chore(deps-dev): bump js-yaml from 4.3.0 to 4.3.2 in /ui-v2

.cargo/config.toml

@@ -0,0 +1,19 @@
+# LeanKG Build Configuration
+# Limit local release-build CPU and RAM usage on macOS.
+
+[build]
+jobs = 2
+
+[profile.dev]
+opt-level = 0
+debug = false
+codegen-units = 16
+
+[profile.release]
+opt-level = 3
+# codegen-units=1 avoids a rustc 1.95 linker bug (`core::error::Error::cause`
+# undefined) that appears in the lib-test binary once enough grammars are
+# linked. The release binary also benefits from the smaller single-CGU object.
+lto = "off"
+codegen-units = 1
+incremental = true

.claude-plugin/INSTALL.md

@@ -0,0 +1,68 @@
+# Installing LeanKG for Claude Code
+
+## Prerequisites
+
+- [Claude Code](https://claude.ai/code) installed
+
+## Installation
+
+Superpowers is available via the official Claude plugin marketplace:
+
+```
+/plugin install leankg@claude-plugins-official
+```
+
+Or register the marketplace first:
+
+```
+/plugin marketplace add FreePeak/leankg-marketplace
+/plugin install leankg@leankg-marketplace
+```
+
+## What It Does
+
+The plugin automatically injects LeanKG knowledge graph tools into your agent context:
+
+- **Impact Analysis** - Calculate blast radius before making changes
+- **Code Search** - Find functions, files, dependencies instantly
+- **Test Coverage** - Know what tests cover any code element
+- **Call Graphs** - Understand function call chains
+- **Context Generation** - Get AI-optimized context for any file
+
+## Quick Usage
+
+```
+# Check if LeanKG is ready
+mcp_status leankg
+
+# Initialize for your project
+mcp_init leankg { path: "/path/to/your/project/.leankg" }
+
+# Ask questions like:
+# "What breaks if I change auth.rs?"
+# "Where is the login function?"
+# "What tests cover the payment module?"
+```
+
+## Updating
+
+LeanKG updates automatically when you update the plugin:
+
+```
+/plugin update leankg
+```
+
+## Manual Installation
+
+If marketplace doesn't work, add to `~/.config/claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "leankg": {
+      "command": "leankg",
+      "args": ["mcp-stdio", "--watch"]
+    }
+  }
+}
+```

.claude-plugin/hooks/hooks.json

@@ -0,0 +1,27 @@
+{
+  "description": "LeanKG hooks - enforces LeanKG usage for code search",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/leankg-pretooluse.mjs\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "mcp__leankg__*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/leankg-posttooluse.mjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

.claude-plugin/hooks/leankg-posttooluse.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * LeanKG PostToolUse Hook
+ * Logs tool usage for analytics and can provide follow-up LeanKG suggestions.
+ */
+
+import { readFileSync, appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+
+// ─── Configuration ───
+const LOG_DIR = resolve(homedir(), ".cache", "leankg-hooks");
+const LOG_FILE = resolve(LOG_DIR, "posttooluse.log");
+
+// ─── Read stdin ───
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = "";
+    process.stdin.on("readable", () => {
+      let chunk;
+      while ((chunk = process.stdin.read()) !== null) {
+        data += chunk;
+      }
+    });
+    process.stdin.on("end", () => resolve(data));
+    process.stdin.on("error", reject);
+  });
+}
+
+// ─── Log tool usage ───
+function logToolUsage(toolName, toolInput, toolResult, durationMs) {
+  try {
+    if (!existsSync(LOG_DIR)) {
+      mkdirSync(LOG_DIR, { recursive: true });
+    }
+
+    const entry = {
+      timestamp: new Date().toISOString(),
+      tool: toolName,
+      input: toolInput,
+      durationMs,
+      hadResult: !!toolResult,
+      resultLength: toolResult ? JSON.stringify(toolResult).length : 0,
+    };
+
+    appendFileSync(LOG_FILE, JSON.stringify(entry) + "\n");
+  } catch {
+    // Silently ignore logging errors
+  }
+}
+
+// ─── Main ───
+async function main() {
+  try {
+    const raw = await readStdin();
+    if (!raw.trim()) {
+      process.exit(0);
+    }
+
+    const input = JSON.parse(raw);
+    const toolName = input.tool_name || "";
+    const toolInput = input.tool_input || {};
+    const toolResult = input.result || null;
+    const durationMs = input.duration_ms || 0;
+
+    // Log for analytics
+    logToolUsage(toolName, toolInput, toolResult, durationMs);
+
+    process.exit(0);
+  } catch {
+    // Graceful degradation
+    process.exit(0);
+  }
+}
+
+main();

.claude-plugin/hooks/leankg-pretooluse.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/**
+ * LeanKG PreToolUse Hook
+ * Provides LeanKG context when code search is detected.
+ * Only blocks Bash commands that use raw grep/find.
+ */
+import { spawnSync } from "node:child_process";
+
+// ─── LeanKG Tools Mapping ───
+const LEANKG_TOOLS = {
+  search_code: "Search code by name/type",
+  find_function: "Locate function definitions",
+  query_file: "Find files by name/pattern",
+  get_impact_radius: "Calculate blast radius",
+  get_dependencies: "Get direct imports",
+  get_dependents: "Get files depending on target",
+  get_context: "Get AI-optimized file context",
+  get_tested_by: "Get test coverage",
+  get_call_graph: "Get function call graph",
+  get_callers: "Get who calls a function",
+};
+
+// ─── Read stdin ───
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = "";
+    process.stdin.on("readable", () => {
+      let chunk;
+      while ((chunk = process.stdin.read()) !== null) {
+        data += chunk;
+      }
+    });
+    process.stdin.on("end", () => resolve(data));
+    process.stdin.on("error", reject);
+  });
+}
+
+// ─── Check if LeanKG is available ───
+function isLeanKGMCPReady() {
+  try {
+    const result = spawnSync("cargo", ["run", "--release", "--", "status"], {
+      cwd: process.cwd(),
+      timeout: 5000,
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+// ─── Only block Bash with grep/find - allow other tools ───
+function shouldBlockTool(toolName, toolInput) {
+  if (toolName !== "Bash") return false;
+
+  const cmd = (toolInput.command || "").toLowerCase();
+
+  // Build commands always allowed
+  const isBuildCmd = /^(cargo|npm|pnpm|yarn|go|make|cmake|rustc)/.test(cmd);
+  if (isBuildCmd) return false;
+
+  // Only block if using raw grep/find in bash
+  const hasRawSearch = /\b(grep|rg|ag|ack|find|fd|fzf)\b/.test(cmd);
+  const isLeankgCmd = cmd.includes("leankg");
+
+  return hasRawSearch && !isLeankgCmd;
+}
+
+function buildGuidance(toolInput) {
+  const cmd = toolInput.command || "";
+  const match = cmd.match(/['"]([^'"]+)['"]/);
+  const query = match ? match[1] : "";
+
+  const toolsList = Object.entries(LEANKG_TOOLS)
+    .map(([name, desc]) => `  - mcp__leankg__${name}: ${desc}`)
+    .join("\n");
+
+  return `LEANKG ENFORCEMENT: Raw search via Bash is blocked.
+
+Use LeanKG MCP tools instead:
+${toolsList}
+
+REQUIRED WORKFLOW:
+1. mcp__leankg__mcp_status → confirm LeanKG is ready
+2. For code search: mcp__leankg__search_code("${query}") or mcp__leankg__find_function("${query}")
+
+The original tool call: Bash(${JSON.stringify(toolInput)})`;
+}
+
+async function main() {
+  try {
+    const raw = await readStdin();
+    if (!raw.trim()) process.exit(0);
+
+    const input = JSON.parse(raw);
+    const toolName = input.tool_name || "";
+    const toolInput = input.tool_input || {};
+
+    if (!shouldBlockTool(toolName, toolInput)) {
+      process.exit(0);
+    }
+
+    const leanKGReady = isLeanKGMCPReady();
+    if (!leanKGReady) process.exit(0);
+
+    // LeanKG ready - block Bash search commands
+    console.log(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        permissionDecision: "deny",
+        permissionDecisionReason: buildGuidance(toolInput),
+      },
+    }) + "\n");
+    process.exit(0);
+  } catch {
+    process.exit(0);
+  }
+}
+
+main();

.claude-plugin/hooks/run-hook.cmd

@@ -0,0 +1,44 @@
+@echo off
+REM Cross-platform polyglot wrapper for hook scripts.
+REM On Windows: cmd.exe runs the batch portion, which finds and calls bash.
+REM On Unix: the shell interprets this as a script (: is a no-op in bash).
+REM
+REM Hook scripts use extensionless filenames (e.g. "session-start" not
+REM "session-start.sh") so Claude Code's Windows auto-detection -- which
+REM prepends "bash" to any command containing .sh -- doesn't interfere.
+REM
+REM Usage: run-hook.cmd <script-name> [args...]
+
+if "%~1"=="" (
+    echo run-hook.cmd: missing script name >&2
+    exit /b 1
+)
+
+set "HOOK_DIR=%~dp0"
+
+REM Try Git for Windows bash in standard locations
+if exist "C:\Program Files\Git\bin\bash.exe" (
+    "C:\Program Files\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+if exist "C:\Program Files (x86)\Git\bin\bash.exe" (
+    "C:\Program Files (x86)\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+
+REM Try bash on PATH (e.g. user-installed Git Bash, MSYS2, Cygwin)
+where bash >nul 2>nul
+if %ERRORLEVEL% equ 0 (
+    bash "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+
+REM No bash found - exit silently rather than error
+REM (plugin still works, just without SessionStart context injection)
+exit /b 0
+
+# Unix: run the named script directly
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SCRIPT_NAME="$1"
+shift
+exec bash "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"

.claude-plugin/hooks/session-start

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+bootstrap_content=$(cat "${PLUGIN_ROOT}/leankg-bootstrap.md" 2>&1 || echo "Error reading leankg-bootstrap.md")
+bootstrap_escaped=$(escape_for_json "$bootstrap_content")
+
+session_context="<EXTREMELY_IMPORTANT>\n\n**LeanKG is a lightweight knowledge graph for codebase understanding.**\n\n${bootstrap_escaped}\n</EXTREMELY_IMPORTANT>"
+
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+else
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+fi
+
+exit 0