harnery 0.17.0 → 0.18.0

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,oBAAoB,GACpB,SAAS,GACT,kBAAkB,GAClB,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC;IACtF,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAQD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqL3F"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/supervisor/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,oBAAoB,GACpB,SAAS,GACT,kBAAkB,GAClB,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC;IACtF,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAQD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4L3F"}

package/dist/core/supervisor/runner.js

@@ -33,8 +33,10 @@ export async function runSupervisor(input) {
             }
             const before = graphFingerprint(record);
             let changed = false;
-            if (record.projection.next_action === "replan") {
-                log(`[${record.intent.title}] replan active graph generation ${record.projection.plan_generation}`);
+            if (record.projection.next_action === "replan" ||
+                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({
                     coordRoot,
                     record,
@@ -48,6 +50,9 @@ export async function runSupervisor(input) {
                 if (mode === "tick") {
                     return report("tick_complete", `planner produced ${plan.status} plan ${plan.plan_id}`, record);
                 }
+                if (record.projection.state === "succeeded") {
+                    return report("succeeded", record.projection.reason, record);
+                }
                 if (record.projection.state !== "ready") {
                     return report(stopForProjection(record.projection), record.projection.reason, record);
                 }

package/dist/core/supervisor/service.js

@@ -434,9 +434,12 @@ function projectionFingerprint(projection) {
         projection.attempts_used,
         projection.attempts_remaining,
         projection.root_work_id,
+        projection.root_materialized,
         projection.plan_generation,
         projection.replans_used,
         projection.replans_remaining,
+        projection.milestones_completed,
+        projection.milestones_remaining,
         projection.pending_plan_id,
         projection.latest_plan_status,
         projection.ready_work,

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

@@ -15,6 +15,16 @@ export interface SupervisorAutomationPolicy {
     resume_approved: boolean;
     retry_blocked: boolean;
 }
+export interface SupervisorMission {
+    objective: string;
+    acceptance: string[];
+    max_milestones: number;
+}
+export interface CreateSupervisorMissionInput {
+    objective: string;
+    acceptance: readonly string[];
+    maxMilestones?: number;
+}
 export interface SupervisorIntent {
     schema_version: typeof SUPERVISOR_INTENT_SCHEMA_VERSION;
     id: string;
@@ -23,15 +33,17 @@ export interface SupervisorIntent {
     specialists: Record<string, WorkflowSpecialistProfile>;
     limits: SupervisorLimits;
     automation: SupervisorAutomationPolicy;
+    mission?: SupervisorMission;
     replanning?: SupervisorReplanningPolicy;
     created_at: string;
 }
 export type SupervisorState = "ready" | "running" | "awaiting_attention" | "blocked" | "budget_exhausted" | "succeeded";
-export type SupervisorNextAction = "run" | "wait_for_run" | "resolve_approval" | "review" | "retry" | "replan" | "review_plan" | "none";
+export type SupervisorNextAction = "run" | "wait_for_run" | "resolve_approval" | "review" | "retry" | "replan" | "plan_initial" | "plan_milestone" | "review_plan" | "none";
 export interface SupervisorProjection {
     id: string;
     title: string;
     root_work_id: string;
+    root_materialized: boolean;
     state: SupervisorState;
     reason: string;
     next_action: SupervisorNextAction;
@@ -46,6 +58,8 @@ export interface SupervisorProjection {
     plan_generation: number;
     replans_used: number;
     replans_remaining: number;
+    milestones_completed: number;
+    milestones_remaining: number;
     pending_plan_id?: string;
     latest_plan_status?: SupervisorPlanRecord["status"];
     governed_work_ids: string[];
@@ -58,12 +72,13 @@ export interface SupervisorRecord {
 }
 export interface CreateSupervisorInput {
     coordRoot: string;
-    rootWorkId: string;
+    rootWorkId?: string;
     specialists: Readonly<Record<string, WorkflowSpecialistProfile>>;
     title?: string;
     id?: string;
     limits?: Partial<SupervisorLimits>;
     automation?: Partial<SupervisorAutomationPolicy>;
+    mission?: CreateSupervisorMissionInput;
     replanning?: CreateSupervisorReplanningInput;
 }
 export declare function createSupervisor(input: CreateSupervisorInput): SupervisorRecord;

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

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

package/dist/core/supervisor/state.js

@@ -10,27 +10,44 @@ import { supervisorGraphFingerprint, } from "./plan-types.js";
 export const SUPERVISOR_INTENT_SCHEMA_VERSION = 1;
 const GOAL_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
 const MAX_TITLE = 200;
+const MAX_OBJECTIVE = 4_000;
+const MAX_ACCEPTANCE = 50;
 const MAX_INTENT_BYTES = 256 * 1024;
 const MAX_TEMPLATES = 20;
 const TEMPLATE_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 const FOREIGN_LEASE_STALE_MS = 24 * 60 * 60 * 1_000;
 export function createSupervisor(input) {
     const coordRoot = resolve(input.coordRoot);
-    assertWorkId(input.rootWorkId);
-    const root = readWorkItem(coordRoot, input.rootWorkId);
     const id = input.id ?? newSupervisorId();
     assertSupervisorId(id);
+    const mission = input.mission ? normalizeMission(input.mission) : undefined;
+    if (mission && !input.replanning) {
+        throw new Error("supervisor mission requires a replanning policy");
+    }
+    if (!input.rootWorkId && !mission) {
+        throw new Error("supervisor creation without root work requires a mission and replanning policy");
+    }
+    if (input.rootWorkId)
+        assertWorkId(input.rootWorkId);
+    const root = input.rootWorkId ? readWorkItem(coordRoot, input.rootWorkId) : undefined;
     const replanning = input.replanning
         ? normalizeReplanning(input.replanning, input.specialists)
         : undefined;
+    if (mission &&
+        !input.rootWorkId &&
+        replanning &&
+        replanning.max_replans <= mission.max_milestones) {
+        throw new Error("objective-first mission max_replans must exceed max_milestones to reserve completion review");
+    }
     const intent = {
         schema_version: SUPERVISOR_INTENT_SCHEMA_VERSION,
         id,
-        title: bounded(input.title ?? root.intent.title, "supervisor title", MAX_TITLE),
-        root_work_id: input.rootWorkId,
+        title: bounded(input.title ?? root?.intent.title ?? missionTitle(mission), "supervisor title", MAX_TITLE),
+        root_work_id: input.rootWorkId ?? missionRootId(id),
         specialists: normalizeWorkflowSpecialists(input.specialists),
         limits: normalizeLimits(input.limits),
         automation: normalizeAutomation(input.automation),
+        ...(mission ? { mission } : {}),
         ...(replanning ? { replanning } : {}),
         created_at: new Date().toISOString(),
     };
@@ -136,7 +153,11 @@ function readSupervisorInternal(coordRootRaw, goalId, ignoreLease) {
     const coordRoot = resolve(coordRootRaw);
     const intent = readSupervisorIntent(coordRoot, goalId);
     const plans = readSupervisorPlans(coordRoot, intent.id, intent.root_work_id);
-    const work = collectSupervisorWork(coordRoot, plans.active_root_work_id);
+    const activeRootExists = workIntentExists(coordRoot, plans.active_root_work_id);
+    if (!activeRootExists && (!intent.mission || plans.generation > 0)) {
+        throw new Error(`supervisor ${intent.id} root work is missing`);
+    }
+    const work = activeRootExists ? collectSupervisorWork(coordRoot, plans.active_root_work_id) : [];
     const governed = collectGovernedWork(coordRoot, intent.root_work_id, plans, work);
     return {
         intent,
@@ -147,8 +168,6 @@ function readSupervisorInternal(coordRootRaw, goalId, ignoreLease) {
 }
 function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease) {
     const root = work.find((record) => record.intent.id === plans.active_root_work_id);
-    if (!root)
-        throw new Error(`supervisor ${intent.id} root work is missing`);
     const attemptsUsed = governed.reduce((sum, record) => sum + record.projection.attempts_used, 0);
     const readyWork = work
         .filter((record) => record.projection.state === "ready")
@@ -181,10 +200,14 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
         ...cancelled,
         ...terminalBlocked,
     ]);
+    const initialRootAccepted = intent.mission !== undefined &&
+        governed.some((record) => record.intent.id === intent.root_work_id && record.projection.state === "succeeded");
+    const milestonesCompleted = plans.milestones_completed + (initialRootAccepted ? 1 : 0);
     const base = {
         id: intent.id,
         title: intent.title,
         root_work_id: plans.active_root_work_id,
+        root_materialized: root !== undefined,
         work_ids: work.map((record) => record.intent.id),
         ready_work: readyWork,
         resumable_work: resumableWork,
@@ -196,6 +219,8 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
         plan_generation: plans.generation,
         replans_used: plans.plans.length,
         replans_remaining: Math.max(0, (intent.replanning?.max_replans ?? 0) - plans.plans.length),
+        milestones_completed: milestonesCompleted,
+        milestones_remaining: Math.max(0, (intent.mission?.max_milestones ?? 0) - milestonesCompleted),
         pending_plan_id: plans.latest?.status === "proposed" ? plans.latest.request.id : undefined,
         latest_plan_status: plans.latest?.status,
         governed_work_ids: governed.map((record) => record.intent.id),
@@ -208,11 +233,11 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
             next_action: "wait_for_run",
         };
     }
-    if (root.projection.state === "succeeded") {
+    if (intent.mission && plans.completed) {
         return {
             ...base,
             state: "succeeded",
-            reason: "root work was explicitly accepted",
+            reason: "mission completion was explicitly accepted",
             next_action: "none",
         };
     }
@@ -240,6 +265,64 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
             next_action: "replan",
         };
     }
+    const triggerFingerprint = supervisorGraphFingerprint({
+        rootWorkId: plans.active_root_work_id,
+        generation: plans.generation,
+        work,
+    });
+    const latestHandledSameGraph = plans.latest?.request.trigger_fingerprint === triggerFingerprint &&
+        plans.latest.request.prior_root_work_id === plans.active_root_work_id &&
+        plans.latest.status === "attention";
+    if (latestHandledSameGraph && plans.latest) {
+        return {
+            ...base,
+            state: "awaiting_attention",
+            reason: plans.latest.reason ?? `plan ${plans.latest.request.id} requires attention`,
+            next_action: "none",
+        };
+    }
+    if (!root && intent.mission) {
+        if (!intent.replanning || plans.plans.length >= intent.replanning.max_replans) {
+            return {
+                ...base,
+                state: "budget_exhausted",
+                reason: "mission exhausted its planning budget before creating an initial milestone",
+                next_action: "none",
+            };
+        }
+        return {
+            ...base,
+            state: "ready",
+            reason: "mission is ready for its initial bounded milestone plan",
+            next_action: "plan_initial",
+        };
+    }
+    if (!root)
+        throw new Error(`supervisor ${intent.id} root work is missing`);
+    if (root.projection.state === "succeeded" && intent.mission) {
+        if (!intent.replanning || plans.plans.length >= intent.replanning.max_replans) {
+            return {
+                ...base,
+                state: "budget_exhausted",
+                reason: "mission exhausted its planning budget at a milestone boundary",
+                next_action: "none",
+            };
+        }
+        return {
+            ...base,
+            state: "ready",
+            reason: `milestone ${plans.milestones_completed} is accepted and requires mission reassessment`,
+            next_action: "plan_milestone",
+        };
+    }
+    if (root.projection.state === "succeeded") {
+        return {
+            ...base,
+            state: "succeeded",
+            reason: "root work was explicitly accepted",
+            next_action: "none",
+        };
+    }
     const resumableDispatchable = intent.automation.resume_approved ? resumableWork : [];
     const attemptDispatchable = [
         ...readyWork,
@@ -318,14 +401,6 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
             next_action: "none",
         };
     }
-    const triggerFingerprint = supervisorGraphFingerprint({
-        rootWorkId: plans.active_root_work_id,
-        generation: plans.generation,
-        work,
-    });
-    const latestHandledSameGraph = plans.latest?.request.trigger_fingerprint === triggerFingerprint &&
-        plans.latest.request.prior_root_work_id === plans.active_root_work_id &&
-        plans.latest.status === "attention";
     const canReplan = intent.replanning !== undefined &&
         plans.plans.length < intent.replanning.max_replans &&
         cancelled.length === 0 &&
@@ -350,14 +425,6 @@ function deriveProjection(coordRoot, intent, work, governed, plans, ignoreLease)
             next_action: "none",
         };
     }
-    if (latestHandledSameGraph && plans.latest) {
-        return {
-            ...base,
-            state: "awaiting_attention",
-            reason: plans.latest.reason ?? `plan ${plans.latest.request.id} requires attention`,
-            next_action: "none",
-        };
-    }
     return {
         ...base,
         state: "blocked",
@@ -394,6 +461,19 @@ function validateIntent(intent, goalId) {
     }
     bounded(intent.title, "supervisor title", MAX_TITLE);
     assertWorkId(intent.root_work_id);
+    if (intent.mission) {
+        const normalizedMission = normalizeMission({
+            objective: intent.mission.objective,
+            acceptance: intent.mission.acceptance,
+            maxMilestones: intent.mission.max_milestones,
+        });
+        if (JSON.stringify(normalizedMission) !== JSON.stringify(intent.mission)) {
+            throw new Error(`supervisor intent ${goalId} mission is not canonical`);
+        }
+        if (!intent.replanning) {
+            throw new Error(`supervisor intent ${goalId} mission requires replanning`);
+        }
+    }
     const specialists = normalizeWorkflowSpecialists(intent.specialists);
     if (JSON.stringify(specialists) !== JSON.stringify(intent.specialists)) {
         throw new Error(`supervisor intent ${goalId} specialists are not canonical`);
@@ -407,6 +487,28 @@ function validateIntent(intent, goalId) {
     if (intent.replanning)
         validateReplanning(intent.replanning, specialists, goalId);
 }
+function normalizeMission(input) {
+    if (!Array.isArray(input.acceptance)) {
+        throw new Error("supervisor mission acceptance must be an array");
+    }
+    if (input.acceptance.length < 1 || input.acceptance.length > MAX_ACCEPTANCE) {
+        throw new Error(`supervisor mission acceptance must contain 1 to ${MAX_ACCEPTANCE} criteria`);
+    }
+    const acceptance = input.acceptance.map((criterion, index) => bounded(criterion, `supervisor mission acceptance[${index}]`, 500));
+    if (new Set(acceptance).size !== acceptance.length) {
+        throw new Error("supervisor mission acceptance criteria must be unique");
+    }
+    return {
+        objective: bounded(input.objective, "supervisor mission objective", MAX_OBJECTIVE),
+        acceptance,
+        max_milestones: positive(input.maxMilestones ?? 4, "supervisor mission max_milestones", 20),
+    };
+}
+function missionTitle(mission) {
+    return mission.objective.length <= MAX_TITLE
+        ? mission.objective
+        : `${mission.objective.slice(0, MAX_TITLE - 1).trimEnd()}…`;
+}
 function normalizeLimits(input) {
     return {
         max_cycles: positive(input?.max_cycles ?? 50, "supervisor max_cycles", 1_000),
@@ -502,8 +604,10 @@ function validateReplanning(policy, specialists, goalId) {
 }
 function collectGovernedWork(coordRoot, originalRootWorkId, plans, active) {
     const governed = new Map();
-    for (const record of collectSupervisorWork(coordRoot, originalRootWorkId)) {
-        governed.set(record.intent.id, record);
+    if (workIntentExists(coordRoot, originalRootWorkId)) {
+        for (const record of collectSupervisorWork(coordRoot, originalRootWorkId)) {
+            governed.set(record.intent.id, record);
+        }
     }
     for (const workId of plans.applied_work_ids)
         governed.set(workId, readWorkItem(coordRoot, workId));
@@ -511,6 +615,12 @@ function collectGovernedWork(coordRoot, originalRootWorkId, plans, active) {
         governed.set(record.intent.id, record);
     return [...governed.values()];
 }
+function workIntentExists(coordRoot, workId) {
+    return existsSync(join(resolve(coordRoot), ".harnery", "work", workId, "intent.json"));
+}
+function missionRootId(goalId) {
+    return `${goalId.slice(0, 87)}-mission-root`;
+}
 function supervisorDir(coordRoot, goalId) {
     assertSupervisorId(goalId);
     return join(resolve(coordRoot), ".harnery", "supervisors", goalId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",

package/src/commands/supervisor.ts

@@ -9,6 +9,7 @@ import type { PolicyIsolation } from "../core/policy/index.ts";
 import { loadPolicyFile } from "../core/policy/index.ts";
 import {
   approveSupervisorPlan,
+  type CreateSupervisorMissionInput,
   type CreateSupervisorReplanningInput,
   configureSupervisorService,
   createSupervisor,
@@ -46,6 +47,7 @@ interface CreateOpts {
   resumeApproved?: boolean;
   retryBlocked?: boolean;
   replanning?: string;
+  mission?: string;
   json?: boolean;
 }
 
@@ -75,8 +77,8 @@ export function registerSupervisorCommand(program: Command, emit: EmitContext):
     .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)")
@@ -90,8 +92,9 @@ export function registerSupervisorCommand(program: Command, emit: EmitContext):
     .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: string, opts: CreateOpts) => {
+    .action((rootWorkId: string | undefined, opts: CreateOpts) => {
       withSupervisorRoot(emit, (coordRoot) => {
         const specialists = readTeamFile(opts.team);
         for (const [id, profile] of Object.entries(specialists)) {
@@ -121,6 +124,7 @@ export function registerSupervisorCommand(program: Command, emit: EmitContext):
               resume_approved: opts.resumeApproved,
               retry_blocked: opts.retryBlocked,
             },
+            mission: opts.mission ? readMissionFile(opts.mission) : undefined,
             replanning: opts.replanning ? readReplanningFile(opts.replanning) : undefined,
           }),
           opts.json,
@@ -626,6 +630,34 @@ function readReplanningFile(path: string): CreateSupervisorReplanningInput {
   };
 }
 
+function readMissionFile(path: string): CreateSupervisorMissionInput {
+  const absolute = resolve(path);
+  let value: unknown;
+  try {
+    value = JSON.parse(readFileSync(absolute, "utf8"));
+  } catch (error) {
+    throw new Error(`cannot read supervisor mission at ${absolute}: ${(error as Error).message}`);
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("supervisor mission must be a JSON object");
+  }
+  const config = value as Record<string, unknown>;
+  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 as string[],
+    maxMilestones: jsonInteger(config.max_milestones, "mission max_milestones"),
+  };
+}
+
 function emitSupervisor(
   record: SupervisorRecord,
   json: boolean | undefined,
@@ -645,7 +677,7 @@ function emitSupervisor(
   const lines = [
     `${record.intent.id}: ${record.intent.title}`,
     `state: ${projection.state}`,
-    `root: ${projection.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}`,
@@ -663,6 +695,13 @@ function emitSupervisor(
     }
     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(", ")}`);
   }
@@ -724,6 +763,7 @@ function emitPlan(plan: SupervisorPlanRecord, json: boolean | undefined, emit: E
     `${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}`,
   ];
@@ -731,6 +771,9 @@ function emitPlan(plan: SupervisorPlanRecord, json: boolean | undefined, emit: E
     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}`);

package/src/core/supervisor/index.ts

@@ -7,6 +7,7 @@ export {
   type SupervisorPlanEvent,
   type SupervisorPlanEventType,
   type SupervisorPlanHistory,
+  type SupervisorPlanMilestone,
   type SupervisorPlanOutcome,
   type SupervisorPlanProposal,
   type SupervisorPlanRecord,
@@ -53,6 +54,7 @@ export {
 export {
   assertSupervisorId,
   type CreateSupervisorInput,
+  type CreateSupervisorMissionInput,
   collectSupervisorWork,
   createSupervisor,
   listSupervisors,
@@ -62,6 +64,7 @@ export {
   type SupervisorAutomationPolicy,
   type SupervisorIntent,
   type SupervisorLimits,
+  type SupervisorMission,
   type SupervisorNextAction,
   type SupervisorProjection,
   type SupervisorRecord,