@inerrata-corporation/errata 2.0.21-dev.3896 → 2.0.21-dev.3918

package/errata.mjs

@@ -26722,6 +26722,30 @@ function sidecarForNodes(sidecar, nodes) {
   }
   return count > 0 ? filtered : void 0;
 }
+function wireVia(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const v = value;
+  const { edgeType, parentId, forward } = v;
+  if (typeof edgeType !== "string" || !edgeType || typeof parentId !== "string" || !parentId) return null;
+  if (typeof forward !== "boolean") return null;
+  return { edgeType, parentId, forward };
+}
+function searchVia(nodes) {
+  const out2 = {};
+  let any2 = false;
+  for (const n of nodes) {
+    const via = wireVia(n.attrs?.["via"]);
+    if (!via || out2[n.canonicalId]) continue;
+    out2[n.canonicalId] = via;
+    any2 = true;
+  }
+  return any2 ? out2 : void 0;
+}
+function withoutVia(attrs) {
+  if (!("via" in attrs)) return attrs;
+  const { via: _via, ...rest2 } = attrs;
+  return rest2;
+}
 function toWirePayload(batch, runId) {
   const droppedNodeIds = new Set(
     batch.nodes.filter((n) => !isCloudWritableNodeLabel(n.label)).map((n) => n.id)
@@ -27398,6 +27422,10 @@ var init_client = __esm({
         if (q.q) qs.set("q", q.q);
         if (q.channel) qs.set("channel", q.channel);
         if (q.includeTriage) qs.set("includeTriage", "true");
+        if (q.scope) qs.set("scope", q.scope);
+        if (q.community) qs.set("community", "true");
+        if (q.bridges) qs.set("bridges", "true");
+        if (q.via) qs.set("via", "true");
         const publicCtx = process.env["ERRATA_PRIMING_PUBLIC_CONTEXT"];
         const usePublicCtx = Boolean(publicCtx && publicCtx !== "0" && q.channel === "priming");
         const UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -27412,10 +27440,12 @@ var init_client = __esm({
           } : void 0
         );
         const { nodes, edges } = this.toCastalia(res);
+        const via = searchVia(res.nodes);
         return {
           nodes,
           edges,
           generatedAt: res.generatedAt,
+          ...via ? { via } : {},
           ...res.voidSignal ? { voidSignal: res.voidSignal } : {},
           ...res.seeds ? { seeds: res.seeds } : {}
         };
@@ -27445,7 +27475,7 @@ var init_client = __esm({
           isLandmark: false,
           community: null,
           stability: "stable",
-          attrs: { ...localCloudAttrs(n.attrs), source: "cloud", cloudNodeId: n.nodeId }
+          attrs: { ...withoutVia(localCloudAttrs(n.attrs)), source: "cloud", cloudNodeId: n.nodeId }
         }));
         const edges = res.edges.map((e) => ({
           id: digest({ from: e.fromCanonicalId, type: e.type, to: e.toCanonicalId }),
@@ -34969,6 +34999,7 @@ function mergeDualBurst(local, cloud, opts = {}) {
       provenance: corroborated ? "corroborated" : "local",
       ...twin?.usageCount != null ? { usageCount: twin.usageCount } : {},
       ...twin?.rel ? { rel: twin.rel } : {},
+      ...twin?.community ? { community: twin.community } : {},
       why: l.components,
       ...l.via ? { via: l.via } : {}
     });
@@ -34986,7 +35017,9 @@ function mergeDualBurst(local, cloud, opts = {}) {
       // adapters surface 1-hop neighbors of the seed
       provenance: "collective",
       ...c.usageCount != null ? { usageCount: c.usageCount } : {},
-      ...c.rel ? { rel: c.rel } : {}
+      ...c.rel ? { rel: c.rel } : {},
+      ...c.community ? { community: c.community } : {},
+      ...c.via ? { via: c.via } : {}
     });
   }
   nodes.sort((a, b) => b.score - a.score);
@@ -35023,12 +35056,17 @@ function searchResultToCloudHits(result) {
     const usage = node2.attrs?.["usageCount"];
     const s = scores[i2];
     const cloudScore = !Number.isNaN(s) && maxScore > 0 ? s / maxScore : n > 0 ? (n - i2) / n : 0;
+    const communityId = node2.attrs?.["community"];
+    const communityLabel = node2.attrs?.["communityLabel"];
+    const via = result.via?.[node2.id];
     return {
       id: node2.id,
       label: node2.label,
       description: node2.description,
       cloudScore,
-      ...typeof usage === "number" ? { usageCount: usage } : {}
+      ...typeof usage === "number" ? { usageCount: usage } : {},
+      ...typeof communityId === "number" ? { community: { id: communityId, label: typeof communityLabel === "string" ? communityLabel : null } } : {},
+      ...via ? { via } : {}
     };
   });
 }
@@ -35075,7 +35113,7 @@ async function dualAugment(opts) {
     }
     if (hardIds.length > 0 || softQ) {
       calls.push(
-        cloud.search({ stack: [], domains: [], kinds: [], seed: hardIds, ...softQ ? { q: softQ } : {}, limit }).then((res) => {
+        cloud.search({ stack: [], domains: [], kinds: [], seed: hardIds, ...softQ ? { q: softQ } : {}, limit, community: true, via: true }).then((res) => {
           cloudHits.push(...searchResultToCloudHits(res));
         })
       );
@@ -35116,10 +35154,29 @@ function federationHint(status) {
 function hasCloudNodeShape(id) {
   return CANONICAL_KNOWLEDGE_ID.test(id) || UUID_ID.test(id) || id.startsWith("pkg:");
 }
-async function collectiveDrilldown(cloud, seedId, limit) {
+function attrsCommunity(attrs) {
+  const id = attrs?.["community"];
+  if (typeof id !== "number") return void 0;
+  const label = attrs?.["communityLabel"];
+  return { id, label: typeof label === "string" ? label : null };
+}
+function walkerCommunity(c) {
+  return c ? { id: c.communityId, label: c.label } : null;
+}
+async function collectiveDrilldown(cloud, seedId, limit, opts = {}) {
   let res;
   try {
-    res = await cloud.search({ stack: [], domains: [], kinds: [], seed: [seedId], limit });
+    res = await cloud.search({
+      stack: [],
+      domains: [],
+      kinds: [],
+      seed: [seedId],
+      limit,
+      community: true,
+      via: true,
+      ...opts.bridges ? { bridges: true } : {},
+      ...opts.scope ? { scope: opts.scope } : {}
+    });
   } catch (err2) {
     if (isQuotaError(err2)) {
       console.warn("[errata] collectiveDrilldown: collective read QUOTA EXCEEDED \u2014 the id's existence is unknown, not refuted.");
@@ -35144,17 +35201,23 @@ async function collectiveDrilldown(cloud, seedId, limit) {
       nodes: res.nodes.map((n) => {
         const score2 = n.attrs["score"];
         const uncertainty = n.attrs["uncertainty"];
+        const community = attrsCommunity(n.attrs);
+        const via = res.via?.[n.id];
         return {
           id: n.id,
           label: n.label,
           name: n.description,
           ...typeof score2 === "number" ? { score: Number(score2.toFixed(4)) } : {},
           ...typeof uncertainty === "number" ? { uncertainty: Number(uncertainty.toFixed(4)) } : {},
+          ...community ? { community } : {},
           hops: 1,
-          provenance: "collective"
+          provenance: "collective",
+          ...via ? { via } : {}
         };
       }),
-      edges: res.edges.map((e) => ({ from: e.from, to: e.to, type: e.type }))
+      edges: res.edges.map((e) => ({ from: e.from, to: e.to, type: e.type })),
+      ...seedEntry && "community" in seedEntry ? { seedCommunity: walkerCommunity(seedEntry.community) } : {},
+      ...seedEntry?.bridges ? { bridges: seedEntry.bridges } : {}
     }
   };
 }
@@ -35203,6 +35266,7 @@ async function collectiveNodeDetail(cloud, id) {
       createdAtMs: row.createdAtMs,
       lastValidatedAtMs: row.lastValidatedAtMs,
       visibility: row.visibility,
+      ...row.community !== void 0 ? { community: walkerCommunity(row.community) } : {},
       resolvedBy: row.resolvedBy,
       causalChain: row.causalChain ?? [],
       related: row.related
@@ -35219,6 +35283,7 @@ function formatDualNodes(merged) {
     provenance: n.provenance,
     ...n.usageCount != null ? { usageCount: n.usageCount } : {},
     ...n.rel ? { rel: n.rel } : {},
+    ...n.community ? { community: n.community } : {},
     ...n.why ? {
       why: {
         semantic: Number(n.why.semantic.toFixed(3)),
@@ -44493,11 +44558,21 @@ 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) {
+async function collectiveSeedFallback(args2, ctx, defaultLimit, opts = {}) {
   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);
+  const scope = args2["scope"];
+  return collectiveDrilldown(ctx.cloud, seedId, limit, {
+    ...opts.allowScope && (scope === "community" || scope === "neighborhood" || scope === "global") ? { scope } : {},
+    ...opts.allowBridges && args2["bridges"] === true ? { bridges: true } : {}
+  });
+}
+function collectiveCommunityFields(cn) {
+  return {
+    ...cn.seedCommunity !== void 0 ? { seedCommunity: cn.seedCommunity } : {},
+    ...cn.bridges ? { bridges: cn.bridges } : {}
+  };
 }
 function collectiveSeedStatus(cn) {
   return cn.nodes.length > 0 ? "cloud-seed" : "cloud-seed-empty";
@@ -44873,13 +44948,13 @@ var init_mcp = __esm({
                 node: { id: cn.seed, provenance: "collective" },
                 collectiveReachable: true,
                 collectiveStatus: collectiveSeedStatus(cn),
-                // 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.
+                // The collective fallback reports the 1-hop neighborhood + its
+                // internal topology instead of the local contract's typed out/in
+                // lists; the seed-touching edge rides on each node's `via` (the
+                // server's seed burst excludes the seed itself, so `edges` can't).
                 nearby: cn.nodes,
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
             return collectiveSeedMiss(args2, cs);
@@ -44917,20 +44992,29 @@ var init_mcp = __esm({
       },
       {
         name: "errata.burst",
-        description: "Burst-grade local retrieval \u2014 the INTELLIGENT, seed-relative neighborhood (not a flat list). Given a SEED (`nodeId` or `qname`), expand its neighborhood and return the RELEVANT scored subset, ranked by burst-style relevance: semantic similarity to the seed \xD7 centrality \xD7 trust, hop-decayed; semantically-unrelated nodes are gated out. Prefer this over errata.neighbors when you want signal-ranked CONTEXT rather than raw edges. When the SEED is a package and the collective is reachable, results BLEND cross-project knowledge \u2014 each carries `provenance` (local | collective | corroborated) and `usageCount` (projects using it); `corroborated` means your graph and the collective agree (trust it most), `collective` is a cross-project prior to verify. Returns {seed, count, results:[{id,label,name,score,hops,provenance,usageCount?,why?,via?}]} \u2014 `via` is the TOPOLOGY: the edge that reached this result in the walk ({edgeType, parentId, forward}; forward: true \u21D2 parent \u2014edgeType\u2192 node), so you can tell 'FIXED_BY your seed' from 'two hops away via a shared package' and choose whether to dig down a causal chain or turn elsewhere.",
+        description: "Burst-grade local retrieval \u2014 the INTELLIGENT, seed-relative neighborhood (not a flat list). Given a SEED (`nodeId` or `qname`), expand its neighborhood and return the RELEVANT scored subset, ranked by burst-style relevance: semantic similarity to the seed \xD7 centrality \xD7 trust, hop-decayed; semantically-unrelated nodes are gated out. Prefer this over errata.neighbors when you want signal-ranked CONTEXT rather than raw edges. When the SEED is a package and the collective is reachable, results BLEND cross-project knowledge \u2014 each carries `provenance` (local | collective | corroborated) and `usageCount` (projects using it); `corroborated` means your graph and the collective agree (trust it most), `collective` is a cross-project prior to verify. Returns {seed, count, results:[{id,label,name,score,hops,provenance,usageCount?,why?,via?}]} \u2014 `via` is the TOPOLOGY: the edge that reached this result in the walk ({edgeType, parentId, forward}; forward: true \u21D2 parent \u2014edgeType\u2192 node), so you can tell 'FIXED_BY your seed' from 'two hops away via a shared package' and choose whether to dig down a causal chain or turn elsewhere. A COLLECTIVE seed (a cloud id not in your graph) also reports `seedCommunity` {id,label} and each result's `community`; ids are tonight's partition (renumbered nightly \u2014 compare within one walk, never store). Pass `scope` to stay in / leave the seed's community and `bridges:true` for the bordering communities and their crossing edges.",
         inputSchema: {
           type: "object",
           properties: {
             nodeId: { type: "string" },
             qname: { type: "string", description: "Symbol qname (resolved to a node)." },
             maxHops: { type: "number", description: "Neighborhood radius (default 2)." },
-            limit: { type: "number", description: "Max results (default 20)." }
+            limit: { type: "number", description: "Max results (default 20)." },
+            scope: {
+              type: "string",
+              enum: ["community", "neighborhood", "global"],
+              description: "Collective seeds only: `community` keeps only the seed's community, `global` ranks cross-community neighbours on par; default `neighborhood`."
+            },
+            bridges: {
+              type: "boolean",
+              description: "Collective seeds only: also return `bridges` \u2014 the communities bordering the seed's, each with its strongest crossing edges (where to go next)."
+            }
           }
         },
         handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
           if (!id) {
-            const cs = await collectiveSeedFallback(args2, ctx, 20);
+            const cs = await collectiveSeedFallback(args2, ctx, 20, { allowScope: true, allowBridges: true });
             if (cs?.status === "resolved") {
               const cn = cs.neighborhood;
               return {
@@ -44941,7 +45025,8 @@ var init_mcp = __esm({
                 collectiveStatus: collectiveSeedStatus(cn),
                 count: cn.nodes.length,
                 results: cn.nodes,
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
             return collectiveSeedMiss(args2, cs);
@@ -45129,9 +45214,12 @@ var init_mcp = __esm({
                   description: n.name,
                   hops: n.hops,
                   relevance: n.score,
-                  provenance: n.provenance
+                  provenance: n.provenance,
+                  ...n.community ? { community: n.community } : {},
+                  ...n.via ? { via: n.via } : {}
                 })),
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
             return collectiveSeedMiss(args2, cs);
@@ -83124,7 +83212,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.21-dev.3896" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.21-dev.3918" : "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;

package/package.json

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

package/resources/context-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "errata-context",
-  "version": "2.0.21-dev.3896",
+  "version": "2.0.21-dev.3918",
   "description": "A minimal 3D view of loaded Errata priors and recent graph bursts.",
   "author": {
     "name": "inErrata"

package/resources/context-plugin/SHA256SUMS

@@ -1,4 +1,4 @@
-318e19fc332a3ee22b8c6f8318ee7c7c82b37b03b0624fee47dcabbdee5ddaa9  .codex-plugin/plugin.json
+b107a94e4e9828c1c6f57f4acb3e914b4e2ed683a0c75446defb85835e5010ce  .codex-plugin/plugin.json
 a7bebae9fb01c838d6c75fc784129e28be571233fa66ff5ee8039b574f35ccf7  assets/icon.png
 fc38b64e4df1e0b72c35764bef6c4c05430d97c9009ad0ecc8a9e75b4deab232  configure-local.mjs
 73dc6028b3b070257c7c31f252d11e55a9e096f4aed0f187f10cb21716e1e6d7  dist/client.js