@agentskillkit/agent-skills 3.2.1 → 3.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskillkit/agent-skills",
-  "version": "3.2.1",
+  "version": "3.2.5",
   "description": "The Agent Skills Kit for Enterprise",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
     "LICENSE"
   ],
   "bin": {
-    "agent-skills-kit": "./packages/cli/bin/ag-smart.js",
-    "ag-smart": "./packages/cli/bin/ag-smart.js"
+    "agent": "./packages/cli/bin/agent.js",
+    "kit": "./packages/kit/kit.js"
   },
   "type": "module",
   "scripts": {
@@ -79,4 +79,4 @@
     "js-yaml": "^4.1.1",
     "picocolors": "^1.1.1"
   }
-}
+}

package/packages/cli/lib/audit.js

@@ -7,7 +7,7 @@
  * 2. Constitution Checks (Governance)
  * 3. Real-time Analysis
  * 
- * Usage: ag-smart audit [directory]
+ * Usage: agent audit [directory]
  */
 
 import fs from "fs";
@@ -143,7 +143,7 @@ if (args.includes("--help")) {
 ⚖️  Smart Audit - Compliance Checker
 
 Usage:
-  ag-smart audit [directory]
+  agent audit [directory]
 
 Options:
   --help    Show this help

package/packages/cli/lib/auto-learn.js

@@ -8,10 +8,10 @@
  * 3. TypeScript errors (runs tsc and parses)
  * 
  * Usage:
- *   ag-smart auto-learn              # Run all
- *   ag-smart auto-learn --eslint     # ESLint only
- *   ag-smart auto-learn --test       # Test failures only
- *   ag-smart auto-learn --typescript # TypeScript only
+ *   agent auto-learn              # Run all
+ *   agent auto-learn --eslint     # ESLint only
+ *   agent auto-learn --test       # Test failures only
+ *   agent auto-learn --typescript # TypeScript only
  */
 
 import fs from "fs";
@@ -297,10 +297,10 @@ if (args.includes("--help")) {
 🧠 Smart Auto-Learn - True Self-Learning Engine
 
 Usage:
-  ag-smart auto-learn              Run all analyzers
-  ag-smart auto-learn --eslint     ESLint only
-  ag-smart auto-learn --typescript TypeScript only
-  ag-smart auto-learn --test       Test failures only
+  agent auto-learn              Run all analyzers
+  agent auto-learn --eslint     ESLint only
+  agent auto-learn --typescript TypeScript only
+  agent auto-learn --test       Test failures only
 
 The engine automatically:
   1. Runs ESLint and learns from violations

package/packages/cli/lib/eslint-fix.js

@@ -5,7 +5,7 @@
  * Wrapper around ESLint --fix to combine with pattern-based fix.
  * Auto-detects ESLint config and runs fixes.
  * 
- * Usage: ag-smart fix --eslint <path>
+ * Usage: agent fix --eslint <path>
  */
 
 import { execSync, spawnSync } from "child_process";

package/packages/cli/lib/fix.js

@@ -9,7 +9,7 @@
  * - Remove violations (aggressive mode)
  * - Replace patterns (custom fix rules)
  * 
- * Usage: ag-smart fix <file|directory> [--mode safe|aggressive]
+ * Usage: agent fix <file|directory> [--mode safe|aggressive]
  */
 
 import fs from "fs";
@@ -249,7 +249,7 @@ async function main() {
 🔧 Smart Fix v${VERSION} - Auto-fix Violations
 
 Usage:
-  ag-smart fix <file|directory> [options]
+  agent fix <file|directory> [options]
 
 Options:
   --mode safe        Comment out violations (default)
@@ -259,9 +259,9 @@ Options:
   --help             Show this help
 
 Examples:
-  ag-smart fix src/
-  ag-smart fix app.js --mode aggressive
-  ag-smart fix src/ --eslint
+  agent fix src/
+  agent fix app.js --mode aggressive
+  agent fix src/ --eslint
 `);
         process.exit(0);
     }

package/packages/cli/lib/hooks/install-hooks.js

@@ -4,7 +4,7 @@
  * 
  * Installs pre-commit hook that runs recall on staged files.
  * 
- * Usage: ag-smart install-hooks
+ * Usage: agent install-hooks
  */
 
 import fs from "fs";
@@ -26,7 +26,7 @@ if [ -z "$STAGED_FILES" ]; then
 fi
 
 # Run recall (Clack handles all output)
-npx ag-smart recall . 2>/dev/null
+npx agent recall . 2>/dev/null
 exit $?
 `;
 
@@ -136,8 +136,8 @@ if (args.includes("--help")) {
 🔧 Agent Skill Kit Hooks Installer
 
 Usage:
-  ag-smart install-hooks           Install git hooks
-  ag-smart install-hooks --remove  Remove installed hooks
+  agent install-hooks           Install git hooks
+  agent install-hooks --remove  Remove installed hooks
 
 The pre-commit hook checks staged files against learned
 patterns before each commit.

package/packages/cli/lib/hooks/lint-learn.js

@@ -5,8 +5,8 @@
  * Parses ESLint JSON output and creates lessons automatically.
  * 
  * Usage:
- *   npx eslint . --format json | ag-smart lint-learn
- *   npx eslint . --format json > output.json && ag-smart lint-learn output.json
+ *   npx eslint . --format json | agent lint-learn
+ *   npx eslint . --format json > output.json && agent lint-learn output.json
  */
 
 import fs from "fs";
@@ -86,8 +86,8 @@ async function main() {
 🔧 Lint Learn - Auto-Learn from ESLint
 
 Usage:
-  npx eslint . --format json | ag-smart lint-learn
-  ag-smart lint-learn eslint-output.json
+  npx eslint . --format json | agent lint-learn
+  agent lint-learn eslint-output.json
 
 Creates lessons from ESLint violations automatically.
 `);

package/packages/cli/lib/knowledge-index.js

@@ -6,8 +6,8 @@
  * Regenerates on-demand when knowledge files change.
  * 
  * Usage:
- *   ag-smart index --rebuild    # Force rebuild index
- *   ag-smart index --status     # Check index freshness
+ *   agent index --rebuild    # Force rebuild index
+ *   agent index --status     # Check index freshness
  */
 
 import fs from 'fs';
@@ -300,8 +300,8 @@ function main() {
 📇 Knowledge Index Manager
 
 Usage:
-  ag-smart index --rebuild    Rebuild index from knowledge files
-  ag-smart index --status     Check if index is fresh or stale
+  agent index --rebuild    Rebuild index from knowledge files
+  agent index --status     Check if index is fresh or stale
 
 The index provides O(1) lookup for:
   - Pattern matching (by keyword)

package/packages/cli/lib/knowledge-metrics.js

@@ -6,8 +6,8 @@
  * Metrics are collected on-demand or on scan completion.
  * 
  * Usage:
- *   ag-smart metrics           # Show dashboard
- *   ag-smart metrics --json    # JSON output for CI
+ *   agent metrics           # Show dashboard
+ *   agent metrics --json    # JSON output for CI
  */
 
 import fs from 'fs';

package/packages/cli/lib/knowledge-retention.js

@@ -6,9 +6,9 @@
  * Archives or soft-deletes stale lessons based on policy rules.
  * 
  * Usage:
- *   ag-smart retention --dry-run    # Preview what would be cleaned
- *   ag-smart retention --apply      # Execute cleanup (with confirmation)
- *   ag-smart retention --status     # Show retention policy status
+ *   agent retention --dry-run    # Preview what would be cleaned
+ *   agent retention --apply      # Execute cleanup (with confirmation)
+ *   agent retention --status     # Show retention policy status
  */
 
 import fs from 'fs';

package/packages/cli/lib/knowledge-validator.js

@@ -6,9 +6,9 @@
  * Ensures data integrity and prevents corruption.
  * 
  * Usage:
- *   ag-smart validate               # Validate all knowledge files
- *   ag-smart validate --fix         # Auto-fix minor issues
- *   ag-smart validate --json        # JSON output for CI
+ *   agent validate               # Validate all knowledge files
+ *   agent validate --fix         # Auto-fix minor issues
+ *   agent validate --json        # JSON output for CI
  */
 
 import fs from 'fs';

package/packages/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/packages/cli/lib/recall.js

@@ -471,7 +471,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/packages/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/packages/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(`📊 Agent Skill Kit 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/packages/cli/lib/ui/dashboard-ui.js

@@ -0,0 +1,222 @@
+/**
+ * Dashboard UI - Launch Auto-Learn Dashboard in browser
+ */
+import * as p from "@clack/prompts";
+import { spawn, exec } from "child_process";
+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
+ */
+async function findAvailablePort(startPort = 3030) {
+    return new Promise((resolve) => {
+        const server = http.createServer();
+        server.listen(startPort, () => {
+            server.close(() => resolve(startPort));
+        });
+        server.on("error", () => {
+            resolve(findAvailablePort(startPort + 1));
+        });
+    });
+}
+
+/**
+ * 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"),
+        // PRIORITY 3: Fallback user paths (Windows Desktop)
+        path.join(homeDir, "Desktop", "agent-skill-kit", ".agent", "skills", "auto-learner", "scripts", "dashboard_server.js"),
+    ];
+
+    for (const searchPath of possiblePaths) {
+        if (fs.existsSync(searchPath)) {
+            return searchPath;
+        }
+    }
+    return null;
+}
+
+/**
+ * Open URL in default browser
+ */
+function openBrowser(url) {
+    const platform = process.platform;
+    let command;
+
+    if (platform === "win32") {
+        command = `start "" "${url}"`;
+    } else if (platform === "darwin") {
+        command = `open "${url}"`;
+    } else {
+        command = `xdg-open "${url}"`;
+    }
+
+    exec(command, (err) => {
+        if (err) {
+            p.log.warn(`Could not open browser automatically. Visit: ${url}`);
+        }
+    });
+}
+
+/**
+ * Run Dashboard UI
+ */
+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();
+
+    if (!scriptPath) {
+        p.log.error("Dashboard script not found!");
+        p.log.info("Install auto-learner skill first or check .agent/skills/auto-learner/scripts/");
+        return;
+    }
+
+    // Find available port
+    spinner.start("Finding available port...");
+    const port = await findAvailablePort(3030);
+    runningPort = port;
+    spinner.stop(`Using port ${port}`);
+
+    // Start dashboard server
+    spinner.start("Starting dashboard server...");
+
+    const child = spawn("node", [scriptPath, "--port", String(port)], {
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: false
+    });
+
+    runningServer = child;
+
+    // Wait for server to start
+    await new Promise((resolve) => setTimeout(resolve, 1500));
+
+    spinner.stop("Dashboard server started!");
+
+    const url = `http://localhost:${port}`;
+
+    // Open browser
+    p.log.success(`Dashboard running at: ${url}`);
+    openBrowser(url);
+
+    p.log.info("Dashboard opened in browser");
+    p.note(`Server running on port ${port}\nPress Ctrl+C in terminal to stop`, "📊 Auto-Learn Dashboard");
+
+    // Keep server running and wait for user
+    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" || p.isCancel(action)) {
+        child.kill();
+        runningServer = null;
+        runningPort = null;
+        p.log.info("Dashboard server stopped");
+    } else {
+        p.log.info(`Dashboard still running at ${url}`);
+    }
+}
+
+export default runDashboardUI;

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

@@ -1,26 +1,49 @@
 /**
- * Help/Guide UI - Ultra Compact
+ * Help/Guide UI - Compact Visual Guide
  */
 import * as p from "@clack/prompts";
 import pc from "picocolors";
 
+/**
+ * Show compact visual guide (fits in one screen)
+ */
 export async function runHelpUI() {
-  process.stdout.write('\x1Bc');
-  p.intro(pc.cyan("📖 Quick Guide"));
-
-  const guide = [
-    `${pc.bold(" Lessons")}   View/edit learned patterns`,
-    `${pc.bold("💡 Insights")}  Stats & top violations`,
-    `${pc.bold("⚙️  Settings")} Auto-learn, threshold`,
-    `${pc.bold("💾 Backup")}    Export/import data`,
-    ``,
-    `${pc.dim("Agent Coding → learns mistakes → warns you")}`
-  ].join('\n');
-
-  p.note(guide, "Menu");
-
-  await p.select({
-    message: "",
-    options: [{ value: "back", label: "← Back" }]
+  // Clear terminal và reset cursor về top-left
+  process.stdout.write('\x1Bc'); // Full terminal reset
+
+  p.intro(pc.cyan("📖 Agent Skill Kit - Quick Guide"));
+
+  console.log(`
+${pc.bold(pc.yellow("🎯 HOW IT WORKS"))}
+  ${pc.green("Write Code")} → ${pc.yellow("Agent Scans")} → ${pc.blue("Learns Patterns")} → ${pc.magenta("Auto Warns")}
+
+${pc.bold(pc.yellow("🔧 MENU OPTIONS"))}
+  ${pc.cyan("🔎 Scan All")}     - Check violations + option to auto-fix
+  ${pc.cyan("📝 Learn")}        - Teach agent new patterns (manual mode only)
+  ${pc.cyan("📚 Knowledge")}    - View lessons & review pending patterns
+  ${pc.cyan("📊 Stats")}        - Project metrics & insights
+  ${pc.cyan("⚙️  Settings")}    - Configure auto-learning, API keys
+  ${pc.cyan("💾 Backup")}       - Manage knowledge backups
+
+${pc.bold(pc.yellow("🚀 QUICK START"))}
+  ${pc.bold("1.")} ${pc.cyan("Scan All")} ${pc.dim("→ See current violations")}
+  ${pc.bold("2.")} ${pc.cyan("Fix All")} ${pc.dim("→ Auto-fix simple issues")}
+  ${pc.bold("3.")} ${pc.cyan("Knowledge")} ${pc.dim("→ Review what agent learned")}
+
+${pc.green("✓")} Agent learns from your code automatically
+${pc.green("✓")} All fixes are backed up safely
+${pc.green("✓")} The more you use it, the smarter it gets!
+`);
+
+  // User selects next action
+  const action = await p.select({
+    message: "What's next?",
+    options: [
+      { value: "back", label: "← Back to Main Menu" }
+    ]
   });
+
+  if (!p.isCancel(action)) {
+    p.outro(pc.cyan("👋 Returning to menu"));
+  }
 }