harnery 0.29.0 → 0.31.0

package/dist/core/agents/cli.js

@@ -162,12 +162,12 @@ async function emitClaimRelease(root, owner, hb, path, reason) {
         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";
+        const adapter = platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code";
         emit(root, {
             event_type: "claim.release",
             instance_id: owner,
             session_id: hb.session_id ?? owner,
-            harness,
+            adapter,
             source: "agent-coord",
             data: { path: canonical, reason },
         });
@@ -262,16 +262,16 @@ async function handleStateAction(root, action, rest) {
             return 0;
         }
         case "heal-heartbeat": {
-            // harness arrives as a `--harness=<h>` flag (not positional) so the live
+            // adapter arrives as a `--adapter=<h>` flag (not positional) so the live
             // tool.pre_use heal and the manual `harn agents heal` path (which pass
             // different positional counts) can both supply it without arg-order
             // fragility. Positionals (sessionId, model) stay as-is once flags are
             // filtered out.
-            const harness = args.find((a) => a.startsWith("--harness="))?.slice("--harness=".length);
+            const adapter = args.find((a) => a.startsWith("--adapter="))?.slice("--adapter=".length);
             const positional = args.filter((a) => !a.startsWith("--"));
             const sessionId = positional[0];
             const model = positional[1];
-            const hb = writer.healHeartbeat(root, owner, sessionId, model, harness);
+            const hb = writer.healHeartbeat(root, owner, sessionId, model, adapter);
             process.stdout.write(`${JSON.stringify({ instance_id: owner, recreated: !!hb })}\n`);
             return hb ? 0 : 1;
         }
@@ -293,45 +293,45 @@ async function handleStateAction(root, action, rest) {
             return 2;
     }
 }
-async function handleScratchAction(root, action, rest) {
-    const scratch = await import("./state/scratch.js");
-    if (action === "append-scratch") {
+async function handleJournalAction(root, action, rest) {
+    const journal = await import("./state/journal.js");
+    if (action === "append-journal") {
         const [owner, category, ...bodyParts] = rest;
         const body = bodyParts.join(" ");
         if (!owner || !category || !body) {
-            process.stderr.write("agent-coord append-scratch <instance_id> <category> <body>\n");
+            process.stderr.write("agent-coord append-journal <instance_id> <category> <body>\n");
             return 2;
         }
-        const result = scratch.appendScratch(root, owner, category, body);
+        const result = journal.appendJournal(root, owner, category, body);
         if (!result.ok) {
-            process.stderr.write(`agent-coord append-scratch: ${result.reason}\n`);
+            process.stderr.write(`agent-coord append-journal: ${result.reason}\n`);
             return 1;
         }
         process.stdout.write(`${JSON.stringify({ instance_id: owner, category, path: result.path })}\n`);
         return 0;
     }
-    if (action === "edit-scratchpad") {
+    if (action === "edit-journal") {
         const [owner, newBodyFile, ...summaryParts] = rest;
         const summary = summaryParts.join(" ");
         if (!owner || !newBodyFile) {
-            process.stderr.write("agent-coord edit-scratchpad <instance_id> <new-body-file> [<summary>]\n");
+            process.stderr.write("agent-coord edit-journal <instance_id> <new-body-file> [<summary>]\n");
             return 2;
         }
         if (!existsSync(newBodyFile)) {
-            process.stderr.write(`agent-coord edit-scratchpad: file not found: ${newBodyFile}\n`);
+            process.stderr.write(`agent-coord edit-journal: file not found: ${newBodyFile}\n`);
             return 2;
         }
         const { readFileSync } = await import("node:fs");
         const newBody = readFileSync(newBodyFile, "utf8");
-        const result = scratch.editScratchpad(root, owner, newBody, summary);
+        const result = journal.editJournal(root, owner, newBody, summary);
         if (!result.ok) {
-            process.stderr.write(`agent-coord edit-scratchpad: ${result.reason}\n`);
+            process.stderr.write(`agent-coord edit-journal: ${result.reason}\n`);
             return 1;
         }
         process.stdout.write(`${JSON.stringify({ instance_id: owner, path: result.path, archive_path: result.archivePath })}\n`);
         return 0;
     }
-    process.stderr.write(`agent-coord: unknown scratch action ${action}\n`);
+    process.stderr.write(`agent-coord: unknown journal action ${action}\n`);
     return 2;
 }
 async function handleCouncilAction(root, action, rest) {
@@ -522,7 +522,7 @@ async function handleShellMutationClaimLog(root, rest) {
     // in a log file; now a canonical decision.warn so the
     // signal survives in events.ndjson. (The blocking claim-conflict path is
     // separate: claim.conflict / verdict, and unaffected.)
-    const harness = platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code";
+    const adapter = platform === "cursor" ? "cursor" : platform === "codex" ? "codex" : "claude-code";
     const hb = owner ? readHeartbeat(root, owner) : null;
     for (const p of paths) {
         try {
@@ -530,7 +530,7 @@ async function handleShellMutationClaimLog(root, rest) {
                 event_type: "decision.warn",
                 instance_id: owner ?? "unknown",
                 session_id: hb?.session_id ?? owner ?? "unknown",
-                harness,
+                adapter,
                 data: {
                     rule: "shell_mutation_candidate",
                     reason: `path=${p} cmd=${truncated} platform=${platform}`,
@@ -568,9 +568,11 @@ async function handlePromptContext(root, rest) {
     const instanceId = args.instance;
     const sessionId = args.session ?? instanceId;
     const agentName = args.name;
+    const sessionNameNudge = args["session-name-nudge"] === "true";
     const taskNudge = args["task-nudge"] === "true";
+    const statusFooterNudge = args["status-footer-nudge"] === "true";
     if (!instanceId) {
-        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--task-nudge]\n");
+        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--session-name-nudge] [--task-nudge] [--status-footer-nudge]\n");
         return 2;
     }
     const { renderPromptContext } = await import("./render/prompt-context.js");
@@ -579,7 +581,9 @@ async function handlePromptContext(root, rest) {
         instanceId,
         sessionId: sessionId,
         agentName,
+        sessionNameNudge,
         taskNudge,
+        statusFooterNudge,
     });
     process.stdout.write(text);
     return 0;
@@ -689,10 +693,10 @@ async function handleEmitEvent(root, rest) {
     const eventType = args.type;
     const instanceId = args.owner;
     const sessionId = args.session;
-    const harness = args.harness;
+    const adapter = args.adapter;
     const dataJson = args["data-json"] ?? "{}";
-    if (!eventType || !instanceId || !sessionId || !harness) {
-        process.stderr.write("agent-coord emit-event --type <T> --owner <id> --session <id> --harness <h> [--data-json '<json>']\n");
+    if (!eventType || !instanceId || !sessionId || !adapter) {
+        process.stderr.write("agent-coord emit-event --type <T> --owner <id> --session <id> --adapter <h> [--data-json '<json>']\n");
         return 2;
     }
     let data;
@@ -714,7 +718,7 @@ async function handleEmitEvent(root, rest) {
         event_type: eventType,
         instance_id: instanceId,
         session_id: sessionId,
-        harness,
+        adapter,
         turn_id: args["turn-id"],
         parent_session_id: args["parent-session-id"],
         parent_turn_id: args["parent-turn-id"],
@@ -751,8 +755,8 @@ async function main() {
         subcommand === "stamp-tool-activity") {
         return handleStateAction(root, subcommand, rest);
     }
-    if (subcommand === "append-scratch" || subcommand === "edit-scratchpad") {
-        return handleScratchAction(root, subcommand, rest);
+    if (subcommand === "append-journal" || subcommand === "edit-journal") {
+        return handleJournalAction(root, subcommand, rest);
     }
     if (subcommand === "council-advance" ||
         subcommand === "council-close" ||

package/dist/core/agents/codex-replay.d.ts

@@ -4,7 +4,7 @@
  * Production codex sessions emit canonical events from each `harn` invocation
  * via the in-process session-tee middleware (which calls `agent-coord
  * emit-event` for state.task_set / state.status_checked). But the codex
- * harness itself doesn't wire agent-hook on preToolUse, so user_prompt.submit
+ * adapter itself doesn't wire agent-hook on preToolUse, so user_prompt.submit
  * + tool.pre_use + turn.stop aren't emitted live.
  *
  * This module parses the Codex JSONL transcript at stop time and emits the

package/dist/core/agents/codex-replay.js

@@ -4,7 +4,7 @@
  * Production codex sessions emit canonical events from each `harn` invocation
  * via the in-process session-tee middleware (which calls `agent-coord
  * emit-event` for state.task_set / state.status_checked). But the codex
- * harness itself doesn't wire agent-hook on preToolUse, so user_prompt.submit
+ * adapter itself doesn't wire agent-hook on preToolUse, so user_prompt.submit
  * + tool.pre_use + turn.stop aren't emitted live.
  *
  * This module parses the Codex JSONL transcript at stop time and emits the
@@ -49,7 +49,7 @@ export function replayCodexJsonl(opts) {
                 event_type: "user_prompt.submit",
                 instance_id: instanceId,
                 session_id: sessionId,
-                harness: "codex",
+                adapter: "codex",
                 ts,
                 data: {
                     prompt_text: clamp(entry.payload.message ?? "", 4000),
@@ -75,7 +75,7 @@ export function replayCodexJsonl(opts) {
                 event_type: "tool.pre_use",
                 instance_id: instanceId,
                 session_id: sessionId,
-                harness: "codex",
+                adapter: "codex",
                 ts,
                 data: {
                     tool_name: name === "exec_command" ? "Bash" : name,
@@ -94,7 +94,7 @@ export function replayCodexJsonl(opts) {
                     event_type: "state.status_checked",
                     instance_id: instanceId,
                     session_id: sessionId,
-                    harness: "codex",
+                    adapter: "codex",
                     ts,
                     data: { source: "codex-replay" },
                 });
@@ -105,7 +105,7 @@ export function replayCodexJsonl(opts) {
                     event_type: "state.task_set",
                     instance_id: instanceId,
                     session_id: sessionId,
-                    harness: "codex",
+                    adapter: "codex",
                     ts,
                     data: { source: "codex-replay" },
                 });
@@ -121,7 +121,7 @@ export function replayCodexJsonl(opts) {
         event_type: "turn.stop",
         instance_id: instanceId,
         session_id: sessionId,
-        harness: "codex",
+        adapter: "codex",
         data: {
             status_box_present: boxPresent,
             tool_call_count: -1,

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

@@ -38,7 +38,7 @@ export interface Heartbeat {
     last_tool_target?: string;
     /** Free-form task/intent string set via `harn agents set-task`. Phase 2. */
     task?: string;
-    /** UTC ISO-8601 timestamp when task was last set/cleared. Used by harnesses without Stop enforcement to compute staleness. 2026-05-24. */
+    /** UTC ISO-8601 timestamp when task was last set/cleared. Used by adapters without Stop enforcement to compute staleness. 2026-05-24. */
     task_updated_at?: string | null;
     /** Auto-generated per-turn summary written by the Stop hook via Haiku. 2026-05-23. */
     turn_summary?: string | null;
@@ -62,6 +62,25 @@ export declare function monorepoRoot(): string | null;
 export declare function parsePidmapRowOwner(row: string): string;
 /** Parse platform from a pid-map row; legacy rows default to `claude_code`. */
 export declare function parsePidmapRowPlatform(row: string): string;
+/** Parse the start token from a pid-map row; rows written before it carry none. */
+export declare function parsePidmapRowStartToken(row: string): string | undefined;
+/**
+ * Is the process now holding `pid` the one this row was written for?
+ *
+ * A pid is a number the OS re-issues, and quickly: a `pid_max` of 99999 against
+ * ~100 new processes a second recycles the whole space about every quarter
+ * hour. Believing a row past that point resolves this session to whichever
+ * agent last held the number — which is what made `whoami` report a stranger's
+ * name and files. The start token settles it, since two processes may share a
+ * pid but never a pid and a start instant.
+ *
+ * Deliberately inlined rather than imported from `state/proc-start.ts`: this
+ * file is vendored verbatim into a downstream consumer and stays on node
+ * builtins only. The token is a wire format shared with that module and with
+ * the host's commit guard, so the copies must agree byte for byte; exported so
+ * a test can hold this one against `processStartToken` and fail on drift.
+ */
+export declare function pidStartToken(pid: number): string | null;
 /**
  * Walk up the ppid chain looking for a pid-map entry. Returns
  * the resolved instance_id or null.
@@ -87,7 +106,7 @@ export declare function resolveOwnerWithSource(): {
     source: "env" | "pidmap" | "pidmap_fallback" | "session_env" | "active_singleton" | "none";
 };
 /**
- * Resolve the owner by matching the harness session-id env var against the
+ * Resolve the owner by matching the adapter session-id env var against the
  * `session_id` of a live heartbeat in this coord root. Returns the matching
  * `instance_id`, or null if there's no session-id env var or no live heartbeat
  * carries it. "Live" reuses the same 10-minute freshness window the singleton

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

@@ -1 +1 @@
-{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0IAA0I;IAC1I,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CA0C5C;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1D;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAkEA;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMlE;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC"}
+{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yIAAyI;IACzI,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CA0C5C;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CA2DA;AA0DD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMlE;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC"}

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

@@ -107,9 +107,97 @@ export function parsePidmapRowOwner(row) {
 }
 /** Parse platform from a pid-map row; legacy rows default to `claude_code`. */
 export function parsePidmapRowPlatform(row) {
-    const trimmed = row.trim();
-    const tab = trimmed.indexOf("\t");
-    return tab >= 0 ? trimmed.slice(tab + 1).trim() : "claude_code";
+    const platform = row.trim().split("\t")[1]?.trim();
+    return platform || "claude_code";
+}
+/** Parse the start token from a pid-map row; rows written before it carry none. */
+export function parsePidmapRowStartToken(row) {
+    return row.trim().split("\t")[2]?.trim() || undefined;
+}
+/**
+ * Is the process now holding `pid` the one this row was written for?
+ *
+ * A pid is a number the OS re-issues, and quickly: a `pid_max` of 99999 against
+ * ~100 new processes a second recycles the whole space about every quarter
+ * hour. Believing a row past that point resolves this session to whichever
+ * agent last held the number — which is what made `whoami` report a stranger's
+ * name and files. The start token settles it, since two processes may share a
+ * pid but never a pid and a start instant.
+ *
+ * Deliberately inlined rather than imported from `state/proc-start.ts`: this
+ * file is vendored verbatim into a downstream consumer and stays on node
+ * builtins only. The token is a wire format shared with that module and with
+ * the host's commit guard, so the copies must agree byte for byte; exported so
+ * a test can hold this one against `processStartToken` and fail on drift.
+ */
+export function pidStartToken(pid) {
+    const forced = process.env.HARNERY_PID_PROBE;
+    const useProcfs = forced === "procfs" || (forced !== "ps" && existsSync("/proc/self/stat"));
+    // One machine, one probe. Falling back to the other on a read failure would
+    // answer in the wrong dialect and read as a recycled pid.
+    if (useProcfs) {
+        try {
+            const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+            const afterComm = stat.slice(stat.lastIndexOf(") ") + 2);
+            // Fields after comm, 0-based: 0 is state (field 3), starttime (22) is 19.
+            const ticks = afterComm.split(" ")[19];
+            if (!ticks || !/^\d+$/.test(ticks))
+                return null;
+            // Ticks count from boot, so they repeat across reboots; the boot id scopes
+            // them. Rows written before it carry ticks alone and still compare.
+            let boot = "";
+            try {
+                const raw = readFileSync("/proc/sys/kernel/random/boot_id", "utf8")
+                    .trim()
+                    .replace(/-/g, "");
+                if (/^[0-9a-f]{8,}$/.test(raw))
+                    boot = `${raw.slice(0, 8)}.`;
+            }
+            catch {
+                /* unnamed boot: fall back to the tick-only shape */
+            }
+            return `l${boot}${ticks}`;
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        // TZ and locale are pinned because `ps` renders the date through them, and
+        // two callers with different environments must not disagree about one
+        // process.
+        const out = spawnSync("ps", ["-o", "lstart=", "-p", String(pid)], {
+            encoding: "utf8",
+            timeout: 2000,
+            env: { ...process.env, TZ: "UTC", LC_ALL: "C" },
+        });
+        if (out.status !== 0)
+            return null;
+        const lstart = (out.stdout ?? "").split("\n")[0]?.trim().replace(/\s+/g, " ");
+        return lstart ? `p${lstart}` : null;
+    }
+    catch {
+        return null;
+    }
+}
+function pidWasRecycled(pid, row) {
+    const recorded = parsePidmapRowStartToken(row);
+    if (!recorded)
+        return false; // pre-token row: unverifiable, behave as before
+    const current = pidStartToken(pid);
+    if (!current)
+        return false;
+    if (current === recorded)
+        return false;
+    // A row predating the boot segment recorded ticks alone; compare it on what
+    // it recorded rather than pruning every live row on the first upgraded run.
+    if (recorded[0] === "l" &&
+        current[0] === "l" &&
+        recorded.includes(".") !== current.includes(".")) {
+        const ticks = (t) => (t.includes(".") ? t.slice(t.indexOf(".") + 1) : t.slice(1));
+        return ticks(recorded) !== ticks(current);
+    }
+    return true;
 }
 function readPidmapRow(pidmapDir, pid) {
     const candidate = resolve(pidmapDir, String(pid));
@@ -153,9 +241,14 @@ export function resolveOwnerWithSource() {
     const root = monorepoRoot();
     if (!root)
         return { owner: null, source: "none" };
-    // Cursor's Glass/Agents UI can run several chats under one long-lived node
-    // process, so the pid-map row for that shared ancestor is last-writer-wins.
-    // Prefer the per-chat session id when Cursor exposes one in the tool env.
+    // Every supported adapter exports its session id into the env of the
+    // subprocess it spawns for a tool call, and each heartbeat records the
+    // session id it was minted under. Matching the two names us outright, even
+    // with many live agents, so it goes ahead of the ppid walk rather than
+    // catching what the walk drops. Cursor needed this first because its
+    // Glass/Agents UI runs several chats under one node ancestor, making that row
+    // last-writer-wins; pid recycling generalises the same hazard to every
+    // adapter.
     if (shouldPreferSessionEnv()) {
         const bySession = resolveOwnerBySessionEnv(root);
         if (bySession) {
@@ -172,7 +265,7 @@ export function resolveOwnerWithSource() {
         if (pid === null)
             break;
         const row = readPidmapRow(pidmapDir, pid);
-        if (row) {
+        if (row && !pidWasRecycled(pid, row)) {
             const rowOwner = parsePidmapRowOwner(row);
             const rowPlat = parsePidmapRowPlatform(row);
             if (rowPlat === prefer) {
@@ -186,17 +279,6 @@ export function resolveOwnerWithSource() {
     if (fallbackOwner) {
         return { owner: fallbackOwner, source: "pidmap_fallback" };
     }
-    // The ppid walk found nothing (e.g. a Bash-tool subshell whose process tree
-    // doesn't climb back to the harness anchor). Before guessing, try the
-    // harness-provided session id from the environment: every supported harness
-    // exports its session id into the tool subprocess env, and each heartbeat
-    // records the `session_id` it was minted under. Matching the two resolves us
-    // unambiguously even with multiple live agents, which is the case the
-    // singleton fallback below cannot handle.
-    const bySession = resolveOwnerBySessionEnv(root);
-    if (bySession) {
-        return { owner: bySession, source: "session_env" };
-    }
     // Last resort: if exactly one agent is live in this coord root, it's
     // unambiguously us — resolve to it. This is what lets the bare `agents
     // status` / `set-task` the stop hook recommends work without a `--session-id`
@@ -209,8 +291,8 @@ export function resolveOwnerWithSource() {
     return { owner: null, source: "none" };
 }
 /**
- * Harness-exported session-id environment variables, in precedence order. Each
- * supported harness propagates its session id into the env of the subprocess it
+ * Adapter-exported session-id environment variables, in precedence order. Each
+ * supported adapter propagates its session id into the env of the subprocess it
  * spawns for a tool call (Claude Code's Bash tool, Cursor's terminal, Codex's
  * shell). A coord CLI invoked as such a tool can therefore recover its own
  * identity from the env even when the ppid walk misses.
@@ -225,7 +307,7 @@ const SESSION_ID_ENV_VARS = [
     "CURSOR_CONVERSATION_ID",
     "CODEX_SESSION_ID",
 ];
-/** Read normalized candidates from the first non-empty harness session-id env var. */
+/** Read normalized candidates from the first non-empty adapter session-id env var. */
 function sessionIdsFromEnv() {
     for (const key of SESSION_ID_ENV_VARS) {
         const v = process.env[key]?.trim();
@@ -238,18 +320,31 @@ function sessionIdsFromEnv() {
     }
     return [];
 }
-/** Read the first non-empty harness session-id env var, or null. */
+/** Read the first non-empty adapter session-id env var, or null. */
 function sessionIdFromEnv() {
     return sessionIdsFromEnv()[0] ?? null;
 }
+/**
+ * Should the adapter-exported session id be consulted before the ppid walk?
+ *
+ * Yes, whenever one is exported. The env var is the adapter stating its own
+ * identity; the walk is a guess over a namespace the OS recycles. On a box with
+ * `pid_max` of 99999 and ~100 pids allocated per second the whole pid space
+ * turns over about every quarter hour, so a row written before that can name a
+ * pid some unrelated process now holds. Pruning cannot save the walk here:
+ * it removes rows whose pid is dead, and a recycled pid is alive. Letting a
+ * guess outrank a statement of fact is what made `agents whoami` report another
+ * agent's name and file list.
+ *
+ * This only reorders the two. Session-env resolution still requires a live
+ * heartbeat carrying that session id, so when it does not match, the walk runs
+ * exactly as before.
+ */
 function shouldPreferSessionEnv() {
-    if (!sessionIdFromEnv())
-        return false;
-    const platform = process.env.HARNERY_AGENT_COORD_PLATFORM?.trim();
-    return process.env.CURSOR_AGENT === "1" || platform === "cursor";
+    return sessionIdFromEnv() !== null;
 }
 /**
- * Resolve the owner by matching the harness session-id env var against the
+ * Resolve the owner by matching the adapter session-id env var against the
  * `session_id` of a live heartbeat in this coord root. Returns the matching
  * `instance_id`, or null if there's no session-id env var or no live heartbeat
  * carries it. "Live" reuses the same 10-minute freshness window the singleton

package/dist/core/agents/events/consume.d.ts

@@ -33,7 +33,7 @@ export interface CanonicalEvent {
     parent_session_id?: string;
     turn_id?: string;
     parent_turn_id?: string;
-    harness: string;
+    adapter: string;
     source: string;
     data: Record<string, unknown>;
 }

package/dist/core/agents/events/emit.d.ts

@@ -5,12 +5,12 @@
  * event/schema types).
  *
  * Phase 4: agent-coord uses this from CLI handlers (state.task_set,
- * state.status_checked, state.scratch_append, council.*, decision.*,
+ * state.status_checked, state.journal_append, council.*, decision.*,
  * presence.*).
  */
 declare const SCHEMA_VERSION: 1;
-export type Harness = "claude-code" | "cursor" | "codex";
-export type Source = "agent-hooks" | "agent-coord" | "user" | "system";
+export type { Adapter, Source } from "../../hooks/events/schema.js";
+import type { Adapter, Source } from "../../hooks/events/schema.js";
 export interface Envelope {
     schema_version: typeof SCHEMA_VERSION;
     event_id: string;
@@ -21,7 +21,7 @@ export interface Envelope {
     parent_session_id?: string;
     turn_id?: string;
     parent_turn_id?: string;
-    harness: Harness;
+    adapter: Adapter;
     source: Source;
     data: Record<string, unknown>;
 }
@@ -29,7 +29,7 @@ export interface EmitInput {
     event_type: string;
     instance_id: string;
     session_id: string;
-    harness: Harness;
+    adapter: Adapter;
     source?: Source;
     parent_session_id?: string;
     turn_id?: string;
@@ -39,5 +39,4 @@ export interface EmitInput {
 }
 export declare function buildEnvelope(input: EmitInput): Envelope;
 export declare function emit(coordRoot: string, input: EmitInput): Envelope;
-export {};
 //# sourceMappingURL=emit.d.ts.map

package/dist/core/agents/events/emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/events/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,QAAA,MAAM,cAAc,EAAG,CAAU,CAAC;AAKlC,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AACzD,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAexD;AAED,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,CA4BlE"}
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/events/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,QAAA,MAAM,cAAc,EAAG,CAAU,CAAC;AAKlC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAexD;AAED,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,CA4BlE"}

package/dist/core/agents/events/emit.js

@@ -5,7 +5,7 @@
  * event/schema types).
  *
  * Phase 4: agent-coord uses this from CLI handlers (state.task_set,
- * state.status_checked, state.scratch_append, council.*, decision.*,
+ * state.status_checked, state.journal_append, council.*, decision.*,
  * presence.*).
  */
 import { appendFileSync, closeSync, mkdirSync, openSync } from "node:fs";
@@ -27,7 +27,7 @@ export function buildEnvelope(input) {
         parent_session_id: input.parent_session_id,
         turn_id: input.turn_id,
         parent_turn_id: input.parent_turn_id,
-        harness: input.harness,
+        adapter: input.adapter,
         source: input.source ?? "agent-coord",
         data: input.data,
     };

package/dist/core/agents/render/prompt-context.d.ts

@@ -1,19 +1,25 @@
 /**
  * UserPromptSubmit UX renderer. Combines the peer-refresh dedup, the
- * council-pending hash-dedup, and the Cursor set-task staleness nudge.
+ * council-pending hash-dedup, the cross-adapter first-session naming nudge,
+ * the Cursor/Codex set-task staleness nudge, and the Codex status-footer
+ * reminder.
  * agent-hook's user_prompt.submit post-emit handler calls this
- * and forwards the result as the harness-shaped additionalContext payload.
+ * and forwards the result as the adapter-shaped additionalContext payload.
  *
- * Three hash-dedup'd subsections combined into one additionalContext payload:
+ * Four subsections combined into one additionalContext payload:
  *   1. Peer table: semantically-relevant peer fields hashed; only re-emits
  *      when peers change (name + instance_id + session_id + kind + started_at
  *      + sorted(files_touched) + platform, sorted by instance_id).
  *   2. Council pending: pending open-council IDs hashed; re-emits when the
  *      ID set changes.
- *   3. Task staleness nudge (cursor only, since CC enforces via the Stop hook
- *      transcript scan). Fires when `task` is null or `task_updated_at` is
- *      older than HARNERY_TASK_STALE_SECONDS (default 1800 = 30 min). Hash-deduped
- *      against the previous nudge state.
+ *   3. Focus nudge. Before the first set-task in a human-facing session, tells
+ *      every adapter to reproduce set-task's suggested session name in a fenced
+ *      code block. Cursor/Codex additionally get the existing unset/stale-task
+ *      reminder because their Stop hooks do not enforce task declarations as
+ *      reliably as Claude Code's.
+ *   4. Codex status footer: a non-deduplicated reminder to put the live status
+ *      box after the substantive answer. Stop stays observe-only, so missing the
+ *      footer can never trigger a replacement response.
  *
  * Hash files live at:
  *   .harnery/.last-peer-hash.<instance_id>
@@ -27,9 +33,15 @@ export interface PromptContextOpts {
     instanceId: string;
     sessionId: string;
     agentName?: string;
-    /** When true, run the task-staleness nudge check (cursor only; CC has the
-     * Stop-hook transcript-scan enforcement). */
+    /** When true, remind a human-facing session to print the session name before
+     * its first set-task. UserPromptSubmit enables this for every adapter. */
+    sessionNameNudge?: boolean;
+    /** When true, run the unset/stale-task check after the first set-task.
+     * Cursor/Codex use this; Claude Code has Stop-hook transcript enforcement. */
     taskNudge?: boolean;
+    /** When true, append the non-deduplicated Codex status-footer reminder.
+     * The caller enables this only for human-facing Codex sessions. */
+    statusFooterNudge?: boolean;
 }
 /**
  * Build the combined UserPromptSubmit additionalContext string. Returns "" when

package/dist/core/agents/render/prompt-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAiCH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;iDAC6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAqBnE"}
+{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAoCH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;kFAC8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA0CnE"}