@sanqianx/project-knowledge 4.7.0 → 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 (192) hide show
  1. package/.agents/plugins/marketplace.json +17 -17
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +817 -799
  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/chat-claudecodeui-match-test.js +92 -92
  46. package/_site/_test/claude-executable-discovery-test.js +62 -62
  47. package/_site/_test/claude-workbench-test.js +170 -170
  48. package/_site/_test/codex-conversation-projection-test.js +2 -1
  49. package/_site/_test/commit-conversation-binding-test.js +95 -95
  50. package/_site/_test/commit-evidence-test.js +110 -110
  51. package/_site/_test/conversation-api-test.js +109 -109
  52. package/_site/_test/conversation-store-test.js +136 -136
  53. package/_site/_test/data-dir-migration-test.js +57 -57
  54. package/_site/_test/desktop-browser-compat-test.js +28 -28
  55. package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
  56. package/_site/_test/explicit-commit-processor-test.js +37 -37
  57. package/_site/_test/fixtures/make-git-repos.js +12 -1
  58. package/_site/_test/folder-picker-output-test.js +19 -19
  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/legacy-forward-compat-test.js +257 -257
  75. package/_site/_test/legacy-project-upgrade-e2e-test.js +363 -363
  76. package/_site/_test/logging-api-test.js +89 -89
  77. package/_site/_test/logging-sse-no-gap-test.js +88 -88
  78. package/_site/_test/logging-ui-test.js +106 -104
  79. package/_site/_test/markdown-delta-overlay-test.js +85 -85
  80. package/_site/_test/markdown-maintenance-api-test.js +75 -75
  81. package/_site/_test/mcp-server-test.js +149 -149
  82. package/_site/_test/module-artifact-integrity-test.js +27 -0
  83. package/_site/_test/module-boundary-test.js +30 -0
  84. package/_site/_test/module-bridge-eventbridge-test.js +7 -0
  85. package/_site/_test/module-model-configuration-test.js +43 -0
  86. package/_site/_test/module-process-lifecycle-test.js +24 -0
  87. package/_site/_test/module-stream-proxy-test.js +34 -0
  88. package/_site/_test/non-release-ci-test.js +34 -34
  89. package/_site/_test/offline-boundary-isolation-test.js +32 -32
  90. package/_site/_test/p0-data-migration-characterization-test.js +37 -37
  91. package/_site/_test/p0-e2e-gate-test.js +347 -347
  92. package/_site/_test/packaged-ui-smoke-test.js +11 -9
  93. package/_site/_test/path-consistency-test.js +151 -151
  94. package/_site/_test/pending-sweep-test.js +9 -9
  95. package/_site/_test/post-commit-automation-test.js +87 -87
  96. package/_site/_test/product-diagnostics-ui-test.js +75 -0
  97. package/_site/_test/product-import-ui-test.js +92 -0
  98. package/_site/_test/project-delete-recovery-test.js +64 -64
  99. package/_site/_test/project-goal-editor-test.js +144 -144
  100. package/_site/_test/project-layout-v2-migration-test.js +127 -127
  101. package/_site/_test/project-lifecycle-transaction-test.js +106 -106
  102. package/_site/_test/prompt-settings-test.js +115 -115
  103. package/_site/_test/protected-architecture-gate-test.js +122 -122
  104. package/_site/_test/refactor-characterization-test.js +36 -36
  105. package/_site/_test/release-version-sync-test.js +1 -1
  106. package/_site/_test/requirement-recorder-test.js +173 -173
  107. package/_site/_test/run-all-tests.js +159 -156
  108. package/_site/_test/server-runtime-migration-safety-test.js +27 -27
  109. package/_site/_test/shared-contracts-test.js +58 -58
  110. package/_site/_test/startup-analysis-disabled-test.js +10 -10
  111. package/_site/_test/storage-foundation-test.js +78 -78
  112. package/_site/_test/structured-logger-test.js +101 -101
  113. package/_site/_test/tracking-start-test.js +108 -108
  114. package/_site/_test/v4122-upgrade-data-contract-test.js +56 -56
  115. package/_site/_test/workbench-permission-test.js +117 -117
  116. package/_site/_test/workspace-ui-contract-test.js +28 -43
  117. package/_site/lib/ai-profile-resolver.js +78 -78
  118. package/_site/lib/ai-workspace.js +101 -101
  119. package/_site/lib/automation-config.js +140 -140
  120. package/_site/lib/bridge-adapter.js +1 -0
  121. package/_site/lib/bridge-consumer-service.js +402 -402
  122. package/_site/lib/claude-cli-runner.js +1510 -1510
  123. package/_site/lib/commit-conversation-binder.js +234 -234
  124. package/_site/lib/commit-processing-ledger.js +27 -27
  125. package/_site/lib/commit-prompt.js +202 -202
  126. package/_site/lib/commit-reconciler.js +406 -406
  127. package/_site/lib/contracts.js +284 -279
  128. package/_site/lib/conversation-query-service.js +144 -144
  129. package/_site/lib/conversation-store.js +385 -385
  130. package/_site/lib/data-dir.js +74 -74
  131. package/_site/lib/data-state-classifier.js +40 -40
  132. package/_site/lib/engine-cutover.js +97 -0
  133. package/_site/lib/evidence-bundle.js +228 -228
  134. package/_site/lib/folder-picker-output.js +21 -21
  135. package/_site/lib/git-runner.js +62 -62
  136. package/_site/lib/github-team-store.js +1172 -1172
  137. package/_site/lib/hook-manager.js +203 -202
  138. package/_site/lib/index-service.js +173 -173
  139. package/_site/lib/integration-installer.js +907 -907
  140. package/_site/lib/kb-framework.js +176 -176
  141. package/_site/lib/kb-validator.js +124 -124
  142. package/_site/lib/knowledge-promotion.js +435 -435
  143. package/_site/lib/knowledge-retrieval-service.js +401 -401
  144. package/_site/lib/knowledge-tool-runtime.js +359 -359
  145. package/_site/lib/legacy-data-manifest.js +26 -26
  146. package/_site/lib/llm-client.js +161 -161
  147. package/_site/lib/markdown-knowledge-indexer.js +230 -230
  148. package/_site/lib/migration-service.js +442 -442
  149. package/_site/lib/module-bridge.js +198 -33
  150. package/_site/lib/post-commit-automation.js +87 -87
  151. package/_site/lib/project-lifecycle-service.js +519 -497
  152. package/_site/lib/project-store.js +268 -262
  153. package/_site/lib/requirement-recorder.js +278 -278
  154. package/_site/lib/runtime-endpoint.js +155 -155
  155. package/_site/lib/scanner.js +298 -298
  156. package/_site/lib/server-app.js +1590 -1520
  157. package/_site/lib/settings-store.js +133 -113
  158. package/_site/lib/storage-layout.js +162 -162
  159. package/_site/lib/structured-logger.js +574 -574
  160. package/_site/scripts/folder-picker.ps1 +156 -156
  161. package/_site/scripts/hook-trigger.js +157 -156
  162. package/_site/scripts/install-module-candidates.js +69 -0
  163. package/_site/scripts/pack-module-candidates.js +72 -0
  164. package/_site/scripts/sync-release-version.js +2 -2
  165. package/_site/scripts/vendor-modules.js +47 -0
  166. package/_site/scripts/verify-module-runtime.js +45 -0
  167. package/_site/scripts/verify-product-runtime.js +34 -0
  168. package/bin/project-knowledge-mcp.js +194 -194
  169. package/docs/README.zh-CN.md +34 -25
  170. package/docs/project-registry-schema.md +22 -22
  171. package/docs/testing-strategy.md +33 -33
  172. package/module-runtime-manifest.json +220 -0
  173. package/package.json +13 -9
  174. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  175. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  176. package/plugins/project-knowledge/.mcp.json +1 -1
  177. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  178. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  179. package/templates/project-readme.md +34 -34
  180. package/ui/favicon.svg +38 -38
  181. package/ui/index.html +51 -149
  182. package/ui/product.css +9 -0
  183. package/ui/product.js +386 -0
  184. package/vendor-manifest.json +46 -0
  185. package/_site/_test/import-ui-flow-test.js +0 -171
  186. package/_site/_test/project-control-panel-task14-test.js +0 -63
  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/ui/app.css +0 -58
  191. package/ui/app.js +0 -607
  192. 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);