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
|
@@ -729,6 +729,50 @@ export function deriveClaudeCodeVerdictAndActions(state = {}, grid, metrics, opt
|
|
|
729
729
|
});
|
|
730
730
|
}
|
|
731
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
|
+
|
|
732
776
|
if (actions.length === 0) {
|
|
733
777
|
actions.push({
|
|
734
778
|
id: 'keep-coding',
|
|
@@ -1259,10 +1303,19 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1259
1303
|
|
|
1260
1304
|
// Section 3: Circuit Breakers (DET-01..32), Thinking Drift & Prefix Retention
|
|
1261
1305
|
const activeBreakerId =
|
|
1262
|
-
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';
|
|
1263
1316
|
const sec3Lines = [
|
|
1264
1317
|
`[Section 3] Circuit Breakers (DET-01..32), Thinking Drift & Retention`,
|
|
1265
|
-
`Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${
|
|
1318
|
+
`Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${activeBreakerReason})` : 'None (32 guards nominal)'}`,
|
|
1266
1319
|
`Prefix Retention: ${formatRetentionLabel(state.prefixRetention)}`,
|
|
1267
1320
|
`Thinking Drift (DET-30): ${formatDriftLabel(state.thinkingDrift)}`,
|
|
1268
1321
|
`Haiku 100k 5x Cliff (DET-12): ${state.cliffTriggered ? 'EXCEEDED (5x step-up)' : state.preCliffWarningTriggered ? 'PRE-CLIFF WARNING (>= 90k)' : 'Nominal'}`
|
|
@@ -1285,7 +1338,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1285
1338
|
// Section 5: PreCompact State Baton & Session Forensics
|
|
1286
1339
|
const sec5Lines = [
|
|
1287
1340
|
`[Section 5] PreCompact State Baton & Claude Code Forensics`,
|
|
1288
|
-
`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)}`,
|
|
1289
1342
|
`Zoom Tier : ${grid.zoomTier.label} (${grid.zoomTier.tokensPerCell.toLocaleString('en-US')} tok/cell)`,
|
|
1290
1343
|
`State Baton: Auto-flushed on PreCompact to .claude/cache/HANDOFF_LATEST.md`,
|
|
1291
1344
|
`CLI Tools : npx ctxtop statusline | npx ctxtop radar | npx ctxtop inspect | npx ctxtop doctor`
|
|
@@ -1307,7 +1360,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
|
|
|
1307
1360
|
{
|
|
1308
1361
|
sectionNumber: 3,
|
|
1309
1362
|
id: 'circuit-breakers-drift',
|
|
1310
|
-
title: 'Circuit Breakers (DET-01..
|
|
1363
|
+
title: 'Circuit Breakers (DET-01..32), Thinking Drift & Retention',
|
|
1311
1364
|
lines: sec3Lines
|
|
1312
1365
|
},
|
|
1313
1366
|
{
|
|
@@ -1441,15 +1494,16 @@ export function renderStatusLine(state = {}, options = {}) {
|
|
|
1441
1494
|
const rslTok = layoutTier !== 'compact-80' && rslData ? formatRslStatusSegment(rslData) : '';
|
|
1442
1495
|
const rslStr = rslTok ? ` · ${rslTok}` : '';
|
|
1443
1496
|
|
|
1497
|
+
const prefix = options.legacyPrefix ? 'AH' : 'HB';
|
|
1444
1498
|
let p = '';
|
|
1445
1499
|
let a = '';
|
|
1446
1500
|
if (layoutTier === 'compact-80') {
|
|
1447
|
-
p =
|
|
1448
|
-
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}`;
|
|
1449
1503
|
} else {
|
|
1450
1504
|
const shortModel = g.modelId.replace(/^claude-/, '');
|
|
1451
|
-
p =
|
|
1452
|
-
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}`;
|
|
1453
1507
|
}
|
|
1454
1508
|
|
|
1455
1509
|
chosenGrid = g;
|
|
@@ -199,6 +199,23 @@ function scanBinaryMarkersChunked(binPath) {
|
|
|
199
199
|
return foundFlags;
|
|
200
200
|
}
|
|
201
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
|
+
|
|
202
219
|
/**
|
|
203
220
|
* Inspects the installed Claude Code CLI/bundle for `PreModelSwitch` support and contract parity.
|
|
204
221
|
*
|
|
@@ -210,6 +227,7 @@ function scanBinaryMarkersChunked(binPath) {
|
|
|
210
227
|
* preModelSwitchSupported: boolean | null,
|
|
211
228
|
* postModelSwitchSupported: boolean | null,
|
|
212
229
|
* preEffortChangeSupported: boolean | null,
|
|
230
|
+
* preEffortChangeSummary: string | null,
|
|
213
231
|
* supportsAskDecision: boolean | null,
|
|
214
232
|
* sdkSetModelHooked: boolean | null,
|
|
215
233
|
* payloadKeys: { from_model: boolean, to_model: boolean, prompt_cache_warm: boolean, context_tokens: boolean } | null,
|
|
@@ -229,6 +247,7 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
|
229
247
|
preModelSwitchSupported: null,
|
|
230
248
|
postModelSwitchSupported: null,
|
|
231
249
|
preEffortChangeSupported: null,
|
|
250
|
+
preEffortChangeSummary: null,
|
|
232
251
|
supportsAskDecision: null,
|
|
233
252
|
sdkSetModelHooked: null,
|
|
234
253
|
payloadKeys: null,
|
|
@@ -241,7 +260,8 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
|
241
260
|
let stat;
|
|
242
261
|
try {
|
|
243
262
|
stat = fs.statSync(binPath);
|
|
244
|
-
} catch {
|
|
263
|
+
} catch (err) {
|
|
264
|
+
void err;
|
|
245
265
|
return {
|
|
246
266
|
found: false,
|
|
247
267
|
binaryPath: null,
|
|
@@ -249,6 +269,7 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
|
249
269
|
preModelSwitchSupported: null,
|
|
250
270
|
postModelSwitchSupported: null,
|
|
251
271
|
preEffortChangeSupported: null,
|
|
272
|
+
preEffortChangeSummary: null,
|
|
252
273
|
supportsAskDecision: null,
|
|
253
274
|
sdkSetModelHooked: null,
|
|
254
275
|
payloadKeys: null,
|
|
@@ -272,7 +293,12 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
|
272
293
|
cached.result &&
|
|
273
294
|
typeof cached.result.contractValid === 'boolean'
|
|
274
295
|
) {
|
|
275
|
-
return {
|
|
296
|
+
return {
|
|
297
|
+
...cached.result,
|
|
298
|
+
preEffortChangeSummary:
|
|
299
|
+
cached.result.preEffortChangeSummary || formatPreEffortChangeCapability(cached.result),
|
|
300
|
+
cached: true
|
|
301
|
+
};
|
|
276
302
|
}
|
|
277
303
|
}
|
|
278
304
|
|
|
@@ -313,6 +339,9 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
|
|
|
313
339
|
preModelSwitchSupported: markers.preModelSwitchSupported,
|
|
314
340
|
postModelSwitchSupported: markers.postModelSwitchSupported,
|
|
315
341
|
preEffortChangeSupported: markers.preEffortChangeSupported,
|
|
342
|
+
preEffortChangeSummary: formatPreEffortChangeCapability({
|
|
343
|
+
preEffortChangeSupported: markers.preEffortChangeSupported
|
|
344
|
+
}),
|
|
316
345
|
supportsAskDecision,
|
|
317
346
|
sdkSetModelHooked: markers.sdkSetModelHooked,
|
|
318
347
|
payloadKeys,
|
|
@@ -391,6 +420,7 @@ export function extractClaudeSelectableModelsFromBinary(binPath) {
|
|
|
391
420
|
|
|
392
421
|
export default {
|
|
393
422
|
resolveClaudeBinaryPath,
|
|
423
|
+
formatPreEffortChangeCapability,
|
|
394
424
|
inspectClaudeBinaryCapabilities,
|
|
395
425
|
extractClaudeSelectableModelsFromBinary
|
|
396
426
|
};
|
|
@@ -26,6 +26,8 @@ import { auditAntigravityRulesIntegrity } from '../core/layer5_hygiene.mjs';
|
|
|
26
26
|
import { auditClaudeAutoMemory } from '../core/shield_manager.mjs';
|
|
27
27
|
import { auditProseRuleHookCandidates } from '../core/bucket_b_runtime.mjs';
|
|
28
28
|
import { auditWorkspaceRuleClashes } from '../core/rsl_clash_auditor.mjs';
|
|
29
|
+
import { getOffloadIndexStats } from '../core/fts5_output_compressor.mjs';
|
|
30
|
+
import { resolveFastIpcPipePath } from '../engine-node/ipc/fast_client.mjs';
|
|
29
31
|
|
|
30
32
|
/**
|
|
31
33
|
* Redacts the user's OS home directory from any diagnostic string.
|
|
@@ -95,7 +97,7 @@ export function inspectHookDiagnostics(options = {}) {
|
|
|
95
97
|
}
|
|
96
98
|
|
|
97
99
|
/**
|
|
98
|
-
* Runs host contract & runtime diagnostic checks (`npx
|
|
100
|
+
* Runs host contract & runtime diagnostic checks (`npx ctxtop doctor`).
|
|
99
101
|
*
|
|
100
102
|
* @param {object} [options={}]
|
|
101
103
|
* @returns {{
|
|
@@ -273,6 +275,28 @@ export function runDoctorDiagnostics(options = {}) {
|
|
|
273
275
|
memoryRuleIntegrity.ok &&
|
|
274
276
|
(!options.strictClaudeCheck || Boolean(claudeCapabilities.found && claudeCapabilities.contractValid));
|
|
275
277
|
|
|
278
|
+
let offloadIndex = { indexedToolLogs: 0, indexedArtifacts: 0, dbExists: false };
|
|
279
|
+
try {
|
|
280
|
+
offloadIndex = getOffloadIndexStats({
|
|
281
|
+
cwd,
|
|
282
|
+
homeDir: options.homeDir,
|
|
283
|
+
dbPath: options.toolLogsDbPath || null
|
|
284
|
+
});
|
|
285
|
+
} catch (offloadErr) {
|
|
286
|
+
void offloadErr;
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
let ipcFastPath = { pipePath: '', socketPresent: null };
|
|
290
|
+
try {
|
|
291
|
+
const pipePath = resolveFastIpcPipePath({ homeDir: options.homeDir });
|
|
292
|
+
ipcFastPath = {
|
|
293
|
+
pipePath: redactDoctorPaths(pipePath, options.homeDir),
|
|
294
|
+
socketPresent: pipePath.startsWith('\\\\.\\pipe\\') ? null : fs.existsSync(pipePath)
|
|
295
|
+
};
|
|
296
|
+
} catch (ipcErr) {
|
|
297
|
+
void ipcErr;
|
|
298
|
+
}
|
|
299
|
+
|
|
276
300
|
return {
|
|
277
301
|
ok,
|
|
278
302
|
nodeVersion,
|
|
@@ -284,7 +308,9 @@ export function runDoctorDiagnostics(options = {}) {
|
|
|
284
308
|
memoryRuleIntegrity,
|
|
285
309
|
proseHookCandidates,
|
|
286
310
|
rslRuleClashes: rslClashAudit.clashCount,
|
|
287
|
-
rslClashes: rslClashAudit.clashes.slice(0, 5)
|
|
311
|
+
rslClashes: rslClashAudit.clashes.slice(0, 5),
|
|
312
|
+
offloadIndex,
|
|
313
|
+
ipcFastPath
|
|
288
314
|
};
|
|
289
315
|
}
|
|
290
316
|
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/engine-node/ipc/fast_client.mjs
|
|
3
|
+
* Minimal zero-heavy-dependency JSON-RPC client for warm Horizon Daemon IPC checks.
|
|
4
|
+
*
|
|
5
|
+
* Imports strictly Node built-ins (`node:fs`, `node:path`, `node:os`, `node:net`) so
|
|
6
|
+
* thin Tier-2 CLI hook shells avoid loading heavyweight ESM trees when probing or
|
|
7
|
+
* dispatching directly over the warm daemon socket/pipe.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import fs from 'node:fs';
|
|
11
|
+
import path from 'node:path';
|
|
12
|
+
import os from 'node:os';
|
|
13
|
+
import net from 'node:net';
|
|
14
|
+
|
|
15
|
+
function normalizeHomePath(raw = '') {
|
|
16
|
+
return String(raw || '')
|
|
17
|
+
.trim()
|
|
18
|
+
.replace(/\\/g, '/')
|
|
19
|
+
.replace(/\/+$/, '');
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Ensures tests that isolate `HOME`/`USERPROFILE` to temporary sandboxes never
|
|
24
|
+
* auto-connect to a developer's live host daemon pipe unless `CTXTOP_IPC_PATH`
|
|
25
|
+
* is explicitly specified.
|
|
26
|
+
*
|
|
27
|
+
* @param {object} [env=process.env]
|
|
28
|
+
* @returns {boolean}
|
|
29
|
+
*/
|
|
30
|
+
export function isRealHostHomeEnv(env = process.env) {
|
|
31
|
+
if (env && typeof env.CTXTOP_IPC_PATH === 'string' && env.CTXTOP_IPC_PATH.trim()) {
|
|
32
|
+
return true;
|
|
33
|
+
}
|
|
34
|
+
const envHome = normalizeHomePath(env?.USERPROFILE || env?.HOME || '');
|
|
35
|
+
if (!envHome) return true;
|
|
36
|
+
let realHome = '';
|
|
37
|
+
try {
|
|
38
|
+
realHome = normalizeHomePath(os.userInfo()?.homedir || '');
|
|
39
|
+
} catch (err) {
|
|
40
|
+
void err;
|
|
41
|
+
return true;
|
|
42
|
+
}
|
|
43
|
+
if (!realHome) return true;
|
|
44
|
+
if (process.platform === 'win32') {
|
|
45
|
+
return envHome.toLowerCase() === realHome.toLowerCase();
|
|
46
|
+
}
|
|
47
|
+
return envHome === realHome;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Mirrors `resolveIpcPath` from `src/engine-node/ipc/protocol.mjs` without loading it.
|
|
52
|
+
*
|
|
53
|
+
* @param {object} [options={}]
|
|
54
|
+
* @returns {string | null}
|
|
55
|
+
*/
|
|
56
|
+
export function resolveFastIpcPipePath(options = {}) {
|
|
57
|
+
if (options.ipcPath || process.env.CTXTOP_IPC_PATH) {
|
|
58
|
+
return options.ipcPath || process.env.CTXTOP_IPC_PATH;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
if (process.platform === 'win32') {
|
|
62
|
+
let rawUser = process.env.USERNAME || process.env.USER;
|
|
63
|
+
if (!rawUser) {
|
|
64
|
+
try {
|
|
65
|
+
rawUser = typeof os.userInfo === 'function' ? os.userInfo()?.username : null;
|
|
66
|
+
} catch (err) {
|
|
67
|
+
void err;
|
|
68
|
+
rawUser = null;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
const cleanUser = String(rawUser || 'default').replace(/[^a-zA-Z0-9_-]/g, '_');
|
|
72
|
+
return `\\\\.\\pipe\\ctxtop-${cleanUser}`;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const homeDir = options.homeDir || process.env.HOME || os.homedir() || '/tmp';
|
|
76
|
+
return path.join(homeDir, '.ctxtop', 'daemon.sock');
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Attempts a single fast JSON-RPC call to the warm Horizon Daemon pipe.
|
|
81
|
+
* Returns `parsed.result` strictly when `result?.fullVerdict === true`, otherwise `null`.
|
|
82
|
+
* Never writes to stderr and never throws.
|
|
83
|
+
*
|
|
84
|
+
* @param {string} method
|
|
85
|
+
* @param {object} [params={}]
|
|
86
|
+
* @param {object} [options={}]
|
|
87
|
+
* @returns {Promise<object | null>}
|
|
88
|
+
*/
|
|
89
|
+
export function tryFastDaemonRpc(method, params = {}, options = {}) {
|
|
90
|
+
if (!options.ipcPath && !process.env.CTXTOP_IPC_PATH && !isRealHostHomeEnv()) {
|
|
91
|
+
return Promise.resolve(null);
|
|
92
|
+
}
|
|
93
|
+
const pipePath = resolveFastIpcPipePath(options);
|
|
94
|
+
if (!pipePath || (process.platform !== 'win32' && !fs.existsSync(pipePath))) {
|
|
95
|
+
return Promise.resolve(null);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const connectTimeoutMs = Math.max(1, Number(options.connectTimeoutMs ?? 12));
|
|
99
|
+
const requestTimeoutMs = Math.max(20, Number(options.requestTimeoutMs ?? 5000));
|
|
100
|
+
|
|
101
|
+
return new Promise((resolve) => {
|
|
102
|
+
let settled = false;
|
|
103
|
+
let connected = false;
|
|
104
|
+
let socket = null;
|
|
105
|
+
let connectTimer = null;
|
|
106
|
+
let requestTimer = null;
|
|
107
|
+
let buffer = '';
|
|
108
|
+
|
|
109
|
+
const settle = (val) => {
|
|
110
|
+
if (settled) return;
|
|
111
|
+
settled = true;
|
|
112
|
+
if (connectTimer) {
|
|
113
|
+
clearTimeout(connectTimer);
|
|
114
|
+
connectTimer = null;
|
|
115
|
+
}
|
|
116
|
+
if (requestTimer) {
|
|
117
|
+
clearTimeout(requestTimer);
|
|
118
|
+
requestTimer = null;
|
|
119
|
+
}
|
|
120
|
+
if (socket) {
|
|
121
|
+
try {
|
|
122
|
+
socket.removeAllListeners();
|
|
123
|
+
socket.destroy();
|
|
124
|
+
} catch (cleanupErr) {
|
|
125
|
+
void cleanupErr;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
resolve(val);
|
|
129
|
+
};
|
|
130
|
+
|
|
131
|
+
try {
|
|
132
|
+
socket = net.connect(pipePath);
|
|
133
|
+
} catch (connErr) {
|
|
134
|
+
void connErr;
|
|
135
|
+
settle(null);
|
|
136
|
+
return;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
connectTimer = setTimeout(() => {
|
|
140
|
+
if (!connected) settle(null);
|
|
141
|
+
}, connectTimeoutMs);
|
|
142
|
+
|
|
143
|
+
requestTimer = setTimeout(() => {
|
|
144
|
+
settle(null);
|
|
145
|
+
}, requestTimeoutMs);
|
|
146
|
+
|
|
147
|
+
socket.once('connect', () => {
|
|
148
|
+
connected = true;
|
|
149
|
+
if (connectTimer) {
|
|
150
|
+
clearTimeout(connectTimer);
|
|
151
|
+
connectTimer = null;
|
|
152
|
+
}
|
|
153
|
+
try {
|
|
154
|
+
const frame = JSON.stringify({ jsonrpc: '2.0', id: 1, method: String(method), params }) + '\n';
|
|
155
|
+
socket.write(frame);
|
|
156
|
+
} catch (writeErr) {
|
|
157
|
+
void writeErr;
|
|
158
|
+
settle(null);
|
|
159
|
+
}
|
|
160
|
+
});
|
|
161
|
+
|
|
162
|
+
socket.on('data', (chunk) => {
|
|
163
|
+
buffer += chunk.toString('utf8');
|
|
164
|
+
if (buffer.length > 2 * 1024 * 1024) {
|
|
165
|
+
settle(null);
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
const nlIdx = buffer.indexOf('\n');
|
|
169
|
+
if (nlIdx === -1) return;
|
|
170
|
+
const line = buffer.slice(0, nlIdx).trim();
|
|
171
|
+
if (!line) {
|
|
172
|
+
buffer = buffer.slice(nlIdx + 1);
|
|
173
|
+
return;
|
|
174
|
+
}
|
|
175
|
+
try {
|
|
176
|
+
const parsed = JSON.parse(line);
|
|
177
|
+
if (parsed && !parsed.error && parsed.result && parsed.result.fullVerdict === true) {
|
|
178
|
+
settle(parsed.result);
|
|
179
|
+
} else {
|
|
180
|
+
settle(null);
|
|
181
|
+
}
|
|
182
|
+
} catch (parseErr) {
|
|
183
|
+
void parseErr;
|
|
184
|
+
settle(null);
|
|
185
|
+
}
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
socket.once('error', () => settle(null));
|
|
189
|
+
socket.once('close', () => settle(null));
|
|
190
|
+
});
|
|
191
|
+
}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core/shared/multi_host_mcp.mjs
|
|
3
|
+
* Zero-network idempotent MCP client configuration installer for multi-host parity
|
|
4
|
+
* across Cursor, Windsurf, OpenAI Codex CLI, Gemini CLI, and generic `.mcp.json` hosts.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import fs from 'node:fs';
|
|
8
|
+
import path from 'node:path';
|
|
9
|
+
import os from 'node:os';
|
|
10
|
+
|
|
11
|
+
export const SUPPORTED_MCP_HOSTS = Object.freeze([
|
|
12
|
+
'cursor',
|
|
13
|
+
'windsurf',
|
|
14
|
+
'codex',
|
|
15
|
+
'gemini-cli',
|
|
16
|
+
'generic'
|
|
17
|
+
]);
|
|
18
|
+
|
|
19
|
+
const CODEX_TOML_SNIPPET = [
|
|
20
|
+
'[mcp_servers.highbeam]',
|
|
21
|
+
'command = "npx"',
|
|
22
|
+
'args = ["-y", "ctxtop", "mcp"]'
|
|
23
|
+
].join('\n');
|
|
24
|
+
|
|
25
|
+
function resolveHome(options = {}) {
|
|
26
|
+
return (
|
|
27
|
+
options.homeDir ||
|
|
28
|
+
options.home ||
|
|
29
|
+
process.env.USERPROFILE ||
|
|
30
|
+
process.env.HOME ||
|
|
31
|
+
os.homedir()
|
|
32
|
+
);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function readJsonObjectSafe(filePath) {
|
|
36
|
+
if (!fs.existsSync(filePath)) return {};
|
|
37
|
+
try {
|
|
38
|
+
const raw = fs.readFileSync(filePath, 'utf8').trim();
|
|
39
|
+
if (!raw) return {};
|
|
40
|
+
const parsed = JSON.parse(raw);
|
|
41
|
+
if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
|
|
42
|
+
return parsed;
|
|
43
|
+
}
|
|
44
|
+
} catch (err) {
|
|
45
|
+
void err;
|
|
46
|
+
}
|
|
47
|
+
return {};
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function writeJsonAtomicSafe(filePath, obj) {
|
|
51
|
+
const dir = path.dirname(filePath);
|
|
52
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
53
|
+
const tmpPath = path.join(dir, `.${path.basename(filePath)}.tmp.${process.pid}`);
|
|
54
|
+
fs.writeFileSync(tmpPath, JSON.stringify(obj, null, 2) + '\n', 'utf8');
|
|
55
|
+
fs.renameSync(tmpPath, filePath);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function normalizeMcpHostName(rawHost = '') {
|
|
59
|
+
const cleaned = String(rawHost || '').trim().toLowerCase();
|
|
60
|
+
if (cleaned === 'gemini' || cleaned === 'gemini-cli') return 'gemini-cli';
|
|
61
|
+
if (cleaned === 'mcp' || cleaned === 'generic') return 'generic';
|
|
62
|
+
if (SUPPORTED_MCP_HOSTS.includes(cleaned)) return cleaned;
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Resolves the MCP config path for a supported AI host.
|
|
68
|
+
* Strictly avoids auth credential files such as `oauth_creds.json`.
|
|
69
|
+
*/
|
|
70
|
+
export function resolveHostMcpConfigPath(host, { cwd = process.cwd(), homeDir, global = false } = {}) {
|
|
71
|
+
const normalized = normalizeMcpHostName(host) || 'generic';
|
|
72
|
+
const home = resolveHome({ homeDir });
|
|
73
|
+
const workspaceRoot = path.resolve(cwd);
|
|
74
|
+
|
|
75
|
+
if (normalized === 'cursor') {
|
|
76
|
+
return global
|
|
77
|
+
? path.join(home, '.cursor', 'mcp.json')
|
|
78
|
+
: path.join(workspaceRoot, '.cursor', 'mcp.json');
|
|
79
|
+
}
|
|
80
|
+
if (normalized === 'windsurf') {
|
|
81
|
+
return global
|
|
82
|
+
? path.join(home, '.codeium', 'windsurf', 'mcp_config.json')
|
|
83
|
+
: path.join(workspaceRoot, '.windsurf', 'mcp.json');
|
|
84
|
+
}
|
|
85
|
+
if (normalized === 'gemini-cli') {
|
|
86
|
+
return global
|
|
87
|
+
? path.join(home, '.gemini', 'settings.json')
|
|
88
|
+
: path.join(workspaceRoot, '.gemini', 'settings.json');
|
|
89
|
+
}
|
|
90
|
+
if (normalized === 'codex') {
|
|
91
|
+
return global
|
|
92
|
+
? path.join(home, '.codex', 'mcp.json')
|
|
93
|
+
: path.join(workspaceRoot, '.codex', 'mcp.json');
|
|
94
|
+
}
|
|
95
|
+
return path.join(workspaceRoot, '.mcp.json');
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Idempotently installs `{ command: 'npx', args: ['-y', 'ctxtop', 'mcp'] }` under `mcpServers.highbeam`
|
|
100
|
+
* while preserving all existing host settings and third-party MCP servers.
|
|
101
|
+
*/
|
|
102
|
+
export function installHostMcpConfig({
|
|
103
|
+
hosts = ['generic'],
|
|
104
|
+
cwd = process.cwd(),
|
|
105
|
+
homeDir,
|
|
106
|
+
global = false,
|
|
107
|
+
dryRun = false,
|
|
108
|
+
useLocalServer = false,
|
|
109
|
+
serverScriptPath = ''
|
|
110
|
+
} = {}) {
|
|
111
|
+
const resolvedHome = resolveHome({ homeDir });
|
|
112
|
+
const uniqueHosts = Array.from(
|
|
113
|
+
new Set(
|
|
114
|
+
(Array.isArray(hosts) ? hosts : [hosts])
|
|
115
|
+
.map((h) => normalizeMcpHostName(h))
|
|
116
|
+
.filter(Boolean)
|
|
117
|
+
)
|
|
118
|
+
);
|
|
119
|
+
if (uniqueHosts.length === 0) uniqueHosts.push('generic');
|
|
120
|
+
|
|
121
|
+
const serverEntry =
|
|
122
|
+
useLocalServer && serverScriptPath
|
|
123
|
+
? { command: 'node', args: [serverScriptPath] }
|
|
124
|
+
: { command: 'npx', args: ['-y', 'ctxtop', 'mcp'] };
|
|
125
|
+
|
|
126
|
+
const results = [];
|
|
127
|
+
for (const host of uniqueHosts) {
|
|
128
|
+
const configPath = resolveHostMcpConfigPath(host, {
|
|
129
|
+
cwd,
|
|
130
|
+
homeDir: resolvedHome,
|
|
131
|
+
global
|
|
132
|
+
});
|
|
133
|
+
const existing = readJsonObjectSafe(configPath);
|
|
134
|
+
const prevServers =
|
|
135
|
+
existing.mcpServers && typeof existing.mcpServers === 'object' && !Array.isArray(existing.mcpServers)
|
|
136
|
+
? { ...existing.mcpServers }
|
|
137
|
+
: {};
|
|
138
|
+
prevServers.highbeam = { ...serverEntry };
|
|
139
|
+
|
|
140
|
+
const updated = {
|
|
141
|
+
...existing,
|
|
142
|
+
mcpServers: prevServers
|
|
143
|
+
};
|
|
144
|
+
|
|
145
|
+
if (!dryRun) {
|
|
146
|
+
writeJsonAtomicSafe(configPath, updated);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
const codexTomlExists =
|
|
150
|
+
host === 'codex' && fs.existsSync(path.join(resolvedHome, '.codex', 'config.toml'));
|
|
151
|
+
results.push({
|
|
152
|
+
ok: true,
|
|
153
|
+
host,
|
|
154
|
+
serverKey: 'highbeam',
|
|
155
|
+
configPath,
|
|
156
|
+
dryRun: Boolean(dryRun),
|
|
157
|
+
entry: serverEntry,
|
|
158
|
+
...(codexTomlExists ? { tomlSnippet: CODEX_TOML_SNIPPET } : {})
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
return {
|
|
163
|
+
ok: results.every((r) => r.ok),
|
|
164
|
+
dryRun: Boolean(dryRun),
|
|
165
|
+
hosts: uniqueHosts,
|
|
166
|
+
results
|
|
167
|
+
};
|
|
168
|
+
}
|
|
@@ -14,7 +14,10 @@ import {
|
|
|
14
14
|
sanitizeRslSessionId,
|
|
15
15
|
snapshotTestSuiteBaseline,
|
|
16
16
|
recordStepOutcome,
|
|
17
|
-
buildContrastiveDigest
|
|
17
|
+
buildContrastiveDigest,
|
|
18
|
+
RSL_ANTIGRAVITY_POST_TOOL_MATCHER,
|
|
19
|
+
isMutatingOrExecRslTool,
|
|
20
|
+
isDuplicateRslStepEvent
|
|
18
21
|
} from '../core/rsl_triage.mjs';
|
|
19
22
|
import { distillContrastiveDigest } from '../core/rsl_distiller.mjs';
|
|
20
23
|
import {
|
|
@@ -135,6 +138,25 @@ export function handleAntigravityRslHook(payload = {}, options = {}) {
|
|
|
135
138
|
}
|
|
136
139
|
|
|
137
140
|
if (event === 'PostToolUse') {
|
|
141
|
+
const toolName = String(
|
|
142
|
+
payload?.toolCall?.name || payload?.tool_name || payload?.toolName || ''
|
|
143
|
+
).trim();
|
|
144
|
+
if (toolName && !isMutatingOrExecRslTool(toolName)) {
|
|
145
|
+
return {
|
|
146
|
+
exitCode: 0,
|
|
147
|
+
stdoutJson: {},
|
|
148
|
+
event,
|
|
149
|
+
skippedReason: 'read_only_tool'
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
if (isDuplicateRslStepEvent(payload, { ...options, platform: 'antigravity' })) {
|
|
153
|
+
return {
|
|
154
|
+
exitCode: 0,
|
|
155
|
+
stdoutJson: {},
|
|
156
|
+
event,
|
|
157
|
+
deduplicated: true
|
|
158
|
+
};
|
|
159
|
+
}
|
|
138
160
|
const recorded = recordStepOutcome(payload, { ...options, platform: 'antigravity' });
|
|
139
161
|
return {
|
|
140
162
|
exitCode: 0,
|
|
@@ -217,7 +239,7 @@ export function syncAntigravityWorkspaceRslHooks(workspaceRoot, options = {}) {
|
|
|
217
239
|
],
|
|
218
240
|
PostToolUse: [
|
|
219
241
|
{
|
|
220
|
-
matcher:
|
|
242
|
+
matcher: RSL_ANTIGRAVITY_POST_TOOL_MATCHER,
|
|
221
243
|
hooks: [
|
|
222
244
|
{ type: 'command', command: `node "${hookScript}" --event=PostToolUse`, timeout: 5 }
|
|
223
245
|
]
|