@openrig/cli 0.5.0 → 0.5.2

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

@@ -0,0 +1,279 @@
+// 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 -A --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.
+import { userInfo } from "node:os";
+export const MISSION_CONTROL_VIEWS = [
+    "my-queue",
+    "human-gate",
+    "fleet",
+    "active-work",
+    "recent-ships",
+    "recently-active",
+    "recent-observations",
+];
+// V0.3.1 slice 05 kernel-rig-as-default — operator seat resolution
+// now cascades through the workspace.operator_seat_name typed setting
+// (deps.defaultOperatorSession injected by startup.ts which resolves
+// the setting via SettingsStore.resolveConfig()). The ultimate fallback
+// derives `operator-${USER}@kernel` from the OS username so a daemon
+// booted without the setting still routes my-queue cleanly. The
+// previous hardcoded "human-operator@kernel" literal is gone; HG-12.
+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 ?? `operator-${userInfo().username}@kernel`;
+    }
+    /** V0.3.1 slice 05 — public getter for the resolved operator seat
+     *  session. Route handlers (listDestinations, audit history) read
+     *  this so the picker + audit filter always offer the configured
+     *  operator seat even when the kernel rig isn't booted yet. */
+    getDefaultOperatorSession() {
+        return this.defaultOperatorSession;
+    }
+    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/node_modules/@openrig/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/node_modules/@openrig/daemon/dist/domain/mission-control/mission-control-write-contract.d.ts

@@ -0,0 +1,100 @@
+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;
+    /** P21 era-stamp: how actorSession was established. The route passes `transport:v1` (derived from
+     *  the transport chokepoint); omitted/null ⇒ claimed-era, never re-labeled. Recorded on the audit row. */
+    identityProvenance?: string | null;
+    /** 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;
+    /** OPR.0.4.4.19 FR-7 — required for `resolve`: the human's non-empty
+     *  decision text. Lands durably in queue_transitions.transition_note. */
+    decision?: 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;
+    /**
+     * OPR.0.4.4.19 FR-7 — resolve + unpark (all six arch rails encoded):
+     *
+     *   1. A verb in the mission-control family (this method), NOT an overload
+     *      of annotate/route.
+     *   2. The decision text lands durably + queryably in
+     *      queue_transitions.transition_note with actor_session = the
+     *      resolving session (the composer reads it there forever).
+     *   3. Unpark = blocked → in-progress via the Phase-A enum-validated
+     *      update (no state-machine change) + the existing nudge machinery.
+     *   4. Resolution routes BACK to the parked owner — the qitem keeps its
+     *      destination; no new potato owner is ever created here.
+     *   5. Enforcement symmetry: park required summary + evidence_ref;
+     *      resolve requires NON-EMPTY decision text, daemon-enforced.
+     *   6. The human acts on the surface/feed card; this is the ONE write
+     *      path (POST /api/mission-control/action verb=resolve) — the CLI
+     *      wrapper is a thin client of the same endpoint.
+     *
+     * NON-CLOSURE by contract: verbToClosure has NO resolve mapping — a
+     * resolved qitem is state=in-progress with closure_reason still null.
+     * One transaction: transition + decision note + audit row + events.
+     * The owner nudge (carrying the decision text) is post-commit
+     * best-effort — the unpark is never lost to a transport failure (BR-8).
+     */
+    private resolveParked;
+    private requireMutableQitem;
+}
+export {};
+//# sourceMappingURL=mission-control-write-contract.d.ts.map

package/node_modules/@openrig/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;AAGzC,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;8GAC0G;IAC1G,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,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;6EACyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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+JhF;;;OAGG;YACW,YAAY;IAmD1B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;YACW,aAAa;IA+G3B,OAAO,CAAC,mBAAmB;CAkB5B"}