@plumpslabs/kuma 2.4.6 → 2.4.8

package/hooks/kuma-agy-hooks.js

@@ -5,11 +5,18 @@
 import fs from "node:fs";
 import path from "node:path";
 
+const GENERIC_FILENAMES = new Set([
+  "index.ts", "index.js", "index.tsx", "index.jsx",
+  "types.ts", "types.d.ts", "constants.ts", "utils.ts",
+  "config.ts", "schema.ts", "styles.css", "main.ts", "main.js"
+]);
+
 function findGotchasForFile(targetPath) {
   if (!targetPath) return [];
   const results = [];
   const normalized = targetPath.replace(/\\/g, "/");
   const baseName = path.basename(normalized);
+  const isGeneric = GENERIC_FILENAMES.has(baseName.toLowerCase());
 
   const gotchasMd = path.resolve(process.cwd(), ".kuma", "KNOWN_GOTCHAS.md");
   if (fs.existsSync(gotchasMd)) {
@@ -17,11 +24,29 @@ function findGotchasForFile(targetPath) {
       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();
+        // Skip resolved or deprecated gotchas
+        if (/[-*]\s*(?:🏷️\s*)?\*\*Status\*\*:\s*(?:resolved|deprecated)/i.test(sec)) {
+          continue;
+        }
+
+        const headingLine = sec.split("\n")[0] || "";
+        const headingMatch = headingLine.match(/^###\s+\[?(.+?)\]?\s*(?:[—–-]+\s*(.+))?$/);
+        if (!headingMatch) continue;
+
+        const secFilePath = headingMatch[1].trim().replace(/\\/g, "/");
+        const secBase = path.basename(secFilePath);
+
+        // Path matching: exact match, suffix match, or non-generic basename match
+        const isMatch =
+          normalized.endsWith(secFilePath) ||
+          secFilePath.endsWith(normalized) ||
+          (!isGeneric && secBase.toLowerCase() === baseName.toLowerCase());
+
+        if (isMatch) {
+          const firstLine = headingLine.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 trap = trapMatch ? trapMatch[1].trim() : (headingMatch[2]?.trim() || firstLine);
           const rule = ruleMatch ? ruleMatch[1].trim() : "";
           results.push({ file: baseName, trap, rule });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.6",
+  "version": "2.4.8",
   "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",
@@ -82,6 +82,6 @@
     "studio:dev": "bun run packages/ide/studio/src/index.ts",
     "typecheck": "tsc --noEmit",
     "lint": "echo 'No linting configured'",
-    "test": "NODE_OPTIONS=--experimental-vm-modules pnpm exec jest"
+    "test": "NODE_OPTIONS=--experimental-vm-modules pnpm exec jest --runInBand"
   }
 }

package/plugin.json

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