@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,32 +1,32 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
- const { StorageLayout } = require('../lib/storage-layout');
6
- const { ProjectStore } = require('../lib/project-store');
7
- const { ConversationStore } = require('../lib/conversation-store');
8
- const { CommitConversationBinder } = require('../lib/commit-conversation-binder');
9
-
10
- (async () => {
11
- const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-offline-boundaries-'));
12
- try {
13
- const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
14
- const projects = new ProjectStore({ layout });
15
- const projectId = 'project-offline-boundary';
16
- const identity = { commonDir: path.join(root, 'repo', '.git') };
17
- await projects.create(projectId, { storageName: 'offline-boundary', displayName: 'Offline Boundary', repoPath: path.join(root, 'repo'), knowledgePath: path.join(root, 'knowledge'), repoIdentity: identity }, { conversationBaselineCursor: 0 });
18
- const store = new ConversationStore({ layout, projectStore: projects });
19
- const binder = new CommitConversationBinder({ layout, projectStore: projects, conversationStore: store });
20
- const add = (sequence, eventId, content) => store.appendEvent(projectId, { eventId, sequence, source: 'codex', eventType: 'user_prompt', role: 'user', content, turnId: eventId, repoIdentity: identity, capturedAt: '2026-08-24T00:00:00.000Z', identityConfidence: 'exact', captureStatus: 'captured' });
21
- const boundary = (sha, cursor) => store.writeBoundary(projectId, { commitSha: sha, repoIdentity: identity, parentShas: [], branch: 'main', committedAt: '2026-08-24T00:00:00.000Z', bridgeCursorAtCommit: cursor, journalSequence: cursor, openTurnIdsAtCommit: [], operationId: `op-${cursor}` });
22
- const b = 'b'.repeat(40); const c = 'c'.repeat(40); const d = 'd'.repeat(40);
23
- await add(1, 'prompt-b', 'offline B'); boundary(b, 2);
24
- await add(3, 'prompt-c', 'offline C'); boundary(c, 4);
25
- await add(5, 'prompt-d', 'online D'); boundary(d, 6);
26
- const snapshot = await binder.bind({ projectId, commitSha: d });
27
- assert.deepEqual(snapshot.turns.map(turn => turn.turnId), ['prompt-d']);
28
- assert.equal(JSON.stringify(snapshot).includes('offline B'), false);
29
- assert.equal(JSON.stringify(snapshot).includes('offline C'), false);
30
- } finally { fs.rmSync(root, { recursive: true, force: true }); }
31
- console.log('offline-boundary-isolation-test PASS');
32
- })().catch(error => { console.error(error.stack || error.message); process.exit(1); });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+ const { StorageLayout } = require('../lib/storage-layout');
6
+ const { ProjectStore } = require('../lib/project-store');
7
+ const { ConversationStore } = require('../lib/conversation-store');
8
+ const { CommitConversationBinder } = require('../lib/commit-conversation-binder');
9
+
10
+ (async () => {
11
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-offline-boundaries-'));
12
+ try {
13
+ const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
14
+ const projects = new ProjectStore({ layout });
15
+ const projectId = 'project-offline-boundary';
16
+ const identity = { commonDir: path.join(root, 'repo', '.git') };
17
+ await projects.create(projectId, { storageName: 'offline-boundary', displayName: 'Offline Boundary', repoPath: path.join(root, 'repo'), knowledgePath: path.join(root, 'knowledge'), repoIdentity: identity }, { conversationBaselineCursor: 0 });
18
+ const store = new ConversationStore({ layout, projectStore: projects });
19
+ const binder = new CommitConversationBinder({ layout, projectStore: projects, conversationStore: store });
20
+ const add = (sequence, eventId, content) => store.appendEvent(projectId, { eventId, sequence, source: 'codex', eventType: 'user_prompt', role: 'user', content, turnId: eventId, repoIdentity: identity, capturedAt: '2026-08-24T00:00:00.000Z', identityConfidence: 'exact', captureStatus: 'captured' });
21
+ const boundary = (sha, cursor) => store.writeBoundary(projectId, { commitSha: sha, repoIdentity: identity, parentShas: [], branch: 'main', committedAt: '2026-08-24T00:00:00.000Z', bridgeCursorAtCommit: cursor, journalSequence: cursor, openTurnIdsAtCommit: [], operationId: `op-${cursor}` });
22
+ const b = 'b'.repeat(40); const c = 'c'.repeat(40); const d = 'd'.repeat(40);
23
+ await add(1, 'prompt-b', 'offline B'); boundary(b, 2);
24
+ await add(3, 'prompt-c', 'offline C'); boundary(c, 4);
25
+ await add(5, 'prompt-d', 'online D'); boundary(d, 6);
26
+ const snapshot = await binder.bind({ projectId, commitSha: d });
27
+ assert.deepEqual(snapshot.turns.map(turn => turn.turnId), ['prompt-d']);
28
+ assert.equal(JSON.stringify(snapshot).includes('offline B'), false);
29
+ assert.equal(JSON.stringify(snapshot).includes('offline C'), false);
30
+ } finally { fs.rmSync(root, { recursive: true, force: true }); }
31
+ console.log('offline-boundary-isolation-test PASS');
32
+ })().catch(error => { console.error(error.stack || error.message); process.exit(1); });
@@ -1,37 +1,37 @@
1
- const assert = require('assert');
2
- const fs = require('fs');
3
- const os = require('os');
4
- const path = require('path');
5
- const { StorageLayout } = require('../lib/storage-layout');
6
- const { MigrationService } = require('../lib/migration-service');
7
-
8
- function fixture() {
9
- const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-p0-migration-'));
10
- fs.writeFileSync(path.join(dataDir, 'projects.json'), JSON.stringify({ old: { repoPath: 'C:/legacy', kbPath: 'C:/knowledge/old' } }));
11
- fs.writeFileSync(path.join(dataDir, 'knowledge-store.json'), JSON.stringify({ rootPath: 'C:/knowledge' }));
12
- fs.writeFileSync(path.join(dataDir, 'ai-profiles.json'), JSON.stringify({ profiles: [{ id: 'p', apiKey: 'test-secret' }] }));
13
- fs.writeFileSync(path.join(dataDir, 'embedding-config.json'), JSON.stringify({ modelId: 'legacy-model', localModelPath: 'C:/models', localFilesOnly: true }));
14
- fs.mkdirSync(path.join(dataDir, 'models', 'nested'), { recursive: true });
15
- fs.writeFileSync(path.join(dataDir, 'models', 'nested', 'model.onnx'), 'model-fixture');
16
- return dataDir;
17
- }
18
-
19
- (async () => {
20
- const dataDir = fixture();
21
- try {
22
- const layout = new StorageLayout({ dataDir });
23
- const migration = new MigrationService({ layout, legacyDataDir: dataDir });
24
- const result = await migration.migrateIfNeeded({ migrationRunId: 'p0-characterization' });
25
- assert.equal(result.ok, true);
26
- assert.equal(result.marker.schema, 'layout-migration-completion/v2');
27
- assert.equal(result.marker.projectCount, 1);
28
- assert.equal(result.marker.aiProfileCount, 1);
29
- assert.equal(result.marker.knowledgeRootConfigured, true);
30
- assert.equal(result.marker.embeddingConfigured, true);
31
- assert.equal(fs.readFileSync(path.join(dataDir, 'cache', 'models', 'nested', 'model.onnx'), 'utf8'), 'model-fixture');
32
- const settings = JSON.parse(fs.readFileSync(layout.getSettingsPath(), 'utf8'));
33
- assert.equal(settings.embedding.modelId, 'legacy-model');
34
- assert.equal(settings.ai.profiles.length, 1);
35
- } finally { fs.rmSync(dataDir, { recursive: true, force: true }); }
36
- console.log('p0-data-migration-characterization-test PASS');
37
- })().catch(error => { console.error(error.stack || error.message); process.exit(1); });
1
+ const assert = require('assert');
2
+ const fs = require('fs');
3
+ const os = require('os');
4
+ const path = require('path');
5
+ const { StorageLayout } = require('../lib/storage-layout');
6
+ const { MigrationService } = require('../lib/migration-service');
7
+
8
+ function fixture() {
9
+ const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-p0-migration-'));
10
+ fs.writeFileSync(path.join(dataDir, 'projects.json'), JSON.stringify({ old: { repoPath: 'C:/legacy', kbPath: 'C:/knowledge/old' } }));
11
+ fs.writeFileSync(path.join(dataDir, 'knowledge-store.json'), JSON.stringify({ rootPath: 'C:/knowledge' }));
12
+ fs.writeFileSync(path.join(dataDir, 'ai-profiles.json'), JSON.stringify({ profiles: [{ id: 'p', apiKey: 'test-secret' }] }));
13
+ fs.writeFileSync(path.join(dataDir, 'embedding-config.json'), JSON.stringify({ modelId: 'legacy-model', localModelPath: 'C:/models', localFilesOnly: true }));
14
+ fs.mkdirSync(path.join(dataDir, 'models', 'nested'), { recursive: true });
15
+ fs.writeFileSync(path.join(dataDir, 'models', 'nested', 'model.onnx'), 'model-fixture');
16
+ return dataDir;
17
+ }
18
+
19
+ (async () => {
20
+ const dataDir = fixture();
21
+ try {
22
+ const layout = new StorageLayout({ dataDir });
23
+ const migration = new MigrationService({ layout, legacyDataDir: dataDir });
24
+ const result = await migration.migrateIfNeeded({ migrationRunId: 'p0-characterization' });
25
+ assert.equal(result.ok, true);
26
+ assert.equal(result.marker.schema, 'layout-migration-completion/v2');
27
+ assert.equal(result.marker.projectCount, 1);
28
+ assert.equal(result.marker.aiProfileCount, 1);
29
+ assert.equal(result.marker.knowledgeRootConfigured, true);
30
+ assert.equal(result.marker.embeddingConfigured, true);
31
+ assert.equal(fs.readFileSync(path.join(dataDir, 'cache', 'models', 'nested', 'model.onnx'), 'utf8'), 'model-fixture');
32
+ const settings = JSON.parse(fs.readFileSync(layout.getSettingsPath(), 'utf8'));
33
+ assert.equal(settings.embedding.modelId, 'legacy-model');
34
+ assert.equal(settings.ai.profiles.length, 1);
35
+ } finally { fs.rmSync(dataDir, { recursive: true, force: true }); }
36
+ console.log('p0-data-migration-characterization-test PASS');
37
+ })().catch(error => { console.error(error.stack || error.message); process.exit(1); });