@telora/daemon 0.22.245 → 0.22.290

package/dist/completion/team-outcome/decide-turn-work-rows.js

@@ -0,0 +1,366 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/team-progress/progress-guards-recorded-intent.test.ts
+// PINNED-BY-END
+/**
+ * decide() rows for a LEAD-TURN COMPLETION, from the work facts on: the
+ * completion action (terminate / escalate / hand off / re-engage), the
+ * cross-respawn advancement watchdog, and the wake -- held while the lead's
+ * workers report, paced by the hand-off floor, bounded by the re-engagement
+ * backstop.
+ *
+ * Each row is pure: it reads the pipeline state and the stop registry and
+ * returns actions for the applier, or null when it does not apply.
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/decide-turn-work-rows
+ */
+import { evaluateStop } from '../../supervision/stop-registry.js';
+import { renderWait, teamProgressWait } from '../../supervision/wait-reachability.js';
+import { decideCompletionAction } from '../completion-event/completion-decision.js';
+import { FIRST_RESULT_DEMOTED_KEEP_BOUND } from '../team-teardown/session-hold-bounds.js';
+import { HANDOFF_MIN_INTERVAL_MS, HANDOFF_UNPRODUCTIVE_LIMIT, WORKER_WAIT_RECHECK_MS, } from './exit-limits.js';
+import { teamStateOf } from './exit-pipeline-state.js';
+function workOf(state) {
+    return state.outcome.work;
+}
+/** The decided completion action, once recorded; null before. */
+function actionOf(state) {
+    return state.observed.completionAction ?? null;
+}
+function isWake(action) {
+    return action?.kind === 'handoff_new_work' || action?.kind === 'reengage';
+}
+function wakeKind(action) {
+    return action.kind === 'handoff_new_work' ? 'handoff' : 're-engagement';
+}
+const TERMINATED = { kind: 'terminated' };
+const HALTED = { kind: 'halted' };
+export const TURN_COMPLETE_WORK_ROWS = [
+    {
+        name: 'build-work-facts',
+        trigger: 'turn_complete',
+        decide: () => ({ actions: [{ kind: 'build_work_facts' }] }),
+    },
+    {
+        // The handoff-vs-terminate tree (completion-decision.ts), decided ONCE over
+        // the work facts and recorded for the rows below.
+        name: 'completion-decision',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const work = workOf(state);
+            if (!work || actionOf(state))
+                return null;
+            return {
+                actions: [{
+                        kind: 'record_completion_action',
+                        action: decideCompletionAction({
+                            teamHasActionableWork: work.teamHasActionableWork,
+                            advancedThisCycle: work.advancedThisCycle,
+                            hasNonAdvanceableStuck: work.stuck !== null,
+                            noProgressCycles: work.updatedNoProgressCycles,
+                            noProgressLimit: work.noProgressLimits.scopeCoverage,
+                            hasActionableOpenIssues: work.postHasActionableOpen,
+                            hasNewlyAppearedDelivery: work.hasNewlyAppearedDelivery,
+                            stallWindowElapsed: work.stallWindowElapsed,
+                        }),
+                    }],
+            };
+        },
+    },
+    {
+        // The cross-respawn delivery-advancement guard counts a cycle in which a
+        // team that owns work did not advance.
+        name: 'advancement-stall-record',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const work = workOf(state);
+            const action = actionOf(state);
+            if (!work || !action)
+                return null;
+            const shouldRecord = work.teamHasActionableWork
+                && action.kind !== 'escalate_no_progress_and_terminate'
+                && (work.priorSnapshot === null || !work.madeProgress);
+            return shouldRecord ? { actions: [{ kind: 'record_advancement_cycle', limit: work.noProgressLimits.deliveryAdvancement }] } : null;
+        },
+    },
+    {
+        name: 'advancement-stall-check',
+        trigger: 'turn_complete',
+        decide: ({ observed }) => (observed.advancement?.thresholdReached
+            ? { actions: [{ kind: 'read_open_team_failure' }] }
+            : null),
+    },
+    {
+        // Threshold reached: ONE escalation (idempotent against an open
+        // team_failure), then terminate.
+        name: 'advancement-stall-terminate',
+        trigger: 'turn_complete',
+        decide: ({ observed, outcome }) => {
+            if (!observed.advancement?.thresholdReached || observed.openTeamFailure === undefined)
+                return null;
+            return {
+                actions: [
+                    observed.openTeamFailure
+                        ? {
+                            kind: 'note', level: 'info',
+                            message: `Delivery-advancement stall for "${outcome.focusName}" but an open team_failure escalation ` +
+                                'already exists -- terminating without filing a duplicate',
+                        }
+                        : { kind: 'escalate_advancement_stalled' },
+                    { kind: 'terminate_team', reason: 'work_complete' },
+                ],
+                end: TERMINATED,
+            };
+        },
+    },
+    {
+        // Every action commits this cycle's no-progress TIMING (the counter VALUE
+        // is committed per action below). Only the no-actionable-work action can
+        // (re)record the demoted-keep hold; any other action ends that keep.
+        name: 'completion-action',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const action = actionOf(state);
+            if (!action)
+                return null;
+            const actions = action.kind === 'terminate_no_actionable_work'
+                ? [{ kind: 'commit_progress_timing' }]
+                : [{ kind: 'clear_session_hold', hold: 'first_result_teardown_demoted' }, { kind: 'commit_progress_timing' }];
+            switch (action.kind) {
+                case 'escalate_non_advanceable_and_terminate':
+                    return { actions: [...actions, { kind: 'read_open_team_failure' }] };
+                case 'terminate_no_actionable_work': {
+                    const nonTerminal = workOf(state)?.postNonTerminal.length ?? 0;
+                    return {
+                        actions: [
+                            ...actions,
+                            { kind: 'set_shutdown_reason', reason: nonTerminal > 0 ? 'no_actionable_work' : 'work_complete' },
+                            { kind: 'record_teardown_firing' },
+                            { kind: 'read_teardown_demoted' },
+                        ],
+                    };
+                }
+                case 'escalate_no_progress_and_terminate':
+                    // Rescue committed work into the gate before judging the team.
+                    return { actions: [...actions, { kind: 'reconcile_terminated_work' }] };
+                case 'handoff_new_work':
+                case 'reengage':
+                    return {
+                        actions: [
+                            ...actions,
+                            { kind: 'commit_no_progress' },
+                            { kind: 'commit_progress_snapshot' },
+                            { kind: 'read_worker_wait' },
+                        ],
+                    };
+            }
+        },
+    },
+    {
+        // Structural dead end: nothing -- not the team, not the daemon -- will move
+        // the delivery. File exactly one escalation and terminate.
+        name: 'non-advanceable-terminate',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const { observed, outcome } = state;
+            if (actionOf(state)?.kind !== 'escalate_non_advanceable_and_terminate' || observed.openTeamFailure === undefined)
+                return null;
+            return {
+                actions: [
+                    observed.openTeamFailure
+                        ? {
+                            kind: 'note', level: 'info',
+                            message: `Non-advanceable delivery for "${outcome.focusName}" but an open escalation already exists -- ` +
+                                'terminating without filing a duplicate',
+                        }
+                        : { kind: 'escalate_non_advanceable' },
+                    { kind: 'commit_progress_snapshot' },
+                    { kind: 'terminate_team', reason: 'work_complete' },
+                ],
+                end: TERMINATED,
+            };
+        },
+    },
+    {
+        // No team-actionable work: tear down -- unless teardown-at-first-result is
+        // demoted to observe-only, when the team is kept (bounded) to do the work.
+        name: 'no-actionable-work-teardown',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const { observed, outcome } = state;
+            const work = workOf(state);
+            if (actionOf(state)?.kind !== 'terminate_no_actionable_work' || observed.teardownDemoted === undefined || !work)
+                return null;
+            const nonTerminal = work.postNonTerminal.length;
+            const holdClass = work.underVerifyHold
+                ? 'held by an in-flight verify'
+                : 'in daemon-managed states (in_review / paused / verify-pending)';
+            if (observed.teardownDemoted) {
+                return {
+                    actions: [
+                        { kind: 'mark_teardown_firing_unacted' },
+                        {
+                            kind: 'note', level: 'info',
+                            message: `No team-actionable work remains for "${outcome.focusName}" but teardown-at-first-result is DEMOTED to ` +
+                                'observe-only -- recording the firing (unacted) and re-arming the detector but NOT terminating ' +
+                                '(bounded by a first_result_teardown_demoted session hold)',
+                        },
+                    ],
+                    end: { kind: 'kept', bound: FIRST_RESULT_DEMOTED_KEEP_BOUND, reason: 'teardown-at-first-result is demoted to observe-only' },
+                };
+            }
+            return {
+                actions: [
+                    {
+                        kind: 'note', level: 'info',
+                        message: `No team-actionable work remains for "${outcome.focusName}" -- ${nonTerminal} non-terminal ` +
+                            `delivery(ies) ${holdClass}; terminating cleanly`,
+                    },
+                    { kind: 'terminate_team', reason: nonTerminal > 0 ? 'no_actionable_work' : 'work_complete' },
+                ],
+                end: TERMINATED,
+            };
+        },
+    },
+    {
+        // The team owns work it has not moved for the stall window: rescued work
+        // ends it cleanly; nothing rescued files the no-progress team_failure.
+        name: 'no-progress-terminate',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const { observed, outcome } = state;
+            const work = workOf(state);
+            if (actionOf(state)?.kind !== 'escalate_no_progress_and_terminate' || observed.reconciledCount === undefined || !work)
+                return null;
+            if (observed.reconciledCount > 0) {
+                return {
+                    actions: [
+                        { kind: 'commit_no_progress' },
+                        { kind: 'commit_progress_snapshot' },
+                        {
+                            kind: 'note', level: 'info',
+                            message: `Terminated team for "${outcome.focusName}" had committed work -- reconciled ${observed.reconciledCount} ` +
+                                'coding delivery(ies) into verify; terminating WITHOUT a team_failure escalation.',
+                        },
+                        { kind: 'terminate_team', reason: 'work_complete' },
+                    ],
+                    end: TERMINATED,
+                };
+            }
+            return {
+                actions: [
+                    { kind: 'commit_no_progress' },
+                    { kind: 'commit_progress_snapshot' },
+                    {
+                        kind: 'note', level: 'warn',
+                        message: `Scope-coverage guard tripped for "${outcome.focusName}" -- ${work.updatedNoProgressCycles} consecutive ` +
+                            `cycles with no progress on ${work.postNonTerminal.length} non-terminal delivery(ies); the bound on ` +
+                            `${renderWait(teamProgressWait(work.postNonTerminal.length))} fired -- escalating and terminating`,
+                    },
+                    { kind: 'escalate_no_progress' },
+                    { kind: 'terminate_team', reason: 'work_complete' },
+                ],
+                end: TERMINATED,
+            };
+        },
+    },
+    {
+        // A lead waiting on its live workers is left to wait -- unless there is
+        // work it has not been shown. The recheck re-reads the focus on the poll
+        // cadence, so arriving work itself re-drives the decision.
+        name: 'worker-wait',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const action = actionOf(state);
+            const wait = state.observed.workerWait;
+            if (!isWake(action) || !wait)
+                return null;
+            if (!evaluateStop('worker_wait_hold', { workersLive: wait.quietInMs !== null, hasUnshownWork: wait.hasUnshownWork })) {
+                return { actions: [{ kind: 'end_worker_wait' }] };
+            }
+            return {
+                actions: [
+                    { kind: 'hold_wake_for_workers', wake: wakeKind(action) },
+                    { kind: 'schedule_worker_recheck', delayMs: Math.min(wait.quietInMs ?? 0, WORKER_WAIT_RECHECK_MS) },
+                ],
+                end: HALTED,
+            };
+        },
+    },
+    {
+        // A burst of result events must not produce a burst of wakes: inside the
+        // floor the wake is deferred to a scheduled re-drive (a parked lead only
+        // completes in response to a wake, so a deferred final completion must
+        // not be lost).
+        name: 'handoff-floor',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const action = actionOf(state);
+            const work = workOf(state);
+            if (!isWake(action) || !work || !state.observed.workerWait)
+                return null;
+            const lastHandoffAt = teamStateOf(state).lastHandoffAt;
+            const since = lastHandoffAt == null ? Number.POSITIVE_INFINITY : work.nowMs - lastHandoffAt;
+            if (since >= HANDOFF_MIN_INTERVAL_MS)
+                return null;
+            const wake = wakeKind(action);
+            return {
+                actions: [
+                    {
+                        kind: 'note', level: 'info',
+                        message: `Deferring ${wake} for "${state.outcome.focusName}": last handoff ${since}ms ago (< ${HANDOFF_MIN_INTERVAL_MS}ms ` +
+                            'floor) -- scheduling a post-floor self re-drive so a lead whose final completion was deferred is not ' +
+                            'parked idle-but-executing.',
+                    },
+                    { kind: 'schedule_redrive', delayMs: Math.max(0, HANDOFF_MIN_INTERVAL_MS - since) },
+                ],
+                end: HALTED,
+            };
+        },
+    },
+    {
+        // Consecutive unproductive re-engagements are an ask the lead left
+        // unanswered: the one stalled_team row decides when they end the team.
+        name: 'reengagement-backstop',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const action = actionOf(state);
+            const work = workOf(state);
+            if (!isWake(action) || !work || !state.observed.workerWait)
+                return null;
+            const prior = teamStateOf(state).unproductiveReengagements ?? 0;
+            if (!evaluateStop('stalled_team', {
+                asks: [{ counter: 'reengagement', count: prior, limit: HANDOFF_UNPRODUCTIVE_LIMIT, stillWindowElapsed: work.stallWindowElapsed }],
+            }).fires)
+                return null;
+            return {
+                actions: [
+                    {
+                        kind: 'note', level: 'warn',
+                        message: `Re-engagement backstop for "${state.outcome.focusName}" -- ${prior} consecutive unproductive ` +
+                            're-engagements with the team still; terminating cleanly instead of re-waking indefinitely.',
+                    },
+                    { kind: 'terminate_team', reason: 'work_complete' },
+                ],
+                end: TERMINATED,
+            };
+        },
+    },
+    {
+        // Open work on actionable deliveries -> the new work; planning deliveries
+        // left -> a re-engagement nudge to scope them.
+        name: 'wake',
+        trigger: 'turn_complete',
+        decide: (state) => {
+            const action = actionOf(state);
+            if (!isWake(action) || !state.observed.workerWait)
+                return null;
+            return {
+                actions: [{ kind: 'count_reengagement' }, { kind: 'send_wake', wake: wakeKind(action) }],
+                end: HALTED,
+            };
+        },
+    },
+];
+//# sourceMappingURL=decide-turn-work-rows.js.map

package/dist/completion/team-outcome/decide-turn-work-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide-turn-work-rows.js","sourceRoot":"","sources":["../../../src/completion/team-outcome/decide-turn-work-rows.ts"],"names":[],"mappings":"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"}

package/dist/completion/team-outcome/decide.d.ts

@@ -0,0 +1,49 @@
+/**
+ * decide() -- THE team-exit decision table.
+ *
+ * "What does the daemon do when a team exits?" is answered here. Both exit
+ * paths -- the lead process closing and the lead's turn completing -- hand
+ * their TeamOutcome to this one function and carry out only the actions it
+ * returns, through the one applier (apply.ts). decide() is pure: it performs no
+ * I/O and no writes. It reads the pipeline state (the outcome, the team state,
+ * and what the applier has observed so far) and the stop registry
+ * (supervision/stop-registry.ts), and returns the next row's actions.
+ *
+ * The table is ordered; each row declares the exit path it belongs to. The
+ * rows live by concern and are assembled below:
+ *
+ *   - decide-close-rows.ts        a process close
+ *   - decide-turn-entry-rows.ts   a turn completion, up to the work facts
+ *   - decide-turn-work-rows.ts    a turn completion, from the work facts on
+ *   - decide-advance-rows.ts      a delivery advance a poll-side advancer
+ *                                 carries out after the team is gone
+ *
+ * What an exit means regardless of its path -- whether it succeeded, and
+ * whether and how its review outcome is routed -- is decided once, by the
+ * table's FIRST row (decide-shared.ts), which belongs to both team-exit paths
+ * and emits the same decide_exit action on either.
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/decide
+ */
+import type { ExitDecisionRow } from './decide-row.js';
+import type { ExitPipelineState } from './exit-pipeline-state.js';
+import type { RowDecision } from './exit-actions.js';
+/** Every row, in the order decide() consults them. */
+export declare const TEAM_EXIT_DECISION_TABLE: readonly ExitDecisionRow[];
+/** Does this row belong to the exit path of this trigger? */
+export declare function rowBelongsTo(row: ExitDecisionRow, trigger: ExitPipelineState['outcome']['trigger']): boolean;
+/** One decision: the row that decided, what it decided, and where the next look starts. */
+export interface TeamExitDecision extends RowDecision {
+    row: string;
+    /** Index of the next row to consult. */
+    nextCursor: number;
+}
+/**
+ * The next decision for this exit: the first row at or after the cursor that
+ * belongs to the outcome's exit path and applies. Null when no row is left --
+ * the exit has been fully decided.
+ */
+export declare function decide(state: ExitPipelineState): TeamExitDecision | null;
+//# sourceMappingURL=decide.d.ts.map

package/dist/completion/team-outcome/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../../src/completion/team-outcome/decide.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,EAAE,SAAS,eAAe,EAM9D,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAE5G;AAED,2FAA2F;AAC3F,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,CAQxE"}

package/dist/completion/team-outcome/decide.js

@@ -0,0 +1,41 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/completion-event/merge-resolution-hold.test.ts,
+//   packages/daemon/src/completion/completion-event/unclaimed-migration-notice.test.ts,
+//   packages/daemon/src/completion/team-outcome/decide-path-invariance.test.ts,
+//   packages/daemon/src/completion/team-outcome/decide.test.ts,
+//   packages/daemon/src/completion/team-outcome/delivery-advance.test.ts
+// PINNED-BY-END
+import { EXIT_DECISION_ROWS } from './decide-shared.js';
+import { PROCESS_CLOSE_ROWS } from './decide-close-rows.js';
+import { TURN_COMPLETE_ENTRY_ROWS } from './decide-turn-entry-rows.js';
+import { TURN_COMPLETE_WORK_ROWS } from './decide-turn-work-rows.js';
+import { DELIVERY_ADVANCE_ROWS } from './decide-advance-rows.js';
+/** Every row, in the order decide() consults them. */
+export const TEAM_EXIT_DECISION_TABLE = [
+    ...EXIT_DECISION_ROWS,
+    ...PROCESS_CLOSE_ROWS,
+    ...TURN_COMPLETE_ENTRY_ROWS,
+    ...TURN_COMPLETE_WORK_ROWS,
+    ...DELIVERY_ADVANCE_ROWS,
+];
+/** Does this row belong to the exit path of this trigger? */
+export function rowBelongsTo(row, trigger) {
+    return typeof row.trigger === 'string' ? row.trigger === trigger : row.trigger.includes(trigger);
+}
+/**
+ * The next decision for this exit: the first row at or after the cursor that
+ * belongs to the outcome's exit path and applies. Null when no row is left --
+ * the exit has been fully decided.
+ */
+export function decide(state) {
+    for (let i = state.cursor; i < TEAM_EXIT_DECISION_TABLE.length; i++) {
+        const row = TEAM_EXIT_DECISION_TABLE[i];
+        if (!rowBelongsTo(row, state.outcome.trigger))
+            continue;
+        const decision = row.decide(state);
+        if (decision)
+            return { ...decision, row: row.name, nextCursor: i + 1 };
+    }
+    return null;
+}
+//# sourceMappingURL=decide.js.map

package/dist/completion/team-outcome/decide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../../src/completion/team-outcome/decide.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,wFAAwF;AACxF,gFAAgF;AAChF,gEAAgE;AAChE,yEAAyE;AACzE,gBAAgB;AAmChB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,sDAAsD;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAA+B;IAClE,GAAG,kBAAkB;IACrB,GAAG,kBAAkB;IACrB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;CACzB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,GAAoB,EAAE,OAAgD;IACjG,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACnG,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAwB;IAC7C,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,wBAAwB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,wBAAwB,CAAC,CAAC,CAAE,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,QAAQ;YAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/completion/team-outcome/delivery-advance-types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The delivery-level consequences of a team's exit that a poll-side advancer
+ * carries out after the team is gone, as data: a proposed status write, or a
+ * commit-verdict hold release. Types only; a delivery_advance TeamOutcome
+ * carries one of these to decide().
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/delivery-advance-types
+ */
+import type { ArtifactReferences } from '../../types/index.js';
+import type { AutoApproveStamp, TransitionRecord } from '../../queries/deliveries/deliveries.js';
+import type { DeliveryGateState } from '../../queries/delivery-gate-state/delivery-gate-state.js';
+import type { CommitVerdictHoldState, HeldReviewExit } from '../../queries/delivery-gate-state/delivery-gate-holds.js';
+import type { GateVerdictState } from '../../verify/gate-verdicts/own-gate-verdict.js';
+/**
+ * Write one delivery's execution_status (and, when given, its stage, gate
+ * state, artifacts, transition record and auto-approve stamp). The positional
+ * shape of the physical writer, so an advancer's writer seam keeps its shape.
+ */
+export type DeliveryStatusWriter = (deliveryId: string, executionStatus: string, currentWorkflowStageId?: string | null, gateState?: DeliveryGateState | null, completionArtifacts?: ArtifactReferences | null, transition?: TransitionRecord, autoApprove?: AutoApproveStamp) => Promise<void>;
+/** One status write an advancer's reconciler proposed. */
+export interface DeliveryStatusWrite {
+    deliveryId: string;
+    executionStatus: string;
+    currentWorkflowStageId: string | null | undefined;
+    gateState: DeliveryGateState | null | undefined;
+    completionArtifacts: ArtifactReferences | null | undefined;
+    transition: TransitionRecord | undefined;
+    autoApprove: AutoApproveStamp | undefined;
+}
+/** A delivery held on a commit verdict, as the release pass read it. */
+export interface HeldVerdictDelivery {
+    deliveryId: string;
+    deliveryName: string;
+    /** The row's gate_state (the hold marker and the verification history). */
+    gateState: unknown;
+    hold: CommitVerdictHoldState;
+    /**
+     * The held commit is no longer the focus HEAD and the HEAD adds work of the
+     * focus's own: the held review judged nothing the HEAD carries.
+     */
+    superseded: boolean;
+    /** The awaited commit's gate verdict (null when superseded: not read). */
+    verdict: GateVerdictState | null;
+    /** A gate run judging the awaited commit is selected or in flight. */
+    gateRunPending: boolean;
+}
+/** One focus's commit-verdict holds at one HEAD. */
+export interface CommitVerdictRelease {
+    /** The focus HEAD the holds are read against. */
+    head: string;
+    held: HeldVerdictDelivery[];
+}
+/** What a poll-side advancer hands decide(). */
+export type DeliveryAdvance = {
+    kind: 'status_write';
+    write: DeliveryStatusWrite;
+} | {
+    kind: 'commit_verdict_release';
+    release: CommitVerdictRelease;
+};
+/** The review exit a release replays. */
+export type ReplayedReviewExit = HeldReviewExit;
+//# sourceMappingURL=delivery-advance-types.d.ts.map

package/dist/completion/team-outcome/delivery-advance-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-advance-types.d.ts","sourceRoot":"","sources":["../../../src/completion/team-outcome/delivery-advance-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,0DAA0D,CAAC;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,EACtC,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,EACpC,mBAAmB,CAAC,EAAE,kBAAkB,GAAG,IAAI,EAC/C,UAAU,CAAC,EAAE,gBAAgB,EAC7B,WAAW,CAAC,EAAE,gBAAgB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,mBAAmB,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACzC,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC3C;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,sBAAsB,CAAC;IAC7B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,EAAE,CAAC;CAC7B;AAED,gDAAgD;AAChD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEtE,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC"}

package/dist/completion/team-outcome/delivery-advance-types.js

@@ -0,0 +1,5 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/team-outcome/delivery-advance.test.ts
+// PINNED-BY-END
+export {};
+//# sourceMappingURL=delivery-advance-types.js.map

package/dist/completion/team-outcome/delivery-advance-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-advance-types.js","sourceRoot":"","sources":["../../../src/completion/team-outcome/delivery-advance-types.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kFAAkF;AAClF,gBAAgB"}

package/dist/completion/team-outcome/delivery-advance.d.ts

@@ -0,0 +1,39 @@
+import { type ExitPipelineState } from './exit-pipeline-state.js';
+import type { ApplierStatusWriter, DeliveryAdvanceEnv } from './apply-advance.js';
+import type { TransitionRecord } from '../../queries/deliveries/deliveries.js';
+import type { DeliveryAdvance, DeliveryStatusWriter } from './delivery-advance-types.js';
+/** The delivery's focus, when the advancer knows it. */
+export interface DeliveryAdvanceFocus {
+    focusId?: string;
+    focusName?: string;
+}
+/**
+ * Run one delivery advance through decide() and the applier. Returns the
+ * pipeline state, whose observations say what the applier did.
+ */
+export declare function runDeliveryAdvance(advance: DeliveryAdvance, env: Omit<DeliveryAdvanceEnv, 'trigger'>, focus?: DeliveryAdvanceFocus): Promise<ExitPipelineState>;
+/** A clean review's auto-approval of one delivery. */
+export type AutoApproveDelivery = (deliveryId: string, reviewSessionId: string, doneStageId: string | null, transition?: TransitionRecord) => Promise<void>;
+/**
+ * A clean review's auto-approval: verify -> done at the done stage, the gate
+ * cleared on the way out (a shortfall-held delivery must not carry a "Waiting
+ * on" banner into done), the auto-approve stamp (auto_approved_at +
+ * auto_approved_by_session, so the unapprove path can tell it from an explicit
+ * review pass) and the verify -> done transition (the cycle-time population
+ * reads delivery_transitions). One status write through decide() and the
+ * applier, like every other advance.
+ */
+export declare function autoApproveDeliveryThrough(applier: ApplierStatusWriter): AutoApproveDelivery;
+/** The advancers every team-exit and poll-side advancer is wired with. */
+export interface DeliveryAdvancers {
+    /**
+     * THE status writer for every team-exit and poll-side advancer: the
+     * positional shape of the physical writer, carried out through the pipeline.
+     */
+    readonly advanceDeliveryStatus: DeliveryStatusWriter;
+    /** A clean review's auto-approval (autoApproveDeliveryThrough). */
+    readonly autoApproveDelivery: AutoApproveDelivery;
+}
+/** The advancers over one applier status writer (the composition root binds the physical writer into it). */
+export declare function deliveryAdvancersThrough(applier: ApplierStatusWriter): DeliveryAdvancers;
+//# sourceMappingURL=delivery-advance.d.ts.map

package/dist/completion/team-outcome/delivery-advance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-advance.d.ts","sourceRoot":"","sources":["../../../src/completion/team-outcome/delivery-advance.ts"],"names":[],"mappings":"AA6BA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEzF,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,EACxC,KAAK,GAAE,oBAAyB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,CAChC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,CAAC,EAAE,gBAAgB,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,CAa5F;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,EAAE,oBAAoB,CAAC;IACrD,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD;AAED,6GAA6G;AAC7G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CAYxF"}