add-skill-kit 3.2.4 → 3.2.5

package/lib/agent-cli/scripts/adaptive_engine.js

@@ -0,0 +1,381 @@
+#!/usr/bin/env node
+/**
+ * Adaptive Engine - Auto-adjust severity and promote/demote rules
+ * 
+ * Part of FAANG-Grade Auto-Learn System Phase 5
+ * 
+ * Features:
+ * - Auto-adjust severity based on hit count
+ * - Auto-promote rules with 95%+ accuracy to core
+ * - Auto-demote rules with <50% accuracy
+ * - Track rule effectiveness
+ * 
+ * Usage:
+ *   node adaptive_engine.js --analyze
+ *   node adaptive_engine.js --promote
+ *   node adaptive_engine.js --demote
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Colors
+const c = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m'
+};
+
+// Paths
+function findProjectRoot() {
+    let current = process.cwd();
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, '.agent'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return process.cwd();
+}
+
+const projectRoot = findProjectRoot();
+const knowledgePath = path.join(projectRoot, '.agent', 'knowledge');
+
+// Severity levels
+const SEVERITY_LEVELS = ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'];
+
+// Load JSON file
+function loadJson(filename) {
+    const filePath = path.join(knowledgePath, filename);
+    try {
+        if (fs.existsSync(filePath)) {
+            return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        }
+    } catch { }
+    return null;
+}
+
+// Save JSON file
+function saveJson(filename, data) {
+    const filePath = path.join(knowledgePath, filename);
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+
+// ==================== SEVERITY ADJUSTMENT ====================
+
+/**
+ * Auto-adjust severity based on hit count
+ * Rules hit 10+ times -> increase severity
+ * Rules hit 0 times in 30 days -> decrease severity
+ */
+function adjustSeverity() {
+    const lessons = loadJson('lessons-learned.json');
+    if (!lessons?.lessons?.length) {
+        console.log(`${c.gray}No lessons to analyze${c.reset}`);
+        return [];
+    }
+
+    const adjustments = [];
+    const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
+
+    for (const lesson of lessons.lessons) {
+        const hitCount = lesson.hitCount || 0;
+        const currentSeverity = lesson.severity || 'MEDIUM';
+        const currentIndex = SEVERITY_LEVELS.indexOf(currentSeverity);
+        const lastHit = lesson.lastHit ? new Date(lesson.lastHit) : null;
+
+        let newSeverity = currentSeverity;
+        let reason = null;
+
+        // Increase severity if hit 10+ times
+        if (hitCount >= 10 && currentIndex < SEVERITY_LEVELS.length - 1) {
+            newSeverity = SEVERITY_LEVELS[currentIndex + 1];
+            reason = `Hit ${hitCount} times - increasing severity`;
+        }
+        // Further increase if hit 25+ times
+        else if (hitCount >= 25 && currentIndex < SEVERITY_LEVELS.length - 2) {
+            newSeverity = SEVERITY_LEVELS[currentIndex + 2];
+            reason = `Hit ${hitCount} times - promoting to ${newSeverity}`;
+        }
+        // Decrease severity if not hit in 30 days
+        else if (lastHit && lastHit < thirtyDaysAgo && currentIndex > 0) {
+            newSeverity = SEVERITY_LEVELS[currentIndex - 1];
+            reason = `Not hit in 30 days - decreasing severity`;
+        }
+
+        if (reason) {
+            lesson.severity = newSeverity;
+            lesson.adjustedAt = new Date().toISOString();
+            adjustments.push({
+                id: lesson.id,
+                from: currentSeverity,
+                to: newSeverity,
+                reason
+            });
+        }
+    }
+
+    if (adjustments.length > 0) {
+        saveJson('lessons-learned.json', lessons);
+    }
+
+    return adjustments;
+}
+
+// ==================== AUTO-PROMOTION ====================
+
+/**
+ * Promote rules with 95%+ accuracy to core rules
+ */
+function promoteRules() {
+    const lessons = loadJson('lessons-learned.json');
+    if (!lessons?.lessons?.length) {
+        console.log(`${c.gray}No lessons to analyze${c.reset}`);
+        return [];
+    }
+
+    const promoted = [];
+
+    for (const lesson of lessons.lessons) {
+        const hitCount = lesson.hitCount || 0;
+        const successCount = lesson.successCount || 0;
+        const totalAttempts = hitCount + successCount;
+
+        // Need at least 10 attempts to evaluate
+        if (totalAttempts < 10) continue;
+
+        const accuracy = successCount / totalAttempts;
+
+        // Promote if 95%+ accuracy and not already CRITICAL
+        if (accuracy >= 0.95 && lesson.severity !== 'CRITICAL' && !lesson.promoted) {
+            lesson.promoted = true;
+            lesson.promotedAt = new Date().toISOString();
+            lesson.previousSeverity = lesson.severity;
+            lesson.severity = 'CRITICAL';
+
+            promoted.push({
+                id: lesson.id,
+                pattern: lesson.pattern,
+                accuracy: Math.round(accuracy * 100),
+                status: 'PROMOTED_TO_CORE'
+            });
+        }
+    }
+
+    if (promoted.length > 0) {
+        saveJson('lessons-learned.json', lessons);
+    }
+
+    return promoted;
+}
+
+/**
+ * Demote rules with <50% accuracy
+ */
+function demoteRules() {
+    const lessons = loadJson('lessons-learned.json');
+    if (!lessons?.lessons?.length) {
+        console.log(`${c.gray}No lessons to analyze${c.reset}`);
+        return [];
+    }
+
+    const demoted = [];
+
+    for (const lesson of lessons.lessons) {
+        const hitCount = lesson.hitCount || 0;
+        const successCount = lesson.successCount || 0;
+        const totalAttempts = hitCount + successCount;
+
+        // Need at least 10 attempts to evaluate
+        if (totalAttempts < 10) continue;
+
+        const accuracy = successCount / totalAttempts;
+
+        // Demote if <50% accuracy and higher than LOW
+        if (accuracy < 0.50 && lesson.severity !== 'LOW' && !lesson.demoted) {
+            lesson.demoted = true;
+            lesson.demotedAt = new Date().toISOString();
+            lesson.previousSeverity = lesson.severity;
+            lesson.severity = 'LOW';
+
+            demoted.push({
+                id: lesson.id,
+                pattern: lesson.pattern,
+                accuracy: Math.round(accuracy * 100),
+                status: 'DEMOTED_TO_LOW'
+            });
+        }
+    }
+
+    if (demoted.length > 0) {
+        saveJson('lessons-learned.json', lessons);
+    }
+
+    return demoted;
+}
+
+// ==================== ANALYSIS ====================
+
+/**
+ * Analyze all rules and provide recommendations
+ */
+function analyzeRules() {
+    const lessons = loadJson('lessons-learned.json');
+
+    console.log(`${c.cyan}╔════════════════════════════════════════╗${c.reset}`);
+    console.log(`${c.cyan}║${c.reset}  🧠 Adaptive Engine Analysis            ${c.cyan}║${c.reset}`);
+    console.log(`${c.cyan}╚════════════════════════════════════════╝${c.reset}\n`);
+
+    if (!lessons?.lessons?.length) {
+        console.log(`${c.gray}No lessons found. Run error_sensor first.${c.reset}`);
+        return;
+    }
+
+    // Group by severity
+    const bySeverity = {};
+    for (const lesson of lessons.lessons) {
+        const sev = lesson.severity || 'MEDIUM';
+        bySeverity[sev] = (bySeverity[sev] || 0) + 1;
+    }
+
+    console.log(`${c.bold}Current Distribution:${c.reset}`);
+    for (const sev of SEVERITY_LEVELS) {
+        const count = bySeverity[sev] || 0;
+        const bar = '█'.repeat(Math.min(count, 20));
+        const color = { LOW: c.gray, MEDIUM: c.blue, HIGH: c.yellow, CRITICAL: c.red }[sev];
+        console.log(`  ${color}${sev.padEnd(8)}${c.reset} ${bar} ${count}`);
+    }
+
+    // Find candidates for promotion/demotion
+    const promotionCandidates = [];
+    const demotionCandidates = [];
+
+    for (const lesson of lessons.lessons) {
+        const hitCount = lesson.hitCount || 0;
+
+        if (hitCount >= 10 && lesson.severity !== 'CRITICAL') {
+            promotionCandidates.push(lesson);
+        }
+        if (hitCount === 0 && lesson.severity !== 'LOW') {
+            demotionCandidates.push(lesson);
+        }
+    }
+
+    if (promotionCandidates.length > 0) {
+        console.log(`\n${c.green}${c.bold}Promotion Candidates (high hit count):${c.reset}`);
+        for (const l of promotionCandidates.slice(0, 5)) {
+            console.log(`  ${c.green}↑${c.reset} ${l.id}: ${l.pattern?.slice(0, 40)}... (${l.hitCount} hits)`);
+        }
+    }
+
+    if (demotionCandidates.length > 0) {
+        console.log(`\n${c.yellow}${c.bold}Demotion Candidates (no hits):${c.reset}`);
+        for (const l of demotionCandidates.slice(0, 5)) {
+            console.log(`  ${c.yellow}↓${c.reset} ${l.id}: ${l.pattern?.slice(0, 40)}...`);
+        }
+    }
+
+    console.log(`\n${c.gray}Total lessons: ${lessons.lessons.length}${c.reset}`);
+    console.log(`${c.gray}Run --adjust to apply severity changes${c.reset}`);
+}
+
+/**
+ * Run full adaptive cycle
+ */
+function runAdaptiveCycle() {
+    console.log(`${c.cyan}🔄 Running Adaptive Cycle...${c.reset}\n`);
+
+    // Step 1: Adjust severity
+    console.log(`${c.bold}Step 1: Severity Adjustment${c.reset}`);
+    const adjustments = adjustSeverity();
+    if (adjustments.length > 0) {
+        for (const adj of adjustments) {
+            console.log(`  ${adj.id}: ${adj.from} → ${adj.to} (${adj.reason})`);
+        }
+    } else {
+        console.log(`  ${c.gray}No adjustments needed${c.reset}`);
+    }
+
+    // Step 2: Promote high-performers
+    console.log(`\n${c.bold}Step 2: Auto-Promotion${c.reset}`);
+    const promoted = promoteRules();
+    if (promoted.length > 0) {
+        for (const p of promoted) {
+            console.log(`  ${c.green}↑ PROMOTED${c.reset}: ${p.id} (${p.accuracy}% accuracy)`);
+        }
+    } else {
+        console.log(`  ${c.gray}No rules meet promotion threshold (95%+)${c.reset}`);
+    }
+
+    // Step 3: Demote low-performers
+    console.log(`\n${c.bold}Step 3: Auto-Demotion${c.reset}`);
+    const demoted = demoteRules();
+    if (demoted.length > 0) {
+        for (const d of demoted) {
+            console.log(`  ${c.yellow}↓ DEMOTED${c.reset}: ${d.id} (${d.accuracy}% accuracy)`);
+        }
+    } else {
+        console.log(`  ${c.gray}No rules meet demotion threshold (<50%)${c.reset}`);
+    }
+
+    console.log(`\n${c.green}✓ Adaptive cycle complete!${c.reset}`);
+    console.log(`  Adjusted: ${adjustments.length}`);
+    console.log(`  Promoted: ${promoted.length}`);
+    console.log(`  Demoted: ${demoted.length}`);
+}
+
+// ==================== MAIN ====================
+
+const args = process.argv.slice(2);
+
+if (args.includes('--analyze') || args.includes('-a')) {
+    analyzeRules();
+} else if (args.includes('--adjust')) {
+    console.log(`${c.cyan}Adjusting severity levels...${c.reset}`);
+    const adjustments = adjustSeverity();
+    console.log(`${c.green}✓ Made ${adjustments.length} adjustments${c.reset}`);
+    for (const adj of adjustments) {
+        console.log(`  ${adj.id}: ${adj.from} → ${adj.to}`);
+    }
+} else if (args.includes('--promote')) {
+    console.log(`${c.cyan}Checking for promotion candidates...${c.reset}`);
+    const promoted = promoteRules();
+    console.log(`${c.green}✓ Promoted ${promoted.length} rules${c.reset}`);
+} else if (args.includes('--demote')) {
+    console.log(`${c.cyan}Checking for demotion candidates...${c.reset}`);
+    const demoted = demoteRules();
+    console.log(`${c.yellow}✓ Demoted ${demoted.length} rules${c.reset}`);
+} else if (args.includes('--run') || args.includes('-r')) {
+    runAdaptiveCycle();
+} else {
+    console.log(`${c.cyan}adaptive_engine - Auto-adjust severity and promote/demote rules${c.reset}
+
+${c.bold}Usage:${c.reset}
+  node adaptive_engine.js --analyze    Analyze rules and show recommendations
+  node adaptive_engine.js --adjust     Adjust severity based on hit count
+  node adaptive_engine.js --promote    Promote high-accuracy rules
+  node adaptive_engine.js --demote     Demote low-accuracy rules
+  node adaptive_engine.js --run        Run full adaptive cycle
+
+${c.bold}Thresholds:${c.reset}
+  Severity increase: 10+ hits
+  Severity decrease: 0 hits in 30 days
+  Promotion: 95%+ accuracy with 10+ attempts
+  Demotion: <50% accuracy with 10+ attempts
+
+${c.bold}Examples:${c.reset}
+  node adaptive_engine.js --analyze    View current state
+  node adaptive_engine.js --run        Apply all adaptations
+`);
+}
+
+export { adjustSeverity, promoteRules, demoteRules, analyzeRules, runAdaptiveCycle };

package/lib/agent-cli/scripts/dashboard_server.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+/**
+ * Dashboard Server - Local web server for Auto-Learn Dashboard
+ * 
+ * Part of FAANG-Grade Auto-Learn System Phase 4
+ * 
+ * Serves:
+ * - Static dashboard HTML
+ * - API endpoints for data
+ * 
+ * Usage:
+ *   node dashboard_server.js --start
+ *   node dashboard_server.js --port 3030
+ */
+
+import fs from 'fs';
+import path from 'path';
+import http from 'http';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Colors
+const c = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m'
+};
+
+// Find project root
+function findProjectRoot() {
+    let current = process.cwd();
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, '.agent'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return process.cwd();
+}
+
+const projectRoot = findProjectRoot();
+const knowledgePath = path.join(projectRoot, '.agent', 'knowledge');
+const dashboardPath = path.join(__dirname, '..', 'dashboard');
+
+// Load JSON files
+function loadJson(filename) {
+    const filePath = path.join(knowledgePath, filename);
+    try {
+        if (fs.existsSync(filePath)) {
+            return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        }
+    } catch { }
+    return null;
+}
+
+// API handlers
+const api = {
+    '/api/errors': () => {
+        const data = loadJson('detected-errors.json');
+        return data || { errors: [], totalErrors: 0 };
+    },
+
+    '/api/corrections': () => {
+        const data = loadJson('user-corrections.json');
+        return data || { corrections: [], totalCorrections: 0 };
+    },
+
+    '/api/lessons': () => {
+        const data = loadJson('lessons-learned.json');
+        return data || { lessons: [] };
+    },
+
+    '/api/patterns': () => {
+        const data = loadJson('patterns.json');
+        return data || { errors: {}, corrections: {}, highFrequency: [] };
+    },
+
+    '/api/summary': () => {
+        const errors = loadJson('detected-errors.json');
+        const corrections = loadJson('user-corrections.json');
+        const lessons = loadJson('lessons-learned.json');
+        const patterns = loadJson('patterns.json');
+
+        return {
+            errors: {
+                total: errors?.errors?.length || 0,
+                byType: patterns?.errors?.byType || {},
+                bySeverity: patterns?.errors?.bySeverity || {}
+            },
+            corrections: {
+                total: corrections?.corrections?.length || 0,
+                byCategory: patterns?.corrections?.byCategory || {}
+            },
+            lessons: lessons?.lessons?.length || 0,
+            highFrequency: patterns?.highFrequency || [],
+            lastUpdated: patterns?.analyzedAt || null
+        };
+    }
+};
+
+// MIME types
+const mimeTypes = {
+    '.html': 'text/html',
+    '.css': 'text/css',
+    '.js': 'application/javascript',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.svg': 'image/svg+xml'
+};
+
+// Create server
+function createServer(port) {
+    const server = http.createServer((req, res) => {
+        const url = req.url.split('?')[0];
+
+        // CORS headers for local development
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+
+        // Handle API requests
+        if (url.startsWith('/api/')) {
+            const handler = api[url];
+            if (handler) {
+                res.setHeader('Content-Type', 'application/json');
+                res.writeHead(200);
+                res.end(JSON.stringify(handler()));
+            } else {
+                res.writeHead(404);
+                res.end(JSON.stringify({ error: 'Not found' }));
+            }
+            return;
+        }
+
+        // Serve static files
+        let filePath = url === '/' ? '/index.html' : url;
+        filePath = path.join(dashboardPath, filePath);
+
+        if (fs.existsSync(filePath)) {
+            const ext = path.extname(filePath);
+            const mimeType = mimeTypes[ext] || 'text/plain';
+
+            res.setHeader('Content-Type', mimeType);
+            res.writeHead(200);
+            res.end(fs.readFileSync(filePath));
+        } else {
+            res.writeHead(404);
+            res.end('Not found');
+        }
+    });
+
+    return server;
+}
+
+function startServer(port = 3030) {
+    const server = createServer(port);
+
+    server.listen(port, () => {
+        console.log(`${c.cyan}╔════════════════════════════════════════╗${c.reset}`);
+        console.log(`${c.cyan}║${c.reset}  🧠 Auto-Learn Dashboard Server         ${c.cyan}║${c.reset}`);
+        console.log(`${c.cyan}╚════════════════════════════════════════╝${c.reset}\n`);
+        console.log(`${c.green}✓ Server running at:${c.reset}`);
+        console.log(`  ${c.bold}http://localhost:${port}${c.reset}\n`);
+        console.log(`${c.gray}API Endpoints:${c.reset}`);
+        console.log(`  GET /api/errors       - Detected errors`);
+        console.log(`  GET /api/corrections  - User corrections`);
+        console.log(`  GET /api/lessons      - Lessons learned`);
+        console.log(`  GET /api/patterns     - Pattern analysis`);
+        console.log(`  GET /api/summary      - Dashboard summary\n`);
+        console.log(`${c.yellow}Press Ctrl+C to stop${c.reset}`);
+    });
+
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            console.log(`${c.red}Error: Port ${port} is already in use${c.reset}`);
+            console.log(`${c.gray}Try: node dashboard_server.js --port ${port + 1}${c.reset}`);
+        } else {
+            console.error(`${c.red}Server error:${c.reset}`, err);
+        }
+        process.exit(1);
+    });
+
+    return server;
+}
+
+// Parse CLI args
+const args = process.argv.slice(2);
+
+if (args.includes('--start') || args.includes('-s') || args.length === 0 || args.includes('--port') || args.includes('-p')) {
+    let port = 3030;
+    const portIdx = args.findIndex(a => a === '--port' || a === '-p');
+    if (portIdx >= 0 && args[portIdx + 1]) {
+        port = parseInt(args[portIdx + 1], 10);
+    }
+    startServer(port);
+} else if (args.includes('--help') || args.includes('-h')) {
+    console.log(`${c.cyan}dashboard_server - Auto-Learn Dashboard Web Server${c.reset}
+
+${c.bold}Usage:${c.reset}
+  node dashboard_server.js                  Start server (default port 3030)
+  node dashboard_server.js --port 8080      Start on custom port
+  node dashboard_server.js --help           Show this help
+
+${c.bold}API Endpoints:${c.reset}
+  GET /api/errors       - All detected errors
+  GET /api/corrections  - All user corrections
+  GET /api/lessons      - All lessons learned
+  GET /api/patterns     - Pattern analysis results
+  GET /api/summary      - Dashboard summary data
+
+${c.bold}Example:${c.reset}
+  node dashboard_server.js --port 3030
+  # Open http://localhost:3030 in browser
+`);
+}
+
+export { createServer, startServer };