ctxtop 0.0.0-stage → 4.1.0

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.
Files changed (262) hide show
  1. package/.antigravity-plugin/plugin.json +36 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHECKSUMS.sha256 +166 -0
  4. package/LICENSE +27 -0
  5. package/README.md +350 -2
  6. package/SECURITY.md +22 -0
  7. package/agents/ah-flash-scout.md +25 -0
  8. package/assets/advanced_view_loaded_420px.png +0 -0
  9. package/assets/hero-demo.svg +188 -0
  10. package/assets/logo.svg +19 -0
  11. package/assets/simple_view_lean_420px.png +0 -0
  12. package/assets/simple_view_loaded_420px.png +0 -0
  13. package/assets/social-preview.svg +72 -0
  14. package/assets/zone_c_step3_shield_full.png +0 -0
  15. package/bin/ah-statusline.mjs +175 -0
  16. package/bin/cli.mjs +3 -0
  17. package/bin/ctxtop.mjs +1799 -0
  18. package/commands/cost-radar.md +11 -0
  19. package/commands/evolve.md +10 -0
  20. package/commands/handoff.md +10 -0
  21. package/commands/horizon.md +10 -0
  22. package/commands/inspect.md +10 -0
  23. package/commands/precheck.md +10 -0
  24. package/config/default_flightcheck.json +133 -0
  25. package/config/modelCatalog.json +785 -0
  26. package/config/platformQuirks.json +19 -0
  27. package/hooks/handlers/compact-lifecycle.mjs +577 -0
  28. package/hooks/handlers/config-change.mjs +402 -0
  29. package/hooks/handlers/hookIo.mjs +311 -0
  30. package/hooks/handlers/hookIpcClient.mjs +83 -0
  31. package/hooks/handlers/post-model-switch.mjs +111 -0
  32. package/hooks/handlers/post-tool-use.mjs +366 -0
  33. package/hooks/handlers/pre-model-switch.mjs +1048 -0
  34. package/hooks/handlers/pre-tool-use.mjs +632 -0
  35. package/hooks/handlers/stop-gate.mjs +526 -0
  36. package/hooks/handlers/user-prompt-submit.mjs +367 -0
  37. package/hooks/hooks.json +131 -0
  38. package/hooks/post_invocation.mjs +13 -0
  39. package/hooks/post_tool_use.mjs +25 -0
  40. package/hooks/pre_invocation.mjs +14 -0
  41. package/hooks/pre_tool_use.mjs +97 -0
  42. package/hooks/register.js +726 -0
  43. package/hooks/session_start.mjs +24 -0
  44. package/hooks/stop.mjs +23 -0
  45. package/hooks.json +56 -0
  46. package/package.json +110 -4
  47. package/packages/antigravity/package.json +14 -0
  48. package/packages/antigravity/src/index.mjs +1 -0
  49. package/packages/claude-code/package.json +14 -0
  50. package/packages/claude-code/src/index.mjs +2 -0
  51. package/packages/core/package.json +14 -0
  52. package/packages/core/src/index.mjs +1 -0
  53. package/packages/engine-node/package.json +14 -0
  54. package/packages/engine-node/src/index.mjs +1 -0
  55. package/packages/mcp/package.json +17 -0
  56. package/packages/mcp/src/server.mjs +396 -0
  57. package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
  58. package/packages/pro/README-SIGNING.md +30 -0
  59. package/packages/pro/package.json +16 -0
  60. package/packages/pro/src/index.mjs +3 -0
  61. package/packages/pro/src/team_finops_pack.mjs +241 -0
  62. package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
  63. package/plugin.json +36 -0
  64. package/rules/AGENTS.md +10 -0
  65. package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
  66. package/sidecars/horizon-daemon/server.mjs +2038 -0
  67. package/sidecars/horizon-daemon/sidecar.json +19 -0
  68. package/skills/cost-radar/SKILL.md +21 -0
  69. package/skills/evolve/SKILL.md +21 -0
  70. package/skills/handoff/SKILL.md +50 -0
  71. package/skills/horizon/SKILL.md +17 -0
  72. package/skills/inspect/SKILL.md +18 -0
  73. package/skills/precheck/SKILL.md +44 -0
  74. package/src/adapters/antigravity/index.mjs +109 -0
  75. package/src/adapters/claude-code/index.mjs +194 -0
  76. package/src/cli/cost_radar.mjs +70 -0
  77. package/src/cli/doctor.mjs +351 -0
  78. package/src/cli/horizon_hud.mjs +888 -0
  79. package/src/cli/init.mjs +425 -0
  80. package/src/cli/postmortem.mjs +515 -0
  81. package/src/coach/cacheGravityRouter.mjs +12 -0
  82. package/src/config/modelCatalog.json +704 -0
  83. package/src/config/platformQuirks.json +19 -0
  84. package/src/core/action_queue.mjs +264 -0
  85. package/src/core/ag_bridge.mjs +346 -0
  86. package/src/core/atomic_io.mjs +124 -0
  87. package/src/core/baseline.mjs +607 -0
  88. package/src/core/blindspot_sensors.mjs +399 -0
  89. package/src/core/bucket_b_runtime.mjs +1200 -0
  90. package/src/core/classifier.mjs +1757 -0
  91. package/src/core/coach/circuit_breakers.mjs +650 -0
  92. package/src/core/coach/contradiction_auditor.mjs +239 -0
  93. package/src/core/coach/effort_advisor.mjs +143 -0
  94. package/src/core/coach/handoff_hydrator.mjs +483 -0
  95. package/src/core/coach/progressive_checkpointer.mjs +551 -0
  96. package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
  97. package/src/core/coach/reflector_queue.mjs +505 -0
  98. package/src/core/coach/saved_quota_ledger.mjs +615 -0
  99. package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
  100. package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
  101. package/src/core/coach/task_quota_router.mjs +955 -0
  102. package/src/core/coach/turn_zero_gate.mjs +574 -0
  103. package/src/core/compaction_coach.mjs +1126 -0
  104. package/src/core/config.mjs +214 -0
  105. package/src/core/constants.mjs +1987 -0
  106. package/src/core/detectors_det01_to_16.mjs +1523 -0
  107. package/src/core/doc_indexer.mjs +338 -0
  108. package/src/core/episodic_memory.mjs +135 -0
  109. package/src/core/fts5_output_compressor.mjs +359 -0
  110. package/src/core/git_ledger.mjs +189 -0
  111. package/src/core/handoff_audit.mjs +558 -0
  112. package/src/core/history.mjs +221 -0
  113. package/src/core/hook_diagnostics.mjs +158 -0
  114. package/src/core/horizon_classifier.mjs +326 -0
  115. package/src/core/horizon_config.mjs +802 -0
  116. package/src/core/host_watchdog.mjs +200 -0
  117. package/src/core/layer5_hygiene.mjs +1084 -0
  118. package/src/core/log_resolver.mjs +231 -0
  119. package/src/core/mcp_auditor.mjs +138 -0
  120. package/src/core/micro_skills_store.mjs +91 -0
  121. package/src/core/offenders.mjs +161 -0
  122. package/src/core/parser.mjs +1997 -0
  123. package/src/core/path_canonicalizer.mjs +73 -0
  124. package/src/core/paths.mjs +311 -0
  125. package/src/core/prefix_cache_shield.mjs +386 -0
  126. package/src/core/pro_license.mjs +385 -0
  127. package/src/core/prompt_rubric.mjs +518 -0
  128. package/src/core/pruner.mjs +433 -0
  129. package/src/core/quota.mjs +1860 -0
  130. package/src/core/rsi_instinct_engine.mjs +1197 -0
  131. package/src/core/rsl_clash_auditor.mjs +423 -0
  132. package/src/core/rsl_distiller.mjs +372 -0
  133. package/src/core/rsl_ledger.mjs +969 -0
  134. package/src/core/rsl_triage.mjs +909 -0
  135. package/src/core/sanitizer.mjs +121 -0
  136. package/src/core/session_auditor.mjs +658 -0
  137. package/src/core/session_forensics.mjs +303 -0
  138. package/src/core/session_timeline.mjs +358 -0
  139. package/src/core/settings.mjs +99 -0
  140. package/src/core/shared/detectors.mjs +1342 -0
  141. package/src/core/shared/fnv1a64.mjs +85 -0
  142. package/src/core/shared/handoff_schema.mjs +123 -0
  143. package/src/core/shared/index.mjs +5 -0
  144. package/src/core/shared/ipi_sanitizer.mjs +165 -0
  145. package/src/core/shared/micro_skills.mjs +1 -0
  146. package/src/core/shared/plugin_validator.mjs +202 -0
  147. package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
  148. package/src/core/shield_manager.mjs +1417 -0
  149. package/src/core/sidecar_store.mjs +302 -0
  150. package/src/core/sprint_metrics.mjs +366 -0
  151. package/src/core/sqlite_client.mjs +283 -0
  152. package/src/core/storage_doctor.mjs +358 -0
  153. package/src/core/subagents.mjs +609 -0
  154. package/src/core/swarm_topology.mjs +360 -0
  155. package/src/core/task_quota_router.mjs +1656 -0
  156. package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
  157. package/src/core/telemetry/scope_lock_registry.mjs +578 -0
  158. package/src/core/telemetry/shadow_file_detector.mjs +291 -0
  159. package/src/core/telemetry/trajectory_watcher.mjs +259 -0
  160. package/src/core/timeline_svg.mjs +236 -0
  161. package/src/core/tool_surgeon.mjs +305 -0
  162. package/src/core/trajectory_stitcher.mjs +645 -0
  163. package/src/core/u_shaped_optimizer.mjs +789 -0
  164. package/src/core/wal_hygiene.mjs +233 -0
  165. package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  166. package/src/core-isomorphic/catalog/index.mjs +1 -0
  167. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  168. package/src/core-isomorphic/coach/microSkills.mjs +1 -0
  169. package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  170. package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
  171. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  172. package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  173. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +305 -0
  174. package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  175. package/src/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  176. package/src/core-isomorphic/config/anthropicModelCatalog.json +606 -0
  177. package/src/core-isomorphic/config/catalogLoader.mjs +1268 -0
  178. package/src/core-isomorphic/config/horizonConfig.mjs +1055 -0
  179. package/src/core-isomorphic/control/callTree.mjs +338 -0
  180. package/src/core-isomorphic/control/coachLatches.mjs +126 -0
  181. package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
  182. package/src/core-isomorphic/control/index.mjs +49 -0
  183. package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
  184. package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
  185. package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  186. package/src/core-isomorphic/diagnostics/index.mjs +9 -0
  187. package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  188. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  189. package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
  190. package/src/core-isomorphic/economics/cacheGravity.mjs +369 -0
  191. package/src/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  192. package/src/core-isomorphic/economics/driftLatency.mjs +433 -0
  193. package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
  194. package/src/core-isomorphic/economics/index.mjs +47 -0
  195. package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
  196. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  197. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  198. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  199. package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  200. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  201. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  202. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  203. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  204. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  205. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  206. package/src/core-isomorphic/index.js +27 -0
  207. package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  208. package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  209. package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  210. package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  211. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1156 -0
  212. package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  213. package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  214. package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
  215. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1237 -0
  216. package/src/core-isomorphic/ui/modViews.mjs +1504 -0
  217. package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  218. package/src/core-isomorphic/ustf/index.mjs +7 -0
  219. package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
  220. package/src/core-isomorphic/ustf/schema.mjs +186 -0
  221. package/src/core-isomorphic/utils/runtime.mjs +962 -0
  222. package/src/demo/synthetic_states.mjs +661 -0
  223. package/src/diagnostics/bugReportGenerator.mjs +253 -0
  224. package/src/diagnostics/claudeHookCapabilities.mjs +396 -0
  225. package/src/diagnostics/doctorEngine.mjs +295 -0
  226. package/src/engine-node/db/index.mjs +58 -0
  227. package/src/engine-node/db/jsonl_fallback.mjs +184 -0
  228. package/src/engine-node/db/probe.mjs +342 -0
  229. package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
  230. package/src/engine-node/index.mjs +12 -0
  231. package/src/engine-node/ipc/client.mjs +447 -0
  232. package/src/engine-node/ipc/index.mjs +22 -0
  233. package/src/engine-node/ipc/protocol.mjs +177 -0
  234. package/src/engine-node/ipc/server.mjs +445 -0
  235. package/src/engine-node/offloader/index.mjs +6 -0
  236. package/src/engine-node/offloader/tool_offloader.mjs +241 -0
  237. package/src/engine-node/sensors/blindspots.mjs +376 -0
  238. package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
  239. package/src/engine-node/sensors/index.mjs +7 -0
  240. package/src/hooks/antigravity_rsl_hook.mjs +250 -0
  241. package/src/hooks/claude_rsl_hook.mjs +288 -0
  242. package/src/hooks/portfolio_runtime.mjs +858 -0
  243. package/src/hooks/post_invocation.mjs +611 -0
  244. package/src/hooks/pre_invocation.mjs +1725 -0
  245. package/src/hooks/session_start.mjs +199 -0
  246. package/src/shims/agy_cli_compressor.mjs +705 -0
  247. package/src/shims/agy_git_guard.mjs +749 -0
  248. package/src/shims/ah_log_query.mjs +39 -0
  249. package/src/ui/costRadarSvg.mjs +6 -0
  250. package/src/ui/horizonGrid.mjs +1 -0
  251. package/src/ui/horizonPanelHtml.mjs +1 -0
  252. package/src/ui/horizon_panel.css +167 -0
  253. package/src/ui/horizon_panel.js +212 -0
  254. package/src/ui/modViews.mjs +1 -0
  255. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  256. package/src/utils/nodeIo.mjs +59 -0
  257. package/src/utils/runtime.mjs +1 -0
  258. package/src/utils/sessionCalibration.mjs +657 -0
  259. package/src/webview/advanced_view.html +1808 -0
  260. package/src/webview/horizon_panel.html +12397 -0
  261. package/src/webview/registry.mjs +80 -0
  262. package/src/webview/simple_view.html +1370 -0
@@ -0,0 +1,726 @@
1
+ /**
2
+ * @file hooks/register.js
3
+ * In-process Mod entrypoint for Highbeam (attention-horizon-claude).
4
+ * Compliant with Claude Code Mod static analyzer rules:
5
+ * - Direct literal on('...') calls
6
+ * - No destructuring or variable assignment of $ or $.namespace
7
+ * - Never pass $ or $.* to any function (imported or module-local)
8
+ * - Pure ES modules, strictly relative imports, zero node:* or process.getBuiltinModule
9
+ * - Explicit .catch(...) fail-closed handlers resolving { decision: 'deny' } on tool.call guards
10
+ */
11
+
12
+ import {
13
+ createInitialTelemetryState,
14
+ ingestModTurnEvent,
15
+ writeLiveStateSnapshot
16
+ } from '../src/core-isomorphic/telemetry/telemetryBridge.mjs';
17
+ import { loadHorizonConfig } from '../src/core-isomorphic/config/horizonConfig.mjs';
18
+ import { normalizeFlightMode } from '../src/core-isomorphic/coach/cacheGravityRouter.mjs';
19
+ import { TtlWatchdog } from '../src/core-isomorphic/coach/ttlWatchdog.mjs';
20
+ import { CircuitBreakerEngine } from '../src/core-isomorphic/guards/circuitBreakers.mjs';
21
+ import {
22
+ handlePreCompactBatonFlush,
23
+ handleSessionStartHydration,
24
+ handlePostCompactFlush
25
+ } from '../src/core-isomorphic/coach/stateBatonHydrator.mjs';
26
+ import {
27
+ renderAbovePromptBand,
28
+ renderSimpleViewPane,
29
+ renderAdvancedViewPane,
30
+ renderSpinnerSuffix
31
+ } from '../src/core-isomorphic/ui/modViews.mjs';
32
+ import { recordRuntimeDiagnostic } from '../src/core-isomorphic/utils/runtime.mjs';
33
+ import { evaluateToolBoundaryLatch, CONTROL_STATES } from '../src/core-isomorphic/control/index.mjs';
34
+
35
+ const bootHorizonConfig = loadHorizonConfig();
36
+ const ttlWatchdog = new TtlWatchdog({ mode: bootHorizonConfig.flightMode || 'COACH' });
37
+ const breakerEngine = new CircuitBreakerEngine({
38
+ mode: bootHorizonConfig.flightMode || 'COACH',
39
+ horizonConfig: bootHorizonConfig
40
+ });
41
+
42
+ let stopWatchdogClock = null;
43
+ let modUnclippedReadCounts = Object.create(null);
44
+
45
+ /**
46
+ * Disposes any active `$.clock.every(1000)` interval handle so headless / completed
47
+ * sessions exit cleanly without dangling timers (`ISS-036`).
48
+ */
49
+ function clearWatchdogClock() {
50
+ const handle = stopWatchdogClock;
51
+ stopWatchdogClock = null;
52
+ if (!handle) return;
53
+ try {
54
+ if (typeof handle === 'function') {
55
+ handle();
56
+ } else if (typeof handle.cancel === 'function') {
57
+ handle.cancel();
58
+ } else if (typeof handle.dispose === 'function') {
59
+ handle.dispose();
60
+ } else if (typeof handle.stop === 'function') {
61
+ handle.stop();
62
+ }
63
+ } catch (err) {
64
+ recordRuntimeDiagnostic('hooks/register.js', 'clearWatchdogClock', err);
65
+ }
66
+ }
67
+
68
+ /**
69
+ * Detects non-interactive / headless print mode (`claude -p`) from a plain event payload.
70
+ * @param {object} event
71
+ * @returns {boolean}
72
+ */
73
+ function isHeadlessEvent(event) {
74
+ return Boolean(
75
+ event?.headless ||
76
+ event?.printMode ||
77
+ event?.nonInteractive ||
78
+ event?.isHeadless ||
79
+ globalThis.process?.env?.CLAUDE_HEADLESS === '1'
80
+ );
81
+ }
82
+
83
+ /**
84
+ * Resolves the active flight mode from event overrides, `.attention-horizon.json` (when `cwd`
85
+ * is present), or persisted store state, synchronizing `breakerEngine` and `ttlWatchdog` (`ISS-038`).
86
+ *
87
+ * @param {object} event
88
+ * @param {string | undefined | null} storedMode
89
+ * @returns {string}
90
+ */
91
+ function resolveActiveModFlightMode(event, storedMode) {
92
+ if (event?.mode) {
93
+ const explicitMode = normalizeFlightMode(event.mode);
94
+ breakerEngine.setMode(explicitMode);
95
+ ttlWatchdog.setMode(explicitMode);
96
+ return explicitMode;
97
+ }
98
+ if (typeof event?.cwd === 'string' && event.cwd.trim()) {
99
+ const cfg = breakerEngine.refreshConfig({ cwd: event.cwd });
100
+ const cfgMode = normalizeFlightMode(cfg?.flightMode || 'COACH');
101
+ ttlWatchdog.setMode(cfgMode);
102
+ return cfgMode;
103
+ }
104
+ if (storedMode) {
105
+ const normStored = normalizeFlightMode(storedMode);
106
+ breakerEngine.setMode(normStored);
107
+ ttlWatchdog.setMode(normStored);
108
+ return normStored;
109
+ }
110
+ return breakerEngine.mode || 'COACH';
111
+ }
112
+
113
+ /**
114
+ * Extracts a target workspace file path from a tool or file-change event.
115
+ * @param {object} event
116
+ * @returns {string}
117
+ */
118
+ function extractModEventFilePath(event) {
119
+ const input = event?.tool_input || event?.toolInput || {};
120
+ return String(
121
+ input.file_path ||
122
+ input.notebook_path ||
123
+ input.filePath ||
124
+ input.path ||
125
+ event?.filePath ||
126
+ event?.file_path ||
127
+ event?.path ||
128
+ ''
129
+ );
130
+ }
131
+
132
+ /**
133
+ * Checks whether a `tool.call` event mutates a workspace file (`Edit|MultiEdit|Write|NotebookEdit`).
134
+ * @param {object} event
135
+ * @returns {boolean}
136
+ */
137
+ function isWorkspaceEditToolEvent(event) {
138
+ const name = String(event?.tool_name || event?.toolName || '').toLowerCase();
139
+ return (
140
+ name === 'edit' ||
141
+ name === 'multiedit' ||
142
+ name === 'write' ||
143
+ name === 'notebookedit'
144
+ );
145
+ }
146
+
147
+ /**
148
+ * Checks whether a `tool.call` event commits or verifies workspace changes (`git commit` or test runner),
149
+ * clearing the pending-edits flag.
150
+ * @param {object} event
151
+ * @returns {boolean}
152
+ */
153
+ function shouldClearRecentEditsOnToolEvent(event) {
154
+ const name = String(event?.tool_name || event?.toolName || '').toLowerCase();
155
+ if (
156
+ name !== 'bash' &&
157
+ name !== 'powershell' &&
158
+ name !== 'pwsh' &&
159
+ name !== 'cmd' &&
160
+ name !== 'sh'
161
+ ) {
162
+ return false;
163
+ }
164
+ const input = event?.tool_input || event?.toolInput || {};
165
+ const cmd = String(input.command || input.cmd || event?.command || '');
166
+ return (
167
+ /\bgit\s+commit\b/i.test(cmd) ||
168
+ /\b(?:npm\s+test|npm\s+run\s+test|pnpm\s+(?:run\s+)?test|yarn\s+test|bun\s+test|vitest|jest|pytest|cargo\s+test|go\s+test|node\s+--test|tsc(?:\s|$)|npx\s+tsc)\b/i.test(
169
+ cmd
170
+ )
171
+ );
172
+ }
173
+
174
+ function didDownstreamToolResultFail(result) {
175
+ if (!result || typeof result !== 'object') return false;
176
+ if (
177
+ result.is_error === true ||
178
+ result.isError === true ||
179
+ result.succeeded === false ||
180
+ result.status === 'error' ||
181
+ result.status === 'failed' ||
182
+ Boolean(result.error)
183
+ ) {
184
+ return true;
185
+ }
186
+ if (typeof result.exit_code === 'number' && result.exit_code !== 0) return true;
187
+ if (typeof result.exitCode === 'number' && result.exitCode !== 0) return true;
188
+ return false;
189
+ }
190
+
191
+ /**
192
+ * Main Mod registration function.
193
+ * @param {Function} on - Claude Code event registration callback
194
+ */
195
+ export default function register(on) {
196
+ clearWatchdogClock();
197
+ ttlWatchdog.clearRecentEdits();
198
+ modUnclippedReadCounts = Object.create(null);
199
+ breakerEngine.hydrateStateSnapshot({
200
+ consecutiveFailures: 0,
201
+ lastFailedToolKey: '',
202
+ sequentialSearchCount: 0,
203
+ fileHashHistory: {},
204
+ modifiedFilesInTurn: [],
205
+ pendingFormatFiles: [],
206
+ codeEditedSinceLastTest: false,
207
+ subagentTurns: {},
208
+ subagentTokens: {},
209
+ pendingBatchEdits: 0
210
+ });
211
+
212
+ on('file.changed', async (event, $) => {
213
+ try {
214
+ const changedPath = extractModEventFilePath(event);
215
+ ttlWatchdog.recordFileChanged(changedPath, Date.now());
216
+ $.store.set('ah_recent_file_changed', true);
217
+ } catch (err) {
218
+ recordRuntimeDiagnostic(
219
+ 'hooks/register.js',
220
+ 'file.changed',
221
+ err,
222
+ event?.cwd ? { cwd: event.cwd } : {}
223
+ );
224
+ }
225
+ });
226
+
227
+ on('tool.call', (event, $, next) => {
228
+ return Promise.resolve()
229
+ .then(async () => {
230
+ const storedControl = $.store.get('ah_control_state');
231
+ if (storedControl) {
232
+ const latch = evaluateToolBoundaryLatch(storedControl);
233
+ if (latch.decision === 'deny') {
234
+ $.store.set('ah_last_breaker_verdict', { triggered: true, detectorId: 'CONTROL_ABORT', reason: latch.reason });
235
+ $.ui.invalidate('ui.render');
236
+ return {
237
+ decision: 'deny',
238
+ reason: latch.reason || 'Session aborted by user'
239
+ };
240
+ }
241
+ if (latch.decision === 'allow' && latch.consumeStep) {
242
+ $.store.set('ah_control_state', { ...storedControl, state: CONTROL_STATES.PAUSED, stepRemaining: 0, updatedAt: Date.now() });
243
+ }
244
+ }
245
+
246
+ const storedMode = $.store.get('ah_flight_mode');
247
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
248
+ $.store.set('ah_flight_mode', activeMode);
249
+
250
+ const telemetry =
251
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
252
+ const verdict = breakerEngine.evaluatePreToolUse(
253
+ { ...event, mode: event?.mode || activeMode },
254
+ telemetry
255
+ );
256
+
257
+ if (verdict.triggered && verdict.decision === 'deny') {
258
+ $.store.set('ah_last_breaker_verdict', verdict);
259
+ $.ui.invalidate('ui.render');
260
+ return {
261
+ decision: 'deny',
262
+ reason: verdict.reason || 'Blocked by Highbeam circuit breaker'
263
+ };
264
+ }
265
+
266
+ if (verdict.triggered && (verdict.decision === 'ask' || verdict.decision === 'defer')) {
267
+ $.store.set('ah_last_breaker_verdict', verdict);
268
+ $.ui.invalidate('ui.render');
269
+ return {
270
+ decision: verdict.decision === 'defer' ? 'defer' : 'ask',
271
+ reason: verdict.reason || 'Confirmation required by Highbeam'
272
+ };
273
+ }
274
+
275
+ const isEditEvent = isWorkspaceEditToolEvent(event);
276
+ const isClearCandidate = !isEditEvent && shouldClearRecentEditsOnToolEvent(event);
277
+ if (isEditEvent) {
278
+ ttlWatchdog.recordFileChanged(extractModEventFilePath(event), Date.now());
279
+ $.store.set('ah_recent_file_changed', true);
280
+ $.store.set('ah_turn_mutations', (Number($.store.get('ah_turn_mutations')) || 0) + 1);
281
+ }
282
+
283
+ let repeatReadAdvisory = '';
284
+ const tName = String(event?.tool_name || event?.toolName || '');
285
+ const tArgs = event?.tool_input || event?.toolInput || {};
286
+ const cmdStr = String(tArgs.command || tArgs.cmd || event?.command || '');
287
+ if (
288
+ activeMode !== 'OFF' &&
289
+ /^(Read|read_file)$/i.test(tName) &&
290
+ tArgs.offset === undefined &&
291
+ tArgs.limit === undefined &&
292
+ tArgs.StartLine === undefined &&
293
+ tArgs.EndLine === undefined
294
+ ) {
295
+ const readTarget = extractModEventFilePath(event);
296
+ if (readTarget) {
297
+ const normReadKey = readTarget.replace(/\\/g, '/').toLowerCase();
298
+ const nextReadCount = (modUnclippedReadCounts[normReadKey] || 0) + 1;
299
+ modUnclippedReadCounts[normReadKey] = nextReadCount;
300
+ if (nextReadCount >= 3) {
301
+ repeatReadAdvisory = `[GUARD-4 Repeat-Read Surgeon] Unclipped Read #${nextReadCount} of ${readTarget} — pass offset/limit (or StartLine/EndLine) to prevent duplicate context bloat.`;
302
+ }
303
+ }
304
+ }
305
+
306
+ const finalizeDownstream = async () => {
307
+ const downstream = typeof next === 'function' ? await next(event) : undefined;
308
+ const failed = didDownstreamToolResultFail(downstream);
309
+ if (isClearCandidate && !failed) {
310
+ ttlWatchdog.clearRecentEdits();
311
+ $.store.set('ah_recent_file_changed', false);
312
+ $.store.set('ah_turn_mutations', (Number($.store.get('ah_turn_mutations')) || 0) + 1);
313
+ }
314
+ if (/^(bash|powershell|pwsh|cmd|sh)$/i.test(tName)) {
315
+ const outText =
316
+ typeof downstream === 'string'
317
+ ? downstream
318
+ : String(downstream?.stderr || downstream?.stdout || downstream?.output || '');
319
+ breakerEngine.recordVerificationOutcome({
320
+ succeeded: !failed,
321
+ command: cmdStr,
322
+ outputText: outText
323
+ });
324
+ }
325
+ return downstream;
326
+ };
327
+
328
+ if (verdict.triggered) {
329
+ $.store.set('ah_last_breaker_verdict', verdict);
330
+ $.ui.invalidate('ui.render');
331
+ const downstream = await finalizeDownstream();
332
+ return downstream ?? { additionalContext: verdict.reason };
333
+ }
334
+
335
+ if (repeatReadAdvisory) {
336
+ const downstream = await finalizeDownstream();
337
+ if (downstream && typeof downstream === 'object') {
338
+ return {
339
+ ...downstream,
340
+ additionalContext: downstream.additionalContext
341
+ ? `${downstream.additionalContext}\n${repeatReadAdvisory}`
342
+ : repeatReadAdvisory
343
+ };
344
+ }
345
+ return downstream ?? { additionalContext: repeatReadAdvisory };
346
+ }
347
+
348
+ if (typeof next === 'function') {
349
+ return await finalizeDownstream();
350
+ }
351
+ await finalizeDownstream();
352
+ return undefined;
353
+ })
354
+ .catch((err) => {
355
+ // ISS-031: Fail CLOSED on any uncaught or timed-out guard error (never re-throw!)
356
+ recordRuntimeDiagnostic(
357
+ 'hooks/register.js',
358
+ 'tool.call',
359
+ err,
360
+ event?.cwd ? { cwd: event.cwd } : {}
361
+ );
362
+ return {
363
+ decision: 'deny',
364
+ reason: `[Highbeam Fail-Closed] ${err?.message || String(err)}`
365
+ };
366
+ });
367
+ });
368
+
369
+ on('turn.step', async (event, $) => {
370
+ try {
371
+ const storedMode = $.store.get('ah_flight_mode');
372
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
373
+ $.store.set('ah_flight_mode', activeMode);
374
+
375
+ if (event?.fileChanged || event?.hasRecentWorkspaceEdits || isWorkspaceEditToolEvent(event)) {
376
+ ttlWatchdog.recordFileChanged(extractModEventFilePath(event), Date.now());
377
+ $.store.set('ah_recent_file_changed', true);
378
+ }
379
+
380
+ const current =
381
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
382
+ const updated = ingestModTurnEvent(current, {
383
+ ...event,
384
+ flightMode: event?.flightMode || event?.mode || activeMode,
385
+ turnMutations: Number($.store.get('ah_turn_mutations')) || 0,
386
+ type: 'turn.step'
387
+ });
388
+ $.store.set('ah_session_telemetry', updated);
389
+ writeLiveStateSnapshot(
390
+ updated.sessionId || 'default',
391
+ updated,
392
+ event?.cwd ? { cwd: event.cwd } : {}
393
+ );
394
+
395
+ if (
396
+ !isHeadlessEvent(event) &&
397
+ updated.promptCache?.warm &&
398
+ !$.store.get('ah_watchdog_clock_started')
399
+ ) {
400
+ $.store.set('ah_watchdog_clock_started', true);
401
+ stopWatchdogClock = $.clock.every(1000, () => {
402
+ try {
403
+ const state = $.store.get('ah_session_telemetry');
404
+ if (!state || !state.promptCache?.warm) {
405
+ clearWatchdogClock();
406
+ $.store.set('ah_watchdog_clock_started', false);
407
+ return;
408
+ }
409
+ const tick = ttlWatchdog.evaluateTick({
410
+ sessionId: state.sessionId,
411
+ modelId: state.modelId,
412
+ cacheWarm: state.promptCache.warm,
413
+ ttlTier: state.promptCache.ttlTier,
414
+ cachedTokens: state.contextWindow?.cachedTokens || 0,
415
+ totalPromptTokens: state.contextWindow?.totalInputTokens || 0,
416
+ expiresAt: state.promptCache.expiresAt,
417
+ hasRecentWorkspaceEdits: Boolean($.store.get('ah_recent_file_changed')),
418
+ mode: $.store.get('ah_flight_mode') || 'COACH'
419
+ });
420
+ $.store.set('ah_ttl_tick', tick);
421
+ if (tick.preSnapshotTriggered && tick.stateBatonSnapshot) {
422
+ $.store.set('ah_state_baton', tick.stateBatonSnapshot);
423
+ }
424
+ if (tick.amberAlertActive) {
425
+ $.ui.invalidate('ui.render');
426
+ }
427
+ if (tick.remainingSeconds <= 0) {
428
+ clearWatchdogClock();
429
+ $.store.set('ah_watchdog_clock_started', false);
430
+ }
431
+ } catch (err) {
432
+ recordRuntimeDiagnostic(
433
+ 'hooks/register.js',
434
+ 'turn.step.watchdogTick',
435
+ err,
436
+ event?.cwd ? { cwd: event.cwd } : {}
437
+ );
438
+ }
439
+ });
440
+ }
441
+ } catch (err) {
442
+ recordRuntimeDiagnostic(
443
+ 'hooks/register.js',
444
+ 'turn.step',
445
+ err,
446
+ event?.cwd ? { cwd: event.cwd } : {}
447
+ );
448
+ }
449
+ });
450
+
451
+ on('turn.complete', async (event, $) => {
452
+ try {
453
+ const turnId =
454
+ event?.turnId ||
455
+ event?.turn_id ||
456
+ event?.result?.turn_id ||
457
+ event?.result?.id ||
458
+ event?.message?.id ||
459
+ null;
460
+ if (turnId && $.store.get('ah_last_completed_turn_id') === turnId) {
461
+ return;
462
+ }
463
+ if (turnId) {
464
+ $.store.set('ah_last_completed_turn_id', turnId);
465
+ }
466
+
467
+ const storedMode = $.store.get('ah_flight_mode');
468
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
469
+ $.store.set('ah_flight_mode', activeMode);
470
+
471
+ ttlWatchdog.recordTurnTimestamp(Date.now());
472
+ const current =
473
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
474
+ const updated = ingestModTurnEvent(current, {
475
+ ...event,
476
+ flightMode: event?.flightMode || event?.mode || activeMode,
477
+ turnMutations: Number($.store.get('ah_turn_mutations')) || 0,
478
+ type: 'turn.complete'
479
+ });
480
+ $.store.set('ah_turn_mutations', 0);
481
+ $.store.set('ah_session_telemetry', updated);
482
+ writeLiveStateSnapshot(
483
+ updated.sessionId || 'default',
484
+ updated,
485
+ event?.cwd ? { cwd: event.cwd } : {}
486
+ );
487
+
488
+ if (isHeadlessEvent(event)) {
489
+ clearWatchdogClock();
490
+ $.store.set('ah_watchdog_clock_started', false);
491
+ } else if (updated.promptCache?.warm && !$.store.get('ah_watchdog_clock_started')) {
492
+ $.store.set('ah_watchdog_clock_started', true);
493
+ stopWatchdogClock = $.clock.every(1000, () => {
494
+ try {
495
+ const state = $.store.get('ah_session_telemetry');
496
+ if (!state || !state.promptCache?.warm) {
497
+ clearWatchdogClock();
498
+ $.store.set('ah_watchdog_clock_started', false);
499
+ return;
500
+ }
501
+ const tick = ttlWatchdog.evaluateTick({
502
+ sessionId: state.sessionId,
503
+ modelId: state.modelId,
504
+ cacheWarm: state.promptCache.warm,
505
+ ttlTier: state.promptCache.ttlTier,
506
+ cachedTokens: state.contextWindow?.cachedTokens || 0,
507
+ totalPromptTokens: state.contextWindow?.totalInputTokens || 0,
508
+ expiresAt: state.promptCache.expiresAt,
509
+ hasRecentWorkspaceEdits: Boolean($.store.get('ah_recent_file_changed')),
510
+ mode: $.store.get('ah_flight_mode') || 'COACH'
511
+ });
512
+ $.store.set('ah_ttl_tick', tick);
513
+ if (tick.preSnapshotTriggered && tick.stateBatonSnapshot) {
514
+ $.store.set('ah_state_baton', tick.stateBatonSnapshot);
515
+ }
516
+ if (tick.amberAlertActive) {
517
+ $.ui.invalidate('ui.render');
518
+ }
519
+ if (tick.remainingSeconds <= 0) {
520
+ clearWatchdogClock();
521
+ $.store.set('ah_watchdog_clock_started', false);
522
+ }
523
+ } catch (err) {
524
+ recordRuntimeDiagnostic(
525
+ 'hooks/register.js',
526
+ 'turn.complete.watchdogTick',
527
+ err,
528
+ event?.cwd ? { cwd: event.cwd } : {}
529
+ );
530
+ }
531
+ });
532
+ }
533
+
534
+ $.ui.invalidate('ui.render');
535
+ } catch (err) {
536
+ recordRuntimeDiagnostic(
537
+ 'hooks/register.js',
538
+ 'turn.complete',
539
+ err,
540
+ event?.cwd ? { cwd: event.cwd } : {}
541
+ );
542
+ }
543
+ });
544
+
545
+ on('classic.PreCompact', async (event, $) => {
546
+ try {
547
+ const flushRes = handlePreCompactBatonFlush(
548
+ event,
549
+ event?.cwd ? { cwd: event.cwd } : {}
550
+ );
551
+ $.store.set('ah_state_baton', flushRes.baton);
552
+ } catch (err) {
553
+ recordRuntimeDiagnostic(
554
+ 'hooks/register.js',
555
+ 'classic.PreCompact',
556
+ err,
557
+ event?.cwd ? { cwd: event.cwd } : {}
558
+ );
559
+ }
560
+ });
561
+
562
+ on('classic.SessionStart', async (event, $) => {
563
+ try {
564
+ const storedMode = $.store.get('ah_flight_mode');
565
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
566
+ $.store.set('ah_flight_mode', activeMode);
567
+
568
+ const hydrated = handleSessionStartHydration(
569
+ event,
570
+ event?.cwd ? { cwd: event.cwd } : {}
571
+ );
572
+ if (hydrated.hydrated && hydrated.baton) {
573
+ $.store.set('ah_state_baton', hydrated.baton);
574
+ }
575
+ } catch (err) {
576
+ recordRuntimeDiagnostic(
577
+ 'hooks/register.js',
578
+ 'classic.SessionStart',
579
+ err,
580
+ event?.cwd ? { cwd: event.cwd } : {}
581
+ );
582
+ }
583
+ });
584
+
585
+ on('classic.PostCompact', async (event, $) => {
586
+ try {
587
+ const postRes = handlePostCompactFlush(event, {
588
+ ...(event?.cwd ? { cwd: event.cwd } : {}),
589
+ mutationQueue: breakerEngine.router.mutationQueue
590
+ });
591
+ ttlWatchdog.clearRecentEdits();
592
+ $.store.set('ah_recent_file_changed', false);
593
+ $.store.set('ah_last_post_compact', postRes);
594
+ $.ui.invalidate('ui.render');
595
+ } catch (err) {
596
+ recordRuntimeDiagnostic(
597
+ 'hooks/register.js',
598
+ 'classic.PostCompact',
599
+ err,
600
+ event?.cwd ? { cwd: event.cwd } : {}
601
+ );
602
+ }
603
+ });
604
+
605
+ on('classic.Stop', async (event, $) => {
606
+ try {
607
+ clearWatchdogClock();
608
+ $.store.set('ah_watchdog_clock_started', false);
609
+ } catch (err) {
610
+ recordRuntimeDiagnostic(
611
+ 'hooks/register.js',
612
+ 'classic.Stop',
613
+ err,
614
+ event?.cwd ? { cwd: event.cwd } : {}
615
+ );
616
+ }
617
+ });
618
+
619
+ on('command.horizon', async (event, $) => {
620
+ try {
621
+ const rawArgs = String(event?.args || event?.subcommand || event?.viewMode || '').toLowerCase();
622
+ if (rawArgs.includes('advanced')) {
623
+ $.store.set('ah_pane_view_mode', 'advanced');
624
+ } else if (rawArgs.includes('simple')) {
625
+ $.store.set('ah_pane_view_mode', 'simple');
626
+ }
627
+ $.ui.open({
628
+ id: 'attention-horizon',
629
+ title: 'Highbeam',
630
+ closeOnEscape: true
631
+ });
632
+ } catch (err) {
633
+ recordRuntimeDiagnostic(
634
+ 'hooks/register.js',
635
+ 'command.horizon',
636
+ err,
637
+ event?.cwd ? { cwd: event.cwd } : {}
638
+ );
639
+ }
640
+ });
641
+
642
+ on('ui.render', async (event, $, next) => {
643
+ try {
644
+ const component = event?.component || event?.surface || 'AbovePrompt';
645
+
646
+ if (component === 'Pane' && event?.id !== 'attention-horizon') {
647
+ return typeof next === 'function' ? await next(event) : undefined;
648
+ }
649
+
650
+ const telemetry =
651
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
652
+ const renderOptions = {
653
+ nowMs: event?.nowMs,
654
+ maxCols: event?.maxCols || event?.columns,
655
+ noColor: event?.noColor,
656
+ forceColor: event?.forceColor,
657
+ ansi: event?.ansi,
658
+ flightMode: $.store.get('ah_flight_mode') || 'COACH',
659
+ ttlTick: $.store.get('ah_ttl_tick') || null,
660
+ breakerVerdict: $.store.get('ah_last_breaker_verdict') || null
661
+ };
662
+
663
+ if (component === 'Pane' && event?.id === 'attention-horizon') {
664
+ const requestedMode = String(
665
+ event?.viewMode || $.store.get('ah_pane_view_mode') || 'simple'
666
+ ).toLowerCase();
667
+ const pane =
668
+ requestedMode === 'advanced'
669
+ ? renderAdvancedViewPane(telemetry, renderOptions)
670
+ : requestedMode === '4-rank' || requestedMode === 'ranks'
671
+ ? renderSimpleViewPane(telemetry, { ...renderOptions, viewMode: 'SIMPLE_4_RANK' })
672
+ : renderSimpleViewPane(telemetry, renderOptions);
673
+ return {
674
+ ...pane,
675
+ content: pane.text
676
+ };
677
+ }
678
+
679
+ if (component === 'Spinner') {
680
+ const downstream = typeof next === 'function' ? await next(event) : '';
681
+ const spinner = renderSpinnerSuffix(telemetry, renderOptions);
682
+ const baseText =
683
+ typeof downstream === 'string'
684
+ ? downstream
685
+ : typeof downstream?.text === 'string'
686
+ ? downstream.text
687
+ : '';
688
+ return {
689
+ ...(typeof downstream === 'object' && downstream ? downstream : {}),
690
+ text: baseText ? `${baseText} ${spinner.suffix}` : spinner.suffix,
691
+ suffix: spinner.suffix
692
+ };
693
+ }
694
+
695
+ // Default surface: AbovePrompt 1-line band while chaining await next(event)
696
+ const downstream = typeof next === 'function' ? await next(event) : null;
697
+ const band = renderAbovePromptBand(telemetry, renderOptions);
698
+ if (typeof downstream === 'string' && downstream.length > 0) {
699
+ return `${band.line}\n${downstream}`;
700
+ }
701
+ const downstreamLine =
702
+ typeof downstream === 'object' &&
703
+ downstream &&
704
+ typeof downstream.line === 'string' &&
705
+ downstream.line.length > 0
706
+ ? downstream.line
707
+ : '';
708
+ return {
709
+ ...(typeof downstream === 'object' && downstream ? downstream : {}),
710
+ line: downstreamLine ? `${band.line}\n${downstreamLine}` : band.line,
711
+ band
712
+ };
713
+ } catch (err) {
714
+ recordRuntimeDiagnostic(
715
+ 'hooks/register.js',
716
+ 'ui.render',
717
+ err,
718
+ event?.cwd ? { cwd: event.cwd } : {}
719
+ );
720
+ if (typeof next === 'function') {
721
+ return await next(event);
722
+ }
723
+ return undefined;
724
+ }
725
+ });
726
+ }