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,578 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { canonicalizePath } from '../paths.mjs';
|
|
4
|
+
import { atomicWriteFileSync } from '../atomic_io.mjs';
|
|
5
|
+
import { recordHookDiagnostic } from '../hook_diagnostics.mjs';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Phase 4 / Ring 1 Hardening: Advisory Workspace Scope Registry & DET-20 Collision Alert
|
|
9
|
+
* (`src/core/telemetry/scope_lock_registry.mjs`)
|
|
10
|
+
*
|
|
11
|
+
* Maintains `.agents/locks/active_scopes.json` mapping active session/trajectory IDs
|
|
12
|
+
* to claimed relative file paths (derived from active `task.md` targets and dirty `git status` paths).
|
|
13
|
+
*
|
|
14
|
+
* Invariants:
|
|
15
|
+
* - Atomic Windows-safe writes via temp file rename with EPERM fallback.
|
|
16
|
+
* - Automatic eviction of stale leases where `Date.now() > expiresAtMs` (300s TTL)
|
|
17
|
+
* or where the owning `pid` is no longer alive (`!isPidAlive(pid)`).
|
|
18
|
+
* - DET-20 Collision Alert: Triggers when the current trajectory attempts to claim or edit
|
|
19
|
+
* a file held by another live trajectory ID, warning of 2x merge conflict risk and
|
|
20
|
+
* providing a 1-click `git worktree` command snippet.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
export const SCOPE_LOCK_CONSTANTS = Object.freeze({
|
|
24
|
+
DEFAULT_TTL_SECONDS: 900,
|
|
25
|
+
DEFAULT_TTL_MS: 900_000,
|
|
26
|
+
LOCK_FILE_NAME: 'active_scopes.json',
|
|
27
|
+
DETECTOR_ID: 'DET-20',
|
|
28
|
+
VERSION: 1,
|
|
29
|
+
SCHEMA_VERSION: '2026.11.1'
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Determines whether a process with the given PID is currently alive on the host.
|
|
34
|
+
*/
|
|
35
|
+
export function isPidAlive(pid) {
|
|
36
|
+
if (!pid || typeof pid !== 'number' || pid <= 0) return false;
|
|
37
|
+
try {
|
|
38
|
+
process.kill(pid, 0);
|
|
39
|
+
return true;
|
|
40
|
+
} catch (err) {
|
|
41
|
+
return err.code !== 'ESRCH';
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Returns the path to `.agents/locks/active_scopes.json` (Antigravity's owned lockfile).
|
|
47
|
+
*/
|
|
48
|
+
export function getLockFilePath(workspaceDir = process.cwd()) {
|
|
49
|
+
return path.join(workspaceDir, '.agents', 'locks', SCOPE_LOCK_CONSTANTS.LOCK_FILE_NAME);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Returns the path to `.claude/locks/active_scopes.json` (Claude Code cross-harness lockfile, read-only).
|
|
54
|
+
*/
|
|
55
|
+
export function getClaudeLockFilePath(workspaceDir = process.cwd()) {
|
|
56
|
+
return path.join(workspaceDir, '.claude', 'locks', SCOPE_LOCK_CONSTANTS.LOCK_FILE_NAME);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Normalizes relative file paths or scope globs for cross-platform comparison.
|
|
61
|
+
*/
|
|
62
|
+
export function normalizeClaimedPath(filePath = '') {
|
|
63
|
+
return String(filePath || '')
|
|
64
|
+
.trim()
|
|
65
|
+
.replace(/^["']|["']$/g, '')
|
|
66
|
+
.replace(/\\/g, '/')
|
|
67
|
+
.replace(/^\.\//, '')
|
|
68
|
+
.toLowerCase();
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function compileScopeGlob(pattern) {
|
|
72
|
+
const norm = normalizeClaimedPath(pattern);
|
|
73
|
+
if (!norm) return null;
|
|
74
|
+
if (norm.endsWith('/') && !norm.includes('*') && !norm.includes('?')) {
|
|
75
|
+
const base = norm.slice(0, -1);
|
|
76
|
+
const escapedBase = base.replace(/[.+^${}()|[\]\\]/g, '\\$&');
|
|
77
|
+
return new RegExp(`^${escapedBase}(?:/.*)?$`, 'i');
|
|
78
|
+
}
|
|
79
|
+
let regexSrc = '^';
|
|
80
|
+
for (let i = 0; i < norm.length; i++) {
|
|
81
|
+
const ch = norm[i];
|
|
82
|
+
if (ch === '*') {
|
|
83
|
+
if (norm[i + 1] === '*') {
|
|
84
|
+
if (norm[i + 2] === '/') {
|
|
85
|
+
regexSrc += '(?:.+/)?';
|
|
86
|
+
i += 2;
|
|
87
|
+
} else {
|
|
88
|
+
regexSrc += '.*';
|
|
89
|
+
i += 1;
|
|
90
|
+
}
|
|
91
|
+
} else {
|
|
92
|
+
regexSrc += '[^/]*';
|
|
93
|
+
}
|
|
94
|
+
} else if (ch === '?') {
|
|
95
|
+
regexSrc += '[^/]';
|
|
96
|
+
} else {
|
|
97
|
+
regexSrc += ch.replace(/[.+^${}()|[\]\\]/g, '\\$&');
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
regexSrc += '$';
|
|
101
|
+
return new RegExp(regexSrc, 'i');
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* Returns true if two normalized paths or glob patterns overlap (exact match, directory prefix, or glob).
|
|
106
|
+
*/
|
|
107
|
+
export function scopesOverlap(scopeA, scopeB) {
|
|
108
|
+
const a = normalizeClaimedPath(scopeA);
|
|
109
|
+
const b = normalizeClaimedPath(scopeB);
|
|
110
|
+
if (!a || !b) return false;
|
|
111
|
+
if (a === b) return true;
|
|
112
|
+
|
|
113
|
+
const aHasGlob = a.includes('*') || a.includes('?') || a.endsWith('/');
|
|
114
|
+
const bHasGlob = b.includes('*') || b.includes('?') || b.endsWith('/');
|
|
115
|
+
if (!aHasGlob && !bHasGlob) return false;
|
|
116
|
+
|
|
117
|
+
if (aHasGlob) {
|
|
118
|
+
const reA = compileScopeGlob(a);
|
|
119
|
+
if (reA && reA.test(b)) return true;
|
|
120
|
+
}
|
|
121
|
+
if (bHasGlob) {
|
|
122
|
+
const reB = compileScopeGlob(b);
|
|
123
|
+
if (reB && reB.test(a)) return true;
|
|
124
|
+
}
|
|
125
|
+
if (aHasGlob && bHasGlob) {
|
|
126
|
+
const prefixA = a.split(/[*?]/)[0].replace(/\/+$/, '');
|
|
127
|
+
const prefixB = b.split(/[*?]/)[0].replace(/\/+$/, '');
|
|
128
|
+
if (!prefixA || !prefixB) return true;
|
|
129
|
+
if (prefixA === prefixB || prefixA.startsWith(`${prefixB}/`) || prefixB.startsWith(`${prefixA}/`)) {
|
|
130
|
+
return true;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* Normalizes either an Antigravity `leases[]` item or a Claude Code `locks[]` item
|
|
138
|
+
* into a unified cross-edition lease record.
|
|
139
|
+
*/
|
|
140
|
+
export function normalizeScopeLeaseEntry(rawEntry = {}, {
|
|
141
|
+
source = 'local',
|
|
142
|
+
defaultTool = 'antigravity',
|
|
143
|
+
now = Date.now()
|
|
144
|
+
} = {}) {
|
|
145
|
+
if (!rawEntry || typeof rawEntry !== 'object') return null;
|
|
146
|
+
const trajectoryId = String(
|
|
147
|
+
rawEntry.trajectoryId ||
|
|
148
|
+
rawEntry.ownerId ||
|
|
149
|
+
rawEntry.agent_id ||
|
|
150
|
+
rawEntry.session_id ||
|
|
151
|
+
''
|
|
152
|
+
).trim();
|
|
153
|
+
if (!trajectoryId) return null;
|
|
154
|
+
|
|
155
|
+
const rawPaths = Array.isArray(rawEntry.claimedPaths)
|
|
156
|
+
? rawEntry.claimedPaths
|
|
157
|
+
: (Array.isArray(rawEntry.scopes)
|
|
158
|
+
? rawEntry.scopes
|
|
159
|
+
: (Array.isArray(rawEntry.files_locked) ? rawEntry.files_locked : []));
|
|
160
|
+
const claimedPaths = Array.from(
|
|
161
|
+
new Set(rawPaths.map((p) => String(p || '').trim()).filter(Boolean))
|
|
162
|
+
);
|
|
163
|
+
|
|
164
|
+
const parsedAcquired = typeof rawEntry.acquiredAt === 'number' && Number.isFinite(rawEntry.acquiredAt)
|
|
165
|
+
? rawEntry.acquiredAt
|
|
166
|
+
: Date.parse(rawEntry.acquired_at || rawEntry.updatedAtIso || '');
|
|
167
|
+
const acquiredAtMs = Number.isFinite(parsedAcquired) ? parsedAcquired : now;
|
|
168
|
+
|
|
169
|
+
let expiresAtMs = null;
|
|
170
|
+
if (typeof rawEntry.expiresAtMs === 'number' && Number.isFinite(rawEntry.expiresAtMs)) {
|
|
171
|
+
expiresAtMs = rawEntry.expiresAtMs;
|
|
172
|
+
} else if (typeof rawEntry.expiresAt === 'number' && Number.isFinite(rawEntry.expiresAt)) {
|
|
173
|
+
expiresAtMs = rawEntry.expiresAt;
|
|
174
|
+
} else if (typeof rawEntry.expiresAt === 'string' && rawEntry.expiresAt.trim()) {
|
|
175
|
+
const parsedExp = Date.parse(rawEntry.expiresAt);
|
|
176
|
+
if (Number.isFinite(parsedExp)) expiresAtMs = parsedExp;
|
|
177
|
+
} else if (typeof rawEntry.expires_at === 'string' && rawEntry.expires_at.trim()) {
|
|
178
|
+
const parsedExp = Date.parse(rawEntry.expires_at);
|
|
179
|
+
if (Number.isFinite(parsedExp)) expiresAtMs = parsedExp;
|
|
180
|
+
}
|
|
181
|
+
if (!Number.isFinite(expiresAtMs)) {
|
|
182
|
+
const ttlMs = Number(rawEntry.ttl_ms) > 0
|
|
183
|
+
? Number(rawEntry.ttl_ms)
|
|
184
|
+
: SCOPE_LOCK_CONSTANTS.DEFAULT_TTL_MS;
|
|
185
|
+
expiresAtMs = acquiredAtMs + ttlMs;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
const ttlMs = Number(rawEntry.ttl_ms) > 0
|
|
189
|
+
? Number(rawEntry.ttl_ms)
|
|
190
|
+
: Math.max(1000, expiresAtMs - acquiredAtMs);
|
|
191
|
+
const pid = typeof rawEntry.pid === 'number' && Number.isFinite(rawEntry.pid) ? rawEntry.pid : undefined;
|
|
192
|
+
const tool = String(rawEntry.tool || (source === 'cross_harness' ? 'claude-code' : defaultTool));
|
|
193
|
+
|
|
194
|
+
return {
|
|
195
|
+
trajectoryId,
|
|
196
|
+
ownerId: rawEntry.ownerId || trajectoryId,
|
|
197
|
+
agent_id: rawEntry.agent_id || trajectoryId,
|
|
198
|
+
session_id: rawEntry.session_id || trajectoryId,
|
|
199
|
+
...(pid !== undefined ? { pid } : {}),
|
|
200
|
+
tool,
|
|
201
|
+
claimedPaths,
|
|
202
|
+
files_locked: claimedPaths,
|
|
203
|
+
scopes: claimedPaths,
|
|
204
|
+
acquiredAt: acquiredAtMs,
|
|
205
|
+
acquired_at: new Date(acquiredAtMs).toISOString(),
|
|
206
|
+
updatedAtIso: rawEntry.updatedAtIso || new Date(acquiredAtMs).toISOString(),
|
|
207
|
+
expiresAt: expiresAtMs,
|
|
208
|
+
expiresAtMs,
|
|
209
|
+
expires_at: new Date(expiresAtMs).toISOString(),
|
|
210
|
+
ttl_ms: ttlMs,
|
|
211
|
+
source
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
function readLockFileEntriesSafe(lockFilePath, { source, defaultTool, now }) {
|
|
216
|
+
if (!lockFilePath || !fs.existsSync(lockFilePath)) return [];
|
|
217
|
+
try {
|
|
218
|
+
const raw = fs.readFileSync(lockFilePath, 'utf8');
|
|
219
|
+
const data = JSON.parse(raw);
|
|
220
|
+
const combinedRaw = [
|
|
221
|
+
...(Array.isArray(data?.leases) ? data.leases : []),
|
|
222
|
+
...(Array.isArray(data?.locks) ? data.locks : [])
|
|
223
|
+
];
|
|
224
|
+
const dedupedByOwner = new Map();
|
|
225
|
+
for (const item of combinedRaw) {
|
|
226
|
+
const normalized = normalizeScopeLeaseEntry(item, { source, defaultTool, now });
|
|
227
|
+
if (!normalized) continue;
|
|
228
|
+
const isExpired = typeof normalized.expiresAtMs === 'number' && now > normalized.expiresAtMs;
|
|
229
|
+
const pidAlive = typeof normalized.pid === 'number' ? isPidAlive(normalized.pid) : true;
|
|
230
|
+
if (!isExpired && pidAlive) {
|
|
231
|
+
dedupedByOwner.set(normalized.trajectoryId, normalized);
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
return Array.from(dedupedByOwner.values());
|
|
235
|
+
} catch (err) {
|
|
236
|
+
recordHookDiagnostic('scope_lock_registry', 'readLockFileEntriesSafe', err, {
|
|
237
|
+
ignoreCodes: ['ENOENT'],
|
|
238
|
+
persist: false
|
|
239
|
+
});
|
|
240
|
+
return [];
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Loads the active scope registry from BOTH `.agents/locks/active_scopes.json` (local)
|
|
246
|
+
* and `.claude/locks/active_scopes.json` (read-only cross-harness visibility),
|
|
247
|
+
* automatically pruning expired or dead-PID leases.
|
|
248
|
+
*/
|
|
249
|
+
export function loadRegistry(workspaceDir = process.cwd(), options = {}) {
|
|
250
|
+
const now = typeof options.now === 'number' ? options.now : Date.now();
|
|
251
|
+
const includeCrossHarness = options.includeCrossHarness !== false;
|
|
252
|
+
|
|
253
|
+
const localEntries = readLockFileEntriesSafe(getLockFilePath(workspaceDir), {
|
|
254
|
+
source: 'local',
|
|
255
|
+
defaultTool: 'antigravity',
|
|
256
|
+
now
|
|
257
|
+
});
|
|
258
|
+
const crossEntries = includeCrossHarness
|
|
259
|
+
? readLockFileEntriesSafe(getClaudeLockFilePath(workspaceDir), {
|
|
260
|
+
source: 'cross_harness',
|
|
261
|
+
defaultTool: 'claude-code',
|
|
262
|
+
now
|
|
263
|
+
})
|
|
264
|
+
: [];
|
|
265
|
+
|
|
266
|
+
const mergedByKey = new Map();
|
|
267
|
+
for (const entry of localEntries) {
|
|
268
|
+
mergedByKey.set(`local::${entry.trajectoryId}`, entry);
|
|
269
|
+
}
|
|
270
|
+
for (const entry of crossEntries) {
|
|
271
|
+
if (!localEntries.some((l) => l.trajectoryId === entry.trajectoryId)) {
|
|
272
|
+
mergedByKey.set(`cross::${entry.trajectoryId}`, entry);
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
const validLeases = Array.from(mergedByKey.values());
|
|
277
|
+
const locks = validLeases.map((l) => ({
|
|
278
|
+
ownerId: l.ownerId || l.trajectoryId,
|
|
279
|
+
...(l.pid !== undefined ? { pid: l.pid } : {}),
|
|
280
|
+
tool: l.tool,
|
|
281
|
+
scopes: l.scopes || l.claimedPaths,
|
|
282
|
+
acquiredAt: l.acquiredAt,
|
|
283
|
+
expiresAt: l.expiresAtMs,
|
|
284
|
+
source: l.source
|
|
285
|
+
}));
|
|
286
|
+
|
|
287
|
+
return {
|
|
288
|
+
version: SCOPE_LOCK_CONSTANTS.VERSION,
|
|
289
|
+
schemaVersion: SCOPE_LOCK_CONSTANTS.SCHEMA_VERSION,
|
|
290
|
+
updatedAt: new Date(now).toISOString(),
|
|
291
|
+
leases: validLeases,
|
|
292
|
+
locks
|
|
293
|
+
};
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
export const loadScopeLockRegistry = loadRegistry;
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* Saves Antigravity's local registry atomically to `.agents/locks/active_scopes.json`
|
|
300
|
+
* (emitting both `leases[]` and `locks[]` for cross-edition interoperability while never
|
|
301
|
+
* modifying `.claude/locks/active_scopes.json`).
|
|
302
|
+
*/
|
|
303
|
+
export function saveRegistry(workspaceDir = process.cwd(), registry = { version: 1, leases: [] }) {
|
|
304
|
+
const now = Date.now();
|
|
305
|
+
const lockFile = getLockFilePath(workspaceDir);
|
|
306
|
+
const rawItems = Array.isArray(registry?.leases)
|
|
307
|
+
? registry.leases
|
|
308
|
+
: (Array.isArray(registry?.locks) ? registry.locks : []);
|
|
309
|
+
|
|
310
|
+
const localLeases = [];
|
|
311
|
+
const seenOwners = new Set();
|
|
312
|
+
for (const item of rawItems) {
|
|
313
|
+
if (item?.source === 'cross_harness') continue;
|
|
314
|
+
const norm = normalizeScopeLeaseEntry(item, { source: 'local', defaultTool: 'antigravity', now });
|
|
315
|
+
if (!norm || seenOwners.has(norm.trajectoryId)) continue;
|
|
316
|
+
seenOwners.add(norm.trajectoryId);
|
|
317
|
+
localLeases.push(norm);
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
const locks = localLeases.map((l) => ({
|
|
321
|
+
ownerId: l.ownerId || l.trajectoryId,
|
|
322
|
+
...(l.pid !== undefined ? { pid: l.pid } : {}),
|
|
323
|
+
tool: l.tool,
|
|
324
|
+
scopes: l.claimedPaths,
|
|
325
|
+
acquiredAt: l.acquiredAt,
|
|
326
|
+
expiresAt: l.expiresAtMs
|
|
327
|
+
}));
|
|
328
|
+
|
|
329
|
+
const payload = JSON.stringify({
|
|
330
|
+
version: registry?.version || SCOPE_LOCK_CONSTANTS.VERSION,
|
|
331
|
+
schemaVersion: SCOPE_LOCK_CONSTANTS.SCHEMA_VERSION,
|
|
332
|
+
updatedAt: new Date(now).toISOString(),
|
|
333
|
+
leases: localLeases,
|
|
334
|
+
locks
|
|
335
|
+
}, null, 2);
|
|
336
|
+
atomicWriteFileSync(lockFile, payload, { encoding: 'utf8' });
|
|
337
|
+
return true;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* Checks for file-scope collisions (exact path, directory prefix, or glob) across other active leases/locks.
|
|
342
|
+
*/
|
|
343
|
+
export function detectScopeCollision(currentTrajectoryId, claimedPaths = [], activeLeases = [], options = {}) {
|
|
344
|
+
const normalizedCurrent = Array.from(
|
|
345
|
+
new Set((Array.isArray(claimedPaths) ? claimedPaths : []).map(normalizeClaimedPath).filter(Boolean))
|
|
346
|
+
);
|
|
347
|
+
if (normalizedCurrent.length === 0) return null;
|
|
348
|
+
|
|
349
|
+
const now = typeof options.now === 'number' && Number.isFinite(options.now) ? options.now : Date.now();
|
|
350
|
+
|
|
351
|
+
for (const lease of Array.isArray(activeLeases) ? activeLeases : []) {
|
|
352
|
+
if (!lease || typeof lease !== 'object') continue;
|
|
353
|
+
const ownerId = lease.trajectoryId || lease.ownerId || lease.agent_id || lease.session_id;
|
|
354
|
+
if (!ownerId || ownerId === currentTrajectoryId) continue;
|
|
355
|
+
|
|
356
|
+
let expMs = null;
|
|
357
|
+
if (typeof lease.expiresAtMs === 'number' && Number.isFinite(lease.expiresAtMs)) {
|
|
358
|
+
expMs = lease.expiresAtMs;
|
|
359
|
+
} else if (typeof lease.expiresAt === 'number' && Number.isFinite(lease.expiresAt)) {
|
|
360
|
+
expMs = lease.expiresAt;
|
|
361
|
+
} else if (typeof lease.expiresAt === 'string' && lease.expiresAt.trim()) {
|
|
362
|
+
const parsed = Date.parse(lease.expiresAt);
|
|
363
|
+
if (Number.isFinite(parsed)) expMs = parsed;
|
|
364
|
+
} else if (typeof lease.expires_at === 'string' && lease.expires_at.trim()) {
|
|
365
|
+
const parsed = Date.parse(lease.expires_at);
|
|
366
|
+
if (Number.isFinite(parsed)) expMs = parsed;
|
|
367
|
+
}
|
|
368
|
+
if (Number.isFinite(expMs) && now > expMs) continue;
|
|
369
|
+
|
|
370
|
+
const rawLeasePaths = lease.claimedPaths || lease.scopes || lease.files_locked || [];
|
|
371
|
+
const leasePaths = rawLeasePaths.map(normalizeClaimedPath).filter(Boolean);
|
|
372
|
+
const overlapping = normalizedCurrent.filter((cp) =>
|
|
373
|
+
leasePaths.some((lp) => scopesOverlap(cp, lp))
|
|
374
|
+
);
|
|
375
|
+
|
|
376
|
+
if (overlapping.length > 0) {
|
|
377
|
+
return {
|
|
378
|
+
trajectoryId: ownerId,
|
|
379
|
+
ownerId,
|
|
380
|
+
pid: lease.pid,
|
|
381
|
+
tool: lease.tool || 'antigravity',
|
|
382
|
+
source: lease.source || 'local',
|
|
383
|
+
overlappingPaths: overlapping
|
|
384
|
+
};
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
return null;
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
/**
|
|
392
|
+
* Derives file paths touched or claimed in the current session from task.md and git status.
|
|
393
|
+
*/
|
|
394
|
+
export function deriveSessionClaimedPaths({
|
|
395
|
+
workspaceDir = process.cwd(),
|
|
396
|
+
taskMdContent = null,
|
|
397
|
+
gitStatusOutput = null
|
|
398
|
+
} = {}) {
|
|
399
|
+
const paths = new Set();
|
|
400
|
+
|
|
401
|
+
// 1. From task.md
|
|
402
|
+
let resolvedTask = taskMdContent;
|
|
403
|
+
if (resolvedTask === null) {
|
|
404
|
+
const taskPath = path.join(workspaceDir, 'task.md');
|
|
405
|
+
if (fs.existsSync(taskPath)) {
|
|
406
|
+
try {
|
|
407
|
+
resolvedTask = fs.readFileSync(taskPath, 'utf8');
|
|
408
|
+
} catch (err) {
|
|
409
|
+
recordHookDiagnostic('scope_lock_registry', 'deriveSessionClaimedPaths_readTaskMd', err, {
|
|
410
|
+
ignoreCodes: ['ENOENT'],
|
|
411
|
+
persist: false
|
|
412
|
+
});
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
if (resolvedTask) {
|
|
418
|
+
const taskLines = String(resolvedTask).split(/\r?\n/);
|
|
419
|
+
const hasChecklistItems = taskLines.some((l) => /^\s*[-*+]\s*\[[ xX\/]\]/.test(l));
|
|
420
|
+
const validFilePathRe = /([\\/]|^\.[a-zA-Z0-9_-]+|\.(mjs|cjs|js|ts|tsx|jsx|json|jsonl|md|html|css|scss|py|go|rs|java|rb|sh|ps1|yml|yaml|toml|sql|sqlite|db|proto|xml|txt|env|lock|gitignore|eslintrc|prettierrc)$)/i;
|
|
421
|
+
const versionOrMetricRe = /^v?\d+(\.\d+)+[a-zA-Z0-9_-]*$/i;
|
|
422
|
+
|
|
423
|
+
for (const line of taskLines) {
|
|
424
|
+
const trimmedLine = line.trim();
|
|
425
|
+
if (!trimmedLine) continue;
|
|
426
|
+
// Ignore completed checklist items (- [x] or - [X])
|
|
427
|
+
if (/^[-*+]\s*\[[xX]\]/.test(trimmedLine)) continue;
|
|
428
|
+
// When task.md uses checklist items, only claim paths from active/pending items (- [ ] or - [/])
|
|
429
|
+
if (hasChecklistItems && !/^[-*+]\s*\[[ \/]\]/.test(trimmedLine)) continue;
|
|
430
|
+
|
|
431
|
+
const matches = trimmedLine.match(/`([^`]+)`/g) || [];
|
|
432
|
+
for (const m of matches) {
|
|
433
|
+
const clean = m
|
|
434
|
+
.replace(/`/g, '')
|
|
435
|
+
.trim()
|
|
436
|
+
.replace(/:\d+(?:-\d+)?$/, '');
|
|
437
|
+
if (!clean || clean.includes(' ')) continue;
|
|
438
|
+
if (/^(https?:|file:|node:)/i.test(clean)) continue;
|
|
439
|
+
if (versionOrMetricRe.test(clean)) continue;
|
|
440
|
+
if (validFilePathRe.test(clean)) {
|
|
441
|
+
paths.add(clean.replace(/\\/g, '/'));
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
// 2. From git status output
|
|
448
|
+
if (gitStatusOutput) {
|
|
449
|
+
const lines = String(gitStatusOutput).split(/\r?\n/);
|
|
450
|
+
for (const line of lines) {
|
|
451
|
+
const trimmed = line.trim();
|
|
452
|
+
if (!trimmed) continue;
|
|
453
|
+
// Porcelain format: " M path", "?? path", or "R old -> new"
|
|
454
|
+
const parts = trimmed.split(/\s+/);
|
|
455
|
+
if (parts.length >= 2) {
|
|
456
|
+
let filePath = parts.slice(1).join(' ').trim();
|
|
457
|
+
if (filePath.includes(' -> ')) {
|
|
458
|
+
filePath = filePath.split(' -> ').pop().trim();
|
|
459
|
+
}
|
|
460
|
+
const norm = filePath.replace(/\\/g, '/');
|
|
461
|
+
if (
|
|
462
|
+
norm &&
|
|
463
|
+
norm !== '.' &&
|
|
464
|
+
norm !== '..' &&
|
|
465
|
+
!/^\.agents\/(scope-locks\.json|cache(\/|$))/i.test(norm)
|
|
466
|
+
) {
|
|
467
|
+
paths.add(norm);
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
return Array.from(paths).sort();
|
|
474
|
+
}
|
|
475
|
+
|
|
476
|
+
/**
|
|
477
|
+
* ScopeLockRegistry class providing lease acquisition, renewal, release, and DET-20 collision alerts.
|
|
478
|
+
*/
|
|
479
|
+
export class ScopeLockRegistry {
|
|
480
|
+
constructor(options = {}) {
|
|
481
|
+
this.workspaceDir = options.workspaceDir || process.cwd();
|
|
482
|
+
this.pid = options.pid || process.pid;
|
|
483
|
+
this.tool = options.tool || 'antigravity';
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
/**
|
|
487
|
+
* Acquires or renews a scope lease for a trajectory.
|
|
488
|
+
* If an active lease owned by another trajectory claims any of the same paths, triggers DET-20.
|
|
489
|
+
*/
|
|
490
|
+
acquireOrRenewLease({
|
|
491
|
+
trajectoryId = 'default-trajectory',
|
|
492
|
+
claimedPaths = [],
|
|
493
|
+
ttlSeconds = SCOPE_LOCK_CONSTANTS.DEFAULT_TTL_SECONDS
|
|
494
|
+
} = {}) {
|
|
495
|
+
const registry = loadRegistry(this.workspaceDir);
|
|
496
|
+
const normClaimed = Array.isArray(claimedPaths) ? claimedPaths.filter(Boolean) : [];
|
|
497
|
+
|
|
498
|
+
// Check for collision with another live trajectory
|
|
499
|
+
const collision = detectScopeCollision(trajectoryId, normClaimed, registry.leases);
|
|
500
|
+
if (collision) {
|
|
501
|
+
const worktreeBranch = `feature-parallel-${String(trajectoryId).slice(0, 8)}`;
|
|
502
|
+
const worktreeCmd = `git worktree add ../${path.basename(this.workspaceDir)}-worktree-${String(trajectoryId).slice(0, 8)} -b ${worktreeBranch}`;
|
|
503
|
+
|
|
504
|
+
return {
|
|
505
|
+
ok: false,
|
|
506
|
+
collisionDetected: true,
|
|
507
|
+
detectorId: SCOPE_LOCK_CONSTANTS.DETECTOR_ID,
|
|
508
|
+
conflictingTrajectoryId: collision.trajectoryId,
|
|
509
|
+
conflictingPid: collision.pid,
|
|
510
|
+
conflictingTool: collision.tool,
|
|
511
|
+
overlappingPaths: collision.overlappingPaths,
|
|
512
|
+
worktreeCommand: worktreeCmd,
|
|
513
|
+
warning: `[HORIZON DET-20] Concurrent file-scope collision: file(s) [${collision.overlappingPaths.join(', ')}] are currently leased by trajectory "${collision.trajectoryId}" (PID ${collision.pid}). Run in isolated worktree to prevent merge conflicts.`,
|
|
514
|
+
activeLeases: registry.leases
|
|
515
|
+
};
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
const now = Date.now();
|
|
519
|
+
const expiresAtMs = now + ttlSeconds * 1000;
|
|
520
|
+
|
|
521
|
+
// Upsert current local lease (preserving read-only visibility of cross-harness locks without copying them)
|
|
522
|
+
const crossHarnessCount = registry.leases.filter((l) => l.source === 'cross_harness').length;
|
|
523
|
+
const updatedLocalLeases = registry.leases.filter(
|
|
524
|
+
(l) => l.source !== 'cross_harness' && l.trajectoryId !== trajectoryId
|
|
525
|
+
);
|
|
526
|
+
const newLease = normalizeScopeLeaseEntry({
|
|
527
|
+
trajectoryId,
|
|
528
|
+
ownerId: trajectoryId,
|
|
529
|
+
agent_id: trajectoryId,
|
|
530
|
+
session_id: trajectoryId,
|
|
531
|
+
pid: this.pid,
|
|
532
|
+
tool: this.tool,
|
|
533
|
+
claimedPaths: normClaimed,
|
|
534
|
+
acquiredAt: now,
|
|
535
|
+
updatedAtIso: new Date(now).toISOString(),
|
|
536
|
+
expiresAtMs,
|
|
537
|
+
ttl_ms: ttlSeconds * 1000
|
|
538
|
+
}, { source: 'local', defaultTool: this.tool, now });
|
|
539
|
+
updatedLocalLeases.push(newLease);
|
|
540
|
+
|
|
541
|
+
saveRegistry(this.workspaceDir, {
|
|
542
|
+
version: SCOPE_LOCK_CONSTANTS.VERSION,
|
|
543
|
+
leases: updatedLocalLeases
|
|
544
|
+
});
|
|
545
|
+
|
|
546
|
+
return {
|
|
547
|
+
ok: true,
|
|
548
|
+
collisionDetected: false,
|
|
549
|
+
lease: newLease,
|
|
550
|
+
activeLeaseCount: updatedLocalLeases.length + crossHarnessCount
|
|
551
|
+
};
|
|
552
|
+
}
|
|
553
|
+
|
|
554
|
+
/**
|
|
555
|
+
* Releases a trajectory lease.
|
|
556
|
+
*/
|
|
557
|
+
releaseLease(trajectoryId) {
|
|
558
|
+
const registry = loadRegistry(this.workspaceDir);
|
|
559
|
+
const crossHarnessCount = registry.leases.filter((l) => l.source === 'cross_harness').length;
|
|
560
|
+
const updatedLocalLeases = registry.leases.filter(
|
|
561
|
+
(l) => l.source !== 'cross_harness' && l.trajectoryId !== trajectoryId
|
|
562
|
+
);
|
|
563
|
+
saveRegistry(this.workspaceDir, {
|
|
564
|
+
version: SCOPE_LOCK_CONSTANTS.VERSION,
|
|
565
|
+
leases: updatedLocalLeases
|
|
566
|
+
});
|
|
567
|
+
return { ok: true, remainingCount: updatedLocalLeases.length + crossHarnessCount };
|
|
568
|
+
}
|
|
569
|
+
|
|
570
|
+
/**
|
|
571
|
+
* Returns all active non-expired leases for the workspace.
|
|
572
|
+
*/
|
|
573
|
+
getActiveLeases() {
|
|
574
|
+
return loadRegistry(this.workspaceDir).leases;
|
|
575
|
+
}
|
|
576
|
+
}
|
|
577
|
+
|
|
578
|
+
export default ScopeLockRegistry;
|