@sanqianx/project-knowledge 5.0.19 → 5.0.20-rc.1

package/_site/lib/runtime-control.js

@@ -1,89 +1,89 @@
-'use strict';
-const net = require('node:net');
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-
-const SCHEMA = 'project-knowledge/runtime-control/v1';
-function normalizeDataDir(value) {
-  const absolute = path.resolve(value);
-  return process.platform === 'win32' ? absolute.toLowerCase() : absolute;
-}
-function controlPath(dataDir) {
-  const hash = crypto.createHash('sha256').update(normalizeDataDir(dataDir)).digest('hex').slice(0, 32);
-  return process.platform === 'win32' ? `\\\\.\\pipe\\project-knowledge-${hash}` : path.join(dataDir, 'runtime-control.sock');
-}
-function identity(dataDir, endpoint = {}) {
-  return { schema: SCHEMA, name: 'project-knowledge', pid: process.pid, dataDir: path.resolve(dataDir), ...endpoint };
-}
-function request(dataDir, message, timeoutMs = 45000) {
-  return new Promise((resolve, reject) => {
-    const socket = net.createConnection(controlPath(dataDir));
-    let buffer = '', done = false;
-    const timer = setTimeout(() => socket.destroy(new Error('知识库控制请求超时，停止尚未确认。')), timeoutMs);
-    const finish = (error, result) => {
-      if (done) return; done = true;
-      clearTimeout(timer); socket.destroy();
-      if (error) reject(error); else resolve(result);
-    };
-    socket.once('connect', () => socket.write(JSON.stringify(message) + '\n'));
-    socket.on('data', chunk => {
-      buffer += chunk.toString();
-      if (buffer.length > 65536) return finish(new Error('无效的实例响应。'));
-      if (!buffer.includes('\n')) return;
-      try {
-        const value = JSON.parse(buffer.slice(0, buffer.indexOf('\n')));
-        if (!value.ok) return finish(new Error(value.message || '实例控制失败。'));
-        if (value.instance?.schema !== SCHEMA || normalizeDataDir(value.instance.dataDir) !== normalizeDataDir(dataDir)) return finish(new Error('实例身份不匹配，已拒绝控制。'));
-        finish(null, value);
-      } catch (error) { finish(error); }
-    });
-    socket.once('error', error => finish(error));
-    socket.once('end', () => { if (!buffer.includes('\n')) finish(new Error('实例断开连接，停止尚未确认。')); });
-  });
-}
-
-async function listen(dataDir, info, stop) {
-  const address = controlPath(dataDir);
-  if (process.platform !== 'win32' && fs.existsSync(address)) {
-    try { await request(dataDir, { action: 'status' }, 1000); throw new Error('另一个知识库实例已占用控制通道。'); }
-    catch (error) {
-      if (!['ECONNREFUSED', 'ENOENT'].includes(error.code)) throw error;
-      fs.unlinkSync(address);
-    }
-  }
-  const sockets = new Set();
-  let stopping = false, stoppingSocket;
-  const server = net.createServer(socket => {
-    sockets.add(socket); socket.once('close', () => sockets.delete(socket));
-    socket.on('error', () => {});
-    socket.setTimeout(45000, () => socket.destroy());
-    let buffer = '';
-    socket.on('data', chunk => {
-      buffer += chunk.toString();
-      if (buffer.length > 16384) return socket.destroy();
-      if (!buffer.includes('\n')) return;
-      socket.removeAllListeners('data');
-      const respond = value => { if (!socket.destroyed) socket.end(JSON.stringify({ ...value, instance: info }) + '\n'); };
-      let message;
-      try { message = JSON.parse(buffer.slice(0, buffer.indexOf('\n'))); }
-      catch { return respond({ ok: false, message: '无效的控制请求。' }); }
-      if (message.action === 'status') return respond({ ok: true, status: stopping ? 'stopping' : 'running' });
-      // A stale endpoint/port must never become a signal to an unrelated PID.
-      if (message.action !== 'stop' || message.pid !== info.pid || message.port !== info.port || message.startedAt !== info.startedAt) return respond({ ok: false, message: '实例身份已变化，已拒绝停止。' });
-      if (stopping) return respond({ ok: false, message: '实例正在停止，请稍后查询状态。' });
-      stopping = true; stoppingSocket = socket;
-      Promise.resolve().then(stop).then(() => respond({ ok: true, status: 'stopped' })).catch(error => respond({ ok: false, message: error.message }));
-    });
-  });
-  await new Promise((resolve, reject) => { server.once('error', reject); server.listen(address, resolve); });
-  if (process.platform !== 'win32') fs.chmodSync(address, 0o600);
-  return {
-    close() {
-      // Keep only the requesting socket for the final shutdown acknowledgement.
-      return new Promise(resolve => { server.close(resolve); for (const socket of sockets) if (socket !== stoppingSocket) socket.destroy(); if (stopping) resolve(); });
-    },
-  };
-}
-
-module.exports = { SCHEMA, normalizeDataDir, identity, controlPath, request, listen };
+'use strict';
+const net = require('node:net');
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+
+const SCHEMA = 'project-knowledge/runtime-control/v1';
+function normalizeDataDir(value) {
+  const absolute = path.resolve(value);
+  return process.platform === 'win32' ? absolute.toLowerCase() : absolute;
+}
+function controlPath(dataDir) {
+  const hash = crypto.createHash('sha256').update(normalizeDataDir(dataDir)).digest('hex').slice(0, 32);
+  return process.platform === 'win32' ? `\\\\.\\pipe\\project-knowledge-${hash}` : path.join(dataDir, 'runtime-control.sock');
+}
+function identity(dataDir, endpoint = {}) {
+  return { schema: SCHEMA, name: 'project-knowledge', pid: process.pid, dataDir: path.resolve(dataDir), ...endpoint };
+}
+function request(dataDir, message, timeoutMs = 45000) {
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection(controlPath(dataDir));
+    let buffer = '', done = false;
+    const timer = setTimeout(() => socket.destroy(new Error('知识库控制请求超时，停止尚未确认。')), timeoutMs);
+    const finish = (error, result) => {
+      if (done) return; done = true;
+      clearTimeout(timer); socket.destroy();
+      if (error) reject(error); else resolve(result);
+    };
+    socket.once('connect', () => socket.write(JSON.stringify(message) + '\n'));
+    socket.on('data', chunk => {
+      buffer += chunk.toString();
+      if (buffer.length > 65536) return finish(new Error('无效的实例响应。'));
+      if (!buffer.includes('\n')) return;
+      try {
+        const value = JSON.parse(buffer.slice(0, buffer.indexOf('\n')));
+        if (!value.ok) return finish(new Error(value.message || '实例控制失败。'));
+        if (value.instance?.schema !== SCHEMA || normalizeDataDir(value.instance.dataDir) !== normalizeDataDir(dataDir)) return finish(new Error('实例身份不匹配，已拒绝控制。'));
+        finish(null, value);
+      } catch (error) { finish(error); }
+    });
+    socket.once('error', error => finish(error));
+    socket.once('end', () => { if (!buffer.includes('\n')) finish(new Error('实例断开连接，停止尚未确认。')); });
+  });
+}
+
+async function listen(dataDir, info, stop) {
+  const address = controlPath(dataDir);
+  if (process.platform !== 'win32' && fs.existsSync(address)) {
+    try { await request(dataDir, { action: 'status' }, 1000); throw new Error('另一个知识库实例已占用控制通道。'); }
+    catch (error) {
+      if (!['ECONNREFUSED', 'ENOENT'].includes(error.code)) throw error;
+      fs.unlinkSync(address);
+    }
+  }
+  const sockets = new Set();
+  let stopping = false, stoppingSocket;
+  const server = net.createServer(socket => {
+    sockets.add(socket); socket.once('close', () => sockets.delete(socket));
+    socket.on('error', () => {});
+    socket.setTimeout(45000, () => socket.destroy());
+    let buffer = '';
+    socket.on('data', chunk => {
+      buffer += chunk.toString();
+      if (buffer.length > 16384) return socket.destroy();
+      if (!buffer.includes('\n')) return;
+      socket.removeAllListeners('data');
+      const respond = value => { if (!socket.destroyed) socket.end(JSON.stringify({ ...value, instance: info }) + '\n'); };
+      let message;
+      try { message = JSON.parse(buffer.slice(0, buffer.indexOf('\n'))); }
+      catch { return respond({ ok: false, message: '无效的控制请求。' }); }
+      if (message.action === 'status') return respond({ ok: true, status: stopping ? 'stopping' : 'running' });
+      // A stale endpoint/port must never become a signal to an unrelated PID.
+      if (message.action !== 'stop' || message.pid !== info.pid || message.port !== info.port || message.startedAt !== info.startedAt) return respond({ ok: false, message: '实例身份已变化，已拒绝停止。' });
+      if (stopping) return respond({ ok: false, message: '实例正在停止，请稍后查询状态。' });
+      stopping = true; stoppingSocket = socket;
+      Promise.resolve().then(stop).then(() => respond({ ok: true, status: 'stopped' })).catch(error => respond({ ok: false, message: error.message }));
+    });
+  });
+  await new Promise((resolve, reject) => { server.once('error', reject); server.listen(address, resolve); });
+  if (process.platform !== 'win32') fs.chmodSync(address, 0o600);
+  return {
+    close() {
+      // Keep only the requesting socket for the final shutdown acknowledgement.
+      return new Promise(resolve => { server.close(resolve); for (const socket of sockets) if (socket !== stoppingSocket) socket.destroy(); if (stopping) resolve(); });
+    },
+  };
+}
+
+module.exports = { SCHEMA, normalizeDataDir, identity, controlPath, request, listen };

package/_site/lib/runtime-endpoint.js

@@ -88,8 +88,8 @@ function writeEndpoint(dataDir, value) {
   } catch (error) {
     // Windows cannot always replace an existing file with renameSync.
     try { fs.unlinkSync(target); } catch {
-      // The following rename is authoritative and reports endpoint replacement failure.
-    }
+      // The following rename is authoritative and reports endpoint replacement failure.
+    }
     fs.renameSync(temp, target);
   }
   return endpoint;
@@ -122,9 +122,9 @@ function claimEndpoint(dataDir, value) {
       try {
         const ageMs = Date.now() - fs.statSync(target).mtimeMs;
         if (!existing && ageMs < 2000) return { claimed: false, endpoint: null };
-      } catch {
-        // clearEndpoint performs the ownership-safe final check when stat is unavailable.
-      }
+      } catch {
+        // clearEndpoint performs the ownership-safe final check when stat is unavailable.
+      }
       clearEndpoint(dataDir, existing ? { pid: existing.pid } : {});
     }
   }

package/_site/lib/zcode-context-integration.js

@@ -1,60 +1,60 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const AtomicFile = require('./atomic-file');
-
-function configuration(file) {
-  if (!fs.existsSync(file)) return {};
-  let value; try { value = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { throw new Error('ZCode 配置不是有效 JSON，未覆盖原文件。'); }
-  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('ZCode 配置必须是 JSON 对象，未覆盖原文件。');
-  return value;
-}
-const scriptFor = root => path.join(root, 'plugins/project-knowledge/scripts/context-hook.cjs');
-const normalize = file => { const value = path.resolve(file).replace(/\\/g, '/'); return process.platform === 'win32' ? value.toLowerCase() : value; };
-function owned(hook, root) {
-  if (hook?.type !== 'process' || hook.command !== 'node' || !Array.isArray(hook.args) || hook.args.length !== 3 || typeof hook.args[0] !== 'string' || !path.isAbsolute(hook.args[0]) || hook.args[1] !== '--client' || hook.args[2] !== 'zcode') return false;
-  const file = normalize(hook.args[0]);
-  // Only the exact current script or a canonical managed npm installation is
-  // ours. An unrelated script with a similar basename remains untouched.
-  return file === normalize(scriptFor(root)) || /\/node_modules\/(?:@sanqianx\/)?project-knowledge\/plugins\/project-knowledge\/scripts\/context-hook\.cjs$/i.test(file);
-}
-function status({ configFile, rootDir }) {
-  const config = configuration(configFile);
-  const entries = (config.hooks?.events?.UserPromptSubmit || []).flatMap(g => Array.isArray(g?.hooks) ? g.hooks.filter(h => owned(h, rootDir)) : []);
-  const installed = entries.length === 1 && normalize(entries[0].args[0]) === normalize(scriptFor(rootDir)) && fs.existsSync(scriptFor(rootDir));
-  const disabled = config.hooks?.enabled === false;
-  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : entries.length ? 'needs-repair' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : entries.length ? '知识读取入口仍指向旧安装或重复配置，请接入/修复；未误报就绪。' : '开发前知识读取尚未接入；与会话采集独立。' };
-}
-function install({ configFile, rootDir, dryRun }) {
-  const config = configuration(configFile);
-  if (config.hooks?.enabled === false) throw new Error('ZCode Hook 已被用户禁用，请在客户端明确启用后重试；未覆盖配置。');
-  if (!fs.existsSync(scriptFor(rootDir))) throw new Error('缺少已安装的知识读取脚本。');
-  if (!dryRun) {
-    if (config.hooks && (typeof config.hooks !== 'object' || Array.isArray(config.hooks))) throw new Error('ZCode Hook 配置格式无效，未覆盖。');
-    config.hooks ||= {}; config.hooks.events ||= {};
-    if (typeof config.hooks.events !== 'object' || Array.isArray(config.hooks.events)) throw new Error('ZCode Hook 事件配置格式无效，未覆盖。');
-    const groups = config.hooks.events.UserPromptSubmit || [];
-    if (!Array.isArray(groups)) throw new Error('ZCode UserPromptSubmit 配置格式无效，未覆盖。');
-    const hook = { type: 'process', command: 'node', args: [scriptFor(rootDir), '--client', 'zcode'], timeoutMs: 12000 };
-    let found = false;
-    const updated = groups.map(group => {
-      if (!Array.isArray(group?.hooks)) return group;
-      const hooks = group.hooks.flatMap(h => { if (!owned(h, rootDir)) return [h]; if (found) return []; found = true; return [hook]; });
-      return hooks.length || !group.hooks.length ? { ...group, hooks } : null;
-    }).filter(Boolean);
-    if (!found) updated.push({ hooks: [hook] });
-    config.hooks.events.UserPromptSubmit = updated; config.hooks.enabled = true;
-    AtomicFile.writeJsonAtomic(configFile, config);
-  }
-  return { state: dryRun ? 'planned' : 'installed', supported: true, installed: !dryRun, detail: 'ZCode 原生前置读取已配置，保留原模型、第三方 Hook 与采集入口；请重新打开会话。' };
-}
-function uninstall({ configFile, rootDir, dryRun }) {
-  const config = configuration(configFile), groups = config.hooks?.events?.UserPromptSubmit;
-  if (!dryRun && Array.isArray(groups)) {
-    const kept = groups.map(group => { if (!Array.isArray(group?.hooks)) return group; const hooks = group.hooks.filter(h => !owned(h, rootDir)); return hooks.length ? { ...group, hooks } : null; }).filter(Boolean);
-    if (kept.length) config.hooks.events.UserPromptSubmit = kept; else delete config.hooks.events.UserPromptSubmit;
-    AtomicFile.writeJsonAtomic(configFile, config);
-  }
-  return { state: dryRun ? 'planned' : 'removed', supported: true, installed: false, detail: '已移除知识上下文入口，采集、模型和第三方设置保留。' };
-}
-module.exports = { install, status, uninstall };
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const AtomicFile = require('./atomic-file');
+
+function configuration(file) {
+  if (!fs.existsSync(file)) return {};
+  let value; try { value = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { throw new Error('ZCode 配置不是有效 JSON，未覆盖原文件。'); }
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('ZCode 配置必须是 JSON 对象，未覆盖原文件。');
+  return value;
+}
+const scriptFor = root => path.join(root, 'plugins/project-knowledge/scripts/context-hook.cjs');
+const normalize = file => { const value = path.resolve(file).replace(/\\/g, '/'); return process.platform === 'win32' ? value.toLowerCase() : value; };
+function owned(hook, root) {
+  if (hook?.type !== 'process' || hook.command !== 'node' || !Array.isArray(hook.args) || hook.args.length !== 3 || typeof hook.args[0] !== 'string' || !path.isAbsolute(hook.args[0]) || hook.args[1] !== '--client' || hook.args[2] !== 'zcode') return false;
+  const file = normalize(hook.args[0]);
+  // Only the exact current script or a canonical managed npm installation is
+  // ours. An unrelated script with a similar basename remains untouched.
+  return file === normalize(scriptFor(root)) || /\/node_modules\/(?:@sanqianx\/)?project-knowledge\/plugins\/project-knowledge\/scripts\/context-hook\.cjs$/i.test(file);
+}
+function status({ configFile, rootDir }) {
+  const config = configuration(configFile);
+  const entries = (config.hooks?.events?.UserPromptSubmit || []).flatMap(g => Array.isArray(g?.hooks) ? g.hooks.filter(h => owned(h, rootDir)) : []);
+  const installed = entries.length === 1 && normalize(entries[0].args[0]) === normalize(scriptFor(rootDir)) && fs.existsSync(scriptFor(rootDir));
+  const disabled = config.hooks?.enabled === false;
+  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : entries.length ? 'needs-repair' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : entries.length ? '知识读取入口仍指向旧安装或重复配置，请接入/修复；未误报就绪。' : '开发前知识读取尚未接入；与会话采集独立。' };
+}
+function install({ configFile, rootDir, dryRun }) {
+  const config = configuration(configFile);
+  if (config.hooks?.enabled === false) throw new Error('ZCode Hook 已被用户禁用，请在客户端明确启用后重试；未覆盖配置。');
+  if (!fs.existsSync(scriptFor(rootDir))) throw new Error('缺少已安装的知识读取脚本。');
+  if (!dryRun) {
+    if (config.hooks && (typeof config.hooks !== 'object' || Array.isArray(config.hooks))) throw new Error('ZCode Hook 配置格式无效，未覆盖。');
+    config.hooks ||= {}; config.hooks.events ||= {};
+    if (typeof config.hooks.events !== 'object' || Array.isArray(config.hooks.events)) throw new Error('ZCode Hook 事件配置格式无效，未覆盖。');
+    const groups = config.hooks.events.UserPromptSubmit || [];
+    if (!Array.isArray(groups)) throw new Error('ZCode UserPromptSubmit 配置格式无效，未覆盖。');
+    const hook = { type: 'process', command: 'node', args: [scriptFor(rootDir), '--client', 'zcode'], timeoutMs: 12000 };
+    let found = false;
+    const updated = groups.map(group => {
+      if (!Array.isArray(group?.hooks)) return group;
+      const hooks = group.hooks.flatMap(h => { if (!owned(h, rootDir)) return [h]; if (found) return []; found = true; return [hook]; });
+      return hooks.length || !group.hooks.length ? { ...group, hooks } : null;
+    }).filter(Boolean);
+    if (!found) updated.push({ hooks: [hook] });
+    config.hooks.events.UserPromptSubmit = updated; config.hooks.enabled = true;
+    AtomicFile.writeJsonAtomic(configFile, config);
+  }
+  return { state: dryRun ? 'planned' : 'installed', supported: true, installed: !dryRun, detail: 'ZCode 原生前置读取已配置，保留原模型、第三方 Hook 与采集入口；请重新打开会话。' };
+}
+function uninstall({ configFile, rootDir, dryRun }) {
+  const config = configuration(configFile), groups = config.hooks?.events?.UserPromptSubmit;
+  if (!dryRun && Array.isArray(groups)) {
+    const kept = groups.map(group => { if (!Array.isArray(group?.hooks)) return group; const hooks = group.hooks.filter(h => !owned(h, rootDir)); return hooks.length ? { ...group, hooks } : null; }).filter(Boolean);
+    if (kept.length) config.hooks.events.UserPromptSubmit = kept; else delete config.hooks.events.UserPromptSubmit;
+    AtomicFile.writeJsonAtomic(configFile, config);
+  }
+  return { state: dryRun ? 'planned' : 'removed', supported: true, installed: false, detail: '已移除知识上下文入口，采集、模型和第三方设置保留。' };
+}
+module.exports = { install, status, uninstall };

package/_site/scripts/codex-notify-fanout.cjs

@@ -1,95 +1,95 @@
-#!/usr/bin/env node
-'use strict';
-
-// Codex supports one notify command. This fail-open fan-out preserves an
-// existing notifier and invokes the Bridge beside it.
-const { spawn } = require('child_process');
-const os = require('os');
-const path = require('path');
-
-function commandFrom(args, marker) {
-  const index = args.indexOf(marker);
-  if (index < 0 || !args[index + 1]) return null;
-  try {
-    const command = JSON.parse(Buffer.from(args[index + 1], 'base64').toString('utf8'));
-    return Array.isArray(command) && command.length && command.every(part => typeof part === 'string') ? command : null;
-  } catch {
-    return null;
-  }
-}
-
-function readStdin() {
-  return new Promise(resolve => {
-    let value = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', chunk => { value += chunk; });
-    process.stdin.on('end', () => resolve(value));
-    process.stdin.on('error', () => resolve(value));
-  });
-}
-
-function payloadArgument(args) {
-  const last = args.length - 1;
-  if (last < 0 || ['--next-base64', '--bridge-base64'].includes(args[last - 1])) return null;
-  try {
-    const payload = JSON.parse(args[last]);
-    return payload && typeof payload === 'object' && !Array.isArray(payload) ? args[last] : null;
-  } catch {
-    return null;
-  }
-}
-
-function bridgePayload(raw) {
-  try {
-    const payload = JSON.parse(raw);
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return raw;
-    let changed = false;
-    if (!payload.session_id && !payload.sessionId && typeof payload['thread-id'] === 'string') {
-      payload.session_id = payload['thread-id'];
-      changed = true;
-    }
-    if (!payload.turn_id && !payload.turnId && typeof payload['turn-id'] === 'string') {
-      payload.turn_id = payload['turn-id'];
-      changed = true;
-    }
-    // The notification only wakes the authoritative rollout reader. It must
-    // never substitute its summary fields for captured conversation evidence.
-    return changed ? JSON.stringify(payload) : raw;
-  } catch {
-    return raw;
-  }
-}
-
-function invoke(command, payload, env, transport = 'stdin') {
-  if (!command) return;
-  try {
-    const [executable, ...args] = command;
-    const child = spawn(executable, transport === 'argv' ? [...args, payload] : args, {
-      detached: true,
-      stdio: [transport === 'argv' ? 'ignore' : 'pipe', 'ignore', 'ignore'],
-      windowsHide: true,
-      env,
-    });
-    child.on('error', () => {});
-    if (child.stdin) {
-      child.stdin.on('error', () => {});
-      child.stdin.end(payload || '');
-    }
-    child.unref();
-  } catch {
-    // A notifier must never block Codex itself.
-  }
-}
-
-(async () => {
-  const args = process.argv.slice(2);
-  const argument = payloadArgument(args);
-  // Codex passes one JSON argument; legacy callers used stdin. Do not wait for
-  // an open stdin in argv mode, and keep the third-party transport unchanged.
-  const payload = argument === null ? await readStdin() : argument;
-  invoke(commandFrom(args, '--next-base64'), payload, process.env, argument === null ? 'stdin' : 'argv');
-  invoke(commandFrom(args, '--bridge-base64'), bridgePayload(payload), {
-    ...process.env,
-    CODEX_SESSIONS_ROOT: process.env.CODEX_SESSIONS_ROOT || path.join(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'sessions'),
-  });
-})();
+#!/usr/bin/env node
+'use strict';
+
+// Codex supports one notify command. This fail-open fan-out preserves an
+// existing notifier and invokes the Bridge beside it.
+const { spawn } = require('child_process');
+const os = require('os');
+const path = require('path');
+
+function commandFrom(args, marker) {
+  const index = args.indexOf(marker);
+  if (index < 0 || !args[index + 1]) return null;
+  try {
+    const command = JSON.parse(Buffer.from(args[index + 1], 'base64').toString('utf8'));
+    return Array.isArray(command) && command.length && command.every(part => typeof part === 'string') ? command : null;
+  } catch {
+    return null;
+  }
+}
+
+function readStdin() {
+  return new Promise(resolve => {
+    let value = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', chunk => { value += chunk; });
+    process.stdin.on('end', () => resolve(value));
+    process.stdin.on('error', () => resolve(value));
+  });
+}
+
+function payloadArgument(args) {
+  const last = args.length - 1;
+  if (last < 0 || ['--next-base64', '--bridge-base64'].includes(args[last - 1])) return null;
+  try {
+    const payload = JSON.parse(args[last]);
+    return payload && typeof payload === 'object' && !Array.isArray(payload) ? args[last] : null;
+  } catch {
+    return null;
+  }
+}
+
+function bridgePayload(raw) {
+  try {
+    const payload = JSON.parse(raw);
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return raw;
+    let changed = false;
+    if (!payload.session_id && !payload.sessionId && typeof payload['thread-id'] === 'string') {
+      payload.session_id = payload['thread-id'];
+      changed = true;
+    }
+    if (!payload.turn_id && !payload.turnId && typeof payload['turn-id'] === 'string') {
+      payload.turn_id = payload['turn-id'];
+      changed = true;
+    }
+    // The notification only wakes the authoritative rollout reader. It must
+    // never substitute its summary fields for captured conversation evidence.
+    return changed ? JSON.stringify(payload) : raw;
+  } catch {
+    return raw;
+  }
+}
+
+function invoke(command, payload, env, transport = 'stdin') {
+  if (!command) return;
+  try {
+    const [executable, ...args] = command;
+    const child = spawn(executable, transport === 'argv' ? [...args, payload] : args, {
+      detached: true,
+      stdio: [transport === 'argv' ? 'ignore' : 'pipe', 'ignore', 'ignore'],
+      windowsHide: true,
+      env,
+    });
+    child.on('error', () => {});
+    if (child.stdin) {
+      child.stdin.on('error', () => {});
+      child.stdin.end(payload || '');
+    }
+    child.unref();
+  } catch {
+    // A notifier must never block Codex itself.
+  }
+}
+
+(async () => {
+  const args = process.argv.slice(2);
+  const argument = payloadArgument(args);
+  // Codex passes one JSON argument; legacy callers used stdin. Do not wait for
+  // an open stdin in argv mode, and keep the third-party transport unchanged.
+  const payload = argument === null ? await readStdin() : argument;
+  invoke(commandFrom(args, '--next-base64'), payload, process.env, argument === null ? 'stdin' : 'argv');
+  invoke(commandFrom(args, '--bridge-base64'), bridgePayload(payload), {
+    ...process.env,
+    CODEX_SESSIONS_ROOT: process.env.CODEX_SESSIONS_ROOT || path.join(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'sessions'),
+  });
+})();