doctor

Diagnose the host-opened project without changing anything. Doctor is deeper than status: it explains what Nightshift resolved and which failures that implies. It does not arm, stop, revive, rewrite, or delete.

The four state files and what each holds are in $NIGHTSHIFT_PLUGIN_ROOT/skills/nightshift/references/shift/state-map.md. Report these as different categories; do not merge or move them.

Resolve the installed plugin root to an absolute $NIGHTSHIFT_PLUGIN_ROOT — ${CLAUDE_PLUGIN_ROOT} on Claude Code, $PLUGIN_ROOT on Codex when set, otherwise the absolute path this skill was attached from (skills/doctor/SKILL.md). Run every command below through "$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" — native Windows: & "$NIGHTSHIFT_PLUGIN_ROOT\runtime\windows\ns.ps1" in the PowerShell tool, same verbs — which resolves the host and the workspace; ns help lists the verbs, and ns bind prints the six resolved facts (TASK_ROOT, NIGHTSHIFT_WORKSPACE, NS, NIGHTSHIFT_PLUGIN_ROOT, HOST, SOURCE); $NS below is that NS. Never a bare relative path: the working directory persists between calls.

1. Run the inspector

"$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" doctor

Print its report verbatim. Do not summarise away Facts, Warnings, or Actions, and do not re-derive anything it already resolved: the script uses the same workspace, work-mode, work-target, policy and ownership libraries as the hooks, and both implementations print the same lines.

The report answers, in its own words: where the workspace is and whether .nightshift-link is valid; the schema version and whether it is current, legacy, malformed, or newer than this plugin; work mode and work target; the punch-list and staged-work counts; markers, session, process lease and watchman liveness; the deadline and whether it disagrees with the shift policy; an interrupted provisioning transaction; every rules.json knob it needs and the three native question-tool entries; a resolved policy block naming every effective setting with its source (built-in, rules, defaults, one-shift or exact-plan) and expiry (shift, permanent or -); and a preflight fact naming which items need an elevation category the resolved policy does not grant.

Staged work is reported, never offered, while the punch list has open items. Doctor suggests promoting a draft or a parked Hunt order only when no - [ ] remains under ## Items and no shift is armed — the same precedence Start applies. With open work, say what is staged and say plainly that Start works the current list; do not read a count as an invitation to widen the approved scope, and never promote anything from this read-only skill.

The work mode fact is repository or artifact. When $NS/work-mode is missing and Setup would propose artifact, Doctor warns work mode is unset; Setup would propose artifact and offers persist the proposed artifact mode with Setup; Doctor does not write work-mode. When work-mode is unreadable it warns work mode is malformed; treating the site as unusable until Setup rewrites it, and when the target cannot be resolved it warns work target could not be resolved; treating workspace as the code root. When the record is missing the resolver takes the workspace or its single immediate child repository. Skip a symlink or reparse child; it is not a nested checkout.

In artifact mode the report also carries artifact receipts N for files under $NS/receipts/, and latest artifact receipt with the filename only of the most recently written receipt (no directory path). When receipts are enabled it reports completion record per-item receipt and, if ticked items have no model text, warns N ticked items have no receipt text; each item completes through its receipt file. Disabled receipts are a fact only: completion record none; the owner disabled receipts. When the path exists but is not a real directory, it warns artifact receipts path is not a usable directory and offers to replace it so receipts can land; it does not also warn empty ticks for that path. Copies from Archive live under the archive root, $NS/archive/<YYYY-MM-DD>/receipts/ by default and do not replace the live files Doctor counts. Missing or empty receipts create no dated receipts folder.