@inerrata-corporation/errata 2.0.2-dev.156 → 2.0.2-dev.157

package/errata.mjs

@@ -25916,6 +25916,33 @@ function federationHint(status) {
       return void 0;
   }
 }
+function hasCloudNodeShape(id) {
+  return CANONICAL_KNOWLEDGE_ID.test(id) || UUID_ID.test(id) || id.startsWith("pkg:");
+}
+async function collectiveDrilldown(cloud, seedId, limit) {
+  try {
+    const res = await cloud.search({ stack: [], domains: [], kinds: [], seed: [seedId], limit });
+    if (res.nodes.length === 0) return null;
+    return {
+      seed: seedId,
+      nodes: res.nodes.map((n) => ({
+        id: n.id,
+        label: n.label,
+        name: n.description,
+        score: Number((n.extractionConfidence ?? 0.5).toFixed(4)),
+        hops: 1,
+        provenance: "collective"
+      })),
+      edges: res.edges.map((e) => ({ from: e.from, to: e.to, type: e.type }))
+    };
+  } catch (err2) {
+    console.error(
+      "[errata] collectiveDrilldown: cloud fallback failed \u2014",
+      err2 instanceof Error ? err2.message : err2
+    );
+    return null;
+  }
+}
 function formatDualNodes(merged) {
   return merged.nodes.map((n) => ({
     id: n.id,
@@ -25935,7 +25962,7 @@ function formatDualNodes(merged) {
     } : {}
   }));
 }
-var BRIDGE_LABELS;
+var BRIDGE_LABELS, CANONICAL_KNOWLEDGE_ID, UUID_ID;
 var init_dual_augment = __esm({
   "src/dual-augment.ts"() {
     "use strict";
@@ -25943,6 +25970,8 @@ var init_dual_augment = __esm({
     init_generalize_graph();
     init_dual_burst();
     BRIDGE_LABELS = new Set(SEMANTIC_NODE_LABELS);
+    CANONICAL_KNOWLEDGE_ID = /^[a-z][a-z0-9]*_[0-9a-f]{8,}$/;
+    UUID_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
   }
 });
 
@@ -36858,6 +36887,12 @@ function cosine3(a, b) {
   for (let i2 = 0; i2 < a.length; i2++) dot += a[i2] * b[i2];
   return dot;
 }
+async function collectiveSeedFallback(args2, ctx, defaultLimit) {
+  const seedId = typeof args2["nodeId"] === "string" ? args2["nodeId"] : null;
+  if (!seedId || !ctx.cloud || !hasCloudNodeShape(seedId)) return null;
+  const limit = Math.max(1, Math.min(100, Number(args2["limit"] ?? defaultLimit)));
+  return collectiveDrilldown(ctx.cloud, seedId, limit);
+}
 function resolveSymbol2(store, args2) {
   const id = args2["nodeId"];
   if (typeof id === "string" && store.getNode(id)) return id;
@@ -37208,7 +37243,7 @@ var init_mcp = __esm({
       },
       {
         name: "errata.neighbors",
-        description: "Return direct in/out edges of a node. Pass either a nodeId or a qname (e.g. ClassName.method) \u2014 resolved like the other nav verbs. Use after errata.search or errata.locate to walk the graph.",
+        description: "Return direct in/out edges of a node. Pass either a nodeId or a qname (e.g. ClassName.method) \u2014 resolved like the other nav verbs. Use after errata.search or errata.locate to walk the graph. A cloud id from search's collective blend (e.g. dprob_\u2026) that isn't in the local graph falls back to its collective neighborhood, tagged provenance:collective.",
         inputSchema: {
           type: "object",
           properties: {
@@ -37217,9 +37252,27 @@ var init_mcp = __esm({
             limit: { type: "number", description: "Max edges per direction (default 30)" }
           }
         },
-        handler: (args2, store) => {
+        handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
-          if (!id) return unresolved(args2);
+          if (!id) {
+            const cn = await collectiveSeedFallback(args2, ctx, 30);
+            if (cn) {
+              return {
+                found: true,
+                node: { id: cn.seed, provenance: "collective" },
+                collectiveReachable: true,
+                collectiveStatus: "cloud-seed",
+                // Seed-touching edge types aren't on the wire (the server's seed
+                // burst excludes the seed itself, and edges to nodes outside the
+                // result set are dropped), so the collective fallback reports the
+                // 1-hop neighborhood + its internal topology instead of the local
+                // contract's typed out/in lists.
+                nearby: cn.nodes,
+                edges: cn.edges
+              };
+            }
+            return unresolved(args2);
+          }
           const limit = Math.max(1, Math.min(200, Number(args2["limit"] ?? 30)));
           const node2 = store.getNode(id);
           if (!node2) return { found: false, reason: "not-found" };
@@ -37266,32 +37319,17 @@ var init_mcp = __esm({
         handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
           if (!id) {
-            const seedId = typeof args2["nodeId"] === "string" ? args2["nodeId"] : null;
-            if (seedId && ctx.cloud) {
-              const res = await ctx.cloud.search({
-                stack: [],
-                domains: [],
-                kinds: [],
-                seed: [seedId],
-                limit: args2["limit"] != null ? Number(args2["limit"]) : 20
-              }).catch(() => null);
-              if (res && res.nodes.length > 0) {
-                return {
-                  seed: seedId,
-                  seedProvenance: "collective",
-                  collectiveReachable: true,
-                  collectiveStatus: "cloud-seed",
-                  count: res.nodes.length,
-                  results: res.nodes.map((n) => ({
-                    id: n.id,
-                    label: n.label,
-                    name: n.description,
-                    score: Number((n.extractionConfidence ?? 0.5).toFixed(4)),
-                    hops: 1,
-                    provenance: "collective"
-                  }))
-                };
-              }
+            const cn = await collectiveSeedFallback(args2, ctx, 20);
+            if (cn) {
+              return {
+                seed: cn.seed,
+                seedProvenance: "collective",
+                collectiveReachable: true,
+                collectiveStatus: "cloud-seed",
+                count: cn.nodes.length,
+                results: cn.nodes,
+                edges: cn.edges
+              };
             }
             return unresolved(args2);
           }
@@ -37448,7 +37486,7 @@ var init_mcp = __esm({
       },
       {
         name: "errata.why",
-        description: "Causal/resolution neighborhood along the causal edge families (CAUSED_BY, MANIFESTS_AS, FIXED_BY, SOLVED_BY, \u2026), walked in both directions. For a Problem this surfaces its root causes AND solutions; for a Solution, the problems it resolves. Merges the machine-wide shared store's triage layer (cause chains from inline `<-` diagnoses land there, keyed by the same content-derived problem id). Ranked by accumulated conductance. Pass nodeId or qname. Returns {seedId, nodes:[{id,label,description,hops,edgeType,relevance}]}.",
+        description: "Causal/resolution neighborhood along the causal edge families (CAUSED_BY, MANIFESTS_AS, FIXED_BY, SOLVED_BY, \u2026), walked in both directions. For a Problem this surfaces its root causes AND solutions; for a Solution, the problems it resolves. Merges the machine-wide shared store's triage layer (cause chains from inline `<-` diagnoses land there, keyed by the same content-derived problem id). Ranked by accumulated conductance. Pass nodeId or qname. Returns {seedId, nodes:[{id,label,description,hops,edgeType,relevance}]}. A cloud id from search's collective blend (e.g. dprob_\u2026) that isn't in the local graph falls back to its collective causal neighborhood, tagged provenance:collective.",
         inputSchema: {
           type: "object",
           properties: {
@@ -37458,9 +37496,30 @@ var init_mcp = __esm({
             limit: { type: "number", description: "Default 30" }
           }
         },
-        handler: (args2, store) => {
+        handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
-          if (!id) return unresolved(args2);
+          if (!id) {
+            const cn = await collectiveSeedFallback(args2, ctx, 30);
+            if (cn) {
+              return {
+                found: true,
+                seedId: cn.seed,
+                seedProvenance: "collective",
+                collectiveReachable: true,
+                collectiveStatus: "cloud-seed",
+                nodes: cn.nodes.map((n) => ({
+                  id: n.id,
+                  label: n.label,
+                  description: n.name,
+                  hops: n.hops,
+                  relevance: n.score,
+                  provenance: n.provenance
+                })),
+                edges: cn.edges
+              };
+            }
+            return unresolved(args2);
+          }
           const maxHops = Math.max(1, Math.min(8, Number(args2["maxHops"] ?? 4)));
           const limit = Math.max(1, Math.min(100, Number(args2["limit"] ?? 30)));
           const local = causalChain(store, { seedId: id, direction: "both", maxHops, limit });
@@ -51936,7 +51995,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.2-dev.156" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.2-dev.157" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -57373,8 +57432,8 @@ async function cmdSimilar(args2) {
   const limitIdx = args2.indexOf("--limit");
   const limit = limitIdx >= 0 && args2[limitIdx + 1] ? Number(args2[limitIdx + 1]) : 5;
   const { runTool: runTool2 } = await Promise.resolve().then(() => (init_mcp(), mcp_exports));
-  await withStore((store) => {
-    const r = runTool2("errata.similar", { nodeId: seed, qname: seed, limit }, store);
+  await withStore(async (store) => {
+    const r = await runTool2("errata.similar", { nodeId: seed, qname: seed, limit }, store);
     if (!r.found) {
       console.log("seed not found");
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata-corporation/errata",
-  "version": "2.0.2-dev.156",
+  "version": "2.0.2-dev.157",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {