@inerrata-corporation/errata 2.0.2-dev.704 → 2.0.2-dev.714

package/errata.mjs

@@ -15447,6 +15447,15 @@ function extractIdentifierTokens(text) {
   }
   return out2;
 }
+function sidecarDropBucket(reason) {
+  if (reason === null) return null;
+  if (reason === "empty summary") return "empty";
+  if (reason === "summary too long") return "too_long";
+  if (reason === "contains a path shape") return "path_shape";
+  if (reason === "contains a quoted literal") return "quoted_literal";
+  if (reason.startsWith("contains verbatim identifier")) return "verbatim_identifier";
+  return "other";
+}
 function summaryRejectionReason(summary, isKnownToken) {
   if (!summary.trim()) return "empty summary";
   if (summary.length > MAX_SYMBOL_SUMMARY_CHARS) return "summary too long";
@@ -16062,6 +16071,7 @@ __export(src_exports, {
   retrievalTokens: () => retrievalTokens,
   sha256: () => sha256,
   sha256Short: () => sha256Short,
+  sidecarDropBucket: () => sidecarDropBucket,
   splitPnpmKey: () => splitPnpmKey,
   substituteSymbolSummaries: () => substituteSymbolSummaries,
   summarizeIngestResult: () => summarizeIngestResult,
@@ -22299,6 +22309,25 @@ var init_mechanism_liveness = __esm({
         },
         effectCounter: "shown"
       },
+      {
+        id: "contribution-ship",
+        what: "carries local knowledge across the membrane to the cloud, and records the door's verdict",
+        pass: "ship",
+        // FED = nodes that have actually crossed. `contributedAtSeq` is stamped
+        // only after the door accepts, so a fed reading is proof the whole chain
+        // (build → generalize → drain → accept) ran, not merely that a timer fired.
+        // The instance lane sat DEAD for 13 days behind a 422 nobody surfaced —
+        // this row is the instrument that would have caught it on day one.
+        fed: {
+          labels: ["Problem", "Solution", "RootCause"],
+          attr: "contributedAtSeq",
+          minFraction: 0.01
+        },
+        effectCounter: "accepted",
+        // Rising = knowledge piling up locally that never crossed. A backlog that
+        // climbs while `accepted` stays flat is the shape of a silently-closed door.
+        backlogCounter: "candidates"
+      },
       {
         id: "orphan-reap",
         what: "closes File nodes whose path the indexer no longer covers",
@@ -55532,7 +55561,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.2-dev.704" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.2-dev.714" : "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;
@@ -57915,6 +57944,21 @@ function stripCodebaseScope(scope) {
   delete s["codebase"];
   return s;
 }
+function compositionCounters(c) {
+  const { sidecarDropReasons, ...scalars } = c;
+  const buckets = [
+    "empty",
+    "too_long",
+    "path_shape",
+    "quoted_literal",
+    "verbatim_identifier",
+    "other"
+  ];
+  return {
+    ...scalars,
+    ...Object.fromEntries(buckets.map((b) => [`sidecarDrop_${b}`, sidecarDropReasons[b] ?? 0]))
+  };
+}
 function contributedWireId(n) {
   const cloudId = n.attrs["cloudNodeId"];
   return isMembraneSaltedId(cloudId) ? cloudId : n.id;
@@ -57986,7 +58030,9 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
   const shareable = (n) => {
     const preserved = symbolIndex ? preservedSymbolsFor(n.description, symbolIndex) : [];
     const fileScrubbed = generalizeFileRefs(n.description, fileLexicon, level);
-    const shippedText = generalize(fileScrubbed, { level, project: projectIdentity }).text;
+    const generalized = generalize(fileScrubbed, { level, project: projectIdentity });
+    const shippedText = generalized.text;
+    if (generalized.report.classes.length > 0) composition.privacyRewritten++;
     const internalSyms = internalSymbolsFor(shippedText, (t) => ownLexicon.has(t), symbolIndex);
     const internalFiles = internalFilesFor(shippedText, fileLexicon);
     const internal = [.../* @__PURE__ */ new Set([...internalFiles, ...internalSyms])].slice(
@@ -58013,26 +58059,60 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
   const anchorSources = /* @__PURE__ */ new Set();
   const semanticEndpoints = /* @__PURE__ */ new Map();
   const includedByLabel = /* @__PURE__ */ new Map();
+  const composition = {
+    candidates: 0,
+    shipped: 0,
+    cloudSourced: 0,
+    falsePositive: 0,
+    ignored: 0,
+    watermarked: 0,
+    autoMint: 0,
+    notNovel: 0,
+    unshippable: 0,
+    heldOrphans: 0,
+    privacyRewritten: 0,
+    sidecarDropped: 0,
+    sidecarDropReasons: {},
+    sidecarTruncatedAtCap: 0
+  };
   for (const label of INSTANCE_LABELS) {
     const ref = [];
     includedByLabel.set(label, ref);
     const population = label === "RootCause" && opts.sharedStore ? [...store.findNodesByLabel(label), ...opts.sharedStore.findNodesByLabel(label)] : store.findNodesByLabel(label);
     for (const n of population) {
       if (seen.has(n.id)) continue;
-      if (n.attrs["source"] === "cloud") continue;
-      if (label === "Problem" && n.attrs["resolvedAs"] === PROBLEM_RESOLUTION.FALSE_POSITIVE) continue;
-      if (ignored(n.description)) continue;
+      composition.candidates++;
+      if (n.attrs["source"] === "cloud") {
+        composition.cloudSourced++;
+        continue;
+      }
+      if (label === "Problem" && n.attrs["resolvedAs"] === PROBLEM_RESOLUTION.FALSE_POSITIVE) {
+        composition.falsePositive++;
+        continue;
+      }
+      if (ignored(n.description)) {
+        composition.ignored++;
+        continue;
+      }
       const contributedAtSeq = n.attrs["contributedAtSeq"];
       if (typeof contributedAtSeq === "number" && (n.lastReinforcedAtSeq ?? 0) <= contributedAtSeq) {
+        composition.watermarked++;
         anchorSources.add(n.id);
         semanticEndpoints.set(n.id, contributedWireId(n));
         continue;
       }
-      if (label === "Solution" && n.description.startsWith(AUTO_MINT_PREFIX)) continue;
-      if (!noveltyAgainst(n, ref, noveltyOpts).ready) continue;
+      if (label === "Solution" && n.description.startsWith(AUTO_MINT_PREFIX)) {
+        composition.autoMint++;
+        continue;
+      }
+      if (!noveltyAgainst(n, ref, noveltyOpts).ready) {
+        composition.notNovel++;
+        continue;
+      }
       const reject = unshippableReason(n.id, n.label);
       if (reject) {
         console.warn(`[errata] skipping unshippable node ${n.id} (${n.label}): ${reject}`);
+        composition.unshippable++;
         continue;
       }
       ref.push(n);
@@ -58169,7 +58249,10 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
       edges.push({ ...e, from: wireFrom, to: wireTo, attrs: {} });
     }
   }
-  if (nodes.length === 0 && anchorEdges.length === 0 && edges.length === 0) return null;
+  if (nodes.length === 0 && anchorEdges.length === 0 && edges.length === 0) {
+    opts.onComposition?.(composition);
+    return null;
+  }
   let symbolSummaries;
   if (opts.lexicon && opts.lexicon.size > 0 && nodes.length > 0) {
     const lexicon = opts.lexicon;
@@ -58183,8 +58266,16 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
         const entry = lexicon.get(tok);
         if (!entry?.summary) continue;
         const scrubbed = generalize(entry.summary, { level, project: projectIdentity }).text.trim();
-        if (!scrubbed || summaryRejectionReason(scrubbed, isKnown) !== null) continue;
-        if (count >= MAX_SIDECAR_SYMBOLS) break outer;
+        const dropBucket = !scrubbed ? "empty" : sidecarDropBucket(summaryRejectionReason(scrubbed, isKnown));
+        if (dropBucket !== null) {
+          composition.sidecarDropped++;
+          composition.sidecarDropReasons[dropBucket] = (composition.sidecarDropReasons[dropBucket] ?? 0) + 1;
+          continue;
+        }
+        if (count >= MAX_SIDECAR_SYMBOLS) {
+          composition.sidecarTruncatedAtCap = 1;
+          break outer;
+        }
         sidecar[tok] = { kind: entry.kind, summary: scrubbed };
         count++;
       }
@@ -58214,7 +58305,12 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
       `[errata] held ${heldOrphans.size} causal-orphan node(s) \u2014 no shippable binding edge this drain (VS-orphan-gate)`
     );
   }
-  if (shippableNodes.length === 0 && shippableEdges.length === 0) return null;
+  composition.heldOrphans = heldOrphans.size;
+  composition.shipped = shippableNodes.length;
+  if (shippableNodes.length === 0 && shippableEdges.length === 0) {
+    opts.onComposition?.(composition);
+    return null;
+  }
   const base = {
     daemonVersion,
     // Origin key (= project, the salted `wp_…`) — the door stamps it onto created
@@ -58232,7 +58328,8 @@ function buildInstanceIngest(store, profile, daemonVersion, ignorePatterns = [],
     // payloadDigest — byte-identical to the pre-sidecar batch (backward compat).
     ...symbolSummaries ? { symbolSummaries } : {}
   };
-  return { ...base, payloadDigest: digest(base), anchorDigests, semanticEdgeDigests };
+  opts.onComposition?.(composition);
+  return { ...base, payloadDigest: digest(base), anchorDigests, semanticEdgeDigests, composition };
 }
 
 // src/backfill-edges.ts
@@ -59581,15 +59678,28 @@ async function startMultiDaemon(opts = {}) {
           } catch {
           }
         }
+        let composition = null;
         const instances = buildInstanceIngest(store, r.engine.profile, DAEMON_VERSION, ignore, {
           includePackages: cfg2.consent.contributePackages,
           workspaceRoot: r.root,
           sharedStore,
+          onComposition: (c) => {
+            composition = c;
+          },
           ...lexicon ? { lexicon } : {},
           ...project ? { project } : {}
         });
+        if (!instances && composition) {
+          appendPassLedger(r.engine.paths.configDir, "ship", 0, {
+            ...compositionCounters(composition),
+            accepted: 0,
+            rejected: 0,
+            blocked: 0
+          });
+        }
         if (instances) {
           if (project) instances.projectId = project.projectId;
+          const shipStartedAt = Date.now();
           await lane("instances", projectName, async () => {
             const blocked = /* @__PURE__ */ new Set();
             const res = await client.ingest(instances, {
@@ -59608,6 +59718,16 @@ async function startMultiDaemon(opts = {}) {
             const cloudIdByLocal = new Map(
               res.result.nodes.filter((rn) => rn.nodeId).map((rn) => [rn.canonicalId, rn.nodeId])
             );
+            const rejected = /* @__PURE__ */ new Map();
+            for (const rn of res.result.nodes) {
+              if (rn.decision === "rejected") rejected.set(rn.canonicalId, rn.reason ?? "no reason given");
+            }
+            if (rejected.size > 0) {
+              const sample = [...rejected.entries()].slice(0, 3).map(([id, why]) => `${store.getNode(id)?.description.slice(0, 60) ?? id}: ${why}`);
+              console.warn(
+                `[sync\u2192cloud] [${projectName}] instances: ${rejected.size} node(s) REJECTED by the door \u2014 left pending for the next flush: ` + sample.join(" | ")
+              );
+            }
             const owningStore = (id) => {
               const w = store.getNode(id);
               if (w) return { s: store, n: w };
@@ -59619,6 +59739,7 @@ async function startMultiDaemon(opts = {}) {
               const owner = owningStore(n.id);
               if (!owner || !["Problem", "Solution", "RootCause"].includes(owner.n.label)) continue;
               if (blocked.has(n.id)) continue;
+              if (rejected.has(n.id)) continue;
               const cloudNodeId = cloudIdByLocal.get(n.id);
               owner.s.updateNode(n.id, {
                 attrs: {
@@ -59631,6 +59752,7 @@ async function startMultiDaemon(opts = {}) {
             for (const [localId, dg] of Object.entries(instances.anchorDigests)) {
               const owner = owningStore(localId);
               if (!owner) continue;
+              if (rejected.has(localId) || blocked.has(localId)) continue;
               owner.s.updateNode(localId, {
                 attrs: { ...owner.n.attrs, anchorsContributedDigest: dg }
               });
@@ -59638,10 +59760,17 @@ async function startMultiDaemon(opts = {}) {
             for (const [localId, dg] of Object.entries(instances.semanticEdgeDigests)) {
               const owner = owningStore(localId);
               if (!owner) continue;
+              if (rejected.has(localId) || blocked.has(localId)) continue;
               owner.s.updateNode(localId, {
                 attrs: { ...owner.n.attrs, semanticEdgesContributedDigest: dg }
               });
             }
+            appendPassLedger(r.engine.paths.configDir, "ship", Date.now() - shipStartedAt, {
+              ...compositionCounters(instances.composition),
+              accepted: res.accepted,
+              rejected: rejected.size,
+              blocked: blocked.size
+            });
             return res.accepted;
           });
         }

package/package.json

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