Diagnostics reference

Every diagnostic carries a stable code, severity, source range, and variant-specific reason; many also include a fix. The CLI response is authoritative for the exact occurrence. This index does not guess a reason or repair when a variant does not provide one.

Assignment

Assignment error. Use visible stable person keys and valid load values.

Code	Default severity
assignment/ambiguous	error
assignment/duplicate	error
assignment/empty	error
assignment/missing	error

Availability

Availability error. Correct overlapping or invalid leave and overtime dates.

Code	Default severity
availability/conflict	error
availability/duplicate	error
availability/range	error
availability/workday-overtime	warning

Calendar

Calendar error. Correct the workday or holiday declaration.

Code	Default severity
calendar/duplicate	error
calendar/weekday	error

Capacity

Capacity diagnostic. Review assignment load and person availability.

Code	Default severity
capacity/overload	warning
capacity/range	error
capacity/unavailable	warning

Connection

Workspace connection error. Reconnect the project without committing private state.

Code	Default severity
connection/config-invalid	error
connection/source-mismatch	error
connection/workspace-selection-required	error

Date

Date constraint error. Use absolute ISO dates and satisfy the reported date constraint.

Code	Default severity
date/deadline	error
date/deadline-unresolved	warning
date/format	error
date/pair	error
date/range	error

Dep

Dependency error. Repair the referenced work item or ordering constraint.

Code	Default severity
dep/constraint-cycle	error
dep/duplicate	error
dep/missing	error
dep/name-ambiguous	error
dep/name-unknown	error
dep/order	error
dep/order-unresolved	warning
dep/self	error

Doc

Document structure error. Keep exactly one Plan map at the document root.

Code	Default severity
doc/root-not-map	error

Edit

Edit-set error. Review the closed edit-set and current source baseline.

Code	Default severity
edit/candidate-mismatch	error
edit/conflict	error
edit/contract	error
edit/create-conflict	error
edit/create-required	error
edit/operation	error
edit/source-ownership	error

Field

Field contract error. Use the documented field set and value type.

Code	Default severity
field/duplicate	error
field/exclusive	error
field/missing	error
field/type	error
field/unknown	error

Id

Identifier error. Use a unique ASCII kebab-case ID.

Code	Default severity
id/duplicate	error
id/format	error
id/source-basename	error

Include

Include boundary error. Use a safe relative .plan path inside the project root.

Code	Default severity
include/cycle	error
include/duplicate	error
include/limit	error
include/missing	error
include/not-file	error
include/path	error
include/unreadable	error

Init

Initialization error. Choose a new valid target path or Plan identity.

Code	Default severity
init/conflict	error

Manifest

Manifest error. Correct plan.manifest.json and validate the project again.

Code	Default severity
manifest/duplicate	error
manifest/entries	error
manifest/fields	error
manifest/json	error
manifest/missing	error
manifest/not-file	error
manifest/path	error
manifest/unreadable	error
manifest/version	error

Migration

Reference migration error. Review the migration candidate and source baseline.

Code	Default severity
migration/conflict	error
migration/invalid	error
migration/mixed-syntax	error
migration/semantic-change	error

Milestone

Milestone operation error. Refresh the source and correct the milestone operation.

Code	Default severity
milestone/delete-blocked	error
milestone/not-found	error

Name

Name error. Provide a non-empty single-line display name.

Code	Default severity
name/empty	error
name/newline	error

Person

Person reference error. Use the stable @person-key, not the display name.

Code	Default severity
person/name-ambiguous	error
person/name-field-legacy	warning
person/name-unknown	error

Project

Project boundary error. Run the command from a valid project root.

Code	Default severity
project/root-invalid	error

Reference

Reference visibility error. Reference a visible item with explicit @id syntax.

Code	Default severity
reference/scope	error

Resource

Resource catalog error. Repair the local resource source or accepted lock snapshot.

Code	Default severity
resource/auth-failed	error
resource/closure-mismatch	error
resource/contract-incompatible	error
resource/credential-missing	error
resource/forbidden	error
resource/legacy-command	error
resource/legacy-syntax	warning
resource/local-invalid	error
resource/lock-invalid	error
resource/name-reference	error
resource/network	error
resource/person-inactive	error
resource/profile-missing	error
resource/revision-conflict	error
resource/source-conflict	error
resource/source-mismatch	error
resource/workspace-not-ready	error

Skill

Agent Skill error. Inspect the project Skill directory and resolve the conflict explicitly.

Code	Default severity
skill/conflict	error

Source

Source identity error. Provide a valid source path when metadata must be derived.

Code	Default severity
source/path-required	error

State

State diagnostic. Use the exact reason and fix returned by the installed CLI.

Code	Default severity
state/value	error

Syntax

Syntax error. Correct the token or delimiter at the reported range.

Code	Default severity
syntax/comment	error
syntax/indent-mismatch	error
syntax/multiline-bound	error
syntax/parse	error
syntax/reserved	error

Task

Task operation error. Refresh the source and correct the task operation.

Code	Default severity
task/anchor-not-found	error
task/conflict	error
task/delete-blocked	error
task/invalid-move	error
task/not-found	error
task/parent-not-found	error
task/placement-conflict	error
task/summary-state	error

Version

Version error. Use a DSL version supported by the installed CLI.

Code	Default severity
version/dsl	error

See Troubleshooting for workflow-level recovery steps.