@telora/factory 0.4.5

package/dist/audit.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pre-planning codebase audit module.
+ *
+ * Runs a structured discovery phase that scans the codebase for existing
+ * implementations relevant to the specification. The audit produces a
+ * report that gets injected into the planning prompt so the planner knows
+ * what already exists, what is partially built, and what is truly missing.
+ *
+ * The audit is best-effort: if it fails for any reason (timeout, parse error,
+ * empty output), planning proceeds without the audit report.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { AuditReport, FactoryBlueprint, FactoryConfig } from './types.js';
+import type { PersistedStrategy } from './strategy-design.js';
+/**
+ * Resolve the audit timeout from blueprint config.
+ * - null field → use default (180s)
+ * - 0 → no limit (returns null)
+ * - positive → that value
+ */
+export declare function resolveAuditTimeout(blueprint: FactoryBlueprint): number | null;
+/**
+ * Resolve the audit max report chars from blueprint config.
+ * - null field → use default (8000)
+ * - 0 → no limit (returns null)
+ * - positive → that value
+ */
+export declare function resolveAuditMaxReportChars(blueprint: FactoryBlueprint): number | null;
+/**
+ * Build the prompt that instructs Claude Code to audit the codebase
+ * against the specification.
+ */
+export declare function buildAuditPrompt(specification: string, blueprint: FactoryBlueprint): string;
+/**
+ * Build a scoped audit prompt that focuses on a specific strategy's
+ * relevant files and scope rather than the entire codebase.
+ */
+export declare function buildScopedAuditPrompt(strategy: PersistedStrategy, specification: string, blueprint: FactoryBlueprint): string;
+/**
+ * Run a scoped codebase audit for a single strategy.
+ *
+ * Focuses the audit on the strategy's technical context and relevant files
+ * rather than scanning the entire codebase. Best-effort: returns null on
+ * any failure so planning can proceed without it.
+ */
+export declare function runScopedCodebaseAudit(worktreePath: string, strategy: PersistedStrategy, specification: string, blueprint: FactoryBlueprint, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<AuditReport | null>;
+/**
+ * Run a codebase audit by spawning Claude Code in --print mode.
+ *
+ * Returns a validated AuditReport on success, or null on ANY failure.
+ * This function is designed to be best-effort: it never throws and
+ * always returns null on failure so planning can proceed without it.
+ *
+ * @param worktreePath Path to the git worktree (cwd for Claude Code)
+ * @param specification The factory instance specification text
+ * @param blueprint The factory blueprint (for operational notes)
+ * @param config Factory configuration
+ * @returns Validated AuditReport or null on failure
+ */
+export declare function runCodebaseAudit(worktreePath: string, specification: string, blueprint: FactoryBlueprint, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<AuditReport | null>;
+/**
+ * Format a validated AuditReport as human-readable markdown suitable for
+ * injection into the planning prompt.
+ *
+ * Respects the MAX_REPORT_CHARS budget to avoid blowing up the planning
+ * prompt context window.
+ */
+export declare function formatAuditReport(report: AuditReport, blueprint: FactoryBlueprint): string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA6C9D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAI9E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAIrF;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,CAiFR;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,CA8FR;AAMD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyF7B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA4F7B;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAmE1F"}

package/dist/audit.js

@@ -0,0 +1,376 @@
+/**
+ * Pre-planning codebase audit module.
+ *
+ * Runs a structured discovery phase that scans the codebase for existing
+ * implementations relevant to the specification. The audit produces a
+ * report that gets injected into the planning prompt so the planner knows
+ * what already exists, what is partially built, and what is truly missing.
+ *
+ * The audit is best-effort: if it fails for any reason (timeout, parse error,
+ * empty output), planning proceeds without the audit report.
+ */
+import { spawnAsync } from './process-runner.js';
+import { z } from 'zod';
+import { buildPlanningEnv, extractWorkPlanJson } from './planning.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default timeout for the audit Claude Code session (3 minutes -- shorter than planning). */
+const DEFAULT_AUDIT_TIMEOUT_MS = 180_000;
+/** Default maximum character length of the formatted audit report to avoid prompt bloat. */
+const DEFAULT_MAX_REPORT_CHARS = 8_000;
+/** Log prefix for this module. */
+const LOG_PREFIX = '[audit]';
+// ============================================================================
+// Zod schemas
+// ============================================================================
+const AuditEntrySchema = z.object({
+    area: z.string().min(1),
+    description: z.string().min(1),
+    relevantFiles: z.array(z.string()),
+    confidence: z.enum(['high', 'medium', 'low']),
+});
+const AuditConflictSchema = z.object({
+    area: z.string().min(1),
+    existingBehavior: z.string().min(1),
+    specifiedBehavior: z.string().min(1),
+    relevantFiles: z.array(z.string()),
+});
+const AuditReportSchema = z.object({
+    existingImplementations: z.array(AuditEntrySchema),
+    partialImplementations: z.array(AuditEntrySchema),
+    gaps: z.array(AuditEntrySchema),
+    conflicts: z.array(AuditConflictSchema),
+    summary: z.string().min(1),
+});
+// ============================================================================
+// Blueprint-driven config resolution
+// ============================================================================
+/**
+ * Resolve the audit timeout from blueprint config.
+ * - null field → use default (180s)
+ * - 0 → no limit (returns null)
+ * - positive → that value
+ */
+export function resolveAuditTimeout(blueprint) {
+    if (blueprint.auditTimeoutMs === 0)
+        return null;
+    if (blueprint.auditTimeoutMs !== null && blueprint.auditTimeoutMs !== undefined)
+        return blueprint.auditTimeoutMs;
+    return DEFAULT_AUDIT_TIMEOUT_MS;
+}
+/**
+ * Resolve the audit max report chars from blueprint config.
+ * - null field → use default (8000)
+ * - 0 → no limit (returns null)
+ * - positive → that value
+ */
+export function resolveAuditMaxReportChars(blueprint) {
+    if (blueprint.auditMaxReportChars === 0)
+        return null;
+    if (blueprint.auditMaxReportChars !== null && blueprint.auditMaxReportChars !== undefined)
+        return blueprint.auditMaxReportChars;
+    return DEFAULT_MAX_REPORT_CHARS;
+}
+// ============================================================================
+// Audit prompt builder
+// ============================================================================
+/**
+ * Build the prompt that instructs Claude Code to audit the codebase
+ * against the specification.
+ */
+export function buildAuditPrompt(specification, blueprint) {
+    const parts = [
+        'You are a codebase auditor for a software factory system.',
+        'Your task is to analyze the EXISTING codebase in the current working directory',
+        'against the following specification and produce a structured audit report.',
+        '',
+        '## Specification',
+        specification,
+    ];
+    if (blueprint.operationalNotes) {
+        parts.push('', '## Operational Notes (focus areas)', blueprint.operationalNotes);
+    }
+    if (blueprint.specConstraints) {
+        parts.push('', '## Blueprint Infrastructure Requirements', 'The following requirements are mandated by the factory blueprint and take precedence', 'over spec requirements. Do NOT report conflicts or gaps for items covered here.', '', blueprint.specConstraints);
+    }
+    parts.push('', '## Instructions', '', 'Scan the codebase thoroughly:', '1. Identify features/components from the specification that are ALREADY FULLY implemented', '2. Identify features that are PARTIALLY implemented (started but incomplete)', '3. Identify features that are complete GAPS (nothing exists yet)', '4. Flag any CONFLICTS where existing code contradicts the specification', '', 'For each entry, list the relevant file paths and your confidence level.', '', '## Audit Scope', 'Report gaps for FUNCTIONAL REQUIREMENTS only -- things specified but not built.', 'Do NOT report as gaps:', '- Test coverage or missing test files (validated externally by the factory gate system)', '- TypeScript type correctness (validated by the deterministic gate: typecheck)', '- Build validity (validated by the deterministic gate: build)', '- Linting or code style (validated by the deterministic gate: lint)', '- E2E or behavioral correctness (validated by behavioral and adversarial gates)', 'If the factory gates pass, these dimensions are already verified. Only report gaps', 'where a functional feature described in the specification is absent from the codebase.', '', '## Output Format', 'Return ONLY a JSON object (no markdown fencing, no commentary) with this exact structure:', '```', '{', '  "existingImplementations": [', '    { "area": "Feature name", "description": "What exists", "relevantFiles": ["path/to/file.ts"], "confidence": "high" }', '  ],', '  "partialImplementations": [', '    { "area": "Feature name", "description": "What exists and what is missing", "relevantFiles": ["path/to/file.ts"], "confidence": "medium" }', '  ],', '  "gaps": [', '    { "area": "Feature name", "description": "What needs to be built", "relevantFiles": [], "confidence": "high" }', '  ],', '  "conflicts": [', '    { "area": "Feature name", "existingBehavior": "What the code does", "specifiedBehavior": "What the spec says", "relevantFiles": ["path/to/file.ts"] }', '  ],', '  "summary": "One-paragraph overview of audit findings"', '}', '```', '', 'Rules:', '- Every area must have a non-empty name and description', '- relevantFiles should contain actual file paths from the codebase', '- confidence: "high" = very sure, "medium" = fairly sure, "low" = uncertain', '- If no entries for a category, use an empty array []', '- Return ONLY the JSON object, nothing else');
+    return parts.join('\n');
+}
+// ============================================================================
+// Scoped audit prompt builder (per-strategy)
+// ============================================================================
+/**
+ * Build a scoped audit prompt that focuses on a specific strategy's
+ * relevant files and scope rather than the entire codebase.
+ */
+export function buildScopedAuditPrompt(strategy, specification, blueprint) {
+    const parts = [
+        'You are a codebase auditor for a software factory system.',
+        'Your task is to audit the EXISTING codebase scoped to a specific strategy.',
+        `Focus your analysis on the "${strategy.name}" strategy scope.`,
+        '',
+        '## Strategy Scope',
+        `**Name:** ${strategy.name}`,
+    ];
+    if (strategy.description) {
+        parts.push(`**Description:** ${strategy.description}`);
+    }
+    if (strategy.techContext) {
+        parts.push('', '**Technical Context (focus areas):**', strategy.techContext);
+    }
+    parts.push('', '## Full Specification (for reference)', specification);
+    if (blueprint.operationalNotes) {
+        parts.push('', '## Operational Notes', blueprint.operationalNotes);
+    }
+    if (blueprint.specConstraints) {
+        parts.push('', '## Blueprint Infrastructure Requirements', 'The following requirements are mandated by the factory blueprint and take precedence', 'over spec requirements. Do NOT report conflicts or gaps for items covered here.', '', blueprint.specConstraints);
+    }
+    parts.push('', '## Instructions', '', `Focus your audit on the "${strategy.name}" strategy scope:`, '1. Identify features within this strategy that are ALREADY FULLY implemented', '2. Identify features that are PARTIALLY implemented', '3. Identify features that are complete GAPS', '4. Flag any CONFLICTS where existing code contradicts the specification', '', 'For each entry, list the relevant file paths and your confidence level.', '', '## Audit Scope', 'Report gaps for FUNCTIONAL REQUIREMENTS only -- things specified but not built.', 'Do NOT report as gaps:', '- Test coverage or missing test files (validated externally by the factory gate system)', '- TypeScript type correctness (validated by the deterministic gate: typecheck)', '- Build validity (validated by the deterministic gate: build)', '- Linting or code style (validated by the deterministic gate: lint)', '- E2E or behavioral correctness (validated by behavioral and adversarial gates)', 'Only report gaps where a functional feature described in the specification is absent.', '', '## Output Format', 'Return ONLY a JSON object (no markdown fencing, no commentary) with this exact structure:', '```', '{', '  "existingImplementations": [', '    { "area": "Feature name", "description": "What exists", "relevantFiles": ["path/to/file.ts"], "confidence": "high" }', '  ],', '  "partialImplementations": [', '    { "area": "Feature name", "description": "What exists and what is missing", "relevantFiles": ["path/to/file.ts"], "confidence": "medium" }', '  ],', '  "gaps": [', '    { "area": "Feature name", "description": "What needs to be built", "relevantFiles": [], "confidence": "high" }', '  ],', '  "conflicts": [', '    { "area": "Feature name", "existingBehavior": "What the code does", "specifiedBehavior": "What the spec says", "relevantFiles": ["path/to/file.ts"] }', '  ],', '  "summary": "One-paragraph overview of audit findings for this strategy"', '}', '```', '', 'Rules:', '- Every area must have a non-empty name and description', '- relevantFiles should contain actual file paths from the codebase', '- confidence: "high" = very sure, "medium" = fairly sure, "low" = uncertain', '- If no entries for a category, use an empty array []', '- Return ONLY the JSON object, nothing else');
+    return parts.join('\n');
+}
+// ============================================================================
+// Scoped audit function (per-strategy)
+// ============================================================================
+/**
+ * Run a scoped codebase audit for a single strategy.
+ *
+ * Focuses the audit on the strategy's technical context and relevant files
+ * rather than scanning the entire codebase. Best-effort: returns null on
+ * any failure so planning can proceed without it.
+ */
+export async function runScopedCodebaseAudit(worktreePath, strategy, specification, blueprint, config, governor) {
+    const prompt = buildScopedAuditPrompt(strategy, specification, blueprint);
+    let rawOutput;
+    if (governor)
+        await governor.acquireSlot('factory');
+    try {
+        const args = ['--print', '--output-format', 'json', '--verbose'];
+        const env = buildPlanningEnv(config);
+        const timeoutMs = resolveAuditTimeout(blueprint);
+        console.log(`${LOG_PREFIX} Spawning scoped audit for strategy "${strategy.name}" ` +
+            `(timeout: ${timeoutMs === null ? 'none' : `${timeoutMs / 1000}s`})...`);
+        rawOutput = await spawnAsync(config.claudeCodePath, args, {
+            input: prompt,
+            encoding: 'utf-8',
+            timeout: timeoutMs ?? undefined,
+            cwd: worktreePath,
+            env,
+        });
+    }
+    catch (err) {
+        const execErr = err;
+        if (execErr.killed || execErr.signal === 'SIGTERM') {
+            console.warn(`${LOG_PREFIX} Scoped audit for "${strategy.name}" timed out`);
+        }
+        else {
+            console.warn(`${LOG_PREFIX} Scoped audit for "${strategy.name}" failed: ${execErr.message ?? 'unknown error'}`);
+        }
+        return null;
+    }
+    finally {
+        if (governor)
+            governor.releaseSlot('factory');
+    }
+    if (!rawOutput || rawOutput.trim().length === 0) {
+        console.warn(`${LOG_PREFIX} Scoped audit for "${strategy.name}" returned empty output`);
+        return null;
+    }
+    let jsonStr;
+    try {
+        jsonStr = extractWorkPlanJson(rawOutput);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Failed to extract scoped audit JSON for "${strategy.name}": ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Scoped audit output for "${strategy.name}" is not valid JSON: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    // Normalize: AI sometimes returns a bare array instead of an object.
+    if (Array.isArray(parsedJson)) {
+        if (parsedJson.length === 1 && typeof parsedJson[0] === 'object' && parsedJson[0] !== null && !Array.isArray(parsedJson[0])) {
+            parsedJson = parsedJson[0];
+        }
+    }
+    const validation = AuditReportSchema.safeParse(parsedJson);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        const topKeys = typeof parsedJson === 'object' && parsedJson !== null ? Object.keys(parsedJson) : [];
+        console.warn(`${LOG_PREFIX} Scoped audit validation failed for "${strategy.name}": ${issues}`);
+        console.warn(`${LOG_PREFIX} Parsed object keys: [${topKeys}], preview: ${JSON.stringify(parsedJson).slice(0, 500)}`);
+        return null;
+    }
+    console.log(`${LOG_PREFIX} Scoped audit for "${strategy.name}" completed: ` +
+        `${validation.data.existingImplementations.length} existing, ` +
+        `${validation.data.partialImplementations.length} partial, ` +
+        `${validation.data.gaps.length} gaps`);
+    return validation.data;
+}
+// ============================================================================
+// Main audit function
+// ============================================================================
+/**
+ * Run a codebase audit by spawning Claude Code in --print mode.
+ *
+ * Returns a validated AuditReport on success, or null on ANY failure.
+ * This function is designed to be best-effort: it never throws and
+ * always returns null on failure so planning can proceed without it.
+ *
+ * @param worktreePath Path to the git worktree (cwd for Claude Code)
+ * @param specification The factory instance specification text
+ * @param blueprint The factory blueprint (for operational notes)
+ * @param config Factory configuration
+ * @returns Validated AuditReport or null on failure
+ */
+export async function runCodebaseAudit(worktreePath, specification, blueprint, config, governor) {
+    const prompt = buildAuditPrompt(specification, blueprint);
+    let rawOutput;
+    if (governor)
+        await governor.acquireSlot('factory');
+    try {
+        const args = ['--print', '--output-format', 'json', '--verbose'];
+        const env = buildPlanningEnv(config);
+        const timeoutMs = resolveAuditTimeout(blueprint);
+        console.log(`${LOG_PREFIX} Spawning Claude Code for codebase audit (timeout: ${timeoutMs === null ? 'none' : `${timeoutMs / 1000}s`})...`);
+        rawOutput = await spawnAsync(config.claudeCodePath, args, {
+            input: prompt,
+            encoding: 'utf-8',
+            timeout: timeoutMs ?? undefined,
+            cwd: worktreePath,
+            env,
+        });
+    }
+    catch (err) {
+        const execErr = err;
+        if (execErr.killed || execErr.signal === 'SIGTERM') {
+            const timeoutMs = resolveAuditTimeout(blueprint);
+            console.warn(`${LOG_PREFIX} Audit timed out after ${timeoutMs === null ? '?' : timeoutMs / 1000}s`);
+        }
+        else {
+            console.warn(`${LOG_PREFIX} Audit Claude Code session failed: ${execErr.message ?? 'unknown error'}`);
+        }
+        return null;
+    }
+    finally {
+        if (governor)
+            governor.releaseSlot('factory');
+    }
+    if (!rawOutput || rawOutput.trim().length === 0) {
+        console.warn(`${LOG_PREFIX} Audit returned empty output`);
+        return null;
+    }
+    // Extract and validate JSON
+    let jsonStr;
+    try {
+        jsonStr = extractWorkPlanJson(rawOutput);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Failed to extract audit JSON: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Audit output is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    // Normalize: AI sometimes returns a bare array instead of an object.
+    if (Array.isArray(parsedJson)) {
+        if (parsedJson.length === 1 && typeof parsedJson[0] === 'object' && parsedJson[0] !== null && !Array.isArray(parsedJson[0])) {
+            parsedJson = parsedJson[0];
+        }
+    }
+    const validation = AuditReportSchema.safeParse(parsedJson);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        const topKeys = typeof parsedJson === 'object' && parsedJson !== null ? Object.keys(parsedJson) : [];
+        console.warn(`${LOG_PREFIX} Audit report validation failed: ${issues}`);
+        console.warn(`${LOG_PREFIX} Parsed object keys: [${topKeys}], preview: ${JSON.stringify(parsedJson).slice(0, 500)}`);
+        return null;
+    }
+    console.log(`${LOG_PREFIX} Audit completed: ` +
+        `${validation.data.existingImplementations.length} existing, ` +
+        `${validation.data.partialImplementations.length} partial, ` +
+        `${validation.data.gaps.length} gaps, ` +
+        `${validation.data.conflicts.length} conflicts`);
+    return validation.data;
+}
+// ============================================================================
+// Report formatter
+// ============================================================================
+/**
+ * Format a validated AuditReport as human-readable markdown suitable for
+ * injection into the planning prompt.
+ *
+ * Respects the MAX_REPORT_CHARS budget to avoid blowing up the planning
+ * prompt context window.
+ */
+export function formatAuditReport(report, blueprint) {
+    const sections = [];
+    sections.push(report.summary);
+    if (report.existingImplementations.length > 0) {
+        sections.push('');
+        sections.push('### Already Implemented (no work needed)');
+        for (const entry of report.existingImplementations) {
+            sections.push(`- **${entry.area}** [${entry.confidence}]: ${entry.description}`);
+            if (entry.relevantFiles.length > 0) {
+                sections.push(`  Files: ${entry.relevantFiles.join(', ')}`);
+            }
+        }
+    }
+    if (report.partialImplementations.length > 0) {
+        sections.push('');
+        sections.push('### Partially Implemented (complete the missing parts)');
+        for (const entry of report.partialImplementations) {
+            sections.push(`- **${entry.area}** [${entry.confidence}]: ${entry.description}`);
+            if (entry.relevantFiles.length > 0) {
+                sections.push(`  Files: ${entry.relevantFiles.join(', ')}`);
+            }
+        }
+    }
+    if (report.gaps.length > 0) {
+        sections.push('');
+        sections.push('### Gaps (needs building from scratch)');
+        for (const entry of report.gaps) {
+            sections.push(`- **${entry.area}** [${entry.confidence}]: ${entry.description}`);
+            if (entry.relevantFiles.length > 0) {
+                sections.push(`  Files: ${entry.relevantFiles.join(', ')}`);
+            }
+        }
+    }
+    if (report.conflicts.length > 0) {
+        sections.push('');
+        sections.push('### Conflicts (existing code contradicts specification)');
+        for (const conflict of report.conflicts) {
+            sections.push(`- **${conflict.area}**`);
+            sections.push(`  Existing: ${conflict.existingBehavior}`);
+            sections.push(`  Specified: ${conflict.specifiedBehavior}`);
+            if (conflict.relevantFiles.length > 0) {
+                sections.push(`  Files: ${conflict.relevantFiles.join(', ')}`);
+            }
+        }
+    }
+    let formatted = sections.join('\n');
+    // Truncate if over budget (null = no limit)
+    const maxChars = resolveAuditMaxReportChars(blueprint);
+    if (maxChars !== null && formatted.length > maxChars) {
+        const truncationNote = '\n\n[Audit report truncated due to size constraints]';
+        formatted = formatted.slice(0, maxChars - truncationNote.length) + truncationNote;
+    }
+    return formatted;
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/builder-completion.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Builder completion handling and main execution cycle.
+ *
+ * Handles builder session completion (token accounting, status transitions),
+ * and orchestrates the main execution cycle that finds ready work units,
+ * spawns builders, tracks strategy progress, and detects global completion.
+ *
+ * Extracted from execution.ts for focused module boundaries.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { FactoryConfig, FactoryInstanceState, BuilderState } from './types.js';
+/**
+ * Handle builder session completion.
+ *
+ * Routes the result through the gate engine (stubbed for now), then:
+ * - On gate pass: marks work unit completed, unblocks dependents
+ * - On gate fail + retries remaining: feeds output back, increments iteration
+ * - On gate fail + retries exhausted: marks work unit failed, escalates
+ */
+export declare function handleBuilderCompletion(builder: BuilderState, exitCode: number, state: FactoryInstanceState, _config: FactoryConfig, _governor?: ResourceGovernor | null): Promise<void>;
+/**
+ * Run a single execution cycle for a factory instance.
+ *
+ * This is the main orchestration loop called by the instance lifecycle
+ * manager during the "building" phase:
+ *
+ *   1. Fetch current work units from DB
+ *   2. Reconcile orphaned builders and stuck work units
+ *   3. Find work units with all dependencies satisfied
+ *   4. Spawn builders for ready units (skip if already active)
+ *   5. Track strategy progress transitions
+ *   6. Detect global completion (all units completed or failed)
+ */
+export declare function runExecutionCycle(state: FactoryInstanceState, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<void>;
+//# sourceMappingURL=builder-completion.d.ts.map

package/dist/builder-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-completion.d.ts","sourceRoot":"","sources":["../src/builder-completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,EAGb,MAAM,YAAY,CAAC;AAoBpB;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAClC,OAAO,CAAC,IAAI,CAAC,CAkFf;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC,CA2Ff"}