@inerrata-corporation/errata 2.0.0-dev.28 → 2.0.0-dev.29

package/errata.mjs

@@ -19939,7 +19939,7 @@ function budgetSnapshot(s, maxChars) {
   return dropped;
 }
 function assembleAgentContext(opts) {
-  const snapshot = buildSnapshot({
+  const snapshot = opts.snapshot ?? buildSnapshot({
     store: opts.store,
     profile: opts.profile,
     reviewCount: opts.reviewCount,
@@ -37695,7 +37695,7 @@ init_webui();
 init_config();
 
 // src/engine.ts
-import { execFileSync as execFileSync4 } from "node:child_process";
+import { execFileSync as execFileSync3 } from "node:child_process";
 import { existsSync as existsSync14, statSync as statSync4, appendFileSync as appendFileSync2, readdirSync as readdirSync7, renameSync as renameSync2, readFileSync as readFileSync13, writeFileSync as writeFileSync11 } from "node:fs";
 import { join as join19, relative as relative6, sep as sep4 } from "node:path";
 
@@ -40272,14 +40272,19 @@ var PassWorker = class {
   reconcile() {
     return this.call("reconcile");
   }
-  call(kind) {
+  /** Build the AGENTS.md ContextSnapshot on the worker's own store connection —
+   *  the O(graph) scans stay off the main loop (HZ-boot-render-offload). */
+  snapshot(opts) {
+    return this.call("snapshot", opts);
+  }
+  call(kind, payload) {
     if (this.stopped) return Promise.reject(new Error("pass worker stopped"));
     this.ensureWorker();
     const id = this.nextId++;
     return this.ready.then(
       () => new Promise((resolve5, reject) => {
         this.pending.set(id, { resolve: resolve5, reject });
-        this.worker.postMessage({ id, kind });
+        this.worker.postMessage({ id, kind, ...payload !== void 0 ? { payload } : {} });
       })
     );
   }
@@ -40725,18 +40730,25 @@ function startGitSensor(gitDir, onEvent, opts = {}) {
 }
 
 // src/git-delta.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
+import { execFile } from "node:child_process";
 function git(repoDir, args2) {
-  return execFileSync3("git", ["-C", repoDir, ...args2], {
-    encoding: "utf8",
-    maxBuffer: 64 * 1024 * 1024,
-    // Windows: don't flash a console window for each git subcommand the
-    // git-sensor runs on every commit/checkout.
-    windowsHide: true
+  return new Promise((resolve5, reject) => {
+    execFile(
+      "git",
+      ["-C", repoDir, ...args2],
+      {
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+        // Windows: don't flash a console window for each git subcommand the
+        // git-sensor runs on every commit/checkout.
+        windowsHide: true
+      },
+      (err2, stdout) => err2 ? reject(err2) : resolve5(stdout)
+    );
   });
 }
-function gitDiff(repoDir, oldRef, newRef) {
-  const out2 = git(repoDir, ["diff", "--name-status", "-M", oldRef, newRef]);
+async function gitDiff(repoDir, oldRef, newRef) {
+  const out2 = await git(repoDir, ["diff", "--name-status", "-M", oldRef, newRef]);
   const changedPaths = [];
   const renames = [];
   const deleted = [];
@@ -40760,8 +40772,8 @@ function gitDiff(repoDir, oldRef, newRef) {
   return { changedPaths, renames, deleted };
 }
 var FMT = ["%H", "%an", "%ae", "%at", "%P", "%s"].join("%x1f");
-function commitMeta(repoDir, sha2) {
-  const line = git(repoDir, ["show", "--no-patch", `--format=${FMT}`, sha2]).split(/\r?\n/, 1)[0] ?? "";
+async function commitMeta(repoDir, sha2) {
+  const line = (await git(repoDir, ["show", "--no-patch", `--format=${FMT}`, sha2])).split(/\r?\n/, 1)[0] ?? "";
   const [h, an, ae, at, parents, subject] = line.split("");
   return {
     sha: h ?? sha2,
@@ -41316,7 +41328,7 @@ function maybeFlushDigests() {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.28" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.29" : "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;
@@ -41350,7 +41362,7 @@ function saveTurnCursors(path2, cursors) {
 function gitSourceWatchTargets(root) {
   const SOURCE = /\.(ts|tsx|js|jsx|mjs|cjs|py)$/i;
   try {
-    const lsOut = execFileSync4("git", ["-C", root, "ls-files", "-z"], {
+    const lsOut = execFileSync3("git", ["-C", root, "ls-files", "-z"], {
       encoding: "utf8",
       maxBuffer: 128 * 1024 * 1024,
       windowsHide: true,
@@ -41360,7 +41372,7 @@ function gitSourceWatchTargets(root) {
     if (sourceFiles.length === 0) throw new Error("no tracked source");
     let ignoredDirs = [];
     try {
-      const igOut = execFileSync4(
+      const igOut = execFileSync3(
         "git",
         ["-C", root, "ls-files", "--others", "--ignored", "--exclude-standard", "--directory", "-z"],
         { encoding: "utf8", maxBuffer: 256 * 1024 * 1024, windowsHide: true, stdio: ["ignore", "pipe", "ignore"] }
@@ -41501,8 +41513,8 @@ function createWorkspaceEngine(opts) {
       let diff;
       let meta3;
       try {
-        diff = gitDiff(opts.workspaceRoot, ev.oldSha, ev.newSha);
-        meta3 = commitMeta(opts.workspaceRoot, ev.newSha);
+        diff = await gitDiff(opts.workspaceRoot, ev.oldSha, ev.newSha);
+        meta3 = await commitMeta(opts.workspaceRoot, ev.newSha);
       } catch (err2) {
         console.warn("[errata] git read failed:", err2);
         return;
@@ -41559,18 +41571,46 @@ function createWorkspaceEngine(opts) {
   let lastRemoteAt = 0;
   let remoteInFlight = false;
   const REMOTE_REFRESH_MS = 5 * 6e4;
+  let ctxRefreshInFlight = false;
+  let ctxRefreshQueued = false;
   const refreshContextNow = () => {
+    void refreshContextAsync().catch((err2) => {
+      console.warn("[errata] context refresh failed:", err2 instanceof Error ? err2.message : err2);
+    });
+  };
+  const refreshContextAsync = async () => {
     if (opts.skipContextWriter) return;
+    if (ctxRefreshInFlight) {
+      ctxRefreshQueued = true;
+      return;
+    }
+    ctxRefreshInFlight = true;
+    try {
+      await refreshContextOnce();
+    } finally {
+      ctxRefreshInFlight = false;
+      if (ctxRefreshQueued) {
+        ctxRefreshQueued = false;
+        refreshContextNow();
+      }
+    }
+  };
+  const refreshContextOnce = async () => {
     const elicit = isEdgeElicitationEnabled();
-    const { body: body2, snapshot } = assembleAgentContext({
-      store,
+    const snapOpts = {
       profile,
       reviewCount: pendingCount(paths),
       reviewUiUrl: opts.reviewUrl(),
       workingFile: workingFiles.mostRecent() ?? void 0,
-      skills: readSkillManifest(paths.skillsManifest),
+      skills: readSkillManifest(paths.skillsManifest)
+    };
+    const prebuilt = passWorker ? await passWorker.snapshot(snapOpts).catch(() => null) : null;
+    const { body: body2, snapshot } = assembleAgentContext({
+      store,
+      ...snapOpts,
       remote: remotePriors,
-      ...elicit ? { edgeElicitation: { instruction: PRIOR_TAG_INSTRUCTION } } : {}
+      ...elicit ? { edgeElicitation: { instruction: PRIOR_TAG_INSTRUCTION } } : {},
+      ...prebuilt ? { snapshot: prebuilt } : {}
     });
     const target = join19(opts.workspaceRoot, "AGENTS.md");
     writeManagedBlock(target, { body: body2 });
@@ -41774,7 +41814,7 @@ function createWorkspaceEngine(opts) {
       return hit?.id;
     };
     for (const turn of items) {
-      if (processedTurns++ > 0 && processedTurns % 20 === 0) await yieldToLoop();
+      if (processedTurns++ > 0) await yieldToLoop();
       const turnFile = turn.workingFile ? toRel(turn.workingFile) : void 0;
       if (opts.sharedStore) {
         try {
@@ -41823,7 +41863,7 @@ function createWorkspaceEngine(opts) {
             if (!retractAs) {
               const pid = r.id ?? designProblemId(r.problem);
               try {
-                const d = gitDiff(opts.workspaceRoot, "HEAD~1", "HEAD");
+                const d = await gitDiff(opts.workspaceRoot, "HEAD~1", "HEAD");
                 anchorProblemToDiff(store, pid, d.changedPaths, profile.id, t);
                 const solId = solutionForProblem(store, pid);
                 if (solId) anchorSolutionToDiff(store, solId, d.changedPaths, profile.id, t);
@@ -42037,6 +42077,7 @@ function createWorkspaceEngine(opts) {
   const harvestSession = async (sessionId, transcriptPath) => {
     await harvestTurns(sessionId, transcriptPath);
     for (const sub of subagentTranscripts(transcriptPath, sessionId)) {
+      await yieldToLoop();
       await harvestTurns(sub.sessionId, sub.path);
     }
   };
@@ -42050,7 +42091,10 @@ function createWorkspaceEngine(opts) {
           sinceMs: Date.now() - TURN_REPLAY_LOOKBACK_MS,
           limit: 25
         });
-        for (const ref of refs) await harvestSession(ref.sessionId, ref.path);
+        for (const ref of refs) {
+          await yieldToLoop();
+          await harvestSession(ref.sessionId, ref.path);
+        }
       } catch {
       }
     })();

package/package.json

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

package/pass-worker.mjs

@@ -24451,6 +24451,14 @@ function addDependency(store2, opts) {
   store2.mergeEdge(edge);
   return edge;
 }
+function listNeedsRevisit(store2, asOf) {
+  return store2.nodesAsOf(asOf).filter((n) => n.attrs["revisit"] === true).map((n) => ({
+    id: n.id,
+    label: n.label,
+    description: n.description,
+    reason: String(n.attrs["revisitReason"] ?? "")
+  }));
+}
 
 // ../../packages/local-graph/src/credit.ts
 init_src2();
@@ -24798,6 +24806,48 @@ function mergeEdge(store2, from, to, type, ts) {
     attrs: { provisional: true }
   });
 }
+var CITABLE_PRIOR_LABELS = /* @__PURE__ */ new Set([
+  "Solution",
+  "RootCause",
+  "Pattern",
+  "Technique",
+  "AntiPattern"
+]);
+function priorsForFile(store2, relPath) {
+  const want = relPath.trim().replace(/^\.?\//, "");
+  let file2 = null;
+  for (const n of store2.findNodesByLabel("File")) {
+    if (n.description === want || n.attrs["relPath"] === want) {
+      file2 = n;
+      break;
+    }
+  }
+  if (!file2) return null;
+  const openProblems = [];
+  const seenProblem = /* @__PURE__ */ new Set();
+  const related = /* @__PURE__ */ new Map();
+  for (const e of store2.inEdges(file2.id, ["ANCHORED_AT"])) {
+    const n = store2.getNode(e.from);
+    if (!n) continue;
+    if (n.label === "Problem") {
+      if (!n.attrs["resolvedAt"] && !seenProblem.has(n.id)) {
+        seenProblem.add(n.id);
+        openProblems.push(n);
+      }
+    } else if (CITABLE_PRIOR_LABELS.has(n.label)) {
+      related.set(n.id, n);
+    }
+  }
+  for (const p of openProblems) {
+    for (const e of store2.outEdges(p.id, ["SOLVED_BY", "CAUSED_BY", "INSTANCE_OF"])) {
+      const n = store2.getNode(e.to);
+      if (n && CITABLE_PRIOR_LABELS.has(n.label)) related.set(n.id, n);
+    }
+  }
+  if (openProblems.length === 0 && related.size === 0) return null;
+  openProblems.sort((a, b) => (b.lastUpdatedAt ?? 0) - (a.lastUpdatedAt ?? 0));
+  return { file: file2, openProblems, related: [...related.values()] };
+}
 function resolveDesignProblems(store2, t) {
   let resolved = 0;
   for (const p of store2.findNodesByLabel("Problem")) {
@@ -25517,6 +25567,146 @@ function codeAnchorProjection(store2, semanticIds, opts = {}) {
   return out2;
 }
 
+// ../../packages/context-writer/src/agents-md.ts
+init_src();
+
+// ../../packages/context-writer/src/render.ts
+init_src2();
+function buildSnapshot(opts) {
+  const problems = opts.store.findNodesByLabel("Problem").filter((p) => p.attrs["mergedInto"] === void 0);
+  const allProblems = problems.filter((p) => p.attrs["resolvedAt"] == null);
+  allProblems.sort((a, b) => b.lastUpdatedAt - a.lastUpdatedAt);
+  const recent = allProblems.slice(0, 8).map((p) => ({
+    node: p,
+    anchors: opts.store.outEdges(p.id, ["MANIFESTED_IN", "EVIDENCED_BY"])
+  }));
+  const recentResolved = problems.filter((p) => p.attrs["resolvedAt"] != null && p.attrs["resolvedAs"] == null).sort((a, b) => Number(b.attrs["resolvedAt"] ?? 0) - Number(a.attrs["resolvedAt"] ?? 0)).slice(0, 4).map((p) => {
+    const solEdge = opts.store.outEdges(p.id, ["SOLVED_BY"])[0];
+    const solution = solEdge ? opts.store.getNode(solEdge.to) ?? void 0 : void 0;
+    return { node: p, ...solution ? { solution } : {} };
+  });
+  const motifs = [
+    ...opts.store.findNodesByLabel("Pattern"),
+    ...opts.store.findNodesByLabel("Technique"),
+    ...opts.store.findNodesByLabel("AntiPattern")
+  ].sort((a, b) => b.pageRank - a.pageRank).slice(0, 10);
+  const workingFile = opts.workingFile ? sliceForFile(opts.store, opts.workingFile) : void 0;
+  const byEpisode = /* @__PURE__ */ new Map();
+  for (const sol of opts.store.findNodesByLabel("Solution")) {
+    if (sol.attrs["enrichmentPending"] !== true) continue;
+    const ep = sol.attrs["episodeId"] ?? sol.id;
+    const list = byEpisode.get(ep) ?? [];
+    list.push({
+      problemId: sol.attrs["problemId"] ?? "",
+      fixed: sol.attrs["symbolName"] ?? "",
+      problem: sol.attrs["problemDescription"] ?? ""
+    });
+    byEpisode.set(ep, list);
+  }
+  const pendingEnrichment = [...byEpisode.entries()].map(([episodeId, problems2]) => ({
+    episodeId,
+    problems: problems2
+  }));
+  const needsRevisit = listNeedsRevisit(
+    opts.store,
+    (opts.now ?? /* @__PURE__ */ new Date()).getTime()
+  ).slice(0, 10);
+  const norm = (x) => x.toLowerCase().replace(/[^a-z0-9]+/g, "");
+  const pkgBase = (x) => {
+    const at = x.lastIndexOf("@");
+    return at > 0 ? x.slice(0, at) : x;
+  };
+  const matchNode = (cands, key) => {
+    const k = norm(key);
+    if (k.length < 2) return null;
+    return cands.find((n) => norm(n.description ?? "") === k) ?? cands.find((n) => {
+      const d = norm(n.description ?? "");
+      return d.length >= 2 && (d.includes(k) || k.includes(d));
+    }) ?? null;
+  };
+  const langNodes = opts.store.findNodesByLabel("Language");
+  const pkgNodes = opts.store.findNodesByLabel("Package");
+  const profileContext = {
+    languages: opts.profile.languages.map((name2) => ({ name: name2, node: matchNode(langNodes, name2) })),
+    packages: opts.profile.stack.map((name2) => ({ name: name2, node: matchNode(pkgNodes, pkgBase(name2)) }))
+  };
+  return {
+    profile: opts.profile,
+    profileContext,
+    recentProblems: recent,
+    recentResolved,
+    motifs,
+    reviewCount: opts.reviewCount,
+    reviewUiUrl: opts.reviewUiUrl,
+    ...workingFile ? { workingFile } : {},
+    pendingEnrichment,
+    skills: opts.skills ?? [],
+    needsRevisit,
+    generatedAt: (opts.now ?? /* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function sliceForFile(store2, relPath) {
+  const candidates = store2.findNodesByLabel("File");
+  const file2 = candidates.find((n) => n.description === relPath);
+  if (!file2) return void 0;
+  const symbols = [];
+  for (const e of store2.outEdges(file2.id, ["DEFINES"])) {
+    const n = store2.getNode(e.to);
+    if (n) symbols.push({ label: n.label, name: n.description });
+    if (symbols.length >= 25) break;
+  }
+  const importsFrom = [];
+  for (const e of store2.outEdges(file2.id, ["IMPORTS"])) {
+    const n = store2.getNode(e.to);
+    if (n && n.label === "File") importsFrom.push(n.description);
+    if (importsFrom.length >= 15) break;
+  }
+  const importedBy = [];
+  for (const e of store2.inEdges(file2.id, ["IMPORTS"])) {
+    const n = store2.getNode(e.from);
+    if (n && n.label === "File") importedBy.push(n.description);
+    if (importedBy.length >= 15) break;
+  }
+  const externalRefs = [];
+  for (const e of store2.outEdges(file2.id, ["DEFINES"])) {
+    const sym = store2.getNode(e.to);
+    if (!sym) continue;
+    for (const ref of store2.outEdges(sym.id, ["CALLS", "ACCESSES"])) {
+      const tgt = store2.getNode(ref.to);
+      if (!tgt) continue;
+      const tgtFile = fileOf(store2, tgt.id);
+      if (tgtFile && tgtFile !== file2.id) {
+        externalRefs.push({ kind: ref.type, target: tgt.description });
+        if (externalRefs.length >= 20) break;
+      }
+    }
+    if (externalRefs.length >= 20) break;
+  }
+  const fp = priorsForFile(store2, relPath);
+  const priors = fp ? {
+    openProblems: fp.openProblems.slice(0, 3).map((p) => ({ id: p.id, description: p.description })),
+    related: fp.related.slice(0, 4).map((n) => ({ id: n.id, label: n.label, description: n.description }))
+  } : void 0;
+  return {
+    relPath,
+    symbols,
+    importsFrom,
+    importedBy,
+    externalRefs,
+    ...priors ? { priors } : {}
+  };
+}
+function fileOf(store2, nodeId) {
+  for (const e of store2.inEdges(nodeId, ["DEFINES"])) {
+    const parent = store2.getNode(e.from);
+    if (parent && parent.label === "File") return parent.id;
+  }
+  return null;
+}
+
+// ../../packages/context-writer/src/select-durable-memory.ts
+init_src2();
+
 // ../../node_modules/.pnpm/env-paths@3.0.0/node_modules/env-paths/index.js
 import os from "node:os";
 import process3 from "node:process";
@@ -25650,6 +25840,17 @@ function runPass(msg) {
       return runNightly();
     case "reconcile":
       return reconcileStaleFiles(store, init2.workspaceRoot, init2.workspaceId);
+    case "snapshot": {
+      const p = msg.payload;
+      return buildSnapshot({
+        store,
+        profile: p.profile,
+        reviewCount: p.reviewCount,
+        reviewUiUrl: p.reviewUiUrl,
+        ...p.workingFile !== void 0 ? { workingFile: p.workingFile } : {},
+        ...p.skills !== void 0 ? { skills: p.skills } : {}
+      });
+    }
     default:
       throw new Error(`pass-worker: unknown pass "${msg.kind}"`);
   }