@isaacriehm/cairn-core 0.9.7 → 0.10.0

package/dist/missions/cli.js

@@ -0,0 +1,279 @@
+/**
+ * CLI wrappers around the mission MCP tools — `cairn mission ...`
+ * subcommands. Reuses the helper modules (cursor, draft, task-link)
+ * directly so the CLI stays in lock-step with the MCP surface.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, resolve as pathResolve } from "node:path";
+import { appendMissionJournal, archiveMission, countDonePhases, deriveMissionId, detectRoadmapDrift, findActiveMission, initialPhaseProgress, listActiveMissionIds, listDoneMissionIds, locateMission, nextPendingPhase, readMissionState, readRoadmap, restoreMission, writeMissionSpec, writeMissionState, writeRoadmap, } from "@isaacriehm/cairn-state";
+import { advancePhase } from "./cursor.js";
+import { draftRoadmapFromSpec, stubRoadmap } from "./draft.js";
+export async function runMissionStart(args) {
+    if (findActiveMission(args.repoRoot) !== null) {
+        throw new Error("An active mission already exists; close or abort it before starting another.");
+    }
+    const abs = isAbsolute(args.specPath) ? args.specPath : pathResolve(args.repoRoot, args.specPath);
+    if (!abs.startsWith(args.repoRoot)) {
+        throw new Error(`${args.specPath} resolves outside the repo`);
+    }
+    if (!existsSync(abs)) {
+        throw new Error(`Spec doc not found: ${args.specPath}`);
+    }
+    const source = readFileSync(abs, "utf8");
+    const proposedTitle = deriveTitleFromSpec(source, args.specPath);
+    if (args.noLlm === true) {
+        return {
+            proposed_title: proposedTitle,
+            spec_path: args.specPath,
+            exit_gate: args.exitGate,
+            phases: stubRoadmap(),
+            llm_used: false,
+        };
+    }
+    const draft = await draftRoadmapFromSpec({
+        repoRoot: args.repoRoot,
+        spec: source,
+        specPath: args.specPath,
+    });
+    if (draft === null) {
+        throw new Error("Haiku failed to parse the spec doc; retry or pass --no-llm");
+    }
+    return {
+        proposed_title: proposedTitle,
+        spec_path: args.specPath,
+        exit_gate: args.exitGate,
+        phases: draft.phases,
+        llm_used: true,
+    };
+}
+export function runMissionAccept(args) {
+    if (findActiveMission(args.repoRoot) !== null) {
+        throw new Error("An active mission already exists; close or abort it before starting another.");
+    }
+    const abs = isAbsolute(args.specPath) ? args.specPath : pathResolve(args.repoRoot, args.specPath);
+    if (!existsSync(abs)) {
+        throw new Error(`Spec doc not found: ${args.specPath}`);
+    }
+    const startedAt = new Date().toISOString();
+    const missionId = deriveMissionId({ title: args.title, spec_path: args.specPath, started_at: startedAt });
+    const frontmatter = {
+        mission_id: missionId,
+        title: args.title,
+        spec_path: args.specPath,
+        created_at: startedAt,
+        exit_gate: args.exitGate,
+        phases: args.phases,
+    };
+    writeRoadmap(args.repoRoot, missionId, frontmatter, `# Mission — ${args.title}\n\nSpec: \`${args.specPath}\`.\n`);
+    writeMissionSpec(args.repoRoot, missionId, readFileSync(abs, "utf8"));
+    const phaseProgress = initialPhaseProgress(frontmatter);
+    const firstPhase = nextPendingPhase(frontmatter, {
+        mission_id: missionId,
+        started_at: startedAt,
+        cursor: { active_phase: null, active_phase_started_at: null },
+        phase_progress: phaseProgress,
+        outcome: "active",
+    });
+    if (firstPhase !== null) {
+        phaseProgress[firstPhase.id] = { state: "in_progress", task_ids: [] };
+    }
+    writeMissionState(args.repoRoot, missionId, {
+        mission_id: missionId,
+        started_at: startedAt,
+        cursor: {
+            active_phase: firstPhase?.id ?? null,
+            active_phase_started_at: firstPhase !== null ? startedAt : null,
+        },
+        phase_progress: phaseProgress,
+        outcome: "active",
+    });
+    appendMissionJournal(args.repoRoot, missionId, {
+        ts: startedAt,
+        kind: "started",
+        detail: `${args.phases.length} phases, exit_gate=${args.exitGate}`,
+    });
+    return {
+        mission_id: missionId,
+        cursor: { active_phase: firstPhase?.id ?? null },
+        total_phases: args.phases.length,
+    };
+}
+export function runMissionGet(repoRoot) {
+    const id = findActiveMission(repoRoot);
+    if (id === null)
+        return { active: false };
+    const roadmap = readRoadmap(repoRoot, id);
+    const state = readMissionState(repoRoot, id);
+    if (roadmap === null || state === null)
+        return { active: false };
+    return {
+        active: true,
+        mission_id: id,
+        title: roadmap.frontmatter.title,
+        cursor: { active_phase: state.cursor.active_phase },
+        progress: { done: countDonePhases(state), total: roadmap.frontmatter.phases.length },
+        drift_phase_ids: detectRoadmapDrift(roadmap.frontmatter, state),
+    };
+}
+export function runMissionAdvance(args) {
+    const missionId = findActiveMission(args.repoRoot);
+    if (missionId === null)
+        throw new Error("No active mission");
+    const state = readMissionState(args.repoRoot, missionId);
+    if (state === null)
+        throw new Error(`state.json missing for ${missionId}`);
+    const roadmap = readRoadmap(args.repoRoot, missionId);
+    if (roadmap === null)
+        throw new Error(`roadmap.md missing for ${missionId}`);
+    if (args.drop === true) {
+        if (roadmap.frontmatter.phases.some((p) => p.id === args.phaseId)) {
+            throw new Error(`phase ${args.phaseId} is still in roadmap.md; --drop only resolves drifted ids`);
+        }
+        const progress = state.phase_progress[args.phaseId];
+        if (progress === undefined) {
+            throw new Error(`phase ${args.phaseId} not present in phase_progress`);
+        }
+        const taskIds = progress.task_ids;
+        delete state.phase_progress[args.phaseId];
+        writeMissionState(args.repoRoot, missionId, state);
+        appendMissionJournal(args.repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "drift-detected",
+            phase_id: args.phaseId,
+            detail: `dropped — ${taskIds.length} graduated task(s) orphaned`,
+        });
+        return { kind: "dropped", phase_id: args.phaseId, orphaned_task_ids: taskIds };
+    }
+    if (args.force !== true) {
+        const progress = state.phase_progress[args.phaseId];
+        if (progress === undefined || progress.task_ids.length === 0) {
+            throw new Error(`phase ${args.phaseId} has no linked tasks; pass --force to advance`);
+        }
+    }
+    const r = advancePhase(args.repoRoot, missionId, args.phaseId);
+    if (!r.ok)
+        throw new Error(r.message);
+    return {
+        kind: "advanced",
+        phase_advanced: r.phase_advanced,
+        next_phase: r.next_phase?.id ?? null,
+        closed: r.closed,
+    };
+}
+export function runMissionClose(repoRoot, missionId, outcome, reason) {
+    if (locateMission(repoRoot, missionId) !== "active") {
+        throw new Error(`Mission ${missionId} is not active`);
+    }
+    const state = readMissionState(repoRoot, missionId);
+    if (state === null)
+        throw new Error(`state.json missing for ${missionId}`);
+    const closedAt = new Date().toISOString();
+    state.outcome = outcome;
+    state.cursor.active_phase = null;
+    state.cursor.active_phase_started_at = null;
+    state.closed_at = closedAt;
+    if (outcome === "aborted" && reason !== undefined)
+        state.abort_reason = reason;
+    writeMissionState(repoRoot, missionId, state);
+    appendMissionJournal(repoRoot, missionId, {
+        ts: closedAt,
+        kind: "closed",
+        detail: outcome === "aborted" ? `aborted${reason !== undefined ? `: ${reason}` : ""}` : "manual close",
+    });
+    archiveMission(repoRoot, missionId);
+    return { mission_id: missionId, outcome, closed_at: closedAt };
+}
+export function runMissionReopen(repoRoot, missionId) {
+    if (locateMission(repoRoot, missionId) !== "done") {
+        throw new Error(`Mission ${missionId} is not archived`);
+    }
+    if (findActiveMission(repoRoot) !== null) {
+        throw new Error("Another mission is already active");
+    }
+    if (!restoreMission(repoRoot, missionId)) {
+        throw new Error(`Could not restore archived dirs for ${missionId}`);
+    }
+    const state = readMissionState(repoRoot, missionId);
+    const reopenedAt = new Date().toISOString();
+    if (state !== null) {
+        state.outcome = "active";
+        delete state.closed_at;
+        delete state.abort_reason;
+        writeMissionState(repoRoot, missionId, state);
+    }
+    appendMissionJournal(repoRoot, missionId, {
+        ts: reopenedAt,
+        kind: "reopened",
+        detail: `cursor: ${state?.cursor.active_phase ?? "(none)"}`,
+    });
+    return {
+        mission_id: missionId,
+        cursor: state?.cursor ?? null,
+        reopened_at: reopenedAt,
+    };
+}
+export function listMissions(repoRoot) {
+    return {
+        active: listActiveMissionIds(repoRoot),
+        done: listDoneMissionIds(repoRoot),
+    };
+}
+function deriveTitleFromSpec(source, fallback) {
+    const m = source.match(/^#\s+(.+?)\s*$/m);
+    const raw = m?.[1] ?? fallback.replace(/^.*\//, "").replace(/\.[a-z]+$/i, "");
+    return raw.slice(0, 60);
+}
+/**
+ * Pretty-print a roadmap to a string for `cairn mission start --print`
+ * preview output. Matches the YAML-frontmatter shape Cairn writes to
+ * disk so the operator can copy + edit it before approval.
+ */
+export function previewRoadmap(args) {
+    const lines = [];
+    lines.push(`# Mission preview — ${args.title}`);
+    lines.push("");
+    lines.push(`spec_path: ${args.specPath}`);
+    lines.push(`exit_gate: ${args.exitGate}`);
+    lines.push("");
+    lines.push("Phases:");
+    for (const p of args.phases) {
+        lines.push(`  - ${p.id}: ${p.title}`);
+        if (p.depends_on.length > 0)
+            lines.push(`    depends_on: ${p.depends_on.join(", ")}`);
+        lines.push(`    exit_criteria: ${p.exit_criteria}`);
+    }
+    return lines.join("\n");
+}
+/** Used by `cairn mission accept --from <file>` to load a hand-edited roadmap draft. */
+export function loadDraftFromFile(path) {
+    if (!existsSync(path))
+        throw new Error(`Draft file not found: ${path}`);
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null)
+        throw new Error("Draft file must be a JSON object");
+    const obj = parsed;
+    if (typeof obj["title"] !== "string")
+        throw new Error("Draft missing title");
+    if (typeof obj["spec_path"] !== "string")
+        throw new Error("Draft missing spec_path");
+    if (typeof obj["exit_gate"] !== "string")
+        throw new Error("Draft missing exit_gate");
+    if (!Array.isArray(obj["phases"]))
+        throw new Error("Draft missing phases array");
+    const exitGate = obj["exit_gate"];
+    if (exitGate !== "prompt" && exitGate !== "auto" && exitGate !== "manual") {
+        throw new Error(`Invalid exit_gate: ${exitGate}`);
+    }
+    return {
+        title: obj["title"],
+        spec_path: obj["spec_path"],
+        exit_gate: exitGate,
+        phases: obj["phases"],
+    };
+}
+/** Persist the proposed roadmap draft to a temp JSON file for hand-editing. */
+export function writeDraftToFile(path, draft) {
+    writeFileSync(path, JSON.stringify(draft, null, 2) + "\n", "utf8");
+}
+//# sourceMappingURL=cli.js.map

package/dist/missions/cli.js.map

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

package/dist/missions/cursor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Mission cursor advance helpers — shared logic between the explicit
+ * `cairn_mission_advance` MCP tool, the Stop hook auto-advance path
+ * (exit_gate=auto), and the Stop hook prompt path (exit_gate=prompt
+ * after operator picks `a`).
+ */
+import { type MissionPhase, type MissionRoadmapFrontmatter, type MissionState } from "@isaacriehm/cairn-state";
+export interface AdvanceResult {
+    ok: true;
+    phase_advanced: string;
+    next_phase: MissionPhase | null;
+    /** True when this advance closed the mission. */
+    closed: boolean;
+    donePhases: number;
+    totalPhases: number;
+}
+export interface AdvanceError {
+    ok: false;
+    code: "MISSION_NOT_FOUND" | "PHASE_NOT_FOUND" | "PHASE_ALREADY_DONE" | "ROADMAP_MISSING" | "STATE_MISSING";
+    message: string;
+}
+/**
+ * Mark `phaseId` as done in `phase_progress` and pick the next pending
+ * phase whose `depends_on` set is satisfied. When no eligible phase
+ * remains, set `cursor.active_phase = null`, mark `outcome: done`, and
+ * archive the mission dirs.
+ */
+export declare function advancePhase(repoRoot: string, missionId: string, phaseId: string, now?: Date): AdvanceResult | AdvanceError;
+/**
+ * Determine whether every linked task on a phase has graduated.
+ * Returns `false` when the phase has zero tasks (the operator has to
+ * `mission_advance --force` for empty phases — never auto-advance an
+ * empty phase silently).
+ */
+export declare function allPhaseTasksDone(state: MissionState, phaseId: string, taskIsDone: (taskId: string) => boolean): boolean;
+/**
+ * Resolve a roadmap phase by id from a mission's roadmap. Returns null
+ * when the id was deleted in a mid-mission roadmap edit (drift case).
+ */
+export declare function lookupPhase(roadmap: MissionRoadmapFrontmatter, phaseId: string): MissionPhase | null;

package/dist/missions/cursor.js

@@ -0,0 +1,99 @@
+/**
+ * Mission cursor advance helpers — shared logic between the explicit
+ * `cairn_mission_advance` MCP tool, the Stop hook auto-advance path
+ * (exit_gate=auto), and the Stop hook prompt path (exit_gate=prompt
+ * after operator picks `a`).
+ */
+import { appendMissionJournal, archiveMission, countDonePhases, nextPendingPhase, readMissionState, readRoadmap, writeMissionState, } from "@isaacriehm/cairn-state";
+/**
+ * Mark `phaseId` as done in `phase_progress` and pick the next pending
+ * phase whose `depends_on` set is satisfied. When no eligible phase
+ * remains, set `cursor.active_phase = null`, mark `outcome: done`, and
+ * archive the mission dirs.
+ */
+export function advancePhase(repoRoot, missionId, phaseId, now = new Date()) {
+    const roadmap = readRoadmap(repoRoot, missionId);
+    if (roadmap === null) {
+        return { ok: false, code: "ROADMAP_MISSING", message: `roadmap.md missing for ${missionId}` };
+    }
+    const state = readMissionState(repoRoot, missionId);
+    if (state === null) {
+        return { ok: false, code: "STATE_MISSING", message: `state.json missing for ${missionId}` };
+    }
+    const phaseDef = roadmap.frontmatter.phases.find((p) => p.id === phaseId);
+    if (phaseDef === undefined) {
+        return { ok: false, code: "PHASE_NOT_FOUND", message: `phase ${phaseId} not in roadmap` };
+    }
+    const progress = state.phase_progress[phaseId];
+    if (progress?.state === "done") {
+        return { ok: false, code: "PHASE_ALREADY_DONE", message: `phase ${phaseId} already done` };
+    }
+    const ts = now.toISOString();
+    state.phase_progress[phaseId] = {
+        state: "done",
+        task_ids: progress?.task_ids ?? [],
+        graduated_at: ts,
+    };
+    const next = nextPendingPhase(roadmap.frontmatter, state);
+    if (next !== null) {
+        state.cursor.active_phase = next.id;
+        state.cursor.active_phase_started_at = ts;
+        state.phase_progress[next.id] = {
+            state: "in_progress",
+            task_ids: state.phase_progress[next.id]?.task_ids ?? [],
+        };
+    }
+    else {
+        state.cursor.active_phase = null;
+        state.cursor.active_phase_started_at = null;
+        state.outcome = "done";
+        state.closed_at = ts;
+    }
+    writeMissionState(repoRoot, missionId, state);
+    appendMissionJournal(repoRoot, missionId, {
+        ts,
+        kind: "phase-advanced",
+        phase_id: phaseId,
+        detail: next !== null ? `next: ${next.id}` : "mission complete",
+    });
+    let closed = false;
+    if (next === null) {
+        appendMissionJournal(repoRoot, missionId, {
+            ts,
+            kind: "closed",
+            detail: "auto-close on last phase complete",
+        });
+        archiveMission(repoRoot, missionId);
+        closed = true;
+    }
+    return {
+        ok: true,
+        phase_advanced: phaseId,
+        next_phase: next,
+        closed,
+        donePhases: countDonePhases(state),
+        totalPhases: roadmap.frontmatter.phases.length,
+    };
+}
+/**
+ * Determine whether every linked task on a phase has graduated.
+ * Returns `false` when the phase has zero tasks (the operator has to
+ * `mission_advance --force` for empty phases — never auto-advance an
+ * empty phase silently).
+ */
+export function allPhaseTasksDone(state, phaseId, taskIsDone) {
+    const progress = state.phase_progress[phaseId];
+    if (progress === undefined)
+        return false;
+    if (progress.task_ids.length === 0)
+        return false;
+    return progress.task_ids.every(taskIsDone);
+}
+/**
+ * Resolve a roadmap phase by id from a mission's roadmap. Returns null
+ * when the id was deleted in a mid-mission roadmap edit (drift case).
+ */
+export function lookupPhase(roadmap, phaseId) {
+    return roadmap.phases.find((p) => p.id === phaseId) ?? null;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/missions/cursor.js.map

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

package/dist/missions/draft.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Mission roadmap drafting — Haiku call that turns a planning doc into
+ * an ordered phase array. One LLM-cost touchpoint per mission
+ * lifecycle. All subsequent phase advance / linking is deterministic.
+ *
+ * The model receives ONLY the spec doc + a tight system prompt; no
+ * project ground state, no MCP tools, no ambient CLAUDE.md hierarchy.
+ * `isolateAmbientContext: true` enforces that.
+ */
+import type { MissionPhase } from "@isaacriehm/cairn-state";
+export interface DraftRoadmapArgs {
+    repoRoot: string;
+    spec: string;
+    specPath: string;
+}
+export interface DraftRoadmapResult {
+    phases: MissionPhase[];
+    /** Char count of the spec slice actually fed to Haiku. */
+    spec_chars_used: number;
+    /** True when the spec was truncated to fit MAX_SPEC_CHARS. */
+    truncated: boolean;
+}
+export declare function draftRoadmapFromSpec(args: DraftRoadmapArgs): Promise<DraftRoadmapResult | null>;
+/**
+ * Single-phase fallback used when `no_llm: true` or Haiku is offline.
+ * Lets the operator hand-edit roadmap.md before approving.
+ */
+export declare function stubRoadmap(): MissionPhase[];

package/dist/missions/draft.js

@@ -0,0 +1,112 @@
+/**
+ * Mission roadmap drafting — Haiku call that turns a planning doc into
+ * an ordered phase array. One LLM-cost touchpoint per mission
+ * lifecycle. All subsequent phase advance / linking is deterministic.
+ *
+ * The model receives ONLY the spec doc + a tight system prompt; no
+ * project ground state, no MCP tools, no ambient CLAUDE.md hierarchy.
+ * `isolateAmbientContext: true` enforces that.
+ */
+import { runClaude } from "../claude/index.js";
+import { logger } from "../logger.js";
+import { z } from "zod";
+const log = logger("mission.draft");
+const TIMEOUT_MS = 180_000;
+const MAX_SPEC_CHARS = 60_000;
+const MAX_PHASES = 24;
+const SYSTEM_PROMPT = `You parse a software-project planning document into an ordered list of implementation phases.
+
+Return STRICT JSON matching the schema. No prose, no markdown.
+
+Phase rules:
+- Each phase id is kebab-case, prefixed by an ordinal (e.g. "phase-1-schema", "phase-2-jwt"). Lowercase ASCII letters, digits, hyphens only.
+- title is a tight noun-phrase summarizing the phase's deliverable (≤60 chars).
+- depends_on lists prior phase ids that must complete before this phase starts. Empty array for the first phase.
+- exit_criteria is one tight sentence describing the operator-verifiable end state of this phase. Cite concrete artifacts ("migration applied", "smoke green") not vague verbs ("works", "done").
+- Maximum ${MAX_PHASES} phases. If the spec describes finer-grained sub-tasks, group them into phases.
+- Linear or DAG, never cyclic. Every depends_on entry must be an earlier phase id.
+
+Keep phase count tight — one phase per coherent deliverable, not one per file. The roadmap is the operator's mental map; pad it and you waste their attention.`;
+const OUTPUT_SCHEMA = {
+    type: "object",
+    required: ["phases"],
+    properties: {
+        phases: {
+            type: "array",
+            minItems: 1,
+            maxItems: MAX_PHASES,
+            items: {
+                type: "object",
+                required: ["id", "title", "depends_on", "exit_criteria"],
+                properties: {
+                    id: { type: "string", pattern: "^phase-[0-9]+-[a-z0-9-]+$" },
+                    title: { type: "string", minLength: 1, maxLength: 80 },
+                    depends_on: { type: "array", items: { type: "string" } },
+                    exit_criteria: { type: "string", minLength: 1, maxLength: 200 },
+                },
+            },
+        },
+    },
+};
+const DraftResponseSchema = z.object({
+    phases: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        depends_on: z.array(z.string()),
+        exit_criteria: z.string(),
+    })),
+});
+export async function draftRoadmapFromSpec(args) {
+    const truncated = args.spec.length > MAX_SPEC_CHARS;
+    const slice = truncated ? args.spec.slice(0, MAX_SPEC_CHARS) : args.spec;
+    const prompt = `Source planning document (${args.specPath}):\n\n${slice}\n\nReturn the phase array.`;
+    let result;
+    try {
+        result = await runClaude({
+            tier: "haiku",
+            prompt,
+            system: SYSTEM_PROMPT,
+            jsonSchema: OUTPUT_SCHEMA,
+            timeoutMs: TIMEOUT_MS,
+            repoRoot: args.repoRoot,
+            cacheable: false,
+            isolateAmbientContext: true,
+            purpose: "mission.draft",
+        });
+    }
+    catch (err) {
+        log.warn({ error: err instanceof Error ? err.message : String(err) }, "mission draft Haiku call failed");
+        return null;
+    }
+    const parsed = DraftResponseSchema.safeParse(result.parsed);
+    if (!parsed.success) {
+        log.warn({ error: parsed.error.message }, "mission draft response failed schema");
+        return null;
+    }
+    const phases = parsed.data.phases.map((p) => ({
+        id: p.id,
+        title: p.title,
+        depends_on: p.depends_on,
+        exit_criteria: p.exit_criteria,
+    }));
+    return {
+        phases,
+        spec_chars_used: slice.length,
+        truncated,
+    };
+}
+/**
+ * Single-phase fallback used when `no_llm: true` or Haiku is offline.
+ * Lets the operator hand-edit roadmap.md before approving.
+ */
+export function stubRoadmap() {
+    return [
+        {
+            id: "phase-1-todo",
+            title: "Implement (single-phase stub)",
+            depends_on: [],
+            exit_criteria: "Operator hand-edits this phase list before accepting the draft.",
+        },
+    ];
+}
+//# sourceMappingURL=draft.js.map

package/dist/missions/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../src/missions/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAEpC,MAAM,UAAU,GAAG,OAAO,CAAC;AAC3B,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,aAAa,GAAG;;;;;;;;;YASV,UAAU;;;+JAGyI,CAAC;AAEhK,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC;gBACxD,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE;oBAC5D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;oBACtD,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACxD,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;iBAChE;aACF;SACF;KACF;CACe,CAAC;AAEnB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC,CACH;CACF,CAAC,CAAC;AAgBH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAsB;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACzE,MAAM,MAAM,GAAG,6BAA6B,IAAI,CAAC,QAAQ,SAAS,KAAK,6BAA6B,CAAC;IAErG,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC;YACvB,IAAI,EAAE,OAAO;YACb,MAAM;YACN,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,aAAa;YACzB,SAAS,EAAE,UAAU;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,KAAK;YAChB,qBAAqB,EAAE,IAAI;YAC3B,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3D,iCAAiC,CAClC,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CACN,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAC/B,sCAAsC,CACvC,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAmB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,aAAa,EAAE,CAAC,CAAC,aAAa;KAC/B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM;QACN,eAAe,EAAE,KAAK,CAAC,MAAM;QAC7B,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,+BAA+B;YACtC,UAAU,EAAE,EAAE;YACd,aAAa,EACX,iEAAiE;SACpE;KACF,CAAC;AACJ,CAAC"}

package/dist/missions/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mission orchestration — helpers for the `cairn_mission_*` MCP tools.
+ * State + I/O lives in `@isaacriehm/cairn-state`; this module holds
+ * the LLM call (Haiku doc-parse), cursor advance, and task linkage.
+ */
+export { draftRoadmapFromSpec, stubRoadmap, type DraftRoadmapArgs, type DraftRoadmapResult, } from "./draft.js";
+export { advancePhase as advanceMissionPhase, allPhaseTasksDone, lookupPhase, type AdvanceResult, type AdvanceError, } from "./cursor.js";
+export { onTaskCompleted, readTaskMissionAnchor, linkTaskToPhase, type TaskMissionAnchor, type TaskCompletionLink, } from "./task-link.js";
+export { listMissions, loadDraftFromFile, previewRoadmap, runMissionAccept, runMissionAdvance, runMissionClose, runMissionGet, runMissionReopen, runMissionStart, writeDraftToFile, } from "./cli.js";

package/dist/missions/index.js

@@ -0,0 +1,10 @@
+/**
+ * Mission orchestration — helpers for the `cairn_mission_*` MCP tools.
+ * State + I/O lives in `@isaacriehm/cairn-state`; this module holds
+ * the LLM call (Haiku doc-parse), cursor advance, and task linkage.
+ */
+export { draftRoadmapFromSpec, stubRoadmap, } from "./draft.js";
+export { advancePhase as advanceMissionPhase, allPhaseTasksDone, lookupPhase, } from "./cursor.js";
+export { onTaskCompleted, readTaskMissionAnchor, linkTaskToPhase, } from "./task-link.js";
+export { listMissions, loadDraftFromFile, previewRoadmap, runMissionAccept, runMissionAdvance, runMissionClose, runMissionGet, runMissionReopen, runMissionStart, writeDraftToFile, } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/missions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/missions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,WAAW,GAGZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,IAAI,mBAAmB,EACnC,iBAAiB,EACjB,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC"}