@llm-dev-ops/agentics-cli 1.3.1 → 1.3.3

package/dist/commands/export.js

@@ -5,9 +5,16 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Generate exports via agentics-deployment-exporters
- * 3. Record audit entry
- * 4. Return ExportReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Generate exports via agentics-deployment-exporters
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return ExportReference
+ *
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import { isNaturalLanguage } from '../types/index.js';
 import { ExportersAdapter } from '../adapters/base-adapter.js';
@@ -16,6 +23,7 @@ import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
 import { failFast } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
+import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
 // Export Command Implementation
 // ============================================================================
@@ -35,18 +43,47 @@ export async function executeExportCommand(input, options) {
             name: 'generate-export',
             adapter: exportersAdapter,
             request: {
-                endpoint: '/api/v1/exports/generate',
+                endpoint: '/v1/exporters',
                 method: 'POST',
-                buildBody: () => ({
-                    // Pass natural language input or structured reference unchanged
-                    intent_ref: isNaturalLanguage(input.intentRef)
-                        ? { natural_language: input.intentRef.description }
-                        : handoff.passthrough(input.intentRef),
-                    format_spec: {
-                        format: input.format,
-                        output_path: input.outputPath,
-                    },
-                }),
+                buildBody: () => {
+                    let requestBody;
+                    if (isNaturalLanguage(input.intentRef)) {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Natural language format
+                        // ============================================================================
+                        requestBody = {
+                            intent_ref: {
+                                natural_language: input.intentRef.description,
+                            },
+                            format_spec: {
+                                format: input.format,
+                                output_path: input.outputPath,
+                            },
+                        };
+                    }
+                    else {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Structured reference format
+                        // ============================================================================
+                        const intentRef = input.intentRef;
+                        requestBody = {
+                            intent_ref: {
+                                id: intentRef.id,
+                                type: 'IntentReference',
+                                repository: intentRef.repository,
+                                created_at: intentRef.created_at,
+                                checksum: intentRef.checksum,
+                            },
+                            format_spec: {
+                                format: input.format,
+                                output_path: input.outputPath,
+                            },
+                        };
+                    }
+                    // Validate request against contract BEFORE sending
+                    validateRequest(RequestSchemas.EXPORT, requestBody, correlationId);
+                    return requestBody;
+                },
             },
         },
     ];
@@ -57,9 +94,12 @@ export async function executeExportCommand(input, options) {
             const failedStage = result.stages.find(s => s.status === 'failed');
             throw new Error(failedStage?.error?.message ?? 'Export generation failed');
         }
-        // Extract export reference
+        // ============================================================================
+        // RESPONSE VALIDATION - execution_metadata REQUIRED
+        // ============================================================================
         const exportStage = result.stages.find(s => s.name === 'generate-export');
-        const exportRef = handoff.extractReference(exportStage?.response);
+        const validatedExport = validateResponse(ResponseSchemas.EXPORT, exportStage?.response, correlationId);
+        const exportRef = handoff.extractReference(validatedExport);
         // Record audit entry
         const intentRefId = isNaturalLanguage(input.intentRef)
             ? `nl:${input.intentRef.description.slice(0, 50)}`

package/dist/commands/export.js.map

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

package/dist/commands/inspect.d.ts

@@ -5,17 +5,23 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Retrieve simulation output via agentics-simulation-engine
- * 3. Record audit entry
- * 4. Return SimulationOutputReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Retrieve simulation output via agentics-simulation-engine
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return SimulationOutputReference
  *
- * PURPOSE: Retrieve deterministic simulation outputs from completed simulations
- * The CLI does NOT interpret or transform outputs - passthrough only
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
-import type { CommandOptions, SimulationOutputReference, SimulationReference, SimulationOutputType, FlexibleInput } from '../types/index.js';
+import type { CommandOptions, SimulationOutputReference, SimulationReference, FlexibleInput } from '../types/index.js';
 export interface InspectCommandInput {
     simRef: FlexibleInput<SimulationReference>;
-    outputType?: SimulationOutputType;
+    depth?: 'summary' | 'detailed' | 'full';
+    includeMetrics?: boolean;
+    includeTraces?: boolean;
 }
 export interface InspectCommandResult {
     reference: SimulationOutputReference;

package/dist/commands/inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,yBAAyB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA8F/B"}
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,yBAAyB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA2I/B"}

package/dist/commands/inspect.js

@@ -5,12 +5,16 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Retrieve simulation output via agentics-simulation-engine
- * 3. Record audit entry
- * 4. Return SimulationOutputReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Retrieve simulation output via agentics-simulation-engine
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return SimulationOutputReference
  *
- * PURPOSE: Retrieve deterministic simulation outputs from completed simulations
- * The CLI does NOT interpret or transform outputs - passthrough only
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import { isNaturalLanguage } from '../types/index.js';
 import { SimulationEngineAdapter } from '../adapters/base-adapter.js';
@@ -19,6 +23,7 @@ import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
 import { failFast } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
+import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
 // Inspect Command Implementation
 // ============================================================================
@@ -32,23 +37,53 @@ export async function executeInspectCommand(input, options) {
     // Create adapter
     const engineConfig = loadEndpointConfig('agentics-simulation-engine');
     const engineAdapter = new SimulationEngineAdapter(engineConfig, correlationId);
-    // Default output type
-    const outputType = input.outputType ?? 'summary';
+    // Default depth
+    const depth = input.depth ?? 'summary';
     // Define orchestration stages
     const stages = [
         {
             name: 'retrieve-output',
             adapter: engineAdapter,
             request: {
-                endpoint: '/api/v1/outputs/retrieve',
+                endpoint: '/v1/simulate',
                 method: 'POST',
-                buildBody: () => ({
-                    // Pass natural language input or structured reference unchanged
-                    sim_ref: isNaturalLanguage(input.simRef)
-                        ? { natural_language: input.simRef.description }
-                        : handoff.passthrough(input.simRef),
-                    output_type: outputType,
-                }),
+                buildBody: () => {
+                    let requestBody;
+                    if (isNaturalLanguage(input.simRef)) {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Natural language format
+                        // ============================================================================
+                        requestBody = {
+                            sim_ref: {
+                                natural_language: input.simRef.description,
+                            },
+                            depth,
+                            include_metrics: input.includeMetrics,
+                            include_traces: input.includeTraces,
+                        };
+                    }
+                    else {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Structured reference format
+                        // ============================================================================
+                        const simRef = input.simRef;
+                        requestBody = {
+                            sim_ref: {
+                                id: simRef.id,
+                                type: 'SimulationReference',
+                                repository: simRef.repository,
+                                created_at: simRef.created_at,
+                                checksum: simRef.checksum,
+                            },
+                            depth,
+                            include_metrics: input.includeMetrics,
+                            include_traces: input.includeTraces,
+                        };
+                    }
+                    // Validate request against contract BEFORE sending
+                    validateRequest(RequestSchemas.INSPECT, requestBody, correlationId);
+                    return requestBody;
+                },
             },
         },
     ];
@@ -59,16 +94,19 @@ export async function executeInspectCommand(input, options) {
             const failedStage = result.stages.find(s => s.status === 'failed');
             throw new Error(failedStage?.error?.message ?? 'Output retrieval failed');
         }
-        // Extract output reference
+        // ============================================================================
+        // RESPONSE VALIDATION - execution_metadata REQUIRED
+        // ============================================================================
         const outputStage = result.stages.find(s => s.name === 'retrieve-output');
-        const outputRef = handoff.extractReference(outputStage?.response);
+        const validatedOutput = validateResponse(ResponseSchemas.SIMULATION_OUTPUT, outputStage?.response, correlationId);
+        const outputRef = handoff.extractReference(validatedOutput);
         // Record audit entry
         const simRefId = isNaturalLanguage(input.simRef)
             ? `nl:${input.simRef.description.slice(0, 50)}`
             : input.simRef.id;
         audit.record({
             command: 'inspect',
-            inputs: { simRef: simRefId, outputType },
+            inputs: { simRef: simRefId, depth },
             outputs: outputRef,
             dependencies: [
                 { service: 'agentics-simulation-engine', method: 'retrieve', timestamp: new Date().toISOString(), duration_ms: result.timing.total, success: true },
@@ -89,7 +127,7 @@ export async function executeInspectCommand(input, options) {
             : input.simRef.id;
         audit.record({
             command: 'inspect',
-            inputs: { simRef: failedSimRefId, outputType },
+            inputs: { simRef: failedSimRefId, depth },
             outputs: null,
             dependencies: [],
             duration_ms: Date.now() - startTime,

package/dist/commands/inspect.js.map

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

package/dist/commands/login.js

@@ -24,7 +24,7 @@ import { createCredentialStore } from '../utils/credentials.js';
 // ============================================================================
 const API_URL = process.env['AGENTICS_API_URL'] ?? 'https://platform.agentics.dev';
 const CLI_NAME = 'Agentics CLI';
-const CLI_VERSION = '1.3.1';
+const CLI_VERSION = '1.3.2';
 const DEFAULT_POLL_INTERVAL = 5000; // 5 seconds
 const MAX_POLL_ATTEMPTS = 60; // 5 minutes max (60 * 5s)
 // ============================================================================

package/dist/commands/plan.d.ts

@@ -5,10 +5,17 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Select manifest via agentics-org-manifests
- * 3. Create plan via agentics-simulation-planner
- * 4. Record audit entry
- * 5. Return PlanReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Select manifest via agentics-org-manifests
+ * 4. Create plan via agentics-simulation-planner
+ * 5. VALIDATE response has execution_metadata (reject if missing)
+ * 6. Record audit entry
+ * 7. Return PlanReference
+ *
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import type { CommandOptions, PlanReference } from '../types/index.js';
 export interface PlanCommandInput {

package/dist/commands/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAC;AAkB3B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAoG5B"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAC;AAyB3B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA+I5B"}

package/dist/commands/plan.js

@@ -5,10 +5,17 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Select manifest via agentics-org-manifests
- * 3. Create plan via agentics-simulation-planner
- * 4. Record audit entry
- * 5. Return PlanReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Select manifest via agentics-org-manifests
+ * 4. Create plan via agentics-simulation-planner
+ * 5. VALIDATE response has execution_metadata (reject if missing)
+ * 6. Record audit entry
+ * 7. Return PlanReference
+ *
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import { ManifestsAdapter, PlannerAdapter, } from '../adapters/base-adapter.js';
 import { createOrchestrationEngine, } from '../modules/orchestration-engine.js';
@@ -16,12 +23,18 @@ import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
 import { failFast } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
+import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
 // Plan Command Implementation
 // ============================================================================
 export async function executePlanCommand(input, options) {
     const correlationId = options.trace_id ?? crypto.randomUUID();
     const startTime = Date.now();
+    // ============================================================================
+    // CONTRACT VALIDATION - BEFORE ANY NETWORK CALL
+    // ============================================================================
+    // Validate the top-level plan request
+    const validatedInput = validateRequest(RequestSchemas.PLAN, { query: input.manifestQuery, params: input.params }, correlationId);
     // Initialize components
     const engine = createOrchestrationEngine(correlationId);
     const handoff = createArtifactHandoff();
@@ -37,24 +50,35 @@ export async function executePlanCommand(input, options) {
             name: 'select-manifest',
             adapter: manifestsAdapter,
             request: {
-                endpoint: '/api/v1/manifests/select',
+                endpoint: '/v1/manifests',
                 method: 'POST',
-                buildBody: () => ({ query: input.manifestQuery }),
+                buildBody: () => {
+                    // Validate manifests request body before sending
+                    const manifestsRequest = {
+                        query: validatedInput.query,
+                    };
+                    validateRequest(RequestSchemas.MANIFESTS, manifestsRequest, correlationId);
+                    return manifestsRequest;
+                },
             },
         },
         {
             name: 'create-plan',
             adapter: plannerAdapter,
             request: {
-                endpoint: '/api/v1/plans/create',
+                endpoint: '/v1/plans',
                 method: 'POST',
                 buildBody: (previousResults) => {
                     const manifestResult = previousResults.get('select-manifest');
-                    const manifestRef = handoff.extractReference(manifestResult);
-                    return {
+                    // Validate manifest response has execution_metadata
+                    const validatedManifest = validateResponse(ResponseSchemas.MANIFEST, manifestResult, correlationId);
+                    const manifestRef = handoff.extractReference(validatedManifest);
+                    // Build and validate plans request
+                    const plansRequest = {
                         manifest_ref: manifestRef,
-                        params: input.params ?? {},
+                        params: validatedInput.params ?? {},
                     };
+                    return plansRequest;
                 },
             },
             dependsOn: ['select-manifest'],
@@ -67,9 +91,12 @@ export async function executePlanCommand(input, options) {
             const failedStage = result.stages.find(s => s.status === 'failed');
             throw new Error(failedStage?.error?.message ?? 'Orchestration failed');
         }
-        // Extract plan reference from final stage
+        // ============================================================================
+        // RESPONSE VALIDATION - execution_metadata REQUIRED
+        // ============================================================================
         const planStage = result.stages.find(s => s.name === 'create-plan');
-        const planRef = handoff.extractReference(planStage?.response);
+        const validatedPlan = validateResponse(ResponseSchemas.PLAN, planStage?.response, correlationId);
+        const planRef = handoff.extractReference(validatedPlan);
         // Record audit entry
         audit.record({
             command: 'plan',

package/dist/commands/plan.js.map

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

package/dist/commands/quantify.d.ts

@@ -5,18 +5,24 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Generate ROI report via enterprise-roi-engine
- * 3. Record audit entry
- * 4. Return RoiReportReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Generate ROI report via enterprise-roi-engine
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return RoiReportReference
  *
- * PURPOSE: Generate CFO-grade financial impact summaries from completed simulations
- * The CLI does NOT perform financial calculations - delegates entirely to enterprise-roi-engine
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import type { CommandOptions, RoiReportReference, SimulationReference, RoiReportType, FlexibleInput } from '../types/index.js';
 export interface QuantifyCommandInput {
     simRef: FlexibleInput<SimulationReference>;
     reportType?: RoiReportType;
-    params?: Record<string, unknown>;
+    timeHorizon?: 'quarterly' | 'annual' | '3-year' | '5-year';
+    currency?: string;
+    discountRate?: number;
 }
 export interface QuantifyCommandResult {
     reference: RoiReportReference;

package/dist/commands/quantify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quantify.d.ts","sourceRoot":"","sources":["../../src/commands/quantify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA+FhC"}
+{"version":3,"file":"quantify.d.ts","sourceRoot":"","sources":["../../src/commands/quantify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA6IhC"}

package/dist/commands/quantify.js

@@ -5,12 +5,16 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Generate ROI report via enterprise-roi-engine
- * 3. Record audit entry
- * 4. Return RoiReportReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Generate ROI report via enterprise-roi-engine
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return RoiReportReference
  *
- * PURPOSE: Generate CFO-grade financial impact summaries from completed simulations
- * The CLI does NOT perform financial calculations - delegates entirely to enterprise-roi-engine
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import { isNaturalLanguage } from '../types/index.js';
 import { RoiEngineAdapter } from '../adapters/base-adapter.js';
@@ -19,6 +23,7 @@ import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
 import { failFast } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
+import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
 // Quantify Command Implementation
 // ============================================================================
@@ -40,16 +45,47 @@ export async function executeQuantifyCommand(input, options) {
             name: 'generate-roi-report',
             adapter: roiAdapter,
             request: {
-                endpoint: '/api/v1/reports/generate',
+                endpoint: '/v1/roi',
                 method: 'POST',
-                buildBody: () => ({
-                    // Pass natural language input or structured reference unchanged
-                    sim_ref: isNaturalLanguage(input.simRef)
-                        ? { natural_language: input.simRef.description }
-                        : handoff.passthrough(input.simRef),
-                    report_type: reportType,
-                    params: input.params ?? {},
-                }),
+                buildBody: () => {
+                    let requestBody;
+                    if (isNaturalLanguage(input.simRef)) {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Natural language format
+                        // ============================================================================
+                        requestBody = {
+                            sim_ref: {
+                                natural_language: input.simRef.description,
+                            },
+                            report_type: reportType,
+                            time_horizon: input.timeHorizon,
+                            currency: input.currency,
+                            discount_rate: input.discountRate,
+                        };
+                    }
+                    else {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Structured reference format
+                        // ============================================================================
+                        const simRef = input.simRef;
+                        requestBody = {
+                            sim_ref: {
+                                id: simRef.id,
+                                type: 'SimulationReference',
+                                repository: simRef.repository,
+                                created_at: simRef.created_at,
+                                checksum: simRef.checksum,
+                            },
+                            report_type: reportType,
+                            time_horizon: input.timeHorizon,
+                            currency: input.currency,
+                            discount_rate: input.discountRate,
+                        };
+                    }
+                    // Validate request against contract BEFORE sending
+                    validateRequest(RequestSchemas.QUANTIFY, requestBody, correlationId);
+                    return requestBody;
+                },
             },
         },
     ];
@@ -60,16 +96,19 @@ export async function executeQuantifyCommand(input, options) {
             const failedStage = result.stages.find(s => s.status === 'failed');
             throw new Error(failedStage?.error?.message ?? 'ROI report generation failed');
         }
-        // Extract ROI report reference
+        // ============================================================================
+        // RESPONSE VALIDATION - execution_metadata REQUIRED
+        // ============================================================================
         const roiStage = result.stages.find(s => s.name === 'generate-roi-report');
-        const roiRef = handoff.extractReference(roiStage?.response);
+        const validatedRoi = validateResponse(ResponseSchemas.ROI_REPORT, roiStage?.response, correlationId);
+        const roiRef = handoff.extractReference(validatedRoi);
         // Record audit entry
         const simRefId = isNaturalLanguage(input.simRef)
             ? `nl:${input.simRef.description.slice(0, 50)}`
             : input.simRef.id;
         audit.record({
             command: 'quantify',
-            inputs: { simRef: simRefId, reportType, params: input.params },
+            inputs: { simRef: simRefId, reportType },
             outputs: roiRef,
             dependencies: [
                 { service: 'enterprise-roi-engine', method: 'generate', timestamp: new Date().toISOString(), duration_ms: result.timing.total, success: true },