@inerrata-corporation/errata 2.0.6-dev.2759 → 2.0.6

package/README.txt

@@ -34,9 +34,12 @@ errata link flows also refresh detected Codex hooks; --skip-hooks opts out of
 either automatic install. The installer preserves other config and writes its
 Node relay into .codex/hooks/errata-relay.mjs. No curl or Bash dependency.
 
-Restart/resume Codex after installing, and review/trust the hooks with /hooks.
-If your Codex build gates hooks, enable [features] codex_hooks = true. Update
-older Codex builds if UserPromptSubmit or tool hooks are unsupported.
+Codex desktop: open Settings > Hooks, select the project, expand each event,
+and review/Trust its Errata hook. Use Reload hooks after installation. No
+standalone Codex CLI is required. CLI users can use /hooks instead.
+Restarting or reinstalling does not grant trust. Run errata doctor to check
+activation; it discovers the Windows desktop runtime even without a CLI on PATH.
+Respect explicitly disabled hooks ([features] hooks = false).
 
 SessionStart injects .errata/context.md, including startup/resume/compaction.
 UserPromptSubmit and PostToolUse inject it again only when it changes. Tool

package/errata.mjs

@@ -17038,6 +17038,11 @@ var init_context_file = __esm({
       "Live agent context for this checkout \u2014 priors, open problems, the capture",
       "protocol \u2014 is maintained by the errata daemon at `.errata/context.md`.",
       "",
+      "At the beginning of each task and each new user turn, read that file before",
+      "substantive work. Use the current file in preference to an earlier snapshot.",
+      "If it is absent, continue normally. In Codex, an `@` mention alone does not",
+      "load the file; read it explicitly.",
+      "",
       "It is gitignored ON PURPOSE: it is this machine's runtime state, not repo",
       "content. Committing it would prime your teammates with your graph.",
       "",
@@ -26301,8 +26306,8 @@ var init_config = __esm({
     "use strict";
     init_paths();
     LEGACY_CLOUD_URL = "https://inerrata-gateway.onrender.com";
-    DEFAULT_CLOUD_URL = true ? "https://dev.inerrata.dev" : DEV_CLOUD_URL;
-    DEFAULT_UPDATE_CHANNEL = false ? "latest" : "dev";
+    DEFAULT_CLOUD_URL = true ? "https://inerrata.dev" : DEV_CLOUD_URL;
+    DEFAULT_UPDATE_CHANNEL = true ? "latest" : "dev";
   }
 });
 
@@ -71187,8 +71192,8 @@ 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 statSync8 } from "node:fs";
-import { join as join40, resolve as pathResolve2 } from "node:path";
+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 { spawn as spawn5 } from "node:child_process";
 
 // src/daemon.ts
@@ -73721,6 +73726,7 @@ init_src10();
 init_review2();
 
 // src/turn.ts
+init_checkout_root();
 import { closeSync, existsSync as existsSync16, fstatSync, openSync, readdirSync as readdirSync6, readSync, realpathSync, statSync as statSync5 } from "node:fs";
 import { basename as basename5, delimiter, dirname as dirname10, join as join19, normalize as normalize3 } from "node:path";
 import { homedir as homedir4 } from "node:os";
@@ -74205,6 +74211,8 @@ function codexRolloutsForCwd(cwd, opts = {}) {
   const sinceMs = opts.sinceMs ?? 0;
   const limit = opts.limit ?? 25;
   const out2 = [];
+  const owner = checkoutRootOf(cwd);
+  const owners = /* @__PURE__ */ new Map();
   for (const root of codexSessionRoots(opts.env, opts.home)) {
     if (!existsSync16(root)) continue;
     const stack = [{ dir: root, depth: 0 }];
@@ -74231,7 +74239,14 @@ function codexRolloutsForCwd(cwd, opts = {}) {
         if (depth < 3) continue;
         if (!name2.startsWith("rollout-") || !name2.endsWith(".jsonl")) continue;
         if (st.mtimeMs < sinceMs) continue;
-        if (readCodexRolloutCwd(full) !== cwd) continue;
+        const sessionCwd = readCodexRolloutCwd(full);
+        if (sessionCwd === null) continue;
+        let sessionOwner = owners.get(sessionCwd);
+        if (sessionOwner === void 0) {
+          sessionOwner = checkoutRootOf(sessionCwd);
+          owners.set(sessionCwd, sessionOwner);
+        }
+        if (sessionOwner !== owner) continue;
         out2.push({ path: full, sessionId: `codex:${basename5(name2, ".jsonl")}`, mtimeMs: st.mtimeMs });
       }
     }
@@ -79907,7 +79922,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.6-dev.2759" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.6" : "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;
@@ -87636,9 +87651,41 @@ function shouldUseOAuthLogin(flags2, env2 = process.env) {
 
 // src/doctor.ts
 import { spawnSync } from "node:child_process";
+
+// src/codex-runtime.ts
+import { readdirSync as readdirSync12, statSync as statSync8 } from "node:fs";
+import { join as join39 } from "node:path";
+function resolveCodexExecutable(options = {}) {
+  const platform = options.platform ?? process.platform;
+  const env2 = options.env ?? process.env;
+  if (platform !== "win32") return "codex";
+  const fileTime = (path2) => {
+    try {
+      const s = statSync8(path2);
+      return s.isFile() ? s.mtimeMs : null;
+    } catch {
+      return null;
+    }
+  };
+  for (const dir of (env2["PATH"] ?? env2["Path"] ?? "").split(";")) {
+    if (!dir.trim()) continue;
+    const path2 = join39(dir.trim().replace(/^"|"$/g, ""), "codex.exe");
+    if (fileTime(path2) !== null) return path2;
+  }
+  if (!env2["LOCALAPPDATA"]) return "codex";
+  const root = join39(env2["LOCALAPPDATA"], "OpenAI", "Codex", "bin");
+  try {
+    const candidates = readdirSync12(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => join39(root, entry.name, "codex.exe")).map((path2) => ({ path: path2, mtime: fileTime(path2) })).filter((candidate) => candidate.mtime !== null).sort((a, b) => b.mtime - a.mtime || a.path.localeCompare(b.path));
+    return candidates[0]?.path ?? "codex";
+  } catch {
+    return "codex";
+  }
+}
+
+// src/doctor.ts
 function installedHarnessVersion(bin) {
   try {
-    const r = spawnSync(bin, ["--version"], { encoding: "utf8", timeout: 3e3 });
+    const r = spawnSync(bin === "codex" ? resolveCodexExecutable() : bin, ["--version"], { encoding: "utf8", timeout: 3e3, windowsHide: true });
     if (r.status !== 0 && !r.stdout) return null;
     const m = /(\d+\.\d+\.\d+)/.exec(`${r.stdout ?? ""}${r.stderr ?? ""}`);
     return m ? m[1] : null;
@@ -87745,9 +87792,112 @@ async function diagnoseInstallation(cfg, dependencies) {
 // src/codex-doctor.ts
 import { spawn as spawn4 } from "node:child_process";
 import { createInterface } from "node:readline";
+
+// src/codex-hooks.ts
+import { existsSync as existsSync33, mkdirSync as mkdirSync9, readFileSync as readFileSync34, writeFileSync as writeFileSync25 } from "node:fs";
+import { homedir as homedir7 } from "node:os";
+import { join as join40 } from "node:path";
+
+// src/hook-commands.ts
+function hookCurlCommand(port, path2 = "/api/hook") {
+  const url2 = `http://127.0.0.1:${port}${path2}`;
+  return process.platform === "win32" ? `cmd //c "curl -s --connect-timeout 1 --max-time 3 -X POST -H \\"Content-Type: application/json\\" --data-binary @- ${url2} >NUL 2>NUL || exit /b 0"` : `curl -s --connect-timeout 1 --max-time 3 -X POST -H 'Content-Type: application/json' --data-binary @- ${url2} >/dev/null 2>&1 || true`;
+}
+function hookRelayCommand(port, path2) {
+  const url2 = `http://127.0.0.1:${port}${path2}`;
+  return process.platform === "win32" ? `cmd //c "curl -s --connect-timeout 1 --max-time 2 -X POST -H \\"Content-Type: application/json\\" --data-binary @- ${url2} 2>NUL || echo {}"` : `curl -s --connect-timeout 1 --max-time 2 -X POST -H 'Content-Type: application/json' --data-binary @- ${url2} 2>/dev/null || echo '{}'`;
+}
+var CODEX_HOOKS_BEGIN = `# >>> errata hooks (errata-managed)`;
+var CODEX_HOOKS_END = `# <<< errata hooks`;
+function buildCodexHooksToml(port, options) {
+  const platform = options.platform ?? process.platform;
+  const quote = (value) => {
+    if (platform === "win32") {
+      if (/["%\r\n]/.test(value)) throw new Error("Unsupported character in Codex hook path");
+      return '"' + value + '"';
+    }
+    return "'" + value.replace(/'/g, "'\\''") + "'";
+  };
+  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("Invalid hook port");
+  const command = quote(options.nodePath) + " " + quote(options.relayPath) + " " + port;
+  const handlers = ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "Stop"].map(
+    (event) => "[[hooks." + event + "]]\n" + (["UserPromptSubmit", "Stop"].includes(event) ? "" : 'matcher = ".*"\n') + "\n[[hooks." + event + '.hooks]]\ntype = "command"\ncommand = ' + JSON.stringify(command) + "\ntimeout = 10\nadditionalContextLimit = 5000\n"
+  );
+  return CODEX_HOOKS_BEGIN + "\n" + handlers.join("\n") + CODEX_HOOKS_END + "\n";
+}
+
+// src/codex-hook-relay.ts
+var CODEX_RELAY_SOURCE = String.raw`// errata-managed: regenerated by errata install-hooks codex
+import { readFileSync } from 'node:fs';
+
+try {
+  const payload = JSON.parse(readFileSync(0, 'utf8') || '{}');
+  const port = Number(process.argv[2]);
+  const event = payload.hook_event_name;
+  if (!Number.isInteger(port) || port < 1 || port > 65535) process.exit(0);
+  const contexts = [];
+  const post = async (endpoint, relay = false) => {
+    try {
+      const response = await fetch('http://127.0.0.1:' + port + '/api/' + endpoint, {
+        method: 'POST', headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload), signal: AbortSignal.timeout(2000),
+      });
+      if (!response.ok || !relay) return;
+      const result = await response.json();
+      const context = result.hookSpecificOutput?.additionalContext;
+      if (typeof context === 'string' && context.trim()) contexts.push(context);
+    } catch { /* An unavailable daemon must never block the agent. */ }
+  };
+  if (event === 'PreToolUse' || event === 'PostToolUse') await post('hook', true);
+  // Stop sees the final assistant message, including turns with no tools.
+  if (event === 'PostToolUse' || event === 'Stop') await post('turn');
+  if (['SessionStart', 'UserPromptSubmit', 'PostToolUse'].includes(event)) {
+    // Run after capture, so changes already rendered by the daemon arrive now.
+    // 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'),
+    } }));
+  }
+} catch { /* Invalid input is also fail-open. */ }
+`;
+
+// src/codex-hooks.ts
+var CODEX_HOOK_REVIEW_HELP = "Codex desktop: Settings > Hooks, select this project, expand each event and Trust the Errata hook. CLI users can use /hooks.";
+function hasCodexConfig(root, codexHome = process.env["CODEX_HOME"] || join40(homedir7(), ".codex")) {
+  return existsSync33(join40(root, ".codex")) || existsSync33(codexHome);
+}
+function replaceCodexHooks(existing, block) {
+  const begin = existing.indexOf(CODEX_HOOKS_BEGIN);
+  const end = existing.indexOf(CODEX_HOOKS_END);
+  if (begin >= 0 || end >= 0) {
+    if (begin < 0 || end < begin || existing.indexOf(CODEX_HOOKS_BEGIN, begin + CODEX_HOOKS_BEGIN.length) >= 0) {
+      throw new Error(
+        "Incomplete or duplicate errata hooks markers in .codex/config.toml; repair them before reinstalling."
+      );
+    }
+    return existing.slice(0, begin) + block.trimEnd() + existing.slice(end + CODEX_HOOKS_END.length);
+  }
+  return existing.trimEnd() + (existing.trim() ? "\n\n" : "") + block;
+}
+function writeCodexHooks(root, port, nodePath = process.execPath) {
+  const dir = join40(root, ".codex");
+  const file2 = join40(dir, "config.toml");
+  const relay = join40(dir, "hooks", "errata-relay.mjs");
+  const block = buildCodexHooksToml(port, { nodePath, relayPath: relay });
+  const final = replaceCodexHooks(existsSync33(file2) ? readFileSync34(file2, "utf8") : "", block);
+  mkdirSync9(join40(dir, "hooks"), { recursive: true });
+  writeFileSync25(relay, CODEX_RELAY_SOURCE, "utf8");
+  writeFileSync25(file2, final, "utf8");
+  return file2;
+}
+
+// src/codex-doctor.ts
 function readCodexHookState(cwd, options = {}) {
   return new Promise((resolve7, reject) => {
-    const child = spawn4(options.bin ?? "codex", options.args ?? ["app-server", "--stdio"], {
+    const child = spawn4(options.bin ?? resolveCodexExecutable(), options.args ?? ["app-server", "--stdio"], {
       cwd,
       windowsHide: true,
       stdio: ["pipe", "pipe", "pipe"]
@@ -87770,7 +87920,7 @@ function readCodexHookState(cwd, options = {}) {
     const send = (id, method, params) => {
       child.stdin.write(JSON.stringify({ id, method, params }) + "\n");
     };
-    child.on("error", () => finish(new Error("Codex could not be started for hook inspection")));
+    child.on("error", () => finish(new Error(`Codex could not be started for hook inspection. ${CODEX_HOOK_REVIEW_HELP}`)));
     child.on("exit", () => finish(new Error("Codex exited before returning its hook state")));
     child.stdin.on("error", () => finish(new Error("Codex hook inspection connection closed")));
     child.stderr.resume();
@@ -87787,7 +87937,7 @@ function readCodexHookState(cwd, options = {}) {
         return;
       }
       if (![1, 2, 3].includes(message2.id)) return;
-      if (message2.error) return finish(new Error("Codex does not support hook inspection; update Codex and review /hooks"));
+      if (message2.error) return finish(new Error(`Codex does not support hook inspection. ${CODEX_HOOK_REVIEW_HELP}`));
       if (message2.id === 1) {
         child.stdin.write(JSON.stringify({ method: "initialized" }) + "\n");
         send(2, "hooks/list", { cwds: [cwd] });
@@ -87810,7 +87960,7 @@ function readCodexHookState(cwd, options = {}) {
 }
 function assessCodexHooks(state) {
   const check2 = (status, detail) => [{ id: "codex_hooks", status, detail }];
-  if (state.errors?.length) return check2("fail", "Codex could not load hook configuration; inspect /hooks for errors");
+  if (state.errors?.length) return check2("fail", `Codex could not load hook configuration. ${CODEX_HOOK_REVIEW_HELP}`);
   if ((state.features?.hooks ?? state.features?.codex_hooks) === false) {
     return check2("fail", "Codex hooks are explicitly disabled; left unchanged");
   }
@@ -87819,9 +87969,9 @@ function assessCodexHooks(state) {
   const missing = required2.filter((event) => !hooks.some((h) => h.eventName === event));
   const checks = [];
   if (missing.length) checks.push(...check2("fail", `Errata hooks missing or outdated in this checkout (${missing.join(", ")}); run errata install-hooks codex here`));
-  if (hooks.some((h) => !h.enabled)) checks.push(...check2("fail", "Errata hooks are disabled in Codex; review /hooks; left unchanged"));
+  if (hooks.some((h) => !h.enabled)) checks.push(...check2("fail", `Errata hooks are disabled in Codex; left unchanged. ${CODEX_HOOK_REVIEW_HELP}`));
   if (hooks.some((h) => !["trusted", "managed"].includes(h.trustStatus))) {
-    checks.push(...check2("fail", "Errata hooks need review/trust in Codex /hooks before they can run; project trust is separate"));
+    checks.push(...check2("fail", `Errata hooks need review/trust before they can run; project trust is separate. ${CODEX_HOOK_REVIEW_HELP}`));
   }
   return checks.length ? checks : check2("pass", "Codex discovers enabled, trusted Errata hooks; verify live context and capture in a session");
 }
@@ -87903,106 +88053,6 @@ function consolidationGapMs(lastPassMs, policy) {
   return Math.max(policy.baseFloorMs, lastPassMs * policy.dutyFactor);
 }
 
-// src/hook-commands.ts
-function hookCurlCommand(port, path2 = "/api/hook") {
-  const url2 = `http://127.0.0.1:${port}${path2}`;
-  return process.platform === "win32" ? `cmd //c "curl -s --connect-timeout 1 --max-time 3 -X POST -H \\"Content-Type: application/json\\" --data-binary @- ${url2} >NUL 2>NUL || exit /b 0"` : `curl -s --connect-timeout 1 --max-time 3 -X POST -H 'Content-Type: application/json' --data-binary @- ${url2} >/dev/null 2>&1 || true`;
-}
-function hookRelayCommand(port, path2) {
-  const url2 = `http://127.0.0.1:${port}${path2}`;
-  return process.platform === "win32" ? `cmd //c "curl -s --connect-timeout 1 --max-time 2 -X POST -H \\"Content-Type: application/json\\" --data-binary @- ${url2} 2>NUL || echo {}"` : `curl -s --connect-timeout 1 --max-time 2 -X POST -H 'Content-Type: application/json' --data-binary @- ${url2} 2>/dev/null || echo '{}'`;
-}
-var CODEX_HOOKS_BEGIN = `# >>> errata hooks (errata-managed)`;
-var CODEX_HOOKS_END = `# <<< errata hooks`;
-function buildCodexHooksToml(port, options) {
-  const platform = options.platform ?? process.platform;
-  const quote = (value) => {
-    if (platform === "win32") {
-      if (/["%\r\n]/.test(value)) throw new Error("Unsupported character in Codex hook path");
-      return '"' + value + '"';
-    }
-    return "'" + value.replace(/'/g, "'\\''") + "'";
-  };
-  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("Invalid hook port");
-  const command = quote(options.nodePath) + " " + quote(options.relayPath) + " " + port;
-  const handlers = ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "Stop"].map(
-    (event) => "[[hooks." + event + "]]\n" + (["UserPromptSubmit", "Stop"].includes(event) ? "" : 'matcher = ".*"\n') + "\n[[hooks." + event + '.hooks]]\ntype = "command"\ncommand = ' + JSON.stringify(command) + "\ntimeout = 10\nadditionalContextLimit = 5000\n"
-  );
-  return CODEX_HOOKS_BEGIN + "\n" + handlers.join("\n") + CODEX_HOOKS_END + "\n";
-}
-
-// src/codex-hooks.ts
-import { existsSync as existsSync33, mkdirSync as mkdirSync9, readFileSync as readFileSync34, writeFileSync as writeFileSync25 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
-import { join as join39 } from "node:path";
-
-// src/codex-hook-relay.ts
-var CODEX_RELAY_SOURCE = String.raw`// errata-managed: regenerated by errata install-hooks codex
-import { readFileSync } from 'node:fs';
-
-try {
-  const payload = JSON.parse(readFileSync(0, 'utf8') || '{}');
-  const port = Number(process.argv[2]);
-  const event = payload.hook_event_name;
-  if (!Number.isInteger(port) || port < 1 || port > 65535) process.exit(0);
-  const contexts = [];
-  const post = async (endpoint, relay = false) => {
-    try {
-      const response = await fetch('http://127.0.0.1:' + port + '/api/' + endpoint, {
-        method: 'POST', headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(payload), signal: AbortSignal.timeout(2000),
-      });
-      if (!response.ok || !relay) return;
-      const result = await response.json();
-      const context = result.hookSpecificOutput?.additionalContext;
-      if (typeof context === 'string' && context.trim()) contexts.push(context);
-    } catch { /* An unavailable daemon must never block the agent. */ }
-  };
-  if (event === 'PreToolUse' || event === 'PostToolUse') await post('hook', true);
-  // Stop sees the final assistant message, including turns with no tools.
-  if (event === 'PostToolUse' || event === 'Stop') await post('turn');
-  if (['SessionStart', 'UserPromptSubmit', 'PostToolUse'].includes(event)) {
-    // Run after capture, so changes already rendered by the daemon arrive now.
-    // 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'),
-    } }));
-  }
-} catch { /* Invalid input is also fail-open. */ }
-`;
-
-// src/codex-hooks.ts
-function hasCodexConfig(root, codexHome = process.env["CODEX_HOME"] || join39(homedir7(), ".codex")) {
-  return existsSync33(join39(root, ".codex")) || existsSync33(codexHome);
-}
-function replaceCodexHooks(existing, block) {
-  const begin = existing.indexOf(CODEX_HOOKS_BEGIN);
-  const end = existing.indexOf(CODEX_HOOKS_END);
-  if (begin >= 0 || end >= 0) {
-    if (begin < 0 || end < begin || existing.indexOf(CODEX_HOOKS_BEGIN, begin + CODEX_HOOKS_BEGIN.length) >= 0) {
-      throw new Error(
-        "Incomplete or duplicate errata hooks markers in .codex/config.toml; repair them before reinstalling."
-      );
-    }
-    return existing.slice(0, begin) + block.trimEnd() + existing.slice(end + CODEX_HOOKS_END.length);
-  }
-  return existing.trimEnd() + (existing.trim() ? "\n\n" : "") + block;
-}
-function writeCodexHooks(root, port, nodePath = process.execPath) {
-  const dir = join39(root, ".codex");
-  const file2 = join39(dir, "config.toml");
-  const relay = join39(dir, "hooks", "errata-relay.mjs");
-  const block = buildCodexHooksToml(port, { nodePath, relayPath: relay });
-  const final = replaceCodexHooks(existsSync33(file2) ? readFileSync34(file2, "utf8") : "", block);
-  mkdirSync9(join39(dir, "hooks"), { recursive: true });
-  writeFileSync25(relay, CODEX_RELAY_SOURCE, "utf8");
-  writeFileSync25(file2, final, "utf8");
-  return file2;
-}
-
 // 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.";
@@ -88409,13 +88459,13 @@ async function cmdInit() {
     console.log("");
     console.log("installing harness hooks...");
     const { existsSync: existsSync35 } = await import("node:fs");
-    const { join: join41 } = await import("node:path");
+    const { join: join42 } = 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(join41(ROOT, ".cursor"))) {
+    if (existsSync35(join42(ROOT, ".cursor"))) {
       try {
         await installCursorMcpConfig();
       } catch (err2) {
@@ -90243,8 +90293,8 @@ async function cmdReport(args2) {
   const outDir = workspacePaths(ROOT).configDir;
   mkdirSync10(outDir, { recursive: true });
   const files = renderReport2(data, { includeFutureVerbs });
-  for (const f of files) writeFileSync26(join40(outDir, f.name), f.html, "utf8");
-  const indexPath = join40(outDir, "report.html");
+  for (const f of files) writeFileSync26(join41(outDir, f.name), f.html, "utf8");
+  const indexPath = join41(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`
@@ -90299,7 +90349,7 @@ function spawnDaemonDetached(options = {}) {
   try {
     const logPath = daemonLogPath();
     try {
-      if (statSync8(logPath).size > 5 * 1024 * 1024) renameSync4(logPath, `${logPath}.1`);
+      if (statSync9(logPath).size > 5 * 1024 * 1024) renameSync4(logPath, `${logPath}.1`);
     } catch {
     }
     out2 = openSync2(logPath, "a");
@@ -90365,10 +90415,10 @@ async function cmdInstallHooks(args2) {
 }
 async function installOpencodePlugin(port) {
   const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join41 } = await import("node:path");
-  const dir = join41(ROOT, ".opencode", "plugin");
+  const { join: join42 } = await import("node:path");
+  const dir = join42(ROOT, ".opencode", "plugin");
   if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join41(dir, "inerrata.js");
+  const file2 = join42(dir, "inerrata.js");
   if (existsSync35(file2)) {
     const head2 = readFileSync36(file2, "utf8").split("\n")[0] ?? "";
     if (head2.trim() !== OPENCODE_PLUGIN_MARKER) {
@@ -90377,7 +90427,7 @@ async function installOpencodePlugin(port) {
     }
   }
   writeFileSync26(file2, buildOpencodePluginSource(port, { version: DAEMON_VERSION }), "utf8");
-  const cfgFile = join41(ROOT, "opencode.json");
+  const cfgFile = join42(ROOT, "opencode.json");
   let cfg = { $schema: "https://opencode.ai/config.json" };
   if (existsSync35(cfgFile)) {
     try {
@@ -90413,10 +90463,10 @@ function errataMcpInvocation() {
 }
 async function installClaudeHooks(port) {
   const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join41 } = await import("node:path");
-  const dir = join41(ROOT, ".claude");
+  const { join: join42 } = await import("node:path");
+  const dir = join42(ROOT, ".claude");
   if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join41(dir, "settings.json");
+  const file2 = join42(dir, "settings.json");
   let settings = {};
   if (existsSync35(file2)) {
     try {
@@ -90469,7 +90519,7 @@ async function installClaudeHooks(port) {
   writeFileSync26(file2, JSON.stringify(settings, null, 2) + "\n", "utf8");
   console.log(`installed Claude Code hooks \u2192 ${file2}`);
   await installClaudeMcpConfig();
-  const claudeMd = join41(ROOT, "CLAUDE.md");
+  const claudeMd = join42(ROOT, "CLAUDE.md");
   const recall = writeManagedBlock(claudeMd, { body: RECALL_FIRST_BLOCK });
   if (recall.kind === "collision") {
     console.warn(
@@ -90482,8 +90532,8 @@ async function installClaudeHooks(port) {
 }
 async function installClaudeMcpConfig() {
   const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join41, dirname: dirname13 } = await import("node:path");
-  const file2 = join41(ROOT, ".mcp.json");
+  const { join: join42, dirname: dirname13 } = await import("node:path");
+  const file2 = join42(ROOT, ".mcp.json");
   const dir = dirname13(file2);
   if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
   let cfg = {};
@@ -90504,10 +90554,10 @@ async function installClaudeMcpConfig() {
 }
 async function installCursorMcpConfig() {
   const { mkdirSync: mkdirSync10, existsSync: existsSync35, readFileSync: readFileSync36, writeFileSync: writeFileSync26 } = await import("node:fs");
-  const { join: join41 } = await import("node:path");
-  const dir = join41(ROOT, ".cursor");
+  const { join: join42 } = await import("node:path");
+  const dir = join42(ROOT, ".cursor");
   if (!existsSync35(dir)) mkdirSync10(dir, { recursive: true });
-  const file2 = join41(dir, "mcp.json");
+  const file2 = join42(dir, "mcp.json");
   let cfg = {};
   if (existsSync35(file2)) {
     try {
@@ -90530,10 +90580,21 @@ 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"), {
+    body: AGENTS_POINTER_BODY,
+    stable: true
+  });
   console.log(`installed Codex hooks \u2192 ${file2}`);
+  if (instructions.kind === "collision") {
+    console.warn("  AGENTS.md's Errata block was edited; preserved it. Add an explicit instruction to read .errata/context.md each turn.");
+  } else {
+    console.log("  AGENTS.md now tells Codex to read live context at the start of each turn.");
+  }
   console.log("  Context loads on SessionStart/UserPromptSubmit and refreshes after tools when changed.");
   console.log("  Tool and final-reply capture are configured; hooks must be trusted before they run.");
-  console.log("  Restart/resume Codex to reload config, then review and trust the hooks with /hooks.");
+  console.log(`  ${CODEX_HOOK_REVIEW_HELP}`);
+  console.log("  Use Reload hooks in that screen after installation. Restarting alone does not grant trust.");
+  console.log("  No standalone Codex CLI is required for desktop setup.");
   console.log("  Run `errata doctor` here to check hook discovery and trust; installation alone is not activation.");
   console.log("  Respect an explicit [features] hooks = false setting (older builds use codex_hooks).");
   console.log("  Older Codex versions may not support every event; update if hooks do not fire.");
@@ -90923,7 +90984,7 @@ async function cmdDash(args2) {
       await yieldToLoop2();
       try {
         const items = selectDurableMemory(handle2.sharedStore, r.engine.profile);
-        const res = bleedRules(join40(r.root, ".claude", "rules"), items);
+        const res = bleedRules(join41(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.6-dev.2759",
+  "version": "2.0.6",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {

package/pass-worker.mjs

@@ -27255,6 +27255,11 @@ var AGENTS_POINTER_BODY = [
   "Live agent context for this checkout \u2014 priors, open problems, the capture",
   "protocol \u2014 is maintained by the errata daemon at `.errata/context.md`.",
   "",
+  "At the beginning of each task and each new user turn, read that file before",
+  "substantive work. Use the current file in preference to an earlier snapshot.",
+  "If it is absent, continue normally. In Codex, an `@` mention alone does not",
+  "load the file; read it explicitly.",
+  "",
   "It is gitignored ON PURPOSE: it is this machine's runtime state, not repo",
   "content. Committing it would prime your teammates with your graph.",
   "",