@inerrata-corporation/errata 2.0.8-dev.2839 → 2.0.8-dev.2870

package/errata.mjs

@@ -29066,6 +29066,92 @@ var init_agent_signals = __esm({
   }
 });
 
+// src/recall-card.ts
+function labelName(label) {
+  return LABEL_NAMES[label] ?? label.toUpperCase();
+}
+function clip(text, width) {
+  const flat = text.replace(/\s+/g, " ").trim();
+  return flat.length > width ? `${flat.slice(0, width - 1)}\u2026` : flat;
+}
+function plural(n, word, many = `${word}s`) {
+  return `${n} ${n === 1 ? word : many}`;
+}
+function errorCardHeadline(items) {
+  const fixes = items.filter((it) => it.label === "Solution").length;
+  return fixes > 0 ? `${plural(fixes, "known fix", "known fixes")} for this error` : `${plural(items.length, "prior")} for this error`;
+}
+function leadItem(items) {
+  return items.find((it) => it.label === "Solution") ?? items[0];
+}
+function renderRecallLine(card) {
+  const lead2 = leadItem(card.items);
+  if (!lead2) return null;
+  const rest2 = card.items.length - 1;
+  return `\u26A1 errata \xB7 ${card.headline} \u2014 ${labelName(lead2.label)}: ${clip(lead2.text, INLINE_TEXT_WIDTH)}` + (lead2.note ? ` ${lead2.note}` : "") + (rest2 > 0 ? ` \xB7 +${rest2} in context` : "");
+}
+function labelColor(label) {
+  if (label === "Solution") return GREEN;
+  if (label === "Problem" || label === "AntiPattern") return MADDER;
+  return AMBER;
+}
+function renderStatusCard(card) {
+  const ordered = [...card.items].sort(
+    (a, b) => Number(b.label === "Solution") - Number(a.label === "Solution")
+  );
+  const rows = ordered.slice(0, STATUS_ROWS).map((it) => {
+    const label = labelName(it.label).padEnd(LABEL_WIDTH);
+    const note = it.note ? ` ${DIM}${it.note}${RESET}` : "";
+    return `${DIM}\u2502${RESET} ${BOLD}${labelColor(it.label)}${label}${RESET} ${INK}${clip(it.text, STATUS_TEXT_WIDTH)}${RESET}${note}`;
+  });
+  const hidden = card.items.length - STATUS_ROWS;
+  const more = hidden > 0 ? ` ${DIM}\xB7 +${hidden} more in the agent's context${RESET}` : "";
+  return [`${AMBER}\u26A1${RESET} ${BOLD}errata${RESET} ${DIM}\xB7${RESET} ${card.headline}${more}`, ...rows].join("\n");
+}
+function rememberCard(sessionId, card, now = Date.now()) {
+  if (!sessionId) return;
+  latestBySession.delete(sessionId);
+  latestBySession.set(sessionId, { card, at: now });
+  if (latestBySession.size > MAX_SESSIONS) {
+    latestBySession.delete(latestBySession.keys().next().value);
+  }
+}
+function statuslineText(sessionId, now = Date.now()) {
+  const hit = latestBySession.get(sessionId);
+  if (!hit || now - hit.at > STATUS_CARD_TTL_MS) return IDLE_STATUS;
+  return renderStatusCard(hit.card);
+}
+function recallCardEnabled(env2 = process.env) {
+  const v = (env2["ERRATA_RECALL_CARD"] ?? "").trim().toLowerCase();
+  return !(v === "0" || v === "off" || v === "false" || v === "no");
+}
+var LABEL_NAMES, INLINE_TEXT_WIDTH, ESC, RESET, DIM, BOLD, AMBER, MADDER, GREEN, INK, STATUS_ROWS, STATUS_TEXT_WIDTH, LABEL_WIDTH, STATUS_CARD_TTL_MS, IDLE_STATUS, latestBySession, MAX_SESSIONS;
+var init_recall_card = __esm({
+  "src/recall-card.ts"() {
+    "use strict";
+    LABEL_NAMES = {
+      RootCause: "ROOT CAUSE",
+      AntiPattern: "ANTIPATTERN"
+    };
+    INLINE_TEXT_WIDTH = 64;
+    ESC = "\x1B[";
+    RESET = `${ESC}0m`;
+    DIM = `${ESC}2m`;
+    BOLD = `${ESC}1m`;
+    AMBER = `${ESC}38;2;217;164;65m`;
+    MADDER = `${ESC}38;2;210;58;77m`;
+    GREEN = `${ESC}38;2;111;191;138m`;
+    INK = `${ESC}38;2;236;226;221m`;
+    STATUS_ROWS = 2;
+    STATUS_TEXT_WIDTH = 96;
+    LABEL_WIDTH = 10;
+    STATUS_CARD_TTL_MS = 9e4;
+    IDLE_STATUS = `${AMBER}\u26A1${RESET} ${DIM}errata \xB7 watching${RESET}`;
+    latestBySession = /* @__PURE__ */ new Map();
+    MAX_SESSIONS = 256;
+  }
+});
+
 // src/review.ts
 import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "node:fs";
 function loadReviewQueue(paths) {
@@ -51311,8 +51397,11 @@ var init_message_accumulator = __esm({
 // src/webui.ts
 var webui_exports = {};
 __export(webui_exports, {
+  asFailedPostToolUse: () => asFailedPostToolUse,
   buildWebUi: () => buildWebUi,
   decideContextInject: () => decideContextInject,
+  errorRecallTerms: () => errorRecallTerms,
+  fileRecall: () => fileRecall,
   fileUriToFsPath: () => fileUriToFsPath,
   findFileByPath: () => findFileByPath,
   recallForFile: () => recallForFile,
@@ -51327,9 +51416,7 @@ function fileUriToFsPath(raw2) {
   return p;
 }
 function recallForError(store, errorText) {
-  const terms = Array.from(
-    new Set(errorText.split(/[^A-Za-z0-9_.]+/).filter((t) => t.length >= 5))
-  ).slice(0, 3);
+  const terms = errorRecallTerms(errorText);
   if (terms.length === 0) return null;
   const labels = ["Problem", "Solution", "RootCause"];
   const seen = /* @__PURE__ */ new Set();
@@ -51344,15 +51431,46 @@ function recallForError(store, errorText) {
   }
   if (hits.length === 0) return null;
   const lines = hits.slice(0, 3).map((n) => `- [${n.label}] ${(n.description ?? "").replace(/\s+/g, " ").slice(0, 140)}`);
-  return `errata recall \u2014 ${hits.length} prior match(es) in the local graph for this error:
+  const items = hits.map((n) => ({ label: n.label, text: n.description ?? "" }));
+  return {
+    context: `errata recall \u2014 ${hits.length} prior match(es) in the local graph for this error:
 ${lines.join("\n")}
-Reuse the prior fix if it applies before re-deriving.`;
+Reuse the prior fix if it applies before re-deriving.`,
+    card: { headline: errorCardHeadline(items), items }
+  };
+}
+function asFailedPostToolUse(body2) {
+  const error48 = typeof body2["error"] === "string" ? body2["error"] : "";
+  const exit = /^Exit code (\d+)/.exec(error48);
+  return {
+    ...body2,
+    hook_event_name: "PostToolUse",
+    is_error: true,
+    tool_response: { stdout: "", stderr: error48, exitCode: exit ? Number(exit[1]) : 1 }
+  };
+}
+function errorRecallTerms(errorText) {
+  const seen = /* @__PURE__ */ new Set();
+  const scored = [];
+  errorText.split(/[^A-Za-z0-9_.-]+/).forEach((raw2, at) => {
+    const term = raw2.replace(/^[.-]+|[.-]+$/g, "");
+    const key = term.toLowerCase();
+    if (term.length < 5 || seen.has(key) || GENERIC_ERROR_WORDS.has(key)) return;
+    seen.add(key);
+    const identifier = /[_.\d-]/.test(term) || /[a-z][A-Z]/.test(term) || /^[A-Z]{5,}$/.test(term);
+    scored.push({ term, score: identifier ? 1 : 0, at });
+  });
+  const hasIdentifier = scored.some((s) => s.score > 0);
+  return scored.filter((s) => !hasIdentifier || s.score > 0).sort((a, b) => b.score - a.score || a.at - b.at).slice(0, 3).map((s) => s.term);
 }
 function recallLine(n, token) {
   const desc = (n.description ?? "").replace(/\s+/g, " ").slice(0, 120);
   return `- [${n.label}] ${desc}  \u2192  ${token}`;
 }
 function recallForFile(store, relPath) {
+  return fileRecall(store, relPath)?.context ?? null;
+}
+function fileRecall(store, relPath) {
   const priors = priorsForFile(store, relPath);
   if (!priors) return null;
   const lines = [];
@@ -51370,9 +51488,16 @@ function recallForFile(store, relPath) {
     lines.push(recallLine(n, `cite with ${TAG_EXAMPLE.prior(n.id)}`));
   }
   const total = priors.openProblems.length + priors.constraints.length + priors.related.length;
-  return `errata \u2014 ${total} prior(s) recorded on this file (act only if relevant):
+  const items = [...priors.openProblems, ...priors.constraints, ...priors.related].map((n) => ({
+    label: n.label,
+    text: n.description ?? ""
+  }));
+  return {
+    context: `errata \u2014 ${total} prior(s) recorded on this file (act only if relevant):
 ${lines.join("\n")}
-` + buildFileRecallInstruction();
+` + buildFileRecallInstruction(),
+    card: { headline: `${plural(total, "prior")} on ${relPath.split("/").slice(-2).join("/")}`, items }
+  };
 }
 function workspacePackageIds(store) {
   const hit = wsPackagesCache.get(store);
@@ -51383,7 +51508,11 @@ function workspacePackageIds(store) {
   return ids;
 }
 function recallForTool(store, command, ctx) {
+  return toolRecall(store, command, ctx)?.context ?? null;
+}
+function toolRecall(store, command, ctx) {
   const lines = [];
+  const items = [];
   const seen = /* @__PURE__ */ new Set();
   for (const name2 of extractExecutables(command)) {
     if (seen.has(name2)) continue;
@@ -51397,11 +51526,19 @@ function recallForTool(store, command, ctx) {
           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)}`
       );
+      items.push({
+        label: fit.node.label,
+        text: `${name2}: ${fit.node.description ?? ""}`,
+        note: fit.osMismatch ? `[seen on ${fit.observedOn.join("/")}]` : void 0
+      });
     }
   }
   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")}`;
+  return {
+    context: `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")}`,
+    card: { headline: `${plural(items.length, "prior")} before this command runs`, items }
+  };
 }
 function decideContextInject(args2) {
   const { event, sessionId, block, lastInjectedHash } = args2;
@@ -51559,8 +51696,10 @@ function buildWebUi(deps) {
     if (deps.onHook) deps.onHook();
     const tool = String(body2["tool_name"] ?? "");
     const input = body2["tool_input"] ?? {};
-    const event = String(body2["hook_event_name"] ?? "PreToolUse");
-    let recallCtx = null;
+    const hookEvent = String(body2["hook_event_name"] ?? "PreToolUse");
+    if (hookEvent === "PostToolUseFailure") body2 = asFailedPostToolUse(body2);
+    const event = hookEvent === "PostToolUseFailure" ? "PostToolUse" : hookEvent;
+    let recall = null;
     if (event === "PreToolUse") {
       const virtual = extractVirtualReads(input);
       if (virtual.length > 0) {
@@ -51575,7 +51714,7 @@ function buildWebUi(deps) {
       }
       if (tool === "Bash" && typeof input["command"] === "string") {
         try {
-          recallCtx = recallForTool(deps.store, input["command"], {
+          recall = toolRecall(deps.store, input["command"], {
             os: currentOsName(),
             workspacePackageIds: workspacePackageIds(deps.store)
           });
@@ -51629,7 +51768,7 @@ function buildWebUi(deps) {
         deps.onToolsObserved?.(toolSid, observed.nodeIds);
       } catch {
       }
-      if (failed) recallCtx = recallForError(deps.store, stderr || combined);
+      if (failed) recall = recallForError(deps.store, stderr || combined);
     }
     if (event === "PostToolUse" && tool && tool !== "Bash" && deps.onToolError) {
       const rawResp = body2["tool_response"];
@@ -51652,11 +51791,11 @@ function buildWebUi(deps) {
             exitCode: numericExit ?? 1,
             ts: Date.now()
           });
-          recallCtx = recallForError(deps.store, errText2);
+          recall = recallForError(deps.store, errText2);
         }
       }
     }
-    if (event === "PostToolUse" && !recallCtx && rel && (tool === "Read" || tool === "Edit" || tool === "Write" || tool === "NotebookEdit")) {
+    if (event === "PostToolUse" && !recall && rel && (tool === "Read" || tool === "Edit" || tool === "Write" || tool === "NotebookEdit")) {
       const sid = String(body2["session_id"] ?? "");
       let seen = fileRecallSeen.get(sid);
       if (!seen) {
@@ -51664,28 +51803,29 @@ function buildWebUi(deps) {
         fileRecallSeen.set(sid, seen);
       }
       if (!seen.has(rel)) {
-        const fileCtx = recallForFile(deps.store, rel);
-        if (fileCtx) {
+        const fileHit = fileRecall(deps.store, rel);
+        if (fileHit) {
           seen.add(rel);
-          recallCtx = fileCtx;
+          recall = fileHit;
         }
       }
     }
-    if (event === "PostToolUse") {
-      if (recallCtx) {
-        return c.json({
-          hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: recallCtx }
-        });
-      }
-      return c.body(null, 204);
-    }
-    if (event === "PreToolUse" && recallCtx) {
+    if ((event === "PostToolUse" || event === "PreToolUse") && recall) {
+      const showCard = recallCardEnabled();
+      if (showCard) rememberCard(String(body2["session_id"] ?? ""), recall.card);
+      const line = showCard ? renderRecallLine(recall.card) : null;
       return c.json({
-        hookSpecificOutput: { hookEventName: "PreToolUse", additionalContext: recallCtx }
+        ...line ? { systemMessage: line } : {},
+        hookSpecificOutput: { hookEventName: hookEvent, additionalContext: recall.context }
       });
     }
+    if (event === "PostToolUse") return c.body(null, 204);
     return c.json({ ok: true, event, tool, recognizedFile: filePath ?? null });
   });
+  app.post("/api/statusline", async (c) => {
+    const body2 = await c.req.json().catch(() => ({}));
+    return c.text(statuslineText(String(body2["session_id"] ?? "")));
+  });
   app.post("/api/turn", async (c) => {
     let body2;
     try {
@@ -51929,7 +52069,7 @@ function proposalToIngest(p, profile, daemonVersion) {
     payloadDigest: p.id
   };
 }
-var messageAccumulator, wsPackagesCache, WS_PACKAGES_TTL_MS, loggedToolSessions, META_LABELS;
+var messageAccumulator, GENERIC_ERROR_WORDS, wsPackagesCache, WS_PACKAGES_TTL_MS, loggedToolSessions, META_LABELS;
 var init_webui = __esm({
   "src/webui.ts"() {
     "use strict";
@@ -51937,12 +52077,54 @@ var init_webui = __esm({
     init_src6();
     init_src5();
     init_agent_signals();
+    init_recall_card();
     init_review2();
     init_vfile();
     init_tool_index();
     init_outbox();
     init_message_accumulator();
     messageAccumulator = createMessageAccumulator();
+    GENERIC_ERROR_WORDS = /* @__PURE__ */ new Set([
+      "cannot",
+      "error",
+      "errors",
+      "failed",
+      "failure",
+      "found",
+      "install",
+      "installed",
+      "module",
+      "command",
+      "because",
+      "while",
+      "could",
+      "should",
+      "which",
+      "there",
+      "their",
+      "about",
+      "after",
+      "before",
+      "update",
+      "warning",
+      "expected",
+      "received",
+      "value",
+      "undefined",
+      "unable",
+      "invalid",
+      "missing",
+      "exited",
+      "unknown",
+      "files",
+      "directory",
+      "process",
+      "access",
+      "denied",
+      "permission",
+      "running",
+      "argument"
+    ]);
     wsPackagesCache = /* @__PURE__ */ new WeakMap();
     WS_PACKAGES_TTL_MS = 6e4;
     loggedToolSessions = /* @__PURE__ */ new Set();
@@ -55730,8 +55912,8 @@ var require_webidl = __commonJS({
       return new TypeError(`${message2.header}: ${message2.message}`);
     };
     webidl.errors.conversionFailed = function(context) {
-      const plural = context.types.length === 1 ? "" : " one of";
-      const message2 = `${context.argument} could not be converted to${plural}: ${context.types.join(", ")}.`;
+      const plural2 = context.types.length === 1 ? "" : " one of";
+      const message2 = `${context.argument} could not be converted to${plural2}: ${context.types.join(", ")}.`;
       return webidl.errors.exception({
         header: context.prefix,
         message: message2
@@ -63095,9 +63277,9 @@ var require_pluralizer = __commonJS({
       this: "these"
     };
     module2.exports = class Pluralizer {
-      constructor(singular, plural) {
+      constructor(singular, plural2) {
         this.singular = singular;
-        this.plural = plural;
+        this.plural = plural2;
       }
       pluralize(count) {
         const one = count === 1;
@@ -71202,7 +71384,7 @@ var init_report_render = __esm({
 // src/cli.ts
 init_src6();
 import { closeSync as closeSync2, existsSync as existsSync34, openSync as openSync2, readFileSync as readFileSync35, renameSync as renameSync4, statSync as statSync9 } from "node:fs";
-import { join as join41, resolve as pathResolve2 } from "node:path";
+import { join as join42, resolve as pathResolve2 } from "node:path";
 import { spawn as spawn5 } from "node:child_process";
 
 // src/daemon.ts
@@ -79251,7 +79433,7 @@ function createWorkingFileState() {
 }
 
 // src/tool-run-state.ts
-var MAX_SESSIONS = 64;
+var MAX_SESSIONS2 = 64;
 var MAX_TOOLS_PER_SESSION = 64;
 function createToolRunState() {
   const bySession = /* @__PURE__ */ new Map();
@@ -79260,7 +79442,7 @@ function createToolRunState() {
       if (!sessionId || toolNodeIds.length === 0) return;
       let set2 = bySession.get(sessionId);
       if (!set2) {
-        if (bySession.size >= MAX_SESSIONS) {
+        if (bySession.size >= MAX_SESSIONS2) {
           const oldest = bySession.keys().next().value;
           if (oldest !== void 0) bySession.delete(oldest);
         }
@@ -79931,7 +80113,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.8-dev.2839" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.8-dev.2870" : "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;
@@ -80364,7 +80546,7 @@ function createWorkspaceEngine(opts) {
       }
     }
   };
-  const clip = (s, n) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+  const clip2 = (s, n) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
   const pickReviewItems = () => {
     const shared = opts.sharedStore;
     if (!shared) return [];
@@ -80375,12 +80557,12 @@ function createWorkspaceEngine(opts) {
           return [{
             kind: "abstraction",
             candidate: small.candidate,
-            members: small.members.map((m) => ({ id: m.id, description: clip(m.description, 110) }))
+            members: small.members.map((m) => ({ id: m.id, description: clip2(m.description, 110) }))
           }];
         }
       }
       const [d] = pendingDiscriminators(shared, { limit: 1 });
-      return d ? [{ kind: "discriminator", route: d.route, presenting: clip(d.presenting, 140), cause: clip(d.cause, 140) }] : [];
+      return d ? [{ kind: "discriminator", route: d.route, presenting: clip2(d.presenting, 140), cause: clip2(d.cause, 140) }] : [];
     } catch {
       return [];
     }
@@ -83358,6 +83540,7 @@ function buildDrainInstances(store, sharedStore, input) {
 
 // src/multi.ts
 init_webui();
+init_recall_card();
 
 // src/consolidate-worker-client.ts
 import { Worker as Worker2 } from "node:worker_threads";
@@ -83728,6 +83911,22 @@ function isClaimedElsewhere(err2) {
   const e = err2;
   return e.status === 409 && e.code === "claimed_elsewhere";
 }
+function claimHoldStands(onDisk) {
+  return Boolean(onDisk && !onDisk.projectId && onDisk.projectLinkHold);
+}
+var LINK_FIELDS = [
+  "projectId",
+  "projectLocator",
+  "projectLinkHold",
+  "projectLinkDisabled",
+  "rootCommitReportedFor"
+];
+function adoptLinkFields(into, from) {
+  for (const k of LINK_FIELDS) {
+    if (from[k] === void 0) delete into[k];
+    else into[k] = from[k];
+  }
+}
 async function readRootCommit(root) {
   try {
     const { stdout } = await execFileAsync("git", ["rev-list", "--max-parents=0", "HEAD"], {
@@ -85397,6 +85596,7 @@ function applyLinkDecision(root, profile, config2, decision, now = Date.now) {
     projectLocator: decision.locator
   };
   delete nextProfile.projectLinkDisabled;
+  delete nextProfile.projectLinkHold;
   let wroteIgnore = false;
   if (decision.writeIgnoreStarter !== false) {
     const target = join37(root, ".errataignore");
@@ -85793,9 +85993,9 @@ async function startMultiDaemon(opts = {}) {
     if (identityBlocks.delete(wsId)) console.log(`[identity] workspace unblocked \u2014 spooled capture drains on this pass`);
   };
   const projectHolds = /* @__PURE__ */ new Map();
-  const noteProjectHold = (wsId, wsName, reason) => {
+  const noteProjectHold = (wsId, wsName, reason, claimRoot) => {
     if (!projectHolds.has(wsId)) {
-      projectHolds.set(wsId, { workspace: wsName, reason, since: Date.now() });
+      projectHolds.set(wsId, { workspace: wsName, reason, since: Date.now(), ...claimRoot ? { claimRoot } : {} });
       console.error(
         `[project] HOLDING cloud push for workspace "${wsName}": cannot prove its project \u2014 ${reason}. Shipping without the assertion would publish project-scoped knowledge to the whole org; the batch stays pending instead.`
       );
@@ -85804,6 +86004,14 @@ async function startMultiDaemon(opts = {}) {
   const clearProjectHold = (wsId) => {
     if (projectHolds.delete(wsId)) console.log(`[project] project assertion restored \u2014 held contributions drain on this pass`);
   };
+  const releaseSettledClaimHolds = () => {
+    for (const [wsId, hold] of projectHolds) {
+      if (hold.claimRoot && !claimHoldStands(loadProfile(hold.claimRoot))) {
+        projectHolds.delete(wsId);
+        console.log(`[project] claim hold on "${hold.workspace}" settled by \`errata link\` \u2014 ships on the next pass`);
+      }
+    }
+  };
   const cloudForIdentity = (identity) => {
     if (identity.invalid) return blockedCloudClient(identity.reason);
     if (identity.rule === "workspace-binding" && identity.profileName) {
@@ -85898,35 +86106,38 @@ async function startMultiDaemon(opts = {}) {
     if (detail) boundaryFlushDetail = detail;
     if (units > 0 || items > 0) boundaryFlushLastAdvanceAt = Date.now();
   };
-  const flushSnapshot = () => ({
-    running: boundaryFlushing,
-    stage: boundaryFlushStage,
-    detail: boundaryFlushDetail,
-    ageMs: boundaryFlushStartedAt ? Date.now() - boundaryFlushStartedAt : 0,
-    units: boundaryFlushUnits,
-    items: boundaryFlushItems,
-    chunks: boundaryFlushBatches,
-    stalledMs: boundaryFlushLastAdvanceAt ? Date.now() - boundaryFlushLastAdvanceAt : 0,
-    // Held workspaces, so a hold is REPORTABLE and not merely logged once at the
-    // transition. `errata status` reads this rather than the on-disk profile:
-    // the profile records what the workspace INTENDS to assert, which is why
-    // status could print "→ project 019f462d" for hours while every batch was
-    // being held or shipped unlinked. A hold is the daemon's actual behavior.
-    holds: [
-      ...[...projectHolds.values()].map((h) => ({
-        workspace: h.workspace,
-        kind: "project",
-        reason: h.reason,
-        sinceMs: Date.now() - h.since
-      })),
-      ...[...identityBlocks.values()].map((h) => ({
-        workspace: h.workspace,
-        kind: "identity",
-        reason: h.reason,
-        sinceMs: Date.now() - h.since
-      }))
-    ]
-  });
+  const flushSnapshot = () => {
+    releaseSettledClaimHolds();
+    return {
+      running: boundaryFlushing,
+      stage: boundaryFlushStage,
+      detail: boundaryFlushDetail,
+      ageMs: boundaryFlushStartedAt ? Date.now() - boundaryFlushStartedAt : 0,
+      units: boundaryFlushUnits,
+      items: boundaryFlushItems,
+      chunks: boundaryFlushBatches,
+      stalledMs: boundaryFlushLastAdvanceAt ? Date.now() - boundaryFlushLastAdvanceAt : 0,
+      // Held workspaces, so a hold is REPORTABLE and not merely logged once at the
+      // transition. `errata status` reads this rather than the on-disk profile:
+      // the profile records what the workspace INTENDS to assert, which is why
+      // status could print "→ project 019f462d" for hours while every batch was
+      // being held or shipped unlinked. A hold is the daemon's actual behavior.
+      holds: [
+        ...[...projectHolds.values()].map((h) => ({
+          workspace: h.workspace,
+          kind: "project",
+          reason: h.reason,
+          sinceMs: Date.now() - h.since
+        })),
+        ...[...identityBlocks.values()].map((h) => ({
+          workspace: h.workspace,
+          kind: "identity",
+          reason: h.reason,
+          sinceMs: Date.now() - h.since
+        }))
+      ]
+    };
+  };
   const endFlush = () => {
     boundaryFlushing = false;
     boundaryFlushStage = "";
@@ -86307,6 +86518,10 @@ async function startMultiDaemon(opts = {}) {
   app.post("/api/message", (c) => forward(c, cwdOf, { affinity: "follow" }));
   app.post("/api/session-end", (c) => forward(c, cwdOf, { affinity: "follow" }));
   app.post("/api/context-inject", (c) => forward(c, cwdOf, { affinity: "follow" }));
+  app.post("/api/statusline", async (c) => {
+    const body2 = await c.req.json().catch(() => ({}));
+    return c.text(statuslineText(String(body2["session_id"] ?? "")));
+  });
   for (const r of records) {
     mountedIds.add(r.id);
     app.route(`/ws/${r.id}`, r.webApp);
@@ -86380,9 +86595,9 @@ async function startMultiDaemon(opts = {}) {
   const reindexAll = async (rOpts) => {
     const out2 = /* @__PURE__ */ new Map();
     const toIndex = records.filter((r) => rOpts?.force || r.engine.store.nodeCount() === 0);
-    const plural = (n) => `repositor${n === 1 ? "y" : "ies"}`;
+    const plural2 = (n) => `repositor${n === 1 ? "y" : "ies"}`;
     if (toIndex.length > 0) {
-      notifyEvent("index-started", `Indexing ${toIndex.length} ${plural(toIndex.length)}\u2026`);
+      notifyEvent("index-started", `Indexing ${toIndex.length} ${plural2(toIndex.length)}\u2026`);
     }
     let indexed = 0;
     for (const r of records) {
@@ -86404,7 +86619,7 @@ async function startMultiDaemon(opts = {}) {
       }
     }
     if (toIndex.length > 0) {
-      notifyEvent("index-completed", `Indexed ${indexed} ${plural(indexed)}`);
+      notifyEvent("index-completed", `Indexed ${indexed} ${plural2(indexed)}`);
     }
     return out2;
   };
@@ -86503,8 +86718,10 @@ async function startMultiDaemon(opts = {}) {
     if (!hasCloudCredential(c)) return;
     const client = cloudNow();
     for (const r of records) {
-      if (!effectiveConsent(c, r.engine.profile).sync) continue;
-      const out2 = await ensureProjectLink(r.root, r.engine.profile, client);
+      const working = loadProfile(r.root) ?? r.engine.profile;
+      if (!effectiveConsent(c, working).sync) continue;
+      const out2 = await ensureProjectLink(r.root, working, client);
+      if (working !== r.engine.profile) adoptLinkFields(r.engine.profile, working);
       if (out2.linked) {
         console.log(
           `[errata] linked ${r.engine.profile.name} \u2192 project ${out2.projectId}${out2.created ? " (created)" : ""}`
@@ -86512,7 +86729,7 @@ async function startMultiDaemon(opts = {}) {
       } else if (out2.reason === "error") {
         console.warn(`[errata] project link failed for ${r.engine.profile.name}: ${out2.detail}`);
       } else if (out2.reason === "held") {
-        noteProjectHold(r.id, r.engine.profile.name, out2.detail);
+        noteProjectHold(r.id, r.engine.profile.name, out2.detail, r.root);
       }
       let primeSalt = null;
       if (r.engine.profile.projectId && !r.engine.profile.projectHydratedAt) {
@@ -86976,7 +87193,8 @@ async function startMultiDaemon(opts = {}) {
           noteProjectHold(
             r.id,
             r.entry.name,
-            "this repo is already on errata in another workspace \u2014 run `errata link` to join it or create your own project"
+            "this repo is already on errata in another workspace \u2014 run `errata link` to join it or create your own project",
+            r.root
           );
           continue;
         }
@@ -87935,6 +88153,7 @@ try {
   const event = payload.hook_event_name;
   if (!Number.isInteger(port) || port < 1 || port > 65535) process.exit(0);
   const contexts = [];
+  const messages = [];
   const post = async (endpoint, relay = false) => {
     try {
       const response = await fetch('http://127.0.0.1:' + port + '/api/' + endpoint, {
@@ -87945,6 +88164,8 @@ try {
       const result = await response.json();
       const context = result.hookSpecificOutput?.additionalContext;
       if (typeof context === 'string' && context.trim()) contexts.push(context);
+      // The user-visible recall card; Codex renders it inline as '↳ Hook · …'.
+      if (typeof result.systemMessage === 'string' && result.systemMessage.trim()) messages.push(result.systemMessage);
     } catch { /* An unavailable daemon must never block the agent. */ }
   };
   if (event === 'PreToolUse' || event === 'PostToolUse') await post('hook', true);
@@ -87955,10 +88176,13 @@ try {
     // Background extraction finishing later arrives at the next tool boundary.
     await post('context-inject', true);
   }
-  if (contexts.length) {
-    process.stdout.write(JSON.stringify({ hookSpecificOutput: {
-      hookEventName: event, additionalContext: contexts.join('\n\n'),
-    } }));
+  if (contexts.length || messages.length) {
+    process.stdout.write(JSON.stringify({
+      ...(messages.length ? { systemMessage: messages.join('\n\n') } : {}),
+      ...(contexts.length ? { hookSpecificOutput: {
+        hookEventName: event, additionalContext: contexts.join('\n\n'),
+      } } : {}),
+    }));
   }
 } catch { /* Invalid input is also fail-open. */ }
 `;
@@ -88152,6 +88376,45 @@ function consolidationGapMs(lastPassMs, policy) {
   return Math.max(policy.baseFloorMs, lastPassMs * policy.dutyFactor);
 }
 
+// src/claude-statusline.ts
+import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync26 } from "node:fs";
+import { join as join41 } from "node:path";
+var STATUSLINE_RELAY_SOURCE = String.raw`// errata-managed: regenerated by errata install-hooks claude
+import { readFileSync } from 'node:fs';
+
+try {
+  const port = Number(process.argv[2]);
+  if (Number.isInteger(port) && port > 0 && port < 65536) {
+    const response = await fetch('http://127.0.0.1:' + port + '/api/statusline', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: readFileSync(0, 'utf8') || '{}', signal: AbortSignal.timeout(800),
+    });
+    if (response.ok) process.stdout.write(await response.text());
+  }
+} catch { /* An unavailable daemon leaves the status line empty. */ }
+`;
+var STATUSLINE_RELAY_FILE = "errata-statusline.mjs";
+function buildStatusLine(port, nodePath, relayPath) {
+  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("Invalid status line port");
+  const q = (p) => {
+    if (/["$`\r\n]/.test(p)) throw new Error("Unsupported character in status line path");
+    return `"${p.replace(/\\/g, "/")}"`;
+  };
+  return { type: "command", command: `${q(nodePath)} ${q(relayPath)} ${port}`, padding: 0 };
+}
+function isErrataStatusLine(value) {
+  return !!value && typeof value === "object" && typeof value["command"] === "string" && value["command"].includes(STATUSLINE_RELAY_FILE);
+}
+function installStatusLine(settings, root, port, nodePath = process.execPath) {
+  if (settings["statusLine"] !== void 0 && !isErrataStatusLine(settings["statusLine"])) return false;
+  const dir = join41(root, ".claude", "hooks");
+  const relay = join41(dir, STATUSLINE_RELAY_FILE);
+  mkdirSync10(dir, { recursive: true });
+  writeFileSync26(relay, STATUSLINE_RELAY_SOURCE, "utf8");
+  settings["statusLine"] = buildStatusLine(port, nodePath, relay);
+  return true;
+}
+
 // src/opencode-plugin.ts
 var OPENCODE_PLUGIN_MARKER = "// @inerrata opencode plugin \u2014 errata-managed (errata install-hooks opencode)";
 var OPENCODE_D1_CONTRACT = "Behavioral contract: (1) On ANY error, call search() BEFORE debugging \u2014 costs ~400 tokens vs 5,000\u201350,000 cold. (2) After solving non-trivial problems, contribute back: if your harness emits typed nodes (canonicalId + label + attrs), use ingest \u2014 the typed door; otherwise call contribute(), the prose fallback. (3) Before web search, try search() first \u2014 graph is 2\u201315\xD7 cheaper. (4) At session end, review what you solved and contribute anything novel.";
@@ -88558,13 +88821,13 @@ async function cmdInit() {
     console.log("");
     console.log("installing harness hooks...");
     const { existsSync: existsSync35 } = await import("node:fs");
-    const { join: join42 } = await import("node:path");
+    const { join: join43 } = await import("node:path");
     try {
       await installClaudeHooks(port);
     } catch (err2) {
       console.warn(`  \u26A0\uFE0F  Claude hook install failed: ${err2 instanceof Error ? err2.message : err2}`);
     }
-    if (existsSync35(join42(ROOT, ".cursor"))) {
+    if (existsSync35(join43(ROOT, ".cursor"))) {
       try {
         await installCursorMcpConfig();
       } catch (err2) {
@@ -89389,7 +89652,6 @@ async function cmdLink(args2) {
     return;
   }
   delete profile.projectLinkDisabled;
-  delete profile.projectLinkHold;
   const remote = flag("--remote");
   if (remote) {
     const loc = detectRepoLocator(ROOT, remote);
@@ -90439,7 +90701,7 @@ async function gatherReportData(generatedAt) {
   };
 }
 async function cmdReport(args2) {
-  const { mkdirSync: mkdirSync10, writeFileSync: writeFileSync26 } = await import("node:fs");
+  const { mkdirSync: mkdirSync11, writeFileSync: writeFileSync27 } = await import("node:fs");
   const { renderReport: renderReport2 } = await Promise.resolve().then(() => (init_report_render(), report_render_exports));
   const includeFutureVerbs = args2.includes("--future-verbs");
   const now = /* @__PURE__ */ new Date();
@@ -90450,10 +90712,10 @@ async function cmdReport(args2) {
     process.exit(2);
   }
   const outDir = workspacePaths(ROOT).configDir;
-  mkdirSync10(outDir, { recursive: true });
+  mkdirSync11(outDir, { recursive: true });
   const files = renderReport2(data, { includeFutureVerbs });
-  for (const f of files) writeFileSync26(join41(outDir, f.name), f.html, "utf8");
-  const indexPath = join41(outDir, "report.html");
+  for (const f of files) writeFileSync27(join42(outDir, f.name), f.html, "utf8");
+  const indexPath = join42(outDir, "report.html");
   console.log(`report \u2192 ${indexPath}`);
   console.log(
     `  ${data.repos.length} repo(s) \xB7 ${files.length} file(s) \xB7 ${data.rollup.nodes.toLocaleString("en-US")} nodes`
@@ -90573,11 +90835,11 @@ async function cmdInstallHooks(args2) {
   }
 }
 async function installOpencodePlugin(port) {
-  const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join42 } = await import("node:path");
-  const dir = join42(ROOT, ".opencode", "plugin");
-  if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join42(dir, "inerrata.js");
+  const { mkdirSync: mkdirSync11, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync27 } = await import("node:fs");
+  const { join: join43 } = await import("node:path");
+  const dir = join43(ROOT, ".opencode", "plugin");
+  if (!existsSync35(dir)) mkdirSync11(dir, { recursive: true });
+  const file2 = join43(dir, "inerrata.js");
   if (existsSync35(file2)) {
     const head2 = readFileSync36(file2, "utf8").split("\n")[0] ?? "";
     if (head2.trim() !== OPENCODE_PLUGIN_MARKER) {
@@ -90585,8 +90847,8 @@ async function installOpencodePlugin(port) {
       process.exit(2);
     }
   }
-  writeFileSync26(file2, buildOpencodePluginSource(port, { version: DAEMON_VERSION }), "utf8");
-  const cfgFile = join42(ROOT, "opencode.json");
+  writeFileSync27(file2, buildOpencodePluginSource(port, { version: DAEMON_VERSION }), "utf8");
+  const cfgFile = join43(ROOT, "opencode.json");
   let cfg = { $schema: "https://opencode.ai/config.json" };
   if (existsSync35(cfgFile)) {
     try {
@@ -90601,7 +90863,7 @@ async function installOpencodePlugin(port) {
   if (!hadErrata) {
     const inv = errataMcpInvocation();
     cfg.mcp["errata"] = { type: "local", command: [inv.command, ...inv.args] };
-    writeFileSync26(cfgFile, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+    writeFileSync27(cfgFile, JSON.stringify(cfg, null, 2) + "\n", "utf8");
   }
   console.log(`installed OpenCode plugin \u2192 ${file2}`);
   if (hadErrata) console.log(`  mcp.errata already present in ${cfgFile} \u2014 left untouched`);
@@ -90621,11 +90883,11 @@ function errataMcpInvocation() {
   return { command: cmd2, args: args2 };
 }
 async function installClaudeHooks(port) {
-  const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join42 } = await import("node:path");
-  const dir = join42(ROOT, ".claude");
-  if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join42(dir, "settings.json");
+  const { mkdirSync: mkdirSync11, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync27 } = await import("node:fs");
+  const { join: join43 } = await import("node:path");
+  const dir = join43(ROOT, ".claude");
+  if (!existsSync35(dir)) mkdirSync11(dir, { recursive: true });
+  const file2 = join43(dir, "settings.json");
   let settings = {};
   if (existsSync35(file2)) {
     try {
@@ -90647,7 +90909,8 @@ async function installClaudeHooks(port) {
   };
   for (const [event, command, eventMatcher] of [
     ["PreToolUse", preCmd, matcher],
-    ["PostToolUse", postCmd, postMatcher]
+    ["PostToolUse", postCmd, postMatcher],
+    ["PostToolUseFailure", postCmd, postMatcher]
   ]) {
     const list = settings.hooks[event] ??= [];
     dropErrata(list);
@@ -90675,10 +90938,20 @@ async function installClaudeHooks(port) {
     dropErrata(list);
     list.push({ hooks: [{ type: "command", command: injectCmd }] });
   }
-  writeFileSync26(file2, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  const { homedir: homedir8 } = await import("node:os");
+  let userStatusLine;
+  try {
+    userStatusLine = JSON.parse(readFileSync36(join43(homedir8(), ".claude", "settings.json"), "utf8"))["statusLine"];
+  } catch {
+  }
+  const statusLineInstalled = (userStatusLine === void 0 || isErrataStatusLine(userStatusLine)) && installStatusLine(settings, ROOT, port);
+  writeFileSync27(file2, JSON.stringify(settings, null, 2) + "\n", "utf8");
   console.log(`installed Claude Code hooks \u2192 ${file2}`);
+  console.log(
+    statusLineInstalled ? "  status line: errata recall card in colour (daemon env ERRATA_RECALL_CARD=off hides the cards)" : "  status line: kept your own \u2014 errata's recall card shows inline only"
+  );
   await installClaudeMcpConfig();
-  const claudeMd = join42(ROOT, "CLAUDE.md");
+  const claudeMd = join43(ROOT, "CLAUDE.md");
   const recall = writeManagedBlock(claudeMd, { body: RECALL_FIRST_BLOCK });
   if (recall.kind === "collision") {
     console.warn(
@@ -90690,11 +90963,11 @@ async function installClaudeHooks(port) {
   console.log(`  endpoint: http://127.0.0.1:${port}/api/hook`);
 }
 async function installClaudeMcpConfig() {
-  const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join42, dirname: dirname13 } = await import("node:path");
-  const file2 = join42(ROOT, ".mcp.json");
+  const { mkdirSync: mkdirSync11, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync27 } = await import("node:fs");
+  const { join: join43, dirname: dirname13 } = await import("node:path");
+  const file2 = join43(ROOT, ".mcp.json");
   const dir = dirname13(file2);
-  if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
+  if (!existsSync35(dir)) mkdirSync11(dir, { recursive: true });
   let cfg = {};
   if (existsSync35(file2)) {
     try {
@@ -90706,17 +90979,17 @@ async function installClaudeMcpConfig() {
   }
   cfg.mcpServers ??= {};
   cfg.mcpServers["errata"] = errataMcpInvocation();
-  writeFileSync26(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+  writeFileSync27(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
   console.log(`installed Claude Code MCP server config \u2192 ${file2}`);
   console.log(`  Claude Code will spawn \`errata mcp\` on workspace open.`);
   console.log(`  Tools: errata.search / locate / neighbors / callers_of / what_uses / show / similar`);
 }
 async function installCursorMcpConfig() {
-  const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join42 } = await import("node:path");
-  const dir = join42(ROOT, ".cursor");
-  if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join42(dir, "mcp.json");
+  const { mkdirSync: mkdirSync11, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync27 } = await import("node:fs");
+  const { join: join43 } = await import("node:path");
+  const dir = join43(ROOT, ".cursor");
+  if (!existsSync35(dir)) mkdirSync11(dir, { recursive: true });
+  const file2 = join43(dir, "mcp.json");
   let cfg = {};
   if (existsSync35(file2)) {
     try {
@@ -90728,7 +91001,7 @@ async function installCursorMcpConfig() {
   }
   cfg.mcpServers ??= {};
   cfg.mcpServers["errata"] = errataMcpInvocation();
-  writeFileSync26(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+  writeFileSync27(file2, JSON.stringify(cfg, null, 2) + "\n", "utf8");
   console.log(`installed Cursor MCP server config \u2192 ${file2}`);
   console.log(`  Cursor will spawn \`errata mcp\` on workspace open.`);
   console.log(`  Tools: errata.search / locate / neighbors / callers_of / what_uses`);
@@ -90739,7 +91012,7 @@ async function installCodexHooks(port) {
   const gitRoot = nearestGitRoot(process.cwd());
   const hookRoot = gitRoot && mainCheckoutOfWorktree(gitRoot) ? gitRoot : ROOT;
   const file2 = writeCodexHooks(hookRoot, port);
-  const instructions = writeManagedBlock(join41(hookRoot, "AGENTS.md"), {
+  const instructions = writeManagedBlock(join42(hookRoot, "AGENTS.md"), {
     body: AGENTS_POINTER_BODY,
     stable: true
   });
@@ -91143,7 +91416,7 @@ async function cmdDash(args2) {
       await yieldToLoop2();
       try {
         const items = selectDurableMemory(handle2.sharedStore, r.engine.profile);
-        const res = bleedRules(join41(r.root, ".claude", "rules"), items);
+        const res = bleedRules(join42(r.root, ".claude", "rules"), items);
         if (res.written || res.pruned) {
           console.log(
             `[rules:${r.entry.name}] ${res.written} collective principle(s) \u2192 .claude/rules` + (res.pruned ? `, ${res.pruned} pruned` : "")

package/package.json

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