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

package/dist/pipeline/phase2/manifest-writer.js

@@ -0,0 +1,129 @@
+/**
+ * Phase2 Manifest Writer
+ *
+ * Walks the phase2/ directory tree, computes SHA-256 checksums for every file,
+ * and writes phase2-manifest.json with full artifact inventory.
+ *
+ * Follows the atomic write + checksum pattern from
+ * src/synthesis/simulation-artifact-generator.ts
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+const FILE_MODE = 0o600;
+const MANIFEST_FILENAME = 'phase2-manifest.json';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Compute a SHA-256 hex digest of the given string content.
+ *
+ * @param content - UTF-8 string to hash
+ * @returns Lowercase hex SHA-256 checksum
+ */
+export function computeChecksum(content) {
+    return crypto.createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+/**
+ * Write a file atomically via temp-then-rename. On failure the temporary
+ * file is cleaned up and the error is re-thrown.
+ *
+ * @param filePath - Final destination path
+ * @param content  - UTF-8 string content to write
+ */
+function atomicWriteFile(filePath, content) {
+    const tmpPath = `${filePath}.tmp.${process.pid}`;
+    try {
+        fs.writeFileSync(tmpPath, content, { encoding: 'utf-8', mode: FILE_MODE });
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            // Best-effort cleanup; ignore failures
+        }
+        throw err;
+    }
+}
+/**
+ * Recursively collect all files under `dir`, computing a checksum and size
+ * for each. Paths are stored relative to `baseDir`. The manifest file itself
+ * is excluded since it is written after collection.
+ *
+ * @param dir     - Directory to walk
+ * @param baseDir - Root directory for computing relative paths
+ * @returns Sorted array of artifact entries
+ */
+function collectArtifacts(dir, baseDir) {
+    const artifacts = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            artifacts.push(...collectArtifacts(fullPath, baseDir));
+        }
+        else if (entry.isFile()) {
+            const relativePath = path.relative(baseDir, fullPath);
+            // Exclude the manifest itself — it is written after this runs
+            if (relativePath === MANIFEST_FILENAME) {
+                continue;
+            }
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            artifacts.push({
+                path: relativePath,
+                sha256: computeChecksum(content),
+                size_bytes: Buffer.byteLength(content, 'utf-8'),
+            });
+        }
+    }
+    // Sort by path for deterministic output
+    artifacts.sort((a, b) => a.path.localeCompare(b.path));
+    return artifacts;
+}
+// ============================================================================
+// Main
+// ============================================================================
+/**
+ * Build and atomically write the phase2 manifest to `phase2-manifest.json`.
+ *
+ * Walks the phase2 output directory, checksums every artifact, and produces
+ * a manifest with full provenance (trace id, phase1 run id, stage results,
+ * timing, and per-file SHA-256 hashes).
+ *
+ * @param phase2Dir    - Root output directory for phase2 artifacts
+ * @param traceId      - Trace identifier linking phase1 and phase2
+ * @param phase1RunId  - Run identifier from the preceding phase1 execution
+ * @param stageResults - Outputs from each completed phase2 stage
+ * @param totalTiming  - Wall-clock milliseconds for the entire phase2 run
+ * @returns The fully-populated manifest object
+ */
+export function writePhase2Manifest(phase2Dir, traceId, phase1RunId, stageResults, totalTiming) {
+    const artifacts = collectArtifacts(phase2Dir, phase2Dir);
+    const stages = stageResults.map((r) => ({
+        stage: r.stage,
+        status: r.status,
+        timing_ms: r.timing,
+        artifact_count: r.artifacts.length,
+    }));
+    const manifest = {
+        schema_version: '2.0.0',
+        trace_id: traceId,
+        phase1_run_id: phase1RunId,
+        generated_at: new Date().toISOString(),
+        pipeline_version: '1.0.0',
+        stages,
+        artifacts,
+        total_timing_ms: totalTiming,
+        deterministic: true,
+    };
+    const content = JSON.stringify(manifest, null, 2);
+    const manifestPath = path.join(phase2Dir, MANIFEST_FILENAME);
+    atomicWriteFile(manifestPath, content);
+    return manifest;
+}
+//# sourceMappingURL=manifest-writer.js.map

package/dist/pipeline/phase2/manifest-writer.js.map

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

package/dist/pipeline/phase2/phase2-coordinator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Phase2 Pipeline Coordinator
+ *
+ * Orchestrates the 2-stage phase2 pipeline (Deep Research):
+ *   1. Artifact Loading — Load + validate phase1 artifacts
+ *   2. Research Dossier — Deep extraction from artifacts
+ *
+ * SPARC, ADR, DDD, and TDD are now in separate phases (3, 4).
+ * Emits structured telemetry spans and writes phase2-manifest.json on completion.
+ */
+import type { Phase2Context, Phase2PipelineResult } from './types.js';
+/**
+ * Execute the full Phase2 pipeline.
+ *
+ * Runs all 6 stages sequentially. Each stage receives the full context
+ * with outputs from prior stages available via context.stageOutputs.
+ * Fails fast on the first stage failure.
+ */
+export declare function executePhase2Pipeline(context: Phase2Context): Promise<Phase2PipelineResult>;
+//# sourceMappingURL=phase2-coordinator.d.ts.map

package/dist/pipeline/phase2/phase2-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase2-coordinator.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase2/phase2-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,aAAa,EAGb,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAyBpB;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,oBAAoB,CAAC,CA4G/B"}

package/dist/pipeline/phase2/phase2-coordinator.js

@@ -0,0 +1,146 @@
+/**
+ * Phase2 Pipeline Coordinator
+ *
+ * Orchestrates the 2-stage phase2 pipeline (Deep Research):
+ *   1. Artifact Loading — Load + validate phase1 artifacts
+ *   2. Research Dossier — Deep extraction from artifacts
+ *
+ * SPARC, ADR, DDD, and TDD are now in separate phases (3, 4).
+ * Emits structured telemetry spans and writes phase2-manifest.json on completion.
+ */
+import { loadPhase1Artifacts } from './phases/artifact-loader.js';
+import { generateResearchDossier } from './phases/research-dossier.js';
+import { createSpan, endSpan, emitSpan, writeSpans } from './telemetry.js';
+import { writePhase2Manifest } from './manifest-writer.js';
+const PHASE2_STAGES = [
+    { id: 'artifact-loading', label: 'Phase1 Artifact Loading', executor: loadPhase1Artifacts },
+    { id: 'research-dossier', label: 'Research Dossier', executor: generateResearchDossier },
+];
+// ============================================================================
+// Pipeline Executor
+// ============================================================================
+/**
+ * Execute the full Phase2 pipeline.
+ *
+ * Runs all 6 stages sequentially. Each stage receives the full context
+ * with outputs from prior stages available via context.stageOutputs.
+ * Fails fast on the first stage failure.
+ */
+export async function executePhase2Pipeline(context) {
+    const pipelineStart = Date.now();
+    const completedStages = [];
+    const rootSpan = createSpan('phase2-pipeline', 'execute-all', {
+        traceId: context.traceId,
+        phase1Dir: context.phase1Dir,
+        phase2Dir: context.phase2Dir,
+    });
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PHASE 2: SIMULATION ARTIFACT → DEEP RESEARCH');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  Trace ID:   ${context.traceId}`);
+    console.error(`  Phase1 Dir: ${context.phase1Dir}`);
+    console.error(`  Phase2 Dir: ${context.phase2Dir}`);
+    console.error('');
+    for (const stage of PHASE2_STAGES) {
+        console.error(`  >> [${completedStages.length + 1}/${PHASE2_STAGES.length}] ${stage.label}`);
+        const stageSpan = createSpan('phase2-pipeline', stage.id, {}, rootSpan.spanId);
+        let output;
+        try {
+            output = await stage.executor(context);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            output = {
+                stage: stage.id,
+                status: 'failed',
+                data: { error: errMsg },
+                artifacts: [],
+                timing: 0,
+                summary: `  ERROR: ${errMsg}`,
+            };
+        }
+        // Record timing in span
+        const finalSpan = endSpan(stageSpan, output.status === 'completed' ? 'ok' : 'error', {
+            artifactCount: output.artifacts.length,
+            timing: output.timing,
+        });
+        emitSpan(finalSpan);
+        context.telemetrySpans.push(finalSpan);
+        // Store stage output
+        completedStages.push(output);
+        context.stageOutputs.set(stage.id, output);
+        // Show summary
+        if (output.summary) {
+            console.error(output.summary);
+        }
+        console.error('');
+        // Fail fast
+        if (output.status === 'failed') {
+            console.error(`  Stage "${stage.label}" failed. Pipeline halted.`);
+            console.error('');
+            const finalRootSpan = endSpan(rootSpan, 'error', { failedStage: stage.id });
+            context.telemetrySpans.push(finalRootSpan);
+            writeSpans(context.telemetrySpans, context.phase2Dir);
+            return buildResult(context, completedStages, pipelineStart);
+        }
+    }
+    // All stages complete — write manifest and telemetry
+    console.error('  Writing phase2-manifest.json...');
+    const phase1RunId = context.phase1Artifacts.manifest.run_id;
+    const manifest = writePhase2Manifest(context.phase2Dir, context.traceId, phase1RunId, completedStages, Date.now() - pipelineStart);
+    const finalRootSpan = endSpan(rootSpan, 'ok', {
+        totalStages: completedStages.length,
+        totalArtifacts: manifest.artifacts.length,
+    });
+    context.telemetrySpans.push(finalRootSpan);
+    writeSpans(context.telemetrySpans, context.phase2Dir);
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PHASE 2 COMPLETE');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  Output:     ${context.phase2Dir}`);
+    console.error(`  Stages:     ${completedStages.length}/${PHASE2_STAGES.length} completed`);
+    console.error(`  Artifacts:  ${manifest.artifacts.length} files`);
+    console.error(`  Duration:   ${Date.now() - pipelineStart}ms`);
+    console.error('');
+    return {
+        traceId: context.traceId,
+        phase2Dir: context.phase2Dir,
+        manifest,
+        stageResults: completedStages,
+        totalTiming: Date.now() - pipelineStart,
+    };
+}
+// ============================================================================
+// Result Builder
+// ============================================================================
+function buildResult(context, stages, startTime) {
+    const failed = stages.find(s => s.status === 'failed');
+    return {
+        traceId: context.traceId,
+        phase2Dir: context.phase2Dir,
+        manifest: {
+            schema_version: '2.0.0',
+            trace_id: context.traceId,
+            phase1_run_id: context.phase1Artifacts.manifest.run_id,
+            generated_at: new Date().toISOString(),
+            pipeline_version: '1.0.0',
+            stages: stages.map(s => ({
+                stage: s.stage,
+                status: s.status,
+                timing_ms: s.timing,
+                artifact_count: s.artifacts.length,
+            })),
+            artifacts: [],
+            total_timing_ms: Date.now() - startTime,
+            deterministic: false,
+        },
+        stageResults: stages,
+        totalTiming: Date.now() - startTime,
+        ...(failed ? { error: `Pipeline failed at stage: ${failed.stage}` } : {}),
+    };
+}
+//# sourceMappingURL=phase2-coordinator.js.map

package/dist/pipeline/phase2/phase2-coordinator.js.map

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

package/dist/pipeline/phase2/phases/adr-generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Phase 2 Pipeline -- Stage 4: ADR Generator
+ *
+ * Generates Architecture Decision Records DYNAMICALLY from the SPARC output
+ * (Stage 3) and the research dossier (Stage 2). Instead of hardcoding a fixed
+ * set, ADRs are derived by scanning the SPARC output for services, security
+ * boundaries, high-severity risks, inter-service communication needs,
+ * performance targets, compliance constraints, and data persistence concerns.
+ *
+ * Each ADR carries cross-references to both SPARC sections and research
+ * dossier items for full traceability.
+ *
+ * ADR IDs follow the format ADR-P2-NNN. Files are written as Markdown with
+ * a JSON index for programmatic consumption.
+ *
+ * Error codes:
+ *   ECLI-P2-020  SPARC output not available on context
+ *   ECLI-P2-021  ADR file write failure
+ */
+import type { Phase2Context, Phase2StageOutput, Phase2SPARCOutput, Phase2ADRRecord, ResearchDossier } from '../types.js';
+/**
+ * Pure function that dynamically builds ADR records from SPARC output and the
+ * research dossier. The number and content of ADRs depends on what the SPARC
+ * analysis actually produced: one ADR per service, per security boundary, per
+ * high-severity risk, plus conditional ADRs for inter-service communication,
+ * performance targets, compliance, and data persistence.
+ *
+ * No side effects (no file I/O, no telemetry). Exported for unit testing.
+ *
+ * @param sparc   - The SPARC output from Stage 3
+ * @param dossier - The research dossier from Stage 2
+ * @returns Array of Phase2ADRRecord objects (length depends on SPARC content)
+ */
+export declare function buildPhase2ADRs(sparc: Phase2SPARCOutput, dossier: ResearchDossier): Phase2ADRRecord[];
+/**
+ * Stage 4 entry point: generate Architecture Decision Records from the SPARC
+ * output and research dossier stored on the pipeline context.
+ *
+ * Writes Markdown files and a JSON index to `context.phase2Dir/adrs/`.
+ *
+ * @param context - The Phase 2 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export declare function generateADRs(context: Phase2Context): Promise<Phase2StageOutput>;
+//# sourceMappingURL=adr-generator.d.ts.map

package/dist/pipeline/phase2/phases/adr-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-generator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/adr-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EAEhB,MAAM,aAAa,CAAC;AAiqBrB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,eAAe,GACvB,eAAe,EAAE,CAkCnB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAiI5B"}