ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -1,241 +1,241 @@
1
- /**
2
- * @file packages/pro/src/team_finops_pack.mjs
3
- * Roadmap Item #8: Packaged "BYO-Grafana" Team Policy & OpenTelemetry Bundle ($299/yr for 5 Seats).
4
- *
5
- * Generates zero-backend Team FinOps artifacts fed by `src/core-isomorphic/telemetry/otelExporter.mjs`:
6
- * 1. `grafana-dashboard.json` (Grafana v10+ dashboard)
7
- * 2. `datadog-dashboard.json` (Datadog dashboard widget template)
8
- * 3. `.attention-horizon.json` (Committed Team Governance lockfile)
9
- * 4. `otel-collector-config.yaml` (Local OTel JSONL filelog -> Prometheus/OTLP pipeline)
10
- * 5. `README-TEAM-FINOPS.md` (5-minute zero-SaaS deployment guide)
11
- */
12
-
13
- import fs from 'node:fs';
14
- import path from 'node:path';
15
- import { requireProFeature } from '../../../src/core/pro_license.mjs';
16
-
17
- /**
18
- * Builds the 5 Team FinOps Pack file payloads in memory.
19
- *
20
- * @param {object} [options={}]
21
- * @param {string} [options.orgName='Engineering Team']
22
- * @param {number} [options.seats=5]
23
- */
24
- export function buildTeamFinopsArtifacts(options = {}) {
25
- const orgName = String(options.orgName || 'Engineering Team').trim();
26
- const seats = Math.max(1, Number(options.seats || 5));
27
-
28
- const grafanaDashboard = {
29
- uid: 'ah-team-finops-v4',
30
- title: `Highbeam — ${orgName} Context FinOps & KV-Cache ROI`,
31
- tags: ['attention-horizon', 'claude-code', 'antigravity', 'finops', 'otel'],
32
- timezone: 'browser',
33
- schemaVersion: 39,
34
- version: 1,
35
- refresh: '30s',
36
- panels: [
37
- {
38
- id: 1,
39
- type: 'timeseries',
40
- title: 'Actual LLM Spend vs. Verified Highbeam Savings (USD)',
41
- gridPos: { h: 8, w: 12, x: 0, y: 0 },
42
- targets: [
43
- {
44
- expr: 'sum by (vcs_repository_url_full, model) (claude_code_cost_usage)',
45
- legendFormat: 'Actual Spend ({{model}})'
46
- },
47
- {
48
- expr: 'sum by (vcs_repository_url_full, model) (attention_horizon_saved_quota_usd)',
49
- legendFormat: 'Verified Saved USD ({{model}})'
50
- }
51
- ]
52
- },
53
- {
54
- id: 2,
55
- type: 'stat',
56
- title: 'Team Prompt Cache Hit Ratio (%)',
57
- gridPos: { h: 8, w: 6, x: 12, y: 0 },
58
- targets: [
59
- {
60
- expr: '100 * sum(claude_code_token_usage{type="cacheRead"}) / clamp_min(sum(claude_code_token_usage{type=~"input|cacheRead|cacheCreation"}), 1)',
61
- legendFormat: 'Cache Hit %'
62
- }
63
- ]
64
- },
65
- {
66
- id: 3,
67
- type: 'stat',
68
- title: 'Total Circuit Breaker Interventions (DET-01..32)',
69
- gridPos: { h: 8, w: 6, x: 18, y: 0 },
70
- targets: [
71
- {
72
- expr: 'sum(attention_horizon_intervention_count)',
73
- legendFormat: 'Guard Trips'
74
- }
75
- ]
76
- },
77
- {
78
- id: 4,
79
- type: 'table',
80
- title: 'Negative Cache ROI & Cold-Rebuild Hotspots by Repository',
81
- gridPos: { h: 8, w: 24, x: 0, y: 8 },
82
- targets: [
83
- {
84
- expr: 'sum by (vcs_repository_url_full, vcs_ref_head_name, model) (claude_code_cost_usage{negative_cache_roi="true"})',
85
- legendFormat: '{{vcs_repository_url_full}} ({{vcs_ref_head_name}})'
86
- }
87
- ]
88
- }
89
- ]
90
- };
91
-
92
- const datadogDashboard = {
93
- title: `Highbeam — ${orgName} Agent FinOps (${seats} Seats)`,
94
- description: 'Zero-backend Claude Code & Google Antigravity KV-cache efficiency and DET-01..32 circuit breaker telemetry.',
95
- layout_type: 'ordered',
96
- widgets: [
97
- {
98
- definition: {
99
- title: 'LLM Spend vs. Highbeam Saved USD',
100
- type: 'timeseries',
101
- requests: [
102
- { q: 'sum:claude_code.cost.usage{*} by {model,vcs.repository.url.full}', display_type: 'bars' },
103
- { q: 'sum:attention_horizon.saved_quota.usd{*} by {model,vcs.repository.url.full}', display_type: 'line' }
104
- ]
105
- }
106
- },
107
- {
108
- definition: {
109
- title: 'Prompt Cache Read vs. Uncached Input Tokens',
110
- type: 'timeseries',
111
- requests: [
112
- { q: 'sum:claude_code.token.usage{type:cacheread} by {vcs.repository.url.full}', display_type: 'area' },
113
- { q: 'sum:claude_code.token.usage{type:input} by {vcs.repository.url.full}', display_type: 'line' }
114
- ]
115
- }
116
- },
117
- {
118
- definition: {
119
- title: 'Active Circuit Breaker Interventions',
120
- type: 'query_value',
121
- requests: [{ q: 'sum:attention_horizon.intervention.count{*}', aggregator: 'sum' }]
122
- }
123
- }
124
- ]
125
- };
126
-
127
- const teamPolicyConfig = {
128
- version: 1,
129
- organization: orgName,
130
- licensedSeats: seats,
131
- flightMode: 'AUTO_PILOT',
132
- detectorNamespace: 'canonical',
133
- teamGovernance: {
134
- enforceRing0Safety: true,
135
- enforceCrossHarnessScopeLocks: true,
136
- otelExportEnabled: true
137
- },
138
- detectors: {
139
- 'DET-01': 'block',
140
- 'DET-02': 'block',
141
- 'DET-04': 'block',
142
- 'DET-05': 'block',
143
- 'DET-08': 'block',
144
- 'DET-09': 'block',
145
- 'DET-19': 'block',
146
- 'DET-20': 'block'
147
- }
148
- };
149
-
150
- const otelCollectorYaml = [
151
- '# Highbeam — Zero-Backend Team FinOps OpenTelemetry Collector Config',
152
- 'receivers:',
153
- ' filelog/attention_horizon:',
154
- ' include:',
155
- ' - ~/.attention-horizon/otel/metrics.jsonl',
156
- ' - ./.claude/telemetry/otel-metrics.jsonl',
157
- ' operators:',
158
- ' - type: json_parser',
159
- '',
160
- 'processors:',
161
- ' batch:',
162
- ' timeout: 10s',
163
- '',
164
- 'exporters:',
165
- ' prometheus:',
166
- ' endpoint: "127.0.0.1:9464"',
167
- ' otlphttp:',
168
- ' endpoint: "${OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}"',
169
- '',
170
- 'service:',
171
- ' pipelines:',
172
- ' logs/attention_horizon:',
173
- ' receivers: [filelog/attention_horizon]',
174
- ' processors: [batch]',
175
- ' exporters: [prometheus, otlphttp]'
176
- ].join('\n') + '\n';
177
-
178
- const readmeMarkdown = [
179
- `# Highbeam Team FinOps Pack — ${orgName} (${seats} Seats)`,
180
- '',
181
- 'Zero-backend team cost attribution, KV-cache warmth telemetry, and cross-harness (`Claude Code` + `Google Antigravity`) governance.',
182
- '',
183
- '## Included Files',
184
- '1. **`.attention-horizon.json`**: Commit this policy file to your repository root to standardize `DET-01..32` circuit breakers and cross-harness `DET-20` file-scope locks across all developers.',
185
- '2. **`grafana-dashboard.json`**: Import directly into Grafana (**Dashboards -> New -> Import**) to track actual LLM spend vs. Highbeam saved USD.',
186
- '3. **`datadog-dashboard.json`**: Import into Datadog (**Dashboards -> New Dashboard -> Import Dashboard JSON**).',
187
- '4. **`otel-collector-config.yaml`**: Point your local or CI OpenTelemetry Collector at `~/.attention-horizon/otel/metrics.jsonl` (`CLAUDE_CODE_ENABLE_TELEMETRY=1`).'
188
- ].join('\n') + '\n';
189
-
190
- return {
191
- orgName,
192
- seats,
193
- files: {
194
- 'grafana-dashboard.json': JSON.stringify(grafanaDashboard, null, 2) + '\n',
195
- 'datadog-dashboard.json': JSON.stringify(datadogDashboard, null, 2) + '\n',
196
- '.attention-horizon.json': JSON.stringify(teamPolicyConfig, null, 2) + '\n',
197
- 'otel-collector-config.yaml': otelCollectorYaml,
198
- 'README-TEAM-FINOPS.md': readmeMarkdown
199
- }
200
- };
201
- }
202
-
203
- /**
204
- * Writes the BYO-Grafana Team FinOps Pack to disk after checking Pro/Team entitlement.
205
- *
206
- * @param {object} [options={}]
207
- * @returns {{ ok: boolean, outDir: string | null, filesWritten: string[], entitlement: object }}
208
- */
209
- export function generateTeamFinopsPack(options = {}) {
210
- const entitlement = requireProFeature('team_finops_pack', options);
211
- if (!entitlement.allowed && !options.preview) {
212
- return {
213
- ok: false,
214
- outDir: null,
215
- filesWritten: [],
216
- entitlement
217
- };
218
- }
219
-
220
- const outDir = path.resolve(
221
- options.outDir || path.join(options.cwd || process.cwd(), 'attention-horizon-team-pack')
222
- );
223
- fs.mkdirSync(outDir, { recursive: true });
224
-
225
- const artifacts = buildTeamFinopsArtifacts(options);
226
- const filesWritten = [];
227
- for (const [fileName, content] of Object.entries(artifacts.files)) {
228
- const fullPath = path.join(outDir, fileName);
229
- fs.writeFileSync(fullPath, content, 'utf8');
230
- filesWritten.push(fullPath);
231
- }
232
-
233
- return {
234
- ok: true,
235
- outDir,
236
- orgName: artifacts.orgName,
237
- seats: artifacts.seats,
238
- filesWritten,
239
- entitlement
240
- };
241
- }
1
+ /**
2
+ * @file packages/pro/src/team_finops_pack.mjs
3
+ * Roadmap Item #8: Packaged "BYO-Grafana" Team Policy & OpenTelemetry Bundle ($299/yr for 5 Seats).
4
+ *
5
+ * Generates zero-backend Team FinOps artifacts fed by `src/core-isomorphic/telemetry/otelExporter.mjs`:
6
+ * 1. `grafana-dashboard.json` (Grafana v10+ dashboard)
7
+ * 2. `datadog-dashboard.json` (Datadog dashboard widget template)
8
+ * 3. `.attention-horizon.json` (Committed Team Governance lockfile)
9
+ * 4. `otel-collector-config.yaml` (Local OTel JSONL filelog -> Prometheus/OTLP pipeline)
10
+ * 5. `README-TEAM-FINOPS.md` (5-minute zero-SaaS deployment guide)
11
+ */
12
+
13
+ import fs from 'node:fs';
14
+ import path from 'node:path';
15
+ import { requireProFeature } from './pro_license.mjs';
16
+
17
+ /**
18
+ * Builds the 5 Team FinOps Pack file payloads in memory.
19
+ *
20
+ * @param {object} [options={}]
21
+ * @param {string} [options.orgName='Engineering Team']
22
+ * @param {number} [options.seats=5]
23
+ */
24
+ export function buildTeamFinopsArtifacts(options = {}) {
25
+ const orgName = String(options.orgName || 'Engineering Team').trim();
26
+ const seats = Math.max(1, Number(options.seats || 5));
27
+
28
+ const grafanaDashboard = {
29
+ uid: 'ah-team-finops-v4',
30
+ title: `Highbeam — ${orgName} Context FinOps & KV-Cache ROI`,
31
+ tags: ['attention-horizon', 'claude-code', 'antigravity', 'finops', 'otel'],
32
+ timezone: 'browser',
33
+ schemaVersion: 39,
34
+ version: 1,
35
+ refresh: '30s',
36
+ panels: [
37
+ {
38
+ id: 1,
39
+ type: 'timeseries',
40
+ title: 'Actual LLM Spend vs. Verified Highbeam Savings (USD)',
41
+ gridPos: { h: 8, w: 12, x: 0, y: 0 },
42
+ targets: [
43
+ {
44
+ expr: 'sum by (vcs_repository_url_full, model) (claude_code_cost_usage)',
45
+ legendFormat: 'Actual Spend ({{model}})'
46
+ },
47
+ {
48
+ expr: 'sum by (vcs_repository_url_full, model) (attention_horizon_saved_quota_usd)',
49
+ legendFormat: 'Verified Saved USD ({{model}})'
50
+ }
51
+ ]
52
+ },
53
+ {
54
+ id: 2,
55
+ type: 'stat',
56
+ title: 'Team Prompt Cache Hit Ratio (%)',
57
+ gridPos: { h: 8, w: 6, x: 12, y: 0 },
58
+ targets: [
59
+ {
60
+ expr: '100 * sum(claude_code_token_usage{type="cacheRead"}) / clamp_min(sum(claude_code_token_usage{type=~"input|cacheRead|cacheCreation"}), 1)',
61
+ legendFormat: 'Cache Hit %'
62
+ }
63
+ ]
64
+ },
65
+ {
66
+ id: 3,
67
+ type: 'stat',
68
+ title: 'Total Circuit Breaker Interventions (DET-01..32)',
69
+ gridPos: { h: 8, w: 6, x: 18, y: 0 },
70
+ targets: [
71
+ {
72
+ expr: 'sum(attention_horizon_intervention_count)',
73
+ legendFormat: 'Guard Trips'
74
+ }
75
+ ]
76
+ },
77
+ {
78
+ id: 4,
79
+ type: 'table',
80
+ title: 'Negative Cache ROI & Cold-Rebuild Hotspots by Repository',
81
+ gridPos: { h: 8, w: 24, x: 0, y: 8 },
82
+ targets: [
83
+ {
84
+ expr: 'sum by (vcs_repository_url_full, vcs_ref_head_name, model) (claude_code_cost_usage{negative_cache_roi="true"})',
85
+ legendFormat: '{{vcs_repository_url_full}} ({{vcs_ref_head_name}})'
86
+ }
87
+ ]
88
+ }
89
+ ]
90
+ };
91
+
92
+ const datadogDashboard = {
93
+ title: `Highbeam — ${orgName} Agent FinOps (${seats} Seats)`,
94
+ description: 'Zero-backend Claude Code & Google Antigravity KV-cache efficiency and DET-01..32 circuit breaker telemetry.',
95
+ layout_type: 'ordered',
96
+ widgets: [
97
+ {
98
+ definition: {
99
+ title: 'LLM Spend vs. Highbeam Saved USD',
100
+ type: 'timeseries',
101
+ requests: [
102
+ { q: 'sum:claude_code.cost.usage{*} by {model,vcs.repository.url.full}', display_type: 'bars' },
103
+ { q: 'sum:attention_horizon.saved_quota.usd{*} by {model,vcs.repository.url.full}', display_type: 'line' }
104
+ ]
105
+ }
106
+ },
107
+ {
108
+ definition: {
109
+ title: 'Prompt Cache Read vs. Uncached Input Tokens',
110
+ type: 'timeseries',
111
+ requests: [
112
+ { q: 'sum:claude_code.token.usage{type:cacheread} by {vcs.repository.url.full}', display_type: 'area' },
113
+ { q: 'sum:claude_code.token.usage{type:input} by {vcs.repository.url.full}', display_type: 'line' }
114
+ ]
115
+ }
116
+ },
117
+ {
118
+ definition: {
119
+ title: 'Active Circuit Breaker Interventions',
120
+ type: 'query_value',
121
+ requests: [{ q: 'sum:attention_horizon.intervention.count{*}', aggregator: 'sum' }]
122
+ }
123
+ }
124
+ ]
125
+ };
126
+
127
+ const teamPolicyConfig = {
128
+ version: 1,
129
+ organization: orgName,
130
+ licensedSeats: seats,
131
+ flightMode: 'AUTO_PILOT',
132
+ detectorNamespace: 'canonical',
133
+ teamGovernance: {
134
+ enforceRing0Safety: true,
135
+ enforceCrossHarnessScopeLocks: true,
136
+ otelExportEnabled: true
137
+ },
138
+ detectors: {
139
+ 'DET-01': 'block',
140
+ 'DET-02': 'block',
141
+ 'DET-04': 'block',
142
+ 'DET-05': 'block',
143
+ 'DET-08': 'block',
144
+ 'DET-09': 'block',
145
+ 'DET-19': 'block',
146
+ 'DET-20': 'block'
147
+ }
148
+ };
149
+
150
+ const otelCollectorYaml = [
151
+ '# Highbeam — Zero-Backend Team FinOps OpenTelemetry Collector Config',
152
+ 'receivers:',
153
+ ' filelog/attention_horizon:',
154
+ ' include:',
155
+ ' - ~/.attention-horizon/otel/metrics.jsonl',
156
+ ' - ./.claude/telemetry/otel-metrics.jsonl',
157
+ ' operators:',
158
+ ' - type: json_parser',
159
+ '',
160
+ 'processors:',
161
+ ' batch:',
162
+ ' timeout: 10s',
163
+ '',
164
+ 'exporters:',
165
+ ' prometheus:',
166
+ ' endpoint: "127.0.0.1:9464"',
167
+ ' otlphttp:',
168
+ ' endpoint: "${OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}"',
169
+ '',
170
+ 'service:',
171
+ ' pipelines:',
172
+ ' logs/attention_horizon:',
173
+ ' receivers: [filelog/attention_horizon]',
174
+ ' processors: [batch]',
175
+ ' exporters: [prometheus, otlphttp]'
176
+ ].join('\n') + '\n';
177
+
178
+ const readmeMarkdown = [
179
+ `# Highbeam Team FinOps Pack — ${orgName} (${seats} Seats)`,
180
+ '',
181
+ 'Zero-backend team cost attribution, KV-cache warmth telemetry, and cross-harness (`Claude Code` + `Google Antigravity`) governance.',
182
+ '',
183
+ '## Included Files',
184
+ '1. **`.attention-horizon.json`**: Commit this policy file to your repository root to standardize `DET-01..32` circuit breakers and cross-harness `DET-20` file-scope locks across all developers.',
185
+ '2. **`grafana-dashboard.json`**: Import directly into Grafana (**Dashboards -> New -> Import**) to track actual LLM spend vs. Highbeam saved USD.',
186
+ '3. **`datadog-dashboard.json`**: Import into Datadog (**Dashboards -> New Dashboard -> Import Dashboard JSON**).',
187
+ '4. **`otel-collector-config.yaml`**: Point your local or CI OpenTelemetry Collector at `~/.attention-horizon/otel/metrics.jsonl` (`CLAUDE_CODE_ENABLE_TELEMETRY=1`).'
188
+ ].join('\n') + '\n';
189
+
190
+ return {
191
+ orgName,
192
+ seats,
193
+ files: {
194
+ 'grafana-dashboard.json': JSON.stringify(grafanaDashboard, null, 2) + '\n',
195
+ 'datadog-dashboard.json': JSON.stringify(datadogDashboard, null, 2) + '\n',
196
+ '.attention-horizon.json': JSON.stringify(teamPolicyConfig, null, 2) + '\n',
197
+ 'otel-collector-config.yaml': otelCollectorYaml,
198
+ 'README-TEAM-FINOPS.md': readmeMarkdown
199
+ }
200
+ };
201
+ }
202
+
203
+ /**
204
+ * Writes the BYO-Grafana Team FinOps Pack to disk after checking Pro/Team entitlement.
205
+ *
206
+ * @param {object} [options={}]
207
+ * @returns {{ ok: boolean, outDir: string | null, filesWritten: string[], entitlement: object }}
208
+ */
209
+ export function generateTeamFinopsPack(options = {}) {
210
+ const entitlement = requireProFeature('team_finops_pack', options);
211
+ if (!entitlement.allowed && !options.preview) {
212
+ return {
213
+ ok: false,
214
+ outDir: null,
215
+ filesWritten: [],
216
+ entitlement
217
+ };
218
+ }
219
+
220
+ const outDir = path.resolve(
221
+ options.outDir || path.join(options.cwd || process.cwd(), 'attention-horizon-team-pack')
222
+ );
223
+ fs.mkdirSync(outDir, { recursive: true });
224
+
225
+ const artifacts = buildTeamFinopsArtifacts(options);
226
+ const filesWritten = [];
227
+ for (const [fileName, content] of Object.entries(artifacts.files)) {
228
+ const fullPath = path.join(outDir, fileName);
229
+ fs.writeFileSync(fullPath, content, 'utf8');
230
+ filesWritten.push(fullPath);
231
+ }
232
+
233
+ return {
234
+ ok: true,
235
+ outDir,
236
+ orgName: artifacts.orgName,
237
+ seats: artifacts.seats,
238
+ filesWritten,
239
+ entitlement
240
+ };
241
+ }