add-skill-kit 3.2.3 → 3.2.4

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

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * Smart Watcher - Real-Time File Monitoring
+ * 
+ * Watches for file changes and runs recall automatically.
+ * Features:
+ * - Debounced file change detection
+ * - Pattern frequency tracking
+ * - Live feedback on violations
+ * 
+ * Usage: ag-smart watch [directory]
+ */
+
+import fs from "fs";
+import path from "path";
+import { scanFile, loadKnowledge, saveKnowledge } from "./recall.js";
+import { VERSION } from "./config.js";
+
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+const WATCH_EXTENSIONS = [".js", ".ts", ".tsx", ".jsx", ".mjs"];
+const DEBOUNCE_MS = 300;
+const SKIP_DIRS = ["node_modules", ".git", "dist", "build", ".next", "coverage"];
+
+// ============================================================================
+// WATCHER
+// ============================================================================
+
+class SmartWatcher {
+    constructor(rootDir) {
+        this.rootDir = path.resolve(rootDir);
+        this.db = loadKnowledge();
+        this.debounceTimers = new Map();
+        this.sessionStats = {
+            filesChecked: 0,
+            violationsFound: 0,
+            startTime: Date.now()
+        };
+    }
+
+    /**
+     * Start watching
+     */
+    start() {
+        console.log(`\n👁️  Smart Watcher v${VERSION}`);
+        console.log(`📂 Watching: ${this.rootDir}`);
+        console.log(`📚 Loaded ${this.db.lessons.length} pattern(s) from memory`);
+        console.log("─".repeat(50));
+        console.log("Watching for changes... (Ctrl+C to stop)\n");
+
+        this.watch(this.rootDir);
+    }
+
+    /**
+     * Recursively watch directories
+     */
+    watch(dir) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+            // Watch current directory
+            fs.watch(dir, { persistent: true }, (eventType, filename) => {
+                if (filename && eventType === "change") {
+                    this.handleChange(path.join(dir, filename));
+                }
+            });
+
+            // Recurse into subdirs
+            for (const entry of entries) {
+                if (entry.isDirectory() && !SKIP_DIRS.includes(entry.name)) {
+                    this.watch(path.join(dir, entry.name));
+                }
+            }
+        } catch (error) {
+            // Ignore permission errors
+        }
+    }
+
+    /**
+     * Handle file change with debouncing
+     */
+    handleChange(filePath) {
+        const ext = path.extname(filePath);
+        if (!WATCH_EXTENSIONS.includes(ext)) return;
+        if (!fs.existsSync(filePath)) return;
+
+        // Debounce
+        if (this.debounceTimers.has(filePath)) {
+            clearTimeout(this.debounceTimers.get(filePath));
+        }
+
+        this.debounceTimers.set(filePath, setTimeout(() => {
+            this.checkFile(filePath);
+            this.debounceTimers.delete(filePath);
+        }, DEBOUNCE_MS));
+    }
+
+    /**
+     * Check a file against memory
+     */
+    checkFile(filePath) {
+        const relativePath = path.relative(this.rootDir, filePath);
+        const result = scanFile(filePath, this.db, true);
+
+        this.sessionStats.filesChecked++;
+
+        if (result.violations.length === 0) {
+            console.log(`✅ ${relativePath}`);
+            return;
+        }
+
+        console.log(`\n⚠️  ${relativePath}`);
+
+        result.violations.forEach(({ lesson, matches }) => {
+            this.sessionStats.violationsFound += matches.length;
+
+            const icon = lesson.severity === "ERROR" ? "❌" : "⚠️";
+            console.log(`   ${icon} [${lesson.id}] ${lesson.message}`);
+
+            matches.slice(0, 3).forEach(m => {
+                console.log(`      L${m.line}: ${m.content}`);
+            });
+
+            if (matches.length > 3) {
+                console.log(`      ... and ${matches.length - 3} more`);
+            }
+        });
+
+        console.log("");
+
+        // Save updated stats
+        saveKnowledge(this.db);
+    }
+
+    /**
+     * Print session summary
+     */
+    printSummary() {
+        const duration = Math.round((Date.now() - this.sessionStats.startTime) / 1000);
+        console.log("\n" + "─".repeat(50));
+        console.log("📊 Session Summary:");
+        console.log(`   ⏱️  Duration: ${duration}s`);
+        console.log(`   📄 Files checked: ${this.sessionStats.filesChecked}`);
+        console.log(`   ⚠️  Violations found: ${this.sessionStats.violationsFound}`);
+    }
+}
+
+// ============================================================================
+// CLI
+// ============================================================================
+
+const args = process.argv.slice(2);
+const targetDir = args[0] || process.cwd();
+
+if (args.includes("--help")) {
+    console.log(`
+👁️  Smart Watcher - Real-Time Monitor
+
+Usage:
+  ag-smart watch [directory]
+
+Options:
+  --help    Show this help
+
+The watcher monitors file changes and checks them against
+learned patterns in real-time.
+`);
+    process.exit(0);
+}
+
+const watcher = new SmartWatcher(targetDir);
+
+// Handle graceful shutdown
+process.on("SIGINT", () => {
+    watcher.printSummary();
+    process.exit(0);
+});
+
+watcher.start();

package/lib/agent-cli/lib/watcher.test.js

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Tests for watcher.js functionality
+ */
+import { describe, it, expect } from "vitest";
+import path from "path";
+
+describe("Watcher - Extension Filtering", () => {
+    const WATCH_EXTENSIONS = [".js", ".ts", ".tsx", ".jsx", ".mjs"];
+
+    it("includes JavaScript files", () => {
+        const file = "app.js";
+        const ext = path.extname(file);
+        expect(WATCH_EXTENSIONS.includes(ext)).toBe(true);
+    });
+
+    it("includes TypeScript files", () => {
+        const file = "app.tsx";
+        const ext = path.extname(file);
+        expect(WATCH_EXTENSIONS.includes(ext)).toBe(true);
+    });
+
+    it("excludes CSS files", () => {
+        const file = "styles.css";
+        const ext = path.extname(file);
+        expect(WATCH_EXTENSIONS.includes(ext)).toBe(false);
+    });
+
+    it("excludes markdown files", () => {
+        const file = "README.md";
+        const ext = path.extname(file);
+        expect(WATCH_EXTENSIONS.includes(ext)).toBe(false);
+    });
+});
+
+describe("Watcher - Directory Filtering", () => {
+    const SKIP_DIRS = ["node_modules", ".git", "dist", "build", ".next", "coverage"];
+
+    it("skips node_modules", () => {
+        expect(SKIP_DIRS.includes("node_modules")).toBe(true);
+    });
+
+    it("skips .git directory", () => {
+        expect(SKIP_DIRS.includes(".git")).toBe(true);
+    });
+
+    it("skips dist directory", () => {
+        expect(SKIP_DIRS.includes("dist")).toBe(true);
+    });
+
+    it("allows src directory", () => {
+        expect(SKIP_DIRS.includes("src")).toBe(false);
+    });
+
+    it("allows lib directory", () => {
+        expect(SKIP_DIRS.includes("lib")).toBe(false);
+    });
+});
+
+describe("Watcher - Session Stats", () => {
+    it("initializes session stats correctly", () => {
+        const sessionStats = {
+            filesChecked: 0,
+            violationsFound: 0,
+            startTime: Date.now()
+        };
+
+        expect(sessionStats.filesChecked).toBe(0);
+        expect(sessionStats.violationsFound).toBe(0);
+        expect(typeof sessionStats.startTime).toBe("number");
+    });
+
+    it("increments file count correctly", () => {
+        const sessionStats = { filesChecked: 0 };
+        sessionStats.filesChecked++;
+        sessionStats.filesChecked++;
+        expect(sessionStats.filesChecked).toBe(2);
+    });
+
+    it("calculates duration correctly", () => {
+        const startTime = Date.now() - 5000; // 5 seconds ago
+        const duration = Math.round((Date.now() - startTime) / 1000);
+        expect(duration).toBeGreaterThanOrEqual(4);
+        expect(duration).toBeLessThanOrEqual(6);
+    });
+});

package/lib/agent-cli/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "agentskillskit-cli",
+    "version": "3.2.1",
+    "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"
+    },
+    "scripts": {
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@clack/core": "^0.5.0",
+        "@clack/prompts": "^0.11.0",
+        "boxen": "^8.0.1",
+        "clipboardy": "^5.1.0",
+        "js-yaml": "^4.1.0",
+        "ora": "^9.1.0",
+        "picocolors": "^1.1.1"
+    },
+    "devDependencies": {
+        "vitest": "^1.6.0"
+    },
+    "author": "Agent Skill Kit Authors",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/agentskillkit/agent-skills.git",
+        "directory": "packages/cli"
+    },
+    "keywords": [
+        "agent",
+        "ai",
+        "skills",
+        "cli",
+        "tooling",
+        "antigravity"
+    ],
+    "files": [
+        "bin",
+        "lib",
+        "README.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/lib/agentskillskit-cli/README.md

@@ -0,0 +1,21 @@
+# Agent Skill Kit CLI
+
+The intelligent CLI engine for Agent Skill Kit, featuring:
+- **Routing Engine**: Semantic routing validation
+- **Audit System**: Skill usage auditing and metrics
+- **Interactive Mode**: Smart interactive agent interface
+
+## Installation
+
+This package is typically managed by the `add-skill-kit` installer.
+
+```bash
+# Global install (managed by installer)
+npm install -g @agentskillskit/cli
+
+# Usage
+agent
+```
+
+## Documentation
+See the main [Agent Skill Kit](https://github.com/agentskillskit/agent-skills) repository.

package/lib/agentskillskit-cli/ag-smart.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * Smart Agent CLI - ESM Version (Production-Ready)
+ * 
+ * The main interface for humans to interact with the Smart Agent Skills system.
+ * 
+ * Commands:
+ *   learn          Add new lessons to memory
+ *   recall         Check files against memory
+ *   audit          Full compliance audit
+ *   watch          Real-time file monitoring
+ *   stats          Knowledge base statistics
+ *   install-hooks  Install git pre-commit hook
+ *   lint-learn     Auto-learn from ESLint output
+ */
+
+import { spawn } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+import { VERSION } from "../lib/config.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ARGS = process.argv.slice(2);
+const COMMAND = ARGS[0];
+const SCRIPTS_DIR = path.join(__dirname, "..", "lib");
+const HOOKS_DIR = path.join(SCRIPTS_DIR, "hooks");
+
+/**
+ * Run a script with given arguments
+ * @param {string} script - Script filename (relative to lib/)
+ * @param {string[]} args - Arguments to pass
+ * @param {string} baseDir - Base directory for script
+ */
+function run(script, args = [], baseDir = SCRIPTS_DIR) {
+    const scriptPath = path.join(baseDir, script);
+    const child = spawn("node", [scriptPath, ...args], {
+        stdio: "inherit",
+        shell: true
+    });
+
+    child.on("close", (code) => {
+        process.exit(code || 0);
+    });
+
+    child.on("error", (err) => {
+        console.error(`❌ Failed to run ${script}:`, err.message);
+        process.exit(1);
+    });
+}
+
+function printHelp() {
+    console.log(`
+🤖 Agent Skill Kit CLI v${VERSION}
+
+Usage: ag-smart <command> [options]
+
+${"─".repeat(50)}
+
+📚 CORE COMMANDS:
+
+  learn          Teach a new lesson to the memory
+                 ag-smart learn --add --pattern "var " --message "Use let/const"
+                 ag-smart learn --list
+                 ag-smart learn --remove LEARN-001
+
+  recall         Check file(s) against learned patterns
+                 ag-smart recall src/app.js
+                 ag-smart recall ./src
+
+  audit          Run full compliance audit
+                 ag-smart audit [directory]
+
+${"─".repeat(50)}
+
+🚀 PRODUCTION FEATURES:
+
+  watch          Real-time file monitoring
+                 ag-smart watch [directory]
+
+  stats          Knowledge base statistics
+                 ag-smart stats
+
+  install-hooks  Install git pre-commit hook
+                 ag-smart install-hooks
+                 ag-smart install-hooks --remove
+
+  lint-learn     Auto-learn from ESLint JSON output
+                 npx eslint . --format json | ag-smart lint-learn
+
+  fix            🆕 Auto-fix violations
+                 ag-smart fix <file|dir> [--mode safe|aggressive]
+
+  sync-skills    🆕 Sync hot patterns to SKILL.md
+                 ag-smart sync-skills
+
+${"─".repeat(50)}
+
+📖 HELP:
+
+  help, --help   Show this help message
+  --version      Show version number
+
+💡 Docs: https://github.com/agentskillkit/agent-skills
+`);
+}
+
+// Command routing
+switch (COMMAND) {
+    // Core commands (v2 versions)
+    case "learn":
+        run("learn.js", ARGS.slice(1));
+        break;
+    case "recall":
+        run("recall.js", ARGS.slice(1));
+        break;
+    case "audit":
+        run("audit.js", ARGS.slice(1));
+        break;
+
+    // Production features
+    case "watch":
+        run("watcher.js", ARGS.slice(1));
+        break;
+    case "stats":
+        run("stats.js", ARGS.slice(1));
+        break;
+    case "install-hooks":
+        run("install-hooks.js", ARGS.slice(1), HOOKS_DIR);
+        break;
+    case "lint-learn":
+        run("lint-learn.js", ARGS.slice(1), HOOKS_DIR);
+        break;
+    case "fix":
+        run("fix.js", ARGS.slice(1));
+        break;
+    case "sync-skills":
+        run("skill-learn.js", ARGS.slice(1));
+        break;
+
+    // Meta
+    case "--version":
+    case "-v":
+        console.log(VERSION);
+        break;
+    case "help":
+    case "--help":
+    case "-h":
+        printHelp();
+        break;
+    case undefined:
+        // No command = show interactive Clack menu
+        import("../lib/ui/index.js").then(m => m.showMainMenu()).catch(console.error);
+        break;
+    default:
+        console.log(`❌ Unknown command: ${COMMAND}`);
+        console.log("   Run 'ag-smart help' for available commands.\n");
+        process.exit(1);
+}

package/lib/agentskillskit-cli/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "agentskillskit-cli",
+    "version": "3.2.0",
+    "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"
+    },
+    "scripts": {
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@clack/core": "^0.5.0",
+        "@clack/prompts": "^0.11.0",
+        "boxen": "^8.0.1",
+        "clipboardy": "^5.1.0",
+        "js-yaml": "^4.1.0",
+        "ora": "^9.1.0",
+        "picocolors": "^1.1.1"
+    },
+    "devDependencies": {
+        "vitest": "^1.6.0"
+    },
+    "author": "Agent Skill Kit Authors",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/agentskillkit/agent-skills.git",
+        "directory": "packages/cli"
+    },
+    "keywords": [
+        "agent",
+        "ai",
+        "skills",
+        "cli",
+        "tooling",
+        "antigravity"
+    ],
+    "files": [
+        "bin",
+        "lib",
+        "README.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-skill-kit",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Enterprise-grade Agent Skill Manager with Antigravity Skills support, Progressive Disclosure detection, and semantic routing validation",
   "license": "MIT",
   "author": "agentskillkit <agentskillkit@gmail.com>",
@@ -15,10 +15,11 @@
   "type": "module",
   "bin": {
     "kit": "./bin/cli.js",
-    "agent": "./node_modules/agentskillskit-cli/bin/ag-smart.js"
+    "agent": "./lib/agent-cli/bin/ag-smart.js"
   },
   "files": [
     "bin/",
+    "lib/",
     "specs/",
     "README.md",
     "LICENSE"
@@ -51,13 +52,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^0.9.1",
-    "agentskillskit-cli": "^3.2.0",
+    "@clack/core": "^0.5.0",
+    "@clack/prompts": "^0.11.0",
     "boxen": "^8.0.1",
     "chalk": "^5.4.1",
+    "clipboardy": "^5.1.0",
     "gradient-string": "^2.0.2",
+    "js-yaml": "^4.1.0",
     "kleur": "^4.1.5",
-    "ora": "^8.1.0",
+    "ora": "^9.1.0",
+    "picocolors": "^1.1.1",
     "prompts": "^2.4.2"
   },
   "devDependencies": {
@@ -65,4 +69,4 @@
     "prettier": "^3.2.5",
     "vitest": "^1.6.0"
   }
-}
+}