@moreih29/nexus-core 0.16.1 → 0.17.0

package/dist/scripts/smoke/smoke-consumer.js

@@ -1,19 +1,22 @@
 // Issue #46 — prompt-router runtime asset lookup 회귀 감지 (fresh consumer target 모사)
+// Issue #50 — session_id side-channel + tracker lifecycle integration cases
 import { execSync, spawn } from "node:child_process";
-import { mkdtempSync, rmSync, existsSync } from "node:fs";
+import { mkdtempSync, rmSync, existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { findPackageRoot } from "../../src/shared/package-root.js";
+import { getSessionId, resetByPpidCache } from "../../src/shared/paths.js";
 const __dirname = fileURLToPath(new URL(".", import.meta.url));
 const ROOT = findPackageRoot(__dirname);
 function fail(msg) {
     process.stderr.write(`[smoke-consumer] FAIL: ${msg}\n`);
     process.exit(1);
 }
-function spawnWithStdin(handlerPath, payload) {
+function spawnWithStdin(handlerPath, payload, extraEnv) {
     return new Promise((resolve) => {
-        const child = spawn("node", [handlerPath], { stdio: ["pipe", "pipe", "pipe"] });
+        const env = extraEnv ? { ...process.env, ...extraEnv } : process.env;
+        const child = spawn("node", [handlerPath], { stdio: ["pipe", "pipe", "pipe"], env });
         let stdout = "";
         let stderr = "";
         child.stdout.on("data", (d) => { stdout += d.toString(); });
@@ -73,6 +76,153 @@ try {
             `  stdout: ${resultB.stdout.slice(0, 300)}`);
     }
     console.log("[smoke-consumer] PASS — prompt-router emits system-notice for [run] + [rule] tags in fresh consumer target");
+    // Case C — session_id side-channel round-trip
+    const sidTmpDir = mkdtempSync(join(tmpdir(), "nexus-smoke-sid-"));
+    const savedTestPpid = process.env["NEXUS_TEST_PPID"];
+    const savedSessionId = process.env["NEXUS_SESSION_ID"];
+    try {
+        process.env["NEXUS_TEST_PPID"] = "999000";
+        delete process.env["NEXUS_SESSION_ID"];
+        const sessionInitHandler = join(ROOT, "dist/hooks/session-init.js");
+        if (!existsSync(sessionInitHandler)) {
+            fail(`session-init.js not found at ${sessionInitHandler} — run \`bun run build\` first`);
+        }
+        const payloadC = JSON.stringify({
+            hook_event_name: "SessionStart",
+            session_id: "test-sid-abc",
+            cwd: sidTmpDir,
+            source: "startup",
+        });
+        const resultC = await spawnWithStdin(sessionInitHandler, payloadC, { NEXUS_TEST_PPID: "999000" });
+        if (resultC.code !== 0) {
+            fail(`case C (session-init) exited with code ${resultC.code}\n` +
+                `  stderr: ${resultC.stderr.slice(0, 300)}`);
+        }
+        const byPpidFile = join(sidTmpDir, ".nexus/state/runtime/by-ppid/999000.json");
+        if (!existsSync(byPpidFile)) {
+            fail(`case C: by-ppid file not created at ${byPpidFile}`);
+        }
+        const byPpidData = JSON.parse(readFileSync(byPpidFile, "utf-8"));
+        if (byPpidData.session_id !== "test-sid-abc") {
+            fail(`case C: by-ppid file has session_id="${byPpidData.session_id}", expected "test-sid-abc"`);
+        }
+        resetByPpidCache();
+        const resolvedSid = getSessionId(sidTmpDir);
+        if (resolvedSid !== "test-sid-abc") {
+            fail(`case C: getSessionId() returned "${resolvedSid}", expected "test-sid-abc"`);
+        }
+        console.log("[smoke-consumer] PASS — case C: session_id side-channel round-trip");
+    }
+    finally {
+        if (savedTestPpid === undefined) {
+            delete process.env["NEXUS_TEST_PPID"];
+        }
+        else {
+            process.env["NEXUS_TEST_PPID"] = savedTestPpid;
+        }
+        if (savedSessionId !== undefined) {
+            process.env["NEXUS_SESSION_ID"] = savedSessionId;
+        }
+        rmSync(sidTmpDir, { recursive: true, force: true });
+    }
+    // Case D — tracker lifecycle: session-init → agent-bootstrap → agent-finalize
+    const trackerTmpDir = mkdtempSync(join(tmpdir(), "nexus-smoke-tracker-"));
+    const savedTestPpid2 = process.env["NEXUS_TEST_PPID"];
+    const savedSessionId2 = process.env["NEXUS_SESSION_ID"];
+    try {
+        process.env["NEXUS_TEST_PPID"] = "999001";
+        delete process.env["NEXUS_SESSION_ID"];
+        const sessionInitHandler = join(ROOT, "dist/hooks/session-init.js");
+        const bootstrapHandler = join(ROOT, "dist/hooks/agent-bootstrap.js");
+        const finalizeHandler = join(ROOT, "dist/hooks/agent-finalize.js");
+        for (const h of [sessionInitHandler, bootstrapHandler, finalizeHandler]) {
+            if (!existsSync(h)) {
+                fail(`case D: handler not found at ${h} — run \`bun run build\` first`);
+            }
+        }
+        const initPayload = JSON.stringify({
+            hook_event_name: "SessionStart",
+            session_id: "test-sid-abc",
+            cwd: trackerTmpDir,
+            source: "startup",
+        });
+        const initResult = await spawnWithStdin(sessionInitHandler, initPayload, { NEXUS_TEST_PPID: "999001" });
+        if (initResult.code !== 0) {
+            fail(`case D (session-init) exited with code ${initResult.code}\n  stderr: ${initResult.stderr.slice(0, 300)}`);
+        }
+        const trackerPath = join(trackerTmpDir, ".nexus/state/test-sid-abc/agent-tracker.json");
+        if (!existsSync(trackerPath)) {
+            fail(`case D: agent-tracker.json not created at ${trackerPath}`);
+        }
+        const initTracker = JSON.parse(readFileSync(trackerPath, "utf-8"));
+        if (!Array.isArray(initTracker) || initTracker.length !== 0) {
+            fail(`case D: agent-tracker.json after session-init should be [], got ${JSON.stringify(initTracker)}`);
+        }
+        const bootstrapPayload = JSON.stringify({
+            hook_event_name: "SubagentStart",
+            cwd: trackerTmpDir,
+            session_id: "test-sid-abc",
+            agent_type: "architect",
+            agent_id: "test-agent-xyz",
+        });
+        const bootstrapResult = await spawnWithStdin(bootstrapHandler, bootstrapPayload, { NEXUS_TEST_PPID: "999001" });
+        if (bootstrapResult.code !== 0) {
+            fail(`case D (agent-bootstrap) exited with code ${bootstrapResult.code}\n  stderr: ${bootstrapResult.stderr.slice(0, 300)}`);
+        }
+        const afterBootstrap = JSON.parse(readFileSync(trackerPath, "utf-8"));
+        if (!Array.isArray(afterBootstrap) || afterBootstrap.length !== 1) {
+            fail(`case D: tracker after bootstrap should have 1 entry, got ${JSON.stringify(afterBootstrap)}`);
+        }
+        const entry = afterBootstrap[0];
+        if (entry["agent_id"] !== "test-agent-xyz") {
+            fail(`case D: tracker entry agent_id="${entry["agent_id"]}", expected "test-agent-xyz"`);
+        }
+        if (entry["agent_type"] !== "architect") {
+            fail(`case D: tracker entry agent_type="${entry["agent_type"]}", expected "architect"`);
+        }
+        if (entry["status"] !== "running") {
+            fail(`case D: tracker entry status="${entry["status"]}", expected "running"`);
+        }
+        if (typeof entry["started_at"] !== "string" || !entry["started_at"]) {
+            fail(`case D: tracker entry started_at missing or not a string`);
+        }
+        const finalizePayload = JSON.stringify({
+            hook_event_name: "SubagentStop",
+            cwd: trackerTmpDir,
+            session_id: "test-sid-abc",
+            agent_type: "architect",
+            agent_id: "test-agent-xyz",
+            last_assistant_message: "",
+        });
+        const finalizeResult = await spawnWithStdin(finalizeHandler, finalizePayload, { NEXUS_TEST_PPID: "999001" });
+        if (finalizeResult.code !== 0) {
+            fail(`case D (agent-finalize) exited with code ${finalizeResult.code}\n  stderr: ${finalizeResult.stderr.slice(0, 300)}`);
+        }
+        const afterFinalize = JSON.parse(readFileSync(trackerPath, "utf-8"));
+        if (!Array.isArray(afterFinalize) || afterFinalize.length !== 1) {
+            fail(`case D: tracker after finalize should have 1 entry, got ${JSON.stringify(afterFinalize)}`);
+        }
+        const finalEntry = afterFinalize[0];
+        if (finalEntry["status"] !== "completed") {
+            fail(`case D: tracker entry status="${finalEntry["status"]}", expected "completed"`);
+        }
+        if (typeof finalEntry["stopped_at"] !== "string" || !finalEntry["stopped_at"]) {
+            fail(`case D: tracker entry stopped_at missing or not a string`);
+        }
+        console.log("[smoke-consumer] PASS — case D: tracker lifecycle (init → bootstrap → finalize)");
+    }
+    finally {
+        if (savedTestPpid2 === undefined) {
+            delete process.env["NEXUS_TEST_PPID"];
+        }
+        else {
+            process.env["NEXUS_TEST_PPID"] = savedTestPpid2;
+        }
+        if (savedSessionId2 !== undefined) {
+            process.env["NEXUS_SESSION_ID"] = savedSessionId2;
+        }
+        rmSync(trackerTmpDir, { recursive: true, force: true });
+    }
 }
 finally {
     rmSync(tmpDir, { recursive: true, force: true });

package/dist/scripts/smoke/smoke-consumer.js.map

@@ -1 +1 @@
-{"version":3,"file":"smoke-consumer.js","sourceRoot":"","sources":["../../../scripts/smoke/smoke-consumer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"smoke-consumer.js","sourceRoot":"","sources":["../../../scripts/smoke/smoke-consumer.ts"],"names":[],"mappings":"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"}

package/dist/src/shared/paths.d.ts

@@ -14,7 +14,9 @@ export declare function getStateRoot(cwd?: string): string;
 export declare function getCurrentBranch(cwd?: string): string;
 /** 디렉토리 생성 (재귀). 이미 존재하면 idempotent */
 export declare function ensureDir(p: string): void;
-/** NEXUS_SESSION_ID env 우선, 없으면 '<branch>-<pid>' 또는 'unknown-<pid>' */
+export declare function getParentPid(): number;
+export declare function resetByPpidCache(): void;
+/** NEXUS_SESSION_ID env 우선, 없으면 by-ppid 파일, 없으면 '<branch>-<pid>' 또는 'unknown-<pid>' */
 export declare function getSessionId(cwd?: string): string;
 /** .nexus/state/<session_id>/ 경로 */
 export declare function getSessionRoot(cwd?: string): string;

package/dist/src/shared/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzC;AAOD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzC;AAeD,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AASD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAoBD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/src/shared/paths.js

@@ -1,5 +1,5 @@
 import { join, resolve } from 'path';
-import { existsSync, mkdirSync } from 'fs';
+import { existsSync, mkdirSync, statSync, readFileSync } from 'fs';
 import { execSync } from 'child_process';
 /**
  * 프로젝트 루트 해석. 우선순위:
@@ -63,11 +63,47 @@ export function ensureDir(p) {
 function sanitizeBranch(name) {
     return name.replace(/[^a-zA-Z0-9_-]+/g, '_');
 }
-/** NEXUS_SESSION_ID env 우선, 없으면 '<branch>-<pid>' 또는 'unknown-<pid>' */
+function runtimeByPpidDir(cwd) {
+    return join(cwd, '.nexus/state/runtime/by-ppid');
+}
+function byPpidFilePath(cwd, ppid) {
+    return join(runtimeByPpidDir(cwd), `${ppid}.json`);
+}
+export function getParentPid() {
+    const testOverride = parseInt(process.env['NEXUS_TEST_PPID'] ?? '');
+    return testOverride || process.ppid;
+}
+const byPpidCache = new Map();
+export function resetByPpidCache() {
+    byPpidCache.clear();
+}
+function readSessionIdFromByPpidFile(cwd) {
+    try {
+        const ppid = getParentPid();
+        const filePath = byPpidFilePath(cwd, ppid);
+        const st = statSync(filePath);
+        const cached = byPpidCache.get(filePath);
+        if (cached && cached.mtimeMs === st.mtimeMs) {
+            return cached.value;
+        }
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        byPpidCache.set(filePath, { mtimeMs: st.mtimeMs, value: parsed.session_id });
+        return parsed.session_id;
+    }
+    catch {
+        return null;
+    }
+}
+/** NEXUS_SESSION_ID env 우선, 없으면 by-ppid 파일, 없으면 '<branch>-<pid>' 또는 'unknown-<pid>' */
 export function getSessionId(cwd) {
     const envId = process.env['NEXUS_SESSION_ID'];
     if (envId)
         return envId;
+    const resolvedCwd = cwd ?? process.cwd();
+    const byPpidId = readSessionIdFromByPpidFile(resolvedCwd);
+    if (byPpidId)
+        return byPpidId;
     const branch = getCurrentBranch(cwd);
     const pid = process.pid;
     if (!branch)

package/dist/src/shared/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"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"}

package/docs/contract/harness-io.md

@@ -206,10 +206,15 @@ description = "..."
 developer_instructions = """<body>"""
 model = "..."
 sandbox_mode = "..."
-disabled_tools = [...]
+
+[mcp_servers.nx]
+command = "nexus-mcp"
+disabled_tools = ["nx_task_add"]    # 예시 — 실제 항목은 capability-matrix 조합에 따라 다름
 ```
 
-> **주의**: `[agents.<id>]` nested 구조는 `~/.codex/config.toml`(global config)의 agent 정의용이며, standalone role file과 혼용하면 안 된다. standalone 파일에는 반드시 root-level `name`·`developer_instructions` 형식을 사용한다.
+> **주의 1**: `[agents.<id>]` nested 구조는 `~/.codex/config.toml`(global config)의 agent 정의용이며, standalone role file과 혼용하면 안 된다. standalone 파일에는 반드시 root-level `name`·`developer_instructions` 형식을 사용한다.
+
+> **주의 2**: `disabled_tools`는 `[mcp_servers.<id>]` 블록 하위에만 배치한다. root-level에 배치하면 Codex 0.121+ `RawAgentRoleFileToml`의 `deny_unknown_fields`에 걸려 role 전체가 reject된다. `disabled_tools`가 비어 있을 때는 `[mcp_servers.nx]` 블록 자체를 생략한다.
 
 **도메인 서브디렉터리 구조**: Codex 내부 `plugin/`·`agents/`·`install/` 서브디렉터리는 Codex 생태계가 `~/.codex/plugins/`·`~/.codex/agents/`·`~/.codex/config.toml` 3곳에 분리 설치되는 구조를 반영한다. 이 도메인 prefix는 flat 출력 규칙(§4 공통 규칙)과 직교하며 유지된다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moreih29/nexus-core",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Nexus ecosystem authoring layer — canonical agents/skills/hooks and 3-harness build pipeline (Claude Code, OpenCode, Codex)",
   "license": "MIT",
   "type": "module",