@treeseed/dsh-chapters 0.1.22 → 0.1.24

package/cordis.patch.yml

@@ -59,6 +59,11 @@
 #   mergeThreshold: 0.3            # τ for merging turns into one chapter at
 #                                  # archive time. Composition is archive-time
 #                                  # only: tune for future archives.
+#   subagentAutoSave: true         # archive a subagent's completed turns into
+#                                  # searchable chapters when its run settles
+#                                  # (save-only: no session, no compaction;
+#                                  # enrichment queued, never per-child).
+#                                  # false = listener never registers.
 #
 #   # ---- context economy -------------------------------------------------
 #   toolResultDeferFloorTokens: 200        # archive-time inline floor

package/docs/architecture.md

@@ -49,6 +49,11 @@ What we *do* take from the XML instinct, because it was a real concern:
 
 - **Frontmatter carries the parseable structure** — `chapter`, `session`, `root`, `seqRange`, `sha256`,
   `tokens`, `artifacts`. Queryable with a YAML parser, invisible to the reading experience.
+  Chapters authored by a **subagent** carry two more lines — `subagent: true` and
+  `parentSession: <id>` — copied from the child's durable session header, which the host itself
+  stamps (`childSessionMeta`: `parentSession`, `origin: subagent`, `delegationDepth`, `agentPreset`;
+  measured, `spikes/subagent-end/FINDINGS.md`). Emitted ONLY when the header has `parentSession`,
+  so existing chapter bytes never change — which is also why no tape needs re-recording.
 - **There is one index, not three.** The TOC lists the chapters for reading; the storage domain already
   holds the machine-readable enumeration. A separate `MANIFEST.md` was proposed and **rejected as
   redundant** — a regenerated duplicate that can drift, whose growth becomes a context cost when read
@@ -213,6 +218,31 @@ is **going on**, authored while the model still holds the thread:
 - Invariant check: the model authors *state*, never archive text (invariant 4 intact); the note rides
   the replacement event append-only; every byte of the conversation still lives in chapters.
 
+## The archive moments
+
+Chapters are written by exactly five doors, and knowledge that trips none of them is knowledge
+that never enters the index. Four are session-facing, all idempotent over a per-session watermark
+(`fromSeq = max(chapter.endSeq) + 1`) and anchored on the last **completed** turn (`turn/end`):
+
+1. `chapters_continue` (tool) and `/chapters-continue` (deterministic door) — archive + child session.
+2. `chapters_fork` (tool) and `/chapters-fork` (door) — archive + branch session (no new bytes).
+3. `/chapters-save` — archive only, parent untouched.
+4. Compaction finalize — the engine's `summarize()` commits a plan pre-durable, and the post-commit
+   finalizer writes the chapter (issue #47 note: the fanout field study shows this is the ONLY one
+   of these that subagents historically reached — 20 child compactions, or nothing).
+5. **Subagent settlement (issue #47, this round)** — a host-plane listener on the published
+   `subagent/end` lifecycle event runs the SAME save pipeline (one implementation, shared with
+   door 3 by extraction — never a second renderer) for children whose header carries
+   `origin: subagent` and `agentPreset === chapters`. The emitter fires `end` synchronously before
+   the holder's dispose continuation (measured, spike), so the fast path is a synchronous
+   `agents.get(info.id).session.snapshotEvents()`; the fallback arm is `sessionQuery.listEvents`
+   over the durable log (ambient-readable — measured); when neither reads, the child is skipped
+   with a loud diagnostic, never guessed. Save-only, so the "no continuation-creating actions
+   mid-step" rule is not engaged: no session is created, no surface is compacted. Enrichment is
+   **queued** per settlement — a 10-child fanout must not `runNow` ten annotator passes. A
+   continuable child settles repeatedly; the watermark makes every repeat after the first a
+   save of only-new-turns. Config: `subagentAutoSave` (default on).
+
 ## Budgets and the Reserve Margin
 
 Two distinct ceilings. Conflating them caused the original design's silent-failure mode.

package/docs/contract.md

@@ -196,9 +196,16 @@ resumable route. *(Phase 0 confirmed: durable, listed, resumable, byte-identical
 Keep `anchoredBoundaryOf` (`vendor/fork.ts:213`) with its role changed: it yields the **archive ceiling**
 (`boundarySeq`, `cut`) for *what to render*, never for seeding.
 
-Notice event shape — built and vocabulary-pinned by `src/notice.ts` (+ `test/notice.test.ts`): one
-`user/message`, `surfaceOp: 'append'`, at `seq = 0`, `source { kind: 'plugin', plugin: 'dsh-chapters',
-form: 'snapshot', sections: [{ name: 'chapters:toc', text }] }`. Continuity validation in `Session.create`
+Notice event shape — built and vocabulary-pinned by `src/notice.ts` (+ `test/notice.test.ts`, + the
+v4 admission rows in `tests/unit/host-seed-contract.test.ts`): one `user/message`, `surfaceOp: 'append'`,
+at `seq = 0`, `source { kind: 'plugin:dsh-chapters', form: 'snapshot', sections: [{ name: 'chapters:toc', text }] }`
+— **producer-owned kind, no `plugin` field**. Session format v4 (host 0.2.x, measured 2026-10-18 on
+`0.2.0-rc.2`) retired the bare `kind: 'plugin'` wrapper: persistence-row admission refuses it with
+`format v4 message requires a producer-owned source kind`
+(`@deepseek-ai/dsh-session-format-v3-to-v4` `lib/index.js:126`; also
+`dsh-session-persistence-jsonl/lib/worker.cjs:10902`). The v3→v4 migration's own
+`rewritePluginSource` does exactly what we now emit: "kind is the producer's own kind and whose
+`plugin` field is dropped". Continuity validation in `Session.create`
 requires the seq to be the next contiguous seed position (rejection message measured in r5).
 
 ## Compaction Engine Integration (Phase 0b)

package/docs/development.md

@@ -94,6 +94,20 @@ and `frontload: true` (structural context injected into prompts). After editing
 `codegraph_sync` so subsequent queries reflect the new code. The index is gitignored and persists
 across sessions.
 
+### The `docs/superpowers/` plan directory
+
+The upstream `writing-plans` / `brainstorming` skills (`.dsh/skills/`, from obra/superpowers — see
+dev/install README § Skills) default their artifacts to `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
+and `docs/superpowers/specs/…`. Those files are **tracked**: they are per-feature design records, and a
+later session may re-reference them for the *why* behind an implementation. Two rules keep them honest:
+
+1. A plan is stamped with a `**Status:**` header when its work lands (implemented → commit refs +
+   pointers to the shipped code/tests/site docs), so nobody executes a spent to-do list.
+2. The durable cross-session record remains the chapters store and `docs/` proper; a superpowers plan
+   is a working artifact of one pre-implementation session, not a second index. If it rots into
+   contradiction with the shipped code, update or supersede it in place via git history — never rewrite
+   silently.
+
 ### Three test layers (and why the third exists)
 
 | Layer | Command | Runs | Covers |

package/docs/plans-carriage.md

@@ -20,7 +20,7 @@ something nobody approved (worse).
 | Rejection = failed call carrying review feedback; dismissal = failed call naming the takeover | `index.js` execute arm + package README § Model Experience | Three distinct non-approval shapes to classify, plus a fourth we must not invent. |
 | State is one log-only whole-value event `plan/mode { active }`, appended at the next **accepted in-turn pre-step** | `index.js:374, 389` | An approved exit may not have its mode event yet at archive time → the *result* is the primary signal, the mode event secondary. |
 | Mode state is recovered by **folding the log** (projection `apply`, `stateVersion: 3`) | `index.js:83-94` | Last logged value wins; we mirror that rule, we do not cache a verdict. |
-| The mode-switch notice rides as `source.kind 'plugin'`, `plugin: 'plan-mode'`, `form: 'notice'` | `index.js:392-410` | Our injection screen already omits it (`src/injections.ts:38-41, 94-102`). Deliberate — see § Non-Goals. |
+| The mode-switch notice rides with `form: 'notice'` — v3 `source { kind: 'plugin', plugin: 'plan-mode' }`, v4 `{ kind: 'plan-mode' }` (measured dsh-plan-mode/lib/index.js:395-410 on 0.2.0-rc.2; issue #43) | `index.js:392-410` | The screen treats injected context as NOT conversation **except** this one sentence, which is archived verbatim (the named exception, `src/injections.ts:55-68`; both arms narrow by producer AND form). Amended 2026-10-10 — this row originally said "omits". |
 | `/plan <message>` steers a real user message, `source.kind 'user'`; bare `/plan`, `/plan off` and their terminal results stay outside model history | `index.js:220` + README § Human Command | The instruction a human typed under plan guidance **is** conversation and is archived verbatim today. Nothing to change. |
 | Freshly created agents begin plan mode **inactive**; `plan/mode` is per-session and not inheritable | README § Known Limitations | A `chapters_continue` / `chapters_fork` child cannot know it was mid-plan unless we carry that text. |
 | `tool/call` data shape is `data.{callId, name, arguments}`, `arguments` an object **or** a JSON string | `src/types.ts:8`, precedent `src/render.ts:253` | The extractor must accept both, exactly as the renderer already does. |

package/docs/superpowers/plans/2026-10-17-chapters-save.md

@@ -0,0 +1,198 @@
+# Implementation Plan: `/chapters-save` Command
+
+**Issue:** #11
+**Date:** 2026-10-17
+**Author:** Agent (subagent)
+**Status:** ✅ IMPLEMENTED — shipped as a6c840d (#11 → PR #12), hardened by 75ca0ff (#16 → PR #17,
+fire-and-forget enrichment after the timeout bug). `runSave` lives in `src/tools.ts` (`saveCommand`,
+registered beside fork/continue); tests in `tests/unit/save-command.test.ts`; behavior documented on
+the site at `site/src/content/docs/reference/commands.md` § `/chapters-save`. Kept as the design
+record for that command — read it with the shipped code, not as an open to-do.
+
+## Goal
+
+Implement `/chapters-save` — a host command that archives the current session into
+searchable chapters **without** creating a child session or triggering compaction.
+The parent session remains fully functional; archived content becomes searchable
+via `chapters_search` from any session in the workspace.
+
+## Success Criteria
+
+- `/chapters-save` archives completed turns into verbatim chapter files on disk
+- Session state is updated with new chapter records (search index picks them up)
+- Enrichment is triggered after archiving (if configured)
+- Idempotent: respects the watermark, re-running saves only new content
+- No child session is created
+- No compaction is triggered
+- Returns clear success/error messages
+
+## Architecture Decision
+
+`/chapters-save` is the **side-effect-only half** of the deterministic door. It reuses
+the same archive pipeline as `/chapters-fork` and `/chapters-continue`:
+
+```
+composeChapters → renderChapter → writeArchive → commitChapters → scheduler.schedule
+```
+
+But stops before `agents.create`. The key insight: `runContinue` in `src/continue-core.ts`
+bundles rendering + writing + child creation into one function. We need to extract the
+render+write portion into a reusable function, then call it from both `runContinue` and
+the new `runSave`.
+
+### Why NOT reuse `runContinue` directly
+
+`runContinue` calls `finishChild` which does budget preflight, notice assembly, and
+`ports.createChild` — all of which are irrelevant for save. Extracting the archive-only
+portion avoids coupling save to child-creation logic and keeps the atomicity contract
+clean.
+
+## File Structure
+
+| File | Change | Responsibility |
+|------|--------|---------------|
+| `src/continue-core.ts` | Add `runSave()` function | Pure archive-without-child orchestration |
+| `src/tools.ts` | Add `saveCommand` to `buildChaptersTools` return | Host command definition + handler |
+| `src/tools.ts` | Register `saveCommand` in `registerChaptersTools` | Wire into host command service |
+| `tests/unit/save-command.test.ts` | New test file | Unit tests for the save command handler |
+| `site/src/content/docs/reference/commands.md` | Already documented | No change needed |
+
+## Detailed Tasks
+
+### Task 1: Extract `runSave` in `src/continue-core.ts`
+
+Add a new exported function that performs steps 1-3 of `runContinue` (validate, render,
+write, commit) but skips step 4-5 (notice, budget, create child).
+
+```typescript
+// src/continue-core.ts — new export
+
+export interface SaveArgs {
+  callerSessionId: string
+  chapters: ChapterRange[]
+  toolResultOverrides: ToolResultOverride[]
+}
+
+export interface SaveConfig extends RenderConfig {
+  artifactStoreRoot: string
+}
+
+export interface SaveResult {
+  ok: boolean
+  chapters?: Array<{ number: number; path: string; startSeq: number; endSeq: number }>
+  warnings?: string[]
+  reason?: string
+}
+
+export async function runSave(
+  ports: Pick<ContinuePorts, 'readCallerEvents' | 'getState' | 'putState' | 'fs'>,
+  args: SaveArgs,
+  config: SaveConfig,
+): Promise<SaveResult>
+```
+
+**Implementation notes:**
+- Reuse `validateRanges`, `renderChapter`, `writeArchive`, `appendChapters` from existing imports
+- Use `attemptKey(args.callerSessionId, ceiling)` for idempotent number allocation
+- Call `ports.putState` with `appendChapters(state, wrote.records)` to commit records
+- Do NOT call `ports.createChild`, `assembleNotice`, `preflight`, or `linkChild`
+- Return `{ ok: true, chapters, warnings }` on success
+
+### Task 2: Add `saveCommand` in `src/tools.ts`
+
+Inside `buildChaptersTools`, after the `continueCommand` definition (~line 529), add:
+
+```typescript
+const saveCommand: HostCommand = {
+  name: 'chapters-save',
+  description: 'Archive completed turns into searchable chapters without creating a child session. The parent stays fully functional.',
+  input: { hint: '[title]' },
+  async handler(invocation): Promise<CommandResult> {
+    // 1. Get ports (same as deterministicCommand)
+    // 2. Read events, find anchor (last turn/end)
+    // 3. Check watermark — if nothing new, return success with "nothing to save"
+    // 4. Compose/derive ranges (same logic as deterministicCommand lines 485-494)
+    // 5. Call runSave(ports, { callerSessionId, chapters, toolResultOverrides }, config)
+    // 6. On success: trigger scheduler.schedule(cwd, 'archive:save')
+    // 7. Return success text with chapter count and seq range
+  }
+}
+```
+
+**Key differences from `deterministicCommand`:**
+- No `intent`, no `handoffNote`, no `callerPreset`, no `rulesSection`, no `projectLine`
+- No `runContinue` / `runFork` call — uses `runSave` instead
+- No child session ID in the return message
+- Simpler error handling (no Refusal/budget concerns)
+
+Update the return value of `buildChaptersTools` (line 734):
+
+```typescript
+return {
+  segment: chaptersSegment,
+  chaptersContinue, chaptersFork, chaptersSearch, chaptersArtifact, chaptersRulePropose,
+  forkCommand, continueCommand, saveCommand  // ← add saveCommand
+}
+```
+
+### Task 3: Register `saveCommand` in `registerChaptersTools`
+
+In `registerChaptersTools` (line 737), add `saveCommand` to the command registration loop:
+
+```typescript
+for (const def of [built.forkCommand, built.continueCommand, built.saveCommand]) {
+  const disposer = commands.register(def)
+  if (typeof disposer === 'function') commandDisposers.push(disposer as () => void)
+}
+```
+
+This is a one-line change to the existing loop — the disposal mechanism already handles N commands.
+
+### Task 4: Write tests in `tests/unit/save-command.test.ts`
+
+Follow the pattern from `tests/unit/fork-command.test.ts`:
+
+```typescript
+// Test cases:
+// 1. Saves completed turns into chapter files on disk
+// 2. Updates session state with chapter records
+// 3. Respects watermark — second call with no new turns returns "nothing to save"
+// 4. Returns error when no completed turn exists
+// 5. Triggers scheduler.schedule after successful save
+// 6. Does NOT create a child session (verify agents.create is never called)
+// 7. Handles title argument (optional prefix)
+```
+
+**Test infrastructure:** Same `world()` helper pattern as fork-command tests. Stub `ctx`
+with `agents.create` that throws if called (proving no child is created). Real temp-dir
+fs so chapter files materialize.
+
+### Task 5: Verify documentation
+
+`site/src/content/docs/reference/commands.md` lines 77-94 already document `/chapters-save`.
+Verify the documented behavior matches the implementation. No doc changes expected.
+
+## Dependencies Between Tasks
+
+```
+Task 1 (runSave) → Task 2 (saveCommand) → Task 3 (registration) → Task 4 (tests)
+Task 5 (docs verification) can run in parallel with Task 4
+```
+
+## Risk Assessment
+
+| Risk | Mitigation |
+|------|-----------|
+| `runSave` duplicates logic from `runContinue` | Extract shared render+write into a private helper if duplication exceeds ~20 lines |
+| Scheduler not triggered | Mirror the exact `config.scheduler?.schedule(cwd, 'archive:save')` pattern from fork/continue |
+| Search index doesn't pick up new chapters | `commitChapters` via `appendChapters` updates the registry; search reads from registry |
+| Watermark check wrong | Use identical logic to `deterministicCommand` lines 473-480 |
+
+## Verification
+
+After implementation:
+1. `npm test` — all existing tests still pass (no regressions)
+2. `npm run build` — compiles cleanly
+3. Manual: run `/chapters-save` in a live session, verify chapter files appear in `.dsh-chapters/`
+4. Manual: run `chapters_search` from another session, verify archived content is findable
+5. Manual: run `/chapters-save` again immediately, verify "nothing to save" response

package/lib/arrival.js

@@ -14,6 +14,7 @@
 import { artifactPath, sha256 } from "./render.js";
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { resolveStoreRoot } from "./store.js";
 export const ARRIVAL_MARKER = '[dsh:artifact';
 const kb = (n) => n < 1024 ? `${n} B` : `${(n / 1024).toFixed(1)} KB`;
 export async function applyArrivalStubs(session, opts) {
@@ -45,7 +46,7 @@ export async function applyArrivalStubs(session, opts) {
             continue;
         const hash = sha256(text);
         const rel = artifactPath(hash);
-        const abs = path.join(opts.cwd, opts.storeRoot, rel);
+        const abs = path.join(resolveStoreRoot(opts.cwd, opts.storeRoot), rel);
         try {
             await fs.mkdir(path.dirname(abs), { recursive: true, mode: 0o700 });
             // content-addressed: rewriting identical bytes is a no-op by definition

package/lib/arrival.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrival.js","sourceRoot":"","sources":["../src/arrival.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arrival.js","sourceRoot":"","sources":["../src/arrival.ts"],"names":[],"mappings":"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"}

package/lib/auto-save.d.ts

@@ -0,0 +1,71 @@
+import { type SaveSessionConfig } from './save-core.ts';
+import { type SessionEventLike } from './types.ts';
+import type { RegistryStore } from './store.ts';
+/** What `subagent/end` carries — the published `SubagentRunEndInfo` subset we read. */
+export interface SubagentEndInfoLike {
+    /** The child agent's id — a durable session id for local (in-process) runs. */
+    id?: string;
+    runId?: string;
+    provider?: string;
+    stopReason?: string;
+}
+export interface AutoSaveChildHeader {
+    id?: string;
+    cwd?: string;
+    parentSession?: string;
+    origin?: string;
+    agentPreset?: string;
+}
+export interface AutoSaveChildView {
+    events: SessionEventLike[];
+    header: AutoSaveChildHeader;
+}
+export interface AutoSaveDeps {
+    /** The preset id a child must carry to be archived (CHAPTERS_PRESET_ID in production). */
+    presetId: string;
+    /** Synchronous live read at emit time (host `agents.get(id)`); undefined when gone. */
+    liveChild: (sessionId: string) => AutoSaveChildView | undefined;
+    /** Durable fallback when the live handle is gone; undefined when unreadable. */
+    durableChild?: ((sessionId: string) => Promise<AutoSaveChildView | undefined>) | undefined;
+    /** The archive itself — saveSession in production, injected for containment tests. */
+    save: (child: AutoSaveChildView) => Promise<{
+        archived: number;
+        skipped: string | null;
+    }>;
+    warn: (message: string) => void;
+    /** Observability seam: what each settlement decided. Outcome vocabulary pinned by tests. */
+    onSettled?: ((sessionId: string, outcome: string) => void) | undefined;
+}
+/**
+ * The listener factory. Pure against injected reads — the real pipeline is wired
+ * by `wireSubagentAutoSave` below, and both are covered by
+ * tests/{unit,integration} rows. The callback itself is SYNCHRONOUS on the
+ * snapshot (that is the race-avoidance), chained asynchronously per child.
+ */
+export declare function makeSubagentEndListener(deps: AutoSaveDeps): (info: SubagentEndInfoLike) => void;
+/** A minimal slice of the host ctx the wiring reads (structural, cordis-free). */
+export interface AutoSaveCtx {
+    get?(name: string): unknown;
+    logger?: {
+        info?(m: string): void;
+        warn?(m: string): void;
+    };
+}
+export interface AutoSaveWiring extends SaveSessionConfig {
+    presetId: string;
+    /** §5 sync scheduler: every archive is a push point. */
+    scheduler?: {
+        schedule(cwd: string, reason: string): void;
+    } | undefined;
+}
+/**
+ * Bind the listener to the host-plane services: `agents` for the live read,
+ * `sessionQuery` for the durable fallback, `saveSession` for the archive.
+ * Returns the callback to register with `ctx.on('subagent/end', …)`.
+ *
+ * ENRICHMENT DELIBERATELY ABSENT: settlement never runs the annotator — a
+ * ten-child fanout must not fire ten LLM drains; new chapters are pending work
+ * for the idle/afterPush ladders exactly like a `/chapters-save` that skipped
+ * the manual nudge. A test pins that nothing here calls runNow.
+ */
+export declare function wireSubagentAutoSave(ctx: AutoSaveCtx, store: RegistryStore, wiring: AutoSaveWiring): (info: SubagentEndInfoLike) => void;

package/lib/auto-save.js

@@ -0,0 +1,182 @@
+/**
+ * Door 5 — subagent settlement auto-save (issue #47).
+ *
+ * The host publishes a `subagent/end` lifecycle event for every settled child
+ * run (one-shot AND each residency epoch of a continuable child). This module
+ * turns each such settlement of a chapters-preset child into an archive through
+ * the SHARED save core (src/save-core.ts) — the same pipeline `/chapters-save`
+ * runs, never a second implementation.
+ *
+ * The seam facts this leans on are MEASURED, not assumed
+ * (spikes/subagent-end/FINDINGS.md, host-subagent-seam drift rows):
+ *   - `end` fires synchronously from a microtask attached at spawn, strictly
+ *     BEFORE the run holder's dispose continuation → a SYNCHRONOUS snapshot
+ *     inside the listener sees the live child's complete log and header.
+ *   - the child header is durable kernel state (`childSessionMeta`):
+ *     `origin: 'subagent'`, `parentSession`, `agentPreset`, `delegationDepth`.
+ *     The gate reads the HEADER, never an event scan (a synthetic child can
+ *     complete turns without ever carrying `agent-preset/selected` — measured).
+ *   - fallback arm: `sessionQuery.listEvents` + `listSessions` headers are
+ *     ambient-readable after disposal (not capability-gated) — used only when
+ *     the live handle is gone at emit.
+ *
+ * Containment is the signature-listener discipline: the emitter catches listener
+ * throws by contract, but we ALSO never let one lose knowledge silently — every
+ * non-archive is either a quiet, expected skip (wrong preset, no completed turn)
+ * or a LOUD warn (unreadable, save failed).
+ */
+import { appendFileSync } from 'node:fs';
+import { saveSession } from "./save-core.js";
+import { lineageOf } from "./types.js";
+const hasCompletedTurn = (events) => events.some((e) => e.type === 'turn/end');
+/**
+ * The listener factory. Pure against injected reads — the real pipeline is wired
+ * by `wireSubagentAutoSave` below, and both are covered by
+ * tests/{unit,integration} rows. The callback itself is SYNCHRONOUS on the
+ * snapshot (that is the race-avoidance), chained asynchronously per child.
+ */
+export function makeSubagentEndListener(deps) {
+    // Per-child promise chain: repeated settlements of the SAME child serialize
+    // (the watermark makes the second save only see the first's records); distinct
+    // children never queue against each other. Same pattern as the signature listener.
+    const chains = new Map();
+    return (info) => {
+        try {
+            const id = info?.id;
+            if (typeof id !== 'string' || id === '') {
+                deps.warn('subagent auto-save: settlement event without a child session id — nothing archived');
+                return;
+            }
+            // --- synchronous snapshot NOW: `end` strictly precedes disposal (measured).
+            let view;
+            try {
+                view = deps.liveChild(id);
+            }
+            catch (error) {
+                deps.warn(`subagent auto-save: live read failed for ${id}: ${String(error?.message ?? error)}`);
+                view = undefined;
+            }
+            const hadLiveHandle = view !== undefined;
+            const job = async () => {
+                let arm = 'live';
+                if (view === undefined && deps.durableChild !== undefined) {
+                    try {
+                        view = await deps.durableChild(id);
+                        arm = 'durable';
+                    }
+                    catch (error) {
+                        deps.warn(`subagent auto-save: durable read failed for ${id}: ${String(error?.message ?? error)}`);
+                    }
+                }
+                if (view === undefined) {
+                    deps.warn(`subagent auto-save: child ${id} unreadable at settlement (live handle ${hadLiveHandle ? 'read failed' : 'gone'}${deps.durableChild === undefined ? ', no durable arm available' : ', durable read empty'}) — its knowledge was NOT archived`);
+                    deps.onSettled?.(id, 'skipped:unreadable');
+                    return;
+                }
+                const suffix = arm === 'durable' ? '@durable' : '';
+                // Gates, in the order the docs state. Expected skips are quiet: this fires
+                // for EVERY subagent in the profile; a warn per non-chapters child would
+                // bury the anomalies that need a human.
+                if (view.header.origin !== 'subagent') {
+                    deps.onSettled?.(id, `skipped:origin${suffix}`);
+                    return;
+                }
+                if (view.header.agentPreset !== deps.presetId) {
+                    deps.onSettled?.(id, `skipped:preset${suffix}`);
+                    return;
+                }
+                if (!hasCompletedTurn(view.events)) {
+                    deps.onSettled?.(id, `skipped:no-completed-turn${suffix}`);
+                    return;
+                }
+                try {
+                    const out = await deps.save(view);
+                    deps.onSettled?.(id, out.skipped === null ? `saved${suffix}` : `skipped:${out.skipped}${suffix}`);
+                }
+                catch (error) {
+                    deps.warn(`subagent auto-save: archiving ${id} failed: ${String(error?.message ?? error)} — its knowledge was NOT archived`);
+                    deps.onSettled?.(id, `failed${suffix}`);
+                }
+            };
+            const prev = chains.get(id);
+            const next = prev === undefined ? job() : prev.then(job);
+            chains.set(id, next);
+            void next.catch(() => undefined).finally(() => { if (chains.get(id) === next)
+                chains.delete(id); });
+        }
+        catch (error) {
+            // never-break containment, twice: the emitter catches us, we catch ourselves.
+            deps.warn(`subagent auto-save listener threw (contained): ${String(error?.message ?? error)}`);
+        }
+    };
+}
+/**
+ * Bind the listener to the host-plane services: `agents` for the live read,
+ * `sessionQuery` for the durable fallback, `saveSession` for the archive.
+ * Returns the callback to register with `ctx.on('subagent/end', …)`.
+ *
+ * ENRICHMENT DELIBERATELY ABSENT: settlement never runs the annotator — a
+ * ten-child fanout must not fire ten LLM drains; new chapters are pending work
+ * for the idle/afterPush ladders exactly like a `/chapters-save` that skipped
+ * the manual nudge. A test pins that nothing here calls runNow.
+ */
+export function wireSubagentAutoSave(ctx, store, wiring) {
+    const warn = (message) => {
+        ctx.logger?.warn?.(message);
+        // the engine's precedent (r19): a headless profile routes ctx.logger where
+        // nobody can see it; the sink env makes the loss readable from outside.
+        try {
+            const sink = process.env.DSH_CHAPTERS_ENGINE_ERRORS;
+            if (sink !== undefined)
+                appendFileSync(sink, `[${new Date().toISOString()}] ${message}\n`);
+        }
+        catch { /* diagnostics must never mask the real failure */ }
+    };
+    const liveChild = (sessionId) => {
+        const agents = ctx.get?.('agents');
+        const handle = agents?.get?.(sessionId);
+        const session = handle?.agent?.session ?? handle?.session;
+        if (session === undefined || typeof session.snapshotEvents !== 'function')
+            return undefined;
+        return { events: [...session.snapshotEvents()], header: (session.header ?? {}) };
+    };
+    const durableChild = async (sessionId) => {
+        const sq = ctx.get?.('sessionQuery');
+        if (sq?.listEvents === undefined || sq.listSessions === undefined)
+            return undefined;
+        const events = await sq.listEvents(sessionId);
+        if (!Array.isArray(events) || events.length === 0)
+            return undefined;
+        const records = await sq.listSessions();
+        const header = (records ?? []).find((r) => r?.header?.id === sessionId)?.header;
+        if (header === undefined)
+            return undefined;
+        return { events, header };
+    };
+    const save = async (child) => {
+        const cwd = child.header.cwd;
+        if (cwd === undefined || cwd === '')
+            throw new Error('subagent child session has no workspace cwd — nowhere reachable to write');
+        const out = await saveSession({
+            events: child.events,
+            sessionId: child.header.id ?? '',
+            cwd,
+            store,
+            config: wiring,
+            subagentOf: lineageOf(child.header),
+        });
+        if (out.skipped === null && out.records.length > 0 && wiring.scheduler !== undefined && cwd !== '') {
+            wiring.scheduler.schedule(cwd, 'archive:autoSave');
+        }
+        return { archived: out.records.length, skipped: out.skipped };
+    };
+    return makeSubagentEndListener({
+        presetId: wiring.presetId,
+        liveChild,
+        durableChild,
+        save,
+        warn,
+        onSettled: (id, outcome) => { ctx.logger?.info?.(`dsh-chapters: subagent ${id} settled → ${outcome}`); },
+    });
+}
+//# sourceMappingURL=auto-save.js.map

package/lib/auto-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-save.js","sourceRoot":"","sources":["../src/auto-save.ts"],"names":[],"mappings":"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"}

package/lib/commands.d.ts

@@ -24,5 +24,8 @@ export interface HostCommandsConfig {
         kind: 'success' | 'error';
         text: string;
     }>;
+    /** Door 5 (issue #47): whether subagent settlements auto-archive. Reported in
+     *  /chapters-status because it runs WITHOUT a human seeing it happen. */
+    subagentAutoSave?: boolean;
 }
 export declare function registerHostCommands(ctx: ToolsCtx, domain: DomainLike, config: HostCommandsConfig): () => void;