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

package/dist/commands/quantify.d.ts

@@ -1,22 +1,120 @@
 /**
- * Quantify Command
+ * Quantify Command - CRUD Command for ROI Report Management
  *
- * SPARC Pseudocode Reference: §2.7
+ * ARCHITECTURE:
+ * - This module supports both orchestration commands AND local CRUD operations
+ * - Local CRUD uses file-based persistence in .agentics/quantify/
+ * - Has its own error handling and exit codes
  *
- * FLOW:
- * 1. Parse arguments → CommandObject
- * 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
+ * SUBCOMMANDS (Local CRUD):
+ * - list      List all ROI reports
+ * - inspect   Inspect a specific report by ID
+ * - create    Create a new ROI report record
+ * - delete    Delete a report
+ * - compare   Compare two reports (stubbed math)
  *
- * CONTRACT ENFORCEMENT:
- * - Request validation happens BEFORE any network call
- * - Response validation requires execution_metadata
- * - No bypass flags or soft-fail behavior
+ * ORCHESTRATION (External):
+ * - Default command executes via enterprise-roi-engine
  */
 import type { CommandOptions, RoiReportReference, SimulationReference, RoiReportType, FlexibleInput } from '../types/index.js';
+export declare const QUANTIFY_EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly INPUT_ERROR: 100;
+    readonly NOT_FOUND: 100;
+    readonly IO_ERROR: 74;
+    readonly UNEXPECTED_ERROR: 1;
+};
+export interface QuantifyRecord {
+    id: string;
+    name: string;
+    description: string;
+    report_type: RoiReportType;
+    simulation_id?: string;
+    status: QuantifyStatus;
+    metrics: RoiMetrics;
+    created_at: string;
+    updated_at: string;
+    version: number;
+    metadata?: Record<string, unknown>;
+}
+export type QuantifyStatus = 'draft' | 'pending' | 'completed' | 'archived';
+export interface RoiMetrics {
+    total_cost_savings?: number;
+    total_revenue_impact?: number;
+    roi_percentage?: number;
+    payback_period_months?: number;
+    net_present_value?: number;
+    internal_rate_of_return?: number;
+    currency: string;
+    time_horizon: string;
+}
+export interface QuantifyCreateInput {
+    name: string;
+    description?: string;
+    report_type?: RoiReportType;
+    simulation_id?: string;
+    metrics?: Partial<RoiMetrics>;
+    metadata?: Record<string, unknown>;
+}
+export interface QuantifyCreateResult {
+    report: QuantifyRecord;
+    timing: number;
+}
+export interface QuantifyListInput {
+    status?: QuantifyStatus;
+    report_type?: RoiReportType;
+    limit?: number;
+}
+export interface QuantifyListResult {
+    reports: QuantifySummary[];
+    count: number;
+    timing: number;
+}
+export interface QuantifySummary {
+    id: string;
+    name: string;
+    report_type: RoiReportType;
+    status: string;
+    created_at: string;
+    roi_percentage?: number;
+}
+export interface QuantifyInspectInput {
+    id: string;
+}
+export interface QuantifyInspectResult {
+    report: QuantifyRecord | null;
+    found: boolean;
+    timing: number;
+}
+export interface QuantifyDeleteInput {
+    id: string;
+}
+export interface QuantifyDeleteResult {
+    deleted: boolean;
+    id: string;
+    timing: number;
+}
+export interface QuantifyCompareInput {
+    idA: string;
+    idB: string;
+}
+export interface QuantifyCompareResult {
+    reportA: QuantifyRecord | null;
+    reportB: QuantifyRecord | null;
+    comparison: ComparisonSummary | null;
+    timing: number;
+}
+export interface ComparisonSummary {
+    delta_roi: number | null;
+    delta_cost_savings: number | null;
+    delta_revenue_impact: number | null;
+    percentage_difference: number | null;
+    better_report: string | null;
+    summary: string;
+}
+export declare function formatQuantifyForDisplay(record: QuantifyRecord): string;
+export declare function formatQuantifyListForDisplay(reports: QuantifySummary[]): string;
+export declare function formatCompareForDisplay(result: QuantifyCompareResult): string;
 export interface QuantifyCommandInput {
     simRef: FlexibleInput<SimulationReference>;
     reportType?: RoiReportType;
@@ -29,4 +127,24 @@ export interface QuantifyCommandResult {
     timing: number;
 }
 export declare function executeQuantifyCommand(input: QuantifyCommandInput, options: CommandOptions): Promise<QuantifyCommandResult>;
+/**
+ * Create a new ROI report record
+ */
+export declare function executeQuantifyCreateCommand(input: QuantifyCreateInput, options: CommandOptions): Promise<QuantifyCreateResult>;
+/**
+ * List ROI reports from local storage
+ */
+export declare function executeQuantifyListCommand(input: QuantifyListInput, _options: CommandOptions): Promise<QuantifyListResult>;
+/**
+ * Inspect a specific ROI report by ID
+ */
+export declare function executeQuantifyInspectCommand(input: QuantifyInspectInput, options: CommandOptions): Promise<QuantifyInspectResult>;
+/**
+ * Delete an ROI report
+ */
+export declare function executeQuantifyDeleteCommand(input: QuantifyDeleteInput, options: CommandOptions): Promise<QuantifyDeleteResult>;
+/**
+ * Compare two ROI reports (stubbed math)
+ */
+export declare function executeQuantifyCompareCommand(input: QuantifyCompareInput, options: CommandOptions): Promise<QuantifyCompareResult>;
 //# sourceMappingURL=quantify.d.ts.map

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

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

package/dist/commands/quantify.js

@@ -1,30 +1,255 @@
 /**
- * Quantify Command
+ * Quantify Command - CRUD Command for ROI Report Management
  *
- * SPARC Pseudocode Reference: §2.7
+ * ARCHITECTURE:
+ * - This module supports both orchestration commands AND local CRUD operations
+ * - Local CRUD uses file-based persistence in .agentics/quantify/
+ * - Has its own error handling and exit codes
  *
- * FLOW:
- * 1. Parse arguments → CommandObject
- * 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
+ * SUBCOMMANDS (Local CRUD):
+ * - list      List all ROI reports
+ * - inspect   Inspect a specific report by ID
+ * - create    Create a new ROI report record
+ * - delete    Delete a report
+ * - compare   Compare two reports (stubbed math)
  *
- * CONTRACT ENFORCEMENT:
- * - Request validation happens BEFORE any network call
- * - Response validation requires execution_metadata
- * - No bypass flags or soft-fail behavior
+ * ORCHESTRATION (External):
+ * - Default command executes via enterprise-roi-engine
  */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { isNaturalLanguage } from '../types/index.js';
 import { RoiEngineAdapter } from '../adapters/base-adapter.js';
 import { createOrchestrationEngine, } from '../modules/orchestration-engine.js';
 import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
-import { failFast, toError } from '../errors/index.js';
+import { failFast, toError, CLIError } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
 import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
+// Quantify-Specific Exit Codes
+// ============================================================================
+export const QUANTIFY_EXIT_CODES = {
+    SUCCESS: 0,
+    INPUT_ERROR: 100,
+    NOT_FOUND: 100,
+    IO_ERROR: 74,
+    UNEXPECTED_ERROR: 1,
+};
+// ============================================================================
+// Storage Configuration
+// ============================================================================
+function getQuantifyDir() {
+    const baseDir = process.env['AGENTICS_DATA_DIR'] ?? process.cwd();
+    return path.join(baseDir, '.agentics', 'quantify');
+}
+function ensureQuantifyDir() {
+    const dir = getQuantifyDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function getQuantifyPath(id) {
+    return path.join(getQuantifyDir(), `${id}.json`);
+}
+// ============================================================================
+// Storage Operations
+// ============================================================================
+function loadQuantifyRecord(id) {
+    const filePath = getQuantifyPath(id);
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function saveQuantifyRecord(record) {
+    ensureQuantifyDir();
+    const filePath = getQuantifyPath(record.id);
+    fs.writeFileSync(filePath, JSON.stringify(record, null, 2), 'utf-8');
+}
+function deleteQuantifyFile(id) {
+    const filePath = getQuantifyPath(id);
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    fs.unlinkSync(filePath);
+    return true;
+}
+function listAllQuantifyRecords() {
+    const dir = getQuantifyDir();
+    if (!fs.existsSync(dir)) {
+        return [];
+    }
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+    const records = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(path.join(dir, file), 'utf-8');
+            records.push(JSON.parse(content));
+        }
+        catch {
+            // Skip invalid files
+        }
+    }
+    return records;
+}
+// ============================================================================
+// ID Generation
+// ============================================================================
+function generateQuantifyId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `roi-${timestamp}-${random}`;
+}
+// ============================================================================
+// Validation
+// ============================================================================
+function validateQuantifyId(id, correlationId) {
+    if (!id || typeof id !== 'string' || id.trim() === '') {
+        throw new CLIError({
+            code: 'ECLI-QUANTIFY-001',
+            category: 'INPUT_ERROR',
+            message: 'Report ID is required',
+            details: { provided: id },
+            module: 'quantify',
+            correlationId,
+            recoverable: false,
+            exitCode: QUANTIFY_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+}
+function validateQuantifyName(name, correlationId) {
+    if (!name || typeof name !== 'string' || name.trim() === '') {
+        throw new CLIError({
+            code: 'ECLI-QUANTIFY-002',
+            category: 'INPUT_ERROR',
+            message: 'Report name is required',
+            details: { provided: name },
+            module: 'quantify',
+            correlationId,
+            recoverable: false,
+            exitCode: QUANTIFY_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+    if (name.length > 256) {
+        throw new CLIError({
+            code: 'ECLI-QUANTIFY-003',
+            category: 'INPUT_ERROR',
+            message: 'Report name cannot exceed 256 characters',
+            details: { provided_length: name.length, max_length: 256 },
+            module: 'quantify',
+            correlationId,
+            recoverable: false,
+            exitCode: QUANTIFY_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+}
+// ============================================================================
+// Display Formatting
+// ============================================================================
+export function formatQuantifyForDisplay(record) {
+    const lines = [];
+    const statusIcon = record.status === 'completed' ? '[OK]'
+        : record.status === 'pending' ? '[PEND]'
+            : record.status === 'archived' ? '[ARCH]'
+                : '[DRAFT]';
+    lines.push(`${statusIcon} ${record.id}`);
+    lines.push(`   Name:         ${record.name}`);
+    lines.push(`   Report Type:  ${record.report_type}`);
+    lines.push(`   Status:       ${record.status}`);
+    lines.push(`   Description:  ${record.description || '(none)'}`);
+    if (record.simulation_id) {
+        lines.push(`   Simulation:   ${record.simulation_id}`);
+    }
+    lines.push(`   Version:      ${record.version}`);
+    lines.push(`   Created:      ${new Date(record.created_at).toLocaleString()}`);
+    lines.push(`   Updated:      ${new Date(record.updated_at).toLocaleString()}`);
+    // Metrics
+    const m = record.metrics;
+    lines.push(`   Currency:     ${m.currency}`);
+    lines.push(`   Time Horizon: ${m.time_horizon}`);
+    if (m.roi_percentage !== undefined) {
+        lines.push(`   ROI:          ${m.roi_percentage.toFixed(2)}%`);
+    }
+    if (m.total_cost_savings !== undefined) {
+        lines.push(`   Cost Savings: ${m.total_cost_savings.toLocaleString()} ${m.currency}`);
+    }
+    if (m.total_revenue_impact !== undefined) {
+        lines.push(`   Revenue Impact: ${m.total_revenue_impact.toLocaleString()} ${m.currency}`);
+    }
+    if (m.payback_period_months !== undefined) {
+        lines.push(`   Payback:      ${m.payback_period_months} months`);
+    }
+    if (m.net_present_value !== undefined) {
+        lines.push(`   NPV:          ${m.net_present_value.toLocaleString()} ${m.currency}`);
+    }
+    if (m.internal_rate_of_return !== undefined) {
+        lines.push(`   IRR:          ${m.internal_rate_of_return.toFixed(2)}%`);
+    }
+    return lines.join('\n');
+}
+export function formatQuantifyListForDisplay(reports) {
+    if (reports.length === 0) {
+        return 'No ROI reports found.';
+    }
+    const lines = [];
+    lines.push(`Found ${reports.length} report${reports.length === 1 ? '' : 's'}:`);
+    lines.push('');
+    for (const report of reports) {
+        const roiStr = report.roi_percentage !== undefined ? ` (${report.roi_percentage.toFixed(1)}% ROI)` : '';
+        lines.push(`  ${report.id} - ${report.name} [${report.status}]${roiStr}`);
+        lines.push(`    Type: ${report.report_type}`);
+        lines.push(`    Created: ${new Date(report.created_at).toLocaleString()}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function formatCompareForDisplay(result) {
+    const lines = [];
+    if (!result.reportA || !result.reportB) {
+        if (!result.reportA) {
+            lines.push('Report A not found.');
+        }
+        if (!result.reportB) {
+            lines.push('Report B not found.');
+        }
+        return lines.join('\n');
+    }
+    lines.push('ROI Report Comparison');
+    lines.push('=====================');
+    lines.push('');
+    lines.push(`Report A: ${result.reportA.id} - ${result.reportA.name}`);
+    lines.push(`Report B: ${result.reportB.id} - ${result.reportB.name}`);
+    lines.push('');
+    if (result.comparison) {
+        const c = result.comparison;
+        if (c.delta_roi !== null) {
+            lines.push(`ROI Difference: ${c.delta_roi >= 0 ? '+' : ''}${c.delta_roi.toFixed(2)}%`);
+        }
+        if (c.delta_cost_savings !== null) {
+            lines.push(`Cost Savings Difference: ${c.delta_cost_savings >= 0 ? '+' : ''}${c.delta_cost_savings.toLocaleString()}`);
+        }
+        if (c.delta_revenue_impact !== null) {
+            lines.push(`Revenue Impact Difference: ${c.delta_revenue_impact >= 0 ? '+' : ''}${c.delta_revenue_impact.toLocaleString()}`);
+        }
+        if (c.percentage_difference !== null) {
+            lines.push(`Overall Difference: ${c.percentage_difference >= 0 ? '+' : ''}${c.percentage_difference.toFixed(2)}%`);
+        }
+        lines.push('');
+        lines.push(`Summary: ${c.summary}`);
+        if (c.better_report) {
+            lines.push(`Better Report: ${c.better_report}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ============================================================================
 // Quantify Command Implementation
 // ============================================================================
 export async function executeQuantifyCommand(input, options) {
@@ -148,4 +373,190 @@ export async function executeQuantifyCommand(input, options) {
         });
     }
 }
+// ============================================================================
+// CRUD Command Implementations
+// ============================================================================
+/**
+ * Create a new ROI report record
+ */
+export async function executeQuantifyCreateCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validateQuantifyName(input.name, correlationId);
+    const now = new Date().toISOString();
+    const report = {
+        id: generateQuantifyId(),
+        name: input.name.trim(),
+        description: input.description?.trim() ?? '',
+        report_type: input.report_type ?? 'cfo-grade',
+        simulation_id: input.simulation_id,
+        status: 'draft',
+        metrics: {
+            currency: input.metrics?.currency ?? 'USD',
+            time_horizon: input.metrics?.time_horizon ?? 'annual',
+            total_cost_savings: input.metrics?.total_cost_savings,
+            total_revenue_impact: input.metrics?.total_revenue_impact,
+            roi_percentage: input.metrics?.roi_percentage,
+            payback_period_months: input.metrics?.payback_period_months,
+            net_present_value: input.metrics?.net_present_value,
+            internal_rate_of_return: input.metrics?.internal_rate_of_return,
+        },
+        created_at: now,
+        updated_at: now,
+        version: 1,
+        metadata: input.metadata,
+    };
+    try {
+        saveQuantifyRecord(report);
+    }
+    catch (error) {
+        throw new CLIError({
+            code: 'ECLI-QUANTIFY-IO-001',
+            category: 'INTERNAL_ERROR',
+            message: 'Failed to save ROI report',
+            details: { error: error instanceof Error ? error.message : String(error) },
+            module: 'quantify',
+            correlationId,
+            recoverable: false,
+            exitCode: QUANTIFY_EXIT_CODES.IO_ERROR,
+        });
+    }
+    return {
+        report,
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * List ROI reports from local storage
+ */
+export async function executeQuantifyListCommand(input, _options) {
+    const startTime = Date.now();
+    let records = listAllQuantifyRecords();
+    // Apply filters
+    if (input.status) {
+        records = records.filter(r => r.status === input.status);
+    }
+    if (input.report_type) {
+        records = records.filter(r => r.report_type === input.report_type);
+    }
+    // Sort by updated_at descending
+    records.sort((a, b) => new Date(b.updated_at).getTime() - new Date(a.updated_at).getTime());
+    // Apply limit
+    if (input.limit && input.limit > 0) {
+        records = records.slice(0, input.limit);
+    }
+    // Map to summary
+    const summaries = records.map(r => ({
+        id: r.id,
+        name: r.name,
+        report_type: r.report_type,
+        status: r.status,
+        created_at: r.created_at,
+        roi_percentage: r.metrics.roi_percentage,
+    }));
+    return {
+        reports: summaries,
+        count: summaries.length,
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Inspect a specific ROI report by ID
+ */
+export async function executeQuantifyInspectCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validateQuantifyId(input.id, correlationId);
+    const report = loadQuantifyRecord(input.id);
+    return {
+        report,
+        found: report !== null,
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Delete an ROI report
+ */
+export async function executeQuantifyDeleteCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validateQuantifyId(input.id, correlationId);
+    const deleted = deleteQuantifyFile(input.id);
+    if (!deleted) {
+        throw new CLIError({
+            code: 'ECLI-QUANTIFY-NOT-FOUND',
+            category: 'INPUT_ERROR',
+            message: `ROI report not found: ${input.id}`,
+            details: { id: input.id },
+            module: 'quantify',
+            correlationId,
+            recoverable: false,
+            exitCode: QUANTIFY_EXIT_CODES.NOT_FOUND,
+        });
+    }
+    return {
+        deleted: true,
+        id: input.id,
+        timing: Date.now() - startTime,
+    };
+}
+/**
+ * Compare two ROI reports (stubbed math)
+ */
+export async function executeQuantifyCompareCommand(input, options) {
+    const startTime = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    validateQuantifyId(input.idA, correlationId);
+    validateQuantifyId(input.idB, correlationId);
+    const reportA = loadQuantifyRecord(input.idA);
+    const reportB = loadQuantifyRecord(input.idB);
+    let comparison = null;
+    if (reportA && reportB) {
+        const mA = reportA.metrics;
+        const mB = reportB.metrics;
+        const deltaRoi = (mA.roi_percentage !== undefined && mB.roi_percentage !== undefined)
+            ? mA.roi_percentage - mB.roi_percentage
+            : null;
+        const deltaCostSavings = (mA.total_cost_savings !== undefined && mB.total_cost_savings !== undefined)
+            ? mA.total_cost_savings - mB.total_cost_savings
+            : null;
+        const deltaRevenueImpact = (mA.total_revenue_impact !== undefined && mB.total_revenue_impact !== undefined)
+            ? mA.total_revenue_impact - mB.total_revenue_impact
+            : null;
+        // Simple percentage difference based on ROI
+        const percentageDifference = deltaRoi;
+        let betterReport = null;
+        let summary;
+        if (deltaRoi !== null) {
+            if (deltaRoi > 0) {
+                betterReport = reportA.id;
+                summary = `Report A shows ${deltaRoi.toFixed(2)}% higher ROI than Report B.`;
+            }
+            else if (deltaRoi < 0) {
+                betterReport = reportB.id;
+                summary = `Report B shows ${Math.abs(deltaRoi).toFixed(2)}% higher ROI than Report A.`;
+            }
+            else {
+                summary = 'Both reports show equivalent ROI.';
+            }
+        }
+        else {
+            summary = 'Unable to compare ROI - metrics not available in one or both reports.';
+        }
+        comparison = {
+            delta_roi: deltaRoi,
+            delta_cost_savings: deltaCostSavings,
+            delta_revenue_impact: deltaRevenueImpact,
+            percentage_difference: percentageDifference,
+            better_report: betterReport,
+            summary,
+        };
+    }
+    return {
+        reportA,
+        reportB,
+        comparison,
+        timing: Date.now() - startTime,
+    };
+}
 //# sourceMappingURL=quantify.js.map