Doctor reference
greenline doctor validates the workspace and the artifacts and prints one line per finding: a code, a severity, a message that teaches, and the file. Errors exit non-zero; warnings don't. Every message names its cure; this page adds context.
Workspace (GL01xx)#
| Code | Meaning | What to do |
|---|---|---|
| GL0101 | No manifest | greenline init |
| GL0102 | Manifest invalid | fix the named field; errors are source-located |
| GL0103 | No lock | greenline sync |
| GL0104 | Lock invalid | greenline sync regenerates it |
| GL0105 | Not a Git repository | run inside a Git repo (git init first) |
| GL0106 | AGENTS.override.md present | remove or merge it; it blocks managed writes |
| GL0107 | Sync blocked by conflicts | resolve the listed conflicts first |
| GL0108 | Managed block broken | restore the block markers, then sync |
| GL0109 | Already initialized | nothing to do; sync for changes |
| GL0110 | Lock is stale | greenline sync |
| GL0111 | Managed file conflict | you edited a managed region: move your change outside it, then sync --force-managed <path> |
| GL0112 | Orphaned managed file | the corpus no longer produces it; delete when nothing references it |
| GL0113 | Unknown --force-managed target | the path isn't a managed file; check spelling |
| GL0114 | Skill reference unresolvedwarning | a skill's same-directory link points at a missing file; template files and {placeholder} targets are exempt by design |
Artifacts (GL02xx)#
| Code | Meaning | What to do |
|---|---|---|
| GL0201 | Frontmatter refused | the message teaches the shape: legal fields are enumerated, revision is required and starts at 1, only Markdown lives under work/ (raw evidence goes in the initiative's evidence/<TKT>/), prototypes live on branches |
| GL0202 | Duplicate id | two artifacts claim the same id; ids are bound to file slots |
| GL0203 | Reference doesn't resolve | a named artifact id has no file; fix the id or restore the file |
| GL0204 | Stale consumptionerror | you're pinned to an older revision of an upstream artifact: re-read it, confirm your content still holds, re-pin, or send yours back for rework |
| GL0205 | Consumption ahead | pinned to a revision that doesn't exist yet; fix the pin |
| GL0206 | Claim conflict | one worktree claims two tickets in the building window (claimed/implementing): one build at a time; park one (release its claim with a note on the ticket) |
| GL0207 | Dependency cycle | depends_on loops; break the cycle |
| GL0208 | Evidence missing | a status claims evidence the artifact doesn't carry (e.g. implemented without result_commit); add the evidence or correct the status |
| GL0209 | Complete unproven | a complete ticket lacks result_commit or has unchecked acceptance items: complete means proven |
| GL0210 | Harvest unrecordedwarning | an initiative is complete but .green-line/DECISIONS.md has no entry for it: harvest its outliving rulings into the book, pinned to their sources |
General#
Warningwarnings that persist are worth fixing. A workspace that's always yellow trains everyone to stop reading doctor at all.