harnery 0.35.0 → 0.36.0

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

@@ -62,13 +62,21 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
     const ownerEvents = events.filter((event) => event.scope.instance_id === owner &&
         "generation_id" in event.scope &&
         event.scope.generation_id === generationId);
+    const fallbackStartMs = Math.max(0, endMs - 5 * 60 * 1000);
+    const claudeContinuation = req.adapter === "claude-code" && req.stop_hook_active === true;
+    const resolvedStart = resolveTurnStart(ownerEvents, endMs, claudeContinuation);
+    const resolvedStartMs = eventTimeMs(resolvedStart);
     const startMs = req.turn_window?.start_ms ??
-        resolveTurnStartMs(ownerEvents, endMs, Math.max(0, endMs - 5 * 60 * 1000));
+        (Number.isFinite(resolvedStartMs) ? resolvedStartMs : fallbackStartMs);
     const inTurn = ownerEvents.filter((event) => {
         const time = eventTimeMs(event);
         return Number.isFinite(time) && time >= startMs && time <= endMs;
     });
-    const usedTool = inTurn.some((event) => event.event_type === "tool.requested");
+    const policyEvents = claudeContinuation && resolvedStart
+        ? originalTurnEvents(ownerEvents, resolvedStart, endMs)
+        : inTurn;
+    const usedTool = policyEvents.some((event) => event.event_type === "tool.requested");
+    const cycleAnchor = remediationCycleAnchor(resolvedStart, startMs);
     const statusEvents = inTurn.filter((event) => event.event_type === "coord.status_observed" && event.payload.subject_instance_id === owner);
     const statusChecked = statusEvents.length > 0;
     const requiredStatusChecked = agentsRequireGitFinalization(coordRoot)
@@ -79,10 +87,18 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
     const turnTerminals = inTurn.filter((event) => event.event_type === "turn.completed");
     const latestTerminal = turnTerminals.at(-1);
     const latestBox = observedBoolean(latestTerminal?.payload.ritual?.status_box_present_strict);
-    if (req.adapter !== "cursor" && latestBox === undefined) {
+    const strictBoxObservations = turnTerminals
+        .map((event) => observedBoolean(event.payload.ritual?.status_box_present_strict))
+        .filter((value) => value !== undefined);
+    const currentStrictBox = claudeContinuation ? req.status_box_present_strict : undefined;
+    if (req.adapter !== "cursor" && latestBox === undefined && currentStrictBox === undefined) {
         return evidenceUnavailable("turn.completed has no observed V3 assistant-text status-box result; Stop remains fail-open");
     }
-    const ackPresent = req.adapter === "cursor" ? requiredStatusChecked : latestBox === true;
+    const ackPresent = req.adapter === "cursor"
+        ? requiredStatusChecked
+        : claudeContinuation
+            ? strictBoxObservations.includes(true) || currentStrictBox === true
+            : latestBox === true;
     const ackBlock = req.adapter === "cursor"
         ? () => rule13Block(coordRoot, req.session_id)
         : () => rule23Block(coordRoot, req.session_id);
@@ -90,7 +106,7 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
     // task or final-status mutations. This preserves the pre-V3 policy exactly.
     if (!usedTool) {
         if (!ackPresent)
-            return ackBlock();
+            return withCycleAnchor(ackBlock(), cycleAnchor);
         return {
             allow: true,
             exit_code: 0,
@@ -98,12 +114,17 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
             reason: "no tool calls this turn; task and final-status mutations were not required",
         };
     }
+    // Collect EVERY missing signal before returning. Reporting them one at a
+    // time made each additional missing signal cost a whole continuation, and
+    // every continuation forks a fresh hook process: on a busy multi-agent host
+    // the ritual's own enforcement became part of the hook load it polices.
+    const pending = [];
     if (!requiredStatusChecked)
-        return rule13Block(coordRoot, req.session_id);
+        pending.push(rule13Block(coordRoot, req.session_id));
     if (!ackPresent)
-        return ackBlock();
+        pending.push(ackBlock());
     if (!taskSet)
-        return rule33Block(coordRoot, req.session_id);
+        pending.push(rule33Block(coordRoot, req.session_id));
     // Claude Code can prove session-name presentation from assistant-only text.
     // Cursor cannot expose that text and Codex returned observe-only above.
     if (req.adapter !== "cursor") {
@@ -113,9 +134,12 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
         if (naming.some(({ required }) => required) &&
             !naming.some(({ present }) => present) &&
             !sessionNameSeenStamped(coordRoot, req.instance_id)) {
-            return sessionNameBlock(coordRoot, req.instance_id);
+            pending.push(sessionNameBlock(coordRoot, req.instance_id));
         }
     }
+    const blocked = mergeStopBlocks(pending);
+    if (blocked)
+        return withCycleAnchor(blocked, cycleAnchor);
     return { allow: true, exit_code: 0, rule: "stop-hook.pass" };
 }
 function unconditionalVerdict(req) {
@@ -145,22 +169,48 @@ function unconditionalVerdict(req) {
     }
     return undefined;
 }
-function resolveTurnStartMs(ownerEvents, nowMs, fallbackMs) {
+function resolveTurnStart(ownerEvents, nowMs, claudeContinuation) {
     const turns = ownerEvents.filter((event) => event.event_type === "turn.started" && eventTimeMs(event) <= nowMs);
     if (turns.length === 0)
-        return fallbackMs;
+        return undefined;
     let index = turns.length - 1;
     let hops = 0;
     while (index > 0 && hops < MAX_REMEDIATION_WALK_BACK) {
         const turn = turns[index];
-        if (!turn?.payload.stop_remediation)
+        const continuesCycle = claudeContinuation
+            ? turn?.provenance.source_event === "claude-code.recovery" &&
+                turn.provenance.attestation === "derived"
+            : turn?.payload.stop_remediation === true;
+        if (!continuesCycle)
             break;
         index -= 1;
         hops += 1;
     }
-    return eventTimeMs(turns[index]);
+    return turns[index];
+}
+function originalTurnEvents(ownerEvents, turnStart, endMs) {
+    if (!turnStart)
+        return [];
+    const startMs = eventTimeMs(turnStart);
+    const terminal = ownerEvents.find((event) => event.event_type === "turn.completed" && eventTimeMs(event) >= startMs);
+    const policyEndMs = terminal ? eventTimeMs(terminal) : endMs;
+    return ownerEvents.filter((event) => {
+        const time = eventTimeMs(event);
+        return time >= startMs && time <= policyEndMs;
+    });
+}
+function remediationCycleAnchor(turnStart, startMs) {
+    if (turnStart && "turn_id" in turnStart.scope && turnStart.scope.turn_id) {
+        return turnStart.scope.turn_id;
+    }
+    return new Date(startMs).toISOString();
+}
+function withCycleAnchor(verdict, anchor) {
+    return { ...verdict, remediation_cycle_anchor: anchor };
 }
 function eventTimeMs(event) {
+    if (!event)
+        return Number.NaN;
     return Date.parse(event.time.observed_at);
 }
 function observedBoolean(value) {
@@ -204,6 +254,37 @@ function evidenceUnavailable(reason) {
 function sessionIdSuffix(sessionId) {
     return sessionId ? ` --session-id ${sessionId}` : "";
 }
+/**
+ * Fold every failing end-of-turn signal into ONE verdict.
+ *
+ * The verdict keeps the first failure's rule id, so the `blocked_rule`
+ * telemetry and the adapter's `rule=` stderr contract are unchanged; the
+ * reason enumerates the rest so a single continuation can repair all of them.
+ * Cursor maps the acknowledgement onto rule 1/3, so identical rules dedupe.
+ */
+function mergeStopBlocks(blocks) {
+    let primary;
+    const seen = new Set();
+    const reasons = [];
+    for (const block of blocks) {
+        if (seen.has(block.rule))
+            continue;
+        seen.add(block.rule);
+        if (!primary)
+            primary = block;
+        if (block.reason)
+            reasons.push(block.reason);
+    }
+    if (!primary)
+        return undefined;
+    if (reasons.length < 2)
+        return primary;
+    const numbered = reasons.map((reason, index) => `${index + 1}. ${reason}`).join("\n");
+    return {
+        ...primary,
+        reason: `End-of-turn ritual: ${reasons.length} signals are missing from this turn. Repair ALL of them in this continuation, then stop.\n${numbered}`,
+    };
+}
 function rule13Block(coordRoot, sessionId) {
     const missingEvidence = agentsRequireGitFinalization(coordRoot)
         ? "no end_turn_checked coord.status_observed event found in this turn"

package/dist/core/agents/rules/verdict.d.ts

@@ -10,5 +10,6 @@ export type VerdictResult = {
     exit_code: 0 | 2;
     rule: string;
     reason?: string;
+    remediation_cycle_anchor?: string;
 };
 //# sourceMappingURL=verdict.d.ts.map

package/dist/core/agents/rules/verdict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/verdict.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,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"}
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/verdict.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,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;IAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC"}

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;;;;GAIG;AAkBH,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,yBAAyB,GAAG,mBAAmB,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAkID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,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;;;;GAIG;AAkBH,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,yBAAyB,GAAG,mBAAmB,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAsID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,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

@@ -95,6 +95,10 @@ function recordCommandObservation(type, fields) {
             monotonic_ns: process.hrtime.bigint().toString(),
         });
         if (result.state === "generation_unavailable") {
+            const expectedLifecycleReopenGap = result.reason === "turn_not_started" &&
+                hook.session_start_derivation === "approved_lifecycle_reopen";
+            if (expectedLifecycleReopenGap)
+                return;
             writeProducerDiagnosticV3(coordRoot, "command_emit_unjoinable", {
                 type,
                 instance_id: instanceId,

package/dist/core/agents/session-finalization-state-v3.js

@@ -1,6 +1,6 @@
 import { existsSync, lstatSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { EVENT_V3_LEDGER_RELATIVE_ROOT } from "../events/v3/writer.js";
+import { EVENT_V3_LEDGER_RELATIVE_ROOT } from "../events/v3/reader.js";
 export const SESSION_FINALIZATION_REQUEST_FORMAT_V3 = "harnery-v3-session-finalization-request";
 export const SESSION_FINALIZATION_REQUEST_VERSION_V3 = 1;
 export function sessionFinalizationRequestDirectoryV3(coordRoot) {

package/dist/core/agents/session-finalizer-v3.js

@@ -526,7 +526,11 @@ function ensureRequest(coordRoot, record, input) {
     };
     const observation = buildObservationEvent(coordRoot, record, request, input);
     request.observation_event_id = observation.event_id;
-    writeEventV3(coordRoot, observation);
+    const durability = writeEventV3(coordRoot, observation, {
+        expectedGenesisId: input.route.genesis_id,
+    });
+    if (durability.state === "epoch_replaced")
+        return null;
     writeRequest(coordRoot, request, true);
     return request;
 }

package/dist/core/agents/state/activity-log.d.ts

@@ -15,4 +15,7 @@
  * coord_owner_short). Returns `agent-unknown` when instanceId is null.
  */
 export declare function resolveShortName(coordRoot: string, instanceId: string | null): string;
+/** Build a collision-resistant agent label even when identity onboarding has
+ * not produced a usable display name yet. */
+export declare function agentDisplayName(instanceId: string, name?: string | null): string;
 //# sourceMappingURL=activity-log.d.ts.map

package/dist/core/agents/state/activity-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-log.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/activity-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKrF"}
+{"version":3,"file":"activity-log.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/activity-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIrF;AAED;6CAC6C;AAC7C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEjF"}

package/dist/core/agents/state/activity-log.js

@@ -19,7 +19,10 @@ export function resolveShortName(coordRoot, instanceId) {
     if (!instanceId)
         return "agent-unknown";
     const row = readLiveCoordinationRow(coordRoot, instanceId);
-    if (row?.name)
-        return `agent-${row.name}`;
-    return `agent-${instanceId.slice(0, 8)}`;
+    return agentDisplayName(instanceId, row?.name);
+}
+/** Build a collision-resistant agent label even when identity onboarding has
+ * not produced a usable display name yet. */
+export function agentDisplayName(instanceId, name) {
+    return `agent-${name?.trim() || instanceId.slice(0, 8) || "unknown"}`;
 }

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

@@ -21,6 +21,12 @@ export declare function setLifecycleCache(coordRoot: string, instanceId: string,
 export declare function setTask(coordRoot: string, instanceId: string, task: string): Heartbeat | null;
 /** Update the disposable identity cache after a canonical V3 attestation. */
 export declare function setIdentityCache(coordRoot: string, instanceId: string, name: string, agentId: string): Heartbeat | null;
+/** Restore the pool-assigned display name on a generation that was
+ * materialized before the adapter's normal SessionStart naming path ran.
+ * The durable assignment lives in `.name-history`; this only repairs the
+ * disposable generation cache and deliberately leaves durable persona state
+ * (`agent_id`) untouched. */
+export declare function setAssignedNameCache(coordRoot: string, instanceId: string, name: string, kind?: "session" | "subagent" | "transient"): Heartbeat | null;
 /**
  * Build the copy-pasteable session name from the coord identity + the agent's
  * description parts. Pure (no coord-state reads) so it's unit-testable; collapses

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;;;;;;;;;;;;;;GAcG;AAaH,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAatE,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,GAC5B,SAAS,GAAG,IAAI,CAQlB;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoB7F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAOlB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,IAAI,CAOf;AAED;;;;4EAI4E;AAC5E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAMlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAQlB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAWlB;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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,eAAe,EAAE,CA6BnB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASrF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBnF"}
+{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAatE,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,GAC5B,SAAS,GAAG,IAAI,CAQlB;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoB7F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAOlB;AAED;;;;6BAI6B;AAC7B,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,GAAG,UAAU,GAAG,WAAuB,GACrD,SAAS,GAAG,IAAI,CAelB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,IAAI,CAOf;AAED;;;;4EAI4E;AAC5E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAMlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAQlB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAWlB;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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,eAAe,EAAE,CA6BnB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASrF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBnF"}

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

@@ -76,6 +76,24 @@ export function setIdentityCache(coordRoot, instanceId, name, agentId) {
     atomicWrite(heartbeatPath(coordRoot, instanceId), JSON.stringify(heartbeat, null, 2));
     return heartbeat;
 }
+/** Restore the pool-assigned display name on a generation that was
+ * materialized before the adapter's normal SessionStart naming path ran.
+ * The durable assignment lives in `.name-history`; this only repairs the
+ * disposable generation cache and deliberately leaves durable persona state
+ * (`agent_id`) untouched. */
+export function setAssignedNameCache(coordRoot, instanceId, name, kind = "session") {
+    return mutate(coordRoot, instanceId, (heartbeat) => {
+        const suggestedSessionName = heartbeat.suggested_session_name?.replace(/^(\[DONE\]\s+)?Agent unknown( - .+)$/, `$1Agent ${name}$2`);
+        return {
+            ...heartbeat,
+            name,
+            kind: heartbeat.kind ?? kind,
+            ...(suggestedSessionName && suggestedSessionName !== heartbeat.suggested_session_name
+                ? { suggested_session_name: suggestedSessionName }
+                : {}),
+        };
+    });
+}
 /**
  * Build the copy-pasteable session name from the coord identity + the agent's
  * description parts. Pure (no coord-state reads) so it's unit-testable; collapses

package/dist/core/agents/state/live-coordination-view.d.ts

@@ -1,4 +1,5 @@
 import type { Adapter } from "../../adapter.js";
+import { type CoordinationGenerationViewV3 } from "../../events/v3/coordination-view.js";
 import { type Heartbeat } from "./heartbeat-reader.js";
 /**
  * Heartbeat files are disposable V3 caches. These bindings prevent a stale
@@ -21,11 +22,8 @@ export declare function readLiveCoordinationRow(coordRoot: string, nativeInstanc
  * callers must never substitute another adapter when this function succeeds.
  */
 export declare function liveCoordinationAdapterV3(coordRoot: string, nativeInstanceId: string): Adapter | null;
-/**
- * Ensure the current V3 generation has a mutation target. The resulting file
- * is explicitly generation-bound and disposable: V3 remains the source of
- * truth, while the cache gives the crash-safe authority outbox an atomic local
- * state to reconcile.
- */
-export declare function ensureLiveCoordinationHeartbeat(coordRoot: string, nativeInstanceId: string, nativeSessionId: string, _adapter: Adapter, model?: string): Heartbeat | null;
+export declare function isCurrentV3HeartbeatCache(cache: Heartbeat | null | undefined, generation: CoordinationGenerationViewV3): cache is Heartbeat;
+export declare function projectHeartbeatV3(coordRoot: string, generation: CoordinationGenerationViewV3, cache: Heartbeat | undefined, nativeInstanceId: string | undefined, parent?: CoordinationGenerationViewV3): V3HeartbeatMaterialization;
+export declare function observedAdapterV3(generation: CoordinationGenerationViewV3): string | undefined;
+export declare function isAdapterV3(value: string | undefined): value is Adapter;
 //# sourceMappingURL=live-coordination-view.d.ts.map

package/dist/core/agents/state/live-coordination-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-view.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAYhD,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,cAAc,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,QAAQ,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,OAAO,MAAM,EAAE,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,EAAE,CA2BxF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,0BAA0B,GAAG,IAAI,CAuBnC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,GAAG,IAAI,CAWhB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CAyDlB"}
+{"version":3,"file":"live-coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-view.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,KAAK,4BAA4B,EAIlC,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,cAAc,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,QAAQ,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,OAAO,MAAM,EAAE,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,EAAE,CA2BxF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,0BAA0B,GAAG,IAAI,CAuBnC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,GAAG,IAAI,CAWhB;AA8BD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,4BAA4B,GACvC,KAAK,IAAI,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,4BAA4B,EACxC,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,4BAA4B,GACpC,0BAA0B,CAqD5B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,4BAA4B,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,OAAO,CAEvE"}

package/dist/core/agents/state/live-coordination-view.js

@@ -1,12 +1,12 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
-import { dirname, join } from "node:path";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../../events/v3/coordination-view.js";
-import { liveInstanceIdV3, nativeInstanceIdV3, resolveLiveEventLedgerRouteV3, } from "../../events/v3/live-routing.js";
+import { liveInstanceIdV3, nativeInstanceIdV3, observeLiveEventLedgerRouteV3, } from "../../events/v3/live-route-observer.js";
 import { readHeartbeat } from "./heartbeat-reader.js";
 import { resolveName } from "./names.js";
 /** Read the live coordination rows through the hard-cut ledger route. */
 export function readLiveCoordinationRows(coordRoot) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         return [];
     let view;
@@ -29,7 +29,7 @@ export function readLiveCoordinationRows(coordRoot) {
 }
 /** Read one current row from the authority-safe V3 projection. */
 export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         return null;
     try {
@@ -41,7 +41,7 @@ export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
         const parent = generation.parent_generation_id
             ? Object.values(view.instances).find((candidate) => candidate.generation_id === generation.parent_generation_id)
             : undefined;
-        return projectHeartbeatV3(coordRoot, generation, isCurrentCache(cache, generation) ? cache : undefined, nativeInstanceId, parent);
+        return projectHeartbeatV3(coordRoot, generation, isCurrentV3HeartbeatCache(cache, generation) ? cache : undefined, nativeInstanceId, parent);
     }
     catch {
         return null;
@@ -53,84 +53,19 @@ export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
  * callers must never substitute another adapter when this function succeeds.
  */
 export function liveCoordinationAdapterV3(coordRoot, nativeInstanceId) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    const route = observeLiveEventLedgerRouteV3(coordRoot);
     if (route.state === "blocked")
         throw new Error(`event_v3_coordination_view:${route.reason}`);
     const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
     const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
     if (!generation?.authority_eligible)
         return null;
-    const adapter = observedAdapter(generation);
-    if (!isAdapter(adapter)) {
+    const adapter = observedAdapterV3(generation);
+    if (!isAdapterV3(adapter)) {
         throw new Error("event_v3_coordination_view:adapter_not_observed");
     }
     return adapter;
 }
-/**
- * Ensure the current V3 generation has a mutation target. The resulting file
- * is explicitly generation-bound and disposable: V3 remains the source of
- * truth, while the cache gives the crash-safe authority outbox an atomic local
- * state to reconcile.
- */
-export function ensureLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model) {
-    const route = resolveLiveEventLedgerRouteV3(coordRoot);
-    if (route.state === "blocked")
-        throw new Error(`event_v3_coordination_view:${route.reason}`);
-    const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
-    const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
-    if (!generation?.authority_eligible)
-        return null;
-    const generationAdapter = observedAdapter(generation);
-    if (!isAdapter(generationAdapter)) {
-        throw new Error("event_v3_coordination_view:adapter_not_observed");
-    }
-    const current = readHeartbeat(coordRoot, nativeInstanceId);
-    if (isCurrentCache(current, generation) && current.platform === generationAdapter)
-        return current;
-    const resolved = resolveName(coordRoot, nativeInstanceId, nativeSessionId);
-    const projected = projectHeartbeatV3(coordRoot, generation, undefined, nativeInstanceId);
-    // A generation reopen (resume, mid-flight onboarding) discards the stale
-    // cache, but the adapter tab it names is unchanged: same native session,
-    // same agent identity. Rebuilding without the naming evidence re-mints a
-    // fresh suggested name on the next set-task, so a multi-day session
-    // accumulates titles it is asked to display over and over. Carry the
-    // naming evidence across generations; everything else re-projects from V3.
-    // Same native session id means the same adapter tab; drop the carry only
-    // when the durable identity observably changed (a reassumed name would make
-    // the old "Agent <name> - …" block wrong for the new owner).
-    const identityUnchanged = !resolved?.name || !current?.name || resolved.name === current.name;
-    const carriedNaming = current && current.session_id === nativeSessionId && identityUnchanged
-        ? {
-            ...(current.suggested_session_name
-                ? { suggested_session_name: current.suggested_session_name }
-                : {}),
-            ...(current.session_name_seen_for
-                ? { session_name_seen_for: current.session_name_seen_for }
-                : {}),
-            ...(current.session_name_seen_at
-                ? { session_name_seen_at: current.session_name_seen_at }
-                : {}),
-        }
-        : {};
-    const materialized = {
-        ...projected,
-        ...carriedNaming,
-        schema_version: 2,
-        instance_id: nativeInstanceId,
-        session_id: nativeSessionId,
-        name: resolved?.name ?? "",
-        kind: resolved?.kind ?? projected.kind,
-        agent_id: resolved?.agent_id ?? (resolved?.kind === "subagent" ? nativeInstanceId : ""),
-        model: projected.model ?? model ?? "",
-        platform: generationAdapter,
-        v3_instance_id: generation.instance_id,
-        v3_generation_id: generation.generation_id,
-        v3_projection_event_id: generation.last_event_id,
-        v3_task_state: generation.task_state === "set" ? "set" : "cleared",
-    };
-    writeHeartbeatCache(coordRoot, nativeInstanceId, materialized);
-    return materialized;
-}
 function readCacheRows(coordRoot) {
     const dir = join(coordRoot, ".harnery", "active");
     if (!existsSync(dir))
@@ -152,15 +87,15 @@ function readV3Caches(coordRoot) {
     return readCacheRows(coordRoot).filter((row) => row.schema_version === 2 && typeof row.v3_generation_id === "string");
 }
 function matchingCache(caches, generation) {
-    return caches.find((cache) => isCurrentCache(cache, generation));
+    return caches.find((cache) => isCurrentV3HeartbeatCache(cache, generation));
 }
-function isCurrentCache(cache, generation) {
+export function isCurrentV3HeartbeatCache(cache, generation) {
     return (cache?.schema_version === 2 &&
         cache.v3_instance_id === generation.instance_id &&
         cache.v3_generation_id === generation.generation_id);
 }
-function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, parent) {
-    const adapter = observedAdapter(generation) ?? cache?.platform ?? "unknown";
+export function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, parent) {
+    const adapter = observedAdapterV3(generation) ?? cache?.platform ?? "unknown";
     const model = observedModel(generation) ?? cache?.model ?? "";
     const instanceId = nativeInstanceId ?? cache?.instance_id ?? nativeInstanceIdV3(generation.instance_id);
     const durableIdentity = resolveName(coordRoot, instanceId, cache?.session_id ?? generation.session_id);
@@ -207,11 +142,11 @@ function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceId, pare
         v3_task_state: taskIsSet ? "set" : "cleared",
     };
 }
-function observedAdapter(generation) {
+export function observedAdapterV3(generation) {
     const observation = generation.runtime_attestation.adapter;
     return observation.state === "observed" ? observation.value.id : undefined;
 }
-function isAdapter(value) {
+export function isAdapterV3(value) {
     return value === "claude-code" || value === "cursor" || value === "codex";
 }
 function observedModel(generation) {
@@ -221,13 +156,3 @@ function observedModel(generation) {
 function isLifecycleState(value) {
     return value === "active" || value === "blocked" || value === "done";
 }
-function writeHeartbeatCache(coordRoot, instanceId, heartbeat) {
-    if (!/^[a-zA-Z0-9._-]{1,128}$/.test(instanceId)) {
-        throw new Error("instance_id is unsafe for heartbeat materialization");
-    }
-    const path = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
-    mkdirSync(dirname(path), { recursive: true });
-    const temporary = `${path}.tmp.${process.pid}`;
-    writeFileSync(temporary, JSON.stringify(heartbeat, null, 2), "utf8");
-    renameSync(temporary, path);
-}

package/dist/core/agents/state/live-coordination-writer.d.ts

@@ -0,0 +1,12 @@
+import type { Adapter } from "../../adapter.js";
+import { type Heartbeat } from "./heartbeat-reader.js";
+/**
+ * Ensure the current V3 generation has a mutation target. The resulting file
+ * is explicitly generation-bound and disposable: V3 remains the source of
+ * truth, while the cache gives the crash-safe authority outbox an atomic local
+ * state to reconcile.
+ */
+export declare function ensureLiveCoordinationHeartbeat(coordRoot: string, nativeInstanceId: string, nativeSessionId: string, _adapter: Adapter, model?: string): Heartbeat | null;
+/** Rebuild a disposable cache from V3 even when its generation markers look current. */
+export declare function repairLiveCoordinationHeartbeat(coordRoot: string, nativeInstanceId: string, nativeSessionId: string, adapter: Adapter, model?: string): Heartbeat | null;
+//# sourceMappingURL=live-coordination-writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-coordination-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMhD,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAUtE;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CASlB;AAED,wFAAwF;AACxF,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CASlB"}

package/dist/core/agents/state/live-coordination-writer.js

@@ -0,0 +1,92 @@
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../../events/v3/coordination-view.js";
+import { liveInstanceIdV3, resolveLiveEventLedgerRouteV3 } from "../../events/v3/live-routing.js";
+import { readHeartbeat } from "./heartbeat-reader.js";
+import { isAdapterV3, isCurrentV3HeartbeatCache, observedAdapterV3, projectHeartbeatV3, } from "./live-coordination-view.js";
+import { resolveName } from "./names.js";
+/**
+ * Ensure the current V3 generation has a mutation target. The resulting file
+ * is explicitly generation-bound and disposable: V3 remains the source of
+ * truth, while the cache gives the crash-safe authority outbox an atomic local
+ * state to reconcile.
+ */
+export function ensureLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model) {
+    return materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model, false);
+}
+/** Rebuild a disposable cache from V3 even when its generation markers look current. */
+export function repairLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, adapter, model) {
+    return materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, adapter, model, true);
+}
+function materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativeSessionId, _adapter, model, force) {
+    const route = resolveLiveEventLedgerRouteV3(coordRoot);
+    if (route.state === "blocked")
+        throw new Error(`event_v3_coordination_view:${route.reason}`);
+    const view = requireAuthoritySafeCoordinationViewV3(readCoordinationViewV3(coordRoot));
+    const generation = view.instances[liveInstanceIdV3(nativeInstanceId)];
+    if (!generation?.authority_eligible)
+        return null;
+    const generationAdapter = observedAdapterV3(generation);
+    if (!isAdapterV3(generationAdapter)) {
+        throw new Error("event_v3_coordination_view:adapter_not_observed");
+    }
+    const current = readHeartbeat(coordRoot, nativeInstanceId);
+    if (!force &&
+        isCurrentV3HeartbeatCache(current, generation) &&
+        current.platform === generationAdapter) {
+        return current;
+    }
+    const resolved = resolveName(coordRoot, nativeInstanceId, nativeSessionId);
+    const projected = projectHeartbeatV3(coordRoot, generation, undefined, nativeInstanceId);
+    // A generation reopen (resume, mid-flight onboarding) discards the stale
+    // cache, but the adapter tab it names is unchanged: same native session,
+    // same agent identity. Rebuilding without the naming evidence re-mints a
+    // fresh suggested name on the next set-task, so a multi-day session
+    // accumulates titles it is asked to display over and over. Carry the
+    // naming evidence across generations; everything else re-projects from V3.
+    // Same native session id means the same adapter tab; drop the carry only
+    // when the durable identity observably changed (a reassumed name would make
+    // the old "Agent <name> - …" block wrong for the new owner).
+    const identityUnchanged = !resolved?.name || !current?.name || resolved.name === current.name;
+    const carriedNaming = current && current.session_id === nativeSessionId && identityUnchanged
+        ? {
+            ...(current.suggested_session_name
+                ? { suggested_session_name: current.suggested_session_name }
+                : {}),
+            ...(current.session_name_seen_for
+                ? { session_name_seen_for: current.session_name_seen_for }
+                : {}),
+            ...(current.session_name_seen_at
+                ? { session_name_seen_at: current.session_name_seen_at }
+                : {}),
+        }
+        : {};
+    const materialized = {
+        ...projected,
+        ...carriedNaming,
+        schema_version: 2,
+        instance_id: nativeInstanceId,
+        session_id: nativeSessionId,
+        name: resolved?.name ?? "",
+        kind: resolved?.kind ?? projected.kind,
+        agent_id: resolved?.agent_id ?? (resolved?.kind === "subagent" ? nativeInstanceId : ""),
+        model: projected.model ?? model ?? "",
+        platform: generationAdapter,
+        v3_instance_id: generation.instance_id,
+        v3_generation_id: generation.generation_id,
+        v3_projection_event_id: generation.last_event_id,
+        v3_task_state: generation.task_state === "set" ? "set" : "cleared",
+    };
+    writeHeartbeatCache(coordRoot, nativeInstanceId, materialized);
+    return materialized;
+}
+function writeHeartbeatCache(coordRoot, instanceId, heartbeat) {
+    if (!/^[a-zA-Z0-9._-]{1,128}$/.test(instanceId)) {
+        throw new Error("instance_id is unsafe for heartbeat materialization");
+    }
+    const path = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.tmp.${process.pid}`;
+    writeFileSync(temporary, JSON.stringify(heartbeat, null, 2), "utf8");
+    renameSync(temporary, path);
+}