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

package/dist/pipeline/phase3/phases/phase2-validator.js

@@ -0,0 +1,168 @@
+/**
+ * Phase 3 Pipeline — Stage 1: Phase 2 Artifact Validator
+ *
+ * Loads and validates all Phase 2 artifacts from disk using Zod schemas.
+ * Each JSON file is parsed and validated against its on-disk schema.
+ *
+ * Error codes:
+ *   ECLI-P3-001  Phase 2 directory or required artifact missing
+ *   ECLI-P3-004  Phase 2 artifact parse / validation failed
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Phase2ManifestOnDiskSchema, SPARCOnDiskSchema, ADRIndexOnDiskSchema, DomainModelOnDiskSchema, TDDPlanOnDiskSchema, } from '../schemas.js';
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+// ============================================================================
+// Helper: read + parse + validate a single JSON artifact
+// ============================================================================
+/**
+ * Read a JSON file, parse it, and validate against `schema`.
+ *
+ * @param dir      - Directory containing the artifact
+ * @param filename - Relative path within the directory
+ * @param schema   - Zod schema to validate the parsed object
+ * @returns The validated object
+ * @throws Error with ECLI-P3-001 if the file does not exist
+ * @throws Error with ECLI-P3-004 if JSON parsing or Zod validation fails
+ */
+function readJsonArtifact(dir, filename, schema) {
+    const filepath = path.join(dir, filename);
+    if (!fs.existsSync(filepath)) {
+        throw new Error(`ECLI-P3-001: Required Phase 2 artifact missing: ${filename} in ${dir}`);
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(filepath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P3-004: Phase 2 artifact read failed: ${filename}: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P3-004: Phase 2 artifact parse failed: ${filename}: JSON parse error: ${message}`);
+    }
+    try {
+        return schema.parse(parsed);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P3-004: Phase 2 artifact validation failed: ${filename}: ${message}`);
+    }
+}
+const ARTIFACT_DESCRIPTORS = [
+    { filename: 'phase2-manifest.json', key: 'manifest', schema: Phase2ManifestOnDiskSchema },
+    { filename: 'sparc/sparc-combined.json', key: 'sparc', schema: SPARCOnDiskSchema },
+    { filename: 'adrs/adr-index.json', key: 'adrs', schema: ADRIndexOnDiskSchema },
+    { filename: 'ddd/domain-model.json', key: 'domainModel', schema: DomainModelOnDiskSchema },
+    { filename: 'tdd/tdd-plan.json', key: 'tddPlan', schema: TDDPlanOnDiskSchema },
+];
+// ============================================================================
+// Main: validatePhase2Artifacts
+// ============================================================================
+/**
+ * Load and validate all Phase 2 artifacts from disk.
+ *
+ * Creates telemetry spans for overall loading and per-file operations.
+ * On success, stores the assembled Phase2Artifacts on `context.phase2Artifacts`
+ * and the scenario query on `context.scenarioQuery`, then returns a completed
+ * Phase3StageOutput. On failure, returns a failed output with the error message.
+ *
+ * @param context - The mutable Phase 3 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export async function validatePhase2Artifacts(context) {
+    const rootSpan = createSpan('phase2-validation', 'validate-all', {
+        phase2Dir: context.phase2Dir,
+        artifactCount: ARTIFACT_DESCRIPTORS.length,
+    });
+    try {
+        // Check Phase 2 directory exists
+        if (!fs.existsSync(context.phase2Dir)) {
+            throw new Error(`ECLI-P3-001: Phase 2 output directory not found: ${context.phase2Dir}`);
+        }
+        const artifacts = {};
+        const loadedFilenames = [];
+        for (const descriptor of ARTIFACT_DESCRIPTORS) {
+            const childSpan = createSpan('phase2-validation', `load-${descriptor.filename.replace(/\//g, '-')}`, { filename: descriptor.filename }, rootSpan.spanId);
+            try {
+                artifacts[descriptor.key] = readJsonArtifact(context.phase2Dir, descriptor.filename, descriptor.schema);
+                loadedFilenames.push(descriptor.filename);
+                const finalChild = endSpan(childSpan, 'ok', { filename: descriptor.filename });
+                emitSpan(finalChild);
+                context.telemetrySpans.push(finalChild);
+            }
+            catch (err) {
+                const finalChild = endSpan(childSpan, 'error', {
+                    filename: descriptor.filename,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                emitSpan(finalChild);
+                context.telemetrySpans.push(finalChild);
+                throw err;
+            }
+        }
+        const phase2Artifacts = artifacts;
+        // Structural validation: at least 1 bounded context
+        const domainModel = phase2Artifacts.domainModel;
+        if (!domainModel.contexts || domainModel.contexts.length === 0) {
+            throw new Error('ECLI-P3-004: Phase 2 domain model contains no bounded contexts. ' +
+                'At least 1 bounded context is required for code generation.');
+        }
+        // Structural validation: at least 1 test suite
+        const tddPlan = phase2Artifacts.tddPlan;
+        if (!tddPlan.testSuites || tddPlan.testSuites.length === 0) {
+            throw new Error('ECLI-P3-004: Phase 2 TDD plan contains no test suites. ' +
+                'At least 1 test suite is required for test generation.');
+        }
+        // Store artifacts on the mutable context
+        context.phase2Artifacts = phase2Artifacts;
+        // Extract scenario query from the manifest chain
+        const scenarioQuery = phase2Artifacts.manifest['scenario_query']
+            ?? context.scenarioQuery
+            ?? '';
+        context.scenarioQuery = scenarioQuery;
+        const finalRootSpan = endSpan(rootSpan, 'ok', {
+            filesLoaded: loadedFilenames.length,
+            boundedContexts: domainModel.contexts.length,
+            testSuites: tddPlan.testSuites.length,
+        });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = finalRootSpan.durationMs ?? 0;
+        const output = {
+            stage: 'phase2-validation',
+            status: 'completed',
+            data: phase2Artifacts,
+            artifacts: loadedFilenames,
+            timing,
+            summary: `  [OK] Loaded ${loadedFilenames.length} Phase 2 artifacts ` +
+                `(${domainModel.contexts.length} bounded contexts, ` +
+                `${tddPlan.testSuites.length} test suites) in ${timing}ms`,
+        };
+        context.stageOutputs.set('phase2-validation', output);
+        return output;
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const finalRootSpan = endSpan(rootSpan, 'error', { error: errorMessage });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = finalRootSpan.durationMs ?? 0;
+        const output = {
+            stage: 'phase2-validation',
+            status: 'failed',
+            data: { error: errorMessage },
+            artifacts: [],
+            timing,
+            summary: `  [FAIL] Phase 2 artifact validation failed: ${errorMessage}`,
+        };
+        context.stageOutputs.set('phase2-validation', output);
+        return output;
+    }
+}
+//# sourceMappingURL=phase2-validator.js.map

package/dist/pipeline/phase3/phases/phase2-validator.js.map

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

package/dist/pipeline/phase3/phases/ruflo-executor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Phase 3 Ruflo Executor
+ *
+ * Invokes the ruflo CLI tool via child_process to fill implementation
+ * stubs in the generated project scaffold. If ruflo is not installed,
+ * the stage completes with a warning rather than failing the pipeline.
+ *
+ * Export:
+ *   - executeRuflo() — pipeline stage entry returning Phase3StageOutput
+ */
+import type { Phase3Context, Phase3StageOutput } from '../types.js';
+/**
+ * Pipeline stage entry point for ruflo execution.
+ *
+ * Checks whether ruflo is installed, and if so invokes it to fill
+ * implementation stubs in the generated project. If ruflo is not
+ * installed, the stage completes successfully with a warning rather
+ * than failing the pipeline.
+ *
+ * @param context - The Phase 3 pipeline context
+ * @returns Phase3StageOutput summarizing ruflo execution results
+ */
+export declare function executeRuflo(context: Phase3Context): Phase3StageOutput;
+//# sourceMappingURL=ruflo-executor.d.ts.map

package/dist/pipeline/phase3/phases/ruflo-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruflo-executor.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase3/phases/ruflo-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AAmDrB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA8JtE"}

package/dist/pipeline/phase3/phases/ruflo-executor.js

@@ -0,0 +1,197 @@
+/**
+ * Phase 3 Ruflo Executor
+ *
+ * Invokes the ruflo CLI tool via child_process to fill implementation
+ * stubs in the generated project scaffold. If ruflo is not installed,
+ * the stage completes with a warning rather than failing the pipeline.
+ *
+ * Export:
+ *   - executeRuflo() — pipeline stage entry returning Phase3StageOutput
+ */
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+import { execSync, spawnSync } from 'node:child_process';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum time (ms) to wait for the ruflo process. */
+const RUFLO_TIMEOUT = 300_000; // 5 minutes
+/** Timeout for installation checks. */
+const CHECK_TIMEOUT = 10_000;
+/** Shorter timeout for `which` fallback. */
+const WHICH_TIMEOUT = 5_000;
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Check whether ruflo is installed globally and attempt to determine its
+ * version string. Falls back to `which ruflo` if the npm list approach
+ * fails.
+ *
+ * @returns An object indicating whether ruflo was found and its version
+ */
+function checkRufloInstalled() {
+    try {
+        const output = execSync('npm list -g ruflo@alpha', {
+            encoding: 'utf-8',
+            timeout: CHECK_TIMEOUT,
+        });
+        const match = output.match(/ruflo@([^\s\n]+)/);
+        return { installed: true, version: match?.[1] ?? 'unknown' };
+    }
+    catch {
+        // Fallback: try which
+        try {
+            execSync('which ruflo', { encoding: 'utf-8', timeout: WHICH_TIMEOUT });
+            return { installed: true, version: 'unknown' };
+        }
+        catch {
+            return { installed: false, version: 'N/A' };
+        }
+    }
+}
+// ============================================================================
+// Pipeline Stage Entry
+// ============================================================================
+/**
+ * Pipeline stage entry point for ruflo execution.
+ *
+ * Checks whether ruflo is installed, and if so invokes it to fill
+ * implementation stubs in the generated project. If ruflo is not
+ * installed, the stage completes successfully with a warning rather
+ * than failing the pipeline.
+ *
+ * @param context - The Phase 3 pipeline context
+ * @returns Phase3StageOutput summarizing ruflo execution results
+ */
+export function executeRuflo(context) {
+    const span = createSpan('ruflo-execution', 'execute-ruflo');
+    const startTime = Date.now();
+    try {
+        // ---- Check ruflo installation ----
+        const rufloCheck = checkRufloInstalled();
+        if (!rufloCheck.installed) {
+            const timing = Date.now() - startTime;
+            const skippedSpan = endSpan(span, 'ok', {
+                rufloInstalled: false,
+                skipped: true,
+                timingMs: timing,
+            });
+            emitSpan(skippedSpan);
+            context.telemetrySpans.push(skippedSpan);
+            return {
+                stage: 'ruflo-execution',
+                status: 'completed',
+                data: { skipped: true, reason: 'ruflo not installed' },
+                artifacts: [],
+                timing,
+                summary: 'Ruflo execution skipped: ruflo is not installed. Install ruflo@alpha globally to enable stub filling.',
+            };
+        }
+        // ---- Resolve language from prior stage ----
+        const langStageOutput = context.stageOutputs.get('language-resolution');
+        if (!langStageOutput || langStageOutput.status === 'failed') {
+            const timing = Date.now() - startTime;
+            const failedSpan = endSpan(span, 'error', { reason: 'language-resolution not available' });
+            emitSpan(failedSpan);
+            context.telemetrySpans.push(failedSpan);
+            return {
+                stage: 'ruflo-execution',
+                status: 'failed',
+                data: { error: 'ECLI-P3-003: language-resolution stage output not available' },
+                artifacts: [],
+                timing,
+                summary: 'Ruflo execution failed: language resolution not available.',
+            };
+        }
+        const langResolution = langStageOutput.data;
+        const language = langResolution.language;
+        // ---- Build ruflo command ----
+        const phase2Dir = context.phase2Dir;
+        const phase3Dir = context.phase3Dir;
+        const projectDir = `${phase3Dir}/project`;
+        const args = [
+            'fill',
+            '--language', language,
+            '--adr-index', `${phase2Dir}/adrs/adr-index.json`,
+            '--ddd-model', `${phase2Dir}/ddd/domain-model.json`,
+            '--tdd-plan', `${phase2Dir}/tdd/tdd-plan.json`,
+            '--target', projectDir,
+        ];
+        // ---- Execute ruflo ----
+        const rufloStart = Date.now();
+        const result = spawnSync('ruflo', args, {
+            cwd: projectDir,
+            timeout: RUFLO_TIMEOUT,
+            encoding: 'utf-8',
+        });
+        const rufloTimingMs = Date.now() - rufloStart;
+        const stdout = result.stdout ?? '';
+        const stderr = result.stderr ?? '';
+        const exitCode = result.status ?? 1;
+        // ---- Parse files modified from stdout (best-effort) ----
+        const filesModifiedMatch = stdout.match(/(\d+)\s+files?\s+modified/i);
+        const filesModified = filesModifiedMatch?.[1] ? parseInt(filesModifiedMatch[1], 10) : 0;
+        const rufloResult = {
+            exitCode,
+            stdout,
+            stderr,
+            version: rufloCheck.version,
+            filesModified,
+            timingMs: rufloTimingMs,
+        };
+        // ---- Handle failure ----
+        if (exitCode !== 0) {
+            const timing = Date.now() - startTime;
+            const failedSpan = endSpan(span, 'error', {
+                rufloVersion: rufloCheck.version,
+                exitCode,
+                timingMs: timing,
+                stderr: stderr.slice(0, 500),
+            });
+            emitSpan(failedSpan);
+            context.telemetrySpans.push(failedSpan);
+            return {
+                stage: 'ruflo-execution',
+                status: 'failed',
+                data: { error: `ECLI-P3-003: ruflo exited with code ${exitCode}`, rufloResult },
+                artifacts: [],
+                timing,
+                summary: `Ruflo execution failed with exit code ${exitCode}: ${stderr.slice(0, 200)}`,
+            };
+        }
+        // ---- Success ----
+        const timing = Date.now() - startTime;
+        const completedSpan = endSpan(span, 'ok', {
+            rufloVersion: rufloCheck.version,
+            exitCode: 0,
+            filesModified,
+            timingMs: timing,
+        });
+        emitSpan(completedSpan);
+        context.telemetrySpans.push(completedSpan);
+        return {
+            stage: 'ruflo-execution',
+            status: 'completed',
+            data: rufloResult,
+            artifacts: [],
+            timing,
+            summary: `Ruflo v${rufloCheck.version} filled ${filesModified} implementation stubs in ${rufloTimingMs}ms.`,
+        };
+    }
+    catch (err) {
+        const timing = Date.now() - startTime;
+        const message = err instanceof Error ? err.message : String(err);
+        const errorSpan = endSpan(span, 'error', { error: message });
+        emitSpan(errorSpan);
+        context.telemetrySpans.push(errorSpan);
+        return {
+            stage: 'ruflo-execution',
+            status: 'failed',
+            data: { error: `ECLI-P3-003: ${message}` },
+            artifacts: [],
+            timing,
+            summary: `Ruflo execution failed: ${message}`,
+        };
+    }
+}
+//# sourceMappingURL=ruflo-executor.js.map

package/dist/pipeline/phase3/phases/ruflo-executor.js.map

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

package/dist/pipeline/phase3/phases/scaffold-generator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Phase 3 Pipeline -- Stage 3: Scaffold Generator
+ *
+ * Generates the project scaffold (directory structure + config files)
+ * for either TypeScript or Rust, based on the resolved implementation
+ * language and the DDD domain model from Phase 2.
+ *
+ * Exports:
+ *   - buildScaffold(language, domainModel, phase3Dir) -- pure builder (no I/O)
+ *   - generateScaffold(context) -- async pipeline entry point
+ *
+ * Error codes:
+ *   ECLI-P3-020  Missing prerequisite stage output (language-resolution)
+ *   ECLI-P3-021  Scaffold file write failure
+ */
+import type { Phase3Context, Phase3StageOutput, ImplementationLanguage, ScaffoldMetadata, Phase2DomainModel } from '../types.js';
+/**
+ * Pure function that builds the scaffold metadata (including all file
+ * contents) from a resolved language, a DDD domain model, and a trace ID.
+ * No side effects -- does not write anything to disk.
+ *
+ * @param language    - The resolved implementation language
+ * @param domainModel - The Phase 2 DDD domain model
+ * @param traceId     - Unique trace identifier for naming
+ * @returns ScaffoldMetadata describing all files to create
+ */
+export declare function buildScaffold(language: ImplementationLanguage, domainModel: Phase2DomainModel, traceId: string): ScaffoldMetadata;
+/**
+ * Stage 3 entry point: generate the project scaffold from the resolved
+ * implementation language and DDD domain model stored on the pipeline context.
+ *
+ * Reads LanguageResolution from context.stageOutputs.get('language-resolution'),
+ * calls buildScaffold, writes all files to disk, and returns the stage output.
+ *
+ * @param context - The Phase 3 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export declare function generateScaffold(context: Phase3Context): Promise<Phase3StageOutput>;
+//# sourceMappingURL=scaffold-generator.d.ts.map

package/dist/pipeline/phase3/phases/scaffold-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-generator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase3/phases/scaffold-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EAGtB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AA8ZrB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,sBAAsB,EAChC,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,GACd,gBAAgB,CA+BlB;AA6CD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAmG5B"}