harnery 0.30.0 → 0.31.0

package/dist/core/hooks/effects/image-capture.d.ts

@@ -9,15 +9,15 @@
  * the canonical stream. The web image feed (`/images`) groups those events by
  * hash and streams them live over the existing SSE infra.
  *
- * Why this lives at the hook layer: it's the single harness-agnostic chokepoint
+ * Why this lives at the hook layer: it's the single adapter-agnostic chokepoint
  * that sees every tool call across Claude Code / Cursor / Codex with the full
  * `tool_input` (file paths) and `tool_response`. No per-command code needed.
  *
  * Everything here is best-effort and MUST NOT throw; callers wrap it in
  * try/catch + logError, matching every other effect.
  */
-import type { Harness } from "../events/schema.js";
-import type { ParsedPayload } from "../harness/parse.js";
+import type { ParsedPayload } from "../adapter/parse.js";
+import type { Adapter } from "../events/schema.js";
 export interface CaptureContext {
     eventType: "tool.pre_use" | "tool.post_use";
     /** The built event data (tool_name, tool_input string, intent, tool_use_id). */
@@ -26,7 +26,7 @@ export interface CaptureContext {
     payload: ParsedPayload | null;
     instanceId: string;
     sessionId: string;
-    harness: Harness;
+    adapter: Adapter;
 }
 /**
  * Inspect one tool event for image references and capture any that resolve to
@@ -36,7 +36,7 @@ export declare function captureImages(coordRoot: string, ctx: CaptureContext): v
 /**
  * Prune `.harnery/images/` past a size cap (default 2 GB) and an age cap
  * (default 30 days), oldest-mtime-first. Fired on session.start next to
- * scratchJanitor. Pure-fs, fail-soft. Orphaned `image.captured` events whose
+ * journalJanitor. Pure-fs, fail-soft. Orphaned `image.captured` events whose
  * blob was pruned render as an "expired" placeholder in the gallery.
  */
 export declare function imageJanitor(coordRoot: string): void;

package/dist/core/hooks/effects/image-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-capture.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/effects/image-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoBzD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,GAAG,eAAe,CAAC;IAC5C,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gFAAgF;IAChF,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAoC1E;AA2FD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmDpD"}
+{"version":3,"file":"image-capture.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/effects/image-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAoBnD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,GAAG,eAAe,CAAC;IAC5C,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gFAAgF;IAChF,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAoC1E;AA2FD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmDpD"}

package/dist/core/hooks/effects/image-capture.js

@@ -9,7 +9,7 @@
  * the canonical stream. The web image feed (`/images`) groups those events by
  * hash and streams them live over the existing SSE infra.
  *
- * Why this lives at the hook layer: it's the single harness-agnostic chokepoint
+ * Why this lives at the hook layer: it's the single adapter-agnostic chokepoint
  * that sees every tool call across Claude Code / Cursor / Codex with the full
  * `tool_input` (file paths) and `tool_response`. No per-command code needed.
  *
@@ -58,7 +58,7 @@ export function captureImages(coordRoot, ctx) {
             event_type: "image.captured",
             instance_id: ctx.instanceId,
             session_id: ctx.sessionId,
-            harness: ctx.harness,
+            adapter: ctx.adapter,
             data: {
                 hash: captured.hash,
                 ext: captured.ext,
@@ -162,7 +162,7 @@ function captureOne(imagesDir, cand) {
 /**
  * Prune `.harnery/images/` past a size cap (default 2 GB) and an age cap
  * (default 30 days), oldest-mtime-first. Fired on session.start next to
- * scratchJanitor. Pure-fs, fail-soft. Orphaned `image.captured` events whose
+ * journalJanitor. Pure-fs, fail-soft. Orphaned `image.captured` events whose
  * blob was pruned render as an "expired" placeholder in the gallery.
  */
 export function imageJanitor(coordRoot) {

package/dist/core/hooks/effects/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * Non-coordination side effects fired from the normalized `agent-hook` handlers.
  *
- * These are DELIBERATELY outside the agent-coord path: sounds, scratch
+ * These are DELIBERATELY outside the agent-coord path: sounds, journal
  * lifecycle, session telemetry, presence detection. They used to live in
- * per-harness bash adapters. Per the directive ("use the normalized hooks; if
+ * per-adapter bash adapters. Per the directive ("use the normalized hooks; if
  * they aren't coordination, implement them outside of coordination") they move
- * here so the harness configs reference only `agent-hook`, while staying a
+ * here so the adapter configs reference only `agent-hook`, while staying a
  * distinct concern from the coordination logic in cli.ts / agent-coord.
  *
  * Everything here is best-effort: it never throws and never blocks the hook on a
@@ -26,27 +26,27 @@ export declare function soundForEvent(eventName: string): {
     sound: string;
     maxPlays: number;
 } | null;
-/** Prune stale scratch archives + sweep orphans (global, fast). Fire-and-forget. */
-export declare function scratchJanitor(repoRoot: string): void;
+/** Prune stale journal archives + sweep orphans (global, fast). Fire-and-forget. */
+export declare function journalJanitor(repoRoot: string): void;
 /**
- * Return the one-line scratch recovery cue for SessionStart, or "" if none.
+ * Return the one-line journal recovery cue for SessionStart, or "" if none.
  * The caller merges it into the session-start additionalContext (it used to be
- * a standalone additionalContext emission from the previous scratch-on-start adapter).
+ * a standalone additionalContext emission from the previous journal-on-start adapter).
  */
-export declare function scratchRecoveryCue(repoRoot: string): string;
-/** Archive the ending agent's scratchpad. Fire-and-forget. */
-export declare function scratchArchive(repoRoot: string, owner: string): void;
+export declare function journalRecoveryCue(repoRoot: string): string;
+/** Archive the ending agent's journal. Fire-and-forget. */
+export declare function journalArchive(repoRoot: string, owner: string): void;
 /**
  * Fire the optional host session-sync extension on turn stop / session end.
  * harnery core has no session-telemetry sink of its own; a host that wants one
  * drops an executable at
- * `scripts/hooks/harness/claude_code/extensions/session-sync.sh` under the coord
+ * `scripts/hooks/adapter/claude_code/extensions/session-sync.sh` under the coord
  * root, and core runs it detached + unref'd so a slow sink never blocks the
  * hook. `force` arrives as argv $1 ("1" on session end, "0" on turn stop) so the
  * host can rate-limit the stop path and force-flush on end. No-op when the
  * script is absent, so a plain public install spawns nothing. Mirrors
  * `runTurnSummary`'s extension-script pattern. Caller gates to the claude-code
- * harness.
+ * adapter.
  */
 export declare function runSessionSyncExtension(repoRoot: string, force: boolean): void;
 /**

package/dist/core/hooks/effects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/effects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAI,GACX,IAAI,CAYN;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW3F;AAOD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa3D;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAqB9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAqBN;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/effects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAI,GACX,IAAI,CAYN;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW3F;AAOD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa3D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAqB9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAqBN;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOnD"}

package/dist/core/hooks/effects/index.js

@@ -1,11 +1,11 @@
 /**
  * Non-coordination side effects fired from the normalized `agent-hook` handlers.
  *
- * These are DELIBERATELY outside the agent-coord path: sounds, scratch
+ * These are DELIBERATELY outside the agent-coord path: sounds, journal
  * lifecycle, session telemetry, presence detection. They used to live in
- * per-harness bash adapters. Per the directive ("use the normalized hooks; if
+ * per-adapter bash adapters. Per the directive ("use the normalized hooks; if
  * they aren't coordination, implement them outside of coordination") they move
- * here so the harness configs reference only `agent-hook`, while staying a
+ * here so the adapter configs reference only `agent-hook`, while staying a
  * distinct concern from the coordination logic in cli.ts / agent-coord.
  *
  * Everything here is best-effort: it never throws and never blocks the hook on a
@@ -56,13 +56,13 @@ function harnBin(repoRoot) {
     const bin = join(repoRoot, "harnery", "bin", "harn");
     return existsSync(bin) ? bin : null;
 }
-/** Prune stale scratch archives + sweep orphans (global, fast). Fire-and-forget. */
-export function scratchJanitor(repoRoot) {
+/** Prune stale journal archives + sweep orphans (global, fast). Fire-and-forget. */
+export function journalJanitor(repoRoot) {
     try {
         const bin = harnBin(repoRoot);
         if (!bin)
             return;
-        spawnSync("bash", [bin, "scratch", "janitor", "--quiet"], {
+        spawnSync("bash", [bin, "journal", "janitor", "--quiet"], {
             env: { ...process.env, HARNERY_OUTPUT_SESSION_TEE: "0" },
             timeout: 5000,
             stdio: "ignore",
@@ -73,16 +73,16 @@ export function scratchJanitor(repoRoot) {
     }
 }
 /**
- * Return the one-line scratch recovery cue for SessionStart, or "" if none.
+ * Return the one-line journal recovery cue for SessionStart, or "" if none.
  * The caller merges it into the session-start additionalContext (it used to be
- * a standalone additionalContext emission from the previous scratch-on-start adapter).
+ * a standalone additionalContext emission from the previous journal-on-start adapter).
  */
-export function scratchRecoveryCue(repoRoot) {
+export function journalRecoveryCue(repoRoot) {
     try {
         const bin = harnBin(repoRoot);
         if (!bin)
             return "";
-        const r = spawnSync("bash", [bin, "scratch", "recovery-cue"], {
+        const r = spawnSync("bash", [bin, "journal", "recovery-cue"], {
             env: { ...process.env, HARNERY_OUTPUT_SESSION_TEE: "0" },
             timeout: 5000,
             encoding: "utf8",
@@ -93,13 +93,13 @@ export function scratchRecoveryCue(repoRoot) {
         return "";
     }
 }
-/** Archive the ending agent's scratchpad. Fire-and-forget. */
-export function scratchArchive(repoRoot, owner) {
+/** Archive the ending agent's journal. Fire-and-forget. */
+export function journalArchive(repoRoot, owner) {
     try {
         const bin = harnBin(repoRoot);
         if (!bin || !owner)
             return;
-        spawnSync("bash", [bin, "scratch", "archive", "--owner", owner], {
+        spawnSync("bash", [bin, "journal", "archive", "--owner", owner], {
             env: { ...process.env, HARNERY_OUTPUT_SESSION_TEE: "0" },
             timeout: 5000,
             stdio: "ignore",
@@ -113,17 +113,17 @@ export function scratchArchive(repoRoot, owner) {
  * Fire the optional host session-sync extension on turn stop / session end.
  * harnery core has no session-telemetry sink of its own; a host that wants one
  * drops an executable at
- * `scripts/hooks/harness/claude_code/extensions/session-sync.sh` under the coord
+ * `scripts/hooks/adapter/claude_code/extensions/session-sync.sh` under the coord
  * root, and core runs it detached + unref'd so a slow sink never blocks the
  * hook. `force` arrives as argv $1 ("1" on session end, "0" on turn stop) so the
  * host can rate-limit the stop path and force-flush on end. No-op when the
  * script is absent, so a plain public install spawns nothing. Mirrors
  * `runTurnSummary`'s extension-script pattern. Caller gates to the claude-code
- * harness.
+ * adapter.
  */
 export function runSessionSyncExtension(repoRoot, force) {
     try {
-        const script = join(repoRoot, "scripts", "hooks", "harness", "claude_code", "extensions", "session-sync.sh");
+        const script = join(repoRoot, "scripts", "hooks", "adapter", "claude_code", "extensions", "session-sync.sh");
         if (!existsSync(script))
             return;
         const child = spawn("bash", [script, force ? "1" : "0"], {
@@ -147,7 +147,7 @@ export function runTurnSummary(repoRoot, owner, sessionId, transcriptPath) {
     try {
         if (!transcriptPath || !existsSync(transcriptPath))
             return;
-        const script = join(repoRoot, "scripts", "hooks", "harness", "claude_code", "extensions", "turn-summary.sh");
+        const script = join(repoRoot, "scripts", "hooks", "adapter", "claude_code", "extensions", "turn-summary.sh");
         if (!existsSync(script))
             return;
         const child = spawn("bash", [script, owner, sessionId, transcriptPath], {

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

@@ -1,9 +1,9 @@
-import { type EventEnvelope, type EventType, type Harness, type Source } from "./schema.js";
+import { type Adapter, type EventEnvelope, type EventType, type Source } from "./schema.js";
 export interface EmitInput<TType extends EventType, TData> {
     event_type: TType;
     instance_id: string;
     session_id: string;
-    harness: Harness;
+    adapter: Adapter;
     source?: Source;
     parent_session_id?: string;
     turn_id?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/events/emit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,OAAO,EAEZ,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAQrB,MAAM,WAAW,SAAS,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK;IACvD,UAAU,EAAE,KAAK,CAAC;IAClB,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,KAAK,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK,EAC1D,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAC7B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAe7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK,EACjD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAC7B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAyC7B"}
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/events/emit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,SAAS,EAEd,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAQrB,MAAM,WAAW,SAAS,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK;IACvD,UAAU,EAAE,KAAK,CAAC;IAClB,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,KAAK,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK,EAC1D,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAC7B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAe7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK,EACjD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAC7B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAyC7B"}

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

@@ -21,7 +21,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-hooks",
         data: input.data,
     };

package/dist/core/hooks/events/rotate.js

@@ -48,7 +48,7 @@ function resolveRollBytes() {
     return Number.isFinite(n) && n > 0 ? n : DEFAULT_ROLL_BYTES;
 }
 /** `YYYY-MM-DD` (UTC) from a millisecond timestamp. Uses the file's own mtime
- * rather than `Date.now()` so it's deterministic and independent of the harness
+ * rather than `Date.now()` so it's deterministic and independent of the adapter
  * runtime's clock surface. */
 function utcDateStamp(mtimeMs) {
     const d = new Date(mtimeMs);

package/dist/core/hooks/events/schema.d.ts

@@ -10,7 +10,11 @@
  *     `schema_version`.
  */
 export declare const SCHEMA_VERSION: 1;
-export type Harness = "claude-code" | "cursor" | "codex";
+/** The adapters harnery ships first-party hook wiring for. The registry's open
+ * `AdapterId` covers any adapter a host registers; this is the closed set, and
+ * it is declared exactly once. Re-exported by the two event modules that used
+ * to keep their own byte-identical copy. */
+export type Adapter = "claude-code" | "cursor" | "codex";
 export type Source = "agent-hooks" | "agent-coord" | "user" | "system";
 /**
  * Common envelope every event carries. Tool events, `user_prompt.submit`, and
@@ -28,7 +32,7 @@ export interface EventEnvelope<TType extends string, TData> {
     parent_session_id?: string;
     turn_id?: string;
     parent_turn_id?: string;
-    harness: Harness;
+    adapter: Adapter;
     source: Source;
     data: TData;
 }
@@ -38,9 +42,13 @@ export type SessionStart = EventEnvelope<"session.start", {
     model?: string;
     pid: number;
     /** Present iff this session is a `workflow run` child: the run id whose
-     * journal owns it (child env HARNERY_WORKFLOW_RUN_ID). Optional-field
+     * transcript owns it (child env HARNERY_WORKFLOW_RUN_ID). Optional-field
      * addition per the schema evolution rules (minor bump). */
     workflow_run_id?: string;
+    /** Which agent row of that run this session is running (`a1`, `a2`, …), from
+     * child env HARNERY_WORKFLOW_AGENT_ID. Lets a dashboard attribute in-flight
+     * child activity to one agent instead of only to the run. */
+    workflow_agent_id?: string;
 }>;
 export type SessionEnd = EventEnvelope<"session.end", {
     ended_at: string;
@@ -175,7 +183,7 @@ export type StateStatusChecked = EventEnvelope<"state.status_checked", {
     agent_count: number;
     included_self: boolean;
 }>;
-export type StateScratchAppend = EventEnvelope<"state.scratch_append", {
+export type StateJournalAppend = EventEnvelope<"state.journal_append", {
     category: "note" | "plan" | "decision" | "blocker" | "question" | "done" | "handoff";
     body_summary: string;
 }>;
@@ -261,7 +269,7 @@ export type HealthVerdictFailure = EventEnvelope<"health.verdict_failure", {
     timeout_ms?: number;
     fallback: "allow";
 }>;
-export type Event = SessionStart | SessionEnd | SubagentStart | SubagentStop | UserPromptSubmit | TurnStop | CommandStart | CommandOutput | CommandEnd | Narration | ToolPreUse | ToolPostUse | ToolPostUseFailure | ToolOutputChunk | ImageCaptured | ContextSampled | ContextCheckpointCreated | ContextCompactionStarted | ContextCompactionCompleted | ContextRecoveryInjected | ClaimAcquire | ClaimRelease | ClaimConflict | StateTaskSet | StateStatusChecked | StateScratchAppend | StatePresenceChange | StateHeartbeat | IdentityAssumed | CouncilOpen | CouncilRoundOpen | CouncilContribution | CouncilRoundClose | CouncilClose | CouncilArchive | DecisionBlock | DecisionWarn | DecisionAllow | HealthHeartbeatHeal | HealthPidmapHeal | HealthHeartbeatSwept | HealthVerdictFailure;
+export type Event = SessionStart | SessionEnd | SubagentStart | SubagentStop | UserPromptSubmit | TurnStop | CommandStart | CommandOutput | CommandEnd | Narration | ToolPreUse | ToolPostUse | ToolPostUseFailure | ToolOutputChunk | ImageCaptured | ContextSampled | ContextCheckpointCreated | ContextCompactionStarted | ContextCompactionCompleted | ContextRecoveryInjected | ClaimAcquire | ClaimRelease | ClaimConflict | StateTaskSet | StateStatusChecked | StateJournalAppend | StatePresenceChange | StateHeartbeat | IdentityAssumed | CouncilOpen | CouncilRoundOpen | CouncilContribution | CouncilRoundClose | CouncilClose | CouncilArchive | DecisionBlock | DecisionWarn | DecisionAllow | HealthHeartbeatHeal | HealthPidmapHeal | HealthHeartbeatSwept | HealthVerdictFailure;
 export type EventType = Event["event_type"];
 /**
  * Redaction marker that may be attached to any `data` payload during emission.

package/dist/core/hooks/events/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/events/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/events/schema.ts"],"names":[],"mappings":"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"}

package/dist/core/hooks/guard-path.d.ts

@@ -2,7 +2,7 @@
  * Canonicalize a write-tool target path for the claim guard.
  *
  * Returns the monorepo-relative path, or `null` when the target lies OUTSIDE the
- * repo (an absolute path not under coordRoot, e.g. a `/tmp` scratchpad or other
+ * repo (an absolute path not under coordRoot, e.g. a `/tmp` journal or other
  * session-temp file).
  *
  * The claim system is intentionally repo-scoped: it coordinates monorepo files,
@@ -10,7 +10,7 @@
  * them is right on two counts. First, it keeps non-repo paths out of a
  * heartbeat's `files_touched`. Second, the ordering rule compares raw path
  * strings, and an absolute `/tmp/…` sorts before every repo-relative path
- * (`/` = 0x2F < any letter), so without this a scratchpad write would spuriously
+ * (`/` = 0x2F < any letter), so without this a journal write would spuriously
  * "block" a legitimately-held repo file. Returning null keeps such paths out of
  * the claim system entirely.
  *

package/dist/core/hooks/guard-path.js

@@ -2,7 +2,7 @@
  * Canonicalize a write-tool target path for the claim guard.
  *
  * Returns the monorepo-relative path, or `null` when the target lies OUTSIDE the
- * repo (an absolute path not under coordRoot, e.g. a `/tmp` scratchpad or other
+ * repo (an absolute path not under coordRoot, e.g. a `/tmp` journal or other
  * session-temp file).
  *
  * The claim system is intentionally repo-scoped: it coordinates monorepo files,
@@ -10,7 +10,7 @@
  * them is right on two counts. First, it keeps non-repo paths out of a
  * heartbeat's `files_touched`. Second, the ordering rule compares raw path
  * strings, and an absolute `/tmp/…` sorts before every repo-relative path
- * (`/` = 0x2F < any letter), so without this a scratchpad write would spuriously
+ * (`/` = 0x2F < any letter), so without this a journal write would spuriously
  * "block" a legitimately-held repo file. Returning null keeps such paths out of
  * the claim system entirely.
  *

package/dist/core/hooks/index.d.ts

@@ -4,5 +4,5 @@
  * Phase 1 (skeleton): exposes only the canonical event schema types. Parsers,
  * resolvers, and emit helpers ship in Phase 2.
  */
-export { type Event, type EventEnvelope, type EventType, type Harness, type RedactionMarker, SCHEMA_VERSION, type Source, } from "./events/schema.js";
+export { type Adapter, type Event, type EventEnvelope, type EventType, type RedactionMarker, SCHEMA_VERSION, type Source, } from "./events/schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,MAAM,GACZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,MAAM,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/core/hooks/resolve/anchor.d.ts

@@ -3,7 +3,7 @@
  * the heartbeat pid-map row should be keyed to, so the agent's later shell
  * tool calls (which ppid-walk up to find it) resolve their own identity.
  *
- * Split out of cli.ts's `findHarnessAnchorPid` so the comm-matching logic is
+ * Split out of cli.ts's `findAdapterAnchorPid` so the comm-matching logic is
  * unit-testable against the real Phase 0 Cursor probe chains without needing a
  * live /proc tree.
  *
@@ -14,7 +14,7 @@
  * calls a reachable, stable pid-map row. This faithfully restores the previous
  * cursor anchor behavior (match `cursor` first, then fall back to `node`) that
  * was dropped in the Phase 4-6 TS refactor, the same regression class as the
- * heartbeat-platform + pidmap-self-heal losses. Scoped to `harness === "cursor"`
+ * heartbeat-platform + pidmap-self-heal losses. Scoped to `adapter === "cursor"`
  * so Claude Code / Codex never
  * mis-anchor on an unrelated `node` ancestor (they match their own comm token
  * directly).
@@ -24,22 +24,31 @@
  * wins between them. Single-chat-per-window (the common case) is correct;
  * concurrent same-window chats disambiguate via `--session-id`.
  */
+/**
+ * The adapter pid as stated by the adapter itself, or undefined.
+ *
+ * Sanity-checked against our own pid: a variable naming this process would
+ * anchor the row to whatever short-lived thing is running the hook, which is
+ * the failure it exists to avoid.
+ */
+export declare function adapterPidFromEnv(): number | undefined;
 /**
  * Pick the anchor PID from a ppid chain ordered nearest-first (the resolving
  * process at index 0, walking up toward init). Returns the first ancestor
- * matching a harness comm token; for cursor, falls back to the first `node`
+ * matching a adapter comm token; for cursor, falls back to the first `node`
  * ancestor; otherwise undefined (caller falls back to process.ppid).
  */
 export declare function selectAnchorPid(chain: ReadonlyArray<{
     pid: number;
     comm: string;
-}>, harness?: string): number | undefined;
+    exe?: string;
+}>, adapter?: string): number | undefined;
 /**
  * Parse one `ps -o ppid=,comm= -p <pid>` line into the same `{ ppid, comm }`
  * shape the `/proc` fast path produces, for the macOS/BSD branch of the anchor
  * walk. `ps` prints `comm` as a full executable path (and some Apple helper
  * names contain spaces, e.g. `Code Helper (Plugin)`), so the comm is reduced to
- * its basename to match the harness comm tokens the way Linux's `/proc/<pid>/comm`
+ * its basename to match the adapter comm tokens the way Linux's `/proc/<pid>/comm`
  * basename does. Returns null when the line has no leading numeric ppid.
  *
  * Pure (no I/O) so the parsing — the error-prone part — is unit-testable

package/dist/core/hooks/resolve/anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/resolve/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACnD,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQpF"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/resolve/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAoBH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAStD;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQpF"}

package/dist/core/hooks/resolve/anchor.js

@@ -3,7 +3,7 @@
  * the heartbeat pid-map row should be keyed to, so the agent's later shell
  * tool calls (which ppid-walk up to find it) resolve their own identity.
  *
- * Split out of cli.ts's `findHarnessAnchorPid` so the comm-matching logic is
+ * Split out of cli.ts's `findAdapterAnchorPid` so the comm-matching logic is
  * unit-testable against the real Phase 0 Cursor probe chains without needing a
  * live /proc tree.
  *
@@ -14,7 +14,7 @@
  * calls a reachable, stable pid-map row. This faithfully restores the previous
  * cursor anchor behavior (match `cursor` first, then fall back to `node`) that
  * was dropped in the Phase 4-6 TS refactor, the same regression class as the
- * heartbeat-platform + pidmap-self-heal losses. Scoped to `harness === "cursor"`
+ * heartbeat-platform + pidmap-self-heal losses. Scoped to `adapter === "cursor"`
  * so Claude Code / Codex never
  * mis-anchor on an unrelated `node` ancestor (they match their own comm token
  * directly).
@@ -24,21 +24,78 @@
  * wins between them. Single-chat-per-window (the common case) is correct;
  * concurrent same-window chats disambiguate via `--session-id`.
  */
-/** Harness-binary comm names. CC's tool calls descend from `claude`, Codex's
+/** Adapter-binary comm names. CC's tool calls descend from `claude`, Codex's
  * from `codex`; matched directly so neither needs the `node` fallback. */
 const PRIMARY_COMM_TOKENS = new Set(["claude", "claude-code", "cursor", "codex"]);
+/**
+ * Adapter-exported pid environment variables, in precedence order.
+ *
+ * A adapter that names its own process spares us the guessing entirely, and the
+ * guess is the part that breaks: comm matching only recognises a binary called
+ * by its adapter name, and at least one Claude Code build installs its CLI
+ * under a version-numbered filename, whose comm is a bare version string. The
+ * walk then finds nothing, falls back to the ephemeral hook shell, and writes a
+ * row that is dead within seconds.
+ *
+ * Only Claude Code is known to export one today. Absent variables cost a lookup.
+ */
+const ADAPTER_PID_ENV_VARS = ["CLAUDE_PID"];
+/**
+ * The adapter pid as stated by the adapter itself, or undefined.
+ *
+ * Sanity-checked against our own pid: a variable naming this process would
+ * anchor the row to whatever short-lived thing is running the hook, which is
+ * the failure it exists to avoid.
+ */
+export function adapterPidFromEnv() {
+    for (const key of ADAPTER_PID_ENV_VARS) {
+        const raw = process.env[key]?.trim();
+        if (!raw)
+            continue;
+        const pid = Number(raw);
+        if (!Number.isInteger(pid) || pid <= 1 || pid === process.pid)
+            continue;
+        return pid;
+    }
+    return undefined;
+}
+/**
+ * Does an executable path belong to a adapter?
+ *
+ * Read as path segments rather than substrings, so a token has to be a whole
+ * directory or file name. The leading dot is optional because adapters install
+ * under a dotted home directory, and that directory is what identifies the
+ * binary when the binary's own name is a version number.
+ */
+function pathNamesAAdapter(exePath) {
+    if (!exePath)
+        return false;
+    for (const raw of exePath.split("/")) {
+        const segment = raw.startsWith(".") ? raw.slice(1) : raw;
+        if (PRIMARY_COMM_TOKENS.has(segment))
+            return true;
+    }
+    return false;
+}
 /**
  * Pick the anchor PID from a ppid chain ordered nearest-first (the resolving
  * process at index 0, walking up toward init). Returns the first ancestor
- * matching a harness comm token; for cursor, falls back to the first `node`
+ * matching a adapter comm token; for cursor, falls back to the first `node`
  * ancestor; otherwise undefined (caller falls back to process.ppid).
  */
-export function selectAnchorPid(chain, harness) {
+export function selectAnchorPid(chain, adapter) {
     for (const hop of chain) {
         if (PRIMARY_COMM_TOKENS.has(hop.comm))
             return hop.pid;
     }
-    if (harness === "cursor") {
+    // Second pass on the executable path, for a adapter whose binary is not named
+    // after itself. Kept behind the comm pass so an exactly-named ancestor still
+    // wins, and so this only ever adds matches.
+    for (const hop of chain) {
+        if (pathNamesAAdapter(hop.exe))
+            return hop.pid;
+    }
+    if (adapter === "cursor") {
         for (const hop of chain) {
             if (hop.comm === "node")
                 return hop.pid;
@@ -51,7 +108,7 @@ export function selectAnchorPid(chain, harness) {
  * shape the `/proc` fast path produces, for the macOS/BSD branch of the anchor
  * walk. `ps` prints `comm` as a full executable path (and some Apple helper
  * names contain spaces, e.g. `Code Helper (Plugin)`), so the comm is reduced to
- * its basename to match the harness comm tokens the way Linux's `/proc/<pid>/comm`
+ * its basename to match the adapter comm tokens the way Linux's `/proc/<pid>/comm`
  * basename does. Returns null when the line has no leading numeric ppid.
  *
  * Pure (no I/O) so the parsing — the error-prone part — is unit-testable

package/dist/core/hooks/resolve/coord-root.d.ts

@@ -4,11 +4,11 @@
  *
  * Resolution precedence:
  *   1. HARNERY_COORD_ROOT_OVERRIDE — explicit pin (tests, git hooks).
- *   2. The harness's project dir (CLAUDE_PROJECT_DIR) — hook processes
+ *   2. The adapter's project dir (CLAUDE_PROJECT_DIR) — hook processes
  *      inherit the session's *shell* cwd, which follows `cd` into
  *      subdirectories/submodules that may carry a `.harnery/` of their own
- *      (or none at all, e.g. a scratch dir under /tmp). The session's
- *      coordination home is the project the harness opened, not wherever the
+ *      (or none at all, e.g. a journal dir under /tmp). The session's
+ *      coordination home is the project the adapter opened, not wherever the
  *      shell happens to sit, so a project dir that resolves to a coord root
  *      wins over the cwd walk.
  *   3. Walk up from `start` (default cwd).

package/dist/core/hooks/resolve/coord-root.js

@@ -7,11 +7,11 @@ import { coordEnv } from "../../../lib/env.js";
  *
  * Resolution precedence:
  *   1. HARNERY_COORD_ROOT_OVERRIDE — explicit pin (tests, git hooks).
- *   2. The harness's project dir (CLAUDE_PROJECT_DIR) — hook processes
+ *   2. The adapter's project dir (CLAUDE_PROJECT_DIR) — hook processes
  *      inherit the session's *shell* cwd, which follows `cd` into
  *      subdirectories/submodules that may carry a `.harnery/` of their own
- *      (or none at all, e.g. a scratch dir under /tmp). The session's
- *      coordination home is the project the harness opened, not wherever the
+ *      (or none at all, e.g. a journal dir under /tmp). The session's
+ *      coordination home is the project the adapter opened, not wherever the
  *      shell happens to sit, so a project dir that resolves to a coord root
  *      wins over the cwd walk.
  *   3. Walk up from `start` (default cwd).
@@ -27,7 +27,7 @@ export function findCoordRoot(start = process.cwd()) {
     if (override)
         return override;
     // Claude Code exports CLAUDE_PROJECT_DIR to every hook process; other
-    // harnesses don't set it, so this is inert outside claude-code hooks.
+    // adapters don't set it, so this is inert outside claude-code hooks.
     const projectDir = process.env.CLAUDE_PROJECT_DIR;
     if (projectDir) {
         const fromProject = walkUp(projectDir);