@plumpslabs/kuma 2.3.12 → 2.3.14

package/dist/{chunk-CRQ7WTPV.js → chunk-LRO3HWGC.js}

@@ -66,9 +66,23 @@ function configFilePath(type) {
   }
 }
 var BOOTSTRAP_LINES = [
-  "Kuma MCP tools are installed (kuma_context, kuma_memory, kuma_safety). All behavioral rules are in `.kuma/init.md`.",
+  "Kuma MCP tools are installed (kuma_context, kuma_memory, kuma_safety).",
   '**Before coding, call `kuma_context({ action: "init" })`** to load project context and session memory.',
-  "Project knowledge persists in `.kuma/memories/*.md` across sessions."
+  "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+  "",
+  "\u26A0\uFE0F **MANDATORY WORKFLOW** \u2014 Follow in order every session:",
+  "",
+  '  1. `kuma_context({ action: "init" })` \u2014 Load context (START HERE)',
+  '  2. `kuma_safety({ action: "guard" })` \u2014 Safety check before work',
+  '  3. `kuma_context({ action: "research", scope: "<area>" })` \u2014 Research before editing',
+  "  4. *(edit using native tools)*",
+  '  5. `kuma_memory({ action: "research_save", scope: "<area>" })` \u2014 Save findings',
+  '  6. `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 Verify changes',
+  '  7. `kuma_context({ action: "changes" })` \u2014 Review changes',
+  "",
+  "\u26D4 Skipping workflow = stale context, missed decisions, unverified code.",
+  "\u{1F4D6} Full rules: `.kuma/init.md`",
+  "\u{1F9E0} Tools: `kuma_context` | `kuma_memory` | `kuma_safety`"
 ].join("\n");
 var KUMA_CORE_INSTRUCTIONS = BOOTSTRAP_LINES;
 function claudeTemplate() {
@@ -476,11 +490,24 @@ function handleOpencodeSecondary(root, results) {
       "description: Kuma MCP \u2014 safety toolkit for AI coding agents. Research, memory, and safety guard.",
       "---",
       "",
-      "Kuma MCP tools are installed. All behavioral rules are in `.kuma/init.md`.",
-      "**Before coding, call `kuma_init()` to load project context and session memory.**",
+      "Kuma MCP tools are installed (kuma_kuma_context, kuma_kuma_memory, kuma_kuma_safety).",
+      '**Before coding, call `kuma_kuma_context({ action: "init" })`** to load project context and session memory.',
       "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
       "",
-      "\u{1F4D6} Read `.kuma/init.md` for detailed rules."
+      "\u26A0\uFE0F **MANDATORY WORKFLOW** \u2014 Follow in order every session:",
+      "",
+      '  1. `kuma_kuma_context({ action: "init" })` \u2014 Load context (START HERE)',
+      '  2. `kuma_kuma_safety({ action: "guard" })` \u2014 Safety check before work',
+      '  3. `kuma_kuma_context({ action: "research", scope: "<area>" })` \u2014 Research before editing',
+      "  4. *(edit using native tools)*",
+      '  5. `kuma_kuma_memory({ action: "research_save", scope: "<area>" })` \u2014 Save findings',
+      '  6. `kuma_kuma_safety({ action: "verify", scope: "<area>" })` \u2014 Verify changes',
+      '  7. `kuma_kuma_context({ action: "changes" })` \u2014 Review changes',
+      "",
+      "\u26A0\uFE0F **OpenCode platform note:** Tool names are prefixed with `kuma_kuma_*`",
+      "   (server name `kuma` + already-prefixed tool name `kuma_context`).",
+      "",
+      "\u{1F4D6} Full rules: `.kuma/init.md`"
     ].join("\n");
     if (fs.existsSync(skillPath)) {
       const existing = fs.readFileSync(skillPath, "utf-8");
@@ -579,27 +606,84 @@ function handleQwenSecondary(root, results) {
   }
 }
 var AGENTS_MD_TYPES = ["opencode", "codex", "qwen", "copilot"];
-function getAgentsMdHeader() {
-  return [
-    "# Kuma MCP - Combined Agent Instructions",
+function getCombinedAgentsMd(selectedTypes) {
+  const lines = [
+    "# Kuma MCP \u2014 Combined Agent Instructions",
+    "",
+    "This file contains behavioral rules for AI coding agents. Unused sections can be safely removed.",
+    "",
+    "---",
+    "",
+    "## \u26A0\uFE0F MANDATORY WORKFLOW",
+    "",
+    "Follow these steps in order every session (all platforms):",
+    "",
+    '  1. `[kuma_]context({ action: "init" })`                   \u2014 Load project context (START HERE)',
+    '  2. `[kuma_]safety({ action: "guard" })`                   \u2014 Safety check before editing',
+    '  3. `[kuma_]context({ action: "research", scope: "<area>" })` \u2014 Research before editing',
+    "  4. *(edit using native tools)*",
+    '  5. `[kuma_]memory({ action: "research_save", ... })`      \u2014 Save findings',
+    '  6. `[kuma_]safety({ action: "verify", ... })`             \u2014 Verify correctness',
+    '  7. `[kuma_]context({ action: "changes" })`                \u2014 Review changes',
+    "",
+    "\u26D4 Skipping workflow = stale context, missed decisions, unverified code.",
     "",
-    "This file contains instructions for AI coding agents that read AGENTS.md.",
-    "Each section applies to a specific agent. Unused sections can be safely removed.",
+    "Replace `[kuma_]` with the correct prefix for your platform (see below).",
     "",
     "---",
-    "_Generated by Kuma MCP - https://github.com/plumpslabs/kuma_",
     ""
-  ].join("\n");
-}
-function getCombinedAgentsMd(selectedTypes) {
-  const sections = [getAgentsMdHeader()];
-  const agentOrder = ["opencode", "codex", "qwen", "copilot"];
-  for (const t of agentOrder) {
-    if (selectedTypes.has(t)) {
-      sections.push(TEMPLATES[t]());
-    }
+  ];
+  if (selectedTypes.has("opencode")) {
+    lines.push(
+      "### OpenCode",
+      "",
+      "OpenCode adds the MCP server name (`kuma`) as a prefix to tool names.",
+      "The server-registered names (kuma_context, kuma_memory, kuma_safety) become:",
+      "",
+      "| Action | Call this |",
+      "|--------|-----------|",
+      '| Init | `kuma_kuma_context({ action: "init" })` |',
+      '| Guard | `kuma_kuma_safety({ action: "guard" })` |',
+      '| Research | `kuma_kuma_context({ action: "research", scope: "..." })` |',
+      '| Save | `kuma_kuma_memory({ action: "research_save", ... })` |',
+      '| Verify | `kuma_kuma_safety({ action: "verify", ... })` |',
+      '| Changes | `kuma_kuma_context({ action: "changes" })` |',
+      "",
+      "\u{1F4D6} Skill: `.agents/skills/kuma/SKILL.md`",
+      "",
+      "---",
+      ""
+    );
+  }
+  const nonOpenCode = Array.from(selectedTypes).filter((t) => t !== "opencode");
+  if (nonOpenCode.length > 0) {
+    lines.push(
+      "### Other Platforms",
+      "",
+      ...nonOpenCode.map((t) => `- ${CONFIG_LABELS[t]}`),
+      "",
+      "Tool names are registered directly \u2014 no server prefix added:",
+      "",
+      "| Action | Call this |",
+      "|--------|-----------|",
+      '| Init | `kuma_context({ action: "init" })` |',
+      '| Guard | `kuma_safety({ action: "guard" })` |',
+      '| Research | `kuma_context({ action: "research", scope: "..." })` |',
+      '| Save | `kuma_memory({ action: "research_save", ... })` |',
+      '| Verify | `kuma_safety({ action: "verify", ... })` |',
+      '| Changes | `kuma_context({ action: "changes" })` |',
+      "",
+      "---",
+      ""
+    );
   }
-  return sections.join("\n\n---\n\n");
+  lines.push(
+    "\u{1F4D6} Rules: `.kuma/init.md`",
+    "\u{1F9E0} Memories: `.kuma/memories/*.md`",
+    "",
+    "_Generated by Kuma MCP - https://github.com/plumpslabs/kuma_"
+  );
+  return lines.join("\n");
 }
 function handleAntigravityMcpConfig(root, results) {
   const mcpPath = path.resolve(root, ".agents/mcp_config.json");

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   ALL_CONFIG_TYPES,
   formatInitResults,
   runInit
-} from "./chunk-CRQ7WTPV.js";
+} from "./chunk-LRO3HWGC.js";
 import {
   formatDecisionTemplate,
   getProactiveMemories,
@@ -2571,7 +2571,7 @@ async function main() {
   });
   (async () => {
     try {
-      const { generateInitMdContent } = await import("./init-OMETJFLM.js");
+      const { generateInitMdContent } = await import("./init-7MWMONZL.js");
       const fs7 = await import("fs");
       const path7 = await import("path");
       const initMdPath = path7.resolve(process.cwd(), ".kuma/init.md");
@@ -2588,7 +2588,7 @@ async function main() {
   (async () => {
     try {
       const { detectAgent, getSkillPath, getAgentLabel } = await import("./agentDetector-YOWQVJFR.js");
-      const { generateSkill, getSecondaryFiles } = await import("./skillGenerator-RGXRSBX2.js");
+      const { generateSkill, getSecondaryFiles } = await import("./skillGenerator-JIHFTNH6.js");
       const fs7 = await import("fs");
       const path7 = await import("path");
       const detection = detectAgent();

package/dist/{init-OMETJFLM.js → init-7MWMONZL.js}

@@ -4,7 +4,7 @@ import {
   formatInitResults,
   generateInitMdContent,
   runInit
-} from "./chunk-CRQ7WTPV.js";
+} from "./chunk-LRO3HWGC.js";
 import "./chunk-E2KFPEBT.js";
 export {
   ALL_CONFIG_TYPES,

package/dist/{skillGenerator-RGXRSBX2.js → skillGenerator-JIHFTNH6.js}

@@ -1,8 +1,22 @@
 // src/utils/skillGenerator.ts
 var BOOTSTRAP = [
-  "Kuma MCP tools are available (kuma_context, kuma_memory, kuma_safety). All behavioral rules are in `.kuma/init.md`.",
+  "Kuma MCP tools are available (kuma_context, kuma_memory, kuma_safety).",
   '**Before coding, call `kuma_context({ action: "init" })`** to load project context and session memory.',
-  "Project knowledge persists in `.kuma/memories/*.md` across sessions."
+  "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+  "",
+  "\u26A0\uFE0F **MANDATORY WORKFLOW** \u2014 Follow in order every session:",
+  "",
+  '  1. `kuma_context({ action: "init" })` \u2014 Load context (START HERE)',
+  '  2. `kuma_safety({ action: "guard" })` \u2014 Safety check before work',
+  '  3. `kuma_context({ action: "research", scope: "<area>" })` \u2014 Research before editing',
+  "  4. *(edit using native tools)*",
+  '  5. `kuma_memory({ action: "research_save", scope: "<area>" })` \u2014 Save findings',
+  '  6. `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 Verify changes',
+  '  7. `kuma_context({ action: "changes" })` \u2014 Review changes',
+  "",
+  "\u26D4 Skipping workflow = stale context, missed decisions, unverified code.",
+  "\u{1F4D6} Full rules: `.kuma/init.md`",
+  "\u{1F9E0} Tools: `kuma_context` | `kuma_memory` | `kuma_safety`"
 ].join("\n");
 function generateSkill(type) {
   switch (type) {
@@ -60,8 +74,9 @@ function generateClaudeSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check before risky ops',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules",
     "  \u2022 `.kuma/memories/` \u2014 persistent project knowledge"
   ].join("\n");
@@ -76,9 +91,9 @@ function generateCursorSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check before risky ops',
-    '  \u2022 `kuma_verify({action: "test"})` \u2014 verify after edits',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules",
     "  \u2022 `.kuma/memories/` \u2014 persistent project knowledge"
   ].join("\n");
@@ -94,8 +109,9 @@ function generateClineSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check before risky ops',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -109,9 +125,9 @@ function generateAntigravitySkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
-    '  \u2022 `kuma_verify({action: "test"})` \u2014 verify after edits',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -147,9 +163,11 @@ function generateOpencodeSkill() {
     "description: Kuma MCP \u2014 safety toolkit for AI coding agents. Research, memory, and safety guard.",
     "---",
     "",
-    "Kuma MCP tools are installed. All behavioral rules are in `.kuma/init.md`.",
-    "**Before coding, call `kuma_init()` to load project context and session memory.**",
-    "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+    "\u26A0\uFE0F **OpenCode platform note:** Tool names use `kuma_kuma_*` prefix",
+    "   (server name `kuma` + already-prefixed `kuma_context`).",
+    '   Example: `kuma_kuma_context({ action: "init" })`',
+    "",
+    BOOTSTRAP,
     "",
     "\u{1F4D6} Read `.kuma/init.md` for detailed rules."
   ].join("\n");
@@ -161,8 +179,9 @@ function generateAiderSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -179,10 +198,7 @@ function generateWindsurfSkill() {
   return [
     "# Kuma MCP \u2014 Windsurf",
     "",
-    "Windsurf Cascade agent: Kuma MCP tools are available.",
-    "All behavioral rules are in `.kuma/init.md`.",
-    "**Before coding, call `kuma_init()` to load project context.**",
-    "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+    BOOTSTRAP,
     "",
     "Also auto-detected via `.windsurf/skills/` and `.agents/skills/`."
   ].join("\n");
@@ -197,8 +213,9 @@ function generateCopilotSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -209,8 +226,9 @@ function generateQwenSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -236,9 +254,9 @@ function generateKiroSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
-    '  \u2022 `kuma_verify({action: "test"})` \u2014 verify after edits',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }
@@ -252,8 +270,9 @@ function generateOpenclawSkill() {
     BOOTSTRAP,
     "",
     "\u{1F4D6} **Usage:**",
-    "  \u2022 `kuma_init()` \u2014 load project context (call first)",
-    '  \u2022 `kuma_guard({check: "all"})` \u2014 safety check',
+    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
+    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
+    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
     "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
   ].join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.3.12",
+  "version": "2.3.14",
   "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",