harnery 0.7.0 → 0.7.1

package/dist/core/agents/cli.js

@@ -150,6 +150,32 @@ async function handleProject(root, rest) {
     }
     return 0;
 }
+/**
+ * Append a canonical `claim.release` event for a path dropped from an owner's
+ * files_touched. The path is canonicalized to repo-relative (matching the
+ * projector's normalization) so the subtraction matches on replay regardless
+ * of the form the caller passed. Soft-fails: a failed emit must never break
+ * the release/kill flow — the file mutation already happened.
+ */
+async function emitClaimRelease(root, owner, hb, path, reason) {
+    try {
+        const { emit } = await import("./events/emit.js");
+        const canonical = path.startsWith(`${root}/`) ? path.slice(root.length + 1) : path;
+        const platform = hb.platform;
+        const harness = platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code";
+        emit(root, {
+            event_type: "claim.release",
+            instance_id: owner,
+            session_id: hb.session_id ?? owner,
+            harness,
+            source: "agent-coord",
+            data: { path: canonical, reason },
+        });
+    }
+    catch {
+        /* soft-fail: never break the caller */
+    }
+}
 async function handleStateAction(root, action, rest) {
     const writer = await import("./state/heartbeat-writer.js");
     const [owner, ...args] = rest;
@@ -189,14 +215,36 @@ async function handleStateAction(root, action, rest) {
                 process.stderr.write("agent-coord release-claim: missing <path>\n");
                 return 2;
             }
+            const before = writer.readHeartbeat(root, owner);
             const hb = writer.releaseClaim(root, owner, path);
             if (!hb)
                 return 1;
+            // Durability: the projector rebuilds files_touched by replaying the
+            // permanent Edit/Write events, so a file-only release is silently
+            // reverted by the next full replay. Emitting claim.release puts the
+            // subtraction into the stream so every future replay honors it. Only
+            // emit when the release actually removed a held path (idempotent
+            // re-releases stay quiet).
+            const heldBefore = before?.files_touched?.length ?? 0;
+            const heldAfter = hb.files_touched?.length ?? 0;
+            if (heldBefore > heldAfter) {
+                await emitClaimRelease(root, owner, before ?? hb, path, "explicit");
+            }
             process.stdout.write(`${JSON.stringify({ instance_id: owner, files_touched: hb.files_touched })}\n`);
             return 0;
         }
         case "kill-heartbeat": {
+            // Read held claims BEFORE the unlink so they can be released durably —
+            // killing only the file leaves the claims resurrectable from the
+            // permanent Edit/Write events on the next full replay (observed: a
+            // 6-day-dead agent's claims returning after its heartbeat was killed).
+            const before = writer.readHeartbeat(root, owner);
             const ok = writer.killHeartbeat(root, owner);
+            if (ok && before) {
+                for (const held of before.files_touched ?? []) {
+                    await emitClaimRelease(root, owner, before, held, "heal");
+                }
+            }
             process.stdout.write(`${JSON.stringify({ instance_id: owner, removed: ok })}\n`);
             return ok ? 0 : 1;
         }

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;AA8VD,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,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"}

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

@@ -38,7 +38,7 @@ export function projectHeartbeats(coordRoot, events) {
                 continue;
             perOwner[ev.instance_id] = existing ?? seed(ev, coordRoot);
         }
-        apply(perOwner[ev.instance_id], ev);
+        apply(perOwner[ev.instance_id], ev, coordRoot);
     }
     const written = [];
     for (const [instance_id, hb] of Object.entries(perOwner)) {
@@ -101,7 +101,7 @@ function seed(ev, coordRoot) {
     }
     return hb;
 }
-function apply(hb, ev) {
+function apply(hb, ev, coordRoot) {
     hb.last_heartbeat = ev.ts;
     hb.last_event_id = ev.event_id;
     hb.events_applied += 1;
@@ -238,7 +238,14 @@ function apply(hb, ev) {
         case "claim.release": {
             const path = pickStr(d, "path");
             if (path && hb.files_touched) {
-                hb.files_touched = hb.files_touched.filter((p) => p !== path);
+                // files_touched holds a mix of absolute-under-coordRoot and canonical
+                // repo-relative entries (Edit events report absolute; release-claim
+                // canonicalizes to relative). Normalize both sides so a release
+                // subtracts regardless of form — an exact-string compare silently
+                // no-ops on the mismatch and the claim resurrects on the next replay.
+                const norm = (p) => p.startsWith(`${coordRoot}/`) ? p.slice(coordRoot.length + 1) : p;
+                const target = norm(path);
+                hb.files_touched = hb.files_touched.filter((p) => norm(p) !== target);
             }
             break;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",

package/src/core/agents/cli.ts

@@ -164,6 +164,39 @@ async function handleProject(root: string, rest: string[]): Promise<number> {
   return 0;
 }
 
+/**
+ * Append a canonical `claim.release` event for a path dropped from an owner's
+ * files_touched. The path is canonicalized to repo-relative (matching the
+ * projector's normalization) so the subtraction matches on replay regardless
+ * of the form the caller passed. Soft-fails: a failed emit must never break
+ * the release/kill flow — the file mutation already happened.
+ */
+async function emitClaimRelease(
+  root: string,
+  owner: string,
+  hb: { session_id?: string; platform?: string },
+  path: string,
+  reason: "explicit" | "heal",
+): Promise<void> {
+  try {
+    const { emit } = await import("./events/emit.ts");
+    const canonical = path.startsWith(`${root}/`) ? path.slice(root.length + 1) : path;
+    const platform = hb.platform;
+    const harness =
+      platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code";
+    emit(root, {
+      event_type: "claim.release",
+      instance_id: owner,
+      session_id: hb.session_id ?? owner,
+      harness,
+      source: "agent-coord",
+      data: { path: canonical, reason },
+    });
+  } catch {
+    /* soft-fail: never break the caller */
+  }
+}
+
 async function handleStateAction(root: string, action: string, rest: string[]): Promise<number> {
   const writer = await import("./state/heartbeat-writer.ts");
   const [owner, ...args] = rest;
@@ -210,15 +243,37 @@ async function handleStateAction(root: string, action: string, rest: string[]):
         process.stderr.write("agent-coord release-claim: missing <path>\n");
         return 2;
       }
+      const before = writer.readHeartbeat(root, owner);
       const hb = writer.releaseClaim(root, owner, path);
       if (!hb) return 1;
+      // Durability: the projector rebuilds files_touched by replaying the
+      // permanent Edit/Write events, so a file-only release is silently
+      // reverted by the next full replay. Emitting claim.release puts the
+      // subtraction into the stream so every future replay honors it. Only
+      // emit when the release actually removed a held path (idempotent
+      // re-releases stay quiet).
+      const heldBefore = before?.files_touched?.length ?? 0;
+      const heldAfter = hb.files_touched?.length ?? 0;
+      if (heldBefore > heldAfter) {
+        await emitClaimRelease(root, owner, before ?? hb, path, "explicit");
+      }
       process.stdout.write(
         `${JSON.stringify({ instance_id: owner, files_touched: hb.files_touched })}\n`,
       );
       return 0;
     }
     case "kill-heartbeat": {
+      // Read held claims BEFORE the unlink so they can be released durably —
+      // killing only the file leaves the claims resurrectable from the
+      // permanent Edit/Write events on the next full replay (observed: a
+      // 6-day-dead agent's claims returning after its heartbeat was killed).
+      const before = writer.readHeartbeat(root, owner);
       const ok = writer.killHeartbeat(root, owner);
+      if (ok && before) {
+        for (const held of before.files_touched ?? []) {
+          await emitClaimRelease(root, owner, before, held, "heal");
+        }
+      }
       process.stdout.write(`${JSON.stringify({ instance_id: owner, removed: ok })}\n`);
       return ok ? 0 : 1;
     }

package/src/core/agents/state/heartbeat-projector.ts

@@ -88,7 +88,7 @@ export function projectHeartbeats(
       if (!existing && TERMINAL.has(ev.event_type)) continue;
       perOwner[ev.instance_id] = existing ?? seed(ev, coordRoot);
     }
-    apply(perOwner[ev.instance_id]!, ev);
+    apply(perOwner[ev.instance_id]!, ev, coordRoot);
   }
 
   const written: string[] = [];
@@ -153,7 +153,7 @@ function seed(ev: CanonicalEvent, coordRoot: string): V2Heartbeat {
   return hb;
 }
 
-function apply(hb: V2Heartbeat, ev: CanonicalEvent): void {
+function apply(hb: V2Heartbeat, ev: CanonicalEvent, coordRoot: string): void {
   hb.last_heartbeat = ev.ts;
   hb.last_event_id = ev.event_id;
   hb.events_applied += 1;
@@ -285,7 +285,15 @@ function apply(hb: V2Heartbeat, ev: CanonicalEvent): void {
     case "claim.release": {
       const path = pickStr(d, "path");
       if (path && hb.files_touched) {
-        hb.files_touched = hb.files_touched.filter((p) => p !== path);
+        // files_touched holds a mix of absolute-under-coordRoot and canonical
+        // repo-relative entries (Edit events report absolute; release-claim
+        // canonicalizes to relative). Normalize both sides so a release
+        // subtracts regardless of form — an exact-string compare silently
+        // no-ops on the mismatch and the claim resurrects on the next replay.
+        const norm = (p: string): string =>
+          p.startsWith(`${coordRoot}/`) ? p.slice(coordRoot.length + 1) : p;
+        const target = norm(path);
+        hb.files_touched = hb.files_touched.filter((p) => norm(p) !== target);
       }
       break;
     }