@llm-dev-ops/agentics-cli 1.6.8 → 1.7.0

package/dist/pipeline/phase3/phases/domain-codegen.js

@@ -3583,6 +3583,13 @@ export function buildDomainCode(domainModel, tddPlan, language, sparc) {
             kind: 'implementation-prompt',
         });
     }
+    // =========================================================================
+    // ADR-PIPELINE-027: Production Infrastructure Files
+    // Every generated project gets config, logging, errors, health, env example
+    // =========================================================================
+    if (isTs) {
+        files.push(...generateInfrastructureFiles(ROOT_DIR));
+    }
     return {
         files,
         totalAggregates,
@@ -3595,6 +3602,292 @@ export function buildDomainCode(domainModel, tddPlan, language, sparc) {
     };
 }
 // ============================================================================
+// ADR-PIPELINE-027: Infrastructure File Generators
+// ============================================================================
+function generateInfrastructureFiles(rootDir) {
+    const files = [];
+    // --- src/config.ts ---
+    files.push({
+        relativePath: `${rootDir}/src/config.ts`,
+        content: [
+            '/**',
+            ' * Central configuration — all settings from environment variables.',
+            ' * ADR-PIPELINE-027: No hardcoded values in business logic.',
+            ' */',
+            '',
+            'function env(key: string, fallback: string): string {',
+            '  return process.env[key] ?? fallback;',
+            '}',
+            '',
+            'function envInt(key: string, fallback: number): number {',
+            '  const v = process.env[key];',
+            '  return v ? parseInt(v, 10) : fallback;',
+            '}',
+            '',
+            'function envFloat(key: string, fallback: number): number {',
+            '  const v = process.env[key];',
+            '  return v ? parseFloat(v) : fallback;',
+            '}',
+            '',
+            'export const config = {',
+            '  erp: {',
+            '    baseUrl: env(\'ERP_BASE_URL\', \'\'),',
+            '    timeoutMs: envInt(\'ERP_TIMEOUT_MS\', 30000),',
+            '    maxRetries: envInt(\'ERP_MAX_RETRIES\', 3),',
+            '  },',
+            '  scoring: {',
+            '    // Override via WEIGHT_* environment variables',
+            '    weights: {} as Record<string, number>,',
+            '  },',
+            '  governance: {',
+            '    approvalExpirationHours: envInt(\'APPROVAL_EXPIRATION_HOURS\', 72),',
+            '    maxPendingApprovals: envInt(\'MAX_PENDING_APPROVALS\', 10),',
+            '    requiredApproverRole: env(\'REQUIRED_APPROVER_ROLE\', \'Manager\'),',
+            '  },',
+            '  logging: {',
+            '    level: env(\'LOG_LEVEL\', \'info\') as \'debug\' | \'info\' | \'warn\' | \'error\',',
+            '  },',
+            '  mockMode: env(\'MOCK_MODE\', \'true\') === \'true\',',
+            '} as const;',
+            '',
+            '// Validate ERP URL is set when not in mock mode',
+            'if (!config.mockMode && !config.erp.baseUrl) {',
+            '  throw new Error(\'ERP_BASE_URL must be set when MOCK_MODE is false\');',
+            '}',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    // --- src/logger.ts ---
+    files.push({
+        relativePath: `${rootDir}/src/logger.ts`,
+        content: [
+            '/**',
+            ' * Structured JSON logger — ADR-PIPELINE-027.',
+            ' * All output is JSON to stdout for cloud-native log aggregation.',
+            ' */',
+            '',
+            'import { config } from \'./config.js\';',
+            '',
+            'type LogLevel = \'debug\' | \'info\' | \'warn\' | \'error\';',
+            'const LEVELS: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };',
+            '',
+            'export function createLogger(component: string) {',
+            '  const minLevel = LEVELS[config.logging.level] ?? 1;',
+            '',
+            '  function log(level: LogLevel, message: string, data?: Record<string, unknown>) {',
+            '    if (LEVELS[level] < minLevel) return;',
+            '    const entry = {',
+            '      level,',
+            '      timestamp: new Date().toISOString(),',
+            '      component,',
+            '      message,',
+            '      ...data,',
+            '    };',
+            '    process.stdout.write(JSON.stringify(entry) + \'\\n\');',
+            '  }',
+            '',
+            '  return {',
+            '    debug: (msg: string, data?: Record<string, unknown>) => log(\'debug\', msg, data),',
+            '    info: (msg: string, data?: Record<string, unknown>) => log(\'info\', msg, data),',
+            '    warn: (msg: string, data?: Record<string, unknown>) => log(\'warn\', msg, data),',
+            '    error: (msg: string, data?: Record<string, unknown>) => log(\'error\', msg, data),',
+            '  };',
+            '}',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    // --- src/errors.ts ---
+    files.push({
+        relativePath: `${rootDir}/src/errors.ts`,
+        content: [
+            '/**',
+            ' * Typed error classes — ADR-PIPELINE-027.',
+            ' * Use these instead of generic Error for structured error handling.',
+            ' */',
+            '',
+            'export class DomainValidationError extends Error {',
+            '  constructor(message: string, public readonly field: string, public readonly value: unknown) {',
+            '    super(`Validation failed: ${message} (field: ${field})`);',
+            '    this.name = \'DomainValidationError\';',
+            '  }',
+            '}',
+            '',
+            'export class ERPIntegrationError extends Error {',
+            '  constructor(message: string, public readonly system: string, public readonly statusCode?: number) {',
+            '    super(`ERP integration failed: ${message} (system: ${system})`);',
+            '    this.name = \'ERPIntegrationError\';',
+            '  }',
+            '}',
+            '',
+            'export class GovernanceViolationError extends Error {',
+            '  constructor(message: string, public readonly requiredRole: string) {',
+            '    super(`Governance violation: ${message} (required role: ${requiredRole})`);',
+            '    this.name = \'GovernanceViolationError\';',
+            '  }',
+            '}',
+            '',
+            'export class ConfigurationError extends Error {',
+            '  constructor(message: string, public readonly variable: string) {',
+            '    super(`Configuration error: ${message} (variable: ${variable})`);',
+            '    this.name = \'ConfigurationError\';',
+            '  }',
+            '}',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    // --- src/retry.ts ---
+    files.push({
+        relativePath: `${rootDir}/src/retry.ts`,
+        content: [
+            '/**',
+            ' * Retry with exponential backoff + circuit breaker — ADR-PIPELINE-027.',
+            ' */',
+            '',
+            'import { config } from \'./config.js\';',
+            'import { createLogger } from \'./logger.js\';',
+            '',
+            'const logger = createLogger(\'retry\');',
+            '',
+            'function isRetryable(err: unknown): boolean {',
+            '  if (err instanceof Error) {',
+            '    // Network errors and 5xx are retryable; 4xx are not',
+            '    const msg = err.message.toLowerCase();',
+            '    if (msg.includes(\'timeout\') || msg.includes(\'econnrefused\') || msg.includes(\'econnreset\')) return true;',
+            '    if (msg.includes(\'5\') && msg.includes(\'00\')) return true; // 500, 502, 503, 504',
+            '  }',
+            '  return false;',
+            '}',
+            '',
+            'export async function withRetry<T>(fn: () => Promise<T>, label = \'operation\'): Promise<T> {',
+            '  const maxRetries = config.erp.maxRetries;',
+            '  for (let attempt = 0; attempt <= maxRetries; attempt++) {',
+            '    try {',
+            '      return await fn();',
+            '    } catch (err) {',
+            '      if (attempt === maxRetries || !isRetryable(err)) {',
+            '        logger.error(`${label} failed after ${attempt + 1} attempt(s)`, {',
+            '          error: err instanceof Error ? err.message : String(err),',
+            '        });',
+            '        throw err;',
+            '      }',
+            '      const delay = Math.min(1000 * Math.pow(2, attempt) + Math.random() * 500, 10000);',
+            '      logger.warn(`${label} attempt ${attempt + 1} failed, retrying in ${Math.round(delay)}ms`, {',
+            '        error: err instanceof Error ? err.message : String(err),',
+            '      });',
+            '      await new Promise(resolve => setTimeout(resolve, delay));',
+            '    }',
+            '  }',
+            '  throw new Error(\'Unreachable\');',
+            '}',
+            '',
+            '// Circuit breaker state',
+            'let failures = 0;',
+            'let circuitOpenUntil = 0;',
+            'const FAILURE_THRESHOLD = 5;',
+            'const RECOVERY_MS = 30000;',
+            '',
+            'export async function withCircuitBreaker<T>(fn: () => Promise<T>, label = \'operation\'): Promise<T> {',
+            '  if (Date.now() < circuitOpenUntil) {',
+            '    throw new Error(`Circuit breaker OPEN for ${label} — retry after ${new Date(circuitOpenUntil).toISOString()}`);',
+            '  }',
+            '  try {',
+            '    const result = await withRetry(fn, label);',
+            '    failures = 0; // Reset on success',
+            '    return result;',
+            '  } catch (err) {',
+            '    failures++;',
+            '    if (failures >= FAILURE_THRESHOLD) {',
+            '      circuitOpenUntil = Date.now() + RECOVERY_MS;',
+            '      logger.error(`Circuit breaker OPENED for ${label} after ${failures} failures`, {',
+            '        recoveryAt: new Date(circuitOpenUntil).toISOString(),',
+            '      });',
+            '    }',
+            '    throw err;',
+            '  }',
+            '}',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    // --- src/health.ts ---
+    files.push({
+        relativePath: `${rootDir}/src/health.ts`,
+        content: [
+            '/**',
+            ' * Health check endpoints — ADR-PIPELINE-027.',
+            ' */',
+            '',
+            'import { config } from \'./config.js\';',
+            '',
+            'export interface HealthStatus {',
+            '  status: \'ok\' | \'degraded\' | \'unhealthy\';',
+            '  timestamp: string;',
+            '  uptime: number;',
+            '  checks: Record<string, \'ok\' | \'fail\'>;',
+            '}',
+            '',
+            'export function checkHealth(): HealthStatus {',
+            '  const checks: Record<string, \'ok\' | \'fail\'> = {};',
+            '',
+            '  // ERP connectivity check',
+            '  checks[\'erp_configured\'] = (config.mockMode || config.erp.baseUrl) ? \'ok\' : \'fail\';',
+            '',
+            '  // Config validity',
+            '  checks[\'config_valid\'] = \'ok\';',
+            '',
+            '  const allOk = Object.values(checks).every(c => c === \'ok\');',
+            '',
+            '  return {',
+            '    status: allOk ? \'ok\' : \'degraded\',',
+            '    timestamp: new Date().toISOString(),',
+            '    uptime: process.uptime(),',
+            '    checks,',
+            '  };',
+            '}',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    // --- .env.example ---
+    files.push({
+        relativePath: `${rootDir}/.env.example`,
+        content: [
+            '# =============================================================================',
+            '# Environment Configuration',
+            '# Copy to .env and fill in values for your deployment.',
+            '# =============================================================================',
+            '',
+            '# ERP Configuration',
+            'ERP_BASE_URL=https://your-erp-instance.example.com/api/v2',
+            'ERP_TIMEOUT_MS=30000',
+            'ERP_MAX_RETRIES=3',
+            '',
+            '# Governance',
+            'APPROVAL_EXPIRATION_HOURS=72',
+            'MAX_PENDING_APPROVALS=10',
+            'REQUIRED_APPROVER_ROLE=Manager',
+            '',
+            '# Logging',
+            'LOG_LEVEL=info',
+            '',
+            '# Feature Flags',
+            'MOCK_MODE=true',
+            '',
+        ].join('\n'),
+        boundedContext: '_infrastructure',
+        kind: 'infrastructure',
+    });
+    return files;
+}
+// ============================================================================
 // Per-Context Implementation Prompt (ADR-004)
 // ============================================================================
 /**