night-orch 0.1.0

package/dist/labels/bootstrap.js

@@ -0,0 +1,101 @@
+const DEFAULT_LABEL_PRESENTATION = {
+    ready: {
+        color: '0E8A16',
+        description: 'Queued for night-orch processing',
+    },
+    running: {
+        color: 'FBCA04',
+        description: 'Currently being processed by night-orch',
+    },
+    blocked: {
+        color: 'D93F0B',
+        description: 'Blocked and requires human intervention',
+    },
+    reviewReady: {
+        color: '1D76DB',
+        description: 'PR is ready for human review',
+    },
+    error: {
+        color: 'B60205',
+        description: 'Processing failed and needs investigation',
+    },
+    retry: {
+        color: '5319E7',
+        description: 'Queued for retry',
+    },
+    planning: {
+        color: 'C2E0C6',
+        description: 'Planning-only mode: produce a PRD markdown file (no code changes)',
+    },
+    mergeQueued: {
+        color: '006B75',
+        description: 'PR is queued in the merge queue',
+    },
+    merging: {
+        color: '0075CA',
+        description: 'PR is actively being merged via staging branch',
+    },
+    mergeFailed: {
+        color: 'E4E669',
+        description: 'Merge attempt failed; manual action required',
+    },
+    kanbanTrigger: {
+        color: '5319E7',
+        description: 'Use kanban state flow instead of default orchestration labels',
+    },
+};
+/**
+ * Build the labels that should exist for a repo, using role defaults and
+ * optional per-label overrides from repo.labelConfig.
+ */
+export function buildLabelBootstrapDefinitions(repoConfig) {
+    const definitions = [];
+    const seen = new Set();
+    const add = (name, role) => {
+        if (!name || seen.has(name))
+            return;
+        seen.add(name);
+        const defaults = DEFAULT_LABEL_PRESENTATION[role];
+        const override = repoConfig.labelConfig[name];
+        definitions.push({
+            name,
+            color: (override?.color ?? defaults.color).toUpperCase(),
+            description: override?.description ?? defaults.description,
+        });
+    };
+    for (const label of asLabelArray(repoConfig.labels.ready))
+        add(label, 'ready');
+    add(repoConfig.labels.running, 'running');
+    for (const label of asLabelArray(repoConfig.labels.blocked))
+        add(label, 'blocked');
+    add(repoConfig.labels.reviewReady, 'reviewReady');
+    add(repoConfig.labels.error, 'error');
+    add(repoConfig.labels.retry, 'retry');
+    add(repoConfig.labels.planning, 'planning');
+    add(repoConfig.labels.mergeQueued, 'mergeQueued');
+    add(repoConfig.labels.merging, 'merging');
+    add(repoConfig.labels.mergeFailed, 'mergeFailed');
+    if (repoConfig.kanban) {
+        add(repoConfig.kanban.triggerLabel, 'kanbanTrigger');
+        for (const label of asLabelArray(repoConfig.kanban.labels.ready))
+            add(label, 'ready');
+        add(repoConfig.kanban.labels.running, 'running');
+        add(repoConfig.kanban.labels.blocked, 'blocked');
+        add(repoConfig.kanban.labels.needsHuman, 'blocked');
+        add(repoConfig.kanban.labels.reviewReady, 'reviewReady');
+        add(repoConfig.kanban.labels.error, 'error');
+        add(repoConfig.kanban.labels.retry, 'retry');
+        add(repoConfig.kanban.labels.planning, 'planning');
+        add(repoConfig.kanban.labels.mergeQueued, 'mergeQueued');
+        add(repoConfig.kanban.labels.merging, 'merging');
+        add(repoConfig.kanban.labels.mergeFailed, 'mergeFailed');
+    }
+    return definitions;
+}
+function asLabelArray(value) {
+    if (typeof value === 'string') {
+        return [value];
+    }
+    return [...value];
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/labels/bootstrap.js.map

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

package/dist/labels/config.d.ts

@@ -0,0 +1,6 @@
+import type { RepoConfig } from '../config/schema.js';
+import type { LabelConfig } from './transitions.js';
+export declare function isKanbanIssue(issueLabels: readonly string[] | undefined, repoConfig: Pick<RepoConfig, 'kanban'>): boolean;
+export declare function getDiscoveryIncludeLabels(repoConfig: Pick<RepoConfig, 'selectors' | 'kanban'>): string[];
+export declare function buildLabelConfig(repoConfig: Pick<RepoConfig, 'labels' | 'kanban'>, issueLabels?: readonly string[]): LabelConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/labels/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/labels/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAInD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC1C,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GACrC,OAAO,CAKT;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC,GACnD,MAAM,EAAE,CAQV;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC,EACjD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,WAAW,CAkBb"}

package/dist/labels/config.js

@@ -0,0 +1,56 @@
+export function isKanbanIssue(issueLabels, repoConfig) {
+    const trigger = repoConfig.kanban?.triggerLabel;
+    if (typeof trigger !== 'string' || trigger.length === 0)
+        return false;
+    if (!issueLabels)
+        return false;
+    return issueLabels.includes(trigger);
+}
+export function getDiscoveryIncludeLabels(repoConfig) {
+    const include = new Set(repoConfig.selectors?.includeLabelsAny ?? []);
+    if (repoConfig.kanban) {
+        for (const label of asLabelArray(repoConfig.kanban.labels.ready, [])) {
+            include.add(label);
+        }
+    }
+    return [...include];
+}
+export function buildLabelConfig(repoConfig, issueLabels) {
+    const source = isKanbanIssue(issueLabels, repoConfig) && repoConfig.kanban
+        ? repoConfig.kanban.labels
+        : repoConfig.labels;
+    return {
+        ready: asLabelArray(source.ready, ['orch:ready']),
+        running: asSingleLabel(source.running, 'orch:running'),
+        blocked: asSingleLabel(source.blocked, 'orch:blocked'),
+        needsHuman: asSingleLabel(source.needsHuman, 'orch:needs-human'),
+        reviewReady: asSingleLabel(source.reviewReady, 'orch:review-ready'),
+        error: asSingleLabel(source.error, 'orch:error'),
+        retry: asSingleLabel(source.retry, 'orch:retry'),
+        planning: asSingleLabel(source.planning, 'orch:planning'),
+        mergeQueued: asSingleLabel(source.mergeQueued, 'orch:merge-queued'),
+        merging: asSingleLabel(source.merging, 'orch:merging'),
+        mergeFailed: asSingleLabel(source.mergeFailed, 'orch:merge-failed'),
+    };
+}
+function asSingleLabel(value, fallback) {
+    if (typeof value === 'string') {
+        return value.length > 0 ? value : fallback;
+    }
+    if (Array.isArray(value)) {
+        const first = value.find((label) => typeof label === 'string' && label.length > 0);
+        return first ?? fallback;
+    }
+    return fallback;
+}
+function asLabelArray(value, fallback) {
+    if (Array.isArray(value)) {
+        const labels = value.filter((label) => typeof label === 'string' && label.length > 0);
+        return labels.length > 0 ? labels : fallback;
+    }
+    if (typeof value === 'string' && value.length > 0) {
+        return [value];
+    }
+    return [...fallback];
+}
+//# sourceMappingURL=config.js.map

package/dist/labels/config.js.map

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

package/dist/labels/manager.d.ts

@@ -0,0 +1,10 @@
+import type { ForgeAdapter } from '../forge/types.js';
+import type { RunStatus } from '../state/runs.js';
+import type { BlockReason } from '../loop/types.js';
+import { type LabelConfig } from './transitions.js';
+/**
+ * Apply label mutations for a run status transition.
+ * Best-effort: partial failures are logged but don't throw.
+ */
+export declare function transitionLabels(forge: ForgeAdapter, repo: string, issueNumber: number, currentLabels: string[], from: RunStatus, to: RunStatus, labelConfig: LabelConfig, blockReason?: BlockReason): Promise<void>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/labels/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/labels/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGzE;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,EACvB,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/labels/manager.js

@@ -0,0 +1,30 @@
+import { computeLabelMutation } from './transitions.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Apply label mutations for a run status transition.
+ * Best-effort: partial failures are logged but don't throw.
+ */
+export async function transitionLabels(forge, repo, issueNumber, currentLabels, from, to, labelConfig, blockReason) {
+    const mutation = computeLabelMutation(from, to, currentLabels, labelConfig, blockReason);
+    if (mutation.add.length === 0 && mutation.remove.length === 0) {
+        return;
+    }
+    logger.info({ repo, issueNumber, from, to, add: mutation.add, remove: mutation.remove }, 'Applying label transition');
+    if (mutation.add.length > 0) {
+        try {
+            await forge.addLabels(repo, issueNumber, mutation.add);
+        }
+        catch (err) {
+            logger.warn({ repo, issueNumber, labels: mutation.add, err }, 'Failed to add labels');
+        }
+    }
+    if (mutation.remove.length > 0) {
+        try {
+            await forge.removeLabels(repo, issueNumber, mutation.remove);
+        }
+        catch (err) {
+            logger.warn({ repo, issueNumber, labels: mutation.remove, err }, 'Failed to remove labels');
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/labels/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/labels/manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAmB,EACnB,IAAY,EACZ,WAAmB,EACnB,aAAuB,EACvB,IAAe,EACf,EAAa,EACb,WAAwB,EACxB,WAAyB;IAEzB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;IAExF,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAM;IACR,CAAC;IAED,MAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAC3E,2BAA2B,CAC5B,CAAA;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAA;QACvF,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/labels/transitions.d.ts

@@ -0,0 +1,33 @@
+import type { RunStatus } from '../state/runs.js';
+import type { BlockReason } from '../loop/types.js';
+import type { MergeBatchStatus } from '../merge-queue/types.js';
+export interface LabelMutation {
+    add: string[];
+    remove: string[];
+}
+export interface LabelConfig {
+    ready: string[];
+    running: string;
+    blocked: string;
+    needsHuman: string;
+    reviewReady: string;
+    error: string;
+    retry: string;
+    planning: string;
+    mergeQueued: string;
+    merging: string;
+    mergeFailed: string;
+}
+/** Returns true if the block reason genuinely requires human intervention. */
+export declare function isHumanRequired(reason: BlockReason): boolean;
+/**
+ * Compute label mutations for a run status transition.
+ * Pure function — no side effects.
+ */
+export declare function computeLabelMutation(_from: RunStatus, to: RunStatus, currentLabels: string[], config: LabelConfig, blockReason?: BlockReason): LabelMutation;
+/**
+ * Compute label mutations for a merge batch status transition.
+ * Pure function — no side effects.
+ */
+export declare function computeMergeLabelMutation(to: MergeBatchStatus, currentLabels: string[], config: LabelConfig): LabelMutation;
+//# sourceMappingURL=transitions.d.ts.map

package/dist/labels/transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/labels/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,SAAS,EACb,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,WAAW,GACxB,aAAa,CAyCf;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,WAAW,GAClB,aAAa,CA+Bf"}

package/dist/labels/transitions.js

@@ -0,0 +1,81 @@
+/** Returns true if the block reason genuinely requires human intervention. */
+export function isHumanRequired(reason) {
+    return reason === 'reviewer_blocked';
+}
+/**
+ * Compute label mutations for a run status transition.
+ * Pure function — no side effects.
+ */
+export function computeLabelMutation(_from, to, currentLabels, config, blockReason) {
+    const current = new Set(currentLabels);
+    let add = [];
+    let remove = [];
+    switch (to) {
+        case 'running':
+            add = [config.running];
+            remove = [...config.ready, config.blocked, config.needsHuman, config.error, config.retry];
+            break;
+        case 'blocked':
+            if (blockReason && isHumanRequired(blockReason)) {
+                add = [config.blocked, config.needsHuman];
+                remove = [config.running];
+            }
+            else {
+                add = [config.blocked];
+                remove = [config.running, config.needsHuman];
+            }
+            break;
+        case 'review_ready':
+            add = [config.reviewReady];
+            remove = [config.running, config.retry];
+            break;
+        case 'error':
+            add = [config.error];
+            remove = [config.running];
+            break;
+        case 'completed':
+            remove = [...config.ready, config.running, config.blocked, config.needsHuman, config.reviewReady, config.error, config.retry];
+            break;
+        case 'queued':
+            add = [...config.ready];
+            remove = [config.running, config.blocked, config.needsHuman, config.error, config.reviewReady, config.retry];
+            break;
+    }
+    // Filter: don't add labels already present, don't remove labels not present
+    add = add.filter((l) => !current.has(l));
+    remove = remove.filter((l) => current.has(l));
+    return { add, remove };
+}
+/**
+ * Compute label mutations for a merge batch status transition.
+ * Pure function — no side effects.
+ */
+export function computeMergeLabelMutation(to, currentLabels, config) {
+    const current = new Set(currentLabels);
+    let add = [];
+    let remove = [];
+    const allMergeLabels = [config.mergeQueued, config.merging, config.mergeFailed];
+    switch (to) {
+        case 'pending':
+        case 'building':
+        case 'testing':
+            add = [config.mergeQueued];
+            remove = [config.mergeFailed];
+            break;
+        case 'bisecting':
+            add = [config.merging];
+            remove = [config.mergeQueued, config.mergeFailed];
+            break;
+        case 'passed':
+            remove = allMergeLabels;
+            break;
+        case 'failed':
+            add = [config.mergeFailed];
+            remove = [config.mergeQueued, config.merging];
+            break;
+    }
+    add = add.filter((l) => !current.has(l));
+    remove = remove.filter((l) => current.has(l));
+    return { add, remove };
+}
+//# sourceMappingURL=transitions.js.map

package/dist/labels/transitions.js.map

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

package/dist/loop/checkpoint.d.ts

@@ -0,0 +1,60 @@
+import type Database from 'better-sqlite3';
+import type { LoopPhase, RunContext } from './types.js';
+export interface PersistedDecisionOutcome {
+    action: 'publish' | 'iterate' | 'block' | 'error';
+    reason?: string;
+    blockReason?: string | null;
+}
+export declare class Checkpoint {
+    private db;
+    private runManager;
+    constructor(db: Database.Database);
+    phaseStarted(runId: string, phase: LoopPhase, iteration?: number): void;
+    phaseCompleted(runId: string, phase: LoopPhase, artifacts: Record<string, unknown>, iteration?: number): void;
+    /**
+     * Record that a phase was skipped by the skipWhen guard. Emits matching
+     * `phase_started` + `phase_completed` events with a `skipped=true` flag
+     * so the event stream stays well-formed even though no work ran.
+     */
+    phaseSkipped(runId: string, phase: LoopPhase, iteration?: number): void;
+    /**
+     * Record that a phase was blocked (e.g. by cost cap). Pairs
+     * phase_started/phase_completed with a `blocked` payload so the event
+     * stream remains consistent and the downstream observability layer can
+     * distinguish blocks from plain completions.
+     */
+    phaseBlocked(runId: string, phase: LoopPhase, reason: string, iteration?: number): void;
+    /**
+     * Persist the terminal outcome of a decide step. Read by
+     * `resumeFromCheckpoint` to short-circuit resume when a decide step
+     * produced a terminal decision in the crashed attempt.
+     */
+    recordDecisionOutcome(runId: string, phase: LoopPhase, outcome: PersistedDecisionOutcome): void;
+    /**
+     * Persist the current sessionIds and stepOutputs maps so they survive
+     * a daemon crash. Called by the engine after every worker step because
+     * workers mutate these maps through `updateContext`.
+     */
+    persistRunState(runId: string, sessionIds: Readonly<Record<string, string>>, stepOutputs: Readonly<Record<string, unknown>>): void;
+    getLastCompleted(runId: string): {
+        phase: LoopPhase;
+        artifacts: Record<string, unknown>;
+    } | null;
+    /**
+     * Return the set of phase IDs that have a phase_completed checkpoint.
+     */
+    getCompletedPhases(runId: string): string[];
+    /**
+     * Return terminal decision outcomes for decide steps that ran and
+     * finished (possibly mid-decide-action) prior to a crash.
+     */
+    getDecisionOutcomes(runId: string): Record<string, PersistedDecisionOutcome>;
+    /**
+     * Reconstruct a partial RunContext from checkpoint data for crash recovery.
+     * Returns null if no checkpoint data exists for this run.
+     */
+    resumeFromCheckpoint(runId: string, baseCtx: RunContext): RunContext | null;
+    private getPhaseData;
+    private recordEvent;
+}
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/loop/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/loop/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAA4D,MAAM,YAAY,CAAA;AAiCjH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,qBAAa,UAAU;IAGT,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,UAAU,CAAY;gBAEV,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIzC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB7G;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvE;;;;;OAKG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAKP;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAU/F;;;;OAIG;IACH,eAAe,CACb,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,IAAI;IAUP,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBhG;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAO5E;;;OAGG;IACH,oBAAoB,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,UAAU,GAAG,IAAI;IAuCpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;CA6BpB"}

package/dist/loop/checkpoint.js

@@ -0,0 +1,226 @@
+import { RunManager } from '../state/runs.js';
+import { nowUtcIso } from '../utils/time.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Sentinel key used to store an array of completed phase IDs in phase_data.
+ * Used on resume to determine whether a phase was merely entered (started)
+ * or fully completed — a distinction that matters for decide steps whose
+ * terminal outcome must not be re-routed to iterate on resume.
+ */
+const COMPLETED_PHASES_KEY = '__completedPhases';
+/**
+ * Sentinel key for session IDs. Persisted across crashes so
+ * multi-step workflows can resume their `--continue` chains on the worker.
+ */
+const SESSION_IDS_KEY = '__sessionIds';
+/**
+ * Sentinel key for generic custom-role step outputs. buildStepArtifacts
+ * only persists well-known role outputs (plan/code/review/verify); without
+ * this escape hatch custom-workflow step outputs are lost on resume.
+ */
+const STEP_OUTPUTS_KEY = '__stepOutputs';
+/**
+ * Sentinel key for terminal outcomes of decide steps. When present, the
+ * engine must not re-enter the loop on resume — it routes straight to the
+ * terminal state instead.
+ */
+const DECISION_OUTCOMES_KEY = '__decisionOutcomes';
+export class Checkpoint {
+    db;
+    runManager;
+    constructor(db) {
+        this.db = db;
+        this.runManager = new RunManager(db);
+    }
+    phaseStarted(runId, phase, iteration) {
+        this.runManager.updatePhaseCheckpoint(runId, phase, null, iteration);
+        this.recordEvent(runId, 'phase_started', phase, null);
+    }
+    phaseCompleted(runId, phase, artifacts, iteration) {
+        // Merge artifacts with existing phase_data in a single DB transaction
+        // so concurrent writers (e.g. parallel sub-tasks on the same run)
+        // cannot lose updates. Also track the set of completed phases in
+        // the same blob so resume can distinguish "entered" from "completed".
+        const tx = this.db.transaction(() => {
+            const existing = this.getPhaseData(runId);
+            const prevCompleted = Array.isArray(existing[COMPLETED_PHASES_KEY])
+                ? existing[COMPLETED_PHASES_KEY]
+                : [];
+            const completed = prevCompleted.includes(phase) ? prevCompleted : [...prevCompleted, phase];
+            const merged = { ...existing, [phase]: artifacts, [COMPLETED_PHASES_KEY]: completed };
+            this.runManager.updatePhaseCheckpoint(runId, phase, JSON.stringify(merged), iteration);
+        });
+        tx();
+        this.recordEvent(runId, 'phase_completed', phase, artifacts);
+    }
+    /**
+     * Record that a phase was skipped by the skipWhen guard. Emits matching
+     * `phase_started` + `phase_completed` events with a `skipped=true` flag
+     * so the event stream stays well-formed even though no work ran.
+     */
+    phaseSkipped(runId, phase, iteration) {
+        this.phaseStarted(runId, phase, iteration);
+        this.phaseCompleted(runId, phase, { skipped: true }, iteration);
+    }
+    /**
+     * Record that a phase was blocked (e.g. by cost cap). Pairs
+     * phase_started/phase_completed with a `blocked` payload so the event
+     * stream remains consistent and the downstream observability layer can
+     * distinguish blocks from plain completions.
+     */
+    phaseBlocked(runId, phase, reason, iteration) {
+        this.phaseStarted(runId, phase, iteration);
+        this.phaseCompleted(runId, phase, { blocked: true, reason }, iteration);
+    }
+    /**
+     * Persist the terminal outcome of a decide step. Read by
+     * `resumeFromCheckpoint` to short-circuit resume when a decide step
+     * produced a terminal decision in the crashed attempt.
+     */
+    recordDecisionOutcome(runId, phase, outcome) {
+        const existing = this.getPhaseData(runId);
+        const prev = existing[DECISION_OUTCOMES_KEY] ?? {};
+        const merged = {
+            ...existing,
+            [DECISION_OUTCOMES_KEY]: { ...prev, [phase]: outcome },
+        };
+        this.runManager.updatePhaseData(runId, JSON.stringify(merged));
+    }
+    /**
+     * Persist the current sessionIds and stepOutputs maps so they survive
+     * a daemon crash. Called by the engine after every worker step because
+     * workers mutate these maps through `updateContext`.
+     */
+    persistRunState(runId, sessionIds, stepOutputs) {
+        const existing = this.getPhaseData(runId);
+        const merged = {
+            ...existing,
+            [SESSION_IDS_KEY]: { ...sessionIds },
+            [STEP_OUTPUTS_KEY]: { ...stepOutputs },
+        };
+        this.runManager.updatePhaseData(runId, JSON.stringify(merged));
+    }
+    getLastCompleted(runId) {
+        const row = this.db
+            .prepare('SELECT current_phase, phase_data FROM runs WHERE id = ?')
+            .get(runId);
+        if (!row?.current_phase)
+            return null;
+        const phaseData = safeParsePhaseData(row.phase_data);
+        const phaseArtifacts = phaseData[row.current_phase] ?? {};
+        return {
+            phase: row.current_phase,
+            artifacts: phaseArtifacts,
+        };
+    }
+    /**
+     * Return the set of phase IDs that have a phase_completed checkpoint.
+     */
+    getCompletedPhases(runId) {
+        const phaseData = this.getPhaseData(runId);
+        const raw = phaseData[COMPLETED_PHASES_KEY];
+        return Array.isArray(raw) ? raw : [];
+    }
+    /**
+     * Return terminal decision outcomes for decide steps that ran and
+     * finished (possibly mid-decide-action) prior to a crash.
+     */
+    getDecisionOutcomes(runId) {
+        const phaseData = this.getPhaseData(runId);
+        const raw = phaseData[DECISION_OUTCOMES_KEY];
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+            return {};
+        return raw;
+    }
+    /**
+     * Reconstruct a partial RunContext from checkpoint data for crash recovery.
+     * Returns null if no checkpoint data exists for this run.
+     */
+    resumeFromCheckpoint(runId, baseCtx) {
+        const row = this.db
+            .prepare('SELECT current_phase, phase_data, iteration_count, estimated_cost_usd FROM runs WHERE id = ?')
+            .get(runId);
+        if (!row?.current_phase)
+            return null;
+        const phaseData = safeParsePhaseData(row.phase_data);
+        // Reconstruct context from persisted phase artifacts
+        const planArtifacts = phaseData['plan'];
+        const codeArtifacts = phaseData['code'];
+        const reviewArtifacts = phaseData['review'];
+        const verifyArtifacts = phaseData['verify'];
+        const persistedSessionIds = phaseData[SESSION_IDS_KEY];
+        const persistedStepOutputs = phaseData[STEP_OUTPUTS_KEY];
+        return {
+            ...baseCtx,
+            currentPhase: row.current_phase,
+            terminalStatus: 'running',
+            iteration: row.iteration_count ?? baseCtx.iteration,
+            estimatedCostUsd: row.estimated_cost_usd ?? baseCtx.estimatedCostUsd,
+            plan: planArtifacts?.plan ?? baseCtx.plan,
+            codeResult: codeArtifacts?.codeResult ?? baseCtx.codeResult,
+            verifyResults: Array.isArray(verifyArtifacts?.verifyResults)
+                ? verifyArtifacts.verifyResults
+                : baseCtx.verifyResults,
+            reviewResult: reviewArtifacts?.reviewResult ?? baseCtx.reviewResult,
+            sessionIds: isStringRecord(persistedSessionIds) ? persistedSessionIds : baseCtx.sessionIds,
+            stepOutputs: isRecord(persistedStepOutputs) ? persistedStepOutputs : baseCtx.stepOutputs,
+        };
+    }
+    getPhaseData(runId) {
+        const row = this.db
+            .prepare('SELECT phase_data FROM runs WHERE id = ?')
+            .get(runId);
+        if (!row?.phase_data)
+            return {};
+        return safeParsePhaseData(row.phase_data);
+    }
+    recordEvent(runId, eventType, phase, data) {
+        try {
+            const now = nowUtcIso();
+            this.db
+                .prepare(`INSERT INTO events (run_id, repo, issue_number, event_type, phase, data, created_at)
+           SELECT ?, repo, issue_number, ?, ?, ?, ?
+           FROM runs
+           WHERE id = ?`)
+                .run(runId, eventType, phase, data ? JSON.stringify(data) : null, now, runId);
+        }
+        catch (err) {
+            // Best-effort event recording: checkpoint persistence must still succeed.
+            // Log at debug so operators can diagnose silent drops without spamming.
+            logger.debug({ runId, eventType, phase, err }, 'Failed to record phase event');
+        }
+    }
+}
+/**
+ * Parse a phase_data JSON blob defensively. A corrupt row must not take
+ * down checkpoint reads; the run will simply resume as if no checkpoint
+ * existed. Logs a warning so operators can notice data corruption.
+ */
+function safeParsePhaseData(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch (err) {
+        logger.warn({ err, phaseDataLength: raw.length }, 'Failed to parse phase_data JSON — treating as empty');
+        return {};
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isStringRecord(value) {
+    if (!isRecord(value))
+        return false;
+    for (const v of Object.values(value)) {
+        if (typeof v !== 'string')
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=checkpoint.js.map