@sanqianx/project-knowledge 5.0.24 → 5.0.25

package/_site/_test/integration-auto-repair-test.js

@@ -1,113 +1,113 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const { markIntent } = require('../lib/integration-intent');
-const { IntegrationAutoRepair } = require('../lib/integration-auto-repair');
-
-const tmpDataDir = () => fs.mkdtempSync(path.join(os.tmpdir(), 'kb-auto-repair-'));
-
-const makeManager = ({ statusClients, onInstall }) => {
-  const calls = { statusAll: 0, installAll: [] };
-  return {
-    calls,
-    async statusAll() {
-      calls.statusAll += 1;
-      return { clients: statusClients.map(client => ({ ...client, developmentCapture: { ...client.developmentCapture } })) };
-    },
-    async installAll(options) {
-      calls.installAll.push(options);
-      return onInstall(options);
-    },
-  };
-};
-
-(async () => {
-  // D + E: runOnce repairs exactly the connected-and-not-installed clients, once.
-  {
-    const dir = tmpDataDir();
-    markIntent(dir, 'claude', 'connected');
-    markIntent(dir, 'codex', 'disconnected');
-    markIntent(dir, 'zcode', 'connected');
-    const manager = makeManager({
-      statusClients: [
-        { client: 'claude', developmentCapture: { installed: false } },
-        { client: 'codex', developmentCapture: { installed: false } },
-        { client: 'zcode', developmentCapture: { installed: true } },
-      ],
-      onInstall: async options => ({ clients: [{ client: options.clients[0], developmentCapture: { ok: true } }] }),
-    });
-    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
-    await repair.runOnce();
-    assert.equal(manager.calls.installAll.length, 1, 'disconnected and already-installed clients are never repaired');
-    assert.deepEqual(manager.calls.installAll[0], { clients: ['claude'] });
-    const repaired = repair.status().claude;
-    assert.equal(repaired.state, 'repaired');
-    assert.equal(repaired.error, null);
-    assert.ok(!Number.isNaN(Date.parse(repaired.at)), 'at must be an ISO timestamp');
-    await repair.runOnce();
-    assert.equal(manager.calls.statusAll, 2, 'second run rescans status');
-    assert.equal(manager.calls.installAll.length, 1, 'a second runOnce must not repair the same client again');
-  }
-  // F + G: failures are recorded without interrupting others; retry repairs.
-  {
-    const dir = tmpDataDir();
-    for (const client of ['claude', 'codex', 'zcode']) markIntent(dir, client, 'connected');
-    let claudeBroken = true;
-    const manager = makeManager({
-      statusClients: [
-        { client: 'claude', developmentCapture: { installed: false } },
-        { client: 'codex', developmentCapture: { installed: false } },
-        { client: 'zcode', developmentCapture: { installed: false } },
-      ],
-      onInstall: async options => {
-        const client = options.clients[0];
-        if (client === 'claude' && claudeBroken) throw new Error('boom');
-        if (client === 'zcode') return { clients: [{ client, developmentCapture: { ok: false, detail: 'hook conflict' } }] };
-        return { clients: [{ client, developmentCapture: { ok: true } }] };
-      },
-    });
-    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
-    await repair.runOnce();
-    assert.equal(manager.calls.installAll.length, 3, 'every connected-and-not-installed client gets one attempt');
-    const status = repair.status();
-    assert.equal(status.claude.state, 'failed');
-    assert.ok(status.claude.error, 'a thrown installAll records the error message');
-    assert.equal(status.codex.state, 'repaired', 'a failing client does not interrupt the others');
-    assert.equal(status.zcode.state, 'failed');
-    assert.ok(status.zcode.error, 'ok=false records a detail as the error');
-    claudeBroken = false;
-    const retried = await repair.retry('claude');
-    assert.equal(retried.state, 'repaired');
-    assert.equal(retried.error, null);
-    assert.equal(manager.calls.installAll.length, 4, 'retry ignores the attempted set');
-    assert.deepEqual(manager.calls.installAll[3], { clients: ['claude'] });
-    assert.equal(repair.status().claude.state, 'repaired', 'a successful retry overwrites the failure');
-    const snapshot = repair.status();
-    snapshot.claude = { state: 'tampered' };
-    assert.equal(repair.status().claude.state, 'repaired', 'status() returns a copy');
-  }
-  {
-    const dir = tmpDataDir();
-    markIntent(dir, 'codex', 'disconnected');
-    const manager = makeManager({ statusClients: [], onInstall: () => { throw new Error('must not repair'); } });
-    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
-    await repair.runOnce();
-    assert.equal(manager.calls.statusAll, 0, 'disconnected clients must not run native startup probes');
-    markIntent(dir, 'codex', 'connected');
-    manager.statusAll = async options => {
-      assert.deepEqual(options.clients, ['codex']);
-      return { clients: [{ client: 'codex', developmentCapture: { state: 'check-failed' } }] };
-    };
-    await repair.runOnce();
-    assert.equal(manager.calls.installAll.length, 0, 'an unknown status must not be treated as an absent integration');
-    manager.statusAll = async () => {
-      markIntent(dir, 'codex', 'disconnected');
-      return { clients: [{ client: 'codex', developmentCapture: { installed: false } }] };
-    };
-    await repair.runOnce();
-    assert.equal(manager.calls.installAll.length, 0, 'a user disconnect during status scanning must cancel the repair');
-  }
-  console.log('integration auto repair test PASS');
-})().catch(error => { console.error(error); process.exitCode = 1; });
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { markIntent } = require('../lib/integration-intent');
+const { IntegrationAutoRepair } = require('../lib/integration-auto-repair');
+
+const tmpDataDir = () => fs.mkdtempSync(path.join(os.tmpdir(), 'kb-auto-repair-'));
+
+const makeManager = ({ statusClients, onInstall }) => {
+  const calls = { statusAll: 0, installAll: [] };
+  return {
+    calls,
+    async statusAll() {
+      calls.statusAll += 1;
+      return { clients: statusClients.map(client => ({ ...client, developmentCapture: { ...client.developmentCapture } })) };
+    },
+    async installAll(options) {
+      calls.installAll.push(options);
+      return onInstall(options);
+    },
+  };
+};
+
+(async () => {
+  // D + E: runOnce repairs exactly the connected-and-not-installed clients, once.
+  {
+    const dir = tmpDataDir();
+    markIntent(dir, 'claude', 'connected');
+    markIntent(dir, 'codex', 'disconnected');
+    markIntent(dir, 'zcode', 'connected');
+    const manager = makeManager({
+      statusClients: [
+        { client: 'claude', developmentCapture: { installed: false } },
+        { client: 'codex', developmentCapture: { installed: false } },
+        { client: 'zcode', developmentCapture: { installed: true } },
+      ],
+      onInstall: async options => ({ clients: [{ client: options.clients[0], developmentCapture: { ok: true } }] }),
+    });
+    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
+    await repair.runOnce();
+    assert.equal(manager.calls.installAll.length, 1, 'disconnected and already-installed clients are never repaired');
+    assert.deepEqual(manager.calls.installAll[0], { clients: ['claude'] });
+    const repaired = repair.status().claude;
+    assert.equal(repaired.state, 'repaired');
+    assert.equal(repaired.error, null);
+    assert.ok(!Number.isNaN(Date.parse(repaired.at)), 'at must be an ISO timestamp');
+    await repair.runOnce();
+    assert.equal(manager.calls.statusAll, 2, 'second run rescans status');
+    assert.equal(manager.calls.installAll.length, 1, 'a second runOnce must not repair the same client again');
+  }
+  // F + G: failures are recorded without interrupting others; retry repairs.
+  {
+    const dir = tmpDataDir();
+    for (const client of ['claude', 'codex', 'zcode']) markIntent(dir, client, 'connected');
+    let claudeBroken = true;
+    const manager = makeManager({
+      statusClients: [
+        { client: 'claude', developmentCapture: { installed: false } },
+        { client: 'codex', developmentCapture: { installed: false } },
+        { client: 'zcode', developmentCapture: { installed: false } },
+      ],
+      onInstall: async options => {
+        const client = options.clients[0];
+        if (client === 'claude' && claudeBroken) throw new Error('boom');
+        if (client === 'zcode') return { clients: [{ client, developmentCapture: { ok: false, detail: 'hook conflict' } }] };
+        return { clients: [{ client, developmentCapture: { ok: true } }] };
+      },
+    });
+    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
+    await repair.runOnce();
+    assert.equal(manager.calls.installAll.length, 3, 'every connected-and-not-installed client gets one attempt');
+    const status = repair.status();
+    assert.equal(status.claude.state, 'failed');
+    assert.ok(status.claude.error, 'a thrown installAll records the error message');
+    assert.equal(status.codex.state, 'repaired', 'a failing client does not interrupt the others');
+    assert.equal(status.zcode.state, 'failed');
+    assert.ok(status.zcode.error, 'ok=false records a detail as the error');
+    claudeBroken = false;
+    const retried = await repair.retry('claude');
+    assert.equal(retried.state, 'repaired');
+    assert.equal(retried.error, null);
+    assert.equal(manager.calls.installAll.length, 4, 'retry ignores the attempted set');
+    assert.deepEqual(manager.calls.installAll[3], { clients: ['claude'] });
+    assert.equal(repair.status().claude.state, 'repaired', 'a successful retry overwrites the failure');
+    const snapshot = repair.status();
+    snapshot.claude = { state: 'tampered' };
+    assert.equal(repair.status().claude.state, 'repaired', 'status() returns a copy');
+  }
+  {
+    const dir = tmpDataDir();
+    markIntent(dir, 'codex', 'disconnected');
+    const manager = makeManager({ statusClients: [], onInstall: () => { throw new Error('must not repair'); } });
+    const repair = new IntegrationAutoRepair({ dataDir: dir, createManager: () => manager });
+    await repair.runOnce();
+    assert.equal(manager.calls.statusAll, 0, 'disconnected clients must not run native startup probes');
+    markIntent(dir, 'codex', 'connected');
+    manager.statusAll = async options => {
+      assert.deepEqual(options.clients, ['codex']);
+      return { clients: [{ client: 'codex', developmentCapture: { state: 'check-failed' } }] };
+    };
+    await repair.runOnce();
+    assert.equal(manager.calls.installAll.length, 0, 'an unknown status must not be treated as an absent integration');
+    manager.statusAll = async () => {
+      markIntent(dir, 'codex', 'disconnected');
+      return { clients: [{ client: 'codex', developmentCapture: { installed: false } }] };
+    };
+    await repair.runOnce();
+    assert.equal(manager.calls.installAll.length, 0, 'a user disconnect during status scanning must cancel the repair');
+  }
+  console.log('integration auto repair test PASS');
+})().catch(error => { console.error(error); process.exitCode = 1; });

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();