ctxtop 4.1.0 → 4.1.1
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/.antigravity-plugin/plugin.json +1 -1
- package/.claude-plugin/plugin.json +21 -18
- package/CHECKSUMS.sha256 +51 -44
- package/LICENSE +27 -27
- package/README.md +90 -56
- package/SECURITY.md +7 -1
- package/assets/hero-demo.svg +1 -1
- package/bin/ctxtop.mjs +267 -54
- package/config/modelCatalog.json +847 -273
- package/hooks/handlers/hookIpcClient.mjs +8 -4
- package/hooks/handlers/post-model-switch.mjs +39 -2
- package/hooks/handlers/post-tool-use-core.mjs +394 -0
- package/hooks/handlers/post-tool-use.mjs +54 -321
- package/hooks/handlers/pre-model-switch.mjs +115 -5
- package/hooks/handlers/pre-tool-use-core.mjs +680 -0
- package/hooks/handlers/pre-tool-use.mjs +61 -571
- package/hooks/handlers/stop-gate.mjs +20 -8
- package/hooks/handlers/user-prompt-submit.mjs +111 -2
- package/hooks/post_tool_use.mjs +17 -4
- package/hooks/pre_tool_use.mjs +84 -54
- package/hooks.json +56 -56
- package/package.json +4 -3
- package/packages/antigravity/package.json +10 -3
- package/packages/antigravity/src/adapter.mjs +109 -0
- package/packages/antigravity/src/index.mjs +7 -1
- package/packages/claude-code/package.json +10 -3
- package/packages/claude-code/src/adapter.mjs +194 -0
- package/packages/claude-code/src/index.mjs +8 -2
- package/packages/claude-code/src/register.js +726 -0
- package/packages/core/package.json +6 -2
- package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
- package/packages/core/src/catalog/index.mjs +1 -0
- package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
- package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
- package/packages/core/src/coach/microSkills.mjs +1 -0
- package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/core/src/coach/repoCalibration.mjs +254 -0
- package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
- package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
- package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
- package/packages/core/src/config/anthropicModelCatalog.json +607 -0
- package/packages/core/src/config/catalogLoader.mjs +1271 -0
- package/packages/core/src/config/horizonConfig.mjs +1055 -0
- package/packages/core/src/control/callTree.mjs +338 -0
- package/packages/core/src/control/coachLatches.mjs +126 -0
- package/packages/core/src/control/controlStateMachine.mjs +205 -0
- package/packages/core/src/control/index.mjs +49 -0
- package/packages/core/src/control/swarmWorktree.mjs +109 -0
- package/packages/core/src/control/toolSuspension.mjs +197 -0
- package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
- package/packages/core/src/diagnostics/index.mjs +9 -0
- package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
- package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/core/src/economics/billingBlocks.mjs +251 -0
- package/packages/core/src/economics/cacheGravity.mjs +371 -0
- package/packages/core/src/economics/cliffBreaker.mjs +256 -0
- package/packages/core/src/economics/driftLatency.mjs +433 -0
- package/packages/core/src/economics/dualTtl.mjs +198 -0
- package/packages/core/src/economics/index.mjs +47 -0
- package/packages/core/src/economics/retentionRadar.mjs +348 -0
- package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
- package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/core/src/guards/bucketBGamma.mjs +442 -0
- package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
- package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
- package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/core/src/guards/docIndexCore.mjs +446 -0
- package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/core/src/guards/slopsquatGate.mjs +551 -0
- package/packages/core/src/index.js +27 -0
- package/packages/core/src/index.mjs +25 -1
- package/packages/core/src/telemetry/otelExporter.mjs +187 -0
- package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
- package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
- package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/core/src/ui/brailleSparkline.mjs +142 -0
- package/packages/core/src/ui/costRadarSvg.mjs +276 -0
- package/packages/core/src/ui/horizonGrid.mjs +475 -0
- package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/core/src/ui/modViews.mjs +1558 -0
- package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/core/src/ustf/index.mjs +7 -0
- package/packages/core/src/ustf/normalizer.mjs +512 -0
- package/packages/core/src/ustf/schema.mjs +186 -0
- package/packages/core/src/utils/runtime.mjs +962 -0
- package/packages/engine-node/package.json +6 -2
- package/packages/engine-node/src/db/index.mjs +58 -0
- package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
- package/packages/engine-node/src/db/probe.mjs +342 -0
- package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
- package/packages/engine-node/src/index.mjs +11 -1
- package/packages/engine-node/src/ipc/client.mjs +447 -0
- package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
- package/packages/engine-node/src/ipc/index.mjs +24 -0
- package/packages/engine-node/src/ipc/protocol.mjs +177 -0
- package/packages/engine-node/src/ipc/server.mjs +445 -0
- package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
- package/packages/engine-node/src/offloader/index.mjs +6 -0
- package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
- package/packages/engine-node/src/rsl/index.mjs +3 -0
- package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
- package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
- package/packages/engine-node/src/sensors/index.mjs +7 -0
- package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
- package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
- package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
- package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
- package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
- package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
- package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
- package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
- package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
- package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
- package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
- package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
- package/packages/mcp/package.json +7 -3
- package/packages/mcp/src/server.mjs +115 -14
- package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
- package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
- package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
- package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
- package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
- package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
- package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
- package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
- package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
- package/packages/mcp/src/vendor/core/paths.mjs +311 -0
- package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
- package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
- package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
- package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
- package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
- package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
- package/packages/pro/package.json +23 -16
- package/packages/pro/src/index.mjs +9 -3
- package/packages/pro/src/pro_license.mjs +547 -0
- package/packages/pro/src/team_finops_pack.mjs +241 -241
- package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
- package/plugin.json +1 -1
- package/sidecars/horizon-daemon/server.mjs +482 -44
- package/src/cli/doctor.mjs +11 -2
- package/src/cli/horizon_hud.mjs +31 -15
- package/src/cli/init.mjs +46 -13
- package/src/config/modelCatalog.json +886 -231
- package/src/core/classifier.mjs +25 -11
- package/src/core/coach/circuit_breakers.mjs +84 -6
- package/src/core/coach/task_quota_router.mjs +8 -0
- package/src/core/code_fold_lite.mjs +169 -0
- package/src/core/config.mjs +44 -0
- package/src/core/constants.mjs +175 -12
- package/src/core/detectors_det01_to_16.mjs +44 -3
- package/src/core/fts5_output_compressor.mjs +272 -35
- package/src/core/horizon_config.mjs +42 -0
- package/src/core/parser.mjs +86 -11
- package/src/core/pro_license.mjs +174 -12
- package/src/core/pruner.mjs +7 -146
- package/src/core/quota.mjs +14 -2
- package/src/core/rsl_distiller.mjs +31 -9
- package/src/core/rsl_ledger.mjs +66 -6
- package/src/core/rsl_triage.mjs +159 -17
- package/src/core/session_auditor.mjs +476 -25
- package/src/core/shadow_auto_ledger.mjs +205 -0
- package/src/core/sqlite_client.mjs +10 -4
- package/src/core/subagents.mjs +18 -2
- package/src/core/task_quota_router.mjs +61 -4
- package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
- package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
- package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
- package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
- package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
- package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
- package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
- package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
- package/src/core-isomorphic/ui/modViews.mjs +62 -8
- package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
- package/src/diagnostics/doctorEngine.mjs +28 -2
- package/src/engine-node/ipc/fast_client.mjs +191 -0
- package/src/engine-node/ipc/index.mjs +2 -0
- package/src/engine-node/multi_host_mcp.mjs +168 -0
- package/src/hooks/antigravity_rsl_hook.mjs +24 -2
- package/src/hooks/claude_rsl_hook.mjs +22 -2
- package/src/hooks/daemon_hook_bridge.mjs +256 -0
- package/src/hooks/fast_hook_ipc.mjs +295 -0
- package/src/hooks/post_invocation.mjs +37 -597
- package/src/hooks/post_invocation_core.mjs +623 -0
- package/src/hooks/pre_invocation.mjs +103 -1668
- package/src/hooks/pre_invocation_core.mjs +1830 -0
- package/src/utils/sessionCalibration.mjs +52 -5
- package/src/webview/advanced_view.html +34 -18
- package/src/webview/horizon_panel.html +3233 -675
- package/src/webview/simple_view.html +1 -1
|
@@ -0,0 +1,913 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core-isomorphic/guards/det13_20_mcp_scope.mjs
|
|
3
|
+
* MCP Schema Bloat, Premature Stop, Format Batch, Subagent Recursion, Auto-Compaction, Settings Guard, IPI Sanitizer & Scope Lock (`DET-13`..`DET-20`).
|
|
4
|
+
* Pure-V8 isomorphic ESM module (zero `node:*` imports).
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { path, getCwd, readJsonSafe, writeJsonAtomic } from '../utils/runtime.mjs';
|
|
8
|
+
import {
|
|
9
|
+
FLIGHT_MODES,
|
|
10
|
+
normalizeFlightMode,
|
|
11
|
+
isSilentOrOffMode
|
|
12
|
+
} from '../coach/cacheGravityRouter.mjs';
|
|
13
|
+
import { RELAY_STATES } from '../coach/promptHygieneGovernor.mjs';
|
|
14
|
+
import { evaluateScopeAndQuotaBrake } from '../telemetry/scopeLockRegistry.mjs';
|
|
15
|
+
import { EDIT_WRITE_TOOL_REGEX } from './det01_03_shell_secret.mjs';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* DET-13: MCP Schema Bloat (`> 15k` startup tokens / `20+` tools) & `tools_changed` Cache-Miss Guard.
|
|
19
|
+
*
|
|
20
|
+
* @param {object} [params={}]
|
|
21
|
+
* @param {number} [params.mcpSchemaTokens=0]
|
|
22
|
+
* @param {number} [params.mcpToolCount=0]
|
|
23
|
+
* @param {string|null} [params.lastMissCause=null]
|
|
24
|
+
* @param {boolean} [params.toolsChanged=false]
|
|
25
|
+
* @param {boolean} [params.cacheWarm=false]
|
|
26
|
+
*/
|
|
27
|
+
export function evaluateDet13McpSchemaBloatGuard(params = {}) {
|
|
28
|
+
const mcpSchemaTokens = Math.max(0, Number(params.mcpSchemaTokens || 0));
|
|
29
|
+
const mcpToolCount = Math.max(0, Number(params.mcpToolCount || 0));
|
|
30
|
+
const bundledSkillsTokens = Math.max(0, Number(params.bundledSkillsTokens || 0));
|
|
31
|
+
const syncedSkillsTokens = Math.max(0, Number(params.syncedSkillsTokens || 0));
|
|
32
|
+
const claudeMdTokens = Math.max(0, Number(params.claudeMdTokens || 0));
|
|
33
|
+
const turnsElapsed = Math.max(0, Number(params.turnsElapsed || 0));
|
|
34
|
+
const mcpInvocations = Math.max(0, Number(params.mcpInvocations || 0));
|
|
35
|
+
const turn0StaticPrefillBreakdown = {
|
|
36
|
+
bundledSkillsTokens,
|
|
37
|
+
syncedSkillsTokens,
|
|
38
|
+
mcpSchemaTokens,
|
|
39
|
+
claudeMdTokens,
|
|
40
|
+
totalStaticPrefillTokens:
|
|
41
|
+
bundledSkillsTokens + syncedSkillsTokens + mcpSchemaTokens + claudeMdTokens
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
const lastMissCause =
|
|
45
|
+
params.lastMissCause || (params.toolsChanged ? 'tools_changed' : null);
|
|
46
|
+
|
|
47
|
+
if (lastMissCause === 'tools_changed') {
|
|
48
|
+
return {
|
|
49
|
+
detectorId: 'DET-13',
|
|
50
|
+
triggered: true,
|
|
51
|
+
decision: 'defer_mcp_mutation',
|
|
52
|
+
advisory: true,
|
|
53
|
+
subType: 'TOOLS_CHANGED_CACHE_MISS',
|
|
54
|
+
mcpSchemaTokens,
|
|
55
|
+
mcpToolCount,
|
|
56
|
+
turn0StaticPrefillBreakdown,
|
|
57
|
+
reason: `[DET-13 MCP Cache-Miss Guard] Mid-session MCP "tools_changed" invalidated the warm prompt cache prefix. Queue dynamic MCP registrations in PostCompactMutationQueue.`
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const idleMcpHoarding5Turns =
|
|
62
|
+
mcpSchemaTokens >= 15_000 && turnsElapsed >= 5 && mcpInvocations === 0;
|
|
63
|
+
|
|
64
|
+
if (idleMcpHoarding5Turns) {
|
|
65
|
+
return {
|
|
66
|
+
detectorId: 'DET-13',
|
|
67
|
+
triggered: true,
|
|
68
|
+
decision: 'advise_lazy_mcp',
|
|
69
|
+
advisory: true,
|
|
70
|
+
subType: 'IDLE_MCP_HOARDING_5_TURNS',
|
|
71
|
+
recommendedEnv: 'ENABLE_TOOL_SEARCH=auto:5',
|
|
72
|
+
mcpSchemaTokens,
|
|
73
|
+
mcpToolCount,
|
|
74
|
+
turn0StaticPrefillBreakdown,
|
|
75
|
+
reason: `[DET-13 Idle MCP Hoarding] ${mcpSchemaTokens.toLocaleString()} MCP schema tokens injected with 0 invocations across ${turnsElapsed} turns (Turn-0 prefill = ${turn0StaticPrefillBreakdown.totalStaticPrefillTokens.toLocaleString()} tok). Set ENABLE_TOOL_SEARCH=auto:5 or disable unused MCP servers.`
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
if (mcpSchemaTokens > 15_000 || mcpToolCount >= 20) {
|
|
80
|
+
return {
|
|
81
|
+
detectorId: 'DET-13',
|
|
82
|
+
triggered: true,
|
|
83
|
+
decision: 'advise_lazy_mcp',
|
|
84
|
+
advisory: true,
|
|
85
|
+
subType: 'MCP_SCHEMA_BLOAT',
|
|
86
|
+
recommendedEnv: 'ENABLE_TOOL_SEARCH=auto:5',
|
|
87
|
+
mcpSchemaTokens,
|
|
88
|
+
mcpToolCount,
|
|
89
|
+
turn0StaticPrefillBreakdown,
|
|
90
|
+
reason: `[DET-13 MCP Schema Bloat] ${mcpToolCount} MCP tools consuming ${mcpSchemaTokens.toLocaleString()} startup tokens (> 15k cap). Set ENABLE_TOOL_SEARCH=auto:5 or disable unused MCP servers.`
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
return {
|
|
95
|
+
detectorId: 'DET-13',
|
|
96
|
+
triggered: false,
|
|
97
|
+
decision: 'allow',
|
|
98
|
+
mcpSchemaTokens,
|
|
99
|
+
mcpToolCount,
|
|
100
|
+
turn0StaticPrefillBreakdown,
|
|
101
|
+
reason: null
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* DET-14: Premature Completion `Stop` Gate.
|
|
107
|
+
* Strictly checks `stop_hook_active` first to prevent infinite loops.
|
|
108
|
+
* Advisory in `COACH` mode; blocks `Stop` in `AUTO_PILOT` mode only when code was edited without running tests.
|
|
109
|
+
*
|
|
110
|
+
* @param {object} [params={}]
|
|
111
|
+
* @param {boolean} [params.stopHookActive=false]
|
|
112
|
+
* @param {boolean} [params.codeEditedSinceLastTest=false]
|
|
113
|
+
* @param {Array<string>} [params.editedFiles=[]]
|
|
114
|
+
* @param {'OFF'|'SILENT'|'COACH'|'AUTO_PILOT'} [params.mode='COACH']
|
|
115
|
+
*/
|
|
116
|
+
export function evaluateDet14PrematureStopGate(params = {}) {
|
|
117
|
+
const stopHookActive = Boolean(params.stopHookActive ?? params.stop_hook_active ?? false);
|
|
118
|
+
const mode = normalizeFlightMode(params.mode || FLIGHT_MODES.COACH);
|
|
119
|
+
const editedFiles = Array.isArray(params.editedFiles) ? params.editedFiles : [];
|
|
120
|
+
const codeEditedSinceLastTest = Boolean(
|
|
121
|
+
params.codeEditedSinceLastTest ?? editedFiles.length > 0
|
|
122
|
+
);
|
|
123
|
+
|
|
124
|
+
// Loop-safety invariant: NEVER block when `stop_hook_active` is already true
|
|
125
|
+
if (stopHookActive) {
|
|
126
|
+
return {
|
|
127
|
+
detectorId: 'DET-14',
|
|
128
|
+
triggered: false,
|
|
129
|
+
stopHookActive: true,
|
|
130
|
+
decision: 'allow',
|
|
131
|
+
advisory: false,
|
|
132
|
+
reason: null
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
if (!codeEditedSinceLastTest || isSilentOrOffMode(mode)) {
|
|
137
|
+
return {
|
|
138
|
+
detectorId: 'DET-14',
|
|
139
|
+
triggered: false,
|
|
140
|
+
stopHookActive: false,
|
|
141
|
+
decision: 'allow',
|
|
142
|
+
advisory: false,
|
|
143
|
+
reason: null
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
const fileSummary = editedFiles.slice(0, 4).join(', ') || 'workspace source files';
|
|
148
|
+
|
|
149
|
+
if (mode === FLIGHT_MODES.COACH) {
|
|
150
|
+
return {
|
|
151
|
+
detectorId: 'DET-14',
|
|
152
|
+
triggered: true,
|
|
153
|
+
stopHookActive: false,
|
|
154
|
+
decision: 'allow',
|
|
155
|
+
advisory: true,
|
|
156
|
+
reason: `[DET-14 Verification Advisory] Modified ${fileSummary} without running tests in this turn.`
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// AUTO_PILOT mode: block premature Stop once
|
|
161
|
+
return {
|
|
162
|
+
detectorId: 'DET-14',
|
|
163
|
+
triggered: true,
|
|
164
|
+
stopHookActive: false,
|
|
165
|
+
decision: 'block',
|
|
166
|
+
advisory: false,
|
|
167
|
+
reason: `[DET-14 Premature Stop Gate] Modified ${fileSummary} without running verification tests. Run the relevant unit test suite before completing the turn.`
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* DET-15: Batched `Stop`-Phase Formatter.
|
|
173
|
+
* Collects modified files during the turn so formatting can run once at `Stop` instead of after every edit.
|
|
174
|
+
*
|
|
175
|
+
* @param {object} [params={}]
|
|
176
|
+
* @param {Array<string>} [params.modifiedFiles=[]]
|
|
177
|
+
*/
|
|
178
|
+
export function evaluateDet15BatchedStopFormatter(params = {}) {
|
|
179
|
+
const files = Array.from(new Set(params.modifiedFiles || []))
|
|
180
|
+
.map((f) => String(f).trim())
|
|
181
|
+
.filter((f) => /\.(?:mjs|cjs|js|ts|tsx|jsx|json|md|css|html)$/i.test(f));
|
|
182
|
+
|
|
183
|
+
if (files.length === 0) {
|
|
184
|
+
const cmd = String(params.command || params.cmd || '').trim();
|
|
185
|
+
if (
|
|
186
|
+
cmd &&
|
|
187
|
+
/\b(?:prettier\s+(?:--write|-w)|biome\s+format\s+--write|gofmt\s+-w|rustfmt)\b/i.test(cmd)
|
|
188
|
+
) {
|
|
189
|
+
return {
|
|
190
|
+
detectorId: 'DET-15',
|
|
191
|
+
triggered: true,
|
|
192
|
+
filesToFormat: [],
|
|
193
|
+
batchCommand: cmd
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
return {
|
|
197
|
+
detectorId: 'DET-15',
|
|
198
|
+
triggered: false,
|
|
199
|
+
filesToFormat: [],
|
|
200
|
+
batchCommand: null
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
return {
|
|
205
|
+
detectorId: 'DET-15',
|
|
206
|
+
triggered: true,
|
|
207
|
+
filesToFormat: files,
|
|
208
|
+
batchCommand: `npx prettier --write ${files.map((f) => `"${f}"`).join(' ')}`
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* DET-15: Pre-Invocation / Pre-Tool-Use Local CLI Formatter Bypass Advisory.
|
|
214
|
+
* Emits advisory recommending local `npx prettier --write` / `npx eslint --fix` on pasted >=40-line blocks.
|
|
215
|
+
*
|
|
216
|
+
* @param {object} [params={}]
|
|
217
|
+
*/
|
|
218
|
+
export function evaluateDet15PreFormatBypass(params = {}) {
|
|
219
|
+
const prompt = String(params.prompt || params.userPrompt || '');
|
|
220
|
+
const newText = String(params.newText || '');
|
|
221
|
+
const lineCount = Number(
|
|
222
|
+
params.lineCount ??
|
|
223
|
+
(newText ? newText.split(/\r?\n/).length : (prompt.match(/\r?\n/g) || []).length)
|
|
224
|
+
);
|
|
225
|
+
const isFormattingIntent = /\b(fix\s+(?:the\s+)?indentation|sort\s+(?:the\s+)?imports|format\s+this\s+(?:code|file|block)|convert\s+tabs\s+to\s+spaces|run\s+prettier)\b/i.test(prompt);
|
|
226
|
+
|
|
227
|
+
if (isFormattingIntent && lineCount >= 40 && !/\b(add|implement|refactor|create|fix\s+bug|logic|test|calculate)\b/i.test(prompt)) {
|
|
228
|
+
return {
|
|
229
|
+
detectorId: 'DET-15',
|
|
230
|
+
triggered: true,
|
|
231
|
+
subType: 'LOCAL_FORMATTER_BYPASS',
|
|
232
|
+
decision: 'allow',
|
|
233
|
+
advisory: true,
|
|
234
|
+
reason: '[DET-15 Local Formatter Bypass] Prompt requests code formatting / import sorting on a pasted code block. Run `npx prettier --write <file>` or `npx eslint --fix <file>` directly (0 LLM tokens).'
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
return { detectorId: 'DET-15', triggered: false, decision: 'allow' };
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* DET-16: Subagent Token (`40k`) & Turn (`12`) Recursion Cap.
|
|
243
|
+
*
|
|
244
|
+
* @param {object} [params={}]
|
|
245
|
+
* @param {string} [params.agentId]
|
|
246
|
+
* @param {number} [params.turns=0]
|
|
247
|
+
* @param {number} [params.totalTokens=0]
|
|
248
|
+
* @param {number} [params.maxTurns=12]
|
|
249
|
+
* @param {number} [params.maxTokens=40000]
|
|
250
|
+
*/
|
|
251
|
+
export function evaluateDet16SubagentRecursionCap(params = {}) {
|
|
252
|
+
const agentId = params.agentId || null;
|
|
253
|
+
if (!agentId) {
|
|
254
|
+
return { detectorId: 'DET-16', triggered: false, decision: 'allow', reason: null };
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
const turns = Math.max(0, Number(params.turns || 0));
|
|
258
|
+
const totalTokens = Math.max(0, Number(params.totalTokens || 0));
|
|
259
|
+
const maxTurns = Number(params.maxTurns ?? 12);
|
|
260
|
+
const maxTokens = Number(params.maxTokens ?? 40_000);
|
|
261
|
+
|
|
262
|
+
if (turns >= maxTurns || totalTokens >= maxTokens) {
|
|
263
|
+
return {
|
|
264
|
+
detectorId: 'DET-16',
|
|
265
|
+
triggered: true,
|
|
266
|
+
decision: 'deny',
|
|
267
|
+
agentId,
|
|
268
|
+
turns,
|
|
269
|
+
totalTokens,
|
|
270
|
+
reason: `[DET-16 Subagent Recursion Cap] Subagent "${agentId}" reached ${turns}/${maxTurns} turns and ${totalTokens.toLocaleString()}/${maxTokens.toLocaleString()} tokens. Terminate exploration and return synthesized summary immediately.`
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
return {
|
|
275
|
+
detectorId: 'DET-16',
|
|
276
|
+
triggered: false,
|
|
277
|
+
decision: 'allow',
|
|
278
|
+
agentId,
|
|
279
|
+
turns,
|
|
280
|
+
totalTokens,
|
|
281
|
+
reason: null
|
|
282
|
+
};
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/**
|
|
286
|
+
* DET-17: Untimely Auto-Compaction Deferral (`PreCompact` `auto` mid-batch syntax guard).
|
|
287
|
+
*
|
|
288
|
+
* @param {object} [params={}]
|
|
289
|
+
* @param {'auto'|'manual'} [params.trigger='auto']
|
|
290
|
+
* @param {boolean} [params.midBatchEditInProgress=false]
|
|
291
|
+
* @param {boolean} [params.unbalancedSyntaxDetected=false]
|
|
292
|
+
*/
|
|
293
|
+
export function evaluateDet17AutoCompactionDeferral(params = {}) {
|
|
294
|
+
const trigger = String(params.trigger || 'auto').toLowerCase();
|
|
295
|
+
const midBatch = Boolean(params.midBatchEditInProgress || params.unbalancedSyntaxDetected);
|
|
296
|
+
const cacheExpired = Boolean(params.cacheExpired);
|
|
297
|
+
const cachedTokens = Math.max(0, Number(params.cachedTokens ?? params.cached_tokens ?? 0));
|
|
298
|
+
|
|
299
|
+
if (cacheExpired && cachedTokens >= 25_000) {
|
|
300
|
+
return {
|
|
301
|
+
detectorId: 'DET-17',
|
|
302
|
+
subType: 'COLD_CACHE_COMPACT_BLOCKED',
|
|
303
|
+
triggered: true,
|
|
304
|
+
decision: 'defer',
|
|
305
|
+
reason: `[DET-17 Cold-Cache /compact Guard] Prompt cache TTL has expired (${cachedTokens.toLocaleString()} cold tokens). Running /compact now would pay full uncached input rates to summarize stale history — flush a <300-token StateBaton and /clear instead.`
|
|
306
|
+
};
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
if (trigger === 'auto' && midBatch) {
|
|
310
|
+
return {
|
|
311
|
+
detectorId: 'DET-17',
|
|
312
|
+
subType: 'MID_BATCH_DEFERRED',
|
|
313
|
+
triggered: true,
|
|
314
|
+
decision: 'defer',
|
|
315
|
+
reason: `[DET-17 Auto-Compaction Deferred] Deferring automatic compaction while a multi-file edit batch or syntax repair is in progress.`
|
|
316
|
+
};
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
return {
|
|
320
|
+
detectorId: 'DET-17',
|
|
321
|
+
triggered: false,
|
|
322
|
+
decision: 'allow',
|
|
323
|
+
reason: null
|
|
324
|
+
};
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
/**
|
|
328
|
+
* Pure zero-I/O evaluator for Silent Prefix Mutations (`Sim 01` & `Sim 16` in Claude Code):
|
|
329
|
+
* - `LATE_MCP_CONNECT`: MCP server count or schema hash changing after Turn 1
|
|
330
|
+
* - `MEMORY_MD_MID_THREAD_MUTATION`: Mid-thread `MEMORY.md` hash/byte change (up to 25KB)
|
|
331
|
+
* - `IDE_STATE_PREFIX_MUTATION`: Dynamic IDE state injected into system prefix instead of user-turn tail
|
|
332
|
+
* - `LOOKBACK_WINDOW_DELETION`: Message deletion inside 20-block lookback window shifting cached suffix
|
|
333
|
+
*/
|
|
334
|
+
export function evaluateSilentPrefixMutations(params = {}) {
|
|
335
|
+
const turn = Math.max(1, Number(params.turnCount || 1));
|
|
336
|
+
const subTypes = [];
|
|
337
|
+
const details = [];
|
|
338
|
+
let shiftedSuffixTokens = 0;
|
|
339
|
+
|
|
340
|
+
if (turn > 1) {
|
|
341
|
+
const mcpCountChanged =
|
|
342
|
+
params.prevMcpServerCount != null &&
|
|
343
|
+
params.currMcpServerCount != null &&
|
|
344
|
+
Number(params.prevMcpServerCount) !== Number(params.currMcpServerCount);
|
|
345
|
+
const mcpHashChanged =
|
|
346
|
+
Boolean(params.prevMcpSchemaHash && params.currMcpSchemaHash) &&
|
|
347
|
+
String(params.prevMcpSchemaHash) !== String(params.currMcpSchemaHash);
|
|
348
|
+
if (mcpCountChanged || mcpHashChanged) {
|
|
349
|
+
subTypes.push('LATE_MCP_CONNECT');
|
|
350
|
+
details.push(
|
|
351
|
+
`Mid-session MCP server/schema change at Turn ${turn} (${params.prevMcpServerCount ?? '?'} -> ${params.currMcpServerCount ?? '?'} servers)`
|
|
352
|
+
);
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
const memHashChanged =
|
|
356
|
+
Boolean(params.prevMemoryMdHash && params.currMemoryMdHash) &&
|
|
357
|
+
String(params.prevMemoryMdHash) !== String(params.currMemoryMdHash);
|
|
358
|
+
const memBytesChanged =
|
|
359
|
+
params.prevMemoryMdBytes != null &&
|
|
360
|
+
params.currMemoryMdBytes != null &&
|
|
361
|
+
Number(params.prevMemoryMdBytes) !== Number(params.currMemoryMdBytes);
|
|
362
|
+
if (memHashChanged || memBytesChanged) {
|
|
363
|
+
subTypes.push('MEMORY_MD_MID_THREAD_MUTATION');
|
|
364
|
+
const kb =
|
|
365
|
+
params.currMemoryMdBytes != null
|
|
366
|
+
? `${(Number(params.currMemoryMdBytes) / 1024).toFixed(1)}KB`
|
|
367
|
+
: 'updated';
|
|
368
|
+
details.push(`Mid-thread MEMORY.md mutation (${kb}) invalidated static system prefix`);
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
const ideHashChanged =
|
|
372
|
+
Boolean(params.prevIdePrefixHash && params.currIdePrefixHash) &&
|
|
373
|
+
String(params.prevIdePrefixHash) !== String(params.currIdePrefixHash);
|
|
374
|
+
if (Boolean(params.ideStateInSystemPrefix) || ideHashChanged) {
|
|
375
|
+
subTypes.push('IDE_STATE_PREFIX_MUTATION');
|
|
376
|
+
details.push(
|
|
377
|
+
'Dynamic IDE state (active tab / highlighted lines / Problems diagnostics) injected into system prefix instead of user-turn tail'
|
|
378
|
+
);
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
if (
|
|
383
|
+
Array.isArray(params.prevMessageIds) &&
|
|
384
|
+
Array.isArray(params.currMessageIds) &&
|
|
385
|
+
params.prevMessageIds.length > 0
|
|
386
|
+
) {
|
|
387
|
+
const currSet = new Set(params.currMessageIds);
|
|
388
|
+
let firstDeletedIdx = -1;
|
|
389
|
+
let deletedCount = 0;
|
|
390
|
+
for (let i = 0; i < params.prevMessageIds.length; i++) {
|
|
391
|
+
if (!currSet.has(params.prevMessageIds[i])) {
|
|
392
|
+
if (firstDeletedIdx === -1) firstDeletedIdx = i;
|
|
393
|
+
deletedCount += 1;
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
if (firstDeletedIdx !== -1) {
|
|
397
|
+
const remaining = Math.max(0, params.prevMessageIds.length - firstDeletedIdx - deletedCount);
|
|
398
|
+
if (Array.isArray(params.tokensPerMessage)) {
|
|
399
|
+
for (let j = firstDeletedIdx + deletedCount; j < params.prevMessageIds.length; j++) {
|
|
400
|
+
shiftedSuffixTokens += Math.max(0, Number(params.tokensPerMessage[j] || 0));
|
|
401
|
+
}
|
|
402
|
+
} else {
|
|
403
|
+
shiftedSuffixTokens = remaining * Math.max(1, Number(params.tokensPerMessage || 5000));
|
|
404
|
+
}
|
|
405
|
+
subTypes.push('LOOKBACK_WINDOW_DELETION');
|
|
406
|
+
details.push(
|
|
407
|
+
`Deleted ${deletedCount} historical message(s) starting at index ${firstDeletedIdx}, shifting ${shiftedSuffixTokens.toLocaleString()} suffix tokens outside 20-block lookback window`
|
|
408
|
+
);
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
const triggered = subTypes.length > 0;
|
|
413
|
+
const detectorId = subTypes.includes('LOOKBACK_WINDOW_DELETION')
|
|
414
|
+
? 'DET-09'
|
|
415
|
+
: subTypes.includes('LATE_MCP_CONNECT')
|
|
416
|
+
? 'DET-13'
|
|
417
|
+
: 'DET-09';
|
|
418
|
+
|
|
419
|
+
return {
|
|
420
|
+
detectorId,
|
|
421
|
+
triggered,
|
|
422
|
+
subTypes,
|
|
423
|
+
shiftedSuffixTokens:
|
|
424
|
+
shiftedSuffixTokens || (triggered ? Math.max(0, Number(params.cachedTokens || 0)) : 0),
|
|
425
|
+
details,
|
|
426
|
+
reason: triggered ? `[${detectorId} Silent Prefix Mutation] ${details.join('; ')}.` : null
|
|
427
|
+
};
|
|
428
|
+
}
|
|
429
|
+
|
|
430
|
+
/**
|
|
431
|
+
* DET-18: Untrusted Project `settings.json` Hook CVE & Clobber Guard.
|
|
432
|
+
*
|
|
433
|
+
* @param {object} [params={}]
|
|
434
|
+
* @param {string} [params.toolName='Write']
|
|
435
|
+
* @param {string} [params.filePath='']
|
|
436
|
+
* @param {string} [params.newText='']
|
|
437
|
+
*/
|
|
438
|
+
export function evaluateDet18UntrustedSettingsGuard(params = {}) {
|
|
439
|
+
const filePath = String(params.filePath || params.path || '').trim().replace(/\\/g, '/');
|
|
440
|
+
if (!/(?:^|\/)\.claude\/settings(?:\.local)?\.json$/i.test(filePath)) {
|
|
441
|
+
return { detectorId: 'DET-18', triggered: false, decision: 'allow', reason: null };
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
const content = String(params.newText || params.content || '');
|
|
445
|
+
const suspiciousHookRegex =
|
|
446
|
+
/(?:\bcurl\b.*\|\s*(?:sh|bash|pwsh)|\bwget\b.*\|\s*(?:sh|bash)|\bInvoke-Expression\b|\biex\b\s*\(|\bnc\s+-e\b|\bbase64\s+-d\b.*\|\s*(?:sh|bash))/i;
|
|
447
|
+
|
|
448
|
+
if (suspiciousHookRegex.test(content)) {
|
|
449
|
+
return {
|
|
450
|
+
detectorId: 'DET-18',
|
|
451
|
+
triggered: true,
|
|
452
|
+
decision: 'deny',
|
|
453
|
+
subType: 'MALICIOUS_SETTINGS_HOOK_CVE',
|
|
454
|
+
targetPath: filePath,
|
|
455
|
+
reason: `[DET-18 Untrusted Settings CVE Guard] Blocked suspicious remote shell execution payload in "${filePath}".`
|
|
456
|
+
};
|
|
457
|
+
}
|
|
458
|
+
|
|
459
|
+
if (EDIT_WRITE_TOOL_REGEX.test(String(params.toolName || 'Write')) && !params.hasBackup) {
|
|
460
|
+
return {
|
|
461
|
+
detectorId: 'DET-18',
|
|
462
|
+
triggered: true,
|
|
463
|
+
decision: 'ask',
|
|
464
|
+
subType: 'SETTINGS_CLOBBER_GUARD',
|
|
465
|
+
targetPath: filePath,
|
|
466
|
+
reason: `[DET-18 Settings Clobber Guard] Direct modification of "${filePath}" requires user confirmation (or use "npx ah-claude install" for non-destructive backup merge).`
|
|
467
|
+
};
|
|
468
|
+
}
|
|
469
|
+
|
|
470
|
+
return { detectorId: 'DET-18', triggered: false, decision: 'allow', reason: null };
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
/**
|
|
474
|
+
* DET-19: Subagent Indirect Prompt Injection (IPI) & Untrusted URL Exfiltration Sanitizer (`ISS-053`).
|
|
475
|
+
* - Neutralizes XML boundary breakout tags (`</untrusted_subagent_data>`, `<untrusted_subagent_output>`) BEFORE wrapping.
|
|
476
|
+
* - Strips Unicode tag characters (`U+E0000`..`U+E007F`), zero-width/bidi override & isolate chars (`U+200B`..`U+200F`,
|
|
477
|
+
* `U+202A`..`U+202E`, `U+2060`..`U+2069`, `U+061C`, `U+FEFF`), general HTML comments (`<!-- ... -->`),
|
|
478
|
+
* `<script>`/`<style>` blocks, `data:text/html` / `application/javascript` URIs, chat template tokens,
|
|
479
|
+
* and line-leading prompt-injection role spoof headers.
|
|
480
|
+
* - Counts stripped/neutralized source characters BEFORE replacement substitution so `strippedCharCount > 0`
|
|
481
|
+
* whenever any injection vector is neutralized.
|
|
482
|
+
* - Wraps subagent / untrusted data in `<untrusted_subagent_data trust="untrusted" readonly="true">...</untrusted_subagent_data>`.
|
|
483
|
+
* - Blocks `WebFetch` URLs attempting to exfiltrate secrets/tokens in query strings.
|
|
484
|
+
*
|
|
485
|
+
* @param {object} [params={}]
|
|
486
|
+
* @param {string} [params.text='']
|
|
487
|
+
* @param {string} [params.url='']
|
|
488
|
+
* @param {boolean} [params.wrapUntrusted=true]
|
|
489
|
+
*/
|
|
490
|
+
export function evaluateDet19SubagentIpiSanitizer(params = {}) {
|
|
491
|
+
const urlStr = String(params.url || '').trim();
|
|
492
|
+
if (urlStr) {
|
|
493
|
+
if (
|
|
494
|
+
/(?:api[_-]?key|secret|token|password|authorization|aws_access_key|sk-ant-)[=:]\S+/i.test(
|
|
495
|
+
urlStr
|
|
496
|
+
) ||
|
|
497
|
+
/\$\{?[A-Z0-9_]*(?:KEY|SECRET|TOKEN|PASSWORD)[A-Z0-9_]*\}?/i.test(urlStr)
|
|
498
|
+
) {
|
|
499
|
+
return {
|
|
500
|
+
detectorId: 'DET-19',
|
|
501
|
+
triggered: true,
|
|
502
|
+
blocked: true,
|
|
503
|
+
hadInjectionMarkers: false,
|
|
504
|
+
decision: 'deny',
|
|
505
|
+
subType: 'URL_EXFILTRATION_BLOCKED',
|
|
506
|
+
sanitizedText: '',
|
|
507
|
+
strippedCharCount: 0,
|
|
508
|
+
reason: `[DET-19 Untrusted URL Exfiltration Blocked] Outbound request URL contains credential or environment secret interpolation.`
|
|
509
|
+
};
|
|
510
|
+
}
|
|
511
|
+
}
|
|
512
|
+
|
|
513
|
+
const rawText = String(params.text ?? '');
|
|
514
|
+
if (!rawText) {
|
|
515
|
+
return {
|
|
516
|
+
detectorId: 'DET-19',
|
|
517
|
+
triggered: false,
|
|
518
|
+
blocked: false,
|
|
519
|
+
hadInjectionMarkers: false,
|
|
520
|
+
decision: 'allow',
|
|
521
|
+
sanitizedText: '',
|
|
522
|
+
strippedCharCount: 0,
|
|
523
|
+
reason: null
|
|
524
|
+
};
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
let strippedCharCount = 0;
|
|
528
|
+
let hadInjectionMarkers = false;
|
|
529
|
+
|
|
530
|
+
const stripEmpty = (text, regex) =>
|
|
531
|
+
text.replace(regex, (match) => {
|
|
532
|
+
strippedCharCount += match.length;
|
|
533
|
+
hadInjectionMarkers = true;
|
|
534
|
+
return '';
|
|
535
|
+
});
|
|
536
|
+
|
|
537
|
+
const stripWithMarker = (text, regex, replacement = '[STRIPPED_IPI_MARKER]') =>
|
|
538
|
+
text.replace(regex, (match) => {
|
|
539
|
+
strippedCharCount += match.length;
|
|
540
|
+
hadInjectionMarkers = true;
|
|
541
|
+
return replacement;
|
|
542
|
+
});
|
|
543
|
+
|
|
544
|
+
// 1. Neutralize closing/opening XML boundary tags FIRST so untrusted payloads can NEVER break out
|
|
545
|
+
const boundaryTagRegex = /<\s*\/?\s*untrusted_subagent_(?:data|output)\b[^>]*>/gi;
|
|
546
|
+
let cleaned = rawText.replace(boundaryTagRegex, (match) => {
|
|
547
|
+
strippedCharCount += match.length;
|
|
548
|
+
hadInjectionMarkers = true;
|
|
549
|
+
return match.replace(/</g, '<').replace(/>/g, '>');
|
|
550
|
+
});
|
|
551
|
+
|
|
552
|
+
// 2. Strip Unicode Tags (U+E0000..U+E007F) and zero-width / bidi overrides & isolates / Arabic Letter Mark (U+061C)
|
|
553
|
+
cleaned = stripEmpty(cleaned, /[\u{E0000}-\u{E007F}]/gu);
|
|
554
|
+
cleaned = stripEmpty(cleaned, /[\u061C\u200B-\u200F\u202A-\u202E\u2060-\u206F\uFEFF]/g);
|
|
555
|
+
|
|
556
|
+
// 3. Strip general HTML comments, <script>, <style>, executable data: URIs, and chat template tokens
|
|
557
|
+
cleaned = stripWithMarker(cleaned, /<!--[\s\S]*?-->/g);
|
|
558
|
+
cleaned = stripWithMarker(cleaned, /<\s*script\b[^>]*>[\s\S]*?<\s*\/\s*script\s*>/gi);
|
|
559
|
+
cleaned = stripWithMarker(cleaned, /<\s*style\b[^>]*>[\s\S]*?<\s*\/\s*style\s*>/gi);
|
|
560
|
+
cleaned = stripWithMarker(
|
|
561
|
+
cleaned,
|
|
562
|
+
/data:(?:text\/(?:html|javascript)|application\/(?:javascript|x-javascript)|image\/svg\+xml)[^,\s"')]*(?:,[^\s"')>]+)?/gi
|
|
563
|
+
);
|
|
564
|
+
cleaned = stripWithMarker(
|
|
565
|
+
cleaned,
|
|
566
|
+
/<\|(?:im_start|im_end|endoftext|assistant|system|user|startoftext|extra_\d+)\|>/gi
|
|
567
|
+
);
|
|
568
|
+
|
|
569
|
+
// 4. Neutralize line-leading prompt-injection role spoof headers
|
|
570
|
+
cleaned = cleaned.replace(
|
|
571
|
+
/(^|\n)([ \t]*(?:SYSTEM|DEVELOPER|IMPORTANT\s+INSTRUCTION|IGNORE\s+(?:ALL\s+)?PREVIOUS\s+INSTRUCTIONS)[ \t]*:)/gi,
|
|
572
|
+
(_full, prefix, roleHeader) => {
|
|
573
|
+
strippedCharCount += roleHeader.length;
|
|
574
|
+
hadInjectionMarkers = true;
|
|
575
|
+
return `${prefix}[STRIPPED_IPI_MARKER]:`;
|
|
576
|
+
}
|
|
577
|
+
);
|
|
578
|
+
|
|
579
|
+
if (params.wrapUntrusted !== false) {
|
|
580
|
+
cleaned = `<untrusted_subagent_data trust="untrusted" readonly="true">\n${cleaned}\n</untrusted_subagent_data>`;
|
|
581
|
+
}
|
|
582
|
+
|
|
583
|
+
return {
|
|
584
|
+
detectorId: 'DET-19',
|
|
585
|
+
triggered: hadInjectionMarkers,
|
|
586
|
+
blocked: false,
|
|
587
|
+
hadInjectionMarkers,
|
|
588
|
+
decision: 'allow',
|
|
589
|
+
subType: hadInjectionMarkers ? 'IPI_PAYLOAD_SANITIZED' : null,
|
|
590
|
+
sanitizedText: cleaned,
|
|
591
|
+
strippedCharCount,
|
|
592
|
+
reason: hadInjectionMarkers
|
|
593
|
+
? `[DET-19 Subagent IPI Sanitizer] Neutralized ${strippedCharCount} char(s) of hidden Unicode / XML boundary / prompt-injection markers and wrapped output in <untrusted_subagent_data trust="untrusted" readonly="true">.`
|
|
594
|
+
: null
|
|
595
|
+
};
|
|
596
|
+
}
|
|
597
|
+
|
|
598
|
+
/**
|
|
599
|
+
* DET-20: Concurrent Multi-Agent File-Scope Lockfile + Quota Hard Brake.
|
|
600
|
+
* Wrapper delegating to `evaluateScopeAndQuotaBrake` in `src/telemetry/scopeLockRegistry.mjs`.
|
|
601
|
+
*/
|
|
602
|
+
export function evaluateDet20ScopeLockAndQuotaBrake(params = {}, options = {}) {
|
|
603
|
+
return evaluateScopeAndQuotaBrake(params, options);
|
|
604
|
+
}
|
|
605
|
+
|
|
606
|
+
/**
|
|
607
|
+
* Sanitizes a session ID for `.claude/cache/ah_breaker_state_<sessionId>.json`.
|
|
608
|
+
* @param {string} [sessionId='default']
|
|
609
|
+
* @returns {string}
|
|
610
|
+
*/
|
|
611
|
+
export function sanitizeBreakerSessionId(sessionId = 'default') {
|
|
612
|
+
return String(sessionId || 'default').replace(/[^a-zA-Z0-9._-]/g, '_');
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
/**
|
|
616
|
+
* Resolves the atomic CLI circuit-breaker state file path (`.claude/cache/ah_breaker_state_<sessionId>.json`).
|
|
617
|
+
* @param {string} [sessionId='default']
|
|
618
|
+
* @param {object} [options={}]
|
|
619
|
+
* @returns {string}
|
|
620
|
+
*/
|
|
621
|
+
export function getBreakerStateFilePath(sessionId = 'default', options = {}) {
|
|
622
|
+
if (options?.breakerStatePath) {
|
|
623
|
+
return options.breakerStatePath;
|
|
624
|
+
}
|
|
625
|
+
const cwd = getCwd(options);
|
|
626
|
+
return path.join(
|
|
627
|
+
cwd,
|
|
628
|
+
'.claude',
|
|
629
|
+
'cache',
|
|
630
|
+
`ah_breaker_state_${sanitizeBreakerSessionId(sessionId)}.json`
|
|
631
|
+
);
|
|
632
|
+
}
|
|
633
|
+
|
|
634
|
+
/**
|
|
635
|
+
* Safely reads a persisted `CircuitBreakerEngine` snapshot from disk (`ISS-038`).
|
|
636
|
+
* @param {string} [sessionId='default']
|
|
637
|
+
* @param {object} [options={}]
|
|
638
|
+
* @returns {object | null}
|
|
639
|
+
*/
|
|
640
|
+
export function readBreakerStateSnapshot(sessionId = 'default', options = {}) {
|
|
641
|
+
return readJsonSafe(getBreakerStateFilePath(sessionId, options), null, options);
|
|
642
|
+
}
|
|
643
|
+
|
|
644
|
+
/**
|
|
645
|
+
* Atomically writes a `CircuitBreakerEngine` snapshot to disk (`ISS-038`).
|
|
646
|
+
* @param {string} [sessionId='default']
|
|
647
|
+
* @param {object} [snapshot={}]
|
|
648
|
+
* @param {object} [options={}]
|
|
649
|
+
* @returns {boolean}
|
|
650
|
+
*/
|
|
651
|
+
export function writeBreakerStateSnapshot(sessionId = 'default', snapshot = {}, options = {}) {
|
|
652
|
+
return writeJsonAtomic(getBreakerStateFilePath(sessionId, options), snapshot, options);
|
|
653
|
+
}
|
|
654
|
+
|
|
655
|
+
/**
|
|
656
|
+
* Exports a serializable snapshot of a `CircuitBreakerEngine` instance (`ISS-038`).
|
|
657
|
+
* @param {object} engine
|
|
658
|
+
* @returns {object}
|
|
659
|
+
*/
|
|
660
|
+
export function serializeCircuitBreakerState(engine) {
|
|
661
|
+
const hashObj = {};
|
|
662
|
+
for (const [k, v] of engine.fileHashHistory.entries()) {
|
|
663
|
+
hashObj[k] = Array.isArray(v) ? [...v] : [];
|
|
664
|
+
}
|
|
665
|
+
return {
|
|
666
|
+
schemaVersion: '1.0.0',
|
|
667
|
+
updatedAt: Date.now(),
|
|
668
|
+
mode: engine.mode,
|
|
669
|
+
consecutiveFailures: engine.consecutiveFailures,
|
|
670
|
+
lastFailedToolKey: engine.lastFailedToolKey,
|
|
671
|
+
sequentialSearchCount: engine.sequentialSearchCount,
|
|
672
|
+
fileHashHistory: hashObj,
|
|
673
|
+
modifiedFilesInTurn: Array.from(engine.modifiedFilesInTurn),
|
|
674
|
+
editedFiles: Array.from(engine.modifiedFilesInTurn),
|
|
675
|
+
unverifiedEdits: Array.isArray(engine.unverifiedEdits) ? engine.unverifiedEdits.slice(-32) : [],
|
|
676
|
+
turnFileDiffs: Array.isArray(engine.turnFileDiffs) ? engine.turnFileDiffs.slice(-32) : [],
|
|
677
|
+
pendingBatchEdits: Array.from(engine.pendingBatchEdits),
|
|
678
|
+
pendingFormatFiles: Array.from(engine.pendingFormatFiles),
|
|
679
|
+
codeEditedSinceLastTest: Boolean(engine.codeEditedSinceLastTest),
|
|
680
|
+
pendingVerificationCommand: Boolean(engine.pendingVerificationCommand),
|
|
681
|
+
lastFailingLocation: engine.lastFailingLocation || null,
|
|
682
|
+
pendingDownshiftModel: engine.pendingDownshiftModel || null,
|
|
683
|
+
pending_downshift: engine.pending_downshift ? { ...engine.pending_downshift } : null,
|
|
684
|
+
justCompacted: Boolean(engine.justCompacted),
|
|
685
|
+
turnsSinceLastCompact:
|
|
686
|
+
typeof engine.turnsSinceLastCompact === 'number' && Number.isFinite(engine.turnsSinceLastCompact)
|
|
687
|
+
? Math.max(0, engine.turnsSinceLastCompact)
|
|
688
|
+
: null,
|
|
689
|
+
taskBoundaryState: engine.taskBoundaryState
|
|
690
|
+
? {
|
|
691
|
+
openFailure: Boolean(engine.taskBoundaryState.openFailure),
|
|
692
|
+
editsSinceBoundary: Math.max(0, Number(engine.taskBoundaryState.editsSinceBoundary || 0)),
|
|
693
|
+
lastBoundarySuggestedTurn: engine.taskBoundaryState.lastBoundarySuggestedTurn ?? null
|
|
694
|
+
}
|
|
695
|
+
: { openFailure: false, editsSinceBoundary: 0, lastBoundarySuggestedTurn: null },
|
|
696
|
+
lastToolsetHash: engine.lastToolsetHash ? { ...engine.lastToolsetHash } : null,
|
|
697
|
+
lastContextTokens:
|
|
698
|
+
typeof engine.lastContextTokens === 'number' && Number.isFinite(engine.lastContextTokens)
|
|
699
|
+
? Math.max(0, engine.lastContextTokens)
|
|
700
|
+
: null,
|
|
701
|
+
lastModelId: engine.lastModelId ? String(engine.lastModelId) : null,
|
|
702
|
+
activeBackgroundTasks: Array.isArray(engine.activeBackgroundTasks)
|
|
703
|
+
? [...engine.activeBackgroundTasks]
|
|
704
|
+
: [],
|
|
705
|
+
activeWriteWorkers: Array.isArray(engine.activeWriteWorkers)
|
|
706
|
+
? [...engine.activeWriteWorkers]
|
|
707
|
+
: [],
|
|
708
|
+
lastUserPrompt: engine.lastUserPrompt || '',
|
|
709
|
+
lastTurnGitCommitted: Boolean(engine.lastTurnGitCommitted),
|
|
710
|
+
committedTopDirs: Array.isArray(engine.committedTopDirs) ? [...engine.committedTopDirs] : [],
|
|
711
|
+
consecutiveTrivialMaxEffortTurns: engine.consecutiveTrivialMaxEffortTurns,
|
|
712
|
+
recentEditTimestampsByFile: { ...engine.recentEditTimestampsByFile },
|
|
713
|
+
totalDiscoveryCalls: engine.totalDiscoveryCalls,
|
|
714
|
+
consecutiveVisionTurns: engine.consecutiveVisionTurns,
|
|
715
|
+
unanchoredTurnFlag: Boolean(engine.unanchoredTurnFlag),
|
|
716
|
+
candidateFiles: Array.isArray(engine.candidateFiles) ? [...engine.candidateFiles] : [],
|
|
717
|
+
relayState: engine.relayState ? { ...engine.relayState } : { state: RELAY_STATES.IDLE, critiquePastes: 0, boundSpecPath: 'SPEC.md' },
|
|
718
|
+
steeredPrompts: Number(engine.steeredPrompts || 0),
|
|
719
|
+
blockedPrompts: Number(engine.blockedPrompts || 0),
|
|
720
|
+
sightseeingToolsPrevented: Number(engine.sightseeingToolsPrevented || 0),
|
|
721
|
+
subagentTurns: { ...engine.subagentTurns },
|
|
722
|
+
subagentTokens: { ...engine.subagentTokens },
|
|
723
|
+
det11AdvisedTurn: engine.det11AdvisedTurn,
|
|
724
|
+
det13AdvisedTurn: engine.det13AdvisedTurn,
|
|
725
|
+
queuedMutations: engine.router.mutationQueue.toJSON(),
|
|
726
|
+
hysteresisState: engine.router.hysteresisLock.getStatus()
|
|
727
|
+
};
|
|
728
|
+
}
|
|
729
|
+
|
|
730
|
+
/**
|
|
731
|
+
* Hydrates stateful breaker counters and queues onto a `CircuitBreakerEngine` instance (`ISS-038`).
|
|
732
|
+
* @param {object} engine
|
|
733
|
+
* @param {object | null} snap
|
|
734
|
+
* @returns {object}
|
|
735
|
+
*/
|
|
736
|
+
export function hydrateCircuitBreakerState(engine, snap) {
|
|
737
|
+
if (!snap || typeof snap !== 'object') return engine;
|
|
738
|
+
|
|
739
|
+
if (typeof snap.consecutiveFailures === 'number' && Number.isFinite(snap.consecutiveFailures)) {
|
|
740
|
+
engine.consecutiveFailures = Math.max(0, snap.consecutiveFailures);
|
|
741
|
+
}
|
|
742
|
+
if (snap.lastFailedToolKey !== undefined) {
|
|
743
|
+
engine.lastFailedToolKey = snap.lastFailedToolKey ? String(snap.lastFailedToolKey) : null;
|
|
744
|
+
}
|
|
745
|
+
if (
|
|
746
|
+
typeof snap.sequentialSearchCount === 'number' &&
|
|
747
|
+
Number.isFinite(snap.sequentialSearchCount)
|
|
748
|
+
) {
|
|
749
|
+
engine.sequentialSearchCount = Math.max(0, snap.sequentialSearchCount);
|
|
750
|
+
}
|
|
751
|
+
if (snap.fileHashHistory && typeof snap.fileHashHistory === 'object') {
|
|
752
|
+
engine.fileHashHistory = new Map();
|
|
753
|
+
for (const [k, v] of Object.entries(snap.fileHashHistory)) {
|
|
754
|
+
if (Array.isArray(v)) {
|
|
755
|
+
engine.fileHashHistory.set(k, v.slice(-6).map(String));
|
|
756
|
+
}
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
const editedList = Array.isArray(snap.modifiedFilesInTurn)
|
|
760
|
+
? snap.modifiedFilesInTurn
|
|
761
|
+
: Array.isArray(snap.editedFiles)
|
|
762
|
+
? snap.editedFiles
|
|
763
|
+
: null;
|
|
764
|
+
if (editedList) {
|
|
765
|
+
engine.modifiedFilesInTurn = new Set(editedList.filter(Boolean).map(String));
|
|
766
|
+
}
|
|
767
|
+
if (Array.isArray(snap.unverifiedEdits)) {
|
|
768
|
+
engine.unverifiedEdits = snap.unverifiedEdits
|
|
769
|
+
.filter((e) => e && typeof e.filePath === 'string')
|
|
770
|
+
.slice(-32)
|
|
771
|
+
.map((e) => ({
|
|
772
|
+
filePath: String(e.filePath),
|
|
773
|
+
netLines: Math.max(0, Number(e.netLines) || 0),
|
|
774
|
+
...(Array.isArray(e.changedLines) ? { changedLines: e.changedLines.slice(0, 64).map(String) } : {})
|
|
775
|
+
}));
|
|
776
|
+
}
|
|
777
|
+
if (Array.isArray(snap.turnFileDiffs)) {
|
|
778
|
+
engine.turnFileDiffs = snap.turnFileDiffs
|
|
779
|
+
.filter((e) => e && typeof e.filePath === 'string')
|
|
780
|
+
.slice(-32)
|
|
781
|
+
.map((e) => ({
|
|
782
|
+
filePath: String(e.filePath),
|
|
783
|
+
addedLines: Array.isArray(e.addedLines) ? e.addedLines.slice(0, 400).map(String) : [],
|
|
784
|
+
deletedLineCount: Math.max(0, Number(e.deletedLineCount) || 0)
|
|
785
|
+
}));
|
|
786
|
+
}
|
|
787
|
+
if (Array.isArray(snap.pendingBatchEdits)) {
|
|
788
|
+
engine.pendingBatchEdits = new Set(snap.pendingBatchEdits.filter(Boolean).map(String));
|
|
789
|
+
}
|
|
790
|
+
if (Array.isArray(snap.pendingFormatFiles)) {
|
|
791
|
+
engine.pendingFormatFiles = new Set(snap.pendingFormatFiles.filter(Boolean).map(String));
|
|
792
|
+
}
|
|
793
|
+
if (typeof snap.codeEditedSinceLastTest === 'boolean') {
|
|
794
|
+
engine.codeEditedSinceLastTest = snap.codeEditedSinceLastTest;
|
|
795
|
+
}
|
|
796
|
+
if (typeof snap.pendingVerificationCommand === 'boolean') {
|
|
797
|
+
engine.pendingVerificationCommand = snap.pendingVerificationCommand;
|
|
798
|
+
}
|
|
799
|
+
if (snap.lastFailingLocation !== undefined) {
|
|
800
|
+
engine.lastFailingLocation = snap.lastFailingLocation ? String(snap.lastFailingLocation) : null;
|
|
801
|
+
}
|
|
802
|
+
if (snap.pendingDownshiftModel !== undefined) {
|
|
803
|
+
engine.pendingDownshiftModel = snap.pendingDownshiftModel ? String(snap.pendingDownshiftModel) : null;
|
|
804
|
+
}
|
|
805
|
+
if (snap.pending_downshift !== undefined) {
|
|
806
|
+
engine.pending_downshift =
|
|
807
|
+
snap.pending_downshift && typeof snap.pending_downshift === 'object'
|
|
808
|
+
? { ...snap.pending_downshift }
|
|
809
|
+
: null;
|
|
810
|
+
if (engine.pending_downshift?.toModel && snap.pendingDownshiftModel === undefined) {
|
|
811
|
+
engine.pendingDownshiftModel = String(engine.pending_downshift.toModel);
|
|
812
|
+
}
|
|
813
|
+
}
|
|
814
|
+
if (typeof snap.justCompacted === 'boolean') {
|
|
815
|
+
engine.justCompacted = snap.justCompacted;
|
|
816
|
+
}
|
|
817
|
+
if (snap.turnsSinceLastCompact !== undefined) {
|
|
818
|
+
engine.turnsSinceLastCompact =
|
|
819
|
+
snap.turnsSinceLastCompact !== null && Number.isFinite(Number(snap.turnsSinceLastCompact))
|
|
820
|
+
? Math.max(0, Number(snap.turnsSinceLastCompact))
|
|
821
|
+
: null;
|
|
822
|
+
}
|
|
823
|
+
if (snap.taskBoundaryState && typeof snap.taskBoundaryState === 'object') {
|
|
824
|
+
engine.taskBoundaryState = {
|
|
825
|
+
openFailure: Boolean(snap.taskBoundaryState.openFailure),
|
|
826
|
+
editsSinceBoundary: Math.max(0, Number(snap.taskBoundaryState.editsSinceBoundary || 0)),
|
|
827
|
+
lastBoundarySuggestedTurn: snap.taskBoundaryState.lastBoundarySuggestedTurn ?? null
|
|
828
|
+
};
|
|
829
|
+
}
|
|
830
|
+
if (snap.lastToolsetHash !== undefined) {
|
|
831
|
+
engine.lastToolsetHash =
|
|
832
|
+
snap.lastToolsetHash && typeof snap.lastToolsetHash === 'object'
|
|
833
|
+
? { ...snap.lastToolsetHash }
|
|
834
|
+
: null;
|
|
835
|
+
}
|
|
836
|
+
if (snap.lastContextTokens !== undefined) {
|
|
837
|
+
engine.lastContextTokens =
|
|
838
|
+
snap.lastContextTokens !== null && Number.isFinite(Number(snap.lastContextTokens))
|
|
839
|
+
? Math.max(0, Number(snap.lastContextTokens))
|
|
840
|
+
: null;
|
|
841
|
+
}
|
|
842
|
+
if (snap.lastModelId !== undefined) {
|
|
843
|
+
engine.lastModelId = snap.lastModelId ? String(snap.lastModelId) : null;
|
|
844
|
+
}
|
|
845
|
+
if (Array.isArray(snap.activeBackgroundTasks)) {
|
|
846
|
+
engine.activeBackgroundTasks = snap.activeBackgroundTasks.filter(Boolean).map(String);
|
|
847
|
+
}
|
|
848
|
+
if (Array.isArray(snap.activeWriteWorkers)) {
|
|
849
|
+
engine.activeWriteWorkers = snap.activeWriteWorkers.filter(Boolean).map(String);
|
|
850
|
+
}
|
|
851
|
+
if (typeof snap.lastUserPrompt === 'string') {
|
|
852
|
+
engine.lastUserPrompt = snap.lastUserPrompt;
|
|
853
|
+
}
|
|
854
|
+
if (typeof snap.lastTurnGitCommitted === 'boolean') {
|
|
855
|
+
engine.lastTurnGitCommitted = snap.lastTurnGitCommitted;
|
|
856
|
+
}
|
|
857
|
+
if (Array.isArray(snap.committedTopDirs)) {
|
|
858
|
+
engine.committedTopDirs = [...snap.committedTopDirs];
|
|
859
|
+
}
|
|
860
|
+
if (typeof snap.consecutiveTrivialMaxEffortTurns === 'number') {
|
|
861
|
+
engine.consecutiveTrivialMaxEffortTurns = snap.consecutiveTrivialMaxEffortTurns;
|
|
862
|
+
}
|
|
863
|
+
if (snap.recentEditTimestampsByFile && typeof snap.recentEditTimestampsByFile === 'object') {
|
|
864
|
+
engine.recentEditTimestampsByFile = { ...snap.recentEditTimestampsByFile };
|
|
865
|
+
}
|
|
866
|
+
if (typeof snap.totalDiscoveryCalls === 'number') {
|
|
867
|
+
engine.totalDiscoveryCalls = snap.totalDiscoveryCalls;
|
|
868
|
+
}
|
|
869
|
+
if (typeof snap.consecutiveVisionTurns === 'number') {
|
|
870
|
+
engine.consecutiveVisionTurns = snap.consecutiveVisionTurns;
|
|
871
|
+
}
|
|
872
|
+
if (typeof snap.unanchoredTurnFlag === 'boolean') {
|
|
873
|
+
engine.unanchoredTurnFlag = snap.unanchoredTurnFlag;
|
|
874
|
+
}
|
|
875
|
+
if (Array.isArray(snap.candidateFiles)) {
|
|
876
|
+
engine.candidateFiles = [...snap.candidateFiles];
|
|
877
|
+
}
|
|
878
|
+
if (snap.relayState && typeof snap.relayState === 'object') {
|
|
879
|
+
engine.relayState = { ...snap.relayState };
|
|
880
|
+
}
|
|
881
|
+
if (typeof snap.steeredPrompts === 'number') {
|
|
882
|
+
engine.steeredPrompts = snap.steeredPrompts;
|
|
883
|
+
}
|
|
884
|
+
if (typeof snap.blockedPrompts === 'number') {
|
|
885
|
+
engine.blockedPrompts = snap.blockedPrompts;
|
|
886
|
+
}
|
|
887
|
+
if (typeof snap.sightseeingToolsPrevented === 'number') {
|
|
888
|
+
engine.sightseeingToolsPrevented = snap.sightseeingToolsPrevented;
|
|
889
|
+
}
|
|
890
|
+
if (snap.subagentTurns && typeof snap.subagentTurns === 'object') {
|
|
891
|
+
engine.subagentTurns = { ...snap.subagentTurns };
|
|
892
|
+
}
|
|
893
|
+
if (snap.subagentTokens && typeof snap.subagentTokens === 'object') {
|
|
894
|
+
engine.subagentTokens = { ...snap.subagentTokens };
|
|
895
|
+
}
|
|
896
|
+
if (snap.det11AdvisedTurn !== undefined) {
|
|
897
|
+
engine.det11AdvisedTurn = snap.det11AdvisedTurn;
|
|
898
|
+
}
|
|
899
|
+
if (snap.det13AdvisedTurn !== undefined) {
|
|
900
|
+
engine.det13AdvisedTurn = snap.det13AdvisedTurn;
|
|
901
|
+
}
|
|
902
|
+
if (Array.isArray(snap.queuedMutations)) {
|
|
903
|
+
engine.router.mutationQueue.items = [...snap.queuedMutations];
|
|
904
|
+
}
|
|
905
|
+
if (snap.hysteresisState && typeof snap.hysteresisState === 'object') {
|
|
906
|
+
engine.router.hysteresisLock.locked = Boolean(snap.hysteresisState.locked);
|
|
907
|
+
engine.router.hysteresisLock.pinnedModel = snap.hysteresisState.pinnedModel || null;
|
|
908
|
+
engine.router.hysteresisLock.pinnedEffort = snap.hysteresisState.pinnedEffort || null;
|
|
909
|
+
engine.router.hysteresisLock.reason = snap.hysteresisState.reason || null;
|
|
910
|
+
engine.router.hysteresisLock.lockedAtTurn = snap.hysteresisState.lockedAtTurn ?? null;
|
|
911
|
+
}
|
|
912
|
+
return engine;
|
|
913
|
+
}
|