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

package/dist/commands/phase3.js

@@ -0,0 +1,241 @@
+/**
+ * Phase 3 Command (SPARC + London School TDD)
+ *
+ * Generates SPARC specifications and London School TDD test plans from
+ * the Phase 2 research dossier:
+ *   - Phase 2 Loading (research dossier + Phase 1 artifacts from disk)
+ *   - SPARC Specification (spec, pseudocode, architecture, refinement, completion)
+ *   - London School TDD Plan (outside-in test plan with mock contracts and seams)
+ *
+ * Usage:
+ *   agentics phase3 --trace <TRACE_ID>
+ *   agentics phase3 --latest
+ *
+ * Error codes:
+ *   ECLI-P3-001  Missing Phase 2 artifacts or research dossier
+ *   ECLI-P3-006  Phase 3 output directory already exists (append-only)
+ *   ECLI-P3-007  No runs found (--latest with empty runs dir)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CLIError } from '../errors/index.js';
+import { executePhase3SPARCPipeline } from '../pipeline/phase3-sparc/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const RUNS_DIR_NAME = '.agentics/runs';
+const PHASE2_SUBDIR = 'phase2';
+const PHASE3_SUBDIR = 'phase3';
+const DIR_MODE = 0o700;
+const RESEARCH_DOSSIER_FILENAME = 'research-dossier.json';
+// ============================================================================
+// Command Executor
+// ============================================================================
+/**
+ * Execute the `agentics phase3` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 2 exists with a research dossier and Phase 3 does not,
+ * constructs the Phase3SPARCContext, and delegates to the pipeline coordinator.
+ */
+export async function executePhase3Command(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-P3-001',
+            category: 'INPUT_ERROR',
+            message: 'No trace ID specified. Use --trace <TRACE_ID> or --latest.',
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate run directory exists --
+    if (!fs.existsSync(runDir)) {
+        throw new CLIError({
+            code: 'ECLI-P3-001',
+            category: 'INPUT_ERROR',
+            message: `Run directory not found: ${runDir}`,
+            details: { runDir },
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate Phase 2 subdirectory exists --
+    const phase2Dir = path.join(runDir, PHASE2_SUBDIR);
+    if (!fs.existsSync(phase2Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P3-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 2 output not found. Run 'agentics phase2' first: ${phase2Dir}`,
+            details: { phase2Dir },
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Validate research dossier exists --
+    const dossierPath = path.join(phase2Dir, RESEARCH_DOSSIER_FILENAME);
+    if (!fs.existsSync(dossierPath)) {
+        throw new CLIError({
+            code: 'ECLI-P3-001',
+            category: 'INPUT_ERROR',
+            message: `Research dossier not found. Run 'agentics phase2' first: ${dossierPath}`,
+            details: { dossierPath },
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Append-only guard: Phase 3 must not already exist --
+    const phase3Dir = path.join(runDir, PHASE3_SUBDIR);
+    if (fs.existsSync(phase3Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P3-006',
+            category: 'INPUT_ERROR',
+            message: `Phase 3 already exists for this run. Output is append-only: ${phase3Dir}`,
+            details: { phase3Dir },
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // -- Create Phase 3 output directory --
+    fs.mkdirSync(phase3Dir, { 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 will try other sources
+    }
+    // -- Construct Phase3SPARCContext --
+    const context = {
+        traceId,
+        phase2Dir,
+        phase3Dir,
+        scenarioQuery,
+        stageOutputs: new Map(),
+        telemetrySpans: [],
+    };
+    // -- Execute pipeline --
+    const result = await executePhase3SPARCPipeline(context);
+    return result;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format Phase 3 result for human-readable display.
+ */
+export function formatPhase3ForDisplay(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('Phase 3: SPARC + London TDD');
+    lines.push('='.repeat(50));
+    lines.push('');
+    lines.push(`  Trace ID:    ${result.traceId}`);
+    lines.push(`  Output:      ${result.phase3Dir}`);
+    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}"`);
+        const failData = failed.data;
+        if (failData && typeof failData === 'object' && 'error' in failData) {
+            lines.push(`         ${failData['error']}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Find the most recent Phase 1 run directory that has a Phase 2 subdirectory
+ * with a research dossier.
+ */
+function findLatestRunDir(runsDir) {
+    if (!fs.existsSync(runsDir)) {
+        throw new CLIError({
+            code: 'ECLI-P3-007',
+            category: 'INPUT_ERROR',
+            message: `Runs directory not found: ${runsDir}`,
+            details: { runsDir },
+            module: 'phase3',
+            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 phase2Path = path.join(runPath, PHASE2_SUBDIR);
+        // Only consider runs that have Phase 2 output with research dossier
+        if (!fs.existsSync(phase2Path))
+            continue;
+        const dossierPath = path.join(phase2Path, RESEARCH_DOSSIER_FILENAME);
+        if (!fs.existsSync(dossierPath))
+            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-P3-007',
+            category: 'INPUT_ERROR',
+            message: 'No Phase 2 runs with research dossier found. Run Phase 1 and Phase 2 first.',
+            details: { runsDir },
+            module: 'phase3',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    return latestDir;
+}
+//# sourceMappingURL=phase3.js.map

package/dist/commands/phase3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase3.js","sourceRoot":"","sources":["../../src/commands/phase3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAI/E,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAC/B,MAAM,aAAa,GAAG,QAAQ,CAAC;AAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAa1D,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA6B;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAElD,sCAAsC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;QAC1B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;QACnC,CAAC,CAAC,OAAO,CAAC,MAAM;YACd,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,4DAA4D;YACrE,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,4BAA4B,MAAM,EAAE;YAC7C,OAAO,EAAE,EAAE,MAAM,EAAE;YACnB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,0DAA0D,SAAS,EAAE;YAC9E,OAAO,EAAE,EAAE,SAAS,EAAE;YACtB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,4DAA4D,WAAW,EAAE;YAClF,OAAO,EAAE,EAAE,WAAW,EAAE;YACxB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,+DAA+D,SAAS,EAAE;YACnF,OAAO,EAAE,EAAE,SAAS,EAAE;YACtB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE7D,4CAA4C;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtC,kDAAkD;IAClD,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;YACvD,aAAa,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAuB;QAClC,OAAO;QACP,SAAS;QACT,SAAS;QACT,aAAa;QACb,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,cAAc,EAAE,EAAqB;KACtC,CAAC;IAEF,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAEzD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiC;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,qBAAqB;IACrB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IACtE,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAsC,CAAC;QAC/D,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,6BAA6B,OAAO,EAAE;YAC/C,OAAO,EAAE,EAAE,OAAO,EAAE;YACpB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAErD,oEAAoE;QACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAS;QAE1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAS;QAE3C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;YAE5C,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;gBAC3B,UAAU,GAAG,SAAS,CAAC;gBACvB,SAAS,GAAG,OAAO,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,6EAA6E;YACtF,OAAO,EAAE,EAAE,OAAO,EAAE;YACpB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/commands/phase4.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Phase 4 Command
+ *
+ * Generates Architecture Decision Records (ADRs) and Domain-Driven Design
+ * models (DDDs) from the Phase 2 research dossier and Phase 3 SPARC + TDD
+ * output:
+ *   - Prior Phase Loading (research dossier + SPARC + TDD from disk)
+ *   - ADR Generation (citing SPARC sections + dossier items)
+ *   - DDD Model Generation (bounded contexts, aggregates, ubiquitous language)
+ *
+ * Usage:
+ *   agentics phase4 --trace <TRACE_ID>
+ *   agentics phase4 --latest
+ *
+ * Error codes:
+ *   ECLI-P4-001  Missing Phase 2 or Phase 3 artifacts
+ *   ECLI-P4-005  No runs found (--latest with empty runs dir)
+ *   ECLI-P4-006  Phase 4 output directory already exists (append-only)
+ */
+import type { Phase4ADRPipelineResult } from '../pipeline/phase4-adrs/index.js';
+export interface Phase4CommandOptions {
+    readonly trace?: string;
+    readonly latest?: boolean;
+    readonly verbose?: boolean;
+    readonly format?: 'json' | 'text';
+}
+/**
+ * Execute the `agentics phase4` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 2 and Phase 3 exist and Phase 4 does not, constructs the
+ * Phase4ADRContext, and delegates to the pipeline coordinator.
+ */
+export declare function executePhase4Command(options: Phase4CommandOptions): Promise<Phase4ADRPipelineResult>;
+/**
+ * Format Phase 4 result for human-readable display.
+ */
+export declare function formatPhase4ForDisplay(result: Phase4ADRPipelineResult): string;
+//# sourceMappingURL=phase4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase4.d.ts","sourceRoot":"","sources":["../../src/commands/phase4.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAiBlG,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;CACnC;AAMD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA4HlC;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAmC9E"}

package/dist/commands/phase4.js

@@ -0,0 +1,258 @@
+/**
+ * Phase 4 Command
+ *
+ * Generates Architecture Decision Records (ADRs) and Domain-Driven Design
+ * models (DDDs) from the Phase 2 research dossier and Phase 3 SPARC + TDD
+ * output:
+ *   - Prior Phase Loading (research dossier + SPARC + TDD from disk)
+ *   - ADR Generation (citing SPARC sections + dossier items)
+ *   - DDD Model Generation (bounded contexts, aggregates, ubiquitous language)
+ *
+ * Usage:
+ *   agentics phase4 --trace <TRACE_ID>
+ *   agentics phase4 --latest
+ *
+ * Error codes:
+ *   ECLI-P4-001  Missing Phase 2 or Phase 3 artifacts
+ *   ECLI-P4-005  No runs found (--latest with empty runs dir)
+ *   ECLI-P4-006  Phase 4 output directory already exists (append-only)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CLIError } from '../errors/index.js';
+import { executePhase4ADRPipeline } from '../pipeline/phase4-adrs/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const RUNS_DIR_NAME = '.agentics/runs';
+const PHASE2_SUBDIR = 'phase2';
+const PHASE3_SUBDIR = 'phase3';
+const PHASE4_SUBDIR = 'phase4';
+const DIR_MODE = 0o700;
+// ============================================================================
+// Command Executor
+// ============================================================================
+/**
+ * Execute the `agentics phase4` command.
+ *
+ * Resolves the Phase 1 run directory (via --trace or --latest), validates
+ * that Phase 2 and Phase 3 exist and Phase 4 does not, constructs the
+ * Phase4ADRContext, and delegates to the pipeline coordinator.
+ */
+export async function executePhase4Command(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-P4-001',
+            category: 'INPUT_ERROR',
+            message: 'No trace ID specified. Use --trace <TRACE_ID> or --latest.',
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // ── Validate run directory exists ──
+    if (!fs.existsSync(runDir)) {
+        throw new CLIError({
+            code: 'ECLI-P4-001',
+            category: 'INPUT_ERROR',
+            message: `Run directory not found: ${runDir}`,
+            details: { runDir },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // ── Validate Phase 2 subdirectory exists ──
+    const phase2Dir = path.join(runDir, PHASE2_SUBDIR);
+    if (!fs.existsSync(phase2Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P4-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 2 output not found. Run 'agentics phase2' first: ${phase2Dir}`,
+            details: { phase2Dir },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // ── Validate Phase 3 subdirectory exists with SPARC output ──
+    const phase3Dir = path.join(runDir, PHASE3_SUBDIR);
+    if (!fs.existsSync(phase3Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P4-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 3 output not found. Run 'agentics phase3' first: ${phase3Dir}`,
+            details: { phase3Dir },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    const sparcCombinedPath = path.join(phase3Dir, 'sparc', 'sparc-combined.json');
+    if (!fs.existsSync(sparcCombinedPath)) {
+        throw new CLIError({
+            code: 'ECLI-P4-001',
+            category: 'INPUT_ERROR',
+            message: `Phase 3 SPARC output not found: ${sparcCombinedPath}`,
+            details: { sparcCombinedPath },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // ── Append-only guard: Phase 4 must not already exist ──
+    const phase4Dir = path.join(runDir, PHASE4_SUBDIR);
+    if (fs.existsSync(phase4Dir)) {
+        throw new CLIError({
+            code: 'ECLI-P4-006',
+            category: 'INPUT_ERROR',
+            message: `Phase 4 already exists for this run. Output is append-only: ${phase4Dir}`,
+            details: { phase4Dir },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    // ── Create Phase 4 output directory ──
+    fs.mkdirSync(phase4Dir, { 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 will proceed without it
+    }
+    // ── Construct Phase4ADRContext ──
+    const context = {
+        traceId,
+        phase2Dir,
+        phase3Dir,
+        phase4Dir,
+        scenarioQuery,
+        stageOutputs: new Map(),
+        telemetrySpans: [],
+    };
+    // ── Execute pipeline ──
+    const result = await executePhase4ADRPipeline(context);
+    return result;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format Phase 4 result for human-readable display.
+ */
+export function formatPhase4ForDisplay(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('Phase 4: ADRs + DDDs');
+    lines.push('='.repeat(50));
+    lines.push('');
+    lines.push(`  Trace ID:    ${result.traceId}`);
+    lines.push(`  Output:      ${result.phase4Dir}`);
+    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}"`);
+        const failData = failed.data;
+        if (failData && typeof failData === 'object' && 'error' in failData) {
+            lines.push(`         ${failData['error']}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Find the most recent Phase 1 run directory that has both Phase 2 and
+ * Phase 3 subdirectories, with the Phase 3 sparc-combined.json present.
+ */
+function findLatestRunDir(runsDir) {
+    if (!fs.existsSync(runsDir)) {
+        throw new CLIError({
+            code: 'ECLI-P4-005',
+            category: 'INPUT_ERROR',
+            message: `Runs directory not found: ${runsDir}`,
+            details: { runsDir },
+            module: 'phase4',
+            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 phase2Path = path.join(runPath, PHASE2_SUBDIR);
+        const phase3Path = path.join(runPath, PHASE3_SUBDIR);
+        const sparcPath = path.join(phase3Path, 'sparc', 'sparc-combined.json');
+        // Only consider runs that have Phase 2 output, Phase 3 output, and SPARC
+        if (!fs.existsSync(phase2Path))
+            continue;
+        if (!fs.existsSync(phase3Path))
+            continue;
+        if (!fs.existsSync(sparcPath))
+            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-P4-005',
+            category: 'INPUT_ERROR',
+            message: 'No Phase 3 runs found. Run Phase 1, Phase 2, and Phase 3 first.',
+            details: { runsDir },
+            module: 'phase4',
+            recoverable: false,
+            exitCode: 1,
+        });
+    }
+    return latestDir;
+}
+//# sourceMappingURL=phase4.js.map

package/dist/commands/phase4.js.map

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

package/dist/commands/phase5.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 type { Phase5BuildPipelineResult } from '../pipeline/phase5-build/index.js';
+export interface Phase5CommandOptions {
+    readonly trace?: string;
+    readonly latest?: boolean;
+    readonly verbose?: boolean;
+    readonly format?: 'json' | 'text';
+}
+/**
+ * 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 declare function executePhase5Command(options: Phase5CommandOptions): Promise<Phase5BuildPipelineResult>;
+/**
+ * Format Phase 5 Build result for human-readable display.
+ */
+export declare function formatPhase5ForDisplay(result: Phase5BuildPipelineResult): string;
+//# sourceMappingURL=phase5.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase5.d.ts","sourceRoot":"","sources":["../../src/commands/phase5.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAsB,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAqBvG,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;CACnC;AAMD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,yBAAyB,CAAC,CA0HpC;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAkChF"}