@llm-dev-ops/agentics-cli 2.7.36 → 2.7.38

package/dist/pipeline/auto-chain.js

@@ -26,7 +26,6 @@ import { detectExecutionMode, commitScenarioFiles, } from './execution-context.j
 import { initSwarm, dispatchPhaseAgents, storePhaseArtifacts, reviewPhaseOutput, recordPhaseFailure, shutdownSwarm, invokeRufloCodingSwarm, PHASE_AGENTS, } from './swarm-orchestrator.js';
 import { executeRufloPhaseSwarm, buildPhase2Tasks, buildPhase3Tasks, buildPhase4Tasks, buildPhase5Tasks, buildPhase6Tasks, collectPhase2Artifacts, collectPhase3Artifacts, collectPhase4Artifacts, collectPhase5Artifacts, collectPhase6Artifacts, extractPhase1AgentCode, runPrimaryPhaseExecution, } from './ruflo-phase-executor.js';
 import { gatePhaseInputs, determineBlockedPhases, } from './gate/phase-dependency-gate.js';
-import { pipelineHeartbeat } from '../cli/ui/heartbeat.js';
 /** Extract path strings from any manifest artifact array (objects with .path or plain strings). */
 function extractArtifactPaths(artifacts) {
     return artifacts.map(a => typeof a === 'string' ? a : a.path);
@@ -2358,7 +2357,7 @@ async function ensureAdrsExist(runDir, traceId, scenarioQuery) {
     console.error('');
     console.error('  [ADR-028] No ADRs found — generating guaranteed set');
     try {
-        const { buildPhase2ADRs } = await import('./phase2/phases/adr-generator.js');
+        const { buildLoudFailureADR } = await import('./phase2/phases/adr-generator.js');
         const { buildPhase2DDD } = await import('./phase2/phases/ddd-generator.js');
         // Load SPARC/dossier from any available location, or use empty defaults
         let sparc = { architecture: { services: [] }, specification: { requirements: [], constraints: [] } };
@@ -2383,9 +2382,17 @@ async function ensureAdrsExist(runDir, traceId, scenarioQuery) {
                 catch { /* skip */ }
             }
         }
-        const adrs = buildPhase2ADRs(sparc, dossier, scenarioQuery, true /* skipLLM */);
-        if (adrs.length === 0)
-            return;
+        // ADR-PIPELINE-100 §D5: ADR-028 guarantee path emits a loud-failure ADR
+        // directly rather than calling the LLM. By the time we reach this branch
+        // Phase 4 has already run (or been skipped); the LLM pass would either
+        // duplicate Phase 4's work or block the guarantee path on a 30-min cap.
+        const adrs = [buildLoudFailureADR({
+                reason: 'ADR-028 guarantee path: no usable ADRs found anywhere in the run after Phase 4 completed/skipped. This failure ADR is written to satisfy the "always emit something" contract without re-running the LLM.',
+                claudeFailureReason: 'guarantee path skipped LLM call — see Phase 4 logs for the original failure',
+                dossierItemCount: dossier.items?.length ?? 0,
+                sparcStatus: 'unknown',
+                query: scenarioQuery,
+            })];
         // Write to BOTH phase4 and phase2 so downstream consumers find them regardless of which path they check
         for (const targetDir of [path.join(runDir, 'phase4'), path.join(runDir, 'phase2')]) {
             const adrDir = path.join(targetDir, 'adrs');
@@ -2497,16 +2504,11 @@ export async function executeAutoChain(traceId, options = {}) {
     catch {
         // Best-effort
     }
-    // ADR-PIPELINE-099 D3 — process-wide heartbeat. Lives until executeAutoChain
-    // returns (try/finally below). Replaces the per-call heartbeat in
-    // executeNaturalLanguageRoute that died when auto-chain took over.
-    pipelineHeartbeat.start('agentics ask');
-    pipelineHeartbeat.setPhase('Phase 2 — booting');
     console.error('');
     console.error('='.repeat(72));
     console.error('  ENTERPRISE PROTOTYPE PIPELINE');
     console.error(`  Mode: ${mode === 'development' ? 'DEVELOPMENT (sandbox — no repo mutation)' : 'PROJECT (current branch)'}`);
-    console.error('  Auto-chaining Phases 2-7 from simulation artifacts');
+    console.error('  Auto-chaining Phases 2-6 from simulation artifacts');
     console.error('='.repeat(72));
     console.error('');
     // ── Check ruflo availability (optional — pipeline works without it) ──
@@ -2547,7 +2549,6 @@ export async function executeAutoChain(traceId, options = {}) {
         console.error('-'.repeat(72));
         console.error('  >> Phase 2: Deep Research');
         console.error('-'.repeat(72));
-        pipelineHeartbeat.setPhase('Phase 2 — Deep Research');
         const phase2HasContent = fs.existsSync(phaseDir)
             && fs.existsSync(path.join(phaseDir, 'research-dossier.json'))
             && fs.existsSync(path.join(phaseDir, 'sparc', 'sparc-combined.json'));
@@ -2625,7 +2626,6 @@ export async function executeAutoChain(traceId, options = {}) {
         console.error('');
         console.error('-'.repeat(72));
         console.error('  >> Phase 3: SPARC + London School TDD');
-        pipelineHeartbeat.setPhase('Phase 3 — SPARC + London TDD');
         console.error('-'.repeat(72));
         const phase3HasContent = fs.existsSync(phaseDir)
             && fs.existsSync(path.join(phaseDir, 'sparc', 'sparc-combined.json'));
@@ -2719,48 +2719,6 @@ export async function executeAutoChain(traceId, options = {}) {
                                 }
                             }
                         }
-                        // ADR-PIPELINE-105 — write phase3-manifest.json on recovery so
-                        // downstream phases that read it (Phase 4 + Phase 5) don't bail.
-                        try {
-                            const phase3SparcDir = path.join(phaseDir, 'sparc');
-                            const phase3TddDir = path.join(phaseDir, 'tdd');
-                            const sparcFiles = fs.existsSync(phase3SparcDir)
-                                ? fs.readdirSync(phase3SparcDir).filter(f => f.endsWith('.md') || f.endsWith('.json'))
-                                : [];
-                            const tddFiles = fs.existsSync(phase3TddDir)
-                                ? fs.readdirSync(phase3TddDir).filter(f => f.endsWith('.md') || f.endsWith('.json'))
-                                : [];
-                            // Detect implementation language from the carried-forward SPARC.
-                            let implLang = 'typescript';
-                            try {
-                                const sc = path.join(phase3SparcDir, 'sparc-combined.json');
-                                if (fs.existsSync(sc)) {
-                                    const parsed = JSON.parse(fs.readFileSync(sc, 'utf-8'));
-                                    if (parsed?.architecture?.language)
-                                        implLang = parsed.architecture.language;
-                                }
-                            }
-                            catch { /* keep typescript */ }
-                            const manifestObj = {
-                                phase: 3,
-                                status: 'recovered',
-                                recovered_from: 'phase2',
-                                recovery_reason: errMsg,
-                                trace_id: traceId,
-                                created_at: new Date().toISOString(),
-                                implementation_language: implLang,
-                                artifacts: [
-                                    ...sparcFiles.map(f => `phase3/sparc/${f}`),
-                                    ...tddFiles.map(f => `phase3/tdd/${f}`),
-                                ],
-                                counts: { sparc_files: sparcFiles.length, tdd_files: tddFiles.length },
-                            };
-                            fs.writeFileSync(path.join(phaseDir, 'phase3-manifest.json'), JSON.stringify(manifestObj, null, 2), { mode: 0o600, encoding: 'utf-8' });
-                            console.error(`  [RECOVER] Wrote phase3-manifest.json (${sparcFiles.length} SPARC, ${tddFiles.length} TDD files, lang=${implLang}) — Phase 4+5 can now finalize`);
-                        }
-                        catch (manifestErr) {
-                            console.error(`  [WARN] Failed to write phase3-manifest.json on recovery path: ${manifestErr instanceof Error ? manifestErr.message : String(manifestErr)}`);
-                        }
                         console.error('  [RECOVER] Phase 2 artifacts carried forward — continuing to Phase 4');
                         phases.push({ phase: 3, label: 'SPARC + London TDD', status: 'completed', timing: Date.now() - phaseStart, artifacts: [], outputDir: phaseDir, error: `Recovered from Phase 2: ${errMsg}` });
                         copyPlanningArtifacts(runDir, projectRoot);
@@ -2785,7 +2743,6 @@ export async function executeAutoChain(traceId, options = {}) {
         console.error('');
         console.error('-'.repeat(72));
         console.error('  >> Phase 4: Architecture Decision Records + Domain-Driven Design');
-        pipelineHeartbeat.setPhase('Phase 4 — ADRs + DDDs');
         console.error('-'.repeat(72));
         // Only skip if phase4 has actual ADR + DDD content (not just an empty dir from a failed prior run)
         const phase4HasContent = fs.existsSync(phaseDir)
@@ -2876,7 +2833,7 @@ export async function executeAutoChain(traceId, options = {}) {
                     if (!recovered) {
                         console.error('  [RECOVER] No Phase 2 ADRs — generating ADRs from SPARC + dossier (no LLM required)');
                         try {
-                            const { buildPhase2ADRs } = await import('../pipeline/phase2/phases/adr-generator.js');
+                            const { buildLoudFailureADR } = await import('../pipeline/phase2/phases/adr-generator.js');
                             const { buildPhase2DDD } = await import('../pipeline/phase2/phases/ddd-generator.js');
                             // Load SPARC and dossier from wherever they exist
                             let sparc = null;
@@ -2902,8 +2859,18 @@ export async function executeAutoChain(traceId, options = {}) {
                                 }
                             }
                             if (sparc && dossier) {
-                                // Generate ADRs
-                                const adrs = buildPhase2ADRs(sparc, dossier, scenarioQuery, true /* skipLLM */);
+                                // ADR-PIPELINE-100 §D5: recovery path emits a loud-failure ADR
+                                // directly rather than re-running the LLM. The Phase 4 path
+                                // has already completed/skipped; we just need a present-but-honest
+                                // marker in `phase4/adrs/` so downstream consumers can see that
+                                // ADR generation didn't yield real content.
+                                const adrs = [buildLoudFailureADR({
+                                        reason: 'Recovery path: no Phase 2 ADRs found; Phase 4 also did not produce content. This failure ADR is written so downstream phases can see the regression without rerunning the LLM.',
+                                        claudeFailureReason: 'recovery path skipped LLM call — see Phase 4 logs for the original failure',
+                                        dossierItemCount: dossier.items?.length ?? 0,
+                                        sparcStatus: 'present',
+                                        query: scenarioQuery,
+                                    })];
                                 if (adrs.length > 0) {
                                     const adrDir = path.join(phaseDir, 'adrs');
                                     fs.mkdirSync(adrDir, { recursive: true });
@@ -2956,40 +2923,6 @@ export async function executeAutoChain(traceId, options = {}) {
                         }
                     }
                     if (recovered) {
-                        // ADR-PIPELINE-105 — write a phase4-manifest.json on the recovery
-                        // path so Phase 5 (which reads this manifest to know ADRs/DDD
-                        // exist) can run instead of failing with "Phase 4 manifest
-                        // missing." Pre-105 the recovery copied files but never created
-                        // the manifest, so Phase 5's final-write step bombed and the
-                        // user got "9 code files generated but not finalized."
-                        try {
-                            const adrDir = path.join(phaseDir, 'adrs');
-                            const dddDir = path.join(phaseDir, 'ddd');
-                            const adrFiles = fs.existsSync(adrDir)
-                                ? fs.readdirSync(adrDir).filter(f => f.endsWith('.md'))
-                                : [];
-                            const dddFiles = fs.existsSync(dddDir)
-                                ? fs.readdirSync(dddDir).filter(f => f.endsWith('.json') || f.endsWith('.md'))
-                                : [];
-                            const manifestObj = {
-                                phase: 4,
-                                status: 'recovered',
-                                recovered_from: 'phase2',
-                                recovery_reason: errMsg,
-                                trace_id: traceId,
-                                created_at: new Date().toISOString(),
-                                artifacts: [
-                                    ...adrFiles.map(f => `phase4/adrs/${f}`),
-                                    ...dddFiles.map(f => `phase4/ddd/${f}`),
-                                ],
-                                counts: { adrs: adrFiles.length, ddd_files: dddFiles.length },
-                            };
-                            fs.writeFileSync(path.join(phaseDir, 'phase4-manifest.json'), JSON.stringify(manifestObj, null, 2), { mode: 0o600, encoding: 'utf-8' });
-                            console.error(`  [RECOVER] Wrote phase4-manifest.json (${adrFiles.length} ADRs, ${dddFiles.length} DDD files) — Phase 5 can now finalize`);
-                        }
-                        catch (manifestErr) {
-                            console.error(`  [WARN] Failed to write phase4-manifest.json on recovery path: ${manifestErr instanceof Error ? manifestErr.message : String(manifestErr)}`);
-                        }
                         phases.push({ phase: 4, label: 'ADRs + DDDs', status: 'completed', timing: Date.now() - phaseStart, artifacts: [], outputDir: phaseDir, error: `Recovered: ${errMsg}` });
                     }
                     else {
@@ -3001,11 +2934,10 @@ export async function executeAutoChain(traceId, options = {}) {
             } // close ADR-PIPELINE-093 phase4-adrs-ddd gate-else
         }
     }
-    // ── Phase 4.5 (Phase 5a): Generate implementation prompts by reading ADR + DDD files ──
+    // ── Phase 4.5: Generate implementation prompts by reading ADR + DDD files ──
     // Simple approach: gather all ADR/DDD/SPARC files, hand them to ruflo swarm,
     // let the LLM read them and produce coherent implementation prompts.
     {
-        pipelineHeartbeat.setPhase('Phase 5a — Implementation Prompts');
         const promptsDir = path.join(runDir, 'prompts');
         // Check if prompts already exist from a prior run
         const promptsExist = fs.existsSync(promptsDir)
@@ -3952,7 +3884,6 @@ services when the pilot validates the approach.
         console.error('');
         console.error('-'.repeat(72));
         console.error(`  >> Phase 5: Build (Code Generation + Deployable Service) [${detectedLanguage}]`);
-        pipelineHeartbeat.setPhase(`Phase 5 — Build [${detectedLanguage}]`);
         console.error('-'.repeat(72));
         const phase5HasContent = fs.existsSync(phaseDir)
             && fs.existsSync(path.join(phaseDir, 'phase5-manifest.json'));
@@ -3967,38 +3898,6 @@ services when the pilot validates the approach.
                 fs.rmSync(phaseDir, { recursive: true, force: true });
             }
             const agentResults = await dispatchPhaseAgents(PHASE_AGENTS[5], traceId, runDir, scenarioQuery);
-            // ADR-PIPELINE-099 D3 — surface every implementation prompt so the user
-            // sees the work plan instead of staring at a silent terminal. The build
-            // itself remains a single Ruflo swarm invocation, but each prompt that
-            // feeds it is now visible up front and announced in the heartbeat.
-            try {
-                const promptsDir = path.join(runDir, 'prompts');
-                if (fs.existsSync(promptsDir)) {
-                    const implFiles = fs.readdirSync(promptsDir)
-                        .filter(f => /^impl-\d+-.+\.md$/.test(f))
-                        .sort();
-                    if (implFiles.length > 0) {
-                        console.error(`  [PROMPTS] Build plan: ${implFiles.length} implementation prompts queued`);
-                        for (let i = 0; i < implFiles.length; i++) {
-                            const f = implFiles[i];
-                            // Read just the title line from frontmatter so the visible
-                            // line is human-readable, not a slug.
-                            let title = f;
-                            try {
-                                const head = fs.readFileSync(path.join(promptsDir, f), 'utf-8').split('\n').slice(0, 12);
-                                const titleLine = head.find(l => l.startsWith('title:'));
-                                if (titleLine)
-                                    title = titleLine.replace(/^title:\s*"?/, '').replace(/"?\s*$/, '');
-                            }
-                            catch { /* keep filename */ }
-                            const titleTrim = title.length > 70 ? title.slice(0, 67) + '…' : title;
-                            console.error(`    ${String(i + 1).padStart(2, ' ')}/${implFiles.length}  ${f}  ${titleTrim}`);
-                        }
-                        pipelineHeartbeat.setActivity(`build: handing ${implFiles.length} prompts to ruflo swarm`);
-                    }
-                }
-            }
-            catch { /* visibility is best-effort */ }
             // Ruflo swarm: build production-ready application in cooperation with agentics agents
             const rufloP5Dir = path.join(runDir, '.ruflo-cache', 'phase5');
             const rufloResult = executeRufloPhaseSwarm({
@@ -4077,7 +3976,6 @@ services when the pilot validates the approach.
         console.error('');
         console.error('-'.repeat(72));
         console.error('  >> Phase 6: ERP Surface Push + Project Materialization');
-        pipelineHeartbeat.setPhase('Phase 6 — ERP Push + Materialization');
         console.error('-'.repeat(72));
         // Only skip if phase6 has actual registration content (not just an empty dir from a failed prior run)
         const phase6HasContent = fs.existsSync(phaseDir)
@@ -4135,7 +4033,6 @@ services when the pilot validates the approach.
         console.error('');
         console.error('-'.repeat(72));
         console.error('  >> Phase 7: Consulting Deliverables (85-document enterprise decision pack)');
-        pipelineHeartbeat.setPhase('Phase 7 — Consulting Deliverables');
         console.error('-'.repeat(72));
         try {
             const { executePhase7 } = await import('./phase7/coordinator.js');
@@ -4179,40 +4076,6 @@ services when the pilot validates the approach.
                     outputDir: phaseDir,
                     ...(errorDetail ? { error: errorDetail } : {}),
                 });
-                // ADR-PIPELINE-099 D5 (project-co-located deliverables) — the
-                // executive deliverables MUST land in the project directory itself,
-                // not behind the runDir artifact wall (~/.agentics/runs/...). Copy
-                // <runDir>/deliverables/ into:
-                //   1. <runDir>/phase6/project/deliverables/ — so the materialized
-                //      project tree always carries them
-                //   2. <options.outputDir>/deliverables/ — when the user asked for
-                //      a specific output directory
-                //   3. <repoRoot>/deliverables/ — when running in 'project' mode,
-                //      so the deliverables land alongside the just-built code
-                const deliverablesSrc = phaseDir; // == <runDir>/deliverables
-                if (fs.existsSync(deliverablesSrc)) {
-                    const targets = [];
-                    const phase6ProjectDir = path.join(runDir, 'phase6', 'project');
-                    if (fs.existsSync(phase6ProjectDir)) {
-                        targets.push(path.join(phase6ProjectDir, 'deliverables'));
-                    }
-                    if (options.outputDir) {
-                        targets.push(path.join(path.resolve(options.outputDir), 'deliverables'));
-                    }
-                    if (mode === 'project' && execCtx.repoRoot) {
-                        targets.push(path.join(execCtx.repoRoot, 'deliverables'));
-                    }
-                    for (const target of targets) {
-                        try {
-                            const counts = copyDirRecursive(deliverablesSrc, target);
-                            console.error(`  [P7] Co-located deliverables → ${target} (${counts.copied} new, ${counts.skipped} unchanged)`);
-                        }
-                        catch (copyErr) {
-                            const m = copyErr instanceof Error ? copyErr.message : String(copyErr);
-                            console.error(`  [P7] [WARN] failed to copy deliverables to ${target}: ${m}`);
-                        }
-                    }
-                }
             }
         }
         catch (err) {
@@ -4345,7 +4208,6 @@ services when the pilot validates the approach.
                 shutdownSwarm(traceId, false, totalTiming);
             }
             catch { /* best-effort */ }
-            pipelineHeartbeat.stop();
             process.exit(1);
         }
     }
@@ -4359,10 +4221,6 @@ services when the pilot validates the approach.
     // ADR-PIPELINE-093 §Rule 3 (c): blocked phases threaded into the
     // result so the final `agentics ask` banner can warn the user.
     gateAcc.blocked.map(b => ({ phase: b.phase, missing: [...b.missing] })));
-    // ADR-PIPELINE-099 D3 — clear the heartbeat status line before printing
-    // the final summary so the bottom-of-screen frame doesn't overlap the
-    // summary banner.
-    pipelineHeartbeat.stop();
     printFinalSummary(result);
     return result;
 }