@sanqianx/ai-coding-event-bridge-console 0.7.2 → 0.7.4

package/package.json

@@ -1,26 +1,26 @@
-{
-  "name": "@sanqianx/ai-coding-event-bridge-console",
-  "version": "0.7.2",
-  "description": "Durable AI coding event bridge, all in one: capture connectors and installers (Claude Code, Codex, OpenCode, ZCode), journal with commit boundaries and per-commit conversation sealing, headless query, and a local conversation explorer console.",
-  "license": "MIT",
-  "private": false,
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/SanQianX/ai-coding-event-bridge",
-    "directory": "packages/console"
-  },
-  "main": "src/server.js",
-  "bin": {
-    "ai-coding-event-bridge-console": "src/bin.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "src",
-    "console"
-  ],
-  "scripts": {
-    "test": "node ../../test/run-all.js"
-  }
-}
+{
+  "name": "@sanqianx/ai-coding-event-bridge-console",
+  "version": "0.7.4",
+  "description": "Durable AI coding event bridge, all in one: capture connectors and installers (Claude Code, Codex, OpenCode, ZCode), journal with commit boundaries and per-commit conversation sealing, headless query, and a local conversation explorer console.",
+  "license": "MIT",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SanQianX/ai-coding-event-bridge",
+    "directory": "packages/console"
+  },
+  "main": "src/server.js",
+  "bin": {
+    "ai-coding-event-bridge-console": "src/bin.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src",
+    "console"
+  ],
+  "scripts": {
+    "test": "node ../../test/run-all.js"
+  }
+}

package/src/agent-detect.js

@@ -1,128 +1,128 @@
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { execFileSync } = require('child_process');
-const core = require('./bridge');
-
-/**
- * Detection of AI coding agent tools on this machine. "Installed" means the
- * CLI is on PATH or its config exists; "hookInstalled" means the bridge shim
- * is wired in — either as the installer's managed entry, or through a
- * consumer fan-out chain (for example Codex notify lines that forward to the
- * shim base64-encoded), which the managed-entry check alone would miss.
- */
-
-function commandExists(command) {
-  const finder = process.platform === 'win32' ? 'where' : 'which';
-  try {
-    execFileSync(finder, [command], { stdio: 'ignore', windowsHide: true });
-    return true;
-  } catch (_) {
-    return false;
-  }
-}
-
-function readTextIfAny(file) {
-  try {
-    return fs.readFileSync(file, 'utf8');
-  } catch (_) {
-    return null;
-  }
-}
-
-function fileExists(file) {
-  try {
-    return fs.statSync(file).isFile();
-  } catch (_) {
-    return false;
-  }
-}
-
-function mentionsShim(text) {
-  return typeof text === 'string' && (text.includes('bridge-hook.cjs') || text.includes('--bridge-base64'));
-}
-
-async function detectAgents({ homeDir, claudeSettingsFile, codexConfigFile, opencodePluginsDir, zcodeConfigFile } = {}) {
-  const home = os.homedir();
-
-  const claudeFiles = [
-    claudeSettingsFile || path.join(home, '.claude', 'settings.json'),
-    path.join(path.dirname(claudeSettingsFile || path.join(home, '.claude', 'settings.json')), 'settings.local.json')
-  ];
-  const claudeStatus = await core.installers.claudeCode.statusClaudeCodeHook({
-    homeDir,
-    settingsFile: claudeFiles[0]
-  });
-  const claudeConfigFound = claudeFiles.some(fileExists);
-  const claudeTextHooked = claudeFiles.some((file) => mentionsShim(readTextIfAny(file)));
-
-  const codexFile = codexConfigFile || path.join(home, '.codex', 'config.toml');
-  const codexStatus = await core.installers.codex.statusCodexNotify({ homeDir, configFile: codexFile });
-  const codexConfigFound = fileExists(codexFile);
-  const codexTextHooked = mentionsShim(readTextIfAny(codexFile));
-
-  const opencodeDir = opencodePluginsDir || path.join(home, '.config', 'opencode', 'plugin');
-  const opencodeStatus = await core.installers.openCode.statusOpenCodePlugin({ homeDir, pluginsDir: opencodeDir });
-  let opencodePluginHooked = Boolean(opencodeStatus.installed);
-  if (!opencodePluginHooked) {
-    try {
-      for (const name of fs.readdirSync(opencodeDir)) {
-        if (mentionsShim(readTextIfAny(path.join(opencodeDir, name)))) {
-          opencodePluginHooked = true;
-          break;
-        }
-      }
-    } catch (_) {
-      /* no plugin dir */
-    }
-  }
-
-  const zcodeFile = zcodeConfigFile || path.join(home, '.zcode', 'cli', 'config.json');
-  const zcodeStatus = await core.installers.zcode.statusZcodeHook({ homeDir, configFile: zcodeFile });
-
-  return [
-    {
-      id: 'claude-code',
-      label: 'Claude Code',
-      cliFound: commandExists('claude'),
-      configFound: claudeConfigFound,
-      hookInstalled: Boolean(claudeStatus.installed) || claudeTextHooked,
-      managed: Boolean(claudeStatus.installed),
-      managedEvents: claudeStatus.managedEvents || [],
-      detail: claudeStatus.thirdPartyCount ? `另有 ${claudeStatus.thirdPartyCount} 条第三方 hook（保留不动）` : null
-    },
-    {
-      id: 'codex',
-      label: 'Codex',
-      cliFound: commandExists('codex'),
-      configFound: codexConfigFound,
-      hookInstalled: Boolean(codexStatus.installed) || codexTextHooked,
-      managed: Boolean(codexStatus.installed),
-      detail: codexStatus.thirdParty ? 'notify 已被第三方/消费方链占用（转发链仍会调用 bridge）' : null
-    },
-    {
-      id: 'opencode',
-      label: 'OpenCode',
-      cliFound: commandExists('opencode'),
-      configFound: fileExists(path.join(path.dirname(opencodeDir), 'opencode.jsonc')) || fileExists(path.join(path.dirname(opencodeDir), 'opencode.json')),
-      hookInstalled: opencodePluginHooked,
-      managed: Boolean(opencodeStatus.installed),
-      detail: opencodeStatus.thirdPartyFiles && opencodeStatus.thirdPartyFiles.length
-        ? `插件目录另有 ${opencodeStatus.thirdPartyFiles.length} 个第三方插件（保留不动）`
-        : null
-    },
-    {
-      id: 'zcode',
-      label: 'ZCode',
-      cliFound: commandExists('zcode'),
-      configFound: fileExists(zcodeFile),
-      hookInstalled: Boolean(zcodeStatus.installed),
-      managed: Boolean(zcodeStatus.installed),
-      detail: zcodeStatus.thirdPartyCount ? `配置中另有 ${zcodeStatus.thirdPartyCount} 条第三方 hook（保留不动）` : null
-    }
-  ];
-}
-
-module.exports = { detectAgents, commandExists };
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const core = require('./bridge');
+
+/**
+ * Detection of AI coding agent tools on this machine. "Installed" means the
+ * CLI is on PATH or its config exists; "hookInstalled" means the bridge shim
+ * is wired in — either as the installer's managed entry, or through a
+ * consumer fan-out chain (for example Codex notify lines that forward to the
+ * shim base64-encoded), which the managed-entry check alone would miss.
+ */
+
+function commandExists(command) {
+  const finder = process.platform === 'win32' ? 'where' : 'which';
+  try {
+    execFileSync(finder, [command], { stdio: 'ignore', windowsHide: true });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function readTextIfAny(file) {
+  try {
+    return fs.readFileSync(file, 'utf8');
+  } catch (_) {
+    return null;
+  }
+}
+
+function fileExists(file) {
+  try {
+    return fs.statSync(file).isFile();
+  } catch (_) {
+    return false;
+  }
+}
+
+function mentionsShim(text) {
+  return typeof text === 'string' && (text.includes('bridge-hook.cjs') || text.includes('--bridge-base64'));
+}
+
+async function detectAgents({ homeDir, claudeSettingsFile, codexConfigFile, opencodePluginsDir, zcodeConfigFile } = {}) {
+  const home = os.homedir();
+
+  const claudeFiles = [
+    claudeSettingsFile || path.join(home, '.claude', 'settings.json'),
+    path.join(path.dirname(claudeSettingsFile || path.join(home, '.claude', 'settings.json')), 'settings.local.json')
+  ];
+  const claudeStatus = await core.installers.claudeCode.statusClaudeCodeHook({
+    homeDir,
+    settingsFile: claudeFiles[0]
+  });
+  const claudeConfigFound = claudeFiles.some(fileExists);
+  const claudeTextHooked = claudeFiles.some((file) => mentionsShim(readTextIfAny(file)));
+
+  const codexFile = codexConfigFile || path.join(home, '.codex', 'config.toml');
+  const codexStatus = await core.installers.codex.statusCodexNotify({ homeDir, configFile: codexFile });
+  const codexConfigFound = fileExists(codexFile);
+  const codexTextHooked = mentionsShim(readTextIfAny(codexFile));
+
+  const opencodeDir = opencodePluginsDir || path.join(home, '.config', 'opencode', 'plugin');
+  const opencodeStatus = await core.installers.openCode.statusOpenCodePlugin({ homeDir, pluginsDir: opencodeDir });
+  let opencodePluginHooked = Boolean(opencodeStatus.installed);
+  if (!opencodePluginHooked) {
+    try {
+      for (const name of fs.readdirSync(opencodeDir)) {
+        if (mentionsShim(readTextIfAny(path.join(opencodeDir, name)))) {
+          opencodePluginHooked = true;
+          break;
+        }
+      }
+    } catch (_) {
+      /* no plugin dir */
+    }
+  }
+
+  const zcodeFile = zcodeConfigFile || path.join(home, '.zcode', 'cli', 'config.json');
+  const zcodeStatus = await core.installers.zcode.statusZcodeHook({ homeDir, configFile: zcodeFile });
+
+  return [
+    {
+      id: 'claude-code',
+      label: 'Claude Code',
+      cliFound: commandExists('claude'),
+      configFound: claudeConfigFound,
+      hookInstalled: Boolean(claudeStatus.installed) || claudeTextHooked,
+      managed: Boolean(claudeStatus.installed),
+      managedEvents: claudeStatus.managedEvents || [],
+      detail: claudeStatus.thirdPartyCount ? `另有 ${claudeStatus.thirdPartyCount} 条第三方 hook（保留不动）` : null
+    },
+    {
+      id: 'codex',
+      label: 'Codex',
+      cliFound: commandExists('codex'),
+      configFound: codexConfigFound,
+      hookInstalled: Boolean(codexStatus.installed) || codexTextHooked,
+      managed: Boolean(codexStatus.installed),
+      detail: codexStatus.thirdParty ? 'notify 已被第三方/消费方链占用（转发链仍会调用 bridge）' : null
+    },
+    {
+      id: 'opencode',
+      label: 'OpenCode',
+      cliFound: commandExists('opencode'),
+      configFound: fileExists(path.join(path.dirname(opencodeDir), 'opencode.jsonc')) || fileExists(path.join(path.dirname(opencodeDir), 'opencode.json')),
+      hookInstalled: opencodePluginHooked,
+      managed: Boolean(opencodeStatus.installed),
+      detail: opencodeStatus.thirdPartyFiles && opencodeStatus.thirdPartyFiles.length
+        ? `插件目录另有 ${opencodeStatus.thirdPartyFiles.length} 个第三方插件（保留不动）`
+        : null
+    },
+    {
+      id: 'zcode',
+      label: 'ZCode',
+      cliFound: commandExists('zcode'),
+      configFound: fileExists(zcodeFile),
+      hookInstalled: Boolean(zcodeStatus.installed),
+      managed: Boolean(zcodeStatus.installed),
+      detail: zcodeStatus.thirdPartyCount ? `配置中另有 ${zcodeStatus.thirdPartyCount} 条第三方 hook（保留不动）` : null
+    }
+  ];
+}
+
+module.exports = { detectAgents, commandExists };

package/src/bridge/bin/commit-boundary.js

@@ -1,64 +1,64 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Bridge commit-boundary injection point. Any git hook (or a human, or a
- * test) can signal "this repo just committed" by running:
- *
- *   node commit-boundary.js --cwd <repo> [--home <bridge home>]
- *                           [--sha <sha>] [--branch <name>] [--committed-at <iso>]
- *
- * The repo identity is resolved from the working tree (that is how the bridge
- * knows which registered project — and therefore which store — the commit
- * belongs to). Facts not provided are read from the repo's git. Output is a
- * single JSON line on stdout; errors exit non-zero so callers can distinguish
- * a failed injection from a skip.
- */
-
-const { execFileSync } = require('child_process');
-const { resolveRepoContext } = require('../core/repo-context');
-const { createBridge } = require('../core/bridge');
-
-function arg(name, fallback = '') {
-  const prefix = `--${name}`;
-  const argv = process.argv.slice(2);
-  const index = argv.indexOf(prefix);
-  if (index === -1) return fallback;
-  const value = argv[index + 1];
-  return value === undefined || value.startsWith('--') ? fallback : value;
-}
-
-function git(cwd, args) {
-  return String(execFileSync('git', args, { cwd, windowsHide: true, encoding: 'utf8' })).trim();
-}
-
-async function main() {
-  const cwd = arg('cwd', process.cwd());
-  const repo = await resolveRepoContext(cwd);
-  if (!repo || !repo.repoIdentity) {
-    throw new Error(`not a Git work tree (no repo identity): ${cwd}`);
-  }
-  const commitSha = arg('sha') || git(cwd, ['rev-parse', 'HEAD']);
-  const branch = arg('branch') || git(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']);
-  const committedAt = arg('committed-at') || git(cwd, ['log', '-1', '--format=%cI']);
-  const subject = arg('subject') || git(cwd, ['log', '-1', '--format=%s']);
-  const homeDir = arg('home') || undefined;
-  const bridge = createBridge(homeDir ? { homeDir } : {});
-  const result = await bridge.appendCommitBoundary({
-    repoIdentity: repo.repoIdentity,
-    commitSha,
-    branch,
-    subject,
-    committedAt: committedAt || undefined
-  });
-  process.stdout.write(`${JSON.stringify({ ok: true, projectPath: repo.projectPath, ...result })}\n`);
-}
-
-module.exports = { main };
-
-if (require.main === module) {
-  main().catch((err) => {
-    process.stderr.write(`${JSON.stringify({ ok: false, error: err && err.message ? err.message : String(err) })}\n`);
-    process.exitCode = 1;
-  });
-}
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Bridge commit-boundary injection point. Any git hook (or a human, or a
+ * test) can signal "this repo just committed" by running:
+ *
+ *   node commit-boundary.js --cwd <repo> [--home <bridge home>]
+ *                           [--sha <sha>] [--branch <name>] [--committed-at <iso>]
+ *
+ * The repo identity is resolved from the working tree (that is how the bridge
+ * knows which registered project — and therefore which store — the commit
+ * belongs to). Facts not provided are read from the repo's git. Output is a
+ * single JSON line on stdout; errors exit non-zero so callers can distinguish
+ * a failed injection from a skip.
+ */
+
+const { execFileSync } = require('child_process');
+const { resolveRepoContext } = require('../core/repo-context');
+const { createBridge } = require('../core/bridge');
+
+function arg(name, fallback = '') {
+  const prefix = `--${name}`;
+  const argv = process.argv.slice(2);
+  const index = argv.indexOf(prefix);
+  if (index === -1) return fallback;
+  const value = argv[index + 1];
+  return value === undefined || value.startsWith('--') ? fallback : value;
+}
+
+function git(cwd, args) {
+  return String(execFileSync('git', args, { cwd, windowsHide: true, encoding: 'utf8' })).trim();
+}
+
+async function main() {
+  const cwd = arg('cwd', process.cwd());
+  const repo = await resolveRepoContext(cwd);
+  if (!repo || !repo.repoIdentity) {
+    throw new Error(`not a Git work tree (no repo identity): ${cwd}`);
+  }
+  const commitSha = arg('sha') || git(cwd, ['rev-parse', 'HEAD']);
+  const branch = arg('branch') || git(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']);
+  const committedAt = arg('committed-at') || git(cwd, ['log', '-1', '--format=%cI']);
+  const subject = arg('subject') || git(cwd, ['log', '-1', '--format=%s']);
+  const homeDir = arg('home') || undefined;
+  const bridge = createBridge(homeDir ? { homeDir } : {});
+  const result = await bridge.appendCommitBoundary({
+    repoIdentity: repo.repoIdentity,
+    commitSha,
+    branch,
+    subject,
+    committedAt: committedAt || undefined
+  });
+  process.stdout.write(`${JSON.stringify({ ok: true, projectPath: repo.projectPath, ...result })}\n`);
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main().catch((err) => {
+    process.stderr.write(`${JSON.stringify({ ok: false, error: err && err.message ? err.message : String(err) })}\n`);
+    process.exitCode = 1;
+  });
+}

package/src/bridge/connectors/capture-guard.js

@@ -1,24 +1,24 @@
-'use strict';
-
-/**
- * Capture-disable guard. Project-Knowledge (or any host) marks its internal
- * AI SDK sessions with AI_CODING_EVENT_BRIDGE_CAPTURE=0 and
- * AI_CODING_EVENT_ORIGIN. Every connector checks this FIRST — before
- * normalization, repo Git resolution, or any journal write — so internal
- * Workbench/Analyzer conversations never reach the durable journal.
- */
-function isCaptureDisabled(env = process.env, payload = null) {
-  if (env && env.AI_CODING_EVENT_BRIDGE_CAPTURE === '0') {
-    return true;
-  }
-  if (payload && typeof payload === 'object' && payload.meta && typeof payload.meta === 'object') {
-    return String(payload.meta.bridgeCapture) === '0';
-  }
-  return false;
-}
-
-function captureDisabledResult() {
-  return { status: 'ignored', reason: 'capture-disabled' };
-}
-
-module.exports = { isCaptureDisabled, captureDisabledResult };
+'use strict';
+
+/**
+ * Capture-disable guard. Project-Knowledge (or any host) marks its internal
+ * AI SDK sessions with AI_CODING_EVENT_BRIDGE_CAPTURE=0 and
+ * AI_CODING_EVENT_ORIGIN. Every connector checks this FIRST — before
+ * normalization, repo Git resolution, or any journal write — so internal
+ * Workbench/Analyzer conversations never reach the durable journal.
+ */
+function isCaptureDisabled(env = process.env, payload = null) {
+  if (env && env.AI_CODING_EVENT_BRIDGE_CAPTURE === '0') {
+    return true;
+  }
+  if (payload && typeof payload === 'object' && payload.meta && typeof payload.meta === 'object') {
+    return String(payload.meta.bridgeCapture) === '0';
+  }
+  return false;
+}
+
+function captureDisabledResult() {
+  return { status: 'ignored', reason: 'capture-disabled' };
+}
+
+module.exports = { isCaptureDisabled, captureDisabledResult };

package/src/bridge/connectors/claude-code/hook-entry.js

@@ -1,45 +1,45 @@
-'use strict';
-
-const { normalizeClaudeCode } = require('../../core/normalizer');
-const { resolveRepoContext } = require('../../core/repo-context');
-const { journalFor } = require('../../core/journal-router');
-const { isCaptureDisabled, captureDisabledResult } = require('../capture-guard');
-const { notifyConsumers } = require('./notify');
-
-/**
- * Durable-first Claude Code hook processing. The event is appended and fsynced
- * to the Bridge journal before any consumer notification is attempted, and the
- * whole entry fails open: a broken Bridge must never block the AI client.
- * Internal host SDK sessions (AI_CODING_EVENT_BRIDGE_CAPTURE=0) are ignored
- * before any Git/journal work happens.
- */
-async function main({ home, payload, source }) {
-  if (isCaptureDisabled(process.env, payload)) {
-    return captureDisabledResult();
-  }
-  if (!payload || typeof payload !== 'object') {
-    return { status: 'ignored' };
-  }
-  const event = normalizeClaudeCode(payload, source);
-  if (!event) {
-    return { status: 'ignored' };
-  }
-  const cwd = typeof payload.cwd === 'string' && payload.cwd ? payload.cwd : process.cwd();
-  const repo = await resolveRepoContext(cwd);
-  const journal = journalFor(home, event.repoIdentity || repo.repoIdentity);
-  const appended = await journal.appendConversationEvent({
-    ...event,
-    repoIdentity: event.repoIdentity || repo.repoIdentity,
-    projectPath: event.projectPath || repo.projectPath,
-    branch: event.branch || repo.branch,
-    headAtCapture: event.headAtCapture || repo.headAtCapture
-  });
-  await notifyConsumers(home, { sequence: appended.sequence, eventId: appended.eventId });
-  return { status: 'captured', sequence: appended.sequence, turnId: appended.turnId };
-}
-
-function mainFailOpen({ home, payload, source }) {
-  return main({ home, payload, source }).catch(() => ({ status: 'fail-open' }));
-}
-
-module.exports = { main, mainFailOpen };
+'use strict';
+
+const { normalizeClaudeCode } = require('../../core/normalizer');
+const { resolveRepoContext } = require('../../core/repo-context');
+const { journalFor } = require('../../core/journal-router');
+const { isCaptureDisabled, captureDisabledResult } = require('../capture-guard');
+const { notifyConsumers } = require('./notify');
+
+/**
+ * Durable-first Claude Code hook processing. The event is appended and fsynced
+ * to the Bridge journal before any consumer notification is attempted, and the
+ * whole entry fails open: a broken Bridge must never block the AI client.
+ * Internal host SDK sessions (AI_CODING_EVENT_BRIDGE_CAPTURE=0) are ignored
+ * before any Git/journal work happens.
+ */
+async function main({ home, payload, source }) {
+  if (isCaptureDisabled(process.env, payload)) {
+    return captureDisabledResult();
+  }
+  if (!payload || typeof payload !== 'object') {
+    return { status: 'ignored' };
+  }
+  const event = normalizeClaudeCode(payload, source);
+  if (!event) {
+    return { status: 'ignored' };
+  }
+  const cwd = typeof payload.cwd === 'string' && payload.cwd ? payload.cwd : process.cwd();
+  const repo = await resolveRepoContext(cwd);
+  const journal = journalFor(home, event.repoIdentity || repo.repoIdentity);
+  const appended = await journal.appendConversationEvent({
+    ...event,
+    repoIdentity: event.repoIdentity || repo.repoIdentity,
+    projectPath: event.projectPath || repo.projectPath,
+    branch: event.branch || repo.branch,
+    headAtCapture: event.headAtCapture || repo.headAtCapture
+  });
+  await notifyConsumers(home, { sequence: appended.sequence, eventId: appended.eventId });
+  return { status: 'captured', sequence: appended.sequence, turnId: appended.turnId };
+}
+
+function mainFailOpen({ home, payload, source }) {
+  return main({ home, payload, source }).catch(() => ({ status: 'fail-open' }));
+}
+
+module.exports = { main, mainFailOpen };