@telora/factory 0.4.5

package/dist/escalation.js

@@ -0,0 +1,352 @@
+/**
+ * Factory instance escalation and stuck detection.
+ *
+ * Handles escalation when resource limits are hit or the factory gets stuck.
+ * Pauses the instance and signals the human via the agent_escalations table.
+ *
+ * Stuck detection identifies when the same gate is failing N consecutive
+ * times with the same error pattern, indicating the builder is unable to
+ * make progress.
+ *
+ * Resume support: when a human resolves the escalation, the instance can
+ * transition from 'paused' back to 'building' via resumeInstance().
+ */
+import { updateInstanceStatus, updateInstanceWorkflowStage } from './queries/instances.js';
+import { createFactoryEscalation } from './queries/escalations.js';
+import { getGateResultsByInstance } from './queries/gate-results.js';
+import { getOrResolveWorkflow, attemptTransition } from './workflow-transition.js';
+// ============================================================================
+// Escalation trigger constants
+// ============================================================================
+/** Trigger fired when resource limits (token budget, wall clock, etc.) are exceeded. */
+export const TRIGGER_RESOURCE_LIMIT_EXCEEDED = 'resource_limit_exceeded';
+/** Trigger fired when a builder appears stuck (same gate failure repeated). */
+export const TRIGGER_BUILDER_STUCK = 'builder_stuck';
+/** Trigger fired when a work unit exhausts all gate retry iterations. */
+export const TRIGGER_GATE_FAILURE_EXHAUSTED = 'gate_failure_exhausted';
+/** Trigger fired when strategy-level gate evaluation fails. */
+export const TRIGGER_STRATEGY_GATE_FAILED = 'strategy_gate_failed';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default number of consecutive same-pattern failures before stuck detection triggers. */
+const DEFAULT_STUCK_THRESHOLD = 3;
+/** Maximum length of error pattern to compare for stuck detection. */
+const ERROR_PATTERN_MAX_LENGTH = 500;
+/** Log prefix for all escalation messages. */
+const LOG_PREFIX = '[escalation]';
+// ============================================================================
+// Escalation entry point
+// ============================================================================
+/**
+ * Escalate a factory instance.
+ *
+ * Sets the instance status to 'paused', records the escalation reason
+ * and message on the instance record, and creates an escalation entry
+ * in the agent_escalations table to signal the human.
+ *
+ * @param instanceId - The factory instance UUID.
+ * @param reason     - Short reason for the escalation (e.g. "token_budget_exceeded").
+ * @param message    - Detailed human-readable message describing the situation.
+ * @param config     - Optional escalation configuration overrides.
+ * @param sessionId  - Optional session ID to link the escalation to.
+ */
+export async function escalateInstance(instanceId, reason, message, config, sessionId) {
+    // config is available for future use (e.g., escalation routing rules)
+    void config;
+    const now = new Date().toISOString();
+    console.log(`${LOG_PREFIX} Escalating instance ${instanceId}: ${reason}`);
+    // Step 1: Update instance status to paused with escalation fields
+    await updateInstanceStatus(instanceId, 'paused', {
+        escalationReason: reason,
+        escalationMessage: message,
+        escalatedAt: now,
+    });
+    // Step 2: Create an escalation record for the human to review
+    await createFactoryEscalation(instanceId, reason, message, undefined, sessionId);
+    console.log(`${LOG_PREFIX} Instance ${instanceId} paused and escalation created. ` +
+        `Reason: ${reason}`);
+}
+/**
+ * Escalate a factory instance using its in-memory state.
+ *
+ * Attempts a workflow-governed transition from the current status to
+ * 'paused'. If the workflow allows it (or no workflow exists), updates
+ * in-memory state and persists the escalation.
+ */
+export async function escalateInstanceState(state, reason, message, config, sessionId) {
+    // Attempt workflow-governed transition to paused
+    const workflow = await getOrResolveWorkflow('factory_instance');
+    const ctx = buildEscalationEvalContext(state);
+    const transResult = await attemptTransition(workflow, state.status, 'paused', state.productId, 'factory_instance', state.instanceId, ctx);
+    if (!transResult.allowed) {
+        console.log(`${LOG_PREFIX} Instance ${state.instanceId} transition ${state.status} -> paused ` +
+            `blocked by workflow guards -- skipping escalation`);
+        return;
+    }
+    state.status = 'paused';
+    state.escalatedAt = new Date().toISOString();
+    if (transResult.newStageId) {
+        state.currentWorkflowStageId = transResult.newStageId;
+        await updateInstanceWorkflowStage(state.instanceId, transResult.newStageId, 'paused');
+    }
+    await escalateInstance(state.instanceId, reason, message, config, sessionId);
+}
+// ============================================================================
+// Resume support
+// ============================================================================
+/**
+ * Resume a paused factory instance.
+ *
+ * Attempts a workflow-governed transition from 'paused' back to 'building'
+ * and clears the escalation fields. This is called when a human resolves
+ * the escalation and wants the factory to continue.
+ *
+ * @param instanceId - The factory instance UUID.
+ * @param state      - The in-memory instance state (if available).
+ */
+export async function resumeInstance(instanceId, state) {
+    console.log(`${LOG_PREFIX} Resuming instance ${instanceId} from paused state`);
+    // Attempt workflow-governed transition: paused -> building
+    if (state) {
+        const workflow = await getOrResolveWorkflow('factory_instance');
+        const ctx = buildEscalationEvalContext(state);
+        const transResult = await attemptTransition(workflow, 'paused', 'building', state.productId, 'factory_instance', instanceId, ctx);
+        if (!transResult.allowed) {
+            console.log(`${LOG_PREFIX} Instance ${instanceId} transition paused -> building ` +
+                `blocked by workflow guards`);
+            return;
+        }
+        if (transResult.newStageId) {
+            state.currentWorkflowStageId = transResult.newStageId;
+            await updateInstanceWorkflowStage(instanceId, transResult.newStageId, 'building');
+        }
+    }
+    await updateInstanceStatus(instanceId, 'building', {
+        escalationReason: null,
+        escalationMessage: null,
+        escalatedAt: null,
+    });
+    // Update in-memory state if provided
+    if (state) {
+        state.status = 'building';
+    }
+    console.log(`${LOG_PREFIX} Instance ${instanceId} resumed: paused -> building`);
+}
+/**
+ * Build a minimal EvaluationContext for escalation transitions.
+ */
+function buildEscalationEvalContext(state) {
+    const elapsedSeconds = Math.floor((Date.now() - state.startedAt.getTime()) / 1000);
+    return {
+        deliveryId: '',
+        openIssueCount: 0,
+        totalIssueCount: 0,
+        issuesByStatus: {},
+        issuesByPriority: {},
+        lastExitCode: 0,
+        sessionCount: state.activeBuilderSessions.size,
+        tokensUsed: state.tokensUsed,
+        tokenBudget: state.blueprint.maxTokenBudget,
+        cycleCount: state.completionGateIterations,
+        wallClockSeconds: elapsedSeconds,
+        wallClockLimitSeconds: state.blueprint.maxWallClockHours
+            ? state.blueprint.maxWallClockHours * 3600
+            : null,
+    };
+}
+// ============================================================================
+// Escalation trigger routing
+// ============================================================================
+/**
+ * Check whether a given trigger name is configured in the blueprint's
+ * escalation triggers list.
+ *
+ * If the trigger is in the list, the scenario should cause a pause+escalate.
+ * If not, the scenario should cause an immediate failure.
+ *
+ * @param blueprint - The factory blueprint with escalationTriggers config.
+ * @param triggerName - The trigger name to check (e.g. TRIGGER_RESOURCE_LIMIT_EXCEEDED).
+ * @returns true if the trigger should cause an escalation.
+ */
+export function shouldEscalate(blueprint, triggerName) {
+    return blueprint.escalationTriggers.includes(triggerName);
+}
+/**
+ * Route an escalation-worthy event to either pause+escalate or immediate failure.
+ *
+ * If the trigger name is in the blueprint's escalationTriggers list, pauses
+ * the instance and creates an escalation. Otherwise, calls the onFail callback
+ * to fail the instance immediately.
+ *
+ * @param state       - The in-memory instance state.
+ * @param triggerName - The trigger category (e.g. TRIGGER_RESOURCE_LIMIT_EXCEEDED).
+ * @param reason      - Short reason for the escalation.
+ * @param message     - Detailed human-readable message.
+ * @param onFail      - Callback invoked when the trigger is not configured for escalation.
+ * @param config      - Optional escalation configuration overrides.
+ */
+export async function escalateOrFail(state, triggerName, reason, message, onFail, config, sessionId) {
+    if (shouldEscalate(state.blueprint, triggerName)) {
+        await escalateInstanceState(state, reason, message, config, sessionId);
+    }
+    else {
+        console.log(`${LOG_PREFIX} Trigger "${triggerName}" not in escalationTriggers -- failing instead of escalating`);
+        await onFail();
+    }
+}
+// ============================================================================
+// Stuck detection
+// ============================================================================
+/**
+ * Detect whether any strategies in an instance appear to be stuck.
+ *
+ * A strategy is considered "stuck" when the same gate has failed N
+ * consecutive times (where N is the stuckThreshold) with the same
+ * error pattern. This indicates the builder is unable to make progress
+ * despite retries.
+ *
+ * Gate results are grouped by strategy_id and analyzed per-strategy.
+ *
+ * @param instanceState - The in-memory state of the factory instance.
+ * @param config        - Optional escalation configuration overrides.
+ * @returns Array of stuck detection results (one per stuck strategy).
+ */
+export async function detectStuckStrategies(instanceState, config) {
+    const threshold = config?.stuckThreshold ?? DEFAULT_STUCK_THRESHOLD;
+    const allGateResults = await getGateResultsByInstance(instanceState.instanceId);
+    const results = [];
+    // Group gate results by strategy
+    const byStrategy = new Map();
+    for (const gr of allGateResults) {
+        if (!gr.strategyId)
+            continue;
+        const existing = byStrategy.get(gr.strategyId);
+        if (existing) {
+            existing.push(gr);
+        }
+        else {
+            byStrategy.set(gr.strategyId, [gr]);
+        }
+    }
+    for (const [strategyId, gateResults] of byStrategy) {
+        const stuckResult = analyzeGateResultsForStuck(strategyId, gateResults, threshold);
+        if (stuckResult.isStuck) {
+            results.push(stuckResult);
+        }
+    }
+    return results;
+}
+/**
+ * Check stuck detection and escalate or fail based on blueprint triggers.
+ *
+ * Convenience function that combines detectStuckStrategies() with
+ * escalateOrFail(). Returns true if the instance was escalated or failed.
+ *
+ * @param onFail - Callback invoked when TRIGGER_BUILDER_STUCK is not in
+ *                 escalationTriggers and the instance should fail instead.
+ */
+export async function checkAndEscalateIfStuck(state, onFail, config) {
+    const stuckStrategies = await detectStuckStrategies(state, config);
+    if (stuckStrategies.length === 0) {
+        return false;
+    }
+    // Build a detailed message from all stuck strategies
+    const details = stuckStrategies.map((s) => {
+        const pattern = s.errorPattern
+            ? `: "${s.errorPattern.slice(0, 200)}${s.errorPattern.length > 200 ? '...' : ''}"`
+            : '';
+        return (`Strategy ${s.strategyId} stuck at ${s.gateType ?? 'unknown'} gate ` +
+            `(${s.consecutiveFailures} consecutive failures with same error pattern${pattern})`);
+    });
+    const reason = 'stuck_detected';
+    const message = `Factory instance is stuck. ${stuckStrategies.length} strategy(ies) are failing ` +
+        `repeatedly with the same error:\n\n${details.join('\n')}`;
+    await escalateOrFail(state, TRIGGER_BUILDER_STUCK, reason, message, onFail, config);
+    return true;
+}
+// ============================================================================
+// Pure analysis helpers
+// ============================================================================
+/**
+ * Analyze gate results for a single strategy to detect stuck patterns.
+ *
+ * Looks at the most recent gate results in reverse chronological order.
+ * If N consecutive failed results have the same gate type and normalized
+ * error output, the strategy is considered stuck.
+ */
+export function analyzeGateResultsForStuck(strategyId, gateResults, threshold) {
+    const notStuck = {
+        isStuck: false,
+        strategyId,
+        gateType: null,
+        errorPattern: null,
+        consecutiveFailures: 0,
+    };
+    if (gateResults.length < threshold) {
+        return notStuck;
+    }
+    // Sort by creation time descending (most recent first)
+    const sorted = [...gateResults].sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    // Get the most recent failed results
+    const recentFailed = [];
+    for (const result of sorted) {
+        if (!result.passed) {
+            recentFailed.push(result);
+        }
+        else {
+            // Stop at the first passing result -- the streak is broken
+            break;
+        }
+    }
+    if (recentFailed.length < threshold) {
+        return notStuck;
+    }
+    // Check if the N most recent failures share the same gate type and error pattern
+    const referenceResult = recentFailed[0];
+    const referencePattern = normalizeErrorPattern(referenceResult.output);
+    const referenceGateType = referenceResult.gateType;
+    let consecutiveCount = 0;
+    for (const result of recentFailed) {
+        if (result.gateType !== referenceGateType) {
+            break;
+        }
+        const pattern = normalizeErrorPattern(result.output);
+        if (pattern !== referencePattern) {
+            break;
+        }
+        consecutiveCount++;
+    }
+    if (consecutiveCount >= threshold) {
+        return {
+            isStuck: true,
+            strategyId,
+            gateType: referenceGateType,
+            errorPattern: referencePattern,
+            consecutiveFailures: consecutiveCount,
+        };
+    }
+    return notStuck;
+}
+/**
+ * Normalize an error output string for pattern comparison.
+ *
+ * Applies the following normalizations:
+ *   - Trims whitespace
+ *   - Collapses multiple whitespace to single space
+ *   - Truncates to ERROR_PATTERN_MAX_LENGTH characters
+ *   - Returns empty string for null/undefined input
+ *
+ * This allows comparing error outputs that differ only in timestamps,
+ * line numbers, or minor formatting variations.
+ */
+export function normalizeErrorPattern(output) {
+    if (!output) {
+        return '';
+    }
+    return output
+        .trim()
+        .replace(/\s+/g, ' ')
+        .slice(0, ERROR_PATTERN_MAX_LENGTH);
+}
+//# sourceMappingURL=escalation.js.map

package/dist/escalation.js.map

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

package/dist/execution-target.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Builder execution target -- bridges TriggerExecutionTarget to a running builder.
+ *
+ * The BuilderExecutionTarget wraps a BuilderState (with its stdin handle) and
+ * implements TriggerExecutionTarget for sending stream-json messages to the
+ * builder process.
+ *
+ * Extracted from execution.ts for focused module boundaries.
+ */
+import type { BuilderState, FactoryInstanceState, TriggerExecutionTarget, ContextDirective } from './types.js';
+/**
+ * Wraps a BuilderState (with its stdin handle) as a TriggerExecutionTarget.
+ *
+ * Writes stream-json messages to the builder's stdin pipe.
+ * Handles edge cases: stdin already closed, write errors.
+ */
+export declare class BuilderExecutionTarget implements TriggerExecutionTarget {
+    private readonly builder;
+    constructor(builder: BuilderState);
+    injectPrompt(prompt: string): Promise<void>;
+    manageContext(directive: ContextDirective): Promise<void>;
+    setField(fieldName: string, fieldValue: unknown): Promise<void>;
+    notify(recipients: string[], message: string): Promise<void>;
+    private sendMessage;
+}
+/**
+ * Look up the active builder for a work unit and return it as a TriggerExecutionTarget.
+ * Returns null if no active builder exists for the given work unit.
+ */
+export declare function getBuilderTarget(state: FactoryInstanceState, workUnitId: string): TriggerExecutionTarget | null;
+//# sourceMappingURL=execution-target.d.ts.map

package/dist/execution-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target.d.ts","sourceRoot":"","sources":["../src/execution-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAWpB;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,sBAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAE5C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,OAAO,CAAC,WAAW;CAcpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,EAC3B,UAAU,EAAE,MAAM,GACjB,sBAAsB,GAAG,IAAI,CAM/B"}

package/dist/execution-target.js

@@ -0,0 +1,71 @@
+/**
+ * Builder execution target -- bridges TriggerExecutionTarget to a running builder.
+ *
+ * The BuilderExecutionTarget wraps a BuilderState (with its stdin handle) and
+ * implements TriggerExecutionTarget for sending stream-json messages to the
+ * builder process.
+ *
+ * Extracted from execution.ts for focused module boundaries.
+ */
+import { executeDirective } from './context-manager.js';
+/** Log prefix for execution-target messages. */
+const LOG_PREFIX = '[execution]';
+// ============================================================================
+// Builder execution target
+// ============================================================================
+/**
+ * Wraps a BuilderState (with its stdin handle) as a TriggerExecutionTarget.
+ *
+ * Writes stream-json messages to the builder's stdin pipe.
+ * Handles edge cases: stdin already closed, write errors.
+ */
+export class BuilderExecutionTarget {
+    builder;
+    constructor(builder) {
+        this.builder = builder;
+    }
+    async injectPrompt(prompt) {
+        this.sendMessage(prompt, 'inject_prompt');
+    }
+    async manageContext(directive) {
+        const message = executeDirective(directive);
+        if (message) {
+            this.sendMessage(message, 'manage_context');
+        }
+        else {
+            console.log(`${LOG_PREFIX} manageContext directive '${directive.type}' produced no payload (handled externally or skipped)`);
+        }
+    }
+    async setField(fieldName, fieldValue) {
+        console.log(`${LOG_PREFIX} setField("${fieldName}", ${JSON.stringify(fieldValue)}) on builder ${this.builder.sessionId} -- no-op for builder sessions`);
+    }
+    async notify(recipients, message) {
+        console.log(`${LOG_PREFIX} notify(${JSON.stringify(recipients)}, "${message}") on builder ${this.builder.sessionId}`);
+    }
+    sendMessage(content, action) {
+        const { stdin } = this.builder;
+        if (!stdin || stdin.destroyed) {
+            console.warn(`${LOG_PREFIX} Cannot send ${action} to builder ${this.builder.sessionId} -- stdin closed`);
+            return;
+        }
+        try {
+            const payload = JSON.stringify({ type: 'user', content });
+            stdin.write(payload + '\n');
+        }
+        catch (err) {
+            console.warn(`${LOG_PREFIX} Failed to write ${action} to builder ${this.builder.sessionId}: ${err.message}`);
+        }
+    }
+}
+/**
+ * Look up the active builder for a work unit and return it as a TriggerExecutionTarget.
+ * Returns null if no active builder exists for the given work unit.
+ */
+export function getBuilderTarget(state, workUnitId) {
+    const builder = state.activeBuilderSessions.get(workUnitId);
+    if (!builder || !builder.stdin || builder.stdin.destroyed) {
+        return null;
+    }
+    return new BuilderExecutionTarget(builder);
+}
+//# sourceMappingURL=execution-target.js.map

package/dist/execution-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target.js","sourceRoot":"","sources":["../src/execution-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,gDAAgD;AAChD,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAA2B;QAC7C,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,6BAA6B,SAAS,CAAC,IAAI,uDAAuD,CAAC,CAAC;QAC/H,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,UAAmB;QACnD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,cAAc,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,SAAS,gCAAgC,CAAC,CAAC;IAC1J,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAoB,EAAE,OAAe;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,OAAO,iBAAiB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxH,CAAC;IAEO,WAAW,CAAC,OAAe,EAAE,MAAc;QACjD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,MAAM,eAAe,IAAI,CAAC,OAAO,CAAC,SAAS,kBAAkB,CAAC,CAAC;YACzG,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,oBAAoB,MAAM,eAAe,IAAI,CAAC,OAAO,CAAC,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1H,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA2B,EAC3B,UAAkB;IAElB,MAAM,OAAO,GAAG,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/execution-unit-init.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Execution unit initialization.
+ *
+ * Creates execution unit rows in the DB when a factory instance transitions
+ * to building. Each unit starts as 'idle', ready for strategy assignment
+ * by the scheduler.
+ */
+import type { FactoryInstanceState } from './types.js';
+/**
+ * Initialize execution units for a factory instance entering the building phase.
+ *
+ * Creates N execution unit rows in the DB (N = blueprint.executionUnitCount)
+ * and populates the in-memory executionUnits map on the instance state.
+ * Each unit gets a sequential slot_index (0..N-1), starts as 'idle',
+ * and inherits the model from the blueprint's execution unit config.
+ *
+ * Called once when an instance transitions from planning to building.
+ */
+export declare function initializeExecutionUnits(state: FactoryInstanceState): Promise<void>;
+/**
+ * Restore execution units from DB into in-memory state.
+ *
+ * Used during daemon restart (adoptActiveInstance) to rebuild the
+ * executionUnits map from existing DB rows. Units that were 'running'
+ * are reset to 'idle' since their sessions are gone.
+ */
+export declare function restoreExecutionUnits(state: FactoryInstanceState): Promise<void>;
+//# sourceMappingURL=execution-unit-init.d.ts.map

package/dist/execution-unit-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-unit-init.d.ts","sourceRoot":"","sources":["../src/execution-unit-init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/execution-unit-init.js

@@ -0,0 +1,115 @@
+/**
+ * Execution unit initialization.
+ *
+ * Creates execution unit rows in the DB when a factory instance transitions
+ * to building. Each unit starts as 'idle', ready for strategy assignment
+ * by the scheduler.
+ */
+import { createExecutionUnit, getExecutionUnitsByInstance, updateExecutionUnit } from './queries/execution-units.js';
+const LOG_PREFIX = '[factory-init]';
+/**
+ * Initialize execution units for a factory instance entering the building phase.
+ *
+ * Creates N execution unit rows in the DB (N = blueprint.executionUnitCount)
+ * and populates the in-memory executionUnits map on the instance state.
+ * Each unit gets a sequential slot_index (0..N-1), starts as 'idle',
+ * and inherits the model from the blueprint's execution unit config.
+ *
+ * Called once when an instance transitions from planning to building.
+ */
+export async function initializeExecutionUnits(state) {
+    const { blueprint } = state;
+    const count = blueprint.executionUnitCount;
+    const unitConfig = blueprint.executionUnitConfig;
+    const defaultModel = unitConfig?.defaultModel ?? null;
+    console.log(`${LOG_PREFIX} Initializing ${count} execution unit(s) for instance ${state.instanceId} ` +
+        `(model: ${defaultModel ?? 'default'})`);
+    for (let i = 0; i < count; i++) {
+        const unit = await createExecutionUnit({
+            instanceId: state.instanceId,
+            slotIndex: i,
+            model: defaultModel,
+            config: unitConfig,
+        });
+        state.executionUnits.set(unit.id, {
+            unitId: unit.id,
+            instanceId: state.instanceId,
+            slotIndex: i,
+            status: 'idle',
+            pid: null,
+            stdin: null,
+            streamParser: null,
+            claudeSessionId: null,
+            assignedStrategyId: null,
+            assignedAt: null,
+            previousStrategyId: null,
+            activityTracker: null,
+            adapter: null,
+            startedAt: null,
+            dispatchedAt: null,
+            dispatchedWorkUnitIds: new Set(),
+            lastActivityAt: null,
+            tokensUsed: 0,
+            costUsed: 0,
+        });
+    }
+    console.log(`${LOG_PREFIX} Created ${count} execution unit(s) for instance ${state.instanceId}`);
+}
+/**
+ * Restore execution units from DB into in-memory state.
+ *
+ * Used during daemon restart (adoptActiveInstance) to rebuild the
+ * executionUnits map from existing DB rows. Units that were 'running'
+ * are reset to 'idle' since their sessions are gone.
+ */
+export async function restoreExecutionUnits(state) {
+    const units = await getExecutionUnitsByInstance(state.instanceId);
+    if (units.length === 0) {
+        return;
+    }
+    for (const unit of units) {
+        // If the unit was running or assigned when the daemon died, reset to idle.
+        // After a crash, sessions for assigned/running units are gone -- the
+        // scheduler will reassign them on the next cycle.
+        const needsReset = unit.status === 'running' || unit.status === 'assigned';
+        const status = needsReset ? 'idle' : unit.status;
+        // Also persist the reset to DB so the scheduler sees clean state
+        if (needsReset) {
+            try {
+                await updateExecutionUnit(unit.id, {
+                    status: 'idle',
+                    assignedStrategyId: null,
+                    assignedAt: null,
+                    claudeSessionId: null,
+                });
+            }
+            catch (err) {
+                console.warn(`${LOG_PREFIX} Failed to reset unit ${unit.id} in DB during restore: ` +
+                    `${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        state.executionUnits.set(unit.id, {
+            unitId: unit.id,
+            instanceId: state.instanceId,
+            slotIndex: unit.slotIndex,
+            status,
+            pid: null,
+            stdin: null,
+            streamParser: null,
+            claudeSessionId: needsReset ? null : unit.claudeSessionId,
+            assignedStrategyId: needsReset ? null : unit.assignedStrategyId,
+            assignedAt: null,
+            previousStrategyId: null,
+            activityTracker: null,
+            adapter: null,
+            startedAt: null,
+            dispatchedAt: null,
+            dispatchedWorkUnitIds: new Set(),
+            lastActivityAt: null,
+            tokensUsed: 0,
+            costUsed: 0,
+        });
+    }
+    console.log(`${LOG_PREFIX} Restored ${units.length} execution unit(s) for instance ${state.instanceId}`);
+}
+//# sourceMappingURL=execution-unit-init.js.map

package/dist/execution-unit-init.js.map

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

package/dist/execution.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Factory execution -- barrel re-export.
+ *
+ * The implementation has been split into focused modules:
+ *   - builder-spawner.ts       -- builder process spawning, env setup, stream handling
+ *   - builder-completion.ts    -- builder completion handling, execution cycle orchestration
+ *   - execution-target.ts      -- BuilderExecutionTarget (TriggerExecutionTarget impl)
+ *   - work-unit-scheduler.ts   -- DAG-aware work unit readiness, dependency maps
+ *
+ * This file preserves the original import path for consumers (index.ts, tests).
+ */
+export { findReadyWorkUnits } from './work-unit-scheduler.js';
+export type { StrategyDependencyMap, StrategyStatusMap } from './work-unit-scheduler.js';
+export { spawnBuilder, transitionWorkUnitStatus, DEFAULT_MAX_ITERATIONS, LOG_PREFIX, lastGateOutputByWorkUnit } from './builder-spawner.js';
+export { handleBuilderCompletion, runExecutionCycle } from './builder-completion.js';
+export { BuilderExecutionTarget, getBuilderTarget } from './execution-target.js';
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGzF,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAG5I,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}