@moreih29/nexus-core 0.16.1 → 0.17.0

package/assets/capability-matrix.yml

@@ -162,8 +162,10 @@ capabilities:
 #   Source: https://opencode.ai/docs/agents/ (model field is optional)
 #   Verified: .nexus/memory/external-opencode-plugin.md §5
 #
-# claude model slugs (partial-match basis — Claude Code resolves to latest in series):
-#   Source: https://code.claude.com/docs/en/sub-agents (model field)
+# claude model slugs (alias form — version-tolerant; Claude Code resolves to the
+#   latest dated model in the series. Prefer aliases (opus/sonnet/haiku) over
+#   dated IDs (claude-opus-4-7 등) to avoid rot as new versions ship.):
+#   Source: https://code.claude.com/docs/en/sub-agents (model field accepts aliases)
 #   Verified: .nexus/memory/external-claude-code-hooks-tools.md §6 (Agent tool: model param)
 #
 # codex model slugs:
@@ -178,7 +180,7 @@ model_tier:
   # high — used by: architect, designer, postdoc, strategist
   # Reasoning-intensive advisory roles that require deep analysis.
   high:
-    claude: claude-opus-4
+    claude: opus            # alias — Claude Code resolves to latest Opus
     codex: gpt-5.4          # UNVERIFIED slug — confirm against current Codex model list
     opencode: null          # inherits user config
 
@@ -186,13 +188,13 @@ model_tier:
   # Execution and verification roles where throughput matters more than
   # top-tier reasoning.
   standard:
-    claude: claude-sonnet-4
+    claude: sonnet          # alias — Claude Code resolves to latest Sonnet
     codex: gpt-5.3-codex    # UNVERIFIED slug — confirm against current Codex model list
     opencode: null          # inherits user config
 
   # low — reserved tier; no agents currently assigned.
   # Intended for lightweight utility agents (fast, cheap, simple tasks).
   low:
-    claude: claude-haiku-4
+    claude: haiku           # alias — Claude Code resolves to latest Haiku
     codex: gpt-5.4-mini     # UNVERIFIED slug — confirm against current Codex model list
     opencode: null          # inherits user config

package/assets/hooks/agent-bootstrap/handler.test.ts

@@ -7,7 +7,7 @@
  * (3) resume_count > 0 → skip (not fresh)
  * (4) .nexus/rules/<role>.md absent → core index only
  * (5) core index > 2KB → truncated to recent-modified N entries
- * (6) tracker write side-effect absent (agent-tracker.json unchanged before/after)
+ * (6) tracker append: new entry created; same agent_id is idempotent (no duplicate)
  */
 
 import { describe, test, expect, beforeAll, afterAll } from "bun:test";
@@ -256,43 +256,44 @@ describe("scenario 5: 2KB truncation of core index", () => {
 });
 
 // ---------------------------------------------------------------------------
-// Scenario (6): no tracker write side-effects
+// Scenario (6): tracker append
 // ---------------------------------------------------------------------------
 
-describe("scenario 6: handler produces no file write side-effects", () => {
+describe("scenario 6: tracker append", () => {
   let cleanup: () => void;
 
   afterAll(() => cleanup?.());
 
-  test("agent-tracker.json is not created or modified by handler", async () => {
+  test("agent-tracker.json is created with running entry for fresh agent", async () => {
     const { cwd, sessionId, cleanup: c } = makeFixture({ withTracker: undefined });
     cleanup = c;
 
     const trackerPath = join(cwd, ".nexus/state", sessionId, "agent-tracker.json");
 
-    // Tracker must not exist before the call
     expect(existsSync(trackerPath)).toBe(false);
 
-    await handler(makeInput(cwd, sessionId, "architect"));
+    await handler(makeInput(cwd, sessionId, "architect", "agent-001"));
 
-    // Tracker must still not exist after the call
-    expect(existsSync(trackerPath)).toBe(false);
+    expect(existsSync(trackerPath)).toBe(true);
+    const tracker = JSON.parse(readFileSync(trackerPath, "utf-8")) as Array<Record<string, unknown>>;
+    expect(tracker).toHaveLength(1);
+    expect(tracker[0]["agent_id"]).toBe("agent-001");
+    expect(tracker[0]["agent_type"]).toBe("architect");
+    expect(tracker[0]["status"]).toBe("running");
+    expect(typeof tracker[0]["started_at"]).toBe("string");
   });
 
-  test("pre-existing agent-tracker.json is not modified by handler", async () => {
-    const agentId = "agent-side-effect";
-    const { cwd, sessionId, cleanup: c } = makeFixture({
-      withTracker: { agentId, resumeCount: 0 },
-    });
+  test("duplicate agent_id on second call does not create a second entry", async () => {
+    const { cwd, sessionId, cleanup: c } = makeFixture({ withTracker: undefined });
     cleanup = c;
 
     const trackerPath = join(cwd, ".nexus/state", sessionId, "agent-tracker.json");
-    const before = readFileSync(trackerPath, "utf-8");
 
-    await handler(makeInput(cwd, sessionId, "architect", agentId));
+    await handler(makeInput(cwd, sessionId, "architect", "agent-001"));
+    await handler(makeInput(cwd, sessionId, "architect", "agent-001"));
 
-    const after = readFileSync(trackerPath, "utf-8");
-    expect(after).toBe(before);
+    const tracker = JSON.parse(readFileSync(trackerPath, "utf-8")) as Array<Record<string, unknown>>;
+    expect(tracker.filter((e) => e["agent_id"] === "agent-001")).toHaveLength(1);
   });
 });
 

package/assets/hooks/agent-bootstrap/handler.ts

@@ -1,18 +1,18 @@
 import type { HookHandler } from "../../../src/hooks/types.js";
+import { updateJsonFileLocked } from "../../../src/shared/json-store.js";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 
 const CORE_INDEX_SIZE_LIMIT = 2 * 1024; // 2KB
 
 function loadValidRoles(cwd: string): string[] {
+  const inlined = (globalThis as unknown as { __NEXUS_INLINE_AGENT_ROLES__?: string[] }).__NEXUS_INLINE_AGENT_ROLES__;
+  if (Array.isArray(inlined)) return inlined;
   const agentsDir = join(cwd, "assets/agents");
-  const roles: string[] = [];
-  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: string): string {
@@ -95,6 +95,19 @@ const handler: HookHandler = 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: Array<Record<string, unknown>>) => {
+    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: string[] = [];
 
   const coreIndex = buildCoreIndex(cwd);

package/assets/hooks/post-tool-telemetry/meta.yml

@@ -1,11 +1,10 @@
 name: post-tool-telemetry
 description: Track memory access and file-edit operations for strength/forgetting signals and audit
 events: [PostToolUse]
-matcher: "Read|Edit|Write|MultiEdit|ApplyPatch|NotebookEdit|Bash"
+matcher: "Read|Edit|Write|MultiEdit|ApplyPatch|NotebookEdit"
 timeout: 5
 fallback: warn
 priority: 10
 requires_capabilities:
   - event.post_tool_use.read
   - event.post_tool_use.edit
-  - event.post_tool_use.bash_parsed

package/assets/hooks/session-init/handler.ts

@@ -1,11 +1,11 @@
 import type { HookHandler } from "../../../src/hooks/types.js";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, basename } from "node:path";
+import { getParentPid } from "../../../src/shared/paths.js";
 
 const handler: HookHandler = async (input) => {
   if (input.hook_event_name !== "SessionStart") return;
 
-  // Sanitize session_id to prevent path traversal
   const safeSid = basename(input.session_id);
   if (!safeSid || safeSid.startsWith(".") || safeSid.includes("/")) {
     process.stderr.write(`[session-init] invalid session_id: ${input.session_id}\n`);
@@ -14,17 +14,18 @@ const handler: HookHandler = async (input) => {
 
   const sessionDir = join(input.cwd, ".nexus/state", safeSid);
 
-  // Ensure directory exists (idempotent)
   mkdirSync(sessionDir, { recursive: true });
 
-  // Initialize per-session state files — overwrite unconditionally (resume is intentional)
   writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
   writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
 
-  // plan.json and tasks.json are MCP responsibility — not touched here
-  // memory-access.jsonl is project-level — not touched here
-
-  // No additional_context returned (decided: no context injection at session start)
+  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 }),
+  );
 };
 
 export default handler;

package/dist/assets/hooks/agent-bootstrap/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAoF/D,QAAA,MAAM,OAAO,EAAE,WAgCd,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAoF/D,QAAA,MAAM,OAAO,EAAE,WA6Cd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/agent-bootstrap/handler.js

@@ -1,16 +1,17 @@
+import { updateJsonFileLocked } from "../../../src/shared/json-store.js";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 const CORE_INDEX_SIZE_LIMIT = 2 * 1024; // 2KB
 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) {
     try {
@@ -80,6 +81,19 @@ const 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) {

package/dist/assets/hooks/agent-bootstrap/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/agent-bootstrap/handler.ts"],"names":[],"mappings":"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"}

package/dist/assets/hooks/session-init/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D,QAAA,MAAM,OAAO,EAAE,WAuBd,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK/D,QAAA,MAAM,OAAO,EAAE,WAuBd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/assets/hooks/session-init/handler.js

@@ -1,23 +1,22 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, basename } from "node:path";
+import { getParentPid } from "../../../src/shared/paths.js";
 const handler = async (input) => {
     if (input.hook_event_name !== "SessionStart")
         return;
-    // Sanitize session_id to prevent path traversal
     const safeSid = basename(input.session_id);
     if (!safeSid || safeSid.startsWith(".") || safeSid.includes("/")) {
         process.stderr.write(`[session-init] invalid session_id: ${input.session_id}\n`);
         return;
     }
     const sessionDir = join(input.cwd, ".nexus/state", safeSid);
-    // Ensure directory exists (idempotent)
     mkdirSync(sessionDir, { recursive: true });
-    // Initialize per-session state files — overwrite unconditionally (resume is intentional)
     writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
     writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
-    // plan.json and tasks.json are MCP responsibility — not touched here
-    // memory-access.jsonl is project-level — not touched here
-    // No additional_context returned (decided: no context injection at session start)
+    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 }));
 };
 export default handler;
 //# sourceMappingURL=handler.js.map

package/dist/assets/hooks/session-init/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,OAAO,GAAgB,KAAK,EAAE,KAAK,EAAE,EAAE;IAC3C,IAAI,KAAK,CAAC,eAAe,KAAK,cAAc;QAAE,OAAO;IAErD,gDAAgD;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE5D,uCAAuC;IACvC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,yFAAyF;IACzF,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD,qEAAqE;IACrE,0DAA0D;IAE1D,kFAAkF;AACpF,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../assets/hooks/session-init/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,OAAO,GAAgB,KAAK,EAAE,KAAK,EAAE,EAAE;IAC3C,IAAI,KAAK,CAAC,eAAe,KAAK,cAAc;QAAE,OAAO;IAErD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE5D,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,8BAA8B,CAAC,CAAC;IAClE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,aAAa,CACX,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CACvG,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/claude/agents/architect.md

@@ -1,6 +1,6 @@
 ---
 description: "Technical design — evaluates How, reviews architecture, advises on implementation approach"
-model: claude-opus-4
+model: opus
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/designer.md

@@ -1,6 +1,6 @@
 ---
 description: "UX/UI design — evaluates user experience, interaction patterns, and how users will experience the product"
-model: claude-opus-4
+model: opus
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/engineer.md

@@ -1,6 +1,6 @@
 ---
 description: "Implementation — writes code, debugs issues, follows specifications from Lead and architect"
-model: claude-sonnet-4
+model: sonnet
 disallowedTools:
   - mcp__plugin_claude-nexus_nx__nx_task_add
 ---

package/dist/claude/agents/lead.md

@@ -1,6 +1,6 @@
 ---
 description: "Primary orchestrator — converses directly with users, composes 9 subagents across HOW/DO/CHECK categories, and owns scope decisions and task lifecycle"
-model: claude-opus-4
+model: opus
 ---
 ## Identity
 

package/dist/claude/agents/postdoc.md

@@ -1,6 +1,6 @@
 ---
 description: "Research methodology and synthesis — designs investigation approach, evaluates evidence quality, writes synthesis documents"
-model: claude-opus-4
+model: opus
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/researcher.md

@@ -1,6 +1,6 @@
 ---
 description: "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations"
-model: claude-sonnet-4
+model: sonnet
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/reviewer.md

@@ -1,6 +1,6 @@
 ---
 description: "Content verification — validates accuracy, checks facts, confirms grammar and format of non-code deliverables"
-model: claude-sonnet-4
+model: sonnet
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/strategist.md

@@ -1,6 +1,6 @@
 ---
 description: "Business strategy — evaluates market positioning, competitive landscape, and business viability of decisions"
-model: claude-opus-4
+model: opus
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/tester.md

@@ -1,6 +1,6 @@
 ---
 description: "Testing and verification — tests, verifies, validates stability and security of implementations"
-model: claude-sonnet-4
+model: sonnet
 disallowedTools:
   - Edit
   - Write

package/dist/claude/agents/writer.md

@@ -1,6 +1,6 @@
 ---
 description: "Technical writing — transforms research findings, code, and analysis into clear documents and presentations for the intended audience"
-model: claude-sonnet-4
+model: sonnet
 disallowedTools:
   - mcp__plugin_claude-nexus_nx__nx_task_add
 ---

package/dist/claude/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-1776672660252/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/claude/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-1776672660245/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 = "";