qa360 1.0.3 → 1.1.0

package/dist/core/serve/diagnostics-collector.js

@@ -0,0 +1,149 @@
+/**
+ * QA360 Diagnostics Collector
+ * Collecte des diagnostics actionnables pour /diag
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { HealthChecker } from './health-checker.js';
+export class DiagnosticsCollector {
+    healthChecker;
+    constructor() {
+        this.healthChecker = new HealthChecker();
+    }
+    async collect() {
+        const health = await this.healthChecker.check();
+        const problems = this.analyzeProblems(health);
+        const suggestions = this.generateSuggestions(health);
+        const lastRuns = await this.getLastRuns();
+        return {
+            problems,
+            suggestions,
+            last_runs: lastRuns
+        };
+    }
+    analyzeProblems(health) {
+        const problems = [];
+        // Configuration problems
+        if (health.checks.config === 'error') {
+            problems.push({
+                code: 'DOC001',
+                title: 'QA360 directory not accessible',
+                fix: 'qa360 doctor --fix config'
+            });
+        }
+        // Tool problems
+        if (health.checks.tools.playwright === 'missing') {
+            problems.push({
+                code: 'DOC201',
+                title: 'Playwright not found',
+                fix: 'qa360 doctor --fix tools=playwright'
+            });
+        }
+        if (health.checks.tools.k6 === 'missing') {
+            problems.push({
+                code: 'DOC202',
+                title: 'k6 not found',
+                fix: 'qa360 doctor --fix tools=k6'
+            });
+        }
+        if (health.checks.tools.zap === 'missing') {
+            problems.push({
+                code: 'DOC203',
+                title: 'ZAP not found',
+                fix: 'qa360 doctor --fix tools=zap'
+            });
+        }
+        // Secrets problems
+        if (health.checks.secrets === 'missing') {
+            problems.push({
+                code: 'SEC101',
+                title: 'Secrets file missing',
+                fix: 'qa360 secrets add API_TOKEN'
+            });
+        }
+        // System problems
+        if (!health.checks.tmp_writable) {
+            problems.push({
+                code: 'SYS001',
+                title: 'Temporary directory not writable',
+                fix: 'Check permissions on ' + require('os').tmpdir()
+            });
+        }
+        if (health.checks.disk_free_mb < 500) {
+            problems.push({
+                code: 'SYS002',
+                title: 'Low disk space',
+                fix: 'Free up disk space (< 500MB available)'
+            });
+        }
+        return problems;
+    }
+    generateSuggestions(health) {
+        const suggestions = [];
+        // Performance suggestions
+        if (health.checks.tools.k6 === 'missing') {
+            suggestions.push('Enable Docker fallback: qa360 run --docker');
+        }
+        // Security suggestions
+        if (health.checks.tools.zap === 'missing') {
+            suggestions.push('Install ZAP for DAST security testing');
+        }
+        // Configuration suggestions
+        const packPath = join(process.cwd(), '.qa360', 'pack.yml');
+        if (!existsSync(packPath)) {
+            suggestions.push('Generate pack configuration: qa360 ask "Test my web app"');
+        }
+        // Budget suggestions based on common patterns
+        suggestions.push('Reduce perf budget p95_ms to 900 for demo profile');
+        suggestions.push('Enable strict mode for production: budgets.mode=strict');
+        return suggestions;
+    }
+    async getLastRuns() {
+        try {
+            const runsDir = join(process.cwd(), '.qa360', 'runs');
+            if (!existsSync(runsDir)) {
+                return [];
+            }
+            const fs = require('fs');
+            const runFiles = fs.readdirSync(runsDir)
+                .filter((f) => f.endsWith('.json'))
+                .sort()
+                .slice(-5); // Last 5 runs
+            const runs = [];
+            for (const file of runFiles) {
+                try {
+                    const runPath = join(runsDir, file);
+                    const runData = JSON.parse(fs.readFileSync(runPath, 'utf8'));
+                    runs.push({
+                        runId: runData.runId || file.replace('.json', ''),
+                        trust: runData.trustScore || runData.trust_score || 0,
+                        ts: runData.timestamp || runData.ts || new Date().toISOString(),
+                        status: this.inferRunStatus(runData)
+                    });
+                }
+                catch {
+                    // Skip invalid run files
+                }
+            }
+            return runs.reverse(); // Most recent first
+        }
+        catch {
+            return [];
+        }
+    }
+    inferRunStatus(runData) {
+        if (runData.status) {
+            return runData.status;
+        }
+        if (runData.cancelled || runData.error?.includes('cancelled')) {
+            return 'cancelled';
+        }
+        if (runData.error || runData.errors?.length > 0) {
+            return 'failed';
+        }
+        if (runData.trustScore >= 70 || runData.trust_score >= 70) {
+            return 'success';
+        }
+        return 'failed';
+    }
+}

package/dist/core/serve/health-checker.d.ts

@@ -0,0 +1,45 @@
+/**
+ * QA360 Health Checker
+ * Vérifie liveness, readiness et état des outils
+ */
+export interface HealthStatus {
+    status: 'ok' | 'degraded' | 'error';
+    version: string;
+    commit: string;
+    env: {
+        node: string;
+        platform: string;
+    };
+    checks: {
+        config: 'ok' | 'error';
+        tools: {
+            playwright: 'ok' | 'missing';
+            k6: 'ok' | 'missing';
+            zap: 'ok' | 'missing';
+        };
+        secrets: 'ok' | 'missing';
+        disk_free_mb: number;
+        tmp_writable: boolean;
+        errors?: string[];
+    };
+    readiness: {
+        ready: boolean;
+        reason: string | null;
+    };
+}
+export declare class HealthChecker {
+    private packageInfo;
+    constructor();
+    check(): Promise<HealthStatus>;
+    private performChecks;
+    private checkConfigDir;
+    private checkConfig;
+    private checkTools;
+    private checkTool;
+    private checkSecrets;
+    private checkDiskSpace;
+    private checkTmpWritable;
+    private assessReadiness;
+    private getCommitHash;
+}
+//# sourceMappingURL=health-checker.d.ts.map

package/dist/core/serve/health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.d.ts","sourceRoot":"","sources":["../../../src/core/serve/health-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QACvB,KAAK,EAAE;YACL,UAAU,EAAE,IAAI,GAAG,SAAS,CAAC;YAC7B,EAAE,EAAE,IAAI,GAAG,SAAS,CAAC;YACrB,GAAG,EAAE,IAAI,GAAG,SAAS,CAAC;SACvB,CAAC;QACF,OAAO,EAAE,IAAI,GAAG,SAAS,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAM;;IAUnB,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;YA8BtB,aAAa;IA8B3B,OAAO,CAAC,cAAc;YAWR,WAAW;YAeX,UAAU;YAkBV,SAAS;YAwCT,YAAY;YASZ,cAAc;IAU5B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/core/serve/health-checker.js

@@ -0,0 +1,219 @@
+/**
+ * QA360 Health Checker
+ * Vérifie liveness, readiness et état des outils
+ */
+import { existsSync, statSync, writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, resolve } from 'path';
+import { spawn } from 'child_process';
+export class HealthChecker {
+    packageInfo;
+    constructor() {
+        try {
+            this.packageInfo = require('../../package.json');
+        }
+        catch {
+            this.packageInfo = { version: '0.9.0-core', name: '@qa360/core' };
+        }
+    }
+    async check() {
+        const checks = await this.performChecks();
+        const readiness = this.assessReadiness(checks);
+        // Determine overall status
+        let status = 'ok';
+        if (!readiness.ready) {
+            status = 'error';
+        }
+        else if (checks.tools.playwright === 'missing' ||
+            checks.tools.k6 === 'missing' ||
+            checks.secrets === 'missing') {
+            status = 'degraded';
+        }
+        return {
+            status,
+            version: this.packageInfo.version,
+            commit: this.getCommitHash(),
+            env: {
+                node: process.version,
+                platform: process.platform
+            },
+            checks,
+            readiness
+        };
+    }
+    async performChecks() {
+        const [configCheck, toolsCheck, secretsCheck, diskCheck, tmpCheck] = await Promise.all([
+            this.checkConfig(),
+            this.checkTools(),
+            this.checkSecrets(),
+            this.checkDiskSpace(),
+            this.checkTmpWritable()
+        ]);
+        // Collect error codes
+        const errors = [];
+        if (!tmpCheck.ok)
+            errors.push(tmpCheck.code);
+        if (configCheck.code)
+            errors.push(configCheck.code);
+        return {
+            config: configCheck.ok ? 'ok' : 'error',
+            tools: toolsCheck,
+            secrets: secretsCheck,
+            disk_free_mb: diskCheck,
+            tmp_writable: tmpCheck.ok,
+            ...(errors.length > 0 && { errors })
+        };
+    }
+    checkConfigDir() {
+        const dir = resolve(process.cwd(), '.qa360');
+        try {
+            const s = statSync(dir);
+            if (!s.isDirectory())
+                throw new Error('not a dir');
+            return { ok: true };
+        }
+        catch {
+            return { ok: false, code: 'HLT002', reason: 'Configuration error - cannot access .qa360 directory' };
+        }
+    }
+    async checkConfig() {
+        try {
+            // Check if basic pack structure can be loaded
+            const packPath = join(process.cwd(), '.qa360', 'pack.yml');
+            if (existsSync(packPath)) {
+                return { ok: true };
+            }
+            // Check if we can create .qa360 directory
+            return this.checkConfigDir();
+        }
+        catch {
+            return { ok: false, code: 'HLT002', reason: 'Configuration error - cannot access .qa360 directory' };
+        }
+    }
+    async checkTools() {
+        const [playwright, k6, zap] = await Promise.all([
+            this.checkTool('npx playwright --version'),
+            this.checkTool('k6 version'),
+            this.checkTool('zap-baseline.py --help')
+        ]);
+        return {
+            playwright: playwright === 'error' ? 'missing' : playwright,
+            k6: k6 === 'error' ? 'missing' : k6,
+            zap: zap === 'error' ? 'missing' : zap
+        };
+    }
+    async checkTool(command) {
+        try {
+            const [cmd, ...args] = command.split(' ');
+            const child = spawn(cmd, args, { stdio: 'ignore' });
+            // NEW: garde-fous pour mocks qui renvoient undefined
+            if (!child || typeof child.on !== 'function') {
+                return 'missing';
+            }
+            return await new Promise(resolve => {
+                let resolved = false;
+                const timer = setTimeout(() => {
+                    if (!resolved) {
+                        resolved = true;
+                        resolve('missing');
+                    }
+                }, 3000);
+                child.on('error', () => {
+                    if (!resolved) {
+                        resolved = true;
+                        clearTimeout(timer);
+                        resolve('missing');
+                    }
+                });
+                child.on('exit', (code) => {
+                    if (!resolved) {
+                        resolved = true;
+                        clearTimeout(timer);
+                        resolve(code === 0 ? 'ok' : 'missing');
+                    }
+                });
+            });
+        }
+        catch {
+            return 'missing';
+        }
+    }
+    async checkSecrets() {
+        try {
+            const secretsPath = join(process.cwd(), '.qa360', 'secrets.json');
+            return existsSync(secretsPath) ? 'ok' : 'missing';
+        }
+        catch {
+            return 'missing';
+        }
+    }
+    async checkDiskSpace() {
+        try {
+            const stats = statSync(process.cwd());
+            // Approximation - in real scenario, use statvfs or similar
+            return 2048; // Default 2GB assumption
+        }
+        catch {
+            return 0;
+        }
+    }
+    checkTmpWritable() {
+        try {
+            const p = join(tmpdir(), `qa360-${Date.now()}.tmp`);
+            writeFileSync(p, 'ok');
+            unlinkSync(p);
+            return { ok: true };
+        }
+        catch {
+            return { ok: false, code: 'HLT001', reason: 'tmp not writable' };
+        }
+    }
+    assessReadiness(checks) {
+        // Critical checks for readiness
+        if (!checks.tmp_writable) {
+            return {
+                ready: false,
+                reason: 'HLT001: Temporary directory not writable'
+            };
+        }
+        if (checks.config === 'error') {
+            return {
+                ready: false,
+                reason: 'HLT002: Configuration error - cannot access .qa360 directory'
+            };
+        }
+        if (checks.disk_free_mb < 100) {
+            return {
+                ready: false,
+                reason: 'HLT003: Insufficient disk space (< 100MB)'
+            };
+        }
+        // All critical checks passed
+        return {
+            ready: true,
+            reason: null
+        };
+    }
+    getCommitHash() {
+        try {
+            const fs = require('fs');
+            const gitHead = join(process.cwd(), '.git', 'HEAD');
+            if (existsSync(gitHead)) {
+                const head = fs.readFileSync(gitHead, 'utf8').trim();
+                if (head.startsWith('ref: ')) {
+                    const refPath = join(process.cwd(), '.git', head.substring(5));
+                    if (existsSync(refPath)) {
+                        return fs.readFileSync(refPath, 'utf8').trim().substring(0, 7);
+                    }
+                }
+                else {
+                    return head.substring(0, 7);
+                }
+            }
+            return 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+}

package/dist/core/serve/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * QA360 Serve Module Exports
+ */
+export { QA360Server, ServeConfig, ServeResponse } from './server';
+export { HealthChecker, HealthStatus } from './health-checker';
+export { DiagnosticsCollector, DiagnosticsReport, DiagnosticProblem, LastRun } from './diagnostics-collector';
+export { MetricsCollector, MetricValue } from './metrics-collector';
+export { ProcessManager, RunProcess, CancelResult } from './process-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/serve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/serve/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/serve/index.js

@@ -0,0 +1,8 @@
+/**
+ * QA360 Serve Module Exports
+ */
+export { QA360Server } from './server';
+export { HealthChecker } from './health-checker';
+export { DiagnosticsCollector } from './diagnostics-collector';
+export { MetricsCollector } from './metrics-collector';
+export { ProcessManager } from './process-manager';

package/dist/core/serve/metrics-collector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * QA360 Metrics Collector
+ * Génère des métriques au format OpenMetrics/Prometheus
+ */
+export interface MetricValue {
+    name: string;
+    value: number;
+    labels?: Record<string, string>;
+    help?: string;
+    type?: 'counter' | 'gauge' | 'histogram' | 'summary';
+}
+export declare class MetricsCollector {
+    private startTime;
+    constructor();
+    collect(): Promise<string>;
+    private gatherMetrics;
+    private collectRunMetrics;
+    private collectGateMetrics;
+    private collectSecurityMetrics;
+    private collectPerformanceMetrics;
+    private getLastRunData;
+    private formatOpenMetrics;
+    private getVersion;
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/core/serve/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../../src/core/serve/metrics-collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;CACtD;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;;IAMpB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YAKlB,aAAa;YAwCb,iBAAiB;YA8DjB,kBAAkB;YAwClB,sBAAsB;YAwFtB,yBAAyB;YAmDzB,cAAc;IAoB5B,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,UAAU;CAQnB"}