harnery 0.30.0 → 0.31.0

package/dist/lib/machine.d.ts

@@ -1,11 +1,11 @@
 /**
  * Resolve a human-friendly label for the current machine. Used to tag
- * coordination artifacts (scratch-doc headers, session telemetry) by the host
+ * coordination artifacts (journal-doc headers, session telemetry) by the host
  * they originated on.
  *
  * Precedence (first non-empty wins):
  *   1. HARNERY_MACHINE env var:          transient / per-launch / CI override
- *   2. ~/.config/harnery/machine file:   persistent, harness-neutral identity
+ *   2. ~/.config/harnery/machine file:   persistent, adapter-neutral identity
  *   3. os.hostname() (normalized):       automatic floor; never empty
  *
  * The env var sits on top for ad-hoc overrides; the file is the durable home for

package/dist/lib/machine.js

@@ -4,12 +4,12 @@ import { resolve } from "node:path";
 import { coordEnv } from "./env.js";
 /**
  * Resolve a human-friendly label for the current machine. Used to tag
- * coordination artifacts (scratch-doc headers, session telemetry) by the host
+ * coordination artifacts (journal-doc headers, session telemetry) by the host
  * they originated on.
  *
  * Precedence (first non-empty wins):
  *   1. HARNERY_MACHINE env var:          transient / per-launch / CI override
- *   2. ~/.config/harnery/machine file:   persistent, harness-neutral identity
+ *   2. ~/.config/harnery/machine file:   persistent, adapter-neutral identity
  *   3. os.hostname() (normalized):       automatic floor; never empty
  *
  * The env var sits on top for ad-hoc overrides; the file is the durable home for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",
@@ -47,15 +47,20 @@
       "types": "./dist/core/agents/session-events.d.ts",
       "import": "./dist/core/agents/session-events.js"
     },
+    "./core/artifacts": {
+      "bun": "./src/core/artifacts/index.ts",
+      "types": "./dist/core/artifacts/index.d.ts",
+      "import": "./dist/core/artifacts/index.js"
+    },
     "./core/hooks": {
       "bun": "./src/core/hooks/index.ts",
       "types": "./dist/core/hooks/index.d.ts",
       "import": "./dist/core/hooks/index.js"
     },
-    "./core/harnesses": {
-      "bun": "./src/core/harnesses/index.ts",
-      "types": "./dist/core/harnesses/index.d.ts",
-      "import": "./dist/core/harnesses/index.js"
+    "./core/adapters": {
+      "bun": "./src/core/adapters/index.ts",
+      "types": "./dist/core/adapters/index.d.ts",
+      "import": "./dist/core/adapters/index.js"
     },
     "./core/context": {
       "bun": "./src/core/context/index.ts",
@@ -77,20 +82,20 @@
       "types": "./dist/core/work/read.d.ts",
       "import": "./dist/core/work/read.js"
     },
-    "./core/supervisor": {
-      "bun": "./src/core/supervisor/index.ts",
-      "types": "./dist/core/supervisor/index.d.ts",
-      "import": "./dist/core/supervisor/index.js"
+    "./core/governor": {
+      "bun": "./src/core/governor/index.ts",
+      "types": "./dist/core/governor/index.d.ts",
+      "import": "./dist/core/governor/index.js"
     },
-    "./core/supervisor/state": {
-      "bun": "./src/core/supervisor/read.ts",
-      "types": "./dist/core/supervisor/read.d.ts",
-      "import": "./dist/core/supervisor/read.js"
+    "./core/governor/state": {
+      "bun": "./src/core/governor/read.ts",
+      "types": "./dist/core/governor/read.d.ts",
+      "import": "./dist/core/governor/read.js"
     },
-    "./core/supervisor/plans": {
-      "bun": "./src/core/supervisor/plan-read.ts",
-      "types": "./dist/core/supervisor/plan-read.d.ts",
-      "import": "./dist/core/supervisor/plan-read.js"
+    "./core/governor/plans": {
+      "bun": "./src/core/governor/plan-read.ts",
+      "types": "./dist/core/governor/plan-read.d.ts",
+      "import": "./dist/core/governor/plan-read.js"
     },
     "./core/policy": {
       "bun": "./src/core/policy/index.ts",
@@ -132,10 +137,10 @@
       "types": "./dist/lib/readability/index.d.ts",
       "import": "./dist/lib/readability/index.js"
     },
-    "./core/scratch": {
-      "bun": "./src/core/scratch/index.ts",
-      "types": "./dist/core/scratch/index.d.ts",
-      "import": "./dist/core/scratch/index.js"
+    "./core/journal": {
+      "bun": "./src/core/journal/index.ts",
+      "types": "./dist/core/journal/index.d.ts",
+      "import": "./dist/core/journal/index.js"
     },
     "./lib/tunnel/state": {
       "bun": "./src/lib/tunnel/state.ts",

package/schemas/config.schema.json

@@ -35,6 +35,20 @@
         }
       }
     },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Defaults for repository-local working artifacts under .harnery/artifacts/.",
+      "properties": {
+        "default_retention_days": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 3650,
+          "default": 3,
+          "description": "Retention for `harn artifacts create` when --days is absent. Env override: HARNERY_ARTIFACT_RETENTION_DAYS."
+        }
+      }
+    },
     "web": {
       "type": "object",
       "additionalProperties": false,
@@ -113,6 +127,17 @@
         }
       }
     },
+    "instructions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Agent-facing instructions harnery manages in AGENTS.md.",
+      "properties": {
+        "hostAddendumFile": {
+          "type": "string",
+          "description": "Repo-relative path to a markdown file holding this project's own coordination policy. `harn init` splices its contents into a second managed region in AGENTS.md, `init --check` reports drift against it, and `deinit` (or removing this key) takes the region back out. Harnery never parses the content. Must resolve inside the project and be non-empty."
+        }
+      }
+    },
     "presence": {
       "type": "object",
       "additionalProperties": false,
@@ -165,7 +190,7 @@
     "sync": {
       "type": "object",
       "additionalProperties": false,
-      "description": "`harn sync` (rclone) defaults for the curated cross-machine subset (identities/, scratch/archived/, councils/). Env overrides: HARNERY_SYNC_REMOTE, HARNERY_SYNC_PREFIX. `harn sync init` also records these in ~/.config/harnery/sync.json (a lower-precedence fallback than this section).",
+      "description": "`harn sync` (rclone) defaults for the curated cross-machine subset (identities/, journal/archived/, councils/). Env overrides: HARNERY_SYNC_REMOTE, HARNERY_SYNC_PREFIX. `harn sync init` also records these in ~/.config/harnery/sync.json (a lower-precedence fallback than this section).",
       "properties": {
         "remote": {
           "type": "string",

package/src/commander.ts

@@ -18,15 +18,17 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
-import { registerAgentsCommand } from "./commands/agents.ts";
+import { registerAdapterCommand } from "./commands/adapter.ts";
+import { registerAgentsCommand, registerCouncilCommands } from "./commands/agents.ts";
+import { registerArtifactsCommand } from "./commands/artifacts.ts";
 import { registerBackupCommand } from "./commands/backup.ts";
 import { registerBrowseCommand } from "./commands/browse.ts";
 import { registerBrowseAiCommand } from "./commands/browse-ai.ts";
 import { registerCallersCommand } from "./commands/callers.ts";
+import { registerCheckpointCommand } from "./commands/checkpoint.ts";
 import { registerClaudeDesktopCommand } from "./commands/claude-desktop.ts";
 import { registerCompletionCommand } from "./commands/completion.ts";
 import { registerConfigGetCommand } from "./commands/config-get.ts";
-import { registerContextCommand } from "./commands/context.ts";
 import { registerCookiesCommand } from "./commands/cookies.ts";
 import { registerDecisionCommand } from "./commands/decision.ts";
 import { registerDeinitCommand } from "./commands/deinit.ts";
@@ -38,17 +40,15 @@ import { registerEmlCommand } from "./commands/eml.ts";
 import { registerEnvCommand } from "./commands/env.ts";
 import { registerFetchCommand } from "./commands/fetch.ts";
 import { registerFileHistoryCommand } from "./commands/file-history.ts";
+import { registerGovernorCommand } from "./commands/governor.ts";
 import { registerGrepCommand } from "./commands/grep.ts";
-import { registerHarnessCommand } from "./commands/harness.ts";
 import { registerInitCommand } from "./commands/init.ts";
+import { registerJournalCommand } from "./commands/journal.ts";
 import { registerOutlineCommand } from "./commands/outline.ts";
 import { registerPolicyCommand } from "./commands/policy.ts";
 import { registerPresenceCommand } from "./commands/presence.ts";
 import { registerReadCommand } from "./commands/read.ts";
 import { registerRelayCommand } from "./commands/relay.ts";
-import { registerScratchCommand } from "./commands/scratch.ts";
-import { registerSessionCommand } from "./commands/session.ts";
-import { registerSupervisorCommand } from "./commands/supervisor.ts";
 import { registerSyncCommand } from "./commands/sync.ts";
 import { registerSectionCommand, registerTocCommand } from "./commands/toc.ts";
 import { registerTokensCommand } from "./commands/tokens.ts";
@@ -143,6 +143,14 @@ export interface HarneryProgramContext {
    * zones behind a WAF). harn standalone skips the callback entirely.
    */
   extraHeaders?: (url: string) => Record<string, string>;
+  /**
+   * Host-injected vision-model call for `browse --check-critique`. harnery
+   * ships no model client or API key; a consumer wires this to its own
+   * multimodal provider (OpenAI/Anthropic/etc). Given one page tile + the
+   * rubric, it returns that tile's findings. When omitted, `--check-critique`
+   * reports `skipped` rather than a false pass.
+   */
+  critiqueProvider?: import("./lib/browser/critique.ts").CritiqueProvider;
   /**
    * Shell-completion provider-key lookup. Consumers wire this to a function
    * mapping (commandPath, option/positional) to a provider key, so that
@@ -250,7 +258,7 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
 
   program
     .name(opts.binName ?? "harn")
-    .description("Multi-agent coordination + harness adapters + portable CLI utilities.")
+    .description("Multi-agent coordination + adapter adapters + portable CLI utilities.")
     .version(readVersion());
 
   registerTokensCommand(program, emit);
@@ -266,22 +274,23 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
   registerCallersCommand(program, emit, opts.context);
   registerEditBatchCommand(program, emit);
   registerGrepCommand(program, emit, opts.context);
-  registerHarnessCommand(program, emit);
+  registerAdapterCommand(program, emit);
   registerPolicyCommand(program, emit);
   registerCookiesCommand(program, emit);
   registerFetchCommand(program, emit, opts.context);
   registerReadCommand(program, emit);
   registerBrowseCommand(program, emit, opts.context);
   registerBrowseAiCommand(program, emit);
-  registerSessionCommand(program, emit);
   registerCompletionCommand(program, emit, opts.context);
-  registerContextCommand(program, emit, opts.context);
-  registerScratchCommand(program, emit);
+  registerCheckpointCommand(program, emit, opts.context);
+  registerJournalCommand(program, emit);
+  registerArtifactsCommand(program, emit, opts.context);
   registerDecisionCommand(program, emit);
   registerDevtoolsCommand(program, emit);
   registerTunnelCommand(program, emit, opts.context);
   registerDocsCommand(program, emit, opts.context);
-  registerAgentsCommand(program, emit);
+  registerAgentsCommand(program, emit, opts.context);
+  registerCouncilCommands(program);
   registerDoctorCommand(program, emit);
   registerInitCommand(program, emit, opts.binName);
   registerDeinitCommand(program, emit, opts.binName);
@@ -290,7 +299,7 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
   registerSyncCommand(program, emit);
   registerWorkflowCommand(program, emit);
   registerWorkCommand(program, emit);
-  registerSupervisorCommand(program, emit);
+  registerGovernorCommand(program, emit);
   if (include("web")) registerWebCommand(program, emit);
 
   return program;

package/src/commands/{harness.ts → adapter.ts}

@@ -1,16 +1,16 @@
 import type { Command } from "commander";
 import type { EmitContext } from "../commander.ts";
-import { workflowSubscriptionOnly } from "../core/config.ts";
 import {
+  type AdapterAttestationReport,
+  type AdapterBenchReport,
   type BenchResult,
-  createBuiltinHarnessRegistry,
-  type HarnessAttestationReport,
-  type HarnessBenchReport,
+  createBuiltinAdapterRegistry,
   listAttestations,
-  runHarnessAttestation,
-  runHarnessBench,
-} from "../core/harnesses/index.ts";
-import type { HarnessProfile } from "../core/harnesses/types.ts";
+  runAdapterAttestation,
+  runAdapterBench,
+} from "../core/adapters/index.ts";
+import type { AdapterProfile } from "../core/adapters/types.ts";
+import { workflowSubscriptionOnly } from "../core/config.ts";
 
 interface FormatOpts {
   json?: boolean;
@@ -27,22 +27,22 @@ interface AttestOpts extends FormatOpts {
   projection?: boolean;
 }
 
-const registry = createBuiltinHarnessRegistry();
+const registry = createBuiltinAdapterRegistry();
 
-export function registerHarnessCommand(program: Command, emit: EmitContext): void {
+export function registerAdapterCommand(program: Command, emit: EmitContext): void {
   const command = program
-    .command("harness")
-    .description("Inspect registered harness capabilities and run their conformance bench.");
+    .command("adapter")
+    .description("Inspect registered adapter capabilities and run their conformance bench.");
 
   command
     .command("list")
-    .description("List registered harness adapters and their high-signal capability claims.")
+    .description("List registered adapter adapters and their high-signal capability claims.")
     .option("--json", "Machine-readable profile catalog")
     .action((opts: FormatOpts) => {
       const profiles = registry.list().map((adapter) => adapter.profile);
       if (opts.json) {
         emit.config({ format: "json" });
-        emit.data({ harnesses: profiles });
+        emit.data({ adapters: profiles });
       } else {
         emit.text(renderProfileTable(profiles));
       }
@@ -50,14 +50,14 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
 
   command
     .command("show <id>")
-    .description("Show one harness's complete capability declaration.")
+    .description("Show one adapter's complete capability declaration.")
     .option("--json", "Machine-readable profile")
     .action((id: string, opts: FormatOpts) => {
       const adapter = registry.get(id);
       if (!adapter) {
         emit.error({
-          code: "unknown_harness",
-          message: `unknown harness ${JSON.stringify(id)} (registered: ${registry.ids().join(", ")})`,
+          code: "unknown_adapter",
+          message: `unknown adapter ${JSON.stringify(id)} (registered: ${registry.ids().join(", ")})`,
         });
         emit.setExitCode(1);
         return;
@@ -71,13 +71,13 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
     });
 
   command
-    .command("bench [harnesses...]")
+    .command("bench [adapters...]")
     .description("Run the offline adapter-contract bench (no model calls); drift exits non-zero.")
     .option("--require-installed", "Also fail when a registered vendor CLI is missing")
     .option("--json", "Machine-readable conformance report")
-    .action((harnesses: string[], opts: BenchOpts) => {
+    .action((adapters: string[], opts: BenchOpts) => {
       try {
-        const report = runHarnessBench(registry, { harnesses });
+        const report = runAdapterBench(registry, { adapters });
         if (opts.json) {
           emit.config({ format: "json" });
           emit.data(report);
@@ -86,13 +86,13 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
         }
         emit.setExitCode(report.drift || (opts.requireInstalled && report.skipped) ? 1 : 0);
       } catch (error) {
-        emit.error({ code: "harness_bench_failed", message: (error as Error).message });
+        emit.error({ code: "adapter_bench_failed", message: (error as Error).message });
         emit.setExitCode(1);
       }
     });
 
   command
-    .command("attest [harnesses...]")
+    .command("attest [adapters...]")
     .description(
       "Record what the installed vendor CLIs actually do. Runs one real model turn each; needs --yes.",
     )
@@ -101,18 +101,18 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
       "--subscription-only",
       "Scrub API-key vars so the child uses its stored login (repo default via config.jsonc workflow.subscriptionOnly)",
     )
-    .option("--timeout <ms>", "Per-harness probe timeout in milliseconds")
+    .option("--timeout <ms>", "Per-adapter probe timeout in milliseconds")
     .option(
       "--projection",
-      "Also probe whether a declared sandbox is enforced; costs two extra turns per capable harness",
+      "Also probe whether a declared sandbox is enforced; costs two extra turns per capable adapter",
     )
     .option("--json", "Machine-readable attestation report")
-    .action(async (harnesses: string[], opts: AttestOpts) => {
+    .action(async (adapters: string[], opts: AttestOpts) => {
       if (!opts.yes) {
         emit.error({
-          code: "harness_attest_unconfirmed",
+          code: "adapter_attest_unconfirmed",
           message:
-            "harness attest runs one real model turn per harness and spends vendor tokens. Re-run with --yes.",
+            "adapter attest runs one real model turn per adapter and spends vendor tokens. Re-run with --yes.",
         });
         emit.setExitCode(1);
         return;
@@ -120,7 +120,7 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
       const timeoutMs = opts.timeout ? Number(opts.timeout) : undefined;
       if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
         emit.error({
-          code: "harness_attest_bad_timeout",
+          code: "adapter_attest_bad_timeout",
           message: "--timeout must be a positive number",
         });
         emit.setExitCode(1);
@@ -128,8 +128,8 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
       }
       try {
         const subscriptionOnly = opts.subscriptionOnly || workflowSubscriptionOnly();
-        const report = await runHarnessAttestation(registry, {
-          harnesses,
+        const report = await runAdapterAttestation(registry, {
+          adapters,
           timeoutMs,
           subscriptionOnly,
           projection: opts.projection === true,
@@ -145,7 +145,7 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
         // to install every vendor CLI.
         emit.setExitCode(report.recorded === 0 ? 1 : 0);
       } catch (error) {
-        emit.error({ code: "harness_attest_failed", message: (error as Error).message });
+        emit.error({ code: "adapter_attest_failed", message: (error as Error).message });
         emit.setExitCode(1);
       }
     });
@@ -163,14 +163,14 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
           return;
         }
         if (records.length === 0) {
-          emit.text("No attestations recorded. Run `harness attest --yes` to create one.");
+          emit.text("No attestations recorded. Run `adapter attest --yes` to create one.");
           return;
         }
         emit.text(
           renderTable(
-            ["HARNESS", "VERSION", "BILLING", "OBSERVED AT", "OBSERVATIONS"],
+            ["ADAPTER", "VERSION", "BILLING", "OBSERVED AT", "OBSERVATIONS"],
             records.map((record) => [
-              record.harness,
+              record.adapter,
               record.binary_version,
               record.subscription_only ? "subscription" : "any",
               record.observed_at,
@@ -181,15 +181,15 @@ export function registerHarnessCommand(program: Command, emit: EmitContext): voi
           ),
         );
       } catch (error) {
-        emit.error({ code: "harness_attestations_failed", message: (error as Error).message });
+        emit.error({ code: "adapter_attestations_failed", message: (error as Error).message });
         emit.setExitCode(1);
       }
     });
 }
 
-export function renderAttestationReport(report: HarnessAttestationReport): string {
+export function renderAttestationReport(report: AdapterAttestationReport): string {
   const rows = report.results.map((result) => [
-    result.harness,
+    result.adapter,
     result.outcome,
     result.binaryVersion ?? "",
     result.observations
@@ -198,14 +198,14 @@ export function renderAttestationReport(report: HarnessAttestationReport): strin
           .join(" ")
       : result.note,
   ]);
-  const table = renderTable(["HARNESS", "OUTCOME", "VERSION", "OBSERVED"], rows);
+  const table = renderTable(["ADAPTER", "OUTCOME", "VERSION", "OBSERVED"], rows);
   const tail = report.incomplete
-    ? "Some harnesses were not attested; their bench rows keep an adapter basis."
-    : "Every selected harness was attested.";
+    ? "Some adapters were not attested; their bench rows keep an adapter basis."
+    : "Every selected adapter was attested.";
   return `${table}\n\nrecorded: ${report.recorded}/${report.results.length}\n${tail}`;
 }
 
-export function renderProfileTable(profiles: readonly HarnessProfile[]): string {
+export function renderProfileTable(profiles: readonly AdapterProfile[]): string {
   const rows = profiles.map((profile) => [
     profile.id,
     profile.binary,
@@ -214,10 +214,10 @@ export function renderProfileTable(profiles: readonly HarnessProfile[]): string
     profile.capabilities.sessionId.support,
     profile.capabilities.cost.support,
   ]);
-  return renderTable(["HARNESS", "BINARY", "MODEL", "EFFORT", "SESSION", "COST"], rows);
+  return renderTable(["ADAPTER", "BINARY", "MODEL", "EFFORT", "SESSION", "COST"], rows);
 }
 
-export function renderProfile(profile: HarnessProfile): string {
+export function renderProfile(profile: AdapterProfile): string {
   const lines = [
     `${profile.displayName} (${profile.id})`,
     `binary: ${profile.binary}`,
@@ -237,9 +237,9 @@ export function renderProfile(profile: HarnessProfile): string {
   return lines.join("\n");
 }
 
-export function renderBenchReport(report: HarnessBenchReport): string {
+export function renderBenchReport(report: AdapterBenchReport): string {
   const rows = report.results.map((result) => [
-    result.harness,
+    result.adapter,
     result.dimension,
     result.declared,
     result.observed,
@@ -247,7 +247,7 @@ export function renderBenchReport(report: HarnessBenchReport): string {
     result.basis,
   ]);
   const table = renderTable(
-    ["HARNESS", "DIMENSION", "DECLARED", "OBSERVED", "VERDICT", "BASIS"],
+    ["ADAPTER", "DIMENSION", "DECLARED", "OBSERVED", "VERDICT", "BASIS"],
     rows,
   );
   const summary = Object.entries(report.summary)