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

package/_site/_test/integration-adapters-test.js

@@ -139,85 +139,85 @@ async function main() {
   });
   const codexResult = await codexManager.operate('update', ['codex']);
   assert(codexResult[0].ok, 'Codex update should complete');
-  assert(codexCalls.some(call => call.args.join(' ') === 'plugin marketplace upgrade project-knowledge'), 'Codex should refresh its marketplace');
-  assert(codexCalls.some(call => call.args.join(' ') === 'plugin remove project-knowledge@project-knowledge'), 'Codex should remove the cached plugin during update');
-  assert(codexCalls.some(call => call.args.join(' ') === 'plugin add project-knowledge@project-knowledge'), 'Codex should install the refreshed plugin');
-
-  const chainedCodexConfig = path.join(TEMP, 'codex-config.toml');
-  const oldNotifier = Buffer.from(JSON.stringify(['node', 'C:/existing-notify.js'])).toString('base64');
-  fs.writeFileSync(chainedCodexConfig, `notify = ["node", "C:/tools/devtask-radar/connectors/codex/notify-hook.js", "--previous-notify", "${oldNotifier}"]\n`, 'utf8');
-  const chainedManager = new IntegrationManager({
-    rootDir: ROOT,
-    homeDir: path.join(TEMP, 'codex-home'),
-    bridgeHomeDir: path.join(TEMP, 'bridge-home'),
-    codexConfigFile: chainedCodexConfig,
-  });
-  const chained = await chainedManager.installCaptureCodex();
-  assert(chained.installed && !chained.conflict, 'a compatible DevTask Radar notifier should chain Bridge instead of blocking capture');
-  const chainedConfig = JSON.parse(fs.readFileSync(chainedCodexConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
-  const nextIndex = chainedConfig.indexOf('--next-base64');
+  assert(codexCalls.some(call => call.args.join(' ') === 'plugin marketplace upgrade project-knowledge'), 'Codex should refresh its marketplace');
+  assert(codexCalls.some(call => call.args.join(' ') === 'plugin remove project-knowledge@project-knowledge'), 'Codex should remove the cached plugin during update');
+  assert(codexCalls.some(call => call.args.join(' ') === 'plugin add project-knowledge@project-knowledge'), 'Codex should install the refreshed plugin');
+
+  const chainedCodexConfig = path.join(TEMP, 'codex-config.toml');
+  const oldNotifier = Buffer.from(JSON.stringify(['node', 'C:/existing-notify.js'])).toString('base64');
+  fs.writeFileSync(chainedCodexConfig, `notify = ["node", "C:/tools/devtask-radar/connectors/codex/notify-hook.js", "--previous-notify", "${oldNotifier}"]\n`, 'utf8');
+  const chainedManager = new IntegrationManager({
+    rootDir: ROOT,
+    homeDir: path.join(TEMP, 'codex-home'),
+    bridgeHomeDir: path.join(TEMP, 'bridge-home'),
+    codexConfigFile: chainedCodexConfig,
+  });
+  const chained = await chainedManager.installCaptureCodex();
+  assert(chained.installed && !chained.conflict, 'a compatible DevTask Radar notifier should chain Bridge instead of blocking capture');
+  const chainedConfig = JSON.parse(fs.readFileSync(chainedCodexConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
+  const nextIndex = chainedConfig.indexOf('--next-base64');
   assert(nextIndex >= 0, 'managed fan-out must preserve the compatible notifier as its independent branch');
-  const nextNotify = JSON.parse(Buffer.from(chainedConfig[nextIndex + 1], 'base64').toString('utf8'));
+  const nextNotify = JSON.parse(Buffer.from(chainedConfig[nextIndex + 1], 'base64').toString('utf8'));
   assert(nextNotify[1] === 'C:/tools/devtask-radar/connectors/codex/notify-hook.js', 'Radar remains the existing independent notifier');
   const bridgeIndex = chainedConfig.indexOf('--bridge-base64');
   const bridgeNotify = JSON.parse(Buffer.from(chainedConfig[bridgeIndex + 1], 'base64').toString('utf8'));
   assert(bridgeNotify[1] === path.join(TEMP, 'bridge-home', 'bin', 'bridge-hook.cjs'), 'capture must receive the payload through the current Bridge shim');
-  const chainedStatus = await chainedManager.statusCaptureCodex();
-  assert(chainedStatus.installed && !chainedStatus.conflict, 'status should recognize the compatible chained notifier');
-
-  const nestedCodexConfig = path.join(TEMP, 'nested-codex-config.toml');
-  const nestedDevTask = ['node', 'C:/tools/devtask-radar/connectors/codex/notify-hook.js', '--next-base64', oldNotifier];
+  const chainedStatus = await chainedManager.statusCaptureCodex();
+  assert(chainedStatus.installed && !chainedStatus.conflict, 'status should recognize the compatible chained notifier');
+
+  const nestedCodexConfig = path.join(TEMP, 'nested-codex-config.toml');
+  const nestedDevTask = ['node', 'C:/tools/devtask-radar/connectors/codex/notify-hook.js', '--next-base64', oldNotifier];
   const desktopExecutable = path.join(TEMP, 'OpenAI', 'Codex', 'runtimes', 'cua_node', 'test-runtime', 'bin', 'node_modules', '@oai', 'sky', 'bin', 'windows', 'codex-computer-use.exe');
   fs.mkdirSync(path.dirname(desktopExecutable), { recursive: true });
   fs.writeFileSync(desktopExecutable, '');
   fs.writeFileSync(nestedCodexConfig, `notify = ${JSON.stringify([desktopExecutable, 'turn-ended', '--previous-notify', JSON.stringify(nestedDevTask)])}\n`, 'utf8');
-  const nestedManager = new IntegrationManager({
-    rootDir: ROOT,
-    homeDir: path.join(TEMP, 'nested-codex-home'),
-    bridgeHomeDir: path.join(TEMP, 'nested-bridge-home'),
-    codexConfigFile: nestedCodexConfig,
-  });
-  const nested = await nestedManager.installCaptureCodex();
-  assert(nested.installed && !nested.conflict, 'a nested DevTask Radar notifier should be preserved through the fan-out wrapper');
-  const nestedConfig = JSON.parse(fs.readFileSync(nestedCodexConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
+  const nestedManager = new IntegrationManager({
+    rootDir: ROOT,
+    homeDir: path.join(TEMP, 'nested-codex-home'),
+    bridgeHomeDir: path.join(TEMP, 'nested-bridge-home'),
+    codexConfigFile: nestedCodexConfig,
+  });
+  const nested = await nestedManager.installCaptureCodex();
+  assert(nested.installed && !nested.conflict, 'a nested DevTask Radar notifier should be preserved through the fan-out wrapper');
+  const nestedConfig = JSON.parse(fs.readFileSync(nestedCodexConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
   assert(nestedConfig[0] === desktopExecutable, 'the active Codex desktop wrapper keeps its position');
   assert(nestedConfig.join(' ').includes('codex-notify-fanout.cjs'), 'nested notifier chain should use the Project Knowledge fan-out wrapper');
-  const nestedStatus = await nestedManager.statusCaptureCodex();
-  assert(nestedStatus.installed && !nestedStatus.conflict, 'status should recognize the managed nested fan-out wrapper');
-
-  // Codex Desktop computer-use wraps the existing notifier as a JSON array in
-  // --previous-notify. The managed fan-out is still installed and must not be
-  // misreported as a third-party conflict or wrapped a second time.
-  const desktopWrappedConfig = path.join(TEMP, 'desktop-wrapped-codex-config.toml');
+  const nestedStatus = await nestedManager.statusCaptureCodex();
+  assert(nestedStatus.installed && !nestedStatus.conflict, 'status should recognize the managed nested fan-out wrapper');
+
+  // Codex Desktop computer-use wraps the existing notifier as a JSON array in
+  // --previous-notify. The managed fan-out is still installed and must not be
+  // misreported as a third-party conflict or wrapped a second time.
+  const desktopWrappedConfig = path.join(TEMP, 'desktop-wrapped-codex-config.toml');
   const desktopWrappedArgs = [desktopExecutable, 'turn-ended', '--previous-notify', JSON.stringify(nestedConfig)];
-  fs.writeFileSync(desktopWrappedConfig, `notify = ${JSON.stringify(desktopWrappedArgs)}\n`, 'utf8');
-  const desktopWrappedManager = new IntegrationManager({
-    rootDir: ROOT,
-    homeDir: path.join(TEMP, 'desktop-wrapped-codex-home'),
-    bridgeHomeDir: path.join(TEMP, 'nested-bridge-home'),
-    codexConfigFile: desktopWrappedConfig,
-  });
-  const desktopWrappedStatus = await desktopWrappedManager.statusCaptureCodex();
-  assert(desktopWrappedStatus.installed && !desktopWrappedStatus.conflict,
-    'Codex Desktop outer wrapper should preserve managed capture health');
-  const beforeDesktopInstall = fs.readFileSync(desktopWrappedConfig, 'utf8');
-  const desktopWrappedInstall = await desktopWrappedManager.installCaptureCodex();
-  assert(desktopWrappedInstall.installed && !desktopWrappedInstall.conflict,
-    'one-click repair should recognize the nested managed fan-out');
-  assert(fs.readFileSync(desktopWrappedConfig, 'utf8') === beforeDesktopInstall,
-    'healthy Codex Desktop wrapper must remain byte-for-byte unchanged');
-
-  const bridgeOnlyConfig = path.join(TEMP, 'bridge-only-codex-config.toml');
-  const bridgeOnlyManager = new IntegrationManager({
-    rootDir: ROOT,
-    homeDir: path.join(TEMP, 'bridge-only-codex-home'),
-    bridgeHomeDir: path.join(TEMP, 'bridge-only-bridge-home'),
-    codexConfigFile: bridgeOnlyConfig,
-  });
-  const bridgeOnly = await bridgeOnlyManager.installCaptureCodex();
-  assert(bridgeOnly.installed && !bridgeOnly.conflict, 'a fresh Codex install should use the payload-preserving fan-out wrapper');
-  const bridgeOnlyArgs = JSON.parse(fs.readFileSync(bridgeOnlyConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
-  assert(bridgeOnlyArgs.join(' ').includes('codex-notify-fanout.cjs'), 'fresh Codex install should use the Project Knowledge fan-out wrapper');
+  fs.writeFileSync(desktopWrappedConfig, `notify = ${JSON.stringify(desktopWrappedArgs)}\n`, 'utf8');
+  const desktopWrappedManager = new IntegrationManager({
+    rootDir: ROOT,
+    homeDir: path.join(TEMP, 'desktop-wrapped-codex-home'),
+    bridgeHomeDir: path.join(TEMP, 'nested-bridge-home'),
+    codexConfigFile: desktopWrappedConfig,
+  });
+  const desktopWrappedStatus = await desktopWrappedManager.statusCaptureCodex();
+  assert(desktopWrappedStatus.installed && !desktopWrappedStatus.conflict,
+    'Codex Desktop outer wrapper should preserve managed capture health');
+  const beforeDesktopInstall = fs.readFileSync(desktopWrappedConfig, 'utf8');
+  const desktopWrappedInstall = await desktopWrappedManager.installCaptureCodex();
+  assert(desktopWrappedInstall.installed && !desktopWrappedInstall.conflict,
+    'one-click repair should recognize the nested managed fan-out');
+  assert(fs.readFileSync(desktopWrappedConfig, 'utf8') === beforeDesktopInstall,
+    'healthy Codex Desktop wrapper must remain byte-for-byte unchanged');
+
+  const bridgeOnlyConfig = path.join(TEMP, 'bridge-only-codex-config.toml');
+  const bridgeOnlyManager = new IntegrationManager({
+    rootDir: ROOT,
+    homeDir: path.join(TEMP, 'bridge-only-codex-home'),
+    bridgeHomeDir: path.join(TEMP, 'bridge-only-bridge-home'),
+    codexConfigFile: bridgeOnlyConfig,
+  });
+  const bridgeOnly = await bridgeOnlyManager.installCaptureCodex();
+  assert(bridgeOnly.installed && !bridgeOnly.conflict, 'a fresh Codex install should use the payload-preserving fan-out wrapper');
+  const bridgeOnlyArgs = JSON.parse(fs.readFileSync(bridgeOnlyConfig, 'utf8').replace(/^\s*notify\s*=\s*/, '').trim());
+  assert(bridgeOnlyArgs.join(' ').includes('codex-notify-fanout.cjs'), 'fresh Codex install should use the Project Knowledge fan-out wrapper');
 
   const integrationLogs = [];
   const failingManager = new IntegrationManager({

package/_site/_test/integration-capture-setup-test.js

@@ -1,118 +1,118 @@
-// Run: node _site/_test/integration-capture-setup-test.js
-//
-// T18 gates (INSTALL-001/002/003): one Project-Knowledge setup installs
-// Knowledge Integration + Development Capture without opening any client UI;
-// per-client status reports the two capabilities separately; third-party
-// config is preserved; Codex notify conflicts are reported, not overwritten;
-// connector uninstall keeps the host Bridge consumer until a global disable.
-
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { IntegrationManager } = require('../lib/integration-installer');
-const { createBridge } = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), `pk-integration-capture-${process.pid}-`));
-const homeDir = path.join(TEMP, 'home');
-const bridgeHome = path.join(TEMP, 'bridge-home');
-const claudeSettings = path.join(TEMP, 'claude-settings.json');
-const codexConfig = path.join(TEMP, 'codex-config.toml');
-const openCodePlugins = path.join(TEMP, 'opencode-plugins');
-
-function makeManager() {
-  return new IntegrationManager({
-    rootDir: ROOT,
-    homeDir,
-    env: {},
-    commandResolver: name => name,
-    runner: (command, args) => {
-      const version = require('../../package.json').version;
-      const cache = path.join(homeDir, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
-      if (command === 'claude' && args.slice(0, 2).join(' ') === 'plugin install') { fs.mkdirSync(cache, { recursive: true }); fs.cpSync(path.join(ROOT, 'plugins/project-knowledge'), cache, { recursive: true }); }
-      if (command === 'claude' && args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify(fs.existsSync(cache) ? [{ id: 'project-knowledge@project-knowledge', version, enabled: true }] : []), stderr: '' };
-      const codexCache = path.join(homeDir, 'codex-plugin-cache');
-      if (command === 'codex' && args.slice(0, 2).join(' ') === 'plugin add') { fs.mkdirSync(codexCache, { recursive: true }); fs.cpSync(path.join(ROOT, 'plugins/project-knowledge'), codexCache, { recursive: true }); }
-      if (command === 'codex' && args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify({ installed: fs.existsSync(codexCache) ? [{ pluginId: 'project-knowledge@project-knowledge', version, enabled: true, source: { path: codexCache } }] : [] }), stderr: '' };
-      return { status: 0, stdout: '', stderr: '' };
-    },
-    bridgeHomeDir: bridgeHome,
-    codexHookProbe: async () => ({ data: [] }),
-    claudeSettingsFile: claudeSettings,
-    codexConfigFile: codexConfig,
-    openCodePluginsDir: openCodePlugins,
-  });
-}
-
-async function main() {
-  const manager = makeManager();
-
-  // Third-party entries pre-exist; they must survive every operation.
-  fs.mkdirSync(path.dirname(claudeSettings), { recursive: true });
-  fs.writeFileSync(claudeSettings, JSON.stringify({
-    model: 'sonnet',
-    hooks: { Stop: [{ matcher: '*', hooks: [{ type: 'command', command: 'node /somewhere/notify-user.js' }] }] },
-  }));
-  fs.mkdirSync(path.dirname(codexConfig), { recursive: true });
-  fs.writeFileSync(codexConfig, 'model = "gpt-5"\nnotify = ["python", "C:/tools/my-notify.py"]\n');
-  fs.mkdirSync(openCodePlugins, { recursive: true });
-  fs.writeFileSync(path.join(openCodePlugins, 'my-own-plugin.js'), '// third party\n');
-
-  // GATE INSTALL-001: one setup action, both capabilities, no client UI.
-  const installed = await manager.installAll({ clients: ['claude', 'codex', 'opencode'] });
-  assert.strictEqual(installed.bridge.ok, true, 'host Bridge consumer registered once');
-  assert.strictEqual(installed.bridge.consumerName, 'project-knowledge');
-  for (const entry of installed.clients) {
-    assert.strictEqual(entry.knowledgeIntegration.ok, true, `${entry.client} knowledge integration installs`);
-    const expectedCapture = entry.client === 'codex' ? 'conflict' : 'installed';
-    assert.strictEqual(entry.developmentCapture.state, expectedCapture, `${entry.client} development capture state`);
-  }
-
-  // Claude managed hooks written programmatically into the user config.
-  const settings = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
-  const managedClaude = settings.hooks.UserPromptSubmit.some(group => group.hooks.some(hook => String(hook.command).includes('bridge-hook.cjs')));
-  assert.strictEqual(managedClaude, true, 'managed Bridge hooks written to Claude user config without any interactive Claude step');
-  assert.strictEqual(settings.hooks.Stop.some(group => group.hooks.some(hook => hook.command === 'node /somewhere/notify-user.js')), true, 'Claude third-party hook preserved');
-
-  // GATE INSTALL-002: Codex third-party notify conflict reported, not overwritten.
-  const codexEntry = installed.clients.find(entry => entry.client === 'codex');
-  assert.strictEqual(codexEntry.developmentCapture.state, 'conflict', 'Codex reports the third-party notify conflict');
-  assert.strictEqual(codexEntry.knowledgeIntegration.ok, true, 'Knowledge Integration stays independent of the Codex capture conflict');
-  assert(fs.readFileSync(codexConfig, 'utf8').includes('my-notify.py'), 'third-party notifier never overwritten');
-
-  // OpenCode managed plugin installed alongside third-party files.
-  assert(fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed OpenCode plugin written');
-  assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin preserved');
-
-  // Status reports the two capabilities separately.
-  const status = await manager.statusAll({ clients: ['claude', 'codex', 'opencode'] });
-  assert.strictEqual(status.bridge.consumerRegistered, true);
-  assert.strictEqual(status.bridge.bridgeHealthy, true);
-  const claudeStatus = status.clients.find(entry => entry.client === 'claude');
-  assert.strictEqual(claudeStatus.developmentCapture.installed, true);
-  const codexStatus = status.clients.find(entry => entry.client === 'codex');
-  assert.strictEqual(codexStatus.developmentCapture.conflict, true, 'conflict surfaces in status');
-  assert.ok(Number.isInteger(status.bridge.health.lastSequence), 'bridge health fields available for the UI');
-
-  // GATE INSTALL-003: removing one connector keeps the host consumer.
-  await manager.uninstallCaptureClaude({});
-  const facade = createBridge({ homeDir: bridgeHome });
-  assert.strictEqual(Boolean(await facade.getConsumer('project-knowledge')), true, 'consumer survives a single connector uninstall');
-  const settingsAfterClaude = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
-  assert.strictEqual(settingsAfterClaude.hooks.UserPromptSubmit, undefined, 'managed Claude hook removed');
-  assert.strictEqual(settingsAfterClaude.hooks.Stop[0].hooks[0].command, 'node /somewhere/notify-user.js', 'third-party hook still intact');
-
-  // Another registered consumer stays untouched by a global disable.
-  await facade.registerConsumer('devtask-radar');
-  const disabled = await manager.disableAllCapture({ clients: ['claude', 'codex', 'opencode'] });
-  assert.strictEqual(disabled.consumer.ok, true, 'global disable unregisters the project-knowledge consumer');
-  const consumers = await facade.listConsumers();
-  assert.deepStrictEqual(consumers.map(consumer => consumer.name), ['devtask-radar'], 'other consumers remain');
-  assert(!fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed plugin removed');
-  assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin survives global disable');
-
-  console.log('integration-capture-setup-test PASS');
-}
-
-module.exports = main();
+// Run: node _site/_test/integration-capture-setup-test.js
+//
+// T18 gates (INSTALL-001/002/003): one Project-Knowledge setup installs
+// Knowledge Integration + Development Capture without opening any client UI;
+// per-client status reports the two capabilities separately; third-party
+// config is preserved; Codex notify conflicts are reported, not overwritten;
+// connector uninstall keeps the host Bridge consumer until a global disable.
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { IntegrationManager } = require('../lib/integration-installer');
+const { createBridge } = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), `pk-integration-capture-${process.pid}-`));
+const homeDir = path.join(TEMP, 'home');
+const bridgeHome = path.join(TEMP, 'bridge-home');
+const claudeSettings = path.join(TEMP, 'claude-settings.json');
+const codexConfig = path.join(TEMP, 'codex-config.toml');
+const openCodePlugins = path.join(TEMP, 'opencode-plugins');
+
+function makeManager() {
+  return new IntegrationManager({
+    rootDir: ROOT,
+    homeDir,
+    env: {},
+    commandResolver: name => name,
+    runner: (command, args) => {
+      const version = require('../../package.json').version;
+      const cache = path.join(homeDir, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
+      if (command === 'claude' && args.slice(0, 2).join(' ') === 'plugin install') { fs.mkdirSync(cache, { recursive: true }); fs.cpSync(path.join(ROOT, 'plugins/project-knowledge'), cache, { recursive: true }); }
+      if (command === 'claude' && args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify(fs.existsSync(cache) ? [{ id: 'project-knowledge@project-knowledge', version, enabled: true }] : []), stderr: '' };
+      const codexCache = path.join(homeDir, 'codex-plugin-cache');
+      if (command === 'codex' && args.slice(0, 2).join(' ') === 'plugin add') { fs.mkdirSync(codexCache, { recursive: true }); fs.cpSync(path.join(ROOT, 'plugins/project-knowledge'), codexCache, { recursive: true }); }
+      if (command === 'codex' && args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify({ installed: fs.existsSync(codexCache) ? [{ pluginId: 'project-knowledge@project-knowledge', version, enabled: true, source: { path: codexCache } }] : [] }), stderr: '' };
+      return { status: 0, stdout: '', stderr: '' };
+    },
+    bridgeHomeDir: bridgeHome,
+    codexHookProbe: async () => ({ data: [] }),
+    claudeSettingsFile: claudeSettings,
+    codexConfigFile: codexConfig,
+    openCodePluginsDir: openCodePlugins,
+  });
+}
+
+async function main() {
+  const manager = makeManager();
+
+  // Third-party entries pre-exist; they must survive every operation.
+  fs.mkdirSync(path.dirname(claudeSettings), { recursive: true });
+  fs.writeFileSync(claudeSettings, JSON.stringify({
+    model: 'sonnet',
+    hooks: { Stop: [{ matcher: '*', hooks: [{ type: 'command', command: 'node /somewhere/notify-user.js' }] }] },
+  }));
+  fs.mkdirSync(path.dirname(codexConfig), { recursive: true });
+  fs.writeFileSync(codexConfig, 'model = "gpt-5"\nnotify = ["python", "C:/tools/my-notify.py"]\n');
+  fs.mkdirSync(openCodePlugins, { recursive: true });
+  fs.writeFileSync(path.join(openCodePlugins, 'my-own-plugin.js'), '// third party\n');
+
+  // GATE INSTALL-001: one setup action, both capabilities, no client UI.
+  const installed = await manager.installAll({ clients: ['claude', 'codex', 'opencode'] });
+  assert.strictEqual(installed.bridge.ok, true, 'host Bridge consumer registered once');
+  assert.strictEqual(installed.bridge.consumerName, 'project-knowledge');
+  for (const entry of installed.clients) {
+    assert.strictEqual(entry.knowledgeIntegration.ok, true, `${entry.client} knowledge integration installs`);
+    const expectedCapture = entry.client === 'codex' ? 'conflict' : 'installed';
+    assert.strictEqual(entry.developmentCapture.state, expectedCapture, `${entry.client} development capture state`);
+  }
+
+  // Claude managed hooks written programmatically into the user config.
+  const settings = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
+  const managedClaude = settings.hooks.UserPromptSubmit.some(group => group.hooks.some(hook => String(hook.command).includes('bridge-hook.cjs')));
+  assert.strictEqual(managedClaude, true, 'managed Bridge hooks written to Claude user config without any interactive Claude step');
+  assert.strictEqual(settings.hooks.Stop.some(group => group.hooks.some(hook => hook.command === 'node /somewhere/notify-user.js')), true, 'Claude third-party hook preserved');
+
+  // GATE INSTALL-002: Codex third-party notify conflict reported, not overwritten.
+  const codexEntry = installed.clients.find(entry => entry.client === 'codex');
+  assert.strictEqual(codexEntry.developmentCapture.state, 'conflict', 'Codex reports the third-party notify conflict');
+  assert.strictEqual(codexEntry.knowledgeIntegration.ok, true, 'Knowledge Integration stays independent of the Codex capture conflict');
+  assert(fs.readFileSync(codexConfig, 'utf8').includes('my-notify.py'), 'third-party notifier never overwritten');
+
+  // OpenCode managed plugin installed alongside third-party files.
+  assert(fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed OpenCode plugin written');
+  assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin preserved');
+
+  // Status reports the two capabilities separately.
+  const status = await manager.statusAll({ clients: ['claude', 'codex', 'opencode'] });
+  assert.strictEqual(status.bridge.consumerRegistered, true);
+  assert.strictEqual(status.bridge.bridgeHealthy, true);
+  const claudeStatus = status.clients.find(entry => entry.client === 'claude');
+  assert.strictEqual(claudeStatus.developmentCapture.installed, true);
+  const codexStatus = status.clients.find(entry => entry.client === 'codex');
+  assert.strictEqual(codexStatus.developmentCapture.conflict, true, 'conflict surfaces in status');
+  assert.ok(Number.isInteger(status.bridge.health.lastSequence), 'bridge health fields available for the UI');
+
+  // GATE INSTALL-003: removing one connector keeps the host consumer.
+  await manager.uninstallCaptureClaude({});
+  const facade = createBridge({ homeDir: bridgeHome });
+  assert.strictEqual(Boolean(await facade.getConsumer('project-knowledge')), true, 'consumer survives a single connector uninstall');
+  const settingsAfterClaude = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
+  assert.strictEqual(settingsAfterClaude.hooks.UserPromptSubmit, undefined, 'managed Claude hook removed');
+  assert.strictEqual(settingsAfterClaude.hooks.Stop[0].hooks[0].command, 'node /somewhere/notify-user.js', 'third-party hook still intact');
+
+  // Another registered consumer stays untouched by a global disable.
+  await facade.registerConsumer('devtask-radar');
+  const disabled = await manager.disableAllCapture({ clients: ['claude', 'codex', 'opencode'] });
+  assert.strictEqual(disabled.consumer.ok, true, 'global disable unregisters the project-knowledge consumer');
+  const consumers = await facade.listConsumers();
+  assert.deepStrictEqual(consumers.map(consumer => consumer.name), ['devtask-radar'], 'other consumers remain');
+  assert(!fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed plugin removed');
+  assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin survives global disable');
+
+  console.log('integration-capture-setup-test PASS');
+}
+
+module.exports = main();