@inerrata-corporation/errata 2.0.0-dev.88 → 2.0.0-dev.89

package/consolidate-worker.mjs

@@ -17212,6 +17212,9 @@ var DRIFT_VALUES = new Set(Object.values(DRIFT_KIND));
 init_src();
 init_src();
 
+// ../../packages/local-graph/src/tools.ts
+init_src();
+
 // ../../packages/local-graph/src/principle-sync.ts
 init_src2();
 

package/errata.mjs

@@ -919,6 +919,20 @@ function normalizeToolName(raw2) {
 function operatingSystemCanonicalId(name2) {
   return genericCanonicalId("OperatingSystem", { name: name2.trim().toLowerCase() });
 }
+function osNameForPlatform(platform) {
+  switch (platform) {
+    case "win32":
+      return OS_NAME.windows;
+    case "darwin":
+      return OS_NAME.macos;
+    case "linux":
+      return OS_NAME.linux;
+    case "android":
+      return OS_NAME.android;
+    default:
+      return null;
+  }
+}
 function packageCanonicalId(p) {
   const eco = p.ecosystem.toLowerCase();
   const name2 = eco === "npm" ? p.name.toLowerCase() : p.name;
@@ -939,7 +953,7 @@ function parsePackageRef(ref) {
   const slug2 = (version2 ? `${name2}@${version2}` : name2).toLowerCase();
   return { name: name2, version: version2, slug: slug2 };
 }
-var DESIGN_PROBLEM_PREFIX, DESIGN_PROBLEM_ID_LENGTH, DIAGNOSTIC_PROBLEM_PREFIX, DIAGNOSTIC_HASH_LENGTH, TRIAGE_PREFIX, TRIAGE_ID_LENGTH, SAFE_TOOL_NAME;
+var DESIGN_PROBLEM_PREFIX, DESIGN_PROBLEM_ID_LENGTH, DIAGNOSTIC_PROBLEM_PREFIX, DIAGNOSTIC_HASH_LENGTH, TRIAGE_PREFIX, TRIAGE_ID_LENGTH, SAFE_TOOL_NAME, OS_NAME;
 var init_identity = __esm({
   "../../packages/shared/src/identity.ts"() {
     "use strict";
@@ -953,6 +967,12 @@ var init_identity = __esm({
     TRIAGE_PREFIX = "dtri_";
     TRIAGE_ID_LENGTH = 56;
     SAFE_TOOL_NAME = /^[a-z0-9][a-z0-9._+-]{0,63}$/;
+    OS_NAME = {
+      windows: "Windows",
+      macos: "macOS",
+      linux: "Linux",
+      android: "Android"
+    };
   }
 });
 
@@ -15894,6 +15914,7 @@ __export(src_exports, {
   MAX_NODES_PER_PAYLOAD: () => MAX_NODES_PER_PAYLOAD,
   MAX_SIDECAR_SYMBOLS: () => MAX_SIDECAR_SYMBOLS,
   MAX_SYMBOL_SUMMARY_CHARS: () => MAX_SYMBOL_SUMMARY_CHARS,
+  OS_NAME: () => OS_NAME,
   PAGERANK_EXCLUSIONS: () => PAGERANK_EXCLUSIONS,
   PROBLEM_RESOLUTION: () => PROBLEM_RESOLUTION,
   PROJECT_ONLY_EDGE_TYPES: () => PROJECT_ONLY_EDGE_TYPES,
@@ -15951,6 +15972,7 @@ __export(src_exports, {
   normalizeToolName: () => normalizeToolName,
   npmPurl: () => npmPurl,
   operatingSystemCanonicalId: () => operatingSystemCanonicalId,
+  osNameForPlatform: () => osNameForPlatform,
   packageCanonicalId: () => packageCanonicalId,
   pagerankEdgeTypes: () => pagerankEdgeTypes,
   parsePackageLockJson: () => parsePackageLockJson,
@@ -20352,6 +20374,100 @@ var init_problem_dedup = __esm({
   }
 });
 
+// ../../packages/local-graph/src/tools.ts
+function toolNodeId(name2) {
+  return `tool:${name2}`;
+}
+function osNodeId(name2) {
+  return `os:${name2.toLowerCase()}`;
+}
+function resolveOsNode(store, osName, ts) {
+  const id = osNodeId(osName);
+  const existing = store.getNode(id);
+  if (existing) return existing;
+  const node2 = {
+    id,
+    label: "OperatingSystem",
+    description: osName,
+    extractionConfidence: 1,
+    extractionSource: "daemon-extracted",
+    embedding: [],
+    cumulativeSurprise: 0,
+    peakSurprise: 0,
+    cumulativeHits: 0,
+    lastUpdatedAt: ts,
+    createdAt: ts,
+    memoryTier: "short-term",
+    pageRank: 0,
+    isLandmark: false,
+    community: null,
+    stability: "stable",
+    attrs: { name: osName, canonicalId: operatingSystemCanonicalId(osName), public: true }
+  };
+  store.mergeNode(node2);
+  return node2;
+}
+function stampObservedOs(store, nodeId, osName, ts) {
+  if (!osName || !store.getNode(nodeId)) return false;
+  const os2 = resolveOsNode(store, osName, ts);
+  const already = store.outEdges(nodeId, ["OCCURS_ON"]).some((e) => e.to === os2.id);
+  if (already) return true;
+  store.mergeEdge({
+    id: `edge_${digest({ from: nodeId, type: "OCCURS_ON", to: os2.id })}`.slice(0, 24),
+    from: nodeId,
+    to: os2.id,
+    type: "OCCURS_ON",
+    confidence: 1,
+    // observed, not inferred — we ran on this platform
+    extractionSource: "daemon-extracted",
+    createdAt: ts,
+    lastSeenAt: ts,
+    navSuccesses: 0,
+    navFailures: 0,
+    attrs: { observed: true }
+  });
+  return true;
+}
+function rankToolsForHandles(store, limit = 5) {
+  const scored = store.findNodesByLabel("Tool").map((node2) => ({
+    node: node2,
+    concerns: store.inEdges(node2.id, ["CONCERNS"]).length,
+    hits: node2.cumulativeHits ?? 0
+  }));
+  scored.sort((a, b) => b.concerns - a.concerns || b.hits - a.hits);
+  return scored.slice(0, Math.max(0, limit)).map((s) => s.node);
+}
+function toolPriorsFor(store, toolName, ctx, limit = 4) {
+  const tool = store.getNode(toolNodeId(toolName));
+  if (!tool) return [];
+  const pkgs = ctx.workspacePackageIds ?? /* @__PURE__ */ new Set();
+  const fits = [];
+  for (const e of store.inEdges(tool.id, ["CONCERNS"])) {
+    const node2 = store.getNode(e.from);
+    if (!node2) continue;
+    if (node2.attrs["resolvedAs"] === "false_positive") continue;
+    const observedOn = store.outEdges(node2.id, ["OCCURS_ON"]).map((oe) => store.getNode(oe.to)?.description).filter((d) => !!d);
+    const osMismatch = observedOn.length > 0 && !!ctx.os && !observedOn.includes(ctx.os);
+    const deps = store.outEdges(node2.id, ["DEPENDS_ON"]).map((de) => de.to);
+    const stackHits = [];
+    const stackMisses = [];
+    for (const d of deps) {
+      const name2 = String(store.getNode(d)?.attrs["name"] ?? d);
+      (pkgs.has(d) ? stackHits : stackMisses).push(name2);
+    }
+    fits.push({ node: node2, observedOn, osMismatch, stackHits, stackMisses });
+  }
+  const rank = (f) => (f.osMismatch ? 0 : 2) + (f.stackHits.length > 0 ? 1 : 0);
+  fits.sort((a, b) => rank(b) - rank(a) || (b.node.cumulativeHits ?? 0) - (a.node.cumulativeHits ?? 0));
+  return fits.slice(0, Math.max(0, limit));
+}
+var init_tools = __esm({
+  "../../packages/local-graph/src/tools.ts"() {
+    "use strict";
+    init_src();
+  }
+});
+
 // ../../packages/local-graph/src/principle-sync.ts
 function asStrings(v) {
   return Array.isArray(v) ? v : [];
@@ -20514,6 +20630,7 @@ __export(src_exports2, {
   mergeDuplicateProblems: () => mergeDuplicateProblems,
   mintPatternNode: () => mintPatternNode,
   openGraphStore: () => openGraphStore,
+  osNodeId: () => osNodeId,
   parseAbstractionFences: () => parseAbstractionFences,
   parseSemver: () => parseSemver,
   parseTriageFences: () => parseTriageFences,
@@ -20522,6 +20639,7 @@ __export(src_exports2, {
   priorsForFile: () => priorsForFile,
   propagateFactChange: () => propagateFactChange,
   propagateVersionChange: () => propagateVersionChange,
+  rankToolsForHandles: () => rankToolsForHandles,
   recordAnchorHint: () => recordAnchorHint,
   recordClaim: () => recordClaim,
   recordMisreadPrior: () => recordMisreadPrior,
@@ -20531,13 +20649,17 @@ __export(src_exports2, {
   resolveDesignProblemById: () => resolveDesignProblemById,
   resolveDesignProblemByStatement: () => resolveDesignProblemByStatement,
   resolveDesignProblems: () => resolveDesignProblems,
+  resolveOsNode: () => resolveOsNode,
   retractDesignProblemById: () => retractDesignProblemById,
   retractDesignProblemByStatement: () => retractDesignProblemByStatement,
   revisitContradictedPrinciples: () => revisitContradictedPrinciples,
   revisitStaleRoutes: () => revisitStaleRoutes,
   solutionForProblem: () => solutionForProblem,
   splittingAxis: () => splittingAxis,
+  stampObservedOs: () => stampObservedOs,
   staticConductance: () => staticConductance,
+  toolNodeId: () => toolNodeId,
+  toolPriorsFor: () => toolPriorsFor,
   triageOf: () => triageOf,
   walk: () => walk
 });
@@ -20560,6 +20682,7 @@ var init_src4 = __esm({
     init_triage2();
     init_problem_dedup();
     init_problem_package_link();
+    init_tools();
     init_principle_sync();
   }
 });
@@ -20628,7 +20751,7 @@ function buildSnapshot(opts) {
   };
   const langNodes = opts.store.findNodesByLabel("Language");
   const pkgNodes = opts.store.findNodesByLabel("Package");
-  const toolNodes = opts.store.findNodesByLabel("Tool").sort((a, b) => (b.cumulativeHits ?? 0) - (a.cumulativeHits ?? 0)).slice(0, 5);
+  const toolNodes = rankToolsForHandles(opts.store, 5);
   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)) })),
@@ -45185,8 +45308,8 @@ var init_tldr_tools_generated = __esm({
 });
 
 // src/tool-index.ts
-function toolNodeId(name2) {
-  return `tool:${name2}`;
+function currentOsName() {
+  return osNameForPlatform(process.platform);
 }
 function extractExecutables(command) {
   const out2 = [];
@@ -45211,8 +45334,10 @@ function extractExecutables(command) {
 }
 function observeCommandTools(store, command, ts) {
   const result = { minted: [], reinforced: [] };
+  const osName = currentOsName();
   for (const name2 of extractExecutables(command)) {
     if (!PUBLIC_TOOLS.has(name2)) continue;
+    if (PLUMBING.has(name2)) continue;
     const id = toolNodeId(name2);
     const existing = store.getNode(id);
     if (existing) {
@@ -45245,17 +45370,60 @@ function observeCommandTools(store, command, ts) {
         attrs: { name: name2, canonicalId: toolCanonicalId(name2), public: true }
       });
       result.minted.push(name2);
+      if (osName) {
+        const os2 = resolveOsNode(store, osName, ts);
+        store.mergeEdge({
+          id: `edge_${digest({ from: id, type: "RUNS_ON", to: os2.id })}`.slice(0, 24),
+          from: id,
+          to: os2.id,
+          type: "RUNS_ON",
+          confidence: 1,
+          // observed
+          extractionSource: "daemon-extracted",
+          createdAt: ts,
+          lastSeenAt: ts,
+          navSuccesses: 0,
+          navFailures: 0,
+          attrs: { observed: true }
+        });
+      }
     }
   }
   return result;
 }
-var PUBLIC_TOOLS, PASSTHROUGH, SEGMENT_SPLIT;
+var PUBLIC_TOOLS, PLUMBING, PASSTHROUGH, SEGMENT_SPLIT;
 var init_tool_index = __esm({
   "src/tool-index.ts"() {
     "use strict";
     init_src();
+    init_src();
+    init_src4();
     init_tldr_tools_generated();
     PUBLIC_TOOLS = new Set(TLDR_TOOL_NAMES);
+    PLUMBING = /* @__PURE__ */ new Set([
+      "cd",
+      "pwd",
+      "ls",
+      "dir",
+      "echo",
+      "clear",
+      "cls",
+      "exit",
+      "true",
+      "false",
+      "which",
+      "where",
+      "alias",
+      "unalias",
+      "history",
+      "set",
+      "unset",
+      "export",
+      "source",
+      "sleep",
+      "time",
+      "type"
+    ]);
     PASSTHROUGH = /* @__PURE__ */ new Set(["sudo", "npx", "pnpx", "bunx", "uvx", "time", "nohup", "xargs", "watch"]);
     SEGMENT_SPLIT = /\|\|?|&&|;|\r?\n/;
   }
@@ -45357,7 +45525,8 @@ __export(webui_exports, {
   decideContextInject: () => decideContextInject,
   fileUriToFsPath: () => fileUriToFsPath,
   findFileByPath: () => findFileByPath,
-  recallForFile: () => recallForFile
+  recallForFile: () => recallForFile,
+  recallForTool: () => recallForTool
 });
 import { join as join12 } from "node:path";
 function fileUriToFsPath(raw2) {
@@ -45410,6 +45579,35 @@ function recallForFile(store, relPath) {
 ${lines.join("\n")}
 ` + buildFileRecallInstruction();
 }
+function workspacePackageIds(store) {
+  const hit = wsPackagesCache.get(store);
+  const now = Date.now();
+  if (hit && now - hit.at < WS_PACKAGES_TTL_MS) return hit.ids;
+  const ids = new Set(store.findNodesByLabel("Package").map((n) => n.id));
+  wsPackagesCache.set(store, { at: now, ids });
+  return ids;
+}
+function recallForTool(store, command, ctx) {
+  const lines = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const name2 of extractExecutables(command)) {
+    if (seen.has(name2)) continue;
+    seen.add(name2);
+    for (const fit of toolPriorsFor(store, name2, ctx, 3)) {
+      const where = fit.osMismatch ? ` \`[${fit.observedOn.join("/")}]\`` : "";
+      const stack = fit.stackHits.length > 0 ? ` \`[${fit.stackHits.join(", ")}]\`` : "";
+      lines.push(
+        `- \`${name2}\`${where}${stack} ${recallLine(
+          fit.node,
+          fit.node.label === "Problem" ? `${TAG_EXAMPLE.fix(fit.node.id)} if you resolved it \xB7 ${TAG_EXAMPLE.prior(fit.node.id)} to cite` : `cite with ${TAG_EXAMPLE.prior(fit.node.id)}`
+        ).slice(2)}`
+      );
+    }
+  }
+  if (lines.length === 0) return null;
+  return `errata \u2014 ${lines.length} prior(s) about the tool(s) you're about to run (a \`[platform]\` tag means it was seen on a DIFFERENT OS than this one \u2014 judge it):
+${lines.join("\n")}`;
+}
 function decideContextInject(args2) {
   const { event, source, sessionId, block, lastInjectedHash } = args2;
   if (!block) return null;
@@ -45581,6 +45779,15 @@ function buildWebUi(deps) {
         }
         return c.json({ ok: true, materialized });
       }
+      if (tool === "Bash" && typeof input["command"] === "string") {
+        try {
+          recallCtx = recallForTool(deps.store, input["command"], {
+            os: currentOsName(),
+            workspacePackageIds: workspacePackageIds(deps.store)
+          });
+        } catch {
+        }
+      }
     }
     const filePath = extractWorkingFile(tool, input);
     let rel = null;
@@ -45672,6 +45879,11 @@ function buildWebUi(deps) {
       }
       return c.body(null, 204);
     }
+    if (event === "PreToolUse" && recallCtx) {
+      return c.json({
+        hookSpecificOutput: { hookEventName: "PreToolUse", additionalContext: recallCtx }
+      });
+    }
     return c.json({ ok: true, event, tool, recognizedFile: filePath ?? null });
   });
   app.post("/api/turn", async (c) => {
@@ -45918,7 +46130,7 @@ function proposalToIngest(p, profile, daemonVersion) {
     payloadDigest: p.id
   };
 }
-var META_LABELS;
+var wsPackagesCache, WS_PACKAGES_TTL_MS, META_LABELS;
 var init_webui = __esm({
   "src/webui.ts"() {
     "use strict";
@@ -45930,6 +46142,8 @@ var init_webui = __esm({
     init_vfile();
     init_tool_index();
     init_outbox();
+    wsPackagesCache = /* @__PURE__ */ new WeakMap();
+    WS_PACKAGES_TTL_MS = 6e4;
     META_LABELS = /* @__PURE__ */ new Set([
       "Pattern",
       "Technique",
@@ -48977,6 +49191,8 @@ function subagentTranscripts(mainTranscriptPath, sessionId) {
 init_src();
 init_src2();
 init_agent_signals();
+init_tool_index();
+init_src4();
 import { readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "node:fs";
 var NEG = /n['']t|\b(?:not|never|no|none|neither|nor|unrelated|irrelevant|would|might|could|if)\b/i;
 var CITE_GROUP_RE = /\(((?:[^()\n]|\([^()\n]*\)){1,200})\)/g;
@@ -49304,6 +49520,7 @@ function mintPriorEdge(store, source, target, sentence, touched, ts) {
     navFailures: 0,
     attrs: { provisional: true, priorTag: true, primingProvenance: true, corroborated }
   });
+  if (type === "CONCERNS") stampObservedOs(store, source.id, currentOsName(), ts);
   return true;
 }
 function harvestInlineTags(store, text, opts) {
@@ -51015,7 +51232,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.88" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.89" : "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;
@@ -56070,7 +56287,7 @@ async function installClaudeHooks(port) {
   }
   const matcher = "Read|Edit|Write|Grep|Glob|NotebookEdit|Bash";
   const postMatcher = `${matcher}|ToolSearch|mcp__errata__.*`;
-  const preCmd = `${hookCurlCommand(port)} ${ERRATA_TAG}`;
+  const preCmd = `${hookRelayCommand(port, "/api/hook")} ${ERRATA_TAG}`;
   const postCmd = `${hookRelayCommand(port, "/api/hook")} ${ERRATA_TAG}`;
   settings.hooks ??= {};
   const dropErrata = (list) => {

package/package.json

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

package/pass-worker.mjs

@@ -25748,6 +25748,18 @@ function foldDuplicateProblem(store2, dup, survivor, ts) {
   store2.closeNode(dup.id, ts);
 }
 
+// ../../packages/local-graph/src/tools.ts
+init_src();
+function rankToolsForHandles(store2, limit = 5) {
+  const scored = store2.findNodesByLabel("Tool").map((node) => ({
+    node,
+    concerns: store2.inEdges(node.id, ["CONCERNS"]).length,
+    hits: node.cumulativeHits ?? 0
+  }));
+  scored.sort((a, b) => b.concerns - a.concerns || b.hits - a.hits);
+  return scored.slice(0, Math.max(0, limit)).map((s) => s.node);
+}
+
 // ../../packages/local-graph/src/principle-sync.ts
 init_src2();
 
@@ -26055,7 +26067,7 @@ function buildSnapshot(opts) {
   };
   const langNodes = opts.store.findNodesByLabel("Language");
   const pkgNodes = opts.store.findNodesByLabel("Package");
-  const toolNodes = opts.store.findNodesByLabel("Tool").sort((a, b) => (b.cumulativeHits ?? 0) - (a.cumulativeHits ?? 0)).slice(0, 5);
+  const toolNodes = rankToolsForHandles(opts.store, 5);
   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)) })),