add-skill-kit 3.2.4 → 3.2.6

package/lib/agent-cli/lib/learn.js

@@ -10,9 +10,9 @@
  * - Source tracking (manual, eslint, test-failure)
  * 
  * Usage:
- *   ag-smart learn --add --pattern "regex" --message "why bad"
- *   ag-smart learn --list
- *   ag-smart learn --remove <id>
+ *   agent learn --add --pattern "regex" --message "why bad"
+ *   agent learn --list
+ *   agent learn --remove <id>
  */
 
 import fs from "fs";
@@ -147,7 +147,7 @@ function listLessons(category = null) {
 
     if (!db.lessons || db.lessons.length === 0) {
         console.log("\nℹ️  No lessons learned yet.");
-        console.log("   Use: ag-smart learn --add --pattern \"pat\" --message \"msg\"\n");
+        console.log("   Use: agent learn --add --pattern \"pat\" --message \"msg\"\n");
         return;
     }
 
@@ -180,9 +180,9 @@ function printHelp() {
 🎓 Smart Learning Tool v${VERSION}
 
 USAGE:
-  ag-smart learn --add --pattern "..." --message "..."
-  ag-smart learn --list [--category <cat>]
-  ag-smart learn --remove <ID>
+  agent learn --add --pattern "..." --message "..."
+  agent learn --list [--category <cat>]
+  agent learn --remove <ID>
 
 OPTIONS:
   --add         Add a new lesson
@@ -195,9 +195,9 @@ OPTIONS:
   --help        Show this help
 
 EXAMPLES:
-  ag-smart learn --add --pattern "console\\.log" --message "No console.log in production" --severity ERROR
-  ag-smart learn --list
-  ag-smart learn --remove LEARN-001
+  agent learn --add --pattern "console\\.log" --message "No console.log in production" --severity ERROR
+  agent learn --list
+  agent learn --remove LEARN-001
 `);
 }
 

package/lib/agent-cli/lib/recall.js

@@ -465,7 +465,7 @@ Options:
     const db = loadKnowledge();
 
     if (!db.lessons || db.lessons.length === 0) {
-        console.log("ℹ️  No lessons learned yet. Use 'ag-smart learn' to add patterns.");
+        console.log("ℹ️  No lessons learned yet. Use 'agent learn' to add patterns.");
         process.exit(0);
     }
 

package/lib/agent-cli/lib/settings.js

@@ -57,12 +57,26 @@ export function saveSettings(settings) {
 
 /**
  * Toggle Auto-Learning setting
+ * When enabled, runs a quick scan automatically
  * @returns {boolean} New value
  */
 export function toggleAutoLearning() {
     const settings = loadSettings();
     settings.autoLearning = !settings.autoLearning;
     saveSettings(settings);
+
+    // When turning ON, run quick scan (async, non-blocking)
+    if (settings.autoLearning) {
+        import('../services/auto-learn-service.js')
+            .then(({ quickScan }) => {
+                console.log('\n🧠 Auto-Learning enabled! Running quick scan...\n');
+                quickScan().catch(() => { });
+            })
+            .catch(() => {
+                // Silent fail if service not available
+            });
+    }
+
     return settings.autoLearning;
 }
 
@@ -186,6 +200,15 @@ export function removeApiKey(provider) {
     }
 }
 
+/**
+ * Run full Auto-Learn cycle manually
+ * @returns {Promise<object>} Results from all scripts
+ */
+export async function runAutoLearnCycle() {
+    const { runFullCycle } = await import('../services/auto-learn-service.js');
+    return runFullCycle();
+}
+
 export default {
     loadSettings,
     saveSettings,
@@ -198,6 +221,7 @@ export default {
     setApiKey,
     getApiKey,
     removeApiKey,
+    runAutoLearnCycle,
     SETTINGS_PATH
 };
 

package/lib/agent-cli/lib/skill-learn.js

@@ -7,7 +7,7 @@
  * 
  * This makes the Self-Learning Engine truly "self-learning"!
  * 
- * Usage: ag-smart sync-skills
+ * Usage: agent sync-skills
  */
 
 import fs from "fs";
@@ -280,7 +280,7 @@ if (args.includes("--help")) {
 🔄 Skill Sync - Auto-update SKILL.md
 
 Usage:
-  ag-smart sync-skills
+  agent sync-skills
 
 When patterns reach ${SYNC_THRESHOLD}+ violations, they are automatically
 added to the relevant SKILL.md file as learned rules.

package/lib/agent-cli/lib/stats.js

@@ -7,7 +7,7 @@
  * - Most triggered patterns
  * - Violation trends
  * 
- * Usage: ag-smart stats
+ * Usage: agent stats
  */
 
 import { loadKnowledge } from "./recall.js";
@@ -25,7 +25,7 @@ function displayStats() {
     p.intro(pc.cyan(`📊 Smart Agent Knowledge Base v${VERSION}`));
 
     if (!db.lessons || db.lessons.length === 0) {
-        p.note("No lessons learned yet.\nUse 'ag-smart learn' to add patterns.", pc.dim("Empty"));
+        p.note("No lessons learned yet.\nUse 'agent learn' to add patterns.", pc.dim("Empty"));
         return;
     }
 
@@ -118,7 +118,7 @@ if (args.includes("--help")) {
 📊 Smart Stats - Knowledge Base Statistics
 
 Usage:
-  ag-smart stats
+  agent stats
 
 Shows:
   - Total lessons and violations

package/lib/agent-cli/lib/ui/dashboard-ui.js

@@ -7,6 +7,51 @@ import path from "path";
 import fs from "fs";
 import http from "http";
 
+// Track running server globally
+let runningServer = null;
+let runningPort = null;
+
+/**
+ * Check if a port is already in use by our dashboard
+ * Uses /api/summary to verify it's actually our dashboard server
+ */
+async function checkPortInUse(port) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://localhost:${port}/api/summary`, (res) => {
+            // If we get 200 response from /api/summary, it's our dashboard
+            if (res.statusCode === 200) {
+                resolve(true);
+            } else {
+                resolve(false);
+            }
+            req.destroy();
+        });
+        req.on('error', () => {
+            resolve(false);
+        });
+        // Faster timeout - 500ms is enough for localhost
+        req.setTimeout(500, () => {
+            req.destroy();
+            resolve(false);
+        });
+    });
+}
+
+/**
+ * Find existing dashboard server on ports 3030-3040
+ */
+async function findExistingServer() {
+    // Check ports in parallel for faster detection
+    const portChecks = [];
+    for (let port = 3030; port <= 3040; port++) {
+        portChecks.push(checkPortInUse(port).then(inUse => inUse ? port : null));
+    }
+
+    const results = await Promise.all(portChecks);
+    const existingPort = results.find(port => port !== null);
+    return existingPort || null;
+}
+
 /**
  * Find an available port
  */
@@ -26,14 +71,26 @@ async function findAvailablePort(startPort = 3030) {
  * Find dashboard server script
  */
 function findDashboardScript() {
+    // Get the directory where this module is located
+    const moduleDir = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/i, '$1'));
+    const cliRoot = path.resolve(moduleDir, '..', '..');
+
+    // User home directory
+    const homeDir = process.env.USERPROFILE || process.env.HOME || '';
+
     const possiblePaths = [
+        // PRIORITY 1: Bundled with CLI package (always available)
+        path.join(cliRoot, "dashboard", "dashboard_server.js"),
+        // PRIORITY 2: Current project paths
         path.join(process.cwd(), ".agent", "skills", "auto-learner", "scripts", "dashboard_server.js"),
-        path.join(process.cwd(), ".agent", "agentskillskit", ".agent", "skills", "auto-learner", "scripts", "dashboard_server.js")
+        path.join(process.cwd(), ".agent", "agentskillskit", ".agent", "skills", "auto-learner", "scripts", "dashboard_server.js"),
+        // PRIORITY 3: Fallback user paths (Windows Desktop)
+        path.join(homeDir, "Desktop", "agent-skill-kit", ".agent", "skills", "auto-learner", "scripts", "dashboard_server.js"),
     ];
 
-    for (const p of possiblePaths) {
-        if (fs.existsSync(p)) {
-            return p;
+    for (const searchPath of possiblePaths) {
+        if (fs.existsSync(searchPath)) {
+            return searchPath;
         }
     }
     return null;
@@ -67,6 +124,43 @@ function openBrowser(url) {
 export async function runDashboardUI() {
     const spinner = p.spinner();
 
+    // Check if there's already a server running
+    spinner.start("Checking for existing dashboard server...");
+    const existingPort = await findExistingServer();
+
+    if (existingPort) {
+        spinner.stop(`Found existing server on port ${existingPort}`);
+        const url = `http://localhost:${existingPort}`;
+
+        p.log.success(`Dashboard already running at: ${url}`);
+        openBrowser(url);
+
+        p.note(`Server running on port ${existingPort}\nUsing existing server`, "📊 Auto-Learn Dashboard");
+
+        const action = await p.select({
+            message: "Dashboard is running. What would you like to do?",
+            options: [
+                { value: "keep", label: "🏠 Back to menu", hint: "Keep server running" },
+                { value: "stop", label: "🛑 Stop server", hint: "Shutdown dashboard" }
+            ]
+        });
+
+        if (action === "stop") {
+            // Kill all node processes on that port
+            p.log.info("Stopping existing server...");
+            if (process.platform === "win32") {
+                exec(`for /f "tokens=5" %a in ('netstat -aon ^| findstr :${existingPort}') do taskkill /F /PID %a`, () => { });
+            } else {
+                exec(`lsof -ti:${existingPort} | xargs kill -9`, () => { });
+            }
+            await new Promise(r => setTimeout(r, 1000));
+            p.log.success("Dashboard server stopped");
+        }
+        return;
+    }
+
+    spinner.stop("No existing server found");
+
     // Find dashboard script
     const scriptPath = findDashboardScript();
 
@@ -79,6 +173,7 @@ export async function runDashboardUI() {
     // Find available port
     spinner.start("Finding available port...");
     const port = await findAvailablePort(3030);
+    runningPort = port;
     spinner.stop(`Using port ${port}`);
 
     // Start dashboard server
@@ -89,6 +184,8 @@ export async function runDashboardUI() {
         detached: false
     });
 
+    runningServer = child;
+
     // Wait for server to start
     await new Promise((resolve) => setTimeout(resolve, 1500));
 
@@ -114,6 +211,8 @@ export async function runDashboardUI() {
 
     if (action === "stop" || p.isCancel(action)) {
         child.kill();
+        runningServer = null;
+        runningPort = null;
         p.log.info("Dashboard server stopped");
     } else {
         p.log.info(`Dashboard still running at ${url}`);

package/lib/agent-cli/lib/ui/index.js

@@ -27,6 +27,40 @@ 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
@@ -37,7 +71,7 @@ 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();
@@ -77,9 +111,8 @@ export async function showMainMenu() {
             // ═════════════════════════════════════════════
             // 📊 DASHBOARD
             // ═════════════════════════════════════════════
-            { value: "dashboard", label: "📊 Dashboard", hint: "Web UI for Auto-Learn" },
+            { value: "dashboard", label: "📊 Dashboard", hint: "Web UI & Help" },
 
-            { value: "help", label: "📖 Help", hint: "Visual guide" },
             { value: "exit", label: "👋 Exit" }
         );
 
@@ -113,9 +146,6 @@ export async function showMainMenu() {
             case "backup":
                 await runBackupUI();
                 break;
-            case "help":
-                await runHelpUI();
-                break;
             case "dashboard":
                 await runDashboardUI();
                 break;

package/lib/agent-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

package/lib/agent-cli/package.json

@@ -1,13 +1,13 @@
 {
     "name": "agentskillskit-cli",
-    "version": "3.2.1",
+    "version": "3.2.4",
     "description": "CLI for Agent Skill Kit",
     "type": "module",
     "main": "lib/config.js",
     "bin": {
-        "agent": "bin/ag-smart.js",
-        "ag-smart": "bin/ag-smart.js",
-        "agent-skills-kit": "bin/ag-smart.js"
+        "agent": "bin/agent.js",
+        "agent": "bin/agent.js",
+        "agent-skills-kit": "bin/agent.js"
     },
     "scripts": {
         "test": "vitest run",