@sanqianx/project-knowledge 5.0.19 → 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 (200) hide show
  1. package/.agents/plugins/marketplace.json +3 -3
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +5 -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-failures.js +39 -0
  9. package/_modules/knowledge-engine/src/analysis-worker.js +6 -2
  10. package/_modules/knowledge-engine/src/coordinator.js +7 -0
  11. package/_modules/knowledge-engine/src/headless-analyzer.js +2 -1
  12. package/_modules/knowledge-engine/src/server.js +1 -1
  13. package/_site/_test/agent-capture-mcp-ui-test.js +67 -67
  14. package/_site/_test/ai-profile-test.js +75 -75
  15. package/_site/_test/ai-vendor-presets-test.js +91 -91
  16. package/_site/_test/automatic-context-test.js +70 -70
  17. package/_site/_test/bin-cli-test.js +230 -230
  18. package/_site/_test/bridge-adapter-test.js +95 -95
  19. package/_site/_test/bridge-consumer-service-test.js +310 -310
  20. package/_site/_test/candidate-bin-content-test.js +35 -35
  21. package/_site/_test/candidate-product-assets-test.js +13 -13
  22. package/_site/_test/candidate-release-contract-test.js +14 -14
  23. package/_site/_test/capture-hook-dedup-test.js +158 -158
  24. package/_site/_test/claude-executable-discovery-test.js +28 -28
  25. package/_site/_test/claude-session-lifecycle-sweep-test.js +252 -252
  26. package/_site/_test/cli-instance-management-test.js +62 -62
  27. package/_site/_test/client-capture-restart-e2e-test.js +189 -189
  28. package/_site/_test/codex-conversation-projection-test.js +60 -60
  29. package/_site/_test/codex-marketplace-scoped-path-test.js +186 -186
  30. package/_site/_test/codex-notify-capture-e2e-test.js +101 -101
  31. package/_site/_test/codex-notify-fanout-test.js +134 -134
  32. package/_site/_test/codex-notify-upgrade-test.js +253 -253
  33. package/_site/_test/commit-boundary-freeze-test.js +147 -147
  34. package/_site/_test/commit-conversation-binding-test.js +4 -4
  35. package/_site/_test/configuration-generation-test.js +22 -22
  36. package/_site/_test/context-pack-test.js +200 -200
  37. package/_site/_test/conversation-api-test.js +10 -10
  38. package/_site/_test/conversation-origin-test.js +15 -15
  39. package/_site/_test/cross-repo-isolation-e2e-test.js +187 -187
  40. package/_site/_test/embedding-config-test.js +32 -32
  41. package/_site/_test/fixtures/fake-browser-exit.js +10 -10
  42. package/_site/_test/fixtures/fake-browser-hang.js +10 -10
  43. package/_site/_test/fixtures/integration-busy-worker.cjs +6 -6
  44. package/_site/_test/fixtures/make-git-repos.js +92 -92
  45. package/_site/_test/fixtures/retrieval-gold-queries.json +32 -32
  46. package/_site/_test/fresh-hook-reimport-test.js +53 -53
  47. package/_site/_test/fresh-product-data-test.js +56 -56
  48. package/_site/_test/git-path-compatibility-test.js +80 -80
  49. package/_site/_test/git-validation-test.js +81 -81
  50. package/_site/_test/hook-worktree-test.js +42 -42
  51. package/_site/_test/index-builder-test.js +41 -41
  52. package/_site/_test/index-error-display-contract-test.js +10 -10
  53. package/_site/_test/integration-adapters-test.js +67 -67
  54. package/_site/_test/integration-capture-setup-test.js +118 -118
  55. package/_site/_test/integration-runtime-binding-a2-test.js +566 -566
  56. package/_site/_test/integration-runtime-binding-a3-test.js +227 -227
  57. package/_site/_test/integration-runtime-binding-test.js +473 -473
  58. package/_site/_test/integration-status-scan-test.js +29 -29
  59. package/_site/_test/kb-framework-test.js +57 -57
  60. package/_site/_test/kbpath-follow-test.js +63 -63
  61. package/_site/_test/knowledge-db-test.js +144 -144
  62. package/_site/_test/knowledge-engine-client-test.js +109 -109
  63. package/_site/_test/knowledge-maintenance-test.js +40 -40
  64. package/_site/_test/knowledge-panel-ui-contract-test.js +112 -0
  65. package/_site/_test/knowledge-scopes-test.js +37 -37
  66. package/_site/_test/knowledge-storage-location-test.js +28 -28
  67. package/_site/_test/launcher-readiness-test.js +80 -80
  68. package/_site/_test/legacy-claude-session-alias-test.js +106 -106
  69. package/_site/_test/legacy-routes-removed-test.js +47 -47
  70. package/_site/_test/legacy-workbench-exclusion-test.js +92 -92
  71. package/_site/_test/live-gateway-test.js +48 -48
  72. package/_site/_test/local-marketplace-test.js +16 -16
  73. package/_site/_test/log-redaction-test.js +58 -58
  74. package/_site/_test/markdown-maintenance-test.js +11 -11
  75. package/_site/_test/model-context-windows-test.js +89 -89
  76. package/_site/_test/module-agent-start-proxy-test.js +65 -65
  77. package/_site/_test/module-artifact-integrity-test.js +27 -27
  78. package/_site/_test/module-boundary-test.js +30 -30
  79. package/_site/_test/module-bridge-eventbridge-test.js +202 -202
  80. package/_site/_test/module-dynamic-port-test.js +118 -118
  81. package/_site/_test/module-index-proxy-test.js +33 -33
  82. package/_site/_test/module-model-configuration-test.js +44 -44
  83. package/_site/_test/module-process-lifecycle-test.js +35 -35
  84. package/_site/_test/module-stream-proxy-test.js +34 -34
  85. package/_site/_test/module-terminal-restart-test.js +63 -63
  86. package/_site/_test/module-wiring-unbind-race-test.js +59 -59
  87. package/_site/_test/native-context-integrations-test.js +86 -86
  88. package/_site/_test/orphaned-claim-recovery-test.js +80 -80
  89. package/_site/_test/package-boundary-test.js +43 -42
  90. package/_site/_test/package-startup-test.js +56 -56
  91. package/_site/_test/packaged-ui-smoke-test.js +88 -88
  92. package/_site/_test/pr-consumer-contract-test.js +55 -55
  93. package/_site/_test/product-brand-contract-test.js +25 -25
  94. package/_site/_test/product-diagnostics-ui-test.js +93 -93
  95. package/_site/_test/product-import-ui-test.js +104 -104
  96. package/_site/_test/product-progress-status-test.js +12 -1
  97. package/_site/_test/project-remove-running-guard-test.js +79 -79
  98. package/_site/_test/project-store-test.js +90 -90
  99. package/_site/_test/registry-events-test.js +38 -38
  100. package/_site/_test/release-version-sync-test.js +115 -115
  101. package/_site/_test/requirement-binding-test.js +113 -113
  102. package/_site/_test/runtime-endpoint-test.js +64 -64
  103. package/_site/_test/scanner-test.js +83 -83
  104. package/_site/_test/server-security-test.js +96 -96
  105. package/_site/_test/sessions-stream-test.js +93 -93
  106. package/_site/_test/shared-scope-root-binding-test.js +67 -67
  107. package/_site/_test/simple-import-test.js +98 -98
  108. package/_site/_test/startup-analysis-disabled-test.js +6 -6
  109. package/_site/_test/team-knowledge-store-sparse-checkout-test.js +196 -196
  110. package/_site/_test/team-knowledge-store-test.js +132 -132
  111. package/_site/_test/test-server-cleanup-test.js +35 -35
  112. package/_site/_test/test-server-module-isolation-test.js +37 -37
  113. package/_site/_test/tracking-start-test.js +35 -35
  114. package/_site/_test/workbench-context-receipts-test.js +22 -22
  115. package/_site/_test/workspace-ui-contract-test.js +31 -31
  116. package/_site/_test/zcode-capture-integration-test.js +108 -108
  117. package/_site/lib/ai-vendor-presets.js +83 -83
  118. package/_site/lib/ai-workspace.js +3 -3
  119. package/_site/lib/atomic-file.js +204 -204
  120. package/_site/lib/bridge-adapter.js +260 -260
  121. package/_site/lib/capture-hook-config.js +108 -108
  122. package/_site/lib/claude-cli-runner.js +89 -89
  123. package/_site/lib/cli-instances.js +43 -43
  124. package/_site/lib/codex-context-status.js +17 -17
  125. package/_site/lib/codex-notify-config.js +193 -193
  126. package/_site/lib/commit-conversation-binder.js +12 -12
  127. package/_site/lib/commit-reconciler.js +38 -38
  128. package/_site/lib/context-pack-builder.js +299 -299
  129. package/_site/lib/conversation-exclusions.js +204 -204
  130. package/_site/lib/conversation-query-service.js +17 -17
  131. package/_site/lib/data-dir.js +13 -13
  132. package/_site/lib/embedding-service.js +85 -85
  133. package/_site/lib/engine-connection.js +93 -93
  134. package/_site/lib/engine-knowledge-client.js +72 -72
  135. package/_site/lib/folder-picker-output.js +3 -3
  136. package/_site/lib/git-path.js +14 -14
  137. package/_site/lib/github-team-store.js +3 -3
  138. package/_site/lib/index-builder.js +157 -157
  139. package/_site/lib/integration-status-scan.js +99 -99
  140. package/_site/lib/integration-status-worker.js +14 -14
  141. package/_site/lib/kb-framework.js +15 -15
  142. package/_site/lib/knowledge-db.js +363 -363
  143. package/_site/lib/knowledge-schema.js +121 -121
  144. package/_site/lib/live-gateway.js +78 -78
  145. package/_site/lib/llm-client.js +12 -12
  146. package/_site/lib/model-context-windows.js +82 -82
  147. package/_site/lib/module-bridge.js +874 -874
  148. package/_site/lib/module-port-resolver.js +57 -57
  149. package/_site/lib/post-commit-automation.js +54 -54
  150. package/_site/lib/product-data.js +35 -35
  151. package/_site/lib/project-lifecycle-service.js +14 -14
  152. package/_site/lib/project-registry-store.js +129 -129
  153. package/_site/lib/prompt-registry.js +148 -148
  154. package/_site/lib/registry-events.js +16 -16
  155. package/_site/lib/requirement-adapters.js +10 -10
  156. package/_site/lib/requirement-binder.js +112 -112
  157. package/_site/lib/runtime-control.js +89 -89
  158. package/_site/lib/runtime-endpoint.js +5 -5
  159. package/_site/lib/zcode-context-integration.js +60 -60
  160. package/_site/scripts/codex-notify-fanout.cjs +95 -95
  161. package/_site/scripts/install-module-candidates.js +69 -69
  162. package/_site/scripts/pack-module-candidates.js +89 -89
  163. package/_site/scripts/sync-product-content.js +28 -28
  164. package/_site/scripts/sync-release-version.js +164 -164
  165. package/_site/scripts/vendor-modules.js +49 -49
  166. package/_site/scripts/verify-module-runtime.js +50 -50
  167. package/_site/scripts/verify-product-runtime.js +36 -36
  168. package/_site/scripts/verify-retrieval-gold.js +83 -83
  169. package/_site/server.js +15 -15
  170. package/_site/start.bat +26 -26
  171. package/_site/stop.bat +11 -11
  172. package/bin/project-knowledge-integrations.js +254 -254
  173. package/bin/project-knowledge-kb.js +67 -67
  174. package/bin/project-knowledge-mcp.js +8 -8
  175. package/bin/project-knowledge.js +170 -170
  176. package/claude-prompts.json +21 -21
  177. package/docs/README.zh-CN.md +205 -205
  178. package/docs/assets/architecture.svg +181 -181
  179. package/docs/assets/logo.svg +49 -49
  180. package/docs/fresh-v5-start.md +42 -42
  181. package/docs/leader-glm-workbench-playbook.md +122 -122
  182. package/docs/project-registry-schema.md +11 -11
  183. package/docs/release-5.0.16-acceptance.md +176 -176
  184. package/docs/release-5.0.17-acceptance.md +117 -117
  185. package/docs/release-5.0.19-acceptance.md +39 -25
  186. package/docs/team-knowledge-mode-a-plan.md +73 -73
  187. package/module-runtime-manifest.json +53 -33
  188. package/package.json +3 -2
  189. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  190. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  191. package/plugins/project-knowledge/.mcp.json +1 -1
  192. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  193. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  194. package/templates/change.md +30 -30
  195. package/templates/project-readme.md +18 -18
  196. package/ui/index.html +1 -1
  197. package/ui/knowledge-panel.html +118 -0
  198. package/ui/product.css +8 -0
  199. package/ui/product.js +146 -4
  200. package/vendor-manifest.json +55 -54
@@ -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');