opensquid 0.5.395

package/dist/runtime/handoff/narrate.js

@@ -0,0 +1,44 @@
+/**
+ * T-AUTO-HANDOFF AHO.2 — the narrative layer (NEVER load-bearing).
+ *
+ * One bounded model call over the deterministic dump; ANY failure (unknown
+ * alias, spawn error, timeout, empty output) returns null and the handoff
+ * proceeds without narrative — the dump is the load-bearing record
+ * (user-locked). Explicit-command-only: the SessionEnd backup and the
+ * SessionStart lazy generator never call this (spawn exhaustion is exactly
+ * when automatic handoffs happen).
+ *
+ * Imports from: ../../models/dispatcher.js, ../../models/load_config.js.
+ * Imported by: handoff/index.ts.
+ */
+import { resolveStrategy } from '../../models/dispatcher.js';
+import { loadModelsConfig } from '../../models/load_config.js';
+const NARRATE_TIMEOUT_MS = 120_000;
+const NARRATE_PROMPT_HEADER = [
+    'You are writing the NARRATIVE layer of a session handoff for a successor agent.',
+    'Below is the complete deterministic state dump (the load-bearing record — you',
+    'must not contradict it). Write a tight causal narrative: what was being done,',
+    'what happened, why the state is what it is, and what the successor should watch',
+    'for. Max ~30 lines of markdown. No headers above ###. Do not repeat the dump.',
+    '',
+].join('\n');
+export async function narrateHandoff(docBody, opts = {}) {
+    try {
+        let call = opts.strategyCall;
+        if (call === undefined) {
+            const cfg = await loadModelsConfig();
+            const alias = opts.alias ?? 'reasoning';
+            const aliasCfg = cfg[alias];
+            if (!aliasCfg)
+                return null;
+            const strategy = resolveStrategy(alias, aliasCfg);
+            call = (p) => strategy.call(p, { timeoutMs: opts.timeoutMs ?? NARRATE_TIMEOUT_MS });
+        }
+        const out = (await call(`${NARRATE_PROMPT_HEADER}${docBody}`)).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null; // timeout / spawn / config error — narrative skipped
+    }
+}
+//# sourceMappingURL=narrate.js.map

package/dist/runtime/handoff/narrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrate.js","sourceRoot":"","sources":["../../../src/runtime/handoff/narrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,qBAAqB,GAAG;IAC5B,iFAAiF;IACjF,+EAA+E;IAC/E,+EAA+E;IAC/E,iFAAiF;IACjF,+EAA+E;IAC/E,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,OAII,EAAE;IAEN,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;YACxC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,qBAAqB,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,qDAAqD;IACpE,CAAC;AACH,CAAC"}

package/dist/runtime/handoff/render.d.ts

@@ -0,0 +1,25 @@
+/**
+ * T-AUTO-HANDOFF — pure renderers (deterministic in HandoffState).
+ *
+ * Four surfaces, one state: the handover doc (the complete record), the
+ * MEMORY.md resume block (compressed pointer), the work-graph digest, and the
+ * chat digest. Resume steps are MECHANICAL: a mid-flow FSM always resumes at
+ * the RESEARCH flow (re-fire the pre-research artifact — audits re-run on the
+ * fresh session's budget; user-locked), and the FINAL step is always
+ * "commit the handover doc(s)" (the successor-commits half of the locked
+ * commit policy).
+ *
+ * Imports from: ./collect.js (types only).
+ * Imported by: handoff/index.ts, handoff/write.ts.
+ */
+import type { HandoffState } from './collect.js';
+/** The mechanical resume steps (research-flow-first; commit-doc last). */
+export declare function renderResumeSteps(state: HandoffState): string[];
+export declare function renderHandoverDoc(state: HandoffState): string;
+export declare function renderResumeBlock(state: HandoffState): string;
+export declare function renderWgDigest(state: HandoffState): string;
+export declare function renderChatDigest(state: HandoffState): string;
+export declare function spliceNarrative(doc: string, narrative: string): string;
+/** SessionStart injection text (reader side). */
+export declare function renderInjection(docPath: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/runtime/handoff/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/runtime/handoff/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAsCjD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAqC/D;AAUD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAkD7D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAQ7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAQ1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAO5D;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/runtime/handoff/render.js

@@ -0,0 +1,162 @@
+/**
+ * T-AUTO-HANDOFF — pure renderers (deterministic in HandoffState).
+ *
+ * Four surfaces, one state: the handover doc (the complete record), the
+ * MEMORY.md resume block (compressed pointer), the work-graph digest, and the
+ * chat digest. Resume steps are MECHANICAL: a mid-flow FSM always resumes at
+ * the RESEARCH flow (re-fire the pre-research artifact — audits re-run on the
+ * fresh session's budget; user-locked), and the FINAL step is always
+ * "commit the handover doc(s)" (the successor-commits half of the locked
+ * commit policy).
+ *
+ * Imports from: ./collect.js (types only).
+ * Imported by: handoff/index.ts, handoff/write.ts.
+ */
+const MID_FLOW = new Set([
+    'scoping',
+    'researching',
+    'researched',
+    'spec_authored',
+    'spec_complete',
+    'tasks_loaded',
+    'phases_in_flight',
+]);
+function fsmStateOf(state) {
+    const fsm = state.fsm;
+    if (fsm !== null &&
+        typeof fsm === 'object' &&
+        typeof fsm.state === 'string') {
+        return fsm.state;
+    }
+    return '<unknown>';
+}
+function fsmHistoryTail(state, n = 3) {
+    const fsm = state.fsm;
+    if (fsm === null || typeof fsm !== 'object')
+        return [];
+    const history = fsm.history;
+    if (!Array.isArray(history))
+        return [];
+    return history
+        .slice(-n)
+        .map((h) => h !== null && typeof h === 'object'
+        ? `${String(h.state)} @ ${String(h.at)}`
+        : String(h));
+}
+/** The mechanical resume steps (research-flow-first; commit-doc last). */
+export function renderResumeSteps(state) {
+    const steps = [];
+    const fsmState = fsmStateOf(state);
+    const pre = state.artifacts.find((a) => a.kind === 'pre_research');
+    const spec = state.artifacts.find((a) => a.kind === 'spec');
+    if (MID_FLOW.has(fsmState)) {
+        if (pre !== undefined) {
+            steps.push(`Re-fire the pre-research artifact at ${pre.path} ` +
+                (pre.sha8 !== null
+                    ? `(disk hash ${pre.sha8} — verify before trusting any narrative)`
+                    : `(NOT READABLE ON DISK — recover content from the dead session's transcript first)`) +
+                ` — the audits re-run on the fresh session's budget (cap-hit resumes re-enter at the RESEARCH flow).`);
+        }
+        else {
+            steps.push('No pre-research artifact recorded — start the track at SCOPE (write the pre-research first).');
+        }
+        if (spec !== undefined) {
+            steps.push(`Re-fire the spec at ${spec.path}` +
+                (spec.sha8 !== null ? ` (disk hash ${spec.sha8})` : ' (NOT READABLE ON DISK)') +
+                ' — then TaskCreate with ABSOLUTE metadata.spec + metadata.taskId.');
+        }
+        steps.push('After TaskCreate/TaskUpdate(in_progress): re-drive the 7 log_phase calls for any work already done (the ledger below is the evidence of what genuinely completed).');
+    }
+    else {
+        steps.push(`FSM is at "${fsmState}" — no mid-flow recovery needed; pick the next backlog item (open work-graph issues below).`);
+    }
+    steps.push('Commit the handover doc(s) — left uncommitted by the generator deliberately.');
+    return steps;
+}
+function section(title, body) {
+    return `## ${title}\n\n${body}\n`;
+}
+function codeBlock(lines) {
+    return lines.length === 0 ? '_(empty)_' : `\`\`\`\n${lines.join('\n')}\n\`\`\``;
+}
+export function renderHandoverDoc(state) {
+    const sid8 = state.sessionId.slice(0, 8);
+    const resume = renderResumeSteps(state)
+        .map((s, i) => `${String(i + 1)}. ${s}`)
+        .join('\n');
+    const phaseLedger = typeof state.phaseLedger === 'string'
+        ? state.phaseLedger
+        : state.phaseLedger.map((p) => `- **${p.phase}** — ${p.note}`).join('\n') || '_(none)_';
+    const artifacts = state.artifacts
+        .map((a) => `- ${a.kind}: \`${a.path}\` (sha8: ${a.sha8 ?? 'UNREADABLE'})`)
+        .join('\n') || '_(none recorded)_';
+    const git = state.git
+        .map((g) => `### ${g.repo}\n\nstatus:\n${codeBlock(g.statusShort ? g.statusShort.split('\n') : [])}\n\nunpushed:\n${codeBlock(g.unpushed ? g.unpushed.split('\n') : [])}`)
+        .join('\n\n');
+    const issues = typeof state.openIssues === 'string'
+        ? state.openIssues
+        : state.openIssues.map((i) => `- \`${i.id}\` ${i.title}`).join('\n') || '_(none open)_';
+    return `# AUTO-HANDOVER — session ${sid8} (${state.generatedAt})
+
+Generated DETERMINISTICALLY from disk state by \`opensquid handoff\` (T-AUTO-HANDOFF).
+Narrative carries no authority here — every claim below is a file read; artifact hashes
+let the successor verify disk truth directly.
+
+## The handoff lives on 4 surfaces
+
+1. THIS doc (\`${state.umbrellaRoot}/docs/\` — uncommitted; committing it is resume step ${String(renderResumeSteps(state).length)}).
+2. The auto-memory MEMORY.md managed resume block (\`opensquid:handoff\` markers).
+3. Work-graph issue \`handoff-${sid8}\`.
+4. The umbrella chat topic (best-effort digest).
+
+${section('RESUME steps (mechanical)', resume)}
+${section('FSM', `state: **${fsmStateOf(state)}**\n\nlast transitions:\n${codeBlock(fsmHistoryTail(state))}`)}
+${section('Active task', codeBlock([JSON.stringify(state.activeTask, null, 2)]))}
+${section('Phase set (session)', codeBlock([JSON.stringify(state.phaseSet)]))}
+${section('Phase ledger (durable, active task)', phaseLedger)}
+${section('Guess-audit head', codeBlock([state.guessAuditHead]))}
+${section('Spec-audit head', codeBlock([state.specAuditHead]))}
+${section('Spawn-ledger tail', codeBlock(state.spawnLedgerTail))}
+${section('Attestations tail', codeBlock(state.attestationsTail))}
+${section('Artifacts (disk truth)', artifacts)}
+${section('Git', git || '_(no repos swept)_')}
+${section('Open work-graph issues', issues)}
+`;
+}
+export function renderResumeBlock(state) {
+    const sid8 = state.sessionId.slice(0, 8);
+    const steps = renderResumeSteps(state);
+    return (`## ‼️ AUTO-HANDOFF (session ${sid8}, ${state.generatedAt}) — FSM ${fsmStateOf(state)}\n` +
+        `Full record: see the auto-handover doc for session ${sid8} under the umbrella docs/ dir. ` +
+        `First step: ${steps[0] ?? '(none)'} Final step: commit the handover doc(s).`);
+}
+export function renderWgDigest(state) {
+    return (`AUTO-HANDOFF for session ${state.sessionId} (${state.generatedAt}). ` +
+        `FSM: ${fsmStateOf(state)}. Resume steps:\n` +
+        renderResumeSteps(state)
+            .map((s, i) => `${String(i + 1)}. ${s}`)
+            .join('\n'));
+}
+export function renderChatDigest(state) {
+    const sid8 = state.sessionId.slice(0, 8);
+    return (`AUTO-HANDOFF session ${sid8} — FSM ${fsmStateOf(state)}. ` +
+        `Doc: handover-…-session-${sid8}-auto.md (umbrella docs/). ` +
+        `${renderResumeSteps(state)[0] ?? ''}`);
+}
+/** AHO.2 — insert the narrative section above the RESUME steps. PURE: every
+ *  other byte of the doc is untouched (the splice pin enforces it). */
+const NARRATIVE_ANCHOR = '## RESUME steps (mechanical)';
+export function spliceNarrative(doc, narrative) {
+    const section = `## Narrative (LLM layer — non-load-bearing)\n\n${narrative}\n\n`;
+    const at = doc.indexOf(NARRATIVE_ANCHOR);
+    if (at === -1)
+        return `${doc}\n${section}`; // defensive — append
+    return `${doc.slice(0, at)}${section}${doc.slice(at)}`;
+}
+/** SessionStart injection text (reader side). */
+export function renderInjection(docPath) {
+    return (`📦 AUTO-HANDOFF available from the previous session: ${docPath}\n` +
+        `Read it BEFORE starting substantive work — it carries the mechanical RESUME steps ` +
+        `(research-flow-first when the flow was mid-flight) and disk-truth artifact hashes.`);
+}
+//# sourceMappingURL=render.js.map

package/dist/runtime/handoff/render.js.map

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

package/dist/runtime/handoff/substance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * T-AUTO-HANDOFF AHO.4 — the ONE substance predicate both handoff writers
+ * consume (the SessionEnd backup and the SessionStart tier-3 lazy generator).
+ *
+ * A handoff is worth generating iff the dump would contain at least one
+ * RESUMABLE item: an active task, an FSM beyond bare `scoping`, or a recorded
+ * pre-research artifact. Bare `scoping` with no task and no artifact renders
+ * the zero-information resume ("start the track at SCOPE") — the junk class
+ * two cleanups chased: scope-intent-matching prompts (every audit
+ * subprocess, codex coding probes) mint an FSM at scoping, and AHO.3's
+ * FSM-exists check passed for them while SessionEnd's own clearFsmState
+ * erased the evidence afterwards. Total over all trivial sessions whatever
+ * spawned them.
+ *
+ * Imports from: node:fs/promises, ../paths.js, ../session_state.js.
+ * Imported by: ../hooks/session-end.ts, ../../functions/handoff_session_start.ts.
+ */
+export declare function hasResumableState(sessionId: string): Promise<boolean>;
+//# sourceMappingURL=substance.d.ts.map

package/dist/runtime/handoff/substance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substance.d.ts","sourceRoot":"","sources":["../../../src/runtime/handoff/substance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB3E"}

package/dist/runtime/handoff/substance.js

@@ -0,0 +1,48 @@
+/**
+ * T-AUTO-HANDOFF AHO.4 — the ONE substance predicate both handoff writers
+ * consume (the SessionEnd backup and the SessionStart tier-3 lazy generator).
+ *
+ * A handoff is worth generating iff the dump would contain at least one
+ * RESUMABLE item: an active task, an FSM beyond bare `scoping`, or a recorded
+ * pre-research artifact. Bare `scoping` with no task and no artifact renders
+ * the zero-information resume ("start the track at SCOPE") — the junk class
+ * two cleanups chased: scope-intent-matching prompts (every audit
+ * subprocess, codex coding probes) mint an FSM at scoping, and AHO.3's
+ * FSM-exists check passed for them while SessionEnd's own clearFsmState
+ * erased the evidence afterwards. Total over all trivial sessions whatever
+ * spawned them.
+ *
+ * Imports from: node:fs/promises, ../paths.js, ../session_state.js.
+ * Imported by: ../hooks/session-end.ts, ../../functions/handoff_session_start.ts.
+ */
+import { readFile } from 'node:fs/promises';
+import { sessionStateFile } from '../paths.js';
+import { readActiveTask } from '../session_state.js';
+async function readJson(path) {
+    return JSON.parse(await readFile(path, 'utf8'));
+}
+export async function hasResumableState(sessionId) {
+    if ((await readActiveTask(sessionId)) !== null)
+        return true;
+    try {
+        const fsm = (await readJson(sessionStateFile(sessionId, 'fsm-coding-flow')));
+        if (typeof fsm.state === 'string' && fsm.state !== 'scoping')
+            return true;
+    }
+    catch {
+        /* no FSM → fall through */
+    }
+    try {
+        // The key stores a bare JSON string (write_state, scope-lifecycle:64) —
+        // present the moment a pre-research artifact lands, so a genuine
+        // cap-hit-at-SCOPE session keeps its handoff.
+        const p = await readJson(sessionStateFile(sessionId, 'coding-flow-pre-research-path'));
+        if (typeof p === 'string' && p.length > 0)
+            return true;
+    }
+    catch {
+        /* no artifact */
+    }
+    return false;
+}
+//# sourceMappingURL=substance.js.map

package/dist/runtime/handoff/substance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substance.js","sourceRoot":"","sources":["../../../src/runtime/handoff/substance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAE1E,CAAC;QACF,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,IAAI,CAAC;QACH,wEAAwE;QACxE,iEAAiE;QACjE,8CAA8C;QAC9C,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC,CAAC;QACvF,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runtime/handoff/write.d.ts

@@ -0,0 +1,39 @@
+/**
+ * T-AUTO-HANDOFF — the four surface writers.
+ *
+ * (a) handover doc: atomic tmp+rename at a STABLE per-session path (idempotent
+ *     rewrites — re-running a handoff updates, never accumulates).
+ * (b) MEMORY.md: marker-delimited managed region ONLY (the settings-writer
+ *     `@opensquid` marker contract applied to a doc) — bytes outside the
+ *     markers are never touched; absent file → surface skipped.
+ * (c) work-graph: upsert one `handoff-<sid8>` issue (stable title key).
+ * (d) chat: best-effort daemon `send` — a down daemon NEVER fails the handoff.
+ *
+ * Imports from: node:fs/promises, node:os, node:path, ./collect.js,
+ *   ./render.js, ../paths.js, ../../workgraph/store.js,
+ *   ../../chat_daemon/client.js.
+ * Imported by: handoff/index.ts.
+ */
+import { type HandoffState } from './collect.js';
+export declare const HANDOFF_BEGIN = "<!-- opensquid:handoff:begin -->";
+export declare const HANDOFF_END = "<!-- opensquid:handoff:end -->";
+export interface SurfaceOutcome {
+    surface: 'doc' | 'memory' | 'workgraph' | 'chat';
+    ok: boolean;
+    detail: string;
+}
+/** `/`→`-` — the EXISTING auto-memory dir naming convention (doctor.ts:36-38;
+ *  deliberately a duplicated one-liner there too — no cli↔runtime import edge). */
+export declare function encodeProjectPath(projectPath: string): string;
+export declare function memoryMdPathFor(umbrellaRoot: string): string;
+/** Replace the managed region; insert after the first H1 when absent; prepend
+ *  when no H1. Bytes outside the markers are NEVER touched. */
+export declare function spliceResumeBlock(memoryMd: string, block: string): string;
+export interface WriteHandoffResult {
+    docPath: string;
+    outcomes: SurfaceOutcome[];
+}
+export declare function writeHandoffSurfaces(state: HandoffState, opts?: {
+    narrative?: string;
+}): Promise<WriteHandoffResult>;
+//# sourceMappingURL=write.d.ts.map

package/dist/runtime/handoff/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/runtime/handoff/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AASlE,eAAO,MAAM,aAAa,qCAAqC,CAAC;AAChE,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACjD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;mFACmF;AACnF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED;+DAC+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAazE;AASD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA0E7B"}

package/dist/runtime/handoff/write.js

@@ -0,0 +1,131 @@
+/**
+ * T-AUTO-HANDOFF — the four surface writers.
+ *
+ * (a) handover doc: atomic tmp+rename at a STABLE per-session path (idempotent
+ *     rewrites — re-running a handoff updates, never accumulates).
+ * (b) MEMORY.md: marker-delimited managed region ONLY (the settings-writer
+ *     `@opensquid` marker contract applied to a doc) — bytes outside the
+ *     markers are never touched; absent file → surface skipped.
+ * (c) work-graph: upsert one `handoff-<sid8>` issue (stable title key).
+ * (d) chat: best-effort daemon `send` — a down daemon NEVER fails the handoff.
+ *
+ * Imports from: node:fs/promises, node:os, node:path, ./collect.js,
+ *   ./render.js, ../paths.js, ../../workgraph/store.js,
+ *   ../../chat_daemon/client.js.
+ * Imported by: handoff/index.ts.
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { sendChat } from '../../chat_daemon/client.js';
+import { GENERAL_UMBRELLA, loadChannelsConfig, resolveOutbound, resolveUmbrellaForCwd, } from '../../channels/routing.js';
+import { workGraphStore } from '../../workgraph/store.js';
+import { OPENSQUID_HOME } from '../paths.js';
+import { handoverDocPath } from './collect.js';
+import { renderChatDigest, renderHandoverDoc, renderResumeBlock, renderWgDigest, spliceNarrative, } from './render.js';
+export const HANDOFF_BEGIN = '<!-- opensquid:handoff:begin -->';
+export const HANDOFF_END = '<!-- opensquid:handoff:end -->';
+/** `/`→`-` — the EXISTING auto-memory dir naming convention (doctor.ts:36-38;
+ *  deliberately a duplicated one-liner there too — no cli↔runtime import edge). */
+export function encodeProjectPath(projectPath) {
+    return projectPath.replace(/\//g, '-');
+}
+export function memoryMdPathFor(umbrellaRoot) {
+    return join(homedir(), '.claude', 'projects', encodeProjectPath(umbrellaRoot), 'memory', 'MEMORY.md');
+}
+/** Replace the managed region; insert after the first H1 when absent; prepend
+ *  when no H1. Bytes outside the markers are NEVER touched. */
+export function spliceResumeBlock(memoryMd, block) {
+    const wrapped = `${HANDOFF_BEGIN}\n${block}\n${HANDOFF_END}`;
+    const b = memoryMd.indexOf(HANDOFF_BEGIN);
+    const e = memoryMd.indexOf(HANDOFF_END);
+    if (b !== -1 && e !== -1 && e > b) {
+        return `${memoryMd.slice(0, b)}${wrapped}${memoryMd.slice(e + HANDOFF_END.length)}`;
+    }
+    const m = /^# .*$/m.exec(memoryMd);
+    if (m?.index !== undefined) {
+        const at = m.index + m[0].length;
+        return `${memoryMd.slice(0, at)}\n\n${wrapped}${memoryMd.slice(at)}`;
+    }
+    return `${wrapped}\n\n${memoryMd}`;
+}
+async function atomicWrite(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${String(process.pid)}`;
+    await writeFile(tmp, content, 'utf8');
+    await rename(tmp, path);
+}
+export async function writeHandoffSurfaces(state, opts = {}) {
+    const outcomes = [];
+    const docPath = handoverDocPath(state.umbrellaRoot, state.sessionId);
+    // (a) the doc — the load-bearing record; a failure here IS a handoff failure.
+    const docBody = renderHandoverDoc(state);
+    await atomicWrite(docPath, opts.narrative === undefined ? docBody : spliceNarrative(docBody, opts.narrative));
+    outcomes.push({ surface: 'doc', ok: true, detail: docPath });
+    // (b) MEMORY.md managed region — absent file → skip (not all hosts run auto-memory).
+    const memPath = memoryMdPathFor(state.umbrellaRoot);
+    try {
+        const current = await readFile(memPath, 'utf8');
+        await atomicWrite(memPath, spliceResumeBlock(current, renderResumeBlock(state)));
+        outcomes.push({ surface: 'memory', ok: true, detail: memPath });
+    }
+    catch (e) {
+        outcomes.push({
+            surface: 'memory',
+            ok: false,
+            detail: `skipped: ${e instanceof Error ? e.message : String(e)}`,
+        });
+    }
+    // (c) work-graph upsert — stable title key; update-or-create.
+    try {
+        const store = workGraphStore({
+            dbUrl: `file:${join(OPENSQUID_HOME(), 'workgraph.db')}`,
+            sourceDir: join(OPENSQUID_HOME(), 'store', 'issues'),
+        });
+        await store.init();
+        const title = `handoff-${state.sessionId.slice(0, 8)}`;
+        const existing = (await store.listIssues()).find((i) => i.title === title);
+        if (existing !== undefined) {
+            await store.updateIssue(existing.id, { body: renderWgDigest(state) });
+        }
+        else {
+            await store.createIssue({ title, body: renderWgDigest(state) });
+        }
+        outcomes.push({ surface: 'workgraph', ok: true, detail: title });
+    }
+    catch (e) {
+        outcomes.push({
+            surface: 'workgraph',
+            ok: false,
+            detail: `skipped: ${e instanceof Error ? e.message : String(e)}`,
+        });
+    }
+    // (d) chat — best-effort notification; daemon down / no binding → note,
+    // never fail. The daemon's send RPC needs the `telegram:<chat_id>` wire
+    // form (live spike finding: 'project:telegram' is an MCP-bridge shorthand,
+    // not a daemon channel) — resolve via channels.json like the bridge does.
+    try {
+        const cfg = await loadChannelsConfig();
+        if (cfg === null)
+            throw new Error('no channels.json — chat surface skipped');
+        const umbrella = resolveUmbrellaForCwd(cfg, state.cwd) ?? GENERAL_UMBRELLA;
+        const tg = resolveOutbound(cfg, umbrella);
+        if (tg === null)
+            throw new Error(`umbrella '${umbrella}' has no telegram binding`);
+        const result = await sendChat({
+            channel: `telegram:${tg.chat_id}`,
+            text: renderChatDigest(state),
+            ...(tg.topic_id !== undefined ? { threadId: String(tg.topic_id) } : {}),
+        });
+        outcomes.push({ surface: 'chat', ok: true, detail: JSON.stringify(result).slice(0, 120) });
+    }
+    catch (e) {
+        outcomes.push({
+            surface: 'chat',
+            ok: false,
+            detail: `skipped: ${e instanceof Error ? e.message : String(e)}`,
+        });
+    }
+    return { docPath, outcomes };
+}
+//# sourceMappingURL=write.js.map

package/dist/runtime/handoff/write.js.map

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

package/dist/runtime/hooks/active_task_mirror.d.ts

@@ -0,0 +1,70 @@
+/**
+ * AP.1 — mirror the harness task store into opensquid's active-task signal.
+ *
+ * The whole automation gate-set keys off `active-task.json` (design rules
+ * #1/#8/#16). This module is the ONLY place that knows the Claude-Code-specific
+ * task-store path — every gate reads opensquid's own `active-task.json`,
+ * harness-agnostic (substrate-vs-consumer discipline).
+ *
+ * WHY mirror the store rather than reconstruct from the tool-call args: a
+ * `TaskCreate` PreToolUse payload carries `subject` but NO id (the harness
+ * assigns the id in the RESPONSE, which a PreToolUse hook never sees), and a
+ * `TaskUpdate(in_progress)` payload carries `taskId` but NO subject — and the
+ * two events share no key, so they cannot be correlated. The canonical store
+ * `~/.claude/tasks/<session-id>/<task-id>.json` carries `{id, subject, status,
+ * metadata}` together; we read it and pick the `in_progress` task.
+ *
+ * Timing (H4a): `PreToolUse` fires BEFORE the tool executes, so on a status
+ * TRANSITION the on-disk file still holds the OLD status. We therefore honor the
+ * pending `args` for both directions — the task being moved to `in_progress`
+ * becomes active even though disk still says `pending`; the task being
+ * `completed`/`deleted` is excluded even though disk still says `in_progress`.
+ *
+ * Best-effort + fail-open: never throws into the hook (the caller also guards).
+ *
+ * Imports from: node:fs/promises, node:os, node:path, ../session_state.js.
+ * Imported by: src/runtime/hooks/pre-tool-use.ts.
+ */
+/**
+ * T-ATSC L1 (2026-05-29) — mirror re-derives `active-task.json` on EVERY
+ * PreToolUse, not only on `TaskCreate`/`TaskUpdate` ticks. Pre-T-ATSC the
+ * mirror short-circuited on the harness task tools, leaving a race window
+ * where `active-task.json` could stay absent across the whole code phase
+ * (root cause of SIC commit fc0801a sailing past the workflow gate). With
+ * L1 the mirror reads the harness store on every PreToolUse: the H4a
+ * status overlay + AP.7 metadata overlay safely no-op for non-task tools
+ * (activatingId / completingId both null, args.metadata undefined → falls
+ * through to the on-disk store-derived view). Cost: ~5 ms per call
+ * (readdir + N small readFile); benefit: race-class elimination. The
+ * write path stays idempotent (writeActiveTask is tmp+rename atomic), so
+ * unchanged-state PreToolUse calls cost just the read.
+ */
+export interface HarnessTask {
+    id: string;
+    subject: string;
+    status: string;
+    metadata?: {
+        taskId?: string;
+        spec?: string;
+    };
+}
+/**
+ * Harness task-store directory for a session. `base` is injectable (the mirror
+ * passes it in tests); when omitted, an `OPENSQUID_HARNESS_TASKS_DIR` env
+ * override wins (lets the Gate B primitive — which has no `base` seam — be
+ * tested, and lets a user relocate the store), else the codebase-convention
+ * default `join(homedir(), '.claude', 'tasks')`.
+ */
+export declare const harnessTasksDir: (sessionId: string, base?: string) => string;
+/**
+ * Read + parse the harness task store for a session. Returns `[]` on an absent
+ * dir (no tasks yet) and skips malformed / shape-invalid entries. Never throws.
+ */
+export declare function readHarnessTasks(sessionId: string, base?: string): Promise<HarnessTask[]>;
+/**
+ * Mirror the harness in-progress task into opensquid's `active-task.json`.
+ * No-op for non-task tools. Writes the signal when a task is active, clears it
+ * when none is. Best-effort: resolves without throwing on any I/O failure.
+ */
+export declare function mirrorActiveTask(sessionId: string, tool: string, args: Record<string, unknown>, base?: string, transcriptPath?: string): Promise<void>;
+//# sourceMappingURL=active_task_mirror.d.ts.map

package/dist/runtime/hooks/active_task_mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active_task_mirror.d.ts","sourceRoot":"","sources":["../../../src/runtime/hooks/active_task_mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAkBH;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIhE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAkC/F;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAiJf"}