qa360 2.1.7 → 2.2.0

package/cli/src/commands/serve.ts

@@ -0,0 +1,194 @@
+/**
+ * QA360 Serve Command
+ * Démarre le serveur d'observabilité
+ */
+
+import { Command } from 'commander';
+import { QA360Server, ServeConfig } from 'qa360-core';
+
+export interface ServeOptions {
+  port: number;
+  host?: string;
+  metrics: boolean;
+  readinessCheck: boolean;
+  verbose: boolean;
+}
+
+export function createServeCommand(): Command {
+  return new Command('serve')
+    .description('Start QA360 observability server')
+    .option('-p, --port <port>', 'Server port', '4060')
+    .option('-h, --host <host>', 'Server host', '127.0.0.1')
+    .option('--no-metrics', 'Disable metrics endpoint')
+    .option('--readiness-check', 'Perform readiness check and exit')
+    .option('-v, --verbose', 'Verbose logging')
+    .action(async (options: ServeOptions) => {
+      await handleServeCommand(options);
+    });
+}
+
+async function handleServeCommand(options: ServeOptions): Promise<void> {
+  const config: ServeConfig = {
+    port: parseInt(options.port.toString(), 10),
+    host: options.host,
+    metrics: options.metrics,
+    readinessCheck: options.readinessCheck,
+    verbose: options.verbose
+  };
+
+  // Validate port
+  if (isNaN(config.port) || config.port < 1 || config.port > 65535) {
+    console.error('❌ Invalid port number. Must be between 1 and 65535.');
+    process.exit(1);
+  }
+
+  // Handle readiness check mode
+  if (config.readinessCheck) {
+    await performReadinessCheck(config);
+    return;
+  }
+
+  // Start server
+  const server = new QA360Server(config);
+  
+  try {
+    await server.start();
+    
+    console.log(`🚀 QA360 Server started successfully`);
+    console.log(`📊 Health: http://${config.host}:${config.port}/health`);
+    console.log(`🔍 Diagnostics: http://${config.host}:${config.port}/diag`);
+    
+    if (config.metrics) {
+      console.log(`📈 Metrics: http://${config.host}:${config.port}/metrics`);
+    }
+    
+    console.log(`🛑 Cancel: POST http://${config.host}:${config.port}/cancel/:runId`);
+    console.log(`\nPress Ctrl+C to stop the server`);
+    
+    // Keep the process alive
+    await new Promise<void>((resolve) => {
+      process.on('SIGINT', async () => {
+        console.log('\n🛑 Stopping server...');
+        await server.stop();
+        resolve();
+      });
+      
+      process.on('SIGTERM', async () => {
+        console.log('\n🛑 Stopping server...');
+        await server.stop();
+        resolve();
+      });
+    });
+    
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+    console.error(`❌ Failed to start server: ${errorMessage}`);
+    
+    if (errorMessage.includes('EADDRINUSE')) {
+      console.error(`💡 Port ${config.port} is already in use. Try a different port with --port <number>`);
+    }
+    
+    process.exit(1);
+  }
+}
+
+async function performReadinessCheck(config: ServeConfig): Promise<void> {
+  console.log('🔍 Performing readiness check...');
+  
+  const server = new QA360Server(config);
+  
+  try {
+    // Start server temporarily
+    await server.start();
+    
+    // Perform health check
+    const response = await fetch(`http://${config.host}:${config.port}/health`);
+    const health = await response.json();
+    
+    // Stop server
+    await server.stop();
+    
+    // Check readiness
+    if (health.readiness?.ready) {
+      console.log('✅ System is ready');
+      console.log(`📊 Status: ${health.status}`);
+      console.log(`🔧 Tools: Playwright=${health.checks.tools.playwright}, k6=${health.checks.tools.k6}, ZAP=${health.checks.tools.zap}`);
+      console.log(`💾 Secrets: ${health.checks.secrets}`);
+      console.log(`💿 Disk: ${health.checks.disk_free_mb}MB free`);
+      process.exit(0);
+    } else {
+      console.log('❌ System is not ready');
+      console.log(`🚨 Reason: ${health.readiness?.reason || 'Unknown'}`);
+      console.log(`📊 Status: ${health.status}`);
+      
+      // Show specific issues
+      if (health.checks.tools.playwright === 'missing') {
+        console.log('🎭 Playwright: Missing (run: qa360 doctor --fix tools=playwright)');
+      }
+      if (health.checks.tools.k6 === 'missing') {
+        console.log('⚡ k6: Missing (run: qa360 doctor --fix tools=k6)');
+      }
+      if (health.checks.tools.zap === 'missing') {
+        console.log('🛡️ ZAP: Missing (run: qa360 doctor --fix tools=zap)');
+      }
+      if (health.checks.secrets === 'missing') {
+        console.log('🔐 Secrets: Missing (run: qa360 secrets add API_TOKEN)');
+      }
+      if (!health.checks.tmp_writable) {
+        console.log('📁 Temp directory: Not writable');
+      }
+      
+      process.exit(1);
+    }
+    
+  } catch (error) {
+    console.log('❌ Readiness check failed');
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+    console.log(`🚨 Error: ${errorMessage}`);
+    
+    if (errorMessage.includes('EADDRINUSE')) {
+      console.log(`💡 Port ${config.port} is already in use. QA360 server might already be running.`);
+      console.log(`🔍 Check: curl http://${config.host}:${config.port}/health`);
+    }
+    
+    process.exit(1);
+  }
+}
+
+// Helper function for fetch (Node.js 18+ has built-in fetch)
+async function fetch(url: string): Promise<any> {
+  const http = require('http');
+  const { URL } = require('url');
+  
+  return new Promise((resolve, reject) => {
+    const parsedUrl = new URL(url);
+    
+    const req = http.request({
+      hostname: parsedUrl.hostname,
+      port: parsedUrl.port,
+      path: parsedUrl.pathname,
+      method: 'GET'
+    }, (res: any) => {
+      let data = '';
+      
+      res.on('data', (chunk: any) => {
+        data += chunk;
+      });
+      
+      res.on('end', () => {
+        resolve({
+          json: async () => JSON.parse(data),
+          status: res.statusCode
+        });
+      });
+    });
+    
+    req.on('error', reject);
+    req.setTimeout(5000, () => {
+      req.destroy();
+      reject(new Error('Request timeout'));
+    });
+    
+    req.end();
+  });
+}

package/cli/src/commands/slo.ts

@@ -0,0 +1,387 @@
+/**
+ * QA360 SLO/SLI Command
+ *
+ * CLI command for SLO/SLI management and reporting.
+ */
+
+import { Command } from 'commander';
+import {
+  SLOTracker,
+  createDefaultSLOConfig,
+  createStrictSLOConfig,
+  createRelaxedSLOConfig,
+  TimeWindows,
+  type SLO,
+  type SLI
+} from 'qa360-core';
+
+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: any) => 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: any) => 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: any) => ({
+        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: SLO = {
+      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: number): string {
+  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: string): number {
+  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: number): string {
+  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: string): string {
+  switch (status) {
+    case 'healthy':
+      return '✅ Healthy';
+    case 'warning':
+      return '⚠️ Warning';
+    case 'breached':
+      return '❌ Breached';
+    default:
+      return '❓ Unknown';
+  }
+}
+
+export default sloCommand;

package/cli/src/commands/verify-temp-note.md

@@ -0,0 +1,11 @@
+# Note Temporaire - verify.ts
+
+Ce fichier utilise des imports de `@qa360/core/proof` qui seront résolus une fois que:
+
+1. core/src/index.ts exporte les modules proof
+2. core est build
+3. cli peut importer depuis @qa360/core
+
+Pour l'instant, le fichier compile avec des types temporaires inline.
+
+Phase 3 sera complétée une fois les exports configurés.