@telora/daemon 0.21.26 → 0.21.82

package/dist/delivery/delivery-close-actions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Delivery-close issue actions (single definition).
+ *
+ * The Context-Group auto-close loop and the Verified/In-Review close-sweep were
+ * previously copy-pasted, byte-identical, at three sites (listener-auto-advance
+ * twice, completion/status-advance-phase once). Three copies of the same
+ * best-effort loop is three chances to drift. This module names each action
+ * ONCE; every site calls it, passing its own issue-status updater and logger so
+ * per-caller log attribution (module field) is preserved.
+ *
+ * Both actions are BEST-EFFORT: a failed write is logged and skipped, never
+ * thrown -- delivery advancement must not wedge because one auxiliary issue
+ * write failed. That matches the behavior of the loops they replace.
+ */
+import type { Logger } from '../shell/log.js';
+/** The minimal issue shape these actions read. */
+export interface CloseActionIssue {
+    id: string;
+    title: string;
+    status: string;
+    issueType: string;
+}
+type IssueStatusUpdater = (issueId: string, status: string) => Promise<void>;
+/**
+ * Auto-close any Context Groups still open once all of a delivery's work issues
+ * are done. Context Groups are reference material, not actionable work, so they
+ * collapse to Done for a clean terminal record. Best-effort per group.
+ */
+export declare function autoCloseContextGroups(contextGroups: ReadonlyArray<CloseActionIssue>, updateIssueStatus: IssueStatusUpdater, log: Logger): Promise<void>;
+/**
+ * Sweep a delivery's Verified / In Review work issues to Done just before the
+ * delivery advances or closes, so they leave a clean terminal record.
+ * - 'Verified': review agent confirmed the fix but used Verified instead of Done.
+ * - 'In Review': dev signalled completion; no review agent ran before close.
+ * Best-effort per issue.
+ */
+export declare function sweepDeliveryCloseIssues(workIssues: ReadonlyArray<CloseActionIssue>, updateIssueStatus: IssueStatusUpdater, log: Logger): Promise<void>;
+export {};
+//# sourceMappingURL=delivery-close-actions.d.ts.map

package/dist/delivery/delivery-close-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-close-actions.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-close-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC9C,iBAAiB,EAAE,kBAAkB,EACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC3C,iBAAiB,EAAE,kBAAkB,EACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/delivery/delivery-close-actions.js

@@ -0,0 +1,53 @@
+/**
+ * Delivery-close issue actions (single definition).
+ *
+ * The Context-Group auto-close loop and the Verified/In-Review close-sweep were
+ * previously copy-pasted, byte-identical, at three sites (listener-auto-advance
+ * twice, completion/status-advance-phase once). Three copies of the same
+ * best-effort loop is three chances to drift. This module names each action
+ * ONCE; every site calls it, passing its own issue-status updater and logger so
+ * per-caller log attribution (module field) is preserved.
+ *
+ * Both actions are BEST-EFFORT: a failed write is logged and skipped, never
+ * thrown -- delivery advancement must not wedge because one auxiliary issue
+ * write failed. That matches the behavior of the loops they replace.
+ */
+import { planDeliveryCloseSweep } from '../shell/constants.js';
+/**
+ * Auto-close any Context Groups still open once all of a delivery's work issues
+ * are done. Context Groups are reference material, not actionable work, so they
+ * collapse to Done for a clean terminal record. Best-effort per group.
+ */
+export async function autoCloseContextGroups(contextGroups, updateIssueStatus, log) {
+    for (const cg of contextGroups) {
+        if (cg.status !== 'Done') {
+            try {
+                await updateIssueStatus(cg.id, 'Done');
+                log.info(`Auto-closed Context Group "${cg.title}" (all work issues done)`);
+            }
+            catch (err) {
+                log.warn(`Failed to auto-close Context Group "${cg.title}":`, err.message);
+            }
+        }
+    }
+}
+/**
+ * Sweep a delivery's Verified / In Review work issues to Done just before the
+ * delivery advances or closes, so they leave a clean terminal record.
+ * - 'Verified': review agent confirmed the fix but used Verified instead of Done.
+ * - 'In Review': dev signalled completion; no review agent ran before close.
+ * Best-effort per issue.
+ */
+export async function sweepDeliveryCloseIssues(workIssues, updateIssueStatus, log) {
+    const sweepIds = planDeliveryCloseSweep([...workIssues]);
+    for (const issueId of sweepIds) {
+        try {
+            await updateIssueStatus(issueId, 'Done');
+            log.info(`Swept issue ${issueId} to Done before delivery advance`);
+        }
+        catch (err) {
+            log.warn(`Failed to sweep issue ${issueId} to Done:`, err.message);
+        }
+    }
+}
+//# sourceMappingURL=delivery-close-actions.js.map

package/dist/delivery/delivery-close-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-close-actions.js","sourceRoot":"","sources":["../../src/delivery/delivery-close-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAa/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,aAA8C,EAC9C,iBAAqC,EACrC,GAAW;IAEX,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACvC,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE,CAAC,KAAK,0BAA0B,CAAC,CAAC;YAC7E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE,CAAC,KAAK,IAAI,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAA2C,EAC3C,iBAAqC,EACrC,GAAW;IAEX,MAAM,QAAQ,GAAG,sBAAsB,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,eAAe,OAAO,kCAAkC,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,yBAAyB,OAAO,WAAW,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/delivery/delivery-lifecycle.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Delivery lifecycle - reusable functions for guard evaluation,
+ * stage transitions, and merge operations.
+ *
+ * Extracted from completion-handler.ts so that both the legacy
+ * per-delivery completion handler and the focus team lead
+ * can use the same logic.
+ *
+ * Key functions:
+ * - evaluateAndTransition(): evaluate guards and determine next stage
+ * - mergeDeliveryBranch(): merge a branch to integration
+ * - advanceDeliveryStage(): update delivery to its next workflow stage
+ */
+import type { DaemonConfig, Workflow, WorkflowTransition, PolicyFailureMode } from '../types/index.js';
+import { type DeliveryGateState } from '../queries/deliveries.js';
+import type { ReconcilerIssue } from './delivery-reconciler.js';
+export interface GuardEvalOutcome {
+    /** Whether the transition was blocked by a guard. */
+    blocked: boolean;
+    /** Whether to merge the agent's branch to integration. */
+    shouldMerge: boolean;
+    /** Whether to trigger a re-poll for next work. */
+    shouldTriggerRepoll: boolean;
+    /** Session status to record. */
+    sessionStatus: 'completed' | 'failed';
+    /** Human-readable exit reason. */
+    exitReason: string;
+    /** Structured gate state. Populated when blocked; null when all guards passed. */
+    gateState?: DeliveryGateState | null;
+}
+export interface MergeOutcome {
+    /** Whether the merge to integration succeeded. */
+    mergeSucceeded: boolean;
+    /** Updated exit reason string. */
+    exitReason: string;
+    /** If set, override the delivery status (e.g., back to queued on conflict). */
+    overrideDeliveryStatus?: string;
+    /** If set, override the delivery stage ID. */
+    overrideDeliveryStageId?: string | null;
+    /** The squash merge commit SHA (set on successful merge). */
+    commitSha?: string;
+}
+export interface StageAdvanceResult {
+    /** Whether the stage was advanced successfully. */
+    advanced: boolean;
+    /** The new delivery status. */
+    deliveryStatus: string;
+    /** The new delivery stage ID. */
+    deliveryStageId: string | null | undefined;
+    /** Whether guards blocked the transition. */
+    guardBlocked: boolean;
+    /** Whether to merge. */
+    shouldMerge: boolean;
+    /** Human-readable reason. */
+    exitReason: string;
+}
+export interface GuardEvalParams {
+    deliveryId: string;
+    organizationId: string;
+    workflowTransition: WorkflowTransition | null;
+    exitCode: number;
+    policyFailureMode: PolicyFailureMode;
+    deliveryName: string;
+    sessionId: string | null;
+}
+/**
+ * Evaluate guards at a stage transition for a delivery.
+ *
+ * This is the core guard evaluation logic extracted from completion-handler.ts.
+ * Can be called by:
+ * - The per-delivery completion handler (legacy)
+ * - The focus team lead (after detecting delivery issue completion)
+ */
+export declare function evaluateGuardsForDeliveryTransition(params: GuardEvalParams): Promise<GuardEvalOutcome>;
+export interface DeliveryStageAdvanceParams {
+    deliveryId: string;
+    deliveryName: string;
+    organizationId: string;
+    workflow: Workflow;
+    currentStageId: string;
+    /**
+     * The delivery's execution_status before this advance. Recorded as
+     * from_status on the delivery_transitions row. Optional for legacy callers;
+     * when omitted the transition is still logged with from_status = null.
+     */
+    fromStatus?: string | null;
+    exitCode: number;
+    openIssueCount: number;
+    /**
+     * The delivery's REAL issue list mapped to the reconciler's minimal shape
+     * ({ status, issueType }). The single-writer reconciler derives its decision
+     * from actual issue state through the shared predicate; this list must NEVER
+     * be synthesized from a count. A synthesized [{status:'Done',issueType:'Task'}]
+     * makes hasWorkIssues() unconditionally true, which silently defeats the
+     * queued-branch scoping gate (a zero-issue delivery would advance instead of
+     * holding in queued). Every caller passes the issues it already fetched.
+     */
+    reconcilerIssues: ReconcilerIssue[];
+    sessionCount: number;
+    policyFailureMode: PolicyFailureMode;
+    sessionId: string | null;
+    /**
+     * Focus owning this delivery. Used to look up the focus worktree when
+     * deriving `completion_artifacts` at terminal-stage advance.
+     */
+    focusId?: string;
+    /**
+     * Daemon config. Used to resolve the base ref (integration branch) when
+     * deriving `completion_artifacts` from the focus worktree.
+     */
+    config?: DaemonConfig;
+}
+/**
+ * Advance a delivery through its workflow stage.
+ *
+ * Given a delivery's current stage and workflow, determines the next stage,
+ * evaluates any guards on the transition, and updates the delivery status.
+ *
+ * Used by the focus team lead when all issues in a delivery are completed.
+ */
+export declare function advanceDeliveryStage(params: DeliveryStageAdvanceParams): Promise<StageAdvanceResult>;
+export interface DeliveryBranchMergeParams {
+    config: DaemonConfig;
+    branchName: string;
+    deliveryId: string;
+    deliveryName: string;
+    organizationId: string;
+    sessionId: string | null;
+    workflow: Workflow;
+    /** Focus ID for recording the merge in focus_merges. Optional for legacy per-delivery path. */
+    focusId?: string;
+}
+/**
+ * Merge a delivery's branch to the integration branch.
+ *
+ * Handles:
+ * - Merge to integration
+ * - Conflict escalation
+ * - Git state reporting
+ */
+export declare function mergeDeliveryBranch(params: DeliveryBranchMergeParams): Promise<MergeOutcome>;
+export { ADVANCE_BLOCK_ESCALATION_KIND, DEFAULT_AUTO_REMEDIATION_BUDGET, ensureWorktreeCommittedBeforeAdvance, __resetAutoRemediationAttempts, } from './delivery-advance-block.js';
+export type { EnsureWorktreeCommittedDeps } from './delivery-advance-block.js';
+//# sourceMappingURL=delivery-lifecycle.d.ts.map

package/dist/delivery/delivery-lifecycle.d.ts.map

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