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

package/dist/pipeline/phase5/phases/project-materializer.js

@@ -0,0 +1,319 @@
+/**
+ * Phase 5 — Stage 3: Project Materialization
+ *
+ * Copies the Phase 4 generated project directory into phase5/project/.
+ * Adds runtime wiring:
+ * - Contract schema validation from agentics-contracts
+ * - Health check endpoint
+ * - Telemetry integration
+ */
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+const GENERATED_HEADER = '// Generated by Phase 5 pipeline — do not edit manually\n';
+// ============================================================================
+// Helper: Recursively count files in a directory
+// ============================================================================
+/**
+ * Walk a directory tree and return the total number of files found.
+ * Returns 0 if the directory does not exist.
+ */
+function countFilesRecursive(dir) {
+    if (!existsSync(dir)) {
+        return 0;
+    }
+    let count = 0;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isFile()) {
+            count += 1;
+        }
+        else if (entry.isDirectory()) {
+            count += countFilesRecursive(join(dir, entry.name));
+        }
+    }
+    return count;
+}
+// ============================================================================
+// Helper: Collect all file paths in a directory tree
+// ============================================================================
+/**
+ * Recursively collect all file paths under a directory.
+ * Returns absolute paths.
+ */
+function collectFilePaths(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const results = [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isFile()) {
+            results.push(fullPath);
+        }
+        else if (entry.isDirectory()) {
+            results.push(...collectFilePaths(fullPath));
+        }
+    }
+    return results;
+}
+// ============================================================================
+// Helper: Generate contract validation module
+// ============================================================================
+/**
+ * Generate a contract-validation.ts file that validates ERP deployment
+ * artifacts against the agentics-contracts schema.
+ *
+ * If the agentics-contracts repo is cached, reads the ERPDeploymentArtifact
+ * schema and embeds it. Otherwise, generates a stub with runtime schema
+ * loading support.
+ */
+function generateContractValidation(contractsRepoPath) {
+    let schemaJson = 'null';
+    let schemaSource = 'runtime';
+    if (contractsRepoPath) {
+        const schemaPath = join(contractsRepoPath, 'schemas', 'erp-deployment-artifact.json');
+        if (existsSync(schemaPath)) {
+            try {
+                const raw = readFileSync(schemaPath, 'utf-8');
+                // Validate that it is parseable JSON
+                JSON.parse(raw);
+                schemaJson = raw.trim();
+                schemaSource = 'embedded';
+            }
+            catch {
+                // Malformed schema — fall back to runtime loading
+            }
+        }
+    }
+    return [
+        GENERATED_HEADER,
+        `/**`,
+        ` * Contract validation for ERP deployment artifacts.`,
+        ` *`,
+        ` * Schema source: ${schemaSource}`,
+        ` * Validates request/response payloads against the ERPDeploymentArtifact`,
+        ` * contract defined in the agentics-contracts repository.`,
+        ` */`,
+        ``,
+        `// eslint-disable-next-line @typescript-eslint/no-explicit-any`,
+        `type JsonSchema = Record<string, any>;`,
+        ``,
+        `/**`,
+        ` * Embedded ERPDeploymentArtifact schema.`,
+        ` * If null, the schema must be loaded at runtime from the contracts registry.`,
+        ` */`,
+        `const EMBEDDED_SCHEMA: JsonSchema | null = ${schemaJson};`,
+        ``,
+        `export interface ValidationResult {`,
+        `  readonly valid: boolean;`,
+        `  readonly errors: string[];`,
+        `}`,
+        ``,
+        `/**`,
+        ` * Validate a payload against the ERPDeploymentArtifact schema.`,
+        ` *`,
+        ` * @param payload - The object to validate`,
+        ` * @param schema - Optional schema override (uses embedded schema if omitted)`,
+        ` * @returns Validation result with any errors`,
+        ` */`,
+        `export function validateDeploymentArtifact(`,
+        `  payload: unknown,`,
+        `  schema?: JsonSchema,`,
+        `): ValidationResult {`,
+        `  const activeSchema = schema ?? EMBEDDED_SCHEMA;`,
+        `  const errors: string[] = [];`,
+        ``,
+        `  if (activeSchema === null) {`,
+        `    return {`,
+        `      valid: true,`,
+        `      errors: ['Schema not available — validation skipped'],`,
+        `    };`,
+        `  }`,
+        ``,
+        `  if (typeof payload !== 'object' || payload === null) {`,
+        `    return {`,
+        `      valid: false,`,
+        `      errors: ['Payload must be a non-null object'],`,
+        `    };`,
+        `  }`,
+        ``,
+        `  const obj = payload as Record<string, unknown>;`,
+        ``,
+        `  // Validate required top-level fields from the contract`,
+        `  const requiredFields = activeSchema['required'] as string[] | undefined;`,
+        `  if (Array.isArray(requiredFields)) {`,
+        `    for (const field of requiredFields) {`,
+        `      if (!(field in obj)) {`,
+        `        errors.push(\`Missing required field: \${field}\`);`,
+        `      }`,
+        `    }`,
+        `  }`,
+        ``,
+        `  // Validate field types from the contract properties`,
+        `  const properties = activeSchema['properties'] as Record<string, { type?: string }> | undefined;`,
+        `  if (properties) {`,
+        `    for (const [key, def] of Object.entries(properties)) {`,
+        `      if (key in obj && def.type) {`,
+        `        const actualType = typeof obj[key];`,
+        `        if (def.type === 'string' && actualType !== 'string') {`,
+        `          errors.push(\`Field \${key}: expected string, got \${actualType}\`);`,
+        `        }`,
+        `        if (def.type === 'number' && actualType !== 'number') {`,
+        `          errors.push(\`Field \${key}: expected number, got \${actualType}\`);`,
+        `        }`,
+        `        if (def.type === 'boolean' && actualType !== 'boolean') {`,
+        `          errors.push(\`Field \${key}: expected boolean, got \${actualType}\`);`,
+        `        }`,
+        `      }`,
+        `    }`,
+        `  }`,
+        ``,
+        `  return {`,
+        `    valid: errors.length === 0,`,
+        `    errors,`,
+        `  };`,
+        `}`,
+        ``,
+    ].join('\n');
+}
+// ============================================================================
+// Main: materializeProject
+// ============================================================================
+/**
+ * Stage 3: Materialize the Phase 4 project into the Phase 5 output directory.
+ *
+ * Copies the entire Phase 4 project directory tree into `phase5/project/`
+ * using a recursive copy. Then augments the project with runtime wiring
+ * modules:
+ *
+ * - `contract-validation.ts`: Schema validation against agentics-contracts
+ *   ERPDeploymentArtifact (embedded if the contracts repo is cached,
+ *   otherwise a runtime-loading stub).
+ *
+ * @param context - The mutable Phase 5 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export function materializeProject(context) {
+    const startTime = Date.now();
+    const rootSpan = createSpan('project-materialization', 'materialize-project', {
+        phase5Dir: context.phase5Dir,
+        phase4Dir: context.phase4Dir,
+    });
+    try {
+        // -------------------------------------------------------------------------
+        // Step 1: Locate the Phase 4 project directory
+        // -------------------------------------------------------------------------
+        const locateSpan = createSpan('project-materialization', 'locate-phase4-project', { phase4Dir: context.phase4Dir }, rootSpan.spanId);
+        const phase4ProjectDir = context.phase4Artifacts.projectDir;
+        // If the project directory does not exist, fall back to the phase4Dir root.
+        // This handles pipelines where Phase 4 places all files at the root level
+        // rather than in a project/ subdirectory.
+        const sourceDir = existsSync(phase4ProjectDir)
+            ? phase4ProjectDir
+            : context.phase4Dir;
+        const sourceFileCount = countFilesRecursive(sourceDir);
+        const finalLocateSpan = endSpan(locateSpan, 'ok', {
+            sourceDir,
+            sourceFileCount,
+            usedProjectSubdir: existsSync(phase4ProjectDir),
+        });
+        emitSpan(finalLocateSpan);
+        context.telemetrySpans.push(finalLocateSpan);
+        // -------------------------------------------------------------------------
+        // Step 2: Copy Phase 4 project into phase5/project/
+        // -------------------------------------------------------------------------
+        const copySpan = createSpan('project-materialization', 'copy-project-tree', { sourceDir, sourceFileCount }, rootSpan.spanId);
+        const destDir = join(context.phase5Dir, 'project');
+        mkdirSync(destDir, { recursive: true, mode: DIR_MODE });
+        cpSync(sourceDir, destDir, {
+            recursive: true,
+            force: true,
+            errorOnExist: false,
+        });
+        const copiedFileCount = countFilesRecursive(destDir);
+        const finalCopySpan = endSpan(copySpan, 'ok', {
+            destDir,
+            copiedFileCount,
+        });
+        emitSpan(finalCopySpan);
+        context.telemetrySpans.push(finalCopySpan);
+        // -------------------------------------------------------------------------
+        // Step 3: Generate contract-validation.ts (agentics-contracts wiring)
+        // -------------------------------------------------------------------------
+        const contractSpan = createSpan('project-materialization', 'generate-contract-validation', {}, rootSpan.spanId);
+        const contractsRepoPath = context.platformRepoPaths['agentics-contracts'];
+        const contractValidationContent = generateContractValidation(contractsRepoPath);
+        // Place the contract validation module alongside the project source
+        const contractValidationDir = join(destDir, 'src', 'contracts');
+        mkdirSync(contractValidationDir, { recursive: true, mode: DIR_MODE });
+        const contractValidationPath = join(contractValidationDir, 'contract-validation.ts');
+        writeFileSync(contractValidationPath, contractValidationContent, {
+            encoding: 'utf-8',
+            mode: FILE_MODE,
+        });
+        const finalContractSpan = endSpan(contractSpan, 'ok', {
+            hasEmbeddedSchema: contractsRepoPath !== undefined,
+            contractValidationPath: relative(context.phase5Dir, contractValidationPath),
+        });
+        emitSpan(finalContractSpan);
+        context.telemetrySpans.push(finalContractSpan);
+        // -------------------------------------------------------------------------
+        // Step 4: Count total materialized files
+        // -------------------------------------------------------------------------
+        const totalFiles = countFilesRecursive(destDir);
+        const allFilePaths = collectFilePaths(destDir);
+        // -------------------------------------------------------------------------
+        // Step 5: Build and return stage output
+        // -------------------------------------------------------------------------
+        const finalRootSpan = endSpan(rootSpan, 'ok', {
+            sourceDir,
+            destDir,
+            sourceFileCount,
+            copiedFileCount,
+            totalFiles,
+            contractValidationGenerated: true,
+        });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = Date.now() - startTime;
+        const output = {
+            stage: 'project-materialization',
+            status: 'completed',
+            data: {
+                sourceDir,
+                destDir,
+                sourceFileCount,
+                totalFiles,
+                contractValidationPath,
+            },
+            artifacts: allFilePaths,
+            timing,
+        };
+        context.stageOutputs.set('project-materialization', 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 = Date.now() - startTime;
+        const output = {
+            stage: 'project-materialization',
+            status: 'failed',
+            data: { error: errorMessage },
+            artifacts: [],
+            timing,
+        };
+        context.stageOutputs.set('project-materialization', output);
+        return output;
+    }
+}
+//# sourceMappingURL=project-materializer.js.map

package/dist/pipeline/phase5/phases/project-materializer.js.map

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

package/dist/pipeline/phase5/phases/service-registrar.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Phase 5 — Stage 2: ERP Surface Service Registration
+ *
+ * Generates registration.json and erp-surface-mapping.json.
+ * Uses the erp-surface repo's registration schema and the
+ * agentics-contracts ERPDeploymentArtifact for normalization.
+ *
+ * If the connector-hub/erp-surface Cloud Function is reachable,
+ * calls it for live registration. Otherwise generates deterministic
+ * registration artifacts.
+ */
+import type { Phase5Context, Phase5StageOutput } from '../types.js';
+/**
+ * Stage 2: Register the service on the ERP surface.
+ *
+ * Builds a complete ERPSurfaceRegistration including endpoint mappings for
+ * the four procurement use cases, operational endpoints, VPC configuration,
+ * IAM roles, and governance controls. Writes registration.json and
+ * erp-surface-mapping.json to the Phase 5 output directory.
+ *
+ * If the erp-surface platform repo is cached, reads procurement surface
+ * definitions for enrichment. Attempts live Cloud Function registration
+ * with graceful fallback to deterministic local generation.
+ *
+ * @param context - The mutable Phase 5 pipeline context
+ * @returns Stage output describing success or failure
+ */
+export declare function registerERPSurface(context: Phase5Context): Phase5StageOutput;
+//# sourceMappingURL=service-registrar.d.ts.map

package/dist/pipeline/phase5/phases/service-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registrar.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase5/phases/service-registrar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAA8C,MAAM,aAAa,CAAC;AA+OhH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAsM5E"}