@sanqianx/project-knowledge 4.7.0 → 5.0.0

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 (196) hide show
  1. package/.agents/plugins/marketplace.json +17 -17
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +836 -799
  4. package/README.md +58 -41
  5. package/_modules/knowledge-engine/README.md +91 -0
  6. package/_modules/knowledge-engine/package.json +38 -0
  7. package/_modules/knowledge-engine/src/analysis-contract.js +25 -0
  8. package/_modules/knowledge-engine/src/analysis-worker.js +54 -0
  9. package/_modules/knowledge-engine/src/bin.js +52 -0
  10. package/_modules/knowledge-engine/src/bridge-client.js +24 -0
  11. package/_modules/knowledge-engine/src/coordinator.js +263 -0
  12. package/_modules/knowledge-engine/src/headless-analyzer.js +75 -0
  13. package/_modules/knowledge-engine/src/memories.js +85 -0
  14. package/_modules/knowledge-engine/src/retrieval.js +116 -0
  15. package/_modules/knowledge-engine/src/runtime/README.md +7 -0
  16. package/_modules/knowledge-engine/src/runtime/atomic-file.js +204 -0
  17. package/_modules/knowledge-engine/src/runtime/automation-config.js +140 -0
  18. package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +249 -0
  19. package/_modules/knowledge-engine/src/runtime/commit-processing-ledger.js +26 -0
  20. package/_modules/knowledge-engine/src/runtime/commit-prompt.js +202 -0
  21. package/_modules/knowledge-engine/src/runtime/commit-reconciler.js +432 -0
  22. package/_modules/knowledge-engine/src/runtime/content-hash.js +4 -0
  23. package/_modules/knowledge-engine/src/runtime/contracts.js +279 -0
  24. package/_modules/knowledge-engine/src/runtime/conversation-exclusions.js +204 -0
  25. package/_modules/knowledge-engine/src/runtime/conversation-store.js +387 -0
  26. package/_modules/knowledge-engine/src/runtime/evidence-bundle.js +228 -0
  27. package/_modules/knowledge-engine/src/runtime/git-runner.js +62 -0
  28. package/_modules/knowledge-engine/src/runtime/knowledge-promotion.js +444 -0
  29. package/_modules/knowledge-engine/src/runtime/knowledge-retrieval-service.js +402 -0
  30. package/_modules/knowledge-engine/src/runtime/layout.js +44 -0
  31. package/_modules/knowledge-engine/src/runtime/markdown-knowledge-indexer.js +230 -0
  32. package/_modules/knowledge-engine/src/runtime/scanner.js +298 -0
  33. package/_modules/knowledge-engine/src/server.js +154 -0
  34. package/_modules/knowledge-engine/src/store.js +236 -0
  35. package/_modules/knowledge-engine/ui/app.css +172 -0
  36. package/_modules/knowledge-engine/ui/app.js +297 -0
  37. package/_modules/knowledge-engine/ui/index.html +95 -0
  38. package/_site/README.md +30 -30
  39. package/_site/_test/ai-profile-resolver-test.js +137 -137
  40. package/_site/_test/automation-queue-test.js +14 -14
  41. package/_site/_test/automation-ui-test.js +40 -40
  42. package/_site/_test/background-task-registry-test.js +43 -43
  43. package/_site/_test/baseline-schema-test.js +91 -91
  44. package/_site/_test/chat-claudecodeui-match-test.js +92 -92
  45. package/_site/_test/claude-executable-discovery-test.js +62 -62
  46. package/_site/_test/claude-workbench-test.js +170 -170
  47. package/_site/_test/codex-conversation-projection-test.js +2 -1
  48. package/_site/_test/commit-conversation-binding-test.js +95 -95
  49. package/_site/_test/commit-evidence-test.js +110 -110
  50. package/_site/_test/conversation-api-test.js +109 -109
  51. package/_site/_test/conversation-store-test.js +136 -136
  52. package/_site/_test/desktop-browser-compat-test.js +28 -28
  53. package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
  54. package/_site/_test/explicit-commit-processor-test.js +37 -37
  55. package/_site/_test/fixtures/make-git-repos.js +12 -1
  56. package/_site/_test/folder-picker-output-test.js +19 -19
  57. package/_site/_test/fresh-hook-reimport-test.js +53 -0
  58. package/_site/_test/fresh-product-data-test.js +42 -0
  59. package/_site/_test/full-integration-e2e-test.js +165 -165
  60. package/_site/_test/git-validation-test.js +2 -2
  61. package/_site/_test/hook-runtime-endpoint-test.js +88 -88
  62. package/_site/_test/hook-status-repair-api-test.js +152 -152
  63. package/_site/_test/hook-trigger-test.js +85 -85
  64. package/_site/_test/import-preflight-api-test.js +234 -233
  65. package/_site/_test/index-writer-concurrency-test.js +135 -135
  66. package/_site/_test/integration-adapters-test.js +171 -171
  67. package/_site/_test/integration-surface-coverage-test.js +164 -164
  68. package/_site/_test/knowledge-language-control-test.js +170 -170
  69. package/_site/_test/knowledge-promotion-recovery-test.js +260 -260
  70. package/_site/_test/knowledge-query-test.js +54 -54
  71. package/_site/_test/knowledge-retrieval-service-test.js +77 -77
  72. package/_site/_test/knowledge-storage-startup-test.js +52 -52
  73. package/_site/_test/knowledge-store-logs-supervision-test.js +89 -89
  74. package/_site/_test/logging-api-test.js +89 -89
  75. package/_site/_test/logging-sse-no-gap-test.js +88 -88
  76. package/_site/_test/logging-ui-test.js +106 -104
  77. package/_site/_test/markdown-delta-overlay-test.js +85 -85
  78. package/_site/_test/markdown-maintenance-api-test.js +75 -75
  79. package/_site/_test/mcp-server-test.js +149 -149
  80. package/_site/_test/module-artifact-integrity-test.js +27 -0
  81. package/_site/_test/module-boundary-test.js +30 -0
  82. package/_site/_test/module-bridge-eventbridge-test.js +7 -0
  83. package/_site/_test/module-model-configuration-test.js +44 -0
  84. package/_site/_test/module-process-lifecycle-test.js +24 -0
  85. package/_site/_test/module-stream-proxy-test.js +34 -0
  86. package/_site/_test/non-release-ci-test.js +34 -34
  87. package/_site/_test/offline-boundary-isolation-test.js +32 -32
  88. package/_site/_test/packaged-ui-smoke-test.js +11 -9
  89. package/_site/_test/path-consistency-test.js +151 -151
  90. package/_site/_test/pending-sweep-test.js +9 -9
  91. package/_site/_test/post-commit-automation-test.js +87 -87
  92. package/_site/_test/product-diagnostics-ui-test.js +75 -0
  93. package/_site/_test/product-import-ui-test.js +92 -0
  94. package/_site/_test/project-delete-recovery-test.js +64 -64
  95. package/_site/_test/project-goal-editor-test.js +144 -144
  96. package/_site/_test/project-lifecycle-transaction-test.js +106 -106
  97. package/_site/_test/prompt-settings-test.js +115 -115
  98. package/_site/_test/protected-architecture-gate-test.js +122 -122
  99. package/_site/_test/refactor-characterization-test.js +36 -36
  100. package/_site/_test/release-version-sync-test.js +1 -1
  101. package/_site/_test/requirement-recorder-test.js +173 -173
  102. package/_site/_test/run-all-tests.js +159 -156
  103. package/_site/_test/shared-contracts-test.js +58 -58
  104. package/_site/_test/startup-analysis-disabled-test.js +10 -10
  105. package/_site/_test/storage-foundation-test.js +78 -78
  106. package/_site/_test/structured-logger-test.js +101 -101
  107. package/_site/_test/tracking-start-test.js +109 -108
  108. package/_site/_test/workbench-permission-test.js +117 -117
  109. package/_site/_test/workspace-ui-contract-test.js +28 -43
  110. package/_site/lib/ai-profile-resolver.js +78 -78
  111. package/_site/lib/ai-workspace.js +101 -101
  112. package/_site/lib/automation-config.js +140 -140
  113. package/_site/lib/bridge-adapter.js +1 -0
  114. package/_site/lib/bridge-consumer-service.js +402 -402
  115. package/_site/lib/claude-cli-runner.js +1510 -1510
  116. package/_site/lib/commit-conversation-binder.js +234 -234
  117. package/_site/lib/commit-processing-ledger.js +27 -27
  118. package/_site/lib/commit-prompt.js +202 -202
  119. package/_site/lib/commit-reconciler.js +406 -406
  120. package/_site/lib/contracts.js +284 -279
  121. package/_site/lib/conversation-query-service.js +144 -144
  122. package/_site/lib/conversation-store.js +385 -385
  123. package/_site/lib/data-dir.js +6 -74
  124. package/_site/lib/engine-connection.js +67 -0
  125. package/_site/lib/evidence-bundle.js +228 -228
  126. package/_site/lib/folder-picker-output.js +21 -21
  127. package/_site/lib/git-runner.js +62 -62
  128. package/_site/lib/github-team-store.js +1172 -1172
  129. package/_site/lib/hook-manager.js +203 -202
  130. package/_site/lib/index-service.js +173 -173
  131. package/_site/lib/integration-installer.js +908 -907
  132. package/_site/lib/kb-framework.js +176 -176
  133. package/_site/lib/kb-validator.js +124 -124
  134. package/_site/lib/knowledge-promotion.js +435 -435
  135. package/_site/lib/knowledge-retrieval-service.js +401 -401
  136. package/_site/lib/knowledge-tool-runtime.js +359 -359
  137. package/_site/lib/llm-client.js +161 -161
  138. package/_site/lib/markdown-knowledge-indexer.js +230 -230
  139. package/_site/lib/module-bridge.js +191 -36
  140. package/_site/lib/post-commit-automation.js +87 -87
  141. package/_site/lib/product-data.js +24 -0
  142. package/_site/lib/project-lifecycle-service.js +535 -497
  143. package/_site/lib/project-store.js +268 -262
  144. package/_site/lib/requirement-recorder.js +278 -278
  145. package/_site/lib/runtime-endpoint.js +155 -155
  146. package/_site/lib/scanner.js +298 -298
  147. package/_site/lib/server-app.js +1579 -1520
  148. package/_site/lib/settings-store.js +133 -113
  149. package/_site/lib/storage-layout.js +162 -162
  150. package/_site/lib/structured-logger.js +574 -574
  151. package/_site/scripts/folder-picker.ps1 +156 -156
  152. package/_site/scripts/hook-trigger.js +157 -156
  153. package/_site/scripts/install-module-candidates.js +69 -0
  154. package/_site/scripts/pack-module-candidates.js +72 -0
  155. package/_site/scripts/sync-release-version.js +2 -2
  156. package/_site/scripts/vendor-modules.js +47 -0
  157. package/_site/scripts/verify-module-runtime.js +45 -0
  158. package/_site/scripts/verify-product-runtime.js +34 -0
  159. package/bin/project-knowledge-mcp.js +194 -194
  160. package/docs/README.zh-CN.md +42 -29
  161. package/docs/fresh-v5-start.md +28 -0
  162. package/docs/project-registry-schema.md +22 -22
  163. package/docs/testing-strategy.md +33 -33
  164. package/module-runtime-manifest.json +220 -0
  165. package/package.json +14 -9
  166. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  167. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  168. package/plugins/project-knowledge/.mcp.json +1 -1
  169. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  170. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  171. package/templates/project-readme.md +34 -34
  172. package/ui/favicon.svg +38 -38
  173. package/ui/index.html +52 -149
  174. package/ui/product.css +9 -0
  175. package/ui/product.js +412 -0
  176. package/vendor-manifest.json +45 -0
  177. package/_site/_test/data-dir-migration-test.js +0 -77
  178. package/_site/_test/import-ui-flow-test.js +0 -171
  179. package/_site/_test/knowledge-migration-test.js +0 -75
  180. package/_site/_test/legacy-forward-compat-test.js +0 -257
  181. package/_site/_test/legacy-project-upgrade-e2e-test.js +0 -363
  182. package/_site/_test/p0-data-migration-characterization-test.js +0 -37
  183. package/_site/_test/p0-e2e-gate-test.js +0 -347
  184. package/_site/_test/project-control-panel-task14-test.js +0 -63
  185. package/_site/_test/project-layout-v2-migration-test.js +0 -127
  186. package/_site/_test/server-runtime-migration-safety-test.js +0 -27
  187. package/_site/_test/task15-20-ui-flow-test.js +0 -148
  188. package/_site/_test/ui-i18n-toggle-test.js +0 -114
  189. package/_site/_test/ui-smoke-test.js +0 -73
  190. package/_site/_test/v4122-upgrade-data-contract-test.js +0 -56
  191. package/_site/lib/data-state-classifier.js +0 -40
  192. package/_site/lib/legacy-data-manifest.js +0 -26
  193. package/_site/lib/migration-service.js +0 -442
  194. package/ui/app.css +0 -58
  195. package/ui/app.js +0 -607
  196. package/ui/i18n.js +0 -146
@@ -1,91 +1,91 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
- const { spawnServer } = require('./helpers/spawn-server');
6
- const { makeRepo } = require('./fixtures/make-git-repos');
7
-
8
- const ROOT = path.resolve(__dirname, '..', '..');
9
- const PORT = 7791;
10
- const BASE = 'http://127.0.0.1:' + PORT;
11
-
12
- async function json(method, pathname, body) {
13
- const response = await fetch(BASE + pathname, {
14
- method,
15
- headers: body === undefined ? undefined : { 'content-type': 'application/json' },
16
- body: body === undefined ? undefined : JSON.stringify(body),
17
- });
18
- return { response, body: await response.json() };
19
- }
20
-
21
- async function waitForServer() {
22
- for (let attempt = 0; attempt < 150; attempt += 1) {
23
- try { if ((await fetch(BASE + '/api/health')).ok) return; } catch {}
24
- await new Promise(resolve => setTimeout(resolve, 100));
25
- }
26
- throw new Error('v2 baseline server did not start');
27
- }
28
-
29
- (async () => {
30
- const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-baseline-v2-'));
31
- const knowledgeRoot = path.join(dataDir, 'knowledge-root');
32
- const repo = makeRepo({ kind: 'one-commit' });
33
- const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'baseline-v2', stdio: 'ignore' });
34
- try {
35
- await waitForServer();
36
- let result = await json('GET', '/api/state');
37
- assert.strictEqual(result.response.status, 200);
38
- assert.strictEqual(result.body.schema, 'server-state/v2');
39
- assert.strictEqual(result.body.settings.schema, 'settings/v2');
40
- assert.deepStrictEqual(result.body.projects, []);
41
-
42
- result = await json('PATCH', '/api/settings', { knowledge: { rootPath: knowledgeRoot } });
43
- assert.strictEqual(result.response.status, 200);
44
-
45
- result = await json('POST', '/api/projects/import', { localPath: repo.path, displayName: 'Baseline v2' });
46
- assert.strictEqual(result.response.status, 201, JSON.stringify(result.body));
47
- const projectId = result.body.projectId;
48
- const project = result.body.project;
49
- assert.strictEqual(project.config.schema, 'project-config/v2');
50
- assert.strictEqual(project.state.schema, 'project-state/v2');
51
- assert.strictEqual(project.config.projectId, projectId);
52
- assert.strictEqual(project.state.trackingStartCommit, repo.headCommit);
53
- assert.strictEqual(project.state.lastAnalyzedCommit, null);
54
- assert.strictEqual(project.state.analysis.status, 'idle');
55
- assert.strictEqual(project.state.hook.managedVersion, 2);
56
- assert(path.isAbsolute(project.config.repoPath) && path.isAbsolute(project.config.knowledgePath));
57
- assert(project.config.knowledgePath.startsWith(path.resolve(knowledgeRoot)));
58
- assert.deepStrictEqual(fs.readdirSync(project.config.knowledgePath), []);
59
-
60
- const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
61
- assert.strictEqual(registry.schema, 'project-registry/v2');
62
- assert.deepStrictEqual(registry.projectOrder, [projectId]);
63
- assert.deepStrictEqual(Object.keys(registry.projects), [projectId]);
64
- assert(!Object.prototype.hasOwnProperty.call(registry.projects[projectId], 'lastAnalyzedCommit'));
65
-
66
- result = await json('GET', '/api/projects');
67
- assert.strictEqual(result.response.status, 200);
68
- assert.strictEqual(result.body.projects.length, 1);
69
- assert.strictEqual(result.body.projects[0].projectId, projectId);
70
-
71
- const htmlResponse = await fetch(BASE + '/');
72
- const html = await htmlResponse.text();
73
- assert.strictEqual(htmlResponse.status, 200);
74
- assert.strictEqual((html.match(/class="shell"/g) || []).length, 1);
75
- assert.strictEqual((html.match(/id="settings-logs"/g) || []).length, 1);
76
- assert(!html.includes('vue.global.prod.js'));
77
-
78
- result = await json('DELETE', '/api/projects/' + encodeURIComponent(projectId), { deleteKnowledge: false });
79
- assert.strictEqual(result.response.status, 200);
80
- assert.strictEqual(fs.existsSync(project.config.knowledgePath), true, 'default delete must preserve external knowledge');
81
- assert.strictEqual(fs.existsSync(path.join(repo.path, '.git', 'hooks', 'post-commit')), false);
82
-
83
- console.log('baseline schema test PASS');
84
- } finally {
85
- await spawned.cleanup();
86
- repo.cleanup();
87
- }
88
- })().catch(error => {
89
- console.error(error.stack || error.message);
90
- process.exitCode = 1;
91
- });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+ const { spawnServer } = require('./helpers/spawn-server');
6
+ const { makeRepo } = require('./fixtures/make-git-repos');
7
+
8
+ const ROOT = path.resolve(__dirname, '..', '..');
9
+ const PORT = 7791;
10
+ const BASE = 'http://127.0.0.1:' + PORT;
11
+
12
+ async function json(method, pathname, body) {
13
+ const response = await fetch(BASE + pathname, {
14
+ method,
15
+ headers: body === undefined ? undefined : { 'content-type': 'application/json' },
16
+ body: body === undefined ? undefined : JSON.stringify(body),
17
+ });
18
+ return { response, body: await response.json() };
19
+ }
20
+
21
+ async function waitForServer() {
22
+ for (let attempt = 0; attempt < 150; attempt += 1) {
23
+ try { if ((await fetch(BASE + '/api/health')).ok) return; } catch {}
24
+ await new Promise(resolve => setTimeout(resolve, 100));
25
+ }
26
+ throw new Error('v2 baseline server did not start');
27
+ }
28
+
29
+ (async () => {
30
+ const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-baseline-v2-'));
31
+ const knowledgeRoot = path.join(dataDir, 'knowledge-root');
32
+ const repo = makeRepo({ kind: 'one-commit' });
33
+ const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'baseline-v2', stdio: 'ignore' });
34
+ try {
35
+ await waitForServer();
36
+ let result = await json('GET', '/api/state');
37
+ assert.strictEqual(result.response.status, 200);
38
+ assert.strictEqual(result.body.schema, 'server-state/v2');
39
+ assert.strictEqual(result.body.settings.schema, 'settings/v2');
40
+ assert.deepStrictEqual(result.body.projects, []);
41
+
42
+ result = await json('PATCH', '/api/settings', { knowledge: { rootPath: knowledgeRoot } });
43
+ assert.strictEqual(result.response.status, 200);
44
+
45
+ result = await json('POST', '/api/projects/import', { localPath: repo.path, displayName: 'Baseline v2' });
46
+ assert.strictEqual(result.response.status, 201, JSON.stringify(result.body));
47
+ const projectId = result.body.projectId;
48
+ const project = result.body.project;
49
+ assert.strictEqual(project.config.schema, 'project-config/v2');
50
+ assert.strictEqual(project.state.schema, 'project-state/v2');
51
+ assert.strictEqual(project.config.projectId, projectId);
52
+ assert.strictEqual(project.state.trackingStartCommit, repo.headCommit);
53
+ assert.strictEqual(project.state.lastAnalyzedCommit, null);
54
+ assert.strictEqual(project.state.analysis.status, 'idle');
55
+ assert.strictEqual(project.state.hook.managedVersion, 2);
56
+ assert(path.isAbsolute(project.config.repoPath) && path.isAbsolute(project.config.knowledgePath));
57
+ assert(project.config.knowledgePath.startsWith(path.resolve(knowledgeRoot)));
58
+ assert.deepStrictEqual(fs.readdirSync(project.config.knowledgePath), []);
59
+
60
+ const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
61
+ assert.strictEqual(registry.schema, 'project-registry/v2');
62
+ assert.deepStrictEqual(registry.projectOrder, [projectId]);
63
+ assert.deepStrictEqual(Object.keys(registry.projects), [projectId]);
64
+ assert(!Object.prototype.hasOwnProperty.call(registry.projects[projectId], 'lastAnalyzedCommit'));
65
+
66
+ result = await json('GET', '/api/projects');
67
+ assert.strictEqual(result.response.status, 200);
68
+ assert.strictEqual(result.body.projects.length, 1);
69
+ assert.strictEqual(result.body.projects[0].projectId, projectId);
70
+
71
+ const htmlResponse = await fetch(BASE + '/');
72
+ const html = await htmlResponse.text();
73
+ assert.strictEqual(htmlResponse.status, 200);
74
+ assert.strictEqual((html.match(/class="app"/g) || []).length, 1);
75
+ assert.strictEqual((html.match(/id="logsDialog"/g) || []).length, 1);
76
+ assert(!html.includes('vue.global.prod.js'));
77
+
78
+ result = await json('DELETE', '/api/projects/' + encodeURIComponent(projectId), { deleteKnowledge: false });
79
+ assert.strictEqual(result.response.status, 200);
80
+ assert.strictEqual(fs.existsSync(project.config.knowledgePath), true, 'default delete must preserve external knowledge');
81
+ assert.strictEqual(fs.existsSync(path.join(repo.path, '.git', 'hooks', 'post-commit')), false);
82
+
83
+ console.log('baseline schema test PASS');
84
+ } finally {
85
+ await spawned.cleanup();
86
+ repo.cleanup();
87
+ }
88
+ })().catch(error => {
89
+ console.error(error.stack || error.message);
90
+ process.exitCode = 1;
91
+ });
@@ -1,92 +1,92 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
-
6
- const ROOT = path.resolve(__dirname, '..', '..');
7
- const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-claude-runner-v2-'));
8
- process.env.KB_DATA_DIR = path.join(temp, 'data');
9
- require('../lib/data-dir')._resetCache();
10
- const runner = require('../lib/claude-cli-runner');
11
-
12
- (async () => {
13
- const projectPath = path.join(temp, 'repo');
14
- const kbPath = path.join(temp, 'knowledge');
15
- fs.mkdirSync(projectPath, { recursive: true });
16
- fs.mkdirSync(kbPath, { recursive: true });
17
- const slug = 'chat-runner-v2';
18
-
19
- try {
20
- const started = runner.startSession({
21
- slug,
22
- projectPath,
23
- kbPath,
24
- promptKey: 'initial-analysis',
25
- aiProfile: { id: 'test-profile', implementation: 'claude-code-agent', mainModel: 'test-model' },
26
- vars: { SLUG: slug, PROJECT_PATH: projectPath, KNOWLEDGE_LANGUAGE: 'zh-CN' },
27
- });
28
- assert(started.sessionId);
29
-
30
- const source = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'claude-cli-runner.js'), 'utf8');
31
- assert(/normalizePermissionMode\(opts\.permissionMode \|\| session\.permissionMode \|\| 'default'\)/.test(source));
32
- assert(/type === 'claude\/usage' && ev\.usage/.test(source));
33
- assert(/input_tokens/.test(source) && /output_tokens/.test(source) && /cache_creation_input_tokens/.test(source));
34
- assert(/spawnClaude is no longer supported/.test(source));
35
- assert(/type:\s*'claude\/retry'/.test(source) && /maxSdkRetries\(\)/.test(source));
36
-
37
- const fresh = runner.getSessionTokenUsage(started.sessionId);
38
- assert.strictEqual(fresh.used, 0);
39
- assert.strictEqual(fresh.hasUsage, false);
40
- assert(fresh.total > 0);
41
-
42
- const liveSession = runner.getSession(started.sessionId);
43
- liveSession.contextWindow = 1048576;
44
- assert.strictEqual(runner.getSessionTokenUsage(started.sessionId).total, 1048576);
45
- liveSession.contextWindow = null;
46
- assert.strictEqual(runner.getSessionTokenUsage(started.sessionId).total, 200000);
47
-
48
- const overrides = runner.buildSdkOverridesFromProfile({});
49
- assert(overrides.systemPrompt && overrides.systemPrompt.preset === 'claude_code');
50
- const env = runner.buildClaudeEnvFromProfile({
51
- apiKey: 'sk-plaintext',
52
- baseUrl: 'https://example.test/anthropic',
53
- mainModel: 'main',
54
- thinkingModel: 'think',
55
- haikuModel: 'hk',
56
- sonnetModel: 'sn',
57
- opusModel: 'op',
58
- timeoutMs: 1234,
59
- });
60
- assert.strictEqual(env.ANTHROPIC_AUTH_TOKEN, 'sk-plaintext');
61
- assert.strictEqual(env.ANTHROPIC_MODEL, 'main');
62
- assert.strictEqual(env.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'hk');
63
- assert.strictEqual(env.ANTHROPIC_DEFAULT_SONNET_MODEL, 'sn');
64
- assert.strictEqual(env.ANTHROPIC_DEFAULT_OPUS_MODEL, 'op');
65
- assert.strictEqual(env.ANTHROPIC_DEFAULT_THINKING_MODEL, 'think');
66
- assert.strictEqual(env.API_TIMEOUT_MS, '1234');
67
- assert.strictEqual(env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, '1');
68
- assert(runner.isTransientClaudeError(new Error('429 too many requests')));
69
- assert(!runner.isTransientClaudeError(new Error('model does not exist')));
70
-
71
- const server = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'server-app.js'), 'utf8');
72
- assert(server.includes('body.permissionMode'));
73
-
74
- const html = fs.readFileSync(path.join(ROOT, 'ui', 'index.html'), 'utf8');
75
- const app = fs.readFileSync(path.join(ROOT, 'ui', 'app.js'), 'utf8');
76
- // T2: 内嵌终端取代旧 workbench 聊天面板 —— 壳经 kb:* 协议与会话/事件交互
77
- assert(html.includes('id="view-terminal"') && html.includes('id="fr-5760"'));
78
- assert(html.includes('id="view-search"') && html.includes('id="fr-8787"'));
79
- assert(app.includes("'kb:select-project'") && app.includes("'kb:list-sessions'") && app.includes("'kb:open-session'"));
80
- assert(app.includes("'kb:sidebar'"), 'embed protocol wiring must cover fold');
81
- // 会话生命周期(archive/restore)只属于 terminal 模块,壳保持只读投影
82
- assert(!app.includes("'kb:archive-session'") && !app.includes("'kb:restore-session'"), 'session lifecycle wiring must stay terminal-module-only');
83
-
84
- runner.deleteSession(started.sessionId);
85
- console.log('chat runner contract test PASS');
86
- } finally {
87
- try { fs.rmSync(temp, { recursive: true, force: true }); } catch {}
88
- }
89
- })().catch(error => {
90
- console.error(error.stack || error.message);
91
- process.exitCode = 1;
92
- });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+
6
+ const ROOT = path.resolve(__dirname, '..', '..');
7
+ const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-claude-runner-v2-'));
8
+ process.env.KB_DATA_DIR = path.join(temp, 'data');
9
+ require('../lib/data-dir')._resetCache();
10
+ const runner = require('../lib/claude-cli-runner');
11
+
12
+ (async () => {
13
+ const projectPath = path.join(temp, 'repo');
14
+ const kbPath = path.join(temp, 'knowledge');
15
+ fs.mkdirSync(projectPath, { recursive: true });
16
+ fs.mkdirSync(kbPath, { recursive: true });
17
+ const slug = 'chat-runner-v2';
18
+
19
+ try {
20
+ const started = runner.startSession({
21
+ slug,
22
+ projectPath,
23
+ kbPath,
24
+ promptKey: 'initial-analysis',
25
+ aiProfile: { id: 'test-profile', implementation: 'claude-code-agent', mainModel: 'test-model' },
26
+ vars: { SLUG: slug, PROJECT_PATH: projectPath, KNOWLEDGE_LANGUAGE: 'zh-CN' },
27
+ });
28
+ assert(started.sessionId);
29
+
30
+ const source = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'claude-cli-runner.js'), 'utf8');
31
+ assert(/normalizePermissionMode\(opts\.permissionMode \|\| session\.permissionMode \|\| 'default'\)/.test(source));
32
+ assert(/type === 'claude\/usage' && ev\.usage/.test(source));
33
+ assert(/input_tokens/.test(source) && /output_tokens/.test(source) && /cache_creation_input_tokens/.test(source));
34
+ assert(/spawnClaude is no longer supported/.test(source));
35
+ assert(/type:\s*'claude\/retry'/.test(source) && /maxSdkRetries\(\)/.test(source));
36
+
37
+ const fresh = runner.getSessionTokenUsage(started.sessionId);
38
+ assert.strictEqual(fresh.used, 0);
39
+ assert.strictEqual(fresh.hasUsage, false);
40
+ assert(fresh.total > 0);
41
+
42
+ const liveSession = runner.getSession(started.sessionId);
43
+ liveSession.contextWindow = 1048576;
44
+ assert.strictEqual(runner.getSessionTokenUsage(started.sessionId).total, 1048576);
45
+ liveSession.contextWindow = null;
46
+ assert.strictEqual(runner.getSessionTokenUsage(started.sessionId).total, 200000);
47
+
48
+ const overrides = runner.buildSdkOverridesFromProfile({});
49
+ assert(overrides.systemPrompt && overrides.systemPrompt.preset === 'claude_code');
50
+ const env = runner.buildClaudeEnvFromProfile({
51
+ apiKey: 'sk-plaintext',
52
+ baseUrl: 'https://example.test/anthropic',
53
+ mainModel: 'main',
54
+ thinkingModel: 'think',
55
+ haikuModel: 'hk',
56
+ sonnetModel: 'sn',
57
+ opusModel: 'op',
58
+ timeoutMs: 1234,
59
+ });
60
+ assert.strictEqual(env.ANTHROPIC_AUTH_TOKEN, 'sk-plaintext');
61
+ assert.strictEqual(env.ANTHROPIC_MODEL, 'main');
62
+ assert.strictEqual(env.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'hk');
63
+ assert.strictEqual(env.ANTHROPIC_DEFAULT_SONNET_MODEL, 'sn');
64
+ assert.strictEqual(env.ANTHROPIC_DEFAULT_OPUS_MODEL, 'op');
65
+ assert.strictEqual(env.ANTHROPIC_DEFAULT_THINKING_MODEL, 'think');
66
+ assert.strictEqual(env.API_TIMEOUT_MS, '1234');
67
+ assert.strictEqual(env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, '1');
68
+ assert(runner.isTransientClaudeError(new Error('429 too many requests')));
69
+ assert(!runner.isTransientClaudeError(new Error('model does not exist')));
70
+
71
+ const server = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'server-app.js'), 'utf8');
72
+ assert(server.includes('body.permissionMode'));
73
+
74
+ const html = fs.readFileSync(path.join(ROOT, 'ui', 'index.html'), 'utf8');
75
+ const app = fs.readFileSync(path.join(ROOT, 'ui', 'product.js'), 'utf8');
76
+ // T2: 内嵌终端取代旧 workbench 聊天面板 —— 壳经 kb:* 协议与会话/事件交互
77
+ assert(html.includes('id="view-work"') && html.includes('id="workFrame"'));
78
+ assert(html.includes('id="view-search"') && html.includes('id="vectorFrame"'));
79
+ assert(app.includes("'kb:select-project'") && app.includes("'kb:knowledge'") && app.includes('initializeFrame'));
80
+ assert(app.includes("'kb:sidebar'"), 'embed protocol wiring must cover fold');
81
+ // 会话生命周期(archive/restore)只属于 terminal 模块,壳保持只读投影
82
+ assert(!app.includes("'kb:archive-session'") && !app.includes("'kb:restore-session'"), 'session lifecycle wiring must stay terminal-module-only');
83
+
84
+ runner.deleteSession(started.sessionId);
85
+ console.log('chat runner contract test PASS');
86
+ } finally {
87
+ try { fs.rmSync(temp, { recursive: true, force: true }); } catch {}
88
+ }
89
+ })().catch(error => {
90
+ console.error(error.stack || error.message);
91
+ process.exitCode = 1;
92
+ });
@@ -1,56 +1,56 @@
1
- const assert = require('assert');
1
+ const assert = require('assert');
2
2
  const fs = require('fs');
3
3
  const os = require('os');
4
4
  const path = require('path');
5
5
  const { spawnSync } = require('child_process');
6
6
  const runner = require('../lib/claude-cli-runner');
7
-
8
- const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'claude-discovery-test-'));
9
-
10
- (async () => {
11
- try {
12
- const nativeExe = path.join(temp, 'claude.exe');
13
- const npmRoot = path.join(temp, 'npm');
14
- const extensionlessNpmShim = path.join(npmRoot, 'claude');
15
- const npmShim = path.join(npmRoot, 'claude.cmd');
16
- const npmCli = path.join(npmRoot, 'node_modules', '@anthropic-ai', 'claude-code', 'cli.js');
17
- const npmExe = path.join(npmRoot, 'node_modules', '@anthropic-ai', 'claude-code', 'bin', 'claude.exe');
18
- fs.mkdirSync(path.dirname(npmExe), { recursive: true });
19
- fs.writeFileSync(nativeExe, 'test');
20
- fs.writeFileSync(extensionlessNpmShim, '#!/bin/sh');
21
- fs.writeFileSync(npmShim, '@echo off');
22
- fs.writeFileSync(npmCli, '#!/usr/bin/env node');
23
- fs.writeFileSync(npmExe, 'native executable');
24
-
25
- const fromEnv = await runner.findClaudeExecutableForSdk({
26
- platform: 'win32',
27
- env: { CLAUDE_CODE_EXECPATH: nativeExe },
28
- runCommand: () => ({ status: 1, stdout: '' }),
29
- });
30
- assert.equal(fromEnv.cmd, nativeExe);
31
- assert.equal(fromEnv.source, 'CLAUDE_CODE_EXECPATH');
32
-
33
- const fromPath = await runner.findClaudeExecutableForSdk({
34
- platform: 'win32',
35
- env: {},
36
- runCommand: () => ({ status: 0, stdout: `${nativeExe}\r\n` }),
37
- });
38
- assert.equal(fromPath.cmd, nativeExe);
39
- assert.equal(fromPath.source, 'PATH');
40
-
41
- const fromExtensionlessNpmShim = await runner.findClaudeExecutableForSdk({
42
- platform: 'win32',
43
- env: {},
44
- runCommand: () => ({ status: 0, stdout: `${extensionlessNpmShim}\r\n${npmShim}\r\n` }),
45
- });
46
- assert.equal(fromExtensionlessNpmShim.cmd, npmExe,
47
- 'extensionless npm shell shim should resolve to the package native executable');
48
-
7
+
8
+ const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'claude-discovery-test-'));
9
+
10
+ (async () => {
11
+ try {
12
+ const nativeExe = path.join(temp, 'claude.exe');
13
+ const npmRoot = path.join(temp, 'npm');
14
+ const extensionlessNpmShim = path.join(npmRoot, 'claude');
15
+ const npmShim = path.join(npmRoot, 'claude.cmd');
16
+ const npmCli = path.join(npmRoot, 'node_modules', '@anthropic-ai', 'claude-code', 'cli.js');
17
+ const npmExe = path.join(npmRoot, 'node_modules', '@anthropic-ai', 'claude-code', 'bin', 'claude.exe');
18
+ fs.mkdirSync(path.dirname(npmExe), { recursive: true });
19
+ fs.writeFileSync(nativeExe, 'test');
20
+ fs.writeFileSync(extensionlessNpmShim, '#!/bin/sh');
21
+ fs.writeFileSync(npmShim, '@echo off');
22
+ fs.writeFileSync(npmCli, '#!/usr/bin/env node');
23
+ fs.writeFileSync(npmExe, 'native executable');
24
+
25
+ const fromEnv = await runner.findClaudeExecutableForSdk({
26
+ platform: 'win32',
27
+ env: { CLAUDE_CODE_EXECPATH: nativeExe },
28
+ runCommand: () => ({ status: 1, stdout: '' }),
29
+ });
30
+ assert.equal(fromEnv.cmd, nativeExe);
31
+ assert.equal(fromEnv.source, 'CLAUDE_CODE_EXECPATH');
32
+
33
+ const fromPath = await runner.findClaudeExecutableForSdk({
34
+ platform: 'win32',
35
+ env: {},
36
+ runCommand: () => ({ status: 0, stdout: `${nativeExe}\r\n` }),
37
+ });
38
+ assert.equal(fromPath.cmd, nativeExe);
39
+ assert.equal(fromPath.source, 'PATH');
40
+
41
+ const fromExtensionlessNpmShim = await runner.findClaudeExecutableForSdk({
42
+ platform: 'win32',
43
+ env: {},
44
+ runCommand: () => ({ status: 0, stdout: `${extensionlessNpmShim}\r\n${npmShim}\r\n` }),
45
+ });
46
+ assert.equal(fromExtensionlessNpmShim.cmd, npmExe,
47
+ 'extensionless npm shell shim should resolve to the package native executable');
48
+
49
49
  const fromCmdNpmShim = await runner.findClaudeExecutableForSdk({
50
- platform: 'win32',
51
- env: { CLAUDE_CODE_EXECPATH: npmShim },
52
- runCommand: () => ({ status: 1, stdout: '' }),
53
- });
50
+ platform: 'win32',
51
+ env: { CLAUDE_CODE_EXECPATH: npmShim },
52
+ runCommand: () => ({ status: 1, stdout: '' }),
53
+ });
54
54
  assert.equal(fromCmdNpmShim.cmd, npmExe,
55
55
  'configured npm .cmd shim should resolve to the package native executable');
56
56
  assert.equal(fromCmdNpmShim.runtimeExecutable, null,
@@ -73,18 +73,18 @@ const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'claude-discovery-test-'));
73
73
  });
74
74
  assert.equal(scriptLaunch.status, 0,
75
75
  `resolved Claude cli.js should launch through the selected runtime: ${scriptLaunch.stderr}`);
76
-
77
- const missing = await runner.findClaudeExecutableForSdk({
78
- platform: 'win32',
79
- env: {},
80
- exists: () => false,
81
- runCommand: () => ({ status: 1, stdout: '' }),
82
- });
83
- assert.equal(missing.cmd, null);
84
- assert.match(missing.reason, /Claude Code was not found/);
85
-
86
- console.log('claude-executable-discovery-test: PASS');
87
- } finally {
88
- fs.rmSync(temp, { recursive: true, force: true });
89
- }
90
- })();
76
+
77
+ const missing = await runner.findClaudeExecutableForSdk({
78
+ platform: 'win32',
79
+ env: {},
80
+ exists: () => false,
81
+ runCommand: () => ({ status: 1, stdout: '' }),
82
+ });
83
+ assert.equal(missing.cmd, null);
84
+ assert.match(missing.reason, /Claude Code was not found/);
85
+
86
+ console.log('claude-executable-discovery-test: PASS');
87
+ } finally {
88
+ fs.rmSync(temp, { recursive: true, force: true });
89
+ }
90
+ })();