@telora/factory 0.4.5

package/dist/planning-prompt.js

@@ -0,0 +1,251 @@
+/**
+ * Planning prompt builders and environment setup.
+ *
+ * Contains functions that construct the prompts sent to Claude Code for
+ * planning sessions, configure the spawning environment, and generate
+ * branch names. Split from planning.ts for maintainability.
+ */
+import { resolveExecutionProfile } from './spec-profiles.js';
+// ============================================================================
+// Environment builder
+// ============================================================================
+/**
+ * Build a clean environment for the planning Claude Code session.
+ *
+ * Strips inherited CLAUDE_CODE_* and CLAUDECODE env vars to prevent
+ * child Claude Code processes from detecting a parent session and hanging.
+ * Injects TELORA_TRACKER_ID for the spawned session.
+ */
+export function buildPlanningEnv(config) {
+    const env = { ...process.env };
+    // Strip all Claude Code session markers
+    for (const key of Object.keys(env)) {
+        if (key === 'CLAUDECODE' || key.startsWith('CLAUDE_CODE_')) {
+            delete env[key];
+        }
+    }
+    // Inject tracker ID for the spawned session
+    env.TELORA_TRACKER_ID = config.trackerId;
+    return env;
+}
+// ============================================================================
+// Branch name generation
+// ============================================================================
+/**
+ * Sanitize a blueprint name for use in a git branch name.
+ *
+ * Replaces non-alphanumeric characters with hyphens, collapses runs of
+ * hyphens, and trims leading/trailing hyphens.
+ */
+function sanitizeBranchSegment(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Generate a factory branch name from the blueprint name and instance ID.
+ *
+ * Format: factory/{sanitized-blueprint-name}-{first-8-chars-of-instance-id}
+ */
+export function generateBranchName(blueprintName, instanceId) {
+    const sanitized = sanitizeBranchSegment(blueprintName);
+    const shortId = instanceId.replace(/-/g, '').slice(0, 8);
+    return `factory/${sanitized}-${shortId}`;
+}
+// ============================================================================
+// Prompt builder
+// ============================================================================
+/**
+ * Build the prompt that instructs Claude Code to generate a work plan.
+ *
+ * The prompt includes the full factory specification, resource limits from the
+ * blueprint, and asks for a structured JSON response matching the WorkPlan schema.
+ */
+export function buildPlanningPrompt(specification, blueprint, auditReport, specType, reviewGaps) {
+    const parts = [
+        'You are a planning agent for a software factory system.',
+        'Your task is to analyze the following specification and produce a structured work plan.',
+        '',
+        '## Blueprint',
+        `Name: ${blueprint.name}`,
+    ];
+    if (blueprint.operationalNotes) {
+        parts.push('', '## Operational Notes', blueprint.operationalNotes);
+    }
+    // Inject spec type planning guidance from execution profile
+    const profile = resolveExecutionProfile(specType ?? null);
+    if (profile.planningGuidance) {
+        parts.push('', '## Spec Type', profile.planningGuidance);
+    }
+    // Inject resource limits so the AI plans within constraints
+    const limits = [];
+    if (blueprint.maxWorkUnits !== null) {
+        limits.push(`- Maximum work units: ${blueprint.maxWorkUnits}`);
+    }
+    if (blueprint.maxIterationsPerWorkUnit !== null) {
+        limits.push(`- Maximum iterations per work unit: ${blueprint.maxIterationsPerWorkUnit}`);
+    }
+    if (blueprint.maxTokenBudget !== null) {
+        limits.push(`- Token budget for entire instance: ${blueprint.maxTokenBudget}`);
+    }
+    if (blueprint.maxWallClockHours !== null) {
+        limits.push(`- Wall-clock time limit: ${blueprint.maxWallClockHours} hours`);
+    }
+    if (limits.length > 0) {
+        parts.push('', '## Resource Limits', ...limits);
+    }
+    parts.push('', '## Specification', specification);
+    // Inject audit results when available (from pre-planning codebase audit)
+    if (auditReport) {
+        parts.push('', '## Codebase Audit Results', '', 'The following audit was performed against the existing codebase. Use this to avoid duplicating existing work.', '', auditReport, '', 'IMPORTANT:', '- Do NOT create work units for features that are already fully implemented', '- For partial implementations, scope work units to complete only the missing parts', '- If the audit identifies conflicts, include work units to resolve them', '- If the audit shows gaps, these are your primary work units');
+    }
+    // Inject review gap constraints when re-planning after a review cycle
+    if (reviewGaps && reviewGaps.length > 0) {
+        const critical = reviewGaps.filter((g) => g.severity === 'critical');
+        const important = reviewGaps.filter((g) => g.severity === 'important');
+        const gapLines = [
+            '## Review Gaps -- Constrained Scope',
+            '',
+            'The review phase identified specific gaps. Your work plan MUST be LIMITED to fixing these gaps only.',
+            'Do NOT create work units for features already implemented, add new scope, or work on anything',
+            'not directly related to the gaps listed below.',
+            '',
+        ];
+        if (critical.length > 0) {
+            gapLines.push('### Critical gaps (must fix)');
+            for (const g of critical) {
+                gapLines.push(`- **${g.area}**: ${g.description}`);
+                gapLines.push(`  Fix: ${g.suggestedFix}`);
+            }
+            gapLines.push('');
+        }
+        if (important.length > 0) {
+            gapLines.push('### Important gaps (should fix)');
+            for (const g of important) {
+                gapLines.push(`- **${g.area}**: ${g.description}`);
+                gapLines.push(`  Fix: ${g.suggestedFix}`);
+            }
+            gapLines.push('');
+        }
+        parts.push('', ...gapLines);
+    }
+    parts.push('', '## Instructions', 'Analyze the specification and break it down into discrete, implementable work units.', '', '### Work Unit Scope', 'Each work unit should represent a distinct functional capability the specification requires.', 'Think of each work unit as a meaningful deliverable -- not as fine-grained as individual tasks or functions,', 'but not as broad as the entire specification.', '', 'Each work unit is something to BUILD -- a functional capability the spec requires.', 'Writing and running tests is a normal part of implementing a feature, not a separate work unit.', 'Do NOT create work units whose sole purpose is to run tests, confirm builds succeed, or verify', 'commands execute. A work unit called "Implement authentication" that includes writing tests is correct.', 'A work unit called "Verify npm test passes" is not a feature -- it is solving for the gate.', '', 'Split into separate work units when:', '- Features are independently useful', '- Components belong to different subsystems (e.g. backend API vs frontend UI)', '- Changes have no shared state or tightly coupled logic', '', 'Combine into a single work unit when:', '- Changes are tightly coupled and must be deployed together', '- Splitting would leave either side in a broken state', '- The scope is small enough to implement as one coherent change', '', 'If the Operational Notes section above provides specific granularity guidance, follow that instead.', '', 'Order work units by dependency -- units that other units depend on should come first.', 'Use the `blockedBy` field to express dependency relationships between work units using tempId references.', '', '### What Belongs in Work Unit Descriptions', 'Work unit descriptions must describe WHAT to build -- the functional capability --', 'not internal naming conventions or implementation details.', '', 'Do NOT include in work unit titles or descriptions:', '- Specific internal method names, private function names, or internal constant names', '  the team should use (e.g. "rename pressDigit to inputDigit", "use PLUS/MINUS constants")', '- Instructions to rename or restructure code to match spec vocabulary when the', '  existing implementation is functionally equivalent', '- Internal naming prescriptions that do not affect the externally observable behavior', '', 'DO include:', '- What the feature does for a user or caller', '- What the external API or interface must expose (exported functions, endpoints, etc.)', '- What behavior or contract must hold', '', 'If the specification or audit report mentions internal naming differences, ignore them.', 'Only create work units for functional gaps or broken external contracts.', '', '## Output Format', 'Return ONLY a JSON object (no markdown fencing, no commentary) with this exact structure:', '```', '{', '  "workUnits": [', '    {', '      "tempId": "wu-0",', '      "title": "Short descriptive title",', '      "description": "Detailed description of what this work unit implements",', '      "sortOrder": 0,', '      "blockedBy": []', '    },', '    {', '      "tempId": "wu-1",', '      "title": "Another work unit",', '      "description": "This depends on wu-0",', '      "sortOrder": 1,', '      "blockedBy": ["wu-0"]', '    }', '  ]', '}', '```', '', 'Rules:', '- Each tempId must be unique (e.g. "wu-0", "wu-1", "wu-2", ...)', '- sortOrder must start at 0 and increment by 1', '- blockedBy must only reference tempIds of other work units in the plan', '- Every work unit must have a non-empty title and description', '- Return at least one work unit');
+    if (blueprint.maxWorkUnits !== null) {
+        parts.push(`- You MUST produce no more than ${blueprint.maxWorkUnits} work units`);
+    }
+    parts.push('- Return ONLY the JSON object, nothing else');
+    return parts.join('\n');
+}
+/**
+ * Build a scoped planning prompt for a single strategy within a larger
+ * multi-strategy factory instance.
+ *
+ * Differs from buildPlanningPrompt() in that it:
+ * 1. Frames the role as planning within a bounded strategy scope
+ * 2. Includes the strategy's tech context and relevant files
+ * 3. Includes interface contracts (what this strategy must produce/consume)
+ * 4. Includes dependency context from already-planned upstream strategies
+ */
+export function buildScopedPlanningPrompt(strategy, specification, blueprint, auditReport, dependencyContexts, specType) {
+    const parts = [
+        'You are a planning agent for a specific strategy within a multi-strategy software factory system.',
+        `Your task is to plan work units ONLY within the scope of the "${strategy.name}" strategy.`,
+        '',
+        '## Strategy Scope',
+        `**Name:** ${strategy.name}`,
+    ];
+    if (strategy.description) {
+        parts.push(`**Description:** ${strategy.description}`);
+    }
+    if (strategy.techContext) {
+        parts.push('', '**Technical Context:**', strategy.techContext);
+    }
+    // Inject spec type planning guidance from execution profile
+    const profile = resolveExecutionProfile(specType ?? null);
+    if (profile.planningGuidance) {
+        parts.push('', '## Spec Type', profile.planningGuidance);
+    }
+    // Interface contracts
+    if (strategy.interfaceContract) {
+        const contract = strategy.interfaceContract;
+        if (contract.produces.length > 0) {
+            parts.push('', '### This Strategy Must Produce');
+            for (const item of contract.produces) {
+                parts.push(`- [${item.kind}] \`${item.identifier}\`${item.description ? ` -- ${item.description}` : ''}`);
+            }
+        }
+        if (contract.consumes.length > 0) {
+            parts.push('', '### This Strategy Consumes (from dependencies)');
+            for (const item of contract.consumes) {
+                parts.push(`- [${item.kind}] \`${item.identifier}\`${item.description ? ` -- ${item.description}` : ''}`);
+            }
+        }
+    }
+    // Dependency context from upstream strategies
+    if (dependencyContexts && dependencyContexts.length > 0) {
+        parts.push('', '## Upstream Dependencies (already planned)');
+        for (const dep of dependencyContexts) {
+            parts.push(`### ${dep.strategyName}`);
+            if (dep.description) {
+                parts.push(dep.description);
+            }
+            if (dep.produces.length > 0) {
+                parts.push('Produces:');
+                for (const item of dep.produces) {
+                    parts.push(`- [${item.kind}] \`${item.identifier}\`${item.description ? ` -- ${item.description}` : ''}`);
+                }
+            }
+            if (dep.workUnitTitles.length > 0) {
+                parts.push(`Work units (${dep.workUnitTitles.length}): ${dep.workUnitTitles.join(', ')}`);
+            }
+            parts.push('');
+        }
+    }
+    parts.push('', '## Blueprint', `Name: ${blueprint.name}`);
+    if (blueprint.operationalNotes) {
+        parts.push('', '## Operational Notes', blueprint.operationalNotes);
+    }
+    // Resource limits
+    const limits = [];
+    if (blueprint.maxWorkUnits !== null) {
+        limits.push(`- Maximum work units (entire instance): ${blueprint.maxWorkUnits}`);
+    }
+    if (blueprint.maxIterationsPerWorkUnit !== null) {
+        limits.push(`- Maximum iterations per work unit: ${blueprint.maxIterationsPerWorkUnit}`);
+    }
+    if (limits.length > 0) {
+        parts.push('', '## Resource Limits', ...limits);
+    }
+    parts.push('', '## Full Specification (for reference)', specification);
+    if (auditReport) {
+        parts.push('', '## Scoped Codebase Audit Results', '', 'The following audit was performed against the codebase scoped to this strategy.', '', auditReport, '', 'IMPORTANT:', '- Do NOT create work units for features that are already fully implemented', '- For partial implementations, scope work units to complete only the missing parts', '- If the audit identifies conflicts, include work units to resolve them');
+    }
+    parts.push('', '## Instructions', `Plan work units ONLY for the "${strategy.name}" strategy scope described above.`, 'Do NOT plan work that belongs to other strategies or falls outside this scope.', '', '### Work Unit Scope', 'Each work unit should represent a distinct functional capability the specification requires.', '', 'Each work unit is something to BUILD -- a functional capability the spec requires.', 'Writing and running tests is a normal part of implementing a feature, not a separate work unit.', 'Do NOT create work units whose sole purpose is to run tests, confirm builds succeed, or verify', 'commands execute.', '', 'Split into separate work units when:', '- Features are independently useful', '- Components belong to different subsystems within this strategy', '', 'Combine into a single work unit when:', '- Changes are tightly coupled and must be deployed together', '- The scope is small enough to implement as one coherent change', '', 'If the Operational Notes section above provides specific granularity guidance, follow that instead.', '', 'Order work units by dependency -- units that other units depend on should come first.', 'Use the `blockedBy` field to express dependency relationships between work units using tempId references.', '', '### What Belongs in Work Unit Descriptions', 'Work unit descriptions must describe WHAT to build -- the functional capability --', 'not internal naming conventions or implementation details.', '', 'Do NOT include in work unit titles or descriptions:', '- Specific internal method names, private function names, or internal constant names', '  the team should use (e.g. "rename pressDigit to inputDigit", "use PLUS/MINUS constants")', '- Instructions to rename or restructure code to match spec vocabulary when the', '  existing implementation is functionally equivalent', '- Internal naming prescriptions that do not affect the externally observable behavior', '', 'DO include:', '- What the feature does for a user or caller', '- What the external API or interface must expose (exported functions, endpoints, etc.)', '- What behavior or contract must hold', '', 'If the specification or audit report mentions internal naming differences, ignore them.', 'Only create work units for functional gaps or broken external contracts.', '', '## Output Format', 'Return ONLY a JSON object (no markdown fencing, no commentary) with this exact structure:', '```', '{', '  "workUnits": [', '    {', '      "tempId": "wu-0",', '      "title": "Short descriptive title",', '      "description": "Detailed description of what this work unit implements",', '      "sortOrder": 0,', '      "blockedBy": []', '    }', '  ]', '}', '```', '', 'Rules:', '- Each tempId must be unique (e.g. "wu-0", "wu-1", "wu-2", ...)', '- sortOrder must start at 0 and increment by 1', '- blockedBy must only reference tempIds of other work units in THIS plan', '- Every work unit must have a non-empty title and description', '- Return at least one work unit', '- Return ONLY the JSON object, nothing else');
+    return parts.join('\n');
+}
+// ============================================================================
+// Retry feedback prompt builder
+// ============================================================================
+/**
+ * Build a retry prompt that includes the original prompt and the validation error.
+ *
+ * This gives the AI context about what went wrong so it can correct its output
+ * on the next attempt.
+ */
+export function buildRetryPrompt(originalPrompt, validationError) {
+    return [
+        originalPrompt,
+        '',
+        '## RETRY -- Previous Attempt Failed',
+        '',
+        `Your previous work plan was rejected with the following error:`,
+        '',
+        validationError,
+        '',
+        'Please fix the issue and produce a corrected work plan.',
+        'Return ONLY the JSON object, nothing else.',
+    ].join('\n');
+}
+//# sourceMappingURL=planning-prompt.js.map

package/dist/planning-prompt.js.map

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

package/dist/planning.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Factory planning phase -- barrel re-export.
+ *
+ * The implementation has been split into focused modules:
+ *   - planning-prompt.ts   -- prompt builders, env setup, branch naming
+ *   - planning-phase.ts    -- plan generation/validation, runPlanningPhase orchestrator
+ *   - plan-parser.ts       -- JSON extraction, Zod schema, dependency validation, ID mapping
+ *
+ * This file preserves the original import path for consumers.
+ */
+export { buildPlanningEnv, generateBranchName, buildPlanningPrompt, buildScopedPlanningPrompt, buildRetryPrompt, } from './planning-prompt.js';
+export type { DependencyContext } from './planning-prompt.js';
+export { generateAndValidateWorkPlan, runPlanningPhase, } from './planning-phase.js';
+export type { PlanGenerationResult } from './planning-phase.js';
+export { extractWorkPlanJson, mapTempIdsToUuids, WorkPlanSchema, validateDependencies, } from './plan-parser.js';
+//# sourceMappingURL=planning.d.ts.map

package/dist/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/planning.js

@@ -0,0 +1,17 @@
+/**
+ * Factory planning phase -- barrel re-export.
+ *
+ * The implementation has been split into focused modules:
+ *   - planning-prompt.ts   -- prompt builders, env setup, branch naming
+ *   - planning-phase.ts    -- plan generation/validation, runPlanningPhase orchestrator
+ *   - plan-parser.ts       -- JSON extraction, Zod schema, dependency validation, ID mapping
+ *
+ * This file preserves the original import path for consumers.
+ */
+// Prompt builders & env
+export { buildPlanningEnv, generateBranchName, buildPlanningPrompt, buildScopedPlanningPrompt, buildRetryPrompt, } from './planning-prompt.js';
+// Plan generation & orchestration
+export { generateAndValidateWorkPlan, runPlanningPhase, } from './planning-phase.js';
+// Plan parsing & validation
+export { extractWorkPlanJson, mapTempIdsToUuids, WorkPlanSchema, validateDependencies, } from './plan-parser.js';
+//# sourceMappingURL=planning.js.map

package/dist/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,kCAAkC;AAClC,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/process-runner.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Async Claude Code process runner.
+ *
+ * Replaces execFileSync for all Claude Code invocations so the Node.js
+ * event loop remains unblocked during long-running AI sessions.
+ * Unblocked event loop keeps daemon heartbeats alive and allows graceful
+ * SIGTERM shutdown while Claude Code is running.
+ */
+export interface SpawnAsyncOptions {
+    /** Text to write to stdin. */
+    input: string;
+    /** Encoding for stdout output. */
+    encoding: 'utf-8';
+    /** Timeout in ms. Undefined or 0 = no limit. */
+    timeout?: number;
+    /** Working directory for the child process. */
+    cwd: string;
+    /** Environment variables. */
+    env: Record<string, string | undefined>;
+}
+/** Error thrown by spawnAsync on non-zero exit or timeout. */
+export interface SpawnAsyncError extends Error {
+    killed?: boolean;
+    signal?: string | null;
+    status?: number | null;
+    stderr?: string;
+    stdout?: string;
+}
+/**
+ * Async equivalent of execFileSync for one-shot Claude Code invocations.
+ *
+ * Spawns a child process, writes `input` to stdin, and collects stdout.
+ * Resolves with the stdout string when the process exits with code 0.
+ * Rejects with a SpawnAsyncError on non-zero exit, timeout, or spawn failure.
+ *
+ * The error object shape matches what execFileSync throws so existing
+ * catch blocks (checking killed, signal, status, stderr) continue to work
+ * without modification.
+ */
+export declare function spawnAsync(cmd: string, args: string[], options: SpawnAsyncOptions): Promise<string>;
+//# sourceMappingURL=process-runner.d.ts.map

package/dist/process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../src/process-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAmEjB"}

package/dist/process-runner.js

@@ -0,0 +1,81 @@
+/**
+ * Async Claude Code process runner.
+ *
+ * Replaces execFileSync for all Claude Code invocations so the Node.js
+ * event loop remains unblocked during long-running AI sessions.
+ * Unblocked event loop keeps daemon heartbeats alive and allows graceful
+ * SIGTERM shutdown while Claude Code is running.
+ */
+import { spawn } from 'node:child_process';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Async equivalent of execFileSync for one-shot Claude Code invocations.
+ *
+ * Spawns a child process, writes `input` to stdin, and collects stdout.
+ * Resolves with the stdout string when the process exits with code 0.
+ * Rejects with a SpawnAsyncError on non-zero exit, timeout, or spawn failure.
+ *
+ * The error object shape matches what execFileSync throws so existing
+ * catch blocks (checking killed, signal, status, stderr) continue to work
+ * without modification.
+ */
+export function spawnAsync(cmd, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let timedOut = false;
+        let timer;
+        if (options.timeout && options.timeout > 0) {
+            timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+            }, options.timeout);
+        }
+        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        // Swallow EPIPE errors — child may exit before reading all stdin
+        child.stdin.on('error', () => { });
+        child.stdin.write(options.input, 'utf-8', () => {
+            child.stdin.end();
+        });
+        child.on('close', (code, signal) => {
+            if (timer)
+                clearTimeout(timer);
+            const stdout = Buffer.concat(stdoutChunks).toString('utf-8');
+            const stderr = Buffer.concat(stderrChunks).toString('utf-8');
+            if (timedOut) {
+                const err = new Error(`Process timed out`);
+                err.killed = true;
+                err.signal = 'SIGTERM';
+                err.stderr = stderr;
+                err.stdout = stdout;
+                reject(err);
+                return;
+            }
+            if (code !== 0) {
+                const err = new Error(`Command failed: ${cmd} (exit code ${code ?? 'null'})`);
+                err.killed = signal !== null;
+                err.signal = signal ?? undefined;
+                err.status = code ?? undefined;
+                err.stderr = stderr;
+                err.stdout = stdout;
+                reject(err);
+                return;
+            }
+            resolve(stdout);
+        });
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=process-runner.js.map

package/dist/process-runner.js.map

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

package/dist/product-config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Multi-product configuration helpers for the factory engine.
+ *
+ * Separated from config.ts to avoid importing @telora/daemon-core at
+ * module level -- the experimental test module mocking in tsx breaks
+ * external package resolution when config.ts is transitively loaded.
+ */
+import type { FactoryConfig } from './types.js';
+/** Product entry shape (matches ProductEntry from @telora/daemon-core). */
+interface ProductEntry {
+    id: string;
+    repoPath: string;
+}
+/**
+ * Derive a short human-readable label for a product entry.
+ * Uses the basename of the product's repoPath (e.g., "/home/user/repos/telora" -> "telora").
+ * Falls back to an 8-char ID slice if repoPath is empty.
+ */
+export declare function productLabel(product: ProductEntry): string;
+/**
+ * Create a product-scoped FactoryConfig by overriding repoPath,
+ * factoryWorktreeDir, and logDir to target a specific product's repository.
+ *
+ * This ensures factory worktrees are created inside the correct product repo
+ * rather than always using the first product's paths.
+ */
+export declare function configForFactoryProduct(config: FactoryConfig, product: ProductEntry): FactoryConfig;
+/**
+ * Look up a ProductEntry by productId from the config's products array.
+ * Returns undefined if not found.
+ */
+export declare function findFactoryProduct(config: FactoryConfig, productId: string): ProductEntry | undefined;
+export {};
+//# sourceMappingURL=product-config.d.ts.map

package/dist/product-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-config.d.ts","sourceRoot":"","sources":["../src/product-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,2EAA2E;AAC3E,UAAU,YAAY;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAEvD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAG1D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,aAAa,CAQnG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAErG"}

package/dist/product-config.js

@@ -0,0 +1,43 @@
+/**
+ * Multi-product configuration helpers for the factory engine.
+ *
+ * Separated from config.ts to avoid importing @telora/daemon-core at
+ * module level -- the experimental test module mocking in tsx breaks
+ * external package resolution when config.ts is transitively loaded.
+ */
+import { basename } from 'node:path';
+import { resolve } from 'node:path';
+/**
+ * Derive a short human-readable label for a product entry.
+ * Uses the basename of the product's repoPath (e.g., "/home/user/repos/telora" -> "telora").
+ * Falls back to an 8-char ID slice if repoPath is empty.
+ */
+export function productLabel(product) {
+    if (product.repoPath)
+        return basename(product.repoPath);
+    return product.id.slice(0, 8);
+}
+/**
+ * Create a product-scoped FactoryConfig by overriding repoPath,
+ * factoryWorktreeDir, and logDir to target a specific product's repository.
+ *
+ * This ensures factory worktrees are created inside the correct product repo
+ * rather than always using the first product's paths.
+ */
+export function configForFactoryProduct(config, product) {
+    return {
+        ...config,
+        productId: product.id,
+        repoPath: product.repoPath,
+        factoryWorktreeDir: resolve(product.repoPath, '.telora', 'factory-worktrees'),
+        logDir: resolve(product.repoPath, '.telora', 'factory-logs'),
+    };
+}
+/**
+ * Look up a ProductEntry by productId from the config's products array.
+ * Returns undefined if not found.
+ */
+export function findFactoryProduct(config, productId) {
+    return config.products.find(p => p.id === productId);
+}
+//# sourceMappingURL=product-config.js.map

package/dist/product-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-config.js","sourceRoot":"","sources":["../src/product-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB;IAChD,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAqB,EAAE,OAAqB;IAClF,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,mBAAmB,CAAC;QAC7E,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,SAAiB;IACzE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/queries/cycle-evaluations.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Factory cycle evaluation queries.
+ *
+ * Provides read and insert operations for factory_cycle_evaluations table.
+ */
+import type { CompletionGateResult, FactoryCycleEvaluation } from '../types.js';
+/**
+ * Retrieve all cycle evaluations for a factory instance, ordered by cycle_number ASC.
+ *
+ * @param instanceId - The factory instance ID
+ * @returns Array of cycle evaluation records
+ */
+export declare function getCycleEvaluations(instanceId: string): Promise<FactoryCycleEvaluation[]>;
+/**
+ * Persist a completion gate evaluation result to factory_cycle_evaluations.
+ *
+ * @param instanceId - The factory instance ID
+ * @param cycleNumber - Which iteration cycle this evaluation belongs to
+ * @param result - The CompletionGateResult to persist
+ * @returns The created cycle evaluation record
+ */
+export declare function createCycleEvaluation(instanceId: string, cycleNumber: number, result: CompletionGateResult): Promise<FactoryCycleEvaluation>;
+//# sourceMappingURL=cycle-evaluations.d.ts.map

package/dist/queries/cycle-evaluations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-evaluations.d.ts","sourceRoot":"","sources":["../../src/queries/cycle-evaluations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAMnC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/queries/cycle-evaluations.js

@@ -0,0 +1,37 @@
+/**
+ * Factory cycle evaluation queries.
+ *
+ * Provides read and insert operations for factory_cycle_evaluations table.
+ */
+import { callApi } from './shared.js';
+/**
+ * Retrieve all cycle evaluations for a factory instance, ordered by cycle_number ASC.
+ *
+ * @param instanceId - The factory instance ID
+ * @returns Array of cycle evaluation records
+ */
+export async function getCycleEvaluations(instanceId) {
+    const result = await callApi('factory_get_cycle_evaluations', { instanceId });
+    return result.cycleEvaluations || [];
+}
+/**
+ * Persist a completion gate evaluation result to factory_cycle_evaluations.
+ *
+ * @param instanceId - The factory instance ID
+ * @param cycleNumber - Which iteration cycle this evaluation belongs to
+ * @param result - The CompletionGateResult to persist
+ * @returns The created cycle evaluation record
+ */
+export async function createCycleEvaluation(instanceId, cycleNumber, result) {
+    const response = await callApi('factory_create_cycle_evaluation', {
+        instanceId,
+        cycleNumber,
+        passed: result.passed,
+        confidence: result.confidence,
+        summary: result.summary,
+        gaps: result.gaps,
+        suggestions: result.suggestions,
+    });
+    return response.cycleEvaluation;
+}
+//# sourceMappingURL=cycle-evaluations.js.map

package/dist/queries/cycle-evaluations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-evaluations.js","sourceRoot":"","sources":["../../src/queries/cycle-evaluations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,+BAA+B,EAC/B,EAAE,UAAU,EAAE,CACf,CAAC;IACF,OAAO,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,WAAmB,EACnB,MAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,iCAAiC,EACjC;QACE,UAAU;QACV,WAAW;QACX,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CACF,CAAC;IACF,OAAO,QAAQ,CAAC,eAAe,CAAC;AAClC,CAAC"}