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

package/dist/pipeline/phase4/phases/metadata-augmentor.js

@@ -0,0 +1,253 @@
+/**
+ * Phase 4 Pipeline -- Stage 8: Metadata Augmentor
+ *
+ * Augments existing Phase 2 Architecture Decision Records (ADRs) with
+ * Phase 4 runtime decisions covering database engine selection, IAM
+ * strategy, deployment target, and ERP integration pattern.
+ *
+ * Reads the Phase 2 ADR index from disk, appends runtime ADRs, and
+ * writes two output files:
+ *   - augmented-adrs.json  (all ADRs: Phase 2 originals + Phase 4 runtime)
+ *   - runtime-decisions.json  (Phase 4 runtime decisions only)
+ *
+ * Exports:
+ *   - augmentMetadata(context) -- pipeline entry point
+ *
+ * Error codes:
+ *   ECLI-P4-080  Missing prerequisite stage output (erp-target-resolution)
+ *   ECLI-P4-081  ADR index load failure
+ *   ECLI-P4-082  Metadata file write failure
+ */
+import { readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+// ============================================================================
+// Runtime Decision Builders
+// ============================================================================
+/**
+ * Build RT-001: Database engine selection.
+ */
+function buildRT001(erpResolution) {
+    const engine = erpResolution.databaseEngine ?? 'none (api-only)';
+    const dialect = erpResolution.sqlDialect ?? 'N/A';
+    return {
+        id: 'RT-001',
+        title: 'Database engine selection',
+        context: `ERP system "${erpResolution.erpSystem}" was detected as the integration target ` +
+            `(confidence ${(erpResolution.confidence * 100).toFixed(0)}%, ` +
+            `source: ${erpResolution.detectionSource}). ` +
+            `The database engine must be authoritative for the ERP vendor's preferred storage layer.`,
+        decision: `Use ${engine} (SQL dialect: ${dialect}) as the primary persistence engine ` +
+            `for all bounded-context repositories.`,
+        rationale: `Authoritative ERP-to-database mapping: ${erpResolution.erpSystem} → ${engine}. ` +
+            `Direct vendor database access avoids additional sync layers and reduces latency. ` +
+            `Constraints imposed by ERP system: ${erpResolution.constraints.join('; ') || 'none recorded'}.`,
+    };
+}
+/**
+ * Build RT-002: IAM strategy.
+ */
+function buildRT002() {
+    return {
+        id: 'RT-002',
+        title: 'IAM strategy',
+        context: 'Cloud Run services need a secure, auditable identity mechanism for ' +
+            'service-to-service calls and ERP surface access.',
+        decision: 'Use GCP service account identity tokens (OIDC) acquired from the instance ' +
+            'metadata server for all outbound service calls.',
+        rationale: 'Cloud Run natively supports Workload Identity Federation and service account ' +
+            'impersonation without storing long-lived credentials in environment variables. ' +
+            'Identity tokens are short-lived (1 hour), automatically rotated, and fully ' +
+            'auditable via Cloud Audit Logs.',
+    };
+}
+/**
+ * Build RT-003: Deployment target.
+ */
+function buildRT003() {
+    return {
+        id: 'RT-003',
+        title: 'Deployment target',
+        context: 'The MVP must be deployable with minimal infrastructure overhead while ' +
+            'supporting autoscaling to zero and per-request IAM scoping.',
+        decision: 'Deploy as a stateless Cloud Run service (Knative Serving) with ' +
+            'minScale=0 and maxScale=10, bound to an IAM service account.',
+        rationale: 'Cloud Run scales to zero when idle (eliminates idle compute cost), ' +
+            'supports Cloud Build native CI/CD, and isolates each service revision ' +
+            'under its own service account identity. Stateless design aligns with ' +
+            'the DDD command/query separation implemented in the domain layer.',
+    };
+}
+/**
+ * Build RT-004: ERP integration pattern.
+ */
+function buildRT004(erpResolution) {
+    const integrationPoints = erpResolution.integrationPoints.join(', ') || 'general ERP surface';
+    return {
+        id: 'RT-004',
+        title: 'ERP integration pattern',
+        context: `The domain layer must communicate with ${erpResolution.erpSystem} ` +
+            `for the following integration points: ${integrationPoints}. ` +
+            `Direct ERP calls from domain code would violate the hexagonal architecture boundary.`,
+        decision: 'Use an adapter chain: domain → infrastructure adapter → erp-client → ' +
+            'ERP surface Cloud Function → ERP system. ' +
+            'No direct ERP SDK imports in domain or application layers.',
+        rationale: 'The adapter chain enforces the hexagonal architecture principle: domain code ' +
+            'depends only on port interfaces, infrastructure adapters implement those ports, ' +
+            'and the erp-client encapsulates all ERP surface HTTP calls with retry and circuit ' +
+            'breaker resilience. This isolates ERP vendor lock-in to the erp-client module and ' +
+            'enables independent testing of each layer via mock substitution.',
+    };
+}
+// ============================================================================
+// ADR Index Loading
+// ============================================================================
+/**
+ * Attempt to load the Phase 2 ADR index from disk.
+ * Returns an empty array if the file does not exist or cannot be parsed.
+ */
+function loadPhase2Adrs(phase2Dir) {
+    const adrIndexPath = join(phase2Dir, 'adrs', 'adr-index.json');
+    try {
+        const raw = readFileSync(adrIndexPath, { encoding: 'utf-8' });
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        // Some implementations wrap the array in an object
+        if (typeof parsed === 'object' && parsed !== null && 'adrs' in parsed) {
+            const wrapped = parsed;
+            if (Array.isArray(wrapped.adrs)) {
+                return wrapped.adrs;
+            }
+        }
+        return [];
+    }
+    catch {
+        // ADR index may not exist in all pipeline runs; treat as empty
+        return [];
+    }
+}
+// ============================================================================
+// File Writing
+// ============================================================================
+/**
+ * Write a metadata file as formatted JSON to disk.
+ */
+function writeMetadataFile(absPath, data) {
+    const dir = absPath.substring(0, absPath.lastIndexOf('/'));
+    mkdirSync(dir, { recursive: true, mode: DIR_MODE });
+    const content = JSON.stringify(data, null, 2) + '\n';
+    try {
+        writeFileSync(absPath, content, { encoding: 'utf-8', mode: FILE_MODE });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P4-082: Failed to write metadata file ${absPath}: ${message}`);
+    }
+}
+// ============================================================================
+// Public: Pipeline Entry Point
+// ============================================================================
+/**
+ * Stage 8 entry point: augment Phase 2 ADRs with Phase 4 runtime decisions.
+ *
+ * Reads ERPResolution from context.stageOutputs.get('erp-target-resolution'),
+ * loads the Phase 2 ADR index from context.phase2Dir/adrs/adr-index.json,
+ * appends four runtime decisions, and writes two JSON files to
+ * phase4/metadata/.
+ *
+ * @param context - The Phase 4 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export function augmentMetadata(context) {
+    const startTime = Date.now();
+    const rootSpan = createSpan('metadata-augmentation', 'augment-metadata', {
+        phase4Dir: context.phase4Dir,
+        phase2Dir: context.phase2Dir,
+        traceId: context.traceId,
+    });
+    try {
+        // Verify ERP target resolution completed
+        const erpStage = context.stageOutputs.get('erp-target-resolution');
+        if (!erpStage || erpStage.status !== 'completed') {
+            throw new Error('ECLI-P4-080: ERP target resolution not available on context. ' +
+                'Ensure the erp-target-resolution stage completed successfully before running metadata-augmentation.');
+        }
+        const erpResolution = erpStage.data;
+        // Build four runtime decisions
+        const runtimeDecisions = [
+            buildRT001(erpResolution),
+            buildRT002(),
+            buildRT003(),
+            buildRT004(erpResolution),
+        ];
+        // Load Phase 2 ADR index from disk
+        const loadSpan = createSpan('metadata-augmentation', 'load-phase2-adrs', { phase2Dir: context.phase2Dir }, rootSpan.spanId);
+        const phase2Adrs = loadPhase2Adrs(context.phase2Dir);
+        const finalLoadSpan = endSpan(loadSpan, 'ok', { adrCount: phase2Adrs.length });
+        emitSpan(finalLoadSpan);
+        // Merge: original Phase 2 ADRs + runtime decisions
+        const augmentedAdrs = [...phase2Adrs, ...runtimeDecisions];
+        // Output directory: phase4/metadata/
+        const metadataDir = join(context.phase4Dir, 'metadata');
+        mkdirSync(metadataDir, { recursive: true, mode: DIR_MODE });
+        const writtenPaths = [];
+        const writeSpan = createSpan('metadata-augmentation', 'write-metadata-files', { metadataDir }, rootSpan.spanId);
+        // augmented-adrs.json
+        const augmentedAdrsPath = join(metadataDir, 'augmented-adrs.json');
+        writeMetadataFile(augmentedAdrsPath, augmentedAdrs);
+        writtenPaths.push(augmentedAdrsPath);
+        // runtime-decisions.json
+        const runtimeDecisionsPath = join(metadataDir, 'runtime-decisions.json');
+        writeMetadataFile(runtimeDecisionsPath, runtimeDecisions);
+        writtenPaths.push(runtimeDecisionsPath);
+        const finalWriteSpan = endSpan(writeSpan, 'ok', { filesWritten: writtenPaths.length });
+        emitSpan(finalWriteSpan);
+        const finalRootSpan = endSpan(rootSpan, 'ok', {
+            phase2AdrCount: phase2Adrs.length,
+            runtimeDecisionCount: runtimeDecisions.length,
+            augmentedADRCount: augmentedAdrs.length,
+            filesWritten: writtenPaths.length,
+        });
+        emitSpan(finalRootSpan);
+        const timing = Date.now() - startTime;
+        const output = {
+            stage: 'metadata-augmentation',
+            status: 'completed',
+            data: {
+                augmentedADRCount: augmentedAdrs.length,
+                runtimeDecisions,
+            },
+            artifacts: writtenPaths,
+            timing,
+            summary: `Augmented metadata: ${phase2Adrs.length} Phase 2 ADRs + ` +
+                `${runtimeDecisions.length} runtime decisions = ${augmentedAdrs.length} total ` +
+                `(${writtenPaths.length} files written in ${timing}ms)`,
+        };
+        context.stageOutputs.set('metadata-augmentation', output);
+        return output;
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const finalRootSpan = endSpan(rootSpan, 'error', { error: errorMessage });
+        emitSpan(finalRootSpan);
+        const timing = Date.now() - startTime;
+        const output = {
+            stage: 'metadata-augmentation',
+            status: 'failed',
+            data: { error: errorMessage },
+            artifacts: [],
+            timing,
+            summary: `Metadata augmentation failed: ${errorMessage}`,
+        };
+        context.stageOutputs.set('metadata-augmentation', output);
+        return output;
+    }
+}
+//# sourceMappingURL=metadata-augmentor.js.map

package/dist/pipeline/phase4/phases/metadata-augmentor.js.map

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

package/dist/pipeline/phase4/phases/phase3-validator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Phase 4 Pipeline — Stage 1: Phase 3 Artifact Validator
+ *
+ * Loads and validates the Phase 3 manifest and all Phase 2 artifacts
+ * required for downstream Phase 4 code generation stages.
+ *
+ * Error codes:
+ *   ECLI-P4-001  Phase 3 manifest missing or validation failed
+ */
+import type { Phase4Context, Phase4StageOutput } from '../types.js';
+/**
+ * Stage 1: Load and validate the Phase 3 manifest and Phase 2 artifacts.
+ *
+ * Reads `phase3-manifest.json` from `context.phase3Dir`, verifies that
+ * `schema_version === '3.0.0'` and `success === true`, then loads all
+ * Phase 2 JSON artifacts from `context.phase2Dir`.
+ *
+ * On success, stores the assembled Phase3Artifacts on `context.phase3Artifacts`
+ * and returns a completed Phase4StageOutput. On failure, returns a failed
+ * output with the error message.
+ *
+ * @param context - The mutable Phase 4 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export declare function validatePhase3Artifacts(context: Phase4Context): Phase4StageOutput;
+//# sourceMappingURL=phase3-validator.d.ts.map

package/dist/pipeline/phase4/phases/phase3-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase3-validator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase4/phases/phase3-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAmB,MAAM,aAAa,CAAC;AA4CrF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA4JjF"}

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

@@ -0,0 +1,184 @@
+/**
+ * Phase 4 Pipeline — Stage 1: Phase 3 Artifact Validator
+ *
+ * Loads and validates the Phase 3 manifest and all Phase 2 artifacts
+ * required for downstream Phase 4 code generation stages.
+ *
+ * Error codes:
+ *   ECLI-P4-001  Phase 3 manifest missing or validation failed
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+// ============================================================================
+// Helper: read + parse a single JSON file
+// ============================================================================
+/**
+ * Read a JSON file from disk, parse it, and return the result.
+ * Throws a descriptive error if the file is missing or unparseable.
+ */
+function readJson(dir, filename) {
+    const filepath = join(dir, filename);
+    if (!existsSync(filepath)) {
+        throw new Error(`ECLI-P4-001: Required artifact missing: ${filename} in ${dir}`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(filepath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P4-001: Artifact read failed: ${filename}: ${message}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`ECLI-P4-001: Artifact parse failed: ${filename}: JSON parse error: ${message}`);
+    }
+}
+// ============================================================================
+// Main: validatePhase3Artifacts
+// ============================================================================
+/**
+ * Stage 1: Load and validate the Phase 3 manifest and Phase 2 artifacts.
+ *
+ * Reads `phase3-manifest.json` from `context.phase3Dir`, verifies that
+ * `schema_version === '3.0.0'` and `success === true`, then loads all
+ * Phase 2 JSON artifacts from `context.phase2Dir`.
+ *
+ * On success, stores the assembled Phase3Artifacts on `context.phase3Artifacts`
+ * and returns a completed Phase4StageOutput. On failure, returns a failed
+ * output with the error message.
+ *
+ * @param context - The mutable Phase 4 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export function validatePhase3Artifacts(context) {
+    const rootSpan = createSpan('phase3-validation', 'validate-all', {
+        phase3Dir: context.phase3Dir,
+        phase2Dir: context.phase2Dir,
+    });
+    try {
+        // -------------------------------------------------------------------------
+        // Step 1: Read and validate phase3-manifest.json
+        // -------------------------------------------------------------------------
+        const manifestSpan = createSpan('phase3-validation', 'load-phase3-manifest', { filename: 'phase3-manifest.json' }, rootSpan.spanId);
+        let phase3Manifest;
+        try {
+            phase3Manifest = readJson(context.phase3Dir, 'phase3-manifest.json');
+            const finalManifestSpan = endSpan(manifestSpan, 'ok', { filename: 'phase3-manifest.json' });
+            emitSpan(finalManifestSpan);
+            context.telemetrySpans.push(finalManifestSpan);
+        }
+        catch (err) {
+            const finalManifestSpan = endSpan(manifestSpan, 'error', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            emitSpan(finalManifestSpan);
+            context.telemetrySpans.push(finalManifestSpan);
+            throw err;
+        }
+        // Validate schema_version and success flag
+        const manifestObj = phase3Manifest;
+        if (manifestObj['schema_version'] !== '3.0.0') {
+            throw new Error(`ECLI-P4-001: Phase 3 manifest schema_version is '${String(manifestObj['schema_version'])}', expected '3.0.0'. ` +
+                'Ensure Phase 3 completed with the current pipeline version.');
+        }
+        if (manifestObj['success'] !== true) {
+            throw new Error('ECLI-P4-001: Phase 3 manifest indicates pipeline did not succeed (success=false). ' +
+                'Re-run Phase 3 to completion before executing Phase 4.');
+        }
+        // Derive implementation language from the manifest
+        const implementationLanguage = manifestObj['implementation_language'] ?? 'typescript';
+        // -------------------------------------------------------------------------
+        // Step 2: Load Phase 2 artifacts from context.phase2Dir
+        // -------------------------------------------------------------------------
+        const artifactFilenames = [
+            'phase2-manifest.json',
+            'sparc/sparc-combined.json',
+            'adrs/adr-index.json',
+            'ddd/domain-model.json',
+            'tdd/tdd-plan.json',
+        ];
+        const loadedArtifacts = {};
+        for (const filename of artifactFilenames) {
+            const childSpan = createSpan('phase3-validation', `load-${filename.replace(/\//g, '-')}`, { filename }, rootSpan.spanId);
+            try {
+                loadedArtifacts[filename] = readJson(context.phase2Dir, filename);
+                const finalChild = endSpan(childSpan, 'ok', { filename });
+                emitSpan(finalChild);
+                context.telemetrySpans.push(finalChild);
+            }
+            catch (err) {
+                const finalChild = endSpan(childSpan, 'error', {
+                    filename,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                emitSpan(finalChild);
+                context.telemetrySpans.push(finalChild);
+                throw err;
+            }
+        }
+        // -------------------------------------------------------------------------
+        // Step 3: Assemble Phase3Artifacts and mutate context
+        // -------------------------------------------------------------------------
+        const phase2Artifacts = {
+            manifest: loadedArtifacts['phase2-manifest.json'],
+            sparc: loadedArtifacts['sparc/sparc-combined.json'],
+            adrs: loadedArtifacts['adrs/adr-index.json'],
+            domainModel: loadedArtifacts['ddd/domain-model.json'],
+            tddPlan: loadedArtifacts['tdd/tdd-plan.json'],
+        };
+        const phase3Artifacts = {
+            manifest: manifestObj,
+            implementationLanguage: implementationLanguage,
+            projectDir: join(context.phase3Dir, 'project'),
+            phase2Artifacts: phase2Artifacts,
+        };
+        // Mutate context to store the loaded artifacts
+        context['phase3Artifacts'] = phase3Artifacts;
+        // -------------------------------------------------------------------------
+        // Step 4: Build and return stage output
+        // -------------------------------------------------------------------------
+        const finalRootSpan = endSpan(rootSpan, 'ok', {
+            artifactsLoaded: artifactFilenames.length,
+            implementationLanguage,
+            schemaVersion: '3.0.0',
+        });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = finalRootSpan.durationMs ?? 0;
+        const output = {
+            stage: 'phase3-validation',
+            status: 'completed',
+            data: phase3Artifacts,
+            artifacts: artifactFilenames.map((f) => join(context.phase2Dir, f)),
+            timing,
+            summary: `  [OK] Loaded Phase 3 manifest (schema_version=3.0.0, success=true) ` +
+                `and ${artifactFilenames.length} Phase 2 artifacts ` +
+                `(language=${implementationLanguage}) in ${timing}ms`,
+        };
+        context.stageOutputs.set('phase3-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: 'phase3-validation',
+            status: 'failed',
+            data: { error: errorMessage },
+            artifacts: [],
+            timing,
+            summary: `  [FAIL] Phase 3 artifact validation failed: ${errorMessage}`,
+        };
+        context.stageOutputs.set('phase3-validation', output);
+        return output;
+    }
+}
+//# sourceMappingURL=phase3-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase3-validator.js","sourceRoot":"","sources":["../../../../src/pipeline/phase4/phases/phase3-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1E,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,QAAgB;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,OAAO,GAAG,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,sCAAsC,QAAQ,KAAK,OAAO,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,uBAAuB,OAAO,EAAE,CAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,mBAAmB,EAAE,cAAc,EAAE;QAC/D,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,4EAA4E;QAC5E,iDAAiD;QACjD,4EAA4E;QAC5E,MAAM,YAAY,GAAG,UAAU,CAC7B,mBAAmB,EACnB,sBAAsB,EACtB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,EACpC,QAAQ,CAAC,MAAM,CAChB,CAAC;QAEF,IAAI,cAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;YACrE,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC,CAAC;YAC5F,QAAQ,CAAC,iBAAiB,CAAC,CAAC;YAC5B,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE;gBACvD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,QAAQ,CAAC,iBAAiB,CAAC,CAAC;YAC5B,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC/C,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,2CAA2C;QAC3C,MAAM,WAAW,GAAG,cAAyC,CAAC;QAC9D,IAAI,WAAW,CAAC,gBAAgB,CAAC,KAAK,OAAO,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,oDAAoD,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,uBAAuB;gBAChH,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,oFAAoF;gBACpF,wDAAwD,CACzD,CAAC;QACJ,CAAC;QAED,mDAAmD;QACnD,MAAM,sBAAsB,GAAI,WAAW,CAAC,yBAAyB,CAAY,IAAI,YAAY,CAAC;QAElG,4EAA4E;QAC5E,wDAAwD;QACxD,4EAA4E;QAC5E,MAAM,iBAAiB,GAAG;YACxB,sBAAsB;YACtB,2BAA2B;YAC3B,qBAAqB;YACrB,uBAAuB;YACvB,mBAAmB;SACX,CAAC;QAEX,MAAM,eAAe,GAA4B,EAAE,CAAC;QAEpD,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAC1B,mBAAmB,EACnB,QAAQ,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EACtC,EAAE,QAAQ,EAAE,EACZ,QAAQ,CAAC,MAAM,CAChB,CAAC;YAEF,IAAI,CAAC;gBACH,eAAe,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAClE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC1D,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACrB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE;oBAC7C,QAAQ;oBACR,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;gBACH,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACrB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,sDAAsD;QACtD,4EAA4E;QAC5E,MAAM,eAAe,GAAG;YACtB,QAAQ,EAAE,eAAe,CAAC,sBAAsB,CAAC;YACjD,KAAK,EAAE,eAAe,CAAC,2BAA2B,CAAC;YACnD,IAAI,EAAE,eAAe,CAAC,qBAAqB,CAAC;YAC5C,WAAW,EAAE,eAAe,CAAC,uBAAuB,CAAC;YACrD,OAAO,EAAE,eAAe,CAAC,mBAAmB,CAAC;SAC9C,CAAC;QAEF,MAAM,eAAe,GAAoB;YACvC,QAAQ,EAAE,WAAqD;YAC/D,sBAAsB,EAAE,sBAAmE;YAC3F,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;YAC9C,eAAe,EAAE,eAAqD;SACvE,CAAC;QAEF,+CAA+C;QAC9C,OAA8C,CAAC,iBAAiB,CAAC,GAAG,eAAe,CAAC;QAErF,4EAA4E;QAC5E,wCAAwC;QACxC,4EAA4E;QAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC5C,eAAe,EAAE,iBAAiB,CAAC,MAAM;YACzC,sBAAsB;YACtB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QACH,QAAQ,CAAC,aAAa,CAAC,CAAC;QACxB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,IAAI,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAsB;YAChC,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACnE,MAAM;YACN,OAAO,EACL,sEAAsE;gBACtE,OAAO,iBAAiB,CAAC,MAAM,qBAAqB;gBACpD,aAAa,sBAAsB,QAAQ,MAAM,IAAI;SACxD,CAAC;QAEF,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEtE,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1E,QAAQ,CAAC,aAAa,CAAC,CAAC;QACxB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,IAAI,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAsB;YAChC,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;YAC7B,SAAS,EAAE,EAAE;YACb,MAAM;YACN,OAAO,EAAE,gDAAgD,YAAY,EAAE;SACxE,CAAC;QAEF,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/pipeline/phase4/phases/schema-generator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Phase 4 Pipeline — Stage 3: ERP-Native SQL Schema Generator
+ *
+ * Generates CREATE TABLE DDL statements in the SQL dialect of the detected
+ * ERP system's database engine. One .sql file is produced per bounded context
+ * per aggregate/entity. Workday (API-only) is skipped gracefully.
+ *
+ * Supported dialects:
+ *   hana-sql    — SAP HANA COLUMN TABLE syntax
+ *   tsql        — Microsoft SQL Server T-SQL syntax
+ *   oracle-sql  — Oracle Database syntax
+ *   db2-sql     — IBM Db2 syntax
+ *
+ * Error codes:
+ *   ECLI-P4-004  Schema file write failure
+ */
+import type { Phase4Context, Phase4StageOutput } from '../types.js';
+/**
+ * Stage 3: Generate ERP-native SQL schema files for all DDD bounded contexts.
+ *
+ * Reads the ERPResolution from the previous stage and the Phase 2 domain model
+ * from context.phase3Artifacts. For each bounded context, generates one .sql
+ * file per aggregate and standalone entity, using the detected SQL dialect.
+ *
+ * Workday (apiOnly=true) is skipped with a descriptive skip reason.
+ *
+ * @param context - The Phase 4 pipeline context
+ * @returns Stage output describing success, skip, or failure
+ */
+export declare function generateSchemas(context: Phase4Context): Phase4StageOutput;
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/pipeline/phase4/phases/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase4/phases/schema-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAIlB,MAAM,aAAa,CAAC;AAkOrB;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAuLzE"}