@telora/factory 0.4.5

package/dist/completion-gate.js

@@ -0,0 +1,336 @@
+/**
+ * Instance-level completion gate.
+ *
+ * Runs after ALL work units are completed but BEFORE the instance transitions
+ * to 'completed'. An AI reviewer evaluates the full specification against
+ * the entire codebase diff and determines whether everything is actually done.
+ *
+ * On failure, gaps are converted to remediation work units and the instance
+ * goes back to 'building'.
+ */
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { buildPlanningEnv, extractWorkPlanJson } from './planning.js';
+import { formatGateContext } from './gate-context.js';
+import { spawnAsync } from './process-runner.js';
+import { runGit } from './git-factory.js';
+import { createWorkUnits, getInstanceWorkUnits } from './queries/work-units.js';
+import { resolveTraceChecks, runTraceChecks, formatTraceOutput } from './trace-engine.js';
+import { generateFactorySOP } from './sop-generator.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Timeout for the completion gate Claude Code session (5 minutes). */
+const GATE_TIMEOUT_MS = 300_000;
+/** Maximum diff size in characters before truncation. */
+const MAX_DIFF_CHARS = 50_000;
+/** Log prefix for this module. */
+const LOG_PREFIX = '[completion-gate]';
+// ============================================================================
+// Zod schemas
+// ============================================================================
+const CompletionGapSchema = z.object({
+    area: z.string().min(1),
+    description: z.string().min(1),
+    severity: z.enum(['critical', 'important']),
+    suggestedFix: z.string().min(1),
+});
+const CompletionGateResultSchema = z.object({
+    passed: z.boolean(),
+    confidence: z.enum(['high', 'medium', 'low']),
+    summary: z.string().min(1),
+    gaps: z.array(CompletionGapSchema),
+    suggestions: z.array(z.string()),
+});
+// ============================================================================
+// Diff generator
+// ============================================================================
+/**
+ * Generate the full diff between the factory branch and main.
+ *
+ * Includes a stat summary header followed by the full diff.
+ * Truncates to MAX_DIFF_CHARS to avoid blowing up the review prompt.
+ */
+export function generateInstanceDiff(worktreePath, branchName) {
+    // Get stat summary
+    const statResult = runGit(['diff', `main...${branchName}`, '--stat'], worktreePath);
+    // Get full diff
+    const diffResult = runGit(['diff', `main...${branchName}`], worktreePath);
+    const stat = statResult.success ? statResult.output : '[stat unavailable]';
+    const diff = diffResult.success ? diffResult.output : '';
+    if (!diff) {
+        return '[No changes detected between factory branch and main]';
+    }
+    let combined = `## Diff Summary\n${stat}\n\n## Full Diff\n${diff}`;
+    if (combined.length > MAX_DIFF_CHARS) {
+        combined =
+            combined.slice(0, MAX_DIFF_CHARS) +
+                `\n\n[diff truncated at ${MAX_DIFF_CHARS} chars -- review codebase directly for full changes]`;
+    }
+    return combined;
+}
+export { formatGateContext } from './gate-context.js';
+// ============================================================================
+// Review prompt builder
+// ============================================================================
+/**
+ * Build the prompt for the completion gate AI reviewer.
+ */
+export function buildCompletionReviewPrompt(specification, blueprint, workUnits, diffText, strategies, gateContext) {
+    const parts = [
+        'You are a completion reviewer for a software factory system.',
+        'Your task is to identify any requirement described in the specification that has',
+        'no corresponding implementation in the diff.',
+        '',
+        '## Specification',
+        specification,
+    ];
+    if (blueprint.operationalNotes) {
+        parts.push('', '## Operational Notes', blueprint.operationalNotes);
+    }
+    // Pipeline SOP (generated from promise contracts)
+    const sop = generateFactorySOP(blueprint.pipelineGraph);
+    if (sop) {
+        parts.push('', sop);
+    }
+    // Strategy-aware work unit summary
+    if (strategies && strategies.length > 0) {
+        parts.push('', '## Strategies and Work Units');
+        const sorted = [...strategies].sort((a, b) => a.priorityRank - b.priorityRank);
+        for (const s of sorted) {
+            parts.push(``, `### Strategy: ${s.name}`);
+            if (s.description)
+                parts.push(s.description);
+            const strategyUnits = workUnits.filter((wu) => wu.strategyId === s.id && !wu.infrastructureOwned);
+            if (strategyUnits.length > 0) {
+                parts.push('', 'Work units:');
+                for (const wu of strategyUnits) {
+                    parts.push(`- ${wu.title} (${wu.iterationCount} iteration(s)): ${wu.description ?? 'No description'}`);
+                }
+            }
+        }
+        // Include any orphan work units (no strategy)
+        const orphans = workUnits.filter((wu) => !wu.strategyId && !wu.infrastructureOwned);
+        if (orphans.length > 0) {
+            parts.push('', '### Unscoped Work Units');
+            for (const wu of orphans) {
+                parts.push(`- ${wu.title} (${wu.iterationCount} iteration(s)): ${wu.description ?? 'No description'}`);
+            }
+        }
+    }
+    else {
+        // Legacy: flat work unit summary
+        parts.push('', '## Work Units Completed');
+        const agentUnits = workUnits.filter(wu => !wu.infrastructureOwned);
+        for (const wu of agentUnits) {
+            parts.push(`- ${wu.title} (${wu.iterationCount} iteration(s)): ${wu.description ?? 'No description'}`);
+        }
+    }
+    parts.push('', '## Changes Made', diffText);
+    if (gateContext) {
+        parts.push('', gateContext);
+    }
+    // Infrastructure gate ownership context
+    parts.push('', '## Infrastructure-Owned Gate Verification', '', 'The factory engine pre-creates a "Gate verification" work unit per strategy.', 'This unit is infrastructure-owned and resolved automatically by the gate engine.', 'Do NOT flag missing gate verification, build validation, typecheck, lint, or', 'test execution work units as gaps -- these are handled by factory infrastructure.');
+    parts.push('', '## Instructions', '', 'For each requirement described in the specification, check whether there is evidence', 'of a corresponding implementation in the diff. If evidence exists, the requirement is', 'implemented. If no evidence exists anywhere in the diff, it is a gap.', '', 'A gap is only valid if:', '1. A specific capability is described in the specification, AND', '2. Nothing in the diff implements it', '', 'Do NOT assess whether the implementation is thorough, well-tested, or high quality --', 'gates already answered those questions. Your only job is spec requirement presence.', '', 'For each gap found:', '- Classify as "critical" (a spec requirement with no implementation) or "important" (partially addressed)', '- Provide a specific suggested fix description', '', '## Output Format', 'Return ONLY a JSON object (no markdown fencing, no commentary):', '```', '{', '  "passed": true/false,', '  "confidence": "high" | "medium" | "low",', '  "summary": "Overall assessment of spec requirement coverage",', '  "gaps": [', '    {', '      "area": "The spec requirement that is absent",', '      "description": "What the spec says and why nothing in the diff addresses it",', '      "severity": "critical" | "important",', '      "suggestedFix": "How to fix it"', '    }', '  ],', '  "suggestions": ["Optional non-blocking improvements"]', '}', '```', '', 'Rules:', '- Set "passed" to true ONLY if every spec requirement has corresponding implementation in the diff', '- If there are critical gaps (spec requirements with no implementation), "passed" must be false', '- Important gaps alone do not force "passed" to false (use judgment)', '- Return ONLY the JSON object, nothing else');
+    return parts.join('\n');
+}
+// ============================================================================
+// Main gate function
+// ============================================================================
+/**
+ * Run the instance-level completion gate.
+ *
+ * Spawns Claude Code in --print mode to review the full diff against
+ * the specification. Returns a validated CompletionGateResult or null
+ * on any failure.
+ *
+ * @param state The factory instance state (needs worktreePath, branchName, specification, blueprint)
+ * @param config Factory configuration
+ * @param workUnits All work units for the instance (for context)
+ * @returns Validated CompletionGateResult or null on failure
+ */
+export async function runCompletionGate(state, config, workUnits, governor) {
+    if (!state.worktreePath || !state.branchName || !state.specification) {
+        console.warn(`${LOG_PREFIX} Missing worktree/branch/spec on instance ${state.instanceId}`);
+        return null;
+    }
+    // Step 1: Run trace checks (deterministic, fast) -- short-circuits AI review on failure
+    if (state.blueprint.traceChecks.length > 0) {
+        const resolved = resolveTraceChecks(state.blueprint.traceChecks);
+        if (resolved.length > 0) {
+            console.log(`${LOG_PREFIX} Running ${resolved.length} trace check(s) before AI review...`);
+            const traceResults = await runTraceChecks(resolved, state.worktreePath);
+            const traceFailed = traceResults.filter((r) => !r.passed);
+            if (traceFailed.length > 0) {
+                console.log(`${LOG_PREFIX} ${traceFailed.length} trace check(s) failed -- skipping AI review`);
+                return {
+                    passed: false,
+                    confidence: 'high',
+                    summary: `${traceFailed.length} cross-boundary dependency trace(s) failed`,
+                    gaps: traceFailed.map((t) => ({
+                        area: t.checkName,
+                        description: formatTraceOutput(t),
+                        severity: 'critical',
+                        suggestedFix: t.missingTargets.length > 0
+                            ? `Add missing targets: ${t.missingTargets.map((m) => m.value).join(', ')}`
+                            : 'Fix the trace check errors',
+                    })),
+                    suggestions: [],
+                };
+            }
+            console.log(`${LOG_PREFIX} All trace checks passed`);
+        }
+    }
+    // Step 2: Generate diff and run AI review
+    console.log(`${LOG_PREFIX} Generating instance diff for ${state.branchName}...`);
+    const diffText = generateInstanceDiff(state.worktreePath, state.branchName);
+    // Fetch strategies for strategy-aware review prompt
+    let strategies;
+    const hasStrategies = workUnits.some((wu) => wu.strategyId !== null);
+    if (hasStrategies) {
+        try {
+            const { getStrategiesByFactoryInstance } = await import('./strategy-design.js');
+            strategies = await getStrategiesByFactoryInstance(state.instanceId);
+        }
+        catch {
+            // Non-fatal: proceed without strategy context
+        }
+    }
+    // Build prompt -- include gate context so the reviewer knows what was already validated
+    const gateContext = formatGateContext(state.blueprint);
+    const prompt = buildCompletionReviewPrompt(state.specification, state.blueprint, workUnits, diffText, strategies, gateContext);
+    // Spawn Claude Code
+    let rawOutput;
+    if (governor)
+        await governor.acquireSlot('factory');
+    try {
+        const args = ['--print', '--output-format', 'json', '--verbose'];
+        const env = buildPlanningEnv(config);
+        console.log(`${LOG_PREFIX} Spawning Claude Code for completion review...`);
+        rawOutput = await spawnAsync(config.claudeCodePath, args, {
+            input: prompt,
+            encoding: 'utf-8',
+            timeout: GATE_TIMEOUT_MS,
+            cwd: state.worktreePath,
+            env,
+        });
+    }
+    catch (err) {
+        const execErr = err;
+        if (execErr.killed || execErr.signal === 'SIGTERM') {
+            console.warn(`${LOG_PREFIX} Completion review timed out after ${GATE_TIMEOUT_MS / 1000}s`);
+        }
+        else {
+            console.warn(`${LOG_PREFIX} Completion review failed: ${execErr.message ?? 'unknown error'}`);
+        }
+        return null;
+    }
+    finally {
+        if (governor)
+            governor.releaseSlot('factory');
+    }
+    if (!rawOutput || rawOutput.trim().length === 0) {
+        console.warn(`${LOG_PREFIX} Completion review returned empty output`);
+        return null;
+    }
+    // Extract and validate JSON
+    let jsonStr;
+    try {
+        jsonStr = extractWorkPlanJson(rawOutput);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Failed to extract JSON: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} 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 = CompletionGateResultSchema.safeParse(parsedJson);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        console.warn(`${LOG_PREFIX} Validation failed: ${issues}`);
+        return null;
+    }
+    const result = validation.data;
+    console.log(`${LOG_PREFIX} Completion review: ${result.passed ? 'PASSED' : 'FAILED'} ` +
+        `(confidence: ${result.confidence}, gaps: ${result.gaps.length})`);
+    return result;
+}
+// ============================================================================
+// Remediation work unit generation
+// ============================================================================
+/**
+ * Convert critical completion gate gaps into remediation work units.
+ *
+ * Only critical-severity gaps produce new work units. Important gaps are
+ * logged but not auto-remediated. If generating remediation units would
+ * exceed the blueprint's maxWorkUnits limit, no units are created and
+ * the function returns an empty array (caller should escalate).
+ *
+ * @param state The factory instance state
+ * @param gateResult The completion gate result with gaps
+ * @returns Array of created work units (empty if none needed or limit exceeded)
+ */
+export async function generateRemediationWorkUnits(state, gateResult) {
+    const criticalGaps = gateResult.gaps.filter((g) => g.severity === 'critical');
+    if (criticalGaps.length === 0) {
+        // No critical gaps -- all gaps are 'important' (informational)
+        if (gateResult.gaps.length > 0) {
+            console.log(`${LOG_PREFIX} ${gateResult.gaps.length} important gap(s) noted but not auto-remediated`);
+        }
+        return [];
+    }
+    // Check maxWorkUnits limit
+    if (state.blueprint.maxWorkUnits !== null) {
+        const existingUnits = await getInstanceWorkUnits(state.instanceId);
+        if (existingUnits.length + criticalGaps.length > state.blueprint.maxWorkUnits) {
+            console.warn(`${LOG_PREFIX} Cannot create ${criticalGaps.length} remediation units: ` +
+                `would exceed maxWorkUnits (${existingUnits.length} existing + ` +
+                `${criticalGaps.length} new > ${state.blueprint.maxWorkUnits} limit)`);
+            return [];
+        }
+    }
+    // Build remediation work unit definitions
+    const existingUnits = await getInstanceWorkUnits(state.instanceId);
+    const maxSortOrder = existingUnits.reduce((max, wu) => Math.max(max, wu.sortOrder), -1);
+    const units = criticalGaps.map((gap, i) => ({
+        id: randomUUID(),
+        title: `[Remediation] ${gap.area}`,
+        description: [
+            '## Completion Gate Remediation',
+            '',
+            'The completion gate identified this gap after all initial work units were completed.',
+            '',
+            `### Gap: ${gap.area}`,
+            gap.description,
+            '',
+            '### Suggested Fix',
+            gap.suggestedFix,
+            '',
+            '### Context',
+            'This work unit was auto-generated by the completion gate. The original specification',
+            'and all prior work units have been completed. Focus specifically on addressing this gap.',
+        ].join('\n'),
+        sortOrder: maxSortOrder + 1 + i,
+        blockedBy: [],
+        cycleNumber: state.completionGateIterations + 1,
+    }));
+    const created = await createWorkUnits(state.instanceId, units);
+    console.log(`${LOG_PREFIX} Created ${created.length} remediation work unit(s) from completion gate gaps`);
+    return created;
+}
+//# sourceMappingURL=completion-gate.js.map

package/dist/completion-gate.js.map

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

package/dist/completion-report.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Factory instance completion report generation.
+ *
+ * After the final completion gate passes, this module generates a structured
+ * keep/stop/change retrospective. The AI produces the retrospective analysis;
+ * execution metrics are computed from instance state and injected separately.
+ *
+ * Pattern: same one-shot Claude Code --print invocation used by planning,
+ * strategy design, and completion gate modules.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { ExecutionMetrics, FactoryCompletionReport, FactoryConfig, FactoryCycleEvaluation, FactoryGateResult, FactoryInstanceState, FactoryWorkUnit } from './types.js';
+import type { PersistedStrategy } from './strategy-design.js';
+/**
+ * Build the prompt for the completion report AI.
+ *
+ * Includes full factory run context: original spec, cycle evaluations,
+ * gate results, work unit outcomes, and strategy outcomes.
+ */
+export declare function buildCompletionReportPrompt(specification: string, cycleEvaluations: FactoryCycleEvaluation[], workUnits: FactoryWorkUnit[], gateResults: FactoryGateResult[], strategies?: PersistedStrategy[]): string;
+/**
+ * Compute execution metrics from instance state and fetched data.
+ * These are factual numbers, not AI-generated.
+ */
+export declare function computeExecutionMetrics(state: FactoryInstanceState, workUnits: FactoryWorkUnit[], gateResults: FactoryGateResult[], cycleEvaluations: FactoryCycleEvaluation[]): ExecutionMetrics;
+/**
+ * Generate a structured completion report for a factory instance.
+ *
+ * Spawns Claude Code in --print mode to produce the retrospective,
+ * then merges in computed execution metrics.
+ *
+ * Returns null on failure -- report generation should never block
+ * instance completion.
+ */
+export declare function generateCompletionReport(state: FactoryInstanceState, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<FactoryCompletionReport | null>;
+//# sourceMappingURL=completion-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../src/completion-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAwD9D;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,sBAAsB,EAAE,EAC1C,SAAS,EAAE,eAAe,EAAE,EAC5B,WAAW,EAAE,iBAAiB,EAAE,EAChC,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAC/B,MAAM,CAkJR;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,eAAe,EAAE,EAC5B,WAAW,EAAE,iBAAiB,EAAE,EAChC,gBAAgB,EAAE,sBAAsB,EAAE,GACzC,gBAAgB,CAqBlB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAsIzC"}