@sanqianx/project-knowledge 4.6.1 → 4.8.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 (198) hide show
  1. package/.agents/plugins/marketplace.json +17 -17
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +817 -780
  4. package/README.md +48 -36
  5. package/_modules/knowledge-engine/README.md +88 -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 +255 -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/migration.js +88 -0
  15. package/_modules/knowledge-engine/src/retrieval.js +116 -0
  16. package/_modules/knowledge-engine/src/runtime/README.md +7 -0
  17. package/_modules/knowledge-engine/src/runtime/atomic-file.js +204 -0
  18. package/_modules/knowledge-engine/src/runtime/automation-config.js +140 -0
  19. package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +249 -0
  20. package/_modules/knowledge-engine/src/runtime/commit-processing-ledger.js +26 -0
  21. package/_modules/knowledge-engine/src/runtime/commit-prompt.js +202 -0
  22. package/_modules/knowledge-engine/src/runtime/commit-reconciler.js +432 -0
  23. package/_modules/knowledge-engine/src/runtime/content-hash.js +4 -0
  24. package/_modules/knowledge-engine/src/runtime/contracts.js +279 -0
  25. package/_modules/knowledge-engine/src/runtime/conversation-exclusions.js +204 -0
  26. package/_modules/knowledge-engine/src/runtime/conversation-store.js +387 -0
  27. package/_modules/knowledge-engine/src/runtime/evidence-bundle.js +228 -0
  28. package/_modules/knowledge-engine/src/runtime/git-runner.js +62 -0
  29. package/_modules/knowledge-engine/src/runtime/knowledge-promotion.js +444 -0
  30. package/_modules/knowledge-engine/src/runtime/knowledge-retrieval-service.js +402 -0
  31. package/_modules/knowledge-engine/src/runtime/layout.js +44 -0
  32. package/_modules/knowledge-engine/src/runtime/markdown-knowledge-indexer.js +230 -0
  33. package/_modules/knowledge-engine/src/runtime/scanner.js +298 -0
  34. package/_modules/knowledge-engine/src/server.js +155 -0
  35. package/_modules/knowledge-engine/src/store.js +239 -0
  36. package/_modules/knowledge-engine/ui/app.css +172 -0
  37. package/_modules/knowledge-engine/ui/app.js +297 -0
  38. package/_modules/knowledge-engine/ui/index.html +95 -0
  39. package/_site/README.md +30 -30
  40. package/_site/_test/ai-profile-resolver-test.js +137 -137
  41. package/_site/_test/automation-queue-test.js +14 -14
  42. package/_site/_test/automation-ui-test.js +40 -40
  43. package/_site/_test/background-task-registry-test.js +43 -43
  44. package/_site/_test/baseline-schema-test.js +91 -91
  45. package/_site/_test/bridge-adapter-test.js +1 -1
  46. package/_site/_test/bridge-consumer-service-test.js +1 -1
  47. package/_site/_test/chat-claudecodeui-match-test.js +92 -92
  48. package/_site/_test/claude-executable-discovery-test.js +62 -62
  49. package/_site/_test/claude-workbench-test.js +170 -170
  50. package/_site/_test/client-capture-restart-e2e-test.js +4 -4
  51. package/_site/_test/codex-conversation-projection-test.js +2 -1
  52. package/_site/_test/commit-boundary-freeze-test.js +1 -1
  53. package/_site/_test/commit-conversation-binding-test.js +95 -95
  54. package/_site/_test/commit-evidence-test.js +110 -110
  55. package/_site/_test/conversation-api-test.js +109 -109
  56. package/_site/_test/conversation-store-test.js +136 -136
  57. package/_site/_test/cross-repo-isolation-e2e-test.js +2 -2
  58. package/_site/_test/data-dir-migration-test.js +57 -57
  59. package/_site/_test/desktop-browser-compat-test.js +28 -28
  60. package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
  61. package/_site/_test/explicit-commit-processor-test.js +37 -37
  62. package/_site/_test/fixtures/make-git-repos.js +12 -1
  63. package/_site/_test/folder-picker-output-test.js +19 -19
  64. package/_site/_test/full-integration-e2e-test.js +165 -165
  65. package/_site/_test/git-validation-test.js +2 -2
  66. package/_site/_test/hook-runtime-endpoint-test.js +88 -88
  67. package/_site/_test/hook-status-repair-api-test.js +152 -152
  68. package/_site/_test/hook-trigger-test.js +85 -85
  69. package/_site/_test/import-preflight-api-test.js +234 -233
  70. package/_site/_test/index-writer-concurrency-test.js +135 -135
  71. package/_site/_test/integration-adapters-test.js +171 -171
  72. package/_site/_test/integration-capture-setup-test.js +1 -1
  73. package/_site/_test/integration-surface-coverage-test.js +164 -164
  74. package/_site/_test/knowledge-language-control-test.js +170 -170
  75. package/_site/_test/knowledge-promotion-recovery-test.js +260 -260
  76. package/_site/_test/knowledge-query-test.js +54 -54
  77. package/_site/_test/knowledge-retrieval-service-test.js +77 -77
  78. package/_site/_test/knowledge-storage-startup-test.js +52 -52
  79. package/_site/_test/knowledge-store-logs-supervision-test.js +89 -89
  80. package/_site/_test/legacy-forward-compat-test.js +257 -257
  81. package/_site/_test/legacy-project-upgrade-e2e-test.js +363 -363
  82. package/_site/_test/logging-api-test.js +89 -89
  83. package/_site/_test/logging-sse-no-gap-test.js +88 -88
  84. package/_site/_test/logging-ui-test.js +106 -104
  85. package/_site/_test/markdown-delta-overlay-test.js +85 -85
  86. package/_site/_test/markdown-maintenance-api-test.js +75 -75
  87. package/_site/_test/mcp-server-test.js +149 -149
  88. package/_site/_test/module-artifact-integrity-test.js +27 -0
  89. package/_site/_test/module-boundary-test.js +30 -0
  90. package/_site/_test/module-bridge-eventbridge-test.js +7 -0
  91. package/_site/_test/module-model-configuration-test.js +43 -0
  92. package/_site/_test/module-process-lifecycle-test.js +24 -0
  93. package/_site/_test/module-stream-proxy-test.js +34 -0
  94. package/_site/_test/non-release-ci-test.js +34 -34
  95. package/_site/_test/offline-boundary-isolation-test.js +32 -32
  96. package/_site/_test/p0-data-migration-characterization-test.js +37 -37
  97. package/_site/_test/p0-e2e-gate-test.js +347 -347
  98. package/_site/_test/packaged-ui-smoke-test.js +19 -10
  99. package/_site/_test/path-consistency-test.js +151 -151
  100. package/_site/_test/pending-sweep-test.js +9 -9
  101. package/_site/_test/post-commit-automation-test.js +87 -87
  102. package/_site/_test/product-diagnostics-ui-test.js +75 -0
  103. package/_site/_test/product-import-ui-test.js +92 -0
  104. package/_site/_test/project-delete-recovery-test.js +64 -64
  105. package/_site/_test/project-goal-editor-test.js +144 -144
  106. package/_site/_test/project-layout-v2-migration-test.js +127 -127
  107. package/_site/_test/project-lifecycle-transaction-test.js +106 -106
  108. package/_site/_test/prompt-settings-test.js +115 -115
  109. package/_site/_test/protected-architecture-gate-test.js +122 -122
  110. package/_site/_test/refactor-characterization-test.js +36 -36
  111. package/_site/_test/release-version-sync-test.js +1 -1
  112. package/_site/_test/requirement-recorder-test.js +173 -173
  113. package/_site/_test/run-all-tests.js +159 -156
  114. package/_site/_test/server-runtime-migration-safety-test.js +27 -27
  115. package/_site/_test/shared-contracts-test.js +58 -58
  116. package/_site/_test/startup-analysis-disabled-test.js +10 -10
  117. package/_site/_test/storage-foundation-test.js +78 -78
  118. package/_site/_test/structured-logger-test.js +101 -101
  119. package/_site/_test/tracking-start-test.js +108 -108
  120. package/_site/_test/v4122-upgrade-data-contract-test.js +56 -56
  121. package/_site/_test/workbench-permission-test.js +117 -117
  122. package/_site/_test/workspace-ui-contract-test.js +28 -43
  123. package/_site/lib/ai-profile-resolver.js +78 -78
  124. package/_site/lib/ai-workspace.js +101 -101
  125. package/_site/lib/automation-config.js +140 -140
  126. package/_site/lib/bridge-adapter.js +5 -1
  127. package/_site/lib/bridge-consumer-service.js +402 -402
  128. package/_site/lib/claude-cli-runner.js +1510 -1510
  129. package/_site/lib/commit-conversation-binder.js +234 -234
  130. package/_site/lib/commit-processing-ledger.js +27 -27
  131. package/_site/lib/commit-prompt.js +202 -202
  132. package/_site/lib/commit-reconciler.js +406 -406
  133. package/_site/lib/contracts.js +284 -279
  134. package/_site/lib/conversation-query-service.js +144 -144
  135. package/_site/lib/conversation-store.js +385 -385
  136. package/_site/lib/data-dir.js +74 -74
  137. package/_site/lib/data-state-classifier.js +40 -40
  138. package/_site/lib/engine-cutover.js +97 -0
  139. package/_site/lib/evidence-bundle.js +228 -228
  140. package/_site/lib/folder-picker-output.js +21 -21
  141. package/_site/lib/git-runner.js +62 -62
  142. package/_site/lib/github-team-store.js +1172 -1172
  143. package/_site/lib/hook-manager.js +203 -202
  144. package/_site/lib/index-service.js +173 -173
  145. package/_site/lib/integration-installer.js +907 -907
  146. package/_site/lib/kb-framework.js +176 -176
  147. package/_site/lib/kb-validator.js +124 -124
  148. package/_site/lib/knowledge-promotion.js +435 -435
  149. package/_site/lib/knowledge-retrieval-service.js +401 -401
  150. package/_site/lib/knowledge-tool-runtime.js +359 -359
  151. package/_site/lib/legacy-data-manifest.js +26 -26
  152. package/_site/lib/llm-client.js +161 -161
  153. package/_site/lib/markdown-knowledge-indexer.js +230 -230
  154. package/_site/lib/migration-service.js +442 -442
  155. package/_site/lib/module-bridge.js +198 -33
  156. package/_site/lib/post-commit-automation.js +87 -87
  157. package/_site/lib/project-lifecycle-service.js +519 -497
  158. package/_site/lib/project-store.js +268 -262
  159. package/_site/lib/requirement-recorder.js +278 -278
  160. package/_site/lib/runtime-endpoint.js +155 -155
  161. package/_site/lib/scanner.js +298 -298
  162. package/_site/lib/server-app.js +1590 -1520
  163. package/_site/lib/settings-store.js +133 -113
  164. package/_site/lib/storage-layout.js +162 -162
  165. package/_site/lib/structured-logger.js +574 -574
  166. package/_site/scripts/folder-picker.ps1 +156 -156
  167. package/_site/scripts/hook-trigger.js +157 -156
  168. package/_site/scripts/install-module-candidates.js +69 -0
  169. package/_site/scripts/pack-module-candidates.js +72 -0
  170. package/_site/scripts/sync-release-version.js +2 -2
  171. package/_site/scripts/vendor-modules.js +47 -0
  172. package/_site/scripts/verify-module-runtime.js +45 -0
  173. package/_site/scripts/verify-product-runtime.js +34 -0
  174. package/bin/project-knowledge-mcp.js +194 -194
  175. package/docs/README.zh-CN.md +34 -25
  176. package/docs/project-registry-schema.md +22 -22
  177. package/docs/testing-strategy.md +33 -33
  178. package/module-runtime-manifest.json +220 -0
  179. package/package.json +13 -10
  180. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  181. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  182. package/plugins/project-knowledge/.mcp.json +1 -1
  183. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  184. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  185. package/templates/project-readme.md +34 -34
  186. package/ui/favicon.svg +38 -38
  187. package/ui/index.html +51 -149
  188. package/ui/product.css +9 -0
  189. package/ui/product.js +386 -0
  190. package/vendor-manifest.json +46 -0
  191. package/_site/_test/import-ui-flow-test.js +0 -171
  192. package/_site/_test/project-control-panel-task14-test.js +0 -63
  193. package/_site/_test/task15-20-ui-flow-test.js +0 -148
  194. package/_site/_test/ui-i18n-toggle-test.js +0 -114
  195. package/_site/_test/ui-smoke-test.js +0 -73
  196. package/ui/app.css +0 -58
  197. package/ui/app.js +0 -607
  198. package/ui/i18n.js +0 -146
@@ -1,156 +1,159 @@
1
- // _site/_test/run-all-tests.js
2
- //
3
- // Single-command regression suite runner. Iterates the canonical test files
4
- // under _site/_test/ (everything matching *-test.js) and runs each one in a
5
- // separate child process, capturing exit code, duration, and the last few
6
- // lines of output. Writes a Markdown report to TEST-REPORT.md.
7
- //
8
- // Usage:
9
- // node _site/_test/run-all-tests.js # run all *-test.js
10
- // node _site/_test/run-all-tests.js --no-report # do not write report
11
- //
12
- // Exit code is 0 only if every test passes.
13
-
14
- const fs = require('fs');
15
- const os = require('os');
16
- const path = require('path');
17
- const { spawnSync } = require('child_process');
18
-
19
- const ROOT = path.resolve(__dirname, '..', '..');
20
- const TEST_DIR = __dirname;
21
- const REPORT_PATH = path.join(TEST_DIR, 'TEST-REPORT.md');
22
-
23
- const args = process.argv.slice(2);
24
- const WRITE_REPORT = !args.includes('--no-report');
25
- const PER_TEST_TIMEOUT_MS = Number(process.env.PK_TEST_TIMEOUT_MS || 90_000);
26
-
27
- function listTestFiles() {
28
- return fs.readdirSync(TEST_DIR)
29
- .filter(file => file.endsWith('-test.js'))
30
- .filter(file => file !== 'run-all-tests.js')
31
- .sort();
32
- }
33
-
34
- function tail(text, lines = 12) {
35
- const arr = String(text || '').split(/\r?\n/).filter(Boolean);
36
- return arr.slice(-lines).join('\n');
37
- }
38
-
39
- function classifyFailure(result) {
40
- if (result.status !== null) {
41
- return { kind: 'exit', label: `FAIL (exit ${result.status})` };
42
- }
43
- if (result.error && result.error.code === 'ETIMEDOUT') {
44
- return { kind: 'timeout', label: `TIMEOUT (killed after ${PER_TEST_TIMEOUT_MS}ms, signal ${result.signal || 'none'})` };
45
- }
46
- const code = result.error && result.error.code ? result.error.code : 'unknown';
47
- return { kind: 'error', label: `FAIL (spawn error ${code}, signal ${result.signal || 'none'})` };
48
- }
49
-
50
- function runOne(file) {
51
- const start = Date.now();
52
- // Every test child gets its own Bridge journal sandbox so hook-trigger /
53
- // server runtimes never touch the developer's ~/.ai-coding-event-bridge.
54
- const bridgeHome = fs.mkdtempSync(path.join(os.tmpdir(), `kb-runall-bridge-${process.pid}-`));
55
- const result = spawnSync(process.execPath, [path.join(TEST_DIR, file)], {
56
- cwd: ROOT,
57
- encoding: 'utf-8',
58
- timeout: PER_TEST_TIMEOUT_MS,
59
- env: { ...process.env, FORCE_COLOR: '0', AI_CODING_EVENT_BRIDGE_HOME: bridgeHome, KB_MODULES_AUTOSTART: '0' },
60
- });
61
- try { fs.rmSync(bridgeHome, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); } catch {}
62
- const failure = result.status === 0 ? null : classifyFailure(result);
63
- return {
64
- file,
65
- passed: result.status === 0,
66
- failureKind: failure ? failure.kind : null,
67
- failureLabel: failure ? failure.label : null,
68
- exitCode: result.status,
69
- signal: result.signal,
70
- spawnErrorCode: result.error && result.error.code ? result.error.code : null,
71
- durationMs: Date.now() - start,
72
- stdout: result.stdout || '',
73
- stderr: result.stderr || '',
74
- outputTail: tail(`${result.stdout || ''}\n${result.stderr || ''}`.trim()),
75
- };
76
- }
77
-
78
- (async () => {
79
- const files = listTestFiles();
80
- console.log(`Running ${files.length} test file(s)...\n`);
81
-
82
- const results = [];
83
- let totalDuration = 0;
84
- for (const file of files) {
85
- process.stdout.write(`> ${file} ... `);
86
- const result = runOne(file);
87
- totalDuration += result.durationMs;
88
- results.push(result);
89
-
90
- if (result.passed) {
91
- console.log(`PASS (${result.durationMs}ms)`);
92
- } else {
93
- console.log(`${result.failureLabel}, ${result.durationMs}ms`);
94
- if (result.outputTail) {
95
- console.log('--- tail ---');
96
- console.log(result.outputTail);
97
- console.log('--- end tail ---');
98
- }
99
- }
100
- }
101
-
102
- const passed = results.filter(result => result.passed).length;
103
- const failed = results.length - passed;
104
- console.log('\n=========================================');
105
- console.log(`Regression suite: ${passed} passed, ${failed} failed (${totalDuration}ms total)`);
106
- console.log('=========================================\n');
107
-
108
- if (WRITE_REPORT) {
109
- const lines = [];
110
- lines.push('# KB Management Site Regression Test Report');
111
- lines.push('');
112
- lines.push(`**Generated**: ${new Date().toISOString()}`);
113
- lines.push(`**Node**: ${process.version}`);
114
- lines.push('**Runner**: node _site/_test/run-all-tests.js');
115
- lines.push('');
116
- lines.push('## Summary');
117
- lines.push('');
118
- lines.push(`**Per-test timeout**: ${PER_TEST_TIMEOUT_MS}ms (override with PK_TEST_TIMEOUT_MS)`);
119
- lines.push('');
120
- lines.push('| # | File | Status | Exit | Duration |');
121
- lines.push('|--:|------|:------:|-----:|---------:|');
122
- results.forEach((result, index) => {
123
- const status = result.passed ? 'PASS' : (result.failureKind === 'timeout' ? 'TIMEOUT' : 'FAIL');
124
- const exit = result.passed
125
- ? String(result.exitCode)
126
- : `${result.exitCode}${result.signal ? `, signal ${result.signal}` : ''}${result.spawnErrorCode ? `, error ${result.spawnErrorCode}` : ''}`;
127
- lines.push(`| ${index + 1} | \`${result.file}\` | ${status} | ${exit} | ${result.durationMs}ms |`);
128
- });
129
- lines.push('');
130
- lines.push(`**Total**: ${results.length} | **Passed**: ${passed} | **Failed**: ${failed} | **Time**: ${totalDuration}ms`);
131
- lines.push('');
132
-
133
- const failures = results.filter(result => !result.passed);
134
- if (failures.length) {
135
- lines.push('## Failures');
136
- lines.push('');
137
- for (const result of failures) {
138
- lines.push(`### ${result.file}`);
139
- lines.push('');
140
- lines.push('```');
141
- lines.push(result.outputTail);
142
- lines.push('```');
143
- lines.push('');
144
- }
145
- }
146
-
147
- try {
148
- fs.writeFileSync(REPORT_PATH, lines.join('\n'), 'utf-8');
149
- console.log(`Report written to: ${REPORT_PATH}`);
150
- } catch (e) {
151
- console.error(`Failed to write report: ${e.message}`);
152
- }
153
- }
154
-
155
- process.exit(failed > 0 ? 1 : 0);
156
- })();
1
+ // _site/_test/run-all-tests.js
2
+ //
3
+ // Single-command regression suite runner. Iterates the canonical test files
4
+ // under _site/_test/ (everything matching *-test.js) and runs each one in a
5
+ // separate child process, capturing exit code, duration, and the last few
6
+ // lines of output. Writes a Markdown report to TEST-REPORT.md.
7
+ //
8
+ // Usage:
9
+ // node _site/_test/run-all-tests.js # run all *-test.js
10
+ // node _site/_test/run-all-tests.js --no-report # do not write report
11
+ //
12
+ // Exit code is 0 only if every test passes.
13
+
14
+ const fs = require('fs');
15
+ const os = require('os');
16
+ const path = require('path');
17
+ const { spawnSync } = require('child_process');
18
+
19
+ const ROOT = path.resolve(__dirname, '..', '..');
20
+ const TEST_DIR = __dirname;
21
+ const REPORT_PATH = path.join(TEST_DIR, 'TEST-REPORT.md');
22
+
23
+ const args = process.argv.slice(2);
24
+ const WRITE_REPORT = !args.includes('--no-report');
25
+ const BACKEND_ONLY = args.includes('--backend-only');
26
+ const PER_TEST_TIMEOUT_MS = Number(process.env.PK_TEST_TIMEOUT_MS || 90_000);
27
+
28
+ function listTestFiles() {
29
+ return fs.readdirSync(TEST_DIR)
30
+ .filter(file => file.endsWith('-test.js'))
31
+ .filter(file => file !== 'run-all-tests.js')
32
+ .filter(file => !BACKEND_ONLY || !fs.readFileSync(path.join(TEST_DIR, file), 'utf8').includes('helpers/cdp-browser'))
33
+ .sort();
34
+ }
35
+
36
+ function tail(text, lines = 12) {
37
+ const arr = String(text || '').split(/\r?\n/).filter(Boolean);
38
+ return arr.slice(-lines).join('\n');
39
+ }
40
+
41
+ function classifyFailure(result) {
42
+ if (result.status !== null) {
43
+ return { kind: 'exit', label: `FAIL (exit ${result.status})` };
44
+ }
45
+ if (result.error && result.error.code === 'ETIMEDOUT') {
46
+ return { kind: 'timeout', label: `TIMEOUT (killed after ${PER_TEST_TIMEOUT_MS}ms, signal ${result.signal || 'none'})` };
47
+ }
48
+ const code = result.error && result.error.code ? result.error.code : 'unknown';
49
+ return { kind: 'error', label: `FAIL (spawn error ${code}, signal ${result.signal || 'none'})` };
50
+ }
51
+
52
+ function runOne(file) {
53
+ const start = Date.now();
54
+ // Every test child gets its own Bridge journal sandbox so hook-trigger /
55
+ // server runtimes never touch the developer's ~/.ai-coding-event-bridge.
56
+ const bridgeHome = fs.mkdtempSync(path.join(os.tmpdir(), `kb-runall-bridge-${process.pid}-`));
57
+ const result = spawnSync(process.execPath, [path.join(TEST_DIR, file)], {
58
+ cwd: ROOT,
59
+ encoding: 'utf-8',
60
+ timeout: PER_TEST_TIMEOUT_MS,
61
+ env: { ...process.env, FORCE_COLOR: '0', AI_CODING_EVENT_BRIDGE_HOME: bridgeHome, KB_MODULES_AUTOSTART: '0' },
62
+ });
63
+ try { fs.rmSync(bridgeHome, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); } catch {}
64
+ const failure = result.status === 0 ? null : classifyFailure(result);
65
+ return {
66
+ file,
67
+ passed: result.status === 0,
68
+ failureKind: failure ? failure.kind : null,
69
+ failureLabel: failure ? failure.label : null,
70
+ exitCode: result.status,
71
+ signal: result.signal,
72
+ spawnErrorCode: result.error && result.error.code ? result.error.code : null,
73
+ durationMs: Date.now() - start,
74
+ stdout: result.stdout || '',
75
+ stderr: result.stderr || '',
76
+ outputTail: tail(`${result.stdout || ''}\n${result.stderr || ''}`.trim()),
77
+ };
78
+ }
79
+
80
+ (async () => {
81
+ const files = listTestFiles();
82
+ if (BACKEND_ONLY) console.log('Backend/contract scope only. Browser tests are excluded, not passed.');
83
+ console.log(`Running ${files.length} test file(s)...\n`);
84
+
85
+ const results = [];
86
+ let totalDuration = 0;
87
+ for (const file of files) {
88
+ process.stdout.write(`> ${file} ... `);
89
+ const result = runOne(file);
90
+ totalDuration += result.durationMs;
91
+ results.push(result);
92
+
93
+ if (result.passed) {
94
+ console.log(`PASS (${result.durationMs}ms)`);
95
+ } else {
96
+ console.log(`${result.failureLabel}, ${result.durationMs}ms`);
97
+ if (result.outputTail) {
98
+ console.log('--- tail ---');
99
+ console.log(result.outputTail);
100
+ console.log('--- end tail ---');
101
+ }
102
+ }
103
+ }
104
+
105
+ const passed = results.filter(result => result.passed).length;
106
+ const failed = results.length - passed;
107
+ console.log('\n=========================================');
108
+ console.log(`Regression suite: ${passed} passed, ${failed} failed (${totalDuration}ms total)`);
109
+ console.log('=========================================\n');
110
+
111
+ if (WRITE_REPORT) {
112
+ const lines = [];
113
+ lines.push('# KB Management Site Regression Test Report');
114
+ lines.push('');
115
+ lines.push(`**Generated**: ${new Date().toISOString()}`);
116
+ lines.push(`**Node**: ${process.version}`);
117
+ lines.push('**Runner**: node _site/_test/run-all-tests.js');
118
+ lines.push('');
119
+ lines.push('## Summary');
120
+ lines.push('');
121
+ lines.push(`**Per-test timeout**: ${PER_TEST_TIMEOUT_MS}ms (override with PK_TEST_TIMEOUT_MS)`);
122
+ lines.push('');
123
+ lines.push('| # | File | Status | Exit | Duration |');
124
+ lines.push('|--:|------|:------:|-----:|---------:|');
125
+ results.forEach((result, index) => {
126
+ const status = result.passed ? 'PASS' : (result.failureKind === 'timeout' ? 'TIMEOUT' : 'FAIL');
127
+ const exit = result.passed
128
+ ? String(result.exitCode)
129
+ : `${result.exitCode}${result.signal ? `, signal ${result.signal}` : ''}${result.spawnErrorCode ? `, error ${result.spawnErrorCode}` : ''}`;
130
+ lines.push(`| ${index + 1} | \`${result.file}\` | ${status} | ${exit} | ${result.durationMs}ms |`);
131
+ });
132
+ lines.push('');
133
+ lines.push(`**Total**: ${results.length} | **Passed**: ${passed} | **Failed**: ${failed} | **Time**: ${totalDuration}ms`);
134
+ lines.push('');
135
+
136
+ const failures = results.filter(result => !result.passed);
137
+ if (failures.length) {
138
+ lines.push('## Failures');
139
+ lines.push('');
140
+ for (const result of failures) {
141
+ lines.push(`### ${result.file}`);
142
+ lines.push('');
143
+ lines.push('```');
144
+ lines.push(result.outputTail);
145
+ lines.push('```');
146
+ lines.push('');
147
+ }
148
+ }
149
+
150
+ try {
151
+ fs.writeFileSync(REPORT_PATH, lines.join('\n'), 'utf-8');
152
+ console.log(`Report written to: ${REPORT_PATH}`);
153
+ } catch (e) {
154
+ console.error(`Failed to write report: ${e.message}`);
155
+ }
156
+ }
157
+
158
+ process.exit(failed > 0 ? 1 : 0);
159
+ })();
@@ -1,27 +1,27 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
- const { initializeRuntime } = require('../lib/server-app');
6
-
7
- const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-runtime-migration-safety-'));
8
- let settingsInitialized = false;
9
- let registryInitialized = false;
10
- const runtime = {
11
- rootDir: path.join(root, 'missing-legacy-root'),
12
- dataPath: path.join(root, 'data'),
13
- logger: { info: async () => {} },
14
- migrationService: { migrateIfNeeded: async () => ({ ok: false, requiresManualRecovery: true, reason: 'fault-injected' }) },
15
- settingsStore: { initialize: async () => { settingsInitialized = true; } },
16
- registryStore: { initialize: async () => { registryInitialized = true; } },
17
- };
18
-
19
- initializeRuntime(runtime).then(() => {
20
- throw new Error('initializeRuntime must reject an unsuccessful migration');
21
- }).catch(error => {
22
- assert.equal(error.code, 'MIGRATION_FAILED');
23
- assert.equal(settingsInitialized, false, 'settings defaults must not be initialized after migration failure');
24
- assert.equal(registryInitialized, false, 'empty project registry must not be initialized after migration failure');
25
- fs.rmSync(root, { recursive: true, force: true });
26
- console.log('server-runtime-migration-safety-test PASS');
27
- });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+ const { initializeRuntime } = require('../lib/server-app');
6
+
7
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-runtime-migration-safety-'));
8
+ let settingsInitialized = false;
9
+ let registryInitialized = false;
10
+ const runtime = {
11
+ rootDir: path.join(root, 'missing-legacy-root'),
12
+ dataPath: path.join(root, 'data'),
13
+ logger: { info: async () => {} },
14
+ migrationService: { migrateIfNeeded: async () => ({ ok: false, requiresManualRecovery: true, reason: 'fault-injected' }) },
15
+ settingsStore: { initialize: async () => { settingsInitialized = true; } },
16
+ registryStore: { initialize: async () => { registryInitialized = true; } },
17
+ };
18
+
19
+ initializeRuntime(runtime).then(() => {
20
+ throw new Error('initializeRuntime must reject an unsuccessful migration');
21
+ }).catch(error => {
22
+ assert.equal(error.code, 'MIGRATION_FAILED');
23
+ assert.equal(settingsInitialized, false, 'settings defaults must not be initialized after migration failure');
24
+ assert.equal(registryInitialized, false, 'empty project registry must not be initialized after migration failure');
25
+ fs.rmSync(root, { recursive: true, force: true });
26
+ console.log('server-runtime-migration-safety-test PASS');
27
+ });
@@ -1,58 +1,58 @@
1
- const assert = require('assert');
2
- const contracts = require('../lib/contracts');
3
-
4
- assert.deepStrictEqual(contracts.TRIGGERS, ['git-hook']);
5
- assert.deepStrictEqual(contracts.LOG_LEVELS, ['trace', 'debug', 'info', 'warn', 'error', 'fatal']);
6
- assert.strictEqual(contracts.SCHEMAS.projectState, 'project-state/v2');
7
- assert.strictEqual(contracts.SCHEMA_VERSIONS.layoutMigration, 'layout-v2');
8
-
9
- for (const trigger of contracts.TRIGGERS) assert.strictEqual(contracts.validateTrigger(trigger), trigger);
10
- assert.throws(() => contracts.validateTrigger('simulate'), error => error.code === 'INVALID_TRIGGER');
11
- assert.throws(() => contracts.validateTrigger('project-init'), error => error.code === 'INVALID_TRIGGER');
12
- assert.throws(() => contracts.validateTrigger('startup'), error => error.code === 'INVALID_TRIGGER');
13
-
14
- const publicProfile = contracts.publicAiProfileView({
15
- id: 'primary',
16
- name: 'Primary',
17
- apiKey: 'sk-super-secret-1234',
18
- authToken: 'second-secret',
19
- baseUrl: 'https://example.invalid',
20
- });
21
- assert.strictEqual(publicProfile.id, 'primary');
22
- assert.strictEqual(publicProfile.baseUrl, 'https://example.invalid');
23
- assert.strictEqual(publicProfile.hasApiKey, true);
24
- assert.strictEqual(publicProfile.apiKeyMasked, '****1234');
25
- assert.strictEqual(Object.prototype.hasOwnProperty.call(publicProfile, 'apiKey'), false);
26
- assert.strictEqual(Object.prototype.hasOwnProperty.call(publicProfile, 'authToken'), false);
27
-
28
- const domainError = new contracts.DomainError('HOOK_CONFLICT', 'A non-managed hook exists.', {
29
- status: 409,
30
- operationId: 'op-test',
31
- details: {
32
- apiKey: 'must-not-leak',
33
- stack: 'must-not-leak',
34
- nested: { authorization: 'Bearer must-not-leak', safe: 'kept' },
35
- },
36
- });
37
- const envelope = contracts.serializeErrorEnvelope(domainError);
38
- const serialized = JSON.stringify(envelope);
39
- assert.strictEqual(envelope.ok, false);
40
- assert.strictEqual(envelope.error.code, 'HOOK_CONFLICT');
41
- assert.strictEqual(envelope.error.operationId, 'op-test');
42
- assert(!serialized.includes('must-not-leak'));
43
- assert(!serialized.includes('stack'));
44
- assert(serialized.includes('kept'));
45
-
46
- assert.strictEqual(contracts.validateStateTransition('idle', 'scanning'), true);
47
- assert.strictEqual(contracts.validateStateTransition('markdown.promoted', 'state.advanced'), true);
48
- assert.throws(() => contracts.validateStateTransition('idle', 'markdown.promoted'));
49
-
50
- assert.strictEqual(contracts.assertMutableProjectPatch({ displayName: 'New', enabled: false }), true);
51
- assert.throws(() => contracts.assertMutableProjectPatch({ projectId: 'new' }), error => error.code === 'IMMUTABLE_FIELD');
52
- assert.throws(() => contracts.assertMutableProjectPatch({ knowledgePath: 'D:/new' }), error => error.code === 'IMMUTABLE_FIELD');
53
- assert.strictEqual(contracts.assertMutableProjectPatch({ knowledgePath: 'D:/new' }, { allowKnowledgePath: true }), true);
54
- assert.throws(() => contracts.assertMutableProjectPatch({ repoPath: 'D:/moved' }), error => error.code === 'INVALID_ARGUMENT');
55
- assert.strictEqual(contracts.assertMutableProjectPatch({ repoPath: 'D:/moved' }, { allowRepoPath: true }), true);
56
- assert.throws(() => contracts.assertMutableProjectPatch({ teamBinding: {} }), error => error.code === 'INVALID_ARGUMENT');
57
-
58
- console.log('shared-contracts-test PASS');
1
+ const assert = require('assert');
2
+ const contracts = require('../lib/contracts');
3
+
4
+ assert.deepStrictEqual(contracts.TRIGGERS, ['git-hook']);
5
+ assert.deepStrictEqual(contracts.LOG_LEVELS, ['trace', 'debug', 'info', 'warn', 'error', 'fatal']);
6
+ assert.strictEqual(contracts.SCHEMAS.projectState, 'project-state/v2');
7
+ assert.strictEqual(contracts.SCHEMA_VERSIONS.layoutMigration, 'layout-v2');
8
+
9
+ for (const trigger of contracts.TRIGGERS) assert.strictEqual(contracts.validateTrigger(trigger), trigger);
10
+ assert.throws(() => contracts.validateTrigger('simulate'), error => error.code === 'INVALID_TRIGGER');
11
+ assert.throws(() => contracts.validateTrigger('project-init'), error => error.code === 'INVALID_TRIGGER');
12
+ assert.throws(() => contracts.validateTrigger('startup'), error => error.code === 'INVALID_TRIGGER');
13
+
14
+ const publicProfile = contracts.publicAiProfileView({
15
+ id: 'primary',
16
+ name: 'Primary',
17
+ apiKey: 'sk-super-secret-1234',
18
+ authToken: 'second-secret',
19
+ baseUrl: 'https://example.invalid',
20
+ });
21
+ assert.strictEqual(publicProfile.id, 'primary');
22
+ assert.strictEqual(publicProfile.baseUrl, 'https://example.invalid');
23
+ assert.strictEqual(publicProfile.hasApiKey, true);
24
+ assert.strictEqual(publicProfile.apiKeyMasked, '****1234');
25
+ assert.strictEqual(Object.prototype.hasOwnProperty.call(publicProfile, 'apiKey'), false);
26
+ assert.strictEqual(Object.prototype.hasOwnProperty.call(publicProfile, 'authToken'), false);
27
+
28
+ const domainError = new contracts.DomainError('HOOK_CONFLICT', 'A non-managed hook exists.', {
29
+ status: 409,
30
+ operationId: 'op-test',
31
+ details: {
32
+ apiKey: 'must-not-leak',
33
+ stack: 'must-not-leak',
34
+ nested: { authorization: 'Bearer must-not-leak', safe: 'kept' },
35
+ },
36
+ });
37
+ const envelope = contracts.serializeErrorEnvelope(domainError);
38
+ const serialized = JSON.stringify(envelope);
39
+ assert.strictEqual(envelope.ok, false);
40
+ assert.strictEqual(envelope.error.code, 'HOOK_CONFLICT');
41
+ assert.strictEqual(envelope.error.operationId, 'op-test');
42
+ assert(!serialized.includes('must-not-leak'));
43
+ assert(!serialized.includes('stack'));
44
+ assert(serialized.includes('kept'));
45
+
46
+ assert.strictEqual(contracts.validateStateTransition('idle', 'scanning'), true);
47
+ assert.strictEqual(contracts.validateStateTransition('markdown.promoted', 'state.advanced'), true);
48
+ assert.throws(() => contracts.validateStateTransition('idle', 'markdown.promoted'));
49
+
50
+ assert.strictEqual(contracts.assertMutableProjectPatch({ displayName: 'New', enabled: false }), true);
51
+ assert.throws(() => contracts.assertMutableProjectPatch({ projectId: 'new' }), error => error.code === 'IMMUTABLE_FIELD');
52
+ assert.throws(() => contracts.assertMutableProjectPatch({ knowledgePath: 'D:/new' }), error => error.code === 'IMMUTABLE_FIELD');
53
+ assert.strictEqual(contracts.assertMutableProjectPatch({ knowledgePath: 'D:/new' }, { allowKnowledgePath: true }), true);
54
+ assert.throws(() => contracts.assertMutableProjectPatch({ repoPath: 'D:/moved' }), error => error.code === 'INVALID_ARGUMENT');
55
+ assert.strictEqual(contracts.assertMutableProjectPatch({ repoPath: 'D:/moved' }, { allowRepoPath: true }), true);
56
+ assert.throws(() => contracts.assertMutableProjectPatch({ teamBinding: {} }), error => error.code === 'INVALID_ARGUMENT');
57
+
58
+ console.log('shared-contracts-test PASS');
@@ -1,13 +1,13 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const path = require('path');
4
-
5
- const root = path.resolve(__dirname, '..', '..');
6
- const server = fs.readFileSync(path.join(root, '_site', 'lib', 'server-app.js'), 'utf8');
7
- const contracts = require('../lib/contracts');
8
- const automation = require('../lib/post-commit-automation');
9
-
10
- assert.deepEqual(contracts.TRIGGERS, ['git-hook']);
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const path = require('path');
4
+
5
+ const root = path.resolve(__dirname, '..', '..');
6
+ const server = fs.readFileSync(path.join(root, '_site', 'lib', 'server-app.js'), 'utf8');
7
+ const contracts = require('../lib/contracts');
8
+ const automation = require('../lib/post-commit-automation');
9
+
10
+ assert.deepEqual(contracts.TRIGGERS, ['git-hook']);
11
11
  assert.equal(/reconcileProjectCommits\(projectId, 'startup'/.test(server), false);
12
12
  assert.equal(server.includes('reconcile.startup_failed'), false);
13
13
  assert.equal(Object.hasOwn(automation, 'dispatchPendingAutomations'), false);