Error codes and exit codes
Read the message and Next: line before selecting a fix. Structured JSON includes code, details, and next when supplied by the error producer.
Exit codes
| Code | Meaning |
|---|---|
| 0 | The requested operation succeeded. |
| 1 | An infrastructure or unexpected failure occurred. |
| 2 | A policy, state, or prerequisite refused the operation. |
| 3 | The command or input is invalid. |
Operator codes
| Code | Next action |
|---|---|
CliVersionTooOld | Upgrade the CLI to the minimum version in project.toml. |
MigrationPreflightFailed | Read the failed relocation step, correct the named record, and repeat the upgrade step. |
WorkspaceNotRelocated | Follow the upgrade checklist for this checkout. |
LegacyOperationUnavailable | Use the run or runs action named by the refusal. |
ExecutionUnavailable | Start through e11 run or continue through e11 runs resume. |
ToolkitNotPinned | Run e11 init, verify the pin, and commit project.toml. |
PricingUnavailable | Restore a valid pricing.json, review rates, and commit the file. |
SourceNotAtBaseline | Commit the required source bytes and plan from the matching checkout. |
Generation1PreparationUnavailable | Use the compatible bridge release only within the coordinated cutover procedure. |
CleanupStatusNotAdmitted | Finish or cancel the run before cleanup. Stopped runs do not admit cleanup. |
CleanupHeadMismatch | Inspect the run branch and its recorded head before cleanup. |
CleanupWorktreeDirty | Review and commit wanted worktree changes before cleanup. |
CleanupRetentionConflict | Inspect the retained reference. Preserve the differing head. |
AdministrationConfirmationRequired | Preview the administrative operation again and use the current confirmation token. |
RunWorktreeRetired | Plan a new run from retained work. Cleanup ends resume and retry access to the released worktree. |
SchemaUnsupported | Use a release compatible with the record or store. |
LandingNotConfirmed | Follow the branch, file, or history correction in the landing refusal. |
RunPlanInvalid | Read details.problems, correct source documents or profile selection, and plan again. |
Internal store codes
Lease, fencing, journal, and integrity errors belong to Under the hood: the run store. Keep the recorded evidence when reporting a repeatable failure.