harnery 0.31.5 → 0.32.0

package/dist/commander.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commander.d.ts","sourceRoot":"","sources":["../src/commander.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commander.d.ts","sourceRoot":"","sources":["../src/commander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC,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,CAsD3E"}

package/dist/commander.js

@@ -23,6 +23,7 @@ import { registerArtifactsCommand } from "./commands/artifacts.js";
 import { registerBackupCommand } from "./commands/backup.js";
 import { registerBrowseCommand } from "./commands/browse.js";
 import { registerBrowseAiCommand } from "./commands/browse-ai.js";
+import { registerBrowseSessionCommand } from "./commands/browse-session.js";
 import { registerCallersCommand } from "./commands/callers.js";
 import { registerCheckpointCommand } from "./commands/checkpoint.js";
 import { registerClaudeDesktopCommand } from "./commands/claude-desktop.js";
@@ -117,6 +118,7 @@ export function createHarneryProgram(opts = {}) {
     registerFetchCommand(program, emit, opts.context);
     registerReadCommand(program, emit);
     registerBrowseCommand(program, emit, opts.context);
+    registerBrowseSessionCommand(program, emit);
     registerBrowseAiCommand(program, emit);
     registerCompletionCommand(program, emit, opts.context);
     registerCheckpointCommand(program, emit, opts.context);

package/dist/commands/agents.d.ts

@@ -31,13 +31,4 @@ export declare function coordHelperOpts(root: string): {
 };
 export declare function registerAgentsCommand(program: Command, emitParam: EmitContext, programContext?: HarneryProgramContext): void;
 export declare function registerCouncilCommands(parent: Command): void;
-/**
- * Build the copy-pasteable session name from the coord identity + the agent's
- * description parts. Pure (no coord-state reads) so it's unit-testable; collapses
- * internal whitespace and trims. Returns null when the description is empty.
- */
-export declare function buildSuggestedName(agentName: string, descriptionParts: string[]): {
-    suggestedName: string;
-    description: string;
-} | null;
 //# 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":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA2E1E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAErF;AAsED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,cAAc,CAAC,EAAE,qBAAqB,GACrC,IAAI,CA+PN;AAyJD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAyO7D;AA2sBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkF1E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAErF;AAsED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,cAAc,CAAC,EAAE,qBAAqB,GACrC,IAAI,CAmQN;AAsKD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAyO7D"}

package/dist/commands/agents.js

@@ -18,7 +18,9 @@ import { homedir, tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { coordBinPath } from "../core/agents/coord-bin.js";
 import { readStreamTailBounded } from "../core/agents/events/consume.js";
+import { checkGitFinalization, formatGitFinalizationFailure, readSessionWriteClaims, } from "../core/agents/finalization.js";
 import { emitCanonical, monorepoRoot, normalizeAdapter, readHeartbeat, resolveOwner, resolveOwnerBySessionEnv, resolveOwnerWithSource, } from "../core/agents/index.js";
+import { buildSuggestedName } from "../core/agents/state/heartbeat-writer.js";
 import { coordFreshnessSeconds, resolveBinName } from "../core/config.js";
 import { readRemoteMachines } from "../core/presence/index.js";
 import { registerContextCommand } from "./context.js";
@@ -126,6 +128,7 @@ export function registerAgentsCommand(program, emitParam, programContext) {
         .command("status")
         .description("End-of-turn status box (name + session age + files held + peer count)")
         .option("--json", "JSON output instead of the box")
+        .option("--end-turn", "Treat this as the turn's closing status: issue the box only when this session's held paths are committed and their repositories are pushed")
         .option("--session-id <id>", "Lookup heartbeat by session_id directly, bypassing the ppid walk. " +
         "Use this when calling from a hook (the hook's process tree may not lead back to Claude Code's session pid). " +
         "The Stop hook payload includes session_id; pass it through.")
@@ -203,7 +206,7 @@ export function registerAgentsCommand(program, emitParam, programContext) {
         .command("wait <name>")
         .description(`Block until a peer agent releases files (their \`files_touched\` becomes empty, OR they exit). Pair with \`${resolveBinName()} agents ping\` to coordinate hand-offs.`)
         .option("--file <path>", "Wait only for these specific paths (repeatable)", collectPath, [])
-        .option("--timeout <dur>", "Give up after this duration; suffix s/m/h/d (e.g. 30s, 5m, 1h). Bare integer = minutes. Default 60m.", "60m")
+        .option("--timeout <dur>", "Give up after this duration; suffix s/m/h/d is required (e.g. 30s, 5m, 1h). Default 60m.", "60m")
         .option("--poll-secs <n>", "Poll interval in seconds (default 5)", "5")
         .option("--quiet", "Suppress progress lines")
         .option("--json", "JSON output (terminal status, only printed at exit)")
@@ -223,8 +226,8 @@ export function registerAgentsCommand(program, emitParam, programContext) {
     });
     cmd
         .command("health")
-        .description("One-screen coord-layer health rollup: heal events, schema validity, " +
-        "commit-guard activity, council activity, anomalies. Designed for " +
+        .description("One-screen coord-layer health rollup: heal events, council activity, " +
+        "zombie detection, and anomalies. Designed for " +
         "daily glance + dashboard ingestion. Reads .harnery/.")
         .option("--since <window>", "Window (Nh | Nd). Default: 24h.", "24h")
         .option("--json", "JSON envelope output")
@@ -236,7 +239,7 @@ export function registerAgentsCommand(program, emitParam, programContext) {
         .description("Adapter wiring probe: ppid chain, comm names, pid-map anchor, sample payload paths. " +
         "With --replay-samples, also replays every checked-in sample payload against the live " +
         "adapter in an isolated sandbox to catch adapter / payload-shape drift. " +
-        "Complements heal-events (drift telemetry). Id: claude_code | cursor.")
+        "Complements heal-events (drift telemetry). Id: claude-code | cursor.")
         .option("--json", "JSON envelope output")
         .option("--replay-samples", "Replay docs/api/<adapter>-hooks/samples/*.json against the live adapter in an isolated sandbox. " +
         "Exits non-zero if any sample crashes the adapter.")
@@ -359,6 +362,9 @@ function registerIdentityCommands(parent) {
         "the event ledger, and the heartbeat.")
         .option("--json", "JSON envelope output")
         .option("--session-id <id>", "Bind the heartbeat with this session_id directly, bypassing the ppid walk.")
+        .option("--force-ancestor", "Allow assuming a persona this session's fork lineage descends from " +
+        "(default: refused, because a fork's inherited transcript asserting that " +
+        "name is not a role handoff).")
         .action((target, opts) => {
         runIdentityAssume(target, opts);
     });
@@ -385,7 +391,9 @@ function runIdentityAssume(target, opts) {
         process.exit(1);
     }
     try {
-        const result = assumeIdentity(root, owner, target);
+        const result = assumeIdentity(root, owner, target, {
+            forceAncestor: opts.forceAncestor ?? false,
+        });
         emit.data({
             ...result,
             display_name: displayAgentName(result.name),
@@ -592,7 +600,7 @@ function runWhoami(opts) {
         task: hb.task ?? null,
         turn_summary: hb.turn_summary ?? null,
         turn_summary_updated_at: hb.turn_summary_updated_at ?? null,
-        platform: hb.platform ?? "claude_code",
+        platform: hb.platform ?? "claude-code",
     };
     emit.data({ ...row, resolution_source: resolved.source, note: SUBAGENT_NOTE });
     if (process.stdout.isTTY && !opts.json) {
@@ -681,7 +689,7 @@ function runList(opts) {
                 task: h.task ?? null,
                 turn_summary: h.turn_summary ?? null,
                 turn_summary_updated_at: h.turn_summary_updated_at ?? null,
-                platform: h.platform ?? "claude_code",
+                platform: h.platform ?? "claude-code",
             });
             continue;
         }
@@ -706,7 +714,7 @@ function runList(opts) {
             task: h.task ?? null,
             turn_summary: h.turn_summary ?? null,
             turn_summary_updated_at: h.turn_summary_updated_at ?? null,
-            platform: h.platform ?? "claude_code",
+            platform: h.platform ?? "claude-code",
         });
     }
     // Guard missing started_at: a heartbeat seeded from a stray event can lack it
@@ -732,7 +740,7 @@ function runList(opts) {
                 task: a.task ?? null,
                 turn_summary: a.turn_summary ?? null,
                 turn_summary_updated_at: null,
-                platform: a.platform ?? "claude_code",
+                platform: a.platform ?? "claude-code",
                 machine: rm.machine,
             });
         }
@@ -1168,15 +1176,13 @@ function runSetTask(task, opts) {
         });
         process.exit(1);
     }
-    // Snapshot BEFORE the mutation: a heartbeat that has never carried a task
-    // has no `task_updated_at` stamp (setTask always stamps it, even on a clear),
-    // so its absence is the "focus never declared this session" signal — i.e. the
-    // first set-task of the session. That's the natural moment to also hand the
-    // operator a session name built from the same declaration (one source of
-    // truth: the focus you declare names the session). Distinct from task===""
-    // (a deliberate clear), which carries a stamp and does NOT re-trigger.
+    // Snapshot BEFORE the mutation: the writer stamps `suggested_session_name`
+    // on the session's first NON-EMPTY declaration (one source of truth: the
+    // focus you declare names the session). A bare clear never consumes the
+    // naming window, and subagent/workflow kinds are never named — see
+    // heartbeat-writer.setTask. This call is the naming call exactly when the
+    // stamp appears across the mutation.
     const priorHb = readHeartbeat(myOwner);
-    const firstOfSession = !priorHb?.task_updated_at;
     // Heartbeat mutation goes through agent-coord (atomic temp+rename).
     const helper = agentCoordOrExit(root);
     const result = spawnSync(helper, ["set-task", myOwner, task], {
@@ -1191,39 +1197,42 @@ function runSetTask(task, opts) {
         process.exit(1);
     }
     const hb = readHeartbeat(myOwner);
+    // The naming call: the mutation just stamped `suggested_session_name` for
+    // 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 suggestedName = !priorHb?.suggested_session_name && hb?.suggested_session_name
+        ? hb.suggested_session_name
+        : null;
+    const firstOfSession = suggestedName !== null;
     emitCanonical({
         type: "state.task_set",
         owner: myOwner,
         session: hb?.session_id ?? myOwner,
         adapter: normalizeAdapter(hb?.platform),
-        data: { task, cleared: !task || task.length === 0 },
+        data: {
+            task,
+            cleared: !task || task.length === 0,
+            first_of_session: firstOfSession,
+            suggested_session_name: suggestedName,
+        },
     });
-    // On the first focus declaration of a session, surface a suggested session
-    // name for the operator to set as their adapter tab title. Read the result
-    // (`suggested_session_name`) and reproduce it in a fenced code block so the
-    // UI's Copy button hands over the exact string. null on every later call.
-    const built = firstOfSession && !opts?.sessionId ? buildSuggestedName(hb?.name ?? "unknown", [task]) : null;
     emit.data({
         instance_id: myOwner,
         name: hb?.name ?? null,
         task: hb?.task ?? null,
         cleared: !task || task.length === 0,
         first_of_session: firstOfSession,
-        suggested_session_name: built?.suggestedName ?? null,
+        suggested_session_name: suggestedName,
+        // Right-time instruction: the UserPromptSubmit nudge fires before the name
+        // exists; this result is the moment the model holds the string.
+        ...(suggestedName
+            ? {
+                note: "Reproduce suggested_session_name verbatim, by itself, in a fenced code block at the top of your reply — the operator copies it as the session/tab title.",
+            }
+            : {}),
     });
 }
-/**
- * Build the copy-pasteable session name from the coord identity + the agent's
- * description parts. Pure (no coord-state reads) so it's unit-testable; collapses
- * internal whitespace and trims. Returns null when the description is empty.
- */
-export function buildSuggestedName(agentName, descriptionParts) {
-    const description = descriptionParts.join(" ").replace(/\s+/g, " ").trim();
-    if (!description)
-        return null;
-    const name = agentName?.trim() || "unknown";
-    return { suggestedName: `Agent ${name} - ${description}`, description };
-}
 function runSuggestName(descriptionParts, opts) {
     const root = monorepoRoot();
     if (!root) {
@@ -1308,20 +1317,21 @@ function runStatus(opts) {
         });
         process.exit(1);
     }
-    // Stamp .last_status_at = NOW. The verdict path reads state.status_checked
-    // canonical events (emitted below), but the legacy heartbeat field is still
-    // populated for back-compat with consumers reading v1 directly. The stamp
-    // goes through agent-coord (atomic write).
-    try {
-        const helper = agentCoordOrExit(root);
-        spawnSync(helper, ["stamp-status-call", myOwner], {
-            encoding: "utf8",
-            timeout: 2000,
-            ...coordHelperOpts(root),
+    let finalization = null;
+    if (opts.endTurn) {
+        const history = readSessionWriteClaims(root, hb.instance_id, hb.session_id ?? myOwner);
+        const touchedPaths = [...new Set([...(hb.files_touched ?? []), ...history.paths])];
+        finalization = checkGitFinalization(root, touchedPaths, {
+            claimHistoryComplete: history.complete,
         });
-    }
-    catch {
-        /* non-fatal */
+        if (!finalization.ok) {
+            emit.error({
+                code: "git_not_finalized",
+                message: formatGitFinalizationFailure(finalization, resolveBinName(root)),
+            });
+            process.exitCode = 1;
+            return;
+        }
     }
     emitCanonical({
         type: "state.status_checked",
@@ -1330,6 +1340,7 @@ function runStatus(opts) {
         adapter: normalizeAdapter(hb.platform),
         data: {
             format: opts.json ? "json" : "box",
+            git_finalization_checked: opts.endTurn === true,
             agent_count: 0, // computed below, not yet available here; Phase 5 verdict reads owner-scope only
             included_self: true,
         },
@@ -1432,6 +1443,7 @@ function runStatus(opts) {
         context_window: ctxUsage?.window ?? null,
         timestamp_iso: new Date().toISOString(),
         timestamp_local: timeStr,
+        ...(finalization ? { finalization } : {}),
     };
     if (opts.json) {
         emit.config({ format: "json" });
@@ -1794,16 +1806,15 @@ function readCanonicalEventsInWindow(root, cutoffMs) {
     }
     return out;
 }
-/** adapter ("claude-code") → legacy platform label ("claude_code") so the
- * existing formatPlatformLabel rendering keeps working unchanged. */
+/** Normalize adapter event data into the heartbeat platform value. */
 function adapterToPlatform(adapter) {
     if (adapter === "claude-code")
-        return "claude_code";
+        return "claude-code";
     if (adapter === "cursor")
         return "cursor";
     if (adapter === "codex")
         return "codex";
-    return "claude_code";
+    return "claude-code";
 }
 /** Project a canonical health.* event into the HealEvent shape the aggregators
  * already consume. Returns null for non-heal events. instance_id → display name
@@ -2292,18 +2303,7 @@ function runHealth(opts) {
     const councilsDir = resolve(root, ".harnery/councils");
     // Coordination telemetry reads from the canonical events.ndjson stream.
     // Heals come from health.*; council window-activity from council.*. The
-    // commit-guard + schema-invalid counters below have NO canonical equivalent
-    // yet. Their future home is the decision.* events (defined in schema.ts, not
-    // yet wired). Until then they report 0 (fields kept for output-shape
-    // compatibility).
     const heal = [];
-    const schemaInvalid = 0;
-    const schemaSamples = [];
-    const commitBlocked = 0;
-    const commitBypassed = 0;
-    const commitSuppressed = 0;
-    const editBlocked = 0;
-    const shellCandidates = 0;
     let councilAdvanced = 0;
     let councilClosed = 0;
     let councilArchived = 0;
@@ -2420,10 +2420,6 @@ function runHealth(opts) {
     }
     // Anomaly detection.
     const anomalies = [];
-    if (schemaInvalid > 0) {
-        const sampleList = schemaSamples.slice(0, 3).join(", ");
-        anomalies.push(`HEARTBEAT_SCHEMA_INVALID fired ${schemaInvalid}x; heartbeat shape failed validation${sampleList ? ` (samples: ${sampleList})` : ""}`);
-    }
     for (const { agent, count } of healTopAgents) {
         if (count >= 5) {
             anomalies.push(`${agent} self-healed ${count}x in ${opts.since}; possible idle-prune loop or PID instability`);
@@ -2477,14 +2473,6 @@ function runHealth(opts) {
             by_platform: healByPlatform,
             top_agents: healTopAgents,
         },
-        schema_invalid: { count: schemaInvalid, samples: schemaSamples },
-        commit_guards: {
-            blocked: commitBlocked,
-            bypassed: commitBypassed,
-            suppressed: commitSuppressed,
-            edit_blocked: editBlocked,
-            shell_candidates: shellCandidates,
-        },
         councils: {
             active: activeCouncils,
             archived_in_window: councilArchived,
@@ -2523,17 +2511,6 @@ function renderHealthBox(report) {
     }
     const topHealer = report.heal_events.top_agents[0];
     const topHealerStr = topHealer ? `${topHealer.agent} x${topHealer.count}` : "(none)";
-    const guardParts = [];
-    if (report.commit_guards.blocked > 0)
-        guardParts.push(`blocked ${report.commit_guards.blocked}`);
-    if (report.commit_guards.bypassed > 0)
-        guardParts.push(`bypassed ${report.commit_guards.bypassed}`);
-    if (report.commit_guards.suppressed > 0)
-        guardParts.push(`suppressed ${report.commit_guards.suppressed}`);
-    if (report.commit_guards.edit_blocked > 0)
-        guardParts.push(`edit-blocked ${report.commit_guards.edit_blocked}`);
-    if (report.commit_guards.shell_candidates > 0)
-        guardParts.push(`shell ${report.commit_guards.shell_candidates}`);
     const councilParts = [`${report.councils.active} active`];
     if (report.councils.advanced_in_window > 0)
         councilParts.push(`${report.councils.advanced_in_window} advanced`);
@@ -2566,8 +2543,6 @@ function renderHealthBox(report) {
                 ? "0"
                 : `${report.zombies.count} (${report.zombies.samples.join(", ")})`,
         ],
-        ["schema invalid", String(report.schema_invalid.count)],
-        ["commit guards", guardParts.length ? guardParts.join(", ") : "0"],
         ["councils", councilParts.join(", ")],
         ["anomalies", report.anomalies.length === 0 ? "(clean)" : `${report.anomalies.length} flagged`],
     ];
@@ -2585,10 +2560,10 @@ function runAdapterProbe(id, opts) {
     if (opts.json)
         emit.config({ format: "json" });
     const adapter = id.trim();
-    if (adapter !== "claude_code" && adapter !== "cursor") {
+    if (adapter !== "claude-code" && adapter !== "cursor") {
         emit.error({
             code: "bad_adapter",
-            message: "adapter id must be claude_code or cursor",
+            message: "adapter id must be claude-code or cursor",
         });
         process.exit(1);
     }
@@ -2784,7 +2759,7 @@ function replayAdapterSamples(adapter, root, relativeSampleDir, filter) {
         stopFailure: "stop-failure",
         StopFailure: "stop-failure",
     };
-    const adapterFlag = adapter === "claude_code" ? "claude-code" : adapter;
+    const adapterFlag = adapter;
     const sandbox = mkdtempSync(join(tmpdir(), "harn-adapter-probe-"));
     const results = [];
     try {
@@ -2909,15 +2884,15 @@ function extractEventAndPayload(parsed, filename) {
 function collectPath(value, prev) {
     return [...prev, value];
 }
-/** Parse "30", "30s", "5m", "1h", "2d" → ms. Bare integer defaults to minutes (back-compat). */
+/** Parse "30s", "5m", "1h", "2d" into milliseconds. */
 function parseDurationToMs(input) {
-    const match = input.trim().match(/^(\d+)([smhd]?)$/i);
+    const match = input.trim().match(/^(\d+)([smhd])$/i);
     if (!match)
         return null;
     const n = Number.parseInt(match[1], 10);
     if (!Number.isFinite(n) || n <= 0)
         return null;
-    const unit = (match[2] || "m").toLowerCase();
+    const unit = match[2].toLowerCase();
     const mult = { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 };
     return n * mult[unit];
 }

package/dist/commands/browse-session.d.ts

@@ -0,0 +1,21 @@
+import type { Readable } from "node:stream";
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+import type { BrowserSessionLocator } from "../lib/browser/client.js";
+interface ControlFileOpts {
+    controlFile: string;
+}
+interface LocatorOpts extends ControlFileOpts {
+    selector?: string;
+    role?: string;
+    name?: string;
+    label?: string;
+    text?: string;
+    partial?: boolean;
+}
+export declare function registerBrowseSessionCommand(program: Command, emit: EmitContext): void;
+export declare function parseLocatorOptions(opts: LocatorOpts, required: true): BrowserSessionLocator;
+export declare function parseLocatorOptions(opts: LocatorOpts, required: false): BrowserSessionLocator | undefined;
+export declare function readFillValue(input: Readable): Promise<string>;
+export {};
+//# sourceMappingURL=browse-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browse-session.d.ts","sourceRoot":"","sources":["../../src/commands/browse-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOtE,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAY,SAAQ,eAAe;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA4GtF;AAYD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,GAAG,qBAAqB,CAAC;AAC9F,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,KAAK,GACd,qBAAqB,GAAG,SAAS,CAAC;AAoDrC,wBAAsB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE"}

package/dist/commands/browse-session.js

@@ -0,0 +1,157 @@
+import { BROWSER_SESSION_MAX_FILL_BYTES, BrowserSessionError, sendBrowserSessionRequest, } from "../lib/browser/session-control.js";
+export function registerBrowseSessionCommand(program, emit) {
+    const session = program
+        .command("browse-session")
+        .description("Control an opted-in headed browse session through an owner-only descriptor");
+    session
+        .command("status")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((opts) => runAction(emit, opts.controlFile, "status", {}));
+    addLocatorOptions(session
+        .command("inspect")
+        .description("Inspect sanitized text, controls, focus, and active-tab state")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")).action((opts) => {
+        const locator = parseLocatorOptions(opts, false);
+        return runAction(emit, opts.controlFile, "inspect", locator ? { locator } : {});
+    });
+    session
+        .command("screenshot")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .requiredOption("--out <path>", "New PNG path in an existing directory")
+        .action((opts) => runAction(emit, opts.controlFile, "screenshot", { out: opts.out }));
+    session
+        .command("tabs")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((opts) => runAction(emit, opts.controlFile, "tabs", {}));
+    session
+        .command("select-tab")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .requiredOption("--index <n>", "Stable session-local tab index", parseIndex)
+        .action((opts) => runAction(emit, opts.controlFile, "select_tab", { index: opts.index }));
+    session
+        .command("open-tab <url>")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((url, opts) => runAction(emit, opts.controlFile, "open_tab", { url }));
+    session
+        .command("close-tab")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .requiredOption("--index <n>", "Stable session-local tab index", parseIndex)
+        .action((opts) => runAction(emit, opts.controlFile, "close_tab", { index: opts.index }));
+    session
+        .command("goto <url>")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((url, opts) => runAction(emit, opts.controlFile, "goto", { url }));
+    session
+        .command("reload")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((opts) => runAction(emit, opts.controlFile, "reload", {}));
+    addLocatorOptions(session
+        .command("click")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")).action((opts) => runAction(emit, opts.controlFile, "click", { locator: parseLocatorOptions(opts, true) }));
+    addLocatorOptions(session
+        .command("fill")
+        .description("Fill one strict locator with a value read once from standard input")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")).action(async (opts) => {
+        const value = await readFillValue(process.stdin);
+        return runAction(emit, opts.controlFile, "fill", {
+            locator: parseLocatorOptions(opts, true),
+            value,
+        });
+    });
+    session
+        .command("press <key>")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((key, opts) => runAction(emit, opts.controlFile, "press", { key }));
+    addLocatorOptions(session
+        .command("wait")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")).action((opts) => runAction(emit, opts.controlFile, "wait", { locator: parseLocatorOptions(opts, true) }));
+    session
+        .command("close")
+        .requiredOption("--control-file <path>", "Owner-only session descriptor")
+        .action((opts) => runAction(emit, opts.controlFile, "close", {}));
+}
+function addLocatorOptions(command) {
+    return command
+        .option("--selector <css>", "CSS locator")
+        .option("--role <role>", "Accessible role locator")
+        .option("--name <name>", "Accessible name used with --role")
+        .option("--label <text>", "Associated label locator")
+        .option("--text <text>", "Visible text locator")
+        .option("--partial", "Allow partial accessible-name, label, or text matching");
+}
+export function parseLocatorOptions(opts, required) {
+    const forms = [opts.selector, opts.role, opts.label, opts.text].filter((value) => value !== undefined);
+    if (forms.length === 0) {
+        if (!required) {
+            if (opts.name !== undefined || opts.partial) {
+                throw new BrowserSessionError("invalid_locator", "--name and --partial require a locator form.");
+            }
+            return undefined;
+        }
+        throw new BrowserSessionError("invalid_locator", "Choose exactly one locator: --selector, --role, --label, or --text.");
+    }
+    if (forms.length !== 1) {
+        throw new BrowserSessionError("invalid_locator", "Choose exactly one locator: --selector, --role, --label, or --text.");
+    }
+    if (opts.name !== undefined && opts.role === undefined) {
+        throw new BrowserSessionError("invalid_locator", "--name is valid only with --role.");
+    }
+    if (opts.selector !== undefined) {
+        if (opts.partial) {
+            throw new BrowserSessionError("invalid_locator", "--partial is not valid with --selector.");
+        }
+        return { kind: "selector", value: opts.selector, partial: false };
+    }
+    if (opts.role !== undefined) {
+        return {
+            kind: "role",
+            value: opts.role,
+            ...(opts.name === undefined ? {} : { name: opts.name }),
+            partial: Boolean(opts.partial),
+        };
+    }
+    if (opts.label !== undefined) {
+        return { kind: "label", value: opts.label, partial: Boolean(opts.partial) };
+    }
+    return { kind: "text", value: opts.text, partial: Boolean(opts.partial) };
+}
+export async function readFillValue(input) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of input) {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+        size += bytes.length;
+        if (size > BROWSER_SESSION_MAX_FILL_BYTES) {
+            throw new BrowserSessionError("fill_too_large", "Fill input exceeds the 64 KiB limit.");
+        }
+        chunks.push(bytes);
+    }
+    const value = Buffer.concat(chunks)
+        .toString("utf8")
+        .replace(/\r?\n$/, "");
+    if (value.length === 0) {
+        throw new BrowserSessionError("fill_empty", "Fill input from standard input was empty.");
+    }
+    return value;
+}
+async function runAction(emit, controlFile, action, args) {
+    try {
+        emit.data(await sendBrowserSessionRequest(controlFile, action, args));
+    }
+    catch (error) {
+        if (error instanceof BrowserSessionError) {
+            emit.error({ code: error.code, message: error.message });
+            emit.setExitCode(1);
+            return;
+        }
+        emit.error({ code: "browser_session_failed", message: "Browser session command failed." });
+        emit.setExitCode(1);
+    }
+}
+function parseIndex(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0) {
+        throw new BrowserSessionError("invalid_index", "Tab index must be a non-negative integer.");
+    }
+    return parsed;
+}

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;AAuL1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAoWN"}
+{"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;AAmM1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAkZN"}