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
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core-isomorphic/economics/dualTtl.mjs
|
|
3
|
+
* Feature 21: 1s Live Dual-TTL Countdown & Pause Distribution Analyzer.
|
|
4
|
+
*
|
|
5
|
+
* Implements:
|
|
6
|
+
* - 5-Minute (300s) Ephemeral Prompt Cache TTL Countdown
|
|
7
|
+
* - 1-Hour (3,600s) Rolling Billing Block TTL Countdown
|
|
8
|
+
* - Sub-second accuracy clamped cleanly at "00:00" without negative rollover
|
|
9
|
+
* - Inter-turn pause distribution analyzer (recommends 1h tier upgrade when >= 3.1% pauses are 5m-60m)
|
|
10
|
+
* - Amber warning at <= 45s, Keep-alive at <= 15s, T-10s StateBaton pre-snapshot
|
|
11
|
+
*
|
|
12
|
+
* Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
export const DUAL_TTL_CONSTANTS = Object.freeze({
|
|
16
|
+
CACHE_TTL_MS: 300000, // 5 minutes
|
|
17
|
+
BILLING_TTL_MS: 3600000, // 1 hour
|
|
18
|
+
CACHE_TTL_SEC: 300,
|
|
19
|
+
BILLING_TTL_SEC: 3600,
|
|
20
|
+
AMBER_ALERT_SEC: 45,
|
|
21
|
+
KEEP_ALIVE_SEC: 15,
|
|
22
|
+
SNAPSHOT_SEC: 10,
|
|
23
|
+
ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD: 0.031 // 3.1%
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Formats seconds into digital countdown clock notation "MM:SS".
|
|
28
|
+
* Clamps negative or non-finite values to "00:00".
|
|
29
|
+
*
|
|
30
|
+
* @param {number} sec
|
|
31
|
+
* @returns {string}
|
|
32
|
+
*/
|
|
33
|
+
export function formatMmSs(sec) {
|
|
34
|
+
const s = Math.max(0, Math.floor(Number(sec || 0)));
|
|
35
|
+
const m = Math.floor(s / 60);
|
|
36
|
+
const remS = s % 60;
|
|
37
|
+
return `${String(m).padStart(2, '0')}:${String(remS).padStart(2, '0')}`;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Formats remaining seconds into compact human-readable display e.g. "4m12s" or "42s".
|
|
42
|
+
* @param {number} remainingSeconds
|
|
43
|
+
* @returns {string}
|
|
44
|
+
*/
|
|
45
|
+
export function formatRemainingTtl(remainingSeconds = 0) {
|
|
46
|
+
const sec = Math.max(0, Math.floor(Number(remainingSeconds || 0)));
|
|
47
|
+
if (sec <= 0) return '0s';
|
|
48
|
+
const mins = Math.floor(sec / 60);
|
|
49
|
+
const remSec = sec % 60;
|
|
50
|
+
if (mins === 0) return `${remSec}s`;
|
|
51
|
+
return `${mins}m${String(remSec).padStart(2, '0')}s`;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Calculates live Dual-TTL countdown for 5-minute cache TTL and 1-hour billing TTL.
|
|
56
|
+
*
|
|
57
|
+
* @param {number} lastTurnTimestamp Epoch ms when last turn/cache event finished
|
|
58
|
+
* @param {number} [now=Date.now()] Current epoch ms
|
|
59
|
+
* @param {number} [cacheTtlMs=300000] Ephemeral cache window (default 300,000ms = 5m)
|
|
60
|
+
* @param {number} [billingTtlMs=3600000] Billing block TTL (default 3,600,000ms = 1h)
|
|
61
|
+
* @param {object} [options={}] Optional configuration (e.g. { rolling: boolean })
|
|
62
|
+
* @returns {{
|
|
63
|
+
* cacheTtlSec: number,
|
|
64
|
+
* billingTtlSec: number,
|
|
65
|
+
* formattedCacheTtl: string,
|
|
66
|
+
* formattedBillingTtl: string,
|
|
67
|
+
* isCacheExpired: boolean,
|
|
68
|
+
* isBillingExpired: boolean
|
|
69
|
+
* }}
|
|
70
|
+
*/
|
|
71
|
+
export function calculateDualTtlCountdown(
|
|
72
|
+
lastTurnTimestamp,
|
|
73
|
+
now = Date.now(),
|
|
74
|
+
cacheTtlMs = DUAL_TTL_CONSTANTS.CACHE_TTL_MS,
|
|
75
|
+
billingTtlMs = DUAL_TTL_CONSTANTS.BILLING_TTL_MS,
|
|
76
|
+
options = {}
|
|
77
|
+
) {
|
|
78
|
+
const elapsedMs = Math.max(0, now - lastTurnTimestamp);
|
|
79
|
+
const cacheRemainingMs = Math.max(0, cacheTtlMs - elapsedMs);
|
|
80
|
+
|
|
81
|
+
const isRolling = Boolean(options.rolling);
|
|
82
|
+
const billingRemainingMs = isRolling
|
|
83
|
+
? (elapsedMs >= billingTtlMs && elapsedMs % billingTtlMs === 0
|
|
84
|
+
? 0
|
|
85
|
+
: Math.max(0, billingTtlMs - (elapsedMs % billingTtlMs)))
|
|
86
|
+
: Math.max(0, billingTtlMs - elapsedMs);
|
|
87
|
+
|
|
88
|
+
const cacheTtlSec = Math.floor(cacheRemainingMs / 1000);
|
|
89
|
+
const billingTtlSec = Math.floor(billingRemainingMs / 1000);
|
|
90
|
+
|
|
91
|
+
return {
|
|
92
|
+
cacheTtlSec,
|
|
93
|
+
billingTtlSec,
|
|
94
|
+
formattedCacheTtl: formatMmSs(cacheTtlSec),
|
|
95
|
+
formattedBillingTtl: formatMmSs(billingTtlSec),
|
|
96
|
+
isCacheExpired: cacheRemainingMs === 0,
|
|
97
|
+
isBillingExpired: elapsedMs >= billingTtlMs
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Evaluates inter-turn pause durations (in seconds) and advises upgrading the session
|
|
103
|
+
* prompt cache tier to 1h when >= 3.1% of pauses fall between 5m and 60m.
|
|
104
|
+
*
|
|
105
|
+
* @param {Array<number>} pauseDurationsSeconds
|
|
106
|
+
* @param {number} [thresholdRatio=0.031]
|
|
107
|
+
* @returns {{
|
|
108
|
+
* totalIntervals: number,
|
|
109
|
+
* fiveToSixtyMinCount: number,
|
|
110
|
+
* fiveToSixtyMinRatio: number,
|
|
111
|
+
* fiveToSixtyMinPct: number,
|
|
112
|
+
* thresholdRatio: number,
|
|
113
|
+
* recommend1hTierUpgrade: boolean,
|
|
114
|
+
* advisoryMessage: string | null
|
|
115
|
+
* }}
|
|
116
|
+
*/
|
|
117
|
+
export function evaluatePauseDistribution(
|
|
118
|
+
pauseDurationsSeconds = [],
|
|
119
|
+
thresholdRatio = DUAL_TTL_CONSTANTS.ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD
|
|
120
|
+
) {
|
|
121
|
+
const validPauses = Array.isArray(pauseDurationsSeconds)
|
|
122
|
+
? pauseDurationsSeconds.map(v => Number(v)).filter(v => Number.isFinite(v) && v >= 0)
|
|
123
|
+
: [];
|
|
124
|
+
|
|
125
|
+
const totalIntervals = validPauses.length;
|
|
126
|
+
if (totalIntervals === 0) {
|
|
127
|
+
return {
|
|
128
|
+
totalIntervals: 0,
|
|
129
|
+
fiveToSixtyMinCount: 0,
|
|
130
|
+
fiveToSixtyMinRatio: 0,
|
|
131
|
+
fiveToSixtyMinPct: 0,
|
|
132
|
+
thresholdRatio,
|
|
133
|
+
recommend1hTierUpgrade: false,
|
|
134
|
+
advisoryMessage: null
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
const fiveToSixtyMinCount = validPauses.filter(
|
|
139
|
+
sec => sec > DUAL_TTL_CONSTANTS.CACHE_TTL_SEC && sec <= DUAL_TTL_CONSTANTS.BILLING_TTL_SEC
|
|
140
|
+
).length;
|
|
141
|
+
|
|
142
|
+
const fiveToSixtyMinRatio = Number((fiveToSixtyMinCount / totalIntervals).toFixed(4));
|
|
143
|
+
const fiveToSixtyMinPct = Number((fiveToSixtyMinRatio * 100).toFixed(2));
|
|
144
|
+
const recommend1hTierUpgrade = fiveToSixtyMinRatio >= thresholdRatio;
|
|
145
|
+
|
|
146
|
+
const advisoryMessage = recommend1hTierUpgrade
|
|
147
|
+
? `Inter-turn pause telemetry: ${fiveToSixtyMinPct}% of turns (${fiveToSixtyMinCount}/${totalIntervals}) ` +
|
|
148
|
+
`followed a 5-to-60 minute pause (>= ${(thresholdRatio * 100).toFixed(1)}% break-even threshold). ` +
|
|
149
|
+
`Upgrade session prompt cache tier from 5m (1.25x) to 1h (2.0x) to prevent recurring cold prefix rewrites.`
|
|
150
|
+
: null;
|
|
151
|
+
|
|
152
|
+
return {
|
|
153
|
+
totalIntervals,
|
|
154
|
+
fiveToSixtyMinCount,
|
|
155
|
+
fiveToSixtyMinRatio,
|
|
156
|
+
fiveToSixtyMinPct,
|
|
157
|
+
thresholdRatio,
|
|
158
|
+
recommend1hTierUpgrade,
|
|
159
|
+
advisoryMessage
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* Stateful Dual-TTL countdown tracker.
|
|
165
|
+
*/
|
|
166
|
+
export class DualTtlTracker {
|
|
167
|
+
constructor(options = {}) {
|
|
168
|
+
this.cacheTtlMs = options.cacheTtlMs || DUAL_TTL_CONSTANTS.CACHE_TTL_MS;
|
|
169
|
+
this.billingTtlMs = options.billingTtlMs || DUAL_TTL_CONSTANTS.BILLING_TTL_MS;
|
|
170
|
+
this.rolling = Boolean(options.rolling);
|
|
171
|
+
this.lastTurnTimestamp = Date.now();
|
|
172
|
+
this.pauseDurationsSeconds = [];
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
recordTurn(now = Date.now()) {
|
|
176
|
+
if (this.lastTurnTimestamp > 0) {
|
|
177
|
+
const pauseSec = Math.max(0, Math.floor((now - this.lastTurnTimestamp) / 1000));
|
|
178
|
+
this.pauseDurationsSeconds.push(pauseSec);
|
|
179
|
+
}
|
|
180
|
+
this.lastTurnTimestamp = now;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
getCountdown(now = Date.now()) {
|
|
184
|
+
return calculateDualTtlCountdown(
|
|
185
|
+
this.lastTurnTimestamp,
|
|
186
|
+
now,
|
|
187
|
+
this.cacheTtlMs,
|
|
188
|
+
this.billingTtlMs,
|
|
189
|
+
{ rolling: this.rolling }
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
getPauseAnalysis() {
|
|
194
|
+
return evaluatePauseDistribution(this.pauseDurationsSeconds);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
export { TtlWatchdog } from '../coach/ttlWatchdog.mjs';
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core-isomorphic/economics/index.mjs
|
|
3
|
+
* Unified Token Economics, Latency Telemetry, and Cache Retention Radar Module.
|
|
4
|
+
*
|
|
5
|
+
* Consolidates:
|
|
6
|
+
* - Feature 17: TTFT & Thinking Drift Detection (`driftLatency.mjs`)
|
|
7
|
+
* - Feature 18: 95% Prefix-Cache Retention Radar (`retentionRadar.mjs`)
|
|
8
|
+
* - Feature 19: Algebraic C* Break-Even Router (`cacheGravity.mjs`)
|
|
9
|
+
* - Feature 20: Haiku 100k 5x Cliff Breaker (`cliffBreaker.mjs`)
|
|
10
|
+
* - Feature 21: 1s Live Dual-TTL Countdown (`dualTtl.mjs`)
|
|
11
|
+
* - Feature 22: 5-Hour Rolling Billing Blocks (`billingBlocks.mjs`)
|
|
12
|
+
*
|
|
13
|
+
* Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
export * from './driftLatency.mjs';
|
|
17
|
+
export * from './retentionRadar.mjs';
|
|
18
|
+
export * from './cacheGravity.mjs';
|
|
19
|
+
export * from './cliffBreaker.mjs';
|
|
20
|
+
export * from './dualTtl.mjs';
|
|
21
|
+
export * from './billingBlocks.mjs';
|
|
22
|
+
|
|
23
|
+
// Coach & Ledger backward-compatible exports (without duplicate export conflicts)
|
|
24
|
+
export {
|
|
25
|
+
PostCompactMutationQueue,
|
|
26
|
+
HysteresisLock,
|
|
27
|
+
CacheGravityRouter,
|
|
28
|
+
isPrefixInstructionFile,
|
|
29
|
+
normalizeFlightMode,
|
|
30
|
+
isSilentOrOffMode,
|
|
31
|
+
DEFAULT_ADVISORY_COOLDOWN_TURNS,
|
|
32
|
+
evaluatePreModelSwitch,
|
|
33
|
+
evaluateDet09PrefixMutationFence
|
|
34
|
+
} from '../coach/cacheGravityRouter.mjs';
|
|
35
|
+
|
|
36
|
+
export {
|
|
37
|
+
buildPreExpiryStateBaton,
|
|
38
|
+
DEFAULT_MIN_CACHED_TOKENS_FOR_WATCHDOG,
|
|
39
|
+
DEFAULT_AMBER_THRESHOLD_SECONDS,
|
|
40
|
+
DEFAULT_KEEP_ALIVE_THRESHOLD_SECONDS,
|
|
41
|
+
DEFAULT_SNAPSHOT_THRESHOLD_SECONDS,
|
|
42
|
+
ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD,
|
|
43
|
+
FIVE_MINUTES_SECONDS,
|
|
44
|
+
SIXTY_MINUTES_SECONDS
|
|
45
|
+
} from '../coach/ttlWatchdog.mjs';
|
|
46
|
+
|
|
47
|
+
export * from '../coach/savedQuotaLedger.mjs';
|
|
@@ -0,0 +1,348 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core-isomorphic/economics/retentionRadar.mjs
|
|
3
|
+
* Feature 18: 95% Prefix-Cache Retention Radar with Byte-Offset Diffing.
|
|
4
|
+
*
|
|
5
|
+
* Implements:
|
|
6
|
+
* - Isomorphic byte-offset mutation diffing via standard `new TextEncoder().encode()` (Uint8Array)
|
|
7
|
+
* - Prefix retention percentage calculation
|
|
8
|
+
* - 95% discount threshold alert & letter grading (Grade A >= 95%, Grade B 80-95%, Grade C < 80%)
|
|
9
|
+
* - Cache bust cause classification (role_prefix_mutation, rule_mutation, etc.)
|
|
10
|
+
* - Financial accounting: retained discount savings vs leaked cold prefill costs
|
|
11
|
+
*
|
|
12
|
+
* Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
export const PREFIX_RETENTION_THRESHOLDS = Object.freeze({
|
|
16
|
+
DISCOUNT_THRESHOLD_PCT: 95.0,
|
|
17
|
+
DIFF_GRADE_A_PCT: 95.0,
|
|
18
|
+
DIFF_GRADE_B_PCT: 80.0,
|
|
19
|
+
INDEX_GRADE_A_PCT: 90.0,
|
|
20
|
+
INDEX_GRADE_B_PCT: 70.0,
|
|
21
|
+
GRADE_A_PCT: 95.0,
|
|
22
|
+
GRADE_B_PCT: 80.0,
|
|
23
|
+
BUST_RATIO: 0.50
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
const DEFAULT_INPUT_PRICE_PER_1M = 3.00;
|
|
27
|
+
const DEFAULT_READ_PRICE_PER_1M = 0.30;
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Compares two prompt strings byte-by-byte using standard isomorphic TextEncoder.
|
|
31
|
+
* Pinpoints the exact first byte offset where the prompts diverge.
|
|
32
|
+
*
|
|
33
|
+
* @param {string} [originalText='']
|
|
34
|
+
* @param {string} [mutatedText='']
|
|
35
|
+
* @returns {{
|
|
36
|
+
* firstDiffOffset: number,
|
|
37
|
+
* prefixMatchBytes: number,
|
|
38
|
+
* retentionPct: number,
|
|
39
|
+
* is95PctRetained: boolean,
|
|
40
|
+
* grade: 'A' | 'B' | 'C'
|
|
41
|
+
* }}
|
|
42
|
+
*/
|
|
43
|
+
export function verifyRetentionRadarDiff(originalText = '', mutatedText = '') {
|
|
44
|
+
const encoder = new TextEncoder();
|
|
45
|
+
const bufOrig = encoder.encode(String(originalText ?? ''));
|
|
46
|
+
const bufMut = encoder.encode(String(mutatedText ?? ''));
|
|
47
|
+
|
|
48
|
+
let firstDiffOffset = -1;
|
|
49
|
+
const minLen = Math.min(bufOrig.length, bufMut.length);
|
|
50
|
+
|
|
51
|
+
// Fast 32-bit chunking comparison
|
|
52
|
+
const u32Len = Math.floor(minLen / 4);
|
|
53
|
+
const u1 = new Uint32Array(bufOrig.buffer, bufOrig.byteOffset, Math.floor(bufOrig.byteLength / 4));
|
|
54
|
+
const u2 = new Uint32Array(bufMut.buffer, bufMut.byteOffset, Math.floor(bufMut.byteLength / 4));
|
|
55
|
+
|
|
56
|
+
let chunkIdx = 0;
|
|
57
|
+
while (chunkIdx < u32Len && u1[chunkIdx] === u2[chunkIdx]) {
|
|
58
|
+
chunkIdx++;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
for (let i = chunkIdx * 4; i < minLen; i++) {
|
|
62
|
+
if (bufOrig[i] !== bufMut[i]) {
|
|
63
|
+
firstDiffOffset = i;
|
|
64
|
+
break;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
if (firstDiffOffset === -1 && bufOrig.length !== bufMut.length) {
|
|
69
|
+
firstDiffOffset = minLen;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const prefixMatchBytes = firstDiffOffset === -1 ? bufOrig.length : firstDiffOffset;
|
|
73
|
+
const retentionPct = bufOrig.length === 0
|
|
74
|
+
? 100
|
|
75
|
+
: parseFloat(((prefixMatchBytes / bufOrig.length) * 100).toFixed(2));
|
|
76
|
+
|
|
77
|
+
let grade = 'C';
|
|
78
|
+
if (retentionPct >= PREFIX_RETENTION_THRESHOLDS.GRADE_A_PCT) {
|
|
79
|
+
grade = 'A';
|
|
80
|
+
} else if (retentionPct >= PREFIX_RETENTION_THRESHOLDS.GRADE_B_PCT) {
|
|
81
|
+
grade = 'B';
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
return {
|
|
85
|
+
firstDiffOffset,
|
|
86
|
+
prefixMatchBytes,
|
|
87
|
+
retentionPct,
|
|
88
|
+
is95PctRetained: retentionPct >= PREFIX_RETENTION_THRESHOLDS.DISCOUNT_THRESHOLD_PCT,
|
|
89
|
+
grade
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Finds the first mutation offset between two texts, including line and column numbers
|
|
95
|
+
* and a 40-character contextual snippet.
|
|
96
|
+
*
|
|
97
|
+
* @param {string} prevText
|
|
98
|
+
* @param {string} currText
|
|
99
|
+
* @returns {{
|
|
100
|
+
* firstDiffOffset: number,
|
|
101
|
+
* line: number,
|
|
102
|
+
* column: number,
|
|
103
|
+
* snippet: string,
|
|
104
|
+
* retentionPct: number,
|
|
105
|
+
* is95PctRetained: boolean,
|
|
106
|
+
* grade: 'A' | 'B' | 'C'
|
|
107
|
+
* }}
|
|
108
|
+
*/
|
|
109
|
+
export function findPrefixMutationOffset(prevText = '', currText = '') {
|
|
110
|
+
const diff = verifyRetentionRadarDiff(prevText, currText);
|
|
111
|
+
const offset = diff.firstDiffOffset;
|
|
112
|
+
|
|
113
|
+
if (offset === -1) {
|
|
114
|
+
return {
|
|
115
|
+
...diff,
|
|
116
|
+
line: 1,
|
|
117
|
+
column: 1,
|
|
118
|
+
snippet: ''
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
const text = String(currText ?? '');
|
|
123
|
+
const bufCurr = new TextEncoder().encode(text);
|
|
124
|
+
|
|
125
|
+
// Safely convert UTF-8 byte offset to UTF-16 code unit index.
|
|
126
|
+
// Clamp safeOffset within bounds and step backward past any UTF-8 continuation bytes (0x80..0xBF)
|
|
127
|
+
// so TextDecoder never decodes a truncated multibyte sequence or emits \uFFFD.
|
|
128
|
+
let safeOffset = Math.max(0, Math.min(offset, bufCurr.length));
|
|
129
|
+
while (safeOffset > 0 && (bufCurr[safeOffset] & 0xC0) === 0x80) {
|
|
130
|
+
safeOffset--;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
const charOffset = new TextDecoder().decode(bufCurr.subarray(0, safeOffset)).length;
|
|
134
|
+
const textBefore = text.slice(0, charOffset);
|
|
135
|
+
const lines = textBefore.split('\n');
|
|
136
|
+
const line = lines.length;
|
|
137
|
+
const column = lines[lines.length - 1].length + 1;
|
|
138
|
+
|
|
139
|
+
const start = Math.max(0, charOffset - 15);
|
|
140
|
+
const end = Math.min(text.length, charOffset + 25);
|
|
141
|
+
const snippet = text.slice(start, end);
|
|
142
|
+
|
|
143
|
+
return {
|
|
144
|
+
...diff,
|
|
145
|
+
line,
|
|
146
|
+
column,
|
|
147
|
+
snippet
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Classifies the likely cause of a prefix cache bust based on diff offset and text contents.
|
|
153
|
+
*
|
|
154
|
+
* @param {number} firstDiffOffset
|
|
155
|
+
* @param {string} [mutatedText='']
|
|
156
|
+
* @returns {string}
|
|
157
|
+
*/
|
|
158
|
+
export function classifyBustCause(firstDiffOffset, mutatedText = '') {
|
|
159
|
+
if (firstDiffOffset < 0) return 'none';
|
|
160
|
+
if (firstDiffOffset < 60) return 'role_prefix_mutation';
|
|
161
|
+
const prefix = String(mutatedText).slice(0, firstDiffOffset + 100);
|
|
162
|
+
if (/rule|instruction|guideline|invariant/i.test(prefix)) {
|
|
163
|
+
return 'rule_mutation';
|
|
164
|
+
}
|
|
165
|
+
if (/tool|function|schema|mcp/i.test(prefix)) {
|
|
166
|
+
return 'tools_changed';
|
|
167
|
+
}
|
|
168
|
+
if (/system\s+prompt/i.test(prefix)) {
|
|
169
|
+
return 'system_prompt_mutation';
|
|
170
|
+
}
|
|
171
|
+
return 'prefix_drift';
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Creates an empty initial prefix retention accumulator.
|
|
176
|
+
* @returns {object}
|
|
177
|
+
*/
|
|
178
|
+
export function createInitialPrefixRetention() {
|
|
179
|
+
return {
|
|
180
|
+
measured: false,
|
|
181
|
+
measuredTurns: 0,
|
|
182
|
+
bustCount: 0,
|
|
183
|
+
ttlExpiredTurns: 0,
|
|
184
|
+
retentionIndexPct: 100,
|
|
185
|
+
grade: 'A',
|
|
186
|
+
series: [],
|
|
187
|
+
retainedDiscountSavingsUSD: 0,
|
|
188
|
+
leakedColdPrefillUSD: 0,
|
|
189
|
+
lastDiff: null
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Computes multi-turn prefix retention metrics and dollar savings across turns.
|
|
195
|
+
*
|
|
196
|
+
* @param {Array<object>} turns
|
|
197
|
+
* @param {object} [options={}]
|
|
198
|
+
* @param {number} [options.inputPricePer1M]
|
|
199
|
+
* @param {number} [options.readPricePer1M]
|
|
200
|
+
* @returns {object}
|
|
201
|
+
*/
|
|
202
|
+
export function computePrefixRetention(turns = [], options = {}) {
|
|
203
|
+
const rawInputPrice = Number(options.inputPricePer1M ?? DEFAULT_INPUT_PRICE_PER_1M);
|
|
204
|
+
const rawReadPrice = Number(options.readPricePer1M ?? DEFAULT_READ_PRICE_PER_1M);
|
|
205
|
+
const inputPrice = Number.isFinite(rawInputPrice) ? rawInputPrice : DEFAULT_INPUT_PRICE_PER_1M;
|
|
206
|
+
const readPrice = Number.isFinite(rawReadPrice) ? rawReadPrice : DEFAULT_READ_PRICE_PER_1M;
|
|
207
|
+
const savingsPer1M = Math.max(0, inputPrice - readPrice);
|
|
208
|
+
|
|
209
|
+
if (!Array.isArray(turns) || turns.length === 0) {
|
|
210
|
+
return createInitialPrefixRetention();
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
let totalRetainedTokens = 0;
|
|
214
|
+
let totalEligibleTokens = 0;
|
|
215
|
+
let totalLeakedTokens = 0;
|
|
216
|
+
let bustCount = 0;
|
|
217
|
+
let ttlExpiredTurns = 0;
|
|
218
|
+
const series = [];
|
|
219
|
+
|
|
220
|
+
for (let i = 0; i < turns.length; i++) {
|
|
221
|
+
const t = turns[i];
|
|
222
|
+
if (t.ttlExpired) {
|
|
223
|
+
ttlExpiredTurns += 1;
|
|
224
|
+
series.push({ pct: null, bust: false, cause: 'ttl_expired', ttlExpired: true });
|
|
225
|
+
continue;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
const rawEligible = Number(t.eligibleTokens ?? t.previousPrefixTokens ?? 0);
|
|
229
|
+
const rawRetained = Number(t.retainedTokens ?? t.cacheReadTokens ?? 0);
|
|
230
|
+
const eligible = Number.isFinite(rawEligible) ? Math.max(0, rawEligible) : 0;
|
|
231
|
+
const retained = Number.isFinite(rawRetained) ? Math.max(0, rawRetained) : 0;
|
|
232
|
+
const leaked = Math.max(0, eligible - retained);
|
|
233
|
+
|
|
234
|
+
totalEligibleTokens += eligible;
|
|
235
|
+
totalRetainedTokens += retained;
|
|
236
|
+
totalLeakedTokens += leaked;
|
|
237
|
+
|
|
238
|
+
const pct = eligible === 0 ? 100 : parseFloat(((retained / eligible) * 100).toFixed(1));
|
|
239
|
+
const isBust = eligible > 0 && (retained / eligible) < PREFIX_RETENTION_THRESHOLDS.BUST_RATIO;
|
|
240
|
+
if (isBust) bustCount += 1;
|
|
241
|
+
|
|
242
|
+
series.push({
|
|
243
|
+
turnIndex: i + 1,
|
|
244
|
+
pct,
|
|
245
|
+
bust: isBust,
|
|
246
|
+
cause: t.bustCause || (isBust ? 'prefix_drift' : 'none'),
|
|
247
|
+
ttlExpired: false,
|
|
248
|
+
savedUSD: parseFloat(((retained * savingsPer1M) / 1_000_000).toFixed(4)),
|
|
249
|
+
leakedUSD: parseFloat(((leaked * savingsPer1M) / 1_000_000).toFixed(4))
|
|
250
|
+
});
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
const retentionIndexPct = totalEligibleTokens === 0
|
|
254
|
+
? 100
|
|
255
|
+
: parseFloat(((totalRetainedTokens / totalEligibleTokens) * 100).toFixed(1));
|
|
256
|
+
|
|
257
|
+
let grade = 'C';
|
|
258
|
+
if (retentionIndexPct >= PREFIX_RETENTION_THRESHOLDS.INDEX_GRADE_A_PCT) {
|
|
259
|
+
grade = 'A';
|
|
260
|
+
} else if (retentionIndexPct >= PREFIX_RETENTION_THRESHOLDS.INDEX_GRADE_B_PCT) {
|
|
261
|
+
grade = 'B';
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
const retainedDiscountSavingsUSD = parseFloat(((totalRetainedTokens * savingsPer1M) / 1_000_000).toFixed(4));
|
|
265
|
+
const leakedColdPrefillUSD = parseFloat(((totalLeakedTokens * savingsPer1M) / 1_000_000).toFixed(4));
|
|
266
|
+
|
|
267
|
+
return {
|
|
268
|
+
measured: series.length > 0,
|
|
269
|
+
measuredTurns: series.length,
|
|
270
|
+
bustCount,
|
|
271
|
+
ttlExpiredTurns,
|
|
272
|
+
retentionIndexPct,
|
|
273
|
+
grade,
|
|
274
|
+
series,
|
|
275
|
+
retainedDiscountSavingsUSD,
|
|
276
|
+
leakedColdPrefillUSD,
|
|
277
|
+
lastDiff: null
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* Stateful RetentionRadar tracker for rolling turns.
|
|
283
|
+
*/
|
|
284
|
+
export class RetentionRadar {
|
|
285
|
+
constructor(options = {}) {
|
|
286
|
+
this.options = options;
|
|
287
|
+
this.state = createInitialPrefixRetention();
|
|
288
|
+
this.lastPrompt = '';
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
/**
|
|
292
|
+
* Records a turn's prompt and updates the radar state.
|
|
293
|
+
* @param {string} promptText
|
|
294
|
+
* @param {object} [metadata={}]
|
|
295
|
+
* @returns {object} Diff result
|
|
296
|
+
*/
|
|
297
|
+
recordTurn(promptText = '', metadata = {}) {
|
|
298
|
+
const isFirstTurn = this.lastPrompt === '';
|
|
299
|
+
const diff = verifyRetentionRadarDiff(this.lastPrompt, promptText);
|
|
300
|
+
this.state.lastDiff = diff;
|
|
301
|
+
this.state.measured = true;
|
|
302
|
+
this.state.measuredTurns += 1;
|
|
303
|
+
|
|
304
|
+
const isBust = diff.retentionPct < 50;
|
|
305
|
+
if (isBust) this.state.bustCount += 1;
|
|
306
|
+
|
|
307
|
+
const cause = isFirstTurn || diff.retentionPct >= PREFIX_RETENTION_THRESHOLDS.DISCOUNT_THRESHOLD_PCT
|
|
308
|
+
? 'none'
|
|
309
|
+
: classifyBustCause(diff.firstDiffOffset, promptText);
|
|
310
|
+
|
|
311
|
+
this.state.series.push({
|
|
312
|
+
turnIndex: this.state.measuredTurns,
|
|
313
|
+
pct: diff.retentionPct,
|
|
314
|
+
bust: isBust,
|
|
315
|
+
cause,
|
|
316
|
+
ttlExpired: Boolean(metadata.ttlExpired)
|
|
317
|
+
});
|
|
318
|
+
|
|
319
|
+
this.lastPrompt = promptText;
|
|
320
|
+
return diff;
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
getState() {
|
|
324
|
+
return this.state;
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
/**
|
|
329
|
+
* Returns a compact 1-line retention summary for statuslines.
|
|
330
|
+
* @param {object} retention
|
|
331
|
+
* @returns {string}
|
|
332
|
+
*/
|
|
333
|
+
export function formatRetentionCompact(retention) {
|
|
334
|
+
if (!retention?.measured) return 'Cache: —';
|
|
335
|
+
const pct = retention.retentionIndexPct ?? 100;
|
|
336
|
+
const grade = retention.grade ?? 'A';
|
|
337
|
+
return `Cache: ${pct}% [${grade}]`;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* Formats a detailed retention label for reports.
|
|
342
|
+
* @param {object} retention
|
|
343
|
+
* @returns {string}
|
|
344
|
+
*/
|
|
345
|
+
export function formatRetentionLabel(retention) {
|
|
346
|
+
if (!retention?.measured) return 'Prefix retention unmeasured';
|
|
347
|
+
return `${retention.retentionIndexPct}% retained (${retention.grade}) · ${retention.bustCount} busts`;
|
|
348
|
+
}
|