@telora/factory 0.4.5

package/dist/remediation-units.js

@@ -0,0 +1,263 @@
+/**
+ * Remediation unit generation for factory re-planning.
+ *
+ * Generates new work units to address detected gaps after a build cycle
+ * fails the completion gate. Contains:
+ *   - Re-planning prompt builder (original spec + fresh audit + cycle history)
+ *   - Re-planning phase orchestrator (audit, plan generation, unit creation)
+ */
+import { generateFactorySOP } from './sop-generator.js';
+import { runCodebaseAudit, formatAuditReport } from './audit.js';
+import { generateAndValidateWorkPlan, buildRetryPrompt, mapTempIdsToUuids, } from './planning.js';
+import { getCycleEvaluations } from './queries/cycle-evaluations.js';
+import { getInstanceWorkUnits, createWorkUnits } from './queries/work-units.js';
+import { updateStrategyExecutionStatus } from './queries/strategies.js';
+import { formatGateContext } from './gate-context.js';
+import { formatPriorCycleContext, matchWorkUnitToStrategy } from './gap-detection.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum number of retry attempts for re-plan generation. */
+const MAX_REPLANNING_RETRIES = 2;
+/** Log prefix for this module. */
+const LOG_PREFIX = '[replanning]';
+// ============================================================================
+// Re-planning prompt builder (TEL-3)
+// ============================================================================
+/**
+ * Build the re-planning prompt that instructs Claude Code to generate work
+ * units for remaining gaps in a multi-cycle factory run.
+ *
+ * Key differences from buildPlanningPrompt():
+ * - Explicitly states this is iteration N (not a fresh start)
+ * - Includes prior cycle evaluation history
+ * - Includes a fresh codebase audit against the current state
+ * - Instructs the planner to only generate work for remaining gaps
+ */
+export function buildReplanningPrompt(specification, blueprint, auditReport, priorCycleContext, cycleNumber, gateContext) {
+    const parts = [
+        'You are a re-planning agent for a software factory system.',
+        `This is ITERATION ${cycleNumber} of a multi-cycle factory run.`,
+        'Previous cycles have already built and committed code. Your task is to analyze',
+        'what is STILL MISSING and generate work units ONLY for remaining gaps.',
+        '',
+        '## Blueprint',
+        `Name: ${blueprint.name}`,
+    ];
+    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 generate work units that would remove or modify items', 'covered by these requirements, even if the specification appears to prohibit them.', '', blueprint.specConstraints);
+    }
+    // Resource limits
+    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);
+    }
+    // Pipeline SOP (generated from promise contracts)
+    const sop = generateFactorySOP(blueprint.pipelineGraph);
+    if (sop) {
+        parts.push('', sop);
+    }
+    parts.push('', '## Original Specification', specification);
+    // Prior cycle history (evaluations + completed work)
+    if (priorCycleContext) {
+        parts.push('', priorCycleContext);
+    }
+    // Fresh audit results
+    if (auditReport) {
+        parts.push('', '## Fresh Codebase Audit (current state)', '', 'The following audit was performed against the CURRENT codebase state,', 'which includes all code committed by prior cycles.', '', auditReport);
+    }
+    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 generate work units for gate verification, build validation, typecheck,', 'lint, or test execution -- these are handled by the factory infrastructure.');
+    parts.push('', '## Instructions', '', `This is iteration ${cycleNumber}. Prior cycles have already built code and committed it.`, 'The completion gate evaluated each cycle and found remaining gaps (listed above).', 'A fresh codebase audit has been performed against the current state.', '', 'Your task:', '1. Review the original specification', '2. Review what prior cycles built and what gaps the completion gate found', '3. Review the fresh codebase audit to understand what currently exists', '4. Generate work units ONLY for what is STILL MISSING', '', 'CRITICAL RULES:', '- Do NOT duplicate work that prior cycles already completed', '- Do NOT create work units for features the fresh audit shows as already implemented', '- Focus on UNIMPLEMENTED FUNCTIONAL REQUIREMENTS from the specification', '- If the fresh audit contradicts the gate evaluation, trust the fresh audit', '- Each work unit should represent a distinct functional capability the specification requires', '- Each work unit is something to BUILD. Writing and running tests is part of implementing', '  a feature, not a separate deliverable. Do NOT create work units whose sole purpose is', '  to run tests, confirm builds succeed, or verify commands execute.', '- Do NOT create work units for test coverage, type safety, build validity, or', '  runtime behavioral testing -- these are validated by the factory gate system,', '  not by work units. If the gates passed, those dimensions are already verified.', '', '## 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 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');
+}
+// ============================================================================
+// Re-planning phase orchestrator (TEL-4)
+// ============================================================================
+/**
+ * Run a full re-planning phase for a factory instance.
+ *
+ * This is the fresh-context equivalent of runPlanningPhase() but skips
+ * worktree/branch creation (already exists from cycle 1). Steps:
+ * 1. Fetch all prior cycle evaluations
+ * 2. Fetch all work units, filter to completed
+ * 3. Run fresh codebase audit against current worktree state
+ * 4. Format prior cycle context
+ * 5. Build re-planning prompt
+ * 6. Generate and validate work plan (with retries)
+ * 7. Map tempIds to UUIDs and create work units with correct cycle_number
+ */
+export async function runReplanningPhase(state, config, governor) {
+    const cycleNumber = state.completionGateIterations + 1;
+    console.log(`${LOG_PREFIX} Starting re-planning phase for instance ${state.instanceId} ` +
+        `(cycle ${cycleNumber})`);
+    // Guard: must have worktree and specification
+    if (!state.worktreePath || !state.specification) {
+        const error = 'Missing worktree path or specification for re-planning';
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    // Step 1: Fetch prior cycle evaluations
+    let evaluations;
+    try {
+        evaluations = await getCycleEvaluations(state.instanceId);
+        console.log(`${LOG_PREFIX} Fetched ${evaluations.length} prior cycle evaluation(s)`);
+    }
+    catch (err) {
+        const error = `Failed to fetch cycle evaluations: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    // Step 2: Fetch completed work units
+    let allWorkUnits;
+    try {
+        allWorkUnits = await getInstanceWorkUnits(state.instanceId);
+    }
+    catch (err) {
+        const error = `Failed to fetch work units: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    const completedUnits = allWorkUnits.filter((wu) => wu.status === 'completed' && !wu.infrastructureOwned);
+    console.log(`${LOG_PREFIX} ${completedUnits.length} completed work unit(s) from prior cycles`);
+    // Step 3: Run fresh codebase audit (best-effort)
+    let auditReportText = null;
+    try {
+        const auditReport = await runCodebaseAudit(state.worktreePath, state.specification, state.blueprint, config, governor);
+        if (auditReport) {
+            auditReportText = formatAuditReport(auditReport, state.blueprint);
+            console.log(`${LOG_PREFIX} Fresh audit completed: ` +
+                `${auditReport.existingImplementations.length} existing, ` +
+                `${auditReport.partialImplementations.length} partial, ` +
+                `${auditReport.gaps.length} gaps`);
+        }
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} Fresh audit failed (non-fatal): ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Step 4: Format prior cycle context
+    const priorContext = formatPriorCycleContext(evaluations, completedUnits);
+    // Step 5: Build re-planning prompt -- include gate context so planner doesn't create
+    // work units for dimensions the gate layer already validates
+    const gateContext = formatGateContext(state.blueprint);
+    const originalPrompt = buildReplanningPrompt(state.specification, state.blueprint, auditReportText, priorContext, cycleNumber, gateContext);
+    // Step 6: Generate and validate work plan (with retries)
+    let currentPrompt = originalPrompt;
+    let workPlan = null;
+    let lastError = '';
+    for (let attempt = 0; attempt <= MAX_REPLANNING_RETRIES; attempt++) {
+        if (attempt > 0) {
+            console.log(`${LOG_PREFIX} Retry ${attempt}/${MAX_REPLANNING_RETRIES} -- previous error: ${lastError}`);
+            currentPrompt = buildRetryPrompt(originalPrompt, lastError);
+        }
+        if (governor)
+            await governor.acquireSlot('factory');
+        let planResult;
+        try {
+            planResult = await generateAndValidateWorkPlan(currentPrompt, config, state.worktreePath, state.blueprint);
+        }
+        finally {
+            if (governor)
+                governor.releaseSlot('factory');
+        }
+        if (planResult.success) {
+            workPlan = planResult.workPlan;
+            if (attempt > 0) {
+                console.log(`${LOG_PREFIX} Re-plan generation succeeded on retry ${attempt}`);
+            }
+            break;
+        }
+        lastError = planResult.error;
+        console.error(`${LOG_PREFIX} Re-plan generation attempt ${attempt + 1} failed: ${lastError}`);
+    }
+    if (workPlan === null) {
+        const error = `Re-plan generation failed after ${MAX_REPLANNING_RETRIES + 1} attempt(s): ${lastError}`;
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    // Check maxWorkUnits limit including existing units
+    if (state.blueprint.maxWorkUnits !== null) {
+        const totalAfter = allWorkUnits.length + workPlan.workUnits.length;
+        if (totalAfter > state.blueprint.maxWorkUnits) {
+            const error = `Re-plan would create ${workPlan.workUnits.length} work units, ` +
+                `but total (${allWorkUnits.length} existing + ${workPlan.workUnits.length} new) ` +
+                `exceeds maxWorkUnits limit (${state.blueprint.maxWorkUnits})`;
+            console.warn(`${LOG_PREFIX} ${error}`);
+            return { success: false, error, workUnitsCreated: 0 };
+        }
+    }
+    // Step 7: Fetch strategies for strategy-aware tagging (best-effort)
+    let strategies = [];
+    try {
+        const { getStrategiesByFactoryInstance } = await import('./strategy-design.js');
+        strategies = await getStrategiesByFactoryInstance(state.instanceId);
+    }
+    catch {
+        // Non-fatal: re-planning works without strategy tagging
+    }
+    // Step 8: Map tempIds to UUIDs and create work units
+    const maxSortOrder = allWorkUnits.reduce((max, wu) => Math.max(max, wu.sortOrder), -1);
+    let mappedUnits;
+    try {
+        mappedUnits = mapTempIdsToUuids(workPlan.workUnits).map((u, i) => ({
+            ...u,
+            sortOrder: maxSortOrder + 1 + i,
+            cycleNumber,
+            strategyId: matchWorkUnitToStrategy(u.title, u.description, strategies),
+        }));
+    }
+    catch (err) {
+        const error = `Failed to map tempIds to UUIDs: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    let created;
+    try {
+        created = await createWorkUnits(state.instanceId, mappedUnits);
+        console.log(`${LOG_PREFIX} Re-planning cycle ${cycleNumber}: created ${created.length} work unit(s)`);
+    }
+    catch (err) {
+        const error = `Failed to create work units: ${err instanceof Error ? err.message : String(err)}`;
+        console.error(`${LOG_PREFIX} ${error}`);
+        return { success: false, error, workUnitsCreated: 0 };
+    }
+    // Reset only the strategies that received new work units back to 'pending'
+    // so the scheduler picks them up. Strategies with no new work assigned
+    // stay completed -- resetting them would cause unnecessary re-execution.
+    const assignedStrategyIds = new Set(mappedUnits
+        .map((u) => u.strategyId)
+        .filter((id) => id !== undefined));
+    if (assignedStrategyIds.size > 0 && strategies.length > 0) {
+        const toReset = strategies.filter((s) => assignedStrategyIds.has(s.id) && s.executionStatus === 'completed');
+        if (toReset.length > 0) {
+            await Promise.all(toReset.map((s) => updateStrategyExecutionStatus(s.id, 'pending')));
+            console.log(`${LOG_PREFIX} Reset ${toReset.length} strategy/strategies to 'pending' ` +
+                `for re-planning cycle ${cycleNumber}`);
+        }
+    }
+    return { success: true, workUnitsCreated: created.length };
+}
+//# sourceMappingURL=remediation-units.js.map

package/dist/remediation-units.js.map

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

package/dist/replanning.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Fresh context re-planning module.
+ *
+ * When the completion gate finds critical gaps after a build cycle, this
+ * module orchestrates a full re-planning cycle with fresh context:
+ * 1. Fetch prior cycle evaluations and completed work units
+ * 2. Run a fresh codebase audit against the current worktree state
+ * 3. Format prior cycle history as concise context
+ * 4. Build a re-planning prompt (original spec + fresh audit + cycle history)
+ * 5. Generate and validate a new work plan in a fresh Claude Code session
+ * 6. Create work units with the correct cycle_number
+ *
+ * This replaces the shallow gap-to-work-unit approach of
+ * generateRemediationWorkUnits() with full-context AI reasoning.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { FactoryBlueprint, FactoryConfig, FactoryCycleEvaluation, FactoryInstanceState, FactoryWorkUnit } from './types.js';
+/**
+ * Filter completion gate gaps to only include those describing absent
+ * functional capabilities. Strips verification-related gaps (test execution,
+ * build confirmation, etc.) that are not spec requirements.
+ */
+export declare function filterFunctionalGaps(gaps: Array<{
+    area: string;
+    description: string;
+    severity: string;
+}>): Array<{
+    area: string;
+    description: string;
+    severity: string;
+}>;
+/**
+ * Format prior cycle evaluations and completed work units into a concise
+ * markdown string for injection into the re-planning prompt.
+ *
+ * Rules:
+ * - Work unit descriptions truncated to ~100 chars to save context
+ * - Only completed work units included (not failed/pending)
+ * - Gap descriptions kept in full (they are the signal for what is missing)
+ * - Total output capped at MAX_PRIOR_CONTEXT_CHARS
+ */
+export declare function formatPriorCycleContext(evaluations: FactoryCycleEvaluation[], completedWorkUnits: FactoryWorkUnit[]): string;
+/**
+ * Build the re-planning prompt that instructs Claude Code to generate work
+ * units for remaining gaps in a multi-cycle factory run.
+ *
+ * Key differences from buildPlanningPrompt():
+ * - Explicitly states this is iteration N (not a fresh start)
+ * - Includes prior cycle evaluation history
+ * - Includes a fresh codebase audit against the current state
+ * - Instructs the planner to only generate work for remaining gaps
+ */
+export declare function buildReplanningPrompt(specification: string, blueprint: FactoryBlueprint, auditReport: string | null, priorCycleContext: string, cycleNumber: number, gateContext?: string): string;
+/**
+ * Run a full re-planning phase for a factory instance.
+ *
+ * This is the fresh-context equivalent of runPlanningPhase() but skips
+ * worktree/branch creation (already exists from cycle 1). Steps:
+ * 1. Fetch all prior cycle evaluations
+ * 2. Fetch all work units, filter to completed
+ * 3. Run fresh codebase audit against current worktree state
+ * 4. Format prior cycle context
+ * 5. Build re-planning prompt
+ * 6. Generate and validate work plan (with retries)
+ * 7. Map tempIds to UUIDs and create work units with correct cycle_number
+ */
+export declare function runReplanningPhase(state: FactoryInstanceState, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<{
+    success: boolean;
+    error?: string;
+    workUnitsCreated: number;
+}>;
+//# sourceMappingURL=replanning.d.ts.map

package/dist/replanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replanning.d.ts","sourceRoot":"","sources":["../src/replanning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAa5D,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EAEhB,MAAM,YAAY,CAAC;AA6CpB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAUhE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,sBAAsB,EAAE,EACrC,kBAAkB,EAAE,eAAe,EAAE,GACpC,MAAM,CA6DR;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAqJR;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAqNzE"}