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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (209) hide show
  1. package/.agents/plugins/marketplace.json +3 -3
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +14 -0
  4. package/LICENSE +201 -201
  5. package/NOTICE +5 -5
  6. package/README.md +349 -349
  7. package/_modules/knowledge-engine/README.md +4 -0
  8. package/_modules/knowledge-engine/src/analysis-contract.js +4 -3
  9. package/_modules/knowledge-engine/src/analysis-failures.js +39 -0
  10. package/_modules/knowledge-engine/src/analysis-worker.js +6 -2
  11. package/_modules/knowledge-engine/src/coordinator.js +8 -0
  12. package/_modules/knowledge-engine/src/headless-analyzer.js +2 -1
  13. package/_modules/knowledge-engine/src/memories.js +10 -5
  14. package/_modules/knowledge-engine/src/memory-eligibility.js +74 -0
  15. package/_modules/knowledge-engine/src/retrieval-ranking.js +19 -1
  16. package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +1 -0
  17. package/_modules/knowledge-engine/src/runtime/commit-prompt.js +12 -9
  18. package/_modules/knowledge-engine/src/runtime/conversation-store.js +2 -0
  19. package/_modules/knowledge-engine/src/server.js +1 -1
  20. package/_site/_test/agent-capture-mcp-ui-test.js +67 -67
  21. package/_site/_test/ai-profile-test.js +75 -75
  22. package/_site/_test/ai-vendor-presets-test.js +91 -91
  23. package/_site/_test/automatic-context-test.js +70 -70
  24. package/_site/_test/bin-cli-test.js +230 -230
  25. package/_site/_test/bridge-adapter-test.js +95 -95
  26. package/_site/_test/bridge-consumer-service-test.js +310 -310
  27. package/_site/_test/candidate-bin-content-test.js +35 -0
  28. package/_site/_test/candidate-product-assets-test.js +13 -0
  29. package/_site/_test/candidate-release-contract-test.js +14 -14
  30. package/_site/_test/capture-hook-dedup-test.js +158 -158
  31. package/_site/_test/claude-executable-discovery-test.js +28 -28
  32. package/_site/_test/claude-session-lifecycle-sweep-test.js +252 -252
  33. package/_site/_test/cli-instance-management-test.js +62 -62
  34. package/_site/_test/client-capture-restart-e2e-test.js +189 -189
  35. package/_site/_test/codex-conversation-projection-test.js +60 -60
  36. package/_site/_test/codex-marketplace-scoped-path-test.js +186 -186
  37. package/_site/_test/codex-notify-capture-e2e-test.js +101 -101
  38. package/_site/_test/codex-notify-fanout-test.js +134 -134
  39. package/_site/_test/codex-notify-upgrade-test.js +253 -253
  40. package/_site/_test/commit-boundary-freeze-test.js +147 -147
  41. package/_site/_test/commit-conversation-binding-test.js +4 -4
  42. package/_site/_test/configuration-generation-test.js +22 -22
  43. package/_site/_test/context-pack-test.js +200 -200
  44. package/_site/_test/conversation-api-test.js +10 -10
  45. package/_site/_test/conversation-origin-test.js +15 -0
  46. package/_site/_test/cross-repo-isolation-e2e-test.js +187 -187
  47. package/_site/_test/embedding-config-test.js +32 -32
  48. package/_site/_test/fixtures/fake-browser-exit.js +10 -10
  49. package/_site/_test/fixtures/fake-browser-hang.js +10 -10
  50. package/_site/_test/fixtures/integration-busy-worker.cjs +6 -6
  51. package/_site/_test/fixtures/make-git-repos.js +92 -92
  52. package/_site/_test/fixtures/retrieval-gold-queries.json +32 -0
  53. package/_site/_test/fresh-hook-reimport-test.js +53 -53
  54. package/_site/_test/fresh-product-data-test.js +56 -56
  55. package/_site/_test/git-path-compatibility-test.js +80 -80
  56. package/_site/_test/git-validation-test.js +81 -81
  57. package/_site/_test/hook-worktree-test.js +42 -42
  58. package/_site/_test/index-builder-test.js +41 -41
  59. package/_site/_test/index-error-display-contract-test.js +10 -10
  60. package/_site/_test/integration-adapters-test.js +67 -67
  61. package/_site/_test/integration-capture-setup-test.js +118 -118
  62. package/_site/_test/integration-runtime-binding-a2-test.js +566 -566
  63. package/_site/_test/integration-runtime-binding-a3-test.js +227 -227
  64. package/_site/_test/integration-runtime-binding-test.js +473 -473
  65. package/_site/_test/integration-status-scan-test.js +29 -29
  66. package/_site/_test/kb-framework-test.js +57 -57
  67. package/_site/_test/kbpath-follow-test.js +63 -63
  68. package/_site/_test/knowledge-db-test.js +144 -144
  69. package/_site/_test/knowledge-engine-client-test.js +109 -109
  70. package/_site/_test/knowledge-maintenance-test.js +40 -40
  71. package/_site/_test/knowledge-panel-ui-contract-test.js +112 -0
  72. package/_site/_test/knowledge-scopes-test.js +37 -37
  73. package/_site/_test/knowledge-storage-location-test.js +28 -28
  74. package/_site/_test/launcher-readiness-test.js +80 -80
  75. package/_site/_test/legacy-claude-session-alias-test.js +106 -106
  76. package/_site/_test/legacy-routes-removed-test.js +47 -47
  77. package/_site/_test/legacy-workbench-exclusion-test.js +92 -92
  78. package/_site/_test/live-gateway-test.js +48 -48
  79. package/_site/_test/local-marketplace-test.js +16 -16
  80. package/_site/_test/log-redaction-test.js +58 -58
  81. package/_site/_test/markdown-maintenance-test.js +11 -11
  82. package/_site/_test/model-context-windows-test.js +89 -89
  83. package/_site/_test/module-agent-start-proxy-test.js +65 -65
  84. package/_site/_test/module-artifact-integrity-test.js +27 -27
  85. package/_site/_test/module-boundary-test.js +30 -30
  86. package/_site/_test/module-bridge-eventbridge-test.js +202 -202
  87. package/_site/_test/module-dynamic-port-test.js +118 -118
  88. package/_site/_test/module-index-proxy-test.js +33 -0
  89. package/_site/_test/module-model-configuration-test.js +44 -44
  90. package/_site/_test/module-process-lifecycle-test.js +35 -35
  91. package/_site/_test/module-stream-proxy-test.js +34 -34
  92. package/_site/_test/module-terminal-restart-test.js +63 -0
  93. package/_site/_test/module-wiring-unbind-race-test.js +59 -59
  94. package/_site/_test/native-context-integrations-test.js +86 -86
  95. package/_site/_test/orphaned-claim-recovery-test.js +80 -80
  96. package/_site/_test/package-boundary-test.js +43 -42
  97. package/_site/_test/package-startup-test.js +56 -56
  98. package/_site/_test/packaged-ui-smoke-test.js +88 -88
  99. package/_site/_test/pr-consumer-contract-test.js +55 -55
  100. package/_site/_test/product-brand-contract-test.js +25 -25
  101. package/_site/_test/product-diagnostics-ui-test.js +93 -93
  102. package/_site/_test/product-import-ui-test.js +104 -104
  103. package/_site/_test/product-progress-status-test.js +12 -1
  104. package/_site/_test/project-remove-running-guard-test.js +79 -79
  105. package/_site/_test/project-store-test.js +90 -90
  106. package/_site/_test/registry-events-test.js +38 -0
  107. package/_site/_test/release-version-sync-test.js +115 -115
  108. package/_site/_test/requirement-binding-test.js +113 -113
  109. package/_site/_test/runtime-endpoint-test.js +64 -64
  110. package/_site/_test/scanner-test.js +83 -83
  111. package/_site/_test/server-security-test.js +96 -96
  112. package/_site/_test/sessions-stream-test.js +93 -93
  113. package/_site/_test/shared-scope-root-binding-test.js +67 -67
  114. package/_site/_test/simple-import-test.js +98 -98
  115. package/_site/_test/startup-analysis-disabled-test.js +6 -6
  116. package/_site/_test/team-knowledge-store-sparse-checkout-test.js +196 -196
  117. package/_site/_test/team-knowledge-store-test.js +132 -132
  118. package/_site/_test/test-server-cleanup-test.js +35 -35
  119. package/_site/_test/test-server-module-isolation-test.js +37 -37
  120. package/_site/_test/tracking-start-test.js +35 -35
  121. package/_site/_test/workbench-context-receipts-test.js +22 -0
  122. package/_site/_test/workspace-ui-contract-test.js +31 -31
  123. package/_site/_test/zcode-capture-integration-test.js +108 -108
  124. package/_site/lib/ai-vendor-presets.js +83 -83
  125. package/_site/lib/ai-workspace.js +3 -3
  126. package/_site/lib/atomic-file.js +204 -204
  127. package/_site/lib/bridge-adapter.js +260 -260
  128. package/_site/lib/capture-hook-config.js +108 -108
  129. package/_site/lib/claude-cli-runner.js +89 -89
  130. package/_site/lib/cli-instances.js +43 -43
  131. package/_site/lib/codex-context-status.js +17 -17
  132. package/_site/lib/codex-notify-config.js +193 -193
  133. package/_site/lib/commit-conversation-binder.js +13 -12
  134. package/_site/lib/commit-reconciler.js +38 -38
  135. package/_site/lib/context-pack-builder.js +299 -299
  136. package/_site/lib/conversation-exclusions.js +204 -204
  137. package/_site/lib/conversation-query-service.js +17 -17
  138. package/_site/lib/conversation-store.js +2 -0
  139. package/_site/lib/data-dir.js +13 -13
  140. package/_site/lib/embedding-service.js +85 -85
  141. package/_site/lib/engine-connection.js +93 -90
  142. package/_site/lib/engine-knowledge-client.js +72 -72
  143. package/_site/lib/folder-picker-output.js +3 -3
  144. package/_site/lib/git-path.js +14 -14
  145. package/_site/lib/github-team-store.js +3 -3
  146. package/_site/lib/index-builder.js +157 -157
  147. package/_site/lib/integration-status-scan.js +99 -99
  148. package/_site/lib/integration-status-worker.js +14 -14
  149. package/_site/lib/kb-framework.js +15 -15
  150. package/_site/lib/knowledge-db.js +363 -363
  151. package/_site/lib/knowledge-schema.js +121 -121
  152. package/_site/lib/live-gateway.js +78 -76
  153. package/_site/lib/llm-client.js +12 -12
  154. package/_site/lib/model-context-windows.js +82 -82
  155. package/_site/lib/module-bridge.js +874 -865
  156. package/_site/lib/module-port-resolver.js +57 -57
  157. package/_site/lib/post-commit-automation.js +54 -54
  158. package/_site/lib/product-data.js +35 -35
  159. package/_site/lib/project-lifecycle-service.js +14 -14
  160. package/_site/lib/project-registry-store.js +129 -129
  161. package/_site/lib/prompt-registry.js +148 -148
  162. package/_site/lib/registry-events.js +16 -0
  163. package/_site/lib/requirement-adapters.js +10 -10
  164. package/_site/lib/requirement-binder.js +112 -112
  165. package/_site/lib/runtime-control.js +89 -89
  166. package/_site/lib/runtime-endpoint.js +5 -5
  167. package/_site/lib/server-app.js +10 -1
  168. package/_site/lib/zcode-context-integration.js +60 -60
  169. package/_site/scripts/codex-notify-fanout.cjs +95 -95
  170. package/_site/scripts/install-module-candidates.js +69 -69
  171. package/_site/scripts/pack-module-candidates.js +89 -72
  172. package/_site/scripts/sync-product-content.js +28 -28
  173. package/_site/scripts/sync-release-version.js +164 -164
  174. package/_site/scripts/vendor-modules.js +49 -49
  175. package/_site/scripts/verify-module-runtime.js +50 -50
  176. package/_site/scripts/verify-product-runtime.js +36 -36
  177. package/_site/scripts/verify-retrieval-gold.js +83 -0
  178. package/_site/server.js +15 -15
  179. package/_site/start.bat +26 -26
  180. package/_site/stop.bat +11 -11
  181. package/bin/project-knowledge-integrations.js +254 -254
  182. package/bin/project-knowledge-kb.js +67 -67
  183. package/bin/project-knowledge-mcp.js +8 -8
  184. package/bin/project-knowledge.js +170 -170
  185. package/claude-prompts.json +21 -21
  186. package/docs/README.zh-CN.md +205 -205
  187. package/docs/assets/architecture.svg +181 -181
  188. package/docs/assets/logo.svg +49 -49
  189. package/docs/fresh-v5-start.md +42 -42
  190. package/docs/leader-glm-workbench-playbook.md +122 -119
  191. package/docs/project-registry-schema.md +11 -11
  192. package/docs/release-5.0.16-acceptance.md +176 -176
  193. package/docs/release-5.0.17-acceptance.md +117 -117
  194. package/docs/release-5.0.19-acceptance.md +39 -0
  195. package/docs/team-knowledge-mode-a-plan.md +73 -73
  196. package/module-runtime-manifest.json +126 -104
  197. package/package.json +110 -108
  198. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  199. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  200. package/plugins/project-knowledge/.mcp.json +1 -1
  201. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  202. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  203. package/templates/change.md +30 -30
  204. package/templates/project-readme.md +18 -18
  205. package/ui/index.html +1 -1
  206. package/ui/knowledge-panel.html +118 -0
  207. package/ui/product.css +8 -0
  208. package/ui/product.js +175 -8
  209. package/vendor-manifest.json +55 -53
@@ -1,118 +1,118 @@
1
- // Run: node _site/_test/integration-capture-setup-test.js
2
- //
3
- // T18 gates (INSTALL-001/002/003): one Project-Knowledge setup installs
4
- // Knowledge Integration + Development Capture without opening any client UI;
5
- // per-client status reports the two capabilities separately; third-party
6
- // config is preserved; Codex notify conflicts are reported, not overwritten;
7
- // connector uninstall keeps the host Bridge consumer until a global disable.
8
-
9
- const assert = require('assert');
10
- const fs = require('fs');
11
- const os = require('os');
12
- const path = require('path');
13
- const { IntegrationManager } = require('../lib/integration-installer');
14
- const { createBridge } = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
15
-
16
- const ROOT = path.resolve(__dirname, '..', '..');
17
- const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), `pk-integration-capture-${process.pid}-`));
18
- const homeDir = path.join(TEMP, 'home');
19
- const bridgeHome = path.join(TEMP, 'bridge-home');
20
- const claudeSettings = path.join(TEMP, 'claude-settings.json');
21
- const codexConfig = path.join(TEMP, 'codex-config.toml');
22
- const openCodePlugins = path.join(TEMP, 'opencode-plugins');
23
-
24
- function makeManager() {
25
- return new IntegrationManager({
26
- rootDir: ROOT,
27
- homeDir,
28
- env: {},
29
- commandResolver: name => name,
30
- runner: (command, args) => {
31
- const version = require('../../package.json').version;
32
- const cache = path.join(homeDir, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
33
- 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 }); }
34
- 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: '' };
35
- const codexCache = path.join(homeDir, 'codex-plugin-cache');
36
- 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 }); }
37
- 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: '' };
38
- return { status: 0, stdout: '', stderr: '' };
39
- },
40
- bridgeHomeDir: bridgeHome,
41
- codexHookProbe: async () => ({ data: [] }),
42
- claudeSettingsFile: claudeSettings,
43
- codexConfigFile: codexConfig,
44
- openCodePluginsDir: openCodePlugins,
45
- });
46
- }
47
-
48
- async function main() {
49
- const manager = makeManager();
50
-
51
- // Third-party entries pre-exist; they must survive every operation.
52
- fs.mkdirSync(path.dirname(claudeSettings), { recursive: true });
53
- fs.writeFileSync(claudeSettings, JSON.stringify({
54
- model: 'sonnet',
55
- hooks: { Stop: [{ matcher: '*', hooks: [{ type: 'command', command: 'node /somewhere/notify-user.js' }] }] },
56
- }));
57
- fs.mkdirSync(path.dirname(codexConfig), { recursive: true });
58
- fs.writeFileSync(codexConfig, 'model = "gpt-5"\nnotify = ["python", "C:/tools/my-notify.py"]\n');
59
- fs.mkdirSync(openCodePlugins, { recursive: true });
60
- fs.writeFileSync(path.join(openCodePlugins, 'my-own-plugin.js'), '// third party\n');
61
-
62
- // GATE INSTALL-001: one setup action, both capabilities, no client UI.
63
- const installed = await manager.installAll({ clients: ['claude', 'codex', 'opencode'] });
64
- assert.strictEqual(installed.bridge.ok, true, 'host Bridge consumer registered once');
65
- assert.strictEqual(installed.bridge.consumerName, 'project-knowledge');
66
- for (const entry of installed.clients) {
67
- assert.strictEqual(entry.knowledgeIntegration.ok, true, `${entry.client} knowledge integration installs`);
68
- const expectedCapture = entry.client === 'codex' ? 'conflict' : 'installed';
69
- assert.strictEqual(entry.developmentCapture.state, expectedCapture, `${entry.client} development capture state`);
70
- }
71
-
72
- // Claude managed hooks written programmatically into the user config.
73
- const settings = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
74
- const managedClaude = settings.hooks.UserPromptSubmit.some(group => group.hooks.some(hook => String(hook.command).includes('bridge-hook.cjs')));
75
- assert.strictEqual(managedClaude, true, 'managed Bridge hooks written to Claude user config without any interactive Claude step');
76
- assert.strictEqual(settings.hooks.Stop.some(group => group.hooks.some(hook => hook.command === 'node /somewhere/notify-user.js')), true, 'Claude third-party hook preserved');
77
-
78
- // GATE INSTALL-002: Codex third-party notify conflict reported, not overwritten.
79
- const codexEntry = installed.clients.find(entry => entry.client === 'codex');
80
- assert.strictEqual(codexEntry.developmentCapture.state, 'conflict', 'Codex reports the third-party notify conflict');
81
- assert.strictEqual(codexEntry.knowledgeIntegration.ok, true, 'Knowledge Integration stays independent of the Codex capture conflict');
82
- assert(fs.readFileSync(codexConfig, 'utf8').includes('my-notify.py'), 'third-party notifier never overwritten');
83
-
84
- // OpenCode managed plugin installed alongside third-party files.
85
- assert(fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed OpenCode plugin written');
86
- assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin preserved');
87
-
88
- // Status reports the two capabilities separately.
89
- const status = await manager.statusAll({ clients: ['claude', 'codex', 'opencode'] });
90
- assert.strictEqual(status.bridge.consumerRegistered, true);
91
- assert.strictEqual(status.bridge.bridgeHealthy, true);
92
- const claudeStatus = status.clients.find(entry => entry.client === 'claude');
93
- assert.strictEqual(claudeStatus.developmentCapture.installed, true);
94
- const codexStatus = status.clients.find(entry => entry.client === 'codex');
95
- assert.strictEqual(codexStatus.developmentCapture.conflict, true, 'conflict surfaces in status');
96
- assert.ok(Number.isInteger(status.bridge.health.lastSequence), 'bridge health fields available for the UI');
97
-
98
- // GATE INSTALL-003: removing one connector keeps the host consumer.
99
- await manager.uninstallCaptureClaude({});
100
- const facade = createBridge({ homeDir: bridgeHome });
101
- assert.strictEqual(Boolean(await facade.getConsumer('project-knowledge')), true, 'consumer survives a single connector uninstall');
102
- const settingsAfterClaude = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
103
- assert.strictEqual(settingsAfterClaude.hooks.UserPromptSubmit, undefined, 'managed Claude hook removed');
104
- assert.strictEqual(settingsAfterClaude.hooks.Stop[0].hooks[0].command, 'node /somewhere/notify-user.js', 'third-party hook still intact');
105
-
106
- // Another registered consumer stays untouched by a global disable.
107
- await facade.registerConsumer('devtask-radar');
108
- const disabled = await manager.disableAllCapture({ clients: ['claude', 'codex', 'opencode'] });
109
- assert.strictEqual(disabled.consumer.ok, true, 'global disable unregisters the project-knowledge consumer');
110
- const consumers = await facade.listConsumers();
111
- assert.deepStrictEqual(consumers.map(consumer => consumer.name), ['devtask-radar'], 'other consumers remain');
112
- assert(!fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed plugin removed');
113
- assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin survives global disable');
114
-
115
- console.log('integration-capture-setup-test PASS');
116
- }
117
-
118
- module.exports = main();
1
+ // Run: node _site/_test/integration-capture-setup-test.js
2
+ //
3
+ // T18 gates (INSTALL-001/002/003): one Project-Knowledge setup installs
4
+ // Knowledge Integration + Development Capture without opening any client UI;
5
+ // per-client status reports the two capabilities separately; third-party
6
+ // config is preserved; Codex notify conflicts are reported, not overwritten;
7
+ // connector uninstall keeps the host Bridge consumer until a global disable.
8
+
9
+ const assert = require('assert');
10
+ const fs = require('fs');
11
+ const os = require('os');
12
+ const path = require('path');
13
+ const { IntegrationManager } = require('../lib/integration-installer');
14
+ const { createBridge } = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
15
+
16
+ const ROOT = path.resolve(__dirname, '..', '..');
17
+ const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), `pk-integration-capture-${process.pid}-`));
18
+ const homeDir = path.join(TEMP, 'home');
19
+ const bridgeHome = path.join(TEMP, 'bridge-home');
20
+ const claudeSettings = path.join(TEMP, 'claude-settings.json');
21
+ const codexConfig = path.join(TEMP, 'codex-config.toml');
22
+ const openCodePlugins = path.join(TEMP, 'opencode-plugins');
23
+
24
+ function makeManager() {
25
+ return new IntegrationManager({
26
+ rootDir: ROOT,
27
+ homeDir,
28
+ env: {},
29
+ commandResolver: name => name,
30
+ runner: (command, args) => {
31
+ const version = require('../../package.json').version;
32
+ const cache = path.join(homeDir, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
33
+ 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 }); }
34
+ 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: '' };
35
+ const codexCache = path.join(homeDir, 'codex-plugin-cache');
36
+ 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 }); }
37
+ 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: '' };
38
+ return { status: 0, stdout: '', stderr: '' };
39
+ },
40
+ bridgeHomeDir: bridgeHome,
41
+ codexHookProbe: async () => ({ data: [] }),
42
+ claudeSettingsFile: claudeSettings,
43
+ codexConfigFile: codexConfig,
44
+ openCodePluginsDir: openCodePlugins,
45
+ });
46
+ }
47
+
48
+ async function main() {
49
+ const manager = makeManager();
50
+
51
+ // Third-party entries pre-exist; they must survive every operation.
52
+ fs.mkdirSync(path.dirname(claudeSettings), { recursive: true });
53
+ fs.writeFileSync(claudeSettings, JSON.stringify({
54
+ model: 'sonnet',
55
+ hooks: { Stop: [{ matcher: '*', hooks: [{ type: 'command', command: 'node /somewhere/notify-user.js' }] }] },
56
+ }));
57
+ fs.mkdirSync(path.dirname(codexConfig), { recursive: true });
58
+ fs.writeFileSync(codexConfig, 'model = "gpt-5"\nnotify = ["python", "C:/tools/my-notify.py"]\n');
59
+ fs.mkdirSync(openCodePlugins, { recursive: true });
60
+ fs.writeFileSync(path.join(openCodePlugins, 'my-own-plugin.js'), '// third party\n');
61
+
62
+ // GATE INSTALL-001: one setup action, both capabilities, no client UI.
63
+ const installed = await manager.installAll({ clients: ['claude', 'codex', 'opencode'] });
64
+ assert.strictEqual(installed.bridge.ok, true, 'host Bridge consumer registered once');
65
+ assert.strictEqual(installed.bridge.consumerName, 'project-knowledge');
66
+ for (const entry of installed.clients) {
67
+ assert.strictEqual(entry.knowledgeIntegration.ok, true, `${entry.client} knowledge integration installs`);
68
+ const expectedCapture = entry.client === 'codex' ? 'conflict' : 'installed';
69
+ assert.strictEqual(entry.developmentCapture.state, expectedCapture, `${entry.client} development capture state`);
70
+ }
71
+
72
+ // Claude managed hooks written programmatically into the user config.
73
+ const settings = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
74
+ const managedClaude = settings.hooks.UserPromptSubmit.some(group => group.hooks.some(hook => String(hook.command).includes('bridge-hook.cjs')));
75
+ assert.strictEqual(managedClaude, true, 'managed Bridge hooks written to Claude user config without any interactive Claude step');
76
+ assert.strictEqual(settings.hooks.Stop.some(group => group.hooks.some(hook => hook.command === 'node /somewhere/notify-user.js')), true, 'Claude third-party hook preserved');
77
+
78
+ // GATE INSTALL-002: Codex third-party notify conflict reported, not overwritten.
79
+ const codexEntry = installed.clients.find(entry => entry.client === 'codex');
80
+ assert.strictEqual(codexEntry.developmentCapture.state, 'conflict', 'Codex reports the third-party notify conflict');
81
+ assert.strictEqual(codexEntry.knowledgeIntegration.ok, true, 'Knowledge Integration stays independent of the Codex capture conflict');
82
+ assert(fs.readFileSync(codexConfig, 'utf8').includes('my-notify.py'), 'third-party notifier never overwritten');
83
+
84
+ // OpenCode managed plugin installed alongside third-party files.
85
+ assert(fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed OpenCode plugin written');
86
+ assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin preserved');
87
+
88
+ // Status reports the two capabilities separately.
89
+ const status = await manager.statusAll({ clients: ['claude', 'codex', 'opencode'] });
90
+ assert.strictEqual(status.bridge.consumerRegistered, true);
91
+ assert.strictEqual(status.bridge.bridgeHealthy, true);
92
+ const claudeStatus = status.clients.find(entry => entry.client === 'claude');
93
+ assert.strictEqual(claudeStatus.developmentCapture.installed, true);
94
+ const codexStatus = status.clients.find(entry => entry.client === 'codex');
95
+ assert.strictEqual(codexStatus.developmentCapture.conflict, true, 'conflict surfaces in status');
96
+ assert.ok(Number.isInteger(status.bridge.health.lastSequence), 'bridge health fields available for the UI');
97
+
98
+ // GATE INSTALL-003: removing one connector keeps the host consumer.
99
+ await manager.uninstallCaptureClaude({});
100
+ const facade = createBridge({ homeDir: bridgeHome });
101
+ assert.strictEqual(Boolean(await facade.getConsumer('project-knowledge')), true, 'consumer survives a single connector uninstall');
102
+ const settingsAfterClaude = JSON.parse(fs.readFileSync(claudeSettings, 'utf8'));
103
+ assert.strictEqual(settingsAfterClaude.hooks.UserPromptSubmit, undefined, 'managed Claude hook removed');
104
+ assert.strictEqual(settingsAfterClaude.hooks.Stop[0].hooks[0].command, 'node /somewhere/notify-user.js', 'third-party hook still intact');
105
+
106
+ // Another registered consumer stays untouched by a global disable.
107
+ await facade.registerConsumer('devtask-radar');
108
+ const disabled = await manager.disableAllCapture({ clients: ['claude', 'codex', 'opencode'] });
109
+ assert.strictEqual(disabled.consumer.ok, true, 'global disable unregisters the project-knowledge consumer');
110
+ const consumers = await facade.listConsumers();
111
+ assert.deepStrictEqual(consumers.map(consumer => consumer.name), ['devtask-radar'], 'other consumers remain');
112
+ assert(!fs.existsSync(path.join(openCodePlugins, 'ai-coding-event-bridge.js')), 'managed plugin removed');
113
+ assert(fs.existsSync(path.join(openCodePlugins, 'my-own-plugin.js')), 'third-party plugin survives global disable');
114
+
115
+ console.log('integration-capture-setup-test PASS');
116
+ }
117
+
118
+ module.exports = main();