@openrig/cli 0.2.0 → 0.3.1

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;IAiIhF;;;OAGG;YACW,YAAY;IAkD1B,OAAO,CAAC,mBAAmB;CAkB5B"}

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

@@ -0,0 +1,302 @@
+// 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 {
+                // V0.3.1 slice 23: thread actorSession as the source so the
+                // nudge envelope shows where the route/handoff came from.
+                await this.queueRepo.maybeNudge(createdQitemId, createdDestination, createdNudge, input.actorSession);
+                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

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

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

package/daemon/dist/domain/mission-control/notification-adapter-ntfy.d.ts

@@ -0,0 +1,18 @@
+import type { NotificationAdapter, NotificationDeliveryResult, NotificationPayload } from "./notification-adapter-types.js";
+export interface NtfyAdapterOpts {
+    /**
+     * Full topic URL, e.g., `https://ntfy.sh/my-private-topic-abc123`
+     * or self-hosted `https://ntfy.example.com/operator-phone`.
+     */
+    topicUrl: string;
+    /** Optional fetch override for tests. */
+    fetchImpl?: typeof fetch;
+}
+export declare class NtfyNotificationAdapter implements NotificationAdapter {
+    readonly mechanism = "ntfy";
+    readonly target: string;
+    private readonly fetchImpl;
+    constructor(opts: NtfyAdapterOpts);
+    send(payload: NotificationPayload): Promise<NotificationDeliveryResult>;
+}
+//# sourceMappingURL=notification-adapter-ntfy.d.ts.map

package/daemon/dist/domain/mission-control/notification-adapter-ntfy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-ntfy.d.ts","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-ntfy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,QAAQ,CAAC,SAAS,UAAU;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,eAAe;IAK3B,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAyB9E"}

package/daemon/dist/domain/mission-control/notification-adapter-ntfy.js

@@ -0,0 +1,48 @@
+// PL-005 Phase B: ntfy.sh adapter (default per planner brief).
+//
+// ntfy.sh contract: HTTP POST to https://ntfy.sh/<topic> with the body
+// as the notification text. Headers like Title, Click, Tags shape the
+// rendering. Free, self-hostable, simple HTTP POST → push notification
+// on the operator's phone (ntfy mobile app subscribed to the topic).
+export class NtfyNotificationAdapter {
+    mechanism = "ntfy";
+    target;
+    fetchImpl;
+    constructor(opts) {
+        this.target = opts.topicUrl;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async send(payload) {
+        const headers = {
+            Title: truncateHeader(payload.title, 250),
+        };
+        if (payload.qitemRef)
+            headers.Click = payload.qitemRef;
+        if (payload.tags && payload.tags.length > 0) {
+            headers.Tags = payload.tags.join(",");
+        }
+        try {
+            const res = await this.fetchImpl(this.target, {
+                method: "POST",
+                headers,
+                body: payload.body,
+            });
+            if (!res.ok) {
+                return { ok: false, error: `ntfy POST ${res.status}` };
+            }
+            return { ok: true, ack: `ntfy ${res.status}` };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+/** ntfy headers must be ASCII single-line; truncate + strip newlines. */
+function truncateHeader(s, max) {
+    const cleaned = s.replace(/[\r\n]+/g, " ").trim();
+    return cleaned.length > max ? cleaned.slice(0, max - 1) + "…" : cleaned;
+}
+//# sourceMappingURL=notification-adapter-ntfy.js.map

package/daemon/dist/domain/mission-control/notification-adapter-ntfy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-ntfy.js","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-ntfy.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,uEAAuE;AACvE,qEAAqE;AAkBrE,MAAM,OAAO,uBAAuB;IACzB,SAAS,GAAG,MAAM,CAAC;IACnB,MAAM,CAAS;IACP,SAAS,CAAe;IAEzC,YAAY,IAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,MAAM,OAAO,GAA2B;YACtC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SAC1C,CAAC;QACF,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;QACvD,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,yEAAyE;AACzE,SAAS,cAAc,CAAC,CAAS,EAAE,GAAW;IAC5C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1E,CAAC"}

package/daemon/dist/domain/mission-control/notification-adapter-types.d.ts

@@ -0,0 +1,25 @@
+export interface NotificationPayload {
+    /** Short human-readable title (e.g., "human-gate qitem arrived"). */
+    title: string;
+    /** Longer body. May contain qitem id, source rig, action verb. */
+    body: string;
+    /** Optional qitem reference (URL or id) for click-through. */
+    qitemRef?: string;
+    /** Operator-supplied tags for downstream routing (Slack channel, etc.). */
+    tags?: string[];
+}
+export interface NotificationDeliveryResult {
+    ok: boolean;
+    /** When ok=true: provider-side ack (httpStatus, message-id). */
+    ack?: string;
+    /** When ok=false: human-readable error. */
+    error?: string;
+}
+export interface NotificationAdapter {
+    /** Adapter mechanism label for events / audit. */
+    readonly mechanism: string;
+    /** Target descriptor (ntfy topic URL or webhook endpoint URL). */
+    readonly target: string;
+    send(payload: NotificationPayload): Promise<NotificationDeliveryResult>;
+}
+//# sourceMappingURL=notification-adapter-types.d.ts.map

package/daemon/dist/domain/mission-control/notification-adapter-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-types.d.ts","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-types.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzE"}

package/daemon/dist/domain/mission-control/notification-adapter-types.js

@@ -0,0 +1,7 @@
+// PL-005 Phase B: shared notification adapter contract.
+//
+// Each adapter implements `send(payload)`. The dispatcher chooses the
+// adapter at construction time based on the operator's notification
+// mechanism config.
+export {};
+//# sourceMappingURL=notification-adapter-types.js.map

package/daemon/dist/domain/mission-control/notification-adapter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-types.js","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,oBAAoB"}

package/daemon/dist/domain/mission-control/notification-adapter-webhook.d.ts

@@ -0,0 +1,27 @@
+import type { NotificationAdapter, NotificationDeliveryResult, NotificationPayload } from "./notification-adapter-types.js";
+export interface WebhookAdapterOpts {
+    /** Full webhook endpoint URL. */
+    endpointUrl: string;
+    /** Optional fetch override for tests. */
+    fetchImpl?: typeof fetch;
+    /** Optional extra headers (e.g., `X-Webhook-Signature`). */
+    extraHeaders?: Record<string, string>;
+}
+export interface WebhookBodyShape {
+    source: "openrig.mission-control";
+    schema_version: 1;
+    title: string;
+    body: string;
+    qitem_ref?: string;
+    tags?: string[];
+    emitted_at: string;
+}
+export declare class WebhookNotificationAdapter implements NotificationAdapter {
+    readonly mechanism = "webhook";
+    readonly target: string;
+    private readonly fetchImpl;
+    private readonly extraHeaders;
+    constructor(opts: WebhookAdapterOpts);
+    send(payload: NotificationPayload): Promise<NotificationDeliveryResult>;
+}
+//# sourceMappingURL=notification-adapter-webhook.d.ts.map

package/daemon/dist/domain/mission-control/notification-adapter-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-webhook.d.ts","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-webhook.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,QAAQ,CAAC,SAAS,aAAa;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,IAAI,EAAE,kBAAkB;IAM9B,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CA8B9E"}

package/daemon/dist/domain/mission-control/notification-adapter-webhook.js

@@ -0,0 +1,47 @@
+// PL-005 Phase B: generic webhook adapter (operator-routable alternate).
+//
+// Documented stable JSON body shape so the operator can POST through
+// Slack incoming webhooks, Discord, Telegram bots, or their own infra.
+export class WebhookNotificationAdapter {
+    mechanism = "webhook";
+    target;
+    fetchImpl;
+    extraHeaders;
+    constructor(opts) {
+        this.target = opts.endpointUrl;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.extraHeaders = opts.extraHeaders ?? {};
+    }
+    async send(payload) {
+        const body = {
+            source: "openrig.mission-control",
+            schema_version: 1,
+            title: payload.title,
+            body: payload.body,
+            qitem_ref: payload.qitemRef,
+            tags: payload.tags,
+            emitted_at: new Date().toISOString(),
+        };
+        try {
+            const res = await this.fetchImpl(this.target, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...this.extraHeaders,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                return { ok: false, error: `webhook POST ${res.status}` };
+            }
+            return { ok: true, ack: `webhook ${res.status}` };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=notification-adapter-webhook.js.map

package/daemon/dist/domain/mission-control/notification-adapter-webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-adapter-webhook.js","sourceRoot":"","sources":["../../../src/domain/mission-control/notification-adapter-webhook.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AA2BvE,MAAM,OAAO,0BAA0B;IAC5B,SAAS,GAAG,SAAS,CAAC;IACtB,MAAM,CAAS;IACP,SAAS,CAAe;IACxB,YAAY,CAAyB;IAEtD,YAAY,IAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,MAAM,IAAI,GAAqB;YAC7B,MAAM,EAAE,yBAAyB;YACjC,cAAc,EAAE,CAAC;YACjB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,QAAQ;YAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,IAAI,CAAC,YAAY;iBACrB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5D,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/daemon/dist/domain/mission-control/notification-dispatcher.d.ts

@@ -0,0 +1,53 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "../event-bus.js";
+import type { NotificationAdapter } from "./notification-adapter-types.js";
+export interface NotificationDispatcherDeps {
+    db: Database.Database;
+    eventBus: EventBus;
+    adapter: NotificationAdapter;
+    /**
+     * When true, dispatch on `mission_control.action_executed` events
+     * (verb completion). Default false: only human-gate arrivals
+     * trigger by default (per planner brief mandatory trigger).
+     */
+    includeVerbCompletion?: boolean;
+    missionControlBaseUrl?: string;
+    now?: () => Date;
+}
+export declare class MissionControlNotificationDispatcher {
+    private readonly db;
+    private readonly eventBus;
+    private readonly adapter;
+    private readonly includeVerbCompletion;
+    private readonly missionControlBaseUrl;
+    private readonly now;
+    private unsubscribe;
+    /** Per-(qitem_id, mechanism) drop set for once-per-qitem dedup. */
+    private readonly dispatchedKeys;
+    constructor(deps: NotificationDispatcherDeps);
+    /** Subscribe to relevant EventBus events. Idempotent. */
+    start(): void;
+    /** Unsubscribe + clear dedup set. Idempotent. */
+    stop(): void;
+    /**
+     * Send a synthetic notification through the configured adapter so
+     * the operator can verify their setup. Used by the
+     * `POST /api/mission-control/notifications/test` route.
+     */
+    sendTest(): Promise<{
+        mechanism: string;
+        target: string;
+        ok: boolean;
+        ack?: string;
+        error?: string;
+    }>;
+    private handleEvent;
+    private dispatch;
+    private emitSent;
+    private emitFailed;
+    private lookupQitem;
+    private qitemRef;
+    /** Test/observability: clear once-per-qitem dedup set. */
+    resetDedupForTest(): void;
+}
+//# sourceMappingURL=notification-dispatcher.d.ts.map