harnery 0.31.6 → 0.33.0

package/dist/core/agents/cli.js

@@ -91,24 +91,11 @@ async function handleVerdict(root) {
         const { evaluateClaim } = await import("./rules/claim-conflict.js");
         verdict = evaluateClaim(root, parsed);
     }
-    else if (parsed.rule === "commit") {
-        const { evaluateCommit } = await import("./rules/commit-conflict.js");
-        const result = evaluateCommit(root, parsed);
-        // Map CommitVerdictResult → the standard verdict envelope, stash details
-        // on extra fields so the bash caller can pull conflicts + log_lines.
-        verdict = {
-            allow: result.allow,
-            exit_code: result.exit_code,
-            rule: result.rule,
-            reason: result.message,
-            // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-        };
-        verdict.conflicts = result.conflicts;
-        verdict.log_lines = result.log_lines;
-        verdict.suppressed_self_attribution =
-            result.suppressed_self_attribution ?? false;
-    }
     else {
+        // NB: rule === "commit" was served here until 2026-08-09; the commit
+        // guard now enters through `git-hook pre-commit`, which runs the same
+        // evaluateCommit in-process. A straggler host lands in this fail-open
+        // branch, which is the pre-migration behavior for a malformed request.
         verdict = {
             allow: true,
             exit_code: 0,
@@ -233,13 +220,6 @@ async function handleStateAction(root, action, rest) {
             process.stdout.write(`${JSON.stringify({ instance_id: owner, task: hb.task ?? null, cleared: !task })}\n`);
             return 0;
         }
-        case "stamp-status-call": {
-            const hb = writer.stampStatusCheck(root, owner);
-            if (!hb)
-                return 1;
-            process.stdout.write(`${JSON.stringify({ instance_id: owner, last_status_at: hb.last_status_at })}\n`);
-            return 0;
-        }
         case "set-turn-summary": {
             const summary = args.join(" ");
             const hb = writer.setTurnSummary(root, owner, summary);
@@ -313,10 +293,13 @@ async function handleStateAction(root, action, rest) {
             // fragility. Positionals (sessionId, model) stay as-is once flags are
             // filtered out.
             const adapter = args.find((a) => a.startsWith("--adapter="))?.slice("--adapter=".length);
+            const forkedFrom = args
+                .find((a) => a.startsWith("--forked-from="))
+                ?.slice("--forked-from=".length);
             const positional = args.filter((a) => !a.startsWith("--"));
             const sessionId = positional[0];
             const model = positional[1];
-            const hb = writer.healHeartbeat(root, owner, sessionId, model, adapter);
+            const hb = writer.healHeartbeat(root, owner, sessionId, model, adapter, forkedFrom ? { forkedFrom } : undefined);
             process.stdout.write(`${JSON.stringify({ instance_id: owner, recreated: !!hb })}\n`);
             return hb ? 0 : 1;
         }
@@ -450,70 +433,35 @@ async function handleCouncilAction(root, action, rest) {
 }
 async function handleAssignName(root, rest) {
     const { assignName } = await import("./state/names.js");
-    const [owner, kindArg] = rest;
+    // Optional recorded-fork-lineage flag: --forked-from <parent_instance_id>.
+    // Supplied by an adapter layer that knows (or detected) that this session
+    // was branched from another conversation. Inert on resume: assignName only
+    // stamps lineage on the row that first assigns the instance.
+    let forkedFrom;
+    const positional = [];
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "--forked-from") {
+            forkedFrom = rest[++i];
+            continue;
+        }
+        positional.push(rest[i]);
+    }
+    const [owner, kindArg] = positional;
     if (!owner || !kindArg) {
-        process.stderr.write("agent-coord assign-name <instance_id> <session|subagent|transient>\n");
+        process.stderr.write("agent-coord assign-name <instance_id> <session|subagent|transient> [--forked-from <instance_id>]\n");
         return 2;
     }
     if (kindArg !== "session" && kindArg !== "subagent" && kindArg !== "transient") {
         process.stderr.write(`agent-coord assign-name: invalid kind ${kindArg}\n`);
         return 2;
     }
-    const name = assignName(root, owner, kindArg);
-    process.stdout.write(`${JSON.stringify({ instance_id: owner, name, kind: kindArg })}\n`);
-    return 0;
-}
-async function handlePostCommit(root) {
-    const raw = await readStdin();
-    let req = {};
-    try {
-        req = JSON.parse(raw);
-    }
-    catch {
-        return 0;
-    }
-    const { groupUnclaim } = await import("./state/heartbeat-writer.js");
-    // Session-group-wide unclaim. `owner` is the parent's session_id which is
-    // also the group key (parent + subagents share session_id). Each actual
-    // removal also emits a durable claim.release event — the projector rebuilds
-    // files_touched from the permanent Edit/Write events, so a file-only prune
-    // would resurrect on the next replay.
-    if (req.owner && Array.isArray(req.prune)) {
-        for (const path of req.prune) {
-            try {
-                for (const hit of groupUnclaim(root, req.owner, path)) {
-                    await emitClaimRelease(root, hit.instance_id, hit, path, "commit");
-                }
-            }
-            catch {
-                /* best-effort */
-            }
-        }
-    }
-    return 0;
-}
-async function handlePostCheckout(root, _rest) {
-    const raw = await readStdin();
-    let req = {};
-    try {
-        req = JSON.parse(raw);
-    }
-    catch {
-        return 0;
-    }
-    const { groupUnclaim } = await import("./state/heartbeat-writer.js");
-    if (req.owner && Array.isArray(req.removed)) {
-        for (const path of req.removed) {
-            try {
-                for (const hit of groupUnclaim(root, req.owner, path)) {
-                    await emitClaimRelease(root, hit.instance_id, hit, path, "checkout");
-                }
-            }
-            catch {
-                /* best-effort */
-            }
-        }
-    }
+    const name = assignName(root, owner, kindArg, forkedFrom ? { forkedFrom } : undefined);
+    process.stdout.write(`${JSON.stringify({
+        instance_id: owner,
+        name,
+        kind: kindArg,
+        ...(forkedFrom ? { forked_from: forkedFrom } : {}),
+    })}\n`);
     return 0;
 }
 async function handleShellMutationPaths(root, rest) {
@@ -616,8 +564,11 @@ async function handlePromptContext(root, rest) {
     const sessionNameNudge = args["session-name-nudge"] === "true";
     const taskNudge = args["task-nudge"] === "true";
     const statusFooterNudge = args["status-footer-nudge"] === "true";
+    // Value is the adapter id; a bare flag (parsed as "true") still enables the
+    // reminder with the adapter-neutral wording.
+    const turnRitualNudge = args["turn-ritual-nudge"] === "true" ? "generic" : args["turn-ritual-nudge"];
     if (!instanceId) {
-        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--session-name-nudge] [--task-nudge] [--status-footer-nudge]\n");
+        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--session-name-nudge] [--task-nudge] [--status-footer-nudge] [--turn-ritual-nudge <adapter>]\n");
         return 2;
     }
     const { renderPromptContext } = await import("./render/prompt-context.js");
@@ -629,6 +580,7 @@ async function handlePromptContext(root, rest) {
         sessionNameNudge,
         taskNudge,
         statusFooterNudge,
+        turnRitualNudge,
     });
     process.stdout.write(text);
     return 0;
@@ -776,6 +728,97 @@ async function handleEmitEvent(root, rest) {
     process.stdout.write(`${JSON.stringify(result.envelope)}\n`);
     return 0;
 }
+/**
+ * `agent-coord git-hook <event> [args]` — the single entry a host git hook
+ * invokes. Owns ALL of the coordination git plumbing that hosts used to carry
+ * as bash (staged/committed/checkout-removed collection, submodule
+ * canonicalization, gitlink probe, verdict, claim pruning), so a harnery
+ * upgrade upgrades hook behavior with no change to the host's hook file.
+ *
+ * Events: pre-commit (E-guard verdict; exit 1 blocks the commit),
+ * post-commit (prune committed paths' claims), post-checkout <old> <new>
+ * (release claims on paths the ref move rewrote).
+ *
+ * Fail-open by design: an internal error never blocks a commit (parity with
+ * the bash era, where a crashed verdict read as empty and the hook moved on).
+ * A clean conflict verdict still blocks.
+ */
+async function handleGitHook(fallbackRoot, rest) {
+    const event = rest[0];
+    if (process.env.HARNERY_AGENT_COORD_OFF === "1")
+        return 0;
+    const cwd = process.cwd();
+    try {
+        const gh = await import("./git-hook.js");
+        // Pin the coord root to the superproject: a submodule cwd may carry its
+        // own config-only .harnery that the generic root walk would land on.
+        const root = gh.discoverCoordRoot(cwd) ?? fallbackRoot;
+        if (event === "pre-commit") {
+            const { staged, gitlinks } = gh.collectStaged(cwd);
+            if (staged.length === 0)
+                return 0;
+            const { evaluateCommit } = await import("./rules/commit-conflict.js");
+            const result = evaluateCommit(root, {
+                staged_paths: staged,
+                staged_gitlinks: gitlinks,
+                bypass: process.env.HARNERY_AGENT_COORD_BYPASS === "1",
+            });
+            // Forensics channel shared with the stdin `verdict` path.
+            try {
+                const logPath = join(root, ".harnery", "debug", "agent-coord-verdict.ndjson");
+                await mkdir(dirname(logPath), { recursive: true });
+                await appendFile(logPath, `${JSON.stringify({ ts: new Date().toISOString(), via: "git-hook", staged, verdict: result })}\n`);
+            }
+            catch {
+                /* diagnostics never break a verdict */
+            }
+            if (result.rule !== "commit.pass") {
+                if (result.message)
+                    process.stdout.write(`\n${result.message}\n\n`);
+                for (const c of result.conflicts) {
+                    process.stdout.write(`    ${c.staged_path}  (held by ${c.short_name})\n`);
+                }
+                process.stdout.write("\n");
+            }
+            if (!result.allow) {
+                process.stdout.write("  Wait for them to finish, split the commit, or set\n" +
+                    "  HARNERY_AGENT_COORD_BYPASS=1 to force this commit through.\n\n");
+                return result.exit_code || 1;
+            }
+            return 0;
+        }
+        if (event === "post-commit" || event === "post-checkout") {
+            const paths = event === "post-commit"
+                ? gh.collectCommitted(cwd)
+                : gh.collectCheckoutRemoved(cwd, rest[1] ?? "", rest[2] ?? "");
+            if (paths.length === 0)
+                return 0;
+            const { resolveOwner } = await import("../hooks/resolve/owner.js");
+            const owner = resolveOwner({ payload: null, coordRoot: root })?.instance_id;
+            if (!owner)
+                return 0;
+            const { groupUnclaim } = await import("./state/heartbeat-writer.js");
+            const reason = event === "post-commit" ? "commit" : "checkout";
+            for (const path of paths) {
+                try {
+                    for (const hit of groupUnclaim(root, owner, path)) {
+                        await emitClaimRelease(root, hit.instance_id, hit, path, reason);
+                    }
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+            return 0;
+        }
+        process.stderr.write(`agent-coord git-hook: unknown event ${event ?? "(none)"}\n`);
+        return 0;
+    }
+    catch {
+        // Fail open: coordination must never brick git.
+        return 0;
+    }
+}
 async function main() {
     const [subcommand, ...rest] = process.argv.slice(2);
     const root = findCoordRoot(process.cwd());
@@ -791,7 +834,6 @@ async function main() {
         return handleEmitEvent(root, rest);
     }
     if (subcommand === "set-task" ||
-        subcommand === "stamp-status-call" ||
         subcommand === "set-turn-summary" ||
         subcommand === "release-claim" ||
         subcommand === "kill-heartbeat" ||
@@ -835,11 +877,8 @@ async function main() {
     if (subcommand === "shell-mutation-claim-log") {
         return handleShellMutationClaimLog(root, rest);
     }
-    if (subcommand === "post-commit") {
-        return handlePostCommit(root);
-    }
-    if (subcommand === "post-checkout") {
-        return handlePostCheckout(root, rest);
+    if (subcommand === "git-hook") {
+        return handleGitHook(root, rest);
     }
     await logNoop(root, subcommand ?? "(none)", rest);
     // Phase 1/2: silent on stdout for unknown subcommands, exit 0. Existing

package/dist/core/agents/coord-client.d.ts

@@ -40,12 +40,27 @@ export interface Heartbeat {
     task?: string;
     /** UTC ISO-8601 timestamp when task was last set/cleared. Used by adapters without Stop enforcement to compute staleness. 2026-05-24. */
     task_updated_at?: string | null;
+    /** Current evidence-derived activity axis. */
+    activity?: "unknown" | "working" | "needs_input" | "idle";
+    activity_updated_at?: string;
+    activity_source?: string;
+    /** Explicit task lifecycle axis. */
+    task_state?: "active" | "blocked" | "done";
+    task_state_updated_at?: string;
+    task_state_reason?: string;
+    /** Session name built on the first non-empty set-task; its presence means "this session has been named". 2026-08-09. */
+    suggested_session_name?: string;
+    /** Stamped by turn.stop once the suggested name is seen in assistant reply text. 2026-08-09. */
+    session_name_seen_at?: string;
+    /** Which suggested name the latest sighting covered. */
+    session_name_seen_for?: string;
     /** Auto-generated per-turn summary written by the Stop hook via Haiku. 2026-05-23. */
     turn_summary?: string | null;
     /** UTC ISO-8601 timestamp when turn_summary was last refreshed. */
     turn_summary_updated_at?: string | null;
-    /** Hook client: `claude_code` (default) or `cursor`. Cursor Phase 1. */
+    /** Hook client: `claude-code` (default) or `cursor`. Cursor Phase 1. */
     platform?: string;
+    workflow_run_id?: string;
 }
 /**
  * Resolve the monorepo root for coord-state purposes.
@@ -101,7 +116,7 @@ export declare function nearestCoordRoot(start: string): string | null;
 export declare function rootKnowsSession(root: string): boolean;
 /** Parse owner from a pid-map row (`owner` or `owner\tplatform`). */
 export declare function parsePidmapRowOwner(row: string): string;
-/** Parse platform from a pid-map row; legacy rows default to `claude_code`. */
+/** Parse platform from a pid-map row; legacy rows default to `claude-code`. */
 export declare function parsePidmapRowPlatform(row: string): string;
 /** Parse the start token from a pid-map row; rows written before it carry none. */
 export declare function parsePidmapRowStartToken(row: string): string | undefined;
@@ -128,7 +143,7 @@ export declare function pidStartToken(pid: number): string | null;
  *
  * Pid-map files are `instance_id` or `instance_id\tplatform` (Cursor Phase 1).
  * Prefer a row whose platform matches `HARNERY_AGENT_COORD_PLATFORM` (default
- * `claude_code`); otherwise return the first owner seen on the walk.
+ * `claude-code`); otherwise return the first owner seen on the walk.
  *
  * Subagents intentionally do not write pid-map entries; a Bash-tool ppid-walk
  * from inside a subagent therefore resolves to the *parent's* pid-map entry.

package/dist/core/agents/coord-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yIAAyI;IACzI,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CA+B7E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAiED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAwCA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC/C,CAyBA;AA0DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgDpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMlE;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC"}
+{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/coord-client.js

@@ -224,10 +224,10 @@ export function parsePidmapRowOwner(row) {
     const tab = trimmed.indexOf("\t");
     return tab >= 0 ? trimmed.slice(0, tab) : trimmed;
 }
-/** Parse platform from a pid-map row; legacy rows default to `claude_code`. */
+/** Parse platform from a pid-map row; legacy rows default to `claude-code`. */
 export function parsePidmapRowPlatform(row) {
     const platform = row.trim().split("\t")[1]?.trim();
-    return platform || "claude_code";
+    return platform || "claude-code";
 }
 /** Parse the start token from a pid-map row; rows written before it carry none. */
 export function parsePidmapRowStartToken(row) {
@@ -336,7 +336,7 @@ function readPidmapRow(pidmapDir, pid) {
  *
  * Pid-map files are `instance_id` or `instance_id\tplatform` (Cursor Phase 1).
  * Prefer a row whose platform matches `HARNERY_AGENT_COORD_PLATFORM` (default
- * `claude_code`); otherwise return the first owner seen on the walk.
+ * `claude-code`); otherwise return the first owner seen on the walk.
  *
  * Subagents intentionally do not write pid-map entries; a Bash-tool ppid-walk
  * from inside a subagent therefore resolves to the *parent's* pid-map entry.
@@ -400,7 +400,7 @@ export function resolveOwnerByPidmap(root) {
     const pidmapDir = resolve(root, ".harnery", "pid-map");
     if (!existsSync(pidmapDir))
         return { owner: null, source: "none" };
-    const prefer = process.env.HARNERY_AGENT_COORD_PLATFORM?.trim() || "claude_code";
+    const prefer = process.env.HARNERY_AGENT_COORD_PLATFORM?.trim() || "claude-code";
     let fallbackOwner = null;
     let pid = process.pid;
     for (let hop = 0; hop < 20; hop++) {
@@ -439,6 +439,7 @@ const SESSION_ID_ENV_VARS = [
     "CURSOR_SESSION_ID",
     "CURSOR_CONVERSATION_ID",
     "CODEX_SESSION_ID",
+    "CODEX_THREAD_ID",
 ];
 /** Read normalized candidates from the first non-empty adapter session-id env var. */
 function sessionIdsFromEnv() {

package/dist/core/agents/finalization.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Ownership-aware Git completion checks for the end-of-turn status ritual.
+ *
+ * The heartbeat's durable `files_touched` ledger is the ownership boundary. We
+ * inspect only those paths, plus any enclosing submodule gitlinks, so a peer's
+ * active edits elsewhere in a shared checkout do not block this session.
+ */
+import { type AgentFinalizationDisposition } from "../config.js";
+export interface GitFinalizationResult {
+    ok: boolean;
+    claim_history_complete: boolean;
+    dirty_paths: string[];
+    unpushed_repos: string[];
+    host_output_paths: string[];
+    unsupported_paths: UnsupportedFinalizationPath[];
+    unverifiable_paths: string[];
+    unverifiable_repos: string[];
+    repos_checked: string[];
+}
+export type UnsupportedFinalizationReason = "outside_finalization_roots" | "invalid_finalization_root" | "ambiguous_finalization_roots" | "path_escapes_finalization_root" | "git_repository_unavailable" | "output_path_is_git";
+export interface UnsupportedFinalizationPath {
+    path: string;
+    reason: UnsupportedFinalizationReason;
+}
+export interface ClaimFinalizationDescriptor {
+    disposition: AgentFinalizationDisposition;
+    root: string;
+}
+export type ClaimFinalizationDecision = {
+    allow: true;
+    path: string;
+    descriptor: ClaimFinalizationDescriptor;
+    authorityRoot: string;
+    repo?: {
+        root: string;
+        path: string;
+    };
+} | {
+    allow: false;
+    path: string;
+    reason: UnsupportedFinalizationReason;
+};
+export interface SessionWriteClaims {
+    paths: string[];
+    complete: boolean;
+}
+/**
+ * Read every write claim made by this session, including claims released after
+ * a commit. Current heartbeat claims describe dirty ownership; this history is
+ * what keeps the touched repository in scope until its commits are pushed.
+ */
+export declare function readSessionWriteClaims(coordRoot: string, instanceId: string, sessionId: string): SessionWriteClaims;
+/**
+ * Resolve one guarded write to the host's single supported end-turn
+ * disposition. Claim event data never grants authority: every call starts from
+ * the project-owned finalization roots and only then inspects the selected
+ * repository or output tree.
+ */
+export declare function classifyWriteClaimFinalization(coordRoot: string, heldPath: string): ClaimFinalizationDecision;
+/** Check that this session's held paths are committed and their repositories are pushed. */
+export declare function checkGitFinalization(coordRoot: string, heldPaths: readonly string[], options?: {
+    claimHistoryComplete?: boolean;
+}): GitFinalizationResult;
+export declare function formatGitFinalizationFailure(result: GitFinalizationResult, bin: string): string;
+export declare function formatWriteClaimFinalizationDenial(decision: Extract<ClaimFinalizationDecision, {
+    allow: false;
+}>, bin: string): string;
+//# sourceMappingURL=finalization.d.ts.map

package/dist/core/agents/finalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalization.d.ts","sourceRoot":"","sources":["../../../src/core/agents/finalization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,KAAK,4BAA4B,EAA2B,MAAM,cAAc,CAAC;AA4B1F,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,sBAAsB,EAAE,OAAO,CAAC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,2BAA2B,EAAE,CAAC;IACjD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,6BAA6B,GACrC,4BAA4B,GAC5B,2BAA2B,GAC3B,8BAA8B,GAC9B,gCAAgC,GAChC,4BAA4B,GAC5B,oBAAoB,CAAC;AAEzB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,6BAA6B,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,4BAA4B,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,yBAAyB,GACjC;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,2BAA2B,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,6BAA6B,CAAC;CACvC,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CA+BpB;AA+JD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,yBAAyB,CA2D3B;AA2ED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,qBAAqB,CA6EvB;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkD/F;AAmBD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,OAAO,CAAC,yBAAyB,EAAE;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,EAC9D,GAAG,EAAE,MAAM,GACV,MAAM,CAQR"}