ctxtop 4.1.0 → 4.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.antigravity-plugin/plugin.json +1 -1
- package/.claude-plugin/plugin.json +21 -18
- package/CHECKSUMS.sha256 +51 -44
- package/LICENSE +27 -27
- package/README.md +90 -56
- package/SECURITY.md +7 -1
- package/assets/hero-demo.svg +1 -1
- package/bin/ctxtop.mjs +267 -54
- package/config/modelCatalog.json +847 -273
- package/hooks/handlers/hookIpcClient.mjs +8 -4
- package/hooks/handlers/post-model-switch.mjs +39 -2
- package/hooks/handlers/post-tool-use-core.mjs +394 -0
- package/hooks/handlers/post-tool-use.mjs +54 -321
- package/hooks/handlers/pre-model-switch.mjs +115 -5
- package/hooks/handlers/pre-tool-use-core.mjs +680 -0
- package/hooks/handlers/pre-tool-use.mjs +61 -571
- package/hooks/handlers/stop-gate.mjs +20 -8
- package/hooks/handlers/user-prompt-submit.mjs +111 -2
- package/hooks/post_tool_use.mjs +17 -4
- package/hooks/pre_tool_use.mjs +84 -54
- package/hooks.json +56 -56
- package/package.json +4 -3
- package/packages/antigravity/package.json +10 -3
- package/packages/antigravity/src/adapter.mjs +109 -0
- package/packages/antigravity/src/index.mjs +7 -1
- package/packages/claude-code/package.json +10 -3
- package/packages/claude-code/src/adapter.mjs +194 -0
- package/packages/claude-code/src/index.mjs +8 -2
- package/packages/claude-code/src/register.js +726 -0
- package/packages/core/package.json +6 -2
- package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
- package/packages/core/src/catalog/index.mjs +1 -0
- package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
- package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
- package/packages/core/src/coach/microSkills.mjs +1 -0
- package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/core/src/coach/repoCalibration.mjs +254 -0
- package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
- package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
- package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
- package/packages/core/src/config/anthropicModelCatalog.json +607 -0
- package/packages/core/src/config/catalogLoader.mjs +1271 -0
- package/packages/core/src/config/horizonConfig.mjs +1055 -0
- package/packages/core/src/control/callTree.mjs +338 -0
- package/packages/core/src/control/coachLatches.mjs +126 -0
- package/packages/core/src/control/controlStateMachine.mjs +205 -0
- package/packages/core/src/control/index.mjs +49 -0
- package/packages/core/src/control/swarmWorktree.mjs +109 -0
- package/packages/core/src/control/toolSuspension.mjs +197 -0
- package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
- package/packages/core/src/diagnostics/index.mjs +9 -0
- package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
- package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/core/src/economics/billingBlocks.mjs +251 -0
- package/packages/core/src/economics/cacheGravity.mjs +371 -0
- package/packages/core/src/economics/cliffBreaker.mjs +256 -0
- package/packages/core/src/economics/driftLatency.mjs +433 -0
- package/packages/core/src/economics/dualTtl.mjs +198 -0
- package/packages/core/src/economics/index.mjs +47 -0
- package/packages/core/src/economics/retentionRadar.mjs +348 -0
- package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
- package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/core/src/guards/bucketBGamma.mjs +442 -0
- package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
- package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
- package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/core/src/guards/docIndexCore.mjs +446 -0
- package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/core/src/guards/slopsquatGate.mjs +551 -0
- package/packages/core/src/index.js +27 -0
- package/packages/core/src/index.mjs +25 -1
- package/packages/core/src/telemetry/otelExporter.mjs +187 -0
- package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
- package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
- package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/core/src/ui/brailleSparkline.mjs +142 -0
- package/packages/core/src/ui/costRadarSvg.mjs +276 -0
- package/packages/core/src/ui/horizonGrid.mjs +475 -0
- package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/core/src/ui/modViews.mjs +1558 -0
- package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/core/src/ustf/index.mjs +7 -0
- package/packages/core/src/ustf/normalizer.mjs +512 -0
- package/packages/core/src/ustf/schema.mjs +186 -0
- package/packages/core/src/utils/runtime.mjs +962 -0
- package/packages/engine-node/package.json +6 -2
- package/packages/engine-node/src/db/index.mjs +58 -0
- package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
- package/packages/engine-node/src/db/probe.mjs +342 -0
- package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
- package/packages/engine-node/src/index.mjs +11 -1
- package/packages/engine-node/src/ipc/client.mjs +447 -0
- package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
- package/packages/engine-node/src/ipc/index.mjs +24 -0
- package/packages/engine-node/src/ipc/protocol.mjs +177 -0
- package/packages/engine-node/src/ipc/server.mjs +445 -0
- package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
- package/packages/engine-node/src/offloader/index.mjs +6 -0
- package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
- package/packages/engine-node/src/rsl/index.mjs +3 -0
- package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
- package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
- package/packages/engine-node/src/sensors/index.mjs +7 -0
- package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
- package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
- package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
- package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
- package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
- package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
- package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
- package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
- package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
- package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
- package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
- package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
- package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
- package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
- package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
- package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
- package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
- package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
- package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
- package/packages/mcp/package.json +7 -3
- package/packages/mcp/src/server.mjs +115 -14
- package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
- package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
- package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
- package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
- package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
- package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
- package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
- package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
- package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
- package/packages/mcp/src/vendor/core/paths.mjs +311 -0
- package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
- package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
- package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
- package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
- package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
- package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
- package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
- package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
- package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
- package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
- package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
- package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
- package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
- package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
- package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
- package/packages/pro/package.json +23 -16
- package/packages/pro/src/index.mjs +9 -3
- package/packages/pro/src/pro_license.mjs +547 -0
- package/packages/pro/src/team_finops_pack.mjs +241 -241
- package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
- package/plugin.json +1 -1
- package/sidecars/horizon-daemon/server.mjs +482 -44
- package/src/cli/doctor.mjs +11 -2
- package/src/cli/horizon_hud.mjs +31 -15
- package/src/cli/init.mjs +46 -13
- package/src/config/modelCatalog.json +886 -231
- package/src/core/classifier.mjs +25 -11
- package/src/core/coach/circuit_breakers.mjs +84 -6
- package/src/core/coach/task_quota_router.mjs +8 -0
- package/src/core/code_fold_lite.mjs +169 -0
- package/src/core/config.mjs +44 -0
- package/src/core/constants.mjs +175 -12
- package/src/core/detectors_det01_to_16.mjs +44 -3
- package/src/core/fts5_output_compressor.mjs +272 -35
- package/src/core/horizon_config.mjs +42 -0
- package/src/core/parser.mjs +86 -11
- package/src/core/pro_license.mjs +174 -12
- package/src/core/pruner.mjs +7 -146
- package/src/core/quota.mjs +14 -2
- package/src/core/rsl_distiller.mjs +31 -9
- package/src/core/rsl_ledger.mjs +66 -6
- package/src/core/rsl_triage.mjs +159 -17
- package/src/core/session_auditor.mjs +476 -25
- package/src/core/shadow_auto_ledger.mjs +205 -0
- package/src/core/sqlite_client.mjs +10 -4
- package/src/core/subagents.mjs +18 -2
- package/src/core/task_quota_router.mjs +61 -4
- package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
- package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
- package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
- package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
- package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
- package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
- package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
- package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
- package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
- package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
- package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
- package/src/core-isomorphic/ui/modViews.mjs +62 -8
- package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
- package/src/diagnostics/doctorEngine.mjs +28 -2
- package/src/engine-node/ipc/fast_client.mjs +191 -0
- package/src/engine-node/ipc/index.mjs +2 -0
- package/src/engine-node/multi_host_mcp.mjs +168 -0
- package/src/hooks/antigravity_rsl_hook.mjs +24 -2
- package/src/hooks/claude_rsl_hook.mjs +22 -2
- package/src/hooks/daemon_hook_bridge.mjs +256 -0
- package/src/hooks/fast_hook_ipc.mjs +295 -0
- package/src/hooks/post_invocation.mjs +37 -597
- package/src/hooks/post_invocation_core.mjs +623 -0
- package/src/hooks/pre_invocation.mjs +103 -1668
- package/src/hooks/pre_invocation_core.mjs +1830 -0
- package/src/utils/sessionCalibration.mjs +52 -5
- package/src/webview/advanced_view.html +34 -18
- package/src/webview/horizon_panel.html +3233 -675
- package/src/webview/simple_view.html +1 -1
|
@@ -0,0 +1,1109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core/session_auditor.mjs
|
|
3
|
+
* Zero-Write Cross-Platform Historical Session Auditor (`ctxtop audit`).
|
|
4
|
+
*
|
|
5
|
+
* Scans local Antigravity (`transcript_full.jsonl` / `transcript.jsonl`) and Claude Code
|
|
6
|
+
* (`~/.claude/projects/**\/*.jsonl`, deduplicating streaming chunks by `message.id`) transcripts
|
|
7
|
+
* alongside `.agents/telemetry/*.hints.jsonl` and `.claude/cache/horizon_ledger.jsonl`.
|
|
8
|
+
*
|
|
9
|
+
* Guardrails:
|
|
10
|
+
* - Strictly read-only: zero workspace mutations, zero network calls, zero OAuth file reads.
|
|
11
|
+
* - Strictly excludes `packages/airlock/` and sister SKU paths.
|
|
12
|
+
* - Framed strictly around Session ROI & Quota Shield (`Sludge Tax`, `Cold-Cache Spikes`,
|
|
13
|
+
* `Thrash Loops`, `Oversized Reads`, `Top 3 Offending Turns`) — never developer grades.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import os from 'node:os';
|
|
19
|
+
import { normalizeModelKey, resolveModelRates, resolveModelCeiling } from './constants.mjs';
|
|
20
|
+
import { isForbiddenSkuPath } from './doc_indexer.mjs';
|
|
21
|
+
import { getSavedQuotaReceiptSummary } from '../core-isomorphic/coach/savedQuotaLedger.mjs';
|
|
22
|
+
|
|
23
|
+
export const COLD_CACHE_IDLE_GAP_MS = 300_000; // 5m TTL
|
|
24
|
+
export const OVERSIZED_READ_CHARS_THRESHOLD = 48_000; // ~1,200 lines / ~12k tokens
|
|
25
|
+
export const OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD = 16_000; // ~4k tokens
|
|
26
|
+
|
|
27
|
+
function resolveHome(options = {}) {
|
|
28
|
+
return (
|
|
29
|
+
options.homeDir ||
|
|
30
|
+
process.env.USERPROFILE ||
|
|
31
|
+
process.env.HOME ||
|
|
32
|
+
os.homedir()
|
|
33
|
+
);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function parseIsoOrNumMs(ts) {
|
|
37
|
+
if (typeof ts === 'number' && Number.isFinite(ts)) return ts;
|
|
38
|
+
if (typeof ts === 'string' && ts.trim()) {
|
|
39
|
+
const parsed = Date.parse(ts.trim());
|
|
40
|
+
if (Number.isFinite(parsed)) return parsed;
|
|
41
|
+
}
|
|
42
|
+
return 0;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function listClaudeJsonlFiles(claudeRoot, cutoffMs) {
|
|
46
|
+
const results = [];
|
|
47
|
+
if (!claudeRoot || !fs.existsSync(claudeRoot)) return results;
|
|
48
|
+
const walk = (dir, depth = 0) => {
|
|
49
|
+
if (depth > 5) return;
|
|
50
|
+
let entries = [];
|
|
51
|
+
try {
|
|
52
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
53
|
+
} catch (err) {
|
|
54
|
+
void err;
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
for (const ent of entries) {
|
|
58
|
+
if (ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') continue;
|
|
59
|
+
const full = path.join(dir, ent.name);
|
|
60
|
+
if (isForbiddenSkuPath(full)) continue;
|
|
61
|
+
if (ent.isDirectory()) {
|
|
62
|
+
walk(full, depth + 1);
|
|
63
|
+
} else if (ent.isFile() && ent.name.endsWith('.jsonl')) {
|
|
64
|
+
try {
|
|
65
|
+
const st = fs.statSync(full);
|
|
66
|
+
if (st.mtimeMs >= cutoffMs) {
|
|
67
|
+
results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.jsonl') });
|
|
68
|
+
}
|
|
69
|
+
} catch (err) {
|
|
70
|
+
void err;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
walk(claudeRoot, 0);
|
|
76
|
+
return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function listCodexJsonlFiles(codexRoot, cutoffMs) {
|
|
80
|
+
return listClaudeJsonlFiles(codexRoot, cutoffMs);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function listCursorTranscriptFiles(cursorRoot, cutoffMs) {
|
|
84
|
+
const results = [];
|
|
85
|
+
if (!cursorRoot || !fs.existsSync(cursorRoot)) return results;
|
|
86
|
+
const walk = (dir, depth = 0) => {
|
|
87
|
+
if (depth > 5) return;
|
|
88
|
+
let entries = [];
|
|
89
|
+
try {
|
|
90
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
91
|
+
} catch (err) {
|
|
92
|
+
void err;
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
for (const ent of entries) {
|
|
96
|
+
if (ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') continue;
|
|
97
|
+
const full = path.join(dir, ent.name);
|
|
98
|
+
if (isForbiddenSkuPath(full)) continue;
|
|
99
|
+
if (ent.isDirectory()) {
|
|
100
|
+
walk(full, depth + 1);
|
|
101
|
+
} else if (ent.isFile() && ent.name.endsWith('.jsonl') && dir.toLowerCase().includes('transcript')) {
|
|
102
|
+
try {
|
|
103
|
+
const st = fs.statSync(full);
|
|
104
|
+
if (st.mtimeMs >= cutoffMs) {
|
|
105
|
+
results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.jsonl') });
|
|
106
|
+
}
|
|
107
|
+
} catch (err) {
|
|
108
|
+
void err;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
};
|
|
113
|
+
walk(cursorRoot, 0);
|
|
114
|
+
return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function listGeminiSessionJsonFiles(geminiTmpRoot, cutoffMs) {
|
|
118
|
+
const results = [];
|
|
119
|
+
if (!geminiTmpRoot || !fs.existsSync(geminiTmpRoot)) return results;
|
|
120
|
+
const walk = (dir, depth = 0) => {
|
|
121
|
+
if (depth > 5) return;
|
|
122
|
+
let entries = [];
|
|
123
|
+
try {
|
|
124
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
125
|
+
} catch (err) {
|
|
126
|
+
void err;
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
for (const ent of entries) {
|
|
130
|
+
if (ent.name === 'oauth_creds.json' || ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') {
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
const full = path.join(dir, ent.name);
|
|
134
|
+
if (isForbiddenSkuPath(full)) continue;
|
|
135
|
+
if (ent.isDirectory()) {
|
|
136
|
+
walk(full, depth + 1);
|
|
137
|
+
} else if (
|
|
138
|
+
ent.isFile() &&
|
|
139
|
+
/^session-.*\.json$/i.test(ent.name) &&
|
|
140
|
+
path.basename(dir).toLowerCase() === 'chats'
|
|
141
|
+
) {
|
|
142
|
+
try {
|
|
143
|
+
const st = fs.statSync(full);
|
|
144
|
+
if (st.mtimeMs >= cutoffMs) {
|
|
145
|
+
results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.json') });
|
|
146
|
+
}
|
|
147
|
+
} catch (err) {
|
|
148
|
+
void err;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
};
|
|
153
|
+
walk(geminiTmpRoot, 0);
|
|
154
|
+
return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function listAntigravityTranscriptFiles(brainDirs, cutoffMs) {
|
|
158
|
+
const results = [];
|
|
159
|
+
const seen = new Set();
|
|
160
|
+
for (const brainRoot of brainDirs) {
|
|
161
|
+
if (!brainRoot || !fs.existsSync(brainRoot)) continue;
|
|
162
|
+
let convDirs = [];
|
|
163
|
+
try {
|
|
164
|
+
convDirs = fs.readdirSync(brainRoot, { withFileTypes: true }).filter((d) => d.isDirectory());
|
|
165
|
+
} catch (err) {
|
|
166
|
+
void err;
|
|
167
|
+
continue;
|
|
168
|
+
}
|
|
169
|
+
for (const d of convDirs) {
|
|
170
|
+
const convDir = path.join(brainRoot, d.name);
|
|
171
|
+
if (seen.has(convDir) || isForbiddenSkuPath(convDir)) continue;
|
|
172
|
+
seen.add(convDir);
|
|
173
|
+
const logsDir = path.join(convDir, '.system_generated', 'logs');
|
|
174
|
+
const fullLog = path.join(logsDir, 'transcript_full.jsonl');
|
|
175
|
+
const compactLog = path.join(logsDir, 'transcript.jsonl');
|
|
176
|
+
const chosen = fs.existsSync(fullLog) ? fullLog : fs.existsSync(compactLog) ? compactLog : null;
|
|
177
|
+
if (!chosen) continue;
|
|
178
|
+
try {
|
|
179
|
+
const st = fs.statSync(chosen);
|
|
180
|
+
if (st.mtimeMs >= cutoffMs) {
|
|
181
|
+
results.push({
|
|
182
|
+
path: chosen,
|
|
183
|
+
mtimeMs: st.mtimeMs,
|
|
184
|
+
sessionId: d.name
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
} catch (err) {
|
|
188
|
+
void err;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
function estimateSludgeCostUSD(modelId, wastedTokens, tsMs, isColdCacheWrite = false) {
|
|
196
|
+
const tok = Math.max(0, Number(wastedTokens) || 0);
|
|
197
|
+
if (tok === 0) return 0;
|
|
198
|
+
const rates = resolveModelRates(modelId || 'claude-sonnet-4-6', tsMs || Date.now(), 'standard', {
|
|
199
|
+
totalPromptTokens: tok
|
|
200
|
+
});
|
|
201
|
+
if (isColdCacheWrite) {
|
|
202
|
+
const writeDiff = Math.max(
|
|
203
|
+
0.25,
|
|
204
|
+
Number(rates.write5mPer1M || 3.75) - Number(rates.cachedReadPer1M || 0.3)
|
|
205
|
+
);
|
|
206
|
+
return Number(((tok / 1_000_000) * writeDiff).toFixed(4));
|
|
207
|
+
}
|
|
208
|
+
return Number(((tok / 1_000_000) * Number(rates.inputPer1M || 3.0)).toFixed(4));
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* Audits a single Claude Code `.jsonl` session transcript, deduplicating streaming
|
|
213
|
+
* assistant chunks by `message.id`.
|
|
214
|
+
*
|
|
215
|
+
* @param {{ path: string, sessionId: string, mtimeMs: number }} item
|
|
216
|
+
*/
|
|
217
|
+
export function scoreClaudeTranscriptFile(item) {
|
|
218
|
+
const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
|
|
219
|
+
const assistantByMsgId = new Map();
|
|
220
|
+
const orderedEvents = [];
|
|
221
|
+
let fallbackIdx = 0;
|
|
222
|
+
|
|
223
|
+
for (const line of lines) {
|
|
224
|
+
let row;
|
|
225
|
+
try {
|
|
226
|
+
row = JSON.parse(line);
|
|
227
|
+
} catch (parseErr) {
|
|
228
|
+
void parseErr;
|
|
229
|
+
continue;
|
|
230
|
+
}
|
|
231
|
+
if (!row || typeof row !== 'object') continue;
|
|
232
|
+
const tsMs = parseIsoOrNumMs(row.timestamp || row.created_at || row.createdAt);
|
|
233
|
+
|
|
234
|
+
if (row.type === 'assistant' || row.message?.role === 'assistant') {
|
|
235
|
+
const msg = row.message || row;
|
|
236
|
+
const msgId = String(msg.id || row.uuid || `anon_${++fallbackIdx}`);
|
|
237
|
+
const usage = msg.usage || row.usage || {};
|
|
238
|
+
const outTok = Math.max(0, Number(usage.output_tokens || 0));
|
|
239
|
+
const inTok = Math.max(0, Number(usage.input_tokens || 0));
|
|
240
|
+
const cacheRead = Math.max(0, Number(usage.cache_read_input_tokens || 0));
|
|
241
|
+
const cacheWrite = Math.max(
|
|
242
|
+
0,
|
|
243
|
+
Number(
|
|
244
|
+
usage.cache_creation_input_tokens ||
|
|
245
|
+
(Number(usage.cache_creation?.ephemeral_5m_input_tokens || 0) +
|
|
246
|
+
Number(usage.cache_creation?.ephemeral_1h_input_tokens || 0)) ||
|
|
247
|
+
0
|
|
248
|
+
)
|
|
249
|
+
);
|
|
250
|
+
const contentBlocks = Array.isArray(msg.content) ? msg.content : [];
|
|
251
|
+
const prior = assistantByMsgId.get(msgId);
|
|
252
|
+
if (!prior) {
|
|
253
|
+
const entry = {
|
|
254
|
+
kind: 'assistant',
|
|
255
|
+
msgId,
|
|
256
|
+
tsMs,
|
|
257
|
+
modelId: normalizeModelKey(msg.model || row.model || 'claude-sonnet-4-6') || 'claude-sonnet-4-6',
|
|
258
|
+
inputTokens: inTok,
|
|
259
|
+
outputTokens: outTok,
|
|
260
|
+
cacheReadTokens: cacheRead,
|
|
261
|
+
cacheWriteTokens: cacheWrite,
|
|
262
|
+
toolUses: contentBlocks.filter((b) => b && b.type === 'tool_use')
|
|
263
|
+
};
|
|
264
|
+
assistantByMsgId.set(msgId, entry);
|
|
265
|
+
orderedEvents.push(entry);
|
|
266
|
+
} else {
|
|
267
|
+
prior.inputTokens = Math.max(prior.inputTokens, inTok);
|
|
268
|
+
prior.outputTokens = Math.max(prior.outputTokens, outTok);
|
|
269
|
+
prior.cacheReadTokens = Math.max(prior.cacheReadTokens, cacheRead);
|
|
270
|
+
prior.cacheWriteTokens = Math.max(prior.cacheWriteTokens, cacheWrite);
|
|
271
|
+
if (tsMs > prior.tsMs) prior.tsMs = tsMs;
|
|
272
|
+
const moreTools = contentBlocks.filter((b) => b && b.type === 'tool_use');
|
|
273
|
+
if (moreTools.length > prior.toolUses.length) {
|
|
274
|
+
prior.toolUses = moreTools;
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
} else if (row.type === 'user' || row.message?.role === 'user') {
|
|
278
|
+
const content = row.message?.content ?? row.content;
|
|
279
|
+
const toolResults = Array.isArray(content)
|
|
280
|
+
? content.filter((b) => b && b.type === 'tool_result')
|
|
281
|
+
: [];
|
|
282
|
+
orderedEvents.push({
|
|
283
|
+
kind: 'user',
|
|
284
|
+
tsMs,
|
|
285
|
+
toolResults
|
|
286
|
+
});
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
let turnIndex = 0;
|
|
291
|
+
let lastAssistantTsMs = 0;
|
|
292
|
+
let consecutiveToolErrors = 0;
|
|
293
|
+
let thrashLoops = 0;
|
|
294
|
+
let coldCacheSpikes = 0;
|
|
295
|
+
let oversizedReads = 0;
|
|
296
|
+
let oversizedOutputs = 0;
|
|
297
|
+
let sludgeTaxTokens = 0;
|
|
298
|
+
let sludgeTaxUSD = 0;
|
|
299
|
+
let totalPromptTokens = 0;
|
|
300
|
+
let activeModelId = 'claude-sonnet-4-6';
|
|
301
|
+
const toolUseById = new Map();
|
|
302
|
+
const offendingTurns = [];
|
|
303
|
+
|
|
304
|
+
for (const ev of orderedEvents) {
|
|
305
|
+
if (ev.kind === 'assistant') {
|
|
306
|
+
turnIndex += 1;
|
|
307
|
+
activeModelId = ev.modelId || activeModelId;
|
|
308
|
+
totalPromptTokens += ev.inputTokens + ev.cacheReadTokens + ev.cacheWriteTokens;
|
|
309
|
+
|
|
310
|
+
for (const tu of ev.toolUses) {
|
|
311
|
+
if (tu?.id) toolUseById.set(tu.id, { name: tu.name, input: tu.input || {}, turnIndex });
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
// Detect >5m idle Cold-Cache Resume Spike
|
|
315
|
+
if (
|
|
316
|
+
lastAssistantTsMs > 0 &&
|
|
317
|
+
ev.tsMs > 0 &&
|
|
318
|
+
ev.tsMs - lastAssistantTsMs > COLD_CACHE_IDLE_GAP_MS &&
|
|
319
|
+
ev.cacheWriteTokens >= 10_000
|
|
320
|
+
) {
|
|
321
|
+
coldCacheSpikes += 1;
|
|
322
|
+
const usd = estimateSludgeCostUSD(activeModelId, ev.cacheWriteTokens, ev.tsMs, true);
|
|
323
|
+
sludgeTaxTokens += ev.cacheWriteTokens;
|
|
324
|
+
sludgeTaxUSD += usd;
|
|
325
|
+
offendingTurns.push({
|
|
326
|
+
sessionId: item.sessionId,
|
|
327
|
+
platform: 'claude',
|
|
328
|
+
turnIndex,
|
|
329
|
+
modelId: activeModelId,
|
|
330
|
+
category: 'COLD_CACHE_SPIKE',
|
|
331
|
+
wastedTokens: ev.cacheWriteTokens,
|
|
332
|
+
wastedUSD: usd,
|
|
333
|
+
citation: `${item.sessionId}#T${turnIndex} (${Math.round((ev.tsMs - lastAssistantTsMs) / 60000)}m idle gap rebuilt ${ev.cacheWriteTokens.toLocaleString('en-US')} prefix tok)`,
|
|
334
|
+
fix: 'Finish tool batch before 5m TTL expiry or compact before resuming cold threads.'
|
|
335
|
+
});
|
|
336
|
+
}
|
|
337
|
+
if (ev.tsMs > 0) lastAssistantTsMs = ev.tsMs;
|
|
338
|
+
} else if (ev.kind === 'user') {
|
|
339
|
+
for (const tr of ev.toolResults) {
|
|
340
|
+
const linked = tr.tool_use_id ? toolUseById.get(tr.tool_use_id) : null;
|
|
341
|
+
const toolName = String(linked?.name || tr.tool_name || '');
|
|
342
|
+
const toolInput = linked?.input || {};
|
|
343
|
+
const tIdx = linked?.turnIndex || Math.max(1, turnIndex);
|
|
344
|
+
const text =
|
|
345
|
+
typeof tr.content === 'string'
|
|
346
|
+
? tr.content
|
|
347
|
+
: Array.isArray(tr.content)
|
|
348
|
+
? tr.content.map((c) => (typeof c?.text === 'string' ? c.text : '')).join('\n')
|
|
349
|
+
: '';
|
|
350
|
+
|
|
351
|
+
const isError = Boolean(tr.is_error);
|
|
352
|
+
if (isError) {
|
|
353
|
+
consecutiveToolErrors += 1;
|
|
354
|
+
if (consecutiveToolErrors === 3) {
|
|
355
|
+
thrashLoops += 1;
|
|
356
|
+
const thrashTok = 6_000;
|
|
357
|
+
const usd = estimateSludgeCostUSD(activeModelId, thrashTok, ev.tsMs, false);
|
|
358
|
+
sludgeTaxTokens += thrashTok;
|
|
359
|
+
sludgeTaxUSD += usd;
|
|
360
|
+
offendingTurns.push({
|
|
361
|
+
sessionId: item.sessionId,
|
|
362
|
+
platform: 'claude',
|
|
363
|
+
turnIndex: tIdx,
|
|
364
|
+
modelId: activeModelId,
|
|
365
|
+
category: 'THRASH_3X_LOOP',
|
|
366
|
+
wastedTokens: thrashTok,
|
|
367
|
+
wastedUSD: usd,
|
|
368
|
+
citation: `${item.sessionId}#T${tIdx} (3 consecutive failed ${toolName || 'tool'} calls)`,
|
|
369
|
+
fix: 'Enable Active Shield (`ctxtop shield --enable`) to halt 3x failure loops and inspect error lines first.'
|
|
370
|
+
});
|
|
371
|
+
}
|
|
372
|
+
} else {
|
|
373
|
+
consecutiveToolErrors = 0;
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
const isRead = /^Read$/i.test(toolName);
|
|
377
|
+
const hasSlice = toolInput.offset !== undefined || toolInput.limit !== undefined || toolInput.pages !== undefined;
|
|
378
|
+
if (isRead && !hasSlice && text.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
|
|
379
|
+
oversizedReads += 1;
|
|
380
|
+
const estTok = Math.max(0, Math.ceil(text.length / 4) - 600);
|
|
381
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, ev.tsMs, false);
|
|
382
|
+
sludgeTaxTokens += estTok;
|
|
383
|
+
sludgeTaxUSD += usd;
|
|
384
|
+
offendingTurns.push({
|
|
385
|
+
sessionId: item.sessionId,
|
|
386
|
+
platform: 'claude',
|
|
387
|
+
turnIndex: tIdx,
|
|
388
|
+
modelId: activeModelId,
|
|
389
|
+
category: 'UNSLICED_LARGE_READ',
|
|
390
|
+
wastedTokens: estTok,
|
|
391
|
+
wastedUSD: usd,
|
|
392
|
+
citation: `${item.sessionId}#T${tIdx} (un-sliced Read of ${path.basename(String(toolInput.file_path || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
|
|
393
|
+
fix: 'Run `ctxtop shield --enable` to auto-index files >1,200 lines and enforce offset/limit slices.'
|
|
394
|
+
});
|
|
395
|
+
} else if (!isRead && text.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
|
|
396
|
+
oversizedOutputs += 1;
|
|
397
|
+
const estTok = Math.max(0, Math.ceil(text.length / 4) - 350);
|
|
398
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, ev.tsMs, false);
|
|
399
|
+
sludgeTaxTokens += estTok;
|
|
400
|
+
sludgeTaxUSD += usd;
|
|
401
|
+
offendingTurns.push({
|
|
402
|
+
sessionId: item.sessionId,
|
|
403
|
+
platform: 'claude',
|
|
404
|
+
turnIndex: tIdx,
|
|
405
|
+
modelId: activeModelId,
|
|
406
|
+
category: 'OVERSIZED_TOOL_DUMP',
|
|
407
|
+
wastedTokens: estTok,
|
|
408
|
+
wastedUSD: usd,
|
|
409
|
+
citation: `${item.sessionId}#T${tIdx} (${toolName || 'Bash'} dumped ~${Math.ceil(text.length / 4).toLocaleString('en-US')} raw tok)`,
|
|
410
|
+
fix: 'Enable Highbeam PostToolUse sanitizer (`ctxtop shield --enable`) to offload >4k-token logs with 100% error recovery.'
|
|
411
|
+
});
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
return {
|
|
418
|
+
sessionId: item.sessionId,
|
|
419
|
+
platform: 'claude',
|
|
420
|
+
transcriptPath: item.path,
|
|
421
|
+
turns: turnIndex,
|
|
422
|
+
totalPromptTokens,
|
|
423
|
+
sludgeTaxTokens,
|
|
424
|
+
sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
|
|
425
|
+
coldCacheSpikes,
|
|
426
|
+
thrashLoops,
|
|
427
|
+
oversizedReads,
|
|
428
|
+
oversizedOutputs,
|
|
429
|
+
offendingTurns
|
|
430
|
+
};
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* Audits a single Antigravity `transcript_full.jsonl` / `transcript.jsonl` session file.
|
|
435
|
+
*
|
|
436
|
+
* @param {{ path: string, sessionId: string, mtimeMs: number }} item
|
|
437
|
+
*/
|
|
438
|
+
export function scoreAntigravityTranscriptFile(item) {
|
|
439
|
+
const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
|
|
440
|
+
let turnIndex = 0;
|
|
441
|
+
let lastStepTsMs = 0;
|
|
442
|
+
let consecutiveErrors = 0;
|
|
443
|
+
let thrashLoops = 0;
|
|
444
|
+
let coldCacheSpikes = 0;
|
|
445
|
+
let oversizedReads = 0;
|
|
446
|
+
let oversizedOutputs = 0;
|
|
447
|
+
let sludgeTaxTokens = 0;
|
|
448
|
+
let sludgeTaxUSD = 0;
|
|
449
|
+
let cumulativeContextTokens = 0;
|
|
450
|
+
let activeModelId = 'gemini-4-carbon';
|
|
451
|
+
let lastToolCall = null;
|
|
452
|
+
const offendingTurns = [];
|
|
453
|
+
|
|
454
|
+
for (const line of lines) {
|
|
455
|
+
let step;
|
|
456
|
+
try {
|
|
457
|
+
step = JSON.parse(line);
|
|
458
|
+
} catch (parseErr) {
|
|
459
|
+
void parseErr;
|
|
460
|
+
continue;
|
|
461
|
+
}
|
|
462
|
+
if (!step || typeof step !== 'object') continue;
|
|
463
|
+
const tsMs = parseIsoOrNumMs(step.created_at || step.timestamp);
|
|
464
|
+
if (step.model || step.modelName) {
|
|
465
|
+
activeModelId = normalizeModelKey(step.model || step.modelName) || activeModelId;
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
const stepType = String(step.type || '').toUpperCase();
|
|
469
|
+
const contentStr =
|
|
470
|
+
typeof step.content === 'string'
|
|
471
|
+
? step.content
|
|
472
|
+
: step.content
|
|
473
|
+
? JSON.stringify(step.content)
|
|
474
|
+
: '';
|
|
475
|
+
const contentTok = Math.ceil(contentStr.length / 4);
|
|
476
|
+
const modelCeiling = resolveModelCeiling(activeModelId) || 256_000;
|
|
477
|
+
|
|
478
|
+
if (
|
|
479
|
+
stepType.includes('COMPACT') ||
|
|
480
|
+
(stepType === 'USER_INPUT' && /^\s*\/compact\b/i.test(contentStr))
|
|
481
|
+
) {
|
|
482
|
+
cumulativeContextTokens = Math.min(cumulativeContextTokens, 16_000);
|
|
483
|
+
}
|
|
484
|
+
|
|
485
|
+
if (stepType === 'PLANNER_RESPONSE' || Array.isArray(step.tool_calls)) {
|
|
486
|
+
turnIndex += 1;
|
|
487
|
+
const activeWindowTok = Math.min(cumulativeContextTokens, modelCeiling);
|
|
488
|
+
if (
|
|
489
|
+
lastStepTsMs > 0 &&
|
|
490
|
+
tsMs > 0 &&
|
|
491
|
+
tsMs - lastStepTsMs > COLD_CACHE_IDLE_GAP_MS &&
|
|
492
|
+
activeWindowTok >= 15_000
|
|
493
|
+
) {
|
|
494
|
+
coldCacheSpikes += 1;
|
|
495
|
+
const usd = estimateSludgeCostUSD(activeModelId, activeWindowTok, tsMs, true);
|
|
496
|
+
sludgeTaxTokens += activeWindowTok;
|
|
497
|
+
sludgeTaxUSD += usd;
|
|
498
|
+
offendingTurns.push({
|
|
499
|
+
sessionId: item.sessionId,
|
|
500
|
+
platform: 'antigravity',
|
|
501
|
+
turnIndex,
|
|
502
|
+
modelId: activeModelId,
|
|
503
|
+
category: 'COLD_CACHE_SPIKE',
|
|
504
|
+
wastedTokens: activeWindowTok,
|
|
505
|
+
wastedUSD: usd,
|
|
506
|
+
citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastStepTsMs) / 60000)}m idle gap on ~${activeWindowTok.toLocaleString('en-US')}-tok context)`,
|
|
507
|
+
fix: 'Compact or checkpoint to task.md before >5m idle pauses to avoid cold-prefix rebuild spikes.'
|
|
508
|
+
});
|
|
509
|
+
}
|
|
510
|
+
if (tsMs > 0) lastStepTsMs = tsMs;
|
|
511
|
+
const calls = Array.isArray(step.tool_calls) ? step.tool_calls : [];
|
|
512
|
+
lastToolCall = calls.length > 0 ? calls[0] : null;
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
cumulativeContextTokens = Math.min(modelCeiling, cumulativeContextTokens + contentTok);
|
|
516
|
+
|
|
517
|
+
const statusUpper = String(step.status || '').toUpperCase();
|
|
518
|
+
const failed =
|
|
519
|
+
statusUpper === 'ERROR' ||
|
|
520
|
+
/Command exited with code [1-9]/i.test(contentStr);
|
|
521
|
+
if (failed) {
|
|
522
|
+
consecutiveErrors += 1;
|
|
523
|
+
if (consecutiveErrors === 3) {
|
|
524
|
+
thrashLoops += 1;
|
|
525
|
+
const thrashTok = 6_000;
|
|
526
|
+
const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
|
|
527
|
+
sludgeTaxTokens += thrashTok;
|
|
528
|
+
sludgeTaxUSD += usd;
|
|
529
|
+
offendingTurns.push({
|
|
530
|
+
sessionId: item.sessionId,
|
|
531
|
+
platform: 'antigravity',
|
|
532
|
+
turnIndex: Math.max(1, turnIndex),
|
|
533
|
+
modelId: activeModelId,
|
|
534
|
+
category: 'THRASH_3X_LOOP',
|
|
535
|
+
wastedTokens: thrashTok,
|
|
536
|
+
wastedUSD: usd,
|
|
537
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (3 consecutive tool/command errors)`,
|
|
538
|
+
fix: 'Pause blind retries after 2 failures and inspect the indexed error log.'
|
|
539
|
+
});
|
|
540
|
+
}
|
|
541
|
+
} else if (stepType.includes('TOOL') || contentStr.includes('Command exited with code 0')) {
|
|
542
|
+
consecutiveErrors = 0;
|
|
543
|
+
}
|
|
544
|
+
|
|
545
|
+
const callName = String(lastToolCall?.name || lastToolCall?.tool_name || '');
|
|
546
|
+
const callArgs = lastToolCall?.args || lastToolCall?.parameters || lastToolCall?.arguments || {};
|
|
547
|
+
const isRead = /^(?:default_api:)?(?:read_file|view_file)$/i.test(callName);
|
|
548
|
+
const hasBounds =
|
|
549
|
+
callArgs.StartLine !== undefined ||
|
|
550
|
+
callArgs.EndLine !== undefined ||
|
|
551
|
+
callArgs.offset !== undefined ||
|
|
552
|
+
callArgs.limit !== undefined;
|
|
553
|
+
|
|
554
|
+
if (stepType !== 'PLANNER_RESPONSE' && stepType !== 'USER_INPUT' && contentStr.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
|
|
555
|
+
if (isRead && !hasBounds && contentStr.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
|
|
556
|
+
oversizedReads += 1;
|
|
557
|
+
const estTok = Math.max(0, contentTok - 600);
|
|
558
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
559
|
+
sludgeTaxTokens += estTok;
|
|
560
|
+
sludgeTaxUSD += usd;
|
|
561
|
+
offendingTurns.push({
|
|
562
|
+
sessionId: item.sessionId,
|
|
563
|
+
platform: 'antigravity',
|
|
564
|
+
turnIndex: Math.max(1, turnIndex),
|
|
565
|
+
modelId: activeModelId,
|
|
566
|
+
category: 'UNSLICED_LARGE_READ',
|
|
567
|
+
wastedTokens: estTok,
|
|
568
|
+
wastedUSD: usd,
|
|
569
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (un-sliced ${callName || 'read_file'} of ${path.basename(String(callArgs.Path || callArgs.AbsolutePath || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
|
|
570
|
+
fix: 'Enable Active Shield (`ctxtop shield --enable`) to index >1,200-line files and enforce StartLine/EndLine.'
|
|
571
|
+
});
|
|
572
|
+
} else if (!isRead) {
|
|
573
|
+
oversizedOutputs += 1;
|
|
574
|
+
const estTok = Math.max(0, contentTok - 350);
|
|
575
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
576
|
+
sludgeTaxTokens += estTok;
|
|
577
|
+
sludgeTaxUSD += usd;
|
|
578
|
+
offendingTurns.push({
|
|
579
|
+
sessionId: item.sessionId,
|
|
580
|
+
platform: 'antigravity',
|
|
581
|
+
turnIndex: Math.max(1, turnIndex),
|
|
582
|
+
modelId: activeModelId,
|
|
583
|
+
category: 'OVERSIZED_TOOL_DUMP',
|
|
584
|
+
wastedTokens: estTok,
|
|
585
|
+
wastedUSD: usd,
|
|
586
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (~${contentTok.toLocaleString('en-US')} raw tool output tok)`,
|
|
587
|
+
fix: 'Pipe verbose test/grep commands or enable Highbeam output compaction.'
|
|
588
|
+
});
|
|
589
|
+
}
|
|
590
|
+
lastToolCall = null;
|
|
591
|
+
}
|
|
592
|
+
}
|
|
593
|
+
|
|
594
|
+
return {
|
|
595
|
+
sessionId: item.sessionId,
|
|
596
|
+
platform: 'antigravity',
|
|
597
|
+
transcriptPath: item.path,
|
|
598
|
+
turns: turnIndex,
|
|
599
|
+
totalPromptTokens: cumulativeContextTokens,
|
|
600
|
+
sludgeTaxTokens,
|
|
601
|
+
sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
|
|
602
|
+
coldCacheSpikes,
|
|
603
|
+
thrashLoops,
|
|
604
|
+
oversizedReads,
|
|
605
|
+
oversizedOutputs,
|
|
606
|
+
offendingTurns
|
|
607
|
+
};
|
|
608
|
+
}
|
|
609
|
+
|
|
610
|
+
function scoreGenericJsonlEvents(item, platformName, defaultModelId) {
|
|
611
|
+
const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
|
|
612
|
+
let turnIndex = 0;
|
|
613
|
+
let lastTurnTsMs = 0;
|
|
614
|
+
let consecutiveErrors = 0;
|
|
615
|
+
let thrashLoops = 0;
|
|
616
|
+
let coldCacheSpikes = 0;
|
|
617
|
+
let oversizedReads = 0;
|
|
618
|
+
let oversizedOutputs = 0;
|
|
619
|
+
let sludgeTaxTokens = 0;
|
|
620
|
+
let sludgeTaxUSD = 0;
|
|
621
|
+
let totalPromptTokens = 0;
|
|
622
|
+
let cumulativeContextTokens = 0;
|
|
623
|
+
let activeModelId = defaultModelId;
|
|
624
|
+
const callById = new Map();
|
|
625
|
+
const offendingTurns = [];
|
|
626
|
+
|
|
627
|
+
for (const line of lines) {
|
|
628
|
+
let row;
|
|
629
|
+
try {
|
|
630
|
+
row = JSON.parse(line);
|
|
631
|
+
} catch (parseErr) {
|
|
632
|
+
void parseErr;
|
|
633
|
+
continue;
|
|
634
|
+
}
|
|
635
|
+
if (!row || typeof row !== 'object') continue;
|
|
636
|
+
const tsMs = parseIsoOrNumMs(row.timestamp || row.created_at || row.createdAt);
|
|
637
|
+
const payload = row.payload && typeof row.payload === 'object' ? row.payload : row;
|
|
638
|
+
const rawModel = payload.model || row.model || payload.info?.model;
|
|
639
|
+
if (rawModel) {
|
|
640
|
+
activeModelId = normalizeModelKey(rawModel) || activeModelId;
|
|
641
|
+
}
|
|
642
|
+
|
|
643
|
+
const rowType = String(row.type || payload.type || '').toLowerCase();
|
|
644
|
+
const role = String(payload.role || row.role || '').toLowerCase();
|
|
645
|
+
|
|
646
|
+
if (rowType === 'token_count' && payload.info?.total_token_usage) {
|
|
647
|
+
const u = payload.info.total_token_usage;
|
|
648
|
+
const inTok = Number(u.input_tokens || 0) + Number(u.cached_input_tokens || 0);
|
|
649
|
+
if (inTok > cumulativeContextTokens) {
|
|
650
|
+
cumulativeContextTokens = inTok;
|
|
651
|
+
totalPromptTokens += inTok;
|
|
652
|
+
}
|
|
653
|
+
continue;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
if (role === 'assistant' || rowType === 'assistant' || rowType === 'agent_message' || rowType === 'turn_started') {
|
|
657
|
+
turnIndex += 1;
|
|
658
|
+
const u = payload.usage || row.usage || {};
|
|
659
|
+
const stepIn = Number(u.input_tokens || 0) + Number(u.cache_read_input_tokens || 0) + Number(u.cache_creation_input_tokens || 0);
|
|
660
|
+
if (stepIn > 0) {
|
|
661
|
+
totalPromptTokens += stepIn;
|
|
662
|
+
cumulativeContextTokens = Math.max(cumulativeContextTokens, stepIn);
|
|
663
|
+
}
|
|
664
|
+
if (lastTurnTsMs > 0 && tsMs > 0 && tsMs - lastTurnTsMs > COLD_CACHE_IDLE_GAP_MS && cumulativeContextTokens >= 15_000) {
|
|
665
|
+
coldCacheSpikes += 1;
|
|
666
|
+
const usd = estimateSludgeCostUSD(activeModelId, cumulativeContextTokens, tsMs, true);
|
|
667
|
+
sludgeTaxTokens += cumulativeContextTokens;
|
|
668
|
+
sludgeTaxUSD += usd;
|
|
669
|
+
offendingTurns.push({
|
|
670
|
+
sessionId: item.sessionId,
|
|
671
|
+
platform: platformName,
|
|
672
|
+
turnIndex,
|
|
673
|
+
modelId: activeModelId,
|
|
674
|
+
category: 'COLD_CACHE_SPIKE',
|
|
675
|
+
wastedTokens: cumulativeContextTokens,
|
|
676
|
+
wastedUSD: usd,
|
|
677
|
+
citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastTurnTsMs) / 60000)}m idle gap on ~${cumulativeContextTokens.toLocaleString('en-US')}-tok context)`,
|
|
678
|
+
fix: 'Compact or save a handoff checkpoint before >5m idle pauses to avoid cold-prefix rebuilds.'
|
|
679
|
+
});
|
|
680
|
+
}
|
|
681
|
+
if (tsMs > 0) lastTurnTsMs = tsMs;
|
|
682
|
+
}
|
|
683
|
+
|
|
684
|
+
if (rowType === 'function_call' || rowType === 'tool_use') {
|
|
685
|
+
const cid = payload.call_id || payload.id || '';
|
|
686
|
+
const cname = String(payload.name || payload.tool_name || '');
|
|
687
|
+
let cargs = payload.arguments ?? payload.input ?? {};
|
|
688
|
+
if (typeof cargs === 'string') {
|
|
689
|
+
try {
|
|
690
|
+
cargs = JSON.parse(cargs);
|
|
691
|
+
} catch (argErr) {
|
|
692
|
+
void argErr;
|
|
693
|
+
cargs = {};
|
|
694
|
+
}
|
|
695
|
+
}
|
|
696
|
+
if (cid) callById.set(cid, { name: cname, args: cargs, turnIndex: Math.max(1, turnIndex) });
|
|
697
|
+
continue;
|
|
698
|
+
}
|
|
699
|
+
|
|
700
|
+
if (rowType === 'function_call_output' || rowType === 'tool_result' || role === 'tool') {
|
|
701
|
+
const cid = payload.call_id || payload.tool_use_id || '';
|
|
702
|
+
const linked = cid ? callById.get(cid) : null;
|
|
703
|
+
const toolName = String(linked?.name || payload.name || payload.tool_name || '');
|
|
704
|
+
const toolArgs = linked?.args || {};
|
|
705
|
+
const tIdx = linked?.turnIndex || Math.max(1, turnIndex);
|
|
706
|
+
const outputText = typeof payload.output === 'string'
|
|
707
|
+
? payload.output
|
|
708
|
+
: typeof payload.content === 'string'
|
|
709
|
+
? payload.content
|
|
710
|
+
: JSON.stringify(payload.output ?? payload.content ?? '');
|
|
711
|
+
const contentTok = Math.ceil(outputText.length / 4);
|
|
712
|
+
cumulativeContextTokens += contentTok;
|
|
713
|
+
totalPromptTokens += contentTok;
|
|
714
|
+
|
|
715
|
+
const failed = Boolean(payload.is_error || payload.error || /Exit code:\s*[1-9]|Command exited with code [1-9]/i.test(outputText));
|
|
716
|
+
if (failed) {
|
|
717
|
+
consecutiveErrors += 1;
|
|
718
|
+
if (consecutiveErrors === 3) {
|
|
719
|
+
thrashLoops += 1;
|
|
720
|
+
const thrashTok = 6_000;
|
|
721
|
+
const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
|
|
722
|
+
sludgeTaxTokens += thrashTok;
|
|
723
|
+
sludgeTaxUSD += usd;
|
|
724
|
+
offendingTurns.push({
|
|
725
|
+
sessionId: item.sessionId,
|
|
726
|
+
platform: platformName,
|
|
727
|
+
turnIndex: tIdx,
|
|
728
|
+
modelId: activeModelId,
|
|
729
|
+
category: 'THRASH_3X_LOOP',
|
|
730
|
+
wastedTokens: thrashTok,
|
|
731
|
+
wastedUSD: usd,
|
|
732
|
+
citation: `${item.sessionId}#T${tIdx} (3 consecutive ${toolName || 'tool'} failures)`,
|
|
733
|
+
fix: 'Inspect the failing assertion digest via Highbeam MCP or FTS5 search before retrying.'
|
|
734
|
+
});
|
|
735
|
+
}
|
|
736
|
+
} else {
|
|
737
|
+
consecutiveErrors = 0;
|
|
738
|
+
}
|
|
739
|
+
|
|
740
|
+
const isRead = /^(?:read_file|Read|view_file|cat)$/i.test(toolName);
|
|
741
|
+
const hasBounds = toolArgs.offset !== undefined || toolArgs.limit !== undefined || toolArgs.StartLine !== undefined || toolArgs.EndLine !== undefined;
|
|
742
|
+
if (isRead && !hasBounds && outputText.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
|
|
743
|
+
oversizedReads += 1;
|
|
744
|
+
const estTok = Math.max(0, contentTok - 600);
|
|
745
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
746
|
+
sludgeTaxTokens += estTok;
|
|
747
|
+
sludgeTaxUSD += usd;
|
|
748
|
+
offendingTurns.push({
|
|
749
|
+
sessionId: item.sessionId,
|
|
750
|
+
platform: platformName,
|
|
751
|
+
turnIndex: tIdx,
|
|
752
|
+
modelId: activeModelId,
|
|
753
|
+
category: 'UNSLICED_LARGE_READ',
|
|
754
|
+
wastedTokens: estTok,
|
|
755
|
+
wastedUSD: usd,
|
|
756
|
+
citation: `${item.sessionId}#T${tIdx} (un-sliced read of ${path.basename(String(toolArgs.file_path || toolArgs.path || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
|
|
757
|
+
fix: 'Read bounded line ranges (<=150 lines) instead of full large files.'
|
|
758
|
+
});
|
|
759
|
+
} else if (!isRead && outputText.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
|
|
760
|
+
oversizedOutputs += 1;
|
|
761
|
+
const estTok = Math.max(0, contentTok - 350);
|
|
762
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
763
|
+
sludgeTaxTokens += estTok;
|
|
764
|
+
sludgeTaxUSD += usd;
|
|
765
|
+
offendingTurns.push({
|
|
766
|
+
sessionId: item.sessionId,
|
|
767
|
+
platform: platformName,
|
|
768
|
+
turnIndex: tIdx,
|
|
769
|
+
modelId: activeModelId,
|
|
770
|
+
category: 'OVERSIZED_TOOL_DUMP',
|
|
771
|
+
wastedTokens: estTok,
|
|
772
|
+
wastedUSD: usd,
|
|
773
|
+
citation: `${item.sessionId}#T${tIdx} (${toolName || 'CLI'} dumped ~${contentTok.toLocaleString('en-US')} raw tok)`,
|
|
774
|
+
fix: 'Compress noisy CLI dumps via Highbeam FTS5 compressor (`horizon_compress_cli`).'
|
|
775
|
+
});
|
|
776
|
+
}
|
|
777
|
+
}
|
|
778
|
+
}
|
|
779
|
+
|
|
780
|
+
return {
|
|
781
|
+
sessionId: item.sessionId,
|
|
782
|
+
platform: platformName,
|
|
783
|
+
transcriptPath: item.path,
|
|
784
|
+
turns: turnIndex,
|
|
785
|
+
totalPromptTokens,
|
|
786
|
+
sludgeTaxTokens,
|
|
787
|
+
sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
|
|
788
|
+
coldCacheSpikes,
|
|
789
|
+
thrashLoops,
|
|
790
|
+
oversizedReads,
|
|
791
|
+
oversizedOutputs,
|
|
792
|
+
offendingTurns
|
|
793
|
+
};
|
|
794
|
+
}
|
|
795
|
+
|
|
796
|
+
export function scoreCodexTranscriptFile(item) {
|
|
797
|
+
return scoreGenericJsonlEvents(item, 'codex', 'claude-sonnet-4-6');
|
|
798
|
+
}
|
|
799
|
+
|
|
800
|
+
export function scoreCursorTranscriptFile(item) {
|
|
801
|
+
return scoreGenericJsonlEvents(item, 'cursor', 'claude-sonnet-4-6');
|
|
802
|
+
}
|
|
803
|
+
|
|
804
|
+
/**
|
|
805
|
+
* Audits a single Gemini CLI `~/.gemini/tmp/<hash>/chats/session-*.json` transcript read-only.
|
|
806
|
+
*/
|
|
807
|
+
export function scoreGeminiSessionFile(item) {
|
|
808
|
+
const raw = JSON.parse(fs.readFileSync(item.path, 'utf8'));
|
|
809
|
+
const messages = Array.isArray(raw?.messages) ? raw.messages : [];
|
|
810
|
+
let turnIndex = 0;
|
|
811
|
+
let lastTsMs = 0;
|
|
812
|
+
let consecutiveErrors = 0;
|
|
813
|
+
let thrashLoops = 0;
|
|
814
|
+
let coldCacheSpikes = 0;
|
|
815
|
+
let oversizedReads = 0;
|
|
816
|
+
let oversizedOutputs = 0;
|
|
817
|
+
let sludgeTaxTokens = 0;
|
|
818
|
+
let sludgeTaxUSD = 0;
|
|
819
|
+
let totalPromptTokens = 0;
|
|
820
|
+
let activeModelId = 'gemini-4-carbon';
|
|
821
|
+
const offendingTurns = [];
|
|
822
|
+
|
|
823
|
+
for (const msg of messages) {
|
|
824
|
+
if (!msg || typeof msg !== 'object') continue;
|
|
825
|
+
const tsMs = parseIsoOrNumMs(msg.timestamp || msg.createdAt);
|
|
826
|
+
if (msg.model) {
|
|
827
|
+
activeModelId = normalizeModelKey(msg.model) || activeModelId;
|
|
828
|
+
}
|
|
829
|
+
const msgType = String(msg.type || '').toLowerCase();
|
|
830
|
+
if (msgType === 'gemini' || msgType === 'model') {
|
|
831
|
+
turnIndex += 1;
|
|
832
|
+
const inTok = Number(msg.tokens?.input || 0);
|
|
833
|
+
totalPromptTokens += inTok;
|
|
834
|
+
if (lastTsMs > 0 && tsMs > 0 && tsMs - lastTsMs > COLD_CACHE_IDLE_GAP_MS && inTok >= 15_000) {
|
|
835
|
+
coldCacheSpikes += 1;
|
|
836
|
+
const usd = estimateSludgeCostUSD(activeModelId, inTok, tsMs, true);
|
|
837
|
+
sludgeTaxTokens += inTok;
|
|
838
|
+
sludgeTaxUSD += usd;
|
|
839
|
+
offendingTurns.push({
|
|
840
|
+
sessionId: item.sessionId,
|
|
841
|
+
platform: 'gemini',
|
|
842
|
+
turnIndex,
|
|
843
|
+
modelId: activeModelId,
|
|
844
|
+
category: 'COLD_CACHE_SPIKE',
|
|
845
|
+
wastedTokens: inTok,
|
|
846
|
+
wastedUSD: usd,
|
|
847
|
+
citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastTsMs) / 60000)}m idle gap on ~${inTok.toLocaleString('en-US')}-tok context)`,
|
|
848
|
+
fix: 'Compact or save checkpoint before >5m pauses to preserve warm KV prefix.'
|
|
849
|
+
});
|
|
850
|
+
}
|
|
851
|
+
if (tsMs > 0) lastTsMs = tsMs;
|
|
852
|
+
}
|
|
853
|
+
|
|
854
|
+
const toolCalls = Array.isArray(msg.toolCalls) ? msg.toolCalls : [];
|
|
855
|
+
for (const tc of toolCalls) {
|
|
856
|
+
const toolName = String(tc.name || '');
|
|
857
|
+
const toolArgs = tc.args && typeof tc.args === 'object' ? tc.args : {};
|
|
858
|
+
const outStr = typeof tc.result === 'string'
|
|
859
|
+
? tc.result
|
|
860
|
+
: Array.isArray(tc.result)
|
|
861
|
+
? tc.result.map((r) => (typeof r === 'string' ? r : JSON.stringify(r))).join('\n')
|
|
862
|
+
: JSON.stringify(tc.result ?? '');
|
|
863
|
+
const tok = Math.ceil(outStr.length / 4);
|
|
864
|
+
const isErr = String(tc.status || '').toLowerCase() === 'error';
|
|
865
|
+
if (isErr) {
|
|
866
|
+
consecutiveErrors += 1;
|
|
867
|
+
if (consecutiveErrors === 3) {
|
|
868
|
+
thrashLoops += 1;
|
|
869
|
+
const thrashTok = 6_000;
|
|
870
|
+
const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
|
|
871
|
+
sludgeTaxTokens += thrashTok;
|
|
872
|
+
sludgeTaxUSD += usd;
|
|
873
|
+
offendingTurns.push({
|
|
874
|
+
sessionId: item.sessionId,
|
|
875
|
+
platform: 'gemini',
|
|
876
|
+
turnIndex: Math.max(1, turnIndex),
|
|
877
|
+
modelId: activeModelId,
|
|
878
|
+
category: 'THRASH_3X_LOOP',
|
|
879
|
+
wastedTokens: thrashTok,
|
|
880
|
+
wastedUSD: usd,
|
|
881
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (3 consecutive ${toolName || 'tool'} failures)`,
|
|
882
|
+
fix: 'Pause retries and inspect root cause via FTS5 search.'
|
|
883
|
+
});
|
|
884
|
+
}
|
|
885
|
+
} else {
|
|
886
|
+
consecutiveErrors = 0;
|
|
887
|
+
}
|
|
888
|
+
|
|
889
|
+
const isRead = /^(?:read_file|Read|view_file)$/i.test(toolName);
|
|
890
|
+
const hasSlice = toolArgs.offset !== undefined || toolArgs.limit !== undefined || toolArgs.StartLine !== undefined;
|
|
891
|
+
if (isRead && !hasSlice && outStr.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
|
|
892
|
+
oversizedReads += 1;
|
|
893
|
+
const estTok = Math.max(0, tok - 600);
|
|
894
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
895
|
+
sludgeTaxTokens += estTok;
|
|
896
|
+
sludgeTaxUSD += usd;
|
|
897
|
+
offendingTurns.push({
|
|
898
|
+
sessionId: item.sessionId,
|
|
899
|
+
platform: 'gemini',
|
|
900
|
+
turnIndex: Math.max(1, turnIndex),
|
|
901
|
+
modelId: activeModelId,
|
|
902
|
+
category: 'UNSLICED_LARGE_READ',
|
|
903
|
+
wastedTokens: estTok,
|
|
904
|
+
wastedUSD: usd,
|
|
905
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (un-sliced read, ~${estTok.toLocaleString('en-US')} excess tok)`,
|
|
906
|
+
fix: 'Use bounded line offsets on large source files.'
|
|
907
|
+
});
|
|
908
|
+
} else if (!isRead && outStr.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
|
|
909
|
+
oversizedOutputs += 1;
|
|
910
|
+
const estTok = Math.max(0, tok - 350);
|
|
911
|
+
const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
|
|
912
|
+
sludgeTaxTokens += estTok;
|
|
913
|
+
sludgeTaxUSD += usd;
|
|
914
|
+
offendingTurns.push({
|
|
915
|
+
sessionId: item.sessionId,
|
|
916
|
+
platform: 'gemini',
|
|
917
|
+
turnIndex: Math.max(1, turnIndex),
|
|
918
|
+
modelId: activeModelId,
|
|
919
|
+
category: 'OVERSIZED_TOOL_DUMP',
|
|
920
|
+
wastedTokens: estTok,
|
|
921
|
+
wastedUSD: usd,
|
|
922
|
+
citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (${toolName || 'shell'} dumped ~${tok.toLocaleString('en-US')} raw tok)`,
|
|
923
|
+
fix: 'Enable Highbeam MCP output compression (`horizon_compress_cli`).'
|
|
924
|
+
});
|
|
925
|
+
}
|
|
926
|
+
}
|
|
927
|
+
}
|
|
928
|
+
|
|
929
|
+
return {
|
|
930
|
+
sessionId: item.sessionId,
|
|
931
|
+
platform: 'gemini',
|
|
932
|
+
transcriptPath: item.path,
|
|
933
|
+
turns: turnIndex,
|
|
934
|
+
totalPromptTokens,
|
|
935
|
+
sludgeTaxTokens,
|
|
936
|
+
sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
|
|
937
|
+
coldCacheSpikes,
|
|
938
|
+
thrashLoops,
|
|
939
|
+
oversizedReads,
|
|
940
|
+
oversizedOutputs,
|
|
941
|
+
offendingTurns
|
|
942
|
+
};
|
|
943
|
+
}
|
|
944
|
+
|
|
945
|
+
/**
|
|
946
|
+
* Runs a zero-write cross-platform audit across historical Antigravity, Claude Code, Codex CLI,
|
|
947
|
+
* Gemini CLI, and Cursor sessions.
|
|
948
|
+
*
|
|
949
|
+
* @param {object} [options={}]
|
|
950
|
+
* @param {'all' | 'antigravity' | 'claude' | 'codex' | 'gemini' | 'cursor'} [options.platform='all']
|
|
951
|
+
*/
|
|
952
|
+
export function runSessionAudit(options = {}) {
|
|
953
|
+
const rawPlatform = String(options.platform || 'all').toLowerCase();
|
|
954
|
+
const platform = rawPlatform === 'gemini-cli' ? 'gemini' : rawPlatform;
|
|
955
|
+
const days = Math.max(1, Number(options.days) || 7);
|
|
956
|
+
const limit = Math.max(1, Number(options.limit) || 10);
|
|
957
|
+
const nowMs = Number(options.nowMs) || Date.now();
|
|
958
|
+
const cutoffMs = nowMs - days * 86_400_000;
|
|
959
|
+
const home = resolveHome(options);
|
|
960
|
+
const baseCwd = path.resolve(options.cwd || process.cwd());
|
|
961
|
+
|
|
962
|
+
const includeAg = platform === 'all' || platform === 'antigravity';
|
|
963
|
+
const includeClaude = platform === 'all' || platform === 'claude';
|
|
964
|
+
const includeCodex = platform === 'all' || platform === 'codex';
|
|
965
|
+
const includeGemini = platform === 'all' || platform === 'gemini';
|
|
966
|
+
const includeCursor = platform === 'all' || platform === 'cursor';
|
|
967
|
+
|
|
968
|
+
const agDirs = Array.isArray(options.antigravityDirs)
|
|
969
|
+
? options.antigravityDirs
|
|
970
|
+
: [
|
|
971
|
+
path.join(home, '.gemini', 'antigravity', 'brain'),
|
|
972
|
+
path.join(home, '.gemini', 'antigravity-cli', 'brain')
|
|
973
|
+
];
|
|
974
|
+
const claudeDir =
|
|
975
|
+
options.claudeProjectsDir || path.join(home, '.claude', 'projects');
|
|
976
|
+
const codexDir =
|
|
977
|
+
options.codexSessionsDir || path.join(home, '.codex', 'sessions');
|
|
978
|
+
const geminiTmpDir =
|
|
979
|
+
options.geminiTmpDir || path.join(home, '.gemini', 'tmp');
|
|
980
|
+
const cursorDir =
|
|
981
|
+
options.cursorProjectsDir || path.join(home, '.cursor', 'projects');
|
|
982
|
+
|
|
983
|
+
const candidates = [];
|
|
984
|
+
if (includeAg) {
|
|
985
|
+
for (const f of listAntigravityTranscriptFiles(agDirs, cutoffMs)) {
|
|
986
|
+
candidates.push({ ...f, platform: 'antigravity' });
|
|
987
|
+
}
|
|
988
|
+
}
|
|
989
|
+
if (includeClaude) {
|
|
990
|
+
for (const f of listClaudeJsonlFiles(claudeDir, cutoffMs)) {
|
|
991
|
+
candidates.push({ ...f, platform: 'claude' });
|
|
992
|
+
}
|
|
993
|
+
}
|
|
994
|
+
if (includeCodex) {
|
|
995
|
+
for (const f of listCodexJsonlFiles(codexDir, cutoffMs)) {
|
|
996
|
+
candidates.push({ ...f, platform: 'codex' });
|
|
997
|
+
}
|
|
998
|
+
}
|
|
999
|
+
if (includeGemini) {
|
|
1000
|
+
for (const f of listGeminiSessionJsonFiles(geminiTmpDir, cutoffMs)) {
|
|
1001
|
+
candidates.push({ ...f, platform: 'gemini' });
|
|
1002
|
+
}
|
|
1003
|
+
}
|
|
1004
|
+
if (includeCursor) {
|
|
1005
|
+
for (const f of listCursorTranscriptFiles(cursorDir, cutoffMs)) {
|
|
1006
|
+
candidates.push({ ...f, platform: 'cursor' });
|
|
1007
|
+
}
|
|
1008
|
+
}
|
|
1009
|
+
|
|
1010
|
+
candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
|
|
1011
|
+
const selected = candidates.slice(0, limit);
|
|
1012
|
+
|
|
1013
|
+
const sessions = [];
|
|
1014
|
+
const allOffendingTurns = [];
|
|
1015
|
+
const platformsBreakdown = { antigravity: 0, claude: 0, codex: 0, gemini: 0, cursor: 0 };
|
|
1016
|
+
let totalSludgeTokens = 0;
|
|
1017
|
+
let totalSludgeUSD = 0;
|
|
1018
|
+
let totalColdCacheSpikes = 0;
|
|
1019
|
+
let totalThrashLoops = 0;
|
|
1020
|
+
let totalOversizedReads = 0;
|
|
1021
|
+
let totalOversizedOutputs = 0;
|
|
1022
|
+
|
|
1023
|
+
for (const item of selected) {
|
|
1024
|
+
try {
|
|
1025
|
+
let scored;
|
|
1026
|
+
if (item.platform === 'claude') {
|
|
1027
|
+
scored = scoreClaudeTranscriptFile(item);
|
|
1028
|
+
} else if (item.platform === 'codex') {
|
|
1029
|
+
scored = scoreCodexTranscriptFile(item);
|
|
1030
|
+
} else if (item.platform === 'gemini') {
|
|
1031
|
+
scored = scoreGeminiSessionFile(item);
|
|
1032
|
+
} else if (item.platform === 'cursor') {
|
|
1033
|
+
scored = scoreCursorTranscriptFile(item);
|
|
1034
|
+
} else {
|
|
1035
|
+
scored = scoreAntigravityTranscriptFile(item);
|
|
1036
|
+
}
|
|
1037
|
+
sessions.push(scored);
|
|
1038
|
+
platformsBreakdown[item.platform] = (platformsBreakdown[item.platform] || 0) + 1;
|
|
1039
|
+
totalSludgeTokens += scored.sludgeTaxTokens;
|
|
1040
|
+
totalSludgeUSD += scored.sludgeTaxUSD;
|
|
1041
|
+
totalColdCacheSpikes += scored.coldCacheSpikes;
|
|
1042
|
+
totalThrashLoops += scored.thrashLoops;
|
|
1043
|
+
totalOversizedReads += scored.oversizedReads;
|
|
1044
|
+
totalOversizedOutputs += scored.oversizedOutputs;
|
|
1045
|
+
allOffendingTurns.push(...scored.offendingTurns);
|
|
1046
|
+
} catch (err) {
|
|
1047
|
+
void err;
|
|
1048
|
+
}
|
|
1049
|
+
}
|
|
1050
|
+
|
|
1051
|
+
allOffendingTurns.sort((a, b) => b.wastedUSD - a.wastedUSD || b.wastedTokens - a.wastedTokens);
|
|
1052
|
+
const topOffendingTurns = allOffendingTurns.slice(0, 3);
|
|
1053
|
+
|
|
1054
|
+
const ledger = getSavedQuotaReceiptSummary({
|
|
1055
|
+
cwd: baseCwd,
|
|
1056
|
+
homeDir: home
|
|
1057
|
+
});
|
|
1058
|
+
|
|
1059
|
+
return {
|
|
1060
|
+
ok: true,
|
|
1061
|
+
platform,
|
|
1062
|
+
days,
|
|
1063
|
+
limit,
|
|
1064
|
+
sessionsScanned: sessions.length,
|
|
1065
|
+
platformsBreakdown,
|
|
1066
|
+
sludgeTaxTokens: totalSludgeTokens,
|
|
1067
|
+
sludgeTaxUSD: Number(totalSludgeUSD.toFixed(2)),
|
|
1068
|
+
coldCacheSpikes: totalColdCacheSpikes,
|
|
1069
|
+
thrashLoops: totalThrashLoops,
|
|
1070
|
+
oversizedReads: totalOversizedReads,
|
|
1071
|
+
oversizedOutputs: totalOversizedOutputs,
|
|
1072
|
+
savedTokens30d: Number(ledger.workspace30dSavedTokens || 0),
|
|
1073
|
+
savedUSD30d: Number(Number(ledger.workspace30dSavedUSD || 0).toFixed(2)),
|
|
1074
|
+
topOffendingTurns,
|
|
1075
|
+
sessions
|
|
1076
|
+
};
|
|
1077
|
+
}
|
|
1078
|
+
|
|
1079
|
+
/**
|
|
1080
|
+
* Formats a human-readable Quota Shield & Session ROI console report for `ctxtop audit`.
|
|
1081
|
+
*
|
|
1082
|
+
* @param {ReturnType<typeof runSessionAudit>} res
|
|
1083
|
+
* @returns {string}
|
|
1084
|
+
*/
|
|
1085
|
+
export function formatSessionAuditReport(res) {
|
|
1086
|
+
const activePlatforms = Object.entries(res.platformsBreakdown || {})
|
|
1087
|
+
.filter(([, count]) => count > 0)
|
|
1088
|
+
.map(([name, count]) => `${name}=${count}`)
|
|
1089
|
+
.join(', ');
|
|
1090
|
+
const lines = [
|
|
1091
|
+
`[Highbeam Session ROI Audit] Window: ${res.days}d | Platform: ${res.platform} | Sessions: ${res.sessionsScanned}${activePlatforms ? ` (${activePlatforms})` : ''}`,
|
|
1092
|
+
` Sludge Tax Preventable : ${res.sludgeTaxTokens.toLocaleString('en-US')} tok ($${res.sludgeTaxUSD.toFixed(2)} USD)`,
|
|
1093
|
+
` Cold-Cache Spikes (>5m): ${res.coldCacheSpikes} | 3x Thrash Loops: ${res.thrashLoops}`,
|
|
1094
|
+
` Un-Sliced Large Reads : ${res.oversizedReads} | Oversized Tool Dumps: ${res.oversizedOutputs}`,
|
|
1095
|
+
` Quota Shield Saved (30d): +${res.savedTokens30d.toLocaleString('en-US')} tok ($${res.savedUSD30d.toFixed(2)} USD)`
|
|
1096
|
+
];
|
|
1097
|
+
if (res.topOffendingTurns.length > 0) {
|
|
1098
|
+
lines.push(' Top Offending Turns:');
|
|
1099
|
+
res.topOffendingTurns.forEach((turn, idx) => {
|
|
1100
|
+
lines.push(
|
|
1101
|
+
` ${idx + 1}. [${turn.platform}/${turn.category}] ${turn.citation} -> ~$${turn.wastedUSD.toFixed(2)} (${turn.wastedTokens.toLocaleString('en-US')} tok)`
|
|
1102
|
+
);
|
|
1103
|
+
lines.push(` Fix: ${turn.fix}`);
|
|
1104
|
+
});
|
|
1105
|
+
} else {
|
|
1106
|
+
lines.push(' Top Offending Turns: None detected in scanned window.');
|
|
1107
|
+
}
|
|
1108
|
+
return lines.join('\n');
|
|
1109
|
+
}
|