ctxtop 4.0.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 +81 -57
- package/LICENSE +27 -27
- package/README.md +385 -330
- package/SECURITY.md +7 -1
- package/assets/hero-demo.svg +1 -1
- package/bin/ah-statusline.mjs +30 -0
- package/bin/ctxtop.mjs +587 -49
- package/config/default_flightcheck.json +19 -0
- package/config/modelCatalog.json +952 -213
- package/hooks/handlers/compact-lifecycle.mjs +323 -8
- package/hooks/handlers/config-change.mjs +402 -0
- package/hooks/handlers/hookIo.mjs +56 -0
- package/hooks/handlers/hookIpcClient.mjs +8 -4
- package/hooks/handlers/post-model-switch.mjs +148 -0
- package/hooks/handlers/post-tool-use-core.mjs +394 -0
- package/hooks/handlers/post-tool-use.mjs +54 -220
- package/hooks/handlers/pre-model-switch.mjs +933 -24
- package/hooks/handlers/pre-tool-use-core.mjs +680 -0
- package/hooks/handlers/pre-tool-use.mjs +61 -304
- package/hooks/handlers/stop-gate.mjs +310 -12
- package/hooks/handlers/user-prompt-submit.mjs +334 -1
- package/hooks/hooks.json +50 -0
- package/hooks/post_tool_use.mjs +24 -3
- package/hooks/pre_tool_use.mjs +84 -54
- package/hooks/register.js +48 -9
- package/hooks/session_start.mjs +11 -1
- package/hooks/stop.mjs +11 -1
- package/hooks.json +56 -56
- package/package.json +12 -4
- 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 +514 -40
- package/skills/handoff/SKILL.md +8 -0
- package/src/adapters/antigravity/index.mjs +31 -1
- package/src/adapters/claude-code/index.mjs +40 -1
- package/src/cli/doctor.mjs +11 -2
- package/src/cli/horizon_hud.mjs +283 -65
- package/src/cli/init.mjs +46 -13
- package/src/config/modelCatalog.json +952 -213
- package/src/core/bucket_b_runtime.mjs +1200 -0
- 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 +365 -15
- package/src/core/detectors_det01_to_16.mjs +98 -8
- package/src/core/doc_indexer.mjs +338 -0
- package/src/core/fts5_output_compressor.mjs +272 -35
- package/src/core/horizon_config.mjs +42 -0
- package/src/core/layer5_hygiene.mjs +118 -0
- package/src/core/parser.mjs +88 -12
- package/src/core/paths.mjs +3 -2
- 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_clash_auditor.mjs +423 -0
- package/src/core/rsl_distiller.mjs +394 -0
- package/src/core/rsl_ledger.mjs +1029 -0
- package/src/core/rsl_triage.mjs +1051 -0
- package/src/core/session_auditor.mjs +1109 -0
- package/src/core/shadow_auto_ledger.mjs +205 -0
- package/src/core/shield_manager.mjs +1417 -0
- package/src/core/sqlite_client.mjs +10 -4
- package/src/core/subagents.mjs +18 -2
- package/src/core/task_quota_router.mjs +62 -5
- package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
- package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
- package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
- package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
- package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
- package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
- package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
- package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
- package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
- package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
- package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
- package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
- package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
- package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
- package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
- package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/src/core-isomorphic/index.js +1 -0
- package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
- package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
- package/src/core-isomorphic/ui/modViews.mjs +95 -15
- package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
- package/src/diagnostics/doctorEngine.mjs +122 -4
- package/src/engine-node/db/probe.mjs +234 -2
- package/src/engine-node/index.mjs +3 -0
- 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/engine-node/sensors/blindspots.mjs +13 -6
- package/src/hooks/antigravity_rsl_hook.mjs +272 -0
- package/src/hooks/claude_rsl_hook.mjs +308 -0
- 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 -405
- package/src/hooks/post_invocation_core.mjs +623 -0
- package/src/hooks/pre_invocation.mjs +103 -958
- package/src/hooks/pre_invocation_core.mjs +1830 -0
- package/src/hooks/session_start.mjs +39 -1
- package/src/utils/modelSwitchTelemetry.mjs +308 -0
- package/src/utils/sessionCalibration.mjs +704 -0
- package/src/webview/advanced_view.html +34 -18
- package/src/webview/horizon_panel.html +4191 -625
- package/src/webview/simple_view.html +1 -1
|
@@ -345,9 +345,10 @@ export function deriveSurfaceMetrics(state = {}, options = {}) {
|
|
|
345
345
|
totalInputTokens,
|
|
346
346
|
options
|
|
347
347
|
);
|
|
348
|
-
const liveSubagentIsolatedUSD =
|
|
349
|
-
|
|
350
|
-
|
|
348
|
+
const liveSubagentIsolatedUSD =
|
|
349
|
+
activeRatesForSub && !activeRatesForSub.unknownModel && Number.isFinite(activeRatesForSub.inputPer1M)
|
|
350
|
+
? Number(((liveSubagentIsolatedTokens / 1_000_000) * activeRatesForSub.inputPer1M).toFixed(6))
|
|
351
|
+
: 0;
|
|
351
352
|
|
|
352
353
|
// Use explicit options.savedUSD / options.savedTokens if passed, else max of ledger + session
|
|
353
354
|
const savedUSD =
|
|
@@ -478,10 +479,14 @@ export function deriveSurfaceMetrics(state = {}, options = {}) {
|
|
|
478
479
|
totalInputTokens,
|
|
479
480
|
options
|
|
480
481
|
);
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
482
|
+
if (activeRates && !activeRates.unknownModel && activeRates.multipliers) {
|
|
483
|
+
const mWrite =
|
|
484
|
+
ttlTier === '1h' ? activeRates.multipliers.write1h : activeRates.multipliers.write5m;
|
|
485
|
+
const mRead = activeRates.multipliers.read;
|
|
486
|
+
breakEvenReadsPerWrite = Number(((mWrite - 1) / (1 - mRead)).toFixed(3));
|
|
487
|
+
} else {
|
|
488
|
+
breakEvenReadsPerWrite = null;
|
|
489
|
+
}
|
|
485
490
|
}
|
|
486
491
|
const sessionFiveMinRoiTarget = Number(roi.sessionFiveMinRoiTarget || 1.39);
|
|
487
492
|
|
|
@@ -724,6 +729,50 @@ export function deriveClaudeCodeVerdictAndActions(state = {}, grid, metrics, opt
|
|
|
724
729
|
});
|
|
725
730
|
}
|
|
726
731
|
|
|
732
|
+
const rslData = options.rsl || state.rsl || null;
|
|
733
|
+
if (rslData && Number(rslData.clashCount || 0) > 0) {
|
|
734
|
+
if (verdict.severity === 'healthy') {
|
|
735
|
+
verdict = {
|
|
736
|
+
severity: 'warn',
|
|
737
|
+
badge: 'RULE CLASH',
|
|
738
|
+
headline: `${rslData.clashCount} Conflicting Learned Rule${rslData.clashCount === 1 ? '' : 's'}`,
|
|
739
|
+
detail: 'Quarantined RSL heuristic conflict needs review before applying automatically'
|
|
740
|
+
};
|
|
741
|
+
}
|
|
742
|
+
actions.push({
|
|
743
|
+
id: 'rsl-clash',
|
|
744
|
+
severity: 'warn',
|
|
745
|
+
title: `Resolve ${rslData.clashCount} RSL rule clash${rslData.clashCount === 1 ? '' : 'es'}`,
|
|
746
|
+
instruction: 'Run `npx ah rsl status` to inspect and resolve conflicting workspace heuristics.',
|
|
747
|
+
commandHint: 'npx ah rsl status',
|
|
748
|
+
reclaimTokens: 0
|
|
749
|
+
});
|
|
750
|
+
}
|
|
751
|
+
|
|
752
|
+
const shardedSpec = options.shardedSpec || state.shardedSpec || null;
|
|
753
|
+
if (shardedSpec && shardedSpec.sharded) {
|
|
754
|
+
actions.push({
|
|
755
|
+
id: 'sharded-spec',
|
|
756
|
+
severity: 'warn',
|
|
757
|
+
title: `Consolidate ${Number(shardedSpec.count || 2)} sharded specification files`,
|
|
758
|
+
instruction: 'Run `npx ah handoff --consolidate` so split constraints stay anchored in Turn 0.',
|
|
759
|
+
commandHint: 'npx ah handoff --consolidate',
|
|
760
|
+
reclaimTokens: 0
|
|
761
|
+
});
|
|
762
|
+
}
|
|
763
|
+
|
|
764
|
+
const shieldData = options.shield || state.shield || null;
|
|
765
|
+
if (shieldData && (shieldData.quarantined || shieldData.alert)) {
|
|
766
|
+
actions.push({
|
|
767
|
+
id: 'shield-firewall',
|
|
768
|
+
severity: 'warn',
|
|
769
|
+
title: 'Prefix-cache Shield held a mutation',
|
|
770
|
+
instruction: 'Inspect queued prefix updates with `npx ah doctor` before modifying rules mid-chat.',
|
|
771
|
+
commandHint: 'npx ah doctor',
|
|
772
|
+
reclaimTokens: 0
|
|
773
|
+
});
|
|
774
|
+
}
|
|
775
|
+
|
|
727
776
|
if (actions.length === 0) {
|
|
728
777
|
actions.push({
|
|
729
778
|
id: 'keep-coding',
|
|
@@ -1254,10 +1303,19 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1254
1303
|
|
|
1255
1304
|
// Section 3: Circuit Breakers (DET-01..32), Thinking Drift & Prefix Retention
|
|
1256
1305
|
const activeBreakerId =
|
|
1257
|
-
options.breakerVerdict?.detectorId ||
|
|
1306
|
+
options.breakerVerdict?.detectorId ||
|
|
1307
|
+
options.breakerVerdict?.ruleId ||
|
|
1308
|
+
state.coachState?.detectors?.tripped?.detectorId ||
|
|
1309
|
+
state.circuitBreakerTripped?.detectorId ||
|
|
1310
|
+
null;
|
|
1311
|
+
const activeBreakerReason =
|
|
1312
|
+
options.breakerVerdict?.reason ||
|
|
1313
|
+
state.coachState?.detectors?.tripped?.reason ||
|
|
1314
|
+
state.circuitBreakerTripped?.reason ||
|
|
1315
|
+
'active';
|
|
1258
1316
|
const sec3Lines = [
|
|
1259
1317
|
`[Section 3] Circuit Breakers (DET-01..32), Thinking Drift & Retention`,
|
|
1260
|
-
`Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${
|
|
1318
|
+
`Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${activeBreakerReason})` : 'None (32 guards nominal)'}`,
|
|
1261
1319
|
`Prefix Retention: ${formatRetentionLabel(state.prefixRetention)}`,
|
|
1262
1320
|
`Thinking Drift (DET-30): ${formatDriftLabel(state.thinkingDrift)}`,
|
|
1263
1321
|
`Haiku 100k 5x Cliff (DET-12): ${state.cliffTriggered ? 'EXCEEDED (5x step-up)' : state.preCliffWarningTriggered ? 'PRE-CLIFF WARNING (>= 90k)' : 'Nominal'}`
|
|
@@ -1280,7 +1338,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1280
1338
|
// Section 5: PreCompact State Baton & Session Forensics
|
|
1281
1339
|
const sec5Lines = [
|
|
1282
1340
|
`[Section 5] PreCompact State Baton & Claude Code Forensics`,
|
|
1283
|
-
`Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted
|
|
1341
|
+
`Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted ?? state.window?.turnCount ?? state.sessionTimeline?.totalTurns ?? 0)}`,
|
|
1284
1342
|
`Zoom Tier : ${grid.zoomTier.label} (${grid.zoomTier.tokensPerCell.toLocaleString('en-US')} tok/cell)`,
|
|
1285
1343
|
`State Baton: Auto-flushed on PreCompact to .claude/cache/HANDOFF_LATEST.md`,
|
|
1286
1344
|
`CLI Tools : npx ctxtop statusline | npx ctxtop radar | npx ctxtop inspect | npx ctxtop doctor`
|
|
@@ -1302,7 +1360,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1302
1360
|
{
|
|
1303
1361
|
sectionNumber: 3,
|
|
1304
1362
|
id: 'circuit-breakers-drift',
|
|
1305
|
-
title: 'Circuit Breakers (DET-01..
|
|
1363
|
+
title: 'Circuit Breakers (DET-01..32), Thinking Drift & Retention',
|
|
1306
1364
|
lines: sec3Lines
|
|
1307
1365
|
},
|
|
1308
1366
|
{
|
|
@@ -1346,6 +1404,23 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1346
1404
|
};
|
|
1347
1405
|
}
|
|
1348
1406
|
|
|
1407
|
+
/**
|
|
1408
|
+
* Pure zero-Node formatter for the Claude Code `statusLine` RSL budget segment.
|
|
1409
|
+
*
|
|
1410
|
+
* @param {object} rsl
|
|
1411
|
+
* @returns {string}
|
|
1412
|
+
*/
|
|
1413
|
+
export function formatRslStatusSegment(rsl) {
|
|
1414
|
+
if (!rsl || typeof rsl !== 'object') return '';
|
|
1415
|
+
const rules = Math.max(0, Number(rsl.activeRules ?? 0));
|
|
1416
|
+
const tokens = Math.max(0, Number(rsl.ruleBudgetTokens ?? 0));
|
|
1417
|
+
const clashes = Math.max(0, Number(rsl.clashCount ?? 0));
|
|
1418
|
+
const budgetStr =
|
|
1419
|
+
tokens >= 1000 ? `${(tokens / 1000).toFixed(1).replace(/\.0$/, '')}k` : String(tokens);
|
|
1420
|
+
const base = `RSL: ${rules} rules | Budget: ${budgetStr}/20k`;
|
|
1421
|
+
return clashes > 0 ? `${base} | ${clashes} clash!` : base;
|
|
1422
|
+
}
|
|
1423
|
+
|
|
1349
1424
|
/**
|
|
1350
1425
|
* 4. Renders a single-line terminal `statusLine` adapting cleanly to terminal column width
|
|
1351
1426
|
* (`80`, `110`, `144`, or arbitrary column count).
|
|
@@ -1415,16 +1490,20 @@ export function renderStatusLine(state = {}, options = {}) {
|
|
|
1415
1490
|
const retStr = state.prefixRetention?.measured ? ` · ${formatRetentionCompact(state.prefixRetention)}` : '';
|
|
1416
1491
|
const swarmTok = layoutTier === 'wide-144' ? formatSwarmCompact(computeSwarmSummary(state, { nowMs: options.nowMs || Date.now() })) : '';
|
|
1417
1492
|
const swarmStr = swarmTok ? ` · ${swarmTok}` : '';
|
|
1493
|
+
const rslData = options.rsl || state.rsl || null;
|
|
1494
|
+
const rslTok = layoutTier !== 'compact-80' && rslData ? formatRslStatusSegment(rslData) : '';
|
|
1495
|
+
const rslStr = rslTok ? ` · ${rslTok}` : '';
|
|
1418
1496
|
|
|
1497
|
+
const prefix = options.legacyPrefix ? 'AH' : 'HB';
|
|
1419
1498
|
let p = '';
|
|
1420
1499
|
let a = '';
|
|
1421
1500
|
if (layoutTier === 'compact-80') {
|
|
1422
|
-
p =
|
|
1423
|
-
a =
|
|
1501
|
+
p = `${prefix} ${g.bracketedBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
|
|
1502
|
+
a = `${prefix} ${g.ansiCodeBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
|
|
1424
1503
|
} else {
|
|
1425
1504
|
const shortModel = g.modelId.replace(/^claude-/, '');
|
|
1426
|
-
p =
|
|
1427
|
-
a =
|
|
1505
|
+
p = `${prefix} ${g.bracketedBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
|
|
1506
|
+
a = `${prefix} ${g.ansiCodeBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
|
|
1428
1507
|
}
|
|
1429
1508
|
|
|
1430
1509
|
chosenGrid = g;
|
|
@@ -1474,5 +1553,6 @@ export default {
|
|
|
1474
1553
|
renderSimpleViewPane,
|
|
1475
1554
|
renderSimpleHudPane,
|
|
1476
1555
|
renderAdvancedViewPane,
|
|
1556
|
+
formatRslStatusSegment,
|
|
1477
1557
|
renderStatusLine
|
|
1478
1558
|
};
|
|
@@ -0,0 +1,426 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/diagnostics/claudeHookCapabilities.mjs
|
|
3
|
+
* Startup feature-check for undocumented Claude Code hook contracts (`PreModelSwitch`,
|
|
4
|
+
* `permissionBehavior === "ask"`, payload keys `from_model`/`to_model`/`prompt_cache_warm`,
|
|
5
|
+
* and absence of `PreEffortChange`).
|
|
6
|
+
*
|
|
7
|
+
* Scans the installed Claude Code binary/bundle in bounded 4 MB chunks with 256-byte overlap,
|
|
8
|
+
* caches results by `(binaryPath, size, mtimeMs)` under `.attention-horizon/cache/ah_claude_capabilities.json`,
|
|
9
|
+
* and logs a non-fatal runtime diagnostic if the installed binary drops the hook contract.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { execFileSync } from 'node:child_process';
|
|
13
|
+
import {
|
|
14
|
+
fs,
|
|
15
|
+
path,
|
|
16
|
+
os,
|
|
17
|
+
readJsonSafe,
|
|
18
|
+
writeJsonAtomic
|
|
19
|
+
} from '../utils/nodeIo.mjs';
|
|
20
|
+
import { recordRuntimeDiagnostic } from '../core-isomorphic/utils/runtime.mjs';
|
|
21
|
+
|
|
22
|
+
const CHUNK_BYTES = 4 * 1024 * 1024;
|
|
23
|
+
const OVERLAP_BYTES = 256;
|
|
24
|
+
|
|
25
|
+
const CAPABILITY_MARKERS = Object.freeze({
|
|
26
|
+
preModelSwitchSupported: 'PreModelSwitch',
|
|
27
|
+
postModelSwitchSupported: 'PostModelSwitch',
|
|
28
|
+
preEffortChangeSupported: 'PreEffortChange',
|
|
29
|
+
hasFromModelKey: 'from_model',
|
|
30
|
+
hasToModelKey: 'to_model',
|
|
31
|
+
hasPromptCacheWarmKey: 'prompt_cache_warm',
|
|
32
|
+
hasContextTokensKey: 'context_tokens',
|
|
33
|
+
hasAskBehavior: 'permissionBehavior==="ask"',
|
|
34
|
+
hasAskDialog: 'A PreModelSwitch hook asked',
|
|
35
|
+
sdkSetModelHooked: 'blocked_by_hook'
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Resolves the underlying JS bundle or native binary when given a Windows `.cmd` / POSIX wrapper.
|
|
40
|
+
* @param {string} candidatePath
|
|
41
|
+
* @returns {string}
|
|
42
|
+
*/
|
|
43
|
+
function unwrapClaudeShim(candidatePath) {
|
|
44
|
+
if (!candidatePath || !fs.existsSync(candidatePath)) return candidatePath;
|
|
45
|
+
const ext = path.extname(candidatePath).toLowerCase();
|
|
46
|
+
const dir = path.dirname(candidatePath);
|
|
47
|
+
|
|
48
|
+
if (ext === '.cmd' || ext === '.bat') {
|
|
49
|
+
const pkgBase = path.join(dir, 'node_modules', '@anthropic-ai', 'claude-code');
|
|
50
|
+
const exeInPkg = path.join(pkgBase, 'bin', 'claude.exe');
|
|
51
|
+
const jsInPkg = path.join(pkgBase, 'cli.js');
|
|
52
|
+
if (fs.existsSync(exeInPkg)) return exeInPkg;
|
|
53
|
+
if (fs.existsSync(jsInPkg)) return jsInPkg;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
return candidatePath;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Resolves the active `claude` binary/bundle path from options, `CLAUDE_BIN`, or `PATH`.
|
|
61
|
+
* @param {object} [options={}]
|
|
62
|
+
* @returns {string | null}
|
|
63
|
+
*/
|
|
64
|
+
export function resolveClaudeBinaryPath(options = {}) {
|
|
65
|
+
const candidates = [];
|
|
66
|
+
if (typeof options.claudeBinPath === 'string' && options.claudeBinPath.trim()) {
|
|
67
|
+
candidates.push(options.claudeBinPath.trim());
|
|
68
|
+
}
|
|
69
|
+
const envBin = globalThis.process?.env?.CLAUDE_BIN;
|
|
70
|
+
if (typeof envBin === 'string' && envBin.trim()) {
|
|
71
|
+
candidates.push(envBin.trim());
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
if (candidates.length === 0) {
|
|
75
|
+
const pathEnv = String(globalThis.process?.env?.PATH || '');
|
|
76
|
+
const sep = globalThis.process?.platform === 'win32' ? ';' : ':';
|
|
77
|
+
const names =
|
|
78
|
+
globalThis.process?.platform === 'win32'
|
|
79
|
+
? ['claude.exe', 'claude.cmd', 'claude']
|
|
80
|
+
: ['claude'];
|
|
81
|
+
for (const dir of pathEnv.split(sep).filter(Boolean)) {
|
|
82
|
+
for (const name of names) {
|
|
83
|
+
candidates.push(path.join(dir, name));
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// Standard local CLI & benchmark runtime locations (no hardcoded usernames)
|
|
88
|
+
const homeDir = options.homeDir || os.homedir();
|
|
89
|
+
const tmpDir = os.tmpdir();
|
|
90
|
+
if (homeDir) {
|
|
91
|
+
for (const name of names) {
|
|
92
|
+
candidates.push(path.join(homeDir, '.local', 'bin', name));
|
|
93
|
+
candidates.push(path.join(homeDir, '.claude', 'local', name));
|
|
94
|
+
candidates.push(
|
|
95
|
+
path.join(homeDir, '.claude', 'local', 'node_modules', '@anthropic-ai', 'claude-code', 'bin', name)
|
|
96
|
+
);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
try {
|
|
100
|
+
if (tmpDir && fs.existsSync(tmpDir)) {
|
|
101
|
+
for (const ent of fs.readdirSync(tmpDir)) {
|
|
102
|
+
if (ent.includes('model-switch-runtime')) {
|
|
103
|
+
for (const name of names) {
|
|
104
|
+
candidates.push(
|
|
105
|
+
path.join(tmpDir, ent, 'cli', 'node_modules', '@anthropic-ai', 'claude-code', 'bin', name)
|
|
106
|
+
);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
} catch {
|
|
112
|
+
// Ignore temp directory scan errors
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
for (const raw of candidates) {
|
|
117
|
+
try {
|
|
118
|
+
const unwrapped = unwrapClaudeShim(raw);
|
|
119
|
+
if (unwrapped && fs.existsSync(unwrapped)) {
|
|
120
|
+
const st = fs.statSync(unwrapped);
|
|
121
|
+
if (st.isFile()) return unwrapped;
|
|
122
|
+
}
|
|
123
|
+
} catch {
|
|
124
|
+
// Skip inaccessible candidate
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
return null;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Reads sibling `@anthropic-ai/claude-code/package.json` (fast, zero subprocess) or optionally
|
|
132
|
+
* queries `claude --version` when `options.probeVersion === true`.
|
|
133
|
+
*
|
|
134
|
+
* @param {string} binPath
|
|
135
|
+
* @param {object} [options={}]
|
|
136
|
+
* @returns {string | null}
|
|
137
|
+
*/
|
|
138
|
+
function detectClaudeVersion(binPath, options = {}) {
|
|
139
|
+
const pkgCandidates = [
|
|
140
|
+
path.join(path.dirname(binPath), 'package.json'),
|
|
141
|
+
path.join(path.dirname(binPath), '..', 'package.json')
|
|
142
|
+
];
|
|
143
|
+
for (const pkgPath of pkgCandidates) {
|
|
144
|
+
const parsed = readJsonSafe(pkgPath, null, options);
|
|
145
|
+
if (parsed && parsed.name === '@anthropic-ai/claude-code' && typeof parsed.version === 'string') {
|
|
146
|
+
return parsed.version;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
if (options.probeVersion === true) {
|
|
151
|
+
try {
|
|
152
|
+
const out = execFileSync(binPath, ['--version'], {
|
|
153
|
+
encoding: 'utf8',
|
|
154
|
+
timeout: 3000,
|
|
155
|
+
stdio: ['ignore', 'pipe', 'ignore']
|
|
156
|
+
}).trim();
|
|
157
|
+
const match = out.match(/(\d+\.\d+\.\d+(?:[-+][^\s]+)?)/);
|
|
158
|
+
if (match) return match[1];
|
|
159
|
+
} catch {
|
|
160
|
+
// Ignore version subprocess failure
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
return null;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* Streams a file in bounded 4 MB overlapping chunks to test exact ASCII substring markers
|
|
168
|
+
* without loading large standalone binaries wholly into V8 heap memory.
|
|
169
|
+
*
|
|
170
|
+
* @param {string} binPath
|
|
171
|
+
* @returns {Record<string, boolean>}
|
|
172
|
+
*/
|
|
173
|
+
function scanBinaryMarkersChunked(binPath) {
|
|
174
|
+
const foundFlags = Object.fromEntries(Object.keys(CAPABILITY_MARKERS).map((k) => [k, false]));
|
|
175
|
+
const markerEntries = Object.entries(CAPABILITY_MARKERS);
|
|
176
|
+
const buf = Buffer.allocUnsafe(CHUNK_BYTES);
|
|
177
|
+
const fd = fs.openSync(binPath, 'r');
|
|
178
|
+
try {
|
|
179
|
+
let tail = '';
|
|
180
|
+
let bytesRead;
|
|
181
|
+
while ((bytesRead = fs.readSync(fd, buf, 0, CHUNK_BYTES, null)) > 0) {
|
|
182
|
+
const chunkStr = tail + buf.subarray(0, bytesRead).toString('latin1');
|
|
183
|
+
let allFound = true;
|
|
184
|
+
for (const [key, marker] of markerEntries) {
|
|
185
|
+
if (!foundFlags[key]) {
|
|
186
|
+
if (chunkStr.includes(marker)) {
|
|
187
|
+
foundFlags[key] = true;
|
|
188
|
+
} else {
|
|
189
|
+
allFound = false;
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
if (allFound) break;
|
|
194
|
+
tail = chunkStr.slice(Math.max(0, chunkStr.length - OVERLAP_BYTES));
|
|
195
|
+
}
|
|
196
|
+
} finally {
|
|
197
|
+
fs.closeSync(fd);
|
|
198
|
+
}
|
|
199
|
+
return foundFlags;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* Formats `PreEffortChange` capability into a clear human-readable doctor status string
|
|
204
|
+
* without altering the boolean `preEffortChangeSupported` API contract.
|
|
205
|
+
*
|
|
206
|
+
* @param {{ preEffortChangeSupported?: boolean | null }} [cap={}]
|
|
207
|
+
* @returns {string}
|
|
208
|
+
*/
|
|
209
|
+
export function formatPreEffortChangeCapability(cap = {}) {
|
|
210
|
+
if (cap?.preEffortChangeSupported === true) {
|
|
211
|
+
return 'true';
|
|
212
|
+
}
|
|
213
|
+
if (cap?.preEffortChangeSupported === false) {
|
|
214
|
+
return 'n/a (ConfigChange + turn-boundary active; 5.5+ cache-safe)';
|
|
215
|
+
}
|
|
216
|
+
return 'unknown';
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Inspects the installed Claude Code CLI/bundle for `PreModelSwitch` support and contract parity.
|
|
221
|
+
*
|
|
222
|
+
* @param {object} [options={}]
|
|
223
|
+
* @returns {{
|
|
224
|
+
* found: boolean,
|
|
225
|
+
* binaryPath: string | null,
|
|
226
|
+
* claudeVersion: string | null,
|
|
227
|
+
* preModelSwitchSupported: boolean | null,
|
|
228
|
+
* postModelSwitchSupported: boolean | null,
|
|
229
|
+
* preEffortChangeSupported: boolean | null,
|
|
230
|
+
* preEffortChangeSummary: string | null,
|
|
231
|
+
* supportsAskDecision: boolean | null,
|
|
232
|
+
* sdkSetModelHooked: boolean | null,
|
|
233
|
+
* payloadKeys: { from_model: boolean, to_model: boolean, prompt_cache_warm: boolean, context_tokens: boolean } | null,
|
|
234
|
+
* contractValid: boolean | null,
|
|
235
|
+
* cached: boolean,
|
|
236
|
+
* warning: string | null
|
|
237
|
+
* }}
|
|
238
|
+
*/
|
|
239
|
+
export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
240
|
+
const cwd = options.cwd || globalThis.process?.cwd?.() || '.';
|
|
241
|
+
const binPath = resolveClaudeBinaryPath(options);
|
|
242
|
+
if (!binPath) {
|
|
243
|
+
return {
|
|
244
|
+
found: false,
|
|
245
|
+
binaryPath: null,
|
|
246
|
+
claudeVersion: null,
|
|
247
|
+
preModelSwitchSupported: null,
|
|
248
|
+
postModelSwitchSupported: null,
|
|
249
|
+
preEffortChangeSupported: null,
|
|
250
|
+
preEffortChangeSummary: null,
|
|
251
|
+
supportsAskDecision: null,
|
|
252
|
+
sdkSetModelHooked: null,
|
|
253
|
+
payloadKeys: null,
|
|
254
|
+
contractValid: null,
|
|
255
|
+
cached: false,
|
|
256
|
+
warning: null
|
|
257
|
+
};
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
let stat;
|
|
261
|
+
try {
|
|
262
|
+
stat = fs.statSync(binPath);
|
|
263
|
+
} catch (err) {
|
|
264
|
+
void err;
|
|
265
|
+
return {
|
|
266
|
+
found: false,
|
|
267
|
+
binaryPath: null,
|
|
268
|
+
claudeVersion: null,
|
|
269
|
+
preModelSwitchSupported: null,
|
|
270
|
+
postModelSwitchSupported: null,
|
|
271
|
+
preEffortChangeSupported: null,
|
|
272
|
+
preEffortChangeSummary: null,
|
|
273
|
+
supportsAskDecision: null,
|
|
274
|
+
sdkSetModelHooked: null,
|
|
275
|
+
payloadKeys: null,
|
|
276
|
+
contractValid: null,
|
|
277
|
+
cached: false,
|
|
278
|
+
warning: null
|
|
279
|
+
};
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
const cacheBaseDir = options.homeDir || cwd;
|
|
283
|
+
const cachePath =
|
|
284
|
+
options.cachePath ||
|
|
285
|
+
path.join(cacheBaseDir, '.attention-horizon', 'cache', 'ah_claude_capabilities.json');
|
|
286
|
+
if (!options.bypassCache) {
|
|
287
|
+
const cached = readJsonSafe(cachePath, null, options);
|
|
288
|
+
if (
|
|
289
|
+
cached &&
|
|
290
|
+
cached.binaryPath === binPath &&
|
|
291
|
+
cached.size === stat.size &&
|
|
292
|
+
cached.mtimeMs === stat.mtimeMs &&
|
|
293
|
+
cached.result &&
|
|
294
|
+
typeof cached.result.contractValid === 'boolean'
|
|
295
|
+
) {
|
|
296
|
+
return {
|
|
297
|
+
...cached.result,
|
|
298
|
+
preEffortChangeSummary:
|
|
299
|
+
cached.result.preEffortChangeSummary || formatPreEffortChangeCapability(cached.result),
|
|
300
|
+
cached: true
|
|
301
|
+
};
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
const markers = scanBinaryMarkersChunked(binPath);
|
|
306
|
+
const claudeVersion = options.claudeVersion || detectClaudeVersion(binPath, options);
|
|
307
|
+
const payloadKeys = {
|
|
308
|
+
from_model: markers.hasFromModelKey,
|
|
309
|
+
to_model: markers.hasToModelKey,
|
|
310
|
+
prompt_cache_warm: markers.hasPromptCacheWarmKey,
|
|
311
|
+
context_tokens: markers.hasContextTokensKey
|
|
312
|
+
};
|
|
313
|
+
const supportsAskDecision = Boolean(markers.hasAskBehavior || markers.hasAskDialog);
|
|
314
|
+
const contractValid = Boolean(
|
|
315
|
+
markers.preModelSwitchSupported &&
|
|
316
|
+
payloadKeys.from_model &&
|
|
317
|
+
payloadKeys.to_model &&
|
|
318
|
+
payloadKeys.prompt_cache_warm &&
|
|
319
|
+
supportsAskDecision
|
|
320
|
+
);
|
|
321
|
+
|
|
322
|
+
const warning = contractValid
|
|
323
|
+
? null
|
|
324
|
+
: `[Highbeam Startup Check] Claude Code (${claudeVersion || 'unknown'}) does not expose the expected undocumented PreModelSwitch hook contract; DET-08 native /model interception is unavailable.`;
|
|
325
|
+
|
|
326
|
+
if (warning && options.recordDiagnostic !== false) {
|
|
327
|
+
recordRuntimeDiagnostic(
|
|
328
|
+
'claudeHookCapabilities',
|
|
329
|
+
'inspectClaudeBinaryCapabilities',
|
|
330
|
+
new Error(warning),
|
|
331
|
+
{ ...options, cwd }
|
|
332
|
+
);
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
const result = {
|
|
336
|
+
found: true,
|
|
337
|
+
binaryPath: binPath,
|
|
338
|
+
claudeVersion,
|
|
339
|
+
preModelSwitchSupported: markers.preModelSwitchSupported,
|
|
340
|
+
postModelSwitchSupported: markers.postModelSwitchSupported,
|
|
341
|
+
preEffortChangeSupported: markers.preEffortChangeSupported,
|
|
342
|
+
preEffortChangeSummary: formatPreEffortChangeCapability({
|
|
343
|
+
preEffortChangeSupported: markers.preEffortChangeSupported
|
|
344
|
+
}),
|
|
345
|
+
supportsAskDecision,
|
|
346
|
+
sdkSetModelHooked: markers.sdkSetModelHooked,
|
|
347
|
+
payloadKeys,
|
|
348
|
+
contractValid,
|
|
349
|
+
cached: false,
|
|
350
|
+
warning
|
|
351
|
+
};
|
|
352
|
+
|
|
353
|
+
if (options.writeCache !== false && (options.cwd || options.cachePath)) {
|
|
354
|
+
writeJsonAtomic(
|
|
355
|
+
cachePath,
|
|
356
|
+
{
|
|
357
|
+
binaryPath: binPath,
|
|
358
|
+
size: stat.size,
|
|
359
|
+
mtimeMs: stat.mtimeMs,
|
|
360
|
+
result
|
|
361
|
+
},
|
|
362
|
+
options
|
|
363
|
+
);
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
return result;
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
/**
|
|
370
|
+
* Extracts all selectable model IDs and official aliases from an installed Claude Code binary
|
|
371
|
+
* in bounded 4 MB chunks (Item 1.3).
|
|
372
|
+
*
|
|
373
|
+
* @param {string} binPath
|
|
374
|
+
* @returns {{
|
|
375
|
+
* found: boolean,
|
|
376
|
+
* modelIds: string[],
|
|
377
|
+
* aliases: string[],
|
|
378
|
+
* allSelectable: string[]
|
|
379
|
+
* }}
|
|
380
|
+
*/
|
|
381
|
+
export function extractClaudeSelectableModelsFromBinary(binPath) {
|
|
382
|
+
if (!binPath || !fs.existsSync(binPath)) {
|
|
383
|
+
return { found: false, modelIds: [], aliases: [], allSelectable: [] };
|
|
384
|
+
}
|
|
385
|
+
const modelIds = new Set();
|
|
386
|
+
const aliases = new Set();
|
|
387
|
+
const buf = Buffer.allocUnsafe(CHUNK_BYTES);
|
|
388
|
+
const overlap = 8192;
|
|
389
|
+
const fd = fs.openSync(binPath, 'r');
|
|
390
|
+
try {
|
|
391
|
+
let tail = '';
|
|
392
|
+
let bytesRead;
|
|
393
|
+
while ((bytesRead = fs.readSync(fd, buf, 0, CHUNK_BYTES, null)) > 0) {
|
|
394
|
+
const chunkStr = tail + buf.subarray(0, bytesRead).toString('latin1');
|
|
395
|
+
if (chunkStr.includes('family:') && chunkStr.includes('display_name:')) {
|
|
396
|
+
for (const m of chunkStr.matchAll(/\{id:"(claude-[a-z0-9-]+)",family:"(?:haiku|sonnet|opus|fable|mythos)"/g)) {
|
|
397
|
+
modelIds.add(m[1]);
|
|
398
|
+
}
|
|
399
|
+
}
|
|
400
|
+
const aliasArrMatch = chunkStr.match(/\[("sonnet","opus"[^\]]{0,240})\]/);
|
|
401
|
+
if (aliasArrMatch) {
|
|
402
|
+
for (const m of aliasArrMatch[1].matchAll(/"([a-z0-9[\]-]+)"/g)) {
|
|
403
|
+
aliases.add(m[1]);
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
tail = chunkStr.slice(Math.max(0, chunkStr.length - overlap));
|
|
407
|
+
}
|
|
408
|
+
} finally {
|
|
409
|
+
fs.closeSync(fd);
|
|
410
|
+
}
|
|
411
|
+
const sortedIds = Array.from(modelIds).sort();
|
|
412
|
+
const sortedAliases = Array.from(aliases).sort();
|
|
413
|
+
return {
|
|
414
|
+
found: true,
|
|
415
|
+
modelIds: sortedIds,
|
|
416
|
+
aliases: sortedAliases,
|
|
417
|
+
allSelectable: Array.from(new Set([...sortedIds, ...sortedAliases]))
|
|
418
|
+
};
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
export default {
|
|
422
|
+
resolveClaudeBinaryPath,
|
|
423
|
+
formatPreEffortChangeCapability,
|
|
424
|
+
inspectClaudeBinaryCapabilities,
|
|
425
|
+
extractClaudeSelectableModelsFromBinary
|
|
426
|
+
};
|