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,888 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @file src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs
|
|
3
|
+
* Prompt Hygiene Governor (v4.1 Phase 1): Scope Brake ('vague-prompt-rubric')
|
|
4
|
+
* and Relay Breaker ('relay-breaker').
|
|
5
|
+
*
|
|
6
|
+
* Strictly zero `node:*` imports (Claude Code Mod Law 4 compliant).
|
|
7
|
+
* Runs in memory in < 1 ms using Highbeam's local sidecar/breaker ledger
|
|
8
|
+
* with zero background LLM calls and zero synchronous `git status` spawns.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
export const RELAY_STATES = Object.freeze({
|
|
12
|
+
IDLE: 'Idle',
|
|
13
|
+
CANDIDATE: 'Candidate',
|
|
14
|
+
ARMED: 'Armed',
|
|
15
|
+
FINAL_PASS: 'Final Pass',
|
|
16
|
+
LOCKED: 'Locked'
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
const AFFIRMATIVE_OR_CONTINUATION_RE =
|
|
20
|
+
/^(?:yes|y|yep|yeah|ok|okay|sure|ship\s+it|go\s+ahead|proceed|continue|approved|approve|lgtm|do\s+it|sounds\s+good|looks\s+good|run\s+it|commit(?:\s+it)?|push(?:\s+it)?|next|thanks|thank\s+you)[.!?\s]*$/i;
|
|
21
|
+
|
|
22
|
+
const AUTONOMOUS_PROVENANCE_RE =
|
|
23
|
+
/^(?:scheduled|cron|loop|subagent|agent_callback|callback|auto|autonomous|background|system|hook|task_notification|wake)$/i;
|
|
24
|
+
|
|
25
|
+
const VAGUE_UNANCHORED_IMPERATIVE_RE =
|
|
26
|
+
/\b(?:make\s+(?:it|this)\s+(?:better|faster|cleaner|nicer|work)|optimize\s+(?:it|this)|clean\s+(?:this|it)\s+up|speed\s+(?:this|it)\s+up|(?:still\s+)?(?:broken|not\s+working|failing|buggy)|fix\s+(?:it|this|bugs|errors|everything)|improve\s+(?:it|this|performance|code)|refactor\s+(?:it|this)|polish\s+(?:it|this)|update\s+(?:it|this))\b/i;
|
|
27
|
+
|
|
28
|
+
const CONCRETE_FILE_OR_PATH_RE =
|
|
29
|
+
/(?:^|\s)@[A-Za-z0-9_./\\-]+|\b[A-Za-z0-9_.-]+\.(?:mjs|cjs|js|ts|tsx|jsx|py|go|rs|rb|java|kt|cs|cpp|c|h|css|scss|html|json|ya?ml|toml|md|sql|sh|ps1)\b|(?:^|[\s'"`(])(?:src|test|tests|lib|app|packages|hooks|scripts|sidecars|bin|config|docs)[\\/][A-Za-z0-9_./\\-]+/i;
|
|
30
|
+
|
|
31
|
+
const CONCRETE_SYMBOL_OR_METRIC_RE =
|
|
32
|
+
/`[^`]{2,}`|\b[a-z][a-zA-Z0-9]+_[a-zA-Z0-9_]+\b|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]+\b|\b[A-Z][a-z0-9]+[A-Z][A-Za-z0-9]*\b|\b[a-zA-Z_]\w*\s*\([^)]*\)|\b(?:line|ln)\s+\d+\b|\b\d+(?:\.\d+)?\s*(?:ms|s|sec|mb|kb|gb|%|tok|tokens|fps|rps|qps)\b|\b(?:DET|ISS|RSI|SIM)-\d+\b|\b(?:TypeError|ReferenceError|SyntaxError|RangeError|ENOENT|EACCES|ECONNREFUSED|ERR_[A-Z0-9_]+|HTTP\s+[45]\d\d)\b|\b(?:[Uu][Ii]\s+alignment|alignment|margin|padding|z-index|flexbox|grid\s+layout|tooltip|dropdown|sidebar|navbar|modal|button|input|form|card|table|header|footer|panel|drawer|badge|icon|color|font|border|layout|style|css|html|test|tests|spec|build|lint|typecheck|commit|branch|merge|hook|daemon|server|client|router|cache|token|prompt|rule|config|package|readme|console)\b/;
|
|
33
|
+
|
|
34
|
+
// Hard negative filters for Relay Breaker (3.1.4): stack traces, compiler errors, unified diffs, log timestamps, SQL, JSON/CSV payloads
|
|
35
|
+
const HARD_NEGATIVE_STACK_TRACE_RE =
|
|
36
|
+
/(?:^\s*at\s+[^\r\n]+\([^\r\n]+:\d+:\d+\)|Traceback\s+\(most\s+recent\s+call\s+last\):|^\s*File\s+"[^"]+",\s+line\s+\d+|panic:\s+runtime\s+error)/m;
|
|
37
|
+
|
|
38
|
+
const HARD_NEGATIVE_COMPILER_ERROR_RE =
|
|
39
|
+
/(?:\berror\s+TS\d{3,5}:|\b(?:SyntaxError|TypeError|ReferenceError|RangeError|AssertionError):|^\s*error\[E\d{4}\]:|\bFAIL\s+[^\r\n]+\.(?:test|spec)\.)/m;
|
|
40
|
+
|
|
41
|
+
const HARD_NEGATIVE_UNIFIED_DIFF_RE =
|
|
42
|
+
/(?:^diff\s+--git\s+a\/|^---\s+a\/|^\+\+\+\s+b\/|^@@\s+-\d+(?:,\d+)?\s+\+\d+(?:,\d+)?\s+@@)/m;
|
|
43
|
+
|
|
44
|
+
const HARD_NEGATIVE_LOG_TIMESTAMP_RE =
|
|
45
|
+
/(?:^\d{4}-\d{2}-\d{2}[T\s]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?\s+(?:\[?(?:INFO|WARN|ERROR|DEBUG|TRACE|FATAL)\]?))/m;
|
|
46
|
+
|
|
47
|
+
const HARD_NEGATIVE_SQL_RE =
|
|
48
|
+
/\b(?:SELECT\s+[\s\S]{1,120}\s+FROM\s+[A-Za-z0-9_."`]+|INSERT\s+INTO\s+[A-Za-z0-9_."`]+|CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[A-Za-z0-9_."`]+|ALTER\s+TABLE\s+[A-Za-z0-9_."`]+)/i;
|
|
49
|
+
|
|
50
|
+
const REFEREE_SYNTAX_PATTERNS = Object.freeze([
|
|
51
|
+
/\bwhat\s+i\s+confirmed\b/i,
|
|
52
|
+
/\bcould(?:n't|\s+not)\s+confirm\b/i,
|
|
53
|
+
/\bwhat\s+holds\s+up\b/i,
|
|
54
|
+
/\bwhere\s+(?:it|the\s+(?:spec|review|critique|reviewer|author))\s+(?:overreaches|falls\s+short|is\s+right|is\s+wrong|misses)\b/i,
|
|
55
|
+
/\b(?:verdict|overall\s+assessment|blind\s+spots?|my\s+rebuttal|point-by-point|counter-?argument|reviewer(?:'s)?\s+(?:claim|critique|feedback))\b/i,
|
|
56
|
+
/\b\d+(?:\.\d+)?\s*\/\s*(?:10|100)\b/,
|
|
57
|
+
/\b(?:S0|S1|S2)\s*[:—-]\s*(?:Blocker|Major|Minor|Nit)\b/i,
|
|
58
|
+
/\b(?:concede|push\s+back|disagree\s+with\s+point|agree\s+with\s+point|round\s+[234]\s+rebuttal)\b/i
|
|
59
|
+
]);
|
|
60
|
+
|
|
61
|
+
function isJsonOrCsvPayload(text = '') {
|
|
62
|
+
const trimmed = String(text || '').trim();
|
|
63
|
+
if (!trimmed) return false;
|
|
64
|
+
if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
|
|
65
|
+
try {
|
|
66
|
+
JSON.parse(trimmed);
|
|
67
|
+
return true;
|
|
68
|
+
} catch {
|
|
69
|
+
// Not pure JSON; check if >60% of lines look like JSON key-value pairs
|
|
70
|
+
const lines = trimmed.split(/\r?\n/);
|
|
71
|
+
if (lines.length >= 6) {
|
|
72
|
+
const jsonLikeLines = lines.filter((l) => /^\s*"[^"]+"\s*:/.test(l)).length;
|
|
73
|
+
if (jsonLikeLines / lines.length >= 0.6) return true;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
const lines = trimmed.split(/\r?\n/).filter((l) => l.trim().length > 0);
|
|
78
|
+
if (lines.length >= 4) {
|
|
79
|
+
const commaCounts = lines.slice(0, 6).map((l) => (l.match(/,/g) || []).length);
|
|
80
|
+
if (commaCounts[0] >= 3 && commaCounts.every((c) => c === commaCounts[0])) {
|
|
81
|
+
return true;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
return false;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Checks whether a prompt matches any of the Relay Breaker hard negative filters (Section 3.1.4).
|
|
89
|
+
*
|
|
90
|
+
* @param {string} promptText
|
|
91
|
+
* @returns {{ matched: boolean, filter: string | null }}
|
|
92
|
+
*/
|
|
93
|
+
export function matchRelayHardNegativeFilter(promptText = '') {
|
|
94
|
+
const text = String(promptText || '');
|
|
95
|
+
if (!text) return { matched: false, filter: null };
|
|
96
|
+
if (HARD_NEGATIVE_STACK_TRACE_RE.test(text)) return { matched: true, filter: 'STACK_TRACE' };
|
|
97
|
+
if (HARD_NEGATIVE_COMPILER_ERROR_RE.test(text)) return { matched: true, filter: 'COMPILER_OR_TEST_ERROR' };
|
|
98
|
+
if (HARD_NEGATIVE_UNIFIED_DIFF_RE.test(text)) return { matched: true, filter: 'UNIFIED_DIFF' };
|
|
99
|
+
if (HARD_NEGATIVE_LOG_TIMESTAMP_RE.test(text)) return { matched: true, filter: 'LOG_TIMESTAMPS' };
|
|
100
|
+
if (HARD_NEGATIVE_SQL_RE.test(text)) return { matched: true, filter: 'SQL_PAYLOAD' };
|
|
101
|
+
if (isJsonOrCsvPayload(text)) return { matched: true, filter: 'JSON_OR_CSV_PAYLOAD' };
|
|
102
|
+
return { matched: false, filter: null };
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Counts how many distinct referee/critique markers appear in `promptText`.
|
|
107
|
+
*
|
|
108
|
+
* @param {string} promptText
|
|
109
|
+
* @returns {{ count: number, matchedMarkers: string[] }}
|
|
110
|
+
*/
|
|
111
|
+
export function countRefereeSyntaxMarkers(promptText = '') {
|
|
112
|
+
const text = String(promptText || '');
|
|
113
|
+
const matchedMarkers = [];
|
|
114
|
+
for (const re of REFEREE_SYNTAX_PATTERNS) {
|
|
115
|
+
const m = text.match(re);
|
|
116
|
+
if (m) {
|
|
117
|
+
matchedMarkers.push(m[0]);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return {
|
|
121
|
+
count: matchedMarkers.length,
|
|
122
|
+
matchedMarkers
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Pure zero-I/O Scope Brake classifier (Section 3.2 & 5.1).
|
|
128
|
+
* Consolidated into `'vague-prompt-rubric'` (`DET-26` on Antigravity, `DET-14` on Claude Code).
|
|
129
|
+
*
|
|
130
|
+
* @param {object} [params={}]
|
|
131
|
+
* @returns {{
|
|
132
|
+
* detectorId: string,
|
|
133
|
+
* slug: string,
|
|
134
|
+
* triggered: boolean,
|
|
135
|
+
* subType: string | null,
|
|
136
|
+
* decision: 'allow' | 'steer' | 'block',
|
|
137
|
+
* mode: string,
|
|
138
|
+
* bypassReason: string | null,
|
|
139
|
+
* wordCount: number,
|
|
140
|
+
* candidateFiles: string[],
|
|
141
|
+
* steerContext: string | null,
|
|
142
|
+
* blockReason: string | null,
|
|
143
|
+
* unanchoredTurnFlag: boolean
|
|
144
|
+
* }}
|
|
145
|
+
*/
|
|
146
|
+
export function evaluateScopeBrake({
|
|
147
|
+
prompt = '',
|
|
148
|
+
provenance = 'user',
|
|
149
|
+
isAutonomousTurn = false,
|
|
150
|
+
isSubagent = false,
|
|
151
|
+
isScheduledTask = false,
|
|
152
|
+
isLoopIteration = false,
|
|
153
|
+
priorTurnEditedFilesCount = 0,
|
|
154
|
+
priorTurnSingleFileTarget = null,
|
|
155
|
+
priorTurnHadToolOrTestFailure = false,
|
|
156
|
+
priorTurnAssistantAskedQuestion = false,
|
|
157
|
+
activeSetPaths = [],
|
|
158
|
+
modifiedFiles = [],
|
|
159
|
+
recentlyViewedFiles = [],
|
|
160
|
+
overrideMode = 'default',
|
|
161
|
+
flightMode = 'COACH',
|
|
162
|
+
detectorId = 'DET-26'
|
|
163
|
+
} = {}) {
|
|
164
|
+
const raw = String(prompt || '').trim();
|
|
165
|
+
const cleaned = raw.replace(/#check\b/gi, '').trim();
|
|
166
|
+
const words = cleaned ? cleaned.split(/\s+/).filter(Boolean) : [];
|
|
167
|
+
const wordCount = words.length;
|
|
168
|
+
|
|
169
|
+
const normOverride = String(overrideMode || 'default').toLowerCase();
|
|
170
|
+
if (normOverride === 'off' || String(flightMode || '').toUpperCase() === 'OFF') {
|
|
171
|
+
return {
|
|
172
|
+
detectorId,
|
|
173
|
+
slug: 'vague-prompt-rubric',
|
|
174
|
+
triggered: false,
|
|
175
|
+
subType: null,
|
|
176
|
+
decision: 'allow',
|
|
177
|
+
mode: 'off',
|
|
178
|
+
bypassReason: 'DISABLED_BY_CONFIG',
|
|
179
|
+
wordCount,
|
|
180
|
+
candidateFiles: [],
|
|
181
|
+
steerContext: null,
|
|
182
|
+
blockReason: null,
|
|
183
|
+
unanchoredTurnFlag: false
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
// 1. Autonomous turn & affirmative reply bypass (< 1 ms)
|
|
188
|
+
if (
|
|
189
|
+
Boolean(isAutonomousTurn) ||
|
|
190
|
+
Boolean(isSubagent) ||
|
|
191
|
+
Boolean(isScheduledTask) ||
|
|
192
|
+
Boolean(isLoopIteration) ||
|
|
193
|
+
AUTONOMOUS_PROVENANCE_RE.test(String(provenance || '')) ||
|
|
194
|
+
cleaned.startsWith('/') ||
|
|
195
|
+
AFFIRMATIVE_OR_CONTINUATION_RE.test(cleaned)
|
|
196
|
+
) {
|
|
197
|
+
return {
|
|
198
|
+
detectorId,
|
|
199
|
+
slug: 'vague-prompt-rubric',
|
|
200
|
+
triggered: false,
|
|
201
|
+
subType: null,
|
|
202
|
+
decision: 'allow',
|
|
203
|
+
mode: normOverride,
|
|
204
|
+
bypassReason: 'AUTONOMOUS_OR_AFFIRMATIVE_BYPASS',
|
|
205
|
+
wordCount,
|
|
206
|
+
candidateFiles: [],
|
|
207
|
+
steerContext: null,
|
|
208
|
+
blockReason: null,
|
|
209
|
+
unanchoredTurnFlag: false
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
// 2. Trailing context anchor suppression (single-file edit, tool/test failure, or assistant question)
|
|
214
|
+
const effectiveSingleFileEdit =
|
|
215
|
+
Number(priorTurnEditedFilesCount) === 1 || Boolean(priorTurnSingleFileTarget);
|
|
216
|
+
if (
|
|
217
|
+
effectiveSingleFileEdit ||
|
|
218
|
+
Boolean(priorTurnHadToolOrTestFailure) ||
|
|
219
|
+
Boolean(priorTurnAssistantAskedQuestion)
|
|
220
|
+
) {
|
|
221
|
+
return {
|
|
222
|
+
detectorId,
|
|
223
|
+
slug: 'vague-prompt-rubric',
|
|
224
|
+
triggered: false,
|
|
225
|
+
subType: null,
|
|
226
|
+
decision: 'allow',
|
|
227
|
+
mode: normOverride,
|
|
228
|
+
bypassReason: 'TRAILING_CONTEXT_ANCHOR',
|
|
229
|
+
wordCount,
|
|
230
|
+
candidateFiles: [],
|
|
231
|
+
steerContext: null,
|
|
232
|
+
blockReason: null,
|
|
233
|
+
unanchoredTurnFlag: false
|
|
234
|
+
};
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
// 3. Lexical trigger: < 12 words built around bare imperatives / vague comparatives lacking file/symbol/metric/error
|
|
238
|
+
const hasConcreteAnchor =
|
|
239
|
+
CONCRETE_FILE_OR_PATH_RE.test(cleaned) || CONCRETE_SYMBOL_OR_METRIC_RE.test(cleaned);
|
|
240
|
+
const isUnder12Words = wordCount > 0 && wordCount < 12;
|
|
241
|
+
const matchesVagueDirective = VAGUE_UNANCHORED_IMPERATIVE_RE.test(cleaned);
|
|
242
|
+
|
|
243
|
+
if (!isUnder12Words || hasConcreteAnchor || !matchesVagueDirective) {
|
|
244
|
+
return {
|
|
245
|
+
detectorId,
|
|
246
|
+
slug: 'vague-prompt-rubric',
|
|
247
|
+
triggered: false,
|
|
248
|
+
subType: null,
|
|
249
|
+
decision: 'allow',
|
|
250
|
+
mode: normOverride,
|
|
251
|
+
bypassReason: null,
|
|
252
|
+
wordCount,
|
|
253
|
+
candidateFiles: [],
|
|
254
|
+
steerContext: null,
|
|
255
|
+
blockReason: null,
|
|
256
|
+
unanchoredTurnFlag: false
|
|
257
|
+
};
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
// Gather top 5 candidate paths from sidecar activeSetPaths / modifiedFiles / recentlyViewedFiles (zero git spawn)
|
|
261
|
+
const seen = new Set();
|
|
262
|
+
const candidates = [];
|
|
263
|
+
for (const list of [modifiedFiles, activeSetPaths, recentlyViewedFiles]) {
|
|
264
|
+
if (!Array.isArray(list)) continue;
|
|
265
|
+
for (const item of list) {
|
|
266
|
+
const p = String(item || '').trim().replace(/\\/g, '/');
|
|
267
|
+
if (!p || seen.has(p)) continue;
|
|
268
|
+
seen.add(p);
|
|
269
|
+
candidates.push(p);
|
|
270
|
+
if (candidates.length >= 5) break;
|
|
271
|
+
}
|
|
272
|
+
if (candidates.length >= 5) break;
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
const candidateDisplay =
|
|
276
|
+
candidates.length > 0 ? candidates.slice(0, 5).join(', ') : '<target-file>';
|
|
277
|
+
const recentTwoDisplay =
|
|
278
|
+
candidates.length > 0 ? candidates.slice(0, 2).join(' or ') : '@<target-file>';
|
|
279
|
+
|
|
280
|
+
const isBlockMode =
|
|
281
|
+
normOverride === 'block' ||
|
|
282
|
+
(normOverride === 'default' && String(flightMode || '').toUpperCase() === 'AUTO_PILOT');
|
|
283
|
+
|
|
284
|
+
const steerContext =
|
|
285
|
+
`[${detectorId} Scope Brake] Unanchored directive ("${cleaned}") with no target file, symbol, or error anchor. ` +
|
|
286
|
+
`Candidate active files: [${candidateDisplay}]. ` +
|
|
287
|
+
`Single-turn boundary: Do NOT call repository-wide search, directory-listing, or multi-file edit tools on this turn; ask 1 concise scoping question naming candidate target files (${recentTwoDisplay}) and the specific optimization axis (latency, memory allocation, error handling, or readability).`;
|
|
288
|
+
|
|
289
|
+
const blockReason =
|
|
290
|
+
`[${detectorId} Scope Brake] Unanchored directive ("${cleaned}"). ` +
|
|
291
|
+
`Re-send with a concrete target (e.g., "In ${recentTwoDisplay}, ${cleaned} focusing on latency/readability").`;
|
|
292
|
+
|
|
293
|
+
return {
|
|
294
|
+
detectorId,
|
|
295
|
+
slug: 'vague-prompt-rubric',
|
|
296
|
+
triggered: true,
|
|
297
|
+
subType: 'UNANCHORED_SCOPE_BRAKE',
|
|
298
|
+
decision: isBlockMode ? 'block' : 'steer',
|
|
299
|
+
mode: isBlockMode ? 'block' : 'steer',
|
|
300
|
+
bypassReason: null,
|
|
301
|
+
wordCount,
|
|
302
|
+
candidateFiles: candidates,
|
|
303
|
+
steerContext,
|
|
304
|
+
blockReason,
|
|
305
|
+
unanchoredTurnFlag: true
|
|
306
|
+
};
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
/**
|
|
310
|
+
* Pure zero-I/O Relay Breaker classifier & 5-state machine (Section 3.1, 4 & 5.2):
|
|
311
|
+
* `Idle -> Candidate -> Armed -> Final Pass -> Locked`.
|
|
312
|
+
* Any edit to source code outside the bound Markdown specification resets Relay Breaker back to `Idle`.
|
|
313
|
+
*
|
|
314
|
+
* @param {object} [params={}]
|
|
315
|
+
* @returns {{
|
|
316
|
+
* detectorId: string,
|
|
317
|
+
* slug: string,
|
|
318
|
+
* triggered: boolean,
|
|
319
|
+
* subType: string | null,
|
|
320
|
+
* prevState: string,
|
|
321
|
+
* nextState: string,
|
|
322
|
+
* decision: 'allow' | 'steer' | 'block',
|
|
323
|
+
* refereeMarkerCount: number,
|
|
324
|
+
* matchedMarkers: string[],
|
|
325
|
+
* hardNegativeFilter: string | null,
|
|
326
|
+
* pasteChars: number,
|
|
327
|
+
* tailInjection: string | null,
|
|
328
|
+
* hudBadge: string | null,
|
|
329
|
+
* relayStateSnapshot: object
|
|
330
|
+
* }}
|
|
331
|
+
*/
|
|
332
|
+
export function evaluateRelayBreaker({
|
|
333
|
+
prompt = '',
|
|
334
|
+
relayState = null,
|
|
335
|
+
sourceCodeEditsInSession = 0,
|
|
336
|
+
sourceCodeEditedSinceLastRelay = false,
|
|
337
|
+
priorTurnWebSearches = 0,
|
|
338
|
+
zeroEditSessionTokens = 0,
|
|
339
|
+
boundSpecPath = null,
|
|
340
|
+
overrideMode = 'default',
|
|
341
|
+
flightMode = 'COACH',
|
|
342
|
+
detectorId = 'DET-26'
|
|
343
|
+
} = {}) {
|
|
344
|
+
const prevSnap = relayState && typeof relayState === 'object' ? relayState : {};
|
|
345
|
+
const prevState = Object.values(RELAY_STATES).includes(prevSnap.state)
|
|
346
|
+
? prevSnap.state
|
|
347
|
+
: RELAY_STATES.IDLE;
|
|
348
|
+
const prevCritiquePastes = Math.max(0, Number(prevSnap.critiquePastes || 0));
|
|
349
|
+
const activeSpecPath = boundSpecPath || prevSnap.boundSpecPath || 'SPEC.md';
|
|
350
|
+
|
|
351
|
+
const normOverride = String(overrideMode || 'default').toLowerCase();
|
|
352
|
+
if (normOverride === 'off' || String(flightMode || '').toUpperCase() === 'OFF') {
|
|
353
|
+
return {
|
|
354
|
+
detectorId,
|
|
355
|
+
slug: 'relay-breaker',
|
|
356
|
+
triggered: false,
|
|
357
|
+
subType: null,
|
|
358
|
+
prevState,
|
|
359
|
+
nextState: prevState,
|
|
360
|
+
decision: 'allow',
|
|
361
|
+
refereeMarkerCount: 0,
|
|
362
|
+
matchedMarkers: [],
|
|
363
|
+
hardNegativeFilter: null,
|
|
364
|
+
pasteChars: String(prompt || '').length,
|
|
365
|
+
tailInjection: null,
|
|
366
|
+
hudBadge: null,
|
|
367
|
+
relayStateSnapshot: {
|
|
368
|
+
state: prevState,
|
|
369
|
+
critiquePastes: prevCritiquePastes,
|
|
370
|
+
boundSpecPath: activeSpecPath
|
|
371
|
+
}
|
|
372
|
+
};
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
// Any source-code edit outside the bound Markdown spec resets Relay Breaker to Idle
|
|
376
|
+
if (Boolean(sourceCodeEditedSinceLastRelay) || Number(sourceCodeEditsInSession) > 0) {
|
|
377
|
+
return {
|
|
378
|
+
detectorId,
|
|
379
|
+
slug: 'relay-breaker',
|
|
380
|
+
triggered: false,
|
|
381
|
+
subType: null,
|
|
382
|
+
prevState,
|
|
383
|
+
nextState: RELAY_STATES.IDLE,
|
|
384
|
+
decision: 'allow',
|
|
385
|
+
refereeMarkerCount: 0,
|
|
386
|
+
matchedMarkers: [],
|
|
387
|
+
hardNegativeFilter: null,
|
|
388
|
+
pasteChars: String(prompt || '').length,
|
|
389
|
+
tailInjection: null,
|
|
390
|
+
hudBadge: null,
|
|
391
|
+
relayStateSnapshot: {
|
|
392
|
+
state: RELAY_STATES.IDLE,
|
|
393
|
+
critiquePastes: 0,
|
|
394
|
+
boundSpecPath: activeSpecPath
|
|
395
|
+
}
|
|
396
|
+
};
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
const text = String(prompt || '');
|
|
400
|
+
const pasteChars = text.length;
|
|
401
|
+
|
|
402
|
+
// 4. Hard negative filters abort scoring immediately
|
|
403
|
+
const neg = matchRelayHardNegativeFilter(text);
|
|
404
|
+
if (neg.matched) {
|
|
405
|
+
return {
|
|
406
|
+
detectorId,
|
|
407
|
+
slug: 'relay-breaker',
|
|
408
|
+
triggered: false,
|
|
409
|
+
subType: null,
|
|
410
|
+
prevState,
|
|
411
|
+
nextState: prevState,
|
|
412
|
+
decision: 'allow',
|
|
413
|
+
refereeMarkerCount: 0,
|
|
414
|
+
matchedMarkers: [],
|
|
415
|
+
hardNegativeFilter: neg.filter,
|
|
416
|
+
pasteChars,
|
|
417
|
+
tailInjection: null,
|
|
418
|
+
hudBadge: null,
|
|
419
|
+
relayStateSnapshot: {
|
|
420
|
+
state: prevState,
|
|
421
|
+
critiquePastes: prevCritiquePastes,
|
|
422
|
+
boundSpecPath: activeSpecPath
|
|
423
|
+
}
|
|
424
|
+
};
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
const { count: refereeMarkerCount, matchedMarkers } = countRefereeSyntaxMarkers(text);
|
|
428
|
+
const isCritiquePaste = pasteChars > 1500 && refereeMarkerCount >= 2;
|
|
429
|
+
const hasVerificationSprawl =
|
|
430
|
+
Number(priorTurnWebSearches) >= 3 || Number(zeroEditSessionTokens) > 35000;
|
|
431
|
+
|
|
432
|
+
if (!isCritiquePaste) {
|
|
433
|
+
return {
|
|
434
|
+
detectorId,
|
|
435
|
+
slug: 'relay-breaker',
|
|
436
|
+
triggered: false,
|
|
437
|
+
subType: null,
|
|
438
|
+
prevState,
|
|
439
|
+
nextState: prevState,
|
|
440
|
+
decision: 'allow',
|
|
441
|
+
refereeMarkerCount,
|
|
442
|
+
matchedMarkers,
|
|
443
|
+
hardNegativeFilter: null,
|
|
444
|
+
pasteChars,
|
|
445
|
+
tailInjection: null,
|
|
446
|
+
hudBadge: prevState === RELAY_STATES.IDLE ? null : `Relay: ${prevState}`,
|
|
447
|
+
relayStateSnapshot: {
|
|
448
|
+
state: prevState,
|
|
449
|
+
critiquePastes: prevCritiquePastes,
|
|
450
|
+
boundSpecPath: activeSpecPath
|
|
451
|
+
}
|
|
452
|
+
};
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
const nextCritiquePastes = prevCritiquePastes + 1;
|
|
456
|
+
let nextState = prevState;
|
|
457
|
+
|
|
458
|
+
if (prevState === RELAY_STATES.IDLE) {
|
|
459
|
+
nextState = hasVerificationSprawl && nextCritiquePastes >= 2
|
|
460
|
+
? RELAY_STATES.ARMED
|
|
461
|
+
: RELAY_STATES.CANDIDATE;
|
|
462
|
+
} else if (prevState === RELAY_STATES.CANDIDATE) {
|
|
463
|
+
nextState = hasVerificationSprawl || nextCritiquePastes >= 2
|
|
464
|
+
? RELAY_STATES.ARMED
|
|
465
|
+
: RELAY_STATES.CANDIDATE;
|
|
466
|
+
} else if (prevState === RELAY_STATES.ARMED) {
|
|
467
|
+
nextState = RELAY_STATES.FINAL_PASS;
|
|
468
|
+
} else if (prevState === RELAY_STATES.FINAL_PASS || prevState === RELAY_STATES.LOCKED) {
|
|
469
|
+
nextState = RELAY_STATES.LOCKED;
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
const isBlockMode =
|
|
473
|
+
normOverride === 'block' ||
|
|
474
|
+
(normOverride === 'default' && String(flightMode || '').toUpperCase() === 'AUTO_PILOT' && nextState === RELAY_STATES.LOCKED);
|
|
475
|
+
|
|
476
|
+
let tailInjection = null;
|
|
477
|
+
let hudBadge = null;
|
|
478
|
+
let subType = null;
|
|
479
|
+
|
|
480
|
+
if (nextState === RELAY_STATES.CANDIDATE) {
|
|
481
|
+
hudBadge = 'Spec Churn Candidate (Round 1)';
|
|
482
|
+
subType = 'RELAY_CANDIDATE';
|
|
483
|
+
} else if (nextState === RELAY_STATES.ARMED) {
|
|
484
|
+
hudBadge = 'Relay Mode Armed (Owner Protocol)';
|
|
485
|
+
subType = 'RELAY_ARMED';
|
|
486
|
+
tailInjection =
|
|
487
|
+
`[${detectorId} Relay Breaker — Armed (Owner Protocol)] Cross-model spec relay detected (${pasteChars.toLocaleString('en-US')} chars, ${refereeMarkerCount} critique markers, 0 code edits). ` +
|
|
488
|
+
`Act as the stateful Spec Owner: (1) Commit accepted spec changes directly to "${activeSpecPath}" instead of printing full prose recaps; ` +
|
|
489
|
+
`(2) Do NOT run exploratory web searches on uncited peer claims; ` +
|
|
490
|
+
`(3) Triage feedback into Blocker (S0), Major flaw (S1), or Testable runtime question (T) and defer style nits.`;
|
|
491
|
+
} else if (nextState === RELAY_STATES.FINAL_PASS) {
|
|
492
|
+
hudBadge = 'Relay Round 2 of 2 (Final Pass)';
|
|
493
|
+
subType = 'RELAY_FINAL_PASS';
|
|
494
|
+
tailInjection =
|
|
495
|
+
`[${detectorId} Relay Breaker — Round 2 of 2 Cap] Final critique pass for "${activeSpecPath}". Resolve remaining S0/S1 items on disk and convert unresolved runtime debates into a local verification test.`;
|
|
496
|
+
} else if (nextState === RELAY_STATES.LOCKED) {
|
|
497
|
+
hudBadge = 'Relay Locked (Round 3+ Cap Reached)';
|
|
498
|
+
subType = 'RELAY_LOCKED';
|
|
499
|
+
tailInjection =
|
|
500
|
+
`[${detectorId} Relay Breaker — LOCKED (Round ${nextCritiquePastes})] Spec relay cap reached with 0 source-code edits. Stop cross-model prose relays; freeze "${activeSpecPath}" and write a local verification script or begin implementation.`;
|
|
501
|
+
}
|
|
502
|
+
|
|
503
|
+
const triggered =
|
|
504
|
+
nextState === RELAY_STATES.ARMED ||
|
|
505
|
+
nextState === RELAY_STATES.FINAL_PASS ||
|
|
506
|
+
nextState === RELAY_STATES.LOCKED;
|
|
507
|
+
|
|
508
|
+
return {
|
|
509
|
+
detectorId,
|
|
510
|
+
slug: 'relay-breaker',
|
|
511
|
+
triggered,
|
|
512
|
+
subType,
|
|
513
|
+
prevState,
|
|
514
|
+
nextState,
|
|
515
|
+
decision: triggered ? (isBlockMode ? 'block' : 'steer') : 'allow',
|
|
516
|
+
refereeMarkerCount,
|
|
517
|
+
matchedMarkers,
|
|
518
|
+
hardNegativeFilter: null,
|
|
519
|
+
pasteChars,
|
|
520
|
+
tailInjection,
|
|
521
|
+
hudBadge,
|
|
522
|
+
relayStateSnapshot: {
|
|
523
|
+
state: nextState,
|
|
524
|
+
critiquePastes: nextCritiquePastes,
|
|
525
|
+
boundSpecPath: activeSpecPath
|
|
526
|
+
}
|
|
527
|
+
};
|
|
528
|
+
}
|
|
529
|
+
|
|
530
|
+
/**
|
|
531
|
+
* Two-Stage `PreToolUse` Sightseeing-Tool Interception Fallback (Section 4).
|
|
532
|
+
* When `unanchoredTurnFlag` or `relayState === 'Locked'` (or `'Armed'` web search) was recorded
|
|
533
|
+
* at prompt submission, intercepts the model's first exploratory repository scan or web search.
|
|
534
|
+
*
|
|
535
|
+
* @param {object} [params={}]
|
|
536
|
+
* @returns {{
|
|
537
|
+
* intercepted: boolean,
|
|
538
|
+
* detectorId: string | null,
|
|
539
|
+
* subType: string | null,
|
|
540
|
+
* decision: 'allow' | 'deny',
|
|
541
|
+
* reason: string | null,
|
|
542
|
+
* consumeFlag: boolean
|
|
543
|
+
* }}
|
|
544
|
+
*/
|
|
545
|
+
export function evaluateTwoStageSightseeingIntercept({
|
|
546
|
+
toolName = '',
|
|
547
|
+
toolArgs = {},
|
|
548
|
+
unanchoredTurnFlag = false,
|
|
549
|
+
candidateFiles = [],
|
|
550
|
+
relayState = null,
|
|
551
|
+
overrideMode = 'default',
|
|
552
|
+
flightMode = 'COACH',
|
|
553
|
+
detectorId = 'DET-26'
|
|
554
|
+
} = {}) {
|
|
555
|
+
const name = String(toolName || '').trim();
|
|
556
|
+
const isExploratorySearchOrList =
|
|
557
|
+
/^(?:Grep|Glob|grep_search|find_by_name|list_dir|WebFetch|web_search|search_web)$/i.test(name);
|
|
558
|
+
const isWebSearchTool = /^(?:WebFetch|web_search|search_web)$/i.test(name);
|
|
559
|
+
const isUnscopedRead =
|
|
560
|
+
/^(?:Read|read_file|view_file)$/i.test(name) &&
|
|
561
|
+
candidateFiles.length > 0 &&
|
|
562
|
+
!candidateFiles.some((cf) => {
|
|
563
|
+
const target = String(
|
|
564
|
+
toolArgs?.file_path || toolArgs?.Path || toolArgs?.TargetFile || toolArgs?.path || ''
|
|
565
|
+
).replace(/\\/g, '/');
|
|
566
|
+
return target && (target.endsWith(cf) || cf.endsWith(target));
|
|
567
|
+
});
|
|
568
|
+
|
|
569
|
+
// 1. Scope Brake Two-Stage Gate: intercept first exploratory search/list/unscoped read on unanchored turn
|
|
570
|
+
if (Boolean(unanchoredTurnFlag) && (isExploratorySearchOrList || isUnscopedRead)) {
|
|
571
|
+
const candidateHint =
|
|
572
|
+
Array.isArray(candidateFiles) && candidateFiles.length > 0
|
|
573
|
+
? candidateFiles.slice(0, 3).join(', ')
|
|
574
|
+
: '@<target-file>';
|
|
575
|
+
const normOverride = String(overrideMode || 'default').toLowerCase();
|
|
576
|
+
const shouldDeny =
|
|
577
|
+
normOverride === 'block' ||
|
|
578
|
+
normOverride === 'warn' ||
|
|
579
|
+
String(flightMode || '').toUpperCase() === 'AUTO_PILOT';
|
|
580
|
+
|
|
581
|
+
return {
|
|
582
|
+
intercepted: true,
|
|
583
|
+
detectorId,
|
|
584
|
+
subType: 'TWO_STAGE_SCOPE_BRAKE_INTERCEPT',
|
|
585
|
+
decision: shouldDeny ? 'deny' : 'allow',
|
|
586
|
+
reason:
|
|
587
|
+
`[${detectorId} Scope Brake Two-Stage Gate] Exploratory tool "${name}" intercepted on unanchored turn. ` +
|
|
588
|
+
`Stop scanning the repository and ask 1 concrete scoping question naming candidate files (${candidateHint}) and the optimization axis.`,
|
|
589
|
+
consumeFlag: true
|
|
590
|
+
};
|
|
591
|
+
}
|
|
592
|
+
|
|
593
|
+
// 2. Relay Breaker Two-Stage Gate: intercept exploratory WebFetch/web_search during Armed/Final Pass/Locked spec relay
|
|
594
|
+
const currentRelayState =
|
|
595
|
+
typeof relayState === 'string' ? relayState : relayState?.state || RELAY_STATES.IDLE;
|
|
596
|
+
if (
|
|
597
|
+
isWebSearchTool &&
|
|
598
|
+
(currentRelayState === RELAY_STATES.ARMED ||
|
|
599
|
+
currentRelayState === RELAY_STATES.FINAL_PASS ||
|
|
600
|
+
currentRelayState === RELAY_STATES.LOCKED)
|
|
601
|
+
) {
|
|
602
|
+
return {
|
|
603
|
+
intercepted: true,
|
|
604
|
+
detectorId,
|
|
605
|
+
subType: 'TWO_STAGE_RELAY_WEB_SEARCH_INTERCEPT',
|
|
606
|
+
decision: 'deny',
|
|
607
|
+
reason:
|
|
608
|
+
`[${detectorId} Relay Breaker Two-Stage Gate] Exploratory web fetch ("${name}") blocked during ${currentRelayState} spec relay. ` +
|
|
609
|
+
`Do not scrape uncited external pages during critique relays; verify claims via local code or ask the user for primary source citations.`,
|
|
610
|
+
consumeFlag: false
|
|
611
|
+
};
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
return {
|
|
615
|
+
intercepted: false,
|
|
616
|
+
detectorId: null,
|
|
617
|
+
subType: null,
|
|
618
|
+
decision: 'allow',
|
|
619
|
+
reason: null,
|
|
620
|
+
consumeFlag: false
|
|
621
|
+
};
|
|
622
|
+
}
|
|
623
|
+
|
|
624
|
+
const SHARDED_SPEC_PIVOT_PATTERNS = Object.freeze([
|
|
625
|
+
/\b(?:actually|instead|wait)\b[^.?!]{0,40}\b(?:make|use|support|change|switch|add|keep|enforce|require|return|handle|format|allow|reject|export|include|preserve)\b/i,
|
|
626
|
+
/\b(?:also|additionally)\s+(?:make\s+sure|add|support|include|handle|enforce|allow|ensure|require|update|expose|reject|export|return)\b/i,
|
|
627
|
+
/\b(?:don't\s+forget\s+to|do\s+not\s+forget\s+to|make\s+sure\s+(?:it|we|you)\s+(?:also\s+)?(?:support|handle|reject|enforce|preserve|include|export|return)|one\s+more\s+(?:thing|requirement|constraint)|new\s+requirement|change\s+the\s+(?:format|schema|output|contract|behavior)\s+to)\b/i
|
|
628
|
+
]);
|
|
629
|
+
|
|
630
|
+
const TRIVIAL_COMMAND_FOLLOWUP_RE =
|
|
631
|
+
/^(?:also|and|now|then|please)?\s*(?:just\s+)?(?:run|re-?run|execute|check)\s+(?:the\s+)?(?:unit\s+|integration\s+|all\s+)?(?:tests?|npm\s+test|pnpm\s+test|pytest|vitest|jest|lint|build|typecheck|tsc|git\s+status|git\s+diff)[.!?\s]*$/i;
|
|
632
|
+
|
|
633
|
+
const TURN1_BUILD_INTENT_RE =
|
|
634
|
+
/\b(?:build|implement|create|design|architect|redesign|migrate|refactor|overhaul|integrate|add\s+support\s+for|set\s+up)\b/i;
|
|
635
|
+
|
|
636
|
+
const TURN1_QUESTION_RE =
|
|
637
|
+
/^(?:how|why|what|where|when|who|can\s+you\s+explain|could\s+you\s+explain|explain|describe|review|summarize)\b/i;
|
|
638
|
+
|
|
639
|
+
const TURN1_SPEC_REF_RE = /\bspecs?[\\/][\w.-]+\.md\b/i;
|
|
640
|
+
|
|
641
|
+
const REAL_CODE_SYMBOL_RE =
|
|
642
|
+
/`[^`]{2,}`|\b[a-z][a-zA-Z0-9]+_[a-zA-Z0-9_]+\b|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]+\b|\b[A-Z][a-z0-9]+[A-Z][A-Za-z0-9]*\b|\b[a-zA-Z_]\w+\([^\x29]*\)/;
|
|
643
|
+
|
|
644
|
+
const TURN1_BOUNDARY_RE =
|
|
645
|
+
/\b(?:do\s+not|don't|only|without\s+touching|out\s+of\s+scope|non-goal|avoid|preserve|must\s+not|cannot)\b/i;
|
|
646
|
+
|
|
647
|
+
const TURN1_VERIFY_RE =
|
|
648
|
+
/\b(?:test|tests|verify|verification|acceptance\s+criteria|should\s+pass|assert|exit\s+code|exit\s+0|spec|benchmark)\b/i;
|
|
649
|
+
|
|
650
|
+
export const TURN1_CONTRACT_DIRECTIVE =
|
|
651
|
+
'[CTX_CONTRACT: State (1) target files, (2) negative constraints/invariants, and (3) verification command in <=8 lines before calling file-mutation tools.]';
|
|
652
|
+
|
|
653
|
+
/**
|
|
654
|
+
* Tracks cross-turn requirement-modifying user prompts (`Spec Sharding / Drip-Feed`)
|
|
655
|
+
* and emits `[CTX_HINT: SHARDED_SPEC]` when 4+ constraint shards accumulate alongside `>=25k` tokens.
|
|
656
|
+
* Zero I/O, Mod Law 4 compliant.
|
|
657
|
+
*
|
|
658
|
+
* @param {object} [params={}]
|
|
659
|
+
*/
|
|
660
|
+
export function evaluateShardedSpecDrift({
|
|
661
|
+
prompt = '',
|
|
662
|
+
provenance = 'user',
|
|
663
|
+
isAutonomousTurn = false,
|
|
664
|
+
isSubagent = false,
|
|
665
|
+
isScheduledTask = false,
|
|
666
|
+
isLoopIteration = false,
|
|
667
|
+
priorShards = [],
|
|
668
|
+
initialGoal = '',
|
|
669
|
+
totalTokens = 0,
|
|
670
|
+
turnNumber = 1,
|
|
671
|
+
lastAlertTurn = 0,
|
|
672
|
+
minShards = 4,
|
|
673
|
+
minTokens = 25000,
|
|
674
|
+
cooldownTurns = 3,
|
|
675
|
+
overrideMode = 'default',
|
|
676
|
+
flightMode = 'COACH',
|
|
677
|
+
detectorId = 'DET-26'
|
|
678
|
+
} = {}) {
|
|
679
|
+
const safeShards = Array.isArray(priorShards)
|
|
680
|
+
? priorShards
|
|
681
|
+
.filter((s) => s && typeof s.excerpt === 'string' && s.excerpt.trim().length > 0)
|
|
682
|
+
.map((s) => ({ turn: Number(s.turn || 0), excerpt: String(s.excerpt).trim() }))
|
|
683
|
+
: [];
|
|
684
|
+
const raw = String(prompt || '').trim();
|
|
685
|
+
const cleaned = raw.replace(/#check\b/gi, '').trim();
|
|
686
|
+
const normOverride = String(overrideMode || 'default').toLowerCase();
|
|
687
|
+
const fmUpper = String(flightMode || 'COACH').toUpperCase();
|
|
688
|
+
const numericTurn = Math.max(1, Number(turnNumber || 1));
|
|
689
|
+
const numericLastAlert = Number(lastAlertTurn || 0);
|
|
690
|
+
const nextInitialGoal =
|
|
691
|
+
String(initialGoal || '').trim() || (numericTurn <= 1 && cleaned ? cleaned.slice(0, 280) : '');
|
|
692
|
+
|
|
693
|
+
const noOp = (reason = null) => ({
|
|
694
|
+
detectorId,
|
|
695
|
+
slug: 'sharded-spec-drift',
|
|
696
|
+
triggered: false,
|
|
697
|
+
subType: null,
|
|
698
|
+
decision: 'allow',
|
|
699
|
+
bypassReason: reason,
|
|
700
|
+
shardCount: safeShards.length,
|
|
701
|
+
specShards: safeShards,
|
|
702
|
+
initialGoal: nextInitialGoal,
|
|
703
|
+
lastAlertTurn: numericLastAlert,
|
|
704
|
+
steerContext: null
|
|
705
|
+
});
|
|
706
|
+
|
|
707
|
+
if (normOverride === 'off' || fmUpper === 'OFF' || fmUpper === 'SILENT') {
|
|
708
|
+
return noOp('DISABLED_BY_CONFIG');
|
|
709
|
+
}
|
|
710
|
+
|
|
711
|
+
if (
|
|
712
|
+
Boolean(isAutonomousTurn) ||
|
|
713
|
+
Boolean(isSubagent) ||
|
|
714
|
+
Boolean(isScheduledTask) ||
|
|
715
|
+
Boolean(isLoopIteration) ||
|
|
716
|
+
AUTONOMOUS_PROVENANCE_RE.test(String(provenance || '')) ||
|
|
717
|
+
!cleaned ||
|
|
718
|
+
cleaned.startsWith('/') ||
|
|
719
|
+
AFFIRMATIVE_OR_CONTINUATION_RE.test(cleaned)
|
|
720
|
+
) {
|
|
721
|
+
return noOp('AUTONOMOUS_OR_CONTINUATION');
|
|
722
|
+
}
|
|
723
|
+
|
|
724
|
+
if (matchRelayHardNegativeFilter(cleaned).matched) {
|
|
725
|
+
return noOp('HARD_NEGATIVE_PAYLOAD');
|
|
726
|
+
}
|
|
727
|
+
|
|
728
|
+
let nextShards = safeShards.slice();
|
|
729
|
+
const isFollowUpTurn = numericTurn >= 2 || Boolean(String(initialGoal || '').trim()) || safeShards.length > 0;
|
|
730
|
+
const isPivotPrompt =
|
|
731
|
+
isFollowUpTurn &&
|
|
732
|
+
!TRIVIAL_COMMAND_FOLLOWUP_RE.test(cleaned) &&
|
|
733
|
+
SHARDED_SPEC_PIVOT_PATTERNS.some((re) => re.test(cleaned));
|
|
734
|
+
|
|
735
|
+
if (isPivotPrompt) {
|
|
736
|
+
const excerpt = cleaned.slice(0, 220);
|
|
737
|
+
const prevExcerpt = nextShards.length > 0 ? nextShards[nextShards.length - 1].excerpt : '';
|
|
738
|
+
if (excerpt && excerpt !== prevExcerpt) {
|
|
739
|
+
nextShards.push({ turn: numericTurn, excerpt });
|
|
740
|
+
if (nextShards.length > 10) {
|
|
741
|
+
nextShards = nextShards.slice(-10);
|
|
742
|
+
}
|
|
743
|
+
}
|
|
744
|
+
}
|
|
745
|
+
|
|
746
|
+
const tokensNum = Math.max(0, Number(totalTokens || 0));
|
|
747
|
+
const cooldownOk = numericLastAlert <= 0 || numericTurn - numericLastAlert >= Number(cooldownTurns || 3);
|
|
748
|
+
const triggered =
|
|
749
|
+
isPivotPrompt &&
|
|
750
|
+
nextShards.length >= Number(minShards || 4) &&
|
|
751
|
+
tokensNum >= Number(minTokens || 25000) &&
|
|
752
|
+
cooldownOk;
|
|
753
|
+
|
|
754
|
+
if (!triggered) {
|
|
755
|
+
return {
|
|
756
|
+
detectorId,
|
|
757
|
+
slug: 'sharded-spec-drift',
|
|
758
|
+
triggered: false,
|
|
759
|
+
subType: null,
|
|
760
|
+
decision: 'allow',
|
|
761
|
+
bypassReason: null,
|
|
762
|
+
shardCount: nextShards.length,
|
|
763
|
+
specShards: nextShards,
|
|
764
|
+
initialGoal: nextInitialGoal,
|
|
765
|
+
lastAlertTurn: numericLastAlert,
|
|
766
|
+
steerContext: null
|
|
767
|
+
};
|
|
768
|
+
}
|
|
769
|
+
|
|
770
|
+
const steerContext = `[CTX_HINT: SHARDED_SPEC — ${nextShards.length} incremental constraint turns across ~${Math.round(tokensNum / 1000)}k tokens. Run \`npx ctxtop handoff --consolidate\` (or /handoff) to merge scattered requirements into one clean contract before restarting.]`;
|
|
771
|
+
return {
|
|
772
|
+
detectorId,
|
|
773
|
+
slug: 'sharded-spec-drift',
|
|
774
|
+
triggered: true,
|
|
775
|
+
subType: 'SHARDED_SPEC_DRIFT',
|
|
776
|
+
decision: 'steer',
|
|
777
|
+
bypassReason: null,
|
|
778
|
+
shardCount: nextShards.length,
|
|
779
|
+
specShards: nextShards,
|
|
780
|
+
initialGoal: nextInitialGoal,
|
|
781
|
+
lastAlertTurn: numericTurn,
|
|
782
|
+
steerContext
|
|
783
|
+
};
|
|
784
|
+
}
|
|
785
|
+
|
|
786
|
+
/**
|
|
787
|
+
* One-shot Turn-1 Specification Contract Gate (`[CTX_CONTRACT]`) for unanchored multi-file build/refactor prompts.
|
|
788
|
+
* Skips `/plan` mode, questions, slash commands, active-set matches, and Turn 2+.
|
|
789
|
+
* Zero I/O, Mod Law 4 compliant.
|
|
790
|
+
*
|
|
791
|
+
* @param {object} [params={}]
|
|
792
|
+
*/
|
|
793
|
+
export function evaluateTurn1ContractGate({
|
|
794
|
+
prompt = '',
|
|
795
|
+
provenance = 'user',
|
|
796
|
+
isAutonomousTurn = false,
|
|
797
|
+
isSubagent = false,
|
|
798
|
+
isScheduledTask = false,
|
|
799
|
+
isLoopIteration = false,
|
|
800
|
+
inPlanMode = false,
|
|
801
|
+
turnNumber = 1,
|
|
802
|
+
invocationNum = 1,
|
|
803
|
+
alreadyInjected = false,
|
|
804
|
+
hasActiveSetMatch = false,
|
|
805
|
+
sufficiency = null,
|
|
806
|
+
overrideMode = 'default',
|
|
807
|
+
flightMode = 'COACH',
|
|
808
|
+
detectorId = 'DET-26'
|
|
809
|
+
} = {}) {
|
|
810
|
+
const allow = (bypassReason = null) => ({
|
|
811
|
+
detectorId,
|
|
812
|
+
slug: 'turn1-contract-gate',
|
|
813
|
+
triggered: false,
|
|
814
|
+
subType: null,
|
|
815
|
+
decision: 'allow',
|
|
816
|
+
bypassReason,
|
|
817
|
+
contractDirective: null
|
|
818
|
+
});
|
|
819
|
+
|
|
820
|
+
const normOverride = String(overrideMode || 'default').toLowerCase();
|
|
821
|
+
const fmUpper = String(flightMode || 'COACH').toUpperCase();
|
|
822
|
+
if (normOverride === 'off' || fmUpper === 'OFF' || fmUpper === 'SILENT') {
|
|
823
|
+
return allow('DISABLED_BY_CONFIG');
|
|
824
|
+
}
|
|
825
|
+
|
|
826
|
+
if (
|
|
827
|
+
Boolean(alreadyInjected) ||
|
|
828
|
+
Number(turnNumber || 1) > 1 ||
|
|
829
|
+
Number(invocationNum || 1) > 1 ||
|
|
830
|
+
Boolean(inPlanMode) ||
|
|
831
|
+
Boolean(hasActiveSetMatch)
|
|
832
|
+
) {
|
|
833
|
+
return allow('NOT_ELIGIBLE_TURN1');
|
|
834
|
+
}
|
|
835
|
+
|
|
836
|
+
if (
|
|
837
|
+
Boolean(isAutonomousTurn) ||
|
|
838
|
+
Boolean(isSubagent) ||
|
|
839
|
+
Boolean(isScheduledTask) ||
|
|
840
|
+
Boolean(isLoopIteration) ||
|
|
841
|
+
AUTONOMOUS_PROVENANCE_RE.test(String(provenance || ''))
|
|
842
|
+
) {
|
|
843
|
+
return allow('AUTONOMOUS_BYPASS');
|
|
844
|
+
}
|
|
845
|
+
|
|
846
|
+
const cleaned = String(prompt || '').replace(/#check\b/gi, '').trim();
|
|
847
|
+
if (
|
|
848
|
+
!cleaned ||
|
|
849
|
+
cleaned.startsWith('/') ||
|
|
850
|
+
AFFIRMATIVE_OR_CONTINUATION_RE.test(cleaned) ||
|
|
851
|
+
cleaned.endsWith('?') ||
|
|
852
|
+
TURN1_QUESTION_RE.test(cleaned) ||
|
|
853
|
+
TURN1_SPEC_REF_RE.test(cleaned) ||
|
|
854
|
+
matchRelayHardNegativeFilter(cleaned).matched
|
|
855
|
+
) {
|
|
856
|
+
return allow('EXEMPT_PROMPT_KIND');
|
|
857
|
+
}
|
|
858
|
+
|
|
859
|
+
const wordCount = cleaned.split(/\s+/).filter(Boolean).length;
|
|
860
|
+
if (wordCount < 8 || wordCount > 55 || !TURN1_BUILD_INTENT_RE.test(cleaned)) {
|
|
861
|
+
return allow('NOT_UNANCHORED_BUILD');
|
|
862
|
+
}
|
|
863
|
+
|
|
864
|
+
const hasConcreteTarget =
|
|
865
|
+
CONCRETE_FILE_OR_PATH_RE.test(cleaned) || REAL_CODE_SYMBOL_RE.test(cleaned);
|
|
866
|
+
if (hasConcreteTarget) {
|
|
867
|
+
return allow('HAS_CONCRETE_TARGET');
|
|
868
|
+
}
|
|
869
|
+
|
|
870
|
+
const dims = sufficiency?.dims || null;
|
|
871
|
+
const lacksBoundaryOrVerify = dims
|
|
872
|
+
? Number(dims.boundedness || 0) === 0 || Number(dims.testability || 0) === 0
|
|
873
|
+
: !TURN1_BOUNDARY_RE.test(cleaned) || !TURN1_VERIFY_RE.test(cleaned);
|
|
874
|
+
|
|
875
|
+
if (!lacksBoundaryOrVerify) {
|
|
876
|
+
return allow('HAS_CONSTRAINTS_AND_VERIFY');
|
|
877
|
+
}
|
|
878
|
+
|
|
879
|
+
return {
|
|
880
|
+
detectorId,
|
|
881
|
+
slug: 'turn1-contract-gate',
|
|
882
|
+
triggered: true,
|
|
883
|
+
subType: 'TURN1_CONTRACT_GATE',
|
|
884
|
+
decision: 'steer',
|
|
885
|
+
bypassReason: null,
|
|
886
|
+
contractDirective: TURN1_CONTRACT_DIRECTIVE
|
|
887
|
+
};
|
|
888
|
+
}
|