@telora/daemon 0.20.2 → 0.20.9

package/dist/completion/event-phases.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Named phases of the completion-event pipeline.
+ *
+ * Extracted VERBATIM from the former ~690-line handleCompletionEvent body
+ * (completion/event.ts) so each sub-decision is independently testable
+ * without constructing the whole completion world:
+ *
+ *   1. applyPlanningRefresh        planning-team delivery discovery / failure
+ *   2. routeReviewWindowCompletion review routing (review pass vs coding pass)
+ *   3. runWakeCycleSelfHeal        pre-guard advanceDeliveryStatuses self-heal
+ *   4. computeCompletionFacts      the post-advance factual picture
+ *   5. checkDeliveryAdvancementStall  cross-respawn advancement watchdog
+ *   6. executeCompletionAction     side effects of the chosen action
+ *
+ * The decision itself stays pure in completion-decision.ts. Behavior is
+ * preserved exactly: same reads, same order, same log lines, same early
+ * returns; delivery execution_status transition semantics are untouched
+ * (single-writer reconciler).
+ */
+import type { FocusDeliveryInfo, FocusIssueInfo, ProgressSnapshot } from '../types.js';
+import { type CompletionAction } from './completion-decision.js';
+import type { CompletionEventContext, CompletionEventDeps } from './event.js';
+/**
+ * Wake-cycle refresh (Option A): planning teams spawn with knownDeliveryIds
+ * empty. The MCP-driven planning turn writes deliveries to the DB, so we
+ * re-snapshot them here before any downstream merge/completion logic looks
+ * at the set. WHY Option A: keeps the refresh on the existing wake path
+ * instead of polling, so it runs exactly when new deliveries become visible.
+ *
+ * Returns true when the team was terminated (planning produced nothing).
+ */
+export declare function applyPlanningRefresh(ctx: CompletionEventContext, deps: CompletionEventDeps, currentDeliveries: FocusDeliveryInfo[]): Promise<boolean>;
+export type ReviewWindowOutcome = 'terminated' | 'leave_running' | 'not_in_review';
+/**
+ * Review-window handling. Resolves review_requested_at FRESH because it can
+ * be set/cleared between spawn and this event.
+ *
+ * - A completing REVIEW pass routes verify deliveries deterministically
+ *   (runReviewExitHandler) and terminates -> 'terminated'.
+ * - A completing CODING pass during a review window is left alive so the
+ *   review's own completion closes the focus -> 'leave_running'.
+ * - Otherwise -> 'not_in_review' and the pipeline continues.
+ */
+export declare function routeReviewWindowCompletion(ctx: CompletionEventContext, deps: CompletionEventDeps, currentDeliveries: FocusDeliveryInfo[]): Promise<ReviewWindowOutcome>;
+/**
+ * Self-heal BEFORE the no-progress guard. When actionable deliveries exist
+ * but none carry open issues, the team has nothing left to code. The common
+ * cause is a review that bounced a delivery to verify_failed while all its
+ * issues are already Done. The daemon's transparent
+ * verify_failed -> coding -> verify stepping (advanceDeliveryStatuses) clears
+ * that. Running it here -- before snapshotting -- means a benign "no work to
+ * do" cycle either terminates the team cleanly (all deliveries now terminal)
+ * or shows up as real progress (the delivery status moved), instead of being
+ * counted as coder no-progress. Either way it can no longer accrue toward a
+ * spurious team_failure escalation. (Previously this advance ran only AFTER
+ * the guard, so the counter could reach the limit and escalate first.)
+ */
+export declare function runWakeCycleSelfHeal(ctx: CompletionEventContext, deps: CompletionEventDeps, currentDeliveries: FocusDeliveryInfo[], currentIssues: FocusIssueInfo[]): Promise<{
+    terminated: boolean;
+    effectiveDeliveries: FocusDeliveryInfo[];
+}>;
+/** Everything the decision + action execution need, computed once. */
+export interface CompletionFacts {
+    /** The ORIGINAL pre-advance delivery list (tracking-state update uses it). */
+    currentDeliveries: FocusDeliveryInfo[];
+    effectiveDeliveries: FocusDeliveryInfo[];
+    currentIssues: FocusIssueInfo[];
+    postNonTerminal: FocusDeliveryInfo[];
+    postHasActionableOpen: boolean;
+    teamHasActionableWork: boolean;
+    focusWorktreePath: string | null;
+    focusHeadSha: string | null;
+    snapshot: ProgressSnapshot;
+    priorSnapshot: ProgressSnapshot | null;
+    madeProgress: boolean;
+    advancedThisCycle: boolean;
+    stuck: FocusDeliveryInfo | null;
+    updatedNoProgressCycles: 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.
+ */
+export declare function computeCompletionFacts(ctx: CompletionEventContext, deps: CompletionEventDeps, currentDeliveries: FocusDeliveryInfo[], effectiveDeliveries: FocusDeliveryInfo[], currentIssues: FocusIssueInfo[]): Promise<CompletionFacts>;
+/**
+ * Records this cycle on the persistent delivery-advancement guard and, when
+ * the threshold is reached, files ONE delivery-advancement-stalled escalation
+ * (idempotent against an open team_failure) and terminates.
+ *
+ * Returns true when the team was terminated.
+ */
+export declare function checkDeliveryAdvancementStall(ctx: CompletionEventContext, deps: CompletionEventDeps, facts: CompletionFacts, action: CompletionAction, noProgressLimit: number): Promise<boolean>;
+/**
+ * Execute the chosen action's side effects. The decision (completion-decision)
+ * is pure; every mutation of team state and every escalation lives here, with
+ * the branch semantics preserved exactly -- including the commit-nudge re-wake
+ * and terminated-work reconciliation on the no-progress path.
+ */
+export declare function executeCompletionAction(ctx: CompletionEventContext, deps: CompletionEventDeps, facts: CompletionFacts, action: CompletionAction, noProgressLimit: number): Promise<void>;
+//# sourceMappingURL=event-phases.d.ts.map

package/dist/completion/event-phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-phases.d.ts","sourceRoot":"","sources":["../../src/completion/event-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMvF,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAkB5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAO9E;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,iBAAiB,EAAE,iBAAiB,EAAE,GACrC,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAID,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnF;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,iBAAiB,EAAE,iBAAiB,EAAE,GACrC,OAAO,CAAC,mBAAmB,CAAC,CA+F9B;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,iBAAiB,EAAE,iBAAiB,EAAE,EACtC,aAAa,EAAE,cAAc,EAAE,GAC9B,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,mBAAmB,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAiD5E;AAID,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IACvC,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,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;CACjC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,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,eAAe,CAAC,CAyI1B;AAID;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAID;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Mf"}