@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,92 +1,92 @@
1
- // Run: node _site/_test/legacy-workbench-exclusion-test.js
2
- //
3
- // T17 / GATE LEGACY-001: old embedded Workbench pairs are excluded from
4
- // Development Conversation presentation and new commit binding; genuine
5
- // explicit MCP requirements survive; immutable snapshots and JSONL lines are
6
- // never rewritten.
7
-
8
- const assert = require('assert');
9
- const fs = require('fs');
10
- const os = require('os');
11
- const path = require('path');
12
- const { StorageLayout } = require('../lib/storage-layout');
13
- const { ProjectStore } = require('../lib/project-store');
14
- const { ConversationStore } = require('../lib/conversation-store');
15
- const { CommitConversationBinder } = require('../lib/commit-conversation-binder');
16
- const { computeConversationExclusions, readDevelopmentEvents } = require('../lib/conversation-exclusions');
17
-
18
- const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-legacy-exclusion-${process.pid}-`));
19
- const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
20
- const projects = new ProjectStore({ layout });
21
- const store = new ConversationStore({ layout, projectStore: projects, logger: null });
22
- const projectId = 'project-legacy';
23
-
24
- const repoIdentity = { commonDir: path.join(temp, 'repo', '.git') };
25
-
26
- async function append(input) {
27
- await store.appendEvent(projectId, {
28
- source: 'claude-code',
29
- sessionId: 'legacy-session',
30
- projectPath: path.join(temp, 'repo'),
31
- repoIdentity,
32
- branch: 'main',
33
- capturedAt: '2026-08-01T00:00:00.000Z',
34
- ...input,
35
- });
36
- }
37
-
38
- (async () => {
39
- await projects.create(projectId, {
40
- displayName: 'Legacy', storageName: 'legacy',
41
- repoPath: path.join(temp, 'repo'), knowledgePath: path.join(temp, 'knowledge'),
42
- repoIdentity,
43
- }, { conversationBaselineCursor: 0 });
44
-
45
- // Old embedded Workbench pair (explicit-REQ1 + embedded-assistant-REQ1).
46
- await append({ eventId: 'explicit-REQ1', sequence: 1, eventType: 'user_prompt', role: 'user', content: 'Workbench prompt', turnId: 'turn-embed-1', identityConfidence: 'high' });
47
- await append({ eventId: 'embedded-assistant-REQ1', sequence: 2, eventType: 'assistant_response', role: 'assistant', content: 'Workbench reply', turnId: 'turn-embed-1', rawEventType: 'embedded-claude-result', identityConfidence: 'high' });
48
- // Genuine explicit MCP requirement NOT paired with an embedded assistant.
49
- await append({ eventId: 'explicit-REQ2', sequence: 3, eventType: 'user_prompt', role: 'user', content: 'Genuine MCP requirement', turnId: 'turn-explicit-2', identityConfidence: 'explicit', explicitCommitSha: 'f'.repeat(40) });
50
- // Modern bridge-projected event.
51
- await append({ eventId: 'evt-bridge-1', sequence: 4, eventType: 'user_prompt', role: 'user', content: 'Modern bridge event', turnId: 'turn-bridge', identityConfidence: 'exact' });
52
-
53
- const eventsRaw = store.readEvents(projectId);
54
- assert.strictEqual(eventsRaw.length, 4, 'raw JSONL lines are never deleted');
55
-
56
- const manifest = computeConversationExclusions(projectId, eventsRaw);
57
- assert.deepStrictEqual(manifest.excludedEventIds, ['embedded-assistant-REQ1', 'explicit-REQ1'], 'only the embedded pair is excluded');
58
-
59
- const development = readDevelopmentEvents(store, projectId);
60
- assert.deepStrictEqual(development.map(event => event.eventId), ['explicit-REQ2', 'evt-bridge-1'], 'genuine explicit + bridge events survive');
61
- assert.strictEqual(development.some(event => event.content === 'Workbench prompt'), false);
62
- assert.strictEqual(development.some(event => event.content === 'Workbench reply'), false);
63
-
64
- // Manifest persisted for audit; JSONL untouched.
65
- const manifestFile = path.join(layout.getProjectMetadataDir(projectId), 'conversation-exclusions.json');
66
- assert.ok(fs.existsSync(manifestFile), 'exclusion manifest is persisted');
67
- assert.strictEqual(JSON.parse(fs.readFileSync(manifestFile, 'utf8')).schema, 'conversation-exclusions/v1');
68
- assert.strictEqual(store.readEvents(projectId).length, 4, 'raw store still holds every historical line');
69
-
70
- // New commit binding excludes the legacy pair.
71
- const binder = new CommitConversationBinder({ layout, projectStore: projects, conversationStore: store });
72
- const commitSha = 'a'.repeat(40);
73
- store.writeBoundary(projectId, {
74
- repoIdentity, commitSha, parentShas: [], branch: 'main', committedAt: '2026-08-02T00:00:00.000Z',
75
- bridgeCursorAtCommit: 10, journalSequence: 10, openTurnIdsAtCommit: [], operationId: 'op-legacy',
76
- });
77
- const snapshot = await binder.bind({ projectId, commitSha });
78
- assert.ok(!JSON.stringify(snapshot).includes('Workbench prompt'), 'legacy embedded pair never binds to a new commit');
79
- assert.ok(!JSON.stringify(snapshot).includes('embedded-claude-result'));
80
-
81
- // An old frozen snapshot written before the migration stays byte-identical.
82
- const frozenPath = layout.getProjectCommitConversationPath(projectId, commitSha);
83
- const before = fs.readFileSync(frozenPath, 'utf8');
84
- const rebound = await binder.bind({ projectId, commitSha });
85
- assert.strictEqual(rebound.snapshotHash, snapshot.snapshotHash, 'immutable snapshot untouched by exclusion');
86
- assert.strictEqual(fs.readFileSync(frozenPath, 'utf8'), before);
87
-
88
- console.log('legacy-workbench-exclusion-test PASS');
89
- })().catch(error => {
90
- console.error(error.stack || error.message);
91
- process.exitCode = 1;
92
- });
1
+ // Run: node _site/_test/legacy-workbench-exclusion-test.js
2
+ //
3
+ // T17 / GATE LEGACY-001: old embedded Workbench pairs are excluded from
4
+ // Development Conversation presentation and new commit binding; genuine
5
+ // explicit MCP requirements survive; immutable snapshots and JSONL lines are
6
+ // never rewritten.
7
+
8
+ const assert = require('assert');
9
+ const fs = require('fs');
10
+ const os = require('os');
11
+ const path = require('path');
12
+ const { StorageLayout } = require('../lib/storage-layout');
13
+ const { ProjectStore } = require('../lib/project-store');
14
+ const { ConversationStore } = require('../lib/conversation-store');
15
+ const { CommitConversationBinder } = require('../lib/commit-conversation-binder');
16
+ const { computeConversationExclusions, readDevelopmentEvents } = require('../lib/conversation-exclusions');
17
+
18
+ const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-legacy-exclusion-${process.pid}-`));
19
+ const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
20
+ const projects = new ProjectStore({ layout });
21
+ const store = new ConversationStore({ layout, projectStore: projects, logger: null });
22
+ const projectId = 'project-legacy';
23
+
24
+ const repoIdentity = { commonDir: path.join(temp, 'repo', '.git') };
25
+
26
+ async function append(input) {
27
+ await store.appendEvent(projectId, {
28
+ source: 'claude-code',
29
+ sessionId: 'legacy-session',
30
+ projectPath: path.join(temp, 'repo'),
31
+ repoIdentity,
32
+ branch: 'main',
33
+ capturedAt: '2026-08-01T00:00:00.000Z',
34
+ ...input,
35
+ });
36
+ }
37
+
38
+ (async () => {
39
+ await projects.create(projectId, {
40
+ displayName: 'Legacy', storageName: 'legacy',
41
+ repoPath: path.join(temp, 'repo'), knowledgePath: path.join(temp, 'knowledge'),
42
+ repoIdentity,
43
+ }, { conversationBaselineCursor: 0 });
44
+
45
+ // Old embedded Workbench pair (explicit-REQ1 + embedded-assistant-REQ1).
46
+ await append({ eventId: 'explicit-REQ1', sequence: 1, eventType: 'user_prompt', role: 'user', content: 'Workbench prompt', turnId: 'turn-embed-1', identityConfidence: 'high' });
47
+ await append({ eventId: 'embedded-assistant-REQ1', sequence: 2, eventType: 'assistant_response', role: 'assistant', content: 'Workbench reply', turnId: 'turn-embed-1', rawEventType: 'embedded-claude-result', identityConfidence: 'high' });
48
+ // Genuine explicit MCP requirement NOT paired with an embedded assistant.
49
+ await append({ eventId: 'explicit-REQ2', sequence: 3, eventType: 'user_prompt', role: 'user', content: 'Genuine MCP requirement', turnId: 'turn-explicit-2', identityConfidence: 'explicit', explicitCommitSha: 'f'.repeat(40) });
50
+ // Modern bridge-projected event.
51
+ await append({ eventId: 'evt-bridge-1', sequence: 4, eventType: 'user_prompt', role: 'user', content: 'Modern bridge event', turnId: 'turn-bridge', identityConfidence: 'exact' });
52
+
53
+ const eventsRaw = store.readEvents(projectId);
54
+ assert.strictEqual(eventsRaw.length, 4, 'raw JSONL lines are never deleted');
55
+
56
+ const manifest = computeConversationExclusions(projectId, eventsRaw);
57
+ assert.deepStrictEqual(manifest.excludedEventIds, ['embedded-assistant-REQ1', 'explicit-REQ1'], 'only the embedded pair is excluded');
58
+
59
+ const development = readDevelopmentEvents(store, projectId);
60
+ assert.deepStrictEqual(development.map(event => event.eventId), ['explicit-REQ2', 'evt-bridge-1'], 'genuine explicit + bridge events survive');
61
+ assert.strictEqual(development.some(event => event.content === 'Workbench prompt'), false);
62
+ assert.strictEqual(development.some(event => event.content === 'Workbench reply'), false);
63
+
64
+ // Manifest persisted for audit; JSONL untouched.
65
+ const manifestFile = path.join(layout.getProjectMetadataDir(projectId), 'conversation-exclusions.json');
66
+ assert.ok(fs.existsSync(manifestFile), 'exclusion manifest is persisted');
67
+ assert.strictEqual(JSON.parse(fs.readFileSync(manifestFile, 'utf8')).schema, 'conversation-exclusions/v1');
68
+ assert.strictEqual(store.readEvents(projectId).length, 4, 'raw store still holds every historical line');
69
+
70
+ // New commit binding excludes the legacy pair.
71
+ const binder = new CommitConversationBinder({ layout, projectStore: projects, conversationStore: store });
72
+ const commitSha = 'a'.repeat(40);
73
+ store.writeBoundary(projectId, {
74
+ repoIdentity, commitSha, parentShas: [], branch: 'main', committedAt: '2026-08-02T00:00:00.000Z',
75
+ bridgeCursorAtCommit: 10, journalSequence: 10, openTurnIdsAtCommit: [], operationId: 'op-legacy',
76
+ });
77
+ const snapshot = await binder.bind({ projectId, commitSha });
78
+ assert.ok(!JSON.stringify(snapshot).includes('Workbench prompt'), 'legacy embedded pair never binds to a new commit');
79
+ assert.ok(!JSON.stringify(snapshot).includes('embedded-claude-result'));
80
+
81
+ // An old frozen snapshot written before the migration stays byte-identical.
82
+ const frozenPath = layout.getProjectCommitConversationPath(projectId, commitSha);
83
+ const before = fs.readFileSync(frozenPath, 'utf8');
84
+ const rebound = await binder.bind({ projectId, commitSha });
85
+ assert.strictEqual(rebound.snapshotHash, snapshot.snapshotHash, 'immutable snapshot untouched by exclusion');
86
+ assert.strictEqual(fs.readFileSync(frozenPath, 'utf8'), before);
87
+
88
+ console.log('legacy-workbench-exclusion-test PASS');
89
+ })().catch(error => {
90
+ console.error(error.stack || error.message);
91
+ process.exitCode = 1;
92
+ });
@@ -1,48 +1,48 @@
1
- 'use strict';
2
- const assert = require('node:assert/strict');
3
- const http = require('node:http');
4
- const { once } = require('node:events');
5
- const { WebSocket } = require('ws');
6
- const { attachLiveGateway } = require('../lib/live-gateway');
7
- const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
8
- (async () => {
9
- let active = 0, total = 0;
10
- const upstream = http.createServer((req, res) => {
11
- active++; total++;
12
- res.writeHead(200, { 'Content-Type': 'text/event-stream' });
13
- res.write('id: 17\r\nevent: snapshot\r\ndata: {"ok":true}\r');
14
- setTimeout(() => { if (!res.destroyed) res.write('\n\r\n'); }, 5);
15
- req.on('close', () => { active--; });
16
- });
17
- await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
18
- const origin = `http://127.0.0.1:${upstream.address().port}`;
19
- const server = http.createServer();
20
- const runtime = { moduleBridge: { engineUrl: origin, engineCompatible: true, _terminalApi: route => origin + route } };
21
- const gateway = attachLiveGateway(server, runtime);
22
- await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
23
- const base = `http://127.0.0.1:${server.address().port}`, clients = [];
24
- try {
25
- for (let i = 0; i < 8; i++) {
26
- const ws = new WebSocket(base.replace('http:', 'ws:') + '/api/live', { origin: base }); clients.push(ws);
27
- await once(ws, 'open');
28
- const messages = []; ws.on('message', b => messages.push(JSON.parse(String(b))));
29
- ws.send(JSON.stringify({ type: 'subscribe', id: 'engine', route: '/api/engine/progress?summary=1' }));
30
- for (let n = 0; n < 100 && !messages.some(m => m.type === 'event'); n++) await wait(5);
31
- const event = messages.find(m => m.type === 'event'); assert.equal(event.event, 'snapshot'); assert.equal(event.cursor, '17'); assert.deepEqual(JSON.parse(event.data), { ok: true });
32
- ws.send(JSON.stringify({ type: 'subscribe', id: 'invalid', route: 'http://attacker.invalid/private' }));
33
- for (let n = 0; n < 100 && !messages.some(m => m.id === 'invalid'); n++) await wait(5);
34
- assert.equal(messages.find(m => m.id === 'invalid').code, 'INVALID_SUBSCRIPTION');
35
- }
36
- assert.equal(active, 8); assert.equal(total, 8, 'invalid URLs never fetch an upstream');
37
- const last = clients.at(-1);
38
- last.send(JSON.stringify({ type: 'unsubscribe', id: 'engine' }));
39
- for (let n = 0; n < 100 && active !== 7; n++) await wait(5);
40
- assert.equal(active, 7, 'unsubscribing releases the upstream');
41
- const rejected = new WebSocket(base.replace('http:', 'ws:') + '/api/live', { origin: 'http://evil.invalid' });
42
- await new Promise(resolve => { rejected.on('error', resolve); rejected.on('open', () => { throw new Error('cross-origin upgrade was accepted'); }); });
43
- gateway.close();
44
- for (let n = 0; n < 100 && active; n++) await wait(5);
45
- assert.equal(active, 0);
46
- console.log('live-gateway-test PASS (8 real sockets, CRLF frames, bounded allowlist, unsubscribe and shutdown release)');
47
- } finally { for (const ws of clients) ws.terminate(); gateway.close(); upstream.closeAllConnections(); await Promise.all([new Promise(r => server.close(r)), new Promise(r => upstream.close(r))]); }
48
- })().catch(error => { console.error(error); process.exitCode = 1; });
1
+ 'use strict';
2
+ const assert = require('node:assert/strict');
3
+ const http = require('node:http');
4
+ const { once } = require('node:events');
5
+ const { WebSocket } = require('ws');
6
+ const { attachLiveGateway } = require('../lib/live-gateway');
7
+ const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
8
+ (async () => {
9
+ let active = 0, total = 0;
10
+ const upstream = http.createServer((req, res) => {
11
+ active++; total++;
12
+ res.writeHead(200, { 'Content-Type': 'text/event-stream' });
13
+ res.write('id: 17\r\nevent: snapshot\r\ndata: {"ok":true}\r');
14
+ setTimeout(() => { if (!res.destroyed) res.write('\n\r\n'); }, 5);
15
+ req.on('close', () => { active--; });
16
+ });
17
+ await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
18
+ const origin = `http://127.0.0.1:${upstream.address().port}`;
19
+ const server = http.createServer();
20
+ const runtime = { moduleBridge: { engineUrl: origin, engineCompatible: true, _terminalApi: route => origin + route } };
21
+ const gateway = attachLiveGateway(server, runtime);
22
+ await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
23
+ const base = `http://127.0.0.1:${server.address().port}`, clients = [];
24
+ try {
25
+ for (let i = 0; i < 8; i++) {
26
+ const ws = new WebSocket(base.replace('http:', 'ws:') + '/api/live', { origin: base }); clients.push(ws);
27
+ await once(ws, 'open');
28
+ const messages = []; ws.on('message', b => messages.push(JSON.parse(String(b))));
29
+ ws.send(JSON.stringify({ type: 'subscribe', id: 'engine', route: '/api/engine/progress?summary=1' }));
30
+ for (let n = 0; n < 100 && !messages.some(m => m.type === 'event'); n++) await wait(5);
31
+ const event = messages.find(m => m.type === 'event'); assert.equal(event.event, 'snapshot'); assert.equal(event.cursor, '17'); assert.deepEqual(JSON.parse(event.data), { ok: true });
32
+ ws.send(JSON.stringify({ type: 'subscribe', id: 'invalid', route: 'http://attacker.invalid/private' }));
33
+ for (let n = 0; n < 100 && !messages.some(m => m.id === 'invalid'); n++) await wait(5);
34
+ assert.equal(messages.find(m => m.id === 'invalid').code, 'INVALID_SUBSCRIPTION');
35
+ }
36
+ assert.equal(active, 8); assert.equal(total, 8, 'invalid URLs never fetch an upstream');
37
+ const last = clients.at(-1);
38
+ last.send(JSON.stringify({ type: 'unsubscribe', id: 'engine' }));
39
+ for (let n = 0; n < 100 && active !== 7; n++) await wait(5);
40
+ assert.equal(active, 7, 'unsubscribing releases the upstream');
41
+ const rejected = new WebSocket(base.replace('http:', 'ws:') + '/api/live', { origin: 'http://evil.invalid' });
42
+ await new Promise(resolve => { rejected.on('error', resolve); rejected.on('open', () => { throw new Error('cross-origin upgrade was accepted'); }); });
43
+ gateway.close();
44
+ for (let n = 0; n < 100 && active; n++) await wait(5);
45
+ assert.equal(active, 0);
46
+ console.log('live-gateway-test PASS (8 real sockets, CRLF frames, bounded allowlist, unsubscribe and shutdown release)');
47
+ } finally { for (const ws of clients) ws.terminate(); gateway.close(); upstream.closeAllConnections(); await Promise.all([new Promise(r => server.close(r)), new Promise(r => upstream.close(r))]); }
48
+ })().catch(error => { console.error(error); process.exitCode = 1; });
@@ -1,16 +1,16 @@
1
- 'use strict';
2
- const assert = require('node:assert/strict');
3
- const path = require('node:path');
4
- const { IntegrationManager } = require('../lib/integration-installer');
5
- const commands = [];
6
- const root = path.resolve(__dirname, '../..');
7
- const manager = new IntegrationManager({ rootDir: root, commandResolver: name => name, runner: (cmd, args) => {
8
- commands.push(args);
9
- return { status: 0, stdout: '[]', stderr: '' };
10
- } });
11
- manager.ensureClaudeMarketplace();
12
- assert.equal(commands.find(args => args.slice(0, 3).join(' ') === 'plugin marketplace add')[3], root, 'Claude installs from the downloaded npm package, not GitHub');
13
- const custom = new IntegrationManager({ marketplaceSource: 'https://example.invalid/explicit.git', commandResolver: name => name, runner: (cmd, args) => ({ status: 0, stdout: '[]' }), dryRun: true });
14
- custom.ensureClaudeMarketplace();
15
- assert.equal(custom.planned[0].args[3], 'https://example.invalid/explicit.git');
16
- console.log('Local marketplace and explicit-source override passed.');
1
+ 'use strict';
2
+ const assert = require('node:assert/strict');
3
+ const path = require('node:path');
4
+ const { IntegrationManager } = require('../lib/integration-installer');
5
+ const commands = [];
6
+ const root = path.resolve(__dirname, '../..');
7
+ const manager = new IntegrationManager({ rootDir: root, commandResolver: name => name, runner: (cmd, args) => {
8
+ commands.push(args);
9
+ return { status: 0, stdout: '[]', stderr: '' };
10
+ } });
11
+ manager.ensureClaudeMarketplace();
12
+ assert.equal(commands.find(args => args.slice(0, 3).join(' ') === 'plugin marketplace add')[3], root, 'Claude installs from the downloaded npm package, not GitHub');
13
+ const custom = new IntegrationManager({ marketplaceSource: 'https://example.invalid/explicit.git', commandResolver: name => name, runner: (cmd, args) => ({ status: 0, stdout: '[]' }), dryRun: true });
14
+ custom.ensureClaudeMarketplace();
15
+ assert.equal(custom.planned[0].args[3], 'https://example.invalid/explicit.git');
16
+ console.log('Local marketplace and explicit-source override passed.');
@@ -1,58 +1,58 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
- const { StorageLayout } = require('../lib/storage-layout');
6
- const { Logger, LogRepository, redactValue, serializeError } = require('../lib/structured-logger');
7
-
8
- (async () => {
9
- const secret = 'sk-secret-123456';
10
- const value = redactValue({
11
- apiKey: secret,
12
- headers: { authorization: 'Bearer ' + secret },
13
- url: 'https://user:' + secret + '@example.invalid/path?token=' + secret,
14
- nested: [{ clientSecret: secret }, { safe: 'visible' }],
15
- }, { secrets: [secret] });
16
- const text = JSON.stringify(value);
17
- assert(!text.includes(secret));
18
- assert(text.includes('visible'));
19
-
20
- const cause = Object.assign(new Error('cause ' + secret), { code: 'ECAUSE' });
21
- const error = Object.assign(new Error('Bearer ' + secret), { code: 'ETEST', cause });
22
- const serialized = JSON.stringify(serializeError(error, { secrets: [secret] }));
23
- assert(!serialized.includes(secret));
24
- assert(serialized.includes('ETEST'));
25
- assert(serialized.includes('ECAUSE'));
26
-
27
- const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-dynamic-redaction-'));
28
- try {
29
- const layout = new StorageLayout({ dataDir });
30
- let currentSecret = 'dynamic-secret-one';
31
- const settings = { levels: ['info', 'error'], retentionDays: 365, maxTotalSizeMB: 10 };
32
- const secretsProvider = () => [currentSecret];
33
- const logger = new Logger({ layout, settingsProvider: () => settings, secretsProvider });
34
- await logger.info('secret.first', 'first ' + currentSecret, { context: { echoed: currentSecret } });
35
- currentSecret = 'dynamic-secret-two';
36
- await logger.error('secret.second', 'second ' + currentSecret, { error: new Error('failure ' + currentSecret) });
37
- await logger.close();
38
-
39
- const repository = new LogRepository({ layout, settingsProvider: () => settings, secretsProvider });
40
- const page = repository.query({ from: '2000-01-01', to: '2999-12-31' });
41
- const queried = JSON.stringify(page);
42
- assert(!queried.includes(currentSecret), 'current configured secret must be redacted during query');
43
- assert(!queried.includes('dynamic-secret-one'), 'write-time configured secret must be redacted before persistence');
44
-
45
- const exportPath = path.join(dataDir, 'export.jsonl');
46
- repository.exportToFile(exportPath, { from: '2000-01-01', to: '2999-12-31' });
47
- const exported = fs.readFileSync(exportPath, 'utf8');
48
- assert(!exported.includes('dynamic-secret-one'));
49
- assert(!exported.includes('dynamic-secret-two'));
50
- } finally {
51
- fs.rmSync(dataDir, { recursive: true, force: true });
52
- }
53
-
54
- console.log('log-redaction-test PASS');
55
- })().catch(error => {
56
- console.error(error.stack || error.message);
57
- process.exitCode = 1;
58
- });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+ const { StorageLayout } = require('../lib/storage-layout');
6
+ const { Logger, LogRepository, redactValue, serializeError } = require('../lib/structured-logger');
7
+
8
+ (async () => {
9
+ const secret = 'sk-secret-123456';
10
+ const value = redactValue({
11
+ apiKey: secret,
12
+ headers: { authorization: 'Bearer ' + secret },
13
+ url: 'https://user:' + secret + '@example.invalid/path?token=' + secret,
14
+ nested: [{ clientSecret: secret }, { safe: 'visible' }],
15
+ }, { secrets: [secret] });
16
+ const text = JSON.stringify(value);
17
+ assert(!text.includes(secret));
18
+ assert(text.includes('visible'));
19
+
20
+ const cause = Object.assign(new Error('cause ' + secret), { code: 'ECAUSE' });
21
+ const error = Object.assign(new Error('Bearer ' + secret), { code: 'ETEST', cause });
22
+ const serialized = JSON.stringify(serializeError(error, { secrets: [secret] }));
23
+ assert(!serialized.includes(secret));
24
+ assert(serialized.includes('ETEST'));
25
+ assert(serialized.includes('ECAUSE'));
26
+
27
+ const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-dynamic-redaction-'));
28
+ try {
29
+ const layout = new StorageLayout({ dataDir });
30
+ let currentSecret = 'dynamic-secret-one';
31
+ const settings = { levels: ['info', 'error'], retentionDays: 365, maxTotalSizeMB: 10 };
32
+ const secretsProvider = () => [currentSecret];
33
+ const logger = new Logger({ layout, settingsProvider: () => settings, secretsProvider });
34
+ await logger.info('secret.first', 'first ' + currentSecret, { context: { echoed: currentSecret } });
35
+ currentSecret = 'dynamic-secret-two';
36
+ await logger.error('secret.second', 'second ' + currentSecret, { error: new Error('failure ' + currentSecret) });
37
+ await logger.close();
38
+
39
+ const repository = new LogRepository({ layout, settingsProvider: () => settings, secretsProvider });
40
+ const page = repository.query({ from: '2000-01-01', to: '2999-12-31' });
41
+ const queried = JSON.stringify(page);
42
+ assert(!queried.includes(currentSecret), 'current configured secret must be redacted during query');
43
+ assert(!queried.includes('dynamic-secret-one'), 'write-time configured secret must be redacted before persistence');
44
+
45
+ const exportPath = path.join(dataDir, 'export.jsonl');
46
+ repository.exportToFile(exportPath, { from: '2000-01-01', to: '2999-12-31' });
47
+ const exported = fs.readFileSync(exportPath, 'utf8');
48
+ assert(!exported.includes('dynamic-secret-one'));
49
+ assert(!exported.includes('dynamic-secret-two'));
50
+ } finally {
51
+ fs.rmSync(dataDir, { recursive: true, force: true });
52
+ }
53
+
54
+ console.log('log-redaction-test PASS');
55
+ })().catch(error => {
56
+ console.error(error.stack || error.message);
57
+ process.exitCode = 1;
58
+ });
@@ -1,11 +1,11 @@
1
- const assert = require('assert');
2
- const { canonicalRelativePath, validateMarkdown } = require('../lib/knowledge-promotion');
3
-
4
- assert.strictEqual(canonicalRelativePath('modules/core.md'), 'modules/core.md');
5
- for (const invalid of ['../outside.md', '/absolute.md', 'modules/00-index.md', 'module.txt', 'CON.md', 'modules/file.md:stream']) {
6
- assert.throws(() => canonicalRelativePath(invalid), undefined, `unsafe promotion path should fail: ${invalid}`);
7
- }
8
- assert.doesNotThrow(() => validateMarkdown('# Verified fact\n\nEvidence-backed content.\n', 'modules/core.md'));
9
- assert.throws(() => validateMarkdown('# Placeholder\n\nTODO: invent this later.\n', 'modules/core.md'), /placeholder/i);
10
- assert.throws(() => validateMarkdown('# Title\n\n\u0000invalid', 'modules/core.md'), /control/i);
11
- console.log('markdown-maintenance-test: PASS');
1
+ const assert = require('assert');
2
+ const { canonicalRelativePath, validateMarkdown } = require('../lib/knowledge-promotion');
3
+
4
+ assert.strictEqual(canonicalRelativePath('modules/core.md'), 'modules/core.md');
5
+ for (const invalid of ['../outside.md', '/absolute.md', 'modules/00-index.md', 'module.txt', 'CON.md', 'modules/file.md:stream']) {
6
+ assert.throws(() => canonicalRelativePath(invalid), undefined, `unsafe promotion path should fail: ${invalid}`);
7
+ }
8
+ assert.doesNotThrow(() => validateMarkdown('# Verified fact\n\nEvidence-backed content.\n', 'modules/core.md'));
9
+ assert.throws(() => validateMarkdown('# Placeholder\n\nTODO: invent this later.\n', 'modules/core.md'), /placeholder/i);
10
+ assert.throws(() => validateMarkdown('# Title\n\n\u0000invalid', 'modules/core.md'), /control/i);
11
+ console.log('markdown-maintenance-test: PASS');