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

package/errata.mjs

@@ -19028,6 +19028,14 @@ var init_spectral = __esm({
   }
 });
 
+// ../../packages/math/src/community-health.ts
+var init_community_health = __esm({
+  "../../packages/math/src/community-health.ts"() {
+    "use strict";
+    init_spectral();
+  }
+});
+
 // ../../packages/math/src/void-demand.ts
 var DEMAND_HOT, DEMAND_WARM;
 var init_void_demand = __esm({
@@ -19285,6 +19293,7 @@ var init_src3 = __esm({
     init_relevance();
     init_leiden();
     init_spectral();
+    init_community_health();
     init_void_demand();
     init_motif_gate();
     init_bko();
@@ -27407,7 +27416,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 } : {}
         };
       }
       /**
@@ -27552,6 +27562,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);
       }
@@ -35098,28 +35117,97 @@ function hasCloudNodeShape(id) {
   return CANONICAL_KNOWLEDGE_ID.test(id) || UUID_ID.test(id) || id.startsWith("pkg:");
 }
 async function collectiveDrilldown(cloud, seedId, limit) {
+  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 });
   } 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"];
+        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)) } : {},
+          hops: 1,
+          provenance: "collective"
+        };
+      }),
+      edges: res.edges.map((e) => ({ from: e.from, to: e.to, type: e.type }))
+    }
+  };
+}
+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,
+      resolvedBy: row.resolvedBy,
+      causalChain: row.causalChain ?? [],
+      related: row.related
+    }
+  };
 }
 function formatDualNodes(merged) {
   return merged.nodes.map((n) => ({
@@ -44411,6 +44499,22 @@ async function collectiveSeedFallback(args2, ctx, defaultLimit) {
   const limit = Math.max(1, Math.min(100, Number(args2["limit"] ?? defaultLimit)));
   return collectiveDrilldown(ctx.cloud, seedId, limit);
 }
+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"];
   if (typeof id === "string" && store.getNode(id)) return id;
@@ -44761,13 +44865,14 @@ 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
@@ -44777,7 +44882,7 @@ var init_mcp = __esm({
                 edges: cn.edges
               };
             }
-            return unresolved(args2);
+            return collectiveSeedMiss(args2, cs);
           }
           const limit = Math.max(1, Math.min(200, Number(args2["limit"] ?? 30)));
           const node2 = store.getNode(id);
@@ -44825,19 +44930,21 @@ var init_mcp = __esm({
         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);
+            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
               };
             }
-            return unresolved(args2);
+            return collectiveSeedMiss(args2, cs);
           }
           const seedForBurst = store.getNode(id);
           if (seedForBurst && seedForBurst.embedding.length === 0) {
@@ -45007,14 +45114,15 @@ 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,
@@ -45026,7 +45134,7 @@ var init_mcp = __esm({
                 edges: cn.edges
               };
             }
-            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)));
@@ -45390,7 +45498,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: {
@@ -45400,9 +45508,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)));
@@ -83004,7 +83124,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.21-dev.3861" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.21-dev.3896" : "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.3861",
+  "version": "2.0.21-dev.3896",
   "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.3861",
+  "version": "2.0.21-dev.3896",
   "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 @@
-bbf0a0c46b3970acd362dc1334f295797bf392b40aebbba35aaeb90e305f1d49  .codex-plugin/plugin.json
+318e19fc332a3ee22b8c6f8318ee7c7c82b37b03b0624fee47dcabbdee5ddaa9  .codex-plugin/plugin.json
 a7bebae9fb01c838d6c75fc784129e28be571233fa66ff5ee8039b574f35ccf7  assets/icon.png
 fc38b64e4df1e0b72c35764bef6c4c05430d97c9009ad0ecc8a9e75b4deab232  configure-local.mjs
 73dc6028b3b070257c7c31f252d11e55a9e096f4aed0f187f10cb21716e1e6d7  dist/client.js