@agentskillkit/agent-skills 3.2.2 → 3.2.5

package/packages/cli/lib/ui/index.js

@@ -23,9 +23,44 @@ import { runLessonsUI } from "./lessons-ui.js";
 import { runEvolutionSignalsUI } from "./evolution-signals-ui.js";
 import { runKnowledgeUI } from "./knowledge-ui.js";
 import { runHelpUI } from "./help-ui.js";
+import { runDashboardUI } from "./dashboard-ui.js";
 import routingUI from "./routing-ui.js";
 import * as p from "@clack/prompts";
 import { VERSION } from "../config.js";
+import gradient from 'gradient-string';
+
+// ============================================================================
+// ASCII BANNER
+// ============================================================================
+
+const AGENT_BANNER = `
+    _                    _   
+   / \\   __ _  ___ _ __ | |_ 
+  / _ \\ / _\` |/ _ \\ '_ \\| __|
+ / ___ \\ (_| |  __/ | | | |_ 
+/_/   \\_\\__, |\\___|_| |_|\\__|
+        |___/                
+`;
+
+// Custom gradient: white → gray (like PikaKit style)
+const agentGradient = gradient(['#ffffff', '#bbbbbb', '#888888', '#555555']);
+
+function showAgentBanner() {
+    // Extra clear to remove Clack prompt residuals
+    process.stdout.write('\x1B[2J\x1B[0f');
+    console.clear();
+    console.log(''); // Extra space at top
+    const lines = AGENT_BANNER.split('\n').filter(l => l.trim() !== '');
+
+    // Print all lines except last with gradient
+    for (let i = 0; i < lines.length - 1; i++) {
+        console.log(agentGradient(lines[i]));
+    }
+
+    // Last line + version (aligned like PikaKit)
+    console.log(agentGradient(lines[lines.length - 1]) + theme.dim(`  v${VERSION}`));
+    console.log(''); // Empty line to break vertical connector
+}
 
 // ============================================================================
 // MAIN MENU
@@ -36,14 +71,23 @@ import { VERSION } from "../config.js";
  */
 export async function showMainMenu() {
     while (true) {
-        showIntro(`🧠 Agent Skill Kit v${VERSION}`);
+        showAgentBanner();
 
         // Load settings to check auto-learning status
         const settings = loadSettings();
         const autoLearningEnabled = settings.autoLearn !== false; // Default to true
 
         // Build menu options dynamically
-        const menuOptions = [];
+        const menuOptions = [
+            // ═════════════════════════════════════════════
+            // 🔍 SCANNING & ACTIONS
+            // ═════════════════════════════════════════════
+            { value: "scanall", label: "🔎 Scan All", hint: "Check & fix violations" },
+
+            // ═════════════════════════════════════════════
+            // 📚 LEARNING & KNOWLEDGE
+            // ═════════════════════════════════════════════
+        ];
 
         // Only show Learn if auto-learning is OFF
         if (!autoLearningEnabled) {
@@ -63,6 +107,12 @@ export async function showMainMenu() {
             // ═════════════════════════════════════════════
             { value: "settings", label: "⚙️  Settings", hint: "Configure behavior" },
             { value: "backup", label: "💾 Backup", hint: "Data management" },
+
+            // ═════════════════════════════════════════════
+            // 📊 DASHBOARD
+            // ═════════════════════════════════════════════
+            { value: "dashboard", label: "📊 Dashboard", hint: "Web UI & Help" },
+
             { value: "exit", label: "👋 Exit" }
         );
 
@@ -84,7 +134,9 @@ export async function showMainMenu() {
             case "lessons":
                 await runLessonsUI();
                 break;
-
+            case "scanall":
+                await runRecallUI(true); // Auto-scan mode with fix option
+                break;
             case "stats":
                 await runStatsUI(); // Now includes signals
                 break;
@@ -94,8 +146,8 @@ export async function showMainMenu() {
             case "backup":
                 await runBackupUI();
                 break;
-            case "help":
-                await runHelpUI();
+            case "dashboard":
+                await runDashboardUI();
                 break;
         }
 

package/packages/cli/lib/ui/settings-ui.js

@@ -1,5 +1,5 @@
 /**
- * Settings UI - Minimal Interactive settings configuration
+ * Settings UI - Interactive settings configuration
  */
 import * as p from "@clack/prompts";
 import pc from "picocolors";
@@ -7,23 +7,160 @@ import {
     loadSettings,
     saveSettings,
     toggleAutoLearning,
-    toggleAutoUpdating
+    toggleAutoUpdating,
+    setApiKey,
+    getApiKey,
+    removeApiKey
 } from "../settings.js";
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+// ============================================================================
+// HELPERS
+// ============================================================================
+
+/**
+ * Mask API key for display (show first 4 and last 4 chars)
+ */
+function maskApiKey(key) {
+    if (!key) return pc.dim("[Not Set]");
+    if (key.length < 12) return "***...***";
+    return `${key.substring(0, 4)}...${key.substring(key.length - 4)}`;
+}
+
+/**
+ * Get Antigravity OAuth credentials (if available)
+ * @returns {{accessToken: string, expiryDate: number} | null}
+ */
+function getAntigravityOAuthToken() {
+    try {
+        const credPath = path.join(os.homedir(), '.gemini', 'oauth_creds.json');
+
+        if (!fs.existsSync(credPath)) return null;
+
+        const creds = JSON.parse(fs.readFileSync(credPath, 'utf8'));
+
+        // Check if token is still valid
+        if (creds.access_token && creds.expiry_date) {
+            const now = Date.now();
+            if (now < creds.expiry_date) {
+                return {
+                    accessToken: creds.access_token,
+                    expiryDate: creds.expiry_date
+                };
+            }
+        }
+
+        return null;
+    } catch (e) {
+        return null;
+    }
+}
+
+/**
+ * Detect which API key Agent is actively using (from environment)
+ * Checks multiple sources in priority order:
+ * 1. Current process environment
+ * 2. Exported Settings API key
+ * 3. SelfEvolution .env file
+ * @returns {'gemini' | 'claude' | null}
+ */
+function getActiveApiKey() {
+    // Priority 1: Current process environment (Agent session)
+    if (process.env.GEMINI_API_KEY) return 'gemini';
+    if (process.env.CLAUDE_API_KEY || process.env.ANTHROPIC_API_KEY) return 'claude';
+
+    // Priority 2: Check if we have exported keys from Settings
+    const geminiKey = getApiKey('gemini');
+    const claudeKey = getApiKey('claude');
+
+    // If Settings has a key configured, consider it "active"
+    // (because we auto-export to SelfEvolution)
+    if (geminiKey) return 'gemini';
+    if (claudeKey) return 'claude';
+
+    // Priority 3: Check Antigravity OAuth credentials
+    const oauthCreds = getAntigravityOAuthToken();
+    if (oauthCreds) return 'gemini'; // Antigravity uses Google OAuth
+
+    return null;
+}
+
+/**
+ * Format API key status (ON if active, OFF if not)
+ */
+function formatApiKeyStatus(provider, storedKey) {
+    const activeKey = getActiveApiKey();
+    const isActive = activeKey === provider;
+
+    if (!storedKey) {
+        return pc.dim("[Not Set]");
+    }
+
+    if (isActive) {
+        return `${pc.green("[ON]")} ${maskApiKey(storedKey)}`;
+    } else {
+        return `${pc.dim("[OFF]")} ${maskApiKey(storedKey)}`;
+    }
+}
 
 // ============================================================================
 // SETTINGS MENU
 // ============================================================================
 
 /**
- * Interactive settings menu - Minimal version
+ * Interactive settings menu with Clack icons
  */
 export async function runSettingsUI() {
+    // No intro - go straight to settings menu
+
+    // Display active API key info ONCE at the start
+    const geminiKey = getApiKey('gemini');
+    const claudeKey = getApiKey('claude');
+
+    let bannerMsg;
+
+    // Priority 1: Check if running in Antigravity (check for oauth_creds.json)
+    try {
+        const credPath = path.join(os.homedir(), '.gemini', 'oauth_creds.json');
+        if (fs.existsSync(credPath)) {
+            // Running in Antigravity - always show this message
+            bannerMsg = pc.green(
+                `✓ Agent Coding is using system credentials\n` +
+                `  Source: Antigravity Session (in-memory)\n` +
+                `  → Configure permanent API key below for SelfEvolution features`
+            );
+        } else {
+            // Not in Antigravity, check for configured keys
+            if (geminiKey) {
+                bannerMsg = pc.green(`✓ Using Gemini API Key (Configured)\n  → SelfEvolution features enabled`);
+            } else if (claudeKey) {
+                bannerMsg = pc.green(`✓ Using Claude API Key (Configured)\n  → SelfEvolution features enabled`);
+            } else {
+                bannerMsg = pc.yellow(`⚠ No API Key Configured\n  → Set up API key below to enable SelfEvolution features`);
+            }
+        }
+    } catch (e) {
+        // Fallback: check configured keys
+        if (geminiKey) {
+            bannerMsg = pc.green(`✓ Using Gemini API Key (Configured)\n  → SelfEvolution features enabled`);
+        } else if (claudeKey) {
+            bannerMsg = pc.green(`✓ Using Claude API Key (Configured)\n  → SelfEvolution features enabled`);
+        } else {
+            bannerMsg = pc.yellow(`⚠ No API Key Configured\n  → Set up API key below to enable SelfEvolution features`);
+        }
+    }
+
+    p.note(bannerMsg, "🔑 Active API Key");
+
     while (true) {
         const settings = loadSettings();
 
         const action = await p.select({
             message: "⚙️  Settings",
             options: [
+                // AI BEHAVIOR GROUP
                 {
                     value: "autoLearn",
                     label: `🤖 Auto-Learning: ${settings.autoLearning ? pc.green("[ON]") : pc.dim("[OFF]")}`,
@@ -32,12 +169,29 @@ export async function runSettingsUI() {
                 {
                     value: "autoUpdate",
                     label: `🔄 Auto-Updating: ${settings.autoUpdating ? pc.green("[ON]") : pc.dim("[OFF]")}`,
-                    hint: "Auto-escalate patterns"
+                    hint: "Update threshold hits"
                 },
                 {
                     value: "threshold",
                     label: `📈 Update Threshold: ${pc.cyan(settings.updateThreshold)}`,
-                    hint: "Hits before escalation"
+                    hint: "Hits before update"
+                },
+
+                // API CONFIGURATION GROUP
+                {
+                    value: "geminiKey",
+                    label: `🔑 Gemini API: ${formatApiKeyStatus('gemini', getApiKey('gemini'))}`,
+                    hint: "For agent coding"
+                },
+                {
+                    value: "claudeKey",
+                    label: `🔑 Claude API: ${formatApiKeyStatus('claude', getApiKey('claude'))}`,
+                    hint: "Alternative AI provider"
+                },
+                {
+                    value: "testOptimization",
+                    label: "🧪 Test AI Optimization",
+                    hint: "Verify SelfEvolution integration"
                 },
                 { value: "back", label: "← Back", hint: "Return to main menu" }
             ]
@@ -54,15 +208,17 @@ export async function runSettingsUI() {
                     `Auto-Learning is now ${newValue ? pc.green("ON") : pc.red("OFF")}`,
                     "Setting Updated"
                 );
-                break;
+                break; // Continue loop to show menu again
             }
             case "autoUpdate": {
                 const newValue = toggleAutoUpdating();
                 if (newValue) {
                     p.note(
                         `Auto-Updating is now ${pc.green("ON")}\n\n` +
-                        `Patterns will auto-escalate WARNING → ERROR\n` +
-                        `when violations exceed threshold.`,
+                        `When patterns become valuable, Agent will:\n` +
+                        `• Analyze learned lessons\n` +
+                        `• Generate update proposals\n` +
+                        `• Notify you for approval`,
                         "Setting Updated"
                     );
                 } else {
@@ -71,17 +227,17 @@ export async function runSettingsUI() {
                         "Setting Updated"
                     );
                 }
-                break;
+                break; // Continue loop
             }
             case "threshold": {
                 const newThreshold = await p.text({
-                    message: "Set new threshold (1-50):",
-                    placeholder: "10",
+                    message: "Set new threshold (1-20):",
+                    placeholder: "5",
                     initialValue: String(settings.updateThreshold),
                     validate: (value) => {
                         const num = parseInt(value);
-                        if (isNaN(num) || num < 1 || num > 50) {
-                            return "Please enter a number between 1 and 50";
+                        if (isNaN(num) || num < 1 || num > 20) {
+                            return "Please enter a number between 1 and 20";
                         }
                     }
                 });
@@ -90,10 +246,132 @@ export async function runSettingsUI() {
                     settings.updateThreshold = parseInt(newThreshold);
                     saveSettings(settings);
                     p.note(
-                        `Update threshold set to ${pc.cyan(settings.updateThreshold)}`,
+                        `Update threshold set to ${settings.updateThreshold}`,
                         "Setting Updated"
                     );
                 }
+                break; // Continue loop
+            }
+            case "geminiKey":
+            case "claudeKey": {
+                const provider = action === "geminiKey" ? "gemini" : "claude";
+                const providerName = provider.charAt(0).toUpperCase() + provider.slice(1);
+                const currentKey = getApiKey(provider);
+
+                // Ask user action
+                const keyAction = await p.select({
+                    message: `${providerName} API Key:`,
+                    options: [
+                        { value: "set", label: "Set/Update Key", hint: "Configure API key" },
+                        ...(currentKey ? [{ value: "remove", label: "Remove Key", hint: "Clear stored key" }] : []),
+                        { value: "cancel", label: "Cancel", hint: "Go back" }
+                    ]
+                });
+
+                if (p.isCancel(keyAction) || keyAction === "cancel") {
+                    break; // Return to settings menu
+                }
+
+                if (keyAction === "set") {
+                    const apiKey = await p.password({
+                        message: `Enter ${providerName} API Key:`,
+                        mask: "*",
+                        validate: (value) => {
+                            if (!value || value.length < 10) {
+                                return "API key must be at least 10 characters";
+                            }
+                        }
+                    });
+
+                    if (!p.isCancel(apiKey)) {
+                        const success = setApiKey(provider, apiKey);
+                        if (success) {
+                            p.note(
+                                `${providerName} API key ${currentKey ? 'updated' : 'set'} successfully!\n\n` +
+                                `Key: ${maskApiKey(apiKey)}\n` +
+                                `Stored in: .agent/knowledge/settings.yaml`,
+                                pc.green("✓ API Key Saved")
+                            );
+                        } else {
+                            p.note(
+                                `Failed to save ${providerName} API key`,
+                                pc.red("✗ Error")
+                            );
+                        }
+                    }
+                } else if (keyAction === "remove") {
+                    const confirm = await p.confirm({
+                        message: `Remove ${providerName} API key?`,
+                    });
+
+                    if (confirm && !p.isCancel(confirm)) {
+                        removeApiKey(provider);
+                        p.note(
+                            `${providerName} API key removed`,
+                            "Key Removed"
+                        );
+                    }
+                }
+                break;
+            }
+            case "testOptimization": {
+                const { exportApiKeysToSelfEvolution, verifySelfEvolutionAccess } =
+                    await import('../selfevolution-bridge.js');
+
+                // Step 1: Export keys
+                const spinner = p.spinner();
+                spinner.start('Exporting API keys to SelfEvolution...');
+
+                const exportResult = exportApiKeysToSelfEvolution();
+
+                if (!exportResult.success) {
+                    spinner.stop('Export failed');
+                    p.note(
+                        `❌ No API keys configured\n\n` +
+                        `Please set Gemini or Claude API key first.\n\n` +
+                        `Reason: ${exportResult.reason}`,
+                        pc.red('✗ Cannot Test')
+                    );
+                    break;
+                }
+
+                spinner.message('Keys exported. Verifying Python access...');
+
+                // Step 2: Verify Python can access
+                const verifyResult = await verifySelfEvolutionAccess();
+
+                if (verifyResult.success && verifyResult.keyDetected) {
+                    spinner.stop('Verification complete');
+
+                    const exportedKeys = [];
+                    if (exportResult.exported.gemini) exportedKeys.push('Gemini');
+                    if (exportResult.exported.claude) exportedKeys.push('Claude');
+
+                    p.note(
+                        `✅ **API Key Integration Working!**\n\n` +
+                        `Exported: ${exportedKeys.join(', ')}\n` +
+                        `Location: ${exportResult.path}\n\n` +
+                        `SelfEvolution can now:\n` +
+                        `• Auto-learn from mistakes\n` +
+                        `• AI-powered lesson optimization\n` +
+                        `• Self-improve knowledge base\n\n` +
+                        `${pc.dim('Python Output:')}\n${pc.dim(verifyResult.output)}`,
+                        pc.green('✓ Optimization Ready')
+                    );
+                } else {
+                    spinner.stop('Verification failed');
+                    p.note(
+                        `⚠️ **Export OK, but verification failed**\n\n` +
+                        `Keys exported to: ${exportResult.path}\n` +
+                        `But Python script couldn't detect them.\n\n` +
+                        `Error: ${verifyResult.error || 'Unknown'}\n\n` +
+                        `Possible causes:\n` +
+                        `• Python not installed\n` +
+                        `• SelfEvolution scripts missing\n` +
+                        `• Environment variable issue`,
+                        pc.yellow('⚠ Partial Success')
+                    );
+                }
                 break;
             }
         }

package/packages/cli/lib/ui/stats-ui.js

@@ -1,73 +1,123 @@
 /**
- * Stats UI - Compact single-screen insight using Clack boxes
+ * Stats UI - Knowledge base statistics display
  */
-import { getKnowledge } from "./common.js";
-import { showIntro, createSpinner } from "./clack-helpers.js";
+import { ICONS, getKnowledge, line, VERSION } from "./common.js";
+import { showIntro, showInfoNote, showSuccessNote, createSpinner, theme } from "./clack-helpers.js";
+import { signalQueue, getEvolutionStats } from "../evolution-signal.js";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
 
 // ============================================================================
-// INSIGHT - SINGLE SCREEN WITH CLACK BOXES
+// STATS DISPLAY
 // ============================================================================
 
+/**
+ * Stats UI - Show knowledge base statistics with cognitive insights
+ */
 export async function runStatsUI() {
-    process.stdout.write('\x1Bc');
-    showIntro("📊 Insight");
+    // Clear terminal và reset cursor về top-left
+    process.stdout.write('\x1Bc'); // Full terminal reset
+
+    showIntro("📊 Knowledge Base Stats");
 
-    const spinner = createSpinner("Loading...");
+    const spinner = createSpinner("Loading statistics...");
 
     try {
         const db = getKnowledge();
         const lessons = db.lessons || [];
-        const total = lessons.length;
 
-        spinner.stopSuccess("Loaded");
+        // Calculate statistics with cognitive awareness
+        const totalLessons = lessons.length;
+        const mistakes = lessons.filter(l => l.type === 'mistake');
+        const improvements = lessons.filter(l => l.type === 'improvement');
 
-        if (total === 0) {
-            p.note(pc.dim("No patterns learned yet."), "Empty");
-            await waitBack();
-            return;
-        }
+        // Cognitive grouping - Intent
+        const byIntent = lessons.reduce((acc, l) => {
+            const intent = l.intent || 'unknown';
+            acc[intent] = (acc[intent] || 0) + 1;
+            return acc;
+        }, {});
+
+        // Cognitive grouping - Pattern Type
+        const byPatternType = lessons.reduce((acc, l) => {
+            const type = l.patternType || 'general';
+            acc[type] = (acc[type] || 0) + 1;
+            return acc;
+        }, {});
 
-        // Quick counts
-        const mistakes = lessons.filter(l => l.type === 'mistake').length;
-        const improvements = lessons.filter(l => l.type === 'improvement').length;
-        const errors = lessons.filter(l => l.severity === 'ERROR').length;
-        const warnings = lessons.filter(l => l.severity === 'WARNING').length;
+        // Cognitive grouping - Maturity
+        const byMaturity = lessons.reduce((acc, l) => {
+            const maturity = l.cognitive?.maturity || 'learning';
+            acc[maturity] = (acc[maturity] || 0) + 1;
+            return acc;
+        }, {});
 
-        // Top hits
+        // Top 5 by hit count
         const topHits = lessons
-            .filter(l => l.hitCount && l.hitCount > 0)
+            .filter(p => p.hitCount && p.hitCount > 0)
             .sort((a, b) => b.hitCount - a.hitCount)
-            .slice(0, 3);
+            .slice(0, 5);
+
+        spinner.stopSuccess("Stats loaded");
 
-        // ========== CLACK NOTE BOX ==========
-        const summaryContent = [
-            `${pc.red('●')} ${mistakes} Mistakes    ${pc.green('●')} ${improvements} Improvements`,
-            `${pc.red('⊘')} ${errors} Errors      ${pc.yellow('⚠')} ${warnings} Warnings`
-        ].join('\n');
+        // Compact single-line display
+        console.log(`\n${pc.bold('📊 Knowledge Stats')} ${pc.dim(`(${totalLessons} lessons)`)}\n`);
 
-        p.note(summaryContent, `📈 Summary (${total} patterns)`);
+        console.log(
+            `${pc.red('●')} ${mistakes.length} Mistakes  ` +
+            `${pc.green('●')} ${improvements.length} Improvements  ` +
+            `${pc.dim('│')}  ` +
+            `${pc.red('🛡️')} ${byIntent.prevent || 0} Prevent  ` +
+            `${pc.yellow('⚠️')} ${byIntent.warn || 0} Warn  ` +
+            `${pc.green('⚡')} ${byIntent.optimize || 0} Optimize\n`
+        );
 
-        // Top Patterns box
+        console.log(
+            `${pc.dim('Types:')} ` +
+            `${byPatternType.security ? `🔒${byPatternType.security} ` : ''}` +
+            `${byPatternType.dependency ? `📦${byPatternType.dependency} ` : ''}` +
+            `${byPatternType.structure ? `🏗️${byPatternType.structure} ` : ''}` +
+            `${byPatternType.quality ? `✨${byPatternType.quality} ` : ''}` +
+            `${byPatternType.performance ? `⚡${byPatternType.performance} ` : ''}` +
+            `${byPatternType.general ? pc.dim(`📝${byPatternType.general}`) : ''}\n`
+        );
+
+        console.log(
+            `${pc.dim('Maturity:')} ` +
+            `${pc.green('✓')} ${byMaturity.stable || 0} Stable  ` +
+            `${pc.cyan('📚')} ${byMaturity.learning || 0} Learning\n`
+        );
+
+        // Show top 3 hits in compact format
         if (topHits.length > 0) {
-            const topContent = topHits
-                .map((l, i) => `${i + 1}. ${pc.dim(l.id?.slice(0, 12) || '?')} → ${pc.bold(l.hitCount)}× hits`)
-                .join('\n');
-            p.note(topContent, "🔥 Top Patterns");
+            console.log(`${pc.bold('🔥 Top Patterns')}`);
+            topHits.slice(0, 3).forEach((p, i) => {
+                console.log(`  ${i + 1}. ${pc.dim(p.id)} ${pc.bold(p.hitCount)}×`);
+            });
+            console.log('');
         }
 
-        await waitBack();
+        // Show signal queue summary
+        const signalStats = getEvolutionStats();
+        const pending = signalQueue.getPending();
+
+        console.log(`${pc.bold('📡 Signal Queue')}`);
+        console.log(
+            `  ${pc.yellow('⏳')} ${signalStats.pending} Pending  ` +
+            `${pc.green('✓')} ${signalStats.approved} Approved  ` +
+            `${pc.red('✗')} ${signalStats.rejected} Rejected\n`
+        );
+
+        // User can choose next action
+        await p.select({
+            message: "What's next?",
+            options: [
+                { value: "back", label: "← Back to Main Menu" }
+            ]
+        });
 
     } catch (error) {
-        spinner.stopError("Failed");
-        p.note(error.message, "Error");
+        spinner.stopError("Failed to load stats");
+        console.error(error);
     }
 }
-
-async function waitBack() {
-    await p.select({
-        message: "",
-        options: [{ value: "back", label: "← Back" }]
-    });
-}

package/packages/cli/lib/watcher.js

@@ -8,7 +8,7 @@
  * - Pattern frequency tracking
  * - Live feedback on violations
  * 
- * Usage: ag-smart watch [directory]
+ * Usage: agent watch [directory]
  */
 
 import fs from "fs";
@@ -159,7 +159,7 @@ if (args.includes("--help")) {
 👁️  Smart Watcher - Real-Time Monitor
 
 Usage:
-  ag-smart watch [directory]
+  agent watch [directory]
 
 Options:
   --help    Show this help