@openrig/cli 0.2.0 → 0.3.0

package/daemon/dist/domain/mission-control/mission-control-read-layer.js

@@ -0,0 +1,265 @@
+// PL-005 Phase A: Mission Control read layer.
+//
+// Maps the 7 Mission Control views to data sources:
+//   - my-queue            → queue_items where destination_session = operator
+//                            AND tier='human-gate'
+//   - human-gate          → queue_items where tier='human-gate'
+//   - fleet               → shell out to `rig ps --nodes --json` (graceful
+//                            degradation per 4-sub-clause spec)
+//   - active-work         → queue_items where state in (pending, in-progress,
+//                            blocked) sorted by priority
+//   - recent-ships        → queue_items where state in (done, handed-off)
+//                            ORDER BY ts_updated DESC LIMIT 10
+//   - recently-active     → PL-004 Phase B ViewProjector built-in view
+//   - recent-observations → stream_items table (Phase A daemon-backed source)
+//                            with ~/.openrig/stream/<date>.jsonl as graceful
+//                            degradation fallback
+//
+// Each row carries the 9-field phone-friendly content model (PRD § Acceptance
+// Criteria item 1; non-negotiable across all 7 views regardless of UI density).
+//
+// Source-of-truth integration: PL-004 daemon-backed coordination services
+// are the primary read path. Filesystem/CLI fallbacks are for graceful
+// degradation only.
+export const MISSION_CONTROL_VIEWS = [
+    "my-queue",
+    "human-gate",
+    "fleet",
+    "active-work",
+    "recent-ships",
+    "recently-active",
+    "recent-observations",
+];
+const DEFAULT_OPERATOR_SESSION = "human-operator@kernel";
+const RECENT_SHIPS_LIMIT = 10;
+const ACTIVE_WORK_LIMIT = 50;
+const RECENT_OBSERVATIONS_LIMIT = 50;
+const PRIORITY_RANK = {
+    critical: 0,
+    high: 1,
+    routine: 2,
+    background: 3,
+};
+export class MissionControlReadLayer {
+    queueRepo;
+    viewProjector;
+    streamStore;
+    fleetCliCapability;
+    defaultOperatorSession;
+    constructor(deps) {
+        this.queueRepo = deps.queueRepo;
+        this.viewProjector = deps.viewProjector;
+        this.streamStore = deps.streamStore;
+        this.fleetCliCapability = deps.fleetCliCapability;
+        this.defaultOperatorSession = deps.defaultOperatorSession ?? DEFAULT_OPERATOR_SESSION;
+    }
+    async readView(viewName, opts) {
+        switch (viewName) {
+            case "my-queue":
+                return this.readMyQueue(opts?.operatorSession ?? this.defaultOperatorSession);
+            case "human-gate":
+                return this.readHumanGate();
+            case "fleet":
+                return this.readFleet();
+            case "active-work":
+                return this.readActiveWork();
+            case "recent-ships":
+                return this.readRecentShips();
+            case "recently-active":
+                return this.readRecentlyActive();
+            case "recent-observations":
+                return this.readRecentObservations();
+        }
+    }
+    readMyQueue(operatorSession) {
+        const items = this.queueRepo.list({
+            destinationSession: operatorSession,
+            state: ["pending", "in-progress", "blocked"],
+            limit: ACTIVE_WORK_LIMIT,
+        });
+        const humanGateOnly = items.filter((q) => q.tier === "human-gate");
+        return {
+            viewName: "my-queue",
+            rows: humanGateOnly.map((q) => qitemToRow(q, { defaultReadCost: "skim/approve" })),
+            meta: { rowCount: humanGateOnly.length },
+        };
+    }
+    readHumanGate() {
+        const items = this.queueRepo.list({
+            state: ["pending", "in-progress", "blocked"],
+            limit: ACTIVE_WORK_LIMIT,
+        });
+        const humanGateOnly = items.filter((q) => q.tier === "human-gate");
+        return {
+            viewName: "human-gate",
+            rows: humanGateOnly.map((q) => qitemToRow(q, { defaultReadCost: "skim/approve" })),
+            meta: { rowCount: humanGateOnly.length },
+        };
+    }
+    async readFleet() {
+        const fleet = await this.fleetCliCapability.rollupFleet();
+        const rows = fleet.rows.map((r) => fleetRowToCompactRow(r));
+        return {
+            viewName: "fleet",
+            rows,
+            meta: {
+                rowCount: rows.length,
+                rigsRunningStaleCli: fleet.staleCliCount,
+                degradedFields: fleet.degradedFields.length > 0 ? fleet.degradedFields : undefined,
+                sourceFallback: fleet.sourceFallback ?? undefined,
+            },
+        };
+    }
+    readActiveWork() {
+        const items = this.queueRepo.list({
+            state: ["pending", "in-progress", "blocked"],
+            limit: ACTIVE_WORK_LIMIT,
+        });
+        items.sort((a, b) => {
+            const ar = PRIORITY_RANK[a.priority] ?? 99;
+            const br = PRIORITY_RANK[b.priority] ?? 99;
+            if (ar !== br)
+                return ar - br;
+            return a.tsUpdated.localeCompare(b.tsUpdated);
+        });
+        return {
+            viewName: "active-work",
+            rows: items.map((q) => qitemToRow(q, { defaultReadCost: "full" })),
+            meta: { rowCount: items.length },
+        };
+    }
+    readRecentShips() {
+        const done = this.queueRepo.list({
+            state: ["done", "handed-off"],
+            limit: RECENT_SHIPS_LIMIT * 4,
+        });
+        done.sort((a, b) => b.tsUpdated.localeCompare(a.tsUpdated));
+        const top = done.slice(0, RECENT_SHIPS_LIMIT);
+        return {
+            viewName: "recent-ships",
+            rows: top.map((q) => qitemToRow(q, { defaultReadCost: "summary-only" })),
+            meta: { rowCount: top.length },
+        };
+    }
+    readRecentlyActive() {
+        // Delegates to PL-004 Phase B's built-in `recently-active` view.
+        const result = this.viewProjector.show("recently-active");
+        const rows = result.rows.map((row) => builtinViewRowToCompactRow("recently-active", row));
+        return {
+            viewName: "recently-active",
+            rows,
+            meta: { rowCount: rows.length },
+        };
+    }
+    readRecentObservations() {
+        if (!this.streamStore) {
+            return {
+                viewName: "recent-observations",
+                rows: [],
+                meta: { rowCount: 0, sourceFallback: "stream-store-not-wired" },
+            };
+        }
+        const items = this.streamStore.list({ limit: RECENT_OBSERVATIONS_LIMIT });
+        const rows = items.map((s) => streamItemToCompactRow(s));
+        return {
+            viewName: "recent-observations",
+            rows,
+            meta: { rowCount: rows.length },
+        };
+    }
+}
+function qitemToRow(q, opts) {
+    const state = qitemStateToCompactState(q.state);
+    const nextAction = q.state === "blocked" ? `unblock: ${q.blockedOn ?? "external-gate"}` : null;
+    const pendingHumanDecision = q.tier === "human-gate" ? `${q.priority} human-gate item` : null;
+    return {
+        rigOrMissionName: q.destinationSession,
+        currentPhase: q.tier ?? null,
+        state,
+        nextAction,
+        pendingHumanDecision,
+        readCost: opts.defaultReadCost,
+        lastUpdate: q.tsUpdated,
+        confidenceFreshness: q.priority,
+        evidenceLink: null,
+        qitemId: q.qitemId,
+        rawSourceRef: q.sourceSession,
+        qitemSummary: summarizeBody(q.body),
+        qitemBody: q.body,
+    };
+}
+function summarizeBody(body) {
+    const compact = body.replace(/\s+/g, " ").trim();
+    if (compact.length <= 120)
+        return compact;
+    return `${compact.slice(0, 117).trimEnd()}...`;
+}
+function qitemStateToCompactState(state) {
+    switch (state) {
+        case "in-progress":
+            return "active";
+        case "pending":
+            return "idle";
+        case "blocked":
+            return "blocked";
+        case "failed":
+        case "denied":
+        case "canceled":
+            return "degraded";
+        case "done":
+        case "handed-off":
+            return "idle";
+    }
+}
+function fleetRowToCompactRow(r) {
+    return {
+        rigOrMissionName: r.rigName,
+        currentPhase: r.lifecycleState ?? null,
+        state: r.activityState,
+        nextAction: r.attentionReason ?? null,
+        pendingHumanDecision: null,
+        readCost: "summary-only",
+        lastUpdate: r.lastUpdate,
+        confidenceFreshness: r.cliVersionLabel,
+        evidenceLink: null,
+        qitemId: null,
+        rawSourceRef: r.rigName,
+    };
+}
+function builtinViewRowToCompactRow(viewName, row) {
+    const get = (k) => {
+        const v = row[k];
+        if (v === undefined || v === null)
+            return null;
+        return String(v);
+    };
+    return {
+        rigOrMissionName: get("destination_session") ?? get("rig_name") ?? get("rigName") ?? viewName,
+        currentPhase: get("tier") ?? get("state") ?? null,
+        state: "idle",
+        nextAction: null,
+        pendingHumanDecision: null,
+        readCost: "summary-only",
+        lastUpdate: get("ts_updated") ?? get("ts_emitted") ?? new Date().toISOString(),
+        confidenceFreshness: get("priority") ?? null,
+        evidenceLink: null,
+        qitemId: get("qitem_id"),
+        rawSourceRef: get("source_session"),
+    };
+}
+function streamItemToCompactRow(s) {
+    return {
+        rigOrMissionName: s.sourceSession,
+        currentPhase: s.hintType ?? null,
+        state: s.hintUrgency === "critical" ? "attention" : "idle",
+        nextAction: s.hintDestination ?? null,
+        pendingHumanDecision: null,
+        readCost: "summary-only",
+        lastUpdate: s.tsEmitted,
+        confidenceFreshness: s.hintUrgency ?? null,
+        evidenceLink: null,
+        qitemId: null,
+        rawSourceRef: s.streamItemId,
+    };
+}
+//# sourceMappingURL=mission-control-read-layer.js.map

package/daemon/dist/domain/mission-control/mission-control-read-layer.js.map

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

package/daemon/dist/domain/mission-control/mission-control-write-contract.d.ts

@@ -0,0 +1,69 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "../event-bus.js";
+import type { QueueRepository, QueueItem } from "../queue-repository.js";
+import { MissionControlActionLog, type MissionControlVerb } from "./mission-control-action-log.js";
+export declare class MissionControlWriteContractError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export interface MissionControlActionInput {
+    verb: MissionControlVerb;
+    qitemId: string;
+    actorSession: string;
+    /** Required for `route` and `handoff`. */
+    destinationSession?: string;
+    /** Body for the new packet on `route`/`handoff`; defaults to source body. */
+    body?: string;
+    /** Required for `annotate`. */
+    annotation?: string;
+    /** Required for `hold` and `drop`; optional advisory text otherwise. */
+    reason?: string;
+    /** Operator-supplied audit context. */
+    auditNotes?: Record<string, unknown>;
+    /**
+     * For handoff: opt-in best-effort wake. Default true (PL-004 Phase A R1
+     * pattern: durable + waking by default; operators opt out for cold queues).
+     * notify failure does NOT roll back durable state.
+     */
+    notify?: boolean;
+}
+export interface MissionControlActionResult {
+    actionId: string;
+    verb: MissionControlVerb;
+    qitemId: string;
+    closedQitem: QueueItem | null;
+    createdQitemId: string | null;
+    notifyAttempted: boolean;
+    notifyResult: string | null;
+    auditedAt: string;
+}
+interface WriteContractDeps {
+    db: Database.Database;
+    eventBus: EventBus;
+    queueRepo: QueueRepository;
+    actionLog: MissionControlActionLog;
+    now?: () => Date;
+}
+export declare class MissionControlWriteContract {
+    private readonly db;
+    private readonly eventBus;
+    private readonly queueRepo;
+    private readonly actionLog;
+    private readonly now;
+    constructor(deps: WriteContractDeps);
+    /**
+     * Execute one verb. Atomic at the durable layer: queue mutation +
+     * audit record + event persistence in one transaction. Post-commit:
+     * notify subscribers + opt-in transport wake (handoff only).
+     */
+    act(input: MissionControlActionInput): Promise<MissionControlActionResult>;
+    /**
+     * Annotate has no queue mutation — only an audit record + event.
+     * Still wrapped in a transaction so the audit + event are atomic.
+     */
+    private annotateOnly;
+    private requireMutableQitem;
+}
+export {};
+//# sourceMappingURL=mission-control-write-contract.d.ts.map

package/daemon/dist/domain/mission-control/mission-control-write-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-control-write-contract.d.ts","sourceRoot":"","sources":["../../../src/domain/mission-control/mission-control-write-contract.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EACL,uBAAuB,EAEvB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,qBAAa,gCAAiC,SAAQ,KAAK;aAEvC,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,uBAAuB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,IAAI,EAAE,iBAAiB;IAQnC;;;;OAIG;IACG,GAAG,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA+HhF;;;OAGG;YACW,YAAY;IAkD1B,OAAO,CAAC,mBAAmB;CAkB5B"}

package/daemon/dist/domain/mission-control/mission-control-write-contract.js

@@ -0,0 +1,300 @@
+// PL-005 Phase A: Mission Control write-contract — atomic 7-verb actions.
+//
+// LOAD-BEARING. Per PRD § Acceptance Criteria + slice IMPL § Guard
+// Checkpoint Focus item 2: each of 7 verbs is one atomic transaction.
+// The 4-step `handoff` shape (source-update + destination-create +
+// opt-in best-effort notify + audit-record append) is the canonical
+// proof case; other 6 verbs follow the same atomic-update + audit
+// shape with verb-specific metadata.
+//
+// Composition (one db.transaction per verb call):
+//   1. Verify the target qitem exists and isn't already terminal.
+//   2. Compute the verb-specific queue mutation via Phase D's
+//      QueueRepository.updateWithinTransaction (preserves Phase A
+//      hot-potato closure validation; emits queue.updated event).
+//   3. For handoff: also call QueueRepository.createWithinTransaction
+//      to make the destination packet (the same outer txn).
+//   4. Append the mission_control_actions audit record with before +
+//      after state snapshots.
+//   5. Persist the mission_control.action_executed event.
+//
+// Post-commit (outside the transaction): notifySubscribers + opt-in
+// best-effort transport notify. Notify failure does NOT roll back
+// durable mutations (PRD invariant: "notify failure does NOT roll
+// back durable mutations").
+//
+// Verb mappings:
+//   approve   → state="done",        closure_reason="no-follow-on"
+//   deny      → state="done",        closure_reason="denied"
+//   route     → state="done",        closure_reason="handed_off_to",
+//                closure_target+handed_off_to=<route target>;
+//                creates new qitem at the route target (1-hop)
+//   annotate  → no queue mutation; audit record only (annotation field
+//                attached to mission_control_actions)
+//   hold      → state="blocked",     closure_reason="blocked_on",
+//                closure_target+blocked_on=<reason text>
+//   drop      → state="done",        closure_reason="canceled",
+//                closure_target=<reason>
+//   handoff   → state="handed-off",  closure_reason="handed_off_to",
+//                closure_target+handed_off_to=<destination>;
+//                creates new qitem at destination (4-step canonical)
+import { MissionControlActionLogError, } from "./mission-control-action-log.js";
+export class MissionControlWriteContractError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "MissionControlWriteContractError";
+    }
+}
+export class MissionControlWriteContract {
+    db;
+    eventBus;
+    queueRepo;
+    actionLog;
+    now;
+    constructor(deps) {
+        this.db = deps.db;
+        this.eventBus = deps.eventBus;
+        this.queueRepo = deps.queueRepo;
+        this.actionLog = deps.actionLog;
+        this.now = deps.now ?? (() => new Date());
+    }
+    /**
+     * Execute one verb. Atomic at the durable layer: queue mutation +
+     * audit record + event persistence in one transaction. Post-commit:
+     * notify subscribers + opt-in transport wake (handoff only).
+     */
+    async act(input) {
+        if (input.verb === "annotate") {
+            return this.annotateOnly(input);
+        }
+        const source = this.requireMutableQitem(input.qitemId);
+        if ((input.verb === "route" || input.verb === "handoff") && !input.destinationSession) {
+            throw new MissionControlWriteContractError("destination_required", `verb=${input.verb} requires destinationSession`, { verb: input.verb });
+        }
+        const evaluatedAt = this.now().toISOString();
+        const closure = verbToClosure(input);
+        const beforeSnapshot = snapshotQitem(source);
+        let createdQitemId = null;
+        let createdDestination;
+        let createdNudge;
+        let actionEntry = null;
+        const persistedEvents = [];
+        const txn = this.db.transaction(() => {
+            // 1. Close/transition the source via Phase A's queue closure primitive.
+            const closeResult = this.queueRepo.updateWithinTransaction({
+                qitemId: input.qitemId,
+                actorSession: input.actorSession,
+                state: closure.state,
+                closureReason: closure.closureReason,
+                closureTarget: closure.closureTarget ?? undefined,
+                handedOffTo: closure.handedOffTo,
+                blockedOn: closure.blockedOn,
+                transitionNote: `mission-control:${input.verb}${input.reason ? ` (${input.reason})` : ""}`,
+            });
+            persistedEvents.push(closeResult.persistedEvent);
+            // 2. For route/handoff: create the destination packet in same txn.
+            if ((input.verb === "route" || input.verb === "handoff") && input.destinationSession) {
+                const created = this.queueRepo.createWithinTransaction({
+                    sourceSession: input.actorSession,
+                    destinationSession: input.destinationSession,
+                    body: input.body ?? source.body,
+                    priority: source.priority,
+                    tier: source.tier ?? undefined,
+                    tags: source.tags
+                        ? [...source.tags, `mission-control:${input.verb}`]
+                        : [`mission-control:${input.verb}`],
+                    chainOfRecord: [...(source.chainOfRecord ?? []), input.qitemId],
+                    // Default nudge handled post-commit per Phase D pattern.
+                    nudge: input.notify,
+                });
+                createdQitemId = created.qitemId;
+                createdDestination = created.destinationSession;
+                createdNudge = created.nudge;
+                persistedEvents.push(created.persistedEvent);
+            }
+            // 3. Append the audit record. Snapshot the closed qitem state.
+            const closedQitem = this.queueRepo.getById(input.qitemId);
+            const afterSnapshot = closedQitem ? snapshotQitem(closedQitem) : null;
+            actionEntry = this.actionLog.record({
+                actionVerb: input.verb,
+                qitemId: input.qitemId,
+                actorSession: input.actorSession,
+                actedAt: evaluatedAt,
+                beforeState: beforeSnapshot,
+                afterState: afterSnapshot,
+                reason: input.reason ?? null,
+                annotation: input.annotation ?? null,
+                notifyAttempted: false,
+                notifyResult: null,
+                auditNotes: input.auditNotes ?? null,
+            });
+            // 4. Persist the mission_control.action_executed event in same txn.
+            persistedEvents.push(this.eventBus.persistWithinTransaction({
+                type: "mission_control.action_executed",
+                actionId: actionEntry.actionId,
+                actionVerb: input.verb,
+                qitemId: input.qitemId,
+                actorSession: input.actorSession,
+            }));
+        });
+        try {
+            txn();
+        }
+        catch (err) {
+            if (err instanceof MissionControlActionLogError) {
+                throw new MissionControlWriteContractError(err.code, err.message, err.details);
+            }
+            throw err;
+        }
+        // Post-commit: fan out events.
+        for (const e of persistedEvents)
+            this.eventBus.notifySubscribers(e);
+        // Post-commit best-effort notify on handoff/route. Default true per
+        // PL-004 R1 pattern; failure does NOT roll back durable mutations.
+        let notifyAttempted = false;
+        let notifyResult = null;
+        if (createdQitemId && createdDestination && (input.verb === "route" || input.verb === "handoff")) {
+            try {
+                await this.queueRepo.maybeNudge(createdQitemId, createdDestination, createdNudge);
+                notifyAttempted = createdNudge !== false;
+                notifyResult = notifyAttempted ? "attempted-best-effort" : "skipped";
+            }
+            catch (err) {
+                notifyAttempted = true;
+                notifyResult = `failed:${err instanceof Error ? err.message : String(err)}`;
+            }
+        }
+        return {
+            actionId: actionEntry.actionId,
+            verb: input.verb,
+            qitemId: input.qitemId,
+            closedQitem: this.queueRepo.getById(input.qitemId),
+            createdQitemId,
+            notifyAttempted,
+            notifyResult,
+            auditedAt: evaluatedAt,
+        };
+    }
+    /**
+     * Annotate has no queue mutation — only an audit record + event.
+     * Still wrapped in a transaction so the audit + event are atomic.
+     */
+    async annotateOnly(input) {
+        if (!input.annotation) {
+            throw new MissionControlWriteContractError("annotation_required", `verb=annotate requires annotation`, { verb: input.verb });
+        }
+        const source = this.requireMutableQitem(input.qitemId);
+        const snapshot = snapshotQitem(source);
+        const evaluatedAt = this.now().toISOString();
+        let actionEntry = null;
+        const persistedEvents = [];
+        const txn = this.db.transaction(() => {
+            actionEntry = this.actionLog.record({
+                actionVerb: "annotate",
+                qitemId: input.qitemId,
+                actorSession: input.actorSession,
+                actedAt: evaluatedAt,
+                beforeState: snapshot,
+                afterState: snapshot,
+                annotation: input.annotation,
+                auditNotes: input.auditNotes ?? null,
+            });
+            persistedEvents.push(this.eventBus.persistWithinTransaction({
+                type: "mission_control.action_executed",
+                actionId: actionEntry.actionId,
+                actionVerb: "annotate",
+                qitemId: input.qitemId,
+                actorSession: input.actorSession,
+            }));
+        });
+        txn();
+        for (const e of persistedEvents)
+            this.eventBus.notifySubscribers(e);
+        return {
+            actionId: actionEntry.actionId,
+            verb: "annotate",
+            qitemId: input.qitemId,
+            closedQitem: this.queueRepo.getById(input.qitemId),
+            createdQitemId: null,
+            notifyAttempted: false,
+            notifyResult: null,
+            auditedAt: evaluatedAt,
+        };
+    }
+    requireMutableQitem(qitemId) {
+        const source = this.queueRepo.getById(qitemId);
+        if (!source) {
+            throw new MissionControlWriteContractError("qitem_not_found", `qitem ${qitemId} not found`, { qitemId });
+        }
+        if (source.state === "done" || source.state === "handed-off") {
+            throw new MissionControlWriteContractError("qitem_already_terminal", `qitem ${qitemId} is already terminal (state=${source.state}); Mission Control cannot mutate terminal items`, { qitemId, state: source.state });
+        }
+        return source;
+    }
+}
+function verbToClosure(input) {
+    switch (input.verb) {
+        case "approve":
+            return {
+                state: "done",
+                closureReason: "no-follow-on",
+                closureTarget: input.reason ?? null,
+            };
+        case "deny":
+            return {
+                state: "done",
+                closureReason: "denied",
+                closureTarget: input.reason ?? "operator denied",
+            };
+        case "route":
+            return {
+                state: "handed-off",
+                closureReason: "handed_off_to",
+                closureTarget: input.destinationSession,
+                handedOffTo: input.destinationSession,
+            };
+        case "hold":
+            return {
+                state: "blocked",
+                closureReason: "blocked_on",
+                closureTarget: input.reason,
+                blockedOn: input.reason,
+            };
+        case "drop":
+            return {
+                state: "done",
+                closureReason: "canceled",
+                closureTarget: input.reason,
+            };
+        case "handoff":
+            return {
+                state: "handed-off",
+                closureReason: "handed_off_to",
+                closureTarget: input.destinationSession,
+                handedOffTo: input.destinationSession,
+            };
+        case "annotate":
+            // Should never reach here — annotate is handled by annotateOnly().
+            throw new MissionControlWriteContractError("internal_invariant", "annotate verb should have been routed to annotateOnly");
+    }
+}
+function snapshotQitem(q) {
+    return {
+        qitemId: q.qitemId,
+        state: q.state,
+        sourceSession: q.sourceSession,
+        destinationSession: q.destinationSession,
+        priority: q.priority,
+        tier: q.tier,
+        closureReason: q.closureReason,
+        closureTarget: q.closureTarget,
+        handedOffTo: q.handedOffTo,
+        blockedOn: q.blockedOn,
+        tsUpdated: q.tsUpdated,
+    };
+}
+//# sourceMappingURL=mission-control-write-contract.js.map