qa360 2.1.7 → 2.2.0

package/dist/commands/slo.js

@@ -1,327 +0,0 @@
-/**
- * QA360 SLO/SLI Command
- *
- * CLI command for SLO/SLI management and reporting.
- */
-import { Command } from 'commander';
-import { SLOTracker, createDefaultSLOConfig, createStrictSLOConfig, createRelaxedSLOConfig, TimeWindows } from '../core/index.js';
-export const sloCommand = new Command('slo');
-sloCommand.description('Service Level Objectives and Indicators management');
-// List all SLOs
-sloCommand
-    .command('list')
-    .description('List all SLOs')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-    const config = createDefaultSLOConfig();
-    const tracker = new SLOTracker();
-    tracker.registerSLOs(config.slos);
-    const slos = tracker.getAllSLOs();
-    if (options.json) {
-        console.log(JSON.stringify(slos, null, 2));
-        return;
-    }
-    console.log('\n📊 Service Level Objectives\n');
-    if (slos.length === 0) {
-        console.log('No SLOs configured.\n');
-        return;
-    }
-    for (const slo of slos) {
-        const status = slo.status === 'healthy' ? '✓' : slo.status === 'warning' ? '⚠' : '✗';
-        const currentValue = slo.currentValue?.toFixed(2) || 'N/A';
-        console.log(`  ${status} ${slo.name}`);
-        console.log(`      Target: ${slo.target}% | Current: ${currentValue}%`);
-        console.log(`      Window: ${formatDuration(slo.windowMs)}`);
-        console.log(`      Error Budget: ${slo.errorBudget.remainingBudget.toFixed(2)}% remaining`);
-        console.log('');
-    }
-});
-// List all SLIs
-sloCommand
-    .command('sli')
-    .description('List all Service Level Indicators')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-    const config = createDefaultSLOConfig();
-    const tracker = new SLOTracker();
-    tracker.registerSLIs(config.slis);
-    const slis = tracker.getAllSLIs();
-    if (options.json) {
-        console.log(JSON.stringify(slis, null, 2));
-        return;
-    }
-    console.log('\n📈 Service Level Indicators\n');
-    if (slis.length === 0) {
-        console.log('No SLIs configured.\n');
-        return;
-    }
-    for (const sli of slis) {
-        console.log(`  • ${sli.name}`);
-        console.log(`      Type: ${sli.type}`);
-        console.log(`      Source: ${sli.source}`);
-        console.log(`      Aggregation: ${sli.aggregation}`);
-        console.log(`      Unit: ${sli.unit}`);
-        console.log(`      Threshold: ${sli.threshold.operator} ${sli.threshold.value}${sli.unit === 'percentage' ? '%' : sli.unit}`);
-        console.log('');
-    }
-});
-// Show SLO status
-sloCommand
-    .command('status')
-    .description('Show current SLO status')
-    .option('--id <id>', 'SLO ID (optional, shows all if not specified)')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-    const config = createDefaultSLOConfig();
-    const tracker = new SLOTracker();
-    tracker.registerSLOs(config.slos);
-    tracker.registerSLIs(config.slis);
-    // Simulate some measurements for demo
-    const demoSli = config.slis[0];
-    if (demoSli) {
-        tracker.recordMeasurement({
-            sliId: demoSli.id,
-            timestamp: Date.now(),
-            value: 92,
-            total: 100,
-            good: 92,
-            bad: 8,
-            unit: demoSli.unit,
-            windowStart: Date.now() - TimeWindows.DAY,
-            windowEnd: Date.now()
-        });
-    }
-    const results = options.id
-        ? [tracker.calculateSLOResult(options.id)]
-        : tracker.calculateAllResults();
-    if (options.json) {
-        console.log(JSON.stringify(results.filter((r) => r != null), null, 2));
-        return;
-    }
-    console.log('\n📊 SLO Status Report\n');
-    console.log(`Generated: ${new Date().toISOString()}\n`);
-    for (const result of results.filter((r) => r != null)) {
-        if (!result)
-            continue;
-        const status = result.status === 'healthy' ? '✅ Healthy' : result.status === 'warning' ? '⚠️ Warning' : '❌ Breached';
-        const budgetBar = createBudgetBar(result.errorBudget.remaining);
-        console.log(`  ${result.name}`);
-        console.log(`  Status: ${status}`);
-        console.log(`  Target: ${result.target}% | Current: ${result.current.toFixed(2)}%`);
-        console.log(`  Error Budget: ${budgetBar} ${result.errorBudget.remaining.toFixed(2)}%`);
-        console.log(`  Burn Rate: ${result.errorBudget.burnRate.toFixed(2)}x`);
-        console.log('');
-    }
-});
-// Show error budget
-sloCommand
-    .command('budget')
-    .description('Show error budget status')
-    .option('--id <id>', 'SLO ID')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-    const config = createDefaultSLOConfig();
-    const tracker = new SLOTracker();
-    tracker.registerSLOs(config.slos);
-    const slos = options.id
-        ? ((slo => slo ? [slo] : [])(tracker.getSLO(options.id)))
-        : tracker.getAllSLOs();
-    if (options.json) {
-        console.log(JSON.stringify(slos.map((s) => ({
-            id: s.id,
-            name: s.name,
-            errorBudget: s.errorBudget
-        })), null, 2));
-        return;
-    }
-    console.log('\n💰 Error Budget Status\n');
-    for (const slo of slos) {
-        if (!slo)
-            continue;
-        const budget = slo.errorBudget;
-        const budgetBar = createBudgetBar(budget.remainingBudget);
-        const status = budget.remainingBudget > 0 ? '✅' : '❌';
-        console.log(`  ${status} ${slo.name}`);
-        console.log(`      Initial Budget: ${budget.initialBudget}%`);
-        console.log(`      Remaining: ${budgetBar} ${budget.remainingBudget.toFixed(2)}%`);
-        console.log(`      Burned: ${(budget.initialBudget - budget.remainingBudget).toFixed(2)}%`);
-        console.log('');
-    }
-});
-// Create a new SLO
-sloCommand
-    .command('create')
-    .description('Create a new SLO')
-    .option('--name <name>', 'SLO name')
-    .option('--target <percentage>', 'Target percentage (0-100)', parseFloat)
-    .option('--window <duration>', 'Window duration (e.g., 7d, 30d)', '30d')
-    .option('--sli <ids...>', 'SLI IDs (comma-separated)')
-    .option('--tags <tags...>', 'Tags (comma-separated)')
-    .action(async (options) => {
-    if (!options.name) {
-        console.error('Error: --name is required');
-        process.exit(1);
-    }
-    if (options.target === undefined || options.target < 0 || options.target > 100) {
-        console.error('Error: --target must be between 0 and 100');
-        process.exit(1);
-    }
-    const windowMs = parseDuration(options.window);
-    const sliIds = options.sli ? options.sli.split(',') : [];
-    const tags = options.tags ? options.tags.split(',') : [];
-    const newSLO = {
-        id: `slo_${Date.now()}`,
-        name: options.name,
-        sliIds,
-        target: options.target,
-        windowMs,
-        errorBudget: {
-            initialBudget: 100 - options.target,
-            remainingBudget: 100 - options.target,
-            alertThresholds: { warning: 2, critical: 5 },
-            onExhaustion: 'alert_only'
-        },
-        status: 'unknown',
-        tags,
-        createdAt: Date.now(),
-        updatedAt: Date.now()
-    };
-    console.log('\n✅ SLO Created\n');
-    console.log(`  ID: ${newSLO.id}`);
-    console.log(`  Name: ${newSLO.name}`);
-    console.log(`  Target: ${newSLO.target}%`);
-    console.log(`  Window: ${formatDuration(windowMs)}`);
-    console.log(`  SLIs: ${sliIds.join(', ') || 'None'}`);
-    console.log(`  Tags: ${tags.join(', ') || 'None'}`);
-    console.log('');
-});
-// Validate configuration
-sloCommand
-    .command('validate')
-    .description('Validate SLO configuration')
-    .option('--mode <mode>', 'Configuration mode: default, strict, relaxed', 'default')
-    .action(async (options) => {
-    let config;
-    switch (options.mode) {
-        case 'strict':
-            config = createStrictSLOConfig();
-            break;
-        case 'relaxed':
-            config = createRelaxedSLOConfig();
-            break;
-        default:
-            config = createDefaultSLOConfig();
-    }
-    console.log(`\n✅ SLO Configuration Validated (${options.mode} mode)\n`);
-    console.log(`  SLOs defined: ${config.slos.length}`);
-    console.log(`  SLIs defined: ${config.slis.length}`);
-    console.log(`  Default window: ${formatDuration(config.defaultWindowMs)}`);
-    console.log(`  On exhaustion: ${config.defaultOnExhaustion}`);
-    console.log('');
-    for (const slo of config.slos) {
-        console.log(`  • ${slo.name} (${slo.target}% target)`);
-    }
-    console.log('');
-});
-// Generate SLO report
-sloCommand
-    .command('report')
-    .description('Generate SLO report')
-    .option('--period <duration>', 'Report period (e.g., 7d, 30d)', '30d')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-    const config = createDefaultSLOConfig();
-    const tracker = new SLOTracker();
-    tracker.registerSLOs(config.slos);
-    tracker.registerSLIs(config.slis);
-    // Add demo measurements
-    for (const sli of config.slis) {
-        tracker.recordMeasurement({
-            sliId: sli.id,
-            timestamp: Date.now(),
-            value: 92 + Math.random() * 8,
-            total: 100,
-            good: 92 + Math.floor(Math.random() * 8),
-            bad: Math.floor(Math.random() * 8),
-            unit: sli.unit,
-            windowStart: Date.now() - parseDuration(options.period),
-            windowEnd: Date.now()
-        });
-    }
-    const report = tracker.generateReport({
-        start: Date.now() - parseDuration(options.period),
-        end: Date.now()
-    });
-    if (options.json) {
-        console.log(JSON.stringify(report, null, 2));
-        return;
-    }
-    console.log('\n📊 SLO Report\n');
-    console.log(`Period: Last ${options.period}`);
-    console.log(`Generated: ${new Date(report.timestamp).toISOString()}`);
-    console.log(`Overall Status: ${formatStatus(report.status)}\n`);
-    console.log('Summary:');
-    console.log(`  Total SLOs: ${report.summary.total}`);
-    console.log(`  ✅ Healthy: ${report.summary.healthy}`);
-    console.log(`  ⚠️ Warning: ${report.summary.warning}`);
-    console.log(`  ❌ Breached: ${report.summary.breached}\n`);
-    if (report.slos.length > 0) {
-        console.log('SLO Details:\n');
-        for (const slo of report.slos) {
-            const status = slo.status === 'healthy' ? '✅' : slo.status === 'warning' ? '⚠️' : '❌';
-            console.log(`  ${status} ${slo.name}`);
-            console.log(`      Target: ${slo.target}% | Current: ${slo.current.toFixed(2)}%`);
-            console.log(`      Error Budget: ${slo.errorBudget.remaining.toFixed(2)}% remaining`);
-            console.log('');
-        }
-    }
-});
-// Helper functions
-function formatDuration(ms) {
-    const days = Math.floor(ms / (24 * 60 * 60 * 1000));
-    const hours = Math.floor((ms % (24 * 60 * 60 * 1000)) / (60 * 60 * 1000));
-    if (days > 0) {
-        return `${days} day${days > 1 ? 's' : ''}`;
-    }
-    if (hours > 0) {
-        return `${hours} hour${hours > 1 ? 's' : ''}`;
-    }
-    return `${ms}ms`;
-}
-function parseDuration(str) {
-    const match = str.match(/^(\d+)([dh])$/);
-    if (!match) {
-        return TimeWindows.MONTH; // Default
-    }
-    const value = parseInt(match[1], 10);
-    const unit = match[2];
-    switch (unit) {
-        case 'd':
-            return value * 24 * 60 * 60 * 1000;
-        case 'h':
-            return value * 60 * 60 * 1000;
-        default:
-            return TimeWindows.MONTH;
-    }
-}
-function createBudgetBar(remaining) {
-    const width = 20;
-    const filled = Math.round((remaining / 100) * width);
-    const bar = '█'.repeat(Math.max(0, filled)) + '░'.repeat(Math.max(0, width - filled));
-    const color = remaining > 50 ? '\x1b[32m' : remaining > 20 ? '\x1b[33m' : '\x1b[31m';
-    const reset = '\x1b[0m';
-    return `${color}[${bar}]${reset}`;
-}
-function formatStatus(status) {
-    switch (status) {
-        case 'healthy':
-            return '✅ Healthy';
-        case 'warning':
-            return '⚠️ Warning';
-        case 'breached':
-            return '❌ Breached';
-        default:
-            return '❓ Unknown';
-    }
-}
-export default sloCommand;

package/dist/commands/verify.d.ts

@@ -1,32 +0,0 @@
-/**
- * QA360 Verify Command - Proof Bundle Verification
- *
- * Verifies cryptographically signed proof bundles (RFC Proof Bundle v1)
- *
- * Usage:
- *   qa360 verify <proof.json>
- *   qa360 verify <directory>
- *   qa360 verify --json
- *
- * @see docs/rfc/proof-bundle-v1.md
- */
-/**
- * CLI options for verify command
- */
-export interface VerifyOptions {
-    json?: boolean;
-    verbose?: boolean;
-    strict?: boolean;
-}
-/**
- * Verify a single proof bundle file
- */
-export declare function verifySingle(filePath: string, options?: VerifyOptions): Promise<number>;
-/**
- * Verify all proof bundles in a directory
- */
-export declare function verifyDirectory(dirPath: string, options?: VerifyOptions): Promise<number>;
-/**
- * Main verify command
- */
-export declare function verifyCommand(pathArg?: string, options?: VerifyOptions): Promise<void>;

package/dist/commands/verify.js

@@ -1,278 +0,0 @@
-/**
- * QA360 Verify Command - Proof Bundle Verification
- *
- * Verifies cryptographically signed proof bundles (RFC Proof Bundle v1)
- *
- * Usage:
- *   qa360 verify <proof.json>
- *   qa360 verify <directory>
- *   qa360 verify --json
- *
- * @see docs/rfc/proof-bundle-v1.md
- */
-import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
-import { join, resolve, basename } from 'path';
-import chalk from 'chalk';
-// Import from core
-import { verifyProofFile, verifyPhase3Proof, VerificationCode, } from '../core/index.js';
-/**
- * Verify a proof file with automatic format detection
- */
-async function verifyProofAuto(filePath) {
-    try {
-        const content = readFileSync(filePath, 'utf-8');
-        const json = JSON.parse(content);
-        // Detect format
-        if (json.spec === 'qa360.proof.v1') {
-            // RFC format
-            return await verifyProofFile(filePath);
-        }
-        else if (json.version && json.signature && json.runId) {
-            // Phase3 format
-            return await verifyPhase3Proof(filePath);
-        }
-        else {
-            return {
-                valid: false,
-                code: VerificationCode.PROOF_MALFORMED,
-                message: 'Unknown proof format',
-            };
-        }
-    }
-    catch (error) {
-        return {
-            valid: false,
-            code: VerificationCode.PROOF_MALFORMED,
-            message: `Failed to read proof: ${error instanceof Error ? error.message : 'Unknown error'}`,
-        };
-    }
-}
-/**
- * Format verification result for human-readable output
- */
-function formatResult(result, filePath) {
-    if (result.valid) {
-        console.log(chalk.green.bold('\n✅ Proof verified: OK\n'));
-        console.log(chalk.blue(`🔏 Signer: ${result.details?.signerId || 'unknown'}`));
-        console.log(chalk.blue(`🔐 Hash: ${result.details?.hash || 'unknown'}`));
-        if (result.details?.artifactsTotal !== undefined) {
-            const verified = result.details.artifactsVerified || 0;
-            const total = result.details.artifactsTotal;
-            const status = verified === total ? chalk.green('all verified') : chalk.yellow(`${verified}/${total} verified`);
-            console.log(chalk.blue(`📦 Artifacts: ${total} (${status})`));
-        }
-        if (result.details?.startedAt && result.details?.finishedAt) {
-            console.log(chalk.blue(`⏱️  Run: ${result.details.startedAt} → ${result.details.finishedAt}`));
-        }
-        if (result.details?.trustScore !== undefined) {
-            const score = result.details.trustScore;
-            const scoreColor = score >= 80 ? chalk.green : score >= 60 ? chalk.yellow : chalk.red;
-            console.log(chalk.blue(`🎯 Trust Score: ${scoreColor(`${score}/100`)}`));
-        }
-        console.log();
-    }
-    else {
-        console.log(chalk.red.bold('\n❌ Proof verification FAILED\n'));
-        console.log(chalk.red(`📝 ${result.message}`));
-        if (result.code === VerificationCode.PROOF_INVALID_SIG) {
-            console.log(chalk.yellow('\n💡 Possible causes:'));
-            console.log(chalk.yellow('  • Proof bundle was tampered with'));
-            console.log(chalk.yellow('  • Wrong public key used for verification'));
-            console.log(chalk.yellow('  • Proof bundle corrupted'));
-        }
-        else if (result.code === VerificationCode.PROOF_INVALID_SCHEMA) {
-            console.log(chalk.yellow('\n💡 The proof bundle does not match the expected schema'));
-        }
-        else if (result.code === VerificationCode.PROOF_ARTIFACT_MISMATCH) {
-            console.log(chalk.yellow('\n💡 One or more artifacts have been modified or are missing'));
-        }
-        else if (result.code === VerificationCode.PROOF_MISSING_KEY) {
-            console.log(chalk.yellow('\n💡 Public key not found'));
-            console.log(chalk.yellow('  Run: qa360 doctor --init-keys'));
-        }
-        console.log();
-    }
-}
-/**
- * Format verification result as JSON
- */
-function formatJSON(result) {
-    const output = {
-        valid: result.valid,
-        code: result.code,
-        message: result.message,
-        details: result.details,
-    };
-    console.log(JSON.stringify(output, null, 2));
-}
-/**
- * Find all proof bundle files in a directory
- */
-function findProofFiles(dirPath) {
-    const files = [];
-    try {
-        const entries = readdirSync(dirPath);
-        for (const entry of entries) {
-            const fullPath = join(dirPath, entry);
-            const stat = statSync(fullPath);
-            if (stat.isFile() && entry.endsWith('-proof.json')) {
-                files.push(fullPath);
-            }
-            else if (stat.isFile() && entry.endsWith('.json')) {
-                // Check if it looks like a proof bundle (either format)
-                try {
-                    const content = readFileSync(fullPath, 'utf-8');
-                    const json = JSON.parse(content);
-                    // Support both RFC format (spec) and Phase3 format (version + signature)
-                    if (json.spec === 'qa360.proof.v1' ||
-                        (json.version && json.signature && json.runId)) {
-                        files.push(fullPath);
-                    }
-                }
-                catch {
-                    // Not a valid proof bundle, skip
-                }
-            }
-        }
-    }
-    catch (error) {
-        // Directory read error, return empty
-    }
-    return files;
-}
-/**
- * Verify a single proof bundle file
- */
-export async function verifySingle(filePath, options = {}) {
-    const absolutePath = resolve(filePath);
-    if (!existsSync(absolutePath)) {
-        console.error(chalk.red(`❌ File not found: ${filePath}`));
-        return 1;
-    }
-    try {
-        const result = await verifyProofAuto(absolutePath);
-        if (options.json) {
-            formatJSON(result);
-        }
-        else {
-            formatResult(result, filePath);
-        }
-        return result.valid ? 0 : result.code;
-    }
-    catch (error) {
-        if (options.json) {
-            console.log(JSON.stringify({
-                valid: false,
-                code: VerificationCode.PROOF_MALFORMED,
-                message: error instanceof Error ? error.message : 'Unknown error',
-            }, null, 2));
-        }
-        else {
-            console.error(chalk.red(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-        }
-        return VerificationCode.PROOF_MALFORMED;
-    }
-}
-/**
- * Verify all proof bundles in a directory
- */
-export async function verifyDirectory(dirPath, options = {}) {
-    const absolutePath = resolve(dirPath);
-    if (!existsSync(absolutePath)) {
-        console.error(chalk.red(`❌ Directory not found: ${dirPath}`));
-        return 1;
-    }
-    const proofFiles = findProofFiles(absolutePath);
-    if (proofFiles.length === 0) {
-        console.error(chalk.yellow(`⚠️  No proof bundles found in: ${dirPath}`));
-        return 1;
-    }
-    if (!options.json) {
-        console.log(chalk.blue(`\n🔍 Found ${proofFiles.length} proof bundle(s)\n`));
-    }
-    let allValid = true;
-    const results = [];
-    for (const proofFile of proofFiles) {
-        const fileName = basename(proofFile);
-        if (!options.json) {
-            console.log(chalk.gray(`\n━━━ ${fileName} ━━━`));
-        }
-        try {
-            const result = await verifyProofAuto(proofFile);
-            if (!options.json) {
-                formatResult(result, proofFile);
-            }
-            else {
-                results.push({
-                    file: fileName,
-                    ...result,
-                });
-            }
-            if (!result.valid) {
-                allValid = false;
-            }
-        }
-        catch (error) {
-            allValid = false;
-            if (!options.json) {
-                console.error(chalk.red(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-            }
-            else {
-                results.push({
-                    file: fileName,
-                    valid: false,
-                    code: VerificationCode.PROOF_MALFORMED,
-                    message: error instanceof Error ? error.message : 'Unknown error',
-                });
-            }
-        }
-    }
-    if (options.json) {
-        console.log(JSON.stringify({
-            total: proofFiles.length,
-            valid: allValid,
-            results,
-        }, null, 2));
-    }
-    else {
-        console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-        if (allValid) {
-            console.log(chalk.green.bold(`✅ All ${proofFiles.length} proof bundle(s) verified successfully\n`));
-        }
-        else {
-            console.log(chalk.red.bold(`❌ Some proof bundles failed verification\n`));
-        }
-    }
-    return allValid ? 0 : 1;
-}
-/**
- * Main verify command
- */
-export async function verifyCommand(pathArg, options = {}) {
-    // Default to .qa360/proofs if no path provided
-    const targetPath = pathArg || join(process.cwd(), '.qa360', 'proofs');
-    try {
-        const stat = statSync(targetPath);
-        let exitCode;
-        if (stat.isDirectory()) {
-            exitCode = await verifyDirectory(targetPath, options);
-        }
-        else {
-            exitCode = await verifySingle(targetPath, options);
-        }
-        process.exit(exitCode);
-    }
-    catch (error) {
-        if (!existsSync(targetPath)) {
-            console.error(chalk.red(`❌ Path not found: ${targetPath}`));
-            console.error(chalk.yellow('\n💡 Usage:'));
-            console.error(chalk.yellow('  qa360 verify <proof.json>'));
-            console.error(chalk.yellow('  qa360 verify <directory>'));
-            console.error(chalk.yellow('  qa360 verify  (defaults to .qa360/proofs/)'));
-        }
-        else {
-            console.error(chalk.red(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-        }
-        process.exit(1);
-    }
-}