@inerrata-corporation/errata 2.0.21-dev.3863 → 2.0.21-dev.3904

package/errata.mjs

@@ -27398,6 +27398,9 @@ 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");
         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;
@@ -27416,7 +27419,8 @@ var init_client = __esm({
           nodes,
           edges,
           generatedAt: res.generatedAt,
-          ...res.voidSignal ? { voidSignal: res.voidSignal } : {}
+          ...res.voidSignal ? { voidSignal: res.voidSignal } : {},
+          ...res.seeds ? { seeds: res.seeds } : {}
         };
       }
       /**
@@ -27561,6 +27565,15 @@ var init_client = __esm({
           throw err2;
         }
       }
+      /** One graph node's detail — label, full description, evidence counters,
+       *  §5.4 posterior and causal neighbours in both directions — via the
+       *  inspector read of `GET /v2/nodes` (keys on the graph node id, not the
+       *  canonicalId). Null when the node is absent or outside the caller's scope. */
+      async getNode(nodeId) {
+        const qs = new URLSearchParams({ ids: nodeId, withRelated: "true", limit: "1" });
+        const res = await this.json("GET", `/v2/nodes?${qs.toString()}`);
+        return res.rows.find((r) => r.id === nodeId) ?? null;
+      }
       async sendTelemetry(batch) {
         return this.json("POST", "/v2/telemetry", batch);
       }
@@ -34959,6 +34972,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 } : {}
     });
@@ -34976,7 +34990,8 @@ 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 } : {}
     });
   }
   nodes.sort((a, b) => b.score - a.score);
@@ -35013,12 +35028,15 @@ 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"];
     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 } } : {}
     };
   });
 }
@@ -35065,7 +35083,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 }).then((res) => {
           cloudHits.push(...searchResultToCloudHits(res));
         })
       );
@@ -35106,29 +35124,121 @@ 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 {
-    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 }))
-    };
+    res = await cloud.search({
+      stack: [],
+      domains: [],
+      kinds: [],
+      seed: [seedId],
+      limit,
+      community: 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.");
+      return { status: "quota" };
+    }
     console.error(
       "[errata] collectiveDrilldown: cloud fallback failed \u2014",
       err2 instanceof Error ? err2.message : err2
     );
-    return null;
+    return { status: "offline" };
+  }
+  const seedEntry = res.seeds?.find((s) => s.seed === seedId);
+  const resolution = seedEntry?.status;
+  if (resolution === "unresolved") return { status: "no-twin" };
+  if (resolution === "error") return { status: "seed-error" };
+  if (res.nodes.length === 0 && resolution !== "resolved") return { status: "no-twin" };
+  return {
+    status: "resolved",
+    neighborhood: {
+      seed: seedId,
+      ...seedEntry?.nodeId ? { nodeId: seedEntry.nodeId } : {},
+      nodes: res.nodes.map((n) => {
+        const score2 = n.attrs["score"];
+        const uncertainty = n.attrs["uncertainty"];
+        const community = attrsCommunity(n.attrs);
+        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"
+        };
+      }),
+      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 } : {}
+    }
+  };
+}
+async function collectiveNodeDetail(cloud, id) {
+  const read2 = async (nodeId) => {
+    try {
+      return await cloud.getNode(nodeId);
+    } catch (err2) {
+      if (isQuotaError(err2)) return "quota";
+      console.error("[errata] collectiveNodeDetail: node read failed \u2014", err2 instanceof Error ? err2.message : err2);
+      return "offline";
+    }
+  };
+  let row = await read2(id);
+  if (row === "quota" || row === "offline") return { status: row };
+  if (!row) {
+    const drill = await collectiveDrilldown(cloud, id, 1);
+    if (drill.status !== "resolved") return drill;
+    const nodeId = drill.neighborhood.nodeId;
+    if (nodeId && nodeId !== id) {
+      row = await read2(nodeId);
+      if (row === "quota" || row === "offline") return { status: row };
+    }
+    if (!row) return { status: "found", node: null };
   }
+  return {
+    status: "found",
+    node: {
+      id,
+      nodeId: row.id,
+      label: row.label,
+      description: row.description,
+      evidence: {
+        validated: row.validated,
+        acceptedCount: row.accepted,
+        corroborationCount: row.corroborations,
+        failureReportCount: row.refutes,
+        effectivenessScore: row.effectivenessScore ?? null,
+        uncertainty: row.uncertainty?.value ?? null,
+        priorStrength: row.uncertainty?.priorStrength ?? null,
+        trustTier: row.trustTier ?? null
+      },
+      memoryTier: row.memoryTier,
+      reinforcementCount: row.reinforced,
+      hits: row.hits,
+      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
+    }
+  };
 }
 function formatDualNodes(merged) {
   return merged.nodes.map((n) => ({
@@ -35140,6 +35250,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)),
@@ -44414,11 +44525,37 @@ 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";
+}
+function collectiveSeedMiss(args2, outcome) {
+  if (!outcome || outcome.status === "no-twin" || outcome.status === "resolved") return unresolved(args2);
+  const { query } = unresolved(args2);
+  const hint = outcome.status === "seed-error" ? "collective reached, but this id's lookup failed server-side \u2014 its existence is unknown; retry" : federationHint(outcome.status);
+  return {
+    found: false,
+    reason: "collective-unreachable",
+    query,
+    collectiveReachable: outcome.status === "seed-error",
+    collectiveStatus: outcome.status === "seed-error" ? "cloud-seed-error" : outcome.status,
+    ...hint ? { collectiveHint: hint } : {}
+  };
 }
 function resolveSymbol2(store, args2) {
   const id = args2["nodeId"];
@@ -44770,23 +44907,25 @@ var init_mcp = __esm({
         handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
           if (!id) {
-            const cn = await collectiveSeedFallback(args2, ctx, 30);
-            if (cn) {
+            const cs = await collectiveSeedFallback(args2, ctx, 30);
+            if (cs?.status === "resolved") {
+              const cn = cs.neighborhood;
               return {
                 found: true,
                 node: { id: cn.seed, provenance: "collective" },
                 collectiveReachable: true,
-                collectiveStatus: "cloud-seed",
+                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.
                 nearby: cn.nodes,
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
-            return unresolved(args2);
+            return collectiveSeedMiss(args2, cs);
           }
           const limit = Math.max(1, Math.min(200, Number(args2["limit"] ?? 30)));
           const node2 = store.getNode(id);
@@ -44821,32 +44960,44 @@ 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 cn = await collectiveSeedFallback(args2, ctx, 20);
-            if (cn) {
+            const cs = await collectiveSeedFallback(args2, ctx, 20, { allowScope: true, allowBridges: true });
+            if (cs?.status === "resolved") {
+              const cn = cs.neighborhood;
               return {
+                found: true,
                 seed: cn.seed,
                 seedProvenance: "collective",
                 collectiveReachable: true,
-                collectiveStatus: "cloud-seed",
+                collectiveStatus: collectiveSeedStatus(cn),
                 count: cn.nodes.length,
                 results: cn.nodes,
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
-            return unresolved(args2);
+            return collectiveSeedMiss(args2, cs);
           }
           const seedForBurst = store.getNode(id);
           if (seedForBurst && seedForBurst.embedding.length === 0) {
@@ -45016,26 +45167,29 @@ var init_mcp = __esm({
         handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
           if (!id) {
-            const cn = await collectiveSeedFallback(args2, ctx, 30);
-            if (cn) {
+            const cs = await collectiveSeedFallback(args2, ctx, 30);
+            if (cs?.status === "resolved") {
+              const cn = cs.neighborhood;
               return {
                 found: true,
                 seedId: cn.seed,
                 seedProvenance: "collective",
                 collectiveReachable: true,
-                collectiveStatus: "cloud-seed",
+                collectiveStatus: collectiveSeedStatus(cn),
                 nodes: cn.nodes.map((n) => ({
                   id: n.id,
                   label: n.label,
                   description: n.name,
                   hops: n.hops,
                   relevance: n.score,
-                  provenance: n.provenance
+                  provenance: n.provenance,
+                  ...n.community ? { community: n.community } : {}
                 })),
-                edges: cn.edges
+                edges: cn.edges,
+                ...collectiveCommunityFields(cn)
               };
             }
-            return unresolved(args2);
+            return collectiveSeedMiss(args2, cs);
           }
           const maxHops = Math.max(1, Math.min(8, Number(args2["maxHops"] ?? 4)));
           const limit = Math.max(1, Math.min(100, Number(args2["limit"] ?? 30)));
@@ -45399,7 +45553,7 @@ var init_mcp = __esm({
       },
       {
         name: "errata.show",
-        description: "Print the source code for a node. Uses bodyStartByte/endByte if the node has them (Function/Method/Class), else falls back to startByte/endByte (Const/Comment). File nodes return the whole file content. Returns {found, path, signature, calls (in source order), startLine, endLine, source}.",
+        description: "Print the source code for a node. Uses bodyStartByte/endByte if the node has them (Function/Method/Class), else falls back to startByte/endByte (Const/Comment). File nodes return the whole file content. Returns {found, path, signature, calls (in source order), startLine, endLine, source}. A cloud id from search's collective blend (e.g. projn_\u2026, dprob_\u2026) that isn't in the local graph returns the collective node's own record instead: {found, provenance:'collective', node:{label, description, evidence:{validated, acceptedCount, corroborationCount, failureReportCount, effectivenessScore, uncertainty, priorStrength, trustTier}, causalChain, related (causal neighbours, both directions)}}.",
         inputSchema: {
           type: "object",
           properties: {
@@ -45409,9 +45563,21 @@ var init_mcp = __esm({
             maxLines: { type: "number" }
           }
         },
-        handler: (args2, store) => {
+        handler: async (args2, store, ctx) => {
           const id = resolveSymbol2(store, args2);
-          if (!id) return unresolved(args2);
+          if (!id) {
+            const seedId = typeof args2["nodeId"] === "string" ? args2["nodeId"] : null;
+            if (!seedId || !ctx.cloud || !hasCloudNodeShape(seedId)) return unresolved(args2);
+            const shown = await collectiveNodeDetail(ctx.cloud, seedId);
+            if (shown.status !== "found") return collectiveSeedMiss(args2, shown);
+            return {
+              found: true,
+              provenance: "collective",
+              collectiveReachable: true,
+              collectiveStatus: shown.node ? "cloud-node" : "cloud-node-no-detail",
+              ...shown.node ? { node: shown.node } : { node: { id: seedId } }
+            };
+          }
           const node2 = store.getNode(id);
           if (!node2) return { found: false, reason: "not-found" };
           const maxLines = Math.max(10, Math.min(2e3, Number(args2["maxLines"] ?? 200)));
@@ -83013,7 +83179,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.21-dev.3863" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.21-dev.3904" : "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.3863",
+  "version": "2.0.21-dev.3904",
   "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.3863",
+  "version": "2.0.21-dev.3904",
   "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 @@
-d2b8238acf66ab6c4bb1cfb326376ef90018fc2e3ebe8c4a3dabdfff67135669  .codex-plugin/plugin.json
+80437cb509261f3ab983d93240320f8ef99241c2b0709ccca75d3052035b27a7  .codex-plugin/plugin.json
 a7bebae9fb01c838d6c75fc784129e28be571233fa66ff5ee8039b574f35ccf7  assets/icon.png
 fc38b64e4df1e0b72c35764bef6c4c05430d97c9009ad0ecc8a9e75b4deab232  configure-local.mjs
 73dc6028b3b070257c7c31f252d11e55a9e096f4aed0f187f10cb21716e1e6d7  dist/client.js