harnery 0.29.0 → 0.31.0

package/dist/lib/instructions/templates.js

@@ -10,12 +10,19 @@
  * files), so they compile into `dist/` and resolve identically under Bun and
  * Node — no `files`-field copy or package-path guesswork.
  */
-import { SCRATCH_CATEGORIES } from "../../core/scratch/index.js";
+import { JOURNAL_CATEGORIES } from "../../core/journal/index.js";
 import { buildOwnedSkill } from "./splice.js";
 /** Managed-region name for the AGENTS.md orientation block. */
 export const INSTRUCTIONS_REGION = "instructions";
 /** Managed-region name for the CLAUDE.md `@AGENTS.md` import shim. */
 export const IMPORT_REGION = "import";
+/**
+ * Managed-region name for the consumer's own coordination policy, spliced from
+ * the file named by `instructions.hostAddendumFile`. Harnery places and
+ * versions the region; the content is the host's and is never rendered here.
+ * See `host-addendum.ts`.
+ */
+export const HOST_ADDENDUM_REGION = "host-addendum";
 /**
  * The always-on orientation spliced into `AGENTS.md`. Target ≤ 80 rendered
  * lines: it costs every agent context on every turn, so it states that each
@@ -24,7 +31,7 @@ export const IMPORT_REGION = "import";
  * `harn-council`) even for a renamed bin; only command strings track `binName`.
  *
  * The block only points at a skill that actually exists here: a host that
- * excludes one via `skills.exclude`, or a harness with no skill primitive
+ * excludes one via `skills.exclude`, or a adapter with no skill primitive
  * (cursor/codex get the block but no skill files), gets a `--help` pointer
  * instead of a dangling reference to a skill it doesn't have.
  */
@@ -33,24 +40,25 @@ export function renderInstructionsBlock(binName, skills = { decide: true, counci
     const named = [skills.decide && "`harn-decide`", skills.council && "`harn-council`"].filter(Boolean);
     const deeper = named.length > 0
         ? `Procedures for the deeper flows live in the ${named.join(" and ")} skill${named.length > 1 ? "s" : ""}.`
-        : `See \`${b} decision --help\` and \`${b} council --help\` for the deeper procedures.`;
+        : `See \`${b} decision --help\` and \`${b} agents council --help\` for the deeper procedures.`;
     const decidePointer = skills.decide
         ? "The `harn-decide` skill has the file / claim / resolve-with-evidence procedure."
         : `See \`${b} decision --help\` for the file / claim / resolve-with-evidence procedure.`;
     const councilPointer = skills.council
         ? "The `harn-council` skill has the steward and member flow."
-        : `See \`${b} council --help\` for the steward and member flow.`;
-    // Render the scratch categories from the canonical enum so this prose can
-    // never drift from what `scratch add` actually accepts (the "note, plan…" list
+        : `See \`${b} agents council --help\` for the steward and member flow.`;
+    // Render the journal categories from the canonical enum so this prose can
+    // never drift from what `journal add` actually accepts (the "note, plan…" list
     // silently lagged the tool by two categories before this).
-    const scratchCats = SCRATCH_CATEGORIES.length > 1
-        ? `${SCRATCH_CATEGORIES.slice(0, -1).join(", ")}, or ${SCRATCH_CATEGORIES.at(-1)}`
-        : SCRATCH_CATEGORIES[0];
+    const journalCats = JOURNAL_CATEGORIES.length > 1
+        ? `${JOURNAL_CATEGORIES.slice(0, -1).join(", ")}, or ${JOURNAL_CATEGORIES.at(-1)}`
+        : JOURNAL_CATEGORIES[0];
     return `## harnery coordination
 
 This project runs [harnery](https://harnery.com) for multi-agent coordination.
 You share this checkout with other agents; the surfaces below keep you oriented
-and out of each other's way. Run \`${b} <command> --help\` for any command's full
+and out of each other's way, and let you dispatch a team of your own when a job
+is bigger than one session. Run \`${b} <command> --help\` for any command's full
 surface. ${deeper}
 
 **Identity + peers.** You are one of several agents in this repo.
@@ -59,6 +67,20 @@ active peers and the files they've claimed; \`${b} agents set-task "<focus>"\`
 declares your current focus so peers can see it. Check for peers before editing
 widely-shared files.
 
+**Dispatching a team.** Everything else here coordinates the agents already
+present. These three start new ones, and they differ by how long the objective
+outlives a single execution. \`${b} run <script>\` is one bounded pass:
+plain JS stages fan out to headless subagents that are born
+coordination-registered, with deterministic code deciding the routing between
+stages. \`${b} work create <title> <workflow>\` wraps an objective that has to
+survive many such passes, holding it across retries, failures, and review.
+\`${b} governor create\` drives a whole graph of work toward a goal, choosing
+what runs next and how much it may settle without asking a human. Reach for the
+first when one pass will do, the second when the objective must outlive the
+attempt, and the third when a human would otherwise have to babysit the loop. A
+run that needs authorization parks durably instead of failing, so check
+\`${b} approval list\` when one appears to be waiting rather than stuck.
+
 **Durable role handoff.** When you are replacing a prior session in the same
 named role, run \`${b} agents identity assume <name>\` before declaring your task.
 It reclaims an abandoned namesake (no live process) and refuses only when another
@@ -70,11 +92,18 @@ coordination ledger. Lead a shell command with a \`# intent: <why>\` comment (or
 the tool's description) so the recorded event carries a reason instead of
 \`(no intent)\`.
 
-**Scratch journal.** \`${b} scratch add <category> "<text>"\` (category = ${scratchCats})
+**Journal.** \`${b} journal add <category> "<text>"\` (category = ${journalCats})
 leaves breadcrumbs that survive context compaction;
-\`${b} scratch read\` reads yours, \`${b} scratch read --name <peer>\` reads a peer's.
+\`${b} journal read\` reads yours, \`${b} journal read --name <peer>\` reads a peer's.
 Use it for anything future-you or a peer will need to pick up your thread.
 
+**Working artifacts.** For screenshots, exports, audit dumps, rollback inputs,
+and other untracked files that must survive a session, create a managed workspace
+with \`${b} artifacts create <slug> --purpose "<why>"\`. Write files under the
+returned path, then run \`${b} artifacts release <id>\` when active work is done.
+Do not create a repo-root temp directory; \`${b} artifacts clean\` previews
+expired cleanup and requires \`--yes\` to delete anything.
+
 **Decision docket.** When you would otherwise stop to ask a human a decision you
 can't resolve from the repo, file it instead. \`${b} decision file "<question>"\`
 records it and lets you proceed on a stated default; \`${b} decision search "<terms>"\`

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.29.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)