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
package/bin/ctxtop.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
3
|
* @file bin/ctxtop.mjs
|
|
4
|
-
* Highbeam v4.
|
|
4
|
+
* Highbeam v4.1.1 Unified Cross-Platform CLI (`ctxtop`).
|
|
5
5
|
*
|
|
6
6
|
* Commands:
|
|
7
7
|
* - `ctxtop init [--antigravity | --claude | --all | --workspace | --project | --dry-run | --dedupe]`
|
|
@@ -70,6 +70,7 @@ import {
|
|
|
70
70
|
verifyProLicenseKey,
|
|
71
71
|
PLG_TIER_MATRIX
|
|
72
72
|
} from '../src/core/pro_license.mjs';
|
|
73
|
+
import { getShadowAutoSummary } from '../src/core/shadow_auto_ledger.mjs';
|
|
73
74
|
import { generateTeamFinopsPack } from '../packages/pro/src/team_finops_pack.mjs';
|
|
74
75
|
import {
|
|
75
76
|
computeSwarmSummary,
|
|
@@ -94,8 +95,34 @@ import {
|
|
|
94
95
|
inspectHookDiagnostics,
|
|
95
96
|
runDoctorDiagnostics
|
|
96
97
|
} from '../src/diagnostics/doctorEngine.mjs';
|
|
97
|
-
import {
|
|
98
|
+
import {
|
|
99
|
+
formatPreEffortChangeCapability,
|
|
100
|
+
inspectClaudeBinaryCapabilities
|
|
101
|
+
} from '../src/diagnostics/claudeHookCapabilities.mjs';
|
|
102
|
+
import { installPlugin, runLiveOrDemoCli, openBrowserUrl } from '../src/cli/init.mjs';
|
|
98
103
|
import { executeStatusLineBridge, runStatusLineCli } from './ah-statusline.mjs';
|
|
104
|
+
import { runSessionAudit, formatSessionAuditReport } from '../src/core/session_auditor.mjs';
|
|
105
|
+
import { configureShield, getShieldStatus } from '../src/core/shield_manager.mjs';
|
|
106
|
+
import { buildContrastiveDigest, sanitizeRslSessionId } from '../src/core/rsl_triage.mjs';
|
|
107
|
+
import { distillContrastiveDigest } from '../src/core/rsl_distiller.mjs';
|
|
108
|
+
import {
|
|
109
|
+
getRslLedgerPath,
|
|
110
|
+
getRslSummary,
|
|
111
|
+
ingestDistilledHeuristics,
|
|
112
|
+
promoteHeuristic,
|
|
113
|
+
pruneHeuristic,
|
|
114
|
+
auditWorkspaceRuleClashes,
|
|
115
|
+
buildConsolidatedSpecMarkdown
|
|
116
|
+
} from '../src/core/rsl_ledger.mjs';
|
|
117
|
+
import {
|
|
118
|
+
searchOffloadedContextFts5,
|
|
119
|
+
getOffloadIndexStats
|
|
120
|
+
} from '../src/core/fts5_output_compressor.mjs';
|
|
121
|
+
import {
|
|
122
|
+
SUPPORTED_MCP_HOSTS,
|
|
123
|
+
installHostMcpConfig
|
|
124
|
+
} from '../src/engine-node/multi_host_mcp.mjs';
|
|
125
|
+
import { resolveFastIpcPipePath } from '../src/engine-node/ipc/fast_client.mjs';
|
|
99
126
|
|
|
100
127
|
export { inspectHookDiagnostics, runDoctorDiagnostics };
|
|
101
128
|
|
|
@@ -113,7 +140,7 @@ export const LEAN_POST_TOOL_USE_MATCHER =
|
|
|
113
140
|
'Bash|PowerShell|Task|Agent|WebFetch|mcp__.*';
|
|
114
141
|
|
|
115
142
|
const AH_HANDLER_REGEX =
|
|
116
|
-
/hooks[\\/]handlers[\\/](pre-tool-use|post-tool-use|pre-model-switch|compact-lifecycle|stop-gate)\.mjs/i;
|
|
143
|
+
/hooks[\\/]handlers[\\/](pre-tool-use|post-tool-use|pre-model-switch|post-model-switch|compact-lifecycle|stop-gate|user-prompt-submit|config-change)\.mjs/i;
|
|
117
144
|
const AH_STATUSLINE_REGEX = /ah-statusline\.mjs/i;
|
|
118
145
|
const AH_MOD_REGISTER_REGEX = /(?:^|[\\/])hooks[\\/]register\.js$|^\.\/register\.js$/i;
|
|
119
146
|
|
|
@@ -155,6 +182,7 @@ export function buildCanonicalAhHooks(options = {}) {
|
|
|
155
182
|
const handlerPrefix = `${rootPrefix}/hooks/handlers`;
|
|
156
183
|
const preMatcher = options.leanHooks ? LEAN_PRE_TOOL_USE_MATCHER : PRE_TOOL_USE_MATCHER;
|
|
157
184
|
const postMatcher = options.leanHooks ? LEAN_POST_TOOL_USE_MATCHER : POST_TOOL_USE_MATCHER;
|
|
185
|
+
const includePostModelSwitch = options.includePostModelSwitch !== false;
|
|
158
186
|
|
|
159
187
|
return {
|
|
160
188
|
PreToolUse: [
|
|
@@ -189,6 +217,20 @@ export function buildCanonicalAhHooks(options = {}) {
|
|
|
189
217
|
]
|
|
190
218
|
}
|
|
191
219
|
],
|
|
220
|
+
...(includePostModelSwitch
|
|
221
|
+
? {
|
|
222
|
+
PostModelSwitch: [
|
|
223
|
+
{
|
|
224
|
+
hooks: [
|
|
225
|
+
{
|
|
226
|
+
type: 'command',
|
|
227
|
+
command: `node "${handlerPrefix}/post-model-switch.mjs"`
|
|
228
|
+
}
|
|
229
|
+
]
|
|
230
|
+
}
|
|
231
|
+
]
|
|
232
|
+
}
|
|
233
|
+
: {}),
|
|
192
234
|
PreCompact: [
|
|
193
235
|
{
|
|
194
236
|
hooks: [
|
|
@@ -229,6 +271,46 @@ export function buildCanonicalAhHooks(options = {}) {
|
|
|
229
271
|
}
|
|
230
272
|
]
|
|
231
273
|
}
|
|
274
|
+
],
|
|
275
|
+
UserPromptSubmit: [
|
|
276
|
+
{
|
|
277
|
+
hooks: [
|
|
278
|
+
{
|
|
279
|
+
type: 'command',
|
|
280
|
+
command: `node "${handlerPrefix}/user-prompt-submit.mjs"`
|
|
281
|
+
}
|
|
282
|
+
]
|
|
283
|
+
}
|
|
284
|
+
],
|
|
285
|
+
ConfigChange: [
|
|
286
|
+
{
|
|
287
|
+
hooks: [
|
|
288
|
+
{
|
|
289
|
+
type: 'command',
|
|
290
|
+
command: `node "${handlerPrefix}/config-change.mjs"`
|
|
291
|
+
}
|
|
292
|
+
]
|
|
293
|
+
}
|
|
294
|
+
],
|
|
295
|
+
InstructionsLoaded: [
|
|
296
|
+
{
|
|
297
|
+
hooks: [
|
|
298
|
+
{
|
|
299
|
+
type: 'command',
|
|
300
|
+
command: `node "${handlerPrefix}/compact-lifecycle.mjs" --phase=instructions`
|
|
301
|
+
}
|
|
302
|
+
]
|
|
303
|
+
}
|
|
304
|
+
],
|
|
305
|
+
SessionEnd: [
|
|
306
|
+
{
|
|
307
|
+
hooks: [
|
|
308
|
+
{
|
|
309
|
+
type: 'command',
|
|
310
|
+
command: `node "${handlerPrefix}/stop-gate.mjs" --phase=end`
|
|
311
|
+
}
|
|
312
|
+
]
|
|
313
|
+
}
|
|
232
314
|
]
|
|
233
315
|
};
|
|
234
316
|
}
|
|
@@ -330,10 +412,30 @@ export function installAttentionHorizon(options = {}) {
|
|
|
330
412
|
|
|
331
413
|
const useLeanHooks =
|
|
332
414
|
options.leanHooks !== undefined ? Boolean(options.leanHooks) : !Boolean(options.fullHooks);
|
|
415
|
+
let includePostModelSwitch =
|
|
416
|
+
options.includePostModelSwitch !== undefined ? Boolean(options.includePostModelSwitch) : true;
|
|
417
|
+
const omittedUnsupportedHooks = [];
|
|
418
|
+
if (
|
|
419
|
+
options.includePostModelSwitch === undefined &&
|
|
420
|
+
options.checkBinaryCapabilities !== false
|
|
421
|
+
) {
|
|
422
|
+
const caps = inspectClaudeBinaryCapabilities({
|
|
423
|
+
...options,
|
|
424
|
+
cwd,
|
|
425
|
+
probeVersion: false,
|
|
426
|
+
recordDiagnostic: false,
|
|
427
|
+
writeCache: false
|
|
428
|
+
});
|
|
429
|
+
if (caps.found === true && caps.postModelSwitchSupported === false) {
|
|
430
|
+
includePostModelSwitch = false;
|
|
431
|
+
omittedUnsupportedHooks.push('PostModelSwitch');
|
|
432
|
+
}
|
|
433
|
+
}
|
|
333
434
|
const canonicalHooks = buildCanonicalAhHooks({
|
|
334
435
|
usePluginRootVar: false,
|
|
335
436
|
pkgRoot,
|
|
336
|
-
leanHooks: useLeanHooks
|
|
437
|
+
leanHooks: useLeanHooks,
|
|
438
|
+
includePostModelSwitch
|
|
337
439
|
});
|
|
338
440
|
for (const [eventName, ahEntries] of Object.entries(canonicalHooks)) {
|
|
339
441
|
const existingList = Array.isArray(currentSettings.hooks[eventName])
|
|
@@ -395,6 +497,7 @@ export function installAttentionHorizon(options = {}) {
|
|
|
395
497
|
settingsPath,
|
|
396
498
|
backupPath,
|
|
397
499
|
gitExcludeUpdated: gitExclude.updated,
|
|
500
|
+
omittedUnsupportedHooks,
|
|
398
501
|
settings: currentSettings
|
|
399
502
|
};
|
|
400
503
|
}
|
|
@@ -505,11 +608,11 @@ export function generateRoastCard(options = {}) {
|
|
|
505
608
|
`│ Verified Savings : +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD saved in 30d) │`,
|
|
506
609
|
'│ Top Remediation : Fence mid-session CLAUDE.md/AGENTS.md edits (DET-09) │',
|
|
507
610
|
'╰────────────────────────────────────────────────────────────────────────────╯',
|
|
508
|
-
`Share: Shielded +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)}) with npx
|
|
611
|
+
`Share: Shielded +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)}) with npx ctxtop --roast #ClaudeCode #Antigravity`
|
|
509
612
|
].join('\n');
|
|
510
613
|
|
|
511
614
|
const markdown = [
|
|
512
|
-
'### 🔥 Highbeam Context Roast (`npx
|
|
615
|
+
'### 🔥 Highbeam Context Roast (`npx ctxtop --roast`)',
|
|
513
616
|
`- **KV-Cache Retention**: Grade **${retentionGrade}** (${retentionPct}% warmth retained)`,
|
|
514
617
|
`- **Cold Prefill Leak**: **$${leakedUsd.toFixed(2)}** burned on avoidable cold switches`,
|
|
515
618
|
`- **30-Day Verified Savings**: **+${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD)**`,
|
|
@@ -640,15 +743,28 @@ export function installMcpConfig(options = {}) {
|
|
|
640
743
|
}
|
|
641
744
|
|
|
642
745
|
export function executeInitSubcommand(args = [], options = {}) {
|
|
643
|
-
const
|
|
644
|
-
const
|
|
645
|
-
const
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
746
|
+
const isAllHosts = args.includes('--all-hosts') || Boolean(options.allHosts);
|
|
747
|
+
const isAntigravity = args.includes('--antigravity') || args.includes('-a') || isAllHosts;
|
|
748
|
+
const isClaude = args.includes('--claude') || args.includes('-c') || isAllHosts;
|
|
749
|
+
const isLegacyMcp = args.includes('--mcp') || Boolean(options.mcp);
|
|
750
|
+
|
|
751
|
+
const selectedMcpHosts = [];
|
|
752
|
+
if (args.includes('--cursor') || Boolean(options.cursor)) selectedMcpHosts.push('cursor');
|
|
753
|
+
if (args.includes('--windsurf') || Boolean(options.windsurf)) selectedMcpHosts.push('windsurf');
|
|
754
|
+
if (args.includes('--codex') || Boolean(options.codex)) selectedMcpHosts.push('codex');
|
|
755
|
+
if (args.includes('--gemini-cli') || args.includes('--gemini') || Boolean(options.geminiCli)) {
|
|
756
|
+
selectedMcpHosts.push('gemini-cli');
|
|
757
|
+
}
|
|
758
|
+
if (isAllHosts) {
|
|
759
|
+
for (const h of SUPPORTED_MCP_HOSTS) {
|
|
760
|
+
if (!selectedMcpHosts.includes(h)) selectedMcpHosts.push(h);
|
|
761
|
+
}
|
|
762
|
+
} else if (isLegacyMcp && selectedMcpHosts.length === 0) {
|
|
763
|
+
// Also ensure --mcp works cleanly alongside legacy .cursor/mcp.json contract
|
|
764
|
+
}
|
|
765
|
+
|
|
766
|
+
const hasMcpTarget = isLegacyMcp || selectedMcpHosts.length > 0;
|
|
767
|
+
const isAll = args.includes('--all') || (!isAntigravity && !isClaude && !hasMcpTarget);
|
|
652
768
|
const isDryRun = args.includes('--dry-run') || Boolean(options.dryRun);
|
|
653
769
|
const isWorkspace = args.includes('--workspace') || args.includes('--project') || Boolean(options.workspace);
|
|
654
770
|
const isGlobal = args.includes('--global') || Boolean(options.global);
|
|
@@ -659,12 +775,13 @@ export function executeInitSubcommand(args = [], options = {}) {
|
|
|
659
775
|
const targetParts = [];
|
|
660
776
|
if (isAll || isAntigravity) targetParts.push('Google Antigravity');
|
|
661
777
|
if (isAll || isClaude) targetParts.push('Claude Code');
|
|
662
|
-
if (
|
|
778
|
+
if (isLegacyMcp) targetParts.push('MCP (.cursor/mcp.json)');
|
|
779
|
+
if (selectedMcpHosts.length > 0) targetParts.push(`MCP (${selectedMcpHosts.join(', ')})`);
|
|
663
780
|
const targetLabel =
|
|
664
|
-
targetParts.length === 2 && !
|
|
781
|
+
targetParts.length === 2 && !hasMcpTarget ? targetParts.join(' & ') : targetParts.join(', ');
|
|
665
782
|
|
|
666
783
|
const lines = [
|
|
667
|
-
`\x1b[1m\x1b[38;5;51m⚡ Highbeam (ctxtop v4.
|
|
784
|
+
`\x1b[1m\x1b[38;5;51m⚡ Highbeam (ctxtop v4.1.1) — Zero-Config Unified Installer\x1b[0m`,
|
|
668
785
|
` • Target Harnesses : ${targetLabel}`,
|
|
669
786
|
` • Installation Scope: ${isWorkspace ? 'Workspace' : 'Global'}${isDryRun ? ' [DRY RUN]' : ''}`
|
|
670
787
|
];
|
|
@@ -672,6 +789,7 @@ export function executeInitSubcommand(args = [], options = {}) {
|
|
|
672
789
|
let claudeResult = null;
|
|
673
790
|
let antigravityResult = null;
|
|
674
791
|
let mcpResult = null;
|
|
792
|
+
let hostMcpResult = null;
|
|
675
793
|
|
|
676
794
|
if (isClaude || isAll) {
|
|
677
795
|
const scope = isGlobal ? 'global' : 'project';
|
|
@@ -713,7 +831,7 @@ export function executeInitSubcommand(args = [], options = {}) {
|
|
|
713
831
|
}
|
|
714
832
|
}
|
|
715
833
|
|
|
716
|
-
if (
|
|
834
|
+
if (isLegacyMcp) {
|
|
717
835
|
mcpResult = installMcpConfig({
|
|
718
836
|
...options,
|
|
719
837
|
global: isGlobal,
|
|
@@ -725,28 +843,112 @@ export function executeInitSubcommand(args = [], options = {}) {
|
|
|
725
843
|
);
|
|
726
844
|
}
|
|
727
845
|
|
|
846
|
+
if (selectedMcpHosts.length > 0) {
|
|
847
|
+
hostMcpResult = installHostMcpConfig({
|
|
848
|
+
hosts: selectedMcpHosts,
|
|
849
|
+
cwd: options.cwd || process.cwd(),
|
|
850
|
+
homeDir: options.homeDir || options.home,
|
|
851
|
+
global: isGlobal,
|
|
852
|
+
dryRun: isDryRun
|
|
853
|
+
});
|
|
854
|
+
for (const r of hostMcpResult.results) {
|
|
855
|
+
lines.push(
|
|
856
|
+
` \x1b[38;5;82m✓\x1b[0m MCP [${r.host.padEnd(10)}]: ${isDryRun ? '[DRY RUN] Would configure' : 'Configured'} ${r.configPath} (${r.serverKey})`
|
|
857
|
+
);
|
|
858
|
+
if (r.tomlSnippet) {
|
|
859
|
+
lines.push(` Tip: Append to ~/.codex/config.toml:\n${r.tomlSnippet}`);
|
|
860
|
+
}
|
|
861
|
+
}
|
|
862
|
+
}
|
|
863
|
+
|
|
728
864
|
const ok =
|
|
729
865
|
(claudeResult ? claudeResult.ok : true) &&
|
|
730
866
|
(antigravityResult ? antigravityResult.ok : true) &&
|
|
731
|
-
(mcpResult ? mcpResult.ok : true)
|
|
867
|
+
(mcpResult ? mcpResult.ok : true) &&
|
|
868
|
+
(hostMcpResult ? hostMcpResult.ok : true);
|
|
732
869
|
return {
|
|
733
870
|
ok,
|
|
734
871
|
exitCode: ok ? 0 : 1,
|
|
735
872
|
output: lines.join('\n'),
|
|
736
|
-
data: {
|
|
873
|
+
data: {
|
|
874
|
+
claude: claudeResult,
|
|
875
|
+
antigravity: antigravityResult,
|
|
876
|
+
mcp: mcpResult,
|
|
877
|
+
hostMcp: hostMcpResult,
|
|
878
|
+
dryRun: isDryRun
|
|
879
|
+
}
|
|
737
880
|
};
|
|
738
881
|
}
|
|
739
882
|
|
|
740
883
|
export function runCli(args = [], options = {}) {
|
|
741
|
-
const
|
|
742
|
-
const
|
|
743
|
-
const
|
|
744
|
-
|
|
745
|
-
|
|
884
|
+
const invokedBin = path.basename(String(globalThis.process?.argv?.[1] || '')).toLowerCase();
|
|
885
|
+
const isLogSearchBin = invokedBin.includes('agy-log-search');
|
|
886
|
+
const effectiveArgs = isLogSearchBin && !['search', 'log-search'].includes(String(args[0] || '').toLowerCase())
|
|
887
|
+
? ['search', ...args]
|
|
888
|
+
: args;
|
|
889
|
+
const subcommand = String(effectiveArgs[0] || 'doctor').toLowerCase();
|
|
890
|
+
const isGlobal = effectiveArgs.includes('--global') || effectiveArgs.includes('-g');
|
|
891
|
+
const isJson = effectiveArgs.includes('--json') || Boolean(options.json);
|
|
892
|
+
const isMarkdown = effectiveArgs.includes('--markdown') || effectiveArgs.includes('--md') || effectiveArgs.includes('--git');
|
|
893
|
+
const isDiagnostic = effectiveArgs.includes('--diagnostic') || effectiveArgs.includes('--bug-report');
|
|
746
894
|
const scope = isGlobal ? 'global' : 'project';
|
|
747
895
|
|
|
748
|
-
if (
|
|
749
|
-
return { exitCode: 0, output: '4.
|
|
896
|
+
if (effectiveArgs.includes('--version') || effectiveArgs.includes('-v') || subcommand === 'version') {
|
|
897
|
+
return { exitCode: 0, output: '4.1.1', data: { version: '4.1.1' } };
|
|
898
|
+
}
|
|
899
|
+
|
|
900
|
+
if (subcommand === 'search' || subcommand === 'log-search') {
|
|
901
|
+
const positional = [];
|
|
902
|
+
let turnId = options.turnId || '';
|
|
903
|
+
let cwd = options.cwd || process.cwd();
|
|
904
|
+
let limit = Number(options.limit || 10);
|
|
905
|
+
for (let i = 1; i < effectiveArgs.length; i++) {
|
|
906
|
+
const a = String(effectiveArgs[i] || '');
|
|
907
|
+
if (a === '--turn' && effectiveArgs[i + 1]) {
|
|
908
|
+
turnId = String(effectiveArgs[++i]);
|
|
909
|
+
} else if (a === '--cwd' && effectiveArgs[i + 1]) {
|
|
910
|
+
cwd = String(effectiveArgs[++i]);
|
|
911
|
+
} else if (a === '--limit' && effectiveArgs[i + 1]) {
|
|
912
|
+
limit = Math.max(1, Number(effectiveArgs[++i]) || 10);
|
|
913
|
+
} else if (a === '--json') {
|
|
914
|
+
// handled via isJson
|
|
915
|
+
} else if (!a.startsWith('-')) {
|
|
916
|
+
positional.push(a);
|
|
917
|
+
}
|
|
918
|
+
}
|
|
919
|
+
let keyword = '';
|
|
920
|
+
if (!turnId && positional.length >= 2 && /^(turn-|art_)/i.test(positional[0])) {
|
|
921
|
+
turnId = positional[0];
|
|
922
|
+
keyword = positional.slice(1).join(' ');
|
|
923
|
+
} else if (!turnId && positional.length === 1 && /^(turn-|art_)/i.test(positional[0])) {
|
|
924
|
+
turnId = positional[0];
|
|
925
|
+
} else {
|
|
926
|
+
keyword = positional.join(' ');
|
|
927
|
+
}
|
|
928
|
+
return searchOffloadedContextFts5({
|
|
929
|
+
turnId,
|
|
930
|
+
keyword,
|
|
931
|
+
cwd,
|
|
932
|
+
homeDir: options.homeDir || getHomeDir(),
|
|
933
|
+
dbPath: options.dbPath || null,
|
|
934
|
+
limit
|
|
935
|
+
}).then((searchRes) => {
|
|
936
|
+
if (isJson) {
|
|
937
|
+
return { exitCode: 0, output: JSON.stringify(searchRes, null, 2), data: searchRes };
|
|
938
|
+
}
|
|
939
|
+
if (searchRes.matchedLines.length === 0) {
|
|
940
|
+
return {
|
|
941
|
+
exitCode: 0,
|
|
942
|
+
output: `[Highbeam FTS5 Search] No indexed matches for "${keyword || turnId || '*'}" (hits=${searchRes.totalHits}).`,
|
|
943
|
+
data: searchRes
|
|
944
|
+
};
|
|
945
|
+
}
|
|
946
|
+
const lines = [
|
|
947
|
+
`[Highbeam FTS5 Search] Matched ${searchRes.matchedLines.length} line(s) across ${searchRes.toolLogHits} tool log(s) + ${searchRes.artifactHits} artifact(s):`,
|
|
948
|
+
...searchRes.matchedLines.map((m) => ` [${m.turnId}:${m.lineNumber}] (${m.source}) ${m.text}`)
|
|
949
|
+
];
|
|
950
|
+
return { exitCode: 0, output: lines.join('\n'), data: searchRes };
|
|
951
|
+
});
|
|
750
952
|
}
|
|
751
953
|
|
|
752
954
|
if (subcommand === 'inspect') {
|
|
@@ -983,7 +1185,15 @@ export function runCli(args = [], options = {}) {
|
|
|
983
1185
|
}
|
|
984
1186
|
|
|
985
1187
|
if (subcommand === 'init') {
|
|
986
|
-
|
|
1188
|
+
const initRes = executeInitSubcommand(effectiveArgs.slice(1), options);
|
|
1189
|
+
if (isJson) {
|
|
1190
|
+
return {
|
|
1191
|
+
exitCode: initRes.exitCode,
|
|
1192
|
+
output: JSON.stringify(initRes.data, null, 2),
|
|
1193
|
+
data: initRes.data
|
|
1194
|
+
};
|
|
1195
|
+
}
|
|
1196
|
+
return initRes;
|
|
987
1197
|
}
|
|
988
1198
|
|
|
989
1199
|
if (subcommand === 'install') {
|
|
@@ -1123,6 +1333,19 @@ export function runCli(args = [], options = {}) {
|
|
|
1123
1333
|
}
|
|
1124
1334
|
if (action === 'trial') {
|
|
1125
1335
|
const trRes = activateLocalTrial(options);
|
|
1336
|
+
if (!trRes.ok) {
|
|
1337
|
+
if (isJson) {
|
|
1338
|
+
return { exitCode: 1, output: JSON.stringify(trRes, null, 2), data: trRes };
|
|
1339
|
+
}
|
|
1340
|
+
return {
|
|
1341
|
+
exitCode: 1,
|
|
1342
|
+
output: `[Highbeam Pro] 14-day trial already expired (${trRes.expiresAt || ''}). Unlock Pro with: npx ctxtop license activate <CTXP1-KEY>`,
|
|
1343
|
+
data: trRes
|
|
1344
|
+
};
|
|
1345
|
+
}
|
|
1346
|
+
if (isJson) {
|
|
1347
|
+
return { exitCode: 0, output: JSON.stringify(trRes, null, 2), data: trRes };
|
|
1348
|
+
}
|
|
1126
1349
|
return {
|
|
1127
1350
|
exitCode: 0,
|
|
1128
1351
|
output: `[Highbeam Pro] Activated 14-day local trial (expires ${trRes.expiresAt}) -> ${trRes.licensePath}`,
|
|
@@ -1138,13 +1361,25 @@ export function runCli(args = [], options = {}) {
|
|
|
1138
1361
|
};
|
|
1139
1362
|
}
|
|
1140
1363
|
const status = getProEntitlementStatus(options);
|
|
1364
|
+
const shadowAuto = getShadowAutoSummary({
|
|
1365
|
+
workspacePath: options.cwd || process.cwd(),
|
|
1366
|
+
proEntitlement: status,
|
|
1367
|
+
...options
|
|
1368
|
+
});
|
|
1369
|
+
const outData = { ...status, shadowAuto };
|
|
1141
1370
|
if (isJson) {
|
|
1142
|
-
return { exitCode: 0, output: JSON.stringify(
|
|
1371
|
+
return { exitCode: 0, output: JSON.stringify(outData, null, 2), data: outData };
|
|
1372
|
+
}
|
|
1373
|
+
const statusLines = [
|
|
1374
|
+
`[Highbeam Pro] Tier=${status.tier} | Entitled=${status.entitled} | Source=${status.source}`
|
|
1375
|
+
];
|
|
1376
|
+
if (!status.entitled && shadowAuto.incidentCount30d > 0) {
|
|
1377
|
+
statusLines.push(` Auto preview (30d): ${shadowAuto.headlineText} — ${shadowAuto.sublineText}`);
|
|
1143
1378
|
}
|
|
1144
1379
|
return {
|
|
1145
1380
|
exitCode: 0,
|
|
1146
|
-
output:
|
|
1147
|
-
data:
|
|
1381
|
+
output: statusLines.join('\n'),
|
|
1382
|
+
data: outData
|
|
1148
1383
|
};
|
|
1149
1384
|
}
|
|
1150
1385
|
|
|
@@ -1216,7 +1451,7 @@ export function runCli(args = [], options = {}) {
|
|
|
1216
1451
|
const res = generateCostRadar({ ...options, demo: isDemo });
|
|
1217
1452
|
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
1218
1453
|
const ok = writeTextAtomic(target, res.html) !== false;
|
|
1219
|
-
const shareSnippet = `⚡ Cost Radar: ${res.summary.retention} · ${res.summary.drift} · ${res.summary.swarm} (via npx
|
|
1454
|
+
const shareSnippet = `⚡ Cost Radar: ${res.summary.retention} · ${res.summary.drift} · ${res.summary.swarm} (via npx ctxtop cost-radar)`;
|
|
1220
1455
|
const data = { ok, path: target, ...res.summary, shareSnippet };
|
|
1221
1456
|
if (isJson) {
|
|
1222
1457
|
return { exitCode: ok ? 0 : 1, output: JSON.stringify(data, null, 2), data };
|
|
@@ -1363,9 +1598,18 @@ export function runCli(args = [], options = {}) {
|
|
|
1363
1598
|
return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
|
|
1364
1599
|
}
|
|
1365
1600
|
const hookDiag = res.hookDiagnostics || { recentErrorCount: 0, recentErrors: [] };
|
|
1601
|
+
const ccCap = res.claudeCapabilities;
|
|
1366
1602
|
const lines = [
|
|
1367
1603
|
`[Highbeam Doctor] Status: ${res.ok ? 'HEALTHY' : 'ISSUES DETECTED'}`,
|
|
1368
|
-
...res.checks.map((c) =>
|
|
1604
|
+
...res.checks.map((c) => {
|
|
1605
|
+
const badge = c.status || (c.ok ? 'PASS' : 'FAIL');
|
|
1606
|
+
return ` [${badge}] ${c.id}: ${c.detail}`;
|
|
1607
|
+
}),
|
|
1608
|
+
...(ccCap?.found
|
|
1609
|
+
? [
|
|
1610
|
+
` [${ccCap.contractValid ? 'PASS' : 'WARN'}] claude_pre_model_switch: Claude Code ${ccCap.claudeVersion || 'unknown'} | PreModelSwitch=${ccCap.preModelSwitchSupported} | ask=${ccCap.supportsAskDecision} | PreEffortChange=${ccCap.preEffortChangeSummary || formatPreEffortChangeCapability(ccCap)}`
|
|
1611
|
+
]
|
|
1612
|
+
: []),
|
|
1369
1613
|
` [${hookDiag.recentErrorCount > 0 ? 'WARN' : 'PASS'}] hook_diagnostics: ${hookDiag.recentErrorCount} recent non-fatal error(s)`
|
|
1370
1614
|
];
|
|
1371
1615
|
for (const errEntry of hookDiag.recentErrors) {
|
|
@@ -1380,35 +1624,329 @@ export function runCli(args = [], options = {}) {
|
|
|
1380
1624
|
return runStatusLineCli(args.slice(1));
|
|
1381
1625
|
}
|
|
1382
1626
|
|
|
1383
|
-
if (
|
|
1627
|
+
if (subcommand === 'audit') {
|
|
1628
|
+
const platIdx = args.indexOf('--platform');
|
|
1629
|
+
const platform =
|
|
1630
|
+
platIdx !== -1 && args[platIdx + 1]
|
|
1631
|
+
? String(args[platIdx + 1]).toLowerCase()
|
|
1632
|
+
: (options.platform || 'all');
|
|
1633
|
+
const daysIdx = args.indexOf('--days');
|
|
1634
|
+
const days =
|
|
1635
|
+
daysIdx !== -1 && args[daysIdx + 1]
|
|
1636
|
+
? Number(args[daysIdx + 1])
|
|
1637
|
+
: (options.days || 7);
|
|
1638
|
+
const limitIdx = args.indexOf('--limit');
|
|
1639
|
+
const limit =
|
|
1640
|
+
limitIdx !== -1 && args[limitIdx + 1]
|
|
1641
|
+
? Number(args[limitIdx + 1])
|
|
1642
|
+
: (options.limit || 10);
|
|
1643
|
+
|
|
1644
|
+
const auditRes = runSessionAudit({
|
|
1645
|
+
...options,
|
|
1646
|
+
platform,
|
|
1647
|
+
days,
|
|
1648
|
+
limit
|
|
1649
|
+
});
|
|
1650
|
+
if (isJson) {
|
|
1651
|
+
return { exitCode: 0, output: JSON.stringify(auditRes, null, 2), data: auditRes };
|
|
1652
|
+
}
|
|
1653
|
+
return { exitCode: 0, output: formatSessionAuditReport(auditRes), data: auditRes };
|
|
1654
|
+
}
|
|
1655
|
+
|
|
1656
|
+
if (subcommand === 'rsl') {
|
|
1657
|
+
const action = String(args[1] || 'status').toLowerCase();
|
|
1658
|
+
const readFlag = (flag, fallback) => {
|
|
1659
|
+
const idx = args.indexOf(flag);
|
|
1660
|
+
return idx !== -1 && args[idx + 1] ? String(args[idx + 1]) : fallback;
|
|
1661
|
+
};
|
|
1662
|
+
const wsRoot = path.resolve(readFlag('--cwd', options.cwd || process.cwd()));
|
|
1663
|
+
const platform = readFlag('--platform', options.platform || 'all').toLowerCase();
|
|
1664
|
+
|
|
1665
|
+
if (action === 'status') {
|
|
1666
|
+
const summary = { ok: true, platform, ...getRslSummary(wsRoot, options) };
|
|
1667
|
+
if (isJson) {
|
|
1668
|
+
return { exitCode: 0, output: JSON.stringify(summary, null, 2), data: summary };
|
|
1669
|
+
}
|
|
1670
|
+
const memNote = summary.claudeMemoryAudit?.triggered
|
|
1671
|
+
? `WARN (${summary.claudeMemoryAudit.maxLines}L / ${Math.round(summary.claudeMemoryAudit.maxBytes / 1024)}KB)`
|
|
1672
|
+
: 'OK';
|
|
1673
|
+
const lines = [
|
|
1674
|
+
`[Highbeam RSL] Dual-Platform Self-Learning Status (platform=${platform})`,
|
|
1675
|
+
` Active Carriers : ${summary.activeRules} rules · ${summary.activeSkills} skills · ${summary.promotedHooks} promoted hooks`,
|
|
1676
|
+
` Rule Budget : ${summary.ruleBudgetTokens}/${summary.ruleBudgetMaxTokens} tokens (${summary.ruleBudgetPct}%)`,
|
|
1677
|
+
` Rule Clashes : ${summary.clashCount || 0} conflict(s)${summary.quarantinedCount ? ` (${summary.quarantinedCount} quarantined)` : ''}`,
|
|
1678
|
+
` Lifecycle Stats : ${summary.prunedCount} pruned · ${summary.taintedSessions} tainted sessions`,
|
|
1679
|
+
` Claude Memory : ${memNote}`,
|
|
1680
|
+
...((summary.activeClashes || []).map((c) => ` [RULE_CONFLICT] ${c.reason}`))
|
|
1681
|
+
];
|
|
1682
|
+
return { exitCode: 0, output: lines.join('\n'), data: summary };
|
|
1683
|
+
}
|
|
1684
|
+
|
|
1685
|
+
if (action === 'list') {
|
|
1686
|
+
const includeAll = args.includes('--all') || Boolean(options.all);
|
|
1687
|
+
const summary = getRslSummary(wsRoot, { ...options, includeAll });
|
|
1688
|
+
const payload = { ok: true, includeAll, count: summary.items.length, items: summary.items };
|
|
1689
|
+
if (isJson) {
|
|
1690
|
+
return { exitCode: 0, output: JSON.stringify(payload, null, 2), data: payload };
|
|
1691
|
+
}
|
|
1692
|
+
const lines = [`[Highbeam RSL] Heuristics (${payload.count} item(s), all=${includeAll}):`];
|
|
1693
|
+
for (const it of summary.items) {
|
|
1694
|
+
lines.push(` - ${it.slug} [${it.carrier}] importance=${it.importance} status=${it.status} hook=${Boolean(it.promotedHook)}`);
|
|
1695
|
+
}
|
|
1696
|
+
return { exitCode: 0, output: lines.join('\n'), data: payload };
|
|
1697
|
+
}
|
|
1698
|
+
|
|
1699
|
+
if (action === 'run') {
|
|
1700
|
+
const mode = readFlag('--mode', options.mode || 'local').toLowerCase();
|
|
1701
|
+
let sessionId = readFlag('--session', options.sessionId || '');
|
|
1702
|
+
if (!sessionId) {
|
|
1703
|
+
const telemetryDir = path.join(wsRoot, '.agents', 'telemetry');
|
|
1704
|
+
if (fs.existsSync(telemetryDir)) {
|
|
1705
|
+
const candidates = fs.readdirSync(telemetryDir)
|
|
1706
|
+
.filter((f) => f.endsWith('.rsl_steps.jsonl'))
|
|
1707
|
+
.map((f) => ({ name: f.replace(/\.rsl_steps\.jsonl$/, ''), mtime: fs.statSync(path.join(telemetryDir, f)).mtimeMs }))
|
|
1708
|
+
.sort((a, b) => b.mtime - a.mtime);
|
|
1709
|
+
if (candidates[0]) sessionId = candidates[0].name;
|
|
1710
|
+
}
|
|
1711
|
+
}
|
|
1712
|
+
sessionId = sanitizeRslSessionId(sessionId || 'default');
|
|
1713
|
+
const resolvedPlatform = platform === 'auto' || platform === 'all'
|
|
1714
|
+
? (options.transcriptPath && String(options.transcriptPath).includes('.claude') ? 'claude' : 'antigravity')
|
|
1715
|
+
: platform;
|
|
1716
|
+
const digest = buildContrastiveDigest(
|
|
1717
|
+
{
|
|
1718
|
+
conversationId: sessionId,
|
|
1719
|
+
session_id: sessionId,
|
|
1720
|
+
cwd: wsRoot,
|
|
1721
|
+
workspacePaths: [wsRoot],
|
|
1722
|
+
transcriptPath: readFlag('--transcript', options.transcriptPath || ''),
|
|
1723
|
+
artifactDirectoryPath: readFlag('--artifacts', options.artifactDirectoryPath || '')
|
|
1724
|
+
},
|
|
1725
|
+
{ ...options, cwd: wsRoot, platform: resolvedPlatform }
|
|
1726
|
+
);
|
|
1727
|
+
const distillation = digest.triggered
|
|
1728
|
+
? distillContrastiveDigest(digest, { mode, sdkRunner: options.sdkRunner })
|
|
1729
|
+
: { is_valid_learning: false, mode, heuristics: [] };
|
|
1730
|
+
const ledgerResult = (digest.tainted || digest.triggered || fs.existsSync(getRslLedgerPath(wsRoot)))
|
|
1731
|
+
? ingestDistilledHeuristics(wsRoot, distillation, digest, options)
|
|
1732
|
+
: null;
|
|
1733
|
+
const summary = getRslSummary(wsRoot, options);
|
|
1734
|
+
const res = {
|
|
1735
|
+
ok: !digest.tainted,
|
|
1736
|
+
sessionId,
|
|
1737
|
+
platform: resolvedPlatform,
|
|
1738
|
+
mode: distillation.mode || mode,
|
|
1739
|
+
digest,
|
|
1740
|
+
distillation,
|
|
1741
|
+
ledgerResult,
|
|
1742
|
+
summary
|
|
1743
|
+
};
|
|
1744
|
+
if (isJson) {
|
|
1745
|
+
return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
|
|
1746
|
+
}
|
|
1747
|
+
const msg = digest.tainted
|
|
1748
|
+
? `[Highbeam RSL] Session ${sessionId} flagged ${digest.status} (${digest.taintDetails.join('; ')}) — extraction aborted.`
|
|
1749
|
+
: `[Highbeam RSL] Session ${sessionId} distilled (${res.mode}): +${ledgerResult?.added?.length || 0} added, ${ledgerResult?.upvoted?.length || 0} upvoted, ${ledgerResult?.pruned?.length || 0} pruned.`;
|
|
1750
|
+
return { exitCode: res.ok ? 0 : 1, output: msg, data: res };
|
|
1751
|
+
}
|
|
1752
|
+
|
|
1753
|
+
if (action === 'promote' || action === 'prune') {
|
|
1754
|
+
const slug = args[2] && !args[2].startsWith('-') ? args[2] : (options.slug || '');
|
|
1755
|
+
if (!slug) {
|
|
1756
|
+
const errRes = { ok: false, error: `Missing <slug> for rsl ${action}` };
|
|
1757
|
+
return {
|
|
1758
|
+
exitCode: 1,
|
|
1759
|
+
output: isJson ? JSON.stringify(errRes, null, 2) : `[Highbeam RSL] ERROR: ${errRes.error}`,
|
|
1760
|
+
data: errRes
|
|
1761
|
+
};
|
|
1762
|
+
}
|
|
1763
|
+
const res = action === 'promote'
|
|
1764
|
+
? promoteHeuristic(wsRoot, slug, options)
|
|
1765
|
+
: pruneHeuristic(wsRoot, slug, options);
|
|
1766
|
+
if (isJson) {
|
|
1767
|
+
return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
|
|
1768
|
+
}
|
|
1769
|
+
return {
|
|
1770
|
+
exitCode: res.ok ? 0 : 1,
|
|
1771
|
+
output: res.ok
|
|
1772
|
+
? `[Highbeam RSL] ${action === 'promote' ? 'Promoted' : 'Pruned'} heuristic "${res.slug}" across .agents/ and .claude/`
|
|
1773
|
+
: `[Highbeam RSL] ERROR: ${res.error}`,
|
|
1774
|
+
data: res
|
|
1775
|
+
};
|
|
1776
|
+
}
|
|
1777
|
+
|
|
1778
|
+
const helpRsl = 'Usage: ctxtop rsl <status|list|run|promote <slug>|prune <slug>> [--platform all|antigravity|claude] [--mode local|sdk] [--json]';
|
|
1779
|
+
return {
|
|
1780
|
+
exitCode: 1,
|
|
1781
|
+
output: isJson ? JSON.stringify({ ok: false, error: `Unknown rsl action: ${action}` }, null, 2) : helpRsl,
|
|
1782
|
+
data: { ok: false }
|
|
1783
|
+
};
|
|
1784
|
+
}
|
|
1785
|
+
|
|
1786
|
+
if (subcommand === 'shield' || subcommand === 'status') {
|
|
1787
|
+
const platIdx = args.indexOf('--platform');
|
|
1788
|
+
const platform =
|
|
1789
|
+
platIdx !== -1 && args[platIdx + 1]
|
|
1790
|
+
? String(args[platIdx + 1]).toLowerCase()
|
|
1791
|
+
: (options.platform || 'all');
|
|
1792
|
+
const linesIdx = args.indexOf('--max-lines');
|
|
1793
|
+
const maxUnslicedLines =
|
|
1794
|
+
linesIdx !== -1 && args[linesIdx + 1] ? Number(args[linesIdx + 1]) : options.maxUnslicedLines;
|
|
1795
|
+
|
|
1796
|
+
let action = 'status';
|
|
1797
|
+
if (subcommand === 'shield') {
|
|
1798
|
+
if (args.includes('--enable') || args[1] === 'enable') action = 'enable';
|
|
1799
|
+
else if (args.includes('--disable') || args[1] === 'disable') action = 'disable';
|
|
1800
|
+
else action = 'status';
|
|
1801
|
+
}
|
|
1802
|
+
|
|
1803
|
+
const baseRes =
|
|
1804
|
+
subcommand === 'status'
|
|
1805
|
+
? { ok: true, action: 'status', platform, ...getShieldStatus({ ...options }) }
|
|
1806
|
+
: configureShield({
|
|
1807
|
+
...options,
|
|
1808
|
+
action,
|
|
1809
|
+
platform,
|
|
1810
|
+
...(maxUnslicedLines ? { maxUnslicedLines } : {})
|
|
1811
|
+
});
|
|
1812
|
+
|
|
1813
|
+
const offloadIndex =
|
|
1814
|
+
subcommand === 'status'
|
|
1815
|
+
? getOffloadIndexStats({
|
|
1816
|
+
cwd: options.cwd || process.cwd(),
|
|
1817
|
+
homeDir: options.homeDir || getHomeDir(),
|
|
1818
|
+
dbPath: options.dbPath || null
|
|
1819
|
+
})
|
|
1820
|
+
: null;
|
|
1821
|
+
const ipcFastPath =
|
|
1822
|
+
subcommand === 'status'
|
|
1823
|
+
? {
|
|
1824
|
+
pipePath: resolveFastIpcPipePath({ homeDir: options.homeDir || getHomeDir() }),
|
|
1825
|
+
socketPresent: (() => {
|
|
1826
|
+
const p = resolveFastIpcPipePath({ homeDir: options.homeDir || getHomeDir() });
|
|
1827
|
+
return (p && p.startsWith('\\\\.\\pipe\\')) ? null : (p ? fs.existsSync(p) : false);
|
|
1828
|
+
})()
|
|
1829
|
+
}
|
|
1830
|
+
: null;
|
|
1831
|
+
const res =
|
|
1832
|
+
subcommand === 'status'
|
|
1833
|
+
? { ...baseRes, offloadIndex, ipcFastPath }
|
|
1834
|
+
: baseRes;
|
|
1835
|
+
|
|
1836
|
+
if (isJson) {
|
|
1837
|
+
return { exitCode: res.ok === false ? 1 : 0, output: JSON.stringify(res, null, 2), data: res };
|
|
1838
|
+
}
|
|
1839
|
+
const lines = [
|
|
1840
|
+
`[Highbeam Shield] Status: ${res.enabled ? 'ACTIVE' : 'PASSIVE'} (action=${res.action}, platform=${platform})`,
|
|
1841
|
+
` Targets : Antigravity=${res.platforms.antigravity ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.antigravity}) | Claude=${res.platforms.claude ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.claude})`,
|
|
1842
|
+
` Read Threshold: >${res.maxUnslicedLines} lines default | >${res.cliffMaxUnslicedLines} lines near pricing cliff`,
|
|
1843
|
+
` Session ROI : +${res.roi.tokensSaved.toLocaleString('en-US')} tok saved ($${res.roi.dollarsSaved.toFixed(2)} USD) | ${res.roi.readsBlocked} oversized reads indexed`,
|
|
1844
|
+
...(offloadIndex
|
|
1845
|
+
? [
|
|
1846
|
+
` Offload Index : ${offloadIndex.indexedToolLogs} FTS5 CLI logs · ${offloadIndex.indexedArtifacts} artifact(s) (query: npx ctxtop search "<keyword>")`
|
|
1847
|
+
]
|
|
1848
|
+
: []),
|
|
1849
|
+
...(res.selfTest ? [` Self-Test : ${res.selfTest.detail}`] : [])
|
|
1850
|
+
];
|
|
1851
|
+
return { exitCode: res.ok === false ? 1 : 0, output: lines.join('\n'), data: res };
|
|
1852
|
+
}
|
|
1853
|
+
|
|
1854
|
+
if (subcommand === 'handoff') {
|
|
1855
|
+
const readFlag = (flag, fallback) => {
|
|
1856
|
+
const idx = args.indexOf(flag);
|
|
1857
|
+
return idx !== -1 && args[idx + 1] ? String(args[idx + 1]) : fallback;
|
|
1858
|
+
};
|
|
1859
|
+
const wsRoot = path.resolve(readFlag('--cwd', options.cwd || process.cwd()));
|
|
1860
|
+
const sessionId = readFlag('--session', options.sessionId || '');
|
|
1861
|
+
const result = buildConsolidatedSpecMarkdown(wsRoot, { sessionId });
|
|
1862
|
+
let outputPath = null;
|
|
1863
|
+
if (args.includes('--write') || Boolean(options.write)) {
|
|
1864
|
+
outputPath = path.join(wsRoot, '.agents', 'telemetry', 'CONSOLIDATED_SPEC.md');
|
|
1865
|
+
writeTextAtomic(outputPath, `${result.consolidatedMarkdown}\n`);
|
|
1866
|
+
}
|
|
1867
|
+
const payload = { ...result, ...(outputPath ? { outputPath } : {}) };
|
|
1868
|
+
return {
|
|
1869
|
+
exitCode: 0,
|
|
1870
|
+
output: isJson ? JSON.stringify(payload, null, 2) : payload.consolidatedMarkdown,
|
|
1871
|
+
data: payload
|
|
1872
|
+
};
|
|
1873
|
+
}
|
|
1874
|
+
|
|
1875
|
+
if (subcommand === 'mcp') {
|
|
1876
|
+
return import('../packages/mcp/src/server.mjs').then(({ startMcpStdioServer }) => {
|
|
1877
|
+
startMcpStdioServer(options);
|
|
1878
|
+
if (isCliMain()) {
|
|
1879
|
+
globalThis.process?.stdin?.resume?.();
|
|
1880
|
+
}
|
|
1881
|
+
return { exitCode: 0, output: '', data: { ok: true, mode: 'mcp' } };
|
|
1882
|
+
});
|
|
1883
|
+
}
|
|
1884
|
+
|
|
1885
|
+
if (subcommand === 'ui' || subcommand === 'serve' || args.includes('--serve')) {
|
|
1886
|
+
if (args.includes('--demo')) {
|
|
1887
|
+
process.env.HORIZON_DEMO = '1';
|
|
1888
|
+
}
|
|
1889
|
+
const shouldOpenBrowser = (subcommand === 'ui' || args.includes('--open')) && !args.includes('--no-open');
|
|
1890
|
+
return import('../sidecars/horizon-daemon/server.mjs').then(({ startServer }) =>
|
|
1891
|
+
startServer().then(({ port }) => {
|
|
1892
|
+
const targetUrl = `http://127.0.0.1:${port}`;
|
|
1893
|
+
if (shouldOpenBrowser) {
|
|
1894
|
+
openBrowserUrl(targetUrl);
|
|
1895
|
+
}
|
|
1896
|
+
return {
|
|
1897
|
+
exitCode: 0,
|
|
1898
|
+
output: `✓ Highbeam Web UI Live at: ${targetUrl} (Press Ctrl+C to stop)`,
|
|
1899
|
+
data: { ok: true, port, url: targetUrl }
|
|
1900
|
+
};
|
|
1901
|
+
})
|
|
1902
|
+
);
|
|
1903
|
+
}
|
|
1904
|
+
|
|
1905
|
+
if (args.includes('--demo') || args.includes('--demo-animate') || args.includes('--roast')) {
|
|
1384
1906
|
return runLiveOrDemoCli(options);
|
|
1385
1907
|
}
|
|
1386
1908
|
|
|
1387
1909
|
const knownSubcommands = new Set([
|
|
1388
1910
|
'init', 'install', 'uninstall', 'config', 'cost-radar', 'radar', 'panel',
|
|
1389
1911
|
'receipt', 'doctor', 'statusline', 'inspect', 'control', 'postmortem',
|
|
1390
|
-
'
|
|
1391
|
-
'
|
|
1912
|
+
'audit', 'shield', 'status', 'rsl', 'handoff', 'search', 'log-search',
|
|
1913
|
+
'mcp', 'ui', 'serve', 'license', 'pro', 'roast', 'tiers', 'team-pack',
|
|
1914
|
+
'verify', 'verify-checksums', '--help', '-h', 'help', '--version', '-v', 'version'
|
|
1392
1915
|
]);
|
|
1393
1916
|
const hasHelp = args.length === 0 || args.includes('--help') || args.includes('-h') || subcommand === 'help';
|
|
1394
1917
|
const isUnknown = !hasHelp && args.length > 0 && !knownSubcommands.has(subcommand);
|
|
1395
1918
|
|
|
1396
1919
|
const helpText = [
|
|
1397
1920
|
'Usage: ctxtop <command> [options]',
|
|
1398
|
-
'
|
|
1399
|
-
'
|
|
1400
|
-
'
|
|
1401
|
-
'
|
|
1402
|
-
'
|
|
1403
|
-
'
|
|
1404
|
-
'
|
|
1405
|
-
'
|
|
1406
|
-
'
|
|
1407
|
-
'
|
|
1921
|
+
'',
|
|
1922
|
+
'Quick Start (Zero-Write & Setup):',
|
|
1923
|
+
' audit [--platform all|antigravity|claude|codex|gemini|cursor] [--days 7] [--json]',
|
|
1924
|
+
' Zero-write 5-host Sludge Tax & ROI scan',
|
|
1925
|
+
' init [--antigravity|--claude|--cursor|--windsurf|--codex|--gemini-cli|--mcp|--all-hosts]',
|
|
1926
|
+
' Zero-config multi-host installer',
|
|
1927
|
+
' ui [--open] [--demo] Launch local Simple/Advanced Web UI (127.0.0.1)',
|
|
1928
|
+
' doctor [--diagnostic | --json] Verify contracts, FTS5 index & IPC readiness',
|
|
1929
|
+
'',
|
|
1930
|
+
'Daily Cockpit & Live UX:',
|
|
1931
|
+
' status [--platform all|antigravity|claude] [--json] Show Shield, FTS5 offload & Session ROI status',
|
|
1408
1932
|
' statusline [--demo] [--columns N] Responsive single-line statusline bridge',
|
|
1409
|
-
'
|
|
1933
|
+
' panel [--advanced] [--out <file.html>] Write zero-socket HTML HUD',
|
|
1934
|
+
' radar [--out <file.html>] [--json] [--demo] Write SVG KV-cache retention radar timeline',
|
|
1935
|
+
' postmortem [--last N] [--json] [--demo] Analyze transcript forensics & rot',
|
|
1410
1936
|
' inspect [<session-id> | --last] [--out <file.json>] Inspect session trajectory',
|
|
1411
|
-
'
|
|
1937
|
+
'',
|
|
1938
|
+
'Compression, Search & Multi-Host MCP:',
|
|
1939
|
+
' shield <--enable | --disable | --status> [--platform all|...] Toggle Active Context Shield & read-index guard',
|
|
1940
|
+
' search [<turn-id>] "<keyword>" [--limit 10] [--json] Search FTS5 offloaded CLI logs & artifacts',
|
|
1941
|
+
' mcp Start zero-network 7-tool stdio MCP (@ctxtop/mcp)',
|
|
1942
|
+
'',
|
|
1943
|
+
'Governance, RSL & FinOps:',
|
|
1944
|
+
' rsl <status|list|run|promote|prune> [--platform ...] [--json] Dual-platform RSL post-mortem & rule ledger',
|
|
1945
|
+
' handoff [--consolidate] [--session <id>] [--write] [--json] Consolidate sharded spec constraints & diff',
|
|
1946
|
+
' receipt [--advanced | --markdown | --pdf | --json] Print Simple View, Git Receipt, or FinOps PDF',
|
|
1947
|
+
' config [list | set <DET-ID> <mode> | reset] Configure per-detector overrides',
|
|
1948
|
+
' control <pause|resume|step|abort|rewind|status> Execution control plane command',
|
|
1949
|
+
' verify [--json] | uninstall [--global | --project] Verify checksums or remove Highbeam hooks'
|
|
1412
1950
|
].join('\n');
|
|
1413
1951
|
return { exitCode: isUnknown ? 1 : 0, output: helpText, data: { help: true, isUnknown } };
|
|
1414
1952
|
}
|