pikakit 2.0.0 → 3.0.1

package/README.md

@@ -19,8 +19,8 @@ npx pikakit
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| **Skills** | 49 | FAANG-grade coding skills |
-| **Workflows** | 26 | `/think`, `/build`, `/autopilot`, etc. |
+| **Skills** | 50 | FAANG-grade coding skills |
+| **Workflows** | 25 | `/think`, `/build`, `/autopilot`, etc. |
 | **Agents** | 25 | Specialist AI agents |
 | **Rules** | GEMINI.md | AI behavior configuration |
 | **Scripts** | 25 | JavaScript automation scripts |
@@ -63,8 +63,8 @@ npx pikakit add myteam/company-skills   # Custom skills
 your-project/
 ├── .agent/
 │   ├── GEMINI.md              # AI Rules
-│   ├── skills/                # 49 Skills
-│   ├── workflows/             # 26 Workflows
+│   ├── skills/                # 50 Skills
+│   ├── workflows/             # 25 Workflows
 │   ├── agents/                # 25 Agents
 │   ├── knowledge/             # Learning memory
 │   ├── config/                # Configuration
@@ -158,19 +158,19 @@ npx pikakit add pikakit-agent-skills --force
 ├── CONTINUOUS_EXECUTION_POLICY.md # Autopilot Rules
 ├── WORKFLOW_CHAINS.md             # Workflow Patterns
 │
-├── skills/                        # 49 Skills
+├── skills/                        # 50 Skills
 │   ├── auto-learner/
 │   ├── react-architect/
 │   ├── typescript-expert/
 │   ├── debug-pro/
 │   ├── studio/
-│   └── ... (44 more)
+│   └── ... (45 more)
 │
-├── workflows/                     # 26 Workflows
+├── workflows/                     # 25 Workflows
 │   ├── think.md
 │   ├── build.md
 │   ├── autopilot.md
-│   └── ... (23 more)
+│   └── ... (22 more)
 │
 ├── agents/                        # 25 Agents
 │   ├── frontend-specialist.md

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

@@ -0,0 +1,187 @@
+#!/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";
+
+// Fix UTF-8 output on Windows PowerShell/Console
+if (process.platform === "win32" && process.stdout.isTTY) {
+    process.stdout.setDefaultEncoding("utf8");
+}
+
+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(`
+🤖 PikaKit 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
+
+  index          🆕 Knowledge index management
+                 ag-smart index --rebuild | --status
+
+  metrics        🆕 Knowledge metrics dashboard
+                 ag-smart metrics [--json]
+
+  validate        Schema validation for knowledge files
+                 ag-smart validate [--fix] [--json]
+
+  retention       Retention policy runner
+                 ag-smart retention [--dry-run] [--apply] [--status]
+
+${"─".repeat(50)}
+
+📖 HELP:
+
+  help, --help   Show this help message
+  --version      Show version number
+
+💡 Docs: https://github.com/pikakit/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;
+    case "index":
+        run("knowledge-index.js", ARGS.slice(1));
+        break;
+    case "metrics":
+        run("knowledge-metrics.js", ARGS.slice(1));
+        break;
+    case "validate":
+        run("knowledge-validator.js", ARGS.slice(1));
+        break;
+    case "retention":
+        run("knowledge-retention.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/agent-cli/lib/audit.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+/**
+ * Smart Audit Script (Production-Ready)
+ * 
+ * The "Judge" - Orchestrates all compliance checks:
+ * 1. Memory Recall (Past Mistakes)
+ * 2. Constitution Checks (Governance)
+ * 3. Real-time Analysis
+ * 
+ * Usage: agent audit [directory]
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { scanDirectory, loadKnowledge, saveKnowledge, printResults } from "./recall.js";
+import { AGENT_DIR, VERSION } from "./config.js";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// ============================================================================
+// AUDIT CONFIGURATION
+// ============================================================================
+
+const SCAN_EXTENSIONS = [".js", ".ts", ".tsx", ".jsx", ".mjs"];
+
+// ============================================================================
+// GOVERNANCE CHECKS
+// ============================================================================
+
+/**
+ * Check if governance files exist
+ * @param {string} projectRoot 
+ * @returns {{ passed: boolean, details: string[] }}
+ */
+function checkGovernance(projectRoot) {
+    const details = [];
+    let passed = true;
+
+    const governanceFiles = [
+        { path: path.join(projectRoot, ".agent", "GEMINI.md"), name: "GEMINI.md" },
+        { path: path.join(projectRoot, ".agent", "ARCHITECTURE.md"), name: "ARCHITECTURE.md" }
+    ];
+
+    governanceFiles.forEach(file => {
+        if (fs.existsSync(file.path)) {
+            details.push(`${pc.green("✓")} ${file.name} found`);
+        } else {
+            details.push(`${pc.yellow("⚠")} ${file.name} not found (optional)`);
+        }
+    });
+
+    // Check for skills
+    const skillsDir = path.join(projectRoot, ".agent", "skills");
+    if (fs.existsSync(skillsDir)) {
+        const skills = fs.readdirSync(skillsDir).filter(f =>
+            fs.statSync(path.join(skillsDir, f)).isDirectory()
+        );
+        details.push(`${pc.green("✓")} ${skills.length} skill(s) loaded`);
+    }
+
+    return { passed, details };
+}
+
+// ============================================================================
+// MAIN AUDIT
+// ============================================================================
+
+/**
+ * Run full audit on a project
+ * @param {string} projectRoot 
+ */
+async function runAudit(projectRoot) {
+    p.intro(pc.cyan(`⚖️  SMART AUDIT v${VERSION}`));
+
+    let exitCode = 0;
+    const startTime = Date.now();
+
+    // Phase 1: Memory Recall
+    const s1 = p.spinner();
+    s1.start("Phase 1: Memory Recall");
+
+    const db = loadKnowledge();
+
+    if (db.lessons.length === 0) {
+        s1.stop("Phase 1: No lessons learned yet");
+    } else {
+        const { results } = scanDirectory(projectRoot, db, SCAN_EXTENSIONS);
+
+        if (results.length > 0) {
+            const stats = printResults(results);
+            saveKnowledge(db);
+
+            if (stats.errors > 0) {
+                exitCode = 1;
+            }
+            s1.stop(`Phase 1: Found ${stats.total} violation(s)`);
+        } else {
+            s1.stop("Phase 1: No violations found");
+        }
+    }
+
+    // Phase 2: Governance
+    const s2 = p.spinner();
+    s2.start("Phase 2: Governance Check");
+
+    const govResult = checkGovernance(projectRoot);
+    s2.stop("Phase 2: Governance checked");
+
+    p.note(govResult.details.join("\n"), pc.dim("Governance"));
+
+    // Phase 3: Summary
+    const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+    const totalHits = db.lessons.reduce((sum, l) => sum + (l.hitCount || 0), 0);
+
+    const summaryLines = [
+        `⏱️  Completed in ${duration}s`,
+        `📊 Lessons in memory: ${db.lessons.length}`,
+        `🎯 Total pattern hits: ${totalHits}`
+    ];
+    p.note(summaryLines.join("\n"), pc.dim("Summary"));
+
+    if (exitCode === 0) {
+        p.outro(pc.green("✅ AUDIT PASSED: Code is smart and compliant"));
+    } else {
+        p.outro(pc.red("❌ AUDIT FAILED: Please fix ERROR violations"));
+    }
+
+    process.exit(exitCode);
+}
+
+// ============================================================================
+// CLI
+// ============================================================================
+
+const args = process.argv.slice(2);
+const projectRoot = args[0] || process.cwd();
+
+if (args.includes("--help")) {
+    console.log(`
+⚖️  Smart Audit - Compliance Checker
+
+Usage:
+  agent audit [directory]
+
+Options:
+  --help    Show this help
+`);
+    process.exit(0);
+}
+
+runAudit(projectRoot);

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

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Tests for audit.js functionality
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import os from "os";
+
+const TEST_DIR = path.join(os.tmpdir(), "agent-skill-kit-audit-test");
+const AGENT_DIR = path.join(TEST_DIR, ".agent");
+
+describe("Audit - Governance Check", () => {
+    beforeEach(() => {
+        fs.mkdirSync(AGENT_DIR, { recursive: true });
+    });
+
+    afterEach(() => {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+    });
+
+    it("detects GEMINI.md presence", () => {
+        const geminiPath = path.join(AGENT_DIR, "GEMINI.md");
+
+        // Before creation
+        expect(fs.existsSync(geminiPath)).toBe(false);
+
+        // After creation
+        fs.writeFileSync(geminiPath, "# Test", "utf8");
+        expect(fs.existsSync(geminiPath)).toBe(true);
+    });
+
+    it("detects ARCHITECTURE.md presence", () => {
+        const archPath = path.join(AGENT_DIR, "ARCHITECTURE.md");
+        fs.writeFileSync(archPath, "# Architecture", "utf8");
+
+        expect(fs.existsSync(archPath)).toBe(true);
+    });
+
+    it("counts skills in skills directory", () => {
+        const skillsDir = path.join(AGENT_DIR, "skills");
+        fs.mkdirSync(skillsDir, { recursive: true });
+
+        // Create mock skills
+        fs.mkdirSync(path.join(skillsDir, "skill-1"));
+        fs.mkdirSync(path.join(skillsDir, "skill-2"));
+
+        const skills = fs.readdirSync(skillsDir).filter(f =>
+            fs.statSync(path.join(skillsDir, f)).isDirectory()
+        );
+
+        expect(skills.length).toBe(2);
+    });
+});
+
+describe("Audit - Compliance Results", () => {
+    it("calculates pass/fail status correctly", () => {
+        const results = {
+            errors: 0,
+            warnings: 2,
+            total: 2
+        };
+
+        // Errors = 0 means pass
+        expect(results.errors === 0).toBe(true);
+    });
+
+    it("fails when errors exist", () => {
+        const results = {
+            errors: 1,
+            warnings: 0,
+            total: 1
+        };
+
+        expect(results.errors > 0).toBe(true);
+    });
+
+    it("calculates total correctly", () => {
+        const violations = [
+            { lesson: { severity: "ERROR" }, matches: [1, 2] },
+            { lesson: { severity: "WARNING" }, matches: [1] }
+        ];
+
+        let total = 0;
+        let errors = 0;
+        let warnings = 0;
+
+        violations.forEach(v => {
+            total += v.matches.length;
+            if (v.lesson.severity === "ERROR") {
+                errors += v.matches.length;
+            } else {
+                warnings += v.matches.length;
+            }
+        });
+
+        expect(total).toBe(3);
+        expect(errors).toBe(2);
+        expect(warnings).toBe(1);
+    });
+});