harnery 0.16.0 → 0.18.0

package/README.md

@@ -23,7 +23,7 @@
 - **Cross-machine presence:** sessions on every machine that shares a repo see each other, labeled by machine. Zero-config over the repo's own git remote (presence refs), with an optional live-socket upgrade via an end-to-end-encrypted relay — the public `relay.harnery.com`, or self-host with `harn relay serve` / the bundled Cloudflare Worker (`relay/worker/`). The relay sees only ciphertext in opaquely-named rooms.
 - **Coordination-aware workflows:** `harn workflow run <script>` executes bounded, schema-gated multi-subagent workflow scripts — plain JS stages fanning out to headless harness-CLI subagents that are born coordination-registered (heartbeats, events, claim guards), with deterministic code deciding the routing between stages. An optional host-owned policy gates dispatch and declared external mutations with `ALLOW`, `ASK`, and `DENY`; CLI `ASK` requests park durably for an explicit approve/deny and same-run resume, while library callers remain fail-closed by default.
 - **Durable work above attempts:** `harn work` preserves an objective across bounded workflow attempts, dependencies, approval parks, failures, and review. Its one-shot reconciler derives state from append-only local evidence and reports the next explicit action without silently spawning, retrying, or accepting work.
-- **Bounded goal supervision:** `harn supervisor` freezes a specialist team and safety limits around a root durable-work graph, then runs scheduling cycles until success, human attention, no progress, or budget exhaustion. Use explicit foreground ticks or enroll goals in the optional heartbeat-backed background service; specialist roles survive as configuration while every child remains a bounded process.
+- **Bounded goal supervision:** `harn supervisor` freezes a mission or existing root graph, specialist team, and safety limits, then runs scheduling cycles until reviewed mission success, human attention, no progress, or budget exhaustion. Its optional planner can create the first milestone, reassess accepted milestone proof, or recover a terminal graph using only a frozen workflow-template catalog. Proposals require review by default, old generations remain immutable evidence, and all attempts still consume the goal budget. Use explicit foreground ticks or enroll goals in the optional heartbeat-backed background service.
 - **Standalone web UI:** `harn web up` boots a local Next.js dashboard for the coord layer, councils, per-project state, and a local coding-agent status view (Claude Code / Codex / Cursor usage, backed by `harn devtools`). Ships with the git clone, not the npm package (see [Install](#install)).
 - **Backup + sync:** `harn backup` snapshots `.harnery/` via [restic](https://restic.net/); `harn sync` keeps a curated subset live across machines via [rclone](https://rclone.org/) (Google Drive or any rclone remote).
 

package/dist/commands/supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/commands/supervisor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA4DnD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA2FnF"}
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/commands/supervisor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqEnD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAgGnF"}

package/dist/commands/supervisor.js

@@ -1,18 +1,18 @@
 import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { dirname, isAbsolute, resolve } from "node:path";
 import { workflowSubscriptionOnly } from "../core/config.js";
 import { createBuiltinHarnessRegistry } from "../core/harnesses/index.js";
 import { findCoordRoot } from "../core/hooks/resolve/coord-root.js";
 import { loadPolicyFile } from "../core/policy/index.js";
-import { configureSupervisorService, createSupervisor, listSupervisors, readSupervisor, readSupervisorServiceConfig, readSupervisorServiceStatus, requestSupervisorServiceStop, runSupervisor, runSupervisorServiceDaemon, spawnSupervisorService, supervisorServiceLogPath, } from "../core/supervisor/index.js";
+import { approveSupervisorPlan, configureSupervisorService, createSupervisor, listSupervisors, readSupervisor, readSupervisorPlan, readSupervisorServiceConfig, readSupervisorServiceStatus, rejectSupervisorPlan, requestSupervisorServiceStop, runSupervisor, runSupervisorServiceDaemon, spawnSupervisorService, supervisorServiceLogPath, } from "../core/supervisor/index.js";
 export function registerSupervisorCommand(program, emit) {
     const registry = createBuiltinHarnessRegistry();
     const supervisor = program
         .command("supervisor")
         .description("Run a bounded specialist team over a durable-work dependency graph.");
     supervisor
-        .command("create <root-work-id>")
-        .description("Freeze a goal, specialist team, automation policy, and execution limits.")
+        .command("create [root-work-id]")
+        .description("Freeze an existing-root goal or an objective-first bounded mission.")
         .requiredOption("--team <file>", "JSON object mapping specialist ids to profiles")
         .option("--id <goal-id>", "Stable goal id (generated by default)")
         .option("--title <text>", "Goal title (defaults to root work title)")
@@ -25,6 +25,8 @@ export function registerSupervisorCommand(program, emit) {
         .option("--accept-passing-proof", "Allow the supervisor to explicitly accept passing proof")
         .option("--no-resume-approved", "Stop after an approval instead of resuming its parked run")
         .option("--retry-blocked", "Allow bounded retry of blocked work")
+        .option("--replanning <file>", "Frozen planner policy and allowed workflow-template catalog")
+        .option("--mission <file>", "Frozen objective, acceptance criteria, and milestone bound")
         .option("--json", "Emit the complete supervisor record as JSON")
         .action((rootWorkId, opts) => {
         withSupervisorRoot(emit, (coordRoot) => {
@@ -53,6 +55,8 @@ export function registerSupervisorCommand(program, emit) {
                     resume_approved: opts.resumeApproved,
                     retry_blocked: opts.retryBlocked,
                 },
+                mission: opts.mission ? readMissionFile(opts.mission) : undefined,
+                replanning: opts.replanning ? readReplanningFile(opts.replanning) : undefined,
             }), opts.json, emit, true);
         });
     });
@@ -84,10 +88,78 @@ export function registerSupervisorCommand(program, emit) {
             emitSupervisor(readSupervisor(coordRoot, goalId), opts.json, emit, true);
         });
     });
+    registerPlanCommand(supervisor, emit);
     registerServiceCommand(supervisor, registry, emit);
     registerRunCommand(supervisor, "tick", registry, emit);
     registerRunCommand(supervisor, "run", registry, emit);
 }
+function registerPlanCommand(supervisor, emit) {
+    const plan = supervisor
+        .command("plan")
+        .description("Inspect and resolve bounded planner proposals for a durable goal.");
+    plan
+        .command("list <goal-id>")
+        .description("List append-only replanning attempts for one goal.")
+        .option("--json", "Emit complete plan records as JSON")
+        .action((goalId, opts) => {
+        withSupervisorRoot(emit, (coordRoot) => {
+            const plans = readSupervisor(coordRoot, goalId).plans;
+            if (opts.json) {
+                emit.config({ format: "json" });
+                emit.data(plans);
+            }
+            else if (plans.length === 0) {
+                emit.text(`supervisor ${goalId} has no replanning attempts\n`);
+            }
+            else {
+                emit.text(`${plans.map(renderPlanRow).join("\n")}\n`);
+            }
+        });
+    });
+    plan
+        .command("show <goal-id> <plan-id>")
+        .description("Show one planner request, schema-gated proposal, and audit events.")
+        .option("--json", "Emit the complete plan record as JSON")
+        .action((goalId, planId, opts) => {
+        withSupervisorRoot(emit, (coordRoot) => {
+            emitPlan(readSupervisorPlan(coordRoot, goalId, planId), opts.json, emit);
+        });
+    });
+    plan
+        .command("approve <goal-id> <plan-id>")
+        .description("Materialize a reviewed proposal and advance the active immutable root.")
+        .option("--actor <name>", "Actor recorded on the plan decision")
+        .option("--reason <text>", "Reason for approval")
+        .option("--json", "Emit the plan outcome as JSON")
+        .action((goalId, planId, opts) => {
+        withSupervisorRoot(emit, (coordRoot) => {
+            emitPlanOutcome(approveSupervisorPlan({
+                coordRoot,
+                goalId,
+                planId,
+                actor: opts.actor,
+                reason: opts.reason,
+            }), opts.json, emit);
+        });
+    });
+    plan
+        .command("reject <goal-id> <plan-id>")
+        .description("Reject a pending proposal without mutating durable work.")
+        .requiredOption("--reason <text>", "Reason the proposal is rejected")
+        .option("--actor <name>", "Actor recorded on the plan decision")
+        .option("--json", "Emit the plan outcome as JSON")
+        .action((goalId, planId, opts) => {
+        withSupervisorRoot(emit, (coordRoot) => {
+            emitPlanOutcome(rejectSupervisorPlan({
+                coordRoot,
+                goalId,
+                planId,
+                actor: opts.actor,
+                reason: opts.reason,
+            }), opts.json, emit);
+        });
+    });
+}
 function registerServiceCommand(supervisor, registry, emit) {
     const service = supervisor
         .command("service")
@@ -355,6 +427,82 @@ function readTeamFile(path) {
     }
     return value;
 }
+function readReplanningFile(path) {
+    const absolute = resolve(path);
+    let value;
+    try {
+        value = JSON.parse(readFileSync(absolute, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`cannot read supervisor replanning policy at ${absolute}: ${error.message}`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("supervisor replanning policy must be a JSON object");
+    }
+    const config = value;
+    if (typeof config.planner_specialist !== "string") {
+        throw new Error("supervisor replanning planner_specialist must be a string");
+    }
+    if (!config.templates ||
+        typeof config.templates !== "object" ||
+        Array.isArray(config.templates)) {
+        throw new Error("supervisor replanning templates must be an object");
+    }
+    const base = dirname(absolute);
+    const templates = Object.fromEntries(Object.entries(config.templates).map(([id, raw]) => {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            throw new Error(`supervisor replanning template ${id} must be an object`);
+        }
+        const template = raw;
+        if (typeof template.workflow !== "string") {
+            throw new Error(`supervisor replanning template ${id} workflow must be a string`);
+        }
+        return [
+            id,
+            {
+                workflowPath: isAbsolute(template.workflow)
+                    ? template.workflow
+                    : resolve(base, template.workflow),
+                maxAttempts: jsonInteger(template.max_attempts, `template ${id} max_attempts`),
+                root: jsonBoolean(template.root, `template ${id} root`),
+            },
+        ];
+    }));
+    return {
+        plannerSpecialist: config.planner_specialist,
+        autoApply: jsonBoolean(config.auto_apply, "replanning auto_apply"),
+        maxReplans: jsonInteger(config.max_replans, "replanning max_replans"),
+        maxWorkItemsPerPlan: jsonInteger(config.max_work_items_per_plan, "replanning max_work_items_per_plan"),
+        maxTotalWorkItems: jsonInteger(config.max_total_work_items, "replanning max_total_work_items"),
+        templates,
+    };
+}
+function readMissionFile(path) {
+    const absolute = resolve(path);
+    let value;
+    try {
+        value = JSON.parse(readFileSync(absolute, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`cannot read supervisor mission at ${absolute}: ${error.message}`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("supervisor mission must be a JSON object");
+    }
+    const config = value;
+    if (typeof config.objective !== "string") {
+        throw new Error("supervisor mission objective must be a string");
+    }
+    if (!Array.isArray(config.acceptance) ||
+        config.acceptance.some((item) => typeof item !== "string")) {
+        throw new Error("supervisor mission acceptance must be an array of strings");
+    }
+    return {
+        objective: config.objective,
+        acceptance: config.acceptance,
+        maxMilestones: jsonInteger(config.max_milestones, "mission max_milestones"),
+    };
+}
 function emitSupervisor(record, json, emit, detail = false) {
     if (json) {
         emit.config({ format: "json" });
@@ -369,7 +517,7 @@ function emitSupervisor(record, json, emit, detail = false) {
     const lines = [
         `${record.intent.id}: ${record.intent.title}`,
         `state: ${projection.state}`,
-        `root: ${record.intent.root_work_id}`,
+        `root: ${projection.root_materialized ? projection.root_work_id : "pending initial plan"}`,
         `reason: ${projection.reason}`,
         `next: ${projection.next_action}`,
         `work: ${projection.work_ids.length}`,
@@ -378,6 +526,19 @@ function emitSupervisor(record, json, emit, detail = false) {
         `automation: accept=${record.intent.automation.accept_passing_proof}, ` +
             `resume=${record.intent.automation.resume_approved}, retry=${record.intent.automation.retry_blocked}`,
     ];
+    if (record.intent.replanning) {
+        lines.push(`replanning: generation=${projection.plan_generation}, used=${projection.replans_used}/${record.intent.replanning.max_replans}, auto_apply=${record.intent.replanning.auto_apply}`);
+        if (projection.root_work_id !== record.intent.root_work_id) {
+            lines.push(`original root: ${record.intent.root_work_id}`);
+        }
+        if (projection.pending_plan_id)
+            lines.push(`pending plan: ${projection.pending_plan_id}`);
+    }
+    if (record.intent.mission) {
+        lines.push(`mission: ${record.intent.mission.objective}`);
+        lines.push(`milestones: ${projection.milestones_completed}/${record.intent.mission.max_milestones}`);
+        lines.push(`mission acceptance: ${record.intent.mission.acceptance.length}`);
+    }
     if (projection.attention_work.length) {
         lines.push(`attention: ${projection.attention_work.join(", ")}`);
     }
@@ -392,6 +553,7 @@ function emitSupervisorReport(report, json, emit) {
     emit.text(`supervisor ${report.goal_id}: ${report.stop_reason}\n` +
         `reason: ${report.reason}\n` +
         `cycles: ${report.cycles}; dispatches: ${report.dispatches}; acceptances: ${report.acceptances}\n` +
+        `replans: ${report.replans}\n` +
         `state: ${report.projection.state}; next: ${report.projection.next_action}\n`);
 }
 function renderSupervisorRow(record) {
@@ -405,6 +567,62 @@ function integer(value) {
         throw new Error(`expected a positive integer, got ${JSON.stringify(value)}`);
     return Number.parseInt(value, 10);
 }
+function jsonInteger(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`${field} must be a positive integer`);
+    }
+    return value;
+}
+function jsonBoolean(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean")
+        throw new Error(`${field} must be boolean`);
+    return value;
+}
+function emitPlan(plan, json, emit) {
+    if (json) {
+        emit.config({ format: "json" });
+        emit.data(plan);
+        return;
+    }
+    const lines = [
+        `${plan.request.id}: ${plan.status}`,
+        `goal: ${plan.request.goal_id}`,
+        `sequence: ${plan.request.sequence}`,
+        `trigger: ${plan.request.trigger ?? "recovery"}`,
+        `prior root: ${plan.request.prior_root_work_id}`,
+        `planner run: ${plan.request.workflow_run_id}`,
+    ];
+    if (plan.proposal) {
+        lines.push(`decision: ${plan.proposal.decision}`);
+        lines.push(`rationale: ${plan.proposal.rationale}`);
+        lines.push(`proposed work: ${plan.proposal.work.length}`);
+        if (plan.proposal.milestone) {
+            lines.push(`milestone: ${plan.proposal.milestone.sequence} ${plan.proposal.milestone.title}`);
+        }
+    }
+    if (plan.root_work_id)
+        lines.push(`applied root: ${plan.root_work_id}`);
+    if (plan.approval_id)
+        lines.push(`approval: ${plan.approval_id}`);
+    emit.text(`${lines.join("\n")}\n`);
+}
+function emitPlanOutcome(outcome, json, emit) {
+    if (json) {
+        emit.config({ format: "json" });
+        emit.data(outcome);
+        return;
+    }
+    emit.text(`supervisor plan ${outcome.plan_id}: ${outcome.status}\n` +
+        `${outcome.reason ? `reason: ${outcome.reason}\n` : ""}` +
+        `${outcome.root_work_id ? `root: ${outcome.root_work_id}\n` : ""}`);
+}
+function renderPlanRow(plan) {
+    return `${plan.request.id}  ${plan.status.padEnd(18)}  ${plan.request.prior_root_work_id}`;
+}
 function delay(ms) {
     return new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
 }

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

@@ -1,4 +1,7 @@
+export { approveSupervisorPlan, rejectSupervisorPlan } from "./plan-api.js";
+export { readSupervisorPlan, readSupervisorPlans } from "./plan-read.js";
+export { type CreateSupervisorPlanTemplateInput, type CreateSupervisorReplanningInput, SUPERVISOR_PLAN_SCHEMA_VERSION, type SupervisorPlanEvent, type SupervisorPlanEventType, type SupervisorPlanHistory, type SupervisorPlanMilestone, type SupervisorPlanOutcome, type SupervisorPlanProposal, type SupervisorPlanRecord, type SupervisorPlanRequest, type SupervisorPlanStatus, type SupervisorPlanTemplate, type SupervisorPlanWorkSpec, type SupervisorReplanningPolicy, } from "./plan-types.js";
 export { type RunSupervisorInput, runSupervisor, type SupervisorDispatchOutcome, type SupervisorRunReport, type SupervisorStopReason, } from "./runner.js";
 export { type ConfigureSupervisorServiceInput, configureSupervisorService, type RunSupervisorServiceDaemonInput, type RunSupervisorServiceSweepInput, readSupervisorServiceConfig, readSupervisorServiceRuntime, readSupervisorServiceStatus, requestSupervisorServiceStop, runSupervisorServiceDaemon, runSupervisorServiceSweep, SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION, SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION, SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION, type SupervisorServiceConfig, type SupervisorServiceEngineConfig, type SupervisorServiceGoalRuntime, type SupervisorServiceGoalState, type SupervisorServiceProcessState, type SupervisorServiceRuntime, type SupervisorServiceStatus, type SupervisorServiceStatusRecord, type SupervisorServiceSweepOutcome, type SupervisorServiceSweepReport, spawnSupervisorService, supervisorServiceLogPath, } from "./service.js";
-export { assertSupervisorId, type CreateSupervisorInput, collectSupervisorWork, createSupervisor, listSupervisors, newSupervisorId, readSupervisor, SUPERVISOR_INTENT_SCHEMA_VERSION, type SupervisorAutomationPolicy, type SupervisorIntent, type SupervisorLimits, type SupervisorNextAction, type SupervisorProjection, type SupervisorRecord, type SupervisorState, } from "./state.js";
+export { assertSupervisorId, type CreateSupervisorInput, type CreateSupervisorMissionInput, collectSupervisorWork, createSupervisor, listSupervisors, newSupervisorId, readSupervisor, SUPERVISOR_INTENT_SCHEMA_VERSION, type SupervisorAutomationPolicy, type SupervisorIntent, type SupervisorLimits, type SupervisorMission, type SupervisorNextAction, type SupervisorProjection, type SupervisorRecord, type SupervisorState, } from "./state.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,+BAA+B,EACpC,0BAA0B,EAC1B,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,wCAAwC,EACxC,yCAAyC,EACzC,wCAAwC,EACxC,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,gCAAgC,EAChC,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,+BAA+B,EACpC,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,+BAA+B,EACpC,0BAA0B,EAC1B,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,wCAAwC,EACxC,yCAAyC,EACzC,wCAAwC,EACxC,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,gCAAgC,EAChC,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/core/supervisor/index.js

@@ -1,3 +1,6 @@
+export { approveSupervisorPlan, rejectSupervisorPlan } from "./plan-api.js";
+export { readSupervisorPlan, readSupervisorPlans } from "./plan-read.js";
+export { SUPERVISOR_PLAN_SCHEMA_VERSION, } from "./plan-types.js";
 export { runSupervisor, } from "./runner.js";
 export { configureSupervisorService, readSupervisorServiceConfig, readSupervisorServiceRuntime, readSupervisorServiceStatus, requestSupervisorServiceStop, runSupervisorServiceDaemon, runSupervisorServiceSweep, SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION, SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION, SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION, spawnSupervisorService, supervisorServiceLogPath, } from "./service.js";
 export { assertSupervisorId, collectSupervisorWork, createSupervisor, listSupervisors, newSupervisorId, readSupervisor, SUPERVISOR_INTENT_SCHEMA_VERSION, } from "./state.js";

package/dist/core/supervisor/plan-api.d.ts

@@ -0,0 +1,16 @@
+import type { SupervisorPlanOutcome } from "./plan-types.js";
+export declare function approveSupervisorPlan(input: {
+    coordRoot: string;
+    goalId: string;
+    planId: string;
+    actor?: string;
+    reason?: string;
+}): SupervisorPlanOutcome;
+export declare function rejectSupervisorPlan(input: {
+    coordRoot: string;
+    goalId: string;
+    planId: string;
+    actor?: string;
+    reason: string;
+}): SupervisorPlanOutcome;
+//# sourceMappingURL=plan-api.d.ts.map

package/dist/core/supervisor/plan-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-api.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/plan-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,qBAAqB,CAcxB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAcxB"}

package/dist/core/supervisor/plan-api.js

@@ -0,0 +1,34 @@
+import { applySupervisorPlanProposal, rejectSupervisorPlanProposal } from "./planning.js";
+import { acquireSupervisorLease, readSupervisorIgnoringLease } from "./state.js";
+export function approveSupervisorPlan(input) {
+    const actor = input.actor?.trim() || `supervisor:${input.goalId}`;
+    const release = acquireSupervisorLease(input.coordRoot, input.goalId);
+    try {
+        return applySupervisorPlanProposal({
+            coordRoot: input.coordRoot,
+            record: readSupervisorIgnoringLease(input.coordRoot, input.goalId),
+            planId: input.planId,
+            actor,
+            reason: input.reason,
+        });
+    }
+    finally {
+        release();
+    }
+}
+export function rejectSupervisorPlan(input) {
+    const actor = input.actor?.trim() || `supervisor:${input.goalId}`;
+    const release = acquireSupervisorLease(input.coordRoot, input.goalId);
+    try {
+        return rejectSupervisorPlanProposal({
+            coordRoot: input.coordRoot,
+            goalId: input.goalId,
+            planId: input.planId,
+            actor,
+            reason: input.reason,
+        });
+    }
+    finally {
+        release();
+    }
+}

package/dist/core/supervisor/plan-read.d.ts

@@ -0,0 +1,4 @@
+import { type SupervisorPlanHistory, type SupervisorPlanRecord } from "./plan-types.js";
+export declare function readSupervisorPlans(coordRootRaw: string, goalId: string, originalRootWorkId: string): SupervisorPlanHistory;
+export declare function readSupervisorPlan(coordRootRaw: string, goalId: string, planId: string): SupervisorPlanRecord;
+//# sourceMappingURL=plan-read.d.ts.map

package/dist/core/supervisor/plan-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-read.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/plan-read.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EAE1B,MAAM,iBAAiB,CAAC;AAuBzB,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,GACzB,qBAAqB,CAwEvB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,oBAAoB,CAetB"}