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