@plumpslabs/kuma 2.3.8 → 2.3.10

package/dist/{agentDetector-G4RBMZ6X.js → agentDetector-3OTNKKBS.js}

@@ -36,10 +36,10 @@ var AGENT_DETECTORS = [
   },
   {
     type: "windsurf",
-    checkFiles: [".windsurfrules"],
-    checkDirs: [],
+    checkFiles: [],
+    checkDirs: [".windsurf"],
     priority: 70,
-    label: "Windsurf (.windsurfrules)"
+    label: "Windsurf (.windsurf/)"
   },
   {
     type: "opencode",
@@ -156,7 +156,7 @@ function getSkillPath(type) {
     case "aider":
       return "CONVENTIONS.md";
     case "windsurf":
-      return ".windsurfrules";
+      return ".windsurf/rules/kuma.md";
     case "copilot":
       return ".github/skills/kuma/SKILL.md";
     case "qwen":

package/dist/{chunk-NAM7SCBT.js → chunk-3TX6Q37T.js}

@@ -9,6 +9,10 @@ import path from "path";
 var DB_FILENAME = "kuma.db";
 var dbInstance = null;
 var initPromise = null;
+function resetDbInstance() {
+  dbInstance = null;
+  initPromise = null;
+}
 async function getDb() {
   if (dbInstance) return dbInstance;
   if (initPromise) return initPromise;
@@ -74,12 +78,32 @@ function createSchema(db) {
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     source_id TEXT NOT NULL REFERENCES nodes(id),
     target_id TEXT NOT NULL REFERENCES nodes(id),
-    type TEXT NOT NULL CHECK(type IN ('calls','imports','defines','tests','routes','implements','extends','depends_on','owns','modified_by')),
+    type TEXT NOT NULL CHECK(type IN ('calls','imports','defines','tests','routes','implements','extends','depends_on','owns','modified_by','contains','composes')),
     weight REAL DEFAULT 1.0,
     metadata TEXT DEFAULT '{}',
     created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
     UNIQUE(source_id, target_id, type)
   )`);
+  try {
+    const schema = db.exec(`SELECT sql FROM sqlite_master WHERE type='table' AND name='edges'`);
+    const edgeSql = schema[0]?.values?.[0]?.[0] || "";
+    if (edgeSql.includes("contains") === false || edgeSql.includes("composes") === false) {
+      db.run(`ALTER TABLE edges RENAME TO edges_old`);
+      db.run(`CREATE TABLE IF NOT EXISTS edges (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_id TEXT NOT NULL REFERENCES nodes(id),
+        target_id TEXT NOT NULL REFERENCES nodes(id),
+        type TEXT NOT NULL CHECK(type IN ('calls','imports','defines','tests','routes','implements','extends','depends_on','owns','modified_by','contains','composes')),
+        weight REAL DEFAULT 1.0,
+        metadata TEXT DEFAULT '{}',
+        created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
+        UNIQUE(source_id, target_id, type)
+      )`);
+      db.run(`INSERT OR IGNORE INTO edges SELECT * FROM edges_old`);
+      db.run(`DROP TABLE edges_old`);
+    }
+  } catch {
+  }
   db.run(`CREATE TABLE IF NOT EXISTS sessions (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     started_at INTEGER NOT NULL,
@@ -998,6 +1022,7 @@ async function getLatestVerifications(limit = 10) {
 }
 
 export {
+  resetDbInstance,
   getDb,
   saveDb,
   getResearchCache,

package/dist/{chunk-L5WU2HTN.js → chunk-J2CBDLXB.js}

@@ -23,12 +23,12 @@ var ALL_CONFIG_TYPES = [
 var CONFIG_LABELS = {
   claude: "Claude Code (CLAUDE.md / plugin)",
   cursor: "Cursor (.cursor/rules/*.mdc)",
-  windsurf: "Windsurf (.windsurfrules)",
+  windsurf: "Windsurf (.windsurf/rules/)",
   copilot: "GitHub Copilot Editor (AGENTS.md + Skill)",
   cline: "Cline (.clinerules/*.md)",
   aider: "Aider (CONVENTIONS.md via .aider.conf.yml)",
   antigravity: "Antigravity CLI (.agents/skills/)",
-  opencode: "OpenCode (opencode.json)",
+  opencode: "OpenCode (opencode.json + skills)",
   codex: "Codex CLI (AGENTS.md + .codex/config.toml)",
   qwen: "Qwen Code (AGENTS.md + settings.json)",
   kiro: "Kiro (.kiro/steering/*.md)",
@@ -42,7 +42,7 @@ function configFilePath(type) {
     case "cursor":
       return ".cursor/rules/kuma.mdc";
     case "windsurf":
-      return ".windsurfrules";
+      return ".windsurf/rules/kuma.md";
     case "copilot":
       return "AGENTS.md";
     case "cline":
@@ -97,7 +97,12 @@ function windsurfRulesTemplate() {
   return [
     "# Kuma MCP \u2014 Windsurf",
     "",
-    KUMA_CORE_INSTRUCTIONS
+    "Windsurf Cascade agent: Kuma MCP tools are installed.",
+    "All behavioral rules are in `.kuma/init.md`.",
+    "**Before coding, load project context via `kuma_init()`.**",
+    "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+    "",
+    "Also auto-detected as SKILL.md in `.windsurf/skills/` and `.agents/skills/`."
   ].join("\n");
 }
 function copilotTemplate() {
@@ -337,7 +342,43 @@ var TEMPLATES = {
   codewhale: codewhaleTemplate
 };
 var APPEND_SEPARATOR = "\n\n---\n_Generated by Kuma MCP - https://github.com/plumpslabs/kuma_\n\n";
-function handleOpencodeSecondary(_root, _results) {
+function handleOpencodeSecondary(root, results) {
+  const skillPath = path.resolve(root, ".agents", "skills", "kuma", "SKILL.md");
+  if (results.some((r) => r.filePath === ".agents/skills/kuma/SKILL.md")) return;
+  try {
+    const dir = path.dirname(skillPath);
+    const content = [
+      "---",
+      "name: kuma-mcp",
+      "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.",
+      "",
+      "MCP server configured in `opencode.json`."
+    ].join("\n");
+    if (fs.existsSync(skillPath)) {
+      const existing = fs.readFileSync(skillPath, "utf-8");
+      if (existing.includes("kuma-mcp")) {
+        results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "skipped" });
+        return;
+      }
+      results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "skipped" });
+    } else {
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(skillPath, content, "utf-8");
+      results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "created" });
+    }
+  } catch (err) {
+    results.push({
+      type: "opencode",
+      filePath: ".agents/skills/kuma/SKILL.md",
+      action: "error",
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
 }
 function handleCodexSecondary(root, results) {
   const tomlPath = path.resolve(root, ".codex/config.toml");

package/dist/{chunk-RTGLQDMI.js → chunk-OJALFQ4H.js}

@@ -1,6 +1,6 @@
 import {
   sessionMemory
-} from "./chunk-SLRRDKQ2.js";
+} from "./chunk-R6B3VUSB.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";
@@ -82,7 +82,7 @@ function recordDecision(decision) {
 }
 async function recordDecisionToGraph(decision) {
   try {
-    const { upsertNode, addEdge } = await import("./kumaGraph-AWP743TJ.js");
+    const { upsertNode, addEdge } = await import("./kumaGraph-GUQM75WL.js");
     const decisionId = `decision::${decision.title.replace(/[^a-zA-Z0-9_\-\s]/g, "").trim().replace(/\s+/g, "-")}`;
     await upsertNode({
       id: decisionId,

package/dist/{chunk-53J56QCQ.js → chunk-Q2444HWO.js}

@@ -1,6 +1,6 @@
 import {
   sessionMemory
-} from "./chunk-SLRRDKQ2.js";
+} from "./chunk-R6B3VUSB.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{chunk-SLRRDKQ2.js → chunk-R6B3VUSB.js}

@@ -320,7 +320,7 @@ No unresolved issues.`;
    */
   async autoTrackToDb(toolName, params, timestamp) {
     try {
-      const { getDb, saveDb } = await import("./kumaDb-6D53ERFP.js");
+      const { getDb, saveDb } = await import("./kumaDb-IC7UX7PU.js");
       const db = await getDb();
       db.run(
         `INSERT INTO tool_calls (tool_name, params, success, duration_ms, created_at) VALUES (?, ?, 1, 0, ?)`,
@@ -605,7 +605,7 @@ No unresolved issues.`;
       this.addModifiedFile(filePath);
     }
     try {
-      const { recordChange } = await import("./kumaDb-6D53ERFP.js");
+      const { recordChange } = await import("./kumaDb-IC7UX7PU.js");
       const gitHash = this.getGitHead();
       await recordChange({ filePath, changeType, symbol, gitCommitHash: gitHash || void 0 });
     } catch {

package/dist/{chunk-PTEPJK6M.js → chunk-RI3DKY62.js}

@@ -1,7 +1,7 @@
 import {
   getDb,
   saveDb
-} from "./chunk-NAM7SCBT.js";
+} from "./chunk-3TX6Q37T.js";
 
 // src/engine/safetyAudit.ts
 var SCHEMA_SQL = `

package/dist/{chunk-FL2TLLMX.js → chunk-SPHI2BOO.js}

@@ -1,6 +1,6 @@
 import {
   sessionMemory
-} from "./chunk-SLRRDKQ2.js";
+} from "./chunk-R6B3VUSB.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{chunk-4OB3XMHT.js → chunk-ZKDYTYMS.js}

@@ -1,7 +1,7 @@
 import {
   getDb,
   saveDb
-} from "./chunk-NAM7SCBT.js";
+} from "./chunk-3TX6Q37T.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";
@@ -458,7 +458,7 @@ The two nodes may not be connected in the knowledge graph yet. Use more tools to
 }
 async function buildFromSessionMemory() {
   try {
-    const { sessionMemory } = await import("./sessionMemory-CA34TCPF.js");
+    const { sessionMemory } = await import("./sessionMemory-4UWA3E5J.js");
     const toolCalls = sessionMemory.getToolCallHistory(50);
     let edgeCount = 0;
     for (const call of toolCalls) {
@@ -630,6 +630,109 @@ async function codebaseSearchFallback(query, limit = 20) {
     }
   }
 }
+async function resolveFederatedNode(uri) {
+  try {
+    if (!uri.startsWith("kuma://")) {
+      return `\u26A0\uFE0F Invalid URI scheme: "${uri.substring(0, 20)}...". Use kuma://project/node-id`;
+    }
+    const pathPart = uri.replace("kuma://", "");
+    const firstSlash = pathPart.indexOf("/");
+    if (firstSlash === -1) {
+      return `\u26A0\uFE0F Invalid federated URI: "${uri}". Format: kuma://<project>/<node-id>`;
+    }
+    const projectName = pathPart.substring(0, firstSlash);
+    const nodeRef = pathPart.substring(firstSlash + 1);
+    const db = await getDb();
+    const stmt = db.prepare(`
+      SELECT id, type, name, file_path, metadata FROM nodes
+      WHERE id = ? OR name LIKE ?
+      LIMIT 5
+    `);
+    stmt.bind([nodeRef, `%${nodeRef}%`]);
+    const results = [];
+    while (stmt.step()) results.push(stmt.getAsObject());
+    stmt.free();
+    if (results.length > 0) {
+      const lines = [
+        `\u{1F517} **Federated Node Resolved** (local)`,
+        `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`,
+        `\u{1F4C1} Project: ${projectName}`,
+        `\u{1F517} URI: ${uri}`,
+        ""
+      ];
+      for (const r of results) {
+        lines.push(`  \u2022 **${r.name}** (${r.type}) \u2014 ${r.file_path || "no path"}`);
+      }
+      lines.push("", "\u{1F4A1} Federated cross-repo resolution is active. Remote resolution via HTTP coming soon.");
+      return lines.join("\n");
+    }
+    const federatedNodes = await registerFederatedReference(uri, projectName, nodeRef);
+    return [
+      `\u{1F517} **Federated Reference**`,
+      `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`,
+      `\u{1F4C1} Remote project: ${projectName}`,
+      `\u{1F517} URI: ${uri}`,
+      `\u{1F4CC} Node ref: ${nodeRef}`,
+      "",
+      `\u{1F4DD} Registered as federated reference for future resolution.`,
+      `\u{1F4A1} Remote graph resolution will be available when the target project is reachable.`,
+      federatedNodes > 0 ? `\u2705 Created ${federatedNodes} federated node(s) in local graph.` : ""
+    ].filter(Boolean).join("\n");
+  } catch (err) {
+    return `\u274C Federated resolution failed: ${err}`;
+  }
+}
+async function registerFederatedReference(uri, projectName, nodeRef) {
+  try {
+    await upsertNode({
+      id: `federated::${uri}`,
+      type: "module",
+      name: `[${projectName}] ${nodeRef}`,
+      metadata: {
+        federated: true,
+        uri,
+        project: projectName,
+        ref: nodeRef,
+        resolved: false
+      }
+    });
+    return 1;
+  } catch {
+    return 0;
+  }
+}
+async function listFederatedReferences() {
+  try {
+    const db = await getDb();
+    const stmt = db.prepare(`
+      SELECT id, name, metadata FROM nodes
+      WHERE metadata LIKE '%"federated":true%'
+      ORDER BY updated_at DESC
+      LIMIT 20
+    `);
+    const results = [];
+    while (stmt.step()) results.push(stmt.getAsObject());
+    stmt.free();
+    if (results.length === 0) {
+      return "\u{1F517} **No federated references.** Use kuma_memory({ action: 'federated', uri: 'kuma://project/node-id' }) to add one.";
+    }
+    const lines = [
+      "\u{1F517} **Federated References**",
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501",
+      ""
+    ];
+    for (const r of results) {
+      const meta = JSON.parse(r.metadata || "{}");
+      lines.push(`  \u{1F517} **${r.name}**`);
+      lines.push(`     URI: ${meta.uri || "unknown"}`);
+      lines.push(`     Resolved: ${meta.resolved ? "\u2705" : "\u23F3"}`);
+      lines.push("");
+    }
+    return lines.join("\n");
+  } catch (err) {
+    return `Error: ${err}`;
+  }
+}
 async function getGraphStats() {
   try {
     const db = await getDb();
@@ -850,6 +953,7 @@ export {
   detectStaleNodes,
   autoHeal,
   formatHealReport,
+  nodeId,
   upsertNode,
   addEdge,
   recordFunctionCall,
@@ -860,6 +964,8 @@ export {
   queryGraph,
   buildFromSessionMemory,
   searchGraph,
+  resolveFederatedNode,
+  listFederatedReferences,
   getGraphStats,
   analyzeImpact,
   formatImpact,

package/dist/{contextDigest-4PCK3DSM.js → contextDigest-5JXLH56Z.js}

@@ -1,12 +1,12 @@
 import {
   getActiveGotchas
-} from "./chunk-53J56QCQ.js";
+} from "./chunk-Q2444HWO.js";
 import {
   sessionMemory
-} from "./chunk-SLRRDKQ2.js";
+} from "./chunk-R6B3VUSB.js";
 import {
   getDb
-} from "./chunk-NAM7SCBT.js";
+} from "./chunk-3TX6Q37T.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{domainRules-LDZPOIGZ.js → domainRules-ED6EOFVY.js}

@@ -6,8 +6,8 @@ import {
   getLayersSummary,
   readLayer,
   writeLayer
-} from "./chunk-53J56QCQ.js";
-import "./chunk-SLRRDKQ2.js";
+} from "./chunk-Q2444HWO.js";
+import "./chunk-R6B3VUSB.js";
 import "./chunk-E2KFPEBT.js";
 export {
   appendToLayer,