@plumpslabs/kuma 2.4.21 → 2.4.22

package/dist/index.js

@@ -11438,25 +11438,30 @@ function opencodePluginTemplate() {
     "  }",
     "}",
     "",
-    "export const KumaPlugin = async ({ project, client, $, directory, worktree }) => {",
+    "function enforceGotchas(tool, args) {",
+    '  const name = String(tool || "").toLowerCase();',
+    "  const argv = args || {};",
+    '  const targetPath = argv.filePath || argv.targetFile || argv.path || argv.file || "";',
+    "  if (!targetPath) return;",
+    '  if (!(name.includes("edit") || name.includes("write") || name.includes("patch"))) return;',
+    "  const blocking = getBlockingGotchasForFile(String(targetPath));",
+    "  if (blocking.length > 0) {",
+    "    throw new Error(",
+    "      `\u{1F43B} [Kuma] ${blocking.length} critical/high gotcha(s) for ${targetPath}:\\n` +",
+    '      blocking.map((g) => `  \u{1F534} ${g}`).join("\\n") +',
+    '      `\\nRead .kuma/KNOWN_GOTCHAS.md for workarounds, or run kuma_memory({ action: "gotcha" }) to list.`',
+    "    );",
+    "  }",
+    "}",
+    "",
+    "// \u2500\u2500\u2500 v1 host: factory (named export, legacy mode requires functions) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "export const KumaPlugin = async () => {",
     "  return {",
     '    "tool.execute.before": async (input, output) => {',
-    '      const tool = String(input.tool || "").toLowerCase();',
-    "      const args = output.args || {};",
-    '      const targetPath = args.filePath || args.targetFile || args.path || args.file || "";',
-    "      if (!targetPath) return;",
-    '      if (!(tool.includes("edit") || tool.includes("write") || tool.includes("patch"))) return;',
-    "      const blocking = getBlockingGotchasForFile(String(targetPath));",
-    "      if (blocking.length > 0) {",
-    "        throw new Error(",
-    "          `\u{1F43B} [Kuma] ${blocking.length} critical/high gotcha(s) for ${targetPath}:\\n` +",
-    '          blocking.map((g) => `  \u{1F534} ${g}`).join("\\n") +',
-    '          `\\nRead .kuma/KNOWN_GOTCHAS.md for workarounds, or run kuma_memory({ action: "gotcha" }) to list.`',
-    "        );",
-    "      }",
+    "      enforceGotchas(input?.tool, output?.args);",
     "    },",
     '    "file.edited": async (input) => {',
-    '      const fp = input.filePath || input.path || (input.file && input.file.path) || "";',
+    '      const fp = input?.filePath || input?.path || (input?.file && input?.file.path) || "";',
     '      if (fp) console.warn(`\u{1F43B} [Kuma] ${fp} edited \u2014 consider kuma_safety({ action: "verify", scope: "${fp}" })`);',
     "    },",
     '    "experimental.session.compacting": async (input, output) => {',
@@ -11470,6 +11475,48 @@ function opencodePluginTemplate() {
     "    },",
     "  };",
     "};",
+    "",
+    "// \u2500\u2500\u2500 v1 host: module object form (v1 >= 1.18 calls server(), ignores setup) \u2500",
+    "async function server() {",
+    "  return {",
+    '    "tool.execute.before": async (input, output) => {',
+    "      enforceGotchas(input?.tool, output?.args);",
+    "    },",
+    '    "file.edited": async (input) => {',
+    '      const fp = input?.filePath || input?.path || (input?.file && input?.file.path) || "";',
+    '      if (fp) console.warn(`\u{1F43B} [Kuma] ${fp} edited \u2014 consider kuma_safety({ action: "verify", scope: "${fp}" })`);',
+    "    },",
+    '    "experimental.session.compacting": async (input, output) => {',
+    "      try {",
+    '        const { execSync } = await import("node:child_process");',
+    '        const ctx = execSync("kuma hook pre-compact", { encoding: "utf-8", timeout: 8000 });',
+    '        const parsed = JSON.parse(ctx || "{}");',
+    '        const add = parsed?.hookSpecificOutput?.hookSpecificOutput?.additionalContext || "";',
+    "        if (add && output && Array.isArray(output.context)) output.context.push(add);",
+    "      } catch { /* compacting must never fail */ }",
+    "    },",
+    "  };",
+    "}",
+    "",
+    "// \u2500\u2500\u2500 v2 host: setup registers hooks on ctx (mutable event draft) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "async function setup(ctx) {",
+    '  const hook = ctx && ctx.tool && typeof ctx.tool.hook === "function"',
+    "    ? ctx.tool.hook.bind(ctx.tool)",
+    "    : null;",
+    "  if (!hook) return;",
+    '  await hook("execute.before", async (event) => {',
+    "    const e = event || {};",
+    '    const tool = e.tool ?? e.toolName ?? e.name ?? e.input?.tool ?? "";',
+    "    const args = e.input ?? e.args ?? e.output?.args ?? {};",
+    "    enforceGotchas(tool, args);",
+    "  });",
+    "}",
+    "",
+    "export default {",
+    '  id: "kuma",',
+    "  server,",
+    "  setup,",
+    "};",
     ""
   ].join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.21",
+  "version": "2.4.22",
   "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.21",
+  "version": "2.4.22",
   "description": "Safety-first context & orchestration engine for AI coding agents. Shadow memory, gotcha lifecycle, blast radius impact analysis, and test verification.",
   "author": {
     "name": "plumpslabs",