harnery 0.34.1 → 0.35.0

package/dist/commander.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commander.d.ts","sourceRoot":"","sources":["../src/commander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CpC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAEhC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,2BAA2B,EAAE,gBAAgB,CAAC;IACxE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,MAAM,GAAG,SAAS,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACjE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,KAAK,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IACrF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACpE,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,WAAW,EAAE,WAkCzB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAyD3E"}
+{"version":3,"file":"commander.d.ts","sourceRoot":"","sources":["../src/commander.ts"],"names":[],"mappings":"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"}

package/dist/commander.js

@@ -52,6 +52,7 @@ import { registerPolicyCommand } from "./commands/policy.js";
 import { registerPresenceCommand } from "./commands/presence.js";
 import { registerReadCommand } from "./commands/read.js";
 import { registerRelayCommand } from "./commands/relay.js";
+import { registerSemanticCommand } from "./commands/semantic.js";
 import { registerSyncCommand } from "./commands/sync.js";
 import { registerSectionCommand, registerTocCommand } from "./commands/toc.js";
 import { registerTokensCommand } from "./commands/tokens.js";
@@ -127,6 +128,7 @@ export function createHarneryProgram(opts = {}) {
     registerCheckpointCommand(program, emit, opts.context);
     registerJournalCommand(program, emit);
     registerLedgerV3Command(program, emit, opts.context);
+    registerSemanticCommand(program, emit, opts.context);
     registerEventsCommand(program, emit, opts.context);
     registerArtifactsCommand(program, emit, opts.context);
     registerDecisionCommand(program, emit);

package/dist/commands/agents.d.ts

@@ -14,8 +14,8 @@
  */
 import type { Command } from "commander";
 import type { EmitContext, HarneryProgramContext } from "../commander.js";
+import { nativeSessionIdentity } from "../core/agents/index.js";
 import { type SessionFinalizationRequestV3 } from "../core/agents/session-finalizer-v3.js";
-import { type Heartbeat } from "../core/agents/state/heartbeat-writer.js";
 import type { EventTypeV3 } from "../core/events/v3/contract.js";
 /**
  * Spawn options for agent-coord child processes: pin the coord root the
@@ -32,8 +32,7 @@ export declare function coordHelperOpts(root: string): {
     cwd: string;
     env: NodeJS.ProcessEnv;
 };
-/** Producer joins use the private native session ID; `session_id` is the canonical V3 fingerprint. */
-export declare function nativeSessionIdentity(row: Pick<Heartbeat, "native_session_id" | "session_id"> | null | undefined, fallback: string): string;
+export { nativeSessionIdentity };
 export declare function registerAgentsCommand(program: Command, emitParam: EmitContext, programContext?: HarneryProgramContext): void;
 export declare function registerCouncilCommands(parent: Command): void;
 type StatusPeerHeartbeat = {
@@ -126,6 +125,19 @@ export type EventLedgerHealthV3 = {
  * that fails to read lands in `collection_errors` instead of aborting the rest.
  */
 export declare function collectEventLedgerHealthV3(root: string, nowMs?: number): EventLedgerHealthV3;
+/**
+ * Tally stop-hook remediation-cap exhaustions in the window from
+ * `.harnery/debug/agent-hook.ndjson` (rows with
+ * `skipped: "stop-remediation-cap-exhausted"`). Each one is a session whose
+ * end-of-turn evidence never landed, so the Stop hook gave up bouncing it and
+ * let the turn end unenforced — a compliance gap an operator should see
+ * without grepping the debug ledger.
+ */
+export declare function readStopRemediationExhaustions(root: string, cutoffMs: number): {
+    total: number;
+    latestAt: string | null;
+    sessions: string[];
+};
 /** Tally agent-hook failures (.harnery/debug/agent-hook.errors.ndjson) in the
  * window by exact error and phase, while separating current-hour failures from
  * historical rows. Each line is {ts, error, phase, ...}. */
@@ -173,5 +185,4 @@ export interface ActiveAgentHealthSummary {
  * V3 generations, not disposable heartbeat caches, are the active-agent authority.
  */
 export declare function collectActiveAgentHealth(root: string, nowMs?: number): ActiveAgentHealthSummary;
-export {};
 //# sourceMappingURL=agents.d.ts.map

package/dist/commands/agents.d.ts.map

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

package/dist/commands/agents.js

@@ -13,15 +13,15 @@
  *   harn agents health --since 7d --json
  */
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { coordBinPath } from "../core/agents/coord-bin.js";
 import { checkGitFinalization, formatGitFinalizationFailure, readSessionWriteClaims, } from "../core/agents/finalization.js";
-import { emitEventV3, monorepoRoot, normalizeAdapter, resolveOwner, resolveOwnerBySessionEnv, resolveOwnerWithSource, sessionIdentityFromEnv, } from "../core/agents/index.js";
+import { emitEventV3, monorepoRoot, nativeSessionIdentity, normalizeAdapter, resolveOwner, resolveOwnerBySessionEnv, resolveOwnerWithSource, sessionIdentityFromEnv, } from "../core/agents/index.js";
 import { reopenLiveCoordinationGenerationV3 } from "../core/agents/live-authority-v3.js";
 import { listSessionFinalizationRequestsV3, observeHostDisappearedV3, reconcileSessionFinalizationV3, requestSessionEndExplicitV3, } from "../core/agents/session-finalizer-v3.js";
-import { SESSION_NAME_DISPLAY_NOTE } from "../core/agents/session-name-display.js";
+import { SESSION_NAME_DISPLAY_NOTE, sessionNameDisplayPending, } from "../core/agents/session-name-display.js";
 import { buildLifecycleSuggestedName, buildSuggestedName, readHeartbeat as readHeartbeatCache, } from "../core/agents/state/heartbeat-writer.js";
 import { readLiveCoordinationRow, readLiveCoordinationRows, } from "../core/agents/state/live-coordination-view.js";
 import { foldSessionState, } from "../core/agents/state/session-state.js";
@@ -34,6 +34,7 @@ import { listHookProducerStateRecordsV3, readHookProducerStateV3, } from "../cor
 import { readLedgerV3 } from "../core/events/v3/reader.js";
 import { EVENT_V3_LEDGER_RELATIVE_ROOT } from "../core/events/v3/writer.js";
 import { evaluateRunQualityIfDue } from "../core/guard/index.js";
+import { readRuntimeContextUsage } from "../core/hooks/adapter/runtime-telemetry.js";
 import { readRemoteMachines } from "../core/presence/index.js";
 import { registerContextCommand } from "./context.js";
 function readCurrentCoordinationRow(instanceId) {
@@ -57,9 +58,8 @@ import { displayName as displayAgentName, ensureIdentity, listIdentities, lookup
 function freshnessCutoffSecs() {
     return coordFreshnessSeconds();
 }
-const SUBAGENT_NOTE = "Bash identity is process-level; if you're running inside a subagent, " +
-    "this resolves to the parent group's name, not the subagent's. A subagent-aware " +
-    "bridge (per-shell marker file at .harnery/shells/<pid>) is out of scope.";
+const SUBAGENT_NOTE = "Native adapter subagents resolve to their own child generation after the hook bridge " +
+    "observes delegation. An unbridged subprocess shell still resolves through its parent.";
 /**
  * Spawn options for agent-coord child processes: pin the coord root the
  * command already resolved (git-superproject-aware via `monorepoRoot()`), so
@@ -122,18 +122,7 @@ function activityOf(hb) {
 function taskStateOf(hb) {
     return hb.task_state ?? "active";
 }
-/** Producer joins use the private native session ID; `session_id` is the canonical V3 fingerprint. */
-export function nativeSessionIdentity(row, fallback) {
-    if (row?.native_session_id)
-        return row.native_session_id;
-    // A projection-only row carries the privacy-safe canonical session
-    // fingerprint, not the adapter's native session ID needed to join the hook
-    // producer. Until a disposable cache exists, the resolved owner is the only
-    // native identity available to command surfaces such as `agents status`.
-    if (row?.session_id && !/^sid_[a-f0-9]{64}$/.test(row.session_id))
-        return row.session_id;
-    return fallback;
-}
+export { nativeSessionIdentity };
 function lifecycleLabel(hb) {
     const state = taskStateOf(hb);
     return state === "blocked" && hb.task_state_reason ? `${state}: ${hb.task_state_reason}` : state;
@@ -176,9 +165,9 @@ export function registerAgentsCommand(program, emitParam, programContext) {
     cmd
         .command("suggest-name [description...]")
         .description('Reprint a session name ("Agent <you> - <description>") for the operator to set as their ' +
-        "adapter tab title. With no arg, derives it from your current task. The primary naming path " +
+        "adapter tab title. With no arg, prefers the exact pending name, then derives from your current task. The primary naming path " +
         "is set-task (it suggests a name on the first focus declaration); reach for this to reprint " +
-        "or re-suggest after a topic pivot. Read-only.")
+        "or to create an explicit pending-display retry with --json. Read-only.")
         .option("--json", "JSON output instead of the bare name")
         .option("--session-id <id>", "Lookup the V3 generation by session_id directly, bypassing the ppid walk.")
         .action((description, opts) => {
@@ -1378,24 +1367,17 @@ function runSetTask(task, opts) {
     // the first time. `first_of_session: true` means exactly "this call produced
     // the session name" — it is never true with a null name (an empty first
     // declaration or a `--session-id` relay both keep the window open instead).
-    const firstSuggestedName = !priorHb?.suggested_session_name && hb?.suggested_session_name
-        ? hb.suggested_session_name
-        : null;
-    // A readable but misclassified first display would otherwise leave the
-    // session permanently latched: set-task is allowed through the gate, but a
-    // normal repeat used to return no name and therefore could not establish a
-    // fresh ordered transcript boundary. Re-emit the unchanged pending name as
-    // an explicit retry. This does not rename the session or claim that the
-    // display was seen; it only gives the next exact block new mint evidence.
-    const retriedSuggestedName = !firstSuggestedName &&
-        priorHb?.suggested_session_name &&
-        priorHb.session_name_seen_for !== priorHb.suggested_session_name &&
-        hb?.suggested_session_name === priorHb.suggested_session_name
-        ? hb.suggested_session_name
-        : null;
-    const suggestedName = firstSuggestedName ?? retriedSuggestedName;
+    // A native generation restart may rebuild the current cache during the
+    // mutation and carry an already-seen suggestion from the prior generation.
+    // That title is continuity evidence, not a new display request.
+    const pendingName = sessionNameDisplayPending(hb);
+    const firstSuggestedName = !priorHb?.suggested_session_name && pendingName ? pendingName : null;
+    // Routine focus declarations stay title-silent. A pending display no longer
+    // turns every repeated set-task into a fresh name instruction; explicit
+    // recovery belongs to `agents suggest-name --json`.
+    const suggestedName = firstSuggestedName;
     const firstOfSession = firstSuggestedName !== null;
-    const sessionNameRetry = retriedSuggestedName !== null;
+    const sessionNameRetry = false;
     emit.data({
         instance_id: myOwner,
         name: hb?.name ?? null,
@@ -1610,12 +1592,15 @@ function runSuggestName(descriptionParts, opts) {
     }
     const hb = readCurrentCoordinationRow(myOwner);
     const agentName = hb?.name || "unknown";
-    // Description resolution: an explicit arg wins; with no arg, fall back to the
-    // agent's current declared task, so a bare `suggest-name` reprints the running
-    // session's name (handy after a topic pivot). Read-only — mutates no state;
-    // the primary naming path is set-task's first-of-session suggestion.
+    // A bare suggest-name must prefer the exact pending suggestion over rebuilding
+    // from the current task. The task may have changed since the title was minted;
+    // reconstructing it would produce a block the display latch can never accept.
+    // An explicit description keeps the read-only re-suggest behavior.
+    const pendingName = sessionNameDisplayPending(hb);
     const parts = descriptionParts.length > 0 ? descriptionParts : hb?.task ? [hb.task] : [];
-    const built = buildSuggestedName(agentName, parts);
+    const built = descriptionParts.length === 0 && pendingName
+        ? { suggestedName: pendingName, description: hb?.task ?? pendingName }
+        : buildSuggestedName(agentName, parts);
     if (!built) {
         emit.error({
             code: "no_description",
@@ -1630,6 +1615,7 @@ function runSuggestName(descriptionParts, opts) {
         emit.data({
             name: displayName,
             suggested_session_name: suggestedName,
+            session_name_retry: pendingName === suggestedName,
             agent_name: agentName,
             description,
         });
@@ -1978,10 +1964,10 @@ function readContextUsage(sessionId, platform) {
     // store `contextUsagePercent` per composer in workspaceStorage's state.vscdb;
     // readCursorContextUsage reads that via bun:sqlite (percent-only).
     if (platform === "codex")
-        return readCodexContextUsage(sessionId);
+        return readRuntimeContextUsage("codex", sessionId);
     if (platform === "cursor")
         return readCursorContextUsage(sessionId);
-    return readClaudeContextUsage(sessionId);
+    return readRuntimeContextUsage("claude-code", sessionId);
 }
 function readCursorContextUsage(sessionId) {
     // Cursor stores per-chat (composer) context usage as a percent in each
@@ -2054,137 +2040,6 @@ function readCursorContextUsage(sessionId) {
     }
     return null;
 }
-function readClaudeContextUsage(sessionId) {
-    const root = monorepoRoot();
-    if (!root)
-        return null;
-    // Claude Code's project dir scheme: prepend "-", replace "/" → "-".
-    const encoded = `-${root.replace(/^\//, "").replace(/\//g, "-")}`;
-    const transcriptPath = resolve(homedir(), ".claude", "projects", encoded, `${sessionId}.jsonl`);
-    if (!existsSync(transcriptPath))
-        return null;
-    let raw;
-    try {
-        raw = readFileSync(transcriptPath, "utf8");
-    }
-    catch {
-        return null;
-    }
-    const lines = raw.split("\n");
-    for (let i = lines.length - 1; i >= 0; i--) {
-        const line = lines[i].trim();
-        if (!line)
-            continue;
-        try {
-            const entry = JSON.parse(line);
-            const usage = entry?.message?.usage;
-            if (entry?.type === "assistant" && usage) {
-                const used = (usage.input_tokens ?? 0) +
-                    (usage.cache_creation_input_tokens ?? 0) +
-                    (usage.cache_read_input_tokens ?? 0);
-                // Window: hardcode 1M for Opus 4.7 1M (current default). Refine to
-                // model-aware lookup when other models become routine.
-                return { used, window: 1000000 };
-            }
-        }
-        catch {
-            // skip malformed line
-        }
-    }
-    return null;
-}
-function readCodexContextUsage(sessionId) {
-    // Codex transcripts: ~/.codex/sessions/YYYY/MM/DD/rollout-<TS>-<sessionId>.jsonl
-    // On WSL the active install often lives on the Windows side under
-    // /mnt/c/Users/<user>/.codex/sessions/; both are searched.
-    const path = findCodexTranscript(sessionId);
-    if (!path)
-        return null;
-    let raw;
-    try {
-        raw = readFileSync(path, "utf8");
-    }
-    catch {
-        return null;
-    }
-    const lines = raw.split("\n");
-    // Walk backwards: most recent token_count event wins.
-    for (let i = lines.length - 1; i >= 0; i--) {
-        const line = lines[i].trim();
-        if (!line)
-            continue;
-        try {
-            const entry = JSON.parse(line);
-            if (entry?.type === "event_msg" && entry?.payload?.type === "token_count") {
-                const info = entry.payload.info;
-                const used = info?.last_token_usage?.input_tokens;
-                const window = info?.model_context_window;
-                if (typeof used === "number" && typeof window === "number" && window > 0) {
-                    return { used, window };
-                }
-            }
-        }
-        catch {
-            // skip malformed line
-        }
-    }
-    return null;
-}
-function findCodexTranscript(sessionId) {
-    // Candidate roots in priority order.
-    const homeRoot = resolve(homedir(), ".codex", "sessions");
-    const wslRoots = [];
-    try {
-        if (existsSync("/mnt/c/Users")) {
-            for (const entry of readdirSync("/mnt/c/Users")) {
-                wslRoots.push(`/mnt/c/Users/${entry}/.codex/sessions`);
-            }
-        }
-    }
-    catch {
-        // ignore
-    }
-    const roots = [homeRoot, ...wslRoots];
-    const suffix = `-${sessionId}.jsonl`;
-    for (const root of roots) {
-        if (!existsSync(root))
-            continue;
-        try {
-            // Recursive scan: sessions are partitioned by YYYY/MM/DD/, so depth
-            // is bounded at 3 + one file per session. Cheap enough at status time.
-            const stack = [root];
-            while (stack.length) {
-                const dir = stack.pop();
-                let entries;
-                try {
-                    entries = readdirSync(dir);
-                }
-                catch {
-                    continue;
-                }
-                for (const name of entries) {
-                    const full = `${dir}/${name}`;
-                    try {
-                        const stat = statSync(full);
-                        if (stat.isDirectory()) {
-                            stack.push(full);
-                        }
-                        else if (name.endsWith(suffix)) {
-                            return full;
-                        }
-                    }
-                    catch {
-                        // ignore
-                    }
-                }
-            }
-        }
-        catch {
-            // ignore root scan failures
-        }
-    }
-    return null;
-}
 function formatLocalTime(d) {
     // "Sat, May 9, 2026, 3:48 AM CDT", rendered in the Chicago timezone.
     return new Intl.DateTimeFormat("en-US", {
@@ -2643,6 +2498,53 @@ export function collectEventLedgerHealthV3(root, nowMs = Date.now()) {
         collection_errors: collectionErrors,
     };
 }
+/**
+ * Tally stop-hook remediation-cap exhaustions in the window from
+ * `.harnery/debug/agent-hook.ndjson` (rows with
+ * `skipped: "stop-remediation-cap-exhausted"`). Each one is a session whose
+ * end-of-turn evidence never landed, so the Stop hook gave up bouncing it and
+ * let the turn end unenforced — a compliance gap an operator should see
+ * without grepping the debug ledger.
+ */
+export function readStopRemediationExhaustions(root, cutoffMs) {
+    const p = resolve(root, ".harnery", "debug", "agent-hook.ndjson");
+    if (!existsSync(p))
+        return { total: 0, latestAt: null, sessions: [] };
+    let raw;
+    try {
+        raw = readFileSync(p, "utf8");
+    }
+    catch {
+        return { total: 0, latestAt: null, sessions: [] };
+    }
+    let total = 0;
+    let latestMs = Number.NEGATIVE_INFINITY;
+    const sessions = new Set();
+    for (const line of raw.split("\n")) {
+        if (!line.includes("stop-remediation-cap-exhausted"))
+            continue;
+        try {
+            const e = JSON.parse(line);
+            if (e.skipped !== "stop-remediation-cap-exhausted")
+                continue;
+            const tsMs = e.ts ? Date.parse(e.ts) : Number.NaN;
+            if (!Number.isFinite(tsMs) || tsMs < cutoffMs)
+                continue;
+            total++;
+            latestMs = Math.max(latestMs, tsMs);
+            if (e.session_id && sessions.size < 5)
+                sessions.add(e.session_id);
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return {
+        total,
+        latestAt: Number.isFinite(latestMs) ? new Date(latestMs).toISOString() : null,
+        sessions: [...sessions],
+    };
+}
 /** Tally agent-hook failures (.harnery/debug/agent-hook.errors.ndjson) in the
  * window by exact error and phase, while separating current-hour failures from
  * historical rows. Each line is {ts, error, phase, ...}. */
@@ -3144,6 +3046,7 @@ function runHealth(opts) {
         }
     }
     const hookErrors = readHookErrors(root, cutoffMs, nowMs);
+    const stopRemediation = readStopRemediationExhaustions(root, cutoffMs);
     const stream = readStreamStats(root);
     const eventLedger = collectEventLedgerHealthV3(root);
     // Canonical health.* events carry the full instance_id, already resolved to
@@ -3248,6 +3151,12 @@ function runHealth(opts) {
     if (zombieCount > 0) {
         anomalies.push(`${zombieCount} zombie heartbeat(s) in active/ (${zombieSamples.join(", ")}); broken files the sweep isn't reaping`);
     }
+    if (stopRemediation.total > 0) {
+        const who = stopRemediation.sessions.length > 0
+            ? ` (sessions: ${stopRemediation.sessions.map((s) => s.slice(0, 8)).join(", ")})`
+            : "";
+        anomalies.push(`stop-hook remediation cap exhausted ${stopRemediation.total}x in ${opts.since}${who}; these sessions ended turns without the end-of-turn ritual — check why their evidence never lands`);
+    }
     if (eventLedger.state === "live") {
         // Open spans whose generation has no open turn: the turn ended without its
         // tool spans closing, so an explicit end can only queue, never finalize.
@@ -3306,6 +3215,11 @@ function runHealth(opts) {
         stream,
         zombies: { count: zombieCount, samples: zombieSamples },
         event_ledger: eventLedger,
+        stop_remediation: {
+            total: stopRemediation.total,
+            latest_at: stopRemediation.latestAt,
+            sessions: stopRemediation.sessions,
+        },
         anomalies,
     };
     if (opts.json) {

package/dist/commands/browse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA+N1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+cN"}
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAgO1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+cN"}

package/dist/commands/browse.js

@@ -920,9 +920,24 @@ async function runTrioMode(browser, navResult, opts, evalResult, visibility, wid
     else if (opts.captureEvaluate) {
         throw new Error("--capture-evaluate requires a screenshot; remove --no-screenshot.");
     }
+    // A trio `.html` is opened in a browser later — from the files origin, from
+    // another machine, from disk — so it has to carry its own CSS and media. A
+    // selector capture is a DOM fragment, not a document, and stays raw.
     const htmlPath = `${prefix}.html`;
-    const html = await browser.htmlContent(opts.selector);
-    writeFileSync(htmlPath, html);
+    let snapshot;
+    if (opts.selector) {
+        writeFileSync(htmlPath, await browser.htmlContent(opts.selector));
+    }
+    else {
+        try {
+            snapshot = await browser.standaloneHtml();
+            writeFileSync(htmlPath, snapshot.html);
+        }
+        catch {
+            // Inlining is best-effort; a raw serialization beats no snapshot at all.
+            writeFileSync(htmlPath, await browser.htmlContent());
+        }
+    }
     written.push(htmlPath);
     const diag = browser.diagnostics();
     const jsonPath = `${prefix}.json`;
@@ -939,6 +954,15 @@ async function runTrioMode(browser, navResult, opts, evalResult, visibility, wid
     };
     if (pngBytes !== undefined)
         envelope.screenshotBytes = pngBytes;
+    if (snapshot) {
+        envelope.htmlSnapshot = {
+            stylesheetsInlined: snapshot.stylesheetsInlined,
+            stylesheetsLinked: snapshot.stylesheetsLinked,
+            resourcesInlined: snapshot.resourcesInlined,
+            resourcesLinked: snapshot.resourcesLinked,
+            inlinedBytes: snapshot.inlinedBytes,
+        };
+    }
     if (opts.evaluate)
         envelope.eval = evalResult;
     if (opts.captureEvaluate) {

package/dist/commands/decision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAwCnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAgStF"}
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA8CnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAgStF"}

package/dist/commands/decision.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from "node:fs";
-import { emitEventV3, monorepoRoot, normalizeAdapter, resolveOwner } from "../core/agents/index.js";
+import { emitEventV3, monorepoRoot, nativeSessionIdentity, normalizeAdapter, resolveOwner, } from "../core/agents/index.js";
 import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
 import { resolveBinName } from "../core/config.js";
 import { archiveDecision, claimDecision, DECISION_STAKES, fileDecision, isStakes, isStatus, isTier, isVerdict, listDecisions, reopenDecision, resolveDecision, reviewDecision, searchDecisions, showDecision, supersedeDecision, triageDecision, wontfixDecision, } from "../lib/decision/index.js";
@@ -349,7 +349,7 @@ function emitDecisionEvent(newState, manifest, priorState) {
     const hb = root ? readLiveCoordinationRow(root, owner) : null;
     emitEventV3({
         owner,
-        session: hb?.session_id ?? owner,
+        session: nativeSessionIdentity(hb, owner),
         adapter: normalizeAdapter(hb?.platform),
         observation: {
             event_type: "decision.state_changed",

package/dist/commands/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkC1E,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+CN"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmC1E,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+CN"}

package/dist/commands/events.js

@@ -72,6 +72,7 @@ function summarizeByGeneration(turns) {
         tool_ms: sumMetrics(group.map(({ tool_ms }) => tool_ms)),
         command_ms: sumMetrics(group.map(({ command_exclusive_ms }) => command_exclusive_ms)),
         wait_ms: sumMetrics(group.map(({ wait_ms }) => wait_ms)),
+        agent_action_ms: sumMetrics(group.map(({ response_latency }) => response_latency.agent_action_ms)),
         inference_ms: sumMetrics(group.map(({ inference_ms }) => inference_ms)),
         harness_ms: sumMetrics(group.map(({ harness_ms }) => harness_ms)),
         residual_ms: sumMetrics(group.map(({ residual_ms }) => residual_ms)),
@@ -129,6 +130,8 @@ function renderTurns(turns) {
         "TOOL",
         "COMMAND",
         "WAIT",
+        "ACTION",
+        "POST-TOOL",
         "INFERENCE",
         "HARNESS",
         "RESIDUAL",
@@ -140,6 +143,8 @@ function renderTurns(turns) {
         formatMetric(turn.tool_ms),
         formatMetric(turn.command_exclusive_ms),
         formatMetric(turn.wait_ms),
+        formatMetric(turn.response_latency.agent_action_ms),
+        formatMetric(turn.response_latency.post_tool_response_ms),
         formatMetric(turn.inference_ms),
         formatMetric(turn.harness_ms),
         formatMetric(turn.residual_ms),
@@ -147,13 +152,25 @@ function renderTurns(turns) {
     ]));
 }
 function renderGenerations(rows) {
-    return renderTable(["GENERATION", "TURNS", "WALL", "TOOL", "COMMAND", "WAIT", "INFERENCE", "HARNESS", "RESIDUAL"], rows.map((row) => [
+    return renderTable([
+        "GENERATION",
+        "TURNS",
+        "WALL",
+        "TOOL",
+        "COMMAND",
+        "WAIT",
+        "ACTION",
+        "INFERENCE",
+        "HARNESS",
+        "RESIDUAL",
+    ], rows.map((row) => [
         row.generation_id,
         String(row.turns),
         formatMetric(row.wall_ms),
         formatMetric(row.tool_ms),
         formatMetric(row.command_ms),
         formatMetric(row.wait_ms),
+        formatMetric(row.agent_action_ms),
         formatMetric(row.inference_ms),
         formatMetric(row.harness_ms),
         formatMetric(row.residual_ms),

package/dist/commands/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAsBnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA8KjF"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA2BnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA8KjF"}

package/dist/commands/presence.js

@@ -1,5 +1,5 @@
 import { monorepoRoot } from "../core/agents/coord-client.js";
-import { emitEventV3, normalizeAdapter, resolveOwner } from "../core/agents/index.js";
+import { emitEventV3, nativeSessionIdentity, normalizeAdapter, resolveOwner, } from "../core/agents/index.js";
 import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
 import { fetchPresence, publishPresence, readRemoteMachines, relayDaemonStatus, runRelayDaemon, } from "../core/presence/index.js";
 import { ageSeconds, applyDetection, clearPresence, formatAge, presenceFilePath, readPresence, writePresence, } from "../lib/presence.js";
@@ -203,7 +203,7 @@ function emitPresenceChange(from, to, source) {
     const hb = root ? readLiveCoordinationRow(root, owner) : null;
     emitEventV3({
         owner,
-        session: hb?.session_id ?? owner,
+        session: nativeSessionIdentity(hb, owner),
         adapter: normalizeAdapter(hb?.platform),
         observation: {
             event_type: "coord.presence_changed",

package/dist/commands/semantic.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext, HarneryProgramContext } from "../commander.js";
+export declare function registerSemanticCommand(program: Command, emit: EmitContext, context?: HarneryProgramContext): void;
+//# sourceMappingURL=semantic.d.ts.map

package/dist/commands/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/commands/semantic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAc1E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAiIN"}