@sanqianx/project-knowledge 5.0.24 → 5.0.26
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 +20 -20
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +1361 -1353
- package/LICENSE +201 -201
- package/NOTICE +5 -5
- package/README.md +349 -349
- package/_modules/knowledge-engine/package.json +1 -1
- package/_modules/knowledge-engine/src/coordinator.js +48 -3
- package/_modules/knowledge-engine/src/runtime/automation-config.js +140 -140
- package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +238 -238
- package/_modules/knowledge-engine/src/runtime/commit-processing-ledger.js +26 -26
- package/_modules/knowledge-engine/src/runtime/commit-prompt.js +193 -193
- package/_modules/knowledge-engine/src/runtime/commit-reconciler.js +394 -394
- package/_modules/knowledge-engine/src/runtime/contracts.js +282 -282
- package/_modules/knowledge-engine/src/runtime/conversation-store.js +389 -389
- package/_modules/knowledge-engine/src/runtime/evidence-bundle.js +228 -228
- package/_modules/knowledge-engine/src/runtime/git-runner.js +62 -62
- package/_modules/knowledge-engine/src/runtime/knowledge-promotion.js +505 -505
- package/_modules/knowledge-engine/src/runtime/knowledge-retrieval-service.js +400 -400
- package/_modules/knowledge-engine/src/runtime/markdown-knowledge-indexer.js +171 -171
- package/_modules/knowledge-engine/src/runtime/scanner.js +298 -298
- package/_modules/knowledge-engine/ui/app.js +23 -2
- package/_site/README.md +30 -30
- package/_site/_test/agent-capture-mcp-ui-test.js +68 -68
- package/_site/_test/agent-capture-ui-test.js +101 -101
- package/_site/_test/ai-profile-resolver-test.js +137 -137
- package/_site/_test/ai-profile-test.js +75 -75
- package/_site/_test/ai-vendor-presets-test.js +91 -91
- package/_site/_test/automatic-context-test.js +70 -70
- 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/bin-cli-test.js +230 -230
- package/_site/_test/bridge-adapter-test.js +95 -95
- package/_site/_test/bridge-consumer-service-test.js +310 -310
- package/_site/_test/candidate-bin-content-test.js +35 -35
- package/_site/_test/candidate-product-assets-test.js +13 -13
- package/_site/_test/candidate-release-contract-test.js +14 -14
- package/_site/_test/capture-hook-dedup-test.js +158 -158
- package/_site/_test/cdp-browser-failure-test.js +103 -103
- package/_site/_test/chat-claudecodeui-match-test.js +92 -92
- package/_site/_test/claude-executable-discovery-test.js +90 -90
- package/_site/_test/claude-session-lifecycle-sweep-test.js +252 -252
- package/_site/_test/claude-workbench-test.js +174 -174
- package/_site/_test/cli-instance-management-test.js +62 -62
- package/_site/_test/client-capture-restart-e2e-test.js +189 -189
- package/_site/_test/codex-conversation-projection-test.js +60 -60
- package/_site/_test/codex-marketplace-scoped-path-test.js +186 -186
- package/_site/_test/codex-notify-capture-e2e-test.js +101 -101
- package/_site/_test/codex-notify-fanout-test.js +141 -134
- package/_site/_test/codex-notify-upgrade-test.js +253 -253
- package/_site/_test/commit-boundary-freeze-test.js +147 -147
- package/_site/_test/commit-conversation-binding-test.js +99 -99
- package/_site/_test/commit-evidence-test.js +110 -110
- package/_site/_test/configuration-generation-test.js +22 -22
- package/_site/_test/context-pack-test.js +200 -200
- package/_site/_test/conversation-api-test.js +119 -119
- package/_site/_test/conversation-origin-test.js +15 -15
- package/_site/_test/conversation-store-test.js +138 -138
- package/_site/_test/cross-repo-isolation-e2e-test.js +187 -187
- package/_site/_test/desktop-browser-compat-test.js +28 -28
- package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
- package/_site/_test/embedding-config-test.js +32 -32
- package/_site/_test/explicit-commit-processor-test.js +37 -37
- package/_site/_test/fixtures/fake-browser-exit.js +10 -10
- package/_site/_test/fixtures/fake-browser-hang.js +10 -10
- package/_site/_test/fixtures/integration-busy-worker.cjs +6 -6
- package/_site/_test/fixtures/make-git-repos.js +92 -92
- package/_site/_test/fixtures/retrieval-gold-queries.json +32 -32
- package/_site/_test/folder-picker-output-test.js +19 -19
- package/_site/_test/fresh-hook-reimport-test.js +53 -53
- package/_site/_test/fresh-product-data-test.js +56 -56
- package/_site/_test/full-integration-e2e-test.js +167 -167
- package/_site/_test/git-path-compatibility-test.js +80 -80
- package/_site/_test/git-validation-test.js +81 -81
- package/_site/_test/glm-ui-refresh-review-test.js +313 -404
- package/_site/_test/harness-isolation-test.js +138 -0
- package/_site/_test/helpers/cdp-browser.js +383 -0
- package/_site/_test/helpers/cdp-network-capture.js +66 -0
- package/_site/_test/helpers/find-chrome.js +34 -0
- package/_site/_test/helpers/free-port.js +8 -0
- package/_site/_test/helpers/logging-ui-fixture.js +131 -0
- package/_site/_test/helpers/module-fixture.js +282 -0
- package/_site/_test/helpers/parallel-engine-advanced-engine-child.js +45 -0
- package/_site/_test/helpers/parallel-engine-advanced-fault-writer.js +171 -0
- package/_site/_test/helpers/parallel-engine-advanced-harness.js +245 -0
- package/_site/_test/helpers/parallel-engine-advanced-standin-analyzer.js +80 -0
- package/_site/_test/helpers/parallel-engine-advanced-ui-host.js +177 -0
- package/_site/_test/helpers/parallel-engine-final-harness.js +314 -0
- package/_site/_test/helpers/parallel-engine-final-standin-analyzer.js +159 -0
- package/_site/_test/helpers/parallel-knowledge-fixture.js +255 -0
- package/_site/_test/helpers/parallel-logging-acceptance-fixture.js +111 -0
- package/_site/_test/helpers/parallel-logging-acceptance-proxy.js +106 -0
- package/_site/_test/helpers/parallel-logging-fix-r2-proxy.js +205 -0
- package/_site/_test/helpers/parallel-logging-integration-5025-env.js +432 -0
- package/_site/_test/helpers/parallel-memory-analyzer.js +81 -0
- package/_site/_test/helpers/parallel-memory-event-bridge.js +128 -0
- package/_site/_test/helpers/parallel-memory-shell.js +470 -0
- package/_site/_test/helpers/parallel-nav-isolation-env.js +389 -0
- package/_site/_test/helpers/parallel-nav-module-ui.js +186 -0
- package/_site/_test/helpers/parallel-nav-proxy.js +148 -0
- package/_site/_test/helpers/parallel-nav-shell.js +361 -0
- package/_site/_test/helpers/parallel-qa-engine-endpoint-guard.js +206 -0
- package/_site/_test/helpers/parallel-qa-engine-endpoint-isolate.js +257 -0
- package/_site/_test/helpers/parallel-retrieval-followup-corpus.js +293 -0
- package/_site/_test/helpers/parallel-retrieval-followup-next-session.js +70 -0
- package/_site/_test/helpers/parallel-retrieval-followup-r2-shell.js +737 -0
- package/_site/_test/helpers/parallel-retrieval-followup-r2-wb-host.js +82 -0
- package/_site/_test/helpers/parallel-retrieval-followup-shell.js +279 -0
- package/_site/_test/helpers/parallel-workbench-fixture.js +371 -0
- package/_site/_test/helpers/parallel-workbench-host.js +80 -0
- package/_site/_test/helpers/parallel-workbench-integration-5025-fixture.js +408 -0
- package/_site/_test/helpers/parallel-workbench-integration-5025-harness.js +593 -0
- package/_site/_test/helpers/parallel-workbench-integration-5025-host.js +70 -0
- package/_site/_test/helpers/parallel-workbench-integration-5025-launcher.js +240 -0
- package/_site/_test/helpers/parallel-workbench-integration-5025-runtime-harness.js +630 -0
- package/_site/_test/helpers/parallel-workbench-source-map.js +196 -0
- package/_site/_test/helpers/spawn-server.js +106 -0
- package/_site/_test/helpers/version-visibility-fixture.js +251 -0
- 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/hook-worktree-test.js +42 -42
- package/_site/_test/import-preflight-api-test.js +234 -234
- package/_site/_test/index-builder-test.js +41 -41
- package/_site/_test/index-error-display-contract-test.js +10 -10
- package/_site/_test/index-writer-concurrency-test.js +135 -135
- package/_site/_test/integration-adapters-test.js +262 -262
- package/_site/_test/integration-auto-repair-test.js +113 -113
- package/_site/_test/integration-capture-setup-test.js +118 -118
- package/_site/_test/integration-intent-test.js +81 -81
- package/_site/_test/integration-runtime-binding-a2-test.js +566 -566
- package/_site/_test/integration-runtime-binding-a3-test.js +227 -227
- package/_site/_test/integration-runtime-binding-test.js +473 -473
- package/_site/_test/integration-status-scan-test.js +29 -29
- package/_site/_test/integration-surface-coverage-test.js +164 -164
- package/_site/_test/kb-framework-test.js +57 -57
- package/_site/_test/kbpath-follow-test.js +63 -63
- package/_site/_test/knowledge-db-test.js +144 -144
- package/_site/_test/knowledge-engine-client-test.js +120 -109
- package/_site/_test/knowledge-language-control-test.js +170 -170
- package/_site/_test/knowledge-maintenance-test.js +40 -40
- 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-scopes-test.js +37 -37
- package/_site/_test/knowledge-storage-location-test.js +28 -28
- package/_site/_test/knowledge-storage-startup-test.js +52 -52
- package/_site/_test/knowledge-store-logs-supervision-test.js +89 -89
- package/_site/_test/launcher-readiness-test.js +80 -80
- package/_site/_test/legacy-claude-session-alias-test.js +106 -106
- package/_site/_test/legacy-routes-removed-test.js +47 -47
- package/_site/_test/legacy-workbench-exclusion-test.js +92 -92
- package/_site/_test/live-gateway-test.js +48 -48
- package/_site/_test/local-marketplace-test.js +16 -16
- package/_site/_test/log-redaction-test.js +58 -58
- 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 +107 -107
- package/_site/_test/markdown-delta-overlay-test.js +85 -85
- package/_site/_test/markdown-maintenance-api-test.js +75 -75
- package/_site/_test/markdown-maintenance-test.js +11 -11
- package/_site/_test/mcp-server-test.js +149 -149
- package/_site/_test/model-context-windows-test.js +89 -89
- package/_site/_test/module-agent-start-proxy-test.js +65 -65
- package/_site/_test/module-artifact-integrity-test.js +27 -27
- package/_site/_test/module-boundary-test.js +30 -30
- package/_site/_test/module-bridge-eventbridge-test.js +202 -202
- package/_site/_test/module-dynamic-port-test.js +118 -118
- package/_site/_test/module-index-proxy-test.js +33 -33
- package/_site/_test/module-model-configuration-test.js +44 -44
- package/_site/_test/module-process-lifecycle-test.js +35 -35
- package/_site/_test/module-stream-proxy-test.js +34 -34
- package/_site/_test/module-terminal-restart-test.js +63 -63
- package/_site/_test/module-wiring-unbind-race-test.js +59 -59
- package/_site/_test/native-context-integrations-test.js +86 -86
- package/_site/_test/non-release-ci-test.js +34 -34
- package/_site/_test/offline-boundary-isolation-test.js +32 -32
- package/_site/_test/orphaned-claim-recovery-test.js +80 -80
- package/_site/_test/package-boundary-test.js +43 -43
- package/_site/_test/package-startup-test.js +56 -56
- package/_site/_test/packaged-ui-smoke-test.js +88 -88
- package/_site/_test/parallel-ci-r9-posix-socket-budget-test.js +156 -0
- package/_site/_test/parallel-engine-advanced-eng005-test.js +136 -0
- package/_site/_test/parallel-engine-advanced-eng006-test.js +171 -0
- package/_site/_test/parallel-engine-advanced-eng007-reconcile-test.js +231 -0
- package/_site/_test/parallel-engine-advanced-eng009-test.js +208 -0
- package/_site/_test/parallel-engine-advanced-eng010-test.js +213 -0
- package/_site/_test/parallel-engine-advanced-eng011-ui-probe.js +459 -0
- package/_site/_test/parallel-engine-final-eng002-test.js +255 -0
- package/_site/_test/parallel-engine-final-eng007-test.js +269 -0
- package/_site/_test/parallel-engine-final-eng011-test.js +197 -0
- package/_site/_test/parallel-engine-final-eng012-test.js +354 -0
- package/_site/_test/parallel-knowledge-client-error-code-test.js +184 -0
- package/_site/_test/parallel-knowledge-engine-test.js +353 -0
- package/_site/_test/parallel-knowledge-retrieval-test.js +292 -0
- package/_site/_test/parallel-knowledge-vector-test.js +168 -0
- package/_site/_test/parallel-linux-ci-r7-log007-day-test.js +110 -0
- package/_site/_test/parallel-logging-acceptance-log003-test.js +224 -0
- package/_site/_test/parallel-logging-acceptance-log004-test.js +231 -0
- package/_site/_test/parallel-logging-acceptance-log005-test.js +208 -0
- package/_site/_test/parallel-logging-acceptance-log006-test.js +214 -0
- package/_site/_test/parallel-logging-acceptance-log007-test.js +223 -0
- package/_site/_test/parallel-logging-acceptance-log008-test.js +180 -0
- package/_site/_test/parallel-logging-fix-r2-crash-probe.js +271 -0
- package/_site/_test/parallel-logging-fix-r2-gap-test.js +294 -0
- package/_site/_test/parallel-logging-fix-r2-normalhook-test.js +330 -0
- package/_site/_test/parallel-logging-integration-5025-portability-test.js +554 -0
- package/_site/_test/parallel-memory-candidate-test.js +301 -0
- package/_site/_test/parallel-memory-manual-test.js +197 -0
- package/_site/_test/parallel-memory-scope-test.js +228 -0
- package/_site/_test/parallel-memory-source-test.js +227 -0
- package/_site/_test/parallel-memory-sync-test.js +238 -0
- package/_site/_test/parallel-memory-view-r8-reload-gate-test.js +123 -0
- package/_site/_test/parallel-nav-failure-test.js +119 -0
- package/_site/_test/parallel-nav-isolation-test.js +308 -0
- package/_site/_test/parallel-nav-isolation-vector-path-test.js +90 -0
- package/_site/_test/parallel-nav-offline-test.js +272 -0
- package/_site/_test/parallel-nav-operability-test.js +257 -0
- package/_site/_test/parallel-nav-switch-test.js +247 -0
- package/_site/_test/parallel-nav-theme-test.js +130 -0
- package/_site/_test/parallel-nav-viewport-test.js +310 -0
- package/_site/_test/parallel-qa-engine-endpoint-guard-test.js +273 -0
- package/_site/_test/parallel-retrieval-followup-citation-test.js +219 -0
- package/_site/_test/parallel-retrieval-followup-corpus-test.js +287 -0
- package/_site/_test/parallel-workbench-independent-host.js +262 -0
- package/_site/_test/parallel-workbench-integration-5025-abort-probe.js +340 -0
- package/_site/_test/parallel-workbench-integration-5025-drafts-probe.js +588 -0
- package/_site/_test/parallel-workbench-integration-5025-env-check.js +317 -0
- package/_site/_test/parallel-workbench-integration-5025-model-probe.js +342 -0
- package/_site/_test/parallel-workbench-integration-5025-ordering-probe.js +326 -0
- package/_site/_test/parallel-workbench-model-probe.js +336 -0
- package/_site/_test/parallel-workbench-offline-test.js +169 -0
- package/_site/_test/parallel-workbench-provenance-trace.js +134 -0
- package/_site/_test/parallel-workbench-source-match.js +206 -0
- package/_site/_test/parallel-workbench-standalone-turn.js +349 -0
- 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/pr-consumer-contract-test.js +55 -55
- package/_site/_test/product-brand-contract-test.js +25 -25
- package/_site/_test/product-diagnostics-ui-test.js +93 -93
- package/_site/_test/product-empty-state-test.js +148 -0
- package/_site/_test/product-import-ui-test.js +219 -104
- package/_site/_test/product-navigation-test.js +152 -0
- package/_site/_test/product-progress-status-test.js +84 -84
- package/_site/_test/project-delete-recovery-test.js +64 -64
- package/_site/_test/project-domain-create-test.js +91 -0
- package/_site/_test/project-domain-scope-retrieval-test.js +214 -0
- package/_site/_test/project-git-init-confirm-test.js +115 -0
- package/_site/_test/project-goal-editor-test.js +144 -144
- package/_site/_test/project-import-duplicate-alias-test.js +134 -0
- package/_site/_test/project-import-unicode-restart-test.js +140 -0
- package/_site/_test/project-lifecycle-transaction-test.js +106 -106
- package/_site/_test/project-module-partial-recovery-test.js +222 -0
- package/_site/_test/project-remove-running-guard-test.js +79 -79
- package/_site/_test/project-store-test.js +90 -90
- package/_site/_test/project-unbind-late-read-ui-test.js +250 -0
- package/_site/_test/project-unbind-writer-guard-test.js +231 -0
- 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/registry-events-test.js +38 -38
- package/_site/_test/release-version-sync-test.js +115 -115
- package/_site/_test/requirement-binding-test.js +113 -113
- package/_site/_test/requirement-recorder-test.js +173 -173
- package/_site/_test/run-all-tests.js +173 -161
- package/_site/_test/runtime-endpoint-test.js +64 -64
- package/_site/_test/scanner-test.js +83 -83
- package/_site/_test/server-security-test.js +96 -96
- package/_site/_test/sessions-stream-test.js +93 -93
- package/_site/_test/shared-contracts-test.js +58 -58
- package/_site/_test/shared-scope-root-binding-test.js +74 -67
- package/_site/_test/simple-import-test.js +98 -98
- package/_site/_test/startup-analysis-disabled-test.js +16 -16
- package/_site/_test/storage-foundation-test.js +78 -78
- package/_site/_test/structured-logger-test.js +101 -101
- package/_site/_test/t07b-cln-005-coverage-test.js +212 -0
- package/_site/_test/team-knowledge-store-sparse-checkout-test.js +196 -196
- package/_site/_test/team-knowledge-store-test.js +132 -132
- package/_site/_test/test-server-cleanup-test.js +35 -35
- package/_site/_test/test-server-module-isolation-test.js +37 -37
- package/_site/_test/tracking-start-test.js +144 -144
- package/_site/_test/vector-storage-root-test.js +75 -75
- package/_site/_test/version-visibility-browser-probe.js +249 -0
- package/_site/_test/version-visibility-test.js +92 -0
- package/_site/_test/workbench-context-receipts-test.js +22 -22
- package/_site/_test/workbench-permission-test.js +117 -117
- package/_site/_test/zcode-capture-integration-test.js +112 -112
- package/_site/lib/ai-profile-resolver.js +78 -78
- package/_site/lib/ai-vendor-presets.js +83 -83
- package/_site/lib/ai-workspace.js +104 -104
- package/_site/lib/atomic-file.js +204 -204
- package/_site/lib/automation-config.js +140 -140
- package/_site/lib/bridge-adapter.js +260 -260
- package/_site/lib/bridge-consumer-service.js +402 -402
- package/_site/lib/capture-hook-config.js +108 -108
- package/_site/lib/claude-cli-runner.js +1599 -1599
- package/_site/lib/cli-instances.js +43 -43
- package/_site/lib/codex-context-status.js +17 -17
- package/_site/lib/codex-notify-config.js +193 -193
- package/_site/lib/commit-conversation-binder.js +247 -247
- package/_site/lib/commit-processing-ledger.js +27 -27
- package/_site/lib/commit-prompt.js +202 -202
- package/_site/lib/commit-reconciler.js +444 -444
- package/_site/lib/context-pack-builder.js +299 -299
- package/_site/lib/contracts.js +291 -291
- package/_site/lib/conversation-exclusions.js +204 -204
- package/_site/lib/conversation-query-service.js +161 -161
- package/_site/lib/conversation-store.js +387 -387
- package/_site/lib/data-dir.js +13 -13
- package/_site/lib/embedding-service.js +85 -85
- package/_site/lib/engine-connection.js +93 -93
- package/_site/lib/engine-knowledge-client.js +76 -72
- package/_site/lib/evidence-bundle.js +228 -228
- package/_site/lib/folder-picker-output.js +24 -24
- package/_site/lib/git-path.js +14 -14
- package/_site/lib/git-runner.js +62 -62
- package/_site/lib/github-team-store.js +1175 -1175
- package/_site/lib/hook-manager.js +203 -203
- package/_site/lib/index-builder.js +157 -157
- package/_site/lib/index-service.js +173 -173
- package/_site/lib/integration-auto-repair.js +77 -77
- package/_site/lib/integration-installer.js +1240 -1240
- package/_site/lib/integration-intent.js +88 -88
- package/_site/lib/integration-status-scan.js +99 -99
- package/_site/lib/integration-status-worker.js +14 -14
- package/_site/lib/kb-framework.js +191 -191
- package/_site/lib/kb-validator.js +124 -124
- package/_site/lib/knowledge-db.js +363 -363
- package/_site/lib/knowledge-promotion.js +435 -435
- package/_site/lib/knowledge-retrieval-service.js +401 -401
- package/_site/lib/knowledge-schema.js +121 -121
- package/_site/lib/knowledge-tool-runtime.js +366 -366
- package/_site/lib/live-gateway.js +78 -78
- package/_site/lib/llm-client.js +173 -173
- package/_site/lib/markdown-knowledge-indexer.js +230 -230
- package/_site/lib/model-context-windows.js +82 -82
- package/_site/lib/module-bridge.js +874 -874
- package/_site/lib/module-port-resolver.js +57 -57
- package/_site/lib/post-commit-automation.js +141 -141
- package/_site/lib/product-data.js +35 -35
- package/_site/lib/project-lifecycle-service.js +554 -554
- package/_site/lib/project-registry-store.js +129 -129
- package/_site/lib/project-store.js +268 -268
- package/_site/lib/prompt-registry.js +148 -148
- package/_site/lib/public-version-info.js +37 -0
- package/_site/lib/registry-events.js +16 -16
- package/_site/lib/requirement-adapters.js +10 -10
- package/_site/lib/requirement-binder.js +112 -112
- package/_site/lib/requirement-recorder.js +278 -278
- package/_site/lib/runtime-control.js +89 -89
- package/_site/lib/runtime-endpoint.js +160 -160
- package/_site/lib/scanner.js +298 -298
- package/_site/lib/server-app.js +1672 -1664
- package/_site/lib/settings-store.js +153 -153
- package/_site/lib/storage-layout.js +166 -166
- package/_site/lib/structured-logger.js +574 -574
- package/_site/lib/zcode-context-integration.js +60 -60
- package/_site/scripts/codex-notify-fanout.cjs +95 -95
- package/_site/scripts/folder-picker.ps1 +156 -156
- package/_site/scripts/hook-trigger.js +158 -158
- package/_site/scripts/install-module-candidates.js +69 -69
- package/_site/scripts/pack-module-candidates.js +89 -89
- package/_site/scripts/sync-product-content.js +28 -28
- package/_site/scripts/sync-release-version.js +164 -164
- package/_site/scripts/vendor-modules.js +49 -49
- package/_site/scripts/verify-module-runtime.js +50 -50
- package/_site/scripts/verify-product-runtime.js +36 -36
- package/_site/scripts/verify-retrieval-gold.js +83 -83
- package/_site/server.js +15 -15
- package/_site/start.bat +26 -26
- package/_site/stop.bat +11 -11
- package/bin/project-knowledge-integrations.js +254 -254
- package/bin/project-knowledge-kb.js +67 -67
- package/bin/project-knowledge-mcp.js +201 -201
- package/bin/project-knowledge.js +269 -170
- package/claude-prompts.json +21 -21
- package/docs/README.zh-CN.md +207 -205
- package/docs/assets/architecture.svg +181 -181
- package/docs/assets/logo.svg +49 -49
- package/docs/fresh-v5-start.md +44 -44
- package/docs/leader-glm-workbench-playbook.md +122 -122
- package/docs/project-registry-schema.md +33 -33
- package/docs/release-5.0.16-acceptance.md +176 -176
- package/docs/release-5.0.17-acceptance.md +117 -117
- package/docs/release-5.0.19-acceptance.md +39 -39
- package/docs/team-knowledge-mode-a-plan.md +73 -73
- package/docs/testing-strategy.md +33 -33
- package/module-runtime-manifest.json +68 -65
- package/package.json +113 -110
- 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/templates/change.md +30 -30
- package/templates/project-readme.md +52 -52
- package/ui/index.html +3 -2
- package/ui/version-info.css +44 -0
- package/ui/version-info.js +24 -0
- package/vendor-manifest.json +55 -55
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// WB-002/WB-001 offline regression — the portable, zero-network slice.
|
|
3
|
+
//
|
|
4
|
+
// Collected by run-all-tests.js (suffix -test.js). Everything here must hold
|
|
5
|
+
// on a bare CI runner:
|
|
6
|
+
// * the hosted module is the REPOSITORY PIN (node_modules/claude-ai-workbench)
|
|
7
|
+
// — never the machine-local installed product and never a D:-only path;
|
|
8
|
+
// * no account, no real profile, no credential: the standalone host runs on
|
|
9
|
+
// its own empty isolated store and the integration host talks only to this
|
|
10
|
+
// test's controlled localhost fixture;
|
|
11
|
+
// * no paid model turn — the real subscription conversations live in
|
|
12
|
+
// parallel-workbench-standalone-turn.js and parallel-workbench-model-probe.js,
|
|
13
|
+
// which are explicitly invoked and NEVER collected by the runner;
|
|
14
|
+
// * budget: the whole file must finish well under 90s.
|
|
15
|
+
//
|
|
16
|
+
// When the claude CLI is absent (CI), the session-creation sub-checks degrade
|
|
17
|
+
// to an explicit SKIPPED_NO_CLI record instead of a false failure; hosting,
|
|
18
|
+
// health, agents, isolated profile store and the integration contract are
|
|
19
|
+
// asserted unconditionally.
|
|
20
|
+
const assert = require('node:assert/strict');
|
|
21
|
+
const fs = require('node:fs');
|
|
22
|
+
const path = require('node:path');
|
|
23
|
+
const fixture = require('./helpers/parallel-workbench-fixture');
|
|
24
|
+
const sourceMap = require('./helpers/parallel-workbench-source-map');
|
|
25
|
+
|
|
26
|
+
const BUDGET_MS = 90000;
|
|
27
|
+
const startedAt = Date.now();
|
|
28
|
+
const results = [];
|
|
29
|
+
function record(caseId, status, detail) {
|
|
30
|
+
results.push({ caseId, status, detail });
|
|
31
|
+
console.log(`CASE ${caseId} ${status} ${JSON.stringify(detail)}`);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
async function getJson(url, options) {
|
|
35
|
+
const response = await fetch(url, { ...options, signal: AbortSignal.timeout(20000) });
|
|
36
|
+
const body = await response.json().catch(() => null);
|
|
37
|
+
return { status: response.status, ok: response.ok, body };
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
async function startHost(layout, moduleRoot, port, mode, extraEnv = {}) {
|
|
41
|
+
return fixture.spawnNode([path.join(__dirname, 'helpers', 'parallel-workbench-host.js')], fixture.hostEnv(layout, {
|
|
42
|
+
PK_WB_MODULE_ROOT: moduleRoot,
|
|
43
|
+
PK_WB_HOST_PORT: String(port),
|
|
44
|
+
PK_WB_HOST_DATA_DIR: layout.dataDir,
|
|
45
|
+
PK_WB_HOST_WORKSPACE: layout.workspace,
|
|
46
|
+
PK_WB_HOST_MODE: mode,
|
|
47
|
+
...extraEnv,
|
|
48
|
+
}));
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
(async () => {
|
|
52
|
+
// The repository pin only — the machine-local installed product is
|
|
53
|
+
// deliberately NOT consulted, so the test stays portable.
|
|
54
|
+
const moduleRoot = sourceMap.resolveRepoTargetPackage();
|
|
55
|
+
assert.ok(moduleRoot, 'the repository pin node_modules/claude-ai-workbench was not found — run npm install');
|
|
56
|
+
const pinVersion = JSON.parse(fs.readFileSync(path.join(moduleRoot, 'packages', 'server', 'package.json'), 'utf8')).version;
|
|
57
|
+
const manifest = sourceMap.loadManifest();
|
|
58
|
+
record('WB-OFF.a-pin-identity', manifest.terminal.version === pinVersion ? 'PASS' : 'FAIL', {
|
|
59
|
+
moduleRoot,
|
|
60
|
+
pinVersion,
|
|
61
|
+
manifestVersion: manifest.terminal.version,
|
|
62
|
+
});
|
|
63
|
+
assert.equal(manifest.terminal.version, pinVersion, 'the repository pin and the runtime manifest disagree');
|
|
64
|
+
|
|
65
|
+
// ---------- standalone host: no engine, no profiles, no account ----------
|
|
66
|
+
const layoutA = fixture.createIsolationLayout('parallel-wb-off');
|
|
67
|
+
const portA = await fixture.freePort();
|
|
68
|
+
const baseA = `http://127.0.0.1:${portA}`;
|
|
69
|
+
const standalone = await startHost(layoutA, moduleRoot, portA, 'standalone');
|
|
70
|
+
let cliAvailable = null;
|
|
71
|
+
try {
|
|
72
|
+
await fixture.waitForHttp(`${baseA}/api/claude-workbench/v1/health`, 30000);
|
|
73
|
+
const health = await getJson(`${baseA}/api/claude-workbench/v1/health`);
|
|
74
|
+
record('WB-OFF.b-standalone-health', health.ok && health.body && health.body.status === 'ok' && health.body.version === pinVersion ? 'PASS' : 'FAIL', {
|
|
75
|
+
status: health.body && health.body.status,
|
|
76
|
+
version: health.body && health.body.version,
|
|
77
|
+
expectVersion: pinVersion,
|
|
78
|
+
});
|
|
79
|
+
assert.equal(health.body.status, 'ok');
|
|
80
|
+
assert.equal(health.body.version, pinVersion);
|
|
81
|
+
|
|
82
|
+
const runtime = await getJson(`${baseA}/api/claude-workbench/v1/runtime`);
|
|
83
|
+
cliAvailable = Boolean(runtime.body && runtime.body.available);
|
|
84
|
+
record('WB-OFF.c-standalone-runtime', runtime.ok && runtime.body && runtime.body.runtime === 'claude-code' ? 'PASS' : 'FAIL', {
|
|
85
|
+
runtime: runtime.body && runtime.body.runtime,
|
|
86
|
+
transport: runtime.body && runtime.body.transport,
|
|
87
|
+
cliAvailable,
|
|
88
|
+
note: 'cliAvailable may be false on a bare CI runner; only the runtime name is asserted',
|
|
89
|
+
});
|
|
90
|
+
assert.equal(runtime.body.runtime, 'claude-code');
|
|
91
|
+
|
|
92
|
+
const agents = await getJson(`${baseA}/api/claude-workbench/v1/agents`);
|
|
93
|
+
const agentIds = agents.body && Array.isArray(agents.body.agents) ? agents.body.agents.map(agent => agent.id) : [];
|
|
94
|
+
record('WB-OFF.d-standalone-agents', agents.ok && agentIds.includes('claude-code') ? 'PASS' : 'FAIL', { agentIds });
|
|
95
|
+
assert.ok(agentIds.includes('claude-code'));
|
|
96
|
+
|
|
97
|
+
const profiles = await getJson(`${baseA}/api/claude-workbench/v1/profiles`);
|
|
98
|
+
const profileCount = Array.isArray(profiles.body && profiles.body.profiles) ? profiles.body.profiles.length : -1;
|
|
99
|
+
record('WB-OFF.e-standalone-profiles-empty', profiles.ok && profileCount === 0 ? 'PASS' : 'FAIL', { profileCount });
|
|
100
|
+
assert.equal(profileCount, 0, 'the isolated profile store must start empty');
|
|
101
|
+
|
|
102
|
+
if (cliAvailable) {
|
|
103
|
+
const session = await getJson(`${baseA}/api/claude-workbench/v1/sessions`, {
|
|
104
|
+
method: 'POST',
|
|
105
|
+
headers: { 'Content-Type': 'application/json' },
|
|
106
|
+
body: JSON.stringify({ context: { contextId: 'wb-off-standalone', workspaceRef: 'wb-fixture' } }),
|
|
107
|
+
});
|
|
108
|
+
const created = session.body && session.body.session;
|
|
109
|
+
record('WB-OFF.f-standalone-session', session.status === 201 && created && created.sessionId ? 'PASS' : 'FAIL', {
|
|
110
|
+
httpStatus: session.status,
|
|
111
|
+
sessionId: created && created.sessionId,
|
|
112
|
+
});
|
|
113
|
+
assert.equal(session.status, 201);
|
|
114
|
+
const knowledge = await getJson(`${baseA}/api/claude-workbench/v1/sessions/${encodeURIComponent(created.sessionId)}/knowledge`);
|
|
115
|
+
record('WB-OFF.g-standalone-knowledge-none', knowledge.ok && knowledge.body && ['disabled', 'not-retrieved'].includes(knowledge.body.status) ? 'PASS' : 'FAIL', {
|
|
116
|
+
knowledgeStatus: knowledge.body && knowledge.body.status,
|
|
117
|
+
});
|
|
118
|
+
assert.ok(['disabled', 'not-retrieved'].includes(knowledge.body.status));
|
|
119
|
+
} else {
|
|
120
|
+
record('WB-OFF.f-standalone-session', 'SKIPPED_NO_CLI', { cliAvailable, reason: 'the claude CLI is not available in this environment; session creation is not asserted offline' });
|
|
121
|
+
record('WB-OFF.g-standalone-knowledge-none', 'SKIPPED_NO_CLI', { cliAvailable });
|
|
122
|
+
}
|
|
123
|
+
} finally {
|
|
124
|
+
standalone.child.kill();
|
|
125
|
+
await standalone.exited;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// ---------- integration host + controlled fixture (localhost only) -------
|
|
129
|
+
const layoutB = fixture.createIsolationLayout('parallel-wb-offint');
|
|
130
|
+
const integrationFixture = await fixture.startIntegrationFixture();
|
|
131
|
+
const portB = await fixture.freePort();
|
|
132
|
+
const baseB = `http://127.0.0.1:${portB}`;
|
|
133
|
+
const integration = await startHost(layoutB, moduleRoot, portB, 'integration', { PK_WB_ENGINE_URL: integrationFixture.url });
|
|
134
|
+
try {
|
|
135
|
+
await fixture.waitForHttp(`${baseB}/api/claude-workbench/v1/health`, 30000);
|
|
136
|
+
const { KnowledgeContext } = require(path.join(moduleRoot, 'packages', 'server', 'lib', 'knowledge-context.js'));
|
|
137
|
+
const context = new KnowledgeContext({ engineUrl: integrationFixture.url });
|
|
138
|
+
const retrieved = await context.retrieve(layoutB.workspace, 'offline integration contract probe', 'project', { sessionId: 'wb-off-contract' });
|
|
139
|
+
const requestSeen = integrationFixture.requests[integrationFixture.requests.length - 1] || null;
|
|
140
|
+
const promptCarried = String(retrieved.prompt || '').includes(integrationFixture.marker);
|
|
141
|
+
record('WB-OFF.h-integration-contract', retrieved.status === 'ready' && promptCarried && requestSeen ? 'PASS' : 'FAIL', {
|
|
142
|
+
fixtureKind: 'controlled-integration-fixture (localhost stand-in; never counted as real knowledge)',
|
|
143
|
+
retrievedStatus: retrieved.status,
|
|
144
|
+
promptCarriedMarker: promptCarried,
|
|
145
|
+
client: requestSeen && requestSeen.body && requestSeen.body.client,
|
|
146
|
+
});
|
|
147
|
+
assert.equal(retrieved.status, 'ready');
|
|
148
|
+
assert.ok(promptCarried);
|
|
149
|
+
assert.equal(requestSeen.body.client, 'workbench');
|
|
150
|
+
} finally {
|
|
151
|
+
integration.child.kill();
|
|
152
|
+
await integration.exited;
|
|
153
|
+
await integrationFixture.close();
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
fixture.removeTree(layoutA.root);
|
|
157
|
+
fixture.removeTree(layoutB.root);
|
|
158
|
+
|
|
159
|
+
const elapsed = Date.now() - startedAt;
|
|
160
|
+
record('WB-OFF.i-budget', elapsed < BUDGET_MS ? 'PASS' : 'FAIL', { elapsedMs: elapsed, budgetMs: BUDGET_MS });
|
|
161
|
+
assert.ok(elapsed < BUDGET_MS, `the offline slice exceeded its ${BUDGET_MS}ms budget: ${elapsed}ms`);
|
|
162
|
+
|
|
163
|
+
const failures = results.filter(entry => entry.status === 'FAIL');
|
|
164
|
+
console.log(`parallel-workbench-offline-test ${failures.length === 0 ? 'PASS' : 'FAIL'} (${results.filter(r => r.status === 'PASS').length} pass, ${failures.length} fail, ${results.filter(r => r.status.startsWith('SKIPPED')).length} skipped) in ${elapsed}ms`);
|
|
165
|
+
if (failures.length) process.exitCode = 1;
|
|
166
|
+
})().catch(error => {
|
|
167
|
+
console.error(error);
|
|
168
|
+
process.exit(1);
|
|
169
|
+
});
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// WB-001 provenance trace — evidence only, never a regression.
|
|
3
|
+
//
|
|
4
|
+
// The canonical source-match script compares trees that exist today. This
|
|
5
|
+
// script answers the other half of the question: which commit of the
|
|
6
|
+
// Workbench source checkout is the installed package actually built from,
|
|
7
|
+
// and which later commit moved the source away from it.
|
|
8
|
+
//
|
|
9
|
+
// It reads Git objects of the source checkout (that is the point of the
|
|
10
|
+
// trace), it never writes to that checkout, and it never changes a pin, the
|
|
11
|
+
// manifest or the vendored tree. It fails loudly when the checkout or the
|
|
12
|
+
// history is unavailable.
|
|
13
|
+
const fs = require('node:fs');
|
|
14
|
+
const path = require('node:path');
|
|
15
|
+
const crypto = require('node:crypto');
|
|
16
|
+
const { execFileSync } = require('node:child_process');
|
|
17
|
+
const sourceMap = require('./helpers/parallel-workbench-source-map');
|
|
18
|
+
|
|
19
|
+
// The Git blob id of a buffer: sha1("blob <length>\0<content>").
|
|
20
|
+
function gitBlobId(buffer) {
|
|
21
|
+
const hash = crypto.createHash('sha1');
|
|
22
|
+
hash.update(`blob ${buffer.length}\0`);
|
|
23
|
+
hash.update(buffer);
|
|
24
|
+
return hash.digest('hex');
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function git(sourceRoot, args) {
|
|
28
|
+
return execFileSync('git', args, { cwd: sourceRoot, windowsHide: true, encoding: 'utf8', maxBuffer: 1 << 26 });
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
// Blob ids of every manifest file at one commit.
|
|
32
|
+
function treeBlobs(sourceRoot, commit) {
|
|
33
|
+
const out = git(sourceRoot, ['ls-tree', '-r', commit]);
|
|
34
|
+
const blobs = new Map();
|
|
35
|
+
for (const line of out.split(/\r?\n/)) {
|
|
36
|
+
const match = /^(\d{6})\s+blob\s+([0-9a-f]{40})\t(.+)$/.exec(line.trim());
|
|
37
|
+
if (match) blobs.set(match[3].replace(/\\/g, '/'), match[2]);
|
|
38
|
+
}
|
|
39
|
+
return blobs;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function main() {
|
|
43
|
+
const manifest = sourceMap.loadManifest();
|
|
44
|
+
const sourceRoot = sourceMap.resolveSourceCheckout();
|
|
45
|
+
if (!sourceRoot) throw new Error('no Workbench source checkout was found (set PK_WB_SOURCE_DIR)');
|
|
46
|
+
const packageRoot = sourceMap.resolveRepoTargetPackage();
|
|
47
|
+
if (!fs.existsSync(packageRoot)) throw new Error(`the pinned target package is missing: ${packageRoot}`);
|
|
48
|
+
|
|
49
|
+
const head = sourceMap.sourceCommitId(sourceRoot);
|
|
50
|
+
const commits = git(sourceRoot, ['rev-list', `--max-count=40`, 'HEAD']).split(/\r?\n/).map(line => line.trim()).filter(Boolean);
|
|
51
|
+
|
|
52
|
+
// The local blob id of each shipped file: the raw bytes and the
|
|
53
|
+
// CRLF-normalised bytes, so a Windows checkout still matches an LF blob.
|
|
54
|
+
const localBlobs = new Map();
|
|
55
|
+
for (const relative of Object.keys(manifest.files)) {
|
|
56
|
+
const content = fs.readFileSync(path.join(packageRoot, relative));
|
|
57
|
+
const normalized = Buffer.from(content.toString('utf8').replace(/\r\n/g, '\n'), 'utf8');
|
|
58
|
+
localBlobs.set(relative, new Set([gitBlobId(content), gitBlobId(normalized)]));
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const matches = [];
|
|
62
|
+
const examined = [];
|
|
63
|
+
for (const commit of commits) {
|
|
64
|
+
const blobs = treeBlobs(sourceRoot, commit);
|
|
65
|
+
let matched = 0;
|
|
66
|
+
let absent = 0;
|
|
67
|
+
const differing = [];
|
|
68
|
+
for (const [relative, ids] of localBlobs) {
|
|
69
|
+
const blob = blobs.get(relative);
|
|
70
|
+
if (!blob) { absent += 1; continue; }
|
|
71
|
+
if (ids.has(blob)) matched += 1;
|
|
72
|
+
else differing.push(relative);
|
|
73
|
+
}
|
|
74
|
+
examined.push({ commit, subject: git(sourceRoot, ['log', '-1', '--format=%s', commit]).trim(), matched, absent, differing: differing.length });
|
|
75
|
+
if (matched === localBlobs.size && absent === 0) matches.push({ commit, subject: git(sourceRoot, ['log', '-1', '--format=%s', commit]).trim() });
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const sourceComparison = sourceMap.compareTree(manifest.files, sourceRoot);
|
|
79
|
+
const differingFiles = sourceComparison.different;
|
|
80
|
+
const provenance = differingFiles.map(relative => ({
|
|
81
|
+
file: relative,
|
|
82
|
+
commitsTouching: sourceMap.commitsTouchingFile(sourceRoot, relative),
|
|
83
|
+
}));
|
|
84
|
+
|
|
85
|
+
// The newest examined commit whose shipped files still match the package.
|
|
86
|
+
const newestMatch = matches.length ? matches[0] : null;
|
|
87
|
+
const newestMatchIndex = newestMatch ? examined.findIndex(entry => entry.commit === newestMatch.commit) : -1;
|
|
88
|
+
const newerThanPackage = newestMatchIndex > 0 ? examined.slice(0, newestMatchIndex) : [];
|
|
89
|
+
|
|
90
|
+
const summary = {
|
|
91
|
+
lane: 'test-workbench',
|
|
92
|
+
file: 'parallel-workbench-provenance-trace.js',
|
|
93
|
+
role: 'evidence-only (reads Git objects of the source checkout; not a regression)',
|
|
94
|
+
manifest: { file: manifest.file, module: manifest.terminal.name, version: manifest.terminal.version, files: manifest.count },
|
|
95
|
+
packageRoot,
|
|
96
|
+
sourceRoot,
|
|
97
|
+
sourceHead: head,
|
|
98
|
+
sourceWorkingTreeClean: sourceMap.sourceWorkingTreeClean(sourceRoot),
|
|
99
|
+
packageEqualsCommit: matches.length ? matches : null,
|
|
100
|
+
newestMatchingCommit: newestMatch,
|
|
101
|
+
commitsNewerThanPackage: newerThanPackage,
|
|
102
|
+
commitsExamined: examined.length,
|
|
103
|
+
examined: examined.slice(0, 12),
|
|
104
|
+
sourceWorkingTreeVsPackage: {
|
|
105
|
+
identical: sourceComparison.identicalCount,
|
|
106
|
+
eolOnly: sourceComparison.eolOnlyCount,
|
|
107
|
+
different: sourceComparison.differentCount,
|
|
108
|
+
missing: sourceComparison.missingCount,
|
|
109
|
+
eolOnlyFiles: sourceComparison.eolOnly,
|
|
110
|
+
differentFiles: sourceComparison.different,
|
|
111
|
+
},
|
|
112
|
+
provenanceOfDifferences: provenance,
|
|
113
|
+
gitHistoryUsed: true,
|
|
114
|
+
networkUsed: false,
|
|
115
|
+
conclusion: newestMatch
|
|
116
|
+
? `the installed package is byte-identical (CRLF-normalised) to the source checkout at ${newestMatch.commit} (${newestMatch.subject}); the checkout head ${head} is ${newerThanPackage.length} commit(s) newer and already differs in ${sourceComparison.differentCount} shipped file(s)`
|
|
117
|
+
: 'no examined commit matches the installed package byte for byte',
|
|
118
|
+
};
|
|
119
|
+
|
|
120
|
+
const target = process.env.PARALLEL_WORKBENCH_EVIDENCE;
|
|
121
|
+
if (target) {
|
|
122
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
123
|
+
fs.writeFileSync(target, JSON.stringify(summary, null, 2), 'utf8');
|
|
124
|
+
}
|
|
125
|
+
console.log(JSON.stringify({ conclusion: summary.conclusion, packageEqualsCommit: summary.packageEqualsCommit, sourceHead: head }, null, 2));
|
|
126
|
+
return summary;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
try {
|
|
130
|
+
main();
|
|
131
|
+
} catch (error) {
|
|
132
|
+
console.error(error);
|
|
133
|
+
process.exitCode = 1;
|
|
134
|
+
}
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// WB-001 — the Workbench source / package / manifest correspondence.
|
|
3
|
+
//
|
|
4
|
+
// What this script proves, with bytes:
|
|
5
|
+
// 1. the currently installed target package (node_modules/claude-ai-workbench,
|
|
6
|
+
// the pin the repository ships) matches module-runtime-manifest.json on
|
|
7
|
+
// every single file;
|
|
8
|
+
// 2. the copy the installed product 5.0.24 actually ships matches the same
|
|
9
|
+
// manifest on every single file;
|
|
10
|
+
// 3. the Workbench source checkout is compared file by file against that
|
|
11
|
+
// manifest, and every difference is classified (identical / EOL-only /
|
|
12
|
+
// really different / missing).
|
|
13
|
+
//
|
|
14
|
+
// What it deliberately does NOT do:
|
|
15
|
+
// * it never judges two trees equal because their version strings match;
|
|
16
|
+
// * it never reads Git history, a remote or any Git object — the source
|
|
17
|
+
// side is compared as the working tree it is today. The historical trace
|
|
18
|
+
// lives in parallel-workbench-provenance-trace.js, which is evidence, not
|
|
19
|
+
// a regression;
|
|
20
|
+
// * it never touches pins, the manifest, the vendored tree or the installed
|
|
21
|
+
// modules.
|
|
22
|
+
//
|
|
23
|
+
// A mismatch is not a failure of this script and is never papered over: it is
|
|
24
|
+
// reported as BLOCKED_SOURCE_MATCH, which is the defined outcome.
|
|
25
|
+
const assert = require('node:assert/strict');
|
|
26
|
+
const fs = require('node:fs');
|
|
27
|
+
const path = require('node:path');
|
|
28
|
+
const sourceMap = require('./helpers/parallel-workbench-source-map');
|
|
29
|
+
|
|
30
|
+
const results = [];
|
|
31
|
+
function record(caseId, status, detail) {
|
|
32
|
+
results.push({ caseId, status, detail });
|
|
33
|
+
console.log(`CASE ${caseId} ${status} ${JSON.stringify(detail)}`);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function summariseComparison(comparison) {
|
|
37
|
+
return {
|
|
38
|
+
root: comparison.root,
|
|
39
|
+
total: comparison.total,
|
|
40
|
+
identical: comparison.identicalCount,
|
|
41
|
+
eolOnly: comparison.eolOnlyCount,
|
|
42
|
+
different: comparison.differentCount,
|
|
43
|
+
missing: comparison.missingCount,
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function main() {
|
|
48
|
+
const manifest = sourceMap.loadManifest();
|
|
49
|
+
const installedProductRoot = sourceMap.resolveInstalledProductRoot();
|
|
50
|
+
const installedProductVersion = installedProductRoot
|
|
51
|
+
? sourceMap.packageIdentity(installedProductRoot)
|
|
52
|
+
: null;
|
|
53
|
+
|
|
54
|
+
const targets = [];
|
|
55
|
+
|
|
56
|
+
// --- the currently installed target package (the repository pin) -------
|
|
57
|
+
const repoTargetRoot = sourceMap.resolveRepoTargetPackage();
|
|
58
|
+
assert.ok(fs.existsSync(repoTargetRoot), `the pinned target package is missing: ${repoTargetRoot}`);
|
|
59
|
+
const repoTargetIdentity = sourceMap.packageIdentity(repoTargetRoot);
|
|
60
|
+
const repoTargetComparison = sourceMap.compareTree(manifest.files, repoTargetRoot);
|
|
61
|
+
targets.push({
|
|
62
|
+
label: 'currently-installed-package:repository-pin',
|
|
63
|
+
role: 'currently-installed-package',
|
|
64
|
+
identity: repoTargetIdentity,
|
|
65
|
+
comparison: summariseComparison(repoTargetComparison),
|
|
66
|
+
});
|
|
67
|
+
assert.equal(
|
|
68
|
+
repoTargetComparison.identicalCount,
|
|
69
|
+
manifest.count,
|
|
70
|
+
`the pinned package does not match the manifest: ${repoTargetComparison.differentCount} different, ${repoTargetComparison.missingCount} missing`,
|
|
71
|
+
);
|
|
72
|
+
assert.equal(repoTargetComparison.differentCount, 0);
|
|
73
|
+
assert.equal(repoTargetComparison.missingCount, 0);
|
|
74
|
+
assert.equal(repoTargetIdentity.name, manifest.terminal.name, 'the pinned package is not the module the manifest describes');
|
|
75
|
+
assert.equal(repoTargetIdentity.version, manifest.terminal.version, 'the pinned package version differs from the manifest');
|
|
76
|
+
|
|
77
|
+
// --- the copy the installed product 5.0.24 ships ----------------------
|
|
78
|
+
const installedModuleRoot = sourceMap.resolveInstalledProductPackage();
|
|
79
|
+
if (!installedModuleRoot) {
|
|
80
|
+
targets.push({
|
|
81
|
+
label: 'currently-installed-package:installed-product',
|
|
82
|
+
role: 'currently-installed-package',
|
|
83
|
+
status: 'BLOCKED_PRODUCT_NOT_INSTALLED',
|
|
84
|
+
detail: 'no installed product tree was found; the repository pin above is the only installed copy that could be proven',
|
|
85
|
+
});
|
|
86
|
+
} else {
|
|
87
|
+
const installedIdentity = sourceMap.packageIdentity(installedModuleRoot);
|
|
88
|
+
const installedComparison = sourceMap.compareTree(manifest.files, installedModuleRoot);
|
|
89
|
+
targets.push({
|
|
90
|
+
label: 'currently-installed-package:installed-product',
|
|
91
|
+
role: 'currently-installed-package',
|
|
92
|
+
product: installedProductVersion ? installedProductVersion.version : null,
|
|
93
|
+
identity: installedIdentity,
|
|
94
|
+
comparison: summariseComparison(installedComparison),
|
|
95
|
+
});
|
|
96
|
+
assert.equal(installedComparison.identicalCount, manifest.count, 'the installed product copy does not match the manifest');
|
|
97
|
+
assert.equal(installedComparison.differentCount, 0);
|
|
98
|
+
assert.equal(installedComparison.missingCount, 0);
|
|
99
|
+
assert.equal(installedIdentity.name, manifest.terminal.name);
|
|
100
|
+
assert.equal(installedIdentity.version, manifest.terminal.version);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// --- the source checkout (a candidate fixture, never "the package") ----
|
|
104
|
+
const sourceRoot = sourceMap.resolveSourceCheckout();
|
|
105
|
+
let sourceLeg = null;
|
|
106
|
+
if (!sourceRoot) {
|
|
107
|
+
sourceLeg = {
|
|
108
|
+
label: 'candidate-fixture:source-checkout',
|
|
109
|
+
role: 'candidate-fixture',
|
|
110
|
+
status: 'BLOCKED_SOURCE_UNAVAILABLE',
|
|
111
|
+
detail: 'no Workbench source checkout was found (set PK_WB_SOURCE_DIR to compare one)',
|
|
112
|
+
};
|
|
113
|
+
} else {
|
|
114
|
+
const sourceComparison = sourceMap.compareTree(manifest.files, sourceRoot);
|
|
115
|
+
const sourceIdentity = sourceMap.packageIdentity(sourceRoot);
|
|
116
|
+
const matchesPackage = sourceComparison.differentCount === 0 && sourceComparison.missingCount === 0;
|
|
117
|
+
sourceLeg = {
|
|
118
|
+
label: 'candidate-fixture:source-checkout',
|
|
119
|
+
role: 'candidate-fixture',
|
|
120
|
+
root: sourceRoot,
|
|
121
|
+
commit: sourceMap.sourceCommitId(sourceRoot),
|
|
122
|
+
workingTreeClean: sourceMap.sourceWorkingTreeClean(sourceRoot),
|
|
123
|
+
identity: sourceIdentity,
|
|
124
|
+
comparison: summariseComparison(sourceComparison),
|
|
125
|
+
eolOnlyFiles: sourceComparison.eolOnly,
|
|
126
|
+
differentFiles: sourceComparison.different,
|
|
127
|
+
missingFiles: sourceComparison.missing,
|
|
128
|
+
matchesInstalledPackage: matchesPackage,
|
|
129
|
+
verdict: matchesPackage ? 'SOURCE_MATCH' : 'BLOCKED_SOURCE_MATCH',
|
|
130
|
+
};
|
|
131
|
+
assert.equal(sourceComparison.missingCount, 0, 'the source checkout is missing files the manifest ships');
|
|
132
|
+
assert.equal(
|
|
133
|
+
sourceComparison.identicalCount + sourceComparison.eolOnlyCount + sourceComparison.differentCount,
|
|
134
|
+
manifest.count,
|
|
135
|
+
'the source comparison did not classify every manifest file',
|
|
136
|
+
);
|
|
137
|
+
}
|
|
138
|
+
targets.push(sourceLeg);
|
|
139
|
+
|
|
140
|
+
// --- per-expected conclusions ------------------------------------------
|
|
141
|
+
const installedLegs = targets.filter(target => target.role === 'currently-installed-package');
|
|
142
|
+
const installedProven = installedLegs.every(leg => leg.status === undefined && leg.comparison && leg.comparison.identical === leg.comparison.total);
|
|
143
|
+
record('WB-001.a-installed-package-matches-manifest', installedProven ? 'PASS' : 'PARTIAL', {
|
|
144
|
+
manifestFiles: manifest.count,
|
|
145
|
+
manifestVersion: manifest.terminal.version,
|
|
146
|
+
legs: installedLegs.map(leg => ({ label: leg.label, status: leg.status || 'PASS', comparison: leg.comparison || null })),
|
|
147
|
+
});
|
|
148
|
+
|
|
149
|
+
const everyFileOwned = Boolean(sourceLeg) && sourceLeg.status !== 'BLOCKED_SOURCE_UNAVAILABLE'
|
|
150
|
+
&& sourceLeg.comparison.missing === 0
|
|
151
|
+
&& sourceLeg.comparison.identical + sourceLeg.comparison.eolOnly + sourceLeg.comparison.different === manifest.count;
|
|
152
|
+
record('WB-001.b-file-ownership-traceable', everyFileOwned ? 'PASS' : 'BLOCKED', {
|
|
153
|
+
rule: '每一文件所有权可追溯',
|
|
154
|
+
manifestFiles: manifest.count,
|
|
155
|
+
traceableFiles: sourceLeg && sourceLeg.comparison ? sourceLeg.comparison.identical + sourceLeg.comparison.eolOnly + sourceLeg.comparison.different : 0,
|
|
156
|
+
identical: sourceLeg && sourceLeg.comparison ? sourceLeg.comparison.identical : null,
|
|
157
|
+
eolOnly: sourceLeg && sourceLeg.comparison ? sourceLeg.comparison.eolOnly : null,
|
|
158
|
+
reallyDifferent: sourceLeg && sourceLeg.comparison ? sourceLeg.comparison.different : null,
|
|
159
|
+
missing: sourceLeg && sourceLeg.comparison ? sourceLeg.comparison.missing : null,
|
|
160
|
+
});
|
|
161
|
+
|
|
162
|
+
const mismatchRecorded = !sourceLeg || sourceLeg.verdict === 'BLOCKED_SOURCE_MATCH' || sourceLeg.verdict === 'SOURCE_MATCH';
|
|
163
|
+
record('WB-001.c-mismatch-verdict', mismatchRecorded ? 'PASS' : 'FAIL', {
|
|
164
|
+
rule: '不匹配则BLOCKED_SOURCE_MATCH',
|
|
165
|
+
verdict: sourceLeg ? sourceLeg.verdict : 'BLOCKED_SOURCE_UNAVAILABLE',
|
|
166
|
+
reason: sourceLeg && sourceLeg.verdict === 'BLOCKED_SOURCE_MATCH'
|
|
167
|
+
? 'the source checkout is not byte-identical to the installed package; the difference is recorded, not patched away'
|
|
168
|
+
: null,
|
|
169
|
+
noPinOrInstallChange: true,
|
|
170
|
+
});
|
|
171
|
+
|
|
172
|
+
const summary = {
|
|
173
|
+
lane: 'test-workbench',
|
|
174
|
+
file: 'parallel-workbench-source-match.js',
|
|
175
|
+
case: 'WB-001',
|
|
176
|
+
title: '源码版本匹配',
|
|
177
|
+
manifest: {
|
|
178
|
+
file: manifest.file,
|
|
179
|
+
schema: manifest.schema,
|
|
180
|
+
module: manifest.terminal.name,
|
|
181
|
+
installName: manifest.terminal.installName,
|
|
182
|
+
version: manifest.terminal.version,
|
|
183
|
+
files: manifest.count,
|
|
184
|
+
},
|
|
185
|
+
targets,
|
|
186
|
+
verdict: sourceLeg && sourceLeg.verdict ? sourceLeg.verdict : 'BLOCKED_SOURCE_UNAVAILABLE',
|
|
187
|
+
gitHistoryUsed: false,
|
|
188
|
+
networkUsed: false,
|
|
189
|
+
cases: results,
|
|
190
|
+
};
|
|
191
|
+
|
|
192
|
+
const target = process.env.PARALLEL_WORKBENCH_EVIDENCE;
|
|
193
|
+
if (target) {
|
|
194
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
195
|
+
fs.writeFileSync(target, JSON.stringify(summary, null, 2), 'utf8');
|
|
196
|
+
}
|
|
197
|
+
console.log(`parallel-workbench-source-match PASS verdict=${summary.verdict}`);
|
|
198
|
+
return summary;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
try {
|
|
202
|
+
main();
|
|
203
|
+
} catch (error) {
|
|
204
|
+
console.error(error);
|
|
205
|
+
process.exitCode = 1;
|
|
206
|
+
}
|