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

package/dist/pipeline/phase4-adrs/phase4-adrs-coordinator.js

@@ -0,0 +1,312 @@
+/**
+ * Phase 4 Pipeline Coordinator (ADRs + DDDs)
+ *
+ * Orchestrates the 3-stage Phase 4 pipeline:
+ *   1. Prior Phase Loading — Load research dossier + SPARC + TDD from disk
+ *   2. ADR Generation — Architecture Decision Records citing SPARC + dossier
+ *   3. DDD Model Generation — Bounded contexts, aggregates, ubiquitous language
+ *
+ * Reuses the existing ADR and DDD generators from the Phase 2 pipeline by
+ * constructing a Phase2Context with phase2Dir pointing to the phase4/ output
+ * directory and pre-populating stageOutputs with data loaded from prior phases.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { generateADRs } from '../phase2/phases/adr-generator.js';
+import { generateDDDModel } from '../phase2/phases/ddd-generator.js';
+import { createSpan, endSpan, emitSpan, writeSpans } from '../phase2/telemetry.js';
+import { writePhase4ADRManifest } from './manifest-writer.js';
+const STAGES = [
+    { id: 'prior-phase-loading', label: 'Prior Phase Loading' },
+    { id: 'adr-generation', label: 'ADR Generation' },
+    { id: 'ddd-generation', label: 'DDD Model Generation' },
+];
+// ============================================================================
+// Artifact Loaders
+// ============================================================================
+/**
+ * Load Phase 1 artifacts from the run directory root.
+ * Reads manifest.json, scenario.json, roadmap.json, executive-summary.md,
+ * risk-assessment.json, and decision-memo.md. Missing files produce empty
+ * defaults rather than errors.
+ */
+function loadPhase1ArtifactsFromDisk(runDir) {
+    const readJSON = (name) => {
+        const filePath = path.join(runDir, name);
+        if (!fs.existsSync(filePath))
+            return {};
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    };
+    const readText = (name) => {
+        const filePath = path.join(runDir, name);
+        if (!fs.existsSync(filePath))
+            return '';
+        return fs.readFileSync(filePath, 'utf-8');
+    };
+    return {
+        manifest: readJSON('manifest.json'),
+        scenario: readJSON('scenario.json'),
+        roadmap: readJSON('roadmap.json'),
+        executiveSummary: readText('executive-summary.md'),
+        riskAssessment: readJSON('risk-assessment.json'),
+        decisionMemo: readText('decision-memo.md'),
+    };
+}
+// ============================================================================
+// Pipeline Executor
+// ============================================================================
+/**
+ * Execute the Phase 4 ADR + DDD pipeline.
+ *
+ * Loads prior-phase artifacts from disk, then delegates to the existing
+ * ADR and DDD generators from the Phase 2 pipeline. All output is written
+ * to the phase4/ directory.
+ *
+ * @param context - Phase 4 pipeline context with directory paths and trace ID
+ * @returns Pipeline result with manifest, stage outputs, and timing
+ */
+export async function executePhase4ADRPipeline(context) {
+    const pipelineStart = Date.now();
+    const completedStages = [];
+    const rootSpan = createSpan('phase4-adrs-pipeline', 'execute-all', {
+        traceId: context.traceId,
+        phase3Dir: context.phase3Dir,
+        phase4Dir: context.phase4Dir,
+    });
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PHASE 4: SPARC -> ARCHITECTURE DECISION RECORDS + DDD');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  Trace ID:   ${context.traceId}`);
+    console.error(`  Phase3 Dir: ${context.phase3Dir}`);
+    console.error(`  Phase4 Dir: ${context.phase4Dir}`);
+    console.error('');
+    // ── Stage 1: Load Prior Phase Artifacts ──────────────────────────────────
+    console.error(`  >> [1/${STAGES.length}] ${STAGES[0].label}`);
+    const loadSpan = createSpan('phase4-adrs-pipeline', 'prior-phase-loading', {}, rootSpan.spanId);
+    const loadStart = Date.now();
+    let phase1Artifacts;
+    try {
+        const runDir = path.dirname(context.phase2Dir);
+        phase1Artifacts = loadPhase1ArtifactsFromDisk(runDir);
+        // Load research dossier from Phase 2
+        const dossierPath = path.join(context.phase2Dir, 'research-dossier.json');
+        if (!fs.existsSync(dossierPath)) {
+            throw new Error(`Research dossier not found: ${dossierPath}`);
+        }
+        const researchDossier = JSON.parse(fs.readFileSync(dossierPath, 'utf-8'));
+        // Load SPARC from Phase 3
+        const sparcPath = path.join(context.phase3Dir, 'sparc', 'sparc-combined.json');
+        if (!fs.existsSync(sparcPath)) {
+            throw new Error(`SPARC combined output not found: ${sparcPath}`);
+        }
+        const sparc = JSON.parse(fs.readFileSync(sparcPath, 'utf-8'));
+        // Load TDD plan from Phase 3 (optional, for cross-reference)
+        let tddPlan = null;
+        const tddPath = path.join(context.phase3Dir, 'tdd', 'tdd-plan.json');
+        if (fs.existsSync(tddPath)) {
+            tddPlan = JSON.parse(fs.readFileSync(tddPath, 'utf-8'));
+        }
+        // Pre-populate stageOutputs for downstream generators
+        context.stageOutputs.set('artifact-loading', {
+            stage: 'artifact-loading',
+            status: 'completed',
+            data: phase1Artifacts,
+            artifacts: [],
+            timing: 0,
+            summary: '',
+        });
+        context.stageOutputs.set('research-dossier', {
+            stage: 'research-dossier',
+            status: 'completed',
+            data: researchDossier,
+            artifacts: [],
+            timing: 0,
+            summary: '',
+        });
+        context.stageOutputs.set('sparc-specification', {
+            stage: 'sparc-specification',
+            status: 'completed',
+            data: sparc,
+            artifacts: [],
+            timing: 0,
+            summary: '',
+        });
+        if (tddPlan) {
+            context.stageOutputs.set('tdd-plan-generation', {
+                stage: 'tdd-plan-generation',
+                status: 'completed',
+                data: tddPlan,
+                artifacts: [],
+                timing: 0,
+                summary: '',
+            });
+        }
+        const loadOutput = {
+            stage: 'artifact-loading',
+            status: 'completed',
+            data: { researchDossier, sparc, tddPlan },
+            artifacts: [],
+            timing: Date.now() - loadStart,
+            summary: `     Loaded: ${researchDossier.items.length} dossier items, ` +
+                `SPARC (${sparc.architecture?.services?.length ?? 0} services)`,
+        };
+        completedStages.push(loadOutput);
+        context.stageOutputs.set('prior-phase-loading', loadOutput);
+        const finalLoadSpan = endSpan(loadSpan, 'ok', { dossierItems: researchDossier.items.length });
+        emitSpan(finalLoadSpan);
+        context.telemetrySpans.push(finalLoadSpan);
+        console.error(loadOutput.summary);
+        console.error('');
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        const failOutput = {
+            stage: 'artifact-loading',
+            status: 'failed',
+            data: { error: errMsg },
+            artifacts: [],
+            timing: Date.now() - loadStart,
+            summary: `  ERROR: ${errMsg}`,
+        };
+        completedStages.push(failOutput);
+        const finalLoadSpan = endSpan(loadSpan, 'error');
+        context.telemetrySpans.push(finalLoadSpan);
+        writeSpans(context.telemetrySpans, context.phase4Dir);
+        console.error(failOutput.summary);
+        return buildFailResult(context, completedStages, pipelineStart);
+    }
+    // ── Build Phase2Context for reuse of existing generators ─────────────────
+    // The ADR and DDD generators expect a Phase2Context. We construct one with
+    // phase2Dir pointing to phase4Dir so that file output lands in the right
+    // place, and with stageOutputs pre-populated from the loading stage above.
+    const phase2Ctx = {
+        traceId: context.traceId,
+        phase1Dir: path.dirname(context.phase2Dir),
+        phase2Dir: context.phase4Dir, // Generators write to this dir
+        phase1Artifacts: phase1Artifacts,
+        stageOutputs: context.stageOutputs,
+        telemetrySpans: context.telemetrySpans,
+    };
+    // ── Stage 2: ADR Generation ──────────────────────────────────────────────
+    console.error(`  >> [2/${STAGES.length}] ${STAGES[1].label}`);
+    const adrSpan = createSpan('phase4-adrs-pipeline', 'adr-generation', {}, rootSpan.spanId);
+    let adrOutput;
+    try {
+        adrOutput = await generateADRs(phase2Ctx);
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        adrOutput = {
+            stage: 'adr-generation',
+            status: 'failed',
+            data: { error: errMsg },
+            artifacts: [],
+            timing: 0,
+            summary: `  ERROR: ${errMsg}`,
+        };
+    }
+    const finalAdrSpan = endSpan(adrSpan, adrOutput.status === 'completed' ? 'ok' : 'error', {
+        artifactCount: adrOutput.artifacts.length,
+    });
+    emitSpan(finalAdrSpan);
+    context.telemetrySpans.push(finalAdrSpan);
+    completedStages.push(adrOutput);
+    context.stageOutputs.set('adr-generation', adrOutput);
+    if (adrOutput.summary)
+        console.error(adrOutput.summary);
+    console.error('');
+    if (adrOutput.status === 'failed') {
+        writeSpans(context.telemetrySpans, context.phase4Dir);
+        return buildFailResult(context, completedStages, pipelineStart);
+    }
+    // ── Stage 3: DDD Model Generation ───────────────────────────────────────
+    console.error(`  >> [3/${STAGES.length}] ${STAGES[2].label}`);
+    const dddSpan = createSpan('phase4-adrs-pipeline', 'ddd-generation', {}, rootSpan.spanId);
+    let dddOutput;
+    try {
+        dddOutput = await generateDDDModel(phase2Ctx);
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        dddOutput = {
+            stage: 'ddd-generation',
+            status: 'failed',
+            data: { error: errMsg },
+            artifacts: [],
+            timing: 0,
+            summary: `  ERROR: ${errMsg}`,
+        };
+    }
+    const finalDddSpan = endSpan(dddSpan, dddOutput.status === 'completed' ? 'ok' : 'error', {
+        artifactCount: dddOutput.artifacts.length,
+    });
+    emitSpan(finalDddSpan);
+    context.telemetrySpans.push(finalDddSpan);
+    completedStages.push(dddOutput);
+    context.stageOutputs.set('ddd-generation', dddOutput);
+    if (dddOutput.summary)
+        console.error(dddOutput.summary);
+    console.error('');
+    if (dddOutput.status === 'failed') {
+        writeSpans(context.telemetrySpans, context.phase4Dir);
+        return buildFailResult(context, completedStages, pipelineStart);
+    }
+    // ── Write manifest and telemetry ─────────────────────────────────────────
+    console.error('  Writing phase4-manifest.json...');
+    const manifest = writePhase4ADRManifest(context.phase4Dir, context.traceId, completedStages, Date.now() - pipelineStart);
+    const finalRootSpan = endSpan(rootSpan, 'ok', {
+        totalStages: completedStages.length,
+        totalArtifacts: manifest.artifacts.length,
+    });
+    context.telemetrySpans.push(finalRootSpan);
+    writeSpans(context.telemetrySpans, context.phase4Dir);
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PHASE 4 COMPLETE (ADRs + DDDs)');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  Output:     ${context.phase4Dir}`);
+    console.error(`  Stages:     ${completedStages.length}/${STAGES.length} completed`);
+    console.error(`  Artifacts:  ${manifest.artifacts.length} files`);
+    console.error(`  Duration:   ${Date.now() - pipelineStart}ms`);
+    console.error('');
+    return {
+        traceId: context.traceId,
+        phase4Dir: context.phase4Dir,
+        manifest,
+        stageResults: completedStages,
+        totalTiming: Date.now() - pipelineStart,
+    };
+}
+// ============================================================================
+// Result Builder
+// ============================================================================
+/**
+ * Build a failure result when the pipeline cannot continue past a failed stage.
+ */
+function buildFailResult(context, stages, startTime) {
+    return {
+        traceId: context.traceId,
+        phase4Dir: context.phase4Dir,
+        manifest: {
+            schema_version: '4.0.0',
+            trace_id: context.traceId,
+            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,
+            success: false,
+        },
+        stageResults: stages,
+        totalTiming: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=phase4-adrs-coordinator.js.map

package/dist/pipeline/phase4-adrs/phase4-adrs-coordinator.js.map

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

package/dist/pipeline/phase4-adrs/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Phase 4 Pipeline Type Definitions (ADRs + DDDs)
+ *
+ * Phase 4 generates Architecture Decision Records and Domain-Driven Design
+ * models from the Phase 2 research dossier and Phase 3 SPARC + TDD output.
+ */
+import type { TelemetrySpan, Phase2StageOutput } from '../phase2/types.js';
+export type Phase4ADRStage = 'prior-phase-loading' | 'adr-generation' | 'ddd-generation';
+export interface Phase4ADRContext {
+    readonly traceId: string;
+    readonly phase2Dir: string;
+    readonly phase3Dir: string;
+    readonly phase4Dir: string;
+    readonly scenarioQuery: string;
+    readonly stageOutputs: Map<string, Phase2StageOutput>;
+    readonly telemetrySpans: TelemetrySpan[];
+}
+export interface Phase4ADRManifestArtifact {
+    readonly path: string;
+    readonly sha256: string;
+    readonly size_bytes: number;
+}
+export interface Phase4ADRManifest {
+    readonly schema_version: '4.0.0';
+    readonly trace_id: string;
+    readonly generated_at: string;
+    readonly pipeline_version: string;
+    readonly stages: ReadonlyArray<{
+        stage: Phase4ADRStage;
+        status: string;
+        timing_ms: number;
+        artifact_count: number;
+    }>;
+    readonly artifacts: Phase4ADRManifestArtifact[];
+    readonly total_timing_ms: number;
+    readonly success: boolean;
+}
+export interface Phase4ADRPipelineResult {
+    readonly traceId: string;
+    readonly phase4Dir: string;
+    readonly manifest: Phase4ADRManifest;
+    readonly stageResults: Phase2StageOutput[];
+    readonly totalTiming: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/phase4-adrs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC7B,KAAK,EAAE,cAAc,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,EAAE,yBAAyB,EAAE,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/pipeline/phase4-adrs/types.js

@@ -0,0 +1,8 @@
+/**
+ * Phase 4 Pipeline Type Definitions (ADRs + DDDs)
+ *
+ * Phase 4 generates Architecture Decision Records and Domain-Driven Design
+ * models from the Phase 2 research dossier and Phase 3 SPARC + TDD output.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/phase4-adrs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/pipeline/phase5/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Phase 5 Pipeline — Public API
+ *
+ * Pushes Phase 4 deployable services onto an ERP surface with full
+ * registration, materialization, and governance:
+ *   - Phase 4 Artifact Validation
+ *   - ERP Service Registration
+ *   - Project Materialization
+ *   - Deployment Finalization
+ *   - Manifest Writing
+ *
+ * Usage:
+ *   import { executePhase5Pipeline } from './pipeline/phase5/index.js';
+ *   const result = await executePhase5Pipeline(context);
+ */
+export { executePhase5Pipeline } from './phase5-coordinator.js';
+export type { Phase5Context, Phase5Stage, Phase5StageOutput, Phase5PipelineResult, Phase5Manifest, Phase5ManifestArtifact, Phase4Artifacts, Phase4ManifestRef, ERPSurfaceRegistration, ERPEndpointMapping, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/phase5/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase5/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/pipeline/phase5/index.js

@@ -0,0 +1,17 @@
+/**
+ * Phase 5 Pipeline — Public API
+ *
+ * Pushes Phase 4 deployable services onto an ERP surface with full
+ * registration, materialization, and governance:
+ *   - Phase 4 Artifact Validation
+ *   - ERP Service Registration
+ *   - Project Materialization
+ *   - Deployment Finalization
+ *   - Manifest Writing
+ *
+ * Usage:
+ *   import { executePhase5Pipeline } from './pipeline/phase5/index.js';
+ *   const result = await executePhase5Pipeline(context);
+ */
+export { executePhase5Pipeline } from './phase5-coordinator.js';
+//# sourceMappingURL=index.js.map

package/dist/pipeline/phase5/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pipeline/phase5/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/pipeline/phase5/manifest-writer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Phase 5 Manifest Writer
+ *
+ * Walks the phase5/ directory tree, computes SHA-256 checksums for every file,
+ * and writes phase5-manifest.json with full artifact inventory.
+ *
+ * Follows the atomic write + checksum pattern from
+ * src/pipeline/phase4/manifest-writer.ts, adapted for Phase 5 fields:
+ *   - schema_version: '5.0.0'
+ *   - erp_system, service_name, registration_id, endpoints
+ *   - success (derived from stage results)
+ *
+ * Exports:
+ *   - computeChecksum()     — pure SHA-256 hex digest helper
+ *   - writePhase5Manifest() — builds and atomically writes the manifest
+ */
+import type { Phase5StageOutput, Phase5Manifest, ERPSurfaceRegistration } from './types.js';
+/**
+ * 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 declare function computeChecksum(content: string): string;
+/**
+ * Build and atomically write the Phase 5 manifest to `phase5-manifest.json`.
+ *
+ * Walks the Phase 5 output directory, checksums every artifact, and produces
+ * a manifest with full provenance (trace id, ERP system, service registration,
+ * endpoint mappings, stage results, timing, and per-file SHA-256 hashes).
+ *
+ * @param phase5Dir      - Root output directory for Phase 5 artifacts
+ * @param traceId        - Trace identifier linking pipeline phases
+ * @param erpSystem      - The resolved ERP system identifier
+ * @param registration   - The ERP surface registration, or null if skipped
+ * @param stageResults   - Outputs from each completed Phase 5 stage
+ * @param totalTiming    - Wall-clock milliseconds for the entire Phase 5 run
+ * @returns The fully-populated manifest object
+ */
+export declare function writePhase5Manifest(phase5Dir: string, traceId: string, erpSystem: string, registration: ERPSurfaceRegistration | null, stageResults: Phase5StageOutput[], totalTiming: number): Phase5Manifest;
+//# sourceMappingURL=manifest-writer.d.ts.map

package/dist/pipeline/phase5/manifest-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-writer.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase5/manifest-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEd,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAapB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAoED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,sBAAsB,GAAG,IAAI,EAC3C,YAAY,EAAE,iBAAiB,EAAE,EACjC,WAAW,EAAE,MAAM,GAClB,cAAc,CA0BhB"}

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

@@ -0,0 +1,136 @@
+/**
+ * Phase 5 Manifest Writer
+ *
+ * Walks the phase5/ directory tree, computes SHA-256 checksums for every file,
+ * and writes phase5-manifest.json with full artifact inventory.
+ *
+ * Follows the atomic write + checksum pattern from
+ * src/pipeline/phase4/manifest-writer.ts, adapted for Phase 5 fields:
+ *   - schema_version: '5.0.0'
+ *   - erp_system, service_name, registration_id, endpoints
+ *   - success (derived from stage results)
+ *
+ * Exports:
+ *   - computeChecksum()     — pure SHA-256 hex digest helper
+ *   - writePhase5Manifest() — builds and atomically writes the manifest
+ */
+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 = 'phase5-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 Phase 5 manifest to `phase5-manifest.json`.
+ *
+ * Walks the Phase 5 output directory, checksums every artifact, and produces
+ * a manifest with full provenance (trace id, ERP system, service registration,
+ * endpoint mappings, stage results, timing, and per-file SHA-256 hashes).
+ *
+ * @param phase5Dir      - Root output directory for Phase 5 artifacts
+ * @param traceId        - Trace identifier linking pipeline phases
+ * @param erpSystem      - The resolved ERP system identifier
+ * @param registration   - The ERP surface registration, or null if skipped
+ * @param stageResults   - Outputs from each completed Phase 5 stage
+ * @param totalTiming    - Wall-clock milliseconds for the entire Phase 5 run
+ * @returns The fully-populated manifest object
+ */
+export function writePhase5Manifest(phase5Dir, traceId, erpSystem, registration, stageResults, totalTiming) {
+    const artifacts = collectArtifacts(phase5Dir, phase5Dir);
+    const allCompleted = stageResults.every((r) => r.status === 'completed');
+    const manifest = {
+        schema_version: '5.0.0',
+        trace_id: traceId,
+        erp_system: erpSystem,
+        service_name: registration?.service_name ?? 'unknown',
+        registration_id: registration?.registration_id ?? 'none',
+        endpoints: registration?.endpoints.map(e => ({
+            method: e.method,
+            path: e.path,
+            sap_service: e.sap_service,
+        })) ?? [],
+        artifacts,
+        total_timing_ms: totalTiming,
+        success: allCompleted,
+    };
+    const content = JSON.stringify(manifest, null, 2);
+    const manifestPath = path.join(phase5Dir, MANIFEST_FILENAME);
+    atomicWriteFile(manifestPath, content);
+    return manifest;
+}
+//# sourceMappingURL=manifest-writer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-writer.js","sourceRoot":"","sources":["../../../src/pipeline/phase5/manifest-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAQtC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEjD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,OAAe;IACxD,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3E,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAAe;IACpD,MAAM,SAAS,GAA6B,EAAE,CAAC;IAE/C,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEtD,8DAA8D;YAC9D,IAAI,YAAY,KAAK,iBAAiB,EAAE,CAAC;gBACvC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC;gBAChC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,OAAO;AACP,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,OAAe,EACf,SAAiB,EACjB,YAA2C,EAC3C,YAAiC,EACjC,WAAmB;IAEnB,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAmB;QAC/B,cAAc,EAAE,OAAO;QACvB,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,YAAY,EAAE,YAAY,IAAI,SAAS;QACrD,eAAe,EAAE,YAAY,EAAE,eAAe,IAAI,MAAM;QACxD,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,IAAI,EAAE;QACT,SAAS;QACT,eAAe,EAAE,WAAW;QAC5B,OAAO,EAAE,YAAY;KACtB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC7D,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEvC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Phase 5 Pipeline Coordinator
+ *
+ * Orchestrates the 5-stage Phase 5 pipeline:
+ *   1. Phase 4 Artifact Validation  — Load + validate Phase 4 artifacts
+ *   2. Service Registration         — Register service on ERP surface
+ *   3. Project Materialization      — Copy project to phase5/project/
+ *   4. Deployment Finalization      — Generate deployment scripts
+ *   5. Manifest Writing             — SHA-256 checksums, atomic write
+ *
+ * Follows the pattern of src/pipeline/phase4/phase4-coordinator.ts.
+ * Emits structured telemetry spans and writes phase5-manifest.json on completion.
+ */
+import type { Phase5Context, Phase5PipelineResult } from './types.js';
+/**
+ * Execute the full Phase 5 pipeline.
+ *
+ * Runs all 5 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 executePhase5Pipeline(context: Phase5Context): Promise<Phase5PipelineResult>;
+//# sourceMappingURL=phase5-coordinator.d.ts.map

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

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