@isaacriehm/cairn-core 0.9.8 → 0.10.0

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":"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"}

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"}

package/dist/missions/task-link.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Task ↔ mission linkage. Called by `cairn_task_complete` and the Stop
+ * hook auto-graduator after a task transitions to a terminal phase.
+ *
+ * Reads the task's status.yaml for the `mission_id` + `phase_id`
+ * stamps, appends the task id to `phase_progress[phaseId].task_ids` if
+ * not already present, and decides whether the phase is now ready to
+ * exit.
+ *
+ * - exit_gate=auto   → advance cursor immediately.
+ * - exit_gate=prompt → emit `phase_ready_to_exit` invalidation event;
+ *                      Stop hook surfaces the AskUserQuestion next tick.
+ * - exit_gate=manual → no-op; operator runs `cairn mission advance`.
+ */
+export interface TaskMissionAnchor {
+    mission_id: string;
+    phase_id: string;
+}
+/** Read the mission anchor stamped on a task's status.yaml. */
+export declare function readTaskMissionAnchor(repoRoot: string, taskId: string): TaskMissionAnchor | null;
+/** Append `taskId` to a phase's `task_ids` if not already linked. */
+export declare function linkTaskToPhase(repoRoot: string, missionId: string, phaseId: string, taskId: string): boolean;
+export type TaskCompletionLink = {
+    kind: "no-mission";
+} | {
+    kind: "linked";
+    mission_id: string;
+    phase_id: string;
+    gate: "prompt" | "auto" | "manual";
+} | {
+    kind: "phase-advanced";
+    mission_id: string;
+    phase_id: string;
+    next_phase: string | null;
+    mission_closed: boolean;
+} | {
+    kind: "phase-ready-to-exit";
+    mission_id: string;
+    phase_id: string;
+};
+/**
+ * Called after a task graduates to `succeeded` (only). Reads the
+ * task's mission anchor, links the task id, and either advances the
+ * cursor (gate=auto) or emits a `phase_ready_to_exit` invalidation
+ * event for the Stop hook (gate=prompt).
+ *
+ * Failed/aborted tasks are NOT linked (a failed task does not satisfy
+ * a phase exit). Pass-through `no-mission` when the task wasn't
+ * mission-anchored.
+ */
+export declare function onTaskCompleted(repoRoot: string, taskId: string, outcome: "succeeded" | "failed" | "aborted", taskIsDone?: (id: string) => boolean): TaskCompletionLink;

package/dist/missions/task-link.js

@@ -0,0 +1,155 @@
+/**
+ * Task ↔ mission linkage. Called by `cairn_task_complete` and the Stop
+ * hook auto-graduator after a task transitions to a terminal phase.
+ *
+ * Reads the task's status.yaml for the `mission_id` + `phase_id`
+ * stamps, appends the task id to `phase_progress[phaseId].task_ids` if
+ * not already present, and decides whether the phase is now ready to
+ * exit.
+ *
+ * - exit_gate=auto   → advance cursor immediately.
+ * - exit_gate=prompt → emit `phase_ready_to_exit` invalidation event;
+ *                      Stop hook surfaces the AskUserQuestion next tick.
+ * - exit_gate=manual → no-op; operator runs `cairn mission advance`.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * `tasks/done/<id>/` exists → the task graduated to a terminal phase
+ * (succeeded / failed / aborted). The mission task-completion linkage
+ * only counts `succeeded`; the upstream caller filters by outcome
+ * before invoking onTaskCompleted, so a present `done/<id>/` here
+ * means a sibling already graduated successfully.
+ */
+function taskIsCompletedOnDisk(repoRoot, taskId) {
+    const dir = join(repoRoot, ".cairn", "tasks", "done", taskId);
+    if (!existsSync(dir))
+        return false;
+    try {
+        return statSync(dir).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+import { appendMissionJournal, effectivePhaseExitGate, readMissionState, readRoadmap, writeMissionState, } from "@isaacriehm/cairn-state";
+import { writeInvalidationEvent } from "../events/index.js";
+import { advancePhase, allPhaseTasksDone } from "./cursor.js";
+/** Read the mission anchor stamped on a task's status.yaml. */
+export function readTaskMissionAnchor(repoRoot, taskId) {
+    const candidates = [
+        join(repoRoot, ".cairn", "tasks", "active", taskId, "status.yaml"),
+        join(repoRoot, ".cairn", "tasks", "done", taskId, "status.yaml"),
+    ];
+    for (const path of candidates) {
+        if (!existsSync(path))
+            continue;
+        let raw;
+        try {
+            raw = readFileSync(path, "utf8");
+        }
+        catch {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch {
+            continue;
+        }
+        if (parsed === null || typeof parsed !== "object")
+            continue;
+        const obj = parsed;
+        const missionId = obj["mission_id"];
+        const phaseId = obj["phase_id"];
+        if (typeof missionId === "string" && typeof phaseId === "string" && missionId.length > 0) {
+            return { mission_id: missionId, phase_id: phaseId };
+        }
+    }
+    return null;
+}
+/** Append `taskId` to a phase's `task_ids` if not already linked. */
+export function linkTaskToPhase(repoRoot, missionId, phaseId, taskId) {
+    const state = readMissionState(repoRoot, missionId);
+    if (state === null)
+        return false;
+    const progress = state.phase_progress[phaseId] ?? {
+        state: "in_progress",
+        task_ids: [],
+    };
+    if (!progress.task_ids.includes(taskId)) {
+        progress.task_ids = [...progress.task_ids, taskId];
+        state.phase_progress[phaseId] = progress;
+        writeMissionState(repoRoot, missionId, state);
+        appendMissionJournal(repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "task-attached",
+            phase_id: phaseId,
+            task_id: taskId,
+        });
+        return true;
+    }
+    return false;
+}
+/**
+ * Called after a task graduates to `succeeded` (only). Reads the
+ * task's mission anchor, links the task id, and either advances the
+ * cursor (gate=auto) or emits a `phase_ready_to_exit` invalidation
+ * event for the Stop hook (gate=prompt).
+ *
+ * Failed/aborted tasks are NOT linked (a failed task does not satisfy
+ * a phase exit). Pass-through `no-mission` when the task wasn't
+ * mission-anchored.
+ */
+export function onTaskCompleted(repoRoot, taskId, outcome, taskIsDone = (id) => taskIsCompletedOnDisk(repoRoot, id)) {
+    if (outcome !== "succeeded")
+        return { kind: "no-mission" };
+    const anchor = readTaskMissionAnchor(repoRoot, taskId);
+    if (anchor === null)
+        return { kind: "no-mission" };
+    linkTaskToPhase(repoRoot, anchor.mission_id, anchor.phase_id, taskId);
+    const roadmap = readRoadmap(repoRoot, anchor.mission_id);
+    const state = readMissionState(repoRoot, anchor.mission_id);
+    if (roadmap === null || state === null) {
+        return { kind: "linked", mission_id: anchor.mission_id, phase_id: anchor.phase_id, gate: "manual" };
+    }
+    const gate = effectivePhaseExitGate(roadmap.frontmatter, anchor.phase_id) ?? roadmap.frontmatter.exit_gate;
+    if (!allPhaseTasksDone(state, anchor.phase_id, taskIsDone)) {
+        return { kind: "linked", mission_id: anchor.mission_id, phase_id: anchor.phase_id, gate };
+    }
+    if (gate === "auto") {
+        const r = advancePhase(repoRoot, anchor.mission_id, anchor.phase_id);
+        if (r.ok) {
+            return {
+                kind: "phase-advanced",
+                mission_id: anchor.mission_id,
+                phase_id: anchor.phase_id,
+                next_phase: r.next_phase?.id ?? null,
+                mission_closed: r.closed,
+            };
+        }
+        return { kind: "linked", mission_id: anchor.mission_id, phase_id: anchor.phase_id, gate };
+    }
+    if (gate === "prompt") {
+        try {
+            writeInvalidationEvent(repoRoot, {
+                kind: "phase-ready-to-exit",
+                refs: [{ kind: "task", id: taskId }],
+                source: { session_id: null, tool: "cairn_task_complete" },
+                path: `.cairn/missions/${anchor.mission_id}/state.json`,
+            });
+        }
+        catch {
+            // best-effort
+        }
+        return {
+            kind: "phase-ready-to-exit",
+            mission_id: anchor.mission_id,
+            phase_id: anchor.phase_id,
+        };
+    }
+    return { kind: "linked", mission_id: anchor.mission_id, phase_id: anchor.phase_id, gate };
+}
+//# sourceMappingURL=task-link.js.map

package/dist/missions/task-link.js.map

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

package/dist/session-start/build.d.ts

@@ -4,7 +4,7 @@
  * filesystem reads.
  */
 type SessionStartSource = "startup" | "resume" | "clear" | "compact" | string;
-export type SessionStartSection = "first_session_onboarding" | "run_handoff" | "header" | "code_change_contract" | "two_zone_reminder" | "brand_and_positioning" | "decisions_in_scope" | "invariants_active" | "current_task" | "quality_grades_tail" | "pending_drafts";
+export type SessionStartSection = "first_session_onboarding" | "run_handoff" | "header" | "code_change_contract" | "two_zone_reminder" | "brand_and_positioning" | "decisions_in_scope" | "invariants_active" | "current_task" | "quality_grades_tail" | "pending_drafts" | "active_mission";
 export interface BuildSessionStartContextArgs {
     /** Resolved repo root (the dir containing `.cairn/`). */
     repoRoot: string;

package/dist/session-start/build.js

@@ -7,7 +7,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { parse as parseYaml } from "yaml";
 import { buildHandoffBlock } from "../context/index.js";
-import { buildDecisionsLedger, buildInvariantsLedger, parseFrontmatter, } from "@isaacriehm/cairn-state";
+import { buildDecisionsLedger, buildInvariantsLedger, countDonePhases, detectRoadmapDrift, findActiveMission, parseFrontmatter, readMissionState, readRoadmap, } from "@isaacriehm/cairn-state";
 import { loadSensorRegistry } from "../sensors/catalog.js";
 import { CODE_CHANGE_CONTRACT, SESSION_START_HEADER, TWO_ZONE_REMINDER_BASE, } from "./templates.js";
 const DEFAULT_MAX_CHARS = 12_000;
@@ -110,6 +110,8 @@ export async function buildSessionStartContext(args) {
     const drafts = listPendingDrafts(args.repoRoot, warnings);
     counts.pendingDrafts = drafts.length;
     const pendingDraftsSection = renderPendingDraftsSection(drafts);
+    // ── Section 7 — active mission cursor ─────────────────────────────
+    const activeMissionSection = renderActiveMissionSection(args.repoRoot, warnings);
     // Baseline findings drive the attention surface alongside drafts +
     // drift. Only HARD findings count — soft findings (e.g. the
     // commented-block-3-plus-lines pattern that fires on every
@@ -151,6 +153,9 @@ export async function buildSessionStartContext(args) {
     if (brandAndPositioningSection !== null) {
         orderedSections.push({ id: "brand_and_positioning", body: brandAndPositioningSection });
     }
+    if (activeMissionSection !== null) {
+        orderedSections.push({ id: "active_mission", body: activeMissionSection });
+    }
     if (currentTaskSection !== null) {
         orderedSections.push({ id: "current_task", body: currentTaskSection });
     }
@@ -176,6 +181,7 @@ export async function buildSessionStartContext(args) {
         "invariants_active",
         "decisions_in_scope",
         "current_task",
+        "active_mission",
         "two_zone_reminder",
         "header",
         "code_change_contract",
@@ -218,6 +224,57 @@ export async function buildSessionStartContext(args) {
         warnings,
     };
 }
+function renderActiveMissionSection(repoRoot, warnings) {
+    let missionId;
+    try {
+        missionId = findActiveMission(repoRoot);
+    }
+    catch (err) {
+        warnings.push(`mission lookup failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (missionId === null)
+        return null;
+    let roadmap;
+    let state;
+    try {
+        roadmap = readRoadmap(repoRoot, missionId);
+        state = readMissionState(repoRoot, missionId);
+    }
+    catch (err) {
+        warnings.push(`mission read failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (roadmap === null || state === null)
+        return null;
+    const cursorPhaseId = state.cursor.active_phase;
+    const cursorPhase = cursorPhaseId === null
+        ? null
+        : roadmap.frontmatter.phases.find((p) => p.id === cursorPhaseId) ?? null;
+    const done = countDonePhases(state);
+    const total = roadmap.frontmatter.phases.length;
+    const drift = detectRoadmapDrift(roadmap.frontmatter, state);
+    const lines = [];
+    lines.push(`## Active mission — ${roadmap.frontmatter.title}`);
+    lines.push("");
+    lines.push(`- mission: \`${missionId}\``);
+    lines.push(`- progress: ${done}/${total} phases · exit_gate: ${roadmap.frontmatter.exit_gate}`);
+    if (cursorPhase !== null) {
+        lines.push(`- cursor: \`${cursorPhase.id}\` — ${cursorPhase.title}`);
+        lines.push(`  - exit_criteria: ${cursorPhase.exit_criteria}`);
+    }
+    else {
+        lines.push(`- cursor: (no active phase — mission ready to close)`);
+    }
+    lines.push(`- spec: \`${roadmap.frontmatter.spec_path}\``);
+    if (drift.length > 0) {
+        lines.push("");
+        lines.push(`**Mission drift** — ${drift.length} phase id(s) in state.json no longer appear in roadmap.md: ${drift.map((id) => `\`${id}\``).join(", ")}. Resolve via \`cairn-attention\` (\`mission_drift\`).`);
+    }
+    lines.push("");
+    lines.push("Tasks under this cursor inherit `mission_id` + `phase_id` automatically. To work off-mission, pass `mission_id: \"\"` to `cairn_task_create` (side-task, no phase progress).");
+    return lines.join("\n");
+}
 function readBrandAndPositioning(repoRoot, warnings) {
     const brandPath = join(repoRoot, ".cairn", "ground", "brand", "overview.md");
     const positioningPath = join(repoRoot, ".cairn", "ground", "product", "positioning.md");