specweave 1.0.586 → 1.0.588

package/dist/src/core/hooks/handlers/pre-compact.js

@@ -0,0 +1,109 @@
+/**
+ * PreCompact (+ gated Stop) hook handler.
+ *
+ * Fires when Claude Code is about to compact the context window (PreCompact) —
+ * the last safe moment to capture in-flight work before it is summarized away.
+ * The handler auto-writes a work-handoff doc + `.diff` via the SAME
+ * {@link buildWorkHandoff} builder the `specweave handoff` CLI uses, so an
+ * auto-generated handoff is byte-compatible with a manual one (AC-US7-03).
+ *
+ * Design contract (AC-US7-01..04):
+ * - Cheap at context exhaustion: the agent passes only ~5 short string fields
+ *   (reason, summary, next, gotcha, decision) via the hook stdin JSON; all the
+ *   expensive deterministic assembly + the free diff dump happen in the builder.
+ * - Failure-tolerant: a handoff failure must NEVER break compaction. Everything
+ *   is wrapped so the handler always returns the safe `{ continue: true }` shape.
+ * - The Stop variant (`exports.handleStop`) is GATED on an auto/handoff session
+ *   flag (`.specweave/state/auto-mode.json`): PreCompact always writes; Stop only
+ *   writes under an active auto session, so ordinary turn-ends stay quiet
+ *   (AC-US7-02).
+ *
+ * @module core/hooks/handlers/pre-compact
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+/** The compaction-safe response — never block. */
+const SAFE = { continue: true };
+/**
+ * Pull the ~5 short free-text fields the agent may have stated, off the hook
+ * stdin JSON. Tolerant of both snake_case and camelCase keys and of total
+ * absence (the common case at a real token crash — all may be empty).
+ */
+function readShortFields(input) {
+    const get = (...keys) => {
+        for (const k of keys) {
+            const v = input[k];
+            if (typeof v === 'string' && v.trim())
+                return v;
+        }
+        return undefined;
+    };
+    const decisionRaw = input.decision ?? input.decisions;
+    const decisions = Array.isArray(decisionRaw)
+        ? decisionRaw.filter((d) => typeof d === 'string' && d.trim().length > 0)
+        : typeof decisionRaw === 'string' && decisionRaw.trim()
+            ? [decisionRaw]
+            : undefined;
+    return {
+        reason: get('reason'),
+        summary: get('summary'),
+        next: get('next', 'next_step', 'nextStep'),
+        gotcha: get('gotcha'),
+        decisions,
+    };
+}
+/** Is an auto/handoff session currently active? (Stop gating, AC-US7-02.) */
+function isAutoSessionActive(context) {
+    try {
+        return fs.existsSync(path.join(context.stateDir, 'auto-mode.json'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write an auto-handoff. Wrapped so any failure is swallowed — compaction /
+ * turn-end must proceed regardless.
+ */
+async function writeAutoHandoff(context, defaultReason, input) {
+    try {
+        // Lazy import so the handler stays cheap and the builder's deps only load
+        // when a handoff is actually written.
+        const { buildWorkHandoff } = await import('../../session/work-handoff.js');
+        const fields = readShortFields(input);
+        const result = await buildWorkHandoff(context.projectRoot, {
+            // Honor an agent-supplied reason (AC-US7-04); fall back to the
+            // hook-specific default so the CLI and hook paths stay consistent.
+            reason: fields.reason ?? defaultReason,
+            summary: fields.summary,
+            next: fields.next,
+            gotcha: fields.gotcha,
+            decisions: fields.decisions,
+        });
+        logHook(context, 'pre-compact', `auto-handoff written: ${result.docPath}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logHook(context, 'pre-compact', `[ERROR] auto-handoff failed (ignored): ${msg}`);
+    }
+}
+/**
+ * PreCompact handler — always writes a handoff, never blocks compaction.
+ */
+export const handle = async (input, context) => {
+    await writeAutoHandoff(context, 'auto: pre-compact', input);
+    return SAFE;
+};
+/**
+ * Stop handler — gated on an active auto/handoff session. Fires only when
+ * `auto-mode.json` is present so ordinary turn-ends are not noisy (AC-US7-02).
+ */
+export const handleStop = async (input, context) => {
+    if (!isAutoSessionActive(context)) {
+        return SAFE;
+    }
+    await writeAutoHandoff(context, 'auto: stop', input);
+    return SAFE;
+};
+//# sourceMappingURL=pre-compact.js.map

package/dist/src/core/hooks/handlers/pre-compact.js.map

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

package/dist/src/core/hooks/handlers/types.d.ts

@@ -55,7 +55,7 @@ export interface HookContext {
 /** Handler function signature — every handler exports a `handle` matching this */
 export type HandlerFn = (input: HookInput, context: HookContext) => Promise<HookResult>;
 /** Event types supported by the hook router */
-export type HookEventType = 'user-prompt-submit' | 'pre-tool-use';
+export type HookEventType = 'user-prompt-submit' | 'pre-tool-use' | 'pre-compact' | 'stop';
 /** Map of event types to their safe fallback responses */
 export declare const SAFE_DEFAULTS: Record<string, HookResult>;
 /** Get safe default response for an event type */

package/dist/src/core/hooks/handlers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,cAAc,CAAC;AAEnB,0DAA0D;AAC1D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGpD,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE5D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,MAAM,CAAC;AAEX,0DAA0D;AAC1D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAMpD,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE5D"}

package/dist/src/core/hooks/handlers/types.js

@@ -12,6 +12,9 @@
 export const SAFE_DEFAULTS = {
     'user-prompt-submit': { decision: 'approve' },
     'pre-tool-use': { continue: true },
+    // Compaction / turn-end must never be blocked by a handoff failure.
+    'pre-compact': { continue: true },
+    'stop': { continue: true },
 };
 /** Get safe default response for an event type */
 export function getSafeDefault(eventType) {

package/dist/src/core/hooks/handlers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4DH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,oBAAoB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC7C,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;CACnC,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8DH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,oBAAoB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC7C,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,oEAAoE;IACpE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;CAC3B,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/core/session/handoff-doc-format.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Handoff Doc Format — single source of truth
+ *
+ * Renders BOTH the durable handoff document and the copy-paste resume prompt
+ * from one {@link HandoffDocInput}. The CLI command, the PreCompact hook
+ * handler, and the vitest parity test all render through this module, so the
+ * doc format and paste-prompt cannot drift between code paths. The vskill
+ * self-contained skill inlines a byte-compatible template that references the
+ * same canonical section order + footer marker exported here.
+ *
+ * Design rules:
+ * - This module is PURE rendering. It does no IO, no git, no workspace
+ *   detection — callers pass already-captured + already-scrubbed data in.
+ * - The absolute doc path, the `.diff` path, and the per-tool resume matrix are
+ *   inputs/constants so the renderer is deterministic and testable.
+ * - The `Doc format v1` footer marker (DOC_FORMAT_MARKER) is the ownership
+ *   sentinel that lets the builder know a file is a prior handoff it may
+ *   overwrite, and the version handle for future format migrations.
+ *
+ * Part of increment 0867: Cross-Tool Work Handoff
+ * (AC-US1-02, AC-US2-04, AC-US5-01..04, AC-US6-02, AC-US6-05).
+ *
+ * @module core/session/handoff-doc-format
+ */
+/**
+ * Footer marker stamped at the bottom of every handoff doc.
+ *
+ * Doubles as the ownership sentinel: a root `./HANDOFF.md` containing this
+ * string is treated as a prior handoff (safe to overwrite); one lacking it is a
+ * foreign file the builder must not clobber.
+ */
+export declare const DOC_FORMAT_MARKER = "Doc format v1";
+/**
+ * Delimiters wrapping the self-contained body in `--inline` paste-prompts.
+ * A resuming agent reads everything between these markers as the handoff.
+ */
+export declare const INLINE_BEGIN_MARKER = "BEGIN HANDOFF";
+export declare const INLINE_END_MARKER = "END HANDOFF";
+/**
+ * Canonical section headers, in render order. Exported so the vskill inlined
+ * template and the format-parity test (T-017) reference ONE source and fail at
+ * build time if either side reorders or renames a section.
+ */
+export declare const HANDOFF_SECTION_ORDER: readonly string[];
+/**
+ * Per-tool resume guidance. The `findSession` + `resumeCmd` strings are
+ * VERIFIED against the live CLIs and pinned by cross-tool-commands.test.ts
+ * (T-016) so the matrix cannot silently drift when a tool updates.
+ */
+export interface ToolResumeEntry {
+    /** Display name. */
+    tool: string;
+    /** How to locate the source session on disk / in the tool. */
+    findSession: string;
+    /** Native resume command(s). */
+    resumeCmd: string;
+}
+/**
+ * The cross-tool resume matrix (AC-US5-01, AC-US5-02).
+ *
+ * NOTE on Claude: session files live under
+ * `~/.claude/projects/<munged-cwd>/<uuid>.jsonl`, where the cwd is munged by
+ * replacing EVERY non-alphanumeric char with `-` and NOT collapsing runs — so a
+ * leading slash and adjacent separators each become their own dash. Example:
+ *   /Users/.../specweave-umb/.claude-worktrees/x
+ *   → -Users-...-specweave-umb--claude-worktrees-x
+ * (the `/.` between `umb` and `claude-worktrees` yields a double dash).
+ */
+export declare const CLAUDE_MUNGE_EXAMPLE: string;
+export declare const TOOL_RESUME_MATRIX: readonly ToolResumeEntry[];
+/**
+ * Increment-derived facts (present only on the SpecWeave high-fidelity path).
+ */
+export interface HandoffIncrementInfo {
+    id: string;
+    status: string;
+    /** Title from spec.md frontmatter, if available. */
+    title?: string;
+    /** The current (first incomplete / in-progress) task line, if any. */
+    currentTask?: string;
+    /** The next pending task line after the current one, if any. */
+    nextTask?: string;
+    doneTasks: number;
+    totalTasks: number;
+    taskPercentage: number;
+    doneAcs: number;
+    totalAcs: number;
+    /** Human-readable AC/task drift summary lines from acSyncEvents. */
+    acSyncEvents: string[];
+}
+/**
+ * Ambient project rules merged from config.json.
+ */
+export interface HandoffAmbientRules {
+    testMode?: string;
+    coverageTarget?: number;
+    wipLimit?: number;
+}
+/**
+ * Git facts for the doc body (mirrors GitState minus the diff file contents).
+ */
+export interface HandoffGitInfo {
+    isGitRepo: boolean;
+    branch: string;
+    shortSha: string;
+    statusPorcelain: string;
+    diffStat: string;
+    hasUncommittedChanges: boolean;
+}
+/**
+ * The complete, already-scrubbed input to the renderer.
+ */
+export interface HandoffDocInput {
+    /** Absolute path the doc itself will be written to (printed first by CLI). */
+    docPath: string;
+    /** Absolute path of the sibling full-diff file. */
+    diffPath: string;
+    /** Repo / workspace root. */
+    repoRoot: string;
+    /** ISO timestamp of generation. */
+    generatedAt: string;
+    /** Whether this is the SpecWeave high-fidelity path. */
+    isSpecWeave: boolean;
+    /** Free-text "why I'm handing off" (e.g. "out of tokens"). */
+    reason?: string;
+    /** Free-text summary of where things stand. */
+    summary?: string;
+    /** Free-text exact next step. */
+    next?: string;
+    /** Free-text gotcha / warning for the next agent. */
+    gotcha?: string;
+    /** Key decisions (from plan.md + agent-supplied, already merged). */
+    decisions: string[];
+    /** Increment facts (SpecWeave path only). */
+    increment?: HandoffIncrementInfo;
+    /** Ambient rules from config.json. */
+    ambient?: HandoffAmbientRules;
+    /** Git facts. */
+    git: HandoffGitInfo;
+    /** Per-pattern redaction counts from the secret scrub. */
+    redactionCounts: Record<string, number>;
+}
+/**
+ * Render the per-tool "find your source session" block.
+ */
+export declare function renderResumeMatrix(): string;
+/**
+ * Render the full handoff document body (markdown).
+ *
+ * Section order is locked to {@link HANDOFF_SECTION_ORDER}; the `Doc format v1`
+ * footer marker is always last.
+ */
+export declare function renderHandoffDoc(input: HandoffDocInput): string;
+/**
+ * Render the copy-paste resume prompt.
+ *
+ * Default (file-reachable) mode points the next agent at the doc path. The
+ * `inline` mode embeds the FULL doc body between BEGIN/END markers for
+ * cross-machine resume where the file is unreachable (AC-US5-04).
+ */
+export declare function renderPastePrompt(input: HandoffDocInput, opts?: {
+    inline?: boolean;
+}): string;
+//# sourceMappingURL=handoff-doc-format.d.ts.map

package/dist/src/core/session/handoff-doc-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-doc-format.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-doc-format.ts"],"names":[],"mappings":"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"}

package/dist/src/core/session/handoff-doc-format.js

@@ -0,0 +1,292 @@
+/**
+ * Handoff Doc Format — single source of truth
+ *
+ * Renders BOTH the durable handoff document and the copy-paste resume prompt
+ * from one {@link HandoffDocInput}. The CLI command, the PreCompact hook
+ * handler, and the vitest parity test all render through this module, so the
+ * doc format and paste-prompt cannot drift between code paths. The vskill
+ * self-contained skill inlines a byte-compatible template that references the
+ * same canonical section order + footer marker exported here.
+ *
+ * Design rules:
+ * - This module is PURE rendering. It does no IO, no git, no workspace
+ *   detection — callers pass already-captured + already-scrubbed data in.
+ * - The absolute doc path, the `.diff` path, and the per-tool resume matrix are
+ *   inputs/constants so the renderer is deterministic and testable.
+ * - The `Doc format v1` footer marker (DOC_FORMAT_MARKER) is the ownership
+ *   sentinel that lets the builder know a file is a prior handoff it may
+ *   overwrite, and the version handle for future format migrations.
+ *
+ * Part of increment 0867: Cross-Tool Work Handoff
+ * (AC-US1-02, AC-US2-04, AC-US5-01..04, AC-US6-02, AC-US6-05).
+ *
+ * @module core/session/handoff-doc-format
+ */
+/**
+ * Footer marker stamped at the bottom of every handoff doc.
+ *
+ * Doubles as the ownership sentinel: a root `./HANDOFF.md` containing this
+ * string is treated as a prior handoff (safe to overwrite); one lacking it is a
+ * foreign file the builder must not clobber.
+ */
+export const DOC_FORMAT_MARKER = 'Doc format v1';
+/**
+ * Delimiters wrapping the self-contained body in `--inline` paste-prompts.
+ * A resuming agent reads everything between these markers as the handoff.
+ */
+export const INLINE_BEGIN_MARKER = 'BEGIN HANDOFF';
+export const INLINE_END_MARKER = 'END HANDOFF';
+/**
+ * Canonical section headers, in render order. Exported so the vskill inlined
+ * template and the format-parity test (T-017) reference ONE source and fail at
+ * build time if either side reorders or renames a section.
+ */
+export const HANDOFF_SECTION_ORDER = [
+    'Where I Left Off',
+    'Done / Pending',
+    'Key Decisions & Gotchas',
+    'Files Touched',
+    'Exact Next Steps',
+    'How To Resume',
+    'Redaction',
+];
+/**
+ * The cross-tool resume matrix (AC-US5-01, AC-US5-02).
+ *
+ * NOTE on Claude: session files live under
+ * `~/.claude/projects/<munged-cwd>/<uuid>.jsonl`, where the cwd is munged by
+ * replacing EVERY non-alphanumeric char with `-` and NOT collapsing runs — so a
+ * leading slash and adjacent separators each become their own dash. Example:
+ *   /Users/.../specweave-umb/.claude-worktrees/x
+ *   → -Users-...-specweave-umb--claude-worktrees-x
+ * (the `/.` between `umb` and `claude-worktrees` yields a double dash).
+ */
+export const CLAUDE_MUNGE_EXAMPLE = '/Users/antonabyzov/Projects/github/specweave-umb/.claude-worktrees/x ' +
+    '→ -Users-antonabyzov-Projects-github-specweave-umb--claude-worktrees-x';
+export const TOOL_RESUME_MATRIX = [
+    {
+        tool: 'Claude Code',
+        findSession: 'ls ~/.claude/projects/<munged-cwd>/ (munge: every non-alphanumeric char → "-", runs NOT collapsed; e.g. ' +
+            CLAUDE_MUNGE_EXAMPLE + ')',
+        resumeCmd: 'claude -r <uuid>',
+    },
+    {
+        tool: 'Codex',
+        findSession: 'ls ~/.codex/sessions/ (newest dir = most recent session)',
+        resumeCmd: 'codex resume <uuid>   (or: codex resume --last)',
+    },
+    {
+        tool: 'OpenCode',
+        findSession: 'opencode sessions list',
+        resumeCmd: 'opencode -s <id>   (long form: opencode --session <id>)',
+    },
+    {
+        tool: 'Gemini CLI',
+        findSession: 'run /chat list inside the Gemini session to see saved tags',
+        resumeCmd: '/chat resume <tag>',
+    },
+    {
+        tool: 'Antigravity',
+        findSession: 'open the Antigravity Agent Manager and pick the prior task thread',
+        resumeCmd: 'resume the thread from the Antigravity Agent Manager',
+    },
+    {
+        tool: 'Aider',
+        findSession: 'aider keeps .aider.chat.history.md in the repo root',
+        resumeCmd: 'aider --restore-chat-history',
+    },
+];
+function fmtCount(counts) {
+    const entries = Object.entries(counts);
+    if (entries.length === 0) {
+        return '_No token-like strings were detected._';
+    }
+    return entries
+        .map(([type, n]) => `- ${n} \`${type}\` ${n === 1 ? 'string' : 'strings'} masked`)
+        .join('\n');
+}
+/**
+ * Render the per-tool "find your source session" block.
+ */
+export function renderResumeMatrix() {
+    const lines = ['## How To Resume', ''];
+    lines.push('If the doc path above does NOT exist on the machine you are reading this on, ' +
+        'STOP and ask the user to paste the handoff — do not improvise context.');
+    lines.push('');
+    lines.push('To recover the ORIGINAL transcript (optional), find your source session per tool:');
+    lines.push('');
+    for (const e of TOOL_RESUME_MATRIX) {
+        lines.push(`### ${e.tool}`);
+        lines.push(`- Find session: ${e.findSession}`);
+        lines.push(`- Resume: \`${e.resumeCmd}\``);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Render the full handoff document body (markdown).
+ *
+ * Section order is locked to {@link HANDOFF_SECTION_ORDER}; the `Doc format v1`
+ * footer marker is always last.
+ */
+export function renderHandoffDoc(input) {
+    const L = [];
+    // ── Header ──────────────────────────────────────────────────────────────
+    const titleBit = input.increment?.title ? `: ${input.increment.title}` : '';
+    L.push(`# Work Handoff${titleBit}`);
+    L.push('');
+    L.push(`- Doc path: ${input.docPath}`);
+    L.push(`- Doc link: [${input.docPath}](${input.docPath})`);
+    L.push(`- Diff file: ${input.diffPath}`);
+    L.push(`- Generated: ${input.generatedAt}`);
+    L.push(`- Workspace: ${input.repoRoot} ${input.isSpecWeave ? '(SpecWeave)' : '(non-SpecWeave)'}`);
+    if (input.git.isGitRepo) {
+        L.push(`- Git: branch \`${input.git.branch || '(detached)'}\` @ \`${input.git.shortSha || '(no commits)'}\``);
+    }
+    L.push('');
+    // ── Where I Left Off ──────────────────────────────────────────────────────
+    L.push('## Where I Left Off');
+    L.push('');
+    if (input.reason)
+        L.push(`**Why handing off:** ${input.reason}`);
+    if (input.summary)
+        L.push(`**Summary:** ${input.summary}`);
+    if (input.increment) {
+        L.push(`**Increment:** ${input.increment.id} (status: ${input.increment.status})`);
+        if (input.increment.currentTask)
+            L.push(`**Current task:** ${input.increment.currentTask}`);
+        if (input.increment.nextTask)
+            L.push(`**Next task:** ${input.increment.nextTask}`);
+    }
+    else {
+        L.push('_No active SpecWeave increment — this is a git + interview handoff._');
+    }
+    L.push('');
+    // ── Done / Pending ──────────────────────────────────────────────────────
+    L.push('## Done / Pending');
+    L.push('');
+    if (input.increment) {
+        const inc = input.increment;
+        L.push(`- Tasks: ${inc.doneTasks}/${inc.totalTasks} done (${inc.taskPercentage}%), ` +
+            `${inc.totalTasks - inc.doneTasks} pending`);
+        L.push(`- ACs: ${inc.doneAcs}/${inc.totalAcs} checked`);
+        if (inc.acSyncEvents.length > 0) {
+            L.push('- AC/task drift (recent sync events):');
+            for (const ev of inc.acSyncEvents)
+                L.push(`  - ${ev}`);
+        }
+    }
+    else {
+        L.push('_No increment task/AC state available._');
+    }
+    L.push('');
+    // ── Key Decisions & Gotchas ───────────────────────────────────────────────
+    L.push('## Key Decisions & Gotchas');
+    L.push('');
+    if (input.decisions.length > 0) {
+        for (const d of input.decisions)
+            L.push(`- ${d}`);
+    }
+    else {
+        L.push('_No decisions recorded._');
+    }
+    if (input.gotcha) {
+        L.push('');
+        L.push(`**Gotcha:** ${input.gotcha}`);
+    }
+    if (input.ambient && (input.ambient.testMode || input.ambient.coverageTarget != null || input.ambient.wipLimit != null)) {
+        L.push('');
+        L.push('**Ambient rules (config.json):**');
+        if (input.ambient.testMode)
+            L.push(`- Test mode: ${input.ambient.testMode}`);
+        if (input.ambient.coverageTarget != null)
+            L.push(`- Coverage target: ${input.ambient.coverageTarget}%`);
+        if (input.ambient.wipLimit != null)
+            L.push(`- WIP limit: ${input.ambient.wipLimit}`);
+    }
+    L.push('');
+    // ── Files Touched ─────────────────────────────────────────────────────────
+    L.push('## Files Touched');
+    L.push('');
+    if (input.git.hasUncommittedChanges) {
+        L.push('**UNCOMMITTED** — commit, stash, or keep editing BEFORE doing anything destructive.');
+        L.push('');
+        L.push('```');
+        L.push(input.git.statusPorcelain || '(no porcelain output)');
+        L.push('```');
+        if (input.git.diffStat) {
+            L.push('');
+            L.push('```');
+            L.push(input.git.diffStat);
+            L.push('```');
+        }
+        L.push('');
+        L.push(`Full uncommitted diff: \`${input.diffPath}\` — read it or run ` +
+            '`git apply --check` against it to see the exact edits.');
+    }
+    else if (input.git.isGitRepo) {
+        L.push('_Working tree clean — no uncommitted edits._');
+    }
+    else {
+        L.push('_Not a git repository — no diff captured._');
+    }
+    L.push('');
+    // ── Exact Next Steps ──────────────────────────────────────────────────────
+    L.push('## Exact Next Steps');
+    L.push('');
+    if (input.next) {
+        L.push(input.next);
+    }
+    else if (input.increment?.nextTask) {
+        L.push(`Continue with: ${input.increment.nextTask}`);
+    }
+    else {
+        L.push('_No explicit next step recorded — review the summary above._');
+    }
+    L.push('');
+    // ── How To Resume (+ per-tool matrix) ─────────────────────────────────────
+    L.push(renderResumeMatrix());
+    L.push('');
+    // ── Redaction ─────────────────────────────────────────────────────────────
+    L.push('## Redaction');
+    L.push('');
+    L.push(fmtCount(input.redactionCounts));
+    L.push('');
+    L.push('_Scrubbing is heuristic (regex baseline). An empty redaction list is NOT a ' +
+        'guarantee this file is clean — review before sharing or committing._');
+    L.push('');
+    // ── Footer marker ─────────────────────────────────────────────────────────
+    L.push('---');
+    L.push(`<!-- ${DOC_FORMAT_MARKER} -->`);
+    return L.join('\n');
+}
+/**
+ * Render the copy-paste resume prompt.
+ *
+ * Default (file-reachable) mode points the next agent at the doc path. The
+ * `inline` mode embeds the FULL doc body between BEGIN/END markers for
+ * cross-machine resume where the file is unreachable (AC-US5-04).
+ */
+export function renderPastePrompt(input, opts = {}) {
+    const P = [];
+    if (opts.inline) {
+        P.push('Resume my work using the self-contained handoff below.');
+        P.push('This is a full handoff doc — treat everything between the markers as ground truth. ' +
+            'If it references a `.diff` path that does not exist on this machine, ask me to paste the diff.');
+        P.push('');
+        P.push(INLINE_BEGIN_MARKER);
+        P.push(renderHandoffDoc(input));
+        P.push(INLINE_END_MARKER);
+    }
+    else {
+        P.push(`Resume my work. Read the handoff doc at: ${input.docPath}`);
+        P.push('If that path does NOT exist on this machine, STOP and ask me to paste the handoff — ' +
+            'do not improvise context.');
+        P.push(`The exact uncommitted edits are in: ${input.diffPath}`);
+        if (input.increment) {
+            P.push(`Active increment: ${input.increment.id}. Pick up at the next pending task.`);
+        }
+    }
+    return P.join('\n');
+}
+//# sourceMappingURL=handoff-doc-format.js.map

package/dist/src/core/session/handoff-doc-format.js.map

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