@peakinfer/cli 1.0.133

package/dist/commands/template.js

@@ -0,0 +1,341 @@
+/**
+ * Template Commands (v1.6)
+ *
+ * CLI commands for managing insight templates:
+ * - list: List available templates with optional category filter
+ * - info: Show detailed template information
+ * - roi: Calculate ROI for a template
+ */
+import { loadTemplates, getTemplate, loadOptimizationTemplates, getOptimizationTemplate } from '../templates.js';
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Format category with color indicator
+ */
+function formatCategory(category) {
+    return `[${category}]`;
+}
+/**
+ * Format severity with indicator
+ */
+function formatSeverity(severity) {
+    const indicators = {
+        critical: '[!]',
+        warning: '[*]',
+        info: '[-]',
+    };
+    return `${indicators[severity] || '[ ]'} ${severity}`;
+}
+/**
+ * Display templates in a formatted list
+ */
+function displayTemplateList(templates) {
+    if (templates.length === 0) {
+        console.log('No templates found.');
+        return;
+    }
+    console.log(`\n${templates.length} template${templates.length !== 1 ? 's' : ''} available:\n`);
+    // Group by category
+    const byCategory = new Map();
+    for (const t of templates) {
+        if (!byCategory.has(t.category)) {
+            byCategory.set(t.category, []);
+        }
+        byCategory.get(t.category).push(t);
+    }
+    for (const [category, categoryTemplates] of byCategory) {
+        console.log(`${formatCategory(category)}`);
+        for (const t of categoryTemplates) {
+            console.log(`  ${formatSeverity(t.severity)} ${t.id}`);
+            console.log(`     ${t.name}`);
+        }
+        console.log('');
+    }
+}
+/**
+ * Display detailed template information
+ */
+function displayTemplateInfo(template) {
+    console.log(`\n${template.name} (${template.id})`);
+    console.log('═'.repeat(60));
+    console.log(`Version:  ${template.version}`);
+    console.log(`Category: ${formatCategory(template.category)}`);
+    if (template.layer) {
+        console.log(`Layer:    [${template.layer}]`);
+    }
+    console.log(`Severity: ${formatSeverity(template.severity)}`);
+    console.log('');
+    console.log('Match Scope:', template.match.scope);
+    console.log('Conditions:');
+    for (const cond of template.match.conditions) {
+        console.log(`  - ${cond.field} ${cond.op} ${cond.value ?? cond.pattern ?? ''}`);
+    }
+    console.log('');
+    console.log('Output:');
+    console.log(`  Headline: ${template.output.headline}`);
+    console.log(`  Evidence: ${template.output.evidence}`);
+    if (template.defaults && Object.keys(template.defaults).length > 0) {
+        console.log('');
+        console.log('Defaults:');
+        for (const [key, value] of Object.entries(template.defaults)) {
+            console.log(`  ${key}: ${value}`);
+        }
+    }
+}
+// =============================================================================
+// OPTIMIZATION TEMPLATE DISPLAY HELPERS (v1.8 - Inference Squeeze Guide)
+// =============================================================================
+/**
+ * Display optimization templates in a formatted list
+ */
+function displayOptimizationList(templates) {
+    if (templates.length === 0) {
+        console.log('No optimization templates found.');
+        return;
+    }
+    console.log(`\n${templates.length} optimization template${templates.length !== 1 ? 's' : ''} available:\n`);
+    // Group by category
+    const byCategory = new Map();
+    for (const t of templates) {
+        if (!byCategory.has(t.category)) {
+            byCategory.set(t.category, []);
+        }
+        byCategory.get(t.category).push(t);
+    }
+    for (const [category, categoryTemplates] of byCategory) {
+        console.log(`[${category}]`);
+        for (const t of categoryTemplates) {
+            const risk = t.optimization.risk_level === 'high' ? '[!]' : t.optimization.risk_level === 'medium' ? '[*]' : '[-]';
+            console.log(`  ${risk} ${t.id}`);
+            console.log(`     ${t.name}`);
+            if (t.optimization.expected_cost_reduction) {
+                console.log(`     Cost: ${t.optimization.expected_cost_reduction} | Effort: ${t.optimization.effort_estimate}`);
+            }
+        }
+        console.log('');
+    }
+}
+/**
+ * Display detailed optimization template information
+ */
+function displayOptimizationInfo(template) {
+    console.log(`\n${template.name} (${template.id})`);
+    console.log('═'.repeat(70));
+    console.log(`Category:    [${template.category}]`);
+    console.log(`Confidence:  ${(template.confidence * 100).toFixed(0)}%`);
+    if (template.success_count) {
+        console.log(`Success:     ${template.success_count} implementations`);
+    }
+    console.log('');
+    console.log('Optimization:');
+    console.log(`  Technique: ${template.optimization.technique}`);
+    if (template.optimization.expected_cost_reduction) {
+        console.log(`  Cost Reduction: ${template.optimization.expected_cost_reduction}`);
+    }
+    if (template.optimization.expected_latency_improvement) {
+        console.log(`  Latency Improvement: ${template.optimization.expected_latency_improvement}`);
+    }
+    if (template.optimization.expected_throughput_improvement) {
+        console.log(`  Throughput Improvement: ${template.optimization.expected_throughput_improvement}`);
+    }
+    console.log(`  Effort: ${template.optimization.effort_estimate}`);
+    console.log(`  Risk: ${template.optimization.risk_level}`);
+    console.log('');
+    if (template.implementation?.prerequisites) {
+        console.log('Prerequisites:');
+        for (const prereq of template.implementation.prerequisites) {
+            console.log(`  - ${prereq.requirement}`);
+        }
+        console.log('');
+    }
+    if (template.implementation?.automated_steps) {
+        console.log('Implementation Steps:');
+        for (const step of template.implementation.automated_steps) {
+            console.log(`  ${step.step_id}: ${step.name}`);
+        }
+        console.log('');
+    }
+    if (template.monitoring?.key_metrics) {
+        console.log('Key Metrics:');
+        for (const metric of template.monitoring.key_metrics) {
+            console.log(`  - ${metric.metric}: target ${metric.target}`);
+        }
+        console.log('');
+    }
+    if (template.economics?.implementation_cost) {
+        console.log('Implementation Cost:');
+        if (template.economics.implementation_cost.engineering_hours) {
+            console.log(`  Engineering Hours: ${template.economics.implementation_cost.engineering_hours}`);
+        }
+        console.log(`  Total Cost: $${template.economics.implementation_cost.total_cost.toLocaleString()}`);
+        console.log('');
+    }
+    console.log('Note: ROI estimates are indicative. Actual results depend on your environment.');
+}
+/**
+ * Calculate and display ROI for a template
+ */
+function displayTemplateROI(template, monthlyCost) {
+    console.log(`\nROI Analysis: ${template.name}`);
+    console.log('═'.repeat(60));
+    // Use defaults or provided values
+    const defaults = template.defaults || {};
+    const baseCost = monthlyCost || defaults.monthly_cost || 10000;
+    // Estimate savings based on category
+    let savingsPercent = 0;
+    let savingsDescription = '';
+    switch (template.category) {
+        case 'cost':
+            savingsPercent = defaults.estimated_savings_percent || 20;
+            savingsDescription = 'Direct cost reduction';
+            break;
+        case 'latency':
+            savingsPercent = defaults.latency_improvement_percent || 30;
+            savingsDescription = 'User time saved (latency reduction)';
+            break;
+        case 'reliability':
+            savingsPercent = defaults.failure_reduction_percent || 15;
+            savingsDescription = 'Avoided failures and retries';
+            break;
+        case 'throughput':
+            savingsPercent = defaults.throughput_improvement_percent || 25;
+            savingsDescription = 'Capacity improvement';
+            break;
+        default:
+            savingsPercent = 10;
+            savingsDescription = 'General optimization';
+    }
+    const monthlySavings = Math.round(baseCost * (savingsPercent / 100));
+    const annualSavings = monthlySavings * 12;
+    console.log(`Base Monthly Cost: $${baseCost.toLocaleString()}`);
+    console.log(`Category: ${template.category}`);
+    console.log('');
+    console.log(`Estimated Impact: ${savingsPercent}% ${savingsDescription}`);
+    console.log(`Monthly Savings:  $${monthlySavings.toLocaleString()}`);
+    console.log(`Annual Savings:   $${annualSavings.toLocaleString()}`);
+    console.log('');
+    console.log('Note: Estimates based on typical scenarios. Actual results may vary.');
+}
+// =============================================================================
+// COMMANDS
+// =============================================================================
+/**
+ * Register template commands
+ */
+export function registerTemplateCommands(program) {
+    const templateCmd = program
+        .command('template')
+        .description('manage insight templates');
+    // List templates
+    templateCmd
+        .command('list')
+        .description('list available templates')
+        .option('--category <cat>', 'filter by category (cost, latency, reliability, throughput, drift)')
+        .option('--layer <layer>', 'filter by stack layer (application, api, gateway, runtime, model, hardware)')
+        .option('--offline', 'use cached templates only')
+        .action(async (options) => {
+        try {
+            const templates = await loadTemplates({ offline: options.offline });
+            let filtered = templates;
+            // Filter by category if specified
+            if (options.category) {
+                filtered = filtered.filter(t => t.category === options.category);
+            }
+            // v1.8: Filter by layer if specified
+            if (options.layer) {
+                filtered = filtered.filter(t => t.layer === options.layer);
+            }
+            displayTemplateList(filtered);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Failed to load templates');
+            process.exit(1);
+        }
+    });
+    // Template info
+    templateCmd
+        .command('info')
+        .description('show template details')
+        .argument('<id>', 'template ID')
+        .option('--offline', 'use cached templates only')
+        .action(async (id, options) => {
+        try {
+            const template = await getTemplate(id, { offline: options.offline });
+            if (!template) {
+                console.error(`Template not found: ${id}`);
+                console.log('\nRun "peakinfer template list" to see available templates.');
+                process.exit(1);
+            }
+            displayTemplateInfo(template);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Failed to load template');
+            process.exit(1);
+        }
+    });
+    // Template ROI
+    templateCmd
+        .command('roi')
+        .description('calculate ROI for a template')
+        .argument('<id>', 'template ID')
+        .option('--monthly-cost <amount>', 'your monthly inference cost in USD', parseFloat)
+        .option('--offline', 'use cached templates only')
+        .action(async (id, options) => {
+        try {
+            const template = await getTemplate(id, { offline: options.offline });
+            if (!template) {
+                console.error(`Template not found: ${id}`);
+                process.exit(1);
+            }
+            displayTemplateROI(template, options.monthlyCost);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Failed to calculate ROI');
+            process.exit(1);
+        }
+    });
+    // ==========================================================================
+    // OPTIMIZATION TEMPLATES (v1.8 - Inference Squeeze Guide)
+    // ==========================================================================
+    // List optimization templates
+    templateCmd
+        .command('optimizations')
+        .description('list community optimization templates (Inference Squeeze Guide)')
+        .option('--category <cat>', 'filter by category (runtime_optimization, batching_optimization, memory_optimization, application_optimization, cost_optimization, monitoring, scaling)')
+        .action((options) => {
+        try {
+            let templates = loadOptimizationTemplates();
+            // Filter by category if specified
+            if (options.category) {
+                templates = templates.filter(t => t.category === options.category);
+            }
+            displayOptimizationList(templates);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Failed to load optimization templates');
+            process.exit(1);
+        }
+    });
+    // Optimization template info
+    templateCmd
+        .command('optimization')
+        .description('show optimization template details')
+        .argument('<id>', 'optimization template ID')
+        .action((id) => {
+        try {
+            const template = getOptimizationTemplate(id);
+            if (!template) {
+                console.error(`Optimization template not found: ${id}`);
+                console.log('\nRun "peakinfer template optimizations" to see available templates.');
+                process.exit(1);
+            }
+            displayOptimizationInfo(template);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Failed to load optimization template');
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/commands/template.js.map

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

package/dist/commands/validate-map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate-Map Command (v1.9.3)
+ *
+ * CLI command for validating InferenceMap JSON files against the v0.1 schema.
+ * Per PRD v1.9.3: `peakinfer validate-map ./analysis.json`
+ */
+import { Command } from 'commander';
+/**
+ * Register the validate-map command
+ */
+export declare function registerValidateMapCommand(program: Command): void;
+//# sourceMappingURL=validate-map.d.ts.map

package/dist/commands/validate-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-map.d.ts","sourceRoot":"","sources":["../../src/commands/validate-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+PpC;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0DjE"}

package/dist/commands/validate-map.js

@@ -0,0 +1,274 @@
+/**
+ * Validate-Map Command (v1.9.3)
+ *
+ * CLI command for validating InferenceMap JSON files against the v0.1 schema.
+ * Per PRD v1.9.3: `peakinfer validate-map ./analysis.json`
+ */
+import { existsSync, readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// =============================================================================
+// SCHEMA VALIDATION
+// =============================================================================
+/**
+ * Load the InferenceMap v0.1 JSON Schema
+ */
+function loadSchema() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const schemaPath = resolve(__dirname, '../../schemas/inference-map.v0.1.json');
+    if (!existsSync(schemaPath)) {
+        throw new Error(`Schema not found at ${schemaPath}`);
+    }
+    return JSON.parse(readFileSync(schemaPath, 'utf-8'));
+}
+/**
+ * Validate an InferenceMap against the v0.1 schema.
+ * Performs structural validation without external dependencies.
+ */
+function validateInferenceMap(data) {
+    const errors = [];
+    const warnings = [];
+    // Type guard
+    if (typeof data !== 'object' || data === null) {
+        errors.push({ path: '$', message: 'InferenceMap must be an object' });
+        return { valid: false, errors, warnings };
+    }
+    const map = data;
+    // Required fields
+    const requiredFields = ['version', 'root', 'generatedAt', 'summary', 'callsites'];
+    for (const field of requiredFields) {
+        if (!(field in map)) {
+            errors.push({ path: `$.${field}`, message: `Missing required field: ${field}` });
+        }
+    }
+    // Version check
+    if ('version' in map && map.version !== '0.1') {
+        errors.push({
+            path: '$.version',
+            message: 'Invalid version',
+            expected: '0.1',
+            actual: String(map.version),
+        });
+    }
+    // Root validation
+    if ('root' in map && typeof map.root !== 'string') {
+        errors.push({ path: '$.root', message: 'root must be a string' });
+    }
+    // generatedAt validation (ISO 8601)
+    if ('generatedAt' in map) {
+        if (typeof map.generatedAt !== 'string') {
+            errors.push({ path: '$.generatedAt', message: 'generatedAt must be a string' });
+        }
+        else {
+            const date = new Date(map.generatedAt);
+            if (isNaN(date.getTime())) {
+                errors.push({ path: '$.generatedAt', message: 'generatedAt must be a valid ISO 8601 date-time' });
+            }
+        }
+    }
+    // Summary validation
+    if ('summary' in map) {
+        if (typeof map.summary !== 'object' || map.summary === null) {
+            errors.push({ path: '$.summary', message: 'summary must be an object' });
+        }
+        else {
+            const summary = map.summary;
+            // Required summary fields
+            const summaryRequired = ['totalCallsites', 'providers', 'models', 'patterns'];
+            for (const field of summaryRequired) {
+                if (!(field in summary)) {
+                    errors.push({ path: `$.summary.${field}`, message: `Missing required field: ${field}` });
+                }
+            }
+            // Type checks
+            if ('totalCallsites' in summary && typeof summary.totalCallsites !== 'number') {
+                errors.push({ path: '$.summary.totalCallsites', message: 'totalCallsites must be a number' });
+            }
+            if ('providers' in summary && !Array.isArray(summary.providers)) {
+                errors.push({ path: '$.summary.providers', message: 'providers must be an array' });
+            }
+            if ('models' in summary && !Array.isArray(summary.models)) {
+                errors.push({ path: '$.summary.models', message: 'models must be an array' });
+            }
+            if ('patterns' in summary && (typeof summary.patterns !== 'object' || summary.patterns === null)) {
+                errors.push({ path: '$.summary.patterns', message: 'patterns must be an object' });
+            }
+        }
+    }
+    // Callsites validation
+    if ('callsites' in map) {
+        if (!Array.isArray(map.callsites)) {
+            errors.push({ path: '$.callsites', message: 'callsites must be an array' });
+        }
+        else {
+            const callsites = map.callsites;
+            for (let i = 0; i < callsites.length; i++) {
+                const callsite = callsites[i];
+                if (typeof callsite !== 'object' || callsite === null) {
+                    errors.push({ path: `$.callsites[${i}]`, message: 'callsite must be an object' });
+                    continue;
+                }
+                const cs = callsite;
+                // Required callsite fields
+                const callsiteRequired = ['id', 'file', 'line', 'patterns', 'confidence'];
+                for (const field of callsiteRequired) {
+                    if (!(field in cs)) {
+                        errors.push({ path: `$.callsites[${i}].${field}`, message: `Missing required field: ${field}` });
+                    }
+                }
+                // Type checks
+                if ('id' in cs && typeof cs.id !== 'string') {
+                    errors.push({ path: `$.callsites[${i}].id`, message: 'id must be a string' });
+                }
+                if ('file' in cs && typeof cs.file !== 'string') {
+                    errors.push({ path: `$.callsites[${i}].file`, message: 'file must be a string' });
+                }
+                if ('line' in cs) {
+                    if (typeof cs.line !== 'number' || !Number.isInteger(cs.line) || cs.line < 1) {
+                        errors.push({ path: `$.callsites[${i}].line`, message: 'line must be a positive integer' });
+                    }
+                }
+                if ('confidence' in cs) {
+                    if (typeof cs.confidence !== 'number' || cs.confidence < 0 || cs.confidence > 1) {
+                        errors.push({ path: `$.callsites[${i}].confidence`, message: 'confidence must be a number between 0 and 1' });
+                    }
+                }
+                if ('patterns' in cs && (typeof cs.patterns !== 'object' || cs.patterns === null)) {
+                    errors.push({ path: `$.callsites[${i}].patterns`, message: 'patterns must be an object' });
+                }
+                // Provider validation (known providers)
+                const validProviders = [
+                    'openai', 'anthropic', 'google', 'cohere', 'mistral',
+                    'bedrock', 'azure_openai', 'together', 'fireworks',
+                    'groq', 'replicate', 'perplexity',
+                    'vllm', 'sglang', 'tgi', 'ollama', 'llamacpp',
+                    'unknown',
+                ];
+                if ('provider' in cs && cs.provider !== null && typeof cs.provider === 'string') {
+                    if (!validProviders.includes(cs.provider)) {
+                        warnings.push({
+                            path: `$.callsites[${i}].provider`,
+                            message: `Unknown provider: ${cs.provider}. Known providers: ${validProviders.join(', ')}`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Metadata validation (optional)
+    if ('metadata' in map && map.metadata !== null) {
+        if (typeof map.metadata !== 'object') {
+            warnings.push({ path: '$.metadata', message: 'metadata should be an object' });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+// =============================================================================
+// OUTPUT FORMATTING
+// =============================================================================
+/**
+ * Format validation results for terminal output
+ */
+function formatResults(result, filePath) {
+    console.log('');
+    console.log(`InferenceMap Validation: ${filePath}`);
+    console.log('─'.repeat(60));
+    if (result.valid) {
+        console.log('✓ Valid InferenceMap v0.1');
+    }
+    else {
+        console.log('✗ Invalid InferenceMap');
+    }
+    console.log('');
+    if (result.errors.length > 0) {
+        console.log(`Errors (${result.errors.length}):`);
+        for (const error of result.errors) {
+            console.log(`  ✗ ${error.path}: ${error.message}`);
+            if (error.expected !== undefined) {
+                console.log(`    Expected: ${error.expected}`);
+                console.log(`    Actual: ${error.actual}`);
+            }
+        }
+        console.log('');
+    }
+    if (result.warnings.length > 0) {
+        console.log(`Warnings (${result.warnings.length}):`);
+        for (const warning of result.warnings) {
+            console.log(`  ⚠ ${warning.path}: ${warning.message}`);
+        }
+        console.log('');
+    }
+    if (result.valid && result.warnings.length === 0) {
+        console.log('No issues found.');
+        console.log('');
+    }
+}
+// =============================================================================
+// COMMAND REGISTRATION
+// =============================================================================
+/**
+ * Register the validate-map command
+ */
+export function registerValidateMapCommand(program) {
+    program
+        .command('validate-map')
+        .description('validate an InferenceMap JSON file against the v0.1 schema')
+        .argument('<file>', 'path to InferenceMap JSON file')
+        .option('--json', 'output validation results as JSON')
+        .option('--quiet', 'only output errors (exit code indicates validity)')
+        .action((file, options) => {
+        try {
+            // Resolve file path
+            const filePath = resolve(file);
+            // Check file exists
+            if (!existsSync(filePath)) {
+                console.error(`Error: File not found: ${filePath}`);
+                process.exit(1);
+            }
+            // Read and parse file
+            let data;
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                data = JSON.parse(content);
+            }
+            catch (parseError) {
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        valid: false,
+                        errors: [{
+                                path: '$',
+                                message: `Invalid JSON: ${parseError instanceof Error ? parseError.message : 'Parse error'}`,
+                            }],
+                        warnings: [],
+                    }, null, 2));
+                }
+                else if (!options.quiet) {
+                    console.error(`Error: Invalid JSON in ${file}`);
+                    console.error(parseError instanceof Error ? parseError.message : 'Parse error');
+                }
+                process.exit(1);
+            }
+            // Validate
+            const result = validateInferenceMap(data);
+            // Output results
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else if (!options.quiet) {
+                formatResults(result, file);
+            }
+            // Exit with appropriate code
+            process.exit(result.valid ? 0 : 1);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : 'Validation failed');
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=validate-map.js.map