@agent-plan/core 0.2.29 → 0.3.1

package/dist/guard-decision.js

@@ -0,0 +1,269 @@
+import { realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+const FILE_WRITE_TOOLS = new Set(["edit", "write"]);
+/** Strip fd-duplication idioms (`2>&1`, `>&2`, `1>&2`) before segmenting or
+ * matching — they duplicate a stream, not a file, are extremely common in
+ * otherwise read-only commands, and their bare `&` would otherwise be
+ * misread as a command separator by {@link bashSegments}. */
+function stripFdDuplication(command) {
+    return command.replace(/\d*>&\d+/g, " ");
+}
+/** Blank out shell operators (`>`, `<`, `|`, `;`, `&`, newlines) that sit
+ * inside single or double quotes. They are literal text there — a commit
+ * message's `<name@example.com>`, a `grep "a|b"` pattern — not redirects or
+ * separators. Quoted paths keep their characters, so `> "/tmp/x"` still
+ * reads as a redirect to `/tmp/x`. */
+function maskQuotedOperators(command) {
+    let out = "";
+    let quote = null;
+    for (let i = 0; i < command.length; i += 1) {
+        const ch = command[i];
+        if (quote === null) {
+            if (ch === "\\") {
+                out += ch + (command[i + 1] ?? "");
+                i += 1;
+                continue;
+            }
+            if (ch === "'" || ch === '"')
+                quote = ch;
+            out += ch;
+            continue;
+        }
+        if (quote === '"' && ch === "\\") {
+            out += "__";
+            i += 1;
+            continue;
+        }
+        if (ch === quote) {
+            quote = null;
+            out += ch;
+            continue;
+        }
+        out += /[<>|;&\n]/.test(ch) ? "_" : ch;
+    }
+    return out;
+}
+/** The command line as write-detection reads it: quoted operators masked,
+ * then fd-duplication removed. Both detection and target extraction use
+ * this, so they always see the same text. */
+function normalizeBashCommand(command) {
+    return stripFdDuplication(maskQuotedOperators(command));
+}
+/** Split a Bash command line into pipe/list segments so write-detection on
+ * one segment (e.g. `sed -i` on the left of a pipe) doesn't get confused by
+ * an unrelated flag on the other side (e.g. `grep -i` on the right). Best
+ * effort only — nested subshells are not parsed. Callers must pass the
+ * command through {@link normalizeBashCommand} first, or a bare `2>&1`
+ * splits on its `&` and a quoted `|` splits a string in two. */
+function bashSegments(command) {
+    return command
+        .split(/(?:&&|\|\||[;&|\n])+/)
+        .map((segment) => segment.trim())
+        .filter(Boolean);
+}
+const GIT_TREE_WRITE_RE = /\bgit\s+(?:checkout|apply|restore|stash\s+pop|reset\s+--hard)\b/;
+const IN_PLACE_EDITOR_RE = /\b(sed|perl)\b/;
+const IN_PLACE_FLAG_RE = /(^|\s)-\S*i(\s|$)/;
+function isWriteShapedBashSegment(segment) {
+    if (/>{1,2}/.test(segment))
+        return true;
+    if (/\btee\b/.test(segment))
+        return true;
+    if (/\b(cp|mv)\b/.test(segment))
+        return true;
+    if (/\brm\b/.test(segment))
+        return true;
+    if (GIT_TREE_WRITE_RE.test(segment))
+        return true;
+    if (IN_PLACE_EDITOR_RE.test(segment) && IN_PLACE_FLAG_RE.test(segment))
+        return true;
+    return false;
+}
+/**
+ * Whether a Bash command line contains a write-shaped operation: output
+ * redirection, `tee`, in-place `sed`/`perl`, a file-creating `cp`/`mv`,
+ * `rm`, or a `git` operation that rewrites tracked files. Deliberately
+ * over-inclusive: `git`, build/test runners, `ls`, `cat`, `grep`, `find`
+ * and friends must stay unmatched, but when in doubt this returns true — a
+ * false positive costs one warning to the agent, never a blocked call or a
+ * prompt, so under-matching (missing a real edit) is the worse failure.
+ */
+export function isWriteShapedBashCommand(command) {
+    if (!command || !command.trim())
+        return false;
+    return bashSegments(normalizeBashCommand(command)).some(isWriteShapedBashSegment);
+}
+/**
+ * Best-effort extraction of the file path(s) a write-shaped Bash segment
+ * targets, so a command that only touches `.planner/` or files outside the
+ * project earns no warning. This cannot see through a heredoc whose target
+ * is computed (a variable, command substitution, etc.) rather than written
+ * literally in the command line — that case still reaches the in-progress /
+ * bypass checks and can warn, rather than being silently treated as safe.
+ *
+ * A wider gap of the same kind: a command that writes through an
+ * interpreter (`python3 - <<PY` then `open(path, "w")`, `node -e`, a script
+ * invoked by name) is opaque here — nothing in the command line looks
+ * write-shaped. P105(F005)/T431 evaluated closing this and chose not to,
+ * for reasons that also rule out revisiting it the same way later:
+ *   - Parsing the script body is unbounded (a path can be computed, read
+ *     from argv, or built at runtime) and would trade an honest documented
+ *     limit for false confidence.
+ *   - A PostToolUse hook that notices tracked files changed while no task
+ *     was in progress sounds like a fit (the guard's job is visibility, not
+ *     prevention), but it collides with this project's own workflow: a
+ *     task is left with its changes uncommitted for the orchestrator to
+ *     review, so "no task in-progress, tracked files changed outside
+ *     .planner/" is the routine state right after every task completes,
+ *     not a signal of anything wrong. Telling that apart from a real
+ *     interpreter write means diffing only the delta from one specific
+ *     Bash call, which needs a session-scoped git-status baseline checked
+ *     on every Bash invocation — read-only ones included, since which
+ *     commands wrote can't be known in advance. That statefulness and
+ *     per-call cost is worse than the gap it would close.
+ * The limit stands, documented rather than silently assumed away.
+ */
+export function extractBashWriteTargets(command) {
+    const targets = [];
+    for (const segment of bashSegments(normalizeBashCommand(command))) {
+        const redirect = segment.match(/>{1,2}\s*([^\s;&|>]+)/);
+        if (redirect?.[1])
+            targets.push(redirect[1]);
+        const tee = segment.match(/\btee\b\s+(?:-\S+\s+)*([^\s;&|]+)/);
+        if (tee?.[1])
+            targets.push(tee[1]);
+        if (/\b(cp|mv)\b/.test(segment)) {
+            const tokens = segment.trim().split(/\s+/).filter((token) => !token.startsWith("-"));
+            const last = tokens[tokens.length - 1];
+            if (last && !/^(cp|mv)$/.test(last))
+                targets.push(last);
+        }
+        if (/\brm\b/.test(segment)) {
+            const tokens = segment.trim().split(/\s+/).filter((token) => !token.startsWith("-") && token !== "rm");
+            targets.push(...tokens);
+        }
+        if (IN_PLACE_EDITOR_RE.test(segment) && IN_PLACE_FLAG_RE.test(segment)) {
+            const tokens = segment.trim().split(/\s+/);
+            const last = tokens[tokens.length - 1];
+            if (last && !last.startsWith("-"))
+                targets.push(last);
+        }
+    }
+    return targets.filter(Boolean);
+}
+/**
+ * Canonicalize a path by resolving symlinks wherever the filesystem lets us,
+ * so e.g. a macOS temp dir under `/var` (itself a symlink to `/private/var`)
+ * compares equal to a path already given in its resolved form, instead of
+ * two spellings of the same directory looking like different ones. `Edit`
+ * targets an existing file, but `Write` and Bash redirects can target a path
+ * that doesn't exist yet — realpath() throws ENOENT for those, so this walks
+ * up to the nearest existing ancestor, canonicalizes that, and reattaches
+ * the missing tail. Never throws; worst case it returns `path` unchanged.
+ */
+function canonicalize(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        const parent = dirname(path);
+        if (parent === path)
+            return path; // reached the filesystem root
+        return join(canonicalize(parent), basename(path));
+    }
+}
+/** Turn a path as written in a command line into one `resolve` understands:
+ * drop surrounding quotes and expand a leading `~` or `$HOME`. Anything else
+ * the shell would expand (other variables, command substitution) is left
+ * as-is, so it resolves inside the project and the agent is still warned. */
+function shellPathToFsPath(candidate) {
+    const unquoted = candidate.replace(/^['"]|['"]$/g, "");
+    return unquoted.replace(/^(?:~|\$HOME|\$\{HOME\})(?=\/|$)/, homedir());
+}
+/** Whether `candidate` resolves to `root` itself or a path inside it. */
+function isPathInside(candidate, root, cwd) {
+    const resolvedRoot = canonicalize(resolve(root));
+    const resolvedCandidate = canonicalize(resolve(cwd, shellPathToFsPath(candidate)));
+    const rel = relative(resolvedRoot, resolvedCandidate);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+/** Whether `candidate` resolves to a path inside `plannerRoot` (or is it exactly). */
+export function isPathInsidePlannerRoot(candidate, plannerRoot, cwd) {
+    return isPathInside(candidate, plannerRoot, cwd);
+}
+/** Whether writing `candidate` changes the project's code: it is inside the
+ * project (the directory that owns `.planner/`) and not inside `.planner/`.
+ * `/dev/null`, `~/.claude/...`, temp dirs and other repositories are not. */
+export function isProjectCodePath(candidate, plannerRoot, cwd) {
+    return isPathInside(candidate, dirname(plannerRoot), cwd) && !isPathInside(candidate, plannerRoot, cwd);
+}
+/** Which paths a covered tool call would write to, before any filtering;
+ * empty when the target cannot be read from the event. */
+function rawWriteTargets(event) {
+    const tool = event.toolName.toLowerCase();
+    if (FILE_WRITE_TOOLS.has(tool)) {
+        return { covered: true, paths: event.filePath ? [event.filePath] : [] };
+    }
+    if (tool === "notebookedit") {
+        return { covered: true, paths: event.notebookPath ? [event.notebookPath] : [] };
+    }
+    if (tool === "bash") {
+        const command = event.command ?? "";
+        if (!isWriteShapedBashCommand(command))
+            return { covered: false, paths: [] };
+        return { covered: true, paths: extractBashWriteTargets(command) };
+    }
+    return { covered: false, paths: [] };
+}
+/**
+ * Whether a tool call may change the project's code, and so needs the guard
+ * to look at task state. This is the one place that rule lives; the hook's
+ * cheap early exit and {@link noTaskWarning} both read `guarded`.
+ *
+ * - Tools that never write (Read, Grep, MCP tools, read-only Bash, ...) are
+ *   not guarded.
+ * - A write whose targets are all known and none is project code (inside
+ *   `.planner/`, `/dev/null`, `~/.claude/...`, a temp dir, another repo) is
+ *   not guarded: updating the planner or the user's own config never needs a
+ *   task.
+ * - A write with at least one project-code target is guarded, with `paths`
+ *   narrowed to those targets.
+ * - A write whose target is unknown (a computed heredoc, an Edit with no
+ *   path) is guarded with empty `paths` — never silently allowed.
+ */
+export function classifyGuardedTool(event) {
+    const { covered, paths } = rawWriteTargets(event);
+    if (!covered)
+        return { guarded: false, paths: [] };
+    if (paths.length === 0)
+        return { guarded: true, paths: [] };
+    const projectPaths = paths.filter((path) => isProjectCodePath(path, event.plannerRoot, event.cwd));
+    return { guarded: projectPaths.length > 0, paths: projectPaths };
+}
+/**
+ * The warning for a tool call that changes project code while no task is in
+ * progress, or none. Never a block or a prompt: the adapter lets the call
+ * proceed either way and only passes the text to the agent. Pure apart from
+ * the cheap symlink canonicalization in {@link isPathInsidePlannerRoot}.
+ *
+ * Order mirrors the cost of finding out: anything that cannot change project
+ * code (see {@link classifyGuardedTool}) is settled from the event alone, so
+ * adapters can skip loading the plan for it.
+ */
+export function noTaskWarning(event, state) {
+    const classification = classifyGuardedTool(event);
+    if (!classification.guarded)
+        return {};
+    if (!state.hasPlannerDir || state.totalTasks === 0)
+        return {};
+    if (state.hasInProgressTask || state.guardBypassed)
+        return {};
+    const target = classification.paths.length > 0 ? classification.paths.join(", ") : "a project file";
+    const start = state.focusTask
+        ? `start the task that covers it (/planner task start ${state.focusTask.id} — ${state.focusTask.title}, or another one)`
+        : "start the task that covers it (/planner task start <task>)";
+    return {
+        warning: `Agent Plan: no task is in progress, and this call changes project code (${target}). It was not blocked. If this is planned work, ${start} so the plan stays accurate. Planner changes never need a task.`,
+    };
+}

package/dist/guard-state.d.ts

@@ -0,0 +1,14 @@
+import type { PlanStore } from "./plan-store.js";
+import type { GuardStateInput } from "./guard-decision.js";
+export interface NoTaskGuardState extends GuardStateInput {
+    inProgressTaskIds: string[];
+}
+/**
+ * Read the planner state the no-task warning needs, once, for any adapter.
+ * The suggested task is the one the plan is already pointing at: the
+ * resume file's in-progress task, then an open task in the current phase,
+ * then a paused task, then the first open task. Never throws for a missing
+ * planner; it reports `hasPlannerDir: false` instead.
+ */
+export declare function loadNoTaskGuardState(st: PlanStore): Promise<NoTaskGuardState>;
+//# sourceMappingURL=guard-state.d.ts.map

package/dist/guard-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-state.d.ts","sourceRoot":"","sources":["../src/guard-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAID;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BnF"}

package/dist/guard-state.js

@@ -0,0 +1,35 @@
+const CLOSED_STATUSES = new Set(["done", "canceled", "rejected"]);
+/**
+ * Read the planner state the no-task warning needs, once, for any adapter.
+ * The suggested task is the one the plan is already pointing at: the
+ * resume file's in-progress task, then an open task in the current phase,
+ * then a paused task, then the first open task. Never throws for a missing
+ * planner; it reports `hasPlannerDir: false` instead.
+ */
+export async function loadNoTaskGuardState(st) {
+    const hasPlannerDir = await st.exists().catch(() => false);
+    if (!hasPlannerDir) {
+        return { hasPlannerDir, totalTasks: 0, hasInProgressTask: false, inProgressTaskIds: [], guardBypassed: false };
+    }
+    const [workspace, resume, guardBypassed] = await Promise.all([
+        st.loadAll(),
+        st.loadResume().catch(() => null),
+        st.isGuardBypassed().catch(() => false),
+    ]);
+    const allTasks = workspace.phases.flatMap((phase) => phase.tasks.map((task) => ({ phase, task })));
+    const inProgressTaskIds = allTasks.filter(({ task }) => task.status === "in-progress").map(({ task }) => task.id);
+    const isOpen = (status) => !CLOSED_STATUSES.has(status);
+    const focus = (resume?.inProgressTaskIds?.[0] ? allTasks.find(({ task }) => task.id === resume.inProgressTaskIds[0]) : undefined)
+        ?? (resume?.currentPhaseId ? allTasks.find(({ phase, task }) => phase.id === resume.currentPhaseId && isOpen(task.status)) : undefined)
+        ?? allTasks.find(({ task }) => task.pauseSnapshot)
+        ?? allTasks.find(({ task }) => task.status === "planned" || task.status === "blocked" || task.status === "waiting")
+        ?? allTasks.find(({ task }) => isOpen(task.status));
+    return {
+        hasPlannerDir,
+        totalTasks: allTasks.length,
+        hasInProgressTask: inProgressTaskIds.length > 0,
+        inProgressTaskIds,
+        guardBypassed,
+        ...(focus ? { focusTask: { id: focus.task.id, title: focus.task.title } } : {}),
+    };
+}

package/dist/handoff-context.d.ts

@@ -124,12 +124,45 @@ export declare const HANDOFF_COLD_START_INVENTORY_CATEGORIES: readonly [{
 export declare const HANDOFF_CANONICAL_SECTIONS: readonly ["Current focus", "Current and partial state", "Preservation constraints", "Supporting documents", "Blockers and risks", "How to resume"];
 export type HandoffCompletenessCategory = typeof HANDOFF_COMPLETENESS_CATEGORIES[number]["id"];
 export type HandoffColdStartInventoryCategory = typeof HANDOFF_COLD_START_INVENTORY_CATEGORIES[number]["id"];
-export type HandoffContractErrorCode = "HANDOFF_PREFLIGHT_REQUIRED" | "HANDOFF_REASON_REQUIRED" | "HANDOFF_CANONICAL_SECTIONS_REQUIRED" | "HANDOFF_COMPLETENESS_AUDIT_REQUIRED" | "HANDOFF_COLD_START_INVENTORY_REQUIRED" | "HANDOFF_COLD_START_INVENTORY_UNCOVERED" | "HANDOFF_CONTENT_LIMIT_EXCEEDED" | "HANDOFF_SUPPORTING_DOCUMENT_INVALID" | "HANDOFF_PERSISTENCE_VERIFICATION_FAILED" | "HANDOFF_READBACK_VERIFICATION_REQUIRED" | "HANDOFF_READBACK_GAPS_FOUND";
+export type HandoffContractErrorCode = "HANDOFF_PREFLIGHT_REQUIRED" | "HANDOFF_REASON_REQUIRED" | "HANDOFF_CANONICAL_SECTIONS_REQUIRED" | "HANDOFF_COMPLETENESS_AUDIT_REQUIRED" | "HANDOFF_COLD_START_INVENTORY_REQUIRED" | "HANDOFF_COLD_START_INVENTORY_UNCOVERED" | "HANDOFF_CONTENT_LIMIT_EXCEEDED" | "HANDOFF_SUPPORTING_DOCUMENT_INVALID" | "HANDOFF_PERSISTENCE_VERIFICATION_FAILED" | "HANDOFF_READBACK_VERIFICATION_REQUIRED" | "HANDOFF_READBACK_GAPS_FOUND" | "HANDOFF_RETAINED_CONTENT_NOT_FOUND" | "HANDOFF_SECTION_RECONCILIATION_REQUIRED";
 export declare class HandoffContractError extends Error {
     readonly code: HandoffContractErrorCode;
     readonly details: Record<string, unknown>;
     constructor(code: HandoffContractErrorCode, message: string, details?: Record<string, unknown>);
 }
+/** Single source of truth for the supportingDocuments recovery statement.
+ * Rendered in prepare output (before drafting) and attached to every
+ * agent-supplied-manifest failure of HANDOFF_SUPPORTING_DOCUMENT_INVALID
+ * (as details.recovery) so both adapters can render it without duplicating
+ * the wording. */
+export declare const HANDOFF_SUPPORTING_DOCUMENTS_GUIDANCE = "supportingDocuments is optional and usually unnecessary: content above the target length is externalized automatically into .planner/docs/. Drop the field and retry unless you are linking a document you created yourself.";
+/** Build a HANDOFF_SUPPORTING_DOCUMENT_INVALID error for a defect in an
+ * agent-supplied manifest entry, always carrying the droppable-field
+ * recovery statement. Do not use this for planner-owned failures (e.g. the
+ * auto-externalized document's own path) — those are not something dropping
+ * the agent's field would fix. */
+export declare function supportingDocumentInvalidError(message: string, details?: Record<string, unknown>): HandoffContractError;
+/** Build a HANDOFF_RETAINED_CONTENT_NOT_FOUND error: `content` was omitted
+ * from a handoff_write call and PlanStore has no body retained for this
+ * phase + expectedHandoffUpdatedAt token (see PlanStore.retainHandoffDraft /
+ * getRetainedHandoffDraft). Reasons: no write against this token has ever
+ * failed, the retained draft aged out, the phase went terminal and its
+ * drafts were discarded, or the token itself is wrong/stale. Content is
+ * always required on the first write attempt for a token; it becomes
+ * optional only on a retry that reuses a retained one. */
+export declare function retainedHandoffContentNotFoundError(phaseId: string, expectedHandoffUpdatedAt: string): HandoffContractError;
+/** One prior section's fate, supplied by the author when validateHandoffSectionReconciliation
+ * names it as unaccounted for. `section` must match a heading named in the
+ * error's `unaccountedSections`; `disposition` is a short, substantive
+ * statement of what happened to it — dropped deliberately, superseded by
+ * newer content, or folded into a different section (including a rename).
+ * See P104(F005)/T416: this is the evidence that replaces the unchecked
+ * `reconciledExistingHandoff` boolean for the sections most likely to be
+ * silently lost. */
+export interface HandoffSectionDispositionInput {
+    section: string;
+    disposition: string;
+}
 export interface HandoffCompletenessAuditInput {
     version: number;
     entries: HandoffCompletenessEntry[];
@@ -152,6 +185,64 @@ export interface HandoffContentExternalization {
     extendedContent: string;
     supportingDocument?: HandoffSupportingDocumentInput;
 }
+/** One document that a previous handoff refresh moved out of the inline
+ * capsule because it exceeded TARGET_HANDOFF_CONTENT_CHARS. Populated by
+ * PlanStore.preparePhaseHandoff (which alone has filesystem access); pure
+ * code here only shapes the type and the recognition/heading helpers below.
+ * `headings` and `missing` are always meaningful even when `content` is
+ * omitted for budget reasons, so a caller who cannot inline the body can
+ * still name what it contained (see handoff-reply.ts). */
+export interface HandoffExternalizedDocumentAudit {
+    path: string;
+    description: string;
+    /** Level-2 (`##`) headings found in the document, in order. Present even
+     *  when `content` is null, so the omission names what the document held. */
+    headings: string[];
+    /** Full document body, or null when it could not be read back from disk
+     *  (deleted, moved, or unreadable). Bounding this for transport is the
+     *  reply builder's job (handoff-reply.ts), not this audit's. */
+    content: string | null;
+    contentLength: number;
+    missing: boolean;
+}
+/** The exact description externalizeOversizedHandoffContent stamps on the
+ * supporting-document entry it generates for an auto-externalized document.
+ * The single source of truth for recognizing one later: handoff_prepare
+ * matches on this instead of the timestamped file-naming convention, so
+ * detection and generation cannot drift apart. A document a human or agent
+ * linked deliberately (a different description) is already named in the
+ * persisted capsule's own "Supporting documents" bullet and is out of scope
+ * here — only content the tooling itself moved out without being asked. */
+export declare const HANDOFF_AUTO_EXTERNALIZED_DOCUMENT_DESCRIPTION = "Full submitted handoff detail externalized automatically; required for cold resume and reconciliation.";
+export declare function isAutoExternalizedHandoffDocument(document: {
+    description: string;
+}): boolean;
+/** Level-2 (`##`) headings of a handoff document, in order. Used to name
+ * what an externalized document contains when its content cannot be
+ * inlined (budget, or the file is missing) and as a table of contents
+ * alongside content that is inlined. */
+export declare function extractHandoffSectionHeadings(content: string): string[];
+/**
+ * Make reconciliation evidenced rather than asserted (P104(F005)/T416).
+ *
+ * Narrow by design: this compares `##` heading text only, never section
+ * content or a fixed category list — it is not a return to the 16-section
+ * scaffold and 14-category cold-start inventory P100(F021)/T396 removed for
+ * making authoring verbose and failing late. A prior capsule with no
+ * headings (or a new submission with none) simply has nothing to name here;
+ * the check degrades to a no-op rather than blocking the write.
+ *
+ * A prior section vanishes from the new content in three ways an author
+ * might legitimately intend: dropped because it no longer matters,
+ * superseded by newer content, or folded into a different section (a rename
+ * reads the same way — the old heading is gone, the content lives under a
+ * new one). This function does not try to tell those apart; it only
+ * requires the author to say which happened, per named section, before the
+ * write proceeds. A deliberate full rewrite where every prior section is
+ * obsolete is handled the same way: every heading is named, and the author
+ * writes one disposition per heading.
+ */
+export declare function validateHandoffSectionReconciliation(priorSectionHeadings: string[], newContent: string, dispositions: HandoffSectionDispositionInput[] | undefined): void;
 export interface HandoffTaskContextUpdate {
     taskId: string;
     completionSummary: string;
@@ -212,6 +303,27 @@ export interface PhaseHandoffAudit {
     }>;
     existingCompletenessAudit: HandoffCompletenessAudit | null;
     phaseWorkMap: PhaseWorkMap;
+    /** Read before drafting: supportingDocuments is optional and rarely needed. */
+    supportingDocumentsGuidance: string;
+    /** Documents the existing active handoff's own auto-externalization moved
+     *  out of the inline capsule (see HANDOFF_AUTO_EXTERNALIZED_DOCUMENT_DESCRIPTION).
+     *  Empty when there is no active handoff or nothing was ever externalized
+     *  from it. auditPhaseHandoff itself never populates this (it is pure and
+     *  has no filesystem access) — PlanStore.preparePhaseHandoff fills it in
+     *  after reading each document back from .planner/docs/. */
+    externalizedHandoffDocuments: HandoffExternalizedDocumentAudit[];
+    /** `##` headings of the full prior capsule the next write will supersede:
+     *  the active handoff's own headings plus, per P104(F005)/T415, the
+     *  headings of every document its own auto-externalization moved out —
+     *  never the elided copy, so a heading that survives only in the
+     *  externalized file is still named. Empty when there is no active
+     *  handoff to reconcile against (first write, or one already archived by
+     *  handoff_clear). auditPhaseHandoff itself only derives this from the
+     *  compact capsule text (no filesystem access); PlanStore.preparePhaseHandoff
+     *  and PlanStore.refreshPhaseHandoff both overlay the externalized
+     *  documents' own headings after reading them back. See
+     *  validateHandoffSectionReconciliation, which consumes this list. */
+    priorSectionHeadings: string[];
 }
 export interface RefreshPhaseHandoffInput {
     /** Structured, human-supplied explanation; rendered by the planner. */
@@ -219,9 +331,26 @@ export interface RefreshPhaseHandoffInput {
     content: string;
     expectedHandoffUpdatedAt: string;
     reconciledExistingHandoff: boolean;
+    /** The full prior capsule's `##` headings (see PhaseHandoffAudit.priorSectionHeadings),
+     *  as PlanStore derived them from the live phase this write is targeting —
+     *  never a stale copy captured at prepare time, so a handoff archived
+     *  between prepare and write (phase.handoff now "") correctly yields no
+     *  sections to reconcile instead of demanding dispositions for content
+     *  that is no longer live. Populated by PlanStore; absent only in direct
+     *  unit calls to applyHandoffContextSync/validateHandoffContextSync that
+     *  do not exercise this check. */
+    priorSectionHeadings?: string[];
+    /** Per-section account for each entry in priorSectionHeadings that has no
+     *  counterpart heading in the submitted content. See
+     *  validateHandoffSectionReconciliation. */
+    sectionDispositions?: HandoffSectionDispositionInput[];
     completenessAudit?: HandoffCompletenessAuditInput;
     coldStartInventory?: HandoffColdStartInventoryInput;
     supportingDocuments?: HandoffSupportingDocumentInput[];
+    /** The body exactly as the agent submitted it, before auto-externalization
+     *  rewrote `content`. Set by PlanStore only when a rewrite happened, so the
+     *  agent's own document links are still judged against what the agent wrote. */
+    submittedContent?: string;
     /** Populated and verified by PlanStore before pure domain application. */
     verifiedSupportingDocuments?: HandoffSupportingDocument[];
     /** Content is kept in-memory only for cold-start coverage validation. */

package/dist/handoff-context.d.ts.map

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