pikakit 1.0.0

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

@@ -0,0 +1,123 @@
+/**
+ * Stats UI - Knowledge base statistics display
+ */
+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";
+
+// ============================================================================
+// STATS DISPLAY
+// ============================================================================
+
+/**
+ * Stats UI - Show knowledge base statistics with cognitive insights
+ */
+export async function runStatsUI() {
+    // Clear terminal và reset cursor về top-left
+    process.stdout.write('\x1Bc'); // Full terminal reset
+
+    showIntro("📊 Knowledge Base Stats");
+
+    const spinner = createSpinner("Loading statistics...");
+
+    try {
+        const db = getKnowledge();
+        const lessons = db.lessons || [];
+
+        // 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');
+
+        // 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;
+        }, {});
+
+        // Cognitive grouping - Maturity
+        const byMaturity = lessons.reduce((acc, l) => {
+            const maturity = l.cognitive?.maturity || 'learning';
+            acc[maturity] = (acc[maturity] || 0) + 1;
+            return acc;
+        }, {});
+
+        // Top 5 by hit count
+        const topHits = lessons
+            .filter(p => p.hitCount && p.hitCount > 0)
+            .sort((a, b) => b.hitCount - a.hitCount)
+            .slice(0, 5);
+
+        spinner.stopSuccess("Stats loaded");
+
+        // Compact single-line display
+        console.log(`\n${pc.bold('📊 Knowledge Stats')} ${pc.dim(`(${totalLessons} lessons)`)}\n`);
+
+        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`
+        );
+
+        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) {
+            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('');
+        }
+
+        // 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 to load stats");
+        console.error(error);
+    }
+}

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

@@ -0,0 +1,236 @@
+/**
+ * Watch UI - Real-Time File Monitoring with Clack UI
+ * 
+ * Watches for file changes and runs recall automatically.
+ * Uses @clack/prompts for consistent terminal UI.
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { dirname } 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
+// ============================================================================
+
+class SmartWatcher {
+    constructor(rootDir) {
+        this.rootDir = path.resolve(rootDir);
+        this.db = loadKnowledge();
+        this.debounceTimers = new Map();
+        this.watchers = [];
+        this.isRunning = false;
+        this.sessionStats = {
+            filesChecked: 0,
+            violationsFound: 0,
+            startTime: Date.now()
+        };
+    }
+
+    /**
+     * Start watching
+     */
+    start() {
+        this.isRunning = true;
+        this.watch(this.rootDir);
+    }
+
+    /**
+     * Stop watching
+     */
+    stop() {
+        this.isRunning = false;
+        // Close all watchers
+        this.watchers.forEach(w => {
+            try { w.close(); } catch (e) { }
+        });
+        this.watchers = [];
+        // Clear debounce timers
+        this.debounceTimers.forEach(timer => clearTimeout(timer));
+        this.debounceTimers.clear();
+    }
+
+    /**
+     * Recursively watch directories
+     */
+    watch(dir) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+            // Watch current directory
+            const watcher = fs.watch(dir, { persistent: true }, (eventType, filename) => {
+                if (filename && eventType === "change" && this.isRunning) {
+                    this.handleChange(path.join(dir, filename));
+                }
+            });
+            this.watchers.push(watcher);
+
+            // 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(() => {
+            const result = this.checkFile(filePath);
+            this.debounceTimers.delete(filePath);
+
+            // Emit event for UI
+            if (this.onFileChange) {
+                this.onFileChange(result);
+            }
+        }, 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) {
+            this.sessionStats.violationsFound += result.violations.reduce((sum, v) => sum + v.matches.length, 0);
+            saveKnowledge(this.db);
+        }
+
+        return {
+            path: relativePath,
+            violations: result.violations,
+            hasViolations: result.violations.length > 0
+        };
+    }
+
+    /**
+     * Get session summary
+     */
+    getSummary() {
+        const duration = Math.round((Date.now() - this.sessionStats.startTime) / 1000);
+        return {
+            duration,
+            filesChecked: this.sessionStats.filesChecked,
+            violationsFound: this.sessionStats.violationsFound
+        };
+    }
+}
+
+// ============================================================================
+// WATCH UI
+// ============================================================================
+
+/**
+ * Run Watch UI with Clack
+ * @param {string} targetDir - Directory to watch
+ */
+export async function runWatchUI(targetDir = process.cwd()) {
+    const watcher = new SmartWatcher(targetDir);
+
+    // Show intro
+    p.intro(pc.cyan(`Smart Watcher v${VERSION}`));
+
+    // Show info
+    p.note(
+        `${pc.dim("Directory:")} ${watcher.rootDir}\n` +
+        `${pc.dim("Patterns:")}  ${watcher.db.lessons.length} loaded\n` +
+        `${pc.dim("Extensions:")} ${WATCH_EXTENSIONS.join(", ")}`,
+        "Watch Configuration"
+    );
+
+    // Spinner for starting
+    const s = p.spinner();
+    s.start("Starting file watcher...");
+
+    // Start watcher
+    watcher.start();
+
+    s.stop(pc.green("✓") + " Watching for changes");
+
+    // Setup file change handler
+    watcher.onFileChange = (result) => {
+        if (result.hasViolations) {
+            console.log("");
+            p.log.warn(pc.yellow(result.path));
+            result.violations.forEach(({ lesson, matches }) => {
+                const icon = lesson.severity === "ERROR" ? pc.red("✖") : pc.yellow("⚠");
+                console.log(`  ${icon} ${pc.dim(`[${lesson.id}]`)} ${lesson.message}`);
+                matches.slice(0, 2).forEach(m => {
+                    console.log(`    ${pc.dim(`L${m.line}:`)} ${pc.dim(m.content.substring(0, 60))}`);
+                });
+                if (matches.length > 2) {
+                    console.log(`    ${pc.dim(`... +${matches.length - 2} more`)}`);
+                }
+            });
+        } else {
+            p.log.success(pc.green("✓ ") + pc.dim(result.path));
+        }
+    };
+
+    // Wait for user to press Enter or Ctrl+C
+    console.log("");
+    console.log(pc.dim("  Watching for file changes..."));
+    console.log(pc.dim("  Press Enter to stop\n"));
+
+    // Wait for Enter key
+    await new Promise((resolve) => {
+        const handler = (data) => {
+            if (data.toString().includes("\n") || data.toString().includes("\r")) {
+                process.stdin.removeListener("data", handler);
+                process.stdin.setRawMode?.(false);
+                resolve();
+            }
+        };
+
+        process.stdin.setRawMode?.(true);
+        process.stdin.resume();
+        process.stdin.on("data", handler);
+    });
+
+    // Stop watcher
+    watcher.stop();
+
+    // Show summary
+    const summary = watcher.getSummary();
+
+    p.note(
+        `${pc.dim("Duration:")}   ${summary.duration}s\n` +
+        `${pc.dim("Files:")}      ${summary.filesChecked} checked\n` +
+        `${pc.dim("Violations:")} ${summary.violationsFound} found`,
+        "Session Summary"
+    );
+
+    p.outro(pc.green("Watch session ended"));
+}
+
+export default runWatchUI;

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: agent 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:
+  agent 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.4",
+    "description": "CLI for Agent Skill Kit",
+    "type": "module",
+    "main": "lib/config.js",
+    "bin": {
+        "agent": "bin/agent.js",
+        "agent": "bin/agent.js",
+        "agent-skills-kit": "bin/agent.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"
+    }
+}