@openrig/cli 0.2.0 → 0.3.1

package/daemon/dist/routes/kernel-status.js

@@ -0,0 +1,40 @@
+// V0.3.1 slice 05 kernel-rig-as-default — forward-fix #3 architectural.
+//
+// GET /api/kernel/status — read-only observability surface for the
+// background kernel-boot. Pairs with the architectural decoupling in
+// kernel-boot-tracker.ts: healthz binds early; this route lets
+// operators (and CLI's `--wait-for-kernel`) observe kernel agent
+// readiness independently of HTTP health.
+//
+// Returns one of two shapes:
+//
+//   200 { kernel_state, agents[], first_unready_since, variant, detail }
+//     — when the tracker is wired (the standard daemon composition).
+//
+//   503 { error: 'kernel_boot_tracker_unavailable', message: ... }
+//     — when AppDeps was constructed without a tracker (test fixtures
+//       or custom daemon compositions). Clear hint instead of a 500.
+import { Hono } from "hono";
+export const kernelStatusRoutes = new Hono();
+kernelStatusRoutes.get("/status", (c) => {
+    const tracker = c.get("kernelBootTracker");
+    if (!tracker) {
+        return c.json({
+            error: "kernel_boot_tracker_unavailable",
+            message: "Kernel-boot tracker not wired into this daemon. Use --no-kernel or check startup logs for a kernel-boot failure that prevented tracker construction.",
+        }, 503);
+    }
+    const status = tracker.getStatus();
+    return c.json({
+        kernel_state: status.kernelState,
+        agents: status.agents.map((a) => ({
+            session_name: a.sessionName,
+            runtime: a.runtime,
+            startup_status: a.startupStatus,
+        })),
+        first_unready_since: status.firstUnreadySince,
+        variant: status.variant,
+        detail: status.detail,
+    });
+});
+//# sourceMappingURL=kernel-status.js.map

package/daemon/dist/routes/kernel-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-status.js","sourceRoot":"","sources":["../../src/routes/kernel-status.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,mEAAmE;AACnE,qEAAqE;AACrE,+DAA+D;AAC/D,iEAAiE;AACjE,0CAA0C;AAC1C,EAAE;AACF,6BAA6B;AAC7B,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,EAAE;AACF,mEAAmE;AACnE,sEAAsE;AACtE,qEAAqE;AAErE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,IAAI,EAAE,CAAC;AAE7C,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;IACtC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,mBAA4B,CAAkC,CAAC;IACrF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE,iCAAiC;YACxC,OAAO,EACL,sJAAsJ;SACzJ,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,OAAO,CAAC,CAAC,IAAI,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,YAAY,EAAE,CAAC,CAAC,WAAW;YAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,cAAc,EAAE,CAAC,CAAC,aAAa;SAChC,CAAC,CAAC;QACH,mBAAmB,EAAE,MAAM,CAAC,iBAAiB;QAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/daemon/dist/routes/mission-control.d.ts

@@ -0,0 +1,37 @@
+import { Hono } from "hono";
+/**
+ * Mission Control HTTP routes (PL-005 Phase A). Backs the integrated
+ * Mission Control product UI inside the existing shell.
+ *
+ * Per Phase A R1 (PL-004) SSE route-order lesson: SSE/literal paths
+ * mounted BEFORE bare-param /:view-name catchall.
+ *
+ * Endpoints:
+ *   GET  /api/mission-control/views/:view-name   read one of 7 views
+ *   POST /api/mission-control/action              execute one of 7 verbs
+ *   GET  /api/mission-control/sse                 SSE stream of mission_control.* events
+ *   GET  /api/mission-control/watch               alias of /sse
+ *   GET  /api/mission-control/cli-capabilities    per-rig CLI capability cache
+ *   GET  /api/mission-control/destinations         handoff/route destination candidates
+ *   GET  /api/mission-control/views               list view names
+ */
+export interface MissionControlRoutesOpts {
+    /**
+     * PL-005 Phase B: bearer token enforced on write verbs (POST /action,
+     * POST /notifications/test) when set. When null, the daemon is
+     * loopback-bound and no auth is enforced (the index.ts startup
+     * check guarantees this).
+     */
+    bearerToken?: string | null;
+}
+export interface MissionControlDestination {
+    sessionName: string;
+    label: string;
+    source: "topology" | "queue";
+    rigName?: string | null;
+    logicalId?: string | null;
+    runtime?: string | null;
+    status?: string | null;
+}
+export declare function missionControlRoutes(opts?: MissionControlRoutesOpts): Hono;
+//# sourceMappingURL=mission-control.d.ts.map

package/daemon/dist/routes/mission-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-control.d.ts","sourceRoot":"","sources":["../../src/routes/mission-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAuB5B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,wBAAwB,GAAG,IAAI,CA2W1E"}

package/daemon/dist/routes/mission-control.js

@@ -0,0 +1,306 @@
+import { Hono } from "hono";
+import { streamSSE } from "hono/streaming";
+import { authBearerTokenMiddleware } from "../middleware/auth-bearer-token.js";
+import { MissionControlActionLogError, MISSION_CONTROL_VERBS, } from "../domain/mission-control/mission-control-action-log.js";
+import { MISSION_CONTROL_VIEWS, } from "../domain/mission-control/mission-control-read-layer.js";
+import { MissionControlWriteContractError, } from "../domain/mission-control/mission-control-write-contract.js";
+export function missionControlRoutes(opts) {
+    const app = new Hono();
+    const bearerToken = opts?.bearerToken ?? null;
+    // PL-005 Phase B: bearer-token middleware mounted on write verbs.
+    // Reads remain open behind tailnet bind for the headed-browser-from-
+    // phone case where the operator hasn't typed the token into mobile
+    // yet — the bearer is for write integrity, not view confidentiality.
+    // (Operator may extend gating to reads by mounting on read paths in
+    // a future revision; v0 default per planner brief is gate-writes-only.)
+    const requireAuth = authBearerTokenMiddleware({ expectedToken: bearerToken });
+    function getReadLayer(c) {
+        return c.get("missionControlReadLayer");
+    }
+    function getAuditBrowse(c) {
+        return c.get("missionControlAuditBrowse");
+    }
+    function getNotificationDispatcher(c) {
+        return c.get("missionControlNotificationDispatcher");
+    }
+    function getWriteContract(c) {
+        return c.get("missionControlWriteContract");
+    }
+    function getCliCapability(c) {
+        return c.get("missionControlFleetCliCapability");
+    }
+    function getEventBus(c) {
+        return c.get("eventBus");
+    }
+    function getDb(c) {
+        return c.get("db");
+    }
+    function tableExists(db, tableName) {
+        const row = db
+            .prepare("SELECT 1 AS present FROM sqlite_master WHERE type = 'table' AND name = ?")
+            .get(tableName);
+        return Boolean(row);
+    }
+    function listDestinations(db, operatorSeatFallback) {
+        const destinations = new Map();
+        const addDestination = (candidate) => {
+            const sessionName = candidate.sessionName.trim();
+            if (!sessionName)
+                return;
+            const existing = destinations.get(sessionName);
+            if (!existing || candidate.source === "topology") {
+                destinations.set(sessionName, { ...candidate, sessionName });
+            }
+        };
+        if (tableExists(db, "sessions") && tableExists(db, "nodes") && tableExists(db, "rigs")) {
+            const rows = db
+                .prepare(`
+            SELECT
+              s.session_name,
+              s.status,
+              n.logical_id,
+              n.runtime,
+              r.name AS rig_name
+            FROM sessions s
+            JOIN nodes n ON n.id = s.node_id
+            JOIN rigs r ON r.id = n.rig_id
+            WHERE s.session_name IS NOT NULL AND TRIM(s.session_name) != ''
+            ORDER BY r.name COLLATE NOCASE, n.logical_id COLLATE NOCASE, s.session_name COLLATE NOCASE
+          `)
+                .all();
+            for (const row of rows) {
+                const topologyLabel = row.logical_id && row.rig_name ? `${row.logical_id}@${row.rig_name}` : null;
+                addDestination({
+                    sessionName: row.session_name,
+                    label: topologyLabel && topologyLabel !== row.session_name
+                        ? `${topologyLabel} - ${row.session_name}`
+                        : row.session_name,
+                    source: "topology",
+                    rigName: row.rig_name,
+                    logicalId: row.logical_id,
+                    runtime: row.runtime,
+                    status: row.status,
+                });
+            }
+        }
+        if (tableExists(db, "queue_items")) {
+            const rows = db
+                .prepare(`
+            SELECT DISTINCT TRIM(session_name) AS session_name
+            FROM (
+              SELECT source_session AS session_name FROM queue_items
+              UNION
+              SELECT destination_session AS session_name FROM queue_items
+              UNION
+              SELECT handed_off_to AS session_name FROM queue_items
+              UNION
+              SELECT handed_off_from AS session_name FROM queue_items
+            )
+            WHERE session_name IS NOT NULL AND TRIM(session_name) != ''
+            ORDER BY session_name COLLATE NOCASE
+          `)
+                .all();
+            for (const row of rows) {
+                addDestination({
+                    sessionName: row.session_name,
+                    label: row.session_name,
+                    source: "queue",
+                });
+            }
+        }
+        // V0.3.1 slice 05 — belt-and-suspenders for kernel-down state: if
+        // the configured operator seat isn't in the topology + queue
+        // history yet (fresh install, kernel hasn't booted, or kernel
+        // crashed), still include it so the picker can route to the
+        // seat the rest of the daemon's mission-control read layer will
+        // resolve. Source label intentionally stays "queue" so the picker
+        // sort order keeps live topology entries on top.
+        if (operatorSeatFallback) {
+            const trimmed = operatorSeatFallback.trim();
+            if (trimmed && !destinations.has(trimmed)) {
+                destinations.set(trimmed, {
+                    sessionName: trimmed,
+                    label: trimmed,
+                    source: "queue",
+                });
+            }
+        }
+        return [...destinations.values()].sort((a, b) => {
+            if (a.source !== b.source)
+                return a.source === "topology" ? -1 : 1;
+            return a.label.localeCompare(b.label);
+        });
+    }
+    function errorResponse(c, err) {
+        if (err instanceof MissionControlActionLogError) {
+            const status = err.code === "verb_unknown" ? 400
+                : err.code === "annotation_required" || err.code === "reason_required" ? 400
+                    : 500;
+            return c.json({ error: err.code, message: err.message, ...(err.details ?? {}) }, status);
+        }
+        if (err instanceof MissionControlWriteContractError) {
+            const status = err.code === "qitem_not_found" ? 404
+                : err.code === "qitem_already_terminal" ? 409
+                    : err.code === "destination_required" ? 400
+                        : err.code === "annotation_required" ? 400
+                            : 500;
+            return c.json({ error: err.code, message: err.message, ...(err.details ?? {}) }, status);
+        }
+        const message = err instanceof Error ? err.message : "internal error";
+        return c.json({ error: "internal_error", message }, 500);
+    }
+    // GET /views — list view names. MUST precede /views/:view-name catchall.
+    app.get("/views", (c) => {
+        return c.json({ views: [...MISSION_CONTROL_VIEWS] });
+    });
+    // GET /cli-capabilities — fleet roll-up + drift indicator.
+    app.get("/cli-capabilities", async (c) => {
+        const fleet = await getCliCapability(c).rollupFleet();
+        return c.json(fleet);
+    });
+    // GET /destinations — phone-friendly route/handoff candidates. MUST precede
+    // /views/:view-name catchall with the other Mission Control literal routes.
+    // V0.3.1 slice 05 — resolve the operator-seat fallback from the
+    // mission-control read layer's defaultOperatorSession (which itself
+    // tracks the workspace.operator_seat_name setting) so the picker
+    // always offers the configured operator seat even when the kernel
+    // hasn't booted yet.
+    app.get("/destinations", (c) => {
+        const db = getDb(c);
+        if (!db)
+            return c.json({ destinations: [] });
+        const operatorSeat = getReadLayer(c).getDefaultOperatorSession();
+        return c.json({ destinations: listDestinations(db, operatorSeat) });
+    });
+    // SSE for mission_control.* events. MUST precede /views/:view-name
+    // (per PL-004 Phase A R1 SSE route-order lesson).
+    const sseHandler = (c) => {
+        const eventBus = getEventBus(c);
+        return streamSSE(c, async (stream) => {
+            const unsubscribe = eventBus.subscribe((event) => {
+                if (event.type !== "mission_control.action_executed" &&
+                    event.type !== "mission_control.cli_drift_detected" &&
+                    event.type !== "mission_control.view_refreshed")
+                    return;
+                const sse = { id: String(event.seq), data: JSON.stringify(event) };
+                stream.writeSSE(sse).catch(() => { });
+            });
+            try {
+                await new Promise((resolve) => stream.onAbort(() => resolve()));
+            }
+            finally {
+                unsubscribe();
+            }
+        });
+    };
+    app.get("/sse", sseHandler);
+    app.get("/watch", sseHandler);
+    // PL-005 Phase B: bearer-token gate on write verbs.
+    app.post("/action", requireAuth);
+    app.post("/notifications/test", requireAuth);
+    // POST /action — execute one of 7 verbs through the atomic write contract.
+    app.post("/action", async (c) => {
+        const body = await c.req
+            .json()
+            .catch(() => ({}));
+        if (!body.verb)
+            return c.json({ error: "verb is required" }, 400);
+        if (!MISSION_CONTROL_VERBS.includes(body.verb)) {
+            return c.json({
+                error: "verb_unknown",
+                message: `unknown verb '${body.verb}'; supported: ${MISSION_CONTROL_VERBS.join(", ")}`,
+                supported: [...MISSION_CONTROL_VERBS],
+            }, 400);
+        }
+        if (!body.qitemId)
+            return c.json({ error: "qitemId is required" }, 400);
+        if (!body.actorSession)
+            return c.json({ error: "actorSession is required" }, 400);
+        try {
+            const result = await getWriteContract(c).act({
+                verb: body.verb,
+                qitemId: body.qitemId,
+                actorSession: body.actorSession,
+                destinationSession: body.destinationSession,
+                body: body.body,
+                annotation: body.annotation,
+                reason: body.reason,
+                notify: body.notify,
+                auditNotes: body.auditNotes,
+            });
+            return c.json(result);
+        }
+        catch (err) {
+            return errorResponse(c, err);
+        }
+    });
+    // PL-005 Phase B: GET /audit — read-only browse over mission_control_actions.
+    // MUST come BEFORE /views/:view-name catchall (route-order discipline
+    // per PL-004 Phase A R1 lesson).
+    app.get("/audit", async (c) => {
+        const audit = getAuditBrowse(c);
+        if (!audit)
+            return c.json({ error: "audit_browse_unavailable" }, 500);
+        const qitemId = c.req.query("qitem_id") || undefined;
+        const actionVerb = c.req.query("action_verb") || undefined;
+        const actorSession = c.req.query("actor_session") || undefined;
+        const since = c.req.query("since") || undefined;
+        const until = c.req.query("until") || undefined;
+        const limit = c.req.query("limit") ? Number.parseInt(c.req.query("limit"), 10) : undefined;
+        const beforeId = c.req.query("before_id") || undefined;
+        try {
+            const result = audit.query({ qitemId, actionVerb, actorSession, since, until, limit, beforeId });
+            return c.json(result);
+        }
+        catch (err) {
+            return c.json({
+                error: "audit_query_failed",
+                message: err instanceof Error ? err.message : "internal error",
+            }, 500);
+        }
+    });
+    // PL-005 Phase B: POST /notifications/test — synthetic notification
+    // through the configured mechanism so the operator can verify before
+    // relying on it. Bearer-token gated (registered above).
+    app.post("/notifications/test", async (c) => {
+        const dispatcher = getNotificationDispatcher(c);
+        if (!dispatcher) {
+            return c.json({
+                error: "notifications_unconfigured",
+                message: "notifications dispatcher is not wired; configure notifications.mechanism (ntfy|webhook) in daemon config and restart",
+            }, 503);
+        }
+        try {
+            const result = await dispatcher.sendTest();
+            return c.json(result);
+        }
+        catch (err) {
+            return c.json({
+                error: "notification_test_failed",
+                message: err instanceof Error ? err.message : "internal error",
+            }, 500);
+        }
+    });
+    // GET /views/:view-name — read one of 7 views. MUST come AFTER /views,
+    // /cli-capabilities, /sse, /watch, /audit literal paths.
+    app.get("/views/:view-name", async (c) => {
+        const viewName = c.req.param("view-name");
+        if (!MISSION_CONTROL_VIEWS.includes(viewName)) {
+            return c.json({
+                error: "view_unknown",
+                message: `unknown view '${viewName}'; supported: ${MISSION_CONTROL_VIEWS.join(", ")}`,
+                supported: [...MISSION_CONTROL_VIEWS],
+            }, 404);
+        }
+        const operatorSession = c.req.query("operatorSession") || undefined;
+        try {
+            const result = await getReadLayer(c).readView(viewName, { operatorSession });
+            return c.json(result);
+        }
+        catch (err) {
+            return errorResponse(c, err);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=mission-control.js.map

package/daemon/dist/routes/mission-control.js.map

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

package/daemon/dist/routes/missions.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from "hono";
+export declare function missionsRoutes(): Hono;
+//# sourceMappingURL=missions.d.ts.map

package/daemon/dist/routes/missions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missions.d.ts","sourceRoot":"","sources":["../../src/routes/missions.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,wBAAgB,cAAc,IAAI,IAAI,CA+ErC"}

package/daemon/dist/routes/missions.js

@@ -0,0 +1,195 @@
+// V0.3.1 slice 12 walk-item 1 — mission scope data layer.
+// V0.3.1 slice 13 walk-item 7 — extended with workflow_spec frontmatter
+// + projected topology spec graph.
+//
+// GET /api/missions/:missionId — returns aggregated mission metadata
+// (missionPath + slices + optional workflow_spec declaration + optional
+// projected topology). Powers the Mission Overview / Progress / Topology
+// tabs in the Project surface; pairs with useScopeMarkdown for README /
+// PROGRESS content via the existing /api/files/read route.
+//
+// Returns:
+//   200 {
+//     missionId, missionPath, slices,
+//     workflow_spec: { name, version } | null,
+//     topology: { specGraph: SpecGraphPayload | null } | null
+//   }
+//   404 { error: "mission_not_found" } when no slices match
+//   503 { error: "slices_indexer_unavailable" } when indexer not wired
+//   503 { error: "slices_root_not_configured" } when indexer not ready
+//
+// workflow_spec is parsed lazily from <missionPath>/README.md frontmatter
+// using the same parser the slice-indexer uses. topology.specGraph is
+// projected via projectSpecGraph(spec, null) when the spec is in the
+// WorkflowSpecCache; { specGraph: null } when declared but not cached;
+// null when nothing is declared.
+import { Hono } from "hono";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parseWorkflowSpecRef } from "../domain/slices/slice-indexer.js";
+import { projectSpecGraph } from "../domain/workflow/slice-workflow-projection.js";
+export function missionsRoutes() {
+    const app = new Hono();
+    app.get("/:missionId", (c) => {
+        const indexer = c.get("sliceIndexer");
+        if (!indexer) {
+            return c.json({
+                error: "slices_indexer_unavailable",
+                hint: "Mission data layer requires the SliceIndexer to be wired into AppDeps.",
+            }, 503);
+        }
+        if (!indexer.isReady()) {
+            return c.json({
+                error: "slices_root_not_configured",
+                hint: "Run rig config init-workspace, or set workspace.slices_root to workspace/missions. Supported shape: missions/<mission>/slices/<slice>.",
+            }, 503);
+        }
+        const missionId = c.req.param("missionId");
+        const allSlices = indexer.list();
+        const slices = allSlices.filter((s) => s.missionId === missionId);
+        if (slices.length === 0) {
+            return c.json({ error: "mission_not_found", missionId }, 404);
+        }
+        const missionPath = computeMissionPath(slices[0]);
+        const workflowSpec = readMissionWorkflowSpec(missionPath);
+        const topology = computeMissionTopology(workflowSpec, c.get("workflowSpecCache"));
+        const status = readMissionStatus(missionPath);
+        return c.json({
+            missionId,
+            missionPath,
+            slices,
+            workflow_spec: workflowSpec,
+            topology,
+            status,
+        });
+    });
+    // Slice 18 §3.5 — Mark mission complete (Getting Started complete-and-hide).
+    // Writes `status: complete` to the mission README.md frontmatter; the UI
+    // storytelling preview gates on this so completed missions disappear from
+    // the band. The daemon is the audit-trail surface; the UI maintains
+    // an optimistic local mirror via localStorage so the hide is instant.
+    app.post("/:missionId/complete", (c) => {
+        const indexer = c.get("sliceIndexer");
+        if (!indexer) {
+            return c.json({ error: "slices_indexer_unavailable" }, 503);
+        }
+        const missionId = c.req.param("missionId");
+        const allSlices = indexer.list();
+        const slices = allSlices.filter((s) => s.missionId === missionId);
+        if (slices.length === 0) {
+            return c.json({ error: "mission_not_found", missionId }, 404);
+        }
+        const missionPath = computeMissionPath(slices[0]);
+        try {
+            writeMissionStatusComplete(missionPath);
+        }
+        catch (err) {
+            return c.json({
+                error: "mission_complete_write_failed",
+                missionId,
+                message: err.message,
+            }, 500);
+        }
+        return c.json({ missionId, status: "complete" });
+    });
+    return app;
+}
+/** Slice 18 §3.5 — write `status: complete` to a mission README's
+ *  frontmatter, creating the frontmatter block when absent and
+ *  replacing an existing status field when present. Idempotent.
+ *  Preserves unrelated frontmatter fields. */
+function writeMissionStatusComplete(missionPath) {
+    const readmePath = path.join(missionPath, "README.md");
+    let body = fs.existsSync(readmePath) ? fs.readFileSync(readmePath, "utf-8") : "";
+    const fmMatch = body.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (fmMatch) {
+        const fmInner = fmMatch[1] ?? "";
+        const statusLineRegex = /^\s*status\s*:\s*[^\r\n]*$/m;
+        let newFm;
+        if (statusLineRegex.test(fmInner)) {
+            newFm = fmInner.replace(statusLineRegex, "status: complete");
+        }
+        else {
+            newFm = fmInner.trimEnd() + "\nstatus: complete";
+        }
+        body = body.replace(fmMatch[0], `---\n${newFm}\n---`);
+    }
+    else {
+        body = `---\nstatus: complete\n---\n${body}`;
+    }
+    fs.writeFileSync(readmePath, body);
+}
+/** Derive the mission folder's absolute path from any slice's
+ *  `slicePath`. Slices live at
+ *  `<missionsRoot>/<missionId>/slices/<sliceName>` per the workspace
+ *  contract, so going up two levels yields the mission folder. */
+function computeMissionPath(slice) {
+    return path.resolve(slice.slicePath, "..", "..");
+}
+/** Slice 18 §3.5 — parse the `status` field from the mission README's
+ *  frontmatter. Returns the string when present (no enum validation —
+ *  v0 callers care primarily about the "complete" value but other
+ *  workflow states may appear), or null when the README is missing /
+ *  the field is absent. Powers the durable storytelling-filter for
+ *  Getting Started complete-and-hide. */
+function readMissionStatus(missionPath) {
+    const readmePath = path.join(missionPath, "README.md");
+    if (!fs.existsSync(readmePath))
+        return null;
+    const raw = fs.readFileSync(readmePath, "utf-8");
+    const fm = parseSimpleFrontmatter(raw);
+    const value = fm["status"];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+/** V0.3.1 slice 13 walk-item 7 — parse `workflow_spec` from the mission
+ *  README's frontmatter. Returns null when the README is missing or the
+ *  field is absent / malformed. Uses the same parseWorkflowSpecRef
+ *  helper the slice-indexer uses so both surfaces stay in lockstep. */
+function readMissionWorkflowSpec(missionPath) {
+    const readmePath = path.join(missionPath, "README.md");
+    if (!fs.existsSync(readmePath))
+        return null;
+    const raw = fs.readFileSync(readmePath, "utf-8");
+    const fm = parseSimpleFrontmatter(raw);
+    return parseWorkflowSpecRef(fm["workflow_spec"]);
+}
+/** Minimal frontmatter parser. The slice-indexer's parseFrontmatter is
+ *  private; duplicating the v0 shape here is cheaper than exposing
+ *  internal API and keeps the missions route's surface minimal. */
+function parseSimpleFrontmatter(text) {
+    const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!m)
+        return {};
+    const out = {};
+    for (const line of m[1].split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const colonIdx = trimmed.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        let value = trimmed.slice(colonIdx + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+/** V0.3.1 slice 13 walk-item 7 — project the spec graph when both the
+ *  declaration AND the cached spec are present. Returns the topology
+ *  envelope with `specGraph: null` when declared but not yet cached;
+ *  returns `null` for the whole envelope when nothing is declared. */
+function computeMissionTopology(workflowSpec, specCache) {
+    if (!workflowSpec)
+        return null;
+    if (!specCache)
+        return { specGraph: null };
+    const row = specCache.getByNameVersion(workflowSpec.name, workflowSpec.version);
+    if (!row)
+        return { specGraph: null };
+    // WorkflowSpecRow.spec is the WorkflowSpec object the projector expects.
+    return { specGraph: projectSpecGraph(row.spec, null) };
+}
+//# sourceMappingURL=missions.js.map

package/daemon/dist/routes/missions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missions.js","sourceRoot":"","sources":["../../src/routes/missions.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wEAAwE;AACxE,mCAAmC;AACnC,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,WAAW;AACX,UAAU;AACV,sCAAsC;AACtC,+CAA+C;AAC/C,8DAA8D;AAC9D,MAAM;AACN,4DAA4D;AAC5D,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,qEAAqE;AACrE,uEAAuE;AACvE,iCAAiC;AAEjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAMlC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAEnF,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,cAAuB,CAA6B,CAAC;QAC3E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE,4BAA4B;gBACnC,IAAI,EAAE,wEAAwE;aAC/E,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE,4BAA4B;gBACnC,IAAI,EAAE,wIAAwI;aAC/I,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,sBAAsB,CACrC,YAAY,EACZ,CAAC,CAAC,GAAG,CAAC,mBAA4B,CAAkC,CACrE,CAAC;QACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,WAAW;YACX,MAAM;YACN,aAAa,EAAE,YAAY;YAC3B,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,yEAAyE;IACzE,0EAA0E;IAC1E,oEAAoE;IACpE,sEAAsE;IACtE,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,cAAuB,CAA6B,CAAC;QAC3E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,0BAA0B,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE,+BAA+B;gBACtC,SAAS;gBACT,OAAO,EAAG,GAAa,CAAC,OAAO;aAChC,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;8CAG8C;AAC9C,SAAS,0BAA0B,CAAC,WAAmB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC1D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,6BAA6B,CAAC;QACtD,IAAI,KAAa,CAAC;QAClB,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,oBAAoB,CAAC;QACnD,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,+BAA+B,IAAI,EAAE,CAAC;IAC/C,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;kEAGkE;AAClE,SAAS,kBAAkB,CAAC,KAAqB;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;;yCAKyC;AACzC,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED;;;uEAGuE;AACvE,SAAS,uBAAuB,CAAC,WAAmB;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,oBAAoB,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;mEAEmE;AACnE,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;sEAGsE;AACtE,SAAS,sBAAsB,CAC7B,YAAoC,EACpC,SAAwC;IAExC,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,yEAAyE;IACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/daemon/dist/routes/plugins.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from "hono";
+export declare function pluginsRoutes(): Hono;
+//# sourceMappingURL=plugins.d.ts.map

package/daemon/dist/routes/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/routes/plugins.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkE5B,wBAAgB,aAAa,IAAI,IAAI,CA4HpC"}