harnery 0.8.0 → 0.10.0

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

@@ -22,8 +22,8 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { coordEnv } from "../../../lib/env.js";
-const DEFAULT_FRESHNESS_SECS = 600;
+import { coordFreshnessSeconds } from "../../config.js";
+import { instanceHasLivePid } from "../state/pidmap.js";
 export function evaluateCommit(coordRoot, req) {
     if (req.staged_paths.length === 0) {
         return {
@@ -36,7 +36,7 @@ export function evaluateCommit(coordRoot, req) {
         };
     }
     const peers = readActivePeers(coordRoot);
-    const cutoffMs = Date.now() - freshnessSecs() * 1000;
+    const cutoffMs = Date.now() - coordFreshnessSeconds(coordRoot) * 1000;
     const stagedSet = new Set(req.staged_paths);
     const gitlinkSet = new Set(req.staged_gitlinks ?? []);
     const conflicts = [];
@@ -166,33 +166,7 @@ function isHolderSelfAttributed(coordRoot, holderId, stagedSet, peers) {
     return true;
 }
 function holderHasLiveForeignPid(coordRoot, holderId) {
-    const dir = join(coordRoot, ".harnery", "pid-map");
-    if (!existsSync(dir))
-        return false;
-    for (const f of readdirSync(dir)) {
-        let row = "";
-        try {
-            row = readFileSync(join(dir, f), "utf8").trim();
-        }
-        catch {
-            continue;
-        }
-        const owner = row.split("\t")[0]?.trim() ?? "";
-        if (owner !== holderId)
-            continue;
-        // Process still alive?
-        const pid = Number.parseInt(f, 10);
-        if (!Number.isFinite(pid))
-            continue;
-        try {
-            process.kill(pid, 0); // signal 0 = liveness probe
-            return true; // live foreign pid found
-        }
-        catch {
-            // ESRCH (no such process): pid-map entry is stale, skip
-        }
-    }
-    return false;
+    return instanceHasLivePid(coordRoot, holderId);
 }
 function isPathCleanInHead(coordRoot, relPath) {
     // Path is tracked + diff-clean against HEAD = "already committed, holder
@@ -230,13 +204,6 @@ function readActivePeers(coordRoot) {
     }
     return out;
 }
-function freshnessSecs() {
-    const raw = coordEnv("AGENT_FRESHNESS");
-    if (!raw)
-        return DEFAULT_FRESHNESS_SECS;
-    const n = Number.parseInt(raw, 10);
-    return Number.isFinite(n) && n > 0 ? n : DEFAULT_FRESHNESS_SECS;
-}
 function shortName(peer) {
     if (peer.name && peer.name.length > 0)
         return `agent-${peer.name}`;

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/session-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-events.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;iFAEiF;AACjF,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,QAAQ,GACR,aAAa,GACb,aAAa,GACb,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,WAAW,CAAC;AAEhB;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAwB1C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BjE;AAsGD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAEN;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"session-events.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;iFAEiF;AACjF,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,QAAQ,GACR,aAAa,GACb,aAAa,GACb,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,WAAW,CAAC;AAEhB;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAa1C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAsGD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAEN;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAGxD"}

package/dist/core/agents/session-events.js

@@ -8,10 +8,10 @@
  * middleware callers need no edits.
  */
 import { randomBytes } from "node:crypto";
-import { existsSync, readFileSync, statSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 // Kept dependency-light: vendored verbatim into a downstream consumer, so no coordEnv import.
-import { normalizeHarness } from "./canonical-emit.js";
+import { normalizeHarness, resolveEmitRoot } from "./canonical-emit.js";
 import { emit } from "./events/emit.js";
 /**
  * Resolved path of the ndjson sidecar file. Lives inside `.harnery/` so a
@@ -22,27 +22,15 @@ export function sessionEventsPath() {
     const explicit = process.env.HARNERY_OUTPUT_SESSION_EVENTS;
     if (explicit)
         return explicit;
-    // Walk up looking for an EXISTING .harnery/ directory; only match dirs
-    // (submodule .git is a file/gitlink, and CLAUDE.md / AGENTS.md can
-    // proliferate per-subdirectory in many monorepos, so neither is a safe
-    // anchor). Don't reintroduce CLAUDE.md / .git as anchors, which creates
+    // Superproject-aware root resolution (git first, cwd walk fallback) via
+    // resolveEmitRoot. A plain cwd walk here mis-anchored to a NESTED
+    // `.harnery/` when the shell sat inside a submodule carrying its own
+    // (e.g. an embedded harnery checkout), silently splitting the event
+    // stream. Don't reintroduce CLAUDE.md / .git as anchors, which creates
     // stray .harnery/ dirs under submodule subtrees.
-    let dir = process.cwd();
-    for (let i = 0; i < 10; i++) {
-        const candidate = resolve(dir, ".harnery");
-        try {
-            if (existsSync(candidate) && statSync(candidate).isDirectory()) {
-                return resolve(candidate, "session-events.ndjson");
-            }
-        }
-        catch {
-            /* keep walking */
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
+    const root = resolveEmitRoot();
+    if (root)
+        return resolve(root, ".harnery", "session-events.ndjson");
     return resolve(process.env.HOME || "/tmp", ".harnery", "session-events.ndjson");
 }
 /** Random 8-char hex id for grouping output lines under a single command. */
@@ -60,28 +48,13 @@ export function newCmdId() {
 export function readLastIntent(instanceId) {
     if (!instanceId)
         return null;
-    // Walk up from cwd looking for .harnery/, same resolution as
-    // sessionEventsPath() (only match existing directories).
-    let dir = process.cwd();
-    let agentsDir = null;
-    for (let i = 0; i < 10; i++) {
-        const candidate = resolve(dir, ".harnery");
-        try {
-            if (existsSync(candidate) && statSync(candidate).isDirectory()) {
-                agentsDir = candidate;
-                break;
-            }
-        }
-        catch {
-            /* keep walking */
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    if (!agentsDir)
+    // Same superproject-aware root resolution as sessionEventsPath(): the
+    // intent stamp is written by the PreToolUse hook into the SUPERPROJECT's
+    // .harnery/, so a nested-`.harnery/` cwd must not redirect the read.
+    const root = resolveEmitRoot();
+    if (!root)
         return null;
+    const agentsDir = resolve(root, ".harnery");
     const intentPath = resolve(agentsDir, `.last-intent.${instanceId}`);
     if (!existsSync(intentPath))
         return null;

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;AAyXD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}

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

@@ -92,8 +92,8 @@ function seed(ev, coordRoot) {
         if (resolved) {
             hb.name = resolved.name;
             hb.kind = resolved.kind;
-            if (resolved.kind === "subagent")
-                hb.agent_id = ev.instance_id;
+            hb.agent_id =
+                resolved.agent_id ?? (resolved.kind === "subagent" ? ev.instance_id : undefined);
         }
     }
     catch {
@@ -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;
@@ -229,6 +239,15 @@ function apply(hb, ev, coordRoot) {
         case "state.status_checked":
             hb.last_status_at = ev.ts;
             break;
+        case "identity.assumed": {
+            const name = pickStr(d, "name");
+            const agentId = pickStr(d, "agent_id");
+            if (name)
+                hb.name = name;
+            if (agentId)
+                hb.agent_id = agentId;
+            break;
+        }
         case "state.presence_change": {
             const to = pickStr(d, "to");
             if (to === "mobile" || to === "office")
@@ -391,6 +410,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,CAsDlB;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);
@@ -228,9 +245,9 @@ export function healHeartbeat(coordRoot, instanceId, sessionId, model, harness)
         if (resolved) {
             name = resolved.name;
             kind = resolved.kind;
-            // subagent kind: agent_id == instance_id. Else (session/transient): no id stamp.
-            if (resolved.kind === "subagent")
-                agentId = instanceId;
+            // An explicitly assumed session carries its durable persona UUID in
+            // name-history. Native subagents continue to use instance_id.
+            agentId = resolved.agent_id ?? (resolved.kind === "subagent" ? instanceId : "");
         }
     }
     catch {

package/dist/core/agents/state/names.d.ts

@@ -8,14 +8,30 @@
  * Durable persistence: `.harnery/.name-history` (JSONL, one row per assignment)
  * + `.harnery/.name-counter` (current counter, atomic temp+rename).
  *
- * Recreation rule (mirrors v1):
- *   1. Own instance_id in name-history → (original name, original kind)
- *   2. session_id in name-history (owner != session) → (parent's name, "transient")
+ * Recreation rule:
+ *   1. Own instance_id in name-history → latest (name, kind, agent_id)
+ *   2. session_id in name-history (owner != session) → latest parent's
+ *      (name, agent_id) with kind="transient"
+ *
+ * Multiple rows for one instance are intentional. `identity assume` appends a
+ * new binding instead of rewriting history; readers therefore resolve from the
+ * end of the file. Older one-row histories retain their original behavior.
  *   3. Else: new assignment, consume a counter slot.
  */
 /** All 260 names. */
 export declare const COORD_NAMES: readonly ["Anna", "Bob", "Carlos", "Dalia", "Erika", "Fred", "Gemma", "Hank", "Imelda", "Jerry", "Kirk", "Lee", "Milton", "Nate", "Oscar", "Patty", "Quentin", "Rafael", "Sara", "Tony", "Ulrik", "Valerie", "Whitney", "Xander", "Yara", "Zara", "Adelaide", "Bertha", "Carmen", "Dorian", "Edna", "Francine", "Greta", "Helene", "Ines", "Joyce", "Karen", "Lorenzo", "Mindy", "Nadine", "Odette", "Paulette", "Quinn", "Rebekah", "Sean", "Tammy", "Ursula", "Vinson", "Wallace", "Xanthe", "Yusuf", "Zoe", "Alex", "Beatrice", "Cyrus", "Delia", "Ernesto", "Florence", "Gordon", "Hester", "Isaias", "Jenna", "Klaus", "Larry", "Maxine", "Nicholas", "Otto", "Peter", "Quill", "Renee", "Stella", "Theresa", "Umberto", "Virgil", "Willow", "Xavier", "Yolanda", "Zane", "Anita", "Bruno", "Cora", "Damon", "Edith", "Felix", "Gloria", "Holly", "Iris", "Jasper", "Kaia", "Linda", "Marco", "Nora", "Olive", "Petra", "Querida", "Roman", "Sebastian", "Tobias", "Una", "Vera", "Walter", "Xena", "Yusra", "Zelda", "Aaron", "Bonnie", "Caleb", "Daphne", "Elias", "Fiona", "Galileo", "Hugo", "Ian", "Jude", "Knox", "Leo", "Maya", "Nash", "Owen", "Paxton", "Quetzal", "Rosa", "Sage", "Talia", "Uri", "Vincent", "Wesley", "Ximena", "Yvette", "Zephyr", "Astrid", "Beau", "Celeste", "Dexter", "Ezra", "Fitz", "Genevieve", "Hadley", "Imogen", "Joaquin", "Kira", "Lila", "Mason", "Nila", "Olga", "Pearl", "Quincy", "Royce", "Sterling", "Trent", "Ulysses", "Violet", "Wynne", "Xerxes", "Yael", "Zinnia", "Amelia", "Bianca", "Cody", "Dahlia", "Esme", "Fern", "Greer", "Harriet", "Ivan", "Juno", "Kendrick", "Luther", "Margot", "Nigel", "Orion", "Phillip", "Quenby", "Reagan", "Sienna", "Tessa", "Uma", "Vesper", "Watson", "Xiomara", "Yuri", "Zoltan", "Andre", "Boris", "Cassidy", "Davis", "Evander", "Forrest", "Gibson", "Henry", "Irene", "Justus", "Kasper", "Lainey", "Miles", "Naomi", "Ophelia", "Phoebe", "Quark", "Rylie", "Saul", "Truman", "Ulrich", "Voss", "Winifred", "Xuxa", "Yvonne", "Zia", "Aria", "Brenda", "Crispin", "Dolores", "Estelle", "Felicity", "Goldie", "Hazel", "Ira", "Jovi", "Kestrel", "Lyric", "Mavis", "Nico", "Otis", "Percy", "Querubin", "Rhett", "Scout", "Tatum", "Unity", "Vivian", "Wyatt", "Xan", "Yancy", "Zev", "Atticus", "Barnaby", "Calliope", "Drake", "Eustace", "Foster", "Granger", "Hollis", "Indira", "Jericho", "Kaleb", "Logan", "Magnus", "Noor", "Oakley", "Posy", "Quito", "Rosalind", "Sloane", "Theron", "Upton", "Vance", "Wendell", "Xola", "Yann", "Zora"];
 export type NameKind = "session" | "subagent" | "transient";
+export interface NameHistoryRow {
+    instance_id: string;
+    name: string;
+    kind: NameKind;
+    ts: string;
+    /** Durable persona UUID. Present after `agents identity assume`. */
+    agent_id?: string;
+    /** Audit marker distinguishing an explicit role adoption from pool assignment. */
+    source?: "pool" | "identity.assume";
+    previous_name?: string;
+}
 /**
  * Resolve (name, kind) for an existing owner without consuming a counter
  * slot. Returns null if no history match found.
@@ -26,7 +42,26 @@ export type NameKind = "session" | "subagent" | "transient";
 export declare function resolveName(coordRoot: string, instanceId: string, sessionId?: string): {
     name: string;
     kind: NameKind;
+    agent_id?: string;
 } | null;
+export interface NameAssumptionResult {
+    changed: boolean;
+    previous: {
+        name: string;
+        kind: NameKind;
+        agent_id?: string;
+    } | null;
+    current: {
+        name: string;
+        kind: NameKind;
+        agent_id: string;
+    };
+}
+/**
+ * Append an explicit instance → durable-persona binding. Latest-row-wins makes
+ * this auditable and retry-safe without mutating prior assignment history.
+ */
+export declare function recordNameAssumption(coordRoot: string, instanceId: string, name: string, agentId: string, kind?: NameKind): NameAssumptionResult;
 /**
  * Assign a name to <instanceId> with the given <kind>. Counter-consuming when
  * the owner is new. Idempotent: returns existing name on resume.

package/dist/core/agents/state/names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,qBAAqB;AACrB,eAAO,MAAM,WAAW,y5EA+Qd,CAAC;AAMX,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AA6C5D;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,IAAI,CAkBzC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAqBxF"}
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,qBAAqB;AACrB,eAAO,MAAM,WAAW,y5EA+Qd,CAAC;AAMX,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAsCD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4B5D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAoB,GACzB,oBAAoB,CAoBtB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAsBxF"}

package/dist/core/agents/state/names.js

@@ -8,9 +8,14 @@
  * Durable persistence: `.harnery/.name-history` (JSONL, one row per assignment)
  * + `.harnery/.name-counter` (current counter, atomic temp+rename).
  *
- * Recreation rule (mirrors v1):
- *   1. Own instance_id in name-history → (original name, original kind)
- *   2. session_id in name-history (owner != session) → (parent's name, "transient")
+ * Recreation rule:
+ *   1. Own instance_id in name-history → latest (name, kind, agent_id)
+ *   2. session_id in name-history (owner != session) → latest parent's
+ *      (name, agent_id) with kind="transient"
+ *
+ * Multiple rows for one instance are intentional. `identity assume` appends a
+ * new binding instead of rewriting history; readers therefore resolve from the
+ * end of the file. Older one-row histories retain their original behavior.
  *   3. Else: new assignment, consume a counter slot.
  */
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
@@ -333,20 +338,53 @@ function appendHistory(coordRoot, row) {
  */
 export function resolveName(coordRoot, instanceId, sessionId) {
     const history = readHistory(coordRoot);
-    for (const row of history) {
+    for (let i = history.length - 1; i >= 0; i--) {
+        const row = history[i];
         if (row.instance_id === instanceId) {
-            return { name: row.name, kind: row.kind };
+            return {
+                name: row.name,
+                kind: row.kind,
+                ...(row.agent_id ? { agent_id: row.agent_id } : {}),
+            };
         }
     }
     if (sessionId && sessionId !== instanceId) {
-        for (const row of history) {
+        for (let i = history.length - 1; i >= 0; i--) {
+            const row = history[i];
             if (row.instance_id === sessionId) {
-                return { name: row.name, kind: "transient" };
+                return {
+                    name: row.name,
+                    kind: "transient",
+                    ...(row.agent_id ? { agent_id: row.agent_id } : {}),
+                };
             }
         }
     }
     return null;
 }
+/**
+ * Append an explicit instance → durable-persona binding. Latest-row-wins makes
+ * this auditable and retry-safe without mutating prior assignment history.
+ */
+export function recordNameAssumption(coordRoot, instanceId, name, agentId, kind = "session") {
+    const previous = resolveName(coordRoot, instanceId);
+    const current = { name, kind, agent_id: agentId };
+    if (previous?.name === current.name &&
+        previous.kind === current.kind &&
+        previous.agent_id === current.agent_id) {
+        return { changed: false, previous, current };
+    }
+    appendHistory(coordRoot, {
+        instance_id: instanceId,
+        name,
+        kind,
+        agent_id: agentId,
+        source: "identity.assume",
+        previous_name: previous?.name,
+        ts: new Date().toISOString().replace(/\.\d{3}Z$/, "Z"),
+    });
+    return { changed: true, previous, current };
+}
 /**
  * Assign a name to <instanceId> with the given <kind>. Counter-consuming when
  * the owner is new. Idempotent: returns existing name on resume.
@@ -370,6 +408,7 @@ export function assignName(coordRoot, instanceId, kind) {
         instance_id: instanceId,
         name,
         kind,
+        source: "pool",
         ts: new Date().toISOString().replace(/\.\d{3}Z$/, "Z"),
     });
     return name;

package/dist/core/agents/state/pidmap.d.ts

@@ -1,5 +1,5 @@
 /**
- * Pid-map writer.
+ * Pid-map writer + liveness helpers.
  *
  * Per-harness pid-map at `.harnery/pid-map/<pid>` containing
  * `<instance_id>\t<platform>`. `harn agents whoami` walks ppid up 20 hops looking
@@ -8,4 +8,8 @@
  * Atomic temp+rename. Idempotent: re-writing the same row is a no-op.
  */
 export declare function writePidmapRow(coordRoot: string, pid: number, instanceId: string, platform: string): void;
+/** True when any pid-map row for `instanceId` still belongs to a live process. */
+export declare function instanceHasLivePid(coordRoot: string, instanceId: string): boolean;
+/** Drop every pid-map row owned by `instanceId`. Returns how many files were removed. */
+export declare function removePidmapRowsForInstance(coordRoot: string, instanceId: string): number;
 //# sourceMappingURL=pidmap.d.ts.map

package/dist/core/agents/state/pidmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pidmap.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/pidmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAYN"}
+{"version":3,"file":"pidmap.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/pidmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAYN;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAsBjF;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAqBzF"}