@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.
- package/.agents/plugins/marketplace.json +17 -17
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +817 -799
- package/README.md +48 -36
- package/_modules/knowledge-engine/README.md +88 -0
- package/_modules/knowledge-engine/package.json +38 -0
- package/_modules/knowledge-engine/src/analysis-contract.js +25 -0
- package/_modules/knowledge-engine/src/analysis-worker.js +54 -0
- package/_modules/knowledge-engine/src/bin.js +52 -0
- package/_modules/knowledge-engine/src/bridge-client.js +24 -0
- package/_modules/knowledge-engine/src/coordinator.js +255 -0
- package/_modules/knowledge-engine/src/headless-analyzer.js +75 -0
- package/_modules/knowledge-engine/src/memories.js +85 -0
- package/_modules/knowledge-engine/src/migration.js +88 -0
- package/_modules/knowledge-engine/src/retrieval.js +116 -0
- package/_modules/knowledge-engine/src/runtime/README.md +7 -0
- package/_modules/knowledge-engine/src/runtime/atomic-file.js +204 -0
- package/_modules/knowledge-engine/src/runtime/automation-config.js +140 -0
- package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +249 -0
- package/_modules/knowledge-engine/src/runtime/commit-processing-ledger.js +26 -0
- package/_modules/knowledge-engine/src/runtime/commit-prompt.js +202 -0
- package/_modules/knowledge-engine/src/runtime/commit-reconciler.js +432 -0
- package/_modules/knowledge-engine/src/runtime/content-hash.js +4 -0
- package/_modules/knowledge-engine/src/runtime/contracts.js +279 -0
- package/_modules/knowledge-engine/src/runtime/conversation-exclusions.js +204 -0
- package/_modules/knowledge-engine/src/runtime/conversation-store.js +387 -0
- package/_modules/knowledge-engine/src/runtime/evidence-bundle.js +228 -0
- package/_modules/knowledge-engine/src/runtime/git-runner.js +62 -0
- package/_modules/knowledge-engine/src/runtime/knowledge-promotion.js +444 -0
- package/_modules/knowledge-engine/src/runtime/knowledge-retrieval-service.js +402 -0
- package/_modules/knowledge-engine/src/runtime/layout.js +44 -0
- package/_modules/knowledge-engine/src/runtime/markdown-knowledge-indexer.js +230 -0
- package/_modules/knowledge-engine/src/runtime/scanner.js +298 -0
- package/_modules/knowledge-engine/src/server.js +155 -0
- package/_modules/knowledge-engine/src/store.js +239 -0
- package/_modules/knowledge-engine/ui/app.css +172 -0
- package/_modules/knowledge-engine/ui/app.js +297 -0
- package/_modules/knowledge-engine/ui/index.html +95 -0
- package/_site/README.md +30 -30
- package/_site/_test/ai-profile-resolver-test.js +137 -137
- package/_site/_test/automation-queue-test.js +14 -14
- package/_site/_test/automation-ui-test.js +40 -40
- package/_site/_test/background-task-registry-test.js +43 -43
- package/_site/_test/baseline-schema-test.js +91 -91
- package/_site/_test/chat-claudecodeui-match-test.js +92 -92
- package/_site/_test/claude-executable-discovery-test.js +62 -62
- package/_site/_test/claude-workbench-test.js +170 -170
- package/_site/_test/codex-conversation-projection-test.js +2 -1
- package/_site/_test/commit-conversation-binding-test.js +95 -95
- package/_site/_test/commit-evidence-test.js +110 -110
- package/_site/_test/conversation-api-test.js +109 -109
- package/_site/_test/conversation-store-test.js +136 -136
- package/_site/_test/data-dir-migration-test.js +57 -57
- package/_site/_test/desktop-browser-compat-test.js +28 -28
- package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
- package/_site/_test/explicit-commit-processor-test.js +37 -37
- package/_site/_test/fixtures/make-git-repos.js +12 -1
- package/_site/_test/folder-picker-output-test.js +19 -19
- package/_site/_test/full-integration-e2e-test.js +165 -165
- package/_site/_test/git-validation-test.js +2 -2
- package/_site/_test/hook-runtime-endpoint-test.js +88 -88
- package/_site/_test/hook-status-repair-api-test.js +152 -152
- package/_site/_test/hook-trigger-test.js +85 -85
- package/_site/_test/import-preflight-api-test.js +234 -233
- package/_site/_test/index-writer-concurrency-test.js +135 -135
- package/_site/_test/integration-adapters-test.js +171 -171
- package/_site/_test/integration-surface-coverage-test.js +164 -164
- package/_site/_test/knowledge-language-control-test.js +170 -170
- package/_site/_test/knowledge-promotion-recovery-test.js +260 -260
- package/_site/_test/knowledge-query-test.js +54 -54
- package/_site/_test/knowledge-retrieval-service-test.js +77 -77
- package/_site/_test/knowledge-storage-startup-test.js +52 -52
- package/_site/_test/knowledge-store-logs-supervision-test.js +89 -89
- package/_site/_test/legacy-forward-compat-test.js +257 -257
- package/_site/_test/legacy-project-upgrade-e2e-test.js +363 -363
- package/_site/_test/logging-api-test.js +89 -89
- package/_site/_test/logging-sse-no-gap-test.js +88 -88
- package/_site/_test/logging-ui-test.js +106 -104
- package/_site/_test/markdown-delta-overlay-test.js +85 -85
- package/_site/_test/markdown-maintenance-api-test.js +75 -75
- package/_site/_test/mcp-server-test.js +149 -149
- package/_site/_test/module-artifact-integrity-test.js +27 -0
- package/_site/_test/module-boundary-test.js +30 -0
- package/_site/_test/module-bridge-eventbridge-test.js +7 -0
- package/_site/_test/module-model-configuration-test.js +43 -0
- package/_site/_test/module-process-lifecycle-test.js +24 -0
- package/_site/_test/module-stream-proxy-test.js +34 -0
- package/_site/_test/non-release-ci-test.js +34 -34
- package/_site/_test/offline-boundary-isolation-test.js +32 -32
- package/_site/_test/p0-data-migration-characterization-test.js +37 -37
- package/_site/_test/p0-e2e-gate-test.js +347 -347
- package/_site/_test/packaged-ui-smoke-test.js +11 -9
- package/_site/_test/path-consistency-test.js +151 -151
- package/_site/_test/pending-sweep-test.js +9 -9
- package/_site/_test/post-commit-automation-test.js +87 -87
- package/_site/_test/product-diagnostics-ui-test.js +75 -0
- package/_site/_test/product-import-ui-test.js +92 -0
- package/_site/_test/project-delete-recovery-test.js +64 -64
- package/_site/_test/project-goal-editor-test.js +144 -144
- package/_site/_test/project-layout-v2-migration-test.js +127 -127
- package/_site/_test/project-lifecycle-transaction-test.js +106 -106
- package/_site/_test/prompt-settings-test.js +115 -115
- package/_site/_test/protected-architecture-gate-test.js +122 -122
- package/_site/_test/refactor-characterization-test.js +36 -36
- package/_site/_test/release-version-sync-test.js +1 -1
- package/_site/_test/requirement-recorder-test.js +173 -173
- package/_site/_test/run-all-tests.js +159 -156
- package/_site/_test/server-runtime-migration-safety-test.js +27 -27
- package/_site/_test/shared-contracts-test.js +58 -58
- package/_site/_test/startup-analysis-disabled-test.js +10 -10
- package/_site/_test/storage-foundation-test.js +78 -78
- package/_site/_test/structured-logger-test.js +101 -101
- package/_site/_test/tracking-start-test.js +108 -108
- package/_site/_test/v4122-upgrade-data-contract-test.js +56 -56
- package/_site/_test/workbench-permission-test.js +117 -117
- package/_site/_test/workspace-ui-contract-test.js +28 -43
- package/_site/lib/ai-profile-resolver.js +78 -78
- package/_site/lib/ai-workspace.js +101 -101
- package/_site/lib/automation-config.js +140 -140
- package/_site/lib/bridge-adapter.js +1 -0
- package/_site/lib/bridge-consumer-service.js +402 -402
- package/_site/lib/claude-cli-runner.js +1510 -1510
- package/_site/lib/commit-conversation-binder.js +234 -234
- package/_site/lib/commit-processing-ledger.js +27 -27
- package/_site/lib/commit-prompt.js +202 -202
- package/_site/lib/commit-reconciler.js +406 -406
- package/_site/lib/contracts.js +284 -279
- package/_site/lib/conversation-query-service.js +144 -144
- package/_site/lib/conversation-store.js +385 -385
- package/_site/lib/data-dir.js +74 -74
- package/_site/lib/data-state-classifier.js +40 -40
- package/_site/lib/engine-cutover.js +97 -0
- package/_site/lib/evidence-bundle.js +228 -228
- package/_site/lib/folder-picker-output.js +21 -21
- package/_site/lib/git-runner.js +62 -62
- package/_site/lib/github-team-store.js +1172 -1172
- package/_site/lib/hook-manager.js +203 -202
- package/_site/lib/index-service.js +173 -173
- package/_site/lib/integration-installer.js +907 -907
- package/_site/lib/kb-framework.js +176 -176
- package/_site/lib/kb-validator.js +124 -124
- package/_site/lib/knowledge-promotion.js +435 -435
- package/_site/lib/knowledge-retrieval-service.js +401 -401
- package/_site/lib/knowledge-tool-runtime.js +359 -359
- package/_site/lib/legacy-data-manifest.js +26 -26
- package/_site/lib/llm-client.js +161 -161
- package/_site/lib/markdown-knowledge-indexer.js +230 -230
- package/_site/lib/migration-service.js +442 -442
- package/_site/lib/module-bridge.js +198 -33
- package/_site/lib/post-commit-automation.js +87 -87
- package/_site/lib/project-lifecycle-service.js +519 -497
- package/_site/lib/project-store.js +268 -262
- package/_site/lib/requirement-recorder.js +278 -278
- package/_site/lib/runtime-endpoint.js +155 -155
- package/_site/lib/scanner.js +298 -298
- package/_site/lib/server-app.js +1590 -1520
- package/_site/lib/settings-store.js +133 -113
- package/_site/lib/storage-layout.js +162 -162
- package/_site/lib/structured-logger.js +574 -574
- package/_site/scripts/folder-picker.ps1 +156 -156
- package/_site/scripts/hook-trigger.js +157 -156
- package/_site/scripts/install-module-candidates.js +69 -0
- package/_site/scripts/pack-module-candidates.js +72 -0
- package/_site/scripts/sync-release-version.js +2 -2
- package/_site/scripts/vendor-modules.js +47 -0
- package/_site/scripts/verify-module-runtime.js +45 -0
- package/_site/scripts/verify-product-runtime.js +34 -0
- package/bin/project-knowledge-mcp.js +194 -194
- package/docs/README.zh-CN.md +34 -25
- package/docs/project-registry-schema.md +22 -22
- package/docs/testing-strategy.md +33 -33
- package/module-runtime-manifest.json +220 -0
- package/package.json +13 -9
- package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
- package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
- package/plugins/project-knowledge/.mcp.json +1 -1
- package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
- package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
- package/templates/project-readme.md +34 -34
- package/ui/favicon.svg +38 -38
- package/ui/index.html +51 -149
- package/ui/product.css +9 -0
- package/ui/product.js +386 -0
- package/vendor-manifest.json +46 -0
- package/_site/_test/import-ui-flow-test.js +0 -171
- package/_site/_test/project-control-panel-task14-test.js +0 -63
- package/_site/_test/task15-20-ui-flow-test.js +0 -148
- package/_site/_test/ui-i18n-toggle-test.js +0 -114
- package/_site/_test/ui-smoke-test.js +0 -73
- package/ui/app.css +0 -58
- package/ui/app.js +0 -607
- package/ui/i18n.js +0 -146
|
@@ -1,262 +1,268 @@
|
|
|
1
|
-
const fs = require('fs');
|
|
2
|
-
const path = require('path');
|
|
3
|
-
const crypto = require('crypto');
|
|
4
|
-
const {
|
|
5
|
-
SCHEMAS,
|
|
6
|
-
DomainError,
|
|
7
|
-
assertMutableProjectPatch,
|
|
8
|
-
validateProjectId,
|
|
9
|
-
} = require('./contracts');
|
|
10
|
-
const AtomicFile = require('./atomic-file');
|
|
11
|
-
const { StorageLayout } = require('./storage-layout');
|
|
12
|
-
|
|
13
|
-
const processQueues = new Map();
|
|
14
|
-
|
|
15
|
-
function defaultProjectConfig(projectId, input = {}) {
|
|
16
|
-
validateProjectId(projectId);
|
|
17
|
-
const createdAt = String(input.createdAt || new Date().toISOString());
|
|
18
|
-
return {
|
|
19
|
-
schema: SCHEMAS.projectConfig,
|
|
20
|
-
schemaVersion: 2,
|
|
21
|
-
projectId,
|
|
22
|
-
displayName: String(input.displayName || projectId),
|
|
23
|
-
storageName: String(input.storageName || projectId),
|
|
24
|
-
repoPath: path.resolve(String(input.repoPath || '.')),
|
|
25
|
-
knowledgePath: path.resolve(String(input.knowledgePath || '.')),
|
|
26
|
-
enabled: input.enabled !== false,
|
|
27
|
-
createdAt,
|
|
28
|
-
teamBinding: input.teamBinding || null,
|
|
29
|
-
aiProfileId: input.aiProfileId || null,
|
|
30
|
-
knowledgeLanguage: input.knowledgeLanguage || 'zh-CN',
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
if (
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
if (
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
const
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
this.
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
const
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
1
|
+
const fs = require('fs');
|
|
2
|
+
const path = require('path');
|
|
3
|
+
const crypto = require('crypto');
|
|
4
|
+
const {
|
|
5
|
+
SCHEMAS,
|
|
6
|
+
DomainError,
|
|
7
|
+
assertMutableProjectPatch,
|
|
8
|
+
validateProjectId,
|
|
9
|
+
} = require('./contracts');
|
|
10
|
+
const AtomicFile = require('./atomic-file');
|
|
11
|
+
const { StorageLayout } = require('./storage-layout');
|
|
12
|
+
|
|
13
|
+
const processQueues = new Map();
|
|
14
|
+
|
|
15
|
+
function defaultProjectConfig(projectId, input = {}) {
|
|
16
|
+
validateProjectId(projectId);
|
|
17
|
+
const createdAt = String(input.createdAt || new Date().toISOString());
|
|
18
|
+
return {
|
|
19
|
+
schema: SCHEMAS.projectConfig,
|
|
20
|
+
schemaVersion: 2,
|
|
21
|
+
projectId,
|
|
22
|
+
displayName: String(input.displayName || projectId),
|
|
23
|
+
storageName: String(input.storageName || projectId),
|
|
24
|
+
repoPath: path.resolve(String(input.repoPath || '.')),
|
|
25
|
+
knowledgePath: path.resolve(String(input.knowledgePath || '.')),
|
|
26
|
+
enabled: input.enabled !== false,
|
|
27
|
+
createdAt,
|
|
28
|
+
teamBinding: input.teamBinding || null,
|
|
29
|
+
aiProfileId: input.aiProfileId || null,
|
|
30
|
+
knowledgeLanguage: input.knowledgeLanguage || 'zh-CN',
|
|
31
|
+
brainId: input.brainId || 'brain-default',
|
|
32
|
+
domainId: input.domainId || null,
|
|
33
|
+
relatedProjectIds: Array.isArray(input.relatedProjectIds) ? [...new Set(input.relatedProjectIds)] : [],
|
|
34
|
+
repoIdentity: input.repoIdentity || null,
|
|
35
|
+
legacyExtensions: input.legacyExtensions || {},
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function defaultProjectState(input = {}) {
|
|
40
|
+
return {
|
|
41
|
+
schema: SCHEMAS.projectState,
|
|
42
|
+
schemaVersion: 2,
|
|
43
|
+
revision: Number.isInteger(input.revision) ? input.revision : 0,
|
|
44
|
+
trackingStartCommit: input.trackingStartCommit || null,
|
|
45
|
+
lastAnalyzedCommit: input.lastAnalyzedCommit || null,
|
|
46
|
+
conversationBaselineCursor: Number.isInteger(input.conversationBaselineCursor) && input.conversationBaselineCursor >= 0
|
|
47
|
+
? input.conversationBaselineCursor
|
|
48
|
+
: null,
|
|
49
|
+
conversation: {
|
|
50
|
+
lastConsumedCursor: Number.isInteger(input.conversation && input.conversation.lastConsumedCursor)
|
|
51
|
+
? input.conversation.lastConsumedCursor
|
|
52
|
+
: null,
|
|
53
|
+
captureStatus: input.conversation && input.conversation.captureStatus || 'unavailable',
|
|
54
|
+
lastError: input.conversation && input.conversation.lastError || null,
|
|
55
|
+
},
|
|
56
|
+
trackingMode: input.trackingMode === 'empty-repo' ? 'empty-repo' : 'normal',
|
|
57
|
+
analysis: {
|
|
58
|
+
status: input.analysis && input.analysis.status || 'idle',
|
|
59
|
+
activeClaim: input.analysis && input.analysis.activeClaim || null,
|
|
60
|
+
lastError: input.analysis && input.analysis.lastError || null,
|
|
61
|
+
rescanRequested: input.analysis && input.analysis.rescanRequested === true,
|
|
62
|
+
},
|
|
63
|
+
index: {
|
|
64
|
+
dirty: input.index && input.index.dirty === true,
|
|
65
|
+
generation: Number(input.index && input.index.generation || 0),
|
|
66
|
+
sinceCommit: input.index && input.index.sinceCommit || null,
|
|
67
|
+
lastError: input.index && input.index.lastError || null,
|
|
68
|
+
},
|
|
69
|
+
hook: {
|
|
70
|
+
managedVersion: Number(input.hook && input.hook.managedVersion || 0),
|
|
71
|
+
migrationVersion: Number(input.hook && input.hook.migrationVersion || 0),
|
|
72
|
+
lastVerifiedAt: input.hook && input.hook.lastVerifiedAt || '',
|
|
73
|
+
},
|
|
74
|
+
updatedAt: input.updatedAt || new Date().toISOString(),
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function validateProjectConfig(config, expectedProjectId) {
|
|
79
|
+
if (!config || typeof config !== 'object' || Array.isArray(config)) throw new DomainError('DATA_CORRUPT', 'Project config is invalid.', { status: 500 });
|
|
80
|
+
if (config.schema !== SCHEMAS.projectConfig || config.schemaVersion !== 2) throw new DomainError('SCHEMA_UNSUPPORTED', 'Unsupported project config schema.', { status: 409 });
|
|
81
|
+
validateProjectId(config.projectId);
|
|
82
|
+
if (expectedProjectId && config.projectId !== expectedProjectId) throw new DomainError('DATA_CORRUPT', 'Project config identity mismatch.', { status: 500 });
|
|
83
|
+
if (!config.storageName || !config.repoPath || !config.knowledgePath || !config.createdAt) throw new DomainError('DATA_CORRUPT', 'Project config is incomplete.', { status: 500 });
|
|
84
|
+
config.brainId = config.brainId || 'brain-default';
|
|
85
|
+
config.domainId = config.domainId || null;
|
|
86
|
+
validateProjectId(config.brainId);
|
|
87
|
+
if (config.domainId) validateProjectId(config.domainId);
|
|
88
|
+
return config;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function validateProjectState(state) {
|
|
92
|
+
if (!state || typeof state !== 'object' || Array.isArray(state)) throw new DomainError('DATA_CORRUPT', 'Project state is invalid.', { status: 500 });
|
|
93
|
+
if (state.schema !== SCHEMAS.projectState || state.schemaVersion !== 2) throw new DomainError('SCHEMA_UNSUPPORTED', 'Unsupported project state schema.', { status: 409 });
|
|
94
|
+
if (!Number.isInteger(state.revision) || !state.analysis || !state.index || !state.hook) throw new DomainError('DATA_CORRUPT', 'Project state is incomplete.', { status: 500 });
|
|
95
|
+
if (!['normal', 'empty-repo'].includes(state.trackingMode)) throw new DomainError('DATA_CORRUPT', 'Project tracking mode is invalid.', { status: 500 });
|
|
96
|
+
if (!Object.prototype.hasOwnProperty.call(state, 'conversationBaselineCursor')) state.conversationBaselineCursor = null;
|
|
97
|
+
if (!state.conversation || typeof state.conversation !== 'object') {
|
|
98
|
+
state.conversation = { lastConsumedCursor: null, captureStatus: 'unavailable', lastError: null };
|
|
99
|
+
}
|
|
100
|
+
return state;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
class ProjectStore {
|
|
104
|
+
constructor(options = {}) {
|
|
105
|
+
this.layout = options.layout || new StorageLayout(options);
|
|
106
|
+
this.atomic = options.atomic || AtomicFile;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
async withProjectLock(projectId, fn, options = {}) {
|
|
110
|
+
validateProjectId(projectId);
|
|
111
|
+
const previous = processQueues.get(projectId) || Promise.resolve();
|
|
112
|
+
let releaseQueue;
|
|
113
|
+
const current = new Promise(resolve => { releaseQueue = resolve; });
|
|
114
|
+
const queued = previous.then(() => current);
|
|
115
|
+
processQueues.set(projectId, queued);
|
|
116
|
+
await previous;
|
|
117
|
+
try {
|
|
118
|
+
return await this.atomic.withFileLock(this.layout.getProjectLockPath(projectId), fn, options);
|
|
119
|
+
} finally {
|
|
120
|
+
releaseQueue();
|
|
121
|
+
if (processQueues.get(projectId) === queued) processQueues.delete(projectId);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
readConfig(projectId) {
|
|
126
|
+
validateProjectId(projectId);
|
|
127
|
+
return this.atomic.readJsonStrict(this.layout.getProjectConfigPath(projectId), {
|
|
128
|
+
category: 'project-config',
|
|
129
|
+
validate: config => validateProjectConfig(config, projectId),
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
readState(projectId) {
|
|
134
|
+
validateProjectId(projectId);
|
|
135
|
+
return this.atomic.readJsonStrict(this.layout.getProjectStatePath(projectId), {
|
|
136
|
+
category: 'project-state',
|
|
137
|
+
validate: validateProjectState,
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
async create(projectId, configInput, stateInput = {}) {
|
|
142
|
+
validateProjectId(projectId);
|
|
143
|
+
return this.withProjectLock(projectId, async () => {
|
|
144
|
+
const dir = this.layout.getProjectMetadataDir(projectId);
|
|
145
|
+
const configPath = this.layout.getProjectConfigPath(projectId);
|
|
146
|
+
const statePath = this.layout.getProjectStatePath(projectId);
|
|
147
|
+
if (fs.existsSync(configPath) || fs.existsSync(statePath)) throw new DomainError('INVALID_ARGUMENT', 'Project metadata already exists.', { status: 409 });
|
|
148
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
149
|
+
const config = validateProjectConfig(defaultProjectConfig(projectId, configInput), projectId);
|
|
150
|
+
const state = validateProjectState(defaultProjectState(stateInput));
|
|
151
|
+
try {
|
|
152
|
+
this.atomic.writeJsonAtomic(configPath, config);
|
|
153
|
+
this.atomic.writeJsonAtomic(statePath, state);
|
|
154
|
+
} catch (error) {
|
|
155
|
+
try { if (fs.existsSync(configPath)) fs.unlinkSync(configPath); } catch {
|
|
156
|
+
// Preserve the original create error; the lifecycle journal records rollback residue.
|
|
157
|
+
}
|
|
158
|
+
try { if (fs.existsSync(statePath)) fs.unlinkSync(statePath); } catch {
|
|
159
|
+
// Preserve the original create error; the lifecycle journal records rollback residue.
|
|
160
|
+
}
|
|
161
|
+
throw error;
|
|
162
|
+
}
|
|
163
|
+
return { config, state };
|
|
164
|
+
});
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
async updateConfig(projectId, patch, options = {}) {
|
|
168
|
+
validateProjectId(projectId);
|
|
169
|
+
assertMutableProjectPatch(patch, {
|
|
170
|
+
allowKnowledgePath: options.allowKnowledgePath === true,
|
|
171
|
+
allowRepoPath: options.allowRepoPath === true,
|
|
172
|
+
});
|
|
173
|
+
return this.withProjectLock(projectId, async () => {
|
|
174
|
+
const current = this.readConfig(projectId);
|
|
175
|
+
const next = { ...current, ...patch, projectId: current.projectId, storageName: current.storageName, createdAt: current.createdAt };
|
|
176
|
+
validateProjectConfig(next, projectId);
|
|
177
|
+
this.atomic.writeJsonAtomic(this.layout.getProjectConfigPath(projectId), next);
|
|
178
|
+
return next;
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Deliberate one-way upgrade: write a canonical repo-identity/v1 onto a
|
|
184
|
+
* project that was imported before v4.2.3 (repoIdentity null or a legacy
|
|
185
|
+
* { commonDir }-only shape). Only the Bridge consumer migration calls
|
|
186
|
+
* this; it is intentionally not reachable through the generic config
|
|
187
|
+
* update path. Rewrites are refused once a v1 identity exists.
|
|
188
|
+
*/
|
|
189
|
+
async migrateRepoIdentity(projectId, repoIdentity) {
|
|
190
|
+
validateProjectId(projectId);
|
|
191
|
+
if (!repoIdentity || typeof repoIdentity !== 'object'
|
|
192
|
+
|| repoIdentity.schema !== 'repo-identity/v1'
|
|
193
|
+
|| typeof repoIdentity.workspaceId !== 'string'
|
|
194
|
+
|| typeof repoIdentity.workspaceRoot !== 'string' || !repoIdentity.workspaceRoot) {
|
|
195
|
+
throw new DomainError('INVALID_ARGUMENT', 'migrateRepoIdentity requires a canonical repo-identity/v1 object.');
|
|
196
|
+
}
|
|
197
|
+
return this.withProjectLock(projectId, async () => {
|
|
198
|
+
const current = this.readConfig(projectId);
|
|
199
|
+
if (current.repoIdentity && typeof current.repoIdentity.workspaceId === 'string') {
|
|
200
|
+
return current;
|
|
201
|
+
}
|
|
202
|
+
const next = { ...current, repoIdentity };
|
|
203
|
+
validateProjectConfig(next, projectId);
|
|
204
|
+
this.atomic.writeJsonAtomic(this.layout.getProjectConfigPath(projectId), next);
|
|
205
|
+
return next;
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
async updateState(projectId, updater, options = {}) {
|
|
210
|
+
validateProjectId(projectId);
|
|
211
|
+
if (typeof updater !== 'function') throw new DomainError('INVALID_ARGUMENT', 'State updater must be a function.');
|
|
212
|
+
return this.withProjectLock(projectId, async () => {
|
|
213
|
+
const current = this.readState(projectId);
|
|
214
|
+
if (Number.isInteger(options.expectedRevision) && current.revision !== options.expectedRevision) {
|
|
215
|
+
throw new DomainError('PROJECT_BUSY', 'Project state revision changed.', { status: 409, retryable: true });
|
|
216
|
+
}
|
|
217
|
+
const draft = JSON.parse(JSON.stringify(current));
|
|
218
|
+
const updated = await updater(draft);
|
|
219
|
+
const next = updated && typeof updated === 'object' ? updated : draft;
|
|
220
|
+
next.schema = SCHEMAS.projectState;
|
|
221
|
+
next.schemaVersion = 2;
|
|
222
|
+
next.revision = current.revision + 1;
|
|
223
|
+
next.updatedAt = new Date().toISOString();
|
|
224
|
+
validateProjectState(next);
|
|
225
|
+
this.atomic.writeJsonAtomic(this.layout.getProjectStatePath(projectId), next);
|
|
226
|
+
return next;
|
|
227
|
+
});
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
async appendRequirement(projectId, record) {
|
|
231
|
+
validateProjectId(projectId);
|
|
232
|
+
if (!record || typeof record !== 'object' || record.schema !== SCHEMAS.requirement || record.projectId !== projectId || !record.id) {
|
|
233
|
+
throw new DomainError('INVALID_ARGUMENT', 'Requirement record is invalid.');
|
|
234
|
+
}
|
|
235
|
+
const filePath = this.layout.getProjectRequirementsPath(projectId);
|
|
236
|
+
await this.atomic.appendJsonlLocked(filePath, record, { lockPath: `${filePath}.append.lock` });
|
|
237
|
+
return record;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
readRequirements(projectId) {
|
|
241
|
+
validateProjectId(projectId);
|
|
242
|
+
const filePath = this.layout.getProjectRequirementsPath(projectId);
|
|
243
|
+
if (!fs.existsSync(filePath)) return [];
|
|
244
|
+
const records = [];
|
|
245
|
+
const lines = fs.readFileSync(filePath, 'utf8').split(/\r?\n/);
|
|
246
|
+
for (let index = 0; index < lines.length; index += 1) {
|
|
247
|
+
if (!lines[index].trim()) continue;
|
|
248
|
+
try {
|
|
249
|
+
const record = JSON.parse(lines[index]);
|
|
250
|
+
if (record.schema !== SCHEMAS.requirement || record.projectId !== projectId) throw new Error('schema or project mismatch');
|
|
251
|
+
records.push(record);
|
|
252
|
+
} catch (error) {
|
|
253
|
+
throw new DomainError('DATA_CORRUPT', 'Requirements JSONL is corrupt.', { status: 500, cause: error, details: { line: index + 1 } });
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
return records;
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
generateRequirementId() { return `req-${crypto.randomUUID()}`; }
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
module.exports = {
|
|
263
|
+
ProjectStore,
|
|
264
|
+
defaultProjectConfig,
|
|
265
|
+
defaultProjectState,
|
|
266
|
+
validateProjectConfig,
|
|
267
|
+
validateProjectState,
|
|
268
|
+
};
|