@moreih29/nexus-core 0.16.2 → 0.17.0

package/dist/claude/dist/hooks/post-tool-telemetry.js

@@ -0,0 +1,71 @@
+// src/shared/json-store.js
+import { constants as fsConstants, appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+var inProcessQueues = new Map;
+var APPEND_SIZE_WARN_THRESHOLD = 4 * 1024;
+function appendJsonLine(filePath, record) {
+  const line = JSON.stringify(record) + `
+`;
+  if (line.length > APPEND_SIZE_WARN_THRESHOLD) {
+    console.error(`[json-store] appendJsonLine line exceeds ${APPEND_SIZE_WARN_THRESHOLD} bytes ` + `(${line.length}) — write may not be atomic on some filesystems. path=${filePath}`);
+  }
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  appendFileSync(filePath, line);
+}
+
+// assets/hooks/post-tool-telemetry/handler.ts
+import { join, resolve, relative } from "node:path";
+var EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "ApplyPatch", "NotebookEdit"]);
+function isWithinMemory(filePath, projectRoot) {
+  const memRoot = resolve(projectRoot, ".nexus/memory");
+  const abs = resolve(filePath);
+  return abs.startsWith(memRoot + "/") || abs === memRoot;
+}
+var handler = async (input) => {
+  if (input.hook_event_name !== "PostToolUse")
+    return;
+  const { cwd, session_id, tool_name, agent_id } = input;
+  const toolInput = input.tool_input ?? {};
+  if (tool_name === "Read") {
+    const filePath = toolInput.file_path;
+    if (filePath && isWithinMemory(filePath, cwd)) {
+      appendJsonLine(join(cwd, ".nexus/memory-access.jsonl"), {
+        path: relative(cwd, resolve(filePath)),
+        accessed_at: new Date().toISOString(),
+        agent: agent_id ?? null
+      });
+    }
+  }
+  if (EDIT_TOOLS.has(tool_name) && agent_id) {
+    const filePath = toolInput.file_path ?? toolInput.notebook_path;
+    if (filePath) {
+      appendJsonLine(join(cwd, ".nexus/state", session_id, "tool-log.jsonl"), {
+        ts: new Date().toISOString(),
+        agent_id,
+        tool: tool_name,
+        file: relative(cwd, resolve(filePath)),
+        status: "ok"
+      });
+    }
+  }
+};
+var handler_default = handler;
+
+// ../../../../../tmp/nexus-hook-entry-post-tool-telemetry-1776690665643/post-tool-telemetry-entry.ts
+import { readFileSync } from "node:fs";
+async function main() {
+  let raw = "";
+  try {
+    raw = readFileSync(0, "utf-8");
+  } catch {}
+  const input = raw ? JSON.parse(raw) : {};
+  const result = await handler_default(input);
+  if (result != null && result !== undefined) {
+    process.stdout.write(JSON.stringify(result));
+  }
+}
+main().then(() => process.exit(0), (err) => {
+  process.stderr.write(String(err?.stack ?? err) + `
+`);
+  process.exit(1);
+});

package/dist/claude/dist/hooks/prompt-router.js

@@ -7304,7 +7304,7 @@ var handler = async (input) => {
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-prompt-router-1776674516622/prompt-router-entry.ts
+// ../../../../../tmp/nexus-hook-entry-prompt-router-1776690665662/prompt-router-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 globalThis.__NEXUS_INLINE_INVOCATIONS__ = { subagent_spawn: { args: ["target_role", "prompt", "name"], templates: { claude: 'Agent({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', opencode: 'task({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', codex: 'spawn_agent("{target_role}", "{prompt}")' }, notes: { claude: `description field is optional; omit when name arg is absent. model field may be added to override the spawned agent's model.
 `, opencode: `description is required by OpenCode's Zod schema — use target_role as fallback when name is absent. task_id param enables session resume (§15).

package/dist/claude/dist/hooks/session-init.js

@@ -1,6 +1,15 @@
 // assets/hooks/session-init/handler.ts
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, basename } from "node:path";
+
+// src/shared/paths.ts
+function getParentPid() {
+  const testOverride = parseInt(process.env["NEXUS_TEST_PPID"] ?? "");
+  return testOverride || process.ppid;
+}
+var byPpidCache = new Map;
+
+// assets/hooks/session-init/handler.ts
 var handler = async (input) => {
   if (input.hook_event_name !== "SessionStart")
     return;
@@ -14,10 +23,14 @@ var handler = async (input) => {
   mkdirSync(sessionDir, { recursive: true });
   writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
   writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
+  const ppid = getParentPid();
+  const byPpidDir = join(input.cwd, ".nexus/state/runtime/by-ppid");
+  mkdirSync(byPpidDir, { recursive: true });
+  writeFileSync(join(byPpidDir, `${ppid}.json`), JSON.stringify({ session_id: input.session_id, updated_at: new Date().toISOString(), cwd: input.cwd }));
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-session-init-1776674516615/session-init-entry.ts
+// ../../../../../tmp/nexus-hook-entry-session-init-1776690665653/session-init-entry.ts
 import { readFileSync } from "node:fs";
 async function main() {
   let raw = "";

package/dist/claude/hooks/hooks.json

@@ -1,5 +1,17 @@
 {
   "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Edit|Write|MultiEdit|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/post-tool-telemetry.js",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "SessionStart": [
       {
         "matcher": "*",

package/dist/codex/dist/hooks/agent-bootstrap.js

@@ -1,21 +1,124 @@
+// src/shared/json-store.js
+import fs from "node:fs/promises";
+import { constants as fsConstants, appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+var inProcessQueues = new Map;
+async function runWithInProcessLock(filePath, action) {
+  const previous = inProcessQueues.get(filePath) ?? Promise.resolve();
+  let release = () => {};
+  const gate = new Promise((resolve) => {
+    release = resolve;
+  });
+  const entry = previous.then(() => gate);
+  inProcessQueues.set(filePath, entry);
+  await previous;
+  try {
+    return await action();
+  } finally {
+    release();
+    entry.finally(() => {
+      if (inProcessQueues.get(filePath) === entry) {
+        inProcessQueues.delete(filePath);
+      }
+    });
+  }
+}
+var LOCK_RETRY_INTERVAL_MS = 100;
+var LOCK_MAX_RETRIES = 50;
+var LOCK_STALE_MS = 30000;
+function lockPath(filePath) {
+  return `${filePath}.lock`;
+}
+async function acquireFsLock(filePath) {
+  const lp = lockPath(filePath);
+  for (let attempt = 0;attempt <= LOCK_MAX_RETRIES; attempt++) {
+    try {
+      const fd = await fs.open(lp, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL);
+      await fd.close();
+      return;
+    } catch (err) {
+      const e = err;
+      if (e.code !== "EEXIST")
+        throw err;
+      try {
+        const stat = await fs.stat(lp);
+        const ageMs = Date.now() - stat.mtimeMs;
+        if (ageMs > LOCK_STALE_MS) {
+          await fs.unlink(lp).catch(() => {
+            return;
+          });
+          continue;
+        }
+      } catch {
+        continue;
+      }
+      if (attempt === LOCK_MAX_RETRIES) {
+        throw new Error(`Failed to acquire lock for "${filePath}" after ${LOCK_MAX_RETRIES} retries`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_INTERVAL_MS));
+    }
+  }
+}
+async function releaseFsLock(filePath) {
+  await fs.unlink(lockPath(filePath)).catch(() => {
+    return;
+  });
+}
+async function readJsonFile(filePath, defaultValue) {
+  let raw;
+  try {
+    raw = await fs.readFile(filePath, "utf8");
+  } catch (err) {
+    const e = err;
+    if (e.code === "ENOENT")
+      return defaultValue;
+    throw err;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return defaultValue;
+  }
+}
+async function writeJsonFile(filePath, data) {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  const tmpPath = `${filePath}.tmp.${process.pid}.${Date.now()}.${randomUUID()}`;
+  await fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + `
+`, "utf8");
+  await fs.rename(tmpPath, filePath);
+}
+async function updateJsonFileLocked(filePath, defaultValue, updater) {
+  return runWithInProcessLock(filePath, async () => {
+    await acquireFsLock(filePath);
+    try {
+      const current = await readJsonFile(filePath, defaultValue);
+      const next = await updater(current);
+      await writeJsonFile(filePath, next);
+      return next;
+    } finally {
+      await releaseFsLock(filePath);
+    }
+  });
+}
+var APPEND_SIZE_WARN_THRESHOLD = 4 * 1024;
+
 // assets/hooks/agent-bootstrap/handler.ts
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 var CORE_INDEX_SIZE_LIMIT = 2 * 1024;
 function loadValidRoles(cwd) {
+  const inlined = globalThis.__NEXUS_INLINE_AGENT_ROLES__;
+  if (Array.isArray(inlined))
+    return inlined;
   const agentsDir = join(cwd, "assets/agents");
-  const roles = [];
-  if (existsSync(agentsDir)) {
-    for (const entry of readdirSync(agentsDir, { withFileTypes: true })) {
-      if (entry.isDirectory())
-        roles.push(entry.name);
-    }
-  }
-  return roles;
+  if (!existsSync(agentsDir))
+    return [];
+  return readdirSync(agentsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
 }
-function readFirstLine(path) {
+function readFirstLine(path2) {
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync(path2, "utf-8");
     const firstNonEmpty = content.split(`
 `).find((l) => l.trim().length > 0) ?? "";
     return firstNonEmpty.replace(/^#+\s*/, "").slice(0, 80);
@@ -76,6 +179,19 @@ var handler = async (input) => {
   const validRoles = loadValidRoles(cwd);
   if (!validRoles.includes(agent_type))
     return;
+  const trackerPath = join(cwd, ".nexus/state", session_id, "agent-tracker.json");
+  await updateJsonFileLocked(trackerPath, [], (tracker) => {
+    const list = Array.isArray(tracker) ? tracker : [];
+    if (list.find((e) => e["agent_id"] === agent_id))
+      return list;
+    list.push({
+      agent_id,
+      agent_type,
+      started_at: new Date().toISOString(),
+      status: "running"
+    });
+    return list;
+  });
   const parts = [];
   const coreIndex = buildCoreIndex(cwd);
   if (coreIndex) {
@@ -101,8 +217,9 @@ ${ruleContent}
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-agent-bootstrap-1776674516656/agent-bootstrap-entry.ts
+// ../../../../../tmp/nexus-hook-entry-agent-bootstrap-1776690665703/agent-bootstrap-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
+globalThis.__NEXUS_INLINE_AGENT_ROLES__ = ["architect", "designer", "engineer", "reviewer", "strategist", "researcher", "postdoc", "lead", "tester", "writer"];
 async function main() {
   let raw = "";
   try {

package/dist/codex/dist/hooks/agent-finalize.js

@@ -160,7 +160,7 @@ Subagent "${agent_type}" finished. Tasks still pending with this role: ${ids}. R
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-agent-finalize-1776674516650/agent-finalize-entry.ts
+// ../../../../../tmp/nexus-hook-entry-agent-finalize-1776690665695/agent-finalize-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 async function main() {
   let raw = "";

package/dist/codex/dist/hooks/prompt-router.js

@@ -7304,7 +7304,7 @@ var handler = async (input) => {
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-prompt-router-1776674516622/prompt-router-entry.ts
+// ../../../../../tmp/nexus-hook-entry-prompt-router-1776690665662/prompt-router-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 globalThis.__NEXUS_INLINE_INVOCATIONS__ = { subagent_spawn: { args: ["target_role", "prompt", "name"], templates: { claude: 'Agent({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', opencode: 'task({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', codex: 'spawn_agent("{target_role}", "{prompt}")' }, notes: { claude: `description field is optional; omit when name arg is absent. model field may be added to override the spawned agent's model.
 `, opencode: `description is required by OpenCode's Zod schema — use target_role as fallback when name is absent. task_id param enables session resume (§15).

package/dist/codex/dist/hooks/session-init.js

@@ -1,6 +1,15 @@
 // assets/hooks/session-init/handler.ts
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, basename } from "node:path";
+
+// src/shared/paths.ts
+function getParentPid() {
+  const testOverride = parseInt(process.env["NEXUS_TEST_PPID"] ?? "");
+  return testOverride || process.ppid;
+}
+var byPpidCache = new Map;
+
+// assets/hooks/session-init/handler.ts
 var handler = async (input) => {
   if (input.hook_event_name !== "SessionStart")
     return;
@@ -14,10 +23,14 @@ var handler = async (input) => {
   mkdirSync(sessionDir, { recursive: true });
   writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
   writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
+  const ppid = getParentPid();
+  const byPpidDir = join(input.cwd, ".nexus/state/runtime/by-ppid");
+  mkdirSync(byPpidDir, { recursive: true });
+  writeFileSync(join(byPpidDir, `${ppid}.json`), JSON.stringify({ session_id: input.session_id, updated_at: new Date().toISOString(), cwd: input.cwd }));
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-session-init-1776674516615/session-init-entry.ts
+// ../../../../../tmp/nexus-hook-entry-session-init-1776690665653/session-init-entry.ts
 import { readFileSync } from "node:fs";
 async function main() {
   let raw = "";

package/dist/hooks/agent-bootstrap.js

@@ -1,21 +1,124 @@
+// src/shared/json-store.js
+import fs from "node:fs/promises";
+import { constants as fsConstants, appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+var inProcessQueues = new Map;
+async function runWithInProcessLock(filePath, action) {
+  const previous = inProcessQueues.get(filePath) ?? Promise.resolve();
+  let release = () => {};
+  const gate = new Promise((resolve) => {
+    release = resolve;
+  });
+  const entry = previous.then(() => gate);
+  inProcessQueues.set(filePath, entry);
+  await previous;
+  try {
+    return await action();
+  } finally {
+    release();
+    entry.finally(() => {
+      if (inProcessQueues.get(filePath) === entry) {
+        inProcessQueues.delete(filePath);
+      }
+    });
+  }
+}
+var LOCK_RETRY_INTERVAL_MS = 100;
+var LOCK_MAX_RETRIES = 50;
+var LOCK_STALE_MS = 30000;
+function lockPath(filePath) {
+  return `${filePath}.lock`;
+}
+async function acquireFsLock(filePath) {
+  const lp = lockPath(filePath);
+  for (let attempt = 0;attempt <= LOCK_MAX_RETRIES; attempt++) {
+    try {
+      const fd = await fs.open(lp, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL);
+      await fd.close();
+      return;
+    } catch (err) {
+      const e = err;
+      if (e.code !== "EEXIST")
+        throw err;
+      try {
+        const stat = await fs.stat(lp);
+        const ageMs = Date.now() - stat.mtimeMs;
+        if (ageMs > LOCK_STALE_MS) {
+          await fs.unlink(lp).catch(() => {
+            return;
+          });
+          continue;
+        }
+      } catch {
+        continue;
+      }
+      if (attempt === LOCK_MAX_RETRIES) {
+        throw new Error(`Failed to acquire lock for "${filePath}" after ${LOCK_MAX_RETRIES} retries`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_INTERVAL_MS));
+    }
+  }
+}
+async function releaseFsLock(filePath) {
+  await fs.unlink(lockPath(filePath)).catch(() => {
+    return;
+  });
+}
+async function readJsonFile(filePath, defaultValue) {
+  let raw;
+  try {
+    raw = await fs.readFile(filePath, "utf8");
+  } catch (err) {
+    const e = err;
+    if (e.code === "ENOENT")
+      return defaultValue;
+    throw err;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return defaultValue;
+  }
+}
+async function writeJsonFile(filePath, data) {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  const tmpPath = `${filePath}.tmp.${process.pid}.${Date.now()}.${randomUUID()}`;
+  await fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + `
+`, "utf8");
+  await fs.rename(tmpPath, filePath);
+}
+async function updateJsonFileLocked(filePath, defaultValue, updater) {
+  return runWithInProcessLock(filePath, async () => {
+    await acquireFsLock(filePath);
+    try {
+      const current = await readJsonFile(filePath, defaultValue);
+      const next = await updater(current);
+      await writeJsonFile(filePath, next);
+      return next;
+    } finally {
+      await releaseFsLock(filePath);
+    }
+  });
+}
+var APPEND_SIZE_WARN_THRESHOLD = 4 * 1024;
+
 // assets/hooks/agent-bootstrap/handler.ts
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 var CORE_INDEX_SIZE_LIMIT = 2 * 1024;
 function loadValidRoles(cwd) {
+  const inlined = globalThis.__NEXUS_INLINE_AGENT_ROLES__;
+  if (Array.isArray(inlined))
+    return inlined;
   const agentsDir = join(cwd, "assets/agents");
-  const roles = [];
-  if (existsSync(agentsDir)) {
-    for (const entry of readdirSync(agentsDir, { withFileTypes: true })) {
-      if (entry.isDirectory())
-        roles.push(entry.name);
-    }
-  }
-  return roles;
+  if (!existsSync(agentsDir))
+    return [];
+  return readdirSync(agentsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
 }
-function readFirstLine(path) {
+function readFirstLine(path2) {
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync(path2, "utf-8");
     const firstNonEmpty = content.split(`
 `).find((l) => l.trim().length > 0) ?? "";
     return firstNonEmpty.replace(/^#+\s*/, "").slice(0, 80);
@@ -76,6 +179,19 @@ var handler = async (input) => {
   const validRoles = loadValidRoles(cwd);
   if (!validRoles.includes(agent_type))
     return;
+  const trackerPath = join(cwd, ".nexus/state", session_id, "agent-tracker.json");
+  await updateJsonFileLocked(trackerPath, [], (tracker) => {
+    const list = Array.isArray(tracker) ? tracker : [];
+    if (list.find((e) => e["agent_id"] === agent_id))
+      return list;
+    list.push({
+      agent_id,
+      agent_type,
+      started_at: new Date().toISOString(),
+      status: "running"
+    });
+    return list;
+  });
   const parts = [];
   const coreIndex = buildCoreIndex(cwd);
   if (coreIndex) {
@@ -101,8 +217,9 @@ ${ruleContent}
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-agent-bootstrap-1776674516656/agent-bootstrap-entry.ts
+// ../../../../../tmp/nexus-hook-entry-agent-bootstrap-1776690665703/agent-bootstrap-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
+globalThis.__NEXUS_INLINE_AGENT_ROLES__ = ["architect", "designer", "engineer", "reviewer", "strategist", "researcher", "postdoc", "lead", "tester", "writer"];
 async function main() {
   let raw = "";
   try {

package/dist/hooks/agent-finalize.js

@@ -160,7 +160,7 @@ Subagent "${agent_type}" finished. Tasks still pending with this role: ${ids}. R
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-agent-finalize-1776674516650/agent-finalize-entry.ts
+// ../../../../../tmp/nexus-hook-entry-agent-finalize-1776690665695/agent-finalize-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 async function main() {
   let raw = "";

package/dist/hooks/post-tool-telemetry.js

@@ -0,0 +1,71 @@
+// src/shared/json-store.js
+import { constants as fsConstants, appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+var inProcessQueues = new Map;
+var APPEND_SIZE_WARN_THRESHOLD = 4 * 1024;
+function appendJsonLine(filePath, record) {
+  const line = JSON.stringify(record) + `
+`;
+  if (line.length > APPEND_SIZE_WARN_THRESHOLD) {
+    console.error(`[json-store] appendJsonLine line exceeds ${APPEND_SIZE_WARN_THRESHOLD} bytes ` + `(${line.length}) — write may not be atomic on some filesystems. path=${filePath}`);
+  }
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  appendFileSync(filePath, line);
+}
+
+// assets/hooks/post-tool-telemetry/handler.ts
+import { join, resolve, relative } from "node:path";
+var EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "ApplyPatch", "NotebookEdit"]);
+function isWithinMemory(filePath, projectRoot) {
+  const memRoot = resolve(projectRoot, ".nexus/memory");
+  const abs = resolve(filePath);
+  return abs.startsWith(memRoot + "/") || abs === memRoot;
+}
+var handler = async (input) => {
+  if (input.hook_event_name !== "PostToolUse")
+    return;
+  const { cwd, session_id, tool_name, agent_id } = input;
+  const toolInput = input.tool_input ?? {};
+  if (tool_name === "Read") {
+    const filePath = toolInput.file_path;
+    if (filePath && isWithinMemory(filePath, cwd)) {
+      appendJsonLine(join(cwd, ".nexus/memory-access.jsonl"), {
+        path: relative(cwd, resolve(filePath)),
+        accessed_at: new Date().toISOString(),
+        agent: agent_id ?? null
+      });
+    }
+  }
+  if (EDIT_TOOLS.has(tool_name) && agent_id) {
+    const filePath = toolInput.file_path ?? toolInput.notebook_path;
+    if (filePath) {
+      appendJsonLine(join(cwd, ".nexus/state", session_id, "tool-log.jsonl"), {
+        ts: new Date().toISOString(),
+        agent_id,
+        tool: tool_name,
+        file: relative(cwd, resolve(filePath)),
+        status: "ok"
+      });
+    }
+  }
+};
+var handler_default = handler;
+
+// ../../../../../tmp/nexus-hook-entry-post-tool-telemetry-1776690665643/post-tool-telemetry-entry.ts
+import { readFileSync } from "node:fs";
+async function main() {
+  let raw = "";
+  try {
+    raw = readFileSync(0, "utf-8");
+  } catch {}
+  const input = raw ? JSON.parse(raw) : {};
+  const result = await handler_default(input);
+  if (result != null && result !== undefined) {
+    process.stdout.write(JSON.stringify(result));
+  }
+}
+main().then(() => process.exit(0), (err) => {
+  process.stderr.write(String(err?.stack ?? err) + `
+`);
+  process.exit(1);
+});

package/dist/hooks/prompt-router.js

@@ -7304,7 +7304,7 @@ var handler = async (input) => {
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-prompt-router-1776674516622/prompt-router-entry.ts
+// ../../../../../tmp/nexus-hook-entry-prompt-router-1776690665662/prompt-router-entry.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 globalThis.__NEXUS_INLINE_INVOCATIONS__ = { subagent_spawn: { args: ["target_role", "prompt", "name"], templates: { claude: 'Agent({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', opencode: 'task({ subagent_type: "{target_role}", prompt: "{prompt}", description: "{name}" })', codex: 'spawn_agent("{target_role}", "{prompt}")' }, notes: { claude: `description field is optional; omit when name arg is absent. model field may be added to override the spawned agent's model.
 `, opencode: `description is required by OpenCode's Zod schema — use target_role as fallback when name is absent. task_id param enables session resume (§15).

package/dist/hooks/session-init.js

@@ -1,6 +1,15 @@
 // assets/hooks/session-init/handler.ts
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, basename } from "node:path";
+
+// src/shared/paths.ts
+function getParentPid() {
+  const testOverride = parseInt(process.env["NEXUS_TEST_PPID"] ?? "");
+  return testOverride || process.ppid;
+}
+var byPpidCache = new Map;
+
+// assets/hooks/session-init/handler.ts
 var handler = async (input) => {
   if (input.hook_event_name !== "SessionStart")
     return;
@@ -14,10 +23,14 @@ var handler = async (input) => {
   mkdirSync(sessionDir, { recursive: true });
   writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
   writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
+  const ppid = getParentPid();
+  const byPpidDir = join(input.cwd, ".nexus/state/runtime/by-ppid");
+  mkdirSync(byPpidDir, { recursive: true });
+  writeFileSync(join(byPpidDir, `${ppid}.json`), JSON.stringify({ session_id: input.session_id, updated_at: new Date().toISOString(), cwd: input.cwd }));
 };
 var handler_default = handler;
 
-// ../../../../../tmp/nexus-hook-entry-session-init-1776674516615/session-init-entry.ts
+// ../../../../../tmp/nexus-hook-entry-session-init-1776690665653/session-init-entry.ts
 import { readFileSync } from "node:fs";
 async function main() {
   let raw = "";

package/dist/manifests/claude-hooks.json

@@ -1,5 +1,17 @@
 {
   "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Edit|Write|MultiEdit|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/post-tool-telemetry.js",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "SessionStart": [
       {
         "matcher": "*",

package/dist/manifests/opencode-manifest.json

@@ -1,5 +1,15 @@
 {
   "hooks": [
+    {
+      "name": "post-tool-telemetry",
+      "events": [
+        "PostToolUse"
+      ],
+      "matcher": "Read|Edit|Write|MultiEdit|ApplyPatch|NotebookEdit",
+      "handlerPath": "../hooks/post-tool-telemetry.js",
+      "priority": 10,
+      "timeout": 5
+    },
     {
       "name": "session-init",
       "events": [