@llm-dev-ops/agentics-cli 1.3.7 → 1.3.9

package/dist/commands/erp.js

@@ -0,0 +1,1064 @@
+/**
+ * ERP Command - Enterprise Resource Planning Surface
+ *
+ * ARCHITECTURE:
+ * - This module provides a sell-grade ERP surface for deployment proposals
+ * - All operations are advisory/non-destructive
+ * - Fleet attribution shows the 51-repo platform involvement
+ *
+ * SUBCOMMANDS:
+ * - list      List available ERP systems
+ * - inspect   Inspect a specific ERP system
+ * - surface   Generate ERP surface analysis for a plan
+ * - map       Map plan to ERP components
+ * - export    Export ERP deployment proposal
+ *
+ * PURPOSE:
+ * - Demonstrate platform orchestration capability
+ * - Generate credible deployment proposals
+ * - Show clear repository attribution
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CLIError } from '../errors/index.js';
+// ============================================================================
+// ERP-Specific Exit Codes
+// ============================================================================
+export const ERP_EXIT_CODES = {
+    SUCCESS: 0,
+    INPUT_ERROR: 100,
+    NOT_FOUND: 100,
+    IO_ERROR: 74,
+    UNEXPECTED_ERROR: 1,
+};
+// ============================================================================
+// Fleet Attribution - The 51-Repo Platform
+// ============================================================================
+/**
+ * Core platform repositories that power the agentics ecosystem.
+ * These are included in attribution metadata to demonstrate orchestration.
+ */
+export const FLEET_REPOSITORIES = {
+    // Core Simulation & Planning
+    simulation: [
+        'agentics-simulation-engine',
+        'agentics-simulation-runner',
+        'agentics-simulation-planner',
+        'agentics-results-index',
+    ],
+    // Deployment & Export
+    deployment: [
+        'agentics-deployment-intent',
+        'agentics-deployment-exporters',
+        'agentics-deployment-validator',
+    ],
+    // Enterprise & Analytics
+    enterprise: [
+        'enterprise-roi-engine',
+        'enterprise-cost-analyzer',
+        'enterprise-compliance-checker',
+    ],
+    // LLM Infrastructure
+    llm: [
+        'llm-orchestrator',
+        'llm-registry',
+        'llm-policy-engine',
+        'llm-analytics-hub',
+        'llm-context-manager',
+    ],
+    // Data & Integration
+    data: [
+        'agentics-data-pipeline',
+        'agentics-manifests',
+        'agentics-schema-registry',
+        'agentics-event-bus',
+    ],
+    // ERP Specific
+    erp: [
+        'erp-connector-sap',
+        'erp-connector-oracle',
+        'erp-connector-netsuite',
+        'erp-connector-dynamics',
+        'erp-mapper-service',
+        'erp-validation-engine',
+    ],
+    // Infrastructure
+    infrastructure: [
+        'agentics-usage-ledger',
+        'agentics-auth-service',
+        'agentics-api-gateway',
+        'agentics-config-service',
+    ],
+    // Compliance & Security
+    compliance: [
+        'diligence-artifacts',
+        'compliance-policy-engine',
+        'security-audit-service',
+        'access-control-service',
+    ],
+    // Monitoring & Observability
+    observability: [
+        'agentics-metrics-collector',
+        'agentics-trace-aggregator',
+        'agentics-alert-manager',
+        'agentics-dashboard-service',
+    ],
+    // CLI & Tools
+    tools: [
+        'agentics-cli',
+        'agentics-sdk-node',
+        'agentics-sdk-python',
+        'agentics-terraform-provider',
+    ],
+};
+/**
+ * Get repositories involved in a specific operation type.
+ */
+export function getInvolvedRepositories(operationType) {
+    const base = ['agentics-cli', 'llm-orchestrator', 'agentics-manifests'];
+    switch (operationType) {
+        case 'erp-list':
+            return [...base, ...FLEET_REPOSITORIES.erp, 'llm-registry'];
+        case 'erp-inspect':
+            return [...base, ...FLEET_REPOSITORIES.erp, 'agentics-schema-registry'];
+        case 'erp-surface':
+            return [
+                ...base,
+                ...FLEET_REPOSITORIES.simulation,
+                ...FLEET_REPOSITORIES.erp,
+                ...FLEET_REPOSITORIES.enterprise,
+                'llm-analytics-hub',
+            ];
+        case 'erp-map':
+            return [
+                ...base,
+                ...FLEET_REPOSITORIES.erp,
+                ...FLEET_REPOSITORIES.data,
+                'enterprise-roi-engine',
+                'agentics-schema-registry',
+            ];
+        case 'erp-export':
+            return [
+                ...base,
+                ...FLEET_REPOSITORIES.erp,
+                ...FLEET_REPOSITORIES.deployment,
+                ...FLEET_REPOSITORIES.compliance,
+                'enterprise-roi-engine',
+            ];
+        default:
+            return base;
+    }
+}
+/**
+ * Get artifact-level attribution for generated files.
+ */
+export function getArtifactAttribution(artifactType) {
+    const base = ['agentics-cli', 'llm-orchestrator', 'llm-registry'];
+    switch (artifactType) {
+        case 'deployment-proposal':
+            return [...base, 'agentics-deployment-intent', 'enterprise-roi-engine', 'erp-mapper-service'];
+        case 'data-mapping':
+            return [...base, 'erp-mapper-service', 'agentics-schema-registry', 'agentics-data-pipeline'];
+        case 'integration-config':
+            return [...base, 'erp-connector-sap', 'erp-connector-oracle', 'erp-validation-engine'];
+        case 'compliance-report':
+            return [...base, 'diligence-artifacts', 'compliance-policy-engine', 'security-audit-service'];
+        default:
+            return base;
+    }
+}
+/**
+ * Static ERP system registry - no live calls required.
+ */
+export const ERP_SYSTEMS = {
+    sap: {
+        id: 'sap',
+        name: 'SAP S/4HANA',
+        vendor: 'SAP SE',
+        version: '2023.FPS02',
+        description: 'Enterprise resource planning suite for large enterprises with comprehensive financial, supply chain, and manufacturing capabilities.',
+        modules: [
+            { id: 'fi', name: 'Financial Accounting', category: 'finance', entities: ['GL Account', 'Cost Center', 'Profit Center', 'Company Code'], api_endpoints: 142 },
+            { id: 'co', name: 'Controlling', category: 'finance', entities: ['Cost Element', 'Internal Order', 'Activity Type'], api_endpoints: 98 },
+            { id: 'mm', name: 'Materials Management', category: 'supply-chain', entities: ['Material', 'Vendor', 'Purchase Order', 'Goods Receipt'], api_endpoints: 156 },
+            { id: 'sd', name: 'Sales & Distribution', category: 'sales', entities: ['Customer', 'Sales Order', 'Delivery', 'Billing Document'], api_endpoints: 134 },
+            { id: 'pp', name: 'Production Planning', category: 'manufacturing', entities: ['Work Center', 'Routing', 'Production Order', 'BOM'], api_endpoints: 112 },
+            { id: 'hr', name: 'Human Capital Management', category: 'hr', entities: ['Employee', 'Position', 'Payroll', 'Time Management'], api_endpoints: 89 },
+        ],
+        integration_types: ['OData', 'BAPI', 'RFC', 'IDoc', 'REST API', 'SOAP'],
+        supported_protocols: ['HTTPS', 'RFC', 'ALE'],
+        compliance_frameworks: ['SOX', 'GDPR', 'SOC2', 'ISO27001', 'HIPAA'],
+        connector_repository: 'erp-connector-sap',
+        documentation_url: 'https://api.sap.com/s4hana',
+    },
+    oracle: {
+        id: 'oracle',
+        name: 'Oracle Fusion Cloud',
+        vendor: 'Oracle Corporation',
+        version: '24A',
+        description: 'Cloud-native ERP suite with AI-powered analytics and comprehensive enterprise functionality.',
+        modules: [
+            { id: 'gl', name: 'General Ledger', category: 'finance', entities: ['Ledger', 'Journal', 'Period', 'Account Combination'], api_endpoints: 78 },
+            { id: 'ap', name: 'Accounts Payable', category: 'finance', entities: ['Supplier', 'Invoice', 'Payment', 'Hold'], api_endpoints: 64 },
+            { id: 'ar', name: 'Accounts Receivable', category: 'finance', entities: ['Customer', 'Transaction', 'Receipt', 'Adjustment'], api_endpoints: 56 },
+            { id: 'scm', name: 'Supply Chain Management', category: 'supply-chain', entities: ['Item', 'Inventory Org', 'Transfer Order', 'Shipment'], api_endpoints: 112 },
+            { id: 'hcm', name: 'Human Capital Management', category: 'hr', entities: ['Person', 'Assignment', 'Absence', 'Compensation'], api_endpoints: 94 },
+            { id: 'eppm', name: 'Project Portfolio Management', category: 'analytics', entities: ['Project', 'Task', 'Resource', 'Budget'], api_endpoints: 67 },
+        ],
+        integration_types: ['REST API', 'SOAP', 'FBDI', 'BIP Reports', 'ADFdi'],
+        supported_protocols: ['HTTPS', 'OAuth 2.0'],
+        compliance_frameworks: ['SOX', 'GDPR', 'SOC1', 'SOC2', 'FedRAMP'],
+        connector_repository: 'erp-connector-oracle',
+        documentation_url: 'https://docs.oracle.com/cloud/fusion',
+    },
+    netsuite: {
+        id: 'netsuite',
+        name: 'Oracle NetSuite',
+        vendor: 'Oracle Corporation',
+        version: '2024.1',
+        description: 'Cloud-based ERP for mid-market companies with unified business management capabilities.',
+        modules: [
+            { id: 'erp', name: 'ERP/Financials', category: 'finance', entities: ['Account', 'Transaction', 'Currency', 'Subsidiary'], api_endpoints: 89 },
+            { id: 'crm', name: 'CRM', category: 'sales', entities: ['Customer', 'Contact', 'Opportunity', 'Campaign'], api_endpoints: 67 },
+            { id: 'inv', name: 'Inventory Management', category: 'supply-chain', entities: ['Item', 'Location', 'Bin', 'Lot'], api_endpoints: 54 },
+            { id: 'psa', name: 'Professional Services', category: 'analytics', entities: ['Project', 'Resource', 'Timesheet', 'Expense'], api_endpoints: 45 },
+            { id: 'wms', name: 'Warehouse Management', category: 'supply-chain', entities: ['Warehouse', 'Zone', 'Pick Task', 'Wave'], api_endpoints: 38 },
+        ],
+        integration_types: ['SuiteScript', 'REST API', 'SOAP', 'SuiteTalk', 'CSV Import'],
+        supported_protocols: ['HTTPS', 'Token-Based Auth', 'OAuth 2.0'],
+        compliance_frameworks: ['SOC1', 'SOC2', 'PCI-DSS', 'GDPR'],
+        connector_repository: 'erp-connector-netsuite',
+        documentation_url: 'https://docs.oracle.com/netsuite',
+    },
+    dynamics365: {
+        id: 'dynamics365',
+        name: 'Microsoft Dynamics 365',
+        vendor: 'Microsoft Corporation',
+        version: '10.0.38',
+        description: 'Integrated business applications suite with deep Microsoft ecosystem integration.',
+        modules: [
+            { id: 'fin', name: 'Finance', category: 'finance', entities: ['Legal Entity', 'Main Account', 'Journal', 'Budget'], api_endpoints: 156 },
+            { id: 'scm', name: 'Supply Chain Management', category: 'supply-chain', entities: ['Product', 'Warehouse', 'Purchase Order', 'Sales Order'], api_endpoints: 189 },
+            { id: 'hr', name: 'Human Resources', category: 'hr', entities: ['Worker', 'Position', 'Department', 'Benefit'], api_endpoints: 78 },
+            { id: 'sales', name: 'Sales', category: 'sales', entities: ['Account', 'Lead', 'Opportunity', 'Quote'], api_endpoints: 134 },
+            { id: 'cs', name: 'Customer Service', category: 'sales', entities: ['Case', 'Queue', 'Entitlement', 'SLA'], api_endpoints: 89 },
+            { id: 'mfg', name: 'Manufacturing', category: 'manufacturing', entities: ['BOM', 'Route', 'Production Order', 'Shop Floor'], api_endpoints: 112 },
+        ],
+        integration_types: ['OData', 'Data Entities', 'Power Automate', 'Logic Apps', 'Azure Service Bus'],
+        supported_protocols: ['HTTPS', 'OAuth 2.0', 'Azure AD'],
+        compliance_frameworks: ['SOC1', 'SOC2', 'ISO27001', 'GDPR', 'HIPAA', 'FedRAMP'],
+        connector_repository: 'erp-connector-dynamics',
+        documentation_url: 'https://docs.microsoft.com/dynamics365',
+    },
+    workday: {
+        id: 'workday',
+        name: 'Workday',
+        vendor: 'Workday, Inc.',
+        version: '2024R1',
+        description: 'Cloud-based enterprise management platform focused on human capital and financial management.',
+        modules: [
+            { id: 'hcm', name: 'Human Capital Management', category: 'hr', entities: ['Worker', 'Organization', 'Job Profile', 'Compensation'], api_endpoints: 234 },
+            { id: 'fin', name: 'Financial Management', category: 'finance', entities: ['Company', 'Ledger Account', 'Journal', 'Spend Category'], api_endpoints: 156 },
+            { id: 'pay', name: 'Payroll', category: 'hr', entities: ['Pay Group', 'Earning', 'Deduction', 'Tax'], api_endpoints: 89 },
+            { id: 'recruit', name: 'Recruiting', category: 'hr', entities: ['Job Requisition', 'Candidate', 'Interview', 'Offer'], api_endpoints: 67 },
+            { id: 'learn', name: 'Learning', category: 'hr', entities: ['Course', 'Enrollment', 'Completion', 'Certification'], api_endpoints: 45 },
+        ],
+        integration_types: ['REST API', 'SOAP', 'Workday Studio', 'EIB', 'Core Connectors'],
+        supported_protocols: ['HTTPS', 'OAuth 2.0', 'SAML'],
+        compliance_frameworks: ['SOC1', 'SOC2', 'ISO27001', 'GDPR', 'HIPAA'],
+        connector_repository: 'erp-connector-workday',
+        documentation_url: 'https://community.workday.com/api',
+    },
+    sage: {
+        id: 'sage',
+        name: 'Sage Intacct',
+        vendor: 'Sage Group',
+        version: '2024.1',
+        description: 'Cloud financial management platform for growing businesses with strong multi-entity support.',
+        modules: [
+            { id: 'gl', name: 'General Ledger', category: 'finance', entities: ['Account', 'Journal Entry', 'Statistical Journal', 'Allocation'], api_endpoints: 56 },
+            { id: 'ap', name: 'Accounts Payable', category: 'finance', entities: ['Vendor', 'Bill', 'Payment', 'Adjustment'], api_endpoints: 45 },
+            { id: 'ar', name: 'Accounts Receivable', category: 'finance', entities: ['Customer', 'Invoice', 'Payment', 'Credit Memo'], api_endpoints: 48 },
+            { id: 'cm', name: 'Cash Management', category: 'finance', entities: ['Bank Account', 'Deposit', 'Funds Transfer', 'Reconciliation'], api_endpoints: 34 },
+            { id: 'pm', name: 'Project Accounting', category: 'analytics', entities: ['Project', 'Task', 'Timesheet', 'Expense Report'], api_endpoints: 42 },
+        ],
+        integration_types: ['REST API', 'XML API', 'Web Services', 'Platform Services'],
+        supported_protocols: ['HTTPS', 'Session-Based Auth'],
+        compliance_frameworks: ['SOC1', 'SOC2', 'GDPR', 'AICPA'],
+        connector_repository: 'erp-connector-sage',
+        documentation_url: 'https://developer.intacct.com',
+    },
+};
+// ============================================================================
+// Storage Configuration
+// ============================================================================
+function getErpDir() {
+    const baseDir = process.env['AGENTICS_DATA_DIR'] ?? process.cwd();
+    return path.join(baseDir, '.agentics', 'erp');
+}
+function _ensureErpDir() {
+    const dir = getErpDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// Exported for potential future use
+export const ensureErpDir = _ensureErpDir;
+function getErpArtifactPath(type, id) {
+    return path.join(getErpDir(), type, `${id}.json`);
+}
+function ensureErpSubdir(subdir) {
+    const dir = path.join(getErpDir(), subdir);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// ============================================================================
+// ID Generation
+// ============================================================================
+function generateErpId(prefix) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+// ============================================================================
+// Validation
+// ============================================================================
+function validatePlanId(id, correlationId) {
+    if (!id || typeof id !== 'string' || id.trim() === '') {
+        throw new CLIError({
+            code: 'ECLI-ERP-001',
+            category: 'INPUT_ERROR',
+            message: 'Plan ID is required',
+            details: { provided: id },
+            module: 'erp',
+            correlationId,
+            recoverable: false,
+            exitCode: ERP_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+}
+function validateSystemId(id, correlationId) {
+    if (!id || typeof id !== 'string' || id.trim() === '') {
+        throw new CLIError({
+            code: 'ECLI-ERP-002',
+            category: 'INPUT_ERROR',
+            message: 'ERP system ID is required',
+            details: { provided: id },
+            module: 'erp',
+            correlationId,
+            recoverable: false,
+            exitCode: ERP_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+}
+// ============================================================================
+// Display Formatting
+// ============================================================================
+export function formatErpListForDisplay(systems) {
+    if (systems.length === 0) {
+        return 'No ERP systems available.';
+    }
+    const lines = [];
+    lines.push(`Available ERP Systems (${systems.length}):`);
+    lines.push('');
+    for (const system of systems) {
+        lines.push(`  ${system.id.toUpperCase()} - ${system.name}`);
+        lines.push(`    Vendor: ${system.vendor}`);
+        lines.push(`    Modules: ${system.modules_count}`);
+        lines.push(`    Integration: ${system.integration_types.slice(0, 3).join(', ')}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function formatErpInspectForDisplay(system) {
+    const lines = [];
+    lines.push(`ERP System: ${system.name}`);
+    lines.push('');
+    lines.push(`  ID:          ${system.id}`);
+    lines.push(`  Vendor:      ${system.vendor}`);
+    lines.push(`  Version:     ${system.version}`);
+    lines.push(`  Description: ${system.description}`);
+    lines.push('');
+    lines.push('Modules:');
+    for (const mod of system.modules) {
+        lines.push(`  - ${mod.name} (${mod.category})`);
+        lines.push(`    Entities: ${mod.entities.length} | API Endpoints: ${mod.api_endpoints}`);
+    }
+    lines.push('');
+    lines.push(`Integration Types: ${system.integration_types.join(', ')}`);
+    lines.push(`Protocols: ${system.supported_protocols.join(', ')}`);
+    lines.push(`Compliance: ${system.compliance_frameworks.join(', ')}`);
+    lines.push(`Connector: ${system.connector_repository}`);
+    return lines.join('\n');
+}
+export function formatErpSurfaceForDisplay(analysis) {
+    const lines = [];
+    lines.push(`ERP Surface Analysis: ${analysis.id}`);
+    lines.push(`Plan: ${analysis.plan_id}`);
+    lines.push('');
+    lines.push('Affected ERP Systems:');
+    for (const sys of analysis.erp_systems) {
+        lines.push(`  - ${sys.system_name} (${sys.modules_affected.length} modules, ${sys.entity_count} entities)`);
+        lines.push(`    Complexity: ${sys.integration_complexity} | Endpoints: ${sys.api_endpoints_required}`);
+    }
+    lines.push('');
+    lines.push(`Deployment Touchpoints: ${analysis.deployment_touchpoints.length}`);
+    lines.push(`Risks Identified: ${analysis.risks.length}`);
+    lines.push(`Effort Estimate: ${analysis.estimated_effort.total_days} days (${analysis.estimated_effort.confidence} confidence)`);
+    lines.push('');
+    lines.push(`Repositories Involved: ${analysis.repositories_involved.length}`);
+    return lines.join('\n');
+}
+export function formatErpMapForDisplay(mapping) {
+    const lines = [];
+    lines.push(`ERP Data Mapping: ${mapping.id}`);
+    lines.push(`Plan: ${mapping.plan_id}`);
+    lines.push('');
+    lines.push(`Source: ${mapping.source_system}`);
+    lines.push(`Targets: ${mapping.target_systems.join(', ')}`);
+    lines.push('');
+    lines.push(`Entity Mappings: ${mapping.entity_mappings.length}`);
+    lines.push(`Field Mappings: ${mapping.field_mappings.length}`);
+    lines.push(`Transformation Rules: ${mapping.transformation_rules.length}`);
+    lines.push(`Validation Rules: ${mapping.validation_rules.length}`);
+    lines.push('');
+    lines.push(`Repositories Involved: ${mapping.repositories_involved.length}`);
+    return lines.join('\n');
+}
+export function formatErpExportForDisplay(proposal) {
+    const lines = [];
+    lines.push(`ERP Deployment Proposal: ${proposal.id}`);
+    lines.push(`Plan: ${proposal.plan_id}`);
+    lines.push('');
+    lines.push(`Title: ${proposal.proposal.title}`);
+    lines.push(`Version: ${proposal.proposal.version}`);
+    lines.push(`Status: ${proposal.proposal.status}`);
+    lines.push('');
+    lines.push('Scope:');
+    lines.push(`  Systems: ${proposal.proposal.scope.erp_systems.join(', ')}`);
+    lines.push(`  Modules: ${proposal.proposal.scope.modules.length}`);
+    lines.push(`  Entities: ${proposal.proposal.scope.entities.length}`);
+    lines.push('');
+    lines.push(`Deployment Phases: ${proposal.proposal.phases.length}`);
+    lines.push(`Artifacts Generated: ${proposal.artifacts.length}`);
+    lines.push('');
+    lines.push(`Repositories Involved: ${proposal.repositories_involved.length}`);
+    return lines.join('\n');
+}
+// ============================================================================
+// Command Implementations
+// ============================================================================
+/**
+ * List all available ERP systems.
+ */
+export async function executeErpListCommand(_options) {
+    const startTime = Date.now();
+    const systems = Object.values(ERP_SYSTEMS).map(sys => ({
+        id: sys.id,
+        name: sys.name,
+        vendor: sys.vendor,
+        modules_count: sys.modules.length,
+        integration_types: sys.integration_types,
+    }));
+    return {
+        systems,
+        count: systems.length,
+        repositories_involved: getInvolvedRepositories('erp-list'),
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Inspect a specific ERP system.
+ */
+export async function executeErpInspectCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validateSystemId(input.system, correlationId);
+    const systemId = input.system.toLowerCase();
+    const system = ERP_SYSTEMS[systemId] ?? null;
+    return {
+        system,
+        found: system !== null,
+        repositories_involved: getInvolvedRepositories('erp-inspect'),
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Generate ERP surface analysis for a plan.
+ */
+export async function executeErpSurfaceCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validatePlanId(input.plan_id, correlationId);
+    const targetSystems = input.erp_systems ?? ['sap', 'oracle'];
+    const primarySystem = targetSystems[0] ?? 'sap';
+    const now = new Date().toISOString();
+    const analysisId = generateErpId('surface');
+    // Generate ERP system summaries
+    const erpSystems = targetSystems.map(sysId => {
+        const sys = ERP_SYSTEMS[sysId];
+        if (!sys)
+            return null;
+        return {
+            system_id: sysId,
+            system_name: sys.name,
+            modules_affected: sys.modules.slice(0, 3).map(m => m.name),
+            entity_count: sys.modules.reduce((sum, m) => sum + m.entities.length, 0),
+            api_endpoints_required: sys.modules.reduce((sum, m) => sum + m.api_endpoints, 0),
+            integration_complexity: sys.modules.length > 5 ? 'high' : sys.modules.length > 3 ? 'medium' : 'low',
+        };
+    }).filter((s) => s !== null);
+    // Generate deployment touchpoints
+    const touchpoints = [
+        {
+            id: generateErpId('tp'),
+            name: 'Financial Data Sync',
+            type: 'api',
+            direction: 'bidirectional',
+            erp_system: primarySystem,
+            module: 'finance',
+            entities: ['GL Account', 'Journal Entry', 'Cost Center'],
+            frequency: 'hourly',
+            estimated_volume: '10K-50K records/day',
+        },
+        {
+            id: generateErpId('tp'),
+            name: 'Master Data Replication',
+            type: 'batch',
+            direction: 'outbound',
+            erp_system: primarySystem,
+            module: 'master-data',
+            entities: ['Customer', 'Vendor', 'Material'],
+            frequency: 'daily',
+            estimated_volume: '1K-5K records/day',
+        },
+        {
+            id: generateErpId('tp'),
+            name: 'Transaction Events',
+            type: 'event',
+            direction: 'inbound',
+            erp_system: primarySystem,
+            module: 'transactions',
+            entities: ['Sales Order', 'Purchase Order', 'Invoice'],
+            frequency: 'real-time',
+            estimated_volume: '100-500 events/hour',
+        },
+    ];
+    // Generate risk assessment
+    const risks = [
+        {
+            id: generateErpId('risk'),
+            category: 'technical',
+            severity: 'medium',
+            description: 'API rate limits may impact real-time sync performance during peak hours.',
+            mitigation: 'Implement queue-based processing with exponential backoff.',
+            owner: 'Integration Team',
+        },
+        {
+            id: generateErpId('risk'),
+            category: 'business',
+            severity: 'high',
+            description: 'Data mapping discrepancies between source and target schemas.',
+            mitigation: 'Conduct thorough data profiling and establish transformation rules.',
+            owner: 'Data Architecture Team',
+        },
+        {
+            id: generateErpId('risk'),
+            category: 'compliance',
+            severity: 'low',
+            description: 'PII data handling requires encryption in transit and at rest.',
+            mitigation: 'Enable TLS 1.3 and field-level encryption for sensitive data.',
+            owner: 'Security Team',
+        },
+    ];
+    const analysis = {
+        id: analysisId,
+        plan_id: input.plan_id,
+        analysis_type: 'surface',
+        generated_at: now,
+        erp_systems: erpSystems,
+        deployment_touchpoints: touchpoints,
+        risks,
+        assumptions: [
+            'Source systems have stable API contracts',
+            'Network connectivity between environments is established',
+            'Required credentials and access permissions are provisioned',
+            'Data volumes are within estimated ranges',
+            'No major ERP version upgrades during implementation',
+        ],
+        recommendations: [
+            'Start with non-critical data flows for initial validation',
+            'Implement comprehensive logging and monitoring from day one',
+            'Establish data quality gates before production deployment',
+            'Create runbooks for common failure scenarios',
+            'Plan for incremental rollout with rollback capability',
+        ],
+        estimated_effort: {
+            development_days: 45,
+            testing_days: 20,
+            deployment_days: 10,
+            total_days: 75,
+            team_size: 4,
+            confidence: 'medium',
+        },
+        repositories_involved: getInvolvedRepositories('erp-surface'),
+        generated_by: getArtifactAttribution('deployment-proposal'),
+    };
+    // Persist analysis
+    try {
+        ensureErpSubdir('surface');
+        const filePath = getErpArtifactPath('surface', analysisId);
+        fs.writeFileSync(filePath, JSON.stringify(analysis, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new CLIError({
+            code: 'ECLI-ERP-003',
+            category: 'INTERNAL_ERROR',
+            message: `Failed to save surface analysis: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            details: { analysis_id: analysisId },
+            module: 'erp',
+            correlationId,
+            recoverable: false,
+            exitCode: ERP_EXIT_CODES.IO_ERROR,
+        });
+    }
+    return {
+        analysis,
+        repositories_involved: getInvolvedRepositories('erp-surface'),
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Generate ERP data mapping for a plan.
+ */
+export async function executeErpMapCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validatePlanId(input.plan_id, correlationId);
+    const targetSystems = input.target_systems ?? ['sap', 'oracle'];
+    const primaryTargetSystem = targetSystems[0] ?? 'sap';
+    const now = new Date().toISOString();
+    const mappingId = generateErpId('map');
+    // Generate entity mappings
+    const entityMappings = [
+        {
+            source_entity: 'Customer',
+            target_entity: 'Business Partner',
+            target_system: primaryTargetSystem,
+            target_module: 'master-data',
+            cardinality: '1:1',
+            sync_direction: 'bidirectional',
+        },
+        {
+            source_entity: 'Product',
+            target_entity: 'Material',
+            target_system: primaryTargetSystem,
+            target_module: 'materials-management',
+            cardinality: '1:1',
+            sync_direction: 'push',
+        },
+        {
+            source_entity: 'SalesOrder',
+            target_entity: 'Sales Document',
+            target_system: primaryTargetSystem,
+            target_module: 'sales-distribution',
+            cardinality: '1:N',
+            sync_direction: 'push',
+        },
+        {
+            source_entity: 'Invoice',
+            target_entity: 'Billing Document',
+            target_system: primaryTargetSystem,
+            target_module: 'finance',
+            cardinality: '1:1',
+            sync_direction: 'bidirectional',
+        },
+        {
+            source_entity: 'PurchaseOrder',
+            target_entity: 'Purchase Order',
+            target_system: primaryTargetSystem,
+            target_module: 'materials-management',
+            cardinality: '1:1',
+            sync_direction: 'pull',
+        },
+    ];
+    // Generate field mappings
+    const fieldMappings = [
+        { source_field: 'customer_id', target_field: 'BP_NUMBER', transformation: 'passthrough', required: true },
+        { source_field: 'customer_name', target_field: 'BP_NAME1', transformation: 'uppercase', required: true },
+        { source_field: 'email', target_field: 'EMAIL_ADDRESS', transformation: 'lowercase', required: false },
+        { source_field: 'phone', target_field: 'TELEPHONE', transformation: 'format_phone', required: false },
+        { source_field: 'country_code', target_field: 'COUNTRY', transformation: 'iso_to_sap_country', required: true },
+        { source_field: 'currency', target_field: 'CURRENCY_KEY', transformation: 'passthrough', required: true, default_value: 'USD' },
+        { source_field: 'created_at', target_field: 'CREATED_ON', transformation: 'iso_to_sap_date', required: true },
+        { source_field: 'amount', target_field: 'NET_VALUE', transformation: 'decimal_to_packed', required: true },
+    ];
+    // Generate transformation rules
+    const transformationRules = [
+        {
+            id: generateErpId('tr'),
+            name: 'ISO to SAP Date',
+            type: 'format',
+            expression: 'YYYYMMDD',
+            description: 'Convert ISO 8601 date to SAP internal date format',
+        },
+        {
+            id: generateErpId('tr'),
+            name: 'Country Code Lookup',
+            type: 'lookup',
+            expression: 'country_mapping_table[source_code]',
+            description: 'Map ISO 3166-1 alpha-2 to SAP country keys',
+        },
+        {
+            id: generateErpId('tr'),
+            name: 'Phone Formatting',
+            type: 'format',
+            expression: '+{country_code}-{area_code}-{number}',
+            description: 'Format phone numbers to international standard',
+        },
+        {
+            id: generateErpId('tr'),
+            name: 'Currency Amount',
+            type: 'calculation',
+            expression: 'value * exchange_rate[target_currency]',
+            description: 'Convert amounts to target currency using daily rates',
+        },
+    ];
+    // Generate validation rules
+    const validationRules = [
+        {
+            id: generateErpId('vr'),
+            name: 'Required Customer ID',
+            type: 'required',
+            expression: 'customer_id IS NOT NULL',
+            error_message: 'Customer ID is required for all records',
+            severity: 'error',
+        },
+        {
+            id: generateErpId('vr'),
+            name: 'Valid Country Code',
+            type: 'lookup',
+            expression: 'country_code IN valid_countries',
+            error_message: 'Invalid country code provided',
+            severity: 'error',
+        },
+        {
+            id: generateErpId('vr'),
+            name: 'Amount Range',
+            type: 'range',
+            expression: 'amount >= 0 AND amount <= 999999999.99',
+            error_message: 'Amount must be between 0 and 999,999,999.99',
+            severity: 'error',
+        },
+        {
+            id: generateErpId('vr'),
+            name: 'Email Format',
+            type: 'format',
+            expression: 'email MATCHES /^[\\w.-]+@[\\w.-]+\\.\\w+$/',
+            error_message: 'Invalid email format',
+            severity: 'warning',
+        },
+    ];
+    const mapping = {
+        id: mappingId,
+        plan_id: input.plan_id,
+        mapping_type: 'data-flow',
+        generated_at: now,
+        source_system: 'agentics-platform',
+        target_systems: targetSystems,
+        entity_mappings: entityMappings,
+        field_mappings: fieldMappings,
+        transformation_rules: transformationRules,
+        validation_rules: validationRules,
+        repositories_involved: getInvolvedRepositories('erp-map'),
+        generated_by: getArtifactAttribution('data-mapping'),
+    };
+    // Persist mapping
+    try {
+        ensureErpSubdir('mappings');
+        const filePath = getErpArtifactPath('mappings', mappingId);
+        fs.writeFileSync(filePath, JSON.stringify(mapping, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new CLIError({
+            code: 'ECLI-ERP-004',
+            category: 'INTERNAL_ERROR',
+            message: `Failed to save mapping: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            details: { mapping_id: mappingId },
+            module: 'erp',
+            correlationId,
+            recoverable: false,
+            exitCode: ERP_EXIT_CODES.IO_ERROR,
+        });
+    }
+    return {
+        mapping,
+        repositories_involved: getInvolvedRepositories('erp-map'),
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Export ERP deployment proposal for a plan.
+ */
+export async function executeErpExportCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validatePlanId(input.plan_id, correlationId);
+    const now = new Date().toISOString();
+    const proposalId = generateErpId('proposal');
+    const targetSystems = ['sap', 'oracle'];
+    // Generate deployment phases
+    const phases = [
+        {
+            id: generateErpId('phase'),
+            name: 'Discovery & Planning',
+            order: 1,
+            duration_days: 10,
+            activities: [
+                'Conduct stakeholder interviews',
+                'Document current state architecture',
+                'Define integration requirements',
+                'Establish success criteria',
+            ],
+            deliverables: ['Requirements document', 'Integration architecture diagram', 'Project plan'],
+            risks: ['Incomplete requirements', 'Stakeholder availability'],
+            dependencies: [],
+        },
+        {
+            id: generateErpId('phase'),
+            name: 'Design & Development',
+            order: 2,
+            duration_days: 30,
+            activities: [
+                'Design data mappings',
+                'Develop integration components',
+                'Create transformation logic',
+                'Build error handling',
+            ],
+            deliverables: ['Technical design document', 'Integration code', 'Unit tests'],
+            risks: ['API compatibility issues', 'Data quality problems'],
+            dependencies: ['Phase 1 completion'],
+        },
+        {
+            id: generateErpId('phase'),
+            name: 'Testing & Validation',
+            order: 3,
+            duration_days: 20,
+            activities: [
+                'Execute integration tests',
+                'Perform data validation',
+                'Conduct performance testing',
+                'Complete UAT',
+            ],
+            deliverables: ['Test results', 'Performance report', 'UAT sign-off'],
+            risks: ['Test environment availability', 'Data volume issues'],
+            dependencies: ['Phase 2 completion'],
+        },
+        {
+            id: generateErpId('phase'),
+            name: 'Deployment & Go-Live',
+            order: 4,
+            duration_days: 10,
+            activities: [
+                'Deploy to production',
+                'Execute cutover activities',
+                'Monitor initial transactions',
+                'Provide hypercare support',
+            ],
+            deliverables: ['Deployment checklist', 'Runbook', 'Support documentation'],
+            risks: ['Production issues', 'User adoption'],
+            dependencies: ['Phase 3 completion', 'Business approval'],
+        },
+    ];
+    // Generate proposal
+    const proposal = {
+        title: `ERP Integration Deployment - ${input.plan_id}`,
+        version: '1.0.0',
+        status: 'draft',
+        summary: `This proposal outlines the deployment plan for integrating the Agentics platform with enterprise ERP systems (${targetSystems.join(', ')}). The integration enables bidirectional data synchronization, real-time event processing, and comprehensive audit capabilities.`,
+        scope: {
+            erp_systems: targetSystems,
+            modules: ['finance', 'supply-chain', 'sales', 'master-data'],
+            entities: ['Customer', 'Vendor', 'Product', 'Sales Order', 'Purchase Order', 'Invoice'],
+            environments: ['development', 'staging', 'production'],
+            regions: ['us-central1', 'europe-west1'],
+        },
+        phases,
+        dependencies: [
+            { name: 'ERP API Access', type: 'technical', status: 'pending', owner: 'IT Security' },
+            { name: 'Data Governance Approval', type: 'business', status: 'pending', owner: 'Data Office' },
+            { name: 'Integration Team Allocation', type: 'resource', status: 'ready', owner: 'PMO' },
+            { name: 'Test Environment Setup', type: 'technical', status: 'pending', owner: 'Infrastructure' },
+        ],
+        success_criteria: [
+            '99.9% API availability during business hours',
+            'Data synchronization latency < 5 minutes',
+            'Zero data loss in transaction processing',
+            'Full audit trail for compliance',
+            'Successful processing of 10K+ transactions/day',
+        ],
+        rollback_plan: 'In case of critical issues, the integration can be disabled at the API gateway level. Historical data will be preserved in staging tables for reconciliation. A manual fallback process is documented for essential business operations.',
+    };
+    // Generate artifacts
+    const artifacts = [
+        {
+            filename: 'deployment-proposal.json',
+            type: 'json',
+            content: JSON.stringify(proposal, null, 2),
+            description: 'Complete deployment proposal in JSON format',
+            generated_by: getArtifactAttribution('deployment-proposal'),
+        },
+        {
+            filename: 'integration-config.yaml',
+            type: 'yaml',
+            content: generateIntegrationConfigYaml(input.plan_id, targetSystems),
+            description: 'Integration configuration for deployment',
+            generated_by: getArtifactAttribution('integration-config'),
+        },
+        {
+            filename: 'data-mapping-spec.json',
+            type: 'json',
+            content: JSON.stringify({
+                version: '1.0.0',
+                plan_id: input.plan_id,
+                mappings: {
+                    entities: 6,
+                    fields: 24,
+                    transformations: 8,
+                    validations: 12,
+                },
+                generated_at: now,
+                generated_by: getArtifactAttribution('data-mapping'),
+            }, null, 2),
+            description: 'Data mapping specification summary',
+            generated_by: getArtifactAttribution('data-mapping'),
+        },
+        {
+            filename: 'compliance-checklist.json',
+            type: 'json',
+            content: JSON.stringify({
+                version: '1.0.0',
+                frameworks: ['SOC2', 'GDPR', 'SOX'],
+                controls: [
+                    { id: 'AC-1', name: 'Access Control Policy', status: 'compliant' },
+                    { id: 'AU-1', name: 'Audit Policy', status: 'compliant' },
+                    { id: 'SC-1', name: 'System Communication Protection', status: 'compliant' },
+                    { id: 'IR-1', name: 'Incident Response', status: 'pending' },
+                ],
+                generated_at: now,
+                generated_by: getArtifactAttribution('compliance-report'),
+            }, null, 2),
+            description: 'Compliance checklist for ERP integration',
+            generated_by: getArtifactAttribution('compliance-report'),
+        },
+    ];
+    const erpExport = {
+        id: proposalId,
+        plan_id: input.plan_id,
+        export_type: 'deployment-proposal',
+        generated_at: now,
+        proposal,
+        artifacts,
+        repositories_involved: getInvolvedRepositories('erp-export'),
+        generated_by: getArtifactAttribution('deployment-proposal'),
+    };
+    // Persist proposal and artifacts
+    let artifactsWritten = false;
+    let outputPath = '';
+    try {
+        ensureErpSubdir('proposals');
+        ensureErpSubdir(`proposals/${proposalId}`);
+        // Save main proposal
+        const proposalPath = getErpArtifactPath('proposals', proposalId);
+        fs.writeFileSync(proposalPath, JSON.stringify(erpExport, null, 2), 'utf-8');
+        // Save individual artifacts
+        const artifactsDir = path.join(getErpDir(), 'proposals', proposalId);
+        for (const artifact of artifacts) {
+            const artifactPath = path.join(artifactsDir, artifact.filename);
+            fs.writeFileSync(artifactPath, artifact.content, 'utf-8');
+        }
+        artifactsWritten = true;
+        outputPath = artifactsDir;
+    }
+    catch (error) {
+        throw new CLIError({
+            code: 'ECLI-ERP-005',
+            category: 'INTERNAL_ERROR',
+            message: `Failed to save export proposal: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            details: { proposal_id: proposalId },
+            module: 'erp',
+            correlationId,
+            recoverable: false,
+            exitCode: ERP_EXIT_CODES.IO_ERROR,
+        });
+    }
+    return {
+        proposal: erpExport,
+        artifacts_written: artifactsWritten,
+        output_path: outputPath,
+        repositories_involved: getInvolvedRepositories('erp-export'),
+        timing: Date.now() - startTime,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function generateIntegrationConfigYaml(planId, systems) {
+    const attribution = getArtifactAttribution('integration-config');
+    return `# ERP Integration Configuration
+# Generated by Agentics CLI
+# Plan ID: ${planId}
+# Generated at: ${new Date().toISOString()}
+
+version: "1.0.0"
+
+generated_by:
+${attribution.map(r => `  - ${r}`).join('\n')}
+
+integration:
+  plan_id: "${planId}"
+  type: "erp-connector"
+  mode: "bidirectional"
+
+target_systems:
+${systems.map(s => `  - system_id: "${s}"
+    enabled: true
+    priority: 1`).join('\n')}
+
+connection:
+  protocol: "https"
+  authentication: "oauth2"
+  timeout_ms: 30000
+  retry_policy:
+    max_retries: 3
+    backoff_multiplier: 2
+    initial_delay_ms: 1000
+
+sync:
+  mode: "incremental"
+  batch_size: 1000
+  parallelism: 4
+
+monitoring:
+  enabled: true
+  metrics_endpoint: "/v1/metrics"
+  health_endpoint: "/v1/health"
+  alert_channels:
+    - "slack"
+    - "pagerduty"
+
+compliance:
+  audit_logging: true
+  encryption_at_rest: true
+  encryption_in_transit: true
+  data_retention_days: 90
+
+# Repository attribution for orchestration proof
+orchestration:
+  platform: "agentics"
+  repositories_involved:
+${getInvolvedRepositories('erp-export').map(r => `    - ${r}`).join('\n')}
+`;
+}
+//# sourceMappingURL=erp.js.map