@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,180 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// P-LOG-ACCEPTANCE-01 LOG-008 acceptance driver (real product page in a real
|
|
3
|
+
// browser against an isolated managed instance).
|
|
4
|
+
//
|
|
5
|
+
// Case (qa-autopilot/config/test-cases.json LOG-008, P1):
|
|
6
|
+
// steps: 查询超时和导出失败分别触发。
|
|
7
|
+
// expected: 1) UI显示失败。
|
|
8
|
+
// 2) 不能生成空文件冒充成功导出。
|
|
9
|
+
//
|
|
10
|
+
// Real behaviour under test: api() (ui/product.js:31-43) aborts GETs after
|
|
11
|
+
// 3s and loadLogs leaves the previous DOM intact on failure; on() toasts the
|
|
12
|
+
// error message. The lane observation proxy delays /api/logs by 5s (> the 3s
|
|
13
|
+
// timeout) for the query-timeout phase. For export failure, a file placed at
|
|
14
|
+
// <dataDir>/cache/exports makes exportToFile's mkdirSync throw → the route
|
|
15
|
+
// returns 500 → exportLogs throws 诊断导出失败。 → toast, and no download may
|
|
16
|
+
// appear. A control export after unblocking proves the route recovers.
|
|
17
|
+
|
|
18
|
+
const fs = require('node:fs');
|
|
19
|
+
const path = require('node:path');
|
|
20
|
+
const crypto = require('node:crypto');
|
|
21
|
+
|
|
22
|
+
// Portable isolation (P-QA-LOG-INTEGRATION-5025): the temp root comes from
|
|
23
|
+
// PK_TEST_TEMP_ROOT or os.tmpdir() and must live outside the source tree;
|
|
24
|
+
// HOME/APPDATA/LOCALAPPDATA/TEMP/CODEX_HOME/CLAUDE_CONFIG_DIR and the dual
|
|
25
|
+
// product data roots are redirected before any other module is loaded.
|
|
26
|
+
const { installLoggingTestEnv, resolveEvidenceDir } = require('./helpers/parallel-logging-integration-5025-env');
|
|
27
|
+
const lane = installLoggingTestEnv({ caseId: 'LOG-008', prefix: 'log008' });
|
|
28
|
+
const laneTmp = lane.laneTmp;
|
|
29
|
+
|
|
30
|
+
const { spawnServer } = require('./helpers/spawn-server');
|
|
31
|
+
const { findChrome } = require('./helpers/find-chrome');
|
|
32
|
+
const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
|
|
33
|
+
const freePort = require('./helpers/free-port');
|
|
34
|
+
const { createLoggingAcceptanceFixture, writeProjectLogs } = require('./helpers/parallel-logging-acceptance-fixture');
|
|
35
|
+
const { createObservationProxy } = require('./helpers/parallel-logging-acceptance-proxy');
|
|
36
|
+
|
|
37
|
+
const ROOT = path.resolve(__dirname, '../..');
|
|
38
|
+
const ARTIFACTS = resolveEvidenceDir(path.resolve(ROOT, 'qa-autopilot/artifacts/parallel-20261023/logging-acceptance-r1/evidence/log008'));
|
|
39
|
+
|
|
40
|
+
const PROJECT_A = 'project-log008-alpha';
|
|
41
|
+
const run = crypto.randomBytes(6).toString('hex');
|
|
42
|
+
const MARK = `LOG008-Q-${run}`;
|
|
43
|
+
|
|
44
|
+
async function main() {
|
|
45
|
+
fs.mkdirSync(ARTIFACTS, { recursive: true });
|
|
46
|
+
const evidence = { caseId: 'LOG-008', startedAt: new Date().toISOString(), marker: MARK, phases: {} };
|
|
47
|
+
|
|
48
|
+
const fixture = await createLoggingAcceptanceFixture({
|
|
49
|
+
caseId: 'log008',
|
|
50
|
+
projects: [{ projectId: PROJECT_A, displayName: 'LOG008甲项目' }],
|
|
51
|
+
});
|
|
52
|
+
await writeProjectLogs(fixture.logger, PROJECT_A, [
|
|
53
|
+
{ level: 'info', event: 'log008.seed.1', message: `LOG008 seed 1 ${run}`, operationId: `op-log008-seed-1-${run}` },
|
|
54
|
+
{ level: 'warn', event: 'log008.seed.2', message: `LOG008 seed 2 ${run}`, operationId: `op-log008-seed-2-${run}` },
|
|
55
|
+
{ level: 'info', event: `log008.hit`, message: `${MARK} 命中记录`, operationId: `op-log008-hit-${run}` },
|
|
56
|
+
]);
|
|
57
|
+
await fixture.logger.close();
|
|
58
|
+
|
|
59
|
+
const port = await freePort();
|
|
60
|
+
const proxyPort = await freePort();
|
|
61
|
+
const base = `http://127.0.0.1:${port}`;
|
|
62
|
+
const server = spawnServer({ root: ROOT, port, dataDir: fixture.dataDir, tag: 'log008', stdio: 'ignore' });
|
|
63
|
+
let browser;
|
|
64
|
+
let proxy;
|
|
65
|
+
try {
|
|
66
|
+
await waitFor(async () => { try { return (await fetch(`${base}/api/health`)).ok; } catch { return false; } }, 'isolated web shell', 20000);
|
|
67
|
+
proxy = await createObservationProxy({ targetPort: port, port: proxyPort });
|
|
68
|
+
evidence.server = { pid: server.child.pid, port, proxyPort, dataDir: fixture.dataDir };
|
|
69
|
+
|
|
70
|
+
browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(laneTmp, 'browser'), url: proxy.url, width: 1440, height: 900 });
|
|
71
|
+
const runExpr = expression => browser.evaluate(expression);
|
|
72
|
+
const click = selector => runExpr(`document.querySelector(${JSON.stringify(selector)}).click()`);
|
|
73
|
+
const readDom = () => runExpr(`JSON.stringify({ count: document.querySelectorAll('#logsContent .log-entry').length, toastHidden: document.getElementById('toast').hidden, toastText: document.getElementById('toast').textContent })`);
|
|
74
|
+
evidence.browser = await runExpr('navigator.userAgent');
|
|
75
|
+
|
|
76
|
+
await waitFor(() => runExpr(`document.getElementById('projectSelect') && document.getElementById('projectSelect').length >= 1`), 'isolated project registered', 20000);
|
|
77
|
+
await runExpr(`document.getElementById('projectSelect').value = ${JSON.stringify(PROJECT_A)}; document.getElementById('projectSelect').dispatchEvent(new Event('change'))`);
|
|
78
|
+
await waitFor(() => runExpr(`document.getElementById('projectSelect').value === ${JSON.stringify(PROJECT_A)}`), 'project A selected');
|
|
79
|
+
|
|
80
|
+
// Baseline: healthy query first (search narrows to the marker's record).
|
|
81
|
+
await click('#openSystem');
|
|
82
|
+
await runExpr(`document.getElementById('logsScope').value = 'project'; document.getElementById('logsSearch').value = ''`);
|
|
83
|
+
await click('#openLogs');
|
|
84
|
+
await waitFor(async () => {
|
|
85
|
+
const dom = JSON.parse(await readDom());
|
|
86
|
+
return dom.count >= 3;
|
|
87
|
+
}, 'diagnostics dialog rendered the project records', 20000);
|
|
88
|
+
const domBaseline = JSON.parse(await readDom());
|
|
89
|
+
|
|
90
|
+
// expected1a (query timeout): delay /api/logs past api()'s 3s timeout.
|
|
91
|
+
proxy.setDelay('/api/logs', 5000);
|
|
92
|
+
await runExpr(`document.getElementById('logsSearch').value = ${JSON.stringify(MARK)}`);
|
|
93
|
+
await click('#loadLogs');
|
|
94
|
+
await waitFor(async () => {
|
|
95
|
+
const dom = JSON.parse(await readDom());
|
|
96
|
+
return !dom.toastHidden && dom.toastText.includes('状态读取超时');
|
|
97
|
+
}, 'timeout toast appears for the slow query', 8000);
|
|
98
|
+
const domTimeout = JSON.parse(await readDom());
|
|
99
|
+
evidence.phases.queryTimeout = {
|
|
100
|
+
baselineEntries: domBaseline.count,
|
|
101
|
+
entriesAfterTimeout: domTimeout.count,
|
|
102
|
+
toastText: domTimeout.toastText,
|
|
103
|
+
previousContentPreserved: domTimeout.count === domBaseline.count,
|
|
104
|
+
delayedQueryStillNotNarrowed: domTimeout.count !== 1,
|
|
105
|
+
};
|
|
106
|
+
if (!domTimeout.toastText.includes('状态读取超时')) throw new Error('UI did not surface the query timeout');
|
|
107
|
+
if (domTimeout.count !== domBaseline.count) throw new Error('timeout wiped the previously rendered records');
|
|
108
|
+
await browser.screenshot(path.join(ARTIFACTS, 'log008-query-timeout-toast.png'));
|
|
109
|
+
proxy.setDelay('/api/logs', null);
|
|
110
|
+
// Let the delayed response land and the toast clear before the next phase.
|
|
111
|
+
await new Promise(resolve => setTimeout(resolve, 5200));
|
|
112
|
+
|
|
113
|
+
// expected1b + expected2 (export failure): block cache/exports with a file.
|
|
114
|
+
const downloadDir = path.join(ARTIFACTS, 'downloads');
|
|
115
|
+
fs.mkdirSync(downloadDir, { recursive: true });
|
|
116
|
+
await browser.send('Page.setDownloadBehavior', { behavior: 'allow', downloadPath: downloadDir });
|
|
117
|
+
const exportsPath = path.join(fixture.dataDir, 'cache', 'exports');
|
|
118
|
+
const exportsWasDirectory = fs.existsSync(exportsPath) && fs.statSync(exportsPath).isDirectory();
|
|
119
|
+
if (exportsWasDirectory) fs.rmSync(exportsPath, { recursive: true, force: true });
|
|
120
|
+
fs.mkdirSync(path.dirname(exportsPath), { recursive: true });
|
|
121
|
+
fs.writeFileSync(exportsPath, 'blocked by LOG-008 driver');
|
|
122
|
+
const downloadsBefore = fs.readdirSync(downloadDir).length;
|
|
123
|
+
|
|
124
|
+
await runExpr(`document.getElementById('logsSearch').value = ''`);
|
|
125
|
+
await click('#exportLogs');
|
|
126
|
+
await waitFor(async () => {
|
|
127
|
+
const dom = JSON.parse(await readDom());
|
|
128
|
+
return !dom.toastHidden && dom.toastText.includes('诊断导出失败');
|
|
129
|
+
}, 'export failure toast appears', 8000);
|
|
130
|
+
await new Promise(resolve => setTimeout(resolve, 1500));
|
|
131
|
+
const downloadsAfter = fs.readdirSync(downloadDir).length;
|
|
132
|
+
const domExportFail = JSON.parse(await readDom());
|
|
133
|
+
const exportProxyEntry = proxy.state.requests.filter(r => r.pathname === '/api/logs/export').slice(-1)[0] || null;
|
|
134
|
+
evidence.phases.exportFailure = {
|
|
135
|
+
toastText: domExportFail.toastText,
|
|
136
|
+
exportStatusViaProxy: exportProxyEntry && exportProxyEntry.status,
|
|
137
|
+
downloadsBefore, downloadsAfter,
|
|
138
|
+
downloadedFileCount: downloadsAfter - downloadsBefore,
|
|
139
|
+
noFakeEmptyFile: downloadsAfter === downloadsBefore,
|
|
140
|
+
};
|
|
141
|
+
if (!domExportFail.toastText.includes('诊断导出失败')) throw new Error('UI did not surface the export failure');
|
|
142
|
+
if (downloadsAfter !== downloadsBefore) throw new Error('a download file appeared despite the failed export');
|
|
143
|
+
await browser.screenshot(path.join(ARTIFACTS, 'log008-export-failure-toast.png'));
|
|
144
|
+
|
|
145
|
+
// Control: unblock and confirm the export route recovers (no lasting damage).
|
|
146
|
+
fs.rmSync(exportsPath, { force: true });
|
|
147
|
+
const controlRes = await fetch(`${base}/api/logs/export?projectId=${PROJECT_A}`);
|
|
148
|
+
const controlText = await controlRes.text();
|
|
149
|
+
evidence.phases.exportRecovery = {
|
|
150
|
+
status: controlRes.status,
|
|
151
|
+
exportedLines: controlText.trim().split('\n').filter(Boolean).length,
|
|
152
|
+
};
|
|
153
|
+
if (controlRes.status !== 200 || !controlText.includes('log008.seed.1')) throw new Error('export route did not recover after unblocking');
|
|
154
|
+
|
|
155
|
+
if (browser.exceptions.length) throw new Error(`browser exceptions: ${JSON.stringify(browser.exceptions)}`);
|
|
156
|
+
evidence.verdict = { 'expected1 UI显示失败(超时+导出)': 'PASS', 'expected2 未生成空文件冒充导出成功': 'PASS' };
|
|
157
|
+
console.log('LOG-008 PASS');
|
|
158
|
+
process.exitCode = 0;
|
|
159
|
+
} catch (error) {
|
|
160
|
+
evidence.verdict = { failed: String((error && error.stack) || error) };
|
|
161
|
+
try {
|
|
162
|
+
if (browser) {
|
|
163
|
+
evidence.debugDom = JSON.parse(await browser.evaluate(`JSON.stringify({ dialogOpen: document.getElementById('logsDialog').open, entries: document.querySelectorAll('#logsContent .log-entry').length, toast: document.getElementById('toast').textContent })`));
|
|
164
|
+
evidence.debugConsoleErrors = browser.consoleErrors;
|
|
165
|
+
}
|
|
166
|
+
if (proxy) evidence.debugProxy = proxy.state.snapshot();
|
|
167
|
+
} catch {}
|
|
168
|
+
process.exitCode = 1;
|
|
169
|
+
console.error(`LOG-008 FAIL: ${error.message}`);
|
|
170
|
+
} finally {
|
|
171
|
+
evidence.finishedAt = new Date().toISOString();
|
|
172
|
+
try { if (browser) await browser.screenshot(path.join(ARTIFACTS, 'log008-final.png')); } catch {}
|
|
173
|
+
fs.mkdirSync(ARTIFACTS, { recursive: true });
|
|
174
|
+
fs.writeFileSync(path.join(ARTIFACTS, 'log008-evidence.json'), JSON.stringify(evidence, null, 2) + '\n');
|
|
175
|
+
try { await browser?.close(); } finally { try { if (proxy) await proxy.close(); } finally { try { await server.cleanup(); } finally { fixture.cleanup(); } } }
|
|
176
|
+
lane.cleanup();
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
main();
|
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// P-LOG-SAFETY-R2 hook floating-rejection probe (lane-exclusive prefix
|
|
3
|
+
// parallel-logging-fix-r2-*).
|
|
4
|
+
//
|
|
5
|
+
// Scenario: a route-acceptable but semantically incomplete hook event
|
|
6
|
+
// (schema ok, projectId registered, repoRoot non-empty, head NOT a full
|
|
7
|
+
// SHA) is POSTed to an isolated legacy instance with real registered Git
|
|
8
|
+
// fixtures. The route answers 202 and the background task fails for a
|
|
9
|
+
// legitimate reason (scanner.validateSha). This probe observes what the
|
|
10
|
+
// server PROCESS does next:
|
|
11
|
+
//
|
|
12
|
+
// --expect red old candidate: unhandledRejection terminates the whole
|
|
13
|
+
// server (R1 finding findings/log004-hook-unhandled-rejection).
|
|
14
|
+
// --expect green fixed candidate: same PID stays healthy, failure
|
|
15
|
+
// diagnostics remain traceable (background.operation_failed
|
|
16
|
+
// with the operationId), the OTHER project keeps serving,
|
|
17
|
+
// and no fake succeeded record appears.
|
|
18
|
+
// --scenario engine-ack
|
|
19
|
+
// observation-only: engine-ownership instance (dead bridge
|
|
20
|
+
// URL) ack behaviour for the same payload; recorded pre-fix
|
|
21
|
+
// and post-fix to prove the engine branch is untouched.
|
|
22
|
+
//
|
|
23
|
+
// Isolation: independent KB_DATA_DIR/KB_KNOWLEDGE_DATA_DIR (fixture +
|
|
24
|
+
// spawnServer), ephemeral port, TEMP/TMP/TMPDIR under the lane temp root.
|
|
25
|
+
// No payload is ever sent to the real desktop instance on 5757/5760.
|
|
26
|
+
|
|
27
|
+
const fs = require('node:fs');
|
|
28
|
+
const path = require('node:path');
|
|
29
|
+
|
|
30
|
+
// Portable isolation (P-QA-LOG-INTEGRATION-5025): the temp root comes from
|
|
31
|
+
// PK_TEST_TEMP_ROOT or os.tmpdir() and must live outside the source tree;
|
|
32
|
+
// HOME/APPDATA/LOCALAPPDATA/TEMP/CODEX_HOME/CLAUDE_CONFIG_DIR and the dual
|
|
33
|
+
// product data roots are redirected before any other module is loaded.
|
|
34
|
+
const { installLoggingTestEnv, resolveEvidenceDir } = require('./helpers/parallel-logging-integration-5025-env');
|
|
35
|
+
const lane = installLoggingTestEnv({ caseId: 'LOGFIXR2-CRASH', prefix: 'logfixr2-crash' });
|
|
36
|
+
const laneTmp = lane.laneTmp;
|
|
37
|
+
|
|
38
|
+
const { spawnServer } = require('./helpers/spawn-server');
|
|
39
|
+
const freePort = require('./helpers/free-port');
|
|
40
|
+
const { createLoggingAcceptanceFixture } = require('./helpers/parallel-logging-acceptance-fixture');
|
|
41
|
+
|
|
42
|
+
const ROOT = path.resolve(__dirname, '../..');
|
|
43
|
+
const ARTIFACTS = resolveEvidenceDir(path.resolve(ROOT, 'qa-autopilot/artifacts/parallel-20261023/logging-fix-r2/evidence/crash'));
|
|
44
|
+
|
|
45
|
+
const PROJECT_A = 'project-logfixr2-alpha';
|
|
46
|
+
const PROJECT_B = 'project-logfixr2-beta';
|
|
47
|
+
const INVALID_OPERATION = 'op-logfixr2-invalid-0001';
|
|
48
|
+
const SCENARIO = process.argv.includes('--scenario')
|
|
49
|
+
? process.argv[process.argv.indexOf('--scenario') + 1]
|
|
50
|
+
: 'legacy-invalid';
|
|
51
|
+
const EXPECT = process.argv.includes('--expect')
|
|
52
|
+
? process.argv[process.argv.indexOf('--expect') + 1]
|
|
53
|
+
: null;
|
|
54
|
+
const HARD_TIMEOUT_MS = 120000;
|
|
55
|
+
|
|
56
|
+
const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
|
|
57
|
+
const now = () => new Date().toISOString();
|
|
58
|
+
|
|
59
|
+
function projectLogRecords(dataDir, projectId) {
|
|
60
|
+
const dir = path.join(dataDir, 'logs', 'projects', projectId);
|
|
61
|
+
if (!fs.existsSync(dir)) return [];
|
|
62
|
+
const records = [];
|
|
63
|
+
for (const file of fs.readdirSync(dir).filter(name => name.endsWith('.jsonl')).sort()) {
|
|
64
|
+
for (const line of fs.readFileSync(path.join(dir, file), 'utf8').split('\n')) {
|
|
65
|
+
if (!line.trim()) continue;
|
|
66
|
+
try { records.push(JSON.parse(line)); } catch {}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return records;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
async function fetchJson(url, options) {
|
|
73
|
+
const res = await fetch(url, options);
|
|
74
|
+
let body = null;
|
|
75
|
+
try { body = await res.json(); } catch {}
|
|
76
|
+
return { status: res.status, ok: res.ok, body };
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
async function main() {
|
|
80
|
+
fs.mkdirSync(ARTIFACTS, { recursive: true });
|
|
81
|
+
const evidence = {
|
|
82
|
+
probe: 'parallel-logging-fix-r2-crash-probe.js',
|
|
83
|
+
scenario: SCENARIO,
|
|
84
|
+
expect: EXPECT,
|
|
85
|
+
startedAt: now(),
|
|
86
|
+
serverAppSha256: (() => {
|
|
87
|
+
const crypto = require('node:crypto');
|
|
88
|
+
return crypto.createHash('sha256').update(fs.readFileSync(path.join(ROOT, '_site', 'lib', 'server-app.js'))).digest('hex');
|
|
89
|
+
})(),
|
|
90
|
+
};
|
|
91
|
+
|
|
92
|
+
const fixture = await createLoggingAcceptanceFixture({
|
|
93
|
+
caseId: 'logfixr2',
|
|
94
|
+
projects: [
|
|
95
|
+
{ projectId: PROJECT_A, displayName: 'LOGFIXR2甲项目' },
|
|
96
|
+
{ projectId: PROJECT_B, displayName: 'LOGFIXR2乙项目' },
|
|
97
|
+
],
|
|
98
|
+
});
|
|
99
|
+
await fixture.logger.close();
|
|
100
|
+
|
|
101
|
+
const port = await freePort();
|
|
102
|
+
const base = `http://127.0.0.1:${port}`;
|
|
103
|
+
const analysisOwner = SCENARIO === 'engine-ack' ? 'engine' : 'legacy';
|
|
104
|
+
const server = spawnServer({
|
|
105
|
+
root: ROOT,
|
|
106
|
+
port,
|
|
107
|
+
dataDir: fixture.dataDir,
|
|
108
|
+
tag: 'logfixr2',
|
|
109
|
+
analysisOwner,
|
|
110
|
+
extraEnv: { KB_AUTOMATION_FAKE_CLAUDE: '1' },
|
|
111
|
+
});
|
|
112
|
+
let stdout = '';
|
|
113
|
+
let stderr = '';
|
|
114
|
+
server.child.stdout.on('data', chunk => { stdout += chunk; });
|
|
115
|
+
server.child.stderr.on('data', chunk => { stderr += chunk; });
|
|
116
|
+
let exitInfo = null;
|
|
117
|
+
server.child.once('exit', (code, signal) => { exitInfo = { code, signal, at: now() }; });
|
|
118
|
+
evidence.server = { pid: server.child.pid, port, analysisOwner, dataDir: fixture.dataDir };
|
|
119
|
+
|
|
120
|
+
try {
|
|
121
|
+
// Boot wait (real health endpoint, not a sleep guess).
|
|
122
|
+
const bootDeadline = Date.now() + 30000;
|
|
123
|
+
let health = null;
|
|
124
|
+
while (Date.now() < bootDeadline) {
|
|
125
|
+
try {
|
|
126
|
+
const res = await fetch(`${base}/api/health`);
|
|
127
|
+
if (res.ok) { health = await res.json(); break; }
|
|
128
|
+
} catch {}
|
|
129
|
+
await sleep(200);
|
|
130
|
+
}
|
|
131
|
+
if (!health) throw new Error('isolated server did not become healthy within 30s');
|
|
132
|
+
evidence.boot = { healthyAt: now(), pid: server.child.pid };
|
|
133
|
+
|
|
134
|
+
// Route-acceptable but semantically incomplete hook payload (head is not
|
|
135
|
+
// a full 40-char SHA). The route layer accepts it; the background task
|
|
136
|
+
// fails in scanner.validateSha for a legitimate reason.
|
|
137
|
+
const repoA = fixture.projects.find(p => p.projectId === PROJECT_A).repo.path;
|
|
138
|
+
const hookPayload = {
|
|
139
|
+
schema: 'hook-event/v2',
|
|
140
|
+
projectId: PROJECT_A,
|
|
141
|
+
repoRoot: repoA,
|
|
142
|
+
head: 'deadbeef-not-a-full-sha',
|
|
143
|
+
branch: 'main',
|
|
144
|
+
operationId: INVALID_OPERATION,
|
|
145
|
+
};
|
|
146
|
+
const post = await fetchJson(`${base}/api/hooks/post-commit`, {
|
|
147
|
+
method: 'POST',
|
|
148
|
+
headers: { 'content-type': 'application/json' },
|
|
149
|
+
body: JSON.stringify(hookPayload),
|
|
150
|
+
});
|
|
151
|
+
evidence.hookPost = { at: now(), status: post.status, body: post.body };
|
|
152
|
+
|
|
153
|
+
if (SCENARIO === 'engine-ack') {
|
|
154
|
+
// Observation only: the engine branch is untouched by the fix; capture
|
|
155
|
+
// its synchronous ack for pre/post parity.
|
|
156
|
+
await sleep(1000);
|
|
157
|
+
const healthAfter = await fetchJson(`${base}/api/health`);
|
|
158
|
+
evidence.engineAck = { healthAfter: { status: healthAfter.status, ok: healthAfter.ok }, exited: exitInfo ? exitInfo : null };
|
|
159
|
+
evidence.observation = 'engine-branch ack recorded';
|
|
160
|
+
fs.writeFileSync(path.join(ARTIFACTS, 'engine-ack-result.json'), JSON.stringify(evidence, null, 2) + '\n');
|
|
161
|
+
console.log(`engine-ack: hook status=${post.status} health=${healthAfter.status} exit=${exitInfo ? exitInfo.code : 'alive'}`);
|
|
162
|
+
process.exitCode = 0;
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
// Observe the process for up to 15s after the accepted failure.
|
|
167
|
+
const watchDeadline = Date.now() + 15000;
|
|
168
|
+
const healthTrace = [];
|
|
169
|
+
let diedAt = null;
|
|
170
|
+
while (Date.now() < watchDeadline) {
|
|
171
|
+
let alive = false;
|
|
172
|
+
try { const res = await fetch(`${base}/api/health`, { signal: AbortSignal.timeout(1500) }); alive = res.ok; } catch {}
|
|
173
|
+
healthTrace.push({ at: now(), alive });
|
|
174
|
+
if (!alive) { diedAt = now(); break; }
|
|
175
|
+
if (exitInfo) break;
|
|
176
|
+
await sleep(250);
|
|
177
|
+
}
|
|
178
|
+
// Give a possibly-terminating process a moment to fully exit so exitInfo
|
|
179
|
+
// is captured deterministically.
|
|
180
|
+
await sleep(1500);
|
|
181
|
+
evidence.healthTrace = healthTrace;
|
|
182
|
+
evidence.diedAt = diedAt;
|
|
183
|
+
evidence.exitInfo = exitInfo;
|
|
184
|
+
|
|
185
|
+
const records = projectLogRecords(fixture.dataDir, PROJECT_A);
|
|
186
|
+
const failed = records.filter(r => r.event === 'background.operation_failed');
|
|
187
|
+
const completed = records.filter(r => r.event === 'background.operation_completed');
|
|
188
|
+
evidence.diagnostics = {
|
|
189
|
+
operationFailedRecords: failed.map(r => ({
|
|
190
|
+
operationId: r.operationId,
|
|
191
|
+
errorCode: r.error && r.error.code,
|
|
192
|
+
errorMessage: r.error && r.error.message,
|
|
193
|
+
stackHead: (r.error && r.error.stack || []).slice(0, 4),
|
|
194
|
+
ts: r.ts,
|
|
195
|
+
})),
|
|
196
|
+
invalidOperationCompleted: completed.filter(r => r.operationId === INVALID_OPERATION).map(r => r.operationId),
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
let controlProjectOk = null;
|
|
200
|
+
let controlEvidence = null;
|
|
201
|
+
if (exitInfo === null) {
|
|
202
|
+
// Server survived: prove the OTHER project still serves real requests.
|
|
203
|
+
const goalRes = await fetchJson(`${base}/api/projects/${PROJECT_B}/goal`, {
|
|
204
|
+
method: 'PUT',
|
|
205
|
+
headers: { 'content-type': 'application/json' },
|
|
206
|
+
body: JSON.stringify({ content: `LOGFIXR2 control goal ${Date.now()} pad-${'x'.repeat(64)}` }),
|
|
207
|
+
});
|
|
208
|
+
const logsRes = await fetchJson(`${base}/api/logs?pageSize=50&projectId=${PROJECT_B}`);
|
|
209
|
+
const goalUpdated = ((logsRes.body || {}).entries || []).some(e => e.event === 'goal.updated');
|
|
210
|
+
controlEvidence = { goalPutStatus: goalRes.status, logsStatus: logsRes.status, goalUpdatedSeen: goalUpdated };
|
|
211
|
+
controlProjectOk = goalRes.ok && logsRes.ok && goalUpdated;
|
|
212
|
+
evidence.controlProject = controlEvidence;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// Verdict against the declared expectation.
|
|
216
|
+
const serverDied = exitInfo !== null || diedAt !== null;
|
|
217
|
+
const failedForInvalid = evidence.diagnostics.operationFailedRecords.some(r => r.operationId === INVALID_OPERATION);
|
|
218
|
+
const noFakeSuccess = evidence.diagnostics.invalidOperationCompleted.length === 0;
|
|
219
|
+
let verdict;
|
|
220
|
+
if (EXPECT === 'red') {
|
|
221
|
+
verdict = { serverDied, failedDiagnosticPresent: failedForInvalid || serverDied };
|
|
222
|
+
evidence.verdict = verdict;
|
|
223
|
+
if (!serverDied) throw new Error('RED expected: server was expected to die from unhandledRejection but stayed healthy');
|
|
224
|
+
} else if (EXPECT === 'green') {
|
|
225
|
+
verdict = {
|
|
226
|
+
samePidAlive: exitInfo === null && diedAt === null,
|
|
227
|
+
failureDiagnosticTraceable: failedForInvalid,
|
|
228
|
+
noFakeSucceeded: noFakeSuccess,
|
|
229
|
+
controlProjectOk,
|
|
230
|
+
};
|
|
231
|
+
evidence.verdict = verdict;
|
|
232
|
+
if (!(verdict.samePidAlive && verdict.failureDiagnosticTraceable && verdict.noFakeSucceeded && verdict.controlProjectOk)) {
|
|
233
|
+
throw new Error(`GREEN expectation not met: ${JSON.stringify(verdict)}`);
|
|
234
|
+
}
|
|
235
|
+
} else {
|
|
236
|
+
evidence.verdict = { observedOnly: true, serverDied };
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
const file = EXPECT === 'red' ? 'red-result.json' : EXPECT === 'green' ? 'green-result.json' : 'observation.json';
|
|
240
|
+
fs.writeFileSync(path.join(ARTIFACTS, file), JSON.stringify(evidence, null, 2) + '\n');
|
|
241
|
+
console.log(`${EXPECT || 'observe'}: serverDied=${serverDied} exit=${exitInfo ? exitInfo.code : 'alive'} failedDiagnostic=${failedForInvalid} fakeSuccess=${!noFakeSuccess} controlOk=${controlProjectOk}`);
|
|
242
|
+
process.exitCode = 0;
|
|
243
|
+
} catch (error) {
|
|
244
|
+
evidence.error = String((error && error.stack) || error);
|
|
245
|
+
fs.writeFileSync(path.join(ARTIFACTS, `${EXPECT || 'observe'}-failure.json`), JSON.stringify(evidence, null, 2) + '\n');
|
|
246
|
+
console.error(`crash-probe FAIL: ${error.message}`);
|
|
247
|
+
process.exitCode = 1;
|
|
248
|
+
} finally {
|
|
249
|
+
evidence.finishedAt = now();
|
|
250
|
+
evidence.serverStdout = stdout.slice(-4000);
|
|
251
|
+
evidence.serverStderr = stderr.slice(-4000);
|
|
252
|
+
try {
|
|
253
|
+
fs.writeFileSync(path.join(ARTIFACTS, `${EXPECT || 'observe'}-server-io.json`), JSON.stringify({ stdout: stdout.slice(-8000), stderr: stderr.slice(-8000), exitInfo }, null, 2) + '\n');
|
|
254
|
+
} catch {}
|
|
255
|
+
try { await server.cleanup(); } finally { fixture.cleanup(); }
|
|
256
|
+
lane.cleanup();
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
const hardTimer = setTimeout(() => {
|
|
261
|
+
// Total-timeout scene preservation: dump what we know and stop.
|
|
262
|
+
try {
|
|
263
|
+
fs.mkdirSync(ARTIFACTS, { recursive: true });
|
|
264
|
+
fs.writeFileSync(path.join(ARTIFACTS, 'hard-timeout.json'), JSON.stringify({ at: now(), scenario: SCENARIO, expect: EXPECT }, null, 2) + '\n');
|
|
265
|
+
} catch {}
|
|
266
|
+
console.error('crash-probe HARD TIMEOUT');
|
|
267
|
+
process.exit(2);
|
|
268
|
+
}, HARD_TIMEOUT_MS);
|
|
269
|
+
hardTimer.unref();
|
|
270
|
+
|
|
271
|
+
main();
|