harnery 0.30.0 → 0.31.1

package/dist/core/{harnesses → adapters}/bench.js

@@ -1,7 +1,7 @@
 import { spawnSync } from "node:child_process";
-import { HARNESS_SPECS } from "../hooks/harness/events.js";
+import { ADAPTER_SPECS } from "../hooks/adapter/events.js";
 import { isAttestationCurrent, readAttestation } from "./attestation.js";
-import { HARNESS_CAPABILITY_DIMENSIONS } from "./types.js";
+import { ADAPTER_CAPABILITY_DIMENSIONS } from "./types.js";
 const EMPTY_SUMMARY = {
     supported: 0,
     partial: 0,
@@ -43,17 +43,17 @@ function versionToken(value) {
     const match = value.match(/\d+(?:\.\d+)+(?:[-.][0-9a-z]+)*/i);
     return match ? match[0].toLowerCase() : null;
 }
-export function runHarnessBench(registry, opts = {}) {
-    const ids = opts.harnesses?.length ? [...opts.harnesses] : registry.ids();
+export function runAdapterBench(registry, opts = {}) {
+    const ids = opts.adapters?.length ? [...opts.adapters] : registry.ids();
     const dimensions = opts.dimensions?.length
         ? [...new Set(opts.dimensions)]
-        : [...HARNESS_CAPABILITY_DIMENSIONS];
+        : [...ADAPTER_CAPABILITY_DIMENSIONS];
     const versionProbe = opts.versionProbe ?? probeBinaryVersion;
     const results = [];
     for (const id of ids) {
         const adapter = registry.require(id);
         results.push({
-            harness: id,
+            adapter: id,
             dimension: "registration",
             declared: "supported",
             observed: "supported",
@@ -63,7 +63,7 @@ export function runHarnessBench(registry, opts = {}) {
         });
         const version = versionProbe(adapter.profile.binary);
         results.push({
-            harness: id,
+            adapter: id,
             dimension: "binary",
             declared: "supported",
             observed: version ? "supported" : "skipped",
@@ -84,7 +84,7 @@ export function runHarnessBench(registry, opts = {}) {
                 ? { observed: live, basis: "attested" }
                 : observations[dimension];
             results.push({
-                harness: id,
+                adapter: id,
                 dimension,
                 declared: claim.support,
                 observed,
@@ -103,7 +103,7 @@ export function runHarnessBench(registry, opts = {}) {
     return {
         generatedAt: new Date().toISOString(),
         mode: "offline",
-        harnesses: ids,
+        adapters: ids,
         results,
         summary,
         basisSummary,
@@ -121,7 +121,7 @@ export function runHarnessBench(registry, opts = {}) {
  * inferred from the installed one. */
 function contractResult(id, adapter, version) {
     const recorded = adapter.profile.verified;
-    const base = { harness: id, dimension: "contract", declared: "supported" };
+    const base = { adapter: id, dimension: "contract", declared: "supported" };
     if (!version) {
         return {
             ...base,
@@ -209,8 +209,8 @@ function observeAdapter(adapter) {
     const finalMatches = normalized?.ok === fixture.ok && normalized?.text === fixture.text;
     const sessionObserved = normalized?.sessionId !== undefined ? "supported" : "unsupported";
     const costObserved = normalized?.costUsd !== undefined ? "supported" : "unsupported";
-    const hookSpec = adapter.profile.id in HARNESS_SPECS
-        ? HARNESS_SPECS[adapter.profile.id]
+    const hookSpec = adapter.profile.id in ADAPTER_SPECS
+        ? ADAPTER_SPECS[adapter.profile.id]
         : undefined;
     const hookSubcommands = new Set(hookSpec?.events.map((event) => event.subcommand) ?? []);
     return {

package/dist/core/adapters/index.d.ts

@@ -0,0 +1,13 @@
+export type { Spawner, SpawnRequest, SpawnResult } from "../workflow/types.js";
+export type { AdapterAttestationReport, AdapterAttestationResult, AttestationOutcome, RunAdapterAttestationOptions, } from "./attest.js";
+export { ATTESTATION_PROMPT, runAdapterAttestation } from "./attest.js";
+export type { AdapterAttestation, AttestableDimension, AttestationStoreOptions, } from "./attestation.js";
+export { ATTESTABLE_DIMENSIONS, ATTESTATION_SCHEMA_VERSION, adapterProofInputs, attestationsDir, isAttestationCurrent, listAttestations, profileDigest, readAttestation, validateAttestation, writeAttestation, } from "./attestation.js";
+export type { AdapterBenchOptions, AdapterBenchReport, BenchBasis, BenchDimension, BenchResult, BenchVerdict, } from "./bench.js";
+export { probeBinaryVersion, runAdapterBench } from "./bench.js";
+export type { BuiltinAdapterId } from "./profiles.js";
+export { BUILTIN_ADAPTER_IDS, BUILTIN_ADAPTER_PROFILES, builtinAdapterProfile, isBuiltinAdapter, validateAdapterEffort, } from "./profiles.js";
+export { AdapterRegistry, createBuiltinAdapterRegistry } from "./registry.js";
+export type { Adapter, AdapterBenchFixture, AdapterCapabilities, AdapterCapabilityDimension, AdapterId, AdapterInvocation, AdapterProfile, AdapterRawResult, CapabilityClaim, CapabilitySupport, } from "./types.js";
+export { ADAPTER_CAPABILITY_DIMENSIONS } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EACV,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/adapters/index.js

@@ -0,0 +1,6 @@
+export { ATTESTATION_PROMPT, runAdapterAttestation } from "./attest.js";
+export { ATTESTABLE_DIMENSIONS, ATTESTATION_SCHEMA_VERSION, adapterProofInputs, attestationsDir, isAttestationCurrent, listAttestations, profileDigest, readAttestation, validateAttestation, writeAttestation, } from "./attestation.js";
+export { probeBinaryVersion, runAdapterBench } from "./bench.js";
+export { BUILTIN_ADAPTER_IDS, BUILTIN_ADAPTER_PROFILES, builtinAdapterProfile, isBuiltinAdapter, validateAdapterEffort, } from "./profiles.js";
+export { AdapterRegistry, createBuiltinAdapterRegistry } from "./registry.js";
+export { ADAPTER_CAPABILITY_DIMENSIONS } from "./types.js";

package/dist/core/{harnesses → adapters}/profiles.d.ts

@@ -1,7 +1,7 @@
-import type { HarnessCapabilities, HarnessProfile } from "./types.js";
-/** The one built-in profile catalog. Adding a fourth harness starts here; CLI
+import type { AdapterCapabilities, AdapterProfile } from "./types.js";
+/** The one built-in profile catalog. Adding a fourth adapter starts here; CLI
  * choices, doctor metadata, workflow dispatch, and the bench derive from it. */
-export declare const BUILTIN_HARNESS_PROFILES: {
+export declare const BUILTIN_ADAPTER_PROFILES: {
     readonly "claude-code": {
         readonly id: "claude-code";
         readonly displayName: "Claude Code";
@@ -17,7 +17,7 @@ export declare const BUILTIN_HARNESS_PROFILES: {
             readonly date: "2026-07-25";
             readonly version: "2.1.197 (Claude Code)";
         };
-        readonly capabilities: HarnessCapabilities;
+        readonly capabilities: AdapterCapabilities;
     };
     readonly codex: {
         readonly id: "codex";
@@ -41,7 +41,7 @@ export declare const BUILTIN_HARNESS_PROFILES: {
             };
             readonly writableRoots: true;
         };
-        readonly capabilities: HarnessCapabilities;
+        readonly capabilities: AdapterCapabilities;
     };
     readonly cursor: {
         readonly id: "cursor";
@@ -58,12 +58,12 @@ export declare const BUILTIN_HARNESS_PROFILES: {
             readonly date: "2026-07-25";
             readonly version: "2026.07.23-e383d2b";
         };
-        readonly capabilities: HarnessCapabilities;
+        readonly capabilities: AdapterCapabilities;
     };
 };
-export type BuiltinHarnessId = keyof typeof BUILTIN_HARNESS_PROFILES;
-export declare const BUILTIN_HARNESS_IDS: readonly ("cursor" | "claude-code" | "codex")[];
-export declare function isBuiltinHarness(id: string): id is BuiltinHarnessId;
-export declare function builtinHarnessProfile(id: string): HarnessProfile | undefined;
-export declare function validateHarnessEffort(id: string, effort: string | undefined): void;
+export type BuiltinAdapterId = keyof typeof BUILTIN_ADAPTER_PROFILES;
+export declare const BUILTIN_ADAPTER_IDS: readonly ("claude-code" | "codex" | "cursor")[];
+export declare function isBuiltinAdapter(id: string): id is BuiltinAdapterId;
+export declare function builtinAdapterProfile(id: string): AdapterProfile | undefined;
+export declare function validateAdapterEffort(id: string, effort: string | undefined): void;
 //# sourceMappingURL=profiles.d.ts.map

package/dist/core/adapters/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAgCvF;gFACgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Fc,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AAErE,eAAO,MAAM,mBAAmB,iDAE/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,gBAAgB,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}

package/dist/core/{harnesses → adapters}/profiles.js

@@ -22,13 +22,13 @@ function capabilities(overrides) {
         contextTelemetry: unknown("The workflow adapter does not expose live context usage."),
         preCompactionSignal: unknown("No compaction lifecycle probe has certified this adapter."),
         postCompactionSignal: unknown("No compaction lifecycle probe has certified this adapter."),
-        compaction: unsupported("Harnery does not initiate native harness compaction."),
+        compaction: unsupported("Harnery does not initiate native adapter compaction."),
         ...overrides,
     };
 }
-/** The one built-in profile catalog. Adding a fourth harness starts here; CLI
+/** The one built-in profile catalog. Adding a fourth adapter starts here; CLI
  * choices, doctor metadata, workflow dispatch, and the bench derive from it. */
-export const BUILTIN_HARNESS_PROFILES = {
+export const BUILTIN_ADAPTER_PROFILES = {
     "claude-code": {
         id: "claude-code",
         displayName: "Claude Code",
@@ -104,19 +104,19 @@ export const BUILTIN_HARNESS_PROFILES = {
         }),
     },
 };
-export const BUILTIN_HARNESS_IDS = Object.freeze(Object.keys(BUILTIN_HARNESS_PROFILES));
-export function isBuiltinHarness(id) {
-    return Object.hasOwn(BUILTIN_HARNESS_PROFILES, id);
+export const BUILTIN_ADAPTER_IDS = Object.freeze(Object.keys(BUILTIN_ADAPTER_PROFILES));
+export function isBuiltinAdapter(id) {
+    return Object.hasOwn(BUILTIN_ADAPTER_PROFILES, id);
 }
-export function builtinHarnessProfile(id) {
-    return isBuiltinHarness(id) ? BUILTIN_HARNESS_PROFILES[id] : undefined;
+export function builtinAdapterProfile(id) {
+    return isBuiltinAdapter(id) ? BUILTIN_ADAPTER_PROFILES[id] : undefined;
 }
-export function validateHarnessEffort(id, effort) {
+export function validateAdapterEffort(id, effort) {
     if (!effort)
         return;
-    const profile = builtinHarnessProfile(id);
+    const profile = builtinAdapterProfile(id);
     if (!profile)
-        throw new Error(`unknown harness ${JSON.stringify(id)}`);
+        throw new Error(`unknown adapter ${JSON.stringify(id)}`);
     if (!profile.effortValues.includes(effort)) {
         const supportedValues = profile.effortValues.length ? profile.effortValues.join(", ") : "none";
         throw new Error(`effort ${JSON.stringify(effort)} is not supported by ${id}; supported values: ${supportedValues}`);

package/dist/core/adapters/registry.d.ts

@@ -0,0 +1,15 @@
+import type { Adapter, AdapterId } from "./types.js";
+/** Mutable registry for embedders, initialized empty unless adapters are
+ * provided. Duplicate ids fail loud instead of silently replacing behavior. */
+export declare class AdapterRegistry {
+    #private;
+    constructor(adapters?: Iterable<Adapter>);
+    register(adapter: Adapter): this;
+    get(id: AdapterId): Adapter | undefined;
+    require(id: AdapterId): Adapter;
+    list(): Adapter[];
+    ids(): AdapterId[];
+    spawners(): Record<AdapterId, Adapter["spawn"]>;
+}
+export declare function createBuiltinAdapterRegistry(): AdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/registry.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqErD;+EAC+E;AAC/E,qBAAa,eAAe;;gBAGd,QAAQ,GAAE,QAAQ,CAAC,OAAO,CAAM;IAI5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYhC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;IAIvC,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAU/B,IAAI,IAAI,OAAO,EAAE;IAIjB,GAAG,IAAI,SAAS,EAAE;IAIlB,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAGhD;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D"}

package/dist/core/{harnesses → adapters}/registry.js

@@ -1,10 +1,10 @@
 import { buildClaudeInvocation, claudeCodeSpawner, normalizeClaudeResult, } from "../workflow/spawn-claude.js";
 import { buildCodexInvocation, codexSpawner, normalizeCodexResult, } from "../workflow/spawn-codex.js";
 import { buildCursorInvocation, cursorSpawner, normalizeCursorResult, } from "../workflow/spawn-cursor.js";
-import { BUILTIN_HARNESS_IDS, BUILTIN_HARNESS_PROFILES, } from "./profiles.js";
+import { BUILTIN_ADAPTER_IDS, BUILTIN_ADAPTER_PROFILES, } from "./profiles.js";
 const BUILTIN_ADAPTERS = {
     "claude-code": {
-        profile: BUILTIN_HARNESS_PROFILES["claude-code"],
+        profile: BUILTIN_ADAPTER_PROFILES["claude-code"],
         spawn: claudeCodeSpawner,
         buildInvocation: buildClaudeInvocation,
         normalizeResult: normalizeClaudeResult,
@@ -29,7 +29,7 @@ const BUILTIN_ADAPTERS = {
         },
     },
     codex: {
-        profile: BUILTIN_HARNESS_PROFILES.codex,
+        profile: BUILTIN_ADAPTER_PROFILES.codex,
         spawn: codexSpawner,
         buildInvocation: buildCodexInvocation,
         normalizeResult: normalizeCodexResult,
@@ -45,7 +45,7 @@ const BUILTIN_ADAPTERS = {
         },
     },
     cursor: {
-        profile: BUILTIN_HARNESS_PROFILES.cursor,
+        profile: BUILTIN_ADAPTER_PROFILES.cursor,
         spawn: cursorSpawner,
         buildInvocation: buildCursorInvocation,
         normalizeResult: normalizeCursorResult,
@@ -70,7 +70,7 @@ const BUILTIN_ADAPTERS = {
 };
 /** Mutable registry for embedders, initialized empty unless adapters are
  * provided. Duplicate ids fail loud instead of silently replacing behavior. */
-export class HarnessRegistry {
+export class AdapterRegistry {
     #adapters = new Map();
     constructor(adapters = []) {
         for (const adapter of adapters)
@@ -79,11 +79,11 @@ export class HarnessRegistry {
     register(adapter) {
         const id = adapter.profile.id.trim();
         if (!id)
-            throw new Error("harness adapter id cannot be empty");
+            throw new Error("adapter adapter id cannot be empty");
         if (this.#adapters.has(id))
-            throw new Error(`harness adapter ${JSON.stringify(id)} is already registered`);
+            throw new Error(`adapter adapter ${JSON.stringify(id)} is already registered`);
         if (adapter.profile.binary.trim() === "") {
-            throw new Error(`harness adapter ${JSON.stringify(id)} has no binary`);
+            throw new Error(`adapter adapter ${JSON.stringify(id)} has no binary`);
         }
         this.#adapters.set(id, adapter);
         return this;
@@ -94,7 +94,7 @@ export class HarnessRegistry {
     require(id) {
         const adapter = this.get(id);
         if (!adapter) {
-            throw new Error(`unknown harness ${JSON.stringify(id)} (registered: ${this.ids().join(", ") || "none"})`);
+            throw new Error(`unknown adapter ${JSON.stringify(id)} (registered: ${this.ids().join(", ") || "none"})`);
         }
         return adapter;
     }
@@ -108,6 +108,6 @@ export class HarnessRegistry {
         return Object.fromEntries(this.list().map((adapter) => [adapter.profile.id, adapter.spawn]));
     }
 }
-export function createBuiltinHarnessRegistry() {
-    return new HarnessRegistry(BUILTIN_HARNESS_IDS.map((id) => BUILTIN_ADAPTERS[id]));
+export function createBuiltinAdapterRegistry() {
+    return new AdapterRegistry(BUILTIN_ADAPTER_IDS.map((id) => BUILTIN_ADAPTERS[id]));
 }

package/dist/core/{harnesses → adapters}/types.d.ts

@@ -1,29 +1,29 @@
 import type { Spawner, SpawnRequest, SpawnResult } from "../workflow/types.js";
-/** Open harness identifier. Built-ins are registered at runtime rather than
+/** Open adapter identifier. Built-ins are registered at runtime rather than
  * repeated through closed unions in every consumer. */
-export type HarnessId = string;
+export type AdapterId = string;
 export type CapabilitySupport = "supported" | "partial" | "unsupported" | "unknown";
-export declare const HARNESS_CAPABILITY_DIMENSIONS: readonly ["invocation", "modelSelection", "effortSelection", "maxTurns", "finalResult", "sessionId", "cost", "toolEvidence", "policyMapping", "filesystemPolicyProjection", "interruption", "streaming", "steering", "resume", "images", "contextTelemetry", "preCompactionSignal", "postCompactionSignal", "compaction"];
-export type HarnessCapabilityDimension = (typeof HARNESS_CAPABILITY_DIMENSIONS)[number];
+export declare const ADAPTER_CAPABILITY_DIMENSIONS: readonly ["invocation", "modelSelection", "effortSelection", "maxTurns", "finalResult", "sessionId", "cost", "toolEvidence", "policyMapping", "filesystemPolicyProjection", "interruption", "streaming", "steering", "resume", "images", "contextTelemetry", "preCompactionSignal", "postCompactionSignal", "compaction"];
+export type AdapterCapabilityDimension = (typeof ADAPTER_CAPABILITY_DIMENSIONS)[number];
 export interface CapabilityClaim {
     support: CapabilitySupport;
     /** Operational qualification. Required for partial/unknown claims and useful
      * whenever "supported" has a narrower meaning than the vendor CLI itself. */
     note?: string;
 }
-export type HarnessCapabilities = Record<HarnessCapabilityDimension, CapabilityClaim>;
-/** What one harness can represent of a filesystem-policy projection
- * (ADR 0039). `null` means the harness does not distinguish that, which is a
- * fact about the harness rather than something to paper over: a projection the
+export type AdapterCapabilities = Record<AdapterCapabilityDimension, CapabilityClaim>;
+/** What one adapter can represent of a filesystem-policy projection
+ * (ADR 0039). `null` means the adapter does not distinguish that, which is a
+ * fact about the adapter rather than something to paper over: a projection the
  * adapter would silently drop must be refused instead. */
-export interface HarnessSandboxProjection {
+export interface AdapterSandboxProjection {
     /** Native representation per canonical mode, or null when unrepresentable. */
     modes: Record<"read-only" | "workspace-write", string | null>;
-    /** Whether the harness accepts an explicit writable-root set. */
+    /** Whether the adapter accepts an explicit writable-root set. */
     writableRoots: boolean;
 }
-export interface HarnessProfile {
-    id: HarnessId;
+export interface AdapterProfile {
+    id: AdapterId;
     displayName: string;
     binary: string;
     installHint: string;
@@ -33,7 +33,7 @@ export interface HarnessProfile {
     authModel: "own-auth";
     modelFamily: "claude" | "gpt" | "multi";
     effortValues: readonly string[];
-    capabilities: HarnessCapabilities;
+    capabilities: AdapterCapabilities;
     /** The last real vendor CLI contract used to validate this declaration. */
     verified?: {
         date: string;
@@ -41,16 +41,16 @@ export interface HarnessProfile {
     };
     /** How this adapter projects host filesystem policy into the vendor's own
      * sandbox (ADR 0039). Absent means it cannot project any of it. */
-    sandboxProjection?: HarnessSandboxProjection;
+    sandboxProjection?: AdapterSandboxProjection;
 }
 /** Fully planned child invocation. `resultFile` is used by adapters such as
  * Codex that deliver the authoritative final answer out-of-band. */
-export interface HarnessInvocation {
+export interface AdapterInvocation {
     argv: string[];
     resultFile?: string;
 }
 /** Vendor subprocess material passed through an adapter's normalizer. */
-export interface HarnessRawResult {
+export interface AdapterRawResult {
     stdout: string;
     stderr: string;
     exitCode: number;
@@ -67,8 +67,8 @@ export interface HarnessRawResult {
      * (run never started) rather than a work failure. Absent on ordinary exit. */
     spawnErrno?: string;
 }
-export interface HarnessBenchFixture {
-    raw: HarnessRawResult;
+export interface AdapterBenchFixture {
+    raw: AdapterRawResult;
     expected: Pick<SpawnResult, "ok" | "text"> & {
         sessionId?: string;
         costUsd?: number;
@@ -77,11 +77,11 @@ export interface HarnessBenchFixture {
 /** One registered executable adapter. The same planner and normalizer power
  * production workflow runs and the offline conformance bench, preventing the
  * bench from testing a parallel mock implementation. */
-export interface HarnessAdapter {
-    profile: HarnessProfile;
+export interface Adapter {
+    profile: AdapterProfile;
     spawn: Spawner;
-    buildInvocation: (request: SpawnRequest, resultFile?: string) => HarnessInvocation;
-    normalizeResult: (raw: HarnessRawResult) => SpawnResult;
-    fixture: HarnessBenchFixture;
+    buildInvocation: (request: SpawnRequest, resultFile?: string) => AdapterInvocation;
+    normalizeResult: (raw: AdapterRawResult) => SpawnResult;
+    fixture: AdapterBenchFixture;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/E;uDACuD;AACvD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAEpF,eAAO,MAAM,6BAA6B,2TAoBhC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAC3B;iFAC6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;AAEtF;;;0DAG0D;AAC1D,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC,WAAW,GAAG,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9D,iEAAiE;IACjE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACxC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;uEACmE;IACnE,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC9C;AAED;oEACoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;0BAGsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;kFAG8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;wDAEwD;AACxD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACnF,eAAe,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,WAAW,CAAC;IACxD,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}

package/dist/core/{harnesses → adapters}/types.js

@@ -1,4 +1,4 @@
-export const HARNESS_CAPABILITY_DIMENSIONS = [
+export const ADAPTER_CAPABILITY_DIMENSIONS = [
     "invocation",
     "modelSelection",
     "effortSelection",

package/dist/core/agents/canonical-emit.d.ts

@@ -1,6 +1,6 @@
 /**
  * Emit canonical events by spawning `agent-coord emit-event`. Used by every
- * `agents …` / `scratch` / `presence` write that has a canonical state event.
+ * `agents …` / `journal` / `presence` write that has a canonical state event.
  *
  * Soft-fails: never throws into the caller. A failed emit logs to stderr
  * (visible to operators in their terminal) but never breaks the CLI flow.
@@ -12,7 +12,7 @@ export interface CanonicalEmitInput {
     type: string;
     owner: string;
     session: string;
-    harness: "claude-code" | "cursor" | "codex";
+    adapter: "claude-code" | "cursor" | "codex";
     data: Record<string, unknown>;
     turnId?: string;
     parentSessionId?: string;
@@ -21,22 +21,17 @@ export interface CanonicalEmitInput {
 /**
  * Resolve the coord root for a canonical emit.
  *
- * Order: explicit `HARNERY_COORD_ROOT_OVERRIDE` → git-superproject-aware
- * `monorepoRoot()` (must actually carry `.harnery/`) → cwd walk (non-git
- * hosts). The git-aware step is load-bearing: a shell cd'd into a nested
- * directory that carries its own `.harnery/` (e.g. an embedded harnery
- * checkout) made the old cwd-walk resolve the NESTED root, from which
- * `<root>/harnery/bin/agent-coord` doesn't exist — so `agents status` /
- * `set-task` emits silently vanished and the Stop-hook's rule 1/3
- * (`state.status_checked` in-turn) blocked turns that had done the ritual.
- * Same bug class as the coordHelperOpts root-pin fix; this closes the
- * emitCanonical instance of it.
+ * Delegates to `resolveCoordRoot()`, the single resolution the hooks and the
+ * CLI's reads also use. An emit resolved any other way is an emit the Stop hook
+ * cannot see: the hook reads `state.status_checked` from the stream under ITS
+ * root, so a divergent emit root blocks rule 1/3 on a turn that did run
+ * `agents status`, and no sequence of CLI commands can satisfy it.
  */
 export declare function resolveEmitRoot(start?: string): string | null;
 export declare function emitCanonical(input: CanonicalEmitInput): void;
 /**
  * Normalize the heartbeat's `platform` field (which uses snake_case
- * `claude_code`) to the canonical kebab-case Harness type.
+ * `claude_code`) to the canonical kebab-case Adapter type.
  */
-export declare function normalizeHarness(platform: string | undefined): "claude-code" | "cursor" | "codex";
+export declare function normalizeAdapter(platform: string | undefined): "claude-code" | "cursor" | "codex";
 //# sourceMappingURL=canonical-emit.d.ts.map

package/dist/core/agents/canonical-emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAW5E;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAsC7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG"}
+{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAsC7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG"}

package/dist/core/agents/canonical-emit.js

@@ -1,6 +1,6 @@
 /**
  * Emit canonical events by spawning `agent-coord emit-event`. Used by every
- * `agents …` / `scratch` / `presence` write that has a canonical state event.
+ * `agents …` / `journal` / `presence` write that has a canonical state event.
  *
  * Soft-fails: never throws into the caller. A failed emit logs to stderr
  * (visible to operators in their terminal) but never breaks the CLI flow.
@@ -9,44 +9,26 @@
  * latency budget per call.
  */
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { monorepoRoot } from "./coord-client.js";
+import { coordBinPath } from "./coord-bin.js";
+import { resolveCoordRoot } from "./coord-client.js";
 /**
  * Resolve the coord root for a canonical emit.
  *
- * Order: explicit `HARNERY_COORD_ROOT_OVERRIDE` → git-superproject-aware
- * `monorepoRoot()` (must actually carry `.harnery/`) → cwd walk (non-git
- * hosts). The git-aware step is load-bearing: a shell cd'd into a nested
- * directory that carries its own `.harnery/` (e.g. an embedded harnery
- * checkout) made the old cwd-walk resolve the NESTED root, from which
- * `<root>/harnery/bin/agent-coord` doesn't exist — so `agents status` /
- * `set-task` emits silently vanished and the Stop-hook's rule 1/3
- * (`state.status_checked` in-turn) blocked turns that had done the ritual.
- * Same bug class as the coordHelperOpts root-pin fix; this closes the
- * emitCanonical instance of it.
+ * Delegates to `resolveCoordRoot()`, the single resolution the hooks and the
+ * CLI's reads also use. An emit resolved any other way is an emit the Stop hook
+ * cannot see: the hook reads `state.status_checked` from the stream under ITS
+ * root, so a divergent emit root blocks rule 1/3 on a turn that did run
+ * `agents status`, and no sequence of CLI commands can satisfy it.
  */
 export function resolveEmitRoot(start = process.cwd()) {
-    const override = process.env.HARNERY_COORD_ROOT_OVERRIDE;
-    if (override)
-        return override;
-    // Memoized per start-dir: the session-tee middleware resolves once per
-    // emitted event, and monorepoRoot() spawns git — cache so a streaming
-    // command doesn't pay 1-3 subprocess spawns per output line.
-    if (cachedRoot && cachedRoot.start === start)
-        return cachedRoot.root;
-    const gitRoot = monorepoRoot();
-    const root = gitRoot && existsSync(join(gitRoot, ".harnery")) ? gitRoot : findRepoRoot(start);
-    cachedRoot = { start, root };
-    return root;
+    return resolveCoordRoot(start);
 }
-let cachedRoot;
 export function emitCanonical(input) {
     const root = resolveEmitRoot();
     if (!root)
         return;
-    const binary = resolve(root, "harnery", "bin", "agent-coord");
-    if (!existsSync(binary))
+    const binary = coordBinPath("agent-coord", root);
+    if (!binary)
         return;
     try {
         const args = [
@@ -57,8 +39,8 @@ export function emitCanonical(input) {
             input.owner,
             "--session",
             input.session,
-            "--harness",
-            input.harness,
+            "--adapter",
+            input.adapter,
             "--data-json",
             JSON.stringify(input.data),
         ];
@@ -88,23 +70,12 @@ export function emitCanonical(input) {
 }
 /**
  * Normalize the heartbeat's `platform` field (which uses snake_case
- * `claude_code`) to the canonical kebab-case Harness type.
+ * `claude_code`) to the canonical kebab-case Adapter type.
  */
-export function normalizeHarness(platform) {
+export function normalizeAdapter(platform) {
     if (platform === "cursor")
         return "cursor";
     if (platform === "codex")
         return "codex";
     return "claude-code";
 }
-function findRepoRoot(start) {
-    let dir = resolve(start);
-    while (true) {
-        if (existsSync(join(dir, ".harnery")))
-            return dir;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}

package/dist/core/agents/cli-emit.js

@@ -38,7 +38,7 @@ export function emitAndProject(input, opts = {}) {
                         parent_session_id: envelope.parent_session_id,
                         turn_id: envelope.turn_id,
                         parent_turn_id: envelope.parent_turn_id,
-                        harness: envelope.harness,
+                        adapter: envelope.adapter,
                         source: envelope.source,
                         data: envelope.data,
                     },