status

ds:status — the dossier driver (sit-rep)

Read-only on files; mutations route through Bash helpers. The sit-rep writes only the INDEX regen and the TaskList hydration; pause and resume (step 1a) write the ledger on request. Step 6 lists both.

Steps

1. Locate

• .scratchpad/INDEX.md — missing → run ds regen-index to build it.
• Enumerate ALL rows with state=live. Current dossier = the first (most-recent). state=paused rows are listed separately, outside the live set.
• The paused set reaches the report as its own PAUSED line in step 5, printed on every full sit-rep — (none) when the set is empty. The LIGHT path exits at step 1 and never reaches it, which is correct: LIGHT runs where there is no .scratchpad/dossier/ to hold a paused wave. A paused wave that no line names is a wave nobody decides about.

No .scratchpad/dossier/ in cwd → LIGHT sit-rep, the small-work path with no ceremony:

• git status -sb + git log --oneline -${DS_LIGHT_LOG:-5} for working state (skip git cleanly outside a repo).
• $DS_HEALTH_CMD when set: run it and fold its output in (the operator wires a repo/rig health check; unset stays portable).
• One block: LIGHT (no dossier): <branch> · <ahead/behind> · <N> dirty · last: <subject>, then suggest ds:new "<goal>" when the work meets the start rule: it spans more than one session, touches more than 5 files, or needs an operator step.

Exit 0 after the light sit-rep.

1a. Consolidation check

Warn (advisory, never blocking) when the tree needs tidying:

• >1 live dossier (Vm.12): print a CONSOLIDATE block listing each live slug and its §S-tail age, then suggest picking the current one and pausing or closing the rest.
• stale-live (Vm.13): any live dossier whose last §S entry is older than ${DS_STALE_LIVE_DAYS:-14} days → suggest pause or ds:close --abandon.
• drift (Vm.15): an INDEX carrying a <!-- drift:N slugs:... --> trailer (any dossier rendered drift! — header/location/§Z disagreement, the sealed-zombie class) gets a DRIFT block naming each drift slug and its likely cause, then a route: a §Z-closed drift auto-heals on the next SessionStart (session-start runs ds reconcile); anything else is operator-resolved — finish the close (rerun ds close <wave>) or correct the header through ds header-state, which is the supported writer (the dossier mod's header guard denies a non-canonical token written any other way). Run cli/ds ds-check .scratchpad for the deterministic list.