@plumpslabs/kuma 2.4.8 → 2.4.10

package/dist/index.js

@@ -5579,7 +5579,7 @@ async function addGotcha(entry) {
     try {
       const { addEdge: addEdge2 } = await Promise.resolve().then(() => (init_kumaGraph(), kumaGraph_exports));
       const stmt = db.prepare(`
-        SELECT id FROM nodes WHERE type = 'arch_flow'
+        SELECT id FROM nodes WHERE type IN ('arch_flow', 'feature_domain')
         AND (metadata LIKE ? OR file_path = ?)
         LIMIT 5
       `);
@@ -6758,7 +6758,7 @@ async function getFlowFreshness(domain) {
     const { getDb: getDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
     const db = await getDb2();
     const stmt = db.prepare(
-      `SELECT metadata FROM nodes WHERE type = 'feature_domain' AND name = ? LIMIT 1`
+      `SELECT metadata FROM nodes WHERE type IN ('feature_domain', 'arch_flow') AND name = ? LIMIT 1`
     );
     stmt.bind([domain]);
     const found = stmt.step();
@@ -6848,7 +6848,7 @@ async function getHopsForDomain(domain) {
   try {
     const { getDb: getDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
     const db = await getDb2();
-    const stmt = db.prepare(`SELECT metadata FROM nodes WHERE type = 'feature_domain' AND name = ? LIMIT 1`);
+    const stmt = db.prepare(`SELECT metadata FROM nodes WHERE type IN ('feature_domain', 'arch_flow') AND name = ? LIMIT 1`);
     stmt.bind([domain]);
     if (stmt.step()) {
       const meta = JSON.parse(stmt.getAsObject().metadata || "{}");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.8",
+  "version": "2.4.10",
   "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/packages/ide/studio/dist/index.js

@@ -166,7 +166,7 @@ async function getDashboardData() {
       `SELECT json_group_array(json_object('id',id,'file_path',file_path,'description',REPLACE(REPLACE(description,char(10),' '),char(13),''),'severity',severity,'workaround',REPLACE(REPLACE(COALESCE(workaround,''),char(10),' '),char(13),''),'added_by',COALESCE(added_by,'agent'),'status',COALESCE(status,'active'),'scope_package',COALESCE(scope_package,''),'verified_by',COALESCE(verified_by,''),'created_at',created_at,'updated_at',COALESCE(updated_at,created_at))) FROM (SELECT * FROM known_gotchas ORDER BY created_at DESC)`
     );
     const flows = jsonRows(
-      `SELECT json_group_array(json_object('id',id,'name',name,'file_path',COALESCE(file_path,''),'metadata',COALESCE(metadata,'{}'),'updated_at',updated_at)) FROM (SELECT * FROM nodes WHERE type = 'arch_flow' ORDER BY updated_at DESC)`
+      `SELECT json_group_array(json_object('id',id,'name',name,'file_path',COALESCE(file_path,''),'metadata',COALESCE(metadata,'{}'),'updated_at',updated_at)) FROM (SELECT * FROM nodes WHERE type IN ('arch_flow', 'feature_domain') ORDER BY updated_at DESC)`
     );
     const decisions = jsonRows(
       `SELECT json_group_array(json_object('id',id,'name',name,'metadata',COALESCE(metadata,'{}'),'created_at',created_at)) FROM (SELECT * FROM nodes WHERE type = 'decision' ORDER BY created_at DESC)`
@@ -182,11 +182,31 @@ async function getDashboardData() {
         const pkg = JSON.parse(fs.readFileSync(rootPkgPath, "utf-8"));
         const pnpmWs = path.join(root, "pnpm-workspace.yaml");
         const isWs = Boolean(pkg.workspaces || fs.existsSync(pnpmWs));
+        const packages = [];
+        if (isWs) {
+          for (const dirName of ["packages", "apps", "libs", "services", "crates"]) {
+            const dirPath = path.join(root, dirName);
+            if (fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory()) {
+              for (const sub of fs.readdirSync(dirPath)) {
+                const subPkg = path.join(dirPath, sub, "package.json");
+                if (fs.existsSync(subPkg)) {
+                  try {
+                    const sp = JSON.parse(fs.readFileSync(subPkg, "utf-8"));
+                    packages.push({ name: sp.name || sub, path: `${dirName}/${sub}` });
+                  } catch {
+                    packages.push({ name: sub, path: `${dirName}/${sub}` });
+                  }
+                }
+              }
+            }
+          }
+        }
         workspace = {
           isWorkspace: isWs,
           name: pkg.name || path.basename(root),
           version: pkg.version || "1.0.0",
-          type: isWs ? fs.existsSync(pnpmWs) ? "pnpm" : "npm/yarn" : "single-package"
+          type: isWs ? fs.existsSync(pnpmWs) ? "pnpm" : "npm/yarn" : "single-package",
+          packages
         };
       }
     } catch {
@@ -440,10 +460,13 @@ try {
 } catch {
 }
 app.get("/", (c) => {
-  if (!htmlCache) {
+  try {
+    const html = readFileSync(htmlPath, "utf-8");
+    return c.html(html);
+  } catch {
+    if (htmlCache) return c.html(htmlCache);
     return c.text("index.html not found. Run from packages/ide/studio/", 500);
   }
-  return c.html(htmlCache);
 });
 serve({ fetch: app.fetch, port: PORT }, (info) => {
   const dbPath = findKumaDb();

package/packages/ide/studio/public/index.html

@@ -322,10 +322,47 @@ header {
   color: var(--muted);
   border-radius: 4px;
   font-size: 10px;
-  padding: 2px 6px;
+  padding: 3px 8px;
   cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  transition: all 0.2s ease;
 }
 .btn-copy-workaround:hover { color: #fff; border-color: var(--amber); }
+.btn-copy-workaround.copied {
+  background: rgba(16, 185, 129, 0.15);
+  border-color: var(--emerald);
+  color: #34d399;
+}
+
+#kuma-toast {
+  position: fixed;
+  bottom: 24px;
+  right: 24px;
+  background: #1e293b;
+  color: #f8fafc;
+  border: 1px solid #334155;
+  border-left: 4px solid var(--emerald);
+  padding: 10px 16px;
+  border-radius: 6px;
+  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  font-weight: 500;
+  z-index: 9999;
+  opacity: 0;
+  transform: translateY(12px);
+  transition: opacity 0.25s ease, transform 0.25s ease;
+  pointer-events: none;
+}
+#kuma-toast.show {
+  opacity: 1;
+  transform: translateY(0);
+  pointer-events: auto;
+}
 
 .gotcha-footer {
   font-size: 11px;
@@ -699,11 +736,14 @@ async function fetchDashboard() {
 }
 
 function renderAll(data) {
-  renderGotchas(data.gotchas || []);
-  renderFlows(data.flows || []);
-  renderWorkspace(data.workspace, data.nodes || []);
-  renderHealth(data);
-  if (window.lucide && window.lucide.createIcons) window.lucide.createIcons();
+  if (!data) return;
+  try { renderGotchas(data.gotchas || []); } catch (e) { console.error("renderGotchas error:", e); }
+  try { renderFlows(data.flows || []); } catch (e) { console.error("renderFlows error:", e); }
+  try { renderWorkspace(data.workspace, data.nodes || []); } catch (e) { console.error("renderWorkspace error:", e); }
+  try { renderHealth(data); } catch (e) { console.error("renderHealth error:", e); }
+  if (window.lucide && window.lucide.createIcons) {
+    try { window.lucide.createIcons(); } catch {}
+  }
 }
 
 function setStatusFilter(status) {
@@ -756,8 +796,10 @@ function renderGotchaCards(list) {
         ${g.workaround ? `
           <div class="gotcha-workaround">
             <strong>Workaround:</strong>
-            ${escapeHtml(g.workaround)}
-            <button class="btn-copy-workaround" onclick="copyText('${escapeAttr(g.workaround)}')">Copy</button>
+            <div class="workaround-text" style="margin-top:4px">${escapeHtml(g.workaround)}</div>
+            <button class="btn-copy-workaround" onclick="copyWorkaround(this)" title="Copy workaround to clipboard">
+              <i data-lucide="copy" style="width:11px;height:11px"></i> Copy
+            </button>
           </div>
         ` : ''}
         <div class="gotcha-footer">
@@ -771,29 +813,51 @@ function renderGotchaCards(list) {
 }
 
 function renderFlows(flows) {
-  document.getElementById("badge-flow-count").textContent = flows.length;
+  var countBadge = document.getElementById("badge-flow-count");
+  if (countBadge) countBadge.textContent = flows ? flows.length : 0;
   var container = document.getElementById("flow-cards-container");
-  if (!flows.length) {
+  if (!container) return;
+  if (!flows || !flows.length) {
     container.innerHTML = '<div class="empty-placeholder"><i data-lucide="git-branch"></i><div>No domain sequence flows recorded yet.</div></div>';
     if (window.lucide && window.lucide.createIcons) window.lucide.createIcons();
     return;
   }
   container.innerHTML = flows.map(function(f) {
     var meta = {};
-    try { meta = typeof f.metadata === "string" ? JSON.parse(f.metadata) : f.metadata; } catch {}
-    var hops = meta.hops || [];
+    try { meta = typeof f.metadata === "string" ? JSON.parse(f.metadata) : (f.metadata || {}); } catch {}
+    var hops = Array.isArray(meta.hops) ? meta.hops : [];
+    var hopsCount = hops.length || (typeof meta.hops === "number" ? meta.hops : (meta.hopsCount || 0));
+    var gotchas = Array.isArray(meta.gotchas) ? meta.gotchas : [];
+
+    var hopsChainHtml = '';
+    if (hops.length > 0) {
+      hopsChainHtml = `
+        <div class="flow-hops-chain">
+          ${hops.map(function(h, idx) {
+            var toLabel = typeof h === "object" ? (h.to || "") : String(h);
+            var fromLabel = (typeof h === "object" && h.from) ? h.from : "";
+            var rel = (typeof h === "object" && h.relation) ? ` <span style="opacity:0.6;font-size:10px">(${escapeHtml(h.relation)})</span>` : '';
+            var firstHopPrefix = (idx === 0 && fromLabel && fromLabel !== toLabel)
+              ? `<span class="hop-node">${escapeHtml(fromLabel)}</span><span class="hop-arrow">→</span>`
+              : '';
+            return `${firstHopPrefix}<span class="hop-node">${escapeHtml(toLabel)}${rel}</span>${idx < hops.length - 1 ? '<span class="hop-arrow">→</span>' : ''}`;
+          }).join("")}
+        </div>
+      `;
+    } else if (hopsCount > 0) {
+      hopsChainHtml = `<div style="font-size:12px;color:var(--muted);padding:4px 0">${hopsCount} sequence hop(s) recorded.</div>`;
+    } else {
+      hopsChainHtml = `<div style="font-size:12px;color:var(--muted);padding:4px 0">No hops recorded for this flow.</div>`;
+    }
+
     return `
       <div class="flow-card">
         <div class="flow-card-header">
           <div class="flow-anchor"><i data-lucide="anchor" style="width:16px;height:16px"></i> ${escapeHtml(f.name || "Flow")}</div>
-          <span style="font-size:11px;color:var(--muted)">${hops.length} hop(s)</span>
+          <span style="font-size:11px;color:var(--muted)">${hopsCount} hop(s)</span>
         </div>
-        <div class="flow-hops-chain">
-          ${hops.map(function(h, idx) {
-            return `<span class="hop-node">${escapeHtml(h.to || h)}</span>${idx < hops.length - 1 ? '<span class="hop-arrow">→</span>' : ''}`;
-          }).join("")}
-        </div>
-        ${meta.gotchas && meta.gotchas.length ? `<div style="font-size:11px;color:var(--amber)">⚠️ Linked Gotchas: ${meta.gotchas.map(escapeHtml).join(", ")}</div>` : ''}
+        ${hopsChainHtml}
+        ${gotchas.length ? `<div style="font-size:11px;color:var(--amber);margin-top:6px">⚠️ Linked Gotchas: ${gotchas.map(escapeHtml).join(", ")}</div>` : ''}
       </div>
     `;
   }).join("");
@@ -802,14 +866,29 @@ function renderFlows(flows) {
 
 function renderWorkspace(ws, nodes) {
   var container = document.getElementById("ws-topology-info");
+  if (!container) return;
   if (!ws) {
     container.innerHTML = "<div>Single package workspace.</div>";
     return;
   }
+  var nodesLen = (nodes && nodes.length) ? nodes.length : 0;
+  var pkgHtml = '';
+  if (ws.packages && Array.isArray(ws.packages) && ws.packages.length > 0) {
+    pkgHtml = `
+      <div style="margin-top:10px"><strong>Monorepo Packages (${ws.packages.length}):</strong></div>
+      <div style="margin-top:6px;display:flex;flex-wrap:wrap;gap:6px">
+        ${ws.packages.map(function(p) {
+          var name = typeof p === 'string' ? p : (p.name || p.path || '');
+          return `<span class="badge-pkg" style="background:#1e293b;border:1px solid #334155;padding:2px 8px;border-radius:4px;font-size:11px">📦 ${escapeHtml(name)}</span>`;
+        }).join("")}
+      </div>
+    `;
+  }
   container.innerHTML = `
     <div style="margin-bottom:8px"><strong>Workspace Type:</strong> <span class="badge-project">${escapeHtml(ws.type || "standard")}</span></div>
     <div style="margin-bottom:8px"><strong>Project Root:</strong> <code>${escapeHtml(ws.name || "root")}</code> (v${escapeHtml(ws.version || "1.0.0")})</div>
-    <div style="margin-top:12px;color:var(--muted)">Total indexed knowledge entities: <strong>${nodes.length}</strong></div>
+    ${pkgHtml}
+    <div style="margin-top:12px;color:var(--muted)">Total indexed knowledge entities: <strong>${nodesLen}</strong></div>
   `;
 }
 
@@ -859,13 +938,16 @@ function renderHealth(data) {
 
   var tbody = document.querySelector("#sessions-table tbody");
   var sessions = eff.recentSessions || [];
+  if (!tbody) return;
   if (!sessions.length) {
     tbody.innerHTML = '<tr><td colspan="6" style="text-align:center;color:var(--muted)">No session records logged yet.</td></tr>';
   } else {
     tbody.innerHTML = sessions.map(function(s) {
+      var dateObj = s.startedAt ? new Date(s.startedAt < 1e11 ? s.startedAt * 1000 : s.startedAt) : null;
+      var timeStr = dateObj && !isNaN(dateObj.getTime()) ? dateObj.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) : "Recent";
       return `
         <tr>
-          <td>${s.startedAt ? new Date(s.startedAt).toLocaleTimeString() : "Recent"}</td>
+          <td>${timeStr}</td>
           <td>${escapeHtml(s.goal || "General development")}</td>
           <td>${s.toolCalls}</td>
           <td>${s.edits}</td>
@@ -877,6 +959,7 @@ function renderHealth(data) {
   }
 
   var staleBox = document.getElementById("staleness-container");
+  if (!staleBox) return;
   if (data.staleness && data.staleness.missing && data.staleness.missing.length) {
     staleBox.innerHTML = `
       <div style="color:var(--rose);margin-bottom:8px">⚠️ Detected ${data.staleness.missing.length} reference(s) to deleted files:</div>
@@ -896,7 +979,8 @@ function initOrRefreshGraph() {
     var color = "#64748b";
     if (n.type === "file") color = "#06b6d4";
     else if (n.type === "gotcha") color = "#f59e0b";
-    else if (n.type === "arch_flow") color = "#6366f1";
+    else if (n.type === "arch_flow" || n.type === "feature_domain") color = "#6366f1";
+    else if (n.type === "cross_service_link" || n.type === "workflow") color = "#818cf8";
     else if (n.type === "decision") color = "#10b981";
     return {
       id: n.id,
@@ -954,10 +1038,76 @@ async function resetDb() {
   }
 }
 
-function copyText(str) {
-  if (navigator.clipboard) {
-    navigator.clipboard.writeText(str);
+function showToast(msg) {
+  var toast = document.getElementById("kuma-toast");
+  if (!toast) {
+    toast = document.createElement("div");
+    toast.id = "kuma-toast";
+    document.body.appendChild(toast);
+  }
+  toast.innerHTML = `<span style="color:var(--emerald);font-size:14px">✓</span> <span>${escapeHtml(msg || "Copied to clipboard!")}</span>`;
+  toast.classList.add("show");
+  clearTimeout(window.__kumaToastTimer);
+  window.__kumaToastTimer = setTimeout(function() {
+    toast.classList.remove("show");
+  }, 2500);
+}
+
+function fallbackCopy(text) {
+  var textarea = document.createElement("textarea");
+  textarea.value = text;
+  textarea.style.position = "fixed";
+  textarea.style.top = "-9999px";
+  textarea.style.left = "-9999px";
+  document.body.appendChild(textarea);
+  textarea.focus();
+  textarea.select();
+  try {
+    document.execCommand("copy");
+  } catch (err) {
+    console.error("execCommand copy error:", err);
+  }
+  document.body.removeChild(textarea);
+}
+
+async function copyText(str, btn, toastMsg) {
+  if (!str) return;
+  var success = false;
+  if (navigator.clipboard && window.isSecureContext) {
+    try {
+      await navigator.clipboard.writeText(str);
+      success = true;
+    } catch {
+      fallbackCopy(str);
+      success = true;
+    }
+  } else {
+    fallbackCopy(str);
+    success = true;
   }
+
+  if (success) {
+    showToast(toastMsg || "Copied to clipboard!");
+    if (btn) {
+      var origHtml = btn.innerHTML;
+      btn.classList.add("copied");
+      btn.innerHTML = '<span>Copied! ✓</span>';
+      setTimeout(function() {
+        btn.classList.remove("copied");
+        btn.innerHTML = origHtml;
+      }, 2000);
+    }
+  }
+}
+
+function copyWorkaround(btn) {
+  if (!btn) return;
+  var parent = btn.closest(".gotcha-workaround");
+  if (!parent) return;
+  var textEl = parent.querySelector(".workaround-text");
+  var text = textEl ? textEl.innerText.trim() : "";
+  if (!text) return;
+  copyText(text, btn, "Workaround copied to clipboard!");
 }
 
 function escapeHtml(str) {

package/plugin.json

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