harnery 0.8.0 → 0.9.0

package/dist/commands/init.d.ts

@@ -23,11 +23,12 @@ export type { HookGroup, SettingsFile };
 export declare function registerInitCommand(program: Command, emit: EmitContext, binName?: string): void;
 /**
  * Merge agent-hook entries into a harness settings object in place, idempotently.
- * Preserves every existing hook; skips events already wired to
- * `agent-hook <subcommand>`. Honors the harness's entry shape (Claude/Codex nest
- * under an inner `hooks` array; Cursor uses a flat `{ command }`) and ensures the
- * root `version` key when the harness requires one. Pure (no fs/git) so it's
- * unit-testable.
+ * Preserves every existing hook; rewrites events already wired to
+ * `agent-hook <subcommand>` when their command string is stale (e.g. an older
+ * harnery wired a bare relative path). Honors the harness's entry shape
+ * (Claude/Codex nest under an inner `hooks` array; Cursor uses a flat
+ * `{ command }`) and ensures the root `version` key when the harness requires
+ * one. Pure (no fs/git) so it's unit-testable.
  *
  * The trailing space in the match (`agent-hook ${subcommand} `) is load-bearing:
  * it keeps `stop` from matching `stop-failure`.
@@ -36,6 +37,7 @@ export declare function wireHooks(settings: SettingsFile, spec: HarnessSpec, age
     wired: number;
     already: number;
     removed: number;
+    upgraded: number;
 };
 /**
  * Inverse of {@link wireHooks}: strip every harnery-owned hook entry from a
@@ -61,4 +63,12 @@ export declare function unwireHooks(settings: SettingsFile): {
  *   - key absent → splice it in as the first key (comment-safe).
  */
 export declare function stampBinName(configPath: string, binName: string, dryRun: boolean): string | null;
+/**
+ * Idempotently pin `workflow.subscriptionOnly: true` in `.harnery/config.jsonc`
+ * (see `workflowSubscriptionOnly()` in core/config.ts and the `workflow run`
+ * billing safeguards). Same comment-preserving discipline as `stampBinName`.
+ * A `workflow` key of ANY shape (including `subscriptionOnly: false`) is a
+ * deliberate project choice and is left alone.
+ */
+export declare function stampWorkflowDefaults(configPath: string, dryRun: boolean): string | null;
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAKzC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAsH/F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiCrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmDhG"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAKzC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAiI/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAqCvE;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmDhG;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkCxF"}

package/dist/commands/init.js

@@ -92,6 +92,17 @@ export function registerInitCommand(program, emit, binName) {
             if (stamp)
                 actions.push(stamp);
         }
+        // ── 1c. workflow billing default ───────────────────────────────────────
+        // Every init'd project gets `workflow.subscriptionOnly: true`: workflow
+        // children ride the logged-in (subscription) harness auth, and the pin
+        // makes per-token API billing structurally impossible unless the project
+        // deliberately flips it. A committed `workflow` key of any shape is a
+        // deliberate choice and is never touched.
+        {
+            const stamp = stampWorkflowDefaults(resolve(coordDir, "config.jsonc"), dryRun);
+            if (stamp)
+                actions.push(stamp);
+        }
         // ── 2. harness hooks ───────────────────────────────────────────────────
         const settingsPath = resolve(projectRoot, spec.settingsFile);
         const agentHook = relative(projectRoot, resolve(HARNERY_ROOT, "bin", "agent-hook"));
@@ -110,19 +121,19 @@ export function registerInitCommand(program, emit, binName) {
         else {
             settings = {};
         }
-        const { wired, already, removed } = wireHooks(settings, spec, agentHook, harness);
-        if (wired === 0 && removed === 0) {
+        const { wired, already, removed, upgraded } = wireHooks(settings, spec, agentHook, harness);
+        if (wired === 0 && removed === 0 && upgraded === 0) {
             actions.push(`· all ${spec.events.length} ${harness} hooks already wired in ${rel(projectRoot, settingsPath)}`);
         }
         else if (dryRun) {
-            actions.push(`+ would wire ${wired} hook(s) and remove ${removed} legacy hook(s) in ` +
-                `${rel(projectRoot, settingsPath)} (${already} already present)`);
+            actions.push(`+ would wire ${wired} hook(s), upgrade ${upgraded} stale command(s), and remove ` +
+                `${removed} legacy hook(s) in ${rel(projectRoot, settingsPath)} (${already} already present)`);
         }
         else {
             mkdirSync(dirname(settingsPath), { recursive: true });
             writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
-            actions.push(`+ wired ${wired} hook(s) and removed ${removed} legacy hook(s) in ` +
-                `${rel(projectRoot, settingsPath)} (${already} already present)`);
+            actions.push(`+ wired ${wired} hook(s), upgraded ${upgraded} stale command(s), and removed ` +
+                `${removed} legacy hook(s) in ${rel(projectRoot, settingsPath)} (${already} already present)`);
         }
         // ── 3. agent-facing instructions block + skills ────────────────────────
         const applied = applyInstructions(projectRoot, { binName: bin, harness, dryRun });
@@ -132,11 +143,12 @@ export function registerInitCommand(program, emit, binName) {
 }
 /**
  * Merge agent-hook entries into a harness settings object in place, idempotently.
- * Preserves every existing hook; skips events already wired to
- * `agent-hook <subcommand>`. Honors the harness's entry shape (Claude/Codex nest
- * under an inner `hooks` array; Cursor uses a flat `{ command }`) and ensures the
- * root `version` key when the harness requires one. Pure (no fs/git) so it's
- * unit-testable.
+ * Preserves every existing hook; rewrites events already wired to
+ * `agent-hook <subcommand>` when their command string is stale (e.g. an older
+ * harnery wired a bare relative path). Honors the harness's entry shape
+ * (Claude/Codex nest under an inner `hooks` array; Cursor uses a flat
+ * `{ command }`) and ensures the root `version` key when the harness requires
+ * one. Pure (no fs/git) so it's unit-testable.
  *
  * The trailing space in the match (`agent-hook ${subcommand} `) is load-bearing:
  * it keeps `stop` from matching `stop-failure`.
@@ -150,6 +162,7 @@ export function wireHooks(settings, spec, agentHookPath, harness) {
     let wired = 0;
     let already = 0;
     let removed = 0;
+    let upgraded = 0;
     for (const { settingsKey, subcommand } of spec.legacyEvents ?? []) {
         const groups = settings.hooks[settingsKey] ?? [];
         const kept = groups.filter((group) => !groupCommands(group).some((command) => commandWiresSubcommand(command, subcommand)));
@@ -160,9 +173,14 @@ export function wireHooks(settings, spec, agentHookPath, harness) {
             settings.hooks[settingsKey] = kept;
     }
     for (const { settingsKey, subcommand } of spec.events) {
-        const command = `bash ${agentHookPath} ${subcommand} --harness ${harness}`;
+        const command = hookCommand(spec, agentHookPath, subcommand, harness);
         const groups = settings.hooks[settingsKey] ?? [];
-        const present = groups.some((g) => groupCommands(g).some((c) => commandWiresSubcommand(c, subcommand)));
+        let present = false;
+        for (const group of groups) {
+            upgraded += rewriteStaleCommands(group, subcommand, command, () => {
+                present = true;
+            });
+        }
         if (present) {
             already++;
             continue;
@@ -171,7 +189,52 @@ export function wireHooks(settings, spec, agentHookPath, harness) {
         settings.hooks[settingsKey] = groups;
         wired++;
     }
-    return { wired, already, removed };
+    return { wired, already, removed, upgraded };
+}
+/**
+ * The canonical hook command for one event. When the harness exports a
+ * project-dir env var to hook processes (Claude Code's CLAUDE_PROJECT_DIR),
+ * anchor the agent-hook path on it: hook processes inherit the session
+ * shell's cwd, which follows `cd` away from the project root — a bare
+ * relative path silently fails to spawn from there (no events, no image
+ * capture, no guards). `:-.` keeps the command working on harness versions
+ * that don't set the var. Only the env expansion is quoted so the
+ * `agent-hook <subcommand> ` wiring match stays byte-identical.
+ */
+function hookCommand(spec, agentHookPath, subcommand, harness) {
+    const anchor = spec.projectDirEnv ? `"\${${spec.projectDirEnv}:-.}"/` : "";
+    return `bash ${anchor}${agentHookPath} ${subcommand} --harness ${harness}`;
+}
+/**
+ * Rewrite any harnery-owned command for `subcommand` inside one hook group to
+ * the canonical form, in place. Returns the number of commands rewritten and
+ * calls `onPresent` when the subcommand is wired in this group at all.
+ */
+function rewriteStaleCommands(group, subcommand, canonical, onPresent) {
+    let rewritten = 0;
+    if ("command" in group && typeof group.command === "string") {
+        if (commandWiresSubcommand(group.command, subcommand)) {
+            onPresent();
+            if (group.command !== canonical) {
+                group.command = canonical;
+                rewritten++;
+            }
+        }
+    }
+    if ("hooks" in group && Array.isArray(group.hooks)) {
+        for (const hook of group.hooks) {
+            if (typeof hook.command !== "string")
+                continue;
+            if (!commandWiresSubcommand(hook.command, subcommand))
+                continue;
+            onPresent();
+            if (hook.command !== canonical) {
+                hook.command = canonical;
+                rewritten++;
+            }
+        }
+    }
+    return rewritten;
 }
 /**
  * Inverse of {@link wireHooks}: strip every harnery-owned hook entry from a
@@ -270,6 +333,54 @@ export function stampBinName(configPath, binName, dryRun) {
     writeFileSync(configPath, next);
     return `+ added binName "${binName}" to ${rel(configPath)}`;
 }
+/** The commented workflow-billing default block init stamps into config.jsonc. */
+const WORKFLOW_DEFAULT_BLOCK = `  // Workflow children ride the logged-in (subscription) harness auth; this pin\n` +
+    `  // scrubs API-key vars from child envs so runs can never bill per-token rates.\n` +
+    `  // Key-only hosts (CI): set false, or HARNERY_WORKFLOW_SUBSCRIPTION_ONLY=0.\n` +
+    `  "workflow": { "subscriptionOnly": true }`;
+/**
+ * Idempotently pin `workflow.subscriptionOnly: true` in `.harnery/config.jsonc`
+ * (see `workflowSubscriptionOnly()` in core/config.ts and the `workflow run`
+ * billing safeguards). Same comment-preserving discipline as `stampBinName`.
+ * A `workflow` key of ANY shape (including `subscriptionOnly: false`) is a
+ * deliberate project choice and is left alone.
+ */
+export function stampWorkflowDefaults(configPath, dryRun) {
+    const rel = (p) => relative(dirname(dirname(configPath)), p) || p;
+    if (!existsSync(configPath)) {
+        if (dryRun)
+            return `+ would pin workflow.subscriptionOnly in ${rel(configPath)}`;
+        writeFileSync(configPath, `{\n${WORKFLOW_DEFAULT_BLOCK}\n}\n`);
+        return `+ pinned workflow.subscriptionOnly: true in ${rel(configPath)}`;
+    }
+    let raw;
+    try {
+        raw = readFileSync(configPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(stripJsonComments(raw)) ?? {};
+    }
+    catch {
+        return `· ${rel(configPath)} isn't valid JSONC; skipped workflow.subscriptionOnly pin`;
+    }
+    if ("workflow" in parsed)
+        return null; // deliberate config; never touch
+    const at = firstBraceIndex(raw);
+    if (at < 0)
+        return `· ${rel(configPath)} has no object literal; skipped workflow pin`;
+    const keys = Object.keys(parsed);
+    const next = keys.length === 0
+        ? `{\n${WORKFLOW_DEFAULT_BLOCK}\n}\n`
+        : `${raw.slice(0, at + 1)}\n${WORKFLOW_DEFAULT_BLOCK},${raw.slice(at + 1)}`;
+    if (dryRun)
+        return `+ would pin workflow.subscriptionOnly in ${rel(configPath)}`;
+    writeFileSync(configPath, next);
+    return `+ pinned workflow.subscriptionOnly: true in ${rel(configPath)}`;
+}
 /** Index of the first structural `{`, skipping leading whitespace + comments. */
 function firstBraceIndex(raw) {
     let i = 0;

package/dist/commands/workflow.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+export declare function registerWorkflowCommand(program: Command, emit: EmitContext): void;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/commands/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA2BnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAuGjF"}

package/dist/commands/workflow.js

@@ -0,0 +1,89 @@
+import { workflowSubscriptionOnly } from "../core/config.js";
+import { findCoordRoot } from "../core/hooks/resolve/coord-root.js";
+const HARNESSES = ["claude-code", "codex", "cursor"];
+export function registerWorkflowCommand(program, emit) {
+    const workflow = program
+        .command("workflow")
+        .description("Run bounded, schema-gated multi-subagent workflow scripts.");
+    workflow
+        .command("run <script>")
+        .description("Execute a workflow script (plain JS: `export default async ({agent, parallel, stage, log}) => …`). " +
+        "Subagents spawn as headless harness-CLI subprocesses, coordination-registered.")
+        .option("--max-agents <n>", "Total-agent ceiling for the run (default 50)")
+        .option("--concurrency <n>", "Concurrent-subagent cap (default 4)")
+        .option("--cwd <dir>", "Working directory children spawn in (default: coord root)")
+        .option("--harness <name>", `Default harness for agent() calls: ${HARNESSES.join(" | ")} (default claude-code); scripts can override per agent via opts.harness`)
+        .option("--resume-from <run-id>", "Reuse completed agent results from a prior run's journal; only changed/failed calls re-run")
+        .option("--subscription-only", "Guarantee subscription billing: scrub API-key vars from child envs; fail loud when a " +
+        "harness has no stored login (repo default via config.jsonc workflow.subscriptionOnly)")
+        .option("--allow-api-billing", "Permit an exported API key to override a stored subscription login (per-token billing); " +
+        "without this the engine refuses that silent-override state")
+        .option("--json", "Emit the full RunReport as JSON")
+        .action(async (script, opts) => {
+        const coordRoot = findCoordRoot();
+        if (!coordRoot) {
+            emit.error({
+                code: "no_coord_root",
+                message: "no .harnery/ coordination root found; run `init` first",
+            });
+            process.exit(1);
+        }
+        if (opts.harness && !HARNESSES.includes(opts.harness)) {
+            emit.error({
+                code: "bad_harness",
+                message: `unknown harness "${opts.harness}" (expected: ${HARNESSES.join(" | ")})`,
+            });
+            process.exit(1);
+        }
+        // Flag beats config; the two flags contradict each other by design.
+        const subscriptionOnly = opts.subscriptionOnly || workflowSubscriptionOnly(coordRoot);
+        if (subscriptionOnly && opts.allowApiBilling) {
+            emit.error({
+                code: "billing_flags_conflict",
+                message: "--allow-api-billing contradicts subscription-only mode " +
+                    "(flag or config.jsonc workflow.subscriptionOnly); pick one",
+            });
+            process.exit(1);
+        }
+        try {
+            const [{ runWorkflow }, { claudeCodeSpawner }, { codexSpawner }, { cursorSpawner }] = await Promise.all([
+                import("../core/workflow/engine.js"),
+                import("../core/workflow/spawn-claude.js"),
+                import("../core/workflow/spawn-codex.js"),
+                import("../core/workflow/spawn-cursor.js"),
+            ]);
+            const report = await runWorkflow(script, {
+                coordRoot,
+                spawners: {
+                    "claude-code": claudeCodeSpawner,
+                    codex: codexSpawner,
+                    cursor: cursorSpawner,
+                },
+                defaultHarness: opts.harness,
+                resumeFrom: opts.resumeFrom,
+                subscriptionOnly,
+                allowApiBilling: opts.allowApiBilling,
+                maxAgents: opts.maxAgents ? Number.parseInt(opts.maxAgents, 10) : undefined,
+                concurrency: opts.concurrency ? Number.parseInt(opts.concurrency, 10) : undefined,
+                cwd: opts.cwd,
+            });
+            if (opts.json) {
+                emit.config({ format: "json" });
+                emit.data(report);
+                return;
+            }
+            const cachedPart = report.agentsCached > 0 ? ` (+${report.agentsCached} cached)` : "";
+            const billingPart = report.billing.length
+                ? `billing: ${report.billing.map((b) => `${b.harness}=${b.mode}`).join(", ")}\n`
+                : "";
+            emit.text(`run ${report.runId} (${report.name}) finished: ${report.agentsSpawned} agent(s)${cachedPart}, ` +
+                `$${report.costUsd.toFixed(4)}, ${Math.round(report.durationMs / 1000)}s\n${billingPart}` +
+                `journal: ${report.journalPath}\n` +
+                `result: ${typeof report.result === "string" ? report.result : JSON.stringify(report.result, null, 2)}\n`);
+        }
+        catch (err) {
+            emit.error({ code: "workflow_failed", message: err.message });
+            process.exit(1);
+        }
+    });
+}

package/dist/core/agents/cli.js

@@ -427,11 +427,16 @@ async function handlePostCommit(root) {
     }
     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).
+    // 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 {
-                groupUnclaim(root, req.owner, path);
+                for (const hit of groupUnclaim(root, req.owner, path)) {
+                    await emitClaimRelease(root, hit.instance_id, hit, path, "commit");
+                }
             }
             catch {
                 /* best-effort */
@@ -453,7 +458,9 @@ async function handlePostCheckout(root, _rest) {
     if (req.owner && Array.isArray(req.removed)) {
         for (const path of req.removed) {
             try {
-                groupUnclaim(root, req.owner, path);
+                for (const hit of groupUnclaim(root, req.owner, path)) {
+                    await emitClaimRelease(root, hit.instance_id, hit, path, "checkout");
+                }
             }
             catch {
                 /* best-effort */

package/dist/core/agents/rules/claim-conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAeF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CAoGjF"}
+{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAeF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CAoGjF"}

package/dist/core/agents/rules/claim-conflict.js

@@ -16,6 +16,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { emit } from "../events/emit.js";
 const FRESHNESS_SECS = 600;
 /**
  * Evaluate a file-claim. Returns deny when another fresh peer claims the
@@ -267,13 +268,37 @@ function pruneClaimFromPeer(coordRoot, instanceId, relPath) {
     try {
         const body = JSON.parse(readFileSync(path, "utf8"));
         const files = body.files_touched ?? [];
-        const next = files.filter((p) => p !== relPath);
+        // Normalize both sides: files_touched can hold absolute-under-coordRoot
+        // entries (legacy projections) as well as canonical relative ones — an
+        // exact-string filter silently no-ops on the mixed-form case and the
+        // stale claim never heals.
+        const norm = (p) => p.startsWith(`${coordRoot}/`) ? p.slice(coordRoot.length + 1) : p;
+        const target = norm(relPath);
+        const next = files.filter((p) => norm(p) !== target);
         if (next.length === files.length)
             return;
         body.files_touched = next;
         const tmp = `${path}.tmp.${process.pid}`;
         writeFileSync(tmp, JSON.stringify(body, null, 2), "utf8");
         renameSync(tmp, path);
+        // Durable subtraction: the projector rebuilds files_touched from the
+        // permanent Edit/Write events, so a file-only prune resurrects on the
+        // next replay. Soft-fail — the heartbeat write already landed.
+        try {
+            const platform = body.platform;
+            emit(coordRoot, {
+                event_type: "claim.release",
+                instance_id: instanceId,
+                session_id: body.session_id ?? instanceId,
+                harness: platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code",
+                source: "agent-coord",
+                data: { path: target, reason: "heal" },
+                // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+            });
+        }
+        catch {
+            /* soft-fail */
+        }
     }
     catch {
         /* silent */

package/dist/core/agents/rules/stop-hook.d.ts

@@ -34,6 +34,14 @@ export interface StopHookRequest {
     };
     /** Bypass switch: operator escape hatch identical to HARNERY_AGENT_COORD_BYPASS_STOP. */
     bypass?: boolean;
+    /** Headless child spawned by `harn workflow` (HARNERY_WORKFLOW_CHILD=1).
+     * The end-of-turn ritual exists to surface status to a HUMAN reader; a
+     * workflow child reports to the engine's journal instead, so the ritual is
+     * meaningless there — worse, blocking burns the child's turn budget on
+     * re-prompts (observed as error_max_turns in the Phase 1 spike). Exempting
+     * here, rather than disabling the child's hooks wholesale, keeps heartbeat +
+     * event capture on: the child stays visible to peers and the coord layer. */
+    workflow_child?: boolean;
 }
 /**
  * Evaluate the Stop-hook verdict. Returns the first failing rule (or allow

package/dist/core/agents/rules/stop-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;4EACwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA2FvF"}
+{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;4EACwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;iFAM6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA+BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CAoGvF"}

package/dist/core/agents/rules/stop-hook.js

@@ -33,6 +33,14 @@ export function evaluateStopHook(coordRoot, req) {
             reason: "HARNERY_AGENT_COORD_BYPASS_STOP=1",
         };
     }
+    if (req.workflow_child) {
+        return {
+            allow: true,
+            exit_code: 0,
+            rule: "stop-hook.workflow_child",
+            reason: "HARNERY_WORKFLOW_CHILD=1: headless workflow child; ritual not applicable",
+        };
+    }
     let events;
     try {
         events = readRecentEvents(coordRoot, RECENT_EVENT_WINDOW_LINES);

package/dist/core/agents/state/heartbeat-projector.d.ts

@@ -20,6 +20,8 @@ export interface V2Heartbeat {
     platform?: string;
     subagent_call_id?: string;
     parent_session_id?: string;
+    /** Set iff this owner is a `workflow run` child (joins to the run journal). */
+    workflow_run_id?: string;
     started_at?: string;
     last_heartbeat: string;
     last_tool?: string;

package/dist/core/agents/state/heartbeat-projector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-projector.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,CAAC,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,cAAc,EAAE,GAChC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAE,CAoD9D;AAsWD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"heartbeat-projector.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,CAAC,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,cAAc,EAAE,GAChC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAE,CAoD9D;AAgXD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/core/agents/state/heartbeat-projector.js

@@ -138,6 +138,9 @@ function apply(hb, ev, coordRoot) {
                 const parentSession = pickStr(d, "parent_session_id");
                 if (parentSession)
                     hb.parent_session_id = parentSession;
+                const workflowRunId = pickStr(d, "workflow_run_id");
+                if (workflowRunId)
+                    hb.workflow_run_id = workflowRunId;
                 if (!hb.files_touched)
                     hb.files_touched = [];
             }
@@ -202,10 +205,17 @@ function apply(hb, ev, coordRoot) {
             if (toolName === "Edit" || toolName === "Write" || toolName === "NotebookEdit") {
                 const target = extractFilePath(d);
                 if (target) {
+                    // Canonicalize to repo-relative before storing: the claim guard
+                    // writes canonical paths directly, so an absolute entry here would
+                    // double-count the same file (inflated "N files" display) and
+                    // defeat exact-match pruning on commit.
+                    const canonical = target.startsWith(`${coordRoot}/`)
+                        ? target.slice(coordRoot.length + 1)
+                        : target;
                     if (!hb.files_touched)
                         hb.files_touched = [];
-                    if (!hb.files_touched.includes(target))
-                        hb.files_touched.push(target);
+                    if (!hb.files_touched.includes(canonical))
+                        hb.files_touched.push(canonical);
                 }
             }
             break;
@@ -391,6 +401,7 @@ function writeHeartbeat(coordRoot, instanceId, hb) {
         setIfDefined(merged, "kind", hb.kind);
         setIfDefined(merged, "agent_id", hb.agent_id);
         setIfDefined(merged, "subagent_call_id", hb.subagent_call_id);
+        setIfDefined(merged, "workflow_run_id", hb.workflow_run_id);
         setIfDefined(merged, "model", hb.model);
         setIfDefined(merged, "platform", hb.platform);
         setIfDefined(merged, "started_at", hb.started_at);

package/dist/core/agents/state/heartbeat-writer.d.ts

@@ -42,17 +42,31 @@ export declare function setTask(coordRoot: string, instanceId: string, task: str
 export declare function stampStatusCheck(coordRoot: string, instanceId: string): Heartbeat | null;
 export declare function setTurnSummary(coordRoot: string, instanceId: string, summary: string): Heartbeat | null;
 export declare function releaseClaim(coordRoot: string, instanceId: string, path: string): Heartbeat | null;
+/** A heartbeat that actually dropped a path during a group unclaim. */
+export interface GroupUnclaimHit {
+    instance_id: string;
+    session_id?: string;
+    platform?: string;
+}
 /**
  * Session-group-wide unclaim. Walks every heartbeat sharing `groupId`
  * (parent's session_id == group_id;
  * subagents inherit it) and removes the path from each one's files_touched.
- * Idempotent: heartbeats that don't hold the path are untouched.
+ * Idempotent: heartbeats that don't hold the path are untouched. Returns the
+ * heartbeats that actually dropped the path so the caller can emit the
+ * durable `claim.release` events — a file-only prune is silently reverted by
+ * the next projector replay.
+ *
+ * files_touched can hold either absolute-under-coordRoot or canonical
+ * repo-relative entries (legacy projections stored the raw tool_input path),
+ * so both sides are normalized before comparing — an exact-string match
+ * silently no-ops on the mixed-form case and the claim never releases.
  *
  * This is the Option B fix for post-commit's pid-map attribution hole: a
  * subagent-held claim that doesn't live on the parent's heartbeat still gets
  * pruned because the walk covers the whole group.
  */
-export declare function groupUnclaim(coordRoot: string, groupId: string, path: string): void;
+export declare function groupUnclaim(coordRoot: string, groupId: string, path: string): GroupUnclaimHit[];
 export declare function killHeartbeat(coordRoot: string, instanceId: string): boolean;
 export declare function healPidmap(coordRoot: string, instanceId: string, pid: number): void;
 export declare function healHeartbeat(coordRoot: string, instanceId: string, sessionId?: string, model?: string, harness?: string): Heartbeat | null;

package/dist/core/agents/state/heartbeat-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6DH,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAiBD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQrF;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAS7F;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKxF;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAMlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAYlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA4BnF;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAS5E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAuBnF;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,GAAG,IAAI,CAqDlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CAOlB"}
+{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6DH,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAiBD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQrF;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAS7F;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKxF;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAMlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAYlB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAsChG;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAS5E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAuBnF;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,GAAG,IAAI,CAqDlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CAOlB"}

package/dist/core/agents/state/heartbeat-writer.js

@@ -129,18 +129,29 @@ export function releaseClaim(coordRoot, instanceId, path) {
  * Session-group-wide unclaim. Walks every heartbeat sharing `groupId`
  * (parent's session_id == group_id;
  * subagents inherit it) and removes the path from each one's files_touched.
- * Idempotent: heartbeats that don't hold the path are untouched.
+ * Idempotent: heartbeats that don't hold the path are untouched. Returns the
+ * heartbeats that actually dropped the path so the caller can emit the
+ * durable `claim.release` events — a file-only prune is silently reverted by
+ * the next projector replay.
+ *
+ * files_touched can hold either absolute-under-coordRoot or canonical
+ * repo-relative entries (legacy projections stored the raw tool_input path),
+ * so both sides are normalized before comparing — an exact-string match
+ * silently no-ops on the mixed-form case and the claim never releases.
  *
  * This is the Option B fix for post-commit's pid-map attribution hole: a
  * subagent-held claim that doesn't live on the parent's heartbeat still gets
  * pruned because the walk covers the whole group.
  */
 export function groupUnclaim(coordRoot, groupId, path) {
+    const hits = [];
     if (!groupId || !path)
-        return;
+        return hits;
     const activeDir = join(coordRoot, ".harnery", "active");
     if (!existsSync(activeDir))
-        return;
+        return hits;
+    const norm = (p) => p.startsWith(`${coordRoot}/`) ? p.slice(coordRoot.length + 1) : p;
+    const target = norm(path);
     for (const f of readdirSync(activeDir)) {
         if (!f.endsWith(".json"))
             continue;
@@ -156,7 +167,7 @@ export function groupUnclaim(coordRoot, groupId, path) {
         if (peerSession !== groupId)
             continue;
         const files = body.files_touched ?? [];
-        const next = files.filter((p) => p !== path);
+        const next = files.filter((p) => norm(p) !== target);
         if (next.length === files.length)
             continue;
         body.files_touched = next;
@@ -164,11 +175,17 @@ export function groupUnclaim(coordRoot, groupId, path) {
             const tmp = `${hbPath}.tmp.${process.pid}`;
             writeFileSync(tmp, JSON.stringify(body, null, 2), "utf8");
             renameSync(tmp, hbPath);
+            hits.push({
+                instance_id: body.instance_id ?? f.replace(/\.json$/, ""),
+                session_id: body.session_id,
+                platform: body.platform,
+            });
         }
         catch {
             /* silent */
         }
     }
+    return hits;
 }
 export function killHeartbeat(coordRoot, instanceId) {
     const path = heartbeatPath(coordRoot, instanceId);