@openrig/cli 0.1.11 → 0.2.0

package/daemon/dist/domain/ps-projection.js

@@ -1,3 +1,35 @@
+import { getNodeInventory } from "./node-inventory.js";
+/**
+ * Folds per-node lifecycle states into a rig-level lifecycle state.
+ *
+ *   attention_required > running > recoverable > stopped, with `degraded` for mixes.
+ *
+ * Rules (post-L2):
+ *   - any node attention_required          → attention_required (priority over below).
+ *   - all nodes running                    → running.
+ *   - all nodes non-running, any recoverable → recoverable.
+ *   - all nodes non-running, none recoverable → stopped.
+ *   - mixed running + non-running          → degraded.
+ *   - empty rig (no nodes)                 → stopped.
+ *
+ * `recoverable` at rig level depends on per-node recoverability, which already accounts
+ * for whether the rig's latest usable snapshot has a resume token for that node.
+ */
+export function deriveRigLifecycleState(nodeStates) {
+    if (nodeStates.length === 0)
+        return "stopped";
+    if (nodeStates.some((s) => s === "attention_required"))
+        return "attention_required";
+    const runningCount = nodeStates.filter((s) => s === "running").length;
+    const totalCount = nodeStates.length;
+    if (runningCount === totalCount)
+        return "running";
+    if (runningCount === 0) {
+        const anyRecoverable = nodeStates.some((s) => s === "recoverable");
+        return anyRecoverable ? "recoverable" : "stopped";
+    }
+    return "degraded";
+}
 /**
  * Projects rig/run summary for `rig ps`.
  * Aggregates across all rigs: node counts, running counts, status, uptime, snapshot age.
@@ -31,12 +63,18 @@ export class PsProjectionService {
                 : r.running_count === r.node_count ? "running"
                     : r.running_count > 0 ? "partial"
                         : "stopped";
+            // Derive rig-level lifecycleState by folding per-node states. The cost is one
+            // node-inventory pass per rig; this matches the v0 "derive, no migration" decision.
+            const inventory = getNodeInventory(this.db, r.rig_id);
+            const lifecycleState = deriveRigLifecycleState(inventory.map((e) => e.lifecycleState));
             return {
                 rigId: r.rig_id,
                 name: r.name,
+                rigName: r.name,
                 nodeCount: r.node_count,
                 runningCount: r.running_count,
                 status,
+                lifecycleState,
                 uptime: r.earliest_running_at ? formatDuration(now - new Date(r.earliest_running_at + "Z").getTime()) : null,
                 latestSnapshot: r.latest_snapshot_at ? formatAge(now - new Date(r.latest_snapshot_at + "Z").getTime()) : null,
             };

package/daemon/dist/domain/ps-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"ps-projection.js","sourceRoot":"","sources":["../../src/domain/ps-projection.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACrB,EAAE,CAAoB;IAE/B,YAAY,IAA+B;QACzC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC;IAED,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;KAgB5B,CAAC,CAAC,GAAG,EAOJ,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9B,CAAC,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBAC9C,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;wBACjC,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,MAAM;gBACf,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,SAAS,EAAE,CAAC,CAAC,UAAU;gBACvB,YAAY,EAAE,CAAC,CAAC,aAAa;gBAC7B,MAAM;gBACN,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC5G,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;aAC9G,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,GAAG,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,KAAK,aAAa,GAAG,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,GAAG,EAAE,CAAC;IAC/B,OAAO,GAAG,IAAI,KAAK,WAAW,GAAG,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,GAAG,MAAM,CAAC;AACtB,CAAC"}
+{"version":3,"file":"ps-projection.js","sourceRoot":"","sources":["../../src/domain/ps-projection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAyBvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAgC;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,oBAAoB,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAEpF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;IAErC,IAAI,YAAY,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAClD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC;QACnE,OAAO,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACrB,EAAE,CAAoB;IAE/B,YAAY,IAA+B;QACzC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC;IAED,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;KAgB5B,CAAC,CAAC,GAAG,EAOJ,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9B,CAAC,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBAC9C,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;wBACjC,CAAC,CAAC,SAAS,CAAC;YAEd,8EAA8E;YAC9E,oFAAoF;YACpF,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,uBAAuB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;YAEvF,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,MAAM;gBACf,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,IAAI;gBACf,SAAS,EAAE,CAAC,CAAC,UAAU;gBACvB,YAAY,EAAE,CAAC,CAAC,aAAa;gBAC7B,MAAM;gBACN,cAAc;gBACd,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC5G,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;aAC9G,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,GAAG,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,KAAK,aAAa,GAAG,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,GAAG,EAAE,CAAC;IAC/B,OAAO,GAAG,IAAI,KAAK,WAAW,GAAG,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,GAAG,MAAM,CAAC;AACtB,CAAC"}

package/daemon/dist/domain/queue-repository.d.ts

@@ -0,0 +1,322 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "./event-bus.js";
+import type { PersistedEvent } from "./types.js";
+import { QueueTransitionLog } from "./queue-transition-log.js";
+import { type ClosureReason } from "./hot-potato-enforcer.js";
+export declare const QUEUE_STATES: readonly ["pending", "in-progress", "done", "blocked", "failed", "denied", "canceled", "handed-off"];
+export type QueueState = (typeof QUEUE_STATES)[number];
+export declare const QUEUE_PRIORITIES: readonly ["routine", "urgent", "critical"];
+export type QueuePriority = (typeof QUEUE_PRIORITIES)[number];
+export interface QueueItem {
+    qitemId: string;
+    tsCreated: string;
+    tsUpdated: string;
+    sourceSession: string;
+    destinationSession: string;
+    state: QueueState;
+    priority: QueuePriority;
+    tier: string | null;
+    tags: string[] | null;
+    blockedOn: string | null;
+    handedOffTo: string | null;
+    handedOffFrom: string | null;
+    expiresAt: string | null;
+    chainOfRecord: string[] | null;
+    body: string;
+    closureReason: ClosureReason | null;
+    closureTarget: string | null;
+    closureRequiredAt: string | null;
+    claimedAt: string | null;
+    lastNudgeAttempt: string | null;
+    lastNudgeResult: string | null;
+    lastHeartbeat: string | null;
+    resolution: string | null;
+}
+/**
+ * Async transport contract — exists in this domain module so QueueRepository
+ * can do durable+waking handoffs (Phase A contract: queue create / handoff /
+ * handoff-and-complete are nudging by default unless caller opts out).
+ *
+ * The wired-in implementation is `SessionTransport` (packages/daemon/src/
+ * domain/session-transport.ts), but the repository depends only on this
+ * minimal shape so test code can supply a stub.
+ */
+export interface QueueNudgeTransport {
+    send(sessionName: string, text: string, opts?: {
+        verify?: boolean;
+    }): Promise<{
+        ok: boolean;
+        verified?: boolean;
+        error?: string;
+        reason?: string;
+    }>;
+}
+export interface QueueCreateInput {
+    qitemId?: string;
+    sourceSession: string;
+    destinationSession: string;
+    body: string;
+    priority?: QueuePriority;
+    tier?: string;
+    tags?: string[];
+    expiresAt?: string;
+    chainOfRecord?: string[];
+    /**
+     * R1 fix (PL-004 Phase A revision): Phase A is durable + waking by default.
+     * When true (or omitted), the repository nudges the destination after the
+     * create transaction commits and persists last_nudge_attempt + last_nudge_result.
+     * Operators opt out with `nudge: false` for cold-queue cases.
+     */
+    nudge?: boolean;
+}
+export interface QueueUpdateInput {
+    qitemId: string;
+    actorSession: string;
+    state: QueueState;
+    transitionNote?: string;
+    closureReason?: string;
+    closureTarget?: string;
+    /**
+     * PL-004 Phase D extension: when set, persists the queue_items.handed_off_to
+     * column. Used by workflow-projector for state=handed-off transitions so
+     * the canonical "next owner" pointer is recoverable from queue state alone.
+     * Optional to preserve backward compatibility with existing update() callers.
+     */
+    handedOffTo?: string;
+    /**
+     * PL-004 Phase D extension: when set, persists the queue_items.blocked_on
+     * column. Used by workflow-projector for state=blocked transitions so the
+     * blocker reference (qitem id, gate name) is recoverable from queue state.
+     */
+    blockedOn?: string;
+}
+export interface QueueHandoffInput {
+    qitemId: string;
+    fromSession: string;
+    toSession: string;
+    body?: string;
+    transitionNote?: string;
+    priority?: QueuePriority;
+    tier?: string;
+    tags?: string[];
+    /** Default true; nudge the destination after the close+create transaction. */
+    nudge?: boolean;
+}
+/**
+ * Like {@link QueueHandoffInput} but the source qitem is closed as `done`
+ * (terminal) instead of `handed-off` (intermediate). Use when the source seat
+ * is fully complete with the work and the new qitem is the canonical
+ * follow-on. Closure_reason is recorded as `handed_off_to` and the new qitem
+ * is created in the same atomic transaction.
+ */
+export interface QueueHandoffAndCompleteInput extends QueueHandoffInput {
+}
+export interface QueueClaimInput {
+    qitemId: string;
+    destinationSession: string;
+}
+export interface QueueListOptions {
+    destinationSession?: string;
+    sourceSession?: string;
+    state?: QueueState | QueueState[];
+    limit?: number;
+}
+export declare class QueueRepositoryError extends Error {
+    readonly code: string;
+    readonly meta: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, meta?: Record<string, unknown>);
+}
+/**
+ * L3 — Queue repository. Owns CRUD over `queue_items` plus the wired-in
+ * append-only transition log and hot-potato strict-rejection contract.
+ *
+ * Pattern mirrors `chat-repository.ts` (single class, atomic transactions,
+ * persist-event-then-notify). Cross-rig validation hook is `validateRig` —
+ * Phase A wires no-op; Phase B can plug in the rig registry to reject
+ * phantom-rig destinations. POC compatibility: `qitem_id` shape preserved.
+ */
+export declare class QueueRepository {
+    readonly db: Database.Database;
+    readonly transitionLog: QueueTransitionLog;
+    private readonly eventBus;
+    private readonly validateRig;
+    private transport;
+    constructor(db: Database.Database, eventBus: EventBus, opts?: {
+        validateRig?: (sessionRef: string) => boolean;
+        /**
+         * R1 fix (PL-004 Phase A revision): durable+waking-by-default transport
+         * for create / handoff / handoff-and-complete. When provided, the
+         * repository nudges the destination after the corresponding transaction
+         * commits and records last_nudge_attempt + last_nudge_result via
+         * recordNudgeAttempt(). When absent, no nudge is issued (caller is in
+         * a test or daemon-bootstrap path where transport is not yet wired).
+         */
+        transport?: QueueNudgeTransport;
+    });
+    /**
+     * Attach the wake-path transport AFTER construction. Used by daemon
+     * startup, where SessionTransport is constructed later in the dep graph
+     * than QueueRepository (because SessionTransport needs agentActivityStore
+     * which itself needs eventBus). Calling this is safe at any time; create /
+     * handoff / handoff-and-complete will start nudging on the next call.
+     */
+    attachTransport(transport: QueueNudgeTransport): void;
+    /**
+     * Issue a default nudge to the destination after a create / handoff /
+     * handoff-and-complete commit. Records the result via recordNudgeAttempt.
+     * Errors are caught and surfaced as nudge_result strings — they do not
+     * unwind the underlying queue mutation.
+     *
+     * Phase D extension point (orch-ratified): public so workflow-projector
+     * can invoke after its outer transaction commits, completing the
+     * createWithinTransaction()'s deferred post-commit side effects.
+     */
+    maybeNudge(qitemId: string, destinationSession: string, nudgeOpt: boolean | undefined): Promise<void>;
+    create(input: QueueCreateInput): Promise<QueueItem>;
+    /**
+     * PL-004 Phase D extension point (orch-ratified per slice IMPL §
+     * Driver Handoff Contract). Creates a queue item using the SAME
+     * caller-managed db.transaction for transactional-scribe semantics
+     * (workflow-projector folds step closure + next-qitem creation into
+     * one atomic unit). Returns the persisted event AND qitem id so the
+     * caller can defer notifySubscribers/maybeNudge until AFTER its
+     * outer transaction commits.
+     *
+     * Caller MUST:
+     *   1. Invoke this from inside a `db.transaction(() => {...})` block.
+     *   2. After the outer txn commits, call:
+     *        - eventBus.notifySubscribers(persistedEvent)
+     *        - this.maybeNudge(qitemId, destinationSession, input.nudge)
+     *   3. NOT call this from outside a transaction (will produce a
+     *      half-state if the caller errors before committing).
+     *
+     * The split exists ONLY because notifySubscribers + maybeNudge are
+     * post-commit side effects (subscribers should not see events for
+     * data that may roll back; nudges should not fire for handoffs that
+     * may roll back). For independent create()s that don't need to
+     * compose with an outer transaction, use create() instead.
+     */
+    createWithinTransaction(input: QueueCreateInput): {
+        qitemId: string;
+        persistedEvent: PersistedEvent;
+        destinationSession: string;
+        nudge: boolean | undefined;
+    };
+    /**
+     * Internal: insert + transition + emit event. Caller is responsible
+     * for transaction wrapping (the public create() wraps; the public
+     * createWithinTransaction() does not — caller's outer transaction
+     * provides the atomic boundary).
+     */
+    private createInTransactionalContext;
+    /**
+     * Transactional handoff: close the source qitem (state=done,
+     * closure_reason=handed_off_to) and create a new qitem owned by `toSession`,
+     * with `handed_off_from` recording the chain. One atomic transaction.
+     */
+    handoff(input: QueueHandoffInput): Promise<{
+        closed: QueueItem;
+        created: QueueItem;
+    }>;
+    /**
+     * Variant of {@link handoff} that closes the source qitem as `done`
+     * (terminal closure) instead of `handed-off` (intermediate). Same atomic
+     * close+create, same chain_of_record semantics, same default-nudge behavior.
+     * Use when the source seat is fully complete with the work — no follow-up
+     * tracking needed against the source qitem.
+     */
+    handoffAndComplete(input: QueueHandoffAndCompleteInput): Promise<{
+        closed: QueueItem;
+        created: QueueItem;
+    }>;
+    /**
+     * `whoami` — return the seat's queue position from the daemon's perspective.
+     * Counts active qitems (pending + in-progress + blocked) destined for the
+     * caller, lists the most recent active qitems, and reports counts for the
+     * caller's outgoing source role too. Read-only; no mutations.
+     *
+     * Per PL-004 Phase A § Routes: GET /api/queue/whoami.
+     */
+    whoami(session: string, opts?: {
+        recentLimit?: number;
+    }): {
+        session: string;
+        asDestination: {
+            pending: number;
+            inProgress: number;
+            blocked: number;
+            recent: QueueItem[];
+        };
+        asSource: {
+            total: number;
+        };
+    };
+    /**
+     * Mark a qitem `in-progress` (claim). Computes closure_required_at from tier.
+     */
+    claim(input: QueueClaimInput): QueueItem;
+    unclaim(qitemId: string, destinationSession: string, reason: string): QueueItem;
+    /**
+     * General state mutator. Routes through hot-potato strict-rejection on
+     * `done` transitions. All transitions append to the log.
+     *
+     * Phase B R2: emits queue.updated event atomically with the UPDATE +
+     * transition log append, so the view-event-bridge can wake SSE consumers
+     * on /api/views/:name/sse for normal state transitions (pending → blocked,
+     * in-progress → done, closure, escalation). Phase A write semantics are
+     * UNCHANGED — only an additional event emission inside the existing
+     * transaction. Per slice IMPL § Guard Checkpoint Focus item 9, this is
+     * an explicit narrow event-only extension to a Phase A write surface,
+     * justified by the R2 guard finding that update-path mutations were
+     * invisible to the view bridge.
+     */
+    update(input: QueueUpdateInput): QueueItem;
+    /**
+     * PL-004 Phase D extension point (orch-ratified per slice IMPL Driver
+     * Handoff Contract / Guard R1 repair). Same closure validation +
+     * UPDATE + transition log + queue.updated event as update(), but
+     * runs inside the caller's outer db.transaction so it composes with
+     * workflow-projector's transactional-scribe contract.
+     *
+     * Caller MUST:
+     *   1. Invoke from inside a `db.transaction(() => {...})` block.
+     *   2. After the outer txn commits, call:
+     *        eventBus.notifySubscribers(persistedEvent)
+     *   3. NOT call this from outside a transaction (will produce a
+     *      half-state if the caller errors before committing).
+     *
+     * Closure validation runs at call time (before the UPDATE) so a
+     * Phase A invariant violation (e.g., state=done without closure_reason)
+     * throws before the workflow projector's outer transaction can commit
+     * any partial state. The Phase A hot-potato strict-rejection rule
+     * therefore applies to workflow projection unchanged.
+     */
+    updateWithinTransaction(input: QueueUpdateInput): {
+        qitemId: string;
+        persistedEvent: PersistedEvent;
+    };
+    /**
+     * Internal: closure validation + UPDATE + transition log + emit
+     * queue.updated event. Caller is responsible for transaction wrapping
+     * (the public update() wraps; the public updateWithinTransaction()
+     * composes inside the caller's outer transaction).
+     */
+    private updateInTransactionalContext;
+    getById(qitemId: string): QueueItem | null;
+    list(opts?: QueueListOptions): QueueItem[];
+    /**
+     * Find qitems whose `closure_required_at` is past now. Used by watchdog;
+     * does NOT itself emit events — callers decide whether to nudge or escalate.
+     */
+    findOverdue(now?: string): QueueItem[];
+    recordNudgeAttempt(qitemId: string, result: string): void;
+    recordHeartbeat(qitemId: string): void;
+    /**
+     * Pod-fallback: redirect qitem to a fallback destination (e.g., when a seat
+     * is unreachable). Emits qitem.fallback_routed; preserves chain_of_record.
+     */
+    routeToFallback(qitemId: string, fallbackDestination: string, reason: string): QueueItem;
+    private getByIdOrThrow;
+    private rowToItem;
+}
+//# sourceMappingURL=queue-repository.d.ts.map

package/daemon/dist/domain/queue-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-repository.d.ts","sourceRoot":"","sources":["../../src/domain/queue-repository.ts"],"names":[],"mappings":"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"}