@plumpslabs/kuma 2.4.5 → 2.4.7

package/hooks/kuma-agy-hooks.js

@@ -1,37 +1,90 @@
 /**
- * 🐻 Kuma MCP — Antigravity Lifecycle Hook
- * Intercepts file writes to warn about known gotchas and fragile files.
+ * 🐻 Kuma MCP — JIT Gotcha Guard Hook
+ * Intercepts file writes/edits in real time to inject active gotcha warnings.
  */
 import fs from "node:fs";
 import path from "node:path";
 
-function runHook() {
-  try {
-    const input = process.env.AGY_TOOL_INPUT ? JSON.parse(process.env.AGY_TOOL_INPUT) : {};
-    const targetFile = input.TargetFile || input.file || "";
+function findGotchasForFile(targetPath) {
+  if (!targetPath) return [];
+  const results = [];
+  const normalized = targetPath.replace(/\\/g, "/");
+  const baseName = path.basename(normalized);
 
-    if (!targetFile) {
-      process.stdout.write(JSON.stringify({ decision: "allow" }) + "\n");
-      return;
-    }
-
-    const gotchasFile = path.resolve(process.cwd(), ".kuma", "KNOWN_GOTCHAS.md");
-    if (fs.existsSync(gotchasFile)) {
-      const content = fs.readFileSync(gotchasFile, "utf-8");
-      const baseName = path.basename(targetFile);
-      if (content.includes(baseName) || content.includes(targetFile)) {
-        process.stdout.write(JSON.stringify({
-          decision: "allow",
-          systemMessage: `⚠️ Kuma Gotcha Warning: ${baseName} has recorded gotchas in .kuma/KNOWN_GOTCHAS.md. Review before editing!`
-        }) + "\n");
-        return;
+  const gotchasMd = path.resolve(process.cwd(), ".kuma", "KNOWN_GOTCHAS.md");
+  if (fs.existsSync(gotchasMd)) {
+    try {
+      const content = fs.readFileSync(gotchasMd, "utf-8");
+      const sections = content.split(/(?=^###\s+)/m);
+      for (const sec of sections) {
+        if (sec.includes(baseName) || sec.includes(normalized)) {
+          const firstLine = sec.split("\n")[0].replace(/^###\s+/, "").trim();
+          const trapMatch = sec.match(/- \S*\s*\*\*Trap\*\*:\s*([^\n]+)/i) || sec.match(/- \*\*Issue\*\*:\s*([^\n]+)/i);
+          const ruleMatch = sec.match(/- \S*\s*\*\*Rule(?:\/Fix)?\*\*:\s*([^\n]+)/i) || sec.match(/- \*\*Workaround\*\*:\s*([^\n]+)/i);
+          const trap = trapMatch ? trapMatch[1].trim() : firstLine;
+          const rule = ruleMatch ? ruleMatch[1].trim() : "";
+          results.push({ file: baseName, trap, rule });
+        }
       }
+    } catch {}
+  }
+  return results;
+}
+
+function processPayload(rawInput) {
+  let data = {};
+  if (rawInput && typeof rawInput === "string") {
+    try { data = JSON.parse(rawInput); } catch {}
+  } else if (rawInput && typeof rawInput === "object") {
+    data = rawInput;
+  }
+
+  const input = data.input || data;
+  const targetFile = input.TargetFile || input.targetFile || input.file_path || input.path || input.file || "";
+
+  if (!targetFile) {
+    return { decision: "allow" };
+  }
+
+  const gotchas = findGotchasForFile(targetFile);
+  if (gotchas.length > 0) {
+    const baseName = path.basename(targetFile);
+    const lines = [
+      `⚠️ [🐻 Kuma JIT Warning] File "${baseName}" has ${gotchas.length} known gotcha(s):`
+    ];
+    for (const g of gotchas.slice(0, 3)) {
+      lines.push(`  • 🪤 Trap: ${g.trap}`);
+      if (g.rule) lines.push(`    🛡️ Rule: ${g.rule}`);
     }
+    lines.push("💡 Review before modifying to prevent known regressions.");
 
-    process.stdout.write(JSON.stringify({ decision: "allow" }) + "\n");
-  } catch {
-    process.stdout.write(JSON.stringify({ decision: "allow" }) + "\n");
+    const message = lines.join("\n");
+    return {
+      decision: "allow",
+      systemMessage: message,
+      additionalContext: message,
+    };
   }
+
+  return { decision: "allow" };
 }
 
-runHook();
+let inputBuffer = "";
+const timer = setTimeout(() => {
+  const envInput = process.env.AGY_TOOL_INPUT || process.env.TOOL_INPUT || "";
+  const result = processPayload(envInput);
+  process.stdout.write(JSON.stringify(result) + "\n");
+  process.exit(0);
+}, 150);
+
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+  clearTimeout(timer);
+  inputBuffer += chunk;
+});
+process.stdin.on("end", () => {
+  clearTimeout(timer);
+  const result = processPayload(inputBuffer || process.env.AGY_TOOL_INPUT || "");
+  process.stdout.write(JSON.stringify(result) + "\n");
+  process.exit(0);
+});

package/hooks.json

@@ -3,11 +3,11 @@
     "enabled": true,
     "PreToolUse": [
       {
-        "matcher": "replace_file_content|write_to_file",
+        "matcher": "replace_file_content|write_to_file|Edit|Write|MultiEdit|edit_file",
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"import('fs').then(fs=>{const p=['hooks/kuma-agy-hooks.js','.agents/hooks/kuma-agy-hooks.js','../hooks/kuma-agy-hooks.js'].find(x=>fs.existsSync(x));if(p)import('./'+p);else process.stdout.write(JSON.stringify({decision:'allow'})+'\\n');}).catch(()=>process.stdout.write(JSON.stringify({decision:'allow'})+'\\n'))\"",
+            "command": "node -e \"import('fs').then(fs=>{const p=['hooks/kuma-agy-hooks.js','.agents/hooks/kuma-agy-hooks.js',process.env.HOME+'/.gemini/config/plugins/kuma/hooks/kuma-agy-hooks.js'].find(x=>fs.existsSync(x));if(p)import(p.startsWith('/')?p:'./'+p);else process.stdout.write(JSON.stringify({decision:'allow'})+'\\n');}).catch(()=>process.stdout.write(JSON.stringify({decision:'allow'})+'\\n'))\"",
             "timeout": 15
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "Safety-first context & orchestration engine for AI coding agents. MCP server with mandatory research pipeline, knowledge graph, impact analysis, decision memory, and safety guard — works with any MCP client.",
   "type": "module",
   "main": "dist/index.js",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "kuma",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "Safety-first context & orchestration engine for AI coding agents. Shadow memory, gotcha lifecycle, blast radius impact analysis, and test verification.",
   "author": {
     "name": "plumpslabs",