@llm-dev-ops/agentics-cli 1.4.27 → 1.4.29

package/dist/commands/phase5.js

@@ -0,0 +1,254 @@
+/**
+ * Phase 5 Command (Build)
+ *
+ * Chains code generation and deployable service generation into a
+ * single Build pipeline:
+ *   - Prior Phase Loading (Phase 2/3/4 artifact validation)
+ *   - Domain Code Generation (existing Phase 3 codegen pipeline)
+ *   - Deployable Service Generation (existing Phase 4 deploy pipeline)
+ *
+ * Usage:
+ *   agentics phase5 --trace <TRACE_ID>
+ *   agentics phase5 --latest
+ *
+ * Error codes:
+ *   ECLI-P5-001  Missing Phase 4 (ADRs+DDDs) artifacts
+ *   ECLI-P5-006  Phase 5 output directory already exists (append-only)
+ *   ECLI-P5-007  No runs found (--latest with empty runs dir)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { join } from 'node:path';
+import { CLIError } from '../errors/index.js';
+import { executePhase5BuildPipeline } from '../pipeline/phase5-build/index.js';
+import { REPO_CACHE_ROOT } from '../agents/repo-agent-runner.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const RUNS_DIR_NAME = '.agentics/runs';
+const PHASE2_SUBDIR = 'phase2';
+const PHASE3_SUBDIR = 'phase3';
+const PHASE4_SUBDIR = 'phase4';
+const PHASE5_SUBDIR = 'phase5';
+const DIR_MODE = 0o700;
+const PLATFORM_REPOS = ['agentics-contracts', 'infra', 'integrations', 'erp-surface'];
+// ============================================================================
+// Command Executor
+// ============================================================================
+/**
+ * Execute the `agentics phase5` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 4 (ADRs+DDDs) exists and Phase 5 does not, constructs the
+ * Phase5BuildContext, and delegates to the build pipeline coordinator.
+ */
+export async function executePhase5Command(options) {
+    const homeDir = process.env['HOME'] ?? '/tmp';
+    const runsDir = path.join(homeDir, RUNS_DIR_NAME);
+    // -- Resolve Phase 1 run directory --
+    const runDir = options.trace
+        ? path.join(runsDir, options.trace)
+        : options.latest
+            ? findLatestRunDir(runsDir)
+            : null;
+    if (!runDir) {
+        throw new CLIError({
+            code: 'ECLI-P5-001',
+            category: 'INPUT_ERROR',
+            message: 'No trace ID specified. Use --trace <TRACE_ID> or --latest.',
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate run directory exists --
+    if (!fs.existsSync(runDir)) {
+        throw new CLIError({
+            code: 'ECLI-P5-001',
+            category: 'INPUT_ERROR',
+            message: `Run directory not found: ${runDir}`,
+            details: { runDir },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate Phase 4 (ADRs+DDDs) subdirectory exists --
+    const phase4Dir = path.join(runDir, PHASE4_SUBDIR);
+    if (!fs.existsSync(phase4Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P5-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 4 output not found. Run 'agentics phase4' first: ${phase4Dir}`,
+            details: { phase4Dir },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate Phase 4 manifest exists --
+    const phase4ManifestPath = path.join(phase4Dir, 'phase4-manifest.json');
+    if (!fs.existsSync(phase4ManifestPath)) {
+        throw new CLIError({
+            code: 'ECLI-P5-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 4 manifest not found. Run 'agentics phase4' to completion: ${phase4ManifestPath}`,
+            details: { phase4ManifestPath },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Append-only guard: Phase 5 must not already exist --
+    const phase5Dir = path.join(runDir, PHASE5_SUBDIR);
+    if (fs.existsSync(phase5Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P5-006',
+            category: 'INPUT_ERROR',
+            message: `Phase 5 already exists for this run. Output is append-only: ${phase5Dir}`,
+            details: { phase5Dir },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Create Phase 5 output directory --
+    fs.mkdirSync(phase5Dir, { recursive: true, mode: DIR_MODE });
+    // -- Derive trace ID from directory name --
+    const traceId = path.basename(runDir);
+    // -- Read scenario query from Phase 1 manifest --
+    let scenarioQuery = '';
+    try {
+        const manifestPath = path.join(runDir, 'manifest.json');
+        if (fs.existsSync(manifestPath)) {
+            const raw = fs.readFileSync(manifestPath, 'utf-8');
+            const manifest = JSON.parse(raw);
+            scenarioQuery = manifest.query ?? '';
+        }
+    }
+    catch {
+        // Best-effort; the pipeline stages will try other sources
+    }
+    // -- Derive prior phase directories --
+    const phase2Dir = path.join(runDir, PHASE2_SUBDIR);
+    const phase3Dir = path.join(runDir, PHASE3_SUBDIR);
+    // -- Resolve platform repository paths --
+    const platformRepoPaths = {};
+    for (const repoName of PLATFORM_REPOS) {
+        platformRepoPaths[repoName] = join(REPO_CACHE_ROOT, repoName);
+    }
+    // -- Construct Phase5BuildContext --
+    const context = {
+        traceId,
+        phase2Dir,
+        phase3Dir,
+        phase4Dir,
+        phase5Dir,
+        scenarioQuery,
+        platformRepoPaths,
+        telemetrySpans: [],
+    };
+    // -- Execute pipeline --
+    const result = await executePhase5BuildPipeline(context);
+    return result;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format Phase 5 Build result for human-readable display.
+ */
+export function formatPhase5ForDisplay(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('Phase 5: Build (Code Gen + Deployable Service)');
+    lines.push('='.repeat(50));
+    lines.push('');
+    lines.push(`  Trace ID:   ${result.traceId}`);
+    lines.push(`  Output:     ${result.phase5Dir}`);
+    lines.push(`  Language:   ${result.manifest.implementation_language}`);
+    lines.push(`  ERP System: ${result.manifest.erp_system}`);
+    lines.push(`  Duration:   ${result.totalTiming}ms`);
+    lines.push(`  Stages:     ${result.stageResults.length}`);
+    lines.push(`  Artifacts:  ${result.manifest.artifacts.length} files`);
+    lines.push(`  Success:    ${result.manifest.success}`);
+    lines.push('');
+    // Stage summary
+    lines.push('  Stages:');
+    for (const stage of result.stageResults) {
+        const icon = stage.status === 'completed' ? '[OK]' : '[FAIL]';
+        lines.push(`    ${icon} ${stage.stage} (${stage.timing}ms)`);
+    }
+    lines.push('');
+    // Check for failures
+    const failed = result.stageResults.find(s => s.status === 'failed');
+    if (failed) {
+        lines.push(`  ERROR: Pipeline failed at stage "${failed.stage}"`);
+        lines.push(`         ${failed.summary}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Find the most recent Phase 1 run directory that has a Phase 4 subdirectory
+ * with a phase4-manifest.json.
+ */
+function findLatestRunDir(runsDir) {
+    if (!fs.existsSync(runsDir)) {
+        throw new CLIError({
+            code: 'ECLI-P5-007',
+            category: 'INPUT_ERROR',
+            message: `Runs directory not found: ${runsDir}`,
+            details: { runsDir },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    let latestDir = '';
+    let latestTime = '';
+    const entries = fs.readdirSync(runsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const runPath = path.join(runsDir, entry.name);
+        const phase4Path = path.join(runPath, PHASE4_SUBDIR);
+        // Only consider runs that have Phase 4 output with manifest
+        if (!fs.existsSync(phase4Path))
+            continue;
+        const phase4ManifestPath = path.join(phase4Path, 'phase4-manifest.json');
+        if (!fs.existsSync(phase4ManifestPath))
+            continue;
+        const manifestPath = path.join(runPath, 'manifest.json');
+        if (!fs.existsSync(manifestPath))
+            continue;
+        try {
+            const raw = fs.readFileSync(manifestPath, 'utf-8');
+            const manifest = JSON.parse(raw);
+            const createdAt = manifest.created_at ?? '';
+            if (createdAt > latestTime) {
+                latestTime = createdAt;
+                latestDir = runPath;
+            }
+        }
+        catch {
+            // Skip unreadable manifests
+        }
+    }
+    if (!latestDir) {
+        throw new CLIError({
+            code: 'ECLI-P5-007',
+            category: 'INPUT_ERROR',
+            message: 'No Phase 4 runs found. Run Phase 1 through Phase 4 first.',
+            details: { runsDir },
+            module: 'phase5',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    return latestDir;
+}
+//# sourceMappingURL=phase5.js.map

package/dist/commands/phase5.js.map

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

package/dist/commands/phase6.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Phase 6 Command (ERP Surface Push)
+ *
+ * Pushes Phase 5 Build deployable services onto an ERP surface with full
+ * registration, materialization, and governance:
+ *   - Phase 5 Artifact Validation
+ *   - ERP Service Registration
+ *   - Project Materialization
+ *   - Deployment Finalization
+ *   - Manifest Writing
+ *
+ * Usage:
+ *   agentics phase6 --trace <TRACE_ID>
+ *   agentics phase6 --latest
+ *
+ * Error codes:
+ *   ECLI-P6-001  Missing Phase 5 (Build) artifacts
+ *   ECLI-P6-006  Phase 6 output directory already exists (append-only)
+ *   ECLI-P6-007  No runs found (--latest with empty runs dir)
+ */
+import type { Phase6PipelineResult } from '../pipeline/phase6/types.js';
+export interface Phase6CommandOptions {
+    readonly trace?: string;
+    readonly latest?: boolean;
+    readonly verbose?: boolean;
+    readonly format?: 'json' | 'text';
+    readonly outputDir?: string;
+}
+/**
+ * Execute the `agentics phase6` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 5 (Build) exists and Phase 6 does not, constructs the
+ * Phase6Context, and delegates to the Phase 6 pipeline coordinator.
+ */
+export declare function executePhase6Command(options: Phase6CommandOptions): Promise<Phase6PipelineResult>;
+/**
+ * Format Phase 6 result for human-readable display.
+ */
+export declare function formatPhase6ForDisplay(result: Phase6PipelineResult, outputDir?: string): string;
+//# sourceMappingURL=phase6.d.ts.map

package/dist/commands/phase6.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase6.d.ts","sourceRoot":"","sources":["../../src/commands/phase6.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,KAAK,EAAiB,oBAAoB,EAAsC,MAAM,6BAA6B,CAAC;AAmB3H,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAqJ/B;AAqFD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwC/F"}

package/dist/commands/phase6.js

@@ -0,0 +1,355 @@
+/**
+ * Phase 6 Command (ERP Surface Push)
+ *
+ * Pushes Phase 5 Build deployable services onto an ERP surface with full
+ * registration, materialization, and governance:
+ *   - Phase 5 Artifact Validation
+ *   - ERP Service Registration
+ *   - Project Materialization
+ *   - Deployment Finalization
+ *   - Manifest Writing
+ *
+ * Usage:
+ *   agentics phase6 --trace <TRACE_ID>
+ *   agentics phase6 --latest
+ *
+ * Error codes:
+ *   ECLI-P6-001  Missing Phase 5 (Build) artifacts
+ *   ECLI-P6-006  Phase 6 output directory already exists (append-only)
+ *   ECLI-P6-007  No runs found (--latest with empty runs dir)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { CLIError } from '../errors/index.js';
+import { executePhase6Pipeline } from '../pipeline/phase6/index.js';
+import { REPO_CACHE_ROOT } from '../agents/repo-agent-runner.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const RUNS_DIR_NAME = '.agentics/runs';
+const PHASE5_SUBDIR = 'phase5';
+const PHASE6_SUBDIR = 'phase6';
+const DIR_MODE = 0o700;
+const PLATFORM_REPOS = ['agentics-contracts', 'infra', 'integrations', 'erp-surface'];
+// ============================================================================
+// Command Executor
+// ============================================================================
+/**
+ * Execute the `agentics phase6` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 5 (Build) exists and Phase 6 does not, constructs the
+ * Phase6Context, and delegates to the Phase 6 pipeline coordinator.
+ */
+export async function executePhase6Command(options) {
+    const homeDir = process.env['HOME'] ?? '/tmp';
+    const runsDir = path.join(homeDir, RUNS_DIR_NAME);
+    // -- Resolve Phase 1 run directory --
+    const runDir = options.trace
+        ? path.join(runsDir, options.trace)
+        : options.latest
+            ? findLatestRunDir(runsDir)
+            : null;
+    if (!runDir) {
+        throw new CLIError({
+            code: 'ECLI-P6-001',
+            category: 'INPUT_ERROR',
+            message: 'No trace ID specified. Use --trace <TRACE_ID> or --latest.',
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate run directory exists --
+    if (!fs.existsSync(runDir)) {
+        throw new CLIError({
+            code: 'ECLI-P6-001',
+            category: 'INPUT_ERROR',
+            message: `Run directory not found: ${runDir}`,
+            details: { runDir },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate Phase 5 (Build) subdirectory exists --
+    const phase5Dir = path.join(runDir, PHASE5_SUBDIR);
+    if (!fs.existsSync(phase5Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P6-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 5 output not found. Run 'agentics phase5' first: ${phase5Dir}`,
+            details: { phase5Dir },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate Phase 5 manifest exists --
+    const phase5ManifestPath = path.join(phase5Dir, 'phase5-manifest.json');
+    if (!fs.existsSync(phase5ManifestPath)) {
+        throw new CLIError({
+            code: 'ECLI-P6-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 5 manifest not found. Run 'agentics phase5' to completion: ${phase5ManifestPath}`,
+            details: { phase5ManifestPath },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Append-only guard: Phase 6 must not already exist --
+    const phase6Dir = path.join(runDir, PHASE6_SUBDIR);
+    if (fs.existsSync(phase6Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P6-006',
+            category: 'INPUT_ERROR',
+            message: `Phase 6 already exists for this run. Output is append-only: ${phase6Dir}`,
+            details: { phase6Dir },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Create Phase 6 output directory --
+    fs.mkdirSync(phase6Dir, { recursive: true, mode: DIR_MODE });
+    // -- Derive trace ID from directory name --
+    const traceId = path.basename(runDir);
+    // -- Read scenario query from Phase 1 manifest --
+    let scenarioQuery = '';
+    try {
+        const manifestPath = path.join(runDir, 'manifest.json');
+        if (fs.existsSync(manifestPath)) {
+            const raw = fs.readFileSync(manifestPath, 'utf-8');
+            const manifest = JSON.parse(raw);
+            scenarioQuery = manifest.query ?? '';
+        }
+    }
+    catch {
+        // Best-effort; the pipeline stages will try other sources
+    }
+    // -- Load Phase 5 manifest for context --
+    let phase5ManifestData;
+    try {
+        const raw = fs.readFileSync(phase5ManifestPath, 'utf-8');
+        phase5ManifestData = JSON.parse(raw);
+    }
+    catch {
+        throw new CLIError({
+            code: 'ECLI-P6-001',
+            category: 'INPUT_ERROR',
+            message: `Failed to parse Phase 5 manifest: ${phase5ManifestPath}`,
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Build Phase5Artifacts for context --
+    const phase5Artifacts = {
+        manifest: phase5ManifestData,
+        implementationLanguage: phase5ManifestData.implementation_language ?? 'typescript',
+        erpSystem: phase5ManifestData.erp_system ?? 'unknown',
+        databaseEngine: phase5ManifestData.database_engine ?? null,
+        apiOnly: phase5ManifestData.api_only ?? false,
+        projectDir: join(phase5Dir, 'deploy', 'project'),
+    };
+    // -- Resolve platform repository paths --
+    const platformRepoPaths = {};
+    for (const repoName of PLATFORM_REPOS) {
+        platformRepoPaths[repoName] = join(REPO_CACHE_ROOT, repoName);
+    }
+    // -- Construct Phase6Context --
+    const context = {
+        traceId,
+        phase5Dir,
+        phase6Dir,
+        scenarioQuery,
+        phase5Artifacts,
+        platformRepoPaths,
+        stageOutputs: new Map(),
+        telemetrySpans: [],
+    };
+    // -- Execute pipeline --
+    const result = await executePhase6Pipeline(context);
+    // -- Materialize to --output-dir if specified --
+    if (options.outputDir && result.manifest.success) {
+        materializeToOutputDir(result, options.outputDir, scenarioQuery);
+    }
+    return result;
+}
+// ============================================================================
+// Output Directory Materialization
+// ============================================================================
+/**
+ * Copy the materialized project to a user-specified output directory,
+ * initialize a git repository, and create an initial commit.
+ */
+function materializeToOutputDir(result, outputDir, scenarioQuery) {
+    const absOutputDir = path.resolve(outputDir);
+    // Locate the materialized project inside the Phase 6 output
+    const phase6ProjectDir = path.join(result.phase6Dir, 'project');
+    if (!fs.existsSync(phase6ProjectDir)) {
+        console.error(`     [WARN] No project directory in Phase 6 output: ${phase6ProjectDir}`);
+        return;
+    }
+    // Create output directory (fail if it already exists with content)
+    fs.mkdirSync(absOutputDir, { recursive: true, mode: DIR_MODE });
+    // Recursively copy phase6/project/* → outputDir/
+    copyTreeForOutput(phase6ProjectDir, absOutputDir);
+    // Also copy Phase 6 manifest for reference
+    const phase6ManifestSrc = path.join(result.phase6Dir, 'phase6-manifest.json');
+    if (fs.existsSync(phase6ManifestSrc)) {
+        fs.copyFileSync(phase6ManifestSrc, path.join(absOutputDir, 'phase6-manifest.json'));
+    }
+    // Initialize git repository and create initial commit
+    try {
+        execSync('git init', { cwd: absOutputDir, stdio: 'pipe' });
+        execSync('git add -A', { cwd: absOutputDir, stdio: 'pipe' });
+        const commitMsg = scenarioQuery
+            ? `feat: generated prototype — ${scenarioQuery.slice(0, 80)}`
+            : 'feat: generated enterprise prototype';
+        execSync(`git commit -m "${commitMsg}"`, { cwd: absOutputDir, stdio: 'pipe' });
+    }
+    catch {
+        // Non-fatal — git init is best-effort
+        console.error('     [WARN] git init/commit in output directory failed (non-fatal)');
+    }
+    // Print next-steps instructions
+    console.log('');
+    console.log(`  Project materialized: ${absOutputDir}`);
+    console.log('');
+    console.log('  Next steps:');
+    console.log(`    cd ${outputDir}`);
+    console.log('    npm install');
+    console.log('    npm run dev');
+    console.log('');
+    console.log(`  Or inspect the generated prototype:`);
+    console.log(`    tree ${outputDir}/src --dirsfirst -L 3`);
+    console.log('');
+}
+/**
+ * Recursively copy a directory tree for output materialization.
+ */
+function copyTreeForOutput(src, dest) {
+    fs.mkdirSync(dest, { recursive: true, mode: DIR_MODE });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name === '.git')
+                continue;
+            copyTreeForOutput(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format Phase 6 result for human-readable display.
+ */
+export function formatPhase6ForDisplay(result, outputDir) {
+    const lines = [];
+    lines.push('');
+    lines.push('Phase 6: ERP Surface Push');
+    lines.push('='.repeat(50));
+    lines.push('');
+    lines.push(`  Trace ID:       ${result.traceId}`);
+    lines.push(`  Output:         ${result.phase6Dir}`);
+    lines.push(`  ERP System:     ${result.manifest.erp_system}`);
+    lines.push(`  Service:        ${result.manifest.service_name}`);
+    lines.push(`  Registration:   ${result.manifest.registration_id}`);
+    lines.push(`  Endpoints:      ${result.manifest.endpoints.length}`);
+    lines.push(`  Duration:       ${result.totalTiming}ms`);
+    lines.push(`  Artifacts:      ${result.manifest.artifacts.length} files`);
+    lines.push(`  Success:        ${result.manifest.success}`);
+    if (outputDir) {
+        lines.push(`  Output Dir:     ${path.resolve(outputDir)}`);
+    }
+    lines.push('');
+    // Stage summary
+    lines.push('  Stages:');
+    for (const stage of result.stageResults) {
+        const icon = stage.status === 'completed' ? '[OK]' : '[FAIL]';
+        lines.push(`    ${icon} ${stage.stage} (${stage.timing}ms)`);
+    }
+    lines.push('');
+    // Check for failures
+    const failed = result.stageResults.find(s => s.status === 'failed');
+    if (failed) {
+        lines.push(`  ERROR: Pipeline failed at stage "${failed.stage}"`);
+        if (failed.summary) {
+            lines.push(`         ${failed.summary}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Find the most recent Phase 1 run directory that has a Phase 5 subdirectory
+ * with a phase5-manifest.json.
+ */
+function findLatestRunDir(runsDir) {
+    if (!fs.existsSync(runsDir)) {
+        throw new CLIError({
+            code: 'ECLI-P6-007',
+            category: 'INPUT_ERROR',
+            message: `Runs directory not found: ${runsDir}`,
+            details: { runsDir },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    let latestDir = '';
+    let latestTime = '';
+    const entries = fs.readdirSync(runsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const runPath = path.join(runsDir, entry.name);
+        const phase5Path = path.join(runPath, PHASE5_SUBDIR);
+        // Only consider runs that have Phase 5 output with manifest
+        if (!fs.existsSync(phase5Path))
+            continue;
+        const phase5ManifestPath = path.join(phase5Path, 'phase5-manifest.json');
+        if (!fs.existsSync(phase5ManifestPath))
+            continue;
+        const manifestPath = path.join(runPath, 'manifest.json');
+        if (!fs.existsSync(manifestPath))
+            continue;
+        try {
+            const raw = fs.readFileSync(manifestPath, 'utf-8');
+            const manifest = JSON.parse(raw);
+            const createdAt = manifest.created_at ?? '';
+            if (createdAt > latestTime) {
+                latestTime = createdAt;
+                latestDir = runPath;
+            }
+        }
+        catch {
+            // Skip unreadable manifests
+        }
+    }
+    if (!latestDir) {
+        throw new CLIError({
+            code: 'ECLI-P6-007',
+            category: 'INPUT_ERROR',
+            message: 'No Phase 5 runs found. Run Phase 1 through Phase 5 first.',
+            details: { runsDir },
+            module: 'phase6',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    return latestDir;
+}
+//# sourceMappingURL=phase6.js.map