@sanqianx/project-knowledge 5.0.23 → 5.0.25
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 -1346
- 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 +70 -67
- 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
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
const assert = require('node:assert/strict');
|
|
3
|
-
const fs = require('node:fs');
|
|
4
|
-
const os = require('node:os');
|
|
5
|
-
const path = require('node:path');
|
|
6
|
-
const { spawnSync } = require('node:child_process');
|
|
7
|
-
const { installedFileBytes } = require('../scripts/pack-module-candidates');
|
|
8
|
-
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-bin-content-'));
|
|
9
|
-
const npmCli = process.env.npm_execpath || path.join(path.dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
|
|
10
|
-
function npm(args, cwd) {
|
|
11
|
-
const result = spawnSync(process.execPath, [npmCli, ...args], { cwd, encoding: 'utf8', windowsHide: true });
|
|
12
|
-
assert.equal(result.status, 0, result.stderr);
|
|
13
|
-
return result.stdout;
|
|
14
|
-
}
|
|
15
|
-
try {
|
|
16
|
-
const source = path.join(root, 'source'), installed = path.join(root, 'installed');
|
|
17
|
-
fs.mkdirSync(source); fs.mkdirSync(installed);
|
|
18
|
-
const pkg = { name: 'kb-bin-content-fixture', version: '1.0.0', bin: { 'kb-content-fixture': './bin.js' }, files: ['bin.js', 'readme.txt'] };
|
|
19
|
-
const bytes = Buffer.from('#!/usr/bin/env node\r\nconsole.log("安装验收");\r\n');
|
|
20
|
-
fs.writeFileSync(path.join(source, 'package.json'), JSON.stringify(pkg));
|
|
21
|
-
fs.writeFileSync(path.join(source, 'bin.js'), bytes);
|
|
22
|
-
fs.writeFileSync(path.join(source, 'readme.txt'), bytes);
|
|
23
|
-
assert.equal(typeof installedFileBytes, 'function', 'candidate hashes must model npm bin normalization');
|
|
24
|
-
const packed = JSON.parse(npm(['pack', '--ignore-scripts', '--json', '--pack-destination', root], source))[0];
|
|
25
|
-
fs.writeFileSync(path.join(installed, 'package.json'), JSON.stringify({ name: 'kb-bin-consumer', version: '1.0.0', private: true }));
|
|
26
|
-
npm(['install', `file:${path.join(root, packed.filename)}`, '--ignore-scripts', '--no-audit', '--no-fund', '--package-lock=false'], installed);
|
|
27
|
-
const actual = fs.readFileSync(path.join(installed, 'node_modules', pkg.name, 'bin.js'));
|
|
28
|
-
assert.notDeepEqual(actual, bytes, 'npm changes a CRLF shebang on installation');
|
|
29
|
-
assert.deepEqual(installedFileBytes(pkg, 'bin.js', bytes), actual, 'manifest bytes match actual npm installation');
|
|
30
|
-
assert.deepEqual(installedFileBytes(pkg, 'readme.txt', bytes), bytes, 'ordinary files retain their exact bytes');
|
|
31
|
-
assert.deepEqual(installedFileBytes({ bin: 'bin.js' }, 'bin.js', bytes), actual, 'string bin form is supported');
|
|
32
|
-
assert.deepEqual(installedFileBytes(pkg, 'bin.js', actual), actual, 'an already normalized bin is unchanged');
|
|
33
|
-
assert.ok(actual.includes(Buffer.from('验收");\r\n')), 'only the shebang is normalized');
|
|
34
|
-
console.log('candidate-bin-content-test PASS');
|
|
35
|
-
} finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); }
|
|
1
|
+
'use strict';
|
|
2
|
+
const assert = require('node:assert/strict');
|
|
3
|
+
const fs = require('node:fs');
|
|
4
|
+
const os = require('node:os');
|
|
5
|
+
const path = require('node:path');
|
|
6
|
+
const { spawnSync } = require('node:child_process');
|
|
7
|
+
const { installedFileBytes } = require('../scripts/pack-module-candidates');
|
|
8
|
+
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-bin-content-'));
|
|
9
|
+
const npmCli = process.env.npm_execpath || path.join(path.dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
|
|
10
|
+
function npm(args, cwd) {
|
|
11
|
+
const result = spawnSync(process.execPath, [npmCli, ...args], { cwd, encoding: 'utf8', windowsHide: true });
|
|
12
|
+
assert.equal(result.status, 0, result.stderr);
|
|
13
|
+
return result.stdout;
|
|
14
|
+
}
|
|
15
|
+
try {
|
|
16
|
+
const source = path.join(root, 'source'), installed = path.join(root, 'installed');
|
|
17
|
+
fs.mkdirSync(source); fs.mkdirSync(installed);
|
|
18
|
+
const pkg = { name: 'kb-bin-content-fixture', version: '1.0.0', bin: { 'kb-content-fixture': './bin.js' }, files: ['bin.js', 'readme.txt'] };
|
|
19
|
+
const bytes = Buffer.from('#!/usr/bin/env node\r\nconsole.log("安装验收");\r\n');
|
|
20
|
+
fs.writeFileSync(path.join(source, 'package.json'), JSON.stringify(pkg));
|
|
21
|
+
fs.writeFileSync(path.join(source, 'bin.js'), bytes);
|
|
22
|
+
fs.writeFileSync(path.join(source, 'readme.txt'), bytes);
|
|
23
|
+
assert.equal(typeof installedFileBytes, 'function', 'candidate hashes must model npm bin normalization');
|
|
24
|
+
const packed = JSON.parse(npm(['pack', '--ignore-scripts', '--json', '--pack-destination', root], source))[0];
|
|
25
|
+
fs.writeFileSync(path.join(installed, 'package.json'), JSON.stringify({ name: 'kb-bin-consumer', version: '1.0.0', private: true }));
|
|
26
|
+
npm(['install', `file:${path.join(root, packed.filename)}`, '--ignore-scripts', '--no-audit', '--no-fund', '--package-lock=false'], installed);
|
|
27
|
+
const actual = fs.readFileSync(path.join(installed, 'node_modules', pkg.name, 'bin.js'));
|
|
28
|
+
assert.notDeepEqual(actual, bytes, 'npm changes a CRLF shebang on installation');
|
|
29
|
+
assert.deepEqual(installedFileBytes(pkg, 'bin.js', bytes), actual, 'manifest bytes match actual npm installation');
|
|
30
|
+
assert.deepEqual(installedFileBytes(pkg, 'readme.txt', bytes), bytes, 'ordinary files retain their exact bytes');
|
|
31
|
+
assert.deepEqual(installedFileBytes({ bin: 'bin.js' }, 'bin.js', bytes), actual, 'string bin form is supported');
|
|
32
|
+
assert.deepEqual(installedFileBytes(pkg, 'bin.js', actual), actual, 'an already normalized bin is unchanged');
|
|
33
|
+
assert.ok(actual.includes(Buffer.from('验收");\r\n')), 'only the shebang is normalized');
|
|
34
|
+
console.log('candidate-bin-content-test PASS');
|
|
35
|
+
} finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); }
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
const assert=require('node:assert/strict'),fs=require('node:fs'),path=require('node:path'),os=require('node:os'),crypto=require('node:crypto');
|
|
3
|
-
const {productFiles}=require('../scripts/pack-module-candidates');
|
|
4
|
-
const root=fs.mkdtempSync(path.join(os.tmpdir(),'kb-candidate-assets-'));
|
|
5
|
-
try{
|
|
6
|
-
const files=['ui/index.html','ui/knowledge-panel.html','ui/product.js','ui/live-client.js','ui/product.css','ui/favicon.svg','plugins/project-knowledge/scripts/context-hook.cjs'];
|
|
7
|
-
for(const file of files){fs.mkdirSync(path.dirname(path.join(root,file)),{recursive:true});fs.writeFileSync(path.join(root,file),file+' changed');}
|
|
8
|
-
fs.writeFileSync(path.join(root,'module-runtime-manifest.json'),JSON.stringify({productFiles:{[files.at(-1)]:'old-hash'}}));
|
|
9
|
-
const result=productFiles(root);
|
|
10
|
-
assert.equal(Object.keys(result).length,7);
|
|
11
|
-
assert.equal(result[files.at(-1)],crypto.createHash('sha256').update(files.at(-1)+' changed').digest('hex'));
|
|
12
|
-
console.log('candidate-product-assets-test PASS');
|
|
13
|
-
}finally{fs.rmSync(root,{recursive:true,force:true,maxRetries:3,retryDelay:100});}
|
|
1
|
+
'use strict';
|
|
2
|
+
const assert=require('node:assert/strict'),fs=require('node:fs'),path=require('node:path'),os=require('node:os'),crypto=require('node:crypto');
|
|
3
|
+
const {productFiles}=require('../scripts/pack-module-candidates');
|
|
4
|
+
const root=fs.mkdtempSync(path.join(os.tmpdir(),'kb-candidate-assets-'));
|
|
5
|
+
try{
|
|
6
|
+
const files=['ui/index.html','ui/knowledge-panel.html','ui/product.js','ui/live-client.js','ui/product.css','ui/favicon.svg','plugins/project-knowledge/scripts/context-hook.cjs'];
|
|
7
|
+
for(const file of files){fs.mkdirSync(path.dirname(path.join(root,file)),{recursive:true});fs.writeFileSync(path.join(root,file),file+' changed');}
|
|
8
|
+
fs.writeFileSync(path.join(root,'module-runtime-manifest.json'),JSON.stringify({productFiles:{[files.at(-1)]:'old-hash'}}));
|
|
9
|
+
const result=productFiles(root);
|
|
10
|
+
assert.equal(Object.keys(result).length,7);
|
|
11
|
+
assert.equal(result[files.at(-1)],crypto.createHash('sha256').update(files.at(-1)+' changed').digest('hex'));
|
|
12
|
+
console.log('candidate-product-assets-test PASS');
|
|
13
|
+
}finally{fs.rmSync(root,{recursive:true,force:true,maxRetries:3,retryDelay:100});}
|
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
const assert = require('node:assert/strict');
|
|
3
|
-
const fs = require('node:fs');
|
|
4
|
-
const path = require('node:path');
|
|
5
|
-
const { isPinnedModuleVersion } = require('../scripts/verify-module-runtime');
|
|
6
|
-
for (const name of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
|
|
7
|
-
for (const version of ['1.2.3', '1.2.3-rc.1', '1.2.3-rc.12']) assert.ok(isPinnedModuleVersion(name, version));
|
|
8
|
-
for (const version of ['latest', 'next', '^1.2.3', '~1.2.3', '>=1.2.3', 'file:../module', 'link:module', 'workspace:*', '1.2.3-beta.1', '1.2.3-rc', undefined]) assert.equal(isPinnedModuleVersion(name, version), false, String(version));
|
|
9
|
-
}
|
|
10
|
-
assert.ok(isPinnedModuleVersion('claude-ai-workbench', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'));
|
|
11
|
-
assert.equal(isPinnedModuleVersion('@sanqianx/vector-hub', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'), false);
|
|
12
|
-
const manifest = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../../module-runtime-manifest.json')));
|
|
13
|
-
for (const file of ['ui/index.html', 'ui/knowledge-panel.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) assert.match(manifest.productFiles[file], /^[a-f0-9]{64}$/);
|
|
14
|
-
console.log('candidate-release-contract-test PASS');
|
|
1
|
+
'use strict';
|
|
2
|
+
const assert = require('node:assert/strict');
|
|
3
|
+
const fs = require('node:fs');
|
|
4
|
+
const path = require('node:path');
|
|
5
|
+
const { isPinnedModuleVersion } = require('../scripts/verify-module-runtime');
|
|
6
|
+
for (const name of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
|
|
7
|
+
for (const version of ['1.2.3', '1.2.3-rc.1', '1.2.3-rc.12']) assert.ok(isPinnedModuleVersion(name, version));
|
|
8
|
+
for (const version of ['latest', 'next', '^1.2.3', '~1.2.3', '>=1.2.3', 'file:../module', 'link:module', 'workspace:*', '1.2.3-beta.1', '1.2.3-rc', undefined]) assert.equal(isPinnedModuleVersion(name, version), false, String(version));
|
|
9
|
+
}
|
|
10
|
+
assert.ok(isPinnedModuleVersion('claude-ai-workbench', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'));
|
|
11
|
+
assert.equal(isPinnedModuleVersion('@sanqianx/vector-hub', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'), false);
|
|
12
|
+
const manifest = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../../module-runtime-manifest.json')));
|
|
13
|
+
for (const file of ['ui/index.html', 'ui/knowledge-panel.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) assert.match(manifest.productFiles[file], /^[a-f0-9]{64}$/);
|
|
14
|
+
console.log('candidate-release-contract-test PASS');
|
|
@@ -1,158 +1,158 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
|
|
3
|
-
const assert = require('assert');
|
|
4
|
-
const fs = require('fs');
|
|
5
|
-
const os = require('os');
|
|
6
|
-
const path = require('path');
|
|
7
|
-
const { spawnSync } = require('child_process');
|
|
8
|
-
const { IntegrationManager } = require(process.env.PK_TEST_INTEGRATION_ROOT
|
|
9
|
-
? path.join(process.env.PK_TEST_INTEGRATION_ROOT, '_site/lib/integration-installer') : '../lib/integration-installer');
|
|
10
|
-
const { bridgeBinding, planCaptureHooks, repairCaptureHooks } = require('../lib/capture-hook-config');
|
|
11
|
-
const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
|
|
12
|
-
const ROOT = path.resolve(__dirname, '../..');
|
|
13
|
-
const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-capture-dedup-'));
|
|
14
|
-
const HOME = path.join(TEMP, '用户 空格');
|
|
15
|
-
const OLD = path.join(HOME, '.ai-coding-event-bridge');
|
|
16
|
-
const CURRENT = path.join(HOME, '.project-knowledge-v5/events');
|
|
17
|
-
const options = { homeDir: HOME, bridgeHomeDir: CURRENT };
|
|
18
|
-
const shim = home => path.join(home, 'bin/bridge-hook.cjs');
|
|
19
|
-
const cmd = home => ({ type: 'command', command: `node "${shim(home)}"` });
|
|
20
|
-
const processHook = home => ({ type: 'process', command: 'node', args: [shim(home), '--source', 'zcode'], timeoutMs: 15000 });
|
|
21
|
-
const events = ['UserPromptSubmit', 'Stop'];
|
|
22
|
-
const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
23
|
-
function write(file, object) { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, JSON.stringify(object, null, 2) + '\n'); }
|
|
24
|
-
function manager(extra = {}) { return new IntegrationManager({ rootDir: ROOT, env: {}, ...options, ...extra }); }
|
|
25
|
-
|
|
26
|
-
async function main() {
|
|
27
|
-
const claude = path.join(HOME, '.claude/settings.json');
|
|
28
|
-
const third = { type: 'command', command: 'node "notify-user.cjs"', timeout: 10 };
|
|
29
|
-
const context = { type: 'command', command: 'node "context-hook.cjs" --client claude' };
|
|
30
|
-
const lookalike = { type: 'command', command: `node "${shim(OLD)}" && echo keep-user-wrapper` };
|
|
31
|
-
const customHome = path.join(HOME, 'independent-third-party-bridge');
|
|
32
|
-
const unrelated = { model: 'user-model', env: { PRIVATE_TEST_TOKEN: 'do-not-back-up-unrelated-secret' } };
|
|
33
|
-
write(claude, { ...unrelated, hooks: Object.fromEntries(events.map(event => [event, [
|
|
34
|
-
{ matcher: '*', hooks: [cmd(OLD), third, cmd(CURRENT)] },
|
|
35
|
-
{ matcher: '*', hooks: [cmd(OLD), cmd(CURRENT), context, lookalike, cmd(customHome)] },
|
|
36
|
-
]])) });
|
|
37
|
-
const before = fs.readFileSync(claude, 'utf8');
|
|
38
|
-
const logs = [];
|
|
39
|
-
const item = manager({ logger: { info: (...args) => logs.push(args), error: (...args) => logs.push(args) } });
|
|
40
|
-
assert.equal((await item.statusCaptureClaude()).state, 'needs-repair', 'duplicate capture cannot be reported healthy');
|
|
41
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), before, 'status is read-only');
|
|
42
|
-
const installed = await item.captureOperation('install', 'claude');
|
|
43
|
-
assert.equal(installed.removedLegacy, 4);
|
|
44
|
-
assert.equal(installed.removedDuplicates, 2);
|
|
45
|
-
assert(logs.some(row => row[2]?.context?.removedLegacy === 4 && row[2]?.context?.removedDuplicates === 2), 'repair counts are persisted without raw configuration');
|
|
46
|
-
assert(!JSON.stringify(logs).includes('do-not-back-up-unrelated-secret'));
|
|
47
|
-
let saved = read(claude);
|
|
48
|
-
assert.equal(saved.model, unrelated.model); assert.deepEqual(saved.env, unrelated.env);
|
|
49
|
-
for (const event of events) {
|
|
50
|
-
const hooks = saved.hooks[event].flatMap(group => group.hooks);
|
|
51
|
-
assert.equal(hooks.filter(hook => hook.command === cmd(CURRENT).command).length, 1);
|
|
52
|
-
assert.equal(hooks.filter(hook => hook.command === cmd(OLD).command).length, 0);
|
|
53
|
-
for (const keep of [third, context, lookalike, cmd(customHome)]) assert(hooks.some(hook => JSON.stringify(hook) === JSON.stringify(keep)), 'mixed-group third-party hooks survive');
|
|
54
|
-
}
|
|
55
|
-
assert(!fs.readFileSync(installed.backupFile, 'utf8').includes('do-not-back-up-unrelated-secret'), 'backup contains only removed owned invocations');
|
|
56
|
-
assert.equal((await item.statusCaptureClaude()).state, 'installed');
|
|
57
|
-
const after = fs.readFileSync(claude, 'utf8');
|
|
58
|
-
assert.equal((await item.installCaptureClaude()).changed, false);
|
|
59
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), after, 'repeat repair is byte-idempotent');
|
|
60
|
-
await item.uninstallCaptureClaude();
|
|
61
|
-
saved = read(claude);
|
|
62
|
-
for (const event of events) assert(saved.hooks[event].flatMap(group => group.hooks).some(hook => hook.command === third.command), 'uninstall keeps other hooks in the same group');
|
|
63
|
-
|
|
64
|
-
const zcode = path.join(HOME, '.zcode/cli/config.json');
|
|
65
|
-
const zContext = { type: 'process', command: 'node', args: ['context-hook.cjs', '--client', 'zcode'] };
|
|
66
|
-
write(zcode, { ...unrelated, hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), third, processHook(CURRENT), processHook(CURRENT), zContext] }]])) } });
|
|
67
|
-
assert.equal((await item.statusCaptureZCode()).state, 'needs-repair');
|
|
68
|
-
const zInstalled = await item.installCaptureZCode();
|
|
69
|
-
assert.equal(zInstalled.removedLegacy, 2); assert.equal(zInstalled.removedDuplicates, 2);
|
|
70
|
-
const zBeforeRepeat = fs.readFileSync(zcode, 'utf8');
|
|
71
|
-
await item.installCaptureZCode();
|
|
72
|
-
assert.equal(fs.readFileSync(zcode, 'utf8'), zBeforeRepeat);
|
|
73
|
-
await item.uninstallCaptureZCode();
|
|
74
|
-
assert.deepEqual(read(zcode).env, unrelated.env);
|
|
75
|
-
assert.deepEqual(read(zcode).hooks.events.UserPromptSubmit[0].hooks, [third, zContext]);
|
|
76
|
-
|
|
77
|
-
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD)] }]])) });
|
|
78
|
-
const onlyLegacy = fs.readFileSync(claude, 'utf8');
|
|
79
|
-
assert.throws(() => repairCaptureHooks(claude, 'claude', options), /入口未完整/);
|
|
80
|
-
const failed = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => { throw new Error('runtime materialization failed'); } } } } });
|
|
81
|
-
await assert.rejects(failed.installCaptureClaude(), /materialization failed/);
|
|
82
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'failed runtime install cannot retire working old capture');
|
|
83
|
-
const conflict = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => ({ added: [], runtime: { conflict: true } }) } } } });
|
|
84
|
-
await assert.rejects(conflict.installCaptureClaude(), /版本冲突/);
|
|
85
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'a runtime conflict cannot retire old capture');
|
|
86
|
-
const dry = manager({ dryRun: true });
|
|
87
|
-
await dry.installCaptureClaude(); await dry.uninstallCaptureClaude();
|
|
88
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy);
|
|
89
|
-
fs.writeFileSync(claude, '{invalid JSON');
|
|
90
|
-
assert.throws(() => planCaptureHooks(claude, 'claude', options), /JSON/);
|
|
91
|
-
assert.equal(fs.readFileSync(claude, 'utf8'), '{invalid JSON');
|
|
92
|
-
assert.equal(bridgeBinding(['node', `${shim(OLD)}.user-script`], options), '');
|
|
93
|
-
assert.equal(bridgeBinding(['node', shim(OLD), '--custom-argument'], options), '');
|
|
94
|
-
assert.equal(bridgeBinding([['node'], shim(OLD)], options), '');
|
|
95
|
-
write(claude, { hooks: { UserPromptSubmit: [null, { hooks: [cmd(OLD), cmd(CURRENT)] }], Stop: [{ hooks: [cmd(CURRENT)] }] } });
|
|
96
|
-
repairCaptureHooks(claude, 'claude', options);
|
|
97
|
-
assert.equal(read(claude).hooks.UserPromptSubmit[0], null, 'repair does not silently drop unrelated malformed groups');
|
|
98
|
-
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT)] }]])) });
|
|
99
|
-
const originalRead = fs.readFileSync;
|
|
100
|
-
let reads = 0;
|
|
101
|
-
fs.readFileSync = function(file, ...args) {
|
|
102
|
-
const value = originalRead.call(this, file, ...args);
|
|
103
|
-
if (file === claude && ++reads === 2) write(claude, { ...JSON.parse(value), userConcurrentEdit: 'kept' });
|
|
104
|
-
return value;
|
|
105
|
-
};
|
|
106
|
-
try { assert.throws(() => repairCaptureHooks(claude, 'claude', options), error => error.code === 'CONFIG_CHANGED'); }
|
|
107
|
-
finally { fs.readFileSync = originalRead; }
|
|
108
|
-
assert.equal(read(claude).userConcurrentEdit, 'kept', 'a concurrent user edit is never overwritten');
|
|
109
|
-
|
|
110
|
-
// Real Git + real installed shims: the stale store is registered, but no
|
|
111
|
-
// repaired client invocation recreates it or sends duplicate events.
|
|
112
|
-
const repo = path.join(TEMP, '代码 中文 project');
|
|
113
|
-
fs.mkdirSync(repo, { recursive: true });
|
|
114
|
-
const git = spawnSync('git', ['init', '-q'], { cwd: repo, encoding: 'utf8', windowsHide: true });
|
|
115
|
-
assert.equal(git.status, 0, git.stderr);
|
|
116
|
-
const obsoleteStore = path.join(TEMP, 'knowledge/old-slug/dev-conversations');
|
|
117
|
-
const canonicalStore = path.join(TEMP, 'knowledge/Canonical-abcdef/dev-conversations');
|
|
118
|
-
await bridge.ensureRuntimeHome({ homeDir: OLD });
|
|
119
|
-
await bridge.projectRegistry.addProject({ home: OLD, path: repo, store: obsoleteStore });
|
|
120
|
-
await bridge.projectRegistry.addProject({ home: CURRENT, path: repo, store: canonicalStore });
|
|
121
|
-
fs.rmSync(path.join(TEMP, 'knowledge/old-slug'), { recursive: true, force: true });
|
|
122
|
-
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT), cmd(CURRENT)] }]])) });
|
|
123
|
-
await item.installCaptureClaude();
|
|
124
|
-
const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME;
|
|
125
|
-
for (const [event, payload] of [
|
|
126
|
-
['UserPromptSubmit', { prompt: 'isolated dedup test request' }],
|
|
127
|
-
['Stop', { last_assistant_message: 'isolated dedup test answer' }],
|
|
128
|
-
]) {
|
|
129
|
-
const hooks = read(claude).hooks[event].flatMap(group => group.hooks);
|
|
130
|
-
assert.equal(hooks.length, 1);
|
|
131
|
-
const call = spawnSync(process.execPath, [shim(CURRENT)], { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
|
|
132
|
-
assert.equal(call.status, 0, call.stderr);
|
|
133
|
-
}
|
|
134
|
-
const journal = path.join(canonicalStore, 'journal/events.jsonl');
|
|
135
|
-
const captured = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
|
|
136
|
-
assert.deepEqual(captured.map(row => row.eventType), ['user_prompt', 'assistant_response']);
|
|
137
|
-
assert(!fs.existsSync(obsoleteStore), 'the stale second directory is not recreated');
|
|
138
|
-
write(zcode, { hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), processHook(CURRENT), processHook(CURRENT)] }]])) } });
|
|
139
|
-
await item.installCaptureZCode();
|
|
140
|
-
for (const [event, payload] of [
|
|
141
|
-
['UserPromptSubmit', { prompt: 'isolated zcode dedup request' }],
|
|
142
|
-
['Stop', { last_assistant_message: 'isolated zcode dedup answer' }],
|
|
143
|
-
]) {
|
|
144
|
-
const hooks = read(zcode).hooks.events[event].flatMap(group => group.hooks);
|
|
145
|
-
assert.equal(hooks.length, 1);
|
|
146
|
-
const call = spawnSync(process.execPath, hooks[0].args, { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'zcode-dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
|
|
147
|
-
assert.equal(call.status, 0, call.stderr);
|
|
148
|
-
}
|
|
149
|
-
const afterZCode = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
|
|
150
|
-
assert.deepEqual(afterZCode.map(row => row.source), ['claude-code', 'claude-code', 'zcode', 'zcode']);
|
|
151
|
-
assert(!fs.existsSync(obsoleteStore), 'ZCode also cannot recreate the old knowledge folder');
|
|
152
|
-
console.log('capture-hook-dedup-test PASS (duplicate status, exact ownership, mixed-group preservation, idempotency, runtime failure and real journal capture)');
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
main().catch(error => { console.error(error.stack); process.exitCode = 1; }).finally(() => {
|
|
156
|
-
assert(path.resolve(TEMP).startsWith(path.resolve(os.tmpdir()) + path.sep));
|
|
157
|
-
fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
|
|
158
|
-
});
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
const assert = require('assert');
|
|
4
|
+
const fs = require('fs');
|
|
5
|
+
const os = require('os');
|
|
6
|
+
const path = require('path');
|
|
7
|
+
const { spawnSync } = require('child_process');
|
|
8
|
+
const { IntegrationManager } = require(process.env.PK_TEST_INTEGRATION_ROOT
|
|
9
|
+
? path.join(process.env.PK_TEST_INTEGRATION_ROOT, '_site/lib/integration-installer') : '../lib/integration-installer');
|
|
10
|
+
const { bridgeBinding, planCaptureHooks, repairCaptureHooks } = require('../lib/capture-hook-config');
|
|
11
|
+
const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
|
|
12
|
+
const ROOT = path.resolve(__dirname, '../..');
|
|
13
|
+
const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-capture-dedup-'));
|
|
14
|
+
const HOME = path.join(TEMP, '用户 空格');
|
|
15
|
+
const OLD = path.join(HOME, '.ai-coding-event-bridge');
|
|
16
|
+
const CURRENT = path.join(HOME, '.project-knowledge-v5/events');
|
|
17
|
+
const options = { homeDir: HOME, bridgeHomeDir: CURRENT };
|
|
18
|
+
const shim = home => path.join(home, 'bin/bridge-hook.cjs');
|
|
19
|
+
const cmd = home => ({ type: 'command', command: `node "${shim(home)}"` });
|
|
20
|
+
const processHook = home => ({ type: 'process', command: 'node', args: [shim(home), '--source', 'zcode'], timeoutMs: 15000 });
|
|
21
|
+
const events = ['UserPromptSubmit', 'Stop'];
|
|
22
|
+
const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
23
|
+
function write(file, object) { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, JSON.stringify(object, null, 2) + '\n'); }
|
|
24
|
+
function manager(extra = {}) { return new IntegrationManager({ rootDir: ROOT, env: {}, ...options, ...extra }); }
|
|
25
|
+
|
|
26
|
+
async function main() {
|
|
27
|
+
const claude = path.join(HOME, '.claude/settings.json');
|
|
28
|
+
const third = { type: 'command', command: 'node "notify-user.cjs"', timeout: 10 };
|
|
29
|
+
const context = { type: 'command', command: 'node "context-hook.cjs" --client claude' };
|
|
30
|
+
const lookalike = { type: 'command', command: `node "${shim(OLD)}" && echo keep-user-wrapper` };
|
|
31
|
+
const customHome = path.join(HOME, 'independent-third-party-bridge');
|
|
32
|
+
const unrelated = { model: 'user-model', env: { PRIVATE_TEST_TOKEN: 'do-not-back-up-unrelated-secret' } };
|
|
33
|
+
write(claude, { ...unrelated, hooks: Object.fromEntries(events.map(event => [event, [
|
|
34
|
+
{ matcher: '*', hooks: [cmd(OLD), third, cmd(CURRENT)] },
|
|
35
|
+
{ matcher: '*', hooks: [cmd(OLD), cmd(CURRENT), context, lookalike, cmd(customHome)] },
|
|
36
|
+
]])) });
|
|
37
|
+
const before = fs.readFileSync(claude, 'utf8');
|
|
38
|
+
const logs = [];
|
|
39
|
+
const item = manager({ logger: { info: (...args) => logs.push(args), error: (...args) => logs.push(args) } });
|
|
40
|
+
assert.equal((await item.statusCaptureClaude()).state, 'needs-repair', 'duplicate capture cannot be reported healthy');
|
|
41
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), before, 'status is read-only');
|
|
42
|
+
const installed = await item.captureOperation('install', 'claude');
|
|
43
|
+
assert.equal(installed.removedLegacy, 4);
|
|
44
|
+
assert.equal(installed.removedDuplicates, 2);
|
|
45
|
+
assert(logs.some(row => row[2]?.context?.removedLegacy === 4 && row[2]?.context?.removedDuplicates === 2), 'repair counts are persisted without raw configuration');
|
|
46
|
+
assert(!JSON.stringify(logs).includes('do-not-back-up-unrelated-secret'));
|
|
47
|
+
let saved = read(claude);
|
|
48
|
+
assert.equal(saved.model, unrelated.model); assert.deepEqual(saved.env, unrelated.env);
|
|
49
|
+
for (const event of events) {
|
|
50
|
+
const hooks = saved.hooks[event].flatMap(group => group.hooks);
|
|
51
|
+
assert.equal(hooks.filter(hook => hook.command === cmd(CURRENT).command).length, 1);
|
|
52
|
+
assert.equal(hooks.filter(hook => hook.command === cmd(OLD).command).length, 0);
|
|
53
|
+
for (const keep of [third, context, lookalike, cmd(customHome)]) assert(hooks.some(hook => JSON.stringify(hook) === JSON.stringify(keep)), 'mixed-group third-party hooks survive');
|
|
54
|
+
}
|
|
55
|
+
assert(!fs.readFileSync(installed.backupFile, 'utf8').includes('do-not-back-up-unrelated-secret'), 'backup contains only removed owned invocations');
|
|
56
|
+
assert.equal((await item.statusCaptureClaude()).state, 'installed');
|
|
57
|
+
const after = fs.readFileSync(claude, 'utf8');
|
|
58
|
+
assert.equal((await item.installCaptureClaude()).changed, false);
|
|
59
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), after, 'repeat repair is byte-idempotent');
|
|
60
|
+
await item.uninstallCaptureClaude();
|
|
61
|
+
saved = read(claude);
|
|
62
|
+
for (const event of events) assert(saved.hooks[event].flatMap(group => group.hooks).some(hook => hook.command === third.command), 'uninstall keeps other hooks in the same group');
|
|
63
|
+
|
|
64
|
+
const zcode = path.join(HOME, '.zcode/cli/config.json');
|
|
65
|
+
const zContext = { type: 'process', command: 'node', args: ['context-hook.cjs', '--client', 'zcode'] };
|
|
66
|
+
write(zcode, { ...unrelated, hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), third, processHook(CURRENT), processHook(CURRENT), zContext] }]])) } });
|
|
67
|
+
assert.equal((await item.statusCaptureZCode()).state, 'needs-repair');
|
|
68
|
+
const zInstalled = await item.installCaptureZCode();
|
|
69
|
+
assert.equal(zInstalled.removedLegacy, 2); assert.equal(zInstalled.removedDuplicates, 2);
|
|
70
|
+
const zBeforeRepeat = fs.readFileSync(zcode, 'utf8');
|
|
71
|
+
await item.installCaptureZCode();
|
|
72
|
+
assert.equal(fs.readFileSync(zcode, 'utf8'), zBeforeRepeat);
|
|
73
|
+
await item.uninstallCaptureZCode();
|
|
74
|
+
assert.deepEqual(read(zcode).env, unrelated.env);
|
|
75
|
+
assert.deepEqual(read(zcode).hooks.events.UserPromptSubmit[0].hooks, [third, zContext]);
|
|
76
|
+
|
|
77
|
+
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD)] }]])) });
|
|
78
|
+
const onlyLegacy = fs.readFileSync(claude, 'utf8');
|
|
79
|
+
assert.throws(() => repairCaptureHooks(claude, 'claude', options), /入口未完整/);
|
|
80
|
+
const failed = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => { throw new Error('runtime materialization failed'); } } } } });
|
|
81
|
+
await assert.rejects(failed.installCaptureClaude(), /materialization failed/);
|
|
82
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'failed runtime install cannot retire working old capture');
|
|
83
|
+
const conflict = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => ({ added: [], runtime: { conflict: true } }) } } } });
|
|
84
|
+
await assert.rejects(conflict.installCaptureClaude(), /版本冲突/);
|
|
85
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'a runtime conflict cannot retire old capture');
|
|
86
|
+
const dry = manager({ dryRun: true });
|
|
87
|
+
await dry.installCaptureClaude(); await dry.uninstallCaptureClaude();
|
|
88
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy);
|
|
89
|
+
fs.writeFileSync(claude, '{invalid JSON');
|
|
90
|
+
assert.throws(() => planCaptureHooks(claude, 'claude', options), /JSON/);
|
|
91
|
+
assert.equal(fs.readFileSync(claude, 'utf8'), '{invalid JSON');
|
|
92
|
+
assert.equal(bridgeBinding(['node', `${shim(OLD)}.user-script`], options), '');
|
|
93
|
+
assert.equal(bridgeBinding(['node', shim(OLD), '--custom-argument'], options), '');
|
|
94
|
+
assert.equal(bridgeBinding([['node'], shim(OLD)], options), '');
|
|
95
|
+
write(claude, { hooks: { UserPromptSubmit: [null, { hooks: [cmd(OLD), cmd(CURRENT)] }], Stop: [{ hooks: [cmd(CURRENT)] }] } });
|
|
96
|
+
repairCaptureHooks(claude, 'claude', options);
|
|
97
|
+
assert.equal(read(claude).hooks.UserPromptSubmit[0], null, 'repair does not silently drop unrelated malformed groups');
|
|
98
|
+
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT)] }]])) });
|
|
99
|
+
const originalRead = fs.readFileSync;
|
|
100
|
+
let reads = 0;
|
|
101
|
+
fs.readFileSync = function(file, ...args) {
|
|
102
|
+
const value = originalRead.call(this, file, ...args);
|
|
103
|
+
if (file === claude && ++reads === 2) write(claude, { ...JSON.parse(value), userConcurrentEdit: 'kept' });
|
|
104
|
+
return value;
|
|
105
|
+
};
|
|
106
|
+
try { assert.throws(() => repairCaptureHooks(claude, 'claude', options), error => error.code === 'CONFIG_CHANGED'); }
|
|
107
|
+
finally { fs.readFileSync = originalRead; }
|
|
108
|
+
assert.equal(read(claude).userConcurrentEdit, 'kept', 'a concurrent user edit is never overwritten');
|
|
109
|
+
|
|
110
|
+
// Real Git + real installed shims: the stale store is registered, but no
|
|
111
|
+
// repaired client invocation recreates it or sends duplicate events.
|
|
112
|
+
const repo = path.join(TEMP, '代码 中文 project');
|
|
113
|
+
fs.mkdirSync(repo, { recursive: true });
|
|
114
|
+
const git = spawnSync('git', ['init', '-q'], { cwd: repo, encoding: 'utf8', windowsHide: true });
|
|
115
|
+
assert.equal(git.status, 0, git.stderr);
|
|
116
|
+
const obsoleteStore = path.join(TEMP, 'knowledge/old-slug/dev-conversations');
|
|
117
|
+
const canonicalStore = path.join(TEMP, 'knowledge/Canonical-abcdef/dev-conversations');
|
|
118
|
+
await bridge.ensureRuntimeHome({ homeDir: OLD });
|
|
119
|
+
await bridge.projectRegistry.addProject({ home: OLD, path: repo, store: obsoleteStore });
|
|
120
|
+
await bridge.projectRegistry.addProject({ home: CURRENT, path: repo, store: canonicalStore });
|
|
121
|
+
fs.rmSync(path.join(TEMP, 'knowledge/old-slug'), { recursive: true, force: true });
|
|
122
|
+
write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT), cmd(CURRENT)] }]])) });
|
|
123
|
+
await item.installCaptureClaude();
|
|
124
|
+
const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME;
|
|
125
|
+
for (const [event, payload] of [
|
|
126
|
+
['UserPromptSubmit', { prompt: 'isolated dedup test request' }],
|
|
127
|
+
['Stop', { last_assistant_message: 'isolated dedup test answer' }],
|
|
128
|
+
]) {
|
|
129
|
+
const hooks = read(claude).hooks[event].flatMap(group => group.hooks);
|
|
130
|
+
assert.equal(hooks.length, 1);
|
|
131
|
+
const call = spawnSync(process.execPath, [shim(CURRENT)], { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
|
|
132
|
+
assert.equal(call.status, 0, call.stderr);
|
|
133
|
+
}
|
|
134
|
+
const journal = path.join(canonicalStore, 'journal/events.jsonl');
|
|
135
|
+
const captured = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
|
|
136
|
+
assert.deepEqual(captured.map(row => row.eventType), ['user_prompt', 'assistant_response']);
|
|
137
|
+
assert(!fs.existsSync(obsoleteStore), 'the stale second directory is not recreated');
|
|
138
|
+
write(zcode, { hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), processHook(CURRENT), processHook(CURRENT)] }]])) } });
|
|
139
|
+
await item.installCaptureZCode();
|
|
140
|
+
for (const [event, payload] of [
|
|
141
|
+
['UserPromptSubmit', { prompt: 'isolated zcode dedup request' }],
|
|
142
|
+
['Stop', { last_assistant_message: 'isolated zcode dedup answer' }],
|
|
143
|
+
]) {
|
|
144
|
+
const hooks = read(zcode).hooks.events[event].flatMap(group => group.hooks);
|
|
145
|
+
assert.equal(hooks.length, 1);
|
|
146
|
+
const call = spawnSync(process.execPath, hooks[0].args, { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'zcode-dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
|
|
147
|
+
assert.equal(call.status, 0, call.stderr);
|
|
148
|
+
}
|
|
149
|
+
const afterZCode = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
|
|
150
|
+
assert.deepEqual(afterZCode.map(row => row.source), ['claude-code', 'claude-code', 'zcode', 'zcode']);
|
|
151
|
+
assert(!fs.existsSync(obsoleteStore), 'ZCode also cannot recreate the old knowledge folder');
|
|
152
|
+
console.log('capture-hook-dedup-test PASS (duplicate status, exact ownership, mixed-group preservation, idempotency, runtime failure and real journal capture)');
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
main().catch(error => { console.error(error.stack); process.exitCode = 1; }).finally(() => {
|
|
156
|
+
assert(path.resolve(TEMP).startsWith(path.resolve(os.tmpdir()) + path.sep));
|
|
157
|
+
fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
|
|
158
|
+
});
|