harnery 0.39.0 → 0.41.0

package/README.md

@@ -28,7 +28,7 @@
 - **Standalone web UI.** `harn web up` boots a local Next.js dashboard for the coord layer, councils, per-project state, and a local coding-agent status view (Claude Code / Codex / Cursor usage, backed by `harn devtools`). Ships with the git clone, not the npm package (see [Install](#install)).
 - **Backup + sync.** `harn backup` snapshots `.harnery/` via [restic](https://restic.net/); `harn sync` keeps a curated subset live across machines via [rclone](https://rclone.org/) (Google Drive or any rclone remote).
 
-The CLI also ships batteries: portable utility commands (`tokens`, `eml`, `env`, `grep` for parallel, ripgrep-accelerated monorepo search, plus `docs`, `browse`, `fetch`, `read`, `devtools`, and more) and the library toolkit they're built from. Useful, cross-platform, and dependency-light, but deliberately not the headline. Coordination is why harnery exists; the toolkit exists because the CLI needed it (see [Public surface tiers](#public-surface-tiers)).
+The CLI also ships batteries: portable utility commands (`tokens`, `eml`, `env`, `grep` for parallel, ripgrep-accelerated monorepo search, plus `docs`, `browse`, `fetch`, `read`, `webview`, `devtools`, and more) and the library toolkit they're built from. Every page loader reads at human pace by default, waiting 3 to 9 seconds between loads of one site through a machine-wide ledger, with `--no-pace` and `HARNERY_PACE=off` to opt out. Useful, cross-platform, and dependency-light, but deliberately not the headline. Coordination is why harnery exists; the toolkit exists because the CLI needed it (see [Public surface tiers](#public-surface-tiers)).
 
 ## Install
 

package/dist/commander.js

@@ -113,6 +113,7 @@ function harneryCommandBundles({ emit, context, binName, }) {
         lazy("admission", "Machine-wide admission control for heavy jobs: `admission run --resource <name> -- <command…>` waits for a FIFO slot then runs the command; `admission status` lists holders and waiters per resource.", async (program) => (await import("./commands/admission.js")).registerAdmissionCommand(program, emit)),
         lazy("browse-session", "Control an opted-in headed browse session through an owner-only descriptor", async (program) => (await import("./commands/browse-session.js")).registerBrowseSessionCommand(program, emit)),
         lazy("browse-ai <url>", `agent-browser (Vercel Labs) wrapper: accessibility-tree snapshots with element refs (@e1, @e2) for LLM consumption. Daemon-mode: successive calls reuse the same browser instance. Sister to ${binName} browse (Playwright).`, async (program) => (await import("./commands/browse-ai.js")).registerBrowseAiCommand(program, emit, context), { hasOptions: true }),
+        lazy("webview <url>", `Lightweight headless page probe through Bun.WebView (experimental, Bun 1.4+). Fresh ephemeral browser per call; use ${binName} browse for login, cookies, HAR, and QA.`, async (program) => (await import("./commands/webview.js")).registerWebviewCommand(program, emit, binName), { hasOptions: true }),
         {
             commands: [
                 {

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

@@ -29,9 +29,10 @@ import { agentDisplayName } from "../core/agents/state/activity-log.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";
+import { turnChangesStatusRow } from "../core/agents/turn-changes.js";
 import { turnElapsedStatusRow } from "../core/agents/turn-elapsed.js";
 import { coordFreshnessSeconds, resolveBinName, sessionFinalizationConfig, } from "../core/config.js";
-import { EVENT_ADAPTER_IDS_V3 } from "../core/events/v3/adapter-id.js";
+import { EVENT_ADAPTER_IDS_V3, normalizeEventAdapterIdV3, } from "../core/events/v3/adapter-id.js";
 import { readEventV3ControlState } from "../core/events/v3/control.js";
 import { projectCoordinationViewV3, readCoordinationViewV3, } from "../core/events/v3/coordination-view.js";
 import { liveInstanceIdV3 } from "../core/events/v3/live-routing.js";
@@ -337,7 +338,7 @@ export function registerAgentsCommand(program, emitParam, programContext, binNam
         .option("--kind <kind>", "pidmap | cache. Defaults to cache.")
         .option("--session-id <id>", "(--kind cache) native session id used to join the authoritative V3 generation.")
         .option("--adapter <id>", "(--kind cache) adapter used to validate the authoritative V3 generation: " +
-        "claude-code | cursor | codex.")
+        "claude-code | cursor | codex | opencode.")
         .option("--pid <pid>", "(--kind pidmap) PID to register in pid-map. Default: walk " +
         "this shell's ppid chain for a claude process. Pass explicitly " +
         "when calling from outside Claude Code's Bash tool tree (e.g. " +
@@ -813,7 +814,7 @@ function runWhoami(opts) {
     if (!hb) {
         emit.error({
             code: "no_live_generation",
-            message: noLiveGenerationMessage(myOwner),
+            message: noLiveGenerationMessage(root, myOwner),
         });
         process.exit(1);
     }
@@ -994,9 +995,18 @@ function normalizeKind(kind) {
  * This id is actionable: the reader may pass it to cache repair or explicit
  * finalization. Abbreviate ids for display elsewhere, never in a diagnostic
  * whose purpose is to hand the caller a canonical identity.
+ *
+ * The message also names the recovery. A session whose generation ended while
+ * it sat idle (a stale sweep, or a `done` it has since outlived) still has a
+ * live process, and `agents lifecycle active` is the one command that opens a
+ * fresh generation for it (ADR 0088). Without the pointer every coordination
+ * command refuses in turn and the caller has no way to guess the path back.
  */
-function noLiveGenerationMessage(owner) {
-    return `resolved owner=${owner} but no authority-safe live V3 generation exists for it`;
+function noLiveGenerationMessage(root, owner) {
+    return `resolved owner=${owner} but no authority-safe live V3 generation exists for it; ${lifecycleReopenHint(root)}`;
+}
+function lifecycleReopenHint(root) {
+    return `run \`${resolveBinName(root)} agents lifecycle active\` to open a fresh generation for this continuing session`;
 }
 /**
  * The instance_id of a live V3 generation that `prefix` strictly prefixes, or null.
@@ -1470,7 +1480,7 @@ function runLifecycle(rawState, opts) {
         if (state !== "active") {
             emit.error({
                 code: "no_live_generation",
-                message: `${noLiveGenerationMessage(myOwner)}; run \`${resolveBinName(root)} agents lifecycle active\` to open a fresh generation`,
+                message: noLiveGenerationMessage(root, myOwner),
             });
             process.exitCode = 1;
             return;
@@ -1693,7 +1703,7 @@ function runStatus(opts) {
     if (!hb) {
         emit.error({
             code: "no_live_generation",
-            message: noLiveGenerationMessage(myOwner),
+            message: noLiveGenerationMessage(root, myOwner),
         });
         process.exit(1);
     }
@@ -1822,6 +1832,7 @@ function runStatus(opts) {
     // one inside the same session. Best-effort by contract — no turn evidence,
     // no row.
     const turnElapsed = turnElapsedStatusRow({ coordRoot: root, instanceId: hb.instance_id });
+    const turnChanges = turnChangesStatusRow({ coordRoot: root, instanceId: hb.instance_id });
     const resources = readResourceStatus(root);
     const data = {
         name: displayName,
@@ -1830,6 +1841,7 @@ function runStatus(opts) {
         session_age_secs: ageSecs,
         turn_elapsed_secs: turnElapsed ? turnElapsed.elapsed.secs : null,
         turn_complete: turnElapsed ? turnElapsed.elapsed.complete : null,
+        turn_changes: turnChanges.changes,
         activity: activityOf(hb),
         activity_updated_at: hb.activity_updated_at ?? null,
         activity_source: hb.activity_source ?? null,
@@ -1875,6 +1887,7 @@ function runStatus(opts) {
     const rows = [
         ["session", formatAge(ageSecs)],
         ...(turnElapsed ? [["turn", turnElapsed.value]] : []),
+        ["changes", turnChanges.value],
         ["activity", activityOf(hb)],
         ["lifecycle", lifecycleLabel(hb)],
         ["context", ctxStr],
@@ -2112,15 +2125,7 @@ export function readAgentDiagnosticEventsInWindow(root, cutoffMs) {
 }
 /** Normalize adapter event data into the heartbeat platform value. */
 function adapterToPlatform(adapter) {
-    if (adapter === "claude-code")
-        return "claude-code";
-    if (adapter === "cursor")
-        return "cursor";
-    if (adapter === "codex")
-        return "codex";
-    if (adapter === "openclaw")
-        return "openclaw";
-    return "unknown";
+    return normalizeEventAdapterIdV3(adapter) ?? "unknown";
 }
 /** Project a canonical health.* event into the HealEvent shape the aggregators
  * already consume. Returns null for non-heal events. instance_id → display name
@@ -4006,10 +4011,11 @@ function runHeal(opts) {
     if (opts.adapter &&
         opts.adapter !== "claude-code" &&
         opts.adapter !== "cursor" &&
-        opts.adapter !== "codex") {
+        opts.adapter !== "codex" &&
+        opts.adapter !== "opencode") {
         emit.error({
             code: "bad_adapter",
-            message: "--adapter must be one of: claude-code, cursor, codex",
+            message: "--adapter must be one of: claude-code, cursor, codex, opencode",
         });
         process.exit(1);
     }
@@ -4226,7 +4232,7 @@ function cacheHealAuthorityRefusal(root, owner, sessionId, adapter, currentRow)
     if (producer?.terminal) {
         return {
             reason: "terminal_generation",
-            message: "the matching generation is terminal and cannot be repaired or reopened by heal",
+            message: `the matching generation is terminal and cannot be repaired or reopened by heal; ${lifecycleReopenHint(root)}`,
         };
     }
     if (producer && producer.instance_id !== liveInstanceIdV3(owner)) {

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

@@ -1 +1 @@
-{"version":3,"file":"browse-ai.d.ts","sourceRoot":"","sources":["../../src/commands/browse-ai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAiD1E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2CN"}
+{"version":3,"file":"browse-ai.d.ts","sourceRoot":"","sources":["../../src/commands/browse-ai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmD1E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAgDN"}

package/dist/commands/browse-ai.js

@@ -2,6 +2,7 @@ import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { AgentBrowser } from "../lib/agent-browser/index.js";
 import { applyExtraCookies, CookieJar } from "../lib/cookies/index.js";
+import { commandPaceGate } from "../lib/pace/index.js";
 // Module-scoped emit assigned by registerBrowseAiCommand. Same pattern as
 // cookies/read/browse: helper functions close over `emit` so action
 // callbacks stay concise.
@@ -45,6 +46,8 @@ export function registerBrowseAiCommand(program, emitParam, context) {
         'E.g., --batch "click @e5; wait 1000; snapshot"')
         .option("--network-har <path>", "Record a HAR file from open() through end of run")
         .option("--no-cookies", "Skip cookie-jar attach and persist")
+        .option("--no-pace", "Skip the human-pace gap (3 to 9 s) between page loads of the same site for this run. " +
+        "HARNERY_PACE=off disables it machine-wide; local and private hosts never wait.")
         .option("--store <path>", `Cookie store path (default ${DEFAULT_STORE})`)
         .option("--json", "Emit a JSON envelope (snapshot, screenshot path, step results)")
         .option("--timeout <ms>", "Per-step timeout in ms", "60000")
@@ -68,6 +71,7 @@ function runBrowseAi(url, opts, context) {
     const ab = new AgentBrowser({
         jar,
         timeoutMs: Number.parseInt(opts.timeout, 10),
+        pace: commandPaceGate(opts.pace !== false, (message) => emit.log(message, "info")),
     });
     const stepLog = [];
     // 1. Open + optional HAR start.

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;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkS1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,EAC/B,OAAO,SAAmB,GACzB,IAAI,CAugBN;AAuzDD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,qCAAqC,CAAC"}
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA2S1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,EAC/B,OAAO,SAAmB,GACzB,IAAI,CAiiBN;AA61DD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,qCAAqC,CAAC"}

package/dist/commands/browse.js

@@ -1,10 +1,12 @@
+import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, resolve } from "node:path";
+import { chromium } from "playwright";
 import { PNG } from "pngjs";
 import { resolveBinName } from "../core/config.js";
 import { CAPTURE_FIDELITY_MISMATCH_THRESHOLD, compareBand, cropNativePng, decideFidelity, pngDimensions, } from "../lib/browser/capture-fidelity.js";
-import { Browser, browserProxyFromEnv, browserProxyGateFromEnv, captureDevOverlay, DEFAULT_CRITIQUE_RUBRIC, extractObservedIp, parseAssertSpec, runCritique, tilesFromFullPage, WEBRTC_PROXY_ONLY_ARG, writeNetscapeCookieFile, wslHeadedLaunchArgs, } from "../lib/browser/index.js";
+import { Browser, browserProxyFromEnv, browserProxyGateFromEnv, captureDevOverlay, chromeMajorFromExecutable, DEFAULT_CRITIQUE_RUBRIC, extractObservedIp, installedChromeChannel, installedChromePath, parseAssertSpec, resolveUserAgent, runCritique, tilesFromFullPage, WEBRTC_PROXY_ONLY_ARG, writeNetscapeCookieFile, wslHeadedLaunchArgs, } from "../lib/browser/index.js";
 import { allocateTileBudget, validatePageReviewAllocation, } from "../lib/browser/page-review-budget.js";
 import { PAGE_REVIEW_CAPTURE_PLAN_SCHEMA, } from "../lib/browser/page-review-contracts.js";
 import { findPackTile, gateHitsFromEnvelope, readPackContext, tileId, writePackContext, writePackExpandedTile, } from "../lib/browser/page-review-pack.js";
@@ -18,6 +20,7 @@ import { captureThumbnailFingerprint, registerCaptureThumbnail, } from "../lib/b
 import { reviewCandidateRects } from "../lib/browser/tiling.js";
 import { diffAgainstBaseline, saveBaseline, } from "../lib/browser/visual-diff.js";
 import { applyExtraCookies, CookieJar } from "../lib/cookies/index.js";
+import { commandPaceGate } from "../lib/pace/index.js";
 /**
  * `harn browse <url>`: Playwright-backed page navigation with shared
  * cookie jar + persistent profile + diagnostics capture for LLM
@@ -72,24 +75,39 @@ export function registerBrowseCommand(program, emitParam, context, binName = res
         "`click <selector>`, `fill <selector=>value>`, `press <key>`, `wait <selector|ms>`, `eval <js>`, `reload`. " +
         'Example: `--batch "click button; wait 1500; reload; wait 3000"`. `reload` preserves sessionStorage + cookies, which is how to repro sessionStorage-restored UI state.')
         .option("--network-har <path>", "Record network traffic to a HAR file (finalized on close)")
-        .option("--viewport <preset|WxH>", "Viewport: mobile (390x844), tablet (820x1180), desktop (1280x800), hd (1920x1080), or explicit '1920x1080'", "desktop")
+        .option("--viewport <preset|WxH>", "Viewport: mobile (390x844), tablet (820x1180), desktop (1280x800), hd (1920x1080), or explicit '1920x1080'. Default: real window in headed mode, desktop in headless mode")
         .option("--color-scheme <scheme>", "Emulate prefers-color-scheme for the whole session: light | dark. " +
         "Renders theme-aware pages in that scheme without page-specific toggles. " +
         "Absent = browser default (unchanged behavior).")
         .option("--login", "Headed mode for one-time auth flow (cookies persist in profile)")
+        .option("--plain", "With --login: open the URL in the installed Google Chrome with nothing attached (no DevTools " +
+        "protocol, no Playwright) on the same persistent profile. Use it for sign-in flows whose " +
+        "verification step detects automation itself (X does). Sign in, then close the window or " +
+        "create the --login-close-file; later browse and browse-session runs reuse the profile's cookies. " +
+        "Not compatible with --control-file, because nothing is attached to drive.")
         .option("--login-close-file <path>", "With --login, wait for this file instead of terminal Enter, then remove it and close cleanly")
         .option("--control-file <path>", "With --login, publish an owner-only descriptor for repeated browse-session control")
         .option("--headed", "Headed mode for one-off (no auth-flow framing)")
+        .option("--browser-channel <name>", "Browser to launch: chrome | chrome-beta | msedge | chromium. Headed launches (--login, --headed) " +
+        "default to the installed Google Chrome with the automation signals removed, because the bundled " +
+        '"Chrome for Testing" build advertises itself and sign-in flows refuse clicks; chromium forces the ' +
+        "bundled build. HARNERY_BROWSER_CHANNEL sets the default machine-wide.")
+        .option("--user-agent <ua|auto|native>", "User agent to present. Default: a normal Windows (or macOS on a Mac) Chrome user agent at the launched " +
+        "Chrome's major version, stored at ~/.cache/harnery/user-agent.json and reused by every surface; never " +
+        "Linux, never HeadlessChrome. A string rewrites the store, auto refreshes it, native uses the browser's own. " +
+        "HARNERY_BROWSER_UA overrides for one environment.")
         .option("--browser-arg <flag>", "Extra Chromium launch flag, passed straight to the browser (repeatable). " +
         "e.g. --browser-arg --disable-gpu. Also settable machine-wide via the " +
-        "HARNERY_BROWSER_ARGS env var (whitespace-separated). Under WSL, headed " +
-        "launches auto-add --disable-gpu to fix blank-window paint; opt out with " +
-        "HARNERY_BROWSER_NO_WSL_DEFAULTS=1.", (value, prev = []) => [...prev, value], [])
+        "HARNERY_BROWSER_ARGS env var (whitespace-separated). Under WSL, set " +
+        "HARNERY_BROWSER_WSL_DISABLE_GPU=1 to add --disable-gpu when a headed window paints blank; " +
+        "it is off by default because software WebGL is a bot tell.", (value, prev = []) => [...prev, value], [])
         .option("--proxy-from-env", "Pass HTTP(S)_PROXY to Playwright as an authenticated browser proxy. " +
         "Credentials stay in the child environment, never command arguments. " +
         "When the host also injects the HARNERY_BROWSER_PROXY_* gate variables, " +
         "the expected IP is verified before the requested URL opens.")
         .option("--no-cookies", "Skip cookie-jar attach and persist")
+        .option("--no-pace", "Skip the human-pace gap (3 to 9 s) between page loads of the same site for this run. " +
+        "HARNERY_PACE=off disables it machine-wide; local and private hosts never wait.")
         .option("--store <path>", `Cookie store path (default ${DEFAULT_STORE})`)
         .option("--profile <dir>", `Persistent Chromium profile dir (default ${DEFAULT_PROFILE})`)
         .option("--export-cookies <path>", "Write live profile cookies as an owner-only Netscape cookies.txt file on close")
@@ -332,20 +350,54 @@ async function runBrowse(url, opts, context) {
     if (loginCloseFile && existsSync(loginCloseFile)) {
         throw new Error(`Login close signal already exists at ${loginCloseFile}. Remove the stale file before launching.`);
     }
+    const pace = commandPaceGate(opts.pace !== false, (message) => emit.log(message, "info"));
+    if (opts.plain) {
+        if (!opts.login)
+            throw new Error("--plain requires --login.");
+        if (opts.controlFile) {
+            throw new Error("--plain cannot take --control-file: nothing is attached to drive the window.");
+        }
+        const plainExecutable = installedChromePath();
+        const plainUa = resolveUserAgent({
+            requested: opts.userAgent,
+            env: process.env.HARNERY_BROWSER_UA,
+            chromeMajor: plainExecutable ? chromeMajorFromExecutable(plainExecutable) : undefined,
+        });
+        await pace?.before(url);
+        await runPlainLogin(url, opts.profile ?? DEFAULT_PROFILE, loginCloseFile, plainUa, emit);
+        return;
+    }
+    const channel = resolveBrowserChannel(opts, Boolean(headed));
+    const userAgent = resolveUserAgent({
+        requested: opts.userAgent,
+        env: process.env.HARNERY_BROWSER_UA,
+        chromeMajor: launchedChromeMajor(channel),
+    });
     const browser = new Browser({
         profileDir: opts.profile ?? DEFAULT_PROFILE,
         headed,
         jar,
-        viewport,
+        viewport: headed && !opts.viewport ? null : viewport,
         ...(deviceScaleFactor !== undefined ? { deviceScaleFactor } : {}),
         ...(colorScheme ? { colorScheme } : {}),
         navigationTimeout: Number.parseInt(opts.timeout, 10),
         waitUntil: opts.waitUntil,
         recordHarPath: opts.networkHar ? resolve(opts.networkHar) : undefined,
         extraHeaders: context?.extraHeaders,
+        pace,
         launchArgs: resolveLaunchArgs(opts, Boolean(headed), Boolean(proxy)),
+        ...(channel ? { channel } : {}),
+        hideAutomation: Boolean(headed),
+        ...(userAgent ? { userAgent } : {}),
         proxy,
     });
+    if (userAgent)
+        emit.log(`Presenting as: ${userAgent}`, "debug");
+    if (headed) {
+        emit.log(channel && channel !== "chromium"
+            ? `Headed session uses the installed ${channel} channel with automation signals hidden.`
+            : "Headed session uses Playwright's bundled Chromium (no Google Chrome found); automation signals hidden.", "info");
+    }
     // Print mode: --snapshot / --html / --json all suppress file writes.
     const printMode = opts.snapshot || opts.html || opts.json;
     let controlServer = null;
@@ -2035,15 +2087,50 @@ function summarizeDiagnostics(diag) {
 }
 /**
  * Merge Chromium launch flags from three sources, in order, de-duped:
- *   1. WSLg headed default (`--disable-gpu`) — auto-applied for headed launches
- *      under WSL so the window actually paints. Opt out with
- *      HARNERY_BROWSER_NO_WSL_DEFAULTS=1.
+ *   1. WSLg `--disable-gpu`, only when HARNERY_BROWSER_WSL_DISABLE_GPU=1. It
+ *      was the default for headed launches, but software WebGL (SwiftShader)
+ *      is a bot tell that sign-in flows screen for, and current WSLg exposes
+ *      the host GPU through D3D12, so the flag is now opt-in for machines
+ *      that still paint a blank headed window without it.
  *   2. HARNERY_BROWSER_ARGS env (whitespace-separated) — a machine-wide default.
  *   3. --browser-arg flags on this invocation (repeatable).
  */
+const BROWSER_CHANNELS = new Set(["chrome", "chrome-beta", "msedge", "chromium"]);
+/**
+ * Pick the browser channel: `--browser-channel`, then `HARNERY_BROWSER_CHANNEL`,
+ * then (headed only) the installed Google Chrome when one exists. Headless runs
+ * keep the bundled Chromium unless told otherwise, so QA renders stay stable.
+ */
+function resolveBrowserChannel(opts, headed) {
+    const requested = (opts.browserChannel ?? process.env.HARNERY_BROWSER_CHANNEL)?.trim();
+    if (requested) {
+        if (!BROWSER_CHANNELS.has(requested)) {
+            throw new Error(`Unknown --browser-channel "${requested}". Use chrome, chrome-beta, msedge, or chromium.`);
+        }
+        return requested;
+    }
+    return headed ? installedChromeChannel() : undefined;
+}
+/**
+ * Major version of the Chrome that will launch: the installed Chrome for the
+ * `chrome` channel, else Playwright's bundled Chromium. Unknown when neither
+ * answers `--version`; the user-agent store then keeps its last value.
+ */
+function launchedChromeMajor(channel) {
+    if (channel === "chrome") {
+        const exe = installedChromePath();
+        return exe ? chromeMajorFromExecutable(exe) : undefined;
+    }
+    try {
+        return chromeMajorFromExecutable(chromium.executablePath());
+    }
+    catch {
+        return undefined;
+    }
+}
 function resolveLaunchArgs(opts, headed, proxyEnabled) {
     const args = [];
-    if (headed && !process.env.HARNERY_BROWSER_NO_WSL_DEFAULTS) {
+    if (headed && process.env.HARNERY_BROWSER_WSL_DISABLE_GPU === "1") {
         args.push(...wslHeadedLaunchArgs());
     }
     const envArgs = process.env.HARNERY_BROWSER_ARGS?.trim();
@@ -2067,6 +2154,50 @@ async function verifyBrowserProxyGate(browser, gate) {
     }
     emit.log(`browser proxy gate: ${observedIp} · expected IP confirmed`, "info");
 }
+/**
+ * `--login --plain`: spawn the installed Google Chrome directly on the shared
+ * persistent profile, with no DevTools protocol attached. Playwright enables
+ * its runtime hooks in every frame it drives, and sign-in verification vendors
+ * (X's is the reported case) detect that and fail the flow with no explanation.
+ * The person signs in here; cookies land in the same profile that later
+ * `browse` and `browse-session` runs open, so read-only captures inherit the
+ * session without ever repeating the sign-in under automation.
+ */
+async function runPlainLogin(url, profileDir, loginCloseFile, userAgent, emit) {
+    const executable = installedChromePath();
+    if (!executable) {
+        throw new Error("--plain needs an installed Google Chrome at a standard path; none was found on this machine.");
+    }
+    mkdirSync(profileDir, { recursive: true });
+    const child = spawn(executable, [
+        `--user-data-dir=${profileDir}`,
+        "--no-first-run",
+        "--no-default-browser-check",
+        ...(userAgent ? [`--user-agent=${userAgent}`] : []),
+        url,
+    ], { stdio: "ignore" });
+    const exited = new Promise((resolveExit) => {
+        child.once("exit", () => resolveExit());
+        child.once("error", () => resolveExit());
+    });
+    const lifecycleAbort = new AbortController();
+    const waits = [exited];
+    if (loginCloseFile) {
+        emit.log(`[--login --plain] Plain Google Chrome is open with nothing attached. Sign in, then close the window or create ${loginCloseFile}.`, "info");
+        waits.push(waitForLoginCloseFile(loginCloseFile, lifecycleAbort.signal));
+    }
+    else {
+        emit.log("[--login --plain] Plain Google Chrome is open with nothing attached. Sign in, then close the window or press Enter here.", "info");
+        waits.push(waitForTerminalEnter(lifecycleAbort.signal));
+    }
+    await Promise.race(waits);
+    lifecycleAbort.abort();
+    if (child.exitCode === null && child.signalCode === null) {
+        child.kill("SIGTERM");
+        await Promise.race([exited, new Promise((r) => setTimeout(r, 5000))]);
+    }
+    emit.log(`[--login --plain] Chrome closed; cookies persisted in ${profileDir}.`, "info");
+}
 async function waitForLoginCloseFile(path, signal) {
     while (!existsSync(path) && !signal?.aborted) {
         await new Promise((resolve) => setTimeout(resolve, 250));

package/dist/commands/checkpoint.js

@@ -1,3 +1,4 @@
+import { ADAPTERS, normalizeAdapter } from "../core/adapter.js";
 import { monorepoRoot, resolveOwner } from "../core/agents/index.js";
 import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
 import { checkpointContext, readContextState, readLatestCapsule, } from "../core/context/index.js";
@@ -58,7 +59,7 @@ export function registerCheckpointCommand(program, emit, context) {
         .description("Create a durable context-continuity capsule for the current work")
         .option("--session <id>", "Session id (defaults to the current agent heartbeat)")
         .option("--instance <id>", "Agent instance id (defaults to the current owner)")
-        .option("--adapter <id>", "claude-code, codex, or cursor (inferred from heartbeat)")
+        .option("--adapter <id>", `${ADAPTERS.join(", ")} (inferred from heartbeat)`)
         .option("--reason <reason>", "manual, pressure, pre_compact, or session_end", "manual")
         .option("--note <text>", "Short continuation note for the recovered agent")
         .option("--json", "Structured JSON output")
@@ -68,7 +69,7 @@ export function registerCheckpointCommand(program, emit, context) {
             const reason = parseCheckpointReason(opts.reason);
             const identity = resolveContinuityIdentity(context, opts);
             if (!identity.adapter) {
-                throw new Error("could not infer the adapter; pass --adapter claude-code|codex|cursor");
+                throw new Error(`could not infer the adapter; pass --adapter ${ADAPTERS.join("|")}`);
             }
             const result = checkpointContext(identity.coordRoot, {
                 sessionId: identity.sessionId,
@@ -135,18 +136,13 @@ function resolveContinuityIdentity(context, opts) {
     return { coordRoot, instanceId, sessionId, adapter };
 }
 function adapterFromPlatform(platform) {
-    if (platform === "claude-code")
-        return "claude-code";
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    return null;
+    return normalizeAdapter(platform);
 }
 function parseAdapter(value) {
-    if (value === "claude-code" || value === "codex" || value === "cursor")
-        return value;
-    throw new Error(`invalid adapter "${value}"; expected claude-code, codex, or cursor`);
+    const adapter = normalizeAdapter(value);
+    if (adapter)
+        return adapter;
+    throw new Error(`invalid adapter "${value}"; expected one of ${ADAPTERS.join(", ")}`);
 }
 function parseCheckpointReason(value) {
     if (value === "manual" ||

package/dist/commands/deinit.d.ts

@@ -4,7 +4,7 @@
  * `init` makes two kinds of change outside the harnery package:
  *   1. Merges `agent-hook` entries into the adapter settings file
  *      (Claude Code `.claude/settings.json`, Cursor `.cursor/hooks.json`, or
- *      Codex `.codex/hooks.json`).
+ *      Codex `.codex/hooks.json`), or installs the OpenCode plugin directory.
  *   2. Creates the `.harnery/` coord root (runtime state: events, councils,
  *      identities, journal) and stamps the host bin name into
  *      `.harnery/config.jsonc`.

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

@@ -1 +1 @@
-{"version":3,"file":"deinit.d.ts","sourceRoot":"","sources":["../../src/commands/deinit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAgBnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAwHjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAEV;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}
+{"version":3,"file":"deinit.d.ts","sourceRoot":"","sources":["../../src/commands/deinit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAiBnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CA4HjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAEV;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}

package/dist/commands/deinit.js

@@ -4,7 +4,7 @@
  * `init` makes two kinds of change outside the harnery package:
  *   1. Merges `agent-hook` entries into the adapter settings file
  *      (Claude Code `.claude/settings.json`, Cursor `.cursor/hooks.json`, or
- *      Codex `.codex/hooks.json`).
+ *      Codex `.codex/hooks.json`), or installs the OpenCode plugin directory.
  *   2. Creates the `.harnery/` coord root (runtime state: events, councils,
  *      identities, journal) and stamps the host bin name into
  *      `.harnery/config.jsonc`.
@@ -31,6 +31,7 @@ import { relative, resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { DEFAULT_BIN_NAME } from "../core/config.js";
 import { ADAPTER_SPECS } from "../core/hooks/adapter/events.js";
+import { removeOpenCodePlugin } from "../core/hooks/adapter/opencode-plugin.js";
 import { removeIndexerExclusions } from "../lib/indexer-exclusions.js";
 import { removeInstructions } from "../lib/instructions/apply.js";
 import { removeGitHooks } from "../lib/instructions/git-hooks.js";
@@ -47,7 +48,7 @@ export function registerDeinitCommand(program, emit, binName) {
         "settings file (keeps any others). Pass --purge-state to also delete the " +
         ".harnery/ coord root (on a terminal it asks first). Idempotent; use " +
         "--dry-run to preview.")
-        .option("--adapter <id>", "claude-code | cursor | codex", "claude-code")
+        .option("--adapter <id>", "claude-code | cursor | codex | opencode", "claude-code")
         .option("--dry-run", "Show what would change without writing")
         .option("--project-root <path>", "Project root (default: git toplevel, else cwd)")
         .option("--purge-state", "Also delete the .harnery/ coord root (runtime state, destructive)")
@@ -55,7 +56,7 @@ export function registerDeinitCommand(program, emit, binName) {
         const adapter = opts.adapter;
         const spec = ADAPTER_SPECS[adapter];
         if (!spec) {
-            emit.text(`Unknown adapter '${opts.adapter}'. Expected: claude-code | cursor | codex.`);
+            emit.text(`Unknown adapter '${opts.adapter}'. Expected: claude-code | cursor | codex | opencode.`);
             emit.setExitCode(1);
             return;
         }
@@ -77,7 +78,10 @@ export function registerDeinitCommand(program, emit, binName) {
         }
         // ── 1. unwire adapter hooks ────────────────────────────────────────────
         const settingsPath = resolve(projectRoot, spec.settingsFile);
-        if (!existsSync(settingsPath)) {
+        if (spec.installMode === "opencode-plugin") {
+            actions.push(...removeOpenCodePlugin(projectRoot, dryRun));
+        }
+        else if (!existsSync(settingsPath)) {
             actions.push(`· ${rel(projectRoot, settingsPath)} doesn't exist; no hooks to remove`);
         }
         else {

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

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmC1E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2ON"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAqC1E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2ON"}

package/dist/commands/docs.js

@@ -4,6 +4,7 @@ import { initDocsContext as initDocsLinks, runLinks } from "../lib/docs-links.js
 import { initDocsContext as initDocsLint, runLint } from "../lib/docs-lint.js";
 import { readDocsMetadata, readDocsMetadataKey } from "../lib/docs-meta.js";
 import { initDocsMetadataAuditContext, runDocsMetadataAudit } from "../lib/docs-metadata-audit.js";
+import { initDocsMetadataExclusions } from "../lib/docs-metadata-managed.js";
 import { initDocsMetadataSyncContext, runDocsMetadataSync } from "../lib/docs-metadata-sync.js";
 import { createDocsFile } from "../lib/docs-new.js";
 import { countColdHandoffs, initDocsContext as initDocsSweep, runSweep, } from "../lib/docs-sweep.js";
@@ -20,6 +21,7 @@ function ensureContext(context) {
         docsRootAllowlist: context.docsRootAllowlist,
     });
     initDocsLinks({ ...opts, extraExcludedPrefixes: context.extraDocsExcludedPrefixes });
+    initDocsMetadataExclusions(context.extraDocsExcludedPrefixes);
     initDocsMetadataAuditContext(opts);
     initDocsMetadataSyncContext(opts);
     initDocsSweep(opts);

package/dist/commands/doctor.js

@@ -476,12 +476,20 @@ function checkAdapterHooks(installedAdapters = []) {
         if (d.invalidEventKeys.length > 0) {
             bits.push(`unsupported events (${d.invalidEventKeys.join(", ")})`);
         }
+        if (d.pluginIssues && d.pluginIssues.length > 0) {
+            // Plugin issues already name their file; render them as-is.
+            return d.pluginIssues.join("; ");
+        }
         return `${d.settingsFile}: ${bits.join("; ")}`;
     });
     for (const id of unwired) {
-        parts.push(`${ADAPTER_SPECS[id].settingsFile}: ${id} CLI installed, no harnery hooks wired`);
+        const what = ADAPTER_SPECS[id].installMode === "opencode-plugin" ? "plugin" : "hooks";
+        parts.push(`${ADAPTER_SPECS[id].settingsFile}: ${id} CLI installed, no harnery ${what} wired`);
     }
-    const needsManualRepair = drift.some((d) => d.parseError || d.invalidTopLevelKeys.length > 0 || d.invalidEventKeys.length > 0);
+    const needsManualRepair = drift.some((d) => d.parseError ||
+        d.invalidTopLevelKeys.length > 0 ||
+        d.invalidEventKeys.length > 0 ||
+        d.pluginIssues?.some((issue) => issue.includes("without harnery's ownership header")));
     const wireHints = unwired.map((id) => `\`${bin} init --adapter ${id}\``);
     let hint;
     if (needsManualRepair) {

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

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/commands/fetch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA4B1E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2BN"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/commands/fetch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA+B1E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAgCN"}