When a run refuses

Start with the command or action after Next:. Structured refusals include a next field in JSON when the producer supplies a next step. Some earlier error producers supply only a code and details. Use e11 doctor for checkout problems.

Unknown run

Captured from e11 runs status run_nope.

no run of this workspace is run_nope; a run is named by its id, a unique prefix of it, or <project-id>/<workspace-id>/<run-id>
Next: e11 runs list

Uncommitted source

Captured from a plan-only request after editing the story in a scratch clone.

the source has 1 problem(s): foundry/initiatives/operator-dashboard/stories/2-6-artifacts.md is not committed; staged or modified is not committed
Next: git add foundry/initiatives/operator-dashboard/stories/2-6-artifacts.md && git commit -m "<why>"; a run plans from committed documents only

Commit the named document and plan again. If a running item fails after a pinned source changes, inspect the source and the run’s next step before retrying.

Choose the next action

Problem	What to do
A charge exceeds its reservation	Inspect acceptance and cost in e11 runs status <run>. Resume a cost pause with e11 runs resume <run> --raise-ceiling <usd>.
The runtime is outside the sealed policy	Inspect the runtime evidence and policy. Correct runtime selection and plan a successor. A ceiling increase does not authorise another runtime.
An attempt exhausts continuations	Inspect the last worker output, then use e11 runs retry <run> --work-item <id> when another attempt is appropriate.
The landing branch is not checked out	Switch to the branch named in the refusal, then repeat e11 runs land <run> --work-item <id> --merge.
Changed files block landing	Commit or set aside the named files, then repeat landing. Reconcile divergent history by hand.
Cleanup targets a live or stopped run	Use e11 runs status <run>. Finish the work or cancel the run before cleanup.
The CLI is below minimum_cli_version	Install the required CLI version, then use e11 doctor.
The Toolkit pin is absent	Run e11 init and commit the project file.
The price list is unreadable	Inspect .foundry/pricing.json. Restore valid rates, commit the file, and run e11 doctor.

Checkout changes during an attempt

The engine records changed checkout paths as evidence and still judges the delivery in the run worktree. Passing acceptance still accepts the work. A changed source document pinned by the run fails the attempt because the worker’s assignment no longer matches its source.

Error codes and exit codes lists stable codes.