@plumpslabs/kuma 2.3.7 → 2.3.9

package/dist/{chunk-K64NSHBR.js → chunk-ZKDYTYMS.js}

@@ -1,7 +1,7 @@
 import {
   getDb,
   saveDb
-} from "./chunk-GDNAWLHF.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-HBBXUSIP.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-5JXLH56Z.js

@@ -0,0 +1,177 @@
+import {
+  getActiveGotchas
+} from "./chunk-Q2444HWO.js";
+import {
+  sessionMemory
+} from "./chunk-R6B3VUSB.js";
+import {
+  getDb
+} from "./chunk-3TX6Q37T.js";
+import {
+  getProjectRoot
+} from "./chunk-E2KFPEBT.js";
+
+// src/engine/contextDigest.ts
+import fs from "fs";
+import path from "path";
+function detectTechStack() {
+  const root = getProjectRoot();
+  const stack = {
+    languages: [],
+    framework: null,
+    database: null,
+    testRunner: null,
+    packageManager: null,
+    monorepo: false
+  };
+  try {
+    const pkgPath = path.join(root, "package.json");
+    if (fs.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (fs.existsSync(path.join(root, "pnpm-lock.yaml"))) stack.packageManager = "pnpm";
+      else if (fs.existsSync(path.join(root, "yarn.lock"))) stack.packageManager = "yarn";
+      else stack.packageManager = "npm";
+      stack.monorepo = !!pkg.workspaces;
+      if (deps.next) stack.framework = "Next.js";
+      else if (deps.react) stack.framework = "React";
+      else if (deps.vue) stack.framework = "Vue";
+      else if (deps.express) stack.framework = "Express";
+      else if (deps.fastify) stack.framework = "Fastify";
+      else if (deps.nest) stack.framework = "NestJS";
+      else if (deps["@remix-run/react"]) stack.framework = "Remix";
+      else if (deps.svelte) stack.framework = "Svelte";
+      else if (deps.angular) stack.framework = "Angular";
+      if (deps.prisma) stack.database = "Prisma";
+      else if (deps.typeorm) stack.database = "TypeORM";
+      else if (deps.mongoose) stack.database = "MongoDB";
+      else if (deps.pg || deps["@neondatabase/serverless"]) stack.database = "PostgreSQL";
+      else if (deps.redis) stack.database = "Redis";
+      else if (deps.better || deps.drizzle) stack.database = "Drizzle";
+      if (deps.jest || deps["@jest/core"]) stack.testRunner = "Jest";
+      else if (deps.vitest) stack.testRunner = "Vitest";
+      else if (deps.mocha) stack.testRunner = "Mocha";
+      else if (deps.playwright) stack.testRunner = "Playwright";
+      else if (deps.cypress) stack.testRunner = "Cypress";
+      if (fs.existsSync(path.join(root, "tsconfig.json"))) stack.languages.push("TypeScript");
+      if (deps.typescript) stack.languages.push("TypeScript");
+      if (fs.existsSync(path.join(root, "jsconfig.json"))) stack.languages.push("JavaScript");
+      if (fs.existsSync(path.join(root, "go.mod"))) stack.languages.push("Go");
+      if (fs.existsSync(path.join(root, "Cargo.toml"))) stack.languages.push("Rust");
+      if (fs.existsSync(path.join(root, "pyproject.toml"))) stack.languages.push("Python");
+      if (fs.existsSync(path.join(root, "Gemfile"))) stack.languages.push("Ruby");
+      if (stack.languages.length === 0) stack.languages.push("JavaScript");
+    }
+  } catch {
+  }
+  return stack;
+}
+function detectEntryPoints() {
+  const root = getProjectRoot();
+  const entryPoints = [];
+  const candidates = [
+    "src/index.ts",
+    "src/index.js",
+    "src/app.ts",
+    "src/app.js",
+    "index.ts",
+    "index.js",
+    "src/main.ts",
+    "src/main.js",
+    "src/server.ts",
+    "src/server.js",
+    "app.ts",
+    "app.js",
+    "pages/index.tsx",
+    "pages/index.jsx",
+    "src/App.tsx",
+    "src/App.js",
+    "lib/main.ts",
+    "lib/index.ts"
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(path.join(root, c))) {
+      entryPoints.push(c);
+    }
+  }
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
+    if (pkg.main && fs.existsSync(path.join(root, pkg.main))) {
+      if (!entryPoints.includes(pkg.main)) entryPoints.push(pkg.main);
+    }
+  } catch {
+  }
+  return entryPoints;
+}
+async function getActiveADRs() {
+  try {
+    const db = await getDb();
+    const stmt = db.prepare(
+      "SELECT title FROM decision_log WHERE status = 'active' ORDER BY created_at DESC LIMIT 5"
+    );
+    const results = [];
+    while (stmt.step()) {
+      const row = stmt.getAsObject();
+      results.push(row.title);
+    }
+    stmt.free();
+    return results;
+  } catch {
+    return [];
+  }
+}
+async function generateContextDigest() {
+  const stack = detectTechStack();
+  const entryPoints = detectEntryPoints();
+  const adrs = await getActiveADRs();
+  const gotchas = getActiveGotchas();
+  const summary = sessionMemory.getSummary();
+  const lines = [
+    "\u{1F4CB} **Kuma Digest** \u2014 <500 token briefing",
+    "\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\u2501",
+    ""
+  ];
+  const langStr = stack.languages.join("/");
+  const frameworkStr = stack.framework || "\u2014";
+  const dbStr = stack.database || "\u2014";
+  const testStr = stack.testRunner || "\u2014";
+  const pmStr = stack.packageManager || "\u2014";
+  lines.push(`\u{1F527} **Stack**: ${langStr} | ${frameworkStr} | ${dbStr} | ${testStr} | ${pmStr}${stack.monorepo ? " (monorepo)" : ""}`);
+  lines.push(`\u{1F4C1} **Root**: ${getProjectRoot().split("/").pop() || "?"}`);
+  if (entryPoints.length > 0) {
+    lines.push(`\u{1F6AA} **Entry**: ${entryPoints.slice(0, 3).join(", ")}`);
+  }
+  try {
+    const ruleFile = path.join(getProjectRoot(), ".kuma", "DOMAIN_RULES.md");
+    if (fs.existsSync(ruleFile)) {
+      const content = fs.readFileSync(ruleFile, "utf-8");
+      const rules = content.split("\n").filter((l) => /^- Rule \d+:?\s*/i.test(l)).map((l) => l.replace(/^- Rule \d+:?\s*/i, "").trim()).filter(Boolean);
+      if (rules.length > 0) {
+        lines.push(`\u{1F4CB} **Rules**: ${rules.slice(0, 5).join(" | ")}`);
+      }
+    }
+  } catch {
+  }
+  if (gotchas.length > 0) {
+    const critical = gotchas.filter((g) => g.severity === "critical" || g.severity === "high");
+    if (critical.length > 0) {
+      lines.push(`\u26A0\uFE0F **Gotchas**: ${critical.length} high/critical \u2014 ${critical.slice(0, 3).map((g) => g.filePath).join(", ")}`);
+    } else {
+      lines.push(`\u26A0\uFE0F **Gotchas**: ${gotchas.length} recorded`);
+    }
+  }
+  if (adrs.length > 0) {
+    lines.push(`\u{1F4DD} **ADRs**: ${adrs.slice(0, 3).join(" | ")}`);
+  }
+  lines.push(`\u{1F3AF} **Goal**: ${summary.currentGoal?.substring(0, 80) || "not set"}`);
+  const text = lines.join("\n");
+  const estimatedTokens = Math.ceil(text.length / 4);
+  if (estimatedTokens > 450) {
+    lines.push(`\u{1F4CA} *~${estimatedTokens} tokens, fits under 500 limit*`);
+  }
+  return lines.join("\n") + "\n\n\u{1F4A1} Use kuma_context({ action: 'sync' }) for full state.";
+}
+export {
+  generateContextDigest,
+  generateContextDigest as generateDigest
+};

package/dist/domainRules-ED6EOFVY.js

@@ -0,0 +1,20 @@
+import {
+  appendToLayer,
+  checkFileGotchas,
+  generateDigest,
+  getActiveGotchas,
+  getLayersSummary,
+  readLayer,
+  writeLayer
+} from "./chunk-Q2444HWO.js";
+import "./chunk-R6B3VUSB.js";
+import "./chunk-E2KFPEBT.js";
+export {
+  appendToLayer,
+  checkFileGotchas,
+  generateDigest,
+  getActiveGotchas,
+  getLayersSummary,
+  readLayer,
+  writeLayer
+};