@telora/daemon 0.22.245 → 0.22.290

package/dist/completion/team-outcome/exit-pipeline-state.d.ts

@@ -0,0 +1,113 @@
+/**
+ * What the team-exit pipeline knows while it runs: the TeamOutcome, the team
+ * state it decides over (read-only to decide()), what the applier has observed
+ * so far, and how far through the decide() table it is.
+ *
+ * decide() reads this; only the applier (apply.ts) and the driver
+ * (run-exit-pipeline.ts) write it.
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/exit-pipeline-state
+ */
+import type { FocusDeliveryInfo, FocusIssueInfo, FocusTeamState } from '../../types/index.js';
+import type { TeamOutcome } from './team-outcome.js';
+import type { NoticeDelivery } from '../completion-event/unclaimed-migration-notice.js';
+import type { CompletionAction } from '../completion-event/completion-decision.js';
+import type { TeamExitAction } from './exit-actions.js';
+import type { ExitDecision } from './decide-shared.js';
+/** The focus's unclaimed-migration record as read at the exit. */
+export type UnclaimedMigrationObservation = 
+/** The read failed: not evidence that there is nothing to tell. */
+{
+    kind: 'read_failed';
+}
+/** The record (null: none), and whether it already carries its named-at marker. */
+ | {
+    kind: 'record';
+    record: string | null;
+    alreadyNamed: boolean;
+};
+/** What the applier has observed so far. Every field is absent until its read ran. */
+export interface ExitObservations {
+    /** Deliveries the team plausibly worked on (report_git_state). */
+    workedDeliveryIds?: string[];
+    /** The read-only worktree carries agent-authored changes / branch commits. */
+    readOnlyWorktree?: {
+        agentDirty: boolean;
+        committed: boolean;
+    };
+    /** The focus->integration merge attempt. */
+    merge?: {
+        attempted: boolean;
+        mergeSucceeded: boolean;
+        exitReason: string | null;
+    };
+    /** The pass the finalized session row belongs to. */
+    finalizedPassId?: string | null;
+    /** The lineage of a queued respawn for this focus (null when none). */
+    pendingNextLineage?: string | null;
+    /** The focus's deliveries + issues, read once at the start. */
+    deliveries?: FocusDeliveryInfo[];
+    issues?: FocusIssueInfo[];
+    unclaimedMigration?: UnclaimedMigrationObservation;
+    noticeDelivery?: NoticeDelivery;
+    reviewRequestedAt?: string | null;
+    /** A completing coding pass in a review window still owns work it can act on. */
+    codingPassHasActionableWork?: boolean;
+    /**
+     * The deliveries after the wake-cycle self-heal advance: null when the
+     * re-read failed (the pre-advance list stands).
+     */
+    healedDeliveries?: FocusDeliveryInfo[] | null;
+    /** The completion action decided over the work facts (recorded once, read by later rows). */
+    completionAction?: CompletionAction;
+    /** The persistent delivery-advancement guard's verdict for this cycle. */
+    advancement?: {
+        thresholdReached: boolean;
+        noAdvancementCycles: number;
+    } | null;
+    /** An open team_failure escalation already names this focus. */
+    openTeamFailure?: boolean;
+    /** Teardown-at-first-result is demoted to observe-only. */
+    teardownDemoted?: boolean;
+    /** Terminated-work reconciliation: coding deliveries moved into verify. */
+    reconciledCount?: number;
+    /** The canonical exit decision, recorded by the decide_exit action (decide-shared.ts). */
+    exitDecision?: ExitDecision;
+    /** What a commit-verdict release pass did with the holds it was handed. */
+    verdictRelease?: {
+        superseded: number;
+        released: number;
+        waiting: number;
+    };
+    /** The team's live workers: ms until quiet (null: none live), and unshown work. */
+    workerWait?: {
+        quietInMs: number | null;
+        hasUnshownWork: boolean;
+    };
+}
+/** The pipeline's running state. */
+export interface ExitPipelineState {
+    readonly outcome: TeamOutcome;
+    /** The team decided over (null for a delivery advance: its team is gone). decide() only reads it. */
+    readonly teamState: Readonly<FocusTeamState> | null;
+    readonly observed: ExitObservations;
+    /**
+     * The kind of every action the applier entry (apply.ts applyTeamExitAction)
+     * performed, in order: the record that an exit's effects ran through it.
+     */
+    readonly applied: TeamExitAction['kind'][];
+    /** Index of the next decide() row to consult. */
+    cursor: number;
+}
+/** A fresh pipeline state for an outcome. */
+export declare function createExitPipelineState(outcome: TeamOutcome, teamState: FocusTeamState | null): ExitPipelineState;
+/** The team a team-exit row decides over (every team-exit outcome carries one). */
+export declare function teamStateOf(state: ExitPipelineState): Readonly<FocusTeamState>;
+/**
+ * The deliveries the decision reads after the self-heal: the healed re-read
+ * when it succeeded, the start-of-exit read otherwise.
+ */
+export declare function effectiveDeliveriesOf(observed: ExitObservations): FocusDeliveryInfo[];
+//# sourceMappingURL=exit-pipeline-state.d.ts.map

package/dist/completion/team-outcome/exit-pipeline-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-pipeline-state.d.ts","sourceRoot":"","sources":["../../../src/completion/team-outcome/exit-pipeline-state.ts"],"names":[],"mappings":"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"}

package/dist/completion/team-outcome/exit-pipeline-state.js

@@ -0,0 +1,28 @@
+// 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/terminal-error-terminate.test.ts,
+//   packages/daemon/src/completion/team-outcome/apply.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,
+//   packages/daemon/src/completion/team-outcome/team-outcome-characterization.test.ts,
+//   packages/daemon/src/completion/team-progress/progress-guards-recorded-intent.test.ts,
+//   packages/daemon/src/integration/model-reached-review-exit-effects.test.ts
+// PINNED-BY-END
+/** A fresh pipeline state for an outcome. */
+export function createExitPipelineState(outcome, teamState) {
+    return { outcome, teamState, observed: {}, applied: [], cursor: 0 };
+}
+/** The team a team-exit row decides over (every team-exit outcome carries one). */
+export function teamStateOf(state) {
+    if (!state.teamState)
+        throw new Error('a team-exit row was asked about an outcome with no team');
+    return state.teamState;
+}
+/**
+ * The deliveries the decision reads after the self-heal: the healed re-read
+ * when it succeeded, the start-of-exit read otherwise.
+ */
+export function effectiveDeliveriesOf(observed) {
+    return observed.healedDeliveries ?? observed.deliveries ?? [];
+}
+//# sourceMappingURL=exit-pipeline-state.js.map

package/dist/completion/team-outcome/exit-pipeline-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-pipeline-state.js","sourceRoot":"","sources":["../../../src/completion/team-outcome/exit-pipeline-state.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,+DAA+D;AAC/D,gFAAgF;AAChF,gEAAgE;AAChE,0EAA0E;AAC1E,uFAAuF;AACvF,0FAA0F;AAC1F,8EAA8E;AAC9E,gBAAgB;AA4FhB,6CAA6C;AAC7C,MAAM,UAAU,uBAAuB,CAAC,OAAoB,EAAE,SAAgC;IAC5F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA0B;IAC9D,OAAO,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,123 @@
+/**
+ * TeamOutcome -- the single typed record of how a team exited.
+ *
+ * A team's lead ends a segment of work in one of two ways:
+ *
+ *   - process close   the lead PROCESS exited (handleTeamCompletion).
+ *   - turn complete   the lead's TURN completed while its process lives on
+ *                     (handleCompletionEvent).
+ *
+ * Both build ONE value through buildTeamOutcome: who the team is, how it
+ * ended (exit code / signal / result error, and -- for a closed process -- the
+ * exit classification, category and initial exit reason), and the holds it
+ * carried at the moment it ended. The facts about the WORK the team leaves
+ * behind (deliveries, issues, progress) are gathered after the exit into
+ * `work` by buildTeamWorkFacts (work-facts.ts) -- the same module family, so
+ * there is one place that says what the daemon knows about an exit.
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/team-outcome
+ */
+import type { FocusTeamState } from '../../types/index.js';
+import type { ExitCategory } from '../../types/exit-category.js';
+import { type TeamExitClassification } from '../team-exit/exit-classification.js';
+import type { TeamWorkFacts } from './work-facts.js';
+import type { DeliveryAdvance } from './delivery-advance-types.js';
+/**
+ * Which path observed the exit: the two team-exit paths, or a delivery-level
+ * consequence of a team's exit that a poll tick carries out later (a delivery
+ * advance or a commit-verdict release).
+ */
+export type TeamOutcomeTrigger = 'process_close' | 'turn_complete' | 'delivery_advance';
+/** How the lead PROCESS exited (process close). */
+export interface ProcessCloseExit {
+    readonly trigger: 'process_close';
+    readonly code: number | null;
+    readonly signal: string | null;
+    /** How the process exited (success / controlled stop / crash). */
+    readonly classification: TeamExitClassification;
+    /** The exit_category recorded on the session row; every close carries one. */
+    readonly exitCategory: ExitCategory;
+    /** The session's exit reason before the merge / CI steps append to it. */
+    readonly initialExitReason: string;
+}
+/** How the lead's TURN completed while its process lives on (turn complete). */
+export interface TurnCompleteExit {
+    readonly trigger: 'turn_complete';
+    /** The completing turn's result carried is_error. */
+    readonly resultIsError: boolean;
+}
+/**
+ * A delivery-level consequence of a team's exit that a poll-side advancer
+ * carries out after the team is gone: the status write its reconciler proposes,
+ * or a commit-verdict hold release (delivery-advance.ts).
+ */
+export interface DeliveryAdvanceExit {
+    readonly trigger: 'delivery_advance';
+    readonly advance: DeliveryAdvance;
+}
+/** How the team ended this segment. */
+export type TeamOutcomeExit = ProcessCloseExit | TurnCompleteExit | DeliveryAdvanceExit;
+/** Conditions the team carried at the moment it ended. */
+export interface TeamOutcomeHolds {
+    /** A merge-conflict resolution the daemon asked this team for is outstanding. */
+    readonly mergeResolutionOutstanding: boolean;
+    /** The model provider stopped the session on a usage / rate limit. */
+    readonly modelUnavailable: NonNullable<FocusTeamState['modelUnavailable']> | null;
+}
+/** The single typed record of how a team exited. */
+export interface TeamOutcome {
+    readonly trigger: TeamOutcomeTrigger;
+    readonly focusId: string;
+    readonly focusName: string;
+    readonly sessionId: string;
+    readonly sessionType: FocusTeamState['sessionType'];
+    readonly readOnly: boolean;
+    readonly planningPhase: boolean;
+    readonly shutdownReason: FocusTeamState['shutdownReason'];
+    readonly exit: TeamOutcomeExit;
+    readonly holds: TeamOutcomeHolds;
+    /**
+     * The work the team leaves behind, gathered after the exit
+     * (buildTeamWorkFacts). Null until gathered.
+     */
+    work: TeamWorkFacts | null;
+}
+/** What each exit path observed; the builder turns either into a TeamOutcome. */
+export type TeamOutcomeInput = {
+    trigger: 'process_close';
+    teamState: FocusTeamState;
+    sessionId: string;
+    code: number | null;
+    signal: string | null;
+} | {
+    trigger: 'turn_complete';
+    teamState: FocusTeamState;
+    /** Omitted: the team's lead session id. */
+    sessionId?: string;
+    resultIsError: boolean;
+} | {
+    trigger: 'delivery_advance';
+    /** The delivery's focus, when the advancer knows it (a writer seam may not). */
+    focusId?: string;
+    focusName?: string;
+    advance: DeliveryAdvance;
+};
+/** Build the initial exit reason from the exit classification. */
+export declare function buildInitialExitReason(teamState: FocusTeamState, classification: Pick<TeamExitClassification, 'exitCode' | 'proactivelyTerminated' | 'succeeded' | 'controlledStop'>, signal: string | null): string;
+/**
+ * THE builder. Both exit paths call it, and nothing else assembles facts about
+ * how a team exited. Pure: reads the team state and the observed exit only.
+ */
+export declare function buildTeamOutcome(input: TeamOutcomeInput): TeamOutcome;
+/**
+ * Whether the exit succeeded -- ONE reading for both team-exit paths, so the
+ * same exit means the same thing on either: a process close by its
+ * classification (a clean exit or a lifecycle teardown), a turn completion by
+ * its result (not an error). A delivery advance is not a team's exit.
+ */
+export declare function outcomeSucceeded(outcome: TeamOutcome): boolean;
+/** The turn's result was an error (false on a process close, judged by code/signal instead). */
+export declare function outcomeResultIsError(outcome: TeamOutcome): boolean;
+//# sourceMappingURL=team-outcome.d.ts.map

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

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

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

@@ -0,0 +1,113 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/team-exit/teardown-merge-gate.test.ts,
+//   packages/daemon/src/completion/team-outcome/apply.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,
+//   packages/daemon/src/completion/team-outcome/team-outcome-characterization.test.ts,
+//   packages/daemon/src/completion/team-progress/progress-guards-recorded-intent.test.ts,
+//   packages/daemon/src/integration/model-reached-review-exit-effects.test.ts,
+//   packages/daemon/src/spawn/codex-auth.test.ts
+// PINNED-BY-END
+import { classifyTeamExit, deriveExitCategory, } from '../team-exit/exit-classification.js';
+/** Build the initial exit reason from the exit classification. */
+export function buildInitialExitReason(teamState, classification, signal) {
+    const { exitCode, proactivelyTerminated, succeeded, controlledStop } = classification;
+    return exitCode === 0
+        ? 'Focus team completed.'
+        : proactivelyTerminated
+            ? teamState.mergedDeliveryIds.size > 0
+                ? `Focus team terminated: ${teamState.mergedDeliveryIds.size} deliveries merged.`
+                : 'Focus team terminated: all work complete.'
+            : controlledStop && !succeeded
+                // Benign daemon-initiated stop (deactivated / handoff / teardown /
+                // user_stopped). Clean message -- NOT "terminated by signal: SIGTERM".
+                ? `Focus team stopped (${teamState.shutdownReason ?? 'controlled'}).`
+                : signal
+                    ? `Team lead terminated by signal: ${signal}`
+                    : `Team lead exited with code: ${exitCode}`;
+}
+/**
+ * THE builder. Both exit paths call it, and nothing else assembles facts about
+ * how a team exited. Pure: reads the team state and the observed exit only.
+ */
+export function buildTeamOutcome(input) {
+    if (input.trigger === 'delivery_advance') {
+        // Keyed by its delivery: the team whose exit it follows is gone.
+        return {
+            trigger: 'delivery_advance',
+            focusId: input.focusId ?? '',
+            focusName: input.focusName ?? '',
+            sessionId: '',
+            sessionType: 'coding',
+            readOnly: false,
+            planningPhase: false,
+            shutdownReason: null,
+            exit: { trigger: 'delivery_advance', advance: input.advance },
+            holds: { mergeResolutionOutstanding: false, modelUnavailable: null },
+            work: null,
+        };
+    }
+    const { teamState } = input;
+    let exit;
+    if (input.trigger === 'process_close') {
+        // A lifecycle teardown (shutdownReason='work_complete') SIGTERM is a
+        // success, NOT a review failure -- see classifyTeamExit.
+        const classification = classifyTeamExit({
+            code: input.code,
+            signal: input.signal,
+            teamPhase: teamState.phase,
+            shutdownReason: teamState.shutdownReason,
+        });
+        exit = {
+            trigger: 'process_close',
+            code: input.code,
+            signal: input.signal,
+            classification,
+            // Every close carries a category: a categoryless close leaves the
+            // dashboard matching prose in exit_reason to decide what to show.
+            exitCategory: deriveExitCategory(classification.disposition, teamState.shutdownReason),
+            initialExitReason: buildInitialExitReason(teamState, classification, input.signal),
+        };
+    }
+    else {
+        exit = { trigger: 'turn_complete', resultIsError: input.resultIsError };
+    }
+    return {
+        trigger: input.trigger,
+        focusId: teamState.focusId,
+        focusName: teamState.focusName,
+        sessionId: input.sessionId ?? teamState.leadSessionId ?? '',
+        sessionType: teamState.sessionType,
+        readOnly: teamState.readOnly,
+        planningPhase: teamState.planningPhase,
+        shutdownReason: teamState.shutdownReason,
+        exit,
+        holds: {
+            mergeResolutionOutstanding: teamState.resolvingMergeConflict,
+            modelUnavailable: teamState.modelUnavailable ?? null,
+        },
+        work: null,
+    };
+}
+/**
+ * Whether the exit succeeded -- ONE reading for both team-exit paths, so the
+ * same exit means the same thing on either: a process close by its
+ * classification (a clean exit or a lifecycle teardown), a turn completion by
+ * its result (not an error). A delivery advance is not a team's exit.
+ */
+export function outcomeSucceeded(outcome) {
+    switch (outcome.exit.trigger) {
+        case 'process_close':
+            return outcome.exit.classification.succeeded;
+        case 'turn_complete':
+            return !outcome.exit.resultIsError;
+        case 'delivery_advance':
+            return false;
+    }
+}
+/** The turn's result was an error (false on a process close, judged by code/signal instead). */
+export function outcomeResultIsError(outcome) {
+    return outcome.exit.trigger === 'turn_complete' && outcome.exit.resultIsError;
+}
+//# sourceMappingURL=team-outcome.js.map

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

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

package/dist/completion/team-outcome/work-facts.d.ts

@@ -0,0 +1,115 @@
+/**
+ * The work a team leaves behind at an exit -- the `work` part of a TeamOutcome.
+ *
+ * buildTeamWorkFacts computes, once, everything the exit decision reads about
+ * the focus's deliveries and issues after the team's turn: what the running arm
+ * owes, whether the team owns actionable work, the one progress measure's
+ * snapshot, the no-progress counters and the stall window. It is the only
+ * assembly of these facts; the decision reads them from TeamOutcome.work.
+ *
+ * Reader's guide: docs/daemon/team-exit-pipeline.md.
+ *
+ * @module completion/team-outcome/work-facts
+ */
+import type { FocusDeliveryInfo, FocusIssueInfo, ProgressSnapshot } from '../../types/index.js';
+import type { CompletionEventContext, CompletionEventDeps } from '../completion-event/event.js';
+/** Everything the decision + action execution need, computed once. */
+export interface TeamWorkFacts {
+    /** The ORIGINAL pre-advance delivery list (tracking-state update uses it). */
+    currentDeliveries: FocusDeliveryInfo[];
+    effectiveDeliveries: FocusDeliveryInfo[];
+    /**
+     * `effectiveDeliveries` minus anything RECORDED as new intent under this
+     * focus's live arm. This is the set every question about what the running arm
+     * OWES is answered from; `effectiveDeliveries` stays the raw truth for the
+     * single-writer reconciler, which must still see every row it may write.
+     */
+    armVisibleDeliveries: FocusDeliveryInfo[];
+    currentIssues: FocusIssueInfo[];
+    /**
+     * `currentIssues` minus every issue belonging to a delivery RECORDED as new
+     * intent under the live arm. This -- not `currentIssues` -- is what the two
+     * no-progress watchdogs measure, so a recorded delivery can neither freeze
+     * nor manufacture a progress axis. Narrowed alongside `armVisibleDeliveries`
+     * by completion/team-progress/arm-visible-progress-inputs.ts.
+     */
+    armVisibleIssues: FocusIssueInfo[];
+    postNonTerminal: FocusDeliveryInfo[];
+    postHasActionableOpen: boolean;
+    teamHasActionableWork: boolean;
+    /**
+     * A verify command is currently running in the focus worktree (the
+     * verify-interlock hold). Folded into teamHasActionableWork via the shared
+     * predicate; also surfaced so the no-actionable-work terminate branch can name
+     * the verify hold as the reason the focus had nothing team-actionable.
+     */
+    underVerifyHold: boolean;
+    /**
+     * A non-terminal delivery exists on the focus whose id is NOT in
+     * teamState.knownDeliveryIds -- i.e. it appeared since the team was last
+     * engaged. Handoff-eligible without being evidence of a stalled team; see
+     * CompletionDecisionFacts.hasNewlyAppearedDelivery.
+     */
+    hasNewlyAppearedDelivery: boolean;
+    focusWorktreePath: string | null;
+    focusHeadSha: string | null;
+    snapshot: ProgressSnapshot;
+    priorSnapshot: ProgressSnapshot | null;
+    madeProgress: boolean;
+    advancedThisCycle: boolean;
+    stuck: FocusDeliveryInfo | null;
+    updatedNoProgressCycles: number;
+    /** Clock value read once for this cycle's time-floor decisions. */
+    nowMs: number;
+    /**
+     * True when this cycle's no-progress was actually COUNTED toward the limit
+     * (>= NO_PROGRESS_CYCLE_FLOOR_MS since the last counted cycle). False when it
+     * was held sub-floor, or when the team made progress. Drives whether
+     * lastNoProgressCycleAt advances.
+     */
+    noProgressCycleCounted: boolean;
+    /**
+     * Value to commit to teamState.lastNoProgressCycleAt: now on a counted cycle,
+     * unchanged on a sub-floor hold, undefined when progress ended the episode.
+     */
+    updatedLastNoProgressCycleAt: number | undefined;
+    /** Value to commit to teamState.lastProgressAt: now when this cycle made progress. */
+    updatedLastProgressAt: number;
+    /**
+     * NO_PROGRESS_STALL_WINDOW_MS of real time has passed with no movement on any
+     * axis of the progress measure. No no-progress guard ends a team before it.
+     */
+    stallWindowElapsed: boolean;
+    /**
+     * The operator-configured no-progress limits (exit-limit-config.ts), carried
+     * here so decide() reads them without reading config itself.
+     */
+    noProgressLimits: {
+        scopeCoverage: number;
+        deliveryAdvancement: number;
+    };
+}
+/**
+ * Recompute the picture on the post-advance state. The team owns exactly two
+ * kinds of non-terminal work: planning deliveries (it scopes them) and
+ * agent-actionable deliveries that still carry open issues (it codes them).
+ * See the inline notes for the audit-phase, verify_failed-pending-requeue,
+ * and advancedThisCycle subtleties -- each guards a specific production
+ * failure mode and is preserved exactly.
+ */
+/**
+ * Resolve whether the focus is in the human-ratify audit phase, so its held
+ * `planning` deliveries are NOT counted as team-actionable.
+ *
+ * A read_only focus is awaiting the ratify gate: counting its planning
+ * deliveries as actionable made a not-yet-ratified audit focus accrue
+ * no-progress cycles it could never clear -> a spurious no-progress team_failure
+ * (escalation aa58d9c3). Resolve FRESH: an explicit read_only=true OR the second
+ * structural signal (audit-origin AND not-yet-ratified), so a flag-absent audit
+ * focus still degrades gracefully (injection #7). FAIL OPEN to not-audit-phase so
+ * a lookup failure preserves the prior (escalate-eligible) behavior rather than
+ * silently muting the guard. Extracted from computeCompletionFacts (size ratchet).
+ */
+export declare function resolveFocusAuditPhase(ctx: CompletionEventContext, deps: CompletionEventDeps): Promise<boolean>;
+export declare function buildTeamWorkFacts(ctx: CompletionEventContext, deps: CompletionEventDeps, currentDeliveries: FocusDeliveryInfo[], effectiveDeliveries: FocusDeliveryInfo[], currentIssues: FocusIssueInfo[]): Promise<TeamWorkFacts>;
+//# sourceMappingURL=work-facts.d.ts.map

package/dist/completion/team-outcome/work-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-facts.d.ts","sourceRoot":"","sources":["../../../src/completion/team-outcome/work-facts.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAahG,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAUhG,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IACvC,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC;;;;;OAKG;IACH,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;IAC1C,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC;;;;;;OAMG;IACH,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,4BAA4B,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,sFAAsF;IACtF,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED;;;;;;;GAOG;AACH;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,OAAO,CAAC,CAalB;AAwJD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,iBAAiB,EAAE,iBAAiB,EAAE,EACtC,mBAAmB,EAAE,iBAAiB,EAAE,EACxC,aAAa,EAAE,cAAc,EAAE,GAC9B,OAAO,CAAC,aAAa,CAAC,CAoFxB"}