@telora/daemon 0.17.59 → 0.17.70

package/dist/nexus-incoming.js

@@ -0,0 +1,93 @@
+/**
+ * Nexus incoming-request poll: the receiving side of the cross-product request
+ * channel.
+ *
+ * Each poll cycle, for every configured product, the daemon looks for OPEN
+ * incoming requests (product_requests where target_product_id = this product)
+ * and applies the product's accept gate:
+ *
+ *   - auto_with_decline (default): auto-accept + materialize the request as a
+ *     scoped delivery in a per-product "Nexus Inbox" focus, where the target's
+ *     AI team picks it up via the normal focus spawn path. (The target can still
+ *     decline/clarify after the fact via MCP -- "accept with decline".)
+ *   - human_required: leave the request OPEN; a human accepts it via MCP.
+ *
+ * The decision is a pure function (decideIncoming) so the gate is unit-tested
+ * without any I/O; the side effects (list/accept/materialize/policy read) are
+ * injected as deps so the poll wiring is testable with mocks.
+ */
+import { callApi } from './queries/shared.js';
+/**
+ * Pure accept gate. human_required holds the request for a human; everything
+ * else (the default auto_with_decline) auto-accepts.
+ */
+export function decideIncoming(policy) {
+    return policy === 'human_required' ? 'await_human' : 'auto_accept';
+}
+/** Production deps backed by the product-api over callApi. */
+export function defaultNexusIncomingDeps() {
+    return {
+        listIncomingOpen: async (productId) => {
+            const res = await callApi('product_request_list', {
+                productId,
+                direction: 'incoming',
+                status: 'open',
+            });
+            return res.requests ?? [];
+        },
+        getAcceptPolicy: async (productId) => {
+            const res = await callApi('get', { productId });
+            return res.product?.nexusAcceptPolicy === 'human_required' ? 'human_required' : 'auto_with_decline';
+        },
+        acceptRequest: async (requestId) => {
+            await callApi('product_request_accept', { requestId });
+        },
+        materializeRequest: async (requestId) => {
+            await callApi('product_request_materialize', { requestId });
+        },
+    };
+}
+/**
+ * Poll one product for incoming open requests and apply its accept gate.
+ * Safe to call every poll cycle: it is a no-op when there is no incoming work,
+ * and individual request failures are logged without aborting the batch.
+ */
+export async function checkIncomingRequests(config, deps = defaultNexusIncomingDeps()) {
+    const productId = config.productId;
+    if (!productId)
+        return;
+    const log = deps.log ?? ((msg) => console.log(msg));
+    let requests;
+    try {
+        requests = await deps.listIncomingOpen(productId);
+    }
+    catch (err) {
+        log(`[nexus] failed to list incoming requests for ${productId}: ${err.message}`);
+        return;
+    }
+    if (requests.length === 0)
+        return;
+    let policy;
+    try {
+        policy = await deps.getAcceptPolicy(productId);
+    }
+    catch (err) {
+        log(`[nexus] failed to read accept policy for ${productId}: ${err.message}`);
+        return;
+    }
+    if (decideIncoming(policy) === 'await_human') {
+        log(`[nexus] ${requests.length} incoming request(s) for ${productId} await human approval (policy=human_required)`);
+        return;
+    }
+    for (const req of requests) {
+        try {
+            await deps.acceptRequest(req.id);
+            await deps.materializeRequest(req.id);
+            log(`[nexus] auto-accepted + materialized request ${req.id} for product ${productId}`);
+        }
+        catch (err) {
+            log(`[nexus] failed to accept/materialize request ${req.id}: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=nexus-incoming.js.map

package/dist/nexus-incoming.js.map

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

package/dist/nexus-return.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Nexus return-path poll: loop closure to the source.
+ *
+ * This closes the cross-product request differential. Two sides run each poll
+ * cycle, both safe to call every tick (no-op when there is no work):
+ *
+ *   TARGET side -- for every incoming request still in_progress with a
+ *     materialized delivery, ask the server to resolve it. The server gate
+ *     (product_request_resolve) advances the request to 'closed' ONLY when the
+ *     materialized delivery's execution_status is 'done' (it passed the verify
+ *     gate); any other delivery state is a no-op. So merely calling resolve
+ *     every tick converges the request the moment B's work lands.
+ *
+ *   SOURCE side -- for every outgoing request in a terminal state
+ *     ('closed' = completed, 'declined' = rejected) that has not yet notified
+ *     its source (source_notified_at is null), file an escalation on the
+ *     source's blocked focus so the human/agent there learns the cross-product
+ *     dependency resolved, then stamp source_notified_at so it is not
+ *     re-notified. This is the half that unblocks A without a human chasing it.
+ *
+ * shouldResolve is a pure predicate so the gate is unit-testable with no I/O;
+ * the side effects (list/resolve/notify/stamp) are injected as deps so the poll
+ * wiring is testable with mocks. Mirrors nexus-incoming.ts.
+ */
+import type { DaemonConfig } from './types.js';
+import { type DeliveryGateState } from './queries/deliveries.js';
+/**
+ * Minimal shape of a product_request list row (camelCase from the edge fn).
+ * All fields optional + defensive: the daemon must not assume any are present.
+ */
+export interface Req {
+    id: string;
+    status?: string;
+    materializedDeliveryId?: string | null;
+    sourceFocusId?: string | null;
+    sourceProductId?: string | null;
+    sourceDeliveryId?: string | null;
+    targetProductId?: string | null;
+    title?: string | null;
+    declineReason?: string | null;
+    clarificationMessage?: string | null;
+    clarificationNotifiedAt?: string | null;
+    sourceNotifiedAt?: string | null;
+    /** Contract-fulfillment results carried back by the target's deliver step. */
+    findings?: string | null;
+}
+/**
+ * gate_state written onto a source delivery the Nexus gate pauses. It carries
+ * the dashboard "Waiting on" blocker (rendered from `blocking[].guardName`) plus
+ * a `nexusBlock` provenance marker so the release half can prove THIS gate paused
+ * the delivery and never clobber a delivery a human paused for another reason.
+ */
+export interface NexusGateState extends DeliveryGateState {
+    nexusBlock: {
+        requestIds: string[];
+    };
+}
+/** Current execution state of one source-product delivery (status + gate_state). */
+export interface SourceDeliveryState {
+    id: string;
+    executionStatus?: string;
+    gateState?: unknown;
+}
+/**
+ * Pure resolution gate. The loop closes only once the materialized delivery has
+ * passed the verify gate to 'done'. (The authoritative check is server-side in
+ * product_request_resolve; this mirror keeps the gate explicit + unit-tested.)
+ */
+export declare function shouldResolve(deliveryStatus: string | undefined): boolean;
+export interface NexusReturnDeps {
+    /** Incoming requests still in_progress, filtered to those with a materialized delivery. */
+    listIncomingInProgress: (productId: string) => Promise<Req[]>;
+    /** Read a delivery's execution_status (org_nodes). Kept for completeness/testing. */
+    getDeliveryStatus: (deliveryId: string) => Promise<string | undefined>;
+    /** Ask the server to resolve a request; returns true when it closed the loop. */
+    resolveRequest: (requestId: string) => Promise<boolean>;
+    /** Outgoing requests for the source product (any status). */
+    listOutgoing: (productId: string) => Promise<Req[]>;
+    /** Notify the source side (escalation on the blocked focus) about a terminal state. */
+    notifySource: (req: Req) => Promise<void>;
+    /** Stamp source_notified_at so the request is not re-notified. */
+    markSourceNotified: (requestId: string) => Promise<void>;
+    /** Notify the source side that the target requested clarification. */
+    notifyClarification: (req: Req) => Promise<void>;
+    /** Stamp clarification_notified_at so the same clarification is not re-notified. */
+    markClarificationNotified: (requestId: string) => Promise<void>;
+    /**
+     * Current execution_status + gate_state for every delivery in the source
+     * product (one read per poll). The source-gate reconciler keys off these.
+     */
+    listSourceDeliveryStates: (productId: string) => Promise<SourceDeliveryState[]>;
+    /** Daemon-owned transition: pause a source delivery and write the Nexus gate_state. */
+    pauseSourceDelivery: (deliveryId: string, gateState: NexusGateState, fromStatus?: string) => Promise<void>;
+    /** Daemon-owned transition: re-queue a paused source delivery and clear gate_state. */
+    requeueSourceDelivery: (deliveryId: string, fromStatus?: string) => Promise<void>;
+    /** Resolve a product's display name for the "Waiting on" label (best-effort). */
+    getProductName: (productId: string) => Promise<string | undefined>;
+    log?: (msg: string) => void;
+}
+/** Production deps backed by the product-api over callApi + createEscalation. */
+export declare function defaultNexusReturnDeps(config: DaemonConfig): NexusReturnDeps;
+/**
+ * Poll one product for return-path loop closure. Runs both sides:
+ *   TARGET -- resolve materialized in_progress incoming requests (server gates
+ *     on delivery 'done').
+ *   SOURCE -- notify + stamp terminal outgoing requests not yet notified.
+ * Each request's work is wrapped in try/catch so one failure does not abort the
+ * batch (mirrors nexus-incoming).
+ */
+export declare function checkResolvedRequests(config: DaemonConfig, deps?: NexusReturnDeps): Promise<void>;
+/**
+ * Block + auto-resume the source deliveries gated by outgoing Nexus requests.
+ *
+ * Per source delivery (grouped from `outgoing` by sourceDeliveryId):
+ *   BLOCK   -- a currently-`queued` (actionable) delivery with >=1 non-terminal
+ *              outgoing request is paused, with gate_state carrying the
+ *              "Waiting on <target product>" blocker + a nexusBlock provenance
+ *              marker. `paused` is non-actionable + blocking in the spawn walk,
+ *              so an armed focus stops spawning a team that cannot do the work.
+ *   RELEASE -- a `paused` delivery THIS gate paused (nexusBlock provenance) is
+ *              re-queued (and gate_state cleared) once ALL its outgoing requests
+ *              are terminal AND none ended `declined` (every one `closed`). A
+ *              declined request leaves it paused for a human to decide (the
+ *              decline -> NEEDS_INTENT notify already fired above).
+ *
+ * Idempotent: only a `queued` delivery is paused, only a nexus-paused delivery
+ * is resumed; re-running with the same inputs is a no-op. Never clobbers a
+ * delivery a human paused (no nexusBlock marker) or one with no open request.
+ */
+export declare function reconcileSourceDeliveryGates(outgoing: Req[], deps: NexusReturnDeps, log: (msg: string) => void): Promise<void>;
+//# sourceMappingURL=nexus-return.d.ts.map

package/dist/nexus-return.d.ts.map

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

package/dist/nexus-return.js

@@ -0,0 +1,326 @@
+/**
+ * Nexus return-path poll: loop closure to the source.
+ *
+ * This closes the cross-product request differential. Two sides run each poll
+ * cycle, both safe to call every tick (no-op when there is no work):
+ *
+ *   TARGET side -- for every incoming request still in_progress with a
+ *     materialized delivery, ask the server to resolve it. The server gate
+ *     (product_request_resolve) advances the request to 'closed' ONLY when the
+ *     materialized delivery's execution_status is 'done' (it passed the verify
+ *     gate); any other delivery state is a no-op. So merely calling resolve
+ *     every tick converges the request the moment B's work lands.
+ *
+ *   SOURCE side -- for every outgoing request in a terminal state
+ *     ('closed' = completed, 'declined' = rejected) that has not yet notified
+ *     its source (source_notified_at is null), file an escalation on the
+ *     source's blocked focus so the human/agent there learns the cross-product
+ *     dependency resolved, then stamp source_notified_at so it is not
+ *     re-notified. This is the half that unblocks A without a human chasing it.
+ *
+ * shouldResolve is a pure predicate so the gate is unit-testable with no I/O;
+ * the side effects (list/resolve/notify/stamp) are injected as deps so the poll
+ * wiring is testable with mocks. Mirrors nexus-incoming.ts.
+ */
+import { callApi } from './queries/shared.js';
+import { createEscalation } from './queries/issues.js';
+import { updateDeliveryStatus } from './queries/deliveries.js';
+import { ESCALATION_REASONS, ESCALATION_DISPOSITIONS, ESCALATION_KINDS, DELIVERY_STATUS } from '@telora/daemon-core';
+/**
+ * Statuses in which an outgoing request still gates its source delivery -- the
+ * cross-product dependency is not yet settled, so the source must wait.
+ */
+const NON_TERMINAL_REQUEST_STATUSES = new Set(['open', 'accepted', 'in_progress', 'delivered']);
+/** Type guard: was this delivery's pause written by the Nexus gate (has provenance)? */
+function isNexusGateState(gateState) {
+    return (!!gateState &&
+        typeof gateState === 'object' &&
+        Array.isArray(gateState.nexusBlock?.requestIds));
+}
+/**
+ * Pure resolution gate. The loop closes only once the materialized delivery has
+ * passed the verify gate to 'done'. (The authoritative check is server-side in
+ * product_request_resolve; this mirror keeps the gate explicit + unit-tested.)
+ */
+export function shouldResolve(deliveryStatus) {
+    return deliveryStatus === 'done';
+}
+/** Terminal statuses on the source side that warrant a notification. */
+const TERMINAL_SOURCE_STATUSES = new Set(['closed', 'declined']);
+/** Production deps backed by the product-api over callApi + createEscalation. */
+export function defaultNexusReturnDeps(config) {
+    return {
+        listIncomingInProgress: async (productId) => {
+            const res = await callApi('product_request_list', {
+                productId,
+                direction: 'incoming',
+                status: 'in_progress',
+            });
+            return (res.requests ?? []).filter((r) => !!r.materializedDeliveryId);
+        },
+        getDeliveryStatus: async (deliveryId) => {
+            // The server-side gate already reads delivery status during resolve, so
+            // this default is a thin convenience: delivery_list returns org_nodes.
+            const res = await callApi('delivery_list', { deliveryId });
+            const match = (res.deliveries ?? []).find((d) => d.id === deliveryId);
+            return match?.executionStatus;
+        },
+        resolveRequest: async (requestId) => {
+            const res = await callApi('product_request_resolve', { requestId });
+            return res.resolved === true;
+        },
+        listOutgoing: async (productId) => {
+            const res = await callApi('product_request_list', {
+                productId,
+                direction: 'outgoing',
+            });
+            return res.requests ?? [];
+        },
+        notifySource: async (req) => {
+            const declined = req.status === 'declined';
+            const reasonPhrase = declined
+                ? `declined by the target product${req.declineReason ? `: ${req.declineReason}` : ''}`
+                : 'completed by the target product';
+            // Use BLOCKED_BY_EXTERNAL for declines (the source is still blocked and needs
+            // to decide next steps). Use DECISION_NEEDED for resolved (closed) requests:
+            // the dependency cleared and the source team can now unblock their work.
+            const reasonType = declined
+                ? ESCALATION_REASONS.BLOCKED_BY_EXTERNAL
+                : ESCALATION_REASONS.DECISION_NEEDED;
+            const descriptionPrefix = declined
+                ? '[Nexus dependency declined]'
+                : '[Nexus dependency resolved]';
+            await createEscalation({
+                organizationId: config.organizationId,
+                issueId: null,
+                reasonType,
+                // Disposition routes resolution: a resolved (closed) dependency clears the
+                // blocker so an agent on the source focus can act on it automatically; a
+                // decline leaves the source still blocked and needing a human to decide
+                // next steps.
+                disposition: declined
+                    ? ESCALATION_DISPOSITIONS.NEEDS_INTENT
+                    : ESCALATION_DISPOSITIONS.AGENT_RESOLVABLE,
+                escalationKind: ESCALATION_KINDS.NEXUS_REQUEST_RESOLVED,
+                // Provenance: the source focus is the anchor; resolver derives productId.
+                anchor: { focusId: req.sourceFocusId ?? undefined },
+                ...(req.sourceProductId ? { productId: req.sourceProductId } : {}),
+                description: `${descriptionPrefix} Nexus request "${req.title ?? '(untitled)'}" was ${reasonPhrase}. ` +
+                    `${declined ? 'Review the decline reason and decide on next steps.' : 'The cross-product dependency is now clear -- you can unblock your work.'}` +
+                    // Carry the target's delivered findings back so the source acts on the
+                    // actual results, not just the fact of closure (honest-closure path).
+                    (!declined && req.findings ? `\n\nDelivered findings: ${req.findings}` : ''),
+            });
+        },
+        markSourceNotified: async (requestId) => {
+            await callApi('product_request_mark_source_notified', { requestId });
+        },
+        notifyClarification: async (req) => {
+            await createEscalation({
+                organizationId: config.organizationId,
+                issueId: null,
+                reasonType: ESCALATION_REASONS.NEEDS_CLARIFICATION,
+                // A human on the source side must provide the clarification response.
+                disposition: ESCALATION_DISPOSITIONS.NEEDS_INTENT,
+                escalationKind: ESCALATION_KINDS.NEXUS_CLARIFICATION_REQUESTED,
+                // Provenance: the source focus is the anchor; resolver derives productId.
+                anchor: { focusId: req.sourceFocusId ?? undefined },
+                ...(req.sourceProductId ? { productId: req.sourceProductId } : {}),
+                description: `[Nexus clarification requested] Nexus request "${req.title ?? '(untitled)'}" has a question from the target product: ` +
+                    `${req.clarificationMessage ?? '(no message)'} -- reply or update the request to unblock the cross-product work.`,
+            });
+        },
+        markClarificationNotified: async (requestId) => {
+            await callApi('product_request_mark_clarification_notified', { requestId });
+        },
+        listSourceDeliveryStates: async (productId) => {
+            // detail:'full' so gate_state comes back (summary omits it). Outgoing
+            // requests originate in THIS product, so a single product-scoped list
+            // covers every source delivery the gate might touch.
+            const res = await callApi('delivery_list', { productId, detail: 'full', limit: 500 });
+            return (res.deliveries ?? []).map((d) => ({
+                id: d.id,
+                executionStatus: d.executionStatus,
+                gateState: d.gateState,
+            }));
+        },
+        pauseSourceDelivery: async (deliveryId, gateState, fromStatus) => {
+            await updateDeliveryStatus(deliveryId, DELIVERY_STATUS.PAUSED, undefined, gateState, undefined, { organizationId: config.organizationId, fromStatus });
+        },
+        requeueSourceDelivery: async (deliveryId, fromStatus) => {
+            // null clears the stale Nexus gate_state as the delivery resumes.
+            await updateDeliveryStatus(deliveryId, DELIVERY_STATUS.QUEUED, undefined, null, undefined, { organizationId: config.organizationId, fromStatus });
+        },
+        getProductName: async (productId) => {
+            try {
+                const res = await callApi('get', { productId });
+                return res.product?.name ?? undefined;
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/**
+ * Poll one product for return-path loop closure. Runs both sides:
+ *   TARGET -- resolve materialized in_progress incoming requests (server gates
+ *     on delivery 'done').
+ *   SOURCE -- notify + stamp terminal outgoing requests not yet notified.
+ * Each request's work is wrapped in try/catch so one failure does not abort the
+ * batch (mirrors nexus-incoming).
+ */
+export async function checkResolvedRequests(config, deps = defaultNexusReturnDeps(config)) {
+    const productId = config.productId;
+    if (!productId)
+        return;
+    const log = deps.log ?? ((msg) => console.log(msg));
+    // --- TARGET side: resolve materialized in_progress incoming requests. ---
+    let incoming = [];
+    try {
+        incoming = await deps.listIncomingInProgress(productId);
+    }
+    catch (err) {
+        log(`[nexus] failed to list in_progress incoming requests for ${productId}: ${err.message}`);
+    }
+    for (const req of incoming) {
+        try {
+            const resolved = await deps.resolveRequest(req.id);
+            if (resolved) {
+                log(`[nexus] resolved incoming request ${req.id} (materialized delivery done) for ${productId}`);
+            }
+        }
+        catch (err) {
+            log(`[nexus] failed to resolve incoming request ${req.id}: ${err.message}`);
+        }
+    }
+    // --- SOURCE side: notify + stamp terminal outgoing requests. ---
+    let outgoing = [];
+    try {
+        outgoing = await deps.listOutgoing(productId);
+    }
+    catch (err) {
+        log(`[nexus] failed to list outgoing requests for ${productId}: ${err.message}`);
+        return;
+    }
+    const pending = outgoing.filter((r) => r.status !== undefined && TERMINAL_SOURCE_STATUSES.has(r.status) && !r.sourceNotifiedAt);
+    for (const req of pending) {
+        try {
+            await deps.notifySource(req);
+            await deps.markSourceNotified(req.id);
+            log(`[nexus] notified source of resolved request ${req.id} (status=${req.status}) for ${productId}`);
+        }
+        catch (err) {
+            log(`[nexus] failed to notify source for request ${req.id}: ${err.message}`);
+        }
+    }
+    // --- SOURCE side: notify about pending clarifications. ---
+    // Exclude terminal requests (closed/declined): the edge handler rejects clarify on
+    // terminal requests, but guard here too so any pre-existing stale rows don't fire.
+    const pendingClarification = outgoing.filter((r) => !!r.clarificationMessage &&
+        !r.clarificationNotifiedAt &&
+        r.status !== 'closed' &&
+        r.status !== 'declined');
+    for (const req of pendingClarification) {
+        try {
+            await deps.notifyClarification(req);
+            await deps.markClarificationNotified(req.id);
+            log(`[nexus] notified source of clarification request ${req.id} for ${productId}`);
+        }
+        catch (err) {
+            log(`[nexus] failed to notify source about clarification for request ${req.id}: ${err.message}`);
+        }
+    }
+    // --- SOURCE side: dependency-aware delivery gate (block + auto-resume). ---
+    // Turn the cross-product dependency into an actuator on the source delivery's
+    // execution_status so an armed focus blocks instead of churning, and resumes
+    // itself the moment the dependency clears. Daemon-owned transitions only.
+    await reconcileSourceDeliveryGates(outgoing, deps, log);
+}
+/**
+ * Block + auto-resume the source deliveries gated by outgoing Nexus requests.
+ *
+ * Per source delivery (grouped from `outgoing` by sourceDeliveryId):
+ *   BLOCK   -- a currently-`queued` (actionable) delivery with >=1 non-terminal
+ *              outgoing request is paused, with gate_state carrying the
+ *              "Waiting on <target product>" blocker + a nexusBlock provenance
+ *              marker. `paused` is non-actionable + blocking in the spawn walk,
+ *              so an armed focus stops spawning a team that cannot do the work.
+ *   RELEASE -- a `paused` delivery THIS gate paused (nexusBlock provenance) is
+ *              re-queued (and gate_state cleared) once ALL its outgoing requests
+ *              are terminal AND none ended `declined` (every one `closed`). A
+ *              declined request leaves it paused for a human to decide (the
+ *              decline -> NEEDS_INTENT notify already fired above).
+ *
+ * Idempotent: only a `queued` delivery is paused, only a nexus-paused delivery
+ * is resumed; re-running with the same inputs is a no-op. Never clobbers a
+ * delivery a human paused (no nexusBlock marker) or one with no open request.
+ */
+export async function reconcileSourceDeliveryGates(outgoing, deps, log) {
+    // Group outgoing requests by the source delivery they gate.
+    const byDelivery = new Map();
+    for (const req of outgoing) {
+        const deliveryId = req.sourceDeliveryId;
+        if (!deliveryId)
+            continue;
+        const list = byDelivery.get(deliveryId);
+        if (list)
+            list.push(req);
+        else
+            byDelivery.set(deliveryId, [req]);
+    }
+    if (byDelivery.size === 0)
+        return;
+    // One read of the source product's delivery states (status + gate_state).
+    let stateById = new Map();
+    try {
+        const states = await deps.listSourceDeliveryStates(
+        // sourceProductId is uniform across this product's outgoing requests, but
+        // fall back to scanning for any present value defensively.
+        outgoing.find((r) => r.sourceProductId)?.sourceProductId ?? '');
+        stateById = new Map(states.map((s) => [s.id, s]));
+    }
+    catch (err) {
+        log(`[nexus] gate: failed to read source delivery states: ${err.message}`);
+        return;
+    }
+    for (const [deliveryId, reqs] of byDelivery) {
+        const state = stateById.get(deliveryId);
+        if (!state)
+            continue;
+        const status = state.executionStatus;
+        const openReqs = reqs.filter((r) => r.status && NON_TERMINAL_REQUEST_STATUSES.has(r.status));
+        const declined = reqs.some((r) => r.status === 'declined');
+        try {
+            // BLOCK: pause a queued delivery that is waiting on an open request.
+            if (status === DELIVERY_STATUS.QUEUED && openReqs.length > 0) {
+                const target = openReqs[0];
+                const targetName = (target.targetProductId ? await deps.getProductName(target.targetProductId) : undefined) ??
+                    (target.title ? `request "${target.title}"` : undefined) ??
+                    target.targetProductId ??
+                    'another product';
+                const gateState = {
+                    blocking: [{ guardName: `Waiting on ${targetName}`, passed: false }],
+                    warnings: [],
+                    evaluatedAt: new Date().toISOString(),
+                    nexusBlock: { requestIds: openReqs.map((r) => r.id) },
+                };
+                await deps.pauseSourceDelivery(deliveryId, gateState, status);
+                log(`[nexus] gate: paused source delivery ${deliveryId.slice(0, 8)} -- waiting on ${targetName}`);
+                continue;
+            }
+            // RELEASE: re-queue a delivery THIS gate paused once its requests clear.
+            if (status === DELIVERY_STATUS.PAUSED &&
+                isNexusGateState(state.gateState) &&
+                openReqs.length === 0 &&
+                !declined) {
+                await deps.requeueSourceDelivery(deliveryId, status);
+                log(`[nexus] gate: resumed source delivery ${deliveryId.slice(0, 8)} -- all Nexus requests resolved`);
+            }
+        }
+        catch (err) {
+            log(`[nexus] gate: failed to reconcile source delivery ${deliveryId.slice(0, 8)}: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=nexus-return.js.map

package/dist/nexus-return.js.map

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

package/dist/queries/deliveries.d.ts

@@ -214,4 +214,16 @@ export declare function getMergeConflictDeliveries(_organizationId: string, prod
     focus_id: string | null;
     pipeline_config: PipelineConfig | null;
 }>>;
+/**
+ * Return the delivery_id (and derived focus_id + product_id) for a single
+ * issue, for use by resolveProvenance when only an issueId anchor is available.
+ *
+ * Returns null when the issue is not found or has no delivery.
+ * Best-effort: callers must handle null gracefully.
+ */
+export declare function getIssueDelivery(issueId: string): Promise<{
+    deliveryId: string;
+    productId: string | null;
+    focusId: string | null;
+} | null>;
 //# sourceMappingURL=deliveries.d.ts.map

package/dist/queries/deliveries.d.ts.map

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

package/dist/queries/deliveries.js

@@ -285,4 +285,21 @@ export async function getMergeConflictDeliveries(_organizationId, productId) {
         pipeline_config: d.pipelineConfig ?? null,
     }));
 }
+/**
+ * Return the delivery_id (and derived focus_id + product_id) for a single
+ * issue, for use by resolveProvenance when only an issueId anchor is available.
+ *
+ * Returns null when the issue is not found or has no delivery.
+ * Best-effort: callers must handle null gracefully.
+ */
+export async function getIssueDelivery(issueId) {
+    const result = await callApi('daemon_get_issue_delivery', { issueId });
+    if (!result.deliveryId)
+        return null;
+    return {
+        deliveryId: result.deliveryId,
+        productId: result.productId ?? null,
+        focusId: result.focusId ?? null,
+    };
+}
 //# sourceMappingURL=deliveries.js.map