harnery 0.40.0 → 0.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",
@@ -187,6 +187,11 @@
       "types": "./dist/lib/http/index.d.ts",
       "import": "./dist/lib/http/index.js"
     },
+    "./lib/pace": {
+      "bun": "./src/lib/pace/index.ts",
+      "types": "./dist/lib/pace/index.d.ts",
+      "import": "./dist/lib/pace/index.js"
+    },
     "./lib/machine": {
       "bun": "./src/lib/machine.ts",
       "types": "./dist/lib/machine.d.ts",
@@ -219,6 +224,8 @@
     "src",
     "dist",
     "schemas",
+    "opencode-plugin/package.json",
+    "opencode-plugin/src/index.ts",
     "README.md",
     "LICENSE",
     "!src/**/*.test.ts",
@@ -242,13 +249,13 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build",
     "typecheck": "bun x tsc --noEmit",
-    "lint": "bun x @biomejs/biome check src openclaw-plugin",
+    "lint": "bun x @biomejs/biome check src openclaw-plugin opencode-plugin",
     "check:portability": "bun run scripts/check-portability.ts",
     "check:public-surface": "bun run scripts/check-public-surface.ts",
     "check:layering": "bun run scripts/check-layering.ts",
     "probe:supervisor-budget": "bun run scripts/probe-supervisor-budget.ts",
-    "lint:fix": "bun x @biomejs/biome check --write src openclaw-plugin",
-    "format": "bun x @biomejs/biome format --write src openclaw-plugin",
+    "lint:fix": "bun x @biomejs/biome check --write src openclaw-plugin opencode-plugin",
+    "format": "bun x @biomejs/biome format --write src openclaw-plugin opencode-plugin",
     "test": "bun run scripts/test.mjs",
     "test:list": "bun run scripts/test.mjs --list",
     "test:web": "cd web && bun install && bun test",

package/schemas/config.schema.json

@@ -216,6 +216,19 @@
         }
       }
     },
+    "storage": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Who can use this project's .harnery/ state. Read from the project file only.",
+      "properties": {
+        "sharing": {
+          "type": "string",
+          "enum": ["private", "group"],
+          "default": "private",
+          "description": "private: state is 0700/0600, owner-only. group: 2770/0660 for several Unix users sharing the project directory's group (the directory must be setgid). Never opens state to other users. Env override: HARNERY_STORAGE_SHARING."
+        }
+      }
+    },
     "artifacts": {
       "type": "object",
       "additionalProperties": false,

package/schemas/event-v3.schema.json

@@ -23775,6 +23775,170 @@
                 }
               }
             },
+            "line_changes": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state",
+                    "value",
+                    "attestation",
+                    "confidence"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "observed",
+                      "type": "string"
+                    },
+                    "value": {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "added",
+                        "removed"
+                      ],
+                      "properties": {
+                        "added": {
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "removed": {
+                          "minimum": 0,
+                          "type": "integer"
+                        }
+                      }
+                    },
+                    "attestation": {
+                      "anyOf": [
+                        {
+                          "const": "native",
+                          "type": "string"
+                        },
+                        {
+                          "const": "derived",
+                          "type": "string"
+                        },
+                        {
+                          "const": "inferred",
+                          "type": "string"
+                        }
+                      ]
+                    },
+                    "confidence": {
+                      "anyOf": [
+                        {
+                          "const": "exact",
+                          "type": "string"
+                        },
+                        {
+                          "const": "high",
+                          "type": "string"
+                        },
+                        {
+                          "const": "medium",
+                          "type": "string"
+                        },
+                        {
+                          "const": "low",
+                          "type": "string"
+                        }
+                      ]
+                    }
+                  }
+                },
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state",
+                    "capability"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "unsupported",
+                      "type": "string"
+                    },
+                    "capability": {
+                      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:/+-]{0,127}$",
+                      "type": "string"
+                    }
+                  }
+                },
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state",
+                    "capability",
+                    "reason"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "expected_but_missing",
+                      "type": "string"
+                    },
+                    "capability": {
+                      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:/+-]{0,127}$",
+                      "type": "string"
+                    },
+                    "reason": {
+                      "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$",
+                      "type": "string"
+                    }
+                  }
+                },
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state",
+                    "reason"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "redacted",
+                      "type": "string"
+                    },
+                    "reason": {
+                      "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$",
+                      "type": "string"
+                    }
+                  }
+                },
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state",
+                    "reason"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "unknown",
+                      "type": "string"
+                    },
+                    "reason": {
+                      "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$",
+                      "type": "string"
+                    }
+                  }
+                },
+                {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "state"
+                  ],
+                  "properties": {
+                    "state": {
+                      "const": "not_applicable",
+                      "type": "string"
+                    }
+                  }
+                }
+              ]
+            },
             "span": {
               "additionalProperties": false,
               "type": "object",

package/src/commander.ts

@@ -507,6 +507,13 @@ function harneryCommandBundles({
         (await import("./commands/browse-ai.ts")).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.ts")).registerWebviewCommand(program, emit, binName),
+      { hasOptions: true },
+    ),
     {
       commands: [
         {

package/src/commands/agents.ts

@@ -86,13 +86,18 @@ import {
   foldSessionState,
   type TaskState,
 } from "../core/agents/state/session-state.ts";
+import { turnChangesStatusRow } from "../core/agents/turn-changes.ts";
 import { turnElapsedStatusRow } from "../core/agents/turn-elapsed.ts";
 import {
   coordFreshnessSeconds,
   resolveBinName,
   sessionFinalizationConfig,
 } from "../core/config.ts";
-import { EVENT_ADAPTER_IDS_V3, type EventAdapterIdV3 } from "../core/events/v3/adapter-id.ts";
+import {
+  EVENT_ADAPTER_IDS_V3,
+  type EventAdapterIdV3,
+  normalizeEventAdapterIdV3,
+} from "../core/events/v3/adapter-id.ts";
 import type { EventTypeV3 } from "../core/events/v3/contract.ts";
 import { readEventV3ControlState } from "../core/events/v3/control.ts";
 import {
@@ -611,7 +616,7 @@ export function registerAgentsCommand(
     .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>",
@@ -1275,7 +1280,7 @@ function runWhoami(opts: { json?: boolean }): void {
   if (!hb) {
     emit.error({
       code: "no_live_generation",
-      message: noLiveGenerationMessage(myOwner),
+      message: noLiveGenerationMessage(root, myOwner),
     });
     process.exit(1);
   }
@@ -1473,9 +1478,19 @@ function normalizeKind(kind: string | undefined | null): string {
  * 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: string): string {
-  return `resolved owner=${owner} but no authority-safe live V3 generation exists for it`;
+function noLiveGenerationMessage(root: string, owner: string): string {
+  return `resolved owner=${owner} but no authority-safe live V3 generation exists for it; ${lifecycleReopenHint(root)}`;
+}
+
+function lifecycleReopenHint(root: string): string {
+  return `run \`${resolveBinName(root)} agents lifecycle active\` to open a fresh generation for this continuing session`;
 }
 
 /**
@@ -1750,7 +1765,7 @@ function cursorEnvSessionId(): string | null {
 }
 
 interface CommandSessionBootstrap {
-  adapter: "claude-code" | "cursor" | "codex";
+  adapter: Adapter;
   sessionId: string;
 }
 
@@ -2009,7 +2024,7 @@ function runLifecycle(rawState: string, opts: { reason?: string; sessionId?: str
     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;
@@ -2269,7 +2284,7 @@ function runStatus(opts: {
   if (!hb) {
     emit.error({
       code: "no_live_generation",
-      message: noLiveGenerationMessage(myOwner),
+      message: noLiveGenerationMessage(root, myOwner),
     });
     process.exit(1);
   }
@@ -2421,6 +2436,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 = {
@@ -2430,6 +2446,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,
@@ -2477,6 +2494,7 @@ function runStatus(opts: {
   const rows: Array<[string, string]> = [
     ["session", formatAge(ageSecs)],
     ...(turnElapsed ? ([["turn", turnElapsed.value]] as Array<[string, string]>) : []),
+    ["changes", turnChanges.value],
     ["activity", activityOf(hb)],
     ["lifecycle", lifecycleLabel(hb)],
     ["context", ctxStr],
@@ -2777,11 +2795,7 @@ export function readAgentDiagnosticEventsInWindow(
 
 /** Normalize adapter event data into the heartbeat platform value. */
 function adapterToPlatform(adapter: string | undefined): string {
-  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
@@ -5040,11 +5054,12 @@ function runHeal(opts: {
     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);
   }
@@ -5293,7 +5308,7 @@ function cacheHealAuthorityRefusal(
   root: string,
   owner: string,
   sessionId: string,
-  adapter: "claude-code" | "cursor" | "codex",
+  adapter: Adapter,
   currentRow: LiveCoordinationRow | null,
 ): HealAuthorityRefusal | null {
   if (currentRow && normalizeAdapter(currentRow.platform) !== adapter) {
@@ -5314,7 +5329,7 @@ function cacheHealAuthorityRefusal(
   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)) {
@@ -5356,7 +5371,7 @@ function healFailureReason(
   root: string,
   owner: string,
   sessionId: string,
-  adapter: "claude-code" | "cursor" | "codex",
+  adapter: Adapter,
 ): string {
   const refusal = cacheHealAuthorityRefusal(
     root,

package/src/commands/browse-ai.ts

@@ -4,6 +4,7 @@ import type { Command } from "commander";
 import type { EmitContext, HarneryProgramContext } from "../commander.ts";
 import { AgentBrowser, type ExecResult } from "../lib/agent-browser/index.ts";
 import { applyExtraCookies, CookieJar } from "../lib/cookies/index.ts";
+import { commandPaceGate } from "../lib/pace/index.ts";
 
 // Module-scoped emit assigned by registerBrowseAiCommand. Same pattern as
 // cookies/read/browse: helper functions close over `emit` so action
@@ -46,6 +47,7 @@ interface BrowseAiOpts {
   networkHar?: string;
   store?: string;
   cookies?: boolean;
+  pace?: boolean;
   json?: boolean;
   timeout: string;
 }
@@ -85,6 +87,11 @@ export function registerBrowseAiCommand(
     )
     .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")
@@ -108,6 +115,7 @@ function runBrowseAi(url: string, opts: BrowseAiOpts, context?: HarneryProgramCo
   const ab = new AgentBrowser({
     jar,
     timeoutMs: Number.parseInt(opts.timeout, 10),
+    pace: commandPaceGate(opts.pace !== false, (message) => emit.log(message, "info")),
   });
 
   const stepLog: { step: string; ok: boolean; output: string }[] = [];