harnery 0.30.0 → 0.31.1

package/dist/core/{supervisor → governor}/runner.js

@@ -1,15 +1,15 @@
 import { resolve } from "node:path";
 import { acceptWorkItem, reconcileWorkItem, runWorkItem, } from "../work/index.js";
-import { runSupervisorPlanner } from "./planning.js";
-import { acquireSupervisorLease, readSupervisorIgnoringLease, } from "./state.js";
-export async function runSupervisor(input) {
+import { runGovernorPlanner } from "./planning.js";
+import { acquireGovernorLease, readGovernorIgnoringLease, } from "./state.js";
+export async function runGovernor(input) {
     const coordRoot = resolve(input.coordRoot);
     const mode = input.mode ?? "run";
-    const actor = input.actor?.trim() || `supervisor:${input.goalId}`;
+    const actor = input.actor?.trim() || `governor:${input.goalId}`;
     const log = input.onLog ?? (() => undefined);
     const startedAt = new Date().toISOString();
     const startedMs = Date.now();
-    const release = acquireSupervisorLease(coordRoot, input.goalId);
+    const release = acquireGovernorLease(coordRoot, input.goalId);
     let cycles = 0;
     let dispatches = 0;
     let acceptances = 0;
@@ -17,7 +17,7 @@ export async function runSupervisor(input) {
     const outcomes = [];
     const planOutcomes = [];
     try {
-        const initial = readSupervisorIgnoringLease(coordRoot, input.goalId);
+        const initial = readGovernorIgnoringLease(coordRoot, input.goalId);
         const cycleLimit = mode === "tick" ? 1 : initial.intent.limits.max_cycles;
         const deadline = startedMs + initial.intent.limits.max_runtime_ms;
         while (cycles < cycleLimit) {
@@ -29,7 +29,7 @@ export async function runSupervisor(input) {
                 return report("succeeded", record.projection.reason, record);
             }
             if (Date.now() >= deadline) {
-                return report("budget_exhausted", "supervisor wall-time limit reached", record);
+                return report("budget_exhausted", "governor wall-time limit reached", record);
             }
             const before = graphFingerprint(record);
             let changed = false;
@@ -37,7 +37,7 @@ export async function runSupervisor(input) {
                 record.projection.next_action === "plan_initial" ||
                 record.projection.next_action === "plan_milestone") {
                 log(`[${record.intent.title}] ${record.projection.next_action} at graph generation ${record.projection.plan_generation}`);
-                const plan = await runSupervisorPlanner({
+                const plan = await runGovernorPlanner({
                     coordRoot,
                     record,
                     engine: input.engine,
@@ -64,7 +64,7 @@ export async function runSupervisor(input) {
                         continue;
                     acceptWorkItem(coordRoot, work.intent.id, {
                         actor,
-                        reason: "passing proof accepted by frozen supervisor policy",
+                        reason: "passing proof accepted by frozen governor policy",
                     });
                     acceptances++;
                     changed = true;
@@ -124,10 +124,10 @@ export async function runSupervisor(input) {
             if (mode === "tick") {
                 return report(before === after ? "no_progress" : "tick_complete", before === after
                     ? "the tick found no legal progress action"
-                    : "one bounded supervisor cycle completed", record);
+                    : "one bounded governor cycle completed", record);
             }
             if (Date.now() >= deadline) {
-                return report("budget_exhausted", "supervisor wall-time limit reached", record);
+                return report("budget_exhausted", "governor wall-time limit reached", record);
             }
             if (record.projection.state === "budget_exhausted") {
                 return report("budget_exhausted", record.projection.reason, record);
@@ -139,11 +139,11 @@ export async function runSupervisor(input) {
                 return report(stopForProjection(record.projection), record.projection.reason, record);
             }
             if (before === after) {
-                return report("no_progress", "a supervisor cycle produced no durable state change", record);
+                return report("no_progress", "a governor cycle produced no durable state change", record);
             }
         }
         const final = refreshGraph(coordRoot, input.goalId, actor);
-        return report("budget_exhausted", `supervisor cycle limit reached (${cycleLimit})`, final);
+        return report("budget_exhausted", `governor cycle limit reached (${cycleLimit})`, final);
     }
     finally {
         release();
@@ -169,10 +169,10 @@ export async function runSupervisor(input) {
     }
 }
 function refreshGraph(coordRoot, goalId, actor) {
-    const before = readSupervisorIgnoringLease(coordRoot, goalId);
+    const before = readGovernorIgnoringLease(coordRoot, goalId);
     for (const work of before.work)
         reconcileWorkItem(coordRoot, work.intent.id, actor);
-    return readSupervisorIgnoringLease(coordRoot, goalId);
+    return readGovernorIgnoringLease(coordRoot, goalId);
 }
 function selectCandidates(record) {
     const candidates = [];

package/dist/core/governor/service-read.d.ts

@@ -0,0 +1,6 @@
+import type { GovernorServiceConfig, GovernorServiceRuntime, GovernorServiceStatus } from "./service.js";
+export declare function readGovernorServiceConfig(coordRootRaw: string): GovernorServiceConfig;
+export declare function readGovernorServiceRuntime(coordRootRaw: string): GovernorServiceRuntime | undefined;
+export declare function readGovernorServiceStatus(coordRootRaw: string): GovernorServiceStatus;
+export declare function governorServiceLogPath(coordRoot: string): string;
+//# sourceMappingURL=service-read.d.ts.map

package/dist/core/governor/service-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-read.d.ts","sourceRoot":"","sources":["../../../src/core/governor/service-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAMtB,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CA0BrF;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,sBAAsB,GAAG,SAAS,CAgBpC;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAkBrF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/core/{supervisor → governor}/service-read.js

@@ -4,9 +4,9 @@ import { join, resolve } from "node:path";
 const MAX_FILE_BYTES = 512 * 1024;
 const MAX_GOALS = 100;
 const FOREIGN_STATUS_STALE_MS = 30_000;
-export function readSupervisorServiceConfig(coordRootRaw) {
+export function readGovernorServiceConfig(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
-    const config = readBoundedJson(join(serviceDir(coordRoot), "config.json"), "supervisor service configuration");
+    const config = readBoundedJson(join(serviceDir(coordRoot), "config.json"), "governor service configuration");
     if (config.schema_version !== 1 ||
         !validTimestamp(config.created_at) ||
         !Array.isArray(config.goal_ids) ||
@@ -22,39 +22,39 @@ export function readSupervisorServiceConfig(coordRootRaw) {
         typeof config.engine !== "object" ||
         typeof config.engine.subscription_only !== "boolean" ||
         typeof config.engine.allow_api_billing !== "boolean") {
-        throw new Error("supervisor service configuration has an unsupported schema");
+        throw new Error("governor service configuration has an unsupported schema");
     }
     return config;
 }
-export function readSupervisorServiceRuntime(coordRootRaw) {
+export function readGovernorServiceRuntime(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     const path = join(serviceDir(coordRoot), "runtime.json");
     if (!existsSync(path))
         return undefined;
-    const runtime = readBoundedJson(path, "supervisor service runtime");
+    const runtime = readBoundedJson(path, "governor service runtime");
     if (runtime.schema_version !== 1 ||
         !validTimestamp(runtime.config_created_at) ||
         !validTimestamp(runtime.updated_at) ||
         !runtime.goals ||
         typeof runtime.goals !== "object" ||
         Array.isArray(runtime.goals)) {
-        throw new Error("supervisor service runtime has an unsupported schema");
+        throw new Error("governor service runtime has an unsupported schema");
     }
     return runtime;
 }
-export function readSupervisorServiceStatus(coordRootRaw) {
+export function readGovernorServiceStatus(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     const record = readStatusRecord(coordRoot);
     let config;
     let runtime;
     try {
-        config = readSupervisorServiceConfig(coordRoot);
+        config = readGovernorServiceConfig(coordRoot);
     }
     catch {
         // Unconfigured or corrupt service state is represented without throwing.
     }
     try {
-        runtime = readSupervisorServiceRuntime(coordRoot);
+        runtime = readGovernorServiceRuntime(coordRoot);
     }
     catch {
         // Runtime is recoverable and must not make the dashboard unreadable.
@@ -64,7 +64,7 @@ export function readSupervisorServiceStatus(coordRootRaw) {
     const running = statusOwnerIsLive(record);
     return { running, stale: !running && record.state !== "stopped", record, config, runtime };
 }
-export function supervisorServiceLogPath(coordRoot) {
+export function governorServiceLogPath(coordRoot) {
     return join(serviceDir(resolve(coordRoot)), "service.log");
 }
 function readStatusRecord(coordRoot) {
@@ -72,7 +72,7 @@ function readStatusRecord(coordRoot) {
     if (!existsSync(path))
         return undefined;
     try {
-        const value = readBoundedJson(path, "supervisor service status");
+        const value = readBoundedJson(path, "governor service status");
         if (value.schema_version !== 1 ||
             !Number.isSafeInteger(value.pid) ||
             value.pid < 1 ||
@@ -117,7 +117,7 @@ function readBoundedJson(path, label) {
     }
 }
 function serviceDir(coordRoot) {
-    return join(coordRoot, ".harnery", "supervisor-service");
+    return join(coordRoot, ".harnery", "governor-service");
 }
 function positive(value) {
     return Number.isSafeInteger(value) && value > 0;

package/dist/core/governor/service.d.ts

@@ -0,0 +1,114 @@
+import { type NormalizedPolicy, type PolicyIsolation } from "../policy/index.js";
+import type { RunWorkItemInput } from "../work/index.js";
+import { type GovernorRunReport, type GovernorStopReason } from "./runner.js";
+import { type GovernorRecord } from "./state.js";
+export declare const GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION: 1;
+export declare const GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION: 1;
+export declare const GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION: 1;
+export interface GovernorServiceEngineConfig {
+    default_adapter?: string;
+    cwd?: string;
+    subscription_only: boolean;
+    allow_api_billing: boolean;
+    policy?: NormalizedPolicy;
+    isolation?: PolicyIsolation;
+    approval_addressee?: string;
+}
+export interface GovernorServiceConfig {
+    schema_version: typeof GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION;
+    goal_ids: string[];
+    wake_interval_ms: number;
+    heartbeat_interval_ms: number;
+    error_backoff_base_ms: number;
+    error_backoff_max_ms: number;
+    engine: GovernorServiceEngineConfig;
+    created_at: string;
+}
+export interface ConfigureGovernorServiceInput {
+    coordRoot: string;
+    goalIds: readonly string[];
+    wakeIntervalMs?: number;
+    heartbeatIntervalMs?: number;
+    errorBackoffBaseMs?: number;
+    errorBackoffMaxMs?: number;
+    engine?: Partial<GovernorServiceEngineConfig>;
+}
+export type GovernorServiceGoalState = "idle" | "backoff" | "awaiting_change";
+export interface GovernorServiceGoalRuntime {
+    state: GovernorServiceGoalState;
+    consecutive_errors: number;
+    observed_fingerprint?: string;
+    next_wake_at?: string;
+    last_tick_at?: string;
+    last_stop_reason?: GovernorStopReason;
+    last_error?: string;
+}
+export interface GovernorServiceRuntime {
+    schema_version: typeof GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION;
+    config_created_at: string;
+    updated_at: string;
+    goals: Record<string, GovernorServiceGoalRuntime>;
+}
+export type GovernorServiceProcessState = "starting" | "running" | "stopping" | "stopped";
+export interface GovernorServiceStatusRecord {
+    schema_version: typeof GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION;
+    pid: number;
+    host: string;
+    nonce: string;
+    state: GovernorServiceProcessState;
+    started_at: string;
+    heartbeat_at: string;
+    config_created_at: string;
+    sweep_count: number;
+    active_goal_id?: string;
+    last_sweep_at?: string;
+    next_wake_at?: string;
+    last_error?: string;
+    stopped_at?: string;
+}
+export interface GovernorServiceStatus {
+    running: boolean;
+    stale: boolean;
+    record?: GovernorServiceStatusRecord;
+    config?: GovernorServiceConfig;
+    runtime?: GovernorServiceRuntime;
+}
+export interface GovernorServiceSweepOutcome {
+    goal_id: string;
+    action: "tick" | "skip" | "backoff";
+    reason: string;
+    stop_reason?: GovernorStopReason;
+    next_wake_at?: string;
+}
+export interface GovernorServiceSweepReport {
+    started_at: string;
+    ended_at: string;
+    outcomes: GovernorServiceSweepOutcome[];
+}
+export interface RunGovernorServiceSweepInput {
+    coordRoot: string;
+    config: GovernorServiceConfig;
+    engine?: Omit<RunWorkItemInput["engine"], "maxAgents" | "concurrency" | "specialists">;
+    actor?: string;
+    now?: () => number;
+    readGoal?: (coordRoot: string, goalId: string) => GovernorRecord;
+    runGoal?: (goalId: string) => Promise<GovernorRunReport>;
+    onGoalStart?: (goalId: string) => void;
+}
+export interface RunGovernorServiceDaemonInput {
+    coordRoot: string;
+    engine: Omit<RunWorkItemInput["engine"], "maxAgents" | "concurrency" | "specialists">;
+    actor?: string;
+    maxSweeps?: number;
+    onLog?: (line: string) => void;
+}
+export declare function configureGovernorService(input: ConfigureGovernorServiceInput): GovernorServiceConfig;
+export declare function readGovernorServiceConfig(coordRootRaw: string): GovernorServiceConfig;
+export declare function readGovernorServiceRuntime(coordRootRaw: string): GovernorServiceRuntime | undefined;
+export declare function readGovernorServiceStatus(coordRootRaw: string): GovernorServiceStatus;
+export declare function spawnGovernorService(coordRootRaw: string): Promise<GovernorServiceStatus>;
+export declare function requestGovernorServiceStop(coordRootRaw: string): GovernorServiceStatus;
+export declare function runGovernorServiceSweep(input: RunGovernorServiceSweepInput): Promise<GovernorServiceSweepReport>;
+export declare function runGovernorServiceDaemon(input: RunGovernorServiceDaemonInput): Promise<GovernorServiceStatusRecord>;
+export declare function governorServiceLogPath(coordRoot: string): string;
+//# sourceMappingURL=service.d.ts.map

package/dist/core/governor/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/core/governor/service.ts"],"names":[],"mappings":"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"}

package/dist/core/{supervisor → governor}/service.js

@@ -4,27 +4,27 @@ import { appendFileSync, chmodSync, closeSync, existsSync, mkdirSync, openSync,
 import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { normalizePolicy } from "../policy/index.js";
-import { runSupervisor } from "./runner.js";
-import { readSupervisor } from "./state.js";
-export const SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION = 1;
-export const SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION = 1;
-export const SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION = 1;
+import { runGovernor } from "./runner.js";
+import { readGovernor } from "./state.js";
+export const GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION = 1;
+export const GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION = 1;
+export const GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION = 1;
 const MAX_FILE_BYTES = 512 * 1024;
 const MAX_GOALS = 100;
 const MAX_ERROR = 2_000;
 const FOREIGN_STATUS_STALE_MS = 30_000;
-export function configureSupervisorService(input) {
+export function configureGovernorService(input) {
     const coordRoot = resolve(input.coordRoot);
     const active = readStatusRecord(coordRoot);
     if (active && statusOwnerIsLive(active)) {
-        throw new Error(`stop supervisor service pid ${active.pid} before changing its configuration`);
+        throw new Error(`stop governor service pid ${active.pid} before changing its configuration`);
     }
     const goalIds = unique(input.goalIds.map((value) => value.trim()).filter(Boolean));
     if (goalIds.length < 1 || goalIds.length > MAX_GOALS) {
-        throw new Error(`supervisor service requires from 1 to ${MAX_GOALS} unique goal ids`);
+        throw new Error(`governor service requires from 1 to ${MAX_GOALS} unique goal ids`);
     }
     for (const goalId of goalIds)
-        readSupervisor(coordRoot, goalId);
+        readGovernor(coordRoot, goalId);
     const wakeIntervalMs = positive(input.wakeIntervalMs ?? 5_000, "service wake_interval_ms", 60 * 60 * 1_000);
     const heartbeatIntervalMs = positive(input.heartbeatIntervalMs ?? 2_000, "service heartbeat_interval_ms", 60_000);
     const errorBackoffBaseMs = positive(input.errorBackoffBaseMs ?? 2_000, "service error_backoff_base_ms", 60 * 60 * 1_000);
@@ -33,7 +33,7 @@ export function configureSupervisorService(input) {
         throw new Error("service error_backoff_max_ms must be at least error_backoff_base_ms");
     }
     const config = {
-        schema_version: SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION,
+        schema_version: GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION,
         goal_ids: goalIds,
         wake_interval_ms: wakeIntervalMs,
         heartbeat_interval_ms: heartbeatIntervalMs,
@@ -46,42 +46,42 @@ export function configureSupervisorService(input) {
     mkdirSync(dir, { recursive: true, mode: 0o700 });
     chmodSync(dir, 0o700);
     writePrivateJsonAtomic(serviceConfigPath(coordRoot), config);
-    return readSupervisorServiceConfig(coordRoot);
+    return readGovernorServiceConfig(coordRoot);
 }
-export function readSupervisorServiceConfig(coordRootRaw) {
+export function readGovernorServiceConfig(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
-    const config = readBoundedJson(serviceConfigPath(coordRoot), "supervisor service configuration");
+    const config = readBoundedJson(serviceConfigPath(coordRoot), "governor service configuration");
     validateConfig(coordRoot, config);
     return config;
 }
-export function readSupervisorServiceRuntime(coordRootRaw) {
+export function readGovernorServiceRuntime(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     if (!existsSync(serviceRuntimePath(coordRoot)))
         return undefined;
-    const runtime = readBoundedJson(serviceRuntimePath(coordRoot), "supervisor service runtime");
-    if (runtime.schema_version !== SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION ||
+    const runtime = readBoundedJson(serviceRuntimePath(coordRoot), "governor service runtime");
+    if (runtime.schema_version !== GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION ||
         !validTimestamp(runtime.config_created_at) ||
         !validTimestamp(runtime.updated_at) ||
         !runtime.goals ||
         typeof runtime.goals !== "object" ||
         Array.isArray(runtime.goals)) {
-        throw new Error("supervisor service runtime has an unsupported schema");
+        throw new Error("governor service runtime has an unsupported schema");
     }
     return runtime;
 }
-export function readSupervisorServiceStatus(coordRootRaw) {
+export function readGovernorServiceStatus(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     const record = readStatusRecord(coordRoot);
     let config;
     let runtime;
     try {
-        config = readSupervisorServiceConfig(coordRoot);
+        config = readGovernorServiceConfig(coordRoot);
     }
     catch {
         // A service has no usable configuration until explicitly configured.
     }
     try {
-        runtime = readSupervisorServiceRuntime(coordRoot);
+        runtime = readGovernorServiceRuntime(coordRoot);
     }
     catch {
         // Status remains readable when recoverable runtime state is corrupt.
@@ -91,12 +91,12 @@ export function readSupervisorServiceStatus(coordRootRaw) {
     const running = statusOwnerIsLive(record);
     return { running, stale: !running && record.state !== "stopped", record, config, runtime };
 }
-export async function spawnSupervisorService(coordRootRaw) {
+export async function spawnGovernorService(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
-    readSupervisorServiceConfig(coordRoot);
-    const current = readSupervisorServiceStatus(coordRoot);
+    readGovernorServiceConfig(coordRoot);
+    const current = readGovernorServiceStatus(coordRoot);
     if (current.running) {
-        throw new Error(`supervisor service is already running under pid ${current.record?.pid}`);
+        throw new Error(`governor service is already running under pid ${current.record?.pid}`);
     }
     mkdirSync(serviceDir(coordRoot), { recursive: true, mode: 0o700 });
     const logFd = openSync(serviceLogPath(coordRoot), "a", 0o600);
@@ -107,7 +107,7 @@ export async function spawnSupervisorService(coordRootRaw) {
         throw new Error(`cannot find harn executable at ${harnBin}`);
     }
     let spawnError;
-    const child = spawn(harnBin, ["supervisor", "service", "daemon"], {
+    const child = spawn(harnBin, ["governor", "service", "daemon"], {
         cwd: coordRoot,
         detached: true,
         stdio: ["ignore", logFd, logFd],
@@ -127,17 +127,17 @@ export async function spawnSupervisorService(coordRootRaw) {
         await delay(50);
         if (spawnError)
             throw spawnError;
-        const status = readSupervisorServiceStatus(coordRoot);
+        const status = readGovernorServiceStatus(coordRoot);
         if (status.running && status.record?.pid === child.pid)
             return status;
         if (child.exitCode !== null)
             break;
     }
-    throw new Error(`supervisor service failed to start; inspect ${serviceLogPath(coordRoot)}`);
+    throw new Error(`governor service failed to start; inspect ${serviceLogPath(coordRoot)}`);
 }
-export function requestSupervisorServiceStop(coordRootRaw) {
+export function requestGovernorServiceStop(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
-    const status = readSupervisorServiceStatus(coordRoot);
+    const status = readGovernorServiceStatus(coordRoot);
     if (!status.running || !status.record)
         return status;
     writePrivateJsonAtomic(serviceStopPath(coordRoot), {
@@ -152,24 +152,24 @@ export function requestSupervisorServiceStop(coordRootRaw) {
             // The durable stop request remains for a racing or restarted daemon.
         }
     }
-    return readSupervisorServiceStatus(coordRoot);
+    return readGovernorServiceStatus(coordRoot);
 }
-export async function runSupervisorServiceSweep(input) {
+export async function runGovernorServiceSweep(input) {
     const coordRoot = resolve(input.coordRoot);
     const now = input.now ?? Date.now;
-    const readGoal = input.readGoal ?? readSupervisor;
+    const readGoal = input.readGoal ?? readGovernor;
     const runtime = runtimeForConfig(coordRoot, input.config, now());
     const startedAt = new Date(now()).toISOString();
     const outcomes = [];
     const runGoal = input.runGoal ??
         (async (goalId) => {
             if (!input.engine)
-                throw new Error("supervisor service sweep requires an engine");
-            return await runSupervisor({
+                throw new Error("governor service sweep requires an engine");
+            return await runGovernor({
                 coordRoot,
                 goalId,
                 mode: "tick",
-                actor: input.actor ?? "supervisor-service",
+                actor: input.actor ?? "governor-service",
                 engine: input.engine,
             });
         });
@@ -287,14 +287,14 @@ export async function runSupervisorServiceSweep(input) {
     persistRuntime(coordRoot, runtime, Date.parse(endedAt));
     return { started_at: startedAt, ended_at: endedAt, outcomes };
 }
-export async function runSupervisorServiceDaemon(input) {
+export async function runGovernorServiceDaemon(input) {
     const coordRoot = resolve(input.coordRoot);
-    const config = readSupervisorServiceConfig(coordRoot);
+    const config = readGovernorServiceConfig(coordRoot);
     const release = acquireServiceLease(coordRoot);
     rmSync(serviceStopPath(coordRoot), { force: true });
     const now = new Date().toISOString();
     const status = {
-        schema_version: SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION,
+        schema_version: GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION,
         pid: process.pid,
         host: hostname(),
         nonce: randomUUID(),
@@ -325,20 +325,20 @@ export async function runSupervisorServiceDaemon(input) {
         goals: config.goal_ids,
         config_created_at: config.created_at,
     });
-    log(`supervisor service started for ${config.goal_ids.length} goal(s)`);
+    log(`governor service started for ${config.goal_ids.length} goal(s)`);
     const heartbeat = setInterval(() => {
         try {
             writeStatus();
         }
         catch (error) {
-            log(`supervisor service heartbeat error: ${boundedError(error.message)}`);
+            log(`governor service heartbeat error: ${boundedError(error.message)}`);
         }
     }, config.heartbeat_interval_ms);
     try {
         while (!stopRequested && !existsSync(serviceStopPath(coordRoot))) {
             let sleepMs = config.wake_interval_ms;
             try {
-                const report = await runSupervisorServiceSweep({
+                const report = await runGovernorServiceSweep({
                     coordRoot,
                     config,
                     engine: input.engine,
@@ -368,7 +368,7 @@ export async function runSupervisorServiceDaemon(input) {
                     event: "service.sweep_error",
                     error: status.last_error,
                 });
-                log(`supervisor service sweep error: ${status.last_error}`);
+                log(`governor service sweep error: ${status.last_error}`);
             }
             if (input.maxSweeps !== undefined && status.sweep_count >= input.maxSweeps)
                 break;
@@ -395,13 +395,13 @@ export async function runSupervisorServiceDaemon(input) {
     }
     return status;
 }
-export function supervisorServiceLogPath(coordRoot) {
+export function governorServiceLogPath(coordRoot) {
     return serviceLogPath(resolve(coordRoot));
 }
 function runtimeForConfig(coordRoot, config, timestamp) {
     let existing;
     try {
-        existing = readSupervisorServiceRuntime(coordRoot);
+        existing = readGovernorServiceRuntime(coordRoot);
     }
     catch {
         // Runtime is a recoverable scheduling hint; durable goal state remains authoritative.
@@ -411,7 +411,7 @@ function runtimeForConfig(coordRoot, config, timestamp) {
         return { ...existing, goals };
     }
     return {
-        schema_version: SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION,
+        schema_version: GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION,
         config_created_at: config.created_at,
         updated_at: new Date(timestamp).toISOString(),
         goals: Object.fromEntries(config.goal_ids.map((goalId) => [goalId, emptyGoalRuntime()])),
@@ -453,7 +453,7 @@ function wakeDue(value, now) {
 }
 function normalizeEngineConfig(coordRoot, input) {
     return {
-        default_harness: optionalBounded(input?.default_harness, "default_harness", 100),
+        default_adapter: optionalBounded(input?.default_adapter, "default_adapter", 100),
         cwd: input?.cwd ? resolve(input.cwd) : coordRoot,
         subscription_only: bool(input?.subscription_only ?? false, "subscription_only"),
         allow_api_billing: bool(input?.allow_api_billing ?? false, "allow_api_billing"),
@@ -463,13 +463,13 @@ function normalizeEngineConfig(coordRoot, input) {
     };
 }
 function validateConfig(coordRoot, config) {
-    if (config.schema_version !== SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION ||
+    if (config.schema_version !== GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION ||
         !validTimestamp(config.created_at) ||
         !Array.isArray(config.goal_ids)) {
-        throw new Error("supervisor service configuration has an unsupported schema");
+        throw new Error("governor service configuration has an unsupported schema");
     }
     const normalized = {
-        schema_version: SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION,
+        schema_version: GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION,
         goal_ids: unique(config.goal_ids.map((goalId) => goalId.trim()).filter(Boolean)),
         wake_interval_ms: positive(config.wake_interval_ms, "service wake_interval_ms", 60 * 60 * 1_000),
         heartbeat_interval_ms: positive(config.heartbeat_interval_ms, "service heartbeat_interval_ms", 60_000),
@@ -482,7 +482,7 @@ function validateConfig(coordRoot, config) {
         normalized.goal_ids.length > MAX_GOALS ||
         normalized.error_backoff_max_ms < normalized.error_backoff_base_ms ||
         JSON.stringify(normalized) !== JSON.stringify(config)) {
-        throw new Error("supervisor service configuration is not canonical");
+        throw new Error("governor service configuration is not canonical");
     }
 }
 function normalizeIsolation(value) {
@@ -522,11 +522,11 @@ function acquireServiceLease(coordRoot) {
     if (!acquire()) {
         const existing = readLease(path);
         if (existing && leaseOwnerIsLive(existing)) {
-            throw new Error(`supervisor service is already running under pid ${existing.pid}`);
+            throw new Error(`governor service is already running under pid ${existing.pid}`);
         }
         unlinkSync(path);
         if (!acquire())
-            throw new Error("supervisor service lease raced with another process");
+            throw new Error("governor service lease raced with another process");
     }
     return () => {
         try {
@@ -565,8 +565,8 @@ function readStatusRecord(coordRoot) {
     if (!existsSync(serviceStatusPath(coordRoot)))
         return undefined;
     try {
-        const value = readBoundedJson(serviceStatusPath(coordRoot), "supervisor service status");
-        if (value.schema_version !== SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION ||
+        const value = readBoundedJson(serviceStatusPath(coordRoot), "governor service status");
+        if (value.schema_version !== GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION ||
             !Number.isSafeInteger(value.pid) ||
             value.pid < 1 ||
             typeof value.host !== "string" ||
@@ -611,7 +611,7 @@ function renderSweepLog(report) {
     }, {});
     if (!counts.tick && !counts.backoff)
         return undefined;
-    return `supervisor service sweep: ${counts.tick ?? 0} tick, ${counts.skip ?? 0} skip, ${counts.backoff ?? 0} backoff`;
+    return `governor service sweep: ${counts.tick ?? 0} tick, ${counts.skip ?? 0} skip, ${counts.backoff ?? 0} backoff`;
 }
 function readBoundedJson(path, label) {
     if (!existsSync(path))
@@ -629,7 +629,7 @@ function readBoundedJson(path, label) {
 function writePrivateJsonAtomic(path, value) {
     const body = `${JSON.stringify(value, null, 2)}\n`;
     if (Buffer.byteLength(body) > MAX_FILE_BYTES) {
-        throw new Error(`supervisor service file exceeds ${MAX_FILE_BYTES} bytes`);
+        throw new Error(`governor service file exceeds ${MAX_FILE_BYTES} bytes`);
     }
     mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
     chmodSync(dirname(path), 0o700);
@@ -639,7 +639,7 @@ function writePrivateJsonAtomic(path, value) {
     chmodSync(path, 0o600);
 }
 function serviceDir(coordRoot) {
-    return join(resolve(coordRoot), ".harnery", "supervisor-service");
+    return join(resolve(coordRoot), ".harnery", "governor-service");
 }
 function serviceConfigPath(coordRoot) {
     return join(serviceDir(coordRoot), "config.json");