observability-toolkit-hooks 0.0.0-stage → 1.0.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 (306) hide show
  1. package/CONFIG.md +144 -0
  2. package/LICENSE +95 -0
  3. package/README.md +201 -2
  4. package/dist/handlers/compact.js +38 -0
  5. package/dist/handlers/mcp-status.js +66 -0
  6. package/dist/handlers/notification.js +45 -0
  7. package/dist/handlers/post-tool-agent.js +157 -0
  8. package/dist/handlers/post-tool-changelog-sync.js +148 -0
  9. package/dist/handlers/post-tool-code-structure.js +116 -0
  10. package/dist/handlers/post-tool-edit-ledger.js +15 -0
  11. package/dist/handlers/post-tool-failure.js +83 -0
  12. package/dist/handlers/post-tool-git.js +79 -0
  13. package/dist/handlers/post-tool-mcp.js +105 -0
  14. package/dist/handlers/post-tool-outcome.js +48 -0
  15. package/dist/handlers/post-tool-task-state.js +74 -0
  16. package/dist/handlers/post-tool.js +132 -0
  17. package/dist/handlers/pre-tool-agent.js +192 -0
  18. package/dist/handlers/pre-tool.js +218 -0
  19. package/dist/handlers/session-end.js +39 -0
  20. package/dist/handlers/session-start.js +262 -0
  21. package/dist/handlers/stop-error-reminder.js +195 -0
  22. package/dist/handlers/stop-quality-evaluation.js +58 -0
  23. package/dist/handlers/stop-session-summary.js +62 -0
  24. package/dist/handlers/stop-token-metrics.js +83 -0
  25. package/dist/handlers/stop.js +25 -0
  26. package/dist/handlers/subagent.js +105 -0
  27. package/dist/handlers/tool-event-router.js +39 -0
  28. package/dist/handlers/user-prompt.js +218 -0
  29. package/dist/hook-runner.js +10 -0
  30. package/dist/hook-runner.js.map +7 -0
  31. package/dist/lib/agent/agent-context.js +123 -0
  32. package/dist/lib/agent/agent-evaluations.js +155 -0
  33. package/dist/lib/agent/agent-file-budget.js +65 -0
  34. package/dist/lib/agent/agent-sources.js +165 -0
  35. package/dist/lib/agent/synth-spans.js +51 -0
  36. package/dist/lib/core/bounded-label.js +6 -0
  37. package/dist/lib/core/category-rules.js +11 -0
  38. package/dist/lib/core/child-result.js +19 -0
  39. package/dist/lib/core/config-dir-recovery.js +22 -0
  40. package/dist/lib/core/constants.js +171 -0
  41. package/dist/lib/core/detached-runner.js +55 -0
  42. package/dist/lib/core/file-utils.js +353 -0
  43. package/dist/lib/core/format-utils.js +51 -0
  44. package/dist/lib/core/http-utils.js +74 -0
  45. package/dist/lib/core/http1-fetch.js +14 -0
  46. package/dist/lib/core/identity-key-resolver.js +149 -0
  47. package/dist/lib/core/jsonl-tail.js +207 -0
  48. package/dist/lib/core/load-envrc.js +72 -0
  49. package/dist/lib/core/parsers.js +43 -0
  50. package/dist/lib/core/regex.js +27 -0
  51. package/dist/lib/core/settings-env.js +31 -0
  52. package/dist/lib/core/shell-command.js +122 -0
  53. package/dist/lib/core/units.js +97 -0
  54. package/dist/lib/git/git-cache.js +158 -0
  55. package/dist/lib/git/git-commit.js +189 -0
  56. package/dist/lib/git/git-exec.js +30 -0
  57. package/dist/lib/mcp/mcp-completeness.js +40 -0
  58. package/dist/lib/mcp/mcp-config.js +118 -0
  59. package/dist/lib/mcp/mcp-failure-latch.js +22 -0
  60. package/dist/lib/mcp/mcp-identity-launcher.js +43 -0
  61. package/dist/lib/otel/attributes.js +322 -0
  62. package/dist/lib/otel/evaluation-attrs.js +51 -0
  63. package/dist/lib/otel/file-exporters.js +169 -0
  64. package/dist/lib/otel/host-resource.js +61 -0
  65. package/dist/lib/otel/otel-headers-helper.js +26 -0
  66. package/dist/lib/otel/otel-monitor.js +181 -0
  67. package/dist/lib/otel/otel.js +235 -0
  68. package/dist/lib/otel/otlp-headers.js +101 -0
  69. package/dist/lib/otel/otlp-post.js +122 -0
  70. package/dist/lib/otel/otlp-serialize.js +142 -0
  71. package/dist/lib/otel/otlp-signal.js +2 -0
  72. package/dist/lib/otel/remote-spans.js +142 -0
  73. package/dist/lib/otel/service-identity.js +10 -0
  74. package/dist/lib/otel/telemetry-alerts.js +43 -0
  75. package/dist/lib/otel/token-metrics.js +122 -0
  76. package/dist/lib/otel/trace-context.js +81 -0
  77. package/dist/lib/quality/judge-meta-eval.js +70 -0
  78. package/dist/lib/quality/judge-prompts.js +104 -0
  79. package/dist/lib/quality/judge-providers.js +193 -0
  80. package/dist/lib/quality/judge-transport.js +93 -0
  81. package/dist/lib/quality/llm-judge.js +170 -0
  82. package/dist/lib/quality/quality-budget.js +99 -0
  83. package/dist/lib/quality/quality-degradation.js +156 -0
  84. package/dist/lib/quality/quality-eval-handoff.js +74 -0
  85. package/dist/lib/quality/quality-evaluator.js +178 -0
  86. package/dist/lib/quality/quality-sampler.js +43 -0
  87. package/dist/lib/quality/quality-signals.js +150 -0
  88. package/dist/lib/runtime/categorizers.js +101 -0
  89. package/dist/lib/runtime/hook-input.js +16 -0
  90. package/dist/lib/runtime/hook-output.js +50 -0
  91. package/dist/lib/runtime/output-analyzer.js +160 -0
  92. package/dist/lib/runtime/run-handlers.js +32 -0
  93. package/dist/lib/runtime/tool-input.js +111 -0
  94. package/dist/lib/runtime/tool-output.js +44 -0
  95. package/dist/lib/runtime/unknown-tool.js +32 -0
  96. package/dist/lib/session/edit-ledger.js +29 -0
  97. package/dist/lib/session/forked-skill.js +39 -0
  98. package/dist/lib/session/handoffs.js +77 -0
  99. package/dist/lib/session/session-state.js +169 -0
  100. package/dist/lib/session/skill-rules.js +196 -0
  101. package/dist/lib/session/task-tracker.js +83 -0
  102. package/dist/lib/shipper/shipper-credentials.js +38 -0
  103. package/dist/lib/shipper/shipper-cursor.js +89 -0
  104. package/dist/lib/shipper/shipper-status.js +174 -0
  105. package/dist/lib/shipper/span-shipper.js +272 -0
  106. package/dist/lib/shipper/telemetry-shipper.js +39 -0
  107. package/dist/lib/transcript/agent-transcript-metrics.js +34 -0
  108. package/dist/lib/transcript/context-breakdown.js +134 -0
  109. package/dist/lib/transcript/context-history.js +69 -0
  110. package/dist/lib/transcript/context-tracker.js +226 -0
  111. package/dist/lib/transcript/message-count.js +49 -0
  112. package/dist/lib/transcript/model-ids.js +36 -0
  113. package/dist/lib/transcript/model-pricing.js +153 -0
  114. package/dist/lib/transcript/token-metrics-checkpoint.js +152 -0
  115. package/dist/lib/transcript/tool-call-durations.js +64 -0
  116. package/dist/lib/transcript/transcript-entry.js +67 -0
  117. package/dist/lib/transcript/transcript-fold.js +130 -0
  118. package/dist/lib/transcript/transcript-layout.js +39 -0
  119. package/dist/lib/transcript/transcript-parser.js +117 -0
  120. package/dist/runner/agent-context-4XTCLMLZ.js +23 -0
  121. package/dist/runner/agent-context-4XTCLMLZ.js.map +7 -0
  122. package/dist/runner/agent-file-budget-Q33ESBBE.js +68 -0
  123. package/dist/runner/agent-file-budget-Q33ESBBE.js.map +7 -0
  124. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js +39 -0
  125. package/dist/runner/agent-transcript-metrics-W5CZZFMI.js.map +7 -0
  126. package/dist/runner/chunk-2NTNAJZE.js +49 -0
  127. package/dist/runner/chunk-2NTNAJZE.js.map +7 -0
  128. package/dist/runner/chunk-4KWBQTTG.js +78 -0
  129. package/dist/runner/chunk-4KWBQTTG.js.map +7 -0
  130. package/dist/runner/chunk-52RY6LQT.js +699 -0
  131. package/dist/runner/chunk-52RY6LQT.js.map +7 -0
  132. package/dist/runner/chunk-7OM5CYES.js +8695 -0
  133. package/dist/runner/chunk-7OM5CYES.js.map +7 -0
  134. package/dist/runner/chunk-7PEOKGYR.js +1568 -0
  135. package/dist/runner/chunk-7PEOKGYR.js.map +7 -0
  136. package/dist/runner/chunk-AGSGKELQ.js +126 -0
  137. package/dist/runner/chunk-AGSGKELQ.js.map +7 -0
  138. package/dist/runner/chunk-AVM7PJFW.js +12 -0
  139. package/dist/runner/chunk-AVM7PJFW.js.map +7 -0
  140. package/dist/runner/chunk-C3WHUMU5.js +178 -0
  141. package/dist/runner/chunk-C3WHUMU5.js.map +7 -0
  142. package/dist/runner/chunk-DGB4NSSD.js +157 -0
  143. package/dist/runner/chunk-DGB4NSSD.js.map +7 -0
  144. package/dist/runner/chunk-DNSTWC26.js +151 -0
  145. package/dist/runner/chunk-DNSTWC26.js.map +7 -0
  146. package/dist/runner/chunk-FDJJ3TYU.js +449 -0
  147. package/dist/runner/chunk-FDJJ3TYU.js.map +7 -0
  148. package/dist/runner/chunk-FGKYDQHZ.js +137 -0
  149. package/dist/runner/chunk-FGKYDQHZ.js.map +7 -0
  150. package/dist/runner/chunk-GG2I4TGI.js +582 -0
  151. package/dist/runner/chunk-GG2I4TGI.js.map +7 -0
  152. package/dist/runner/chunk-GNNKUMRF.js +60 -0
  153. package/dist/runner/chunk-GNNKUMRF.js.map +7 -0
  154. package/dist/runner/chunk-I7TD2QVR.js +118 -0
  155. package/dist/runner/chunk-I7TD2QVR.js.map +7 -0
  156. package/dist/runner/chunk-IJ4SLUBV.js +78 -0
  157. package/dist/runner/chunk-IJ4SLUBV.js.map +7 -0
  158. package/dist/runner/chunk-IY7AP7NA.js +32 -0
  159. package/dist/runner/chunk-IY7AP7NA.js.map +7 -0
  160. package/dist/runner/chunk-J3F3Z3EQ.js +177 -0
  161. package/dist/runner/chunk-J3F3Z3EQ.js.map +7 -0
  162. package/dist/runner/chunk-JLEO5OHU.js +104 -0
  163. package/dist/runner/chunk-JLEO5OHU.js.map +7 -0
  164. package/dist/runner/chunk-JRNNLOPR.js +168 -0
  165. package/dist/runner/chunk-JRNNLOPR.js.map +7 -0
  166. package/dist/runner/chunk-KGSA5JYP.js +82 -0
  167. package/dist/runner/chunk-KGSA5JYP.js.map +7 -0
  168. package/dist/runner/chunk-LBCZAYFR.js +125 -0
  169. package/dist/runner/chunk-LBCZAYFR.js.map +7 -0
  170. package/dist/runner/chunk-LHWRXY2G.js +41 -0
  171. package/dist/runner/chunk-LHWRXY2G.js.map +7 -0
  172. package/dist/runner/chunk-LQ2LGUYJ.js +41 -0
  173. package/dist/runner/chunk-LQ2LGUYJ.js.map +7 -0
  174. package/dist/runner/chunk-LYY6RCIE.js +158 -0
  175. package/dist/runner/chunk-LYY6RCIE.js.map +7 -0
  176. package/dist/runner/chunk-M4R4QIQH.js +41 -0
  177. package/dist/runner/chunk-M4R4QIQH.js.map +7 -0
  178. package/dist/runner/chunk-MC75VXMX.js +207 -0
  179. package/dist/runner/chunk-MC75VXMX.js.map +7 -0
  180. package/dist/runner/chunk-NKZU4RRG.js +104 -0
  181. package/dist/runner/chunk-NKZU4RRG.js.map +7 -0
  182. package/dist/runner/chunk-PJHWHJ3K.js +56 -0
  183. package/dist/runner/chunk-PJHWHJ3K.js.map +7 -0
  184. package/dist/runner/chunk-RIGVYJ2O.js +114 -0
  185. package/dist/runner/chunk-RIGVYJ2O.js.map +7 -0
  186. package/dist/runner/chunk-RWRGC7ZK.js +93 -0
  187. package/dist/runner/chunk-RWRGC7ZK.js.map +7 -0
  188. package/dist/runner/chunk-SRMAJQMV.js +54 -0
  189. package/dist/runner/chunk-SRMAJQMV.js.map +7 -0
  190. package/dist/runner/chunk-TRMFD36J.js +47 -0
  191. package/dist/runner/chunk-TRMFD36J.js.map +7 -0
  192. package/dist/runner/chunk-U4IOZYQ3.js +21 -0
  193. package/dist/runner/chunk-U4IOZYQ3.js.map +7 -0
  194. package/dist/runner/chunk-UEXDE3WP.js +83 -0
  195. package/dist/runner/chunk-UEXDE3WP.js.map +7 -0
  196. package/dist/runner/chunk-UW3GQZSM.js +50 -0
  197. package/dist/runner/chunk-UW3GQZSM.js.map +7 -0
  198. package/dist/runner/chunk-V2GSP6VR.js +46 -0
  199. package/dist/runner/chunk-V2GSP6VR.js.map +7 -0
  200. package/dist/runner/chunk-VOV4Y5VU.js +81 -0
  201. package/dist/runner/chunk-VOV4Y5VU.js.map +7 -0
  202. package/dist/runner/chunk-VT5T6OEI.js +65 -0
  203. package/dist/runner/chunk-VT5T6OEI.js.map +7 -0
  204. package/dist/runner/chunk-VUYVFWIN.js +12 -0
  205. package/dist/runner/chunk-VUYVFWIN.js.map +7 -0
  206. package/dist/runner/chunk-VVGOPPEN.js +36 -0
  207. package/dist/runner/chunk-VVGOPPEN.js.map +7 -0
  208. package/dist/runner/chunk-VXFSLM6P.js +14 -0
  209. package/dist/runner/chunk-VXFSLM6P.js.map +7 -0
  210. package/dist/runner/chunk-W3EK7JUT.js +26125 -0
  211. package/dist/runner/chunk-W3EK7JUT.js.map +7 -0
  212. package/dist/runner/chunk-WJHNCOUF.js +52 -0
  213. package/dist/runner/chunk-WJHNCOUF.js.map +7 -0
  214. package/dist/runner/chunk-WU7ANGCW.js +269 -0
  215. package/dist/runner/chunk-WU7ANGCW.js.map +7 -0
  216. package/dist/runner/chunk-X7XLMSZX.js +44 -0
  217. package/dist/runner/chunk-X7XLMSZX.js.map +7 -0
  218. package/dist/runner/chunk-XSO3B4QN.js +124 -0
  219. package/dist/runner/chunk-XSO3B4QN.js.map +7 -0
  220. package/dist/runner/chunk-YGFN3LN2.js +174 -0
  221. package/dist/runner/chunk-YGFN3LN2.js.map +7 -0
  222. package/dist/runner/chunk-YHYDBLVB.js +33 -0
  223. package/dist/runner/chunk-YHYDBLVB.js.map +7 -0
  224. package/dist/runner/compact-36NP3PKT.js +60 -0
  225. package/dist/runner/compact-36NP3PKT.js.map +7 -0
  226. package/dist/runner/getMachineId-bsd-AGENNHN6.js +42 -0
  227. package/dist/runner/getMachineId-bsd-AGENNHN6.js.map +7 -0
  228. package/dist/runner/getMachineId-bsd-I5WZGCL4.js +33 -0
  229. package/dist/runner/getMachineId-bsd-I5WZGCL4.js.map +7 -0
  230. package/dist/runner/getMachineId-bsd-ZXK225P7.js +33 -0
  231. package/dist/runner/getMachineId-bsd-ZXK225P7.js.map +7 -0
  232. package/dist/runner/getMachineId-darwin-47GDLEXL.js +42 -0
  233. package/dist/runner/getMachineId-darwin-47GDLEXL.js.map +7 -0
  234. package/dist/runner/getMachineId-darwin-5CRLMDD6.js +33 -0
  235. package/dist/runner/getMachineId-darwin-5CRLMDD6.js.map +7 -0
  236. package/dist/runner/getMachineId-darwin-ADG4I32N.js +33 -0
  237. package/dist/runner/getMachineId-darwin-ADG4I32N.js.map +7 -0
  238. package/dist/runner/getMachineId-linux-5KVS3T2M.js +27 -0
  239. package/dist/runner/getMachineId-linux-5KVS3T2M.js.map +7 -0
  240. package/dist/runner/getMachineId-linux-GDFB5GSO.js +34 -0
  241. package/dist/runner/getMachineId-linux-GDFB5GSO.js.map +7 -0
  242. package/dist/runner/getMachineId-linux-NQMWCRO3.js +27 -0
  243. package/dist/runner/getMachineId-linux-NQMWCRO3.js.map +7 -0
  244. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js +18 -0
  245. package/dist/runner/getMachineId-unsupported-5PFIGMVX.js.map +7 -0
  246. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js +18 -0
  247. package/dist/runner/getMachineId-unsupported-DW27K3ZX.js.map +7 -0
  248. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js +25 -0
  249. package/dist/runner/getMachineId-unsupported-XV3FHTHD.js.map +7 -0
  250. package/dist/runner/getMachineId-win-5JVMW3EI.js +44 -0
  251. package/dist/runner/getMachineId-win-5JVMW3EI.js.map +7 -0
  252. package/dist/runner/getMachineId-win-SNESQF7R.js +35 -0
  253. package/dist/runner/getMachineId-win-SNESQF7R.js.map +7 -0
  254. package/dist/runner/getMachineId-win-UJYHSBM2.js +35 -0
  255. package/dist/runner/getMachineId-win-UJYHSBM2.js.map +7 -0
  256. package/dist/runner/git-commit-BA53DOJQ.js +30 -0
  257. package/dist/runner/git-commit-BA53DOJQ.js.map +7 -0
  258. package/dist/runner/hook-runner-JHH6PGKE.js +220 -0
  259. package/dist/runner/hook-runner-JHH6PGKE.js.map +7 -0
  260. package/dist/runner/judge-transport-R4TF5LEH.js +91 -0
  261. package/dist/runner/judge-transport-R4TF5LEH.js.map +7 -0
  262. package/dist/runner/mcp-status-QEUH2KGX.js +89 -0
  263. package/dist/runner/mcp-status-QEUH2KGX.js.map +7 -0
  264. package/dist/runner/notification-FKMBCSXF.js +69 -0
  265. package/dist/runner/notification-FKMBCSXF.js.map +7 -0
  266. package/dist/runner/post-tool-3MRHTBKH.js +192 -0
  267. package/dist/runner/post-tool-3MRHTBKH.js.map +7 -0
  268. package/dist/runner/post-tool-agent-BB34MNHI.js +370 -0
  269. package/dist/runner/post-tool-agent-BB34MNHI.js.map +7 -0
  270. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js +147 -0
  271. package/dist/runner/post-tool-changelog-sync-OP2TT2I7.js.map +7 -0
  272. package/dist/runner/post-tool-code-structure-LE7J2SC2.js +130 -0
  273. package/dist/runner/post-tool-code-structure-LE7J2SC2.js.map +7 -0
  274. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js +30 -0
  275. package/dist/runner/post-tool-edit-ledger-IJMEYHKF.js.map +7 -0
  276. package/dist/runner/post-tool-failure-XTH2I2Z7.js +111 -0
  277. package/dist/runner/post-tool-failure-XTH2I2Z7.js.map +7 -0
  278. package/dist/runner/post-tool-git-E46HZGZO.js +94 -0
  279. package/dist/runner/post-tool-git-E46HZGZO.js.map +7 -0
  280. package/dist/runner/post-tool-mcp-AMCDY5GH.js +144 -0
  281. package/dist/runner/post-tool-mcp-AMCDY5GH.js.map +7 -0
  282. package/dist/runner/post-tool-task-state-TLDOI33H.js +100 -0
  283. package/dist/runner/post-tool-task-state-TLDOI33H.js.map +7 -0
  284. package/dist/runner/pre-tool-SQE2FZQO.js +245 -0
  285. package/dist/runner/pre-tool-SQE2FZQO.js.map +7 -0
  286. package/dist/runner/pre-tool-agent-OZUPVFUI.js +218 -0
  287. package/dist/runner/pre-tool-agent-OZUPVFUI.js.map +7 -0
  288. package/dist/runner/quality-evaluator-XYNDKDRG.js +901 -0
  289. package/dist/runner/quality-evaluator-XYNDKDRG.js.map +7 -0
  290. package/dist/runner/session-end-3MJTDLLA.js +57 -0
  291. package/dist/runner/session-end-3MJTDLLA.js.map +7 -0
  292. package/dist/runner/session-start-5ZMCLKBS.js +352 -0
  293. package/dist/runner/session-start-5ZMCLKBS.js.map +7 -0
  294. package/dist/runner/shipper-status-MADX6SPG.js +37 -0
  295. package/dist/runner/shipper-status-MADX6SPG.js.map +7 -0
  296. package/dist/runner/span-shipper-4HQDHC47.js +3408 -0
  297. package/dist/runner/span-shipper-4HQDHC47.js.map +7 -0
  298. package/dist/runner/stop-RTKSIYJV.js +596 -0
  299. package/dist/runner/stop-RTKSIYJV.js.map +7 -0
  300. package/dist/runner/subagent-CBCG4OLZ.js +116 -0
  301. package/dist/runner/subagent-CBCG4OLZ.js.map +7 -0
  302. package/dist/runner/token-metrics-AD2RAFGM.js +31 -0
  303. package/dist/runner/token-metrics-AD2RAFGM.js.map +7 -0
  304. package/dist/runner/user-prompt-T5NZ2UJD.js +376 -0
  305. package/dist/runner/user-prompt-T5NZ2UJD.js.map +7 -0
  306. package/package.json +70 -5
@@ -0,0 +1,370 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ EVALUATION_COHORT,
5
+ EVALUATOR_KIND,
6
+ appendEvaluation,
7
+ emitCoherenceHeuristic,
8
+ extractCoherenceSignals
9
+ } from "./chunk-MC75VXMX.js";
10
+ import {
11
+ mentionsAgentError,
12
+ mentionsRateLimit
13
+ } from "./chunk-LYY6RCIE.js";
14
+ import {
15
+ resolveOutputText
16
+ } from "./chunk-M4R4QIQH.js";
17
+ import {
18
+ agentInvocationAttributes,
19
+ getAgentSourceType
20
+ } from "./chunk-DGB4NSSD.js";
21
+ import "./chunk-LHWRXY2G.js";
22
+ import {
23
+ spawnedAgentType
24
+ } from "./chunk-NKZU4RRG.js";
25
+ import "./chunk-LQ2LGUYJ.js";
26
+ import {
27
+ instrumentHook
28
+ } from "./chunk-WU7ANGCW.js";
29
+ import {
30
+ AGENT_ATTRS,
31
+ ERROR_TYPE_ATTR,
32
+ GENAI_AGENT_ATTRIBUTES,
33
+ GENAI_DURATION_BUCKETS_S,
34
+ GENAI_INVOKE_AGENT_DURATION_METRIC,
35
+ GENAI_OPERATION,
36
+ GENAI_PROVIDER_NAMES,
37
+ HOOK_INSTRUMENTATION_ATTR,
38
+ HOOK_INSTRUMENTATION_INTERNAL,
39
+ HOOK_NAMES,
40
+ HOOK_TYPE_ATTR,
41
+ SESSION_ATTRIBUTES,
42
+ appendSpanRecords
43
+ } from "./chunk-7OM5CYES.js";
44
+ import {
45
+ SERVICE_VERSION,
46
+ getServiceName
47
+ } from "./chunk-GG2I4TGI.js";
48
+ import "./chunk-SRMAJQMV.js";
49
+ import "./chunk-YHYDBLVB.js";
50
+ import {
51
+ popPendingAgent
52
+ } from "./chunk-I7TD2QVR.js";
53
+ import {
54
+ conversationIdOf
55
+ } from "./chunk-DNSTWC26.js";
56
+ import {
57
+ writeStderr
58
+ } from "./chunk-52RY6LQT.js";
59
+ import {
60
+ NANOSECONDS_PER_MILLISECOND,
61
+ TIME_MS,
62
+ UNITS
63
+ } from "./chunk-RWRGC7ZK.js";
64
+ import {
65
+ SpanKind,
66
+ SpanStatusCode,
67
+ TraceFlags,
68
+ esm_exports,
69
+ init_esm
70
+ } from "./chunk-7PEOKGYR.js";
71
+ import "./chunk-GNNKUMRF.js";
72
+
73
+ // lib/agent/agent-evaluations.ts
74
+ var MIN_SCORECARD_COLUMNS = 3;
75
+ var AGENT_AUDITOR = "agent-auditor";
76
+ var DIMENSION_MAX_SCORE = 10;
77
+ var DIMENSION_BY_COLUMN = {
78
+ d1: "telemetry",
79
+ d2: "definition",
80
+ d3: "prompting",
81
+ d4: "overlap",
82
+ d5: "alignment",
83
+ d6: "efficiency",
84
+ d7: "code_quality",
85
+ d8: "evolutionary_fitness"
86
+ };
87
+ function tableCells(line) {
88
+ const trimmed = line.trim();
89
+ if (!trimmed.startsWith("|")) return [];
90
+ return trimmed.slice(1).replace(/\|\s*$/, "").split("|").map((c) => c.trim());
91
+ }
92
+ function isSeparatorRow(cells) {
93
+ return cells.length > 0 && cells.every((c) => /^:?-{2,}:?$/.test(c));
94
+ }
95
+ function cellNumber(cell) {
96
+ const digits = cell.replace(/\*/g, "").trim().match(/^([\d.]+)/)?.[1];
97
+ if (!digits) return void 0;
98
+ const value = parseFloat(digits);
99
+ return Number.isNaN(value) ? void 0 : value;
100
+ }
101
+ function cleanAgentName(cell) {
102
+ return cell.replace(/[`*]/g, "").replace(/\.md$/, "").trim();
103
+ }
104
+ function findScorecardLayout(headerCells) {
105
+ const headers = headerCells.map((h) => h.toLowerCase());
106
+ if (headers.length < MIN_SCORECARD_COLUMNS) return void 0;
107
+ const agentCol = headers.findIndex((h) => h === "agent");
108
+ const totalCol = headers.findIndex((h) => h.startsWith("total"));
109
+ if (agentCol === -1 || totalCol === -1) return void 0;
110
+ const totalHeaderCell = headers[totalCol] ?? "";
111
+ const headerDenom = totalHeaderCell.match(/\/\s*(\d+)/)?.[1];
112
+ const maxTotal = headerDenom ? parseInt(headerDenom, 10) : void 0;
113
+ const dimensionCols = /* @__PURE__ */ new Map();
114
+ headers.forEach((header, index) => {
115
+ const key = header.replace(/[^a-z0-9]/g, "");
116
+ const canonical = DIMENSION_BY_COLUMN[key];
117
+ if (canonical) dimensionCols.set(index, canonical);
118
+ });
119
+ return { agentCol, totalCol, maxTotal, dimensionCols };
120
+ }
121
+ function parseScorecardRows(rows, layout) {
122
+ const { agentCol, totalCol, maxTotal, dimensionCols } = layout;
123
+ const cards = [];
124
+ for (const row of rows) {
125
+ const cells = tableCells(row);
126
+ if (cells.length === 0) break;
127
+ if (isSeparatorRow(cells)) continue;
128
+ const agent = cleanAgentName(cells[agentCol] ?? "");
129
+ if (!agent) continue;
130
+ const dimensions = {};
131
+ for (const [index, canonical] of dimensionCols) {
132
+ const value = cellNumber(cells[index] ?? "");
133
+ if (value !== void 0) dimensions[canonical] = value;
134
+ }
135
+ cards.push({ agent, dimensions, total: cellNumber(cells[totalCol] ?? ""), maxTotal });
136
+ }
137
+ return cards;
138
+ }
139
+ function parseScorecard(output) {
140
+ const lines = output.split("\n");
141
+ for (const [i, line] of lines.entries()) {
142
+ const layout = findScorecardLayout(tableCells(line));
143
+ if (layout) return parseScorecardRows(lines.slice(i + 1), layout);
144
+ }
145
+ return [];
146
+ }
147
+ function emitScorecard(card, sessionId) {
148
+ const extras = { [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: card.agent };
149
+ const record = (name, score) => appendEvaluation({
150
+ name,
151
+ score,
152
+ kind: EVALUATOR_KIND.RULE,
153
+ cohort: EVALUATION_COHORT.NORMAL,
154
+ producer: AGENT_AUDITOR,
155
+ sessionId,
156
+ extraAttributes: extras
157
+ });
158
+ for (const [dimension, score] of Object.entries(card.dimensions)) {
159
+ if (score < 0 || score > DIMENSION_MAX_SCORE) {
160
+ writeStderr(
161
+ `[agent-evaluations] ${card.agent} ${dimension}: score ${score} outside 0-${DIMENSION_MAX_SCORE}, not emitted`
162
+ );
163
+ continue;
164
+ }
165
+ record(`agent.quality.score.${dimension}`, score / DIMENSION_MAX_SCORE);
166
+ }
167
+ if (card.total !== void 0 && card.maxTotal === void 0) {
168
+ writeStderr(
169
+ `[agent-evaluations] no denominator for ${card.agent}: total ${card.total} not emitted (write the real denominator in the Total header, e.g. "Total /70")`
170
+ );
171
+ return;
172
+ }
173
+ if (card.total !== void 0 && card.maxTotal !== void 0) {
174
+ record("agent.quality.score", card.total / card.maxTotal);
175
+ }
176
+ }
177
+ function injectAuditEvaluations(output, sessionId) {
178
+ for (const card of parseScorecard(output)) emitScorecard(card, sessionId);
179
+ }
180
+ var AGENT_EVALUATION_PARSERS = {
181
+ [AGENT_AUDITOR]: injectAuditEvaluations
182
+ };
183
+ function tryInjectEvaluations(agentType, output, sessionId) {
184
+ const parser = AGENT_EVALUATION_PARSERS[agentType];
185
+ if (!parser) return;
186
+ try {
187
+ parser(output, sessionId);
188
+ } catch {
189
+ }
190
+ }
191
+
192
+ // lib/agent/synth-spans.ts
193
+ init_esm();
194
+ var SCOPE = { name: "claude-hooks-synth", version: SERVICE_VERSION };
195
+ function msToHrTime(ms) {
196
+ const sec = Math.floor(ms / TIME_MS.SECOND);
197
+ return [sec, Math.floor((ms - sec * TIME_MS.SECOND) * NANOSECONDS_PER_MILLISECOND)];
198
+ }
199
+ function toReadableSpan(s) {
200
+ const links = (s.links ?? []).map((l) => ({
201
+ context: {
202
+ traceId: l.traceId,
203
+ spanId: l.spanId,
204
+ traceFlags: l.traceFlags ?? TraceFlags.SAMPLED,
205
+ isRemote: true
206
+ },
207
+ attributes: l.attributes,
208
+ droppedAttributesCount: 0
209
+ }));
210
+ return {
211
+ traceId: s.traceId,
212
+ spanId: s.spanId,
213
+ parentSpanId: s.parentSpanId,
214
+ name: s.name,
215
+ // SpanKind defaults to INTERNAL: synth spans model in-process agent invocation (OBP6/F14).
216
+ kind: s.kind ?? SpanKind.INTERNAL,
217
+ startTime: msToHrTime(s.startTimeMs),
218
+ endTime: msToHrTime(s.endTimeMs),
219
+ duration: msToHrTime(Math.max(0, s.endTimeMs - s.startTimeMs)),
220
+ status: s.status ?? { code: SpanStatusCode.UNSET },
221
+ attributes: s.attributes,
222
+ events: [],
223
+ links,
224
+ resource: {
225
+ serviceName: getServiceName(),
226
+ serviceVersion: SERVICE_VERSION
227
+ },
228
+ instrumentationScope: SCOPE
229
+ };
230
+ }
231
+ function appendSynthSpans(spans) {
232
+ if (spans.length === 0) return;
233
+ appendSpanRecords(spans.map(toReadableSpan));
234
+ }
235
+
236
+ // handlers/post-tool-agent.ts
237
+ var SYNTH_INSTANT_SPAN_DURATION_MS = TIME_MS.MS;
238
+ var AGENT_ERROR_TYPE = { RATE_LIMIT: "rate_limit", AGENT_ERROR: "agent_error" };
239
+ function agentErrorType(hasRateLimit, hasError) {
240
+ if (hasRateLimit) return AGENT_ERROR_TYPE.RATE_LIMIT;
241
+ if (hasError) return AGENT_ERROR_TYPE.AGENT_ERROR;
242
+ return void 0;
243
+ }
244
+ function emitAgentSynthSpans(ctx, pending, outcomeAttrs, invoc) {
245
+ const { attrs: invocAttrs, agentId } = invoc;
246
+ const errorType = agentErrorType(outcomeAttrs[AGENT_ATTRS.HAS_RATE_LIMIT], outcomeAttrs[AGENT_ATTRS.HAS_ERROR]);
247
+ const endTimeMs = Date.now();
248
+ const synthSpans = [];
249
+ if (pending.isFirstSeen) {
250
+ synthSpans.push({
251
+ name: `${GENAI_OPERATION.CREATE_AGENT} ${pending.agentName}`,
252
+ kind: esm_exports.SpanKind.CLIENT,
253
+ traceId: pending.traceId,
254
+ spanId: pending.createSpanId,
255
+ startTimeMs: pending.startTimeMs,
256
+ endTimeMs: pending.startTimeMs + SYNTH_INSTANT_SPAN_DURATION_MS,
257
+ attributes: {
258
+ [GENAI_AGENT_ATTRIBUTES.OPERATION_NAME]: GENAI_OPERATION.CREATE_AGENT,
259
+ [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: GENAI_PROVIDER_NAMES.ANTHROPIC,
260
+ [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: pending.agentName,
261
+ [GENAI_AGENT_ATTRIBUTES.AGENT_ID]: agentId,
262
+ [SESSION_ATTRIBUTES.SESSION_ID]: pending.sessionId
263
+ }
264
+ });
265
+ }
266
+ const invokeParentSpanId = pending.parentAgentInvokeSpanId || pending.createSpanId;
267
+ const conversationId = conversationIdOf(pending.sessionId);
268
+ const dispatchLinks = pending.dispatchLink ? [pending.dispatchLink] : void 0;
269
+ synthSpans.push({
270
+ name: `${GENAI_OPERATION.INVOKE_AGENT} ${pending.agentName}`,
271
+ traceId: pending.traceId,
272
+ spanId: pending.invokeSpanId,
273
+ parentSpanId: invokeParentSpanId,
274
+ links: dispatchLinks,
275
+ startTimeMs: pending.startTimeMs,
276
+ endTimeMs,
277
+ attributes: {
278
+ ...invocAttrs,
279
+ [AGENT_ATTRS.INVOCATION_ID]: pending.invokeSpanId,
280
+ // After the spread, so the invocation span always says so.
281
+ [GENAI_AGENT_ATTRIBUTES.OPERATION_NAME]: GENAI_OPERATION.INVOKE_AGENT,
282
+ [SESSION_ATTRIBUTES.SESSION_ID]: pending.sessionId,
283
+ ...outcomeAttrs,
284
+ ...conversationId ? { [SESSION_ATTRIBUTES.CONVERSATION_ID]: conversationId } : {},
285
+ ...errorType ? { [ERROR_TYPE_ATTR]: errorType } : {}
286
+ },
287
+ ...errorType ? { status: { code: esm_exports.SpanStatusCode.ERROR, message: errorType } } : {}
288
+ });
289
+ ctx.recordMetric(
290
+ GENAI_INVOKE_AGENT_DURATION_METRIC,
291
+ (endTimeMs - pending.startTimeMs) / TIME_MS.SECOND,
292
+ {
293
+ [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: pending.agentName,
294
+ ...errorType ? { [ERROR_TYPE_ATTR]: errorType } : {}
295
+ },
296
+ { unit: UNITS.SECOND, boundaries: GENAI_DURATION_BUCKETS_S.AGENT }
297
+ );
298
+ appendSynthSpans(synthSpans);
299
+ }
300
+ async function handleAgentPostTool(input) {
301
+ const agentType = spawnedAgentType(input);
302
+ if (!agentType) return;
303
+ const agentInfo = getAgentSourceType(agentType);
304
+ const invocation = agentInvocationAttributes(agentType, agentInfo, input.tool_input ?? {});
305
+ await instrumentHook(HOOK_NAMES.AGENT_FINALIZE, (ctx) => {
306
+ const sessionId = input.session_id;
307
+ const output = resolveOutputText(input);
308
+ const outputSize = output.length;
309
+ const hasRateLimit = mentionsRateLimit(output);
310
+ const hasError = !!input.is_error;
311
+ const outputMentionsError = !hasRateLimit && mentionsAgentError(output);
312
+ const coherenceSignals = extractCoherenceSignals(output);
313
+ const typeLabel = { [AGENT_ATTRS.TYPE]: agentType };
314
+ const outcomeAttrs = {
315
+ [AGENT_ATTRS.OUTPUT_SIZE]: outputSize,
316
+ [AGENT_ATTRS.HAS_ERROR]: hasError,
317
+ [AGENT_ATTRS.HAS_RATE_LIMIT]: hasRateLimit,
318
+ [AGENT_ATTRS.OUTPUT_HAS_STRUCTURE]: coherenceSignals.hasStructure,
319
+ [AGENT_ATTRS.OUTPUT_HAS_CODE]: coherenceSignals.hasCode,
320
+ [AGENT_ATTRS.OUTPUT_TRUNCATED]: coherenceSignals.truncated,
321
+ [AGENT_ATTRS.OUTPUT_EMPTY]: coherenceSignals.empty
322
+ };
323
+ ctx.addAttributes({
324
+ ...typeLabel,
325
+ ...outcomeAttrs,
326
+ [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: outputMentionsError,
327
+ [AGENT_ATTRS.OUTPUT_HAS_ACTIONS]: coherenceSignals.hasActions,
328
+ // No `gen_ai.operation.name` (OBP6).
329
+ ...invocation.attrs
330
+ });
331
+ emitCoherenceHeuristic(coherenceSignals, agentType, sessionId);
332
+ if (hasRateLimit) {
333
+ ctx.recordEvent("integritystudio.agent.rate_limit", typeLabel);
334
+ ctx.logger.warn("Agent hit rate limit", typeLabel);
335
+ writeStderr(`[Agent] ${agentType} hit rate limit \u2014 consider retry with backoff`);
336
+ } else if (hasError) {
337
+ ctx.logger.warn("Agent completed with errors", {
338
+ ...typeLabel,
339
+ [AGENT_ATTRS.OUTPUT_SIZE]: outputSize
340
+ });
341
+ writeStderr(`[Agent] ${agentType} completed with errors`);
342
+ } else {
343
+ ctx.logger.info("Agent completed", {
344
+ ...typeLabel,
345
+ [AGENT_ATTRS.OUTPUT_SIZE]: outputSize,
346
+ ...outputMentionsError ? { [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: true } : {}
347
+ });
348
+ writeStderr(`[Agent] ${agentType} completed`);
349
+ }
350
+ ctx.recordMetric("integritystudio.agent.completions", 1, {
351
+ ...typeLabel,
352
+ [AGENT_ATTRS.SOURCE_TYPE]: agentInfo.sourceType,
353
+ [AGENT_ATTRS.HAS_RATE_LIMIT]: String(hasRateLimit),
354
+ [AGENT_ATTRS.HAS_ERROR]: String(hasError),
355
+ [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: String(outputMentionsError)
356
+ }, { unit: UNITS.COMPLETION });
357
+ ctx.recordMetric(AGENT_ATTRS.OUTPUT_SIZE, outputSize, typeLabel, { unit: UNITS.BYTE });
358
+ if (!hasError && !hasRateLimit) {
359
+ tryInjectEvaluations(agentType, output, sessionId);
360
+ }
361
+ const pending = popPendingAgent(sessionId, agentType, input.tool_use_id);
362
+ if (!pending) return;
363
+ ctx.addAttribute(AGENT_ATTRS.INVOCATION_ID, pending.invokeSpanId);
364
+ emitAgentSynthSpans(ctx, pending, outcomeAttrs, invocation);
365
+ }, { [HOOK_TYPE_ATTR]: "agent", [HOOK_INSTRUMENTATION_ATTR]: HOOK_INSTRUMENTATION_INTERNAL });
366
+ }
367
+ export {
368
+ handleAgentPostTool
369
+ };
370
+ //# sourceMappingURL=post-tool-agent-BB34MNHI.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../lib/agent/agent-evaluations.ts", "../../../lib/agent/synth-spans.ts", "../../../handlers/post-tool-agent.ts"],
4
+ "sourcesContent": ["/** Per-agent scorecard parsers; adding a scoring agent is a table entry, not a handler branch (PT4). */\n\nimport { writeStderr } from '../core/format-utils.js';\nimport { GENAI_AGENT_ATTRIBUTES } from '../otel/attributes.js';\nimport { appendEvaluation, EVALUATOR_KIND, EVALUATION_COHORT } from '../quality/quality-signals.js';\n\nconst MIN_SCORECARD_COLUMNS = 3;\n\nconst AGENT_AUDITOR = 'agent-auditor';\n\n/** Fixed by the scoring spec, unlike the total's denominator, which has moved and is parsed. */\nconst DIMENSION_MAX_SCORE = 10;\n\n/** Keyed by the scorecard's D-number, fixed by `agent-auditor-scoring-spec.md` (the prose titles have already drifted). */\nconst DIMENSION_BY_COLUMN: Record<string, string> = {\n d1: 'telemetry',\n d2: 'definition',\n d3: 'prompting',\n d4: 'overlap',\n d5: 'alignment',\n d6: 'efficiency',\n d7: 'code_quality',\n d8: 'evolutionary_fitness',\n};\n\nfunction tableCells(line: string): string[] {\n const trimmed = line.trim();\n if (!trimmed.startsWith('|')) return [];\n return trimmed\n .slice(1)\n .replace(/\\|\\s*$/, '')\n .split('|')\n .map(c => c.trim());\n}\n\nfunction isSeparatorRow(cells: string[]): boolean {\n return cells.length > 0 && cells.every(c => /^:?-{2,}:?$/.test(c));\n}\n\n/** \"8\", \"8.5\", \"56/70\", \"**64/80**\" \u2192 8, 8.5, 56, 64. */\nfunction cellNumber(cell: string): number | undefined {\n const digits = cell.replace(/\\*/g, '').trim().match(/^([\\d.]+)/)?.[1];\n if (!digits) return undefined;\n const value = parseFloat(digits);\n return Number.isNaN(value) ? undefined : value;\n}\n\nfunction cleanAgentName(cell: string): string {\n return cell.replace(/[`*]/g, '').replace(/\\.md$/, '').trim();\n}\n\ninterface AgentScorecard {\n agent: string;\n dimensions: Record<string, number>;\n total?: number;\n /** From the Total header, e.g. 70 for \"Total /70\". */\n maxTotal?: number;\n}\n\ninterface ScorecardLayout {\n agentCol: number;\n totalCol: number;\n maxTotal?: number;\n dimensionCols: Map<number, string>;\n}\n\nfunction findScorecardLayout(headerCells: string[]): ScorecardLayout | undefined {\n const headers = headerCells.map(h => h.toLowerCase());\n if (headers.length < MIN_SCORECARD_COLUMNS) return undefined;\n\n const agentCol = headers.findIndex(h => h === 'agent');\n const totalCol = headers.findIndex(h => h.startsWith('total'));\n if (agentCol === -1 || totalCol === -1) return undefined;\n\n // agent-auditor.md requires the real denominator in the header (\"Total /70\").\n const totalHeaderCell = headers[totalCol] ?? '';\n const headerDenom = totalHeaderCell.match(/\\/\\s*(\\d+)/)?.[1];\n const maxTotal = headerDenom ? parseInt(headerDenom, 10) : undefined;\n\n const dimensionCols = new Map<number, string>();\n headers.forEach((header, index) => {\n const key = header.replace(/[^a-z0-9]/g, '');\n const canonical = DIMENSION_BY_COLUMN[key];\n if (canonical) dimensionCols.set(index, canonical);\n });\n\n return { agentCol, totalCol, maxTotal, dimensionCols };\n}\n\nfunction parseScorecardRows(rows: string[], layout: ScorecardLayout): AgentScorecard[] {\n const { agentCol, totalCol, maxTotal, dimensionCols } = layout;\n const cards: AgentScorecard[] = [];\n for (const row of rows) {\n const cells = tableCells(row);\n if (cells.length === 0) break;\n if (isSeparatorRow(cells)) continue;\n\n const agent = cleanAgentName(cells[agentCol] ?? '');\n if (!agent) continue;\n\n const dimensions: Record<string, number> = {};\n for (const [index, canonical] of dimensionCols) {\n // A withdrawn dimension renders \"\u2014\" (AA1a) and is absent, not zero.\n const value = cellNumber(cells[index] ?? '');\n if (value !== undefined) dimensions[canonical] = value;\n }\n\n cards.push({ agent, dimensions, total: cellNumber(cells[totalCol] ?? ''), maxTotal });\n }\n return cards;\n}\n\n/**\n * The wide Scorecard table: one row per agent, one column per dimension. Identified\n * by having both an `Agent` and a `Total` column, which separates it from the\n * Adaptive Assessment Detail table below it (same columns, depth labels not scores).\n */\nfunction parseScorecard(output: string): AgentScorecard[] {\n const lines = output.split('\\n');\n\n for (const [i, line] of lines.entries()) {\n const layout = findScorecardLayout(tableCells(line));\n if (layout) return parseScorecardRows(lines.slice(i + 1), layout);\n }\n return [];\n}\n\nfunction emitScorecard(card: AgentScorecard, sessionId: string): void {\n const extras = { [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: card.agent };\n const record = (name: string, score: number): void =>\n appendEvaluation({\n name,\n score,\n kind: EVALUATOR_KIND.RULE,\n cohort: EVALUATION_COHORT.NORMAL,\n producer: AGENT_AUDITOR,\n sessionId,\n extraAttributes: extras,\n });\n\n // Normalised to [0,1] before writing: the consumer treats an absent unit as a\n // ratio, so a raw 0\u201310 dimension averaged as 8.5 against a [0,1] total (AA1i).\n for (const [dimension, score] of Object.entries(card.dimensions)) {\n if (score < 0 || score > DIMENSION_MAX_SCORE) {\n // Dividing would emit >1 under a unit that promises [0,1].\n writeStderr(\n `[agent-evaluations] ${card.agent} ${dimension}: score ${score} outside ` +\n `0-${DIMENSION_MAX_SCORE}, not emitted`\n );\n continue;\n }\n record(`agent.quality.score.${dimension}`, score / DIMENSION_MAX_SCORE);\n }\n // Independent of the dimensions: one bad Total cell must not cost eight real scores.\n // The denominator is parsed, not constant \u2014 it has moved 60 \u2192 70 \u2192 80 (AA1h) \u2014 and\n // without it the total is skipped loudly: the usual cause is the header template\n // emitted verbatim (`Total /{max_score}`).\n if (card.total !== undefined && card.maxTotal === undefined) {\n writeStderr(\n `[agent-evaluations] no denominator for ${card.agent}: total ${card.total} not emitted ` +\n `(write the real denominator in the Total header, e.g. \"Total /70\")`\n );\n return;\n }\n if (card.total !== undefined && card.maxTotal !== undefined) {\n record('agent.quality.score', card.total / card.maxTotal);\n }\n}\n\nfunction injectAuditEvaluations(output: string, sessionId: string): void {\n for (const card of parseScorecard(output)) emitScorecard(card, sessionId);\n}\n\ntype EvaluationParser = (output: string, sessionId: string) => void;\n\nconst AGENT_EVALUATION_PARSERS: Record<string, EvaluationParser> = {\n [AGENT_AUDITOR]: injectAuditEvaluations,\n};\n\n/** Silent when no parser is registered or the parser throws. */\nexport function tryInjectEvaluations(agentType: string, output: string, sessionId: string): void {\n const parser = AGENT_EVALUATION_PARSERS[agentType];\n if (!parser) return;\n try {\n parser(output, sessionId);\n } catch {\n // Never fails the hook.\n }\n}\n", "/** Builds ExportedSpan records and appends them to the traces JSONL, so the shipper carries them like any other span. */\n\nimport { SpanKind, SpanStatusCode, TraceFlags } from '@opentelemetry/api';\nimport type { HrTime } from '@opentelemetry/api';\nimport { NANOSECONDS_PER_MILLISECOND, TIME_MS } from '../core/units.js';\nimport { appendSpanRecords, type ExportedSpan } from '../otel/file-exporters.js';\nimport { getServiceName, SERVICE_VERSION } from '../otel/service-identity.js';\nimport type { SynthSpan } from './agent-context.js';\n\nconst SCOPE = { name: 'claude-hooks-synth', version: SERVICE_VERSION };\n\n/** Not `millisToHrTime`: that rounds, and a sub-nanosecond fraction must truncate out of the fixed64 field. */\nfunction msToHrTime(ms: number): HrTime {\n const sec = Math.floor(ms / TIME_MS.SECOND);\n return [sec, Math.floor((ms - sec * TIME_MS.SECOND) * NANOSECONDS_PER_MILLISECOND)];\n}\n\n/** @internal Exported for testing. */\nexport function toReadableSpan(s: SynthSpan): ExportedSpan {\n // Cross-trace links (OBP6): the target is in another trace, so isRemote, with real sampling flags.\n const links = (s.links ?? []).map((l) => ({\n context: {\n traceId: l.traceId,\n spanId: l.spanId,\n traceFlags: l.traceFlags ?? TraceFlags.SAMPLED,\n isRemote: true,\n },\n attributes: l.attributes,\n droppedAttributesCount: 0,\n }));\n\n return {\n traceId: s.traceId,\n spanId: s.spanId,\n parentSpanId: s.parentSpanId,\n name: s.name,\n // SpanKind defaults to INTERNAL: synth spans model in-process agent invocation (OBP6/F14).\n kind: s.kind ?? SpanKind.INTERNAL,\n startTime: msToHrTime(s.startTimeMs),\n endTime: msToHrTime(s.endTimeMs),\n duration: msToHrTime(Math.max(0, s.endTimeMs - s.startTimeMs)),\n status: s.status ?? { code: SpanStatusCode.UNSET },\n attributes: s.attributes,\n events: [],\n links,\n resource: {\n serviceName: getServiceName(),\n serviceVersion: SERVICE_VERSION,\n },\n instrumentationScope: SCOPE,\n };\n}\n\n/** Append to today's traces file; no-op for an empty batch. */\nexport function appendSynthSpans(spans: SynthSpan[]): void {\n if (spans.length === 0) return;\n appendSpanRecords(spans.map(toReadableSpan));\n}\n", "/** Agent PostToolUse; lazy-loaded by the router so builtin events never pay for its imports (HSF27). */\n\nimport { popPendingAgent, type PendingAgent, type SynthSpan } from '../lib/agent/agent-context.js';\nimport { tryInjectEvaluations } from '../lib/agent/agent-evaluations.js';\nimport { getAgentSourceType, agentInvocationAttributes, type AgentIdentity } from '../lib/agent/agent-sources.js';\nimport { appendSynthSpans } from '../lib/agent/synth-spans.js';\nimport { writeStderr } from '../lib/core/format-utils.js';\nimport { TIME_MS, UNITS } from '../lib/core/units.js';\nimport {\n AGENT_ATTRS,\n ERROR_TYPE_ATTR,\n GENAI_AGENT_ATTRIBUTES,\n GENAI_DURATION_BUCKETS_S,\n GENAI_OPERATION,\n GENAI_PROVIDER_NAMES,\n SESSION_ATTRIBUTES,\n HOOK_TYPE_ATTR,\n HOOK_INSTRUMENTATION_ATTR,\n HOOK_INSTRUMENTATION_INTERNAL,\n GENAI_INVOKE_AGENT_DURATION_METRIC,\n HOOK_NAMES,\n} from '../lib/otel/attributes.js';\nimport { instrumentHook, type HookContext } from '../lib/otel/otel-monitor.js';\nimport { otelApi } from '../lib/otel/otel.js';\nimport { emitCoherenceHeuristic, extractCoherenceSignals } from '../lib/quality/quality-signals.js';\nimport type { PostToolHookInput as HookInput } from '../lib/runtime/hook-input.js';\nimport { mentionsAgentError, mentionsRateLimit } from '../lib/runtime/output-analyzer.js';\nimport { spawnedAgentType } from '../lib/runtime/tool-input.js';\nimport { resolveOutputText } from '../lib/runtime/tool-output.js';\nimport { conversationIdOf } from '../lib/session/session-state.js';\n\nconst SYNTH_INSTANT_SPAN_DURATION_MS = TIME_MS.MS;\n\n/** `error.type` values; `outputMentionsError` is deliberately not one \u2014 the invocation succeeded (AQ17). */\nconst AGENT_ERROR_TYPE = { RATE_LIMIT: 'rate_limit', AGENT_ERROR: 'agent_error' } as const;\n\ntype AgentErrorType = (typeof AGENT_ERROR_TYPE)[keyof typeof AGENT_ERROR_TYPE];\n\n/** The outcome keys the hook span and the synthetic invoke_agent span both carry. */\ntype AgentOutcomeAttrs = otelApi.Attributes & {\n [AGENT_ATTRS.HAS_ERROR]: boolean;\n [AGENT_ATTRS.HAS_RATE_LIMIT]: boolean;\n};\n\nfunction agentErrorType(hasRateLimit: boolean, hasError: boolean): AgentErrorType | undefined {\n if (hasRateLimit) return AGENT_ERROR_TYPE.RATE_LIMIT;\n if (hasError) return AGENT_ERROR_TYPE.AGENT_ERROR;\n return undefined;\n}\n\n/** Builds the create_agent / invoke_agent synthetic spans and records the agent-duration metric. */\nfunction emitAgentSynthSpans(\n ctx: HookContext,\n pending: PendingAgent,\n outcomeAttrs: AgentOutcomeAttrs,\n invoc: AgentIdentity,\n): void {\n const { attrs: invocAttrs, agentId } = invoc;\n const errorType = agentErrorType(outcomeAttrs[AGENT_ATTRS.HAS_RATE_LIMIT], outcomeAttrs[AGENT_ATTRS.HAS_ERROR]);\n const endTimeMs = Date.now();\n const synthSpans: SynthSpan[] = [];\n\n // create_agent on the first invocation per session per agent. Identity attributes\n // only: spreading invocAttrs here would overwrite the operation name with `invoke_agent`.\n if (pending.isFirstSeen) {\n synthSpans.push({\n name: `${GENAI_OPERATION.CREATE_AGENT} ${pending.agentName}`,\n kind: otelApi.SpanKind.CLIENT,\n traceId: pending.traceId,\n spanId: pending.createSpanId,\n startTimeMs: pending.startTimeMs,\n endTimeMs: pending.startTimeMs + SYNTH_INSTANT_SPAN_DURATION_MS,\n attributes: {\n [GENAI_AGENT_ATTRIBUTES.OPERATION_NAME]: GENAI_OPERATION.CREATE_AGENT,\n [GENAI_AGENT_ATTRIBUTES.PROVIDER_NAME]: GENAI_PROVIDER_NAMES.ANTHROPIC,\n [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: pending.agentName,\n [GENAI_AGENT_ATTRIBUTES.AGENT_ID]: agentId,\n [SESSION_ATTRIBUTES.SESSION_ID]: pending.sessionId,\n },\n });\n }\n\n // invoke_agent (pre-tool start \u2192 post-tool end). Parent is the dispatching agent's\n // invokeSpanId under delegation (\u00A712.10), else this agent's create_agent span.\n const invokeParentSpanId = pending.parentAgentInvokeSpanId || pending.createSpanId;\n const conversationId = conversationIdOf(pending.sessionId);\n // OBP6: a link, not a parent, back to the dispatching span in the hook trace.\n const dispatchLinks = pending.dispatchLink ? [pending.dispatchLink] : undefined;\n synthSpans.push({\n name: `${GENAI_OPERATION.INVOKE_AGENT} ${pending.agentName}`,\n traceId: pending.traceId,\n spanId: pending.invokeSpanId,\n parentSpanId: invokeParentSpanId,\n links: dispatchLinks,\n startTimeMs: pending.startTimeMs,\n endTimeMs,\n attributes: {\n ...invocAttrs,\n [AGENT_ATTRS.INVOCATION_ID]: pending.invokeSpanId,\n // After the spread, so the invocation span always says so.\n [GENAI_AGENT_ATTRIBUTES.OPERATION_NAME]: GENAI_OPERATION.INVOKE_AGENT,\n [SESSION_ATTRIBUTES.SESSION_ID]: pending.sessionId,\n ...outcomeAttrs,\n ...(conversationId ? { [SESSION_ATTRIBUTES.CONVERSATION_ID]: conversationId } : {}),\n ...(errorType ? { [ERROR_TYPE_ATTR]: errorType } : {}),\n },\n ...(errorType ? { status: { code: otelApi.SpanStatusCode.ERROR, message: errorType } } : {}),\n });\n\n // No gen_ai.request.model: SHOULD NOT for agents with dynamic model selection.\n ctx.recordMetric(\n GENAI_INVOKE_AGENT_DURATION_METRIC,\n (endTimeMs - pending.startTimeMs) / TIME_MS.SECOND,\n {\n [GENAI_AGENT_ATTRIBUTES.AGENT_NAME]: pending.agentName,\n ...(errorType ? { [ERROR_TYPE_ATTR]: errorType } : {}),\n },\n { unit: UNITS.SECOND, boundaries: GENAI_DURATION_BUCKETS_S.AGENT }\n );\n\n appendSynthSpans(synthSpans);\n}\n\nexport async function handleAgentPostTool(input: HookInput): Promise<void> {\n const agentType = spawnedAgentType(input);\n if (!agentType) return;\n\n const agentInfo = getAgentSourceType(agentType);\n const invocation = agentInvocationAttributes(agentType, agentInfo, input.tool_input ?? {});\n\n // Internal instrumentation; the GenAI-conformant span is the synthetic invoke_agent below (OBP6).\n await instrumentHook(HOOK_NAMES.AGENT_FINALIZE, (ctx) => {\n const sessionId = input.session_id;\n const output = resolveOutputText(input);\n const outputSize = output.length;\n\n const hasRateLimit = mentionsRateLimit(output);\n const hasError = !!input.is_error;\n const outputMentionsError = !hasRateLimit && mentionsAgentError(output);\n\n const coherenceSignals = extractCoherenceSignals(output);\n const typeLabel = { [AGENT_ATTRS.TYPE]: agentType };\n\n // Built once for this span and the synthetic invoke_agent span, so neither names nor values can drift.\n const outcomeAttrs = {\n [AGENT_ATTRS.OUTPUT_SIZE]: outputSize,\n [AGENT_ATTRS.HAS_ERROR]: hasError,\n [AGENT_ATTRS.HAS_RATE_LIMIT]: hasRateLimit,\n [AGENT_ATTRS.OUTPUT_HAS_STRUCTURE]: coherenceSignals.hasStructure,\n [AGENT_ATTRS.OUTPUT_HAS_CODE]: coherenceSignals.hasCode,\n [AGENT_ATTRS.OUTPUT_TRUNCATED]: coherenceSignals.truncated,\n [AGENT_ATTRS.OUTPUT_EMPTY]: coherenceSignals.empty,\n };\n\n ctx.addAttributes({\n ...typeLabel,\n ...outcomeAttrs,\n [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: outputMentionsError,\n [AGENT_ATTRS.OUTPUT_HAS_ACTIONS]: coherenceSignals.hasActions,\n // No `gen_ai.operation.name` (OBP6).\n ...invocation.attrs,\n });\n\n emitCoherenceHeuristic(coherenceSignals, agentType, sessionId);\n\n if (hasRateLimit) {\n ctx.recordEvent('integritystudio.agent.rate_limit', typeLabel);\n ctx.logger.warn('Agent hit rate limit', typeLabel);\n writeStderr(`[Agent] ${agentType} hit rate limit \u2014 consider retry with backoff`);\n } else if (hasError) {\n ctx.logger.warn('Agent completed with errors', {\n ...typeLabel,\n [AGENT_ATTRS.OUTPUT_SIZE]: outputSize,\n });\n writeStderr(`[Agent] ${agentType} completed with errors`);\n } else {\n ctx.logger.info('Agent completed', {\n ...typeLabel,\n [AGENT_ATTRS.OUTPUT_SIZE]: outputSize,\n ...(outputMentionsError ? { [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: true } : {}),\n });\n writeStderr(`[Agent] ${agentType} completed`);\n }\n\n ctx.recordMetric('integritystudio.agent.completions', 1, {\n ...typeLabel,\n [AGENT_ATTRS.SOURCE_TYPE]: agentInfo.sourceType,\n [AGENT_ATTRS.HAS_RATE_LIMIT]: String(hasRateLimit),\n [AGENT_ATTRS.HAS_ERROR]: String(hasError),\n [AGENT_ATTRS.OUTPUT_MENTIONS_ERROR]: String(outputMentionsError),\n }, { unit: UNITS.COMPLETION });\n ctx.recordMetric(AGENT_ATTRS.OUTPUT_SIZE, outputSize, typeLabel, { unit: UNITS.BYTE });\n\n if (!hasError && !hasRateLimit) {\n tryInjectEvaluations(agentType, output, sessionId);\n }\n\n const pending = popPendingAgent(sessionId, agentType, input.tool_use_id);\n if (!pending) return;\n\n // Same id as the pre-tool span, so Q4 pairs the two by exact id, not FIFO (AGQ1).\n ctx.addAttribute(AGENT_ATTRS.INVOCATION_ID, pending.invokeSpanId);\n emitAgentSynthSpans(ctx, pending, outcomeAttrs, invocation);\n }, { [HOOK_TYPE_ATTR]: 'agent', [HOOK_INSTRUMENTATION_ATTR]: HOOK_INSTRUMENTATION_INTERNAL });\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,147 @@
1
+ import { createRequire as __hookRunnerCreateRequire } from 'node:module';
2
+ const require = __hookRunnerCreateRequire(import.meta.url);
3
+ import {
4
+ commandInvocations,
5
+ isOptionArg,
6
+ programOf
7
+ } from "./chunk-JLEO5OHU.js";
8
+ import {
9
+ getStringField
10
+ } from "./chunk-NKZU4RRG.js";
11
+ import {
12
+ addAdditionalContext
13
+ } from "./chunk-2NTNAJZE.js";
14
+ import {
15
+ instrumentHook
16
+ } from "./chunk-WU7ANGCW.js";
17
+ import {
18
+ HOOK_NAMES,
19
+ HOOK_TYPE_ATTR
20
+ } from "./chunk-7OM5CYES.js";
21
+ import "./chunk-GG2I4TGI.js";
22
+ import "./chunk-SRMAJQMV.js";
23
+ import {
24
+ escapeRegExp
25
+ } from "./chunk-YHYDBLVB.js";
26
+ import "./chunk-DNSTWC26.js";
27
+ import {
28
+ CHANGELOG_DIR_SEGMENT
29
+ } from "./chunk-52RY6LQT.js";
30
+ import {
31
+ UNITS
32
+ } from "./chunk-RWRGC7ZK.js";
33
+ import "./chunk-7PEOKGYR.js";
34
+ import "./chunk-GNNKUMRF.js";
35
+
36
+ // handlers/post-tool-changelog-sync.ts
37
+ import { readdir, readFile, writeFile } from "node:fs/promises";
38
+ import { join } from "node:path";
39
+ var CHANGELOG_FILE = "CHANGELOG.md";
40
+ var CHANGELOG_DIR_SOURCE = escapeRegExp(CHANGELOG_DIR_SEGMENT);
41
+ var CHANGELOG_VERSION_PATTERN = new RegExp(`${CHANGELOG_DIR_SOURCE}([^/]+)`);
42
+ var CHANGELOG_PATH_PATTERN = new RegExp(`${CHANGELOG_VERSION_PATTERN.source}/`);
43
+ var changelogLink = (version) => `[Changelog](${CHANGELOG_DIR_SEGMENT}${version}/${CHANGELOG_FILE})`;
44
+ var CHANGELOG_LINK_PATTERN = new RegExp(
45
+ `\\[Changelog\\]\\(${CHANGELOG_DIR_SOURCE}([^/]+)/${escapeRegExp(CHANGELOG_FILE)}\\)`
46
+ );
47
+ var MKDIR_PROGRAM = "mkdir";
48
+ var VERSION_SEGMENT_PATTERN = /^[a-zA-Z0-9._-]+$/;
49
+ var README_FILE = "README.md";
50
+ var TRIGGER = { WRITE: "write", MKDIR: "mkdir" };
51
+ function getReadmeVersion(readme) {
52
+ return readme.match(CHANGELOG_LINK_PATTERN)?.[1];
53
+ }
54
+ var VERSION_PREFIX = /^v/i;
55
+ var compareNumericRuns = new Intl.Collator("en", { numeric: true }).compare;
56
+ function compareVersions(a, b) {
57
+ return compareNumericRuns(a.replace(VERSION_PREFIX, ""), b.replace(VERSION_PREFIX, ""));
58
+ }
59
+ function readmePathOf(projectRoot) {
60
+ return join(projectRoot, README_FILE);
61
+ }
62
+ async function findLatestVersion(changelogDir) {
63
+ try {
64
+ const entries = await readdir(changelogDir, { withFileTypes: true });
65
+ const versions = entries.filter((d) => d.isDirectory() && VERSION_SEGMENT_PATTERN.test(d.name)).map((d) => d.name).sort(compareVersions);
66
+ return versions[versions.length - 1];
67
+ } catch {
68
+ return void 0;
69
+ }
70
+ }
71
+ function pathBeforeChangelogDir(path) {
72
+ return path.substring(0, path.indexOf(CHANGELOG_DIR_SEGMENT)).replace(/\/$/, "");
73
+ }
74
+ function changelogVersionOf(path, pattern) {
75
+ const version = path.match(pattern)?.[1];
76
+ return version && VERSION_SEGMENT_PATTERN.test(version) ? version : void 0;
77
+ }
78
+ function parseWritePath(input) {
79
+ if (input.tool_name !== "Write") return;
80
+ const filePath = getStringField(input, "file_path");
81
+ if (!filePath) return;
82
+ const version = changelogVersionOf(filePath, CHANGELOG_PATH_PATTERN);
83
+ if (!version) return;
84
+ return { version, projectRoot: pathBeforeChangelogDir(filePath) || ".", trigger: TRIGGER.WRITE };
85
+ }
86
+ function isNewerThanReadme(version, readme) {
87
+ const currentVersion = readme === null ? void 0 : getReadmeVersion(readme);
88
+ return !currentVersion || compareVersions(currentVersion, version) < 0;
89
+ }
90
+ function parseMkdirCommand(input) {
91
+ if (input.tool_name !== "Bash") return;
92
+ const command = getStringField(input, "command");
93
+ if (!command) return;
94
+ const fullPath = commandInvocations(command).filter((argv) => programOf(argv) === MKDIR_PROGRAM).flatMap((argv) => argv.slice(1)).find((arg) => !isOptionArg(arg) && arg.includes(CHANGELOG_DIR_SEGMENT));
95
+ if (!fullPath) return;
96
+ const version = changelogVersionOf(fullPath, CHANGELOG_VERSION_PATTERN);
97
+ if (!version) return;
98
+ const projectRoot = pathBeforeChangelogDir(fullPath) || input.cwd;
99
+ return { version, projectRoot, trigger: TRIGGER.MKDIR };
100
+ }
101
+ async function syncReadmeLink({ version, projectRoot, trigger }, readme) {
102
+ await instrumentHook(HOOK_NAMES.CHANGELOG_VERSION_BUMP, async (ctx) => {
103
+ ctx.addAttributes({
104
+ "integritystudio.changelog.version": version,
105
+ "integritystudio.changelog.trigger": trigger
106
+ });
107
+ if (readme === null) return;
108
+ const latestVersion = await findLatestVersion(join(projectRoot, CHANGELOG_DIR_SEGMENT));
109
+ if (!latestVersion) return;
110
+ const changelogLinkMatch = readme.match(CHANGELOG_LINK_PATTERN);
111
+ if (!changelogLinkMatch) {
112
+ ctx.addAttribute("integritystudio.changelog.readme_link_found", false);
113
+ return;
114
+ }
115
+ const newLink = changelogLink(latestVersion);
116
+ if (changelogLinkMatch[0] === newLink) {
117
+ ctx.addAttribute("integritystudio.changelog.readme_already_current", true);
118
+ return;
119
+ }
120
+ const updatedReadme = readme.replace(CHANGELOG_LINK_PATTERN, newLink);
121
+ const readmePath = readmePathOf(projectRoot);
122
+ await writeFile(readmePath, updatedReadme, "utf-8");
123
+ ctx.addAttributes({
124
+ "integritystudio.changelog.readme_link_found": true,
125
+ "integritystudio.changelog.readme_updated": true,
126
+ "integritystudio.changelog.latest_version": latestVersion,
127
+ "integritystudio.changelog.previous_link": changelogLinkMatch[0]
128
+ });
129
+ ctx.recordMetric("integritystudio.changelog.readme_syncs", 1, void 0, { unit: UNITS.SYNC });
130
+ addAdditionalContext(
131
+ `[changelog-version-bump] Rewrote the changelog link in ${readmePath} from ${changelogLinkMatch[0]} to ${newLink}. Include README.md in the commit, or revert it if unwanted.`
132
+ );
133
+ }, { [HOOK_TYPE_ATTR]: "changelog-version-bump" });
134
+ }
135
+ async function handleChangelogVersionBump(input) {
136
+ const parsed = parseWritePath(input) ?? parseMkdirCommand(input);
137
+ if (!parsed) return;
138
+ const readme = await readFile(readmePathOf(parsed.projectRoot), "utf-8").catch(() => null);
139
+ if (!isNewerThanReadme(parsed.version, readme)) return;
140
+ await syncReadmeLink(parsed, readme);
141
+ }
142
+ export {
143
+ getReadmeVersion,
144
+ handleChangelogVersionBump,
145
+ parseMkdirCommand
146
+ };
147
+ //# sourceMappingURL=post-tool-changelog-sync-OP2TT2I7.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../handlers/post-tool-changelog-sync.ts"],
4
+ "sourcesContent": ["/**\n * Points README.md's [Changelog] link at the newest docs/changelog/<version>/\n * when one appears via Write or `mkdir`.\n */\n\nimport { readdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { CHANGELOG_DIR_SEGMENT } from '../lib/core/constants.js';\nimport { escapeRegExp } from '../lib/core/regex.js';\nimport { commandInvocations, isOptionArg, programOf } from '../lib/core/shell-command.js';\nimport { UNITS } from '../lib/core/units.js';\nimport { HOOK_NAMES, HOOK_TYPE_ATTR } from '../lib/otel/attributes.js';\nimport { instrumentHook } from '../lib/otel/otel-monitor.js';\nimport type { PostToolHookInput } from '../lib/runtime/hook-input.js';\nimport { addAdditionalContext } from '../lib/runtime/hook-output.js';\nimport { getStringField } from '../lib/runtime/tool-input.js';\n\ntype HookInput = Pick<PostToolHookInput, 'session_id' | 'tool_name' | 'tool_input' | 'cwd'>;\n\nconst CHANGELOG_FILE = 'CHANGELOG.md';\nconst CHANGELOG_DIR_SOURCE = escapeRegExp(CHANGELOG_DIR_SEGMENT);\n/** The version segment of a changelog path, trailing slash optional (`mkdir docs/changelog/1.2`). */\nconst CHANGELOG_VERSION_PATTERN = new RegExp(`${CHANGELOG_DIR_SOURCE}([^/]+)`);\n/** The Write form: a file follows the version directory, so `docs/changelog/README.md` names no version. */\nconst CHANGELOG_PATH_PATTERN = new RegExp(`${CHANGELOG_VERSION_PATTERN.source}/`);\nconst changelogLink = (version: string): string => `[Changelog](${CHANGELOG_DIR_SEGMENT}${version}/${CHANGELOG_FILE})`;\nconst CHANGELOG_LINK_PATTERN = new RegExp(\n `\\\\[Changelog\\\\]\\\\(${CHANGELOG_DIR_SOURCE}([^/]+)/${escapeRegExp(CHANGELOG_FILE)}\\\\)`,\n);\nconst MKDIR_PROGRAM = 'mkdir';\nconst VERSION_SEGMENT_PATTERN = /^[a-zA-Z0-9._-]+$/;\nconst README_FILE = 'README.md';\n\n/** Which route produced the version directory; the span's `changelog.trigger`. */\nconst TRIGGER = { WRITE: 'write', MKDIR: 'mkdir' } as const;\ntype Trigger = (typeof TRIGGER)[keyof typeof TRIGGER];\n\ninterface ChangelogVersion {\n version: string;\n projectRoot: string;\n trigger: Trigger;\n}\n\n/** The version segment the README's changelog link points to, or undefined. */\nexport function getReadmeVersion(readme: string): string | undefined {\n return readme.match(CHANGELOG_LINK_PATTERN)?.[1];\n}\n\nconst VERSION_PREFIX = /^v/i;\nconst compareNumericRuns = new Intl.Collator('en', { numeric: true }).compare;\n\n/** Orders digit runs numerically and ignores a leading `v`, so \"1.9\" < \"v1.10\" < \"2.0\". */\nfunction compareVersions(a: string, b: string): number {\n return compareNumericRuns(a.replace(VERSION_PREFIX, ''), b.replace(VERSION_PREFIX, ''));\n}\n\nfunction readmePathOf(projectRoot: string): string {\n return join(projectRoot, README_FILE);\n}\n\nasync function findLatestVersion(changelogDir: string): Promise<string | undefined> {\n try {\n const entries = await readdir(changelogDir, { withFileTypes: true });\n const versions = entries\n .filter(d => d.isDirectory() && VERSION_SEGMENT_PATTERN.test(d.name))\n .map(d => d.name)\n .sort(compareVersions);\n\n return versions[versions.length - 1];\n } catch {\n return undefined;\n }\n}\n\n/** The part of `path` before `docs/changelog/`, minus its trailing slash; '' when it starts there. */\nfunction pathBeforeChangelogDir(path: string): string {\n return path.substring(0, path.indexOf(CHANGELOG_DIR_SEGMENT)).replace(/\\/$/, '');\n}\n\n/** The well-formed version segment `pattern` captures from `path`; a match guarantees the path contains CHANGELOG_DIR_SEGMENT. */\nfunction changelogVersionOf(path: string, pattern: RegExp): string | undefined {\n const version = path.match(pattern)?.[1];\n return version && VERSION_SEGMENT_PATTERN.test(version) ? version : undefined;\n}\n\nfunction parseWritePath(input: HookInput): ChangelogVersion | undefined {\n if (input.tool_name !== 'Write') return;\n\n const filePath = getStringField(input, 'file_path');\n if (!filePath) return;\n\n const version = changelogVersionOf(filePath, CHANGELOG_PATH_PATTERN);\n if (!version) return;\n\n return { version, projectRoot: pathBeforeChangelogDir(filePath) || '.', trigger: TRIGGER.WRITE };\n}\n\n/**\n * Compared against the README, not the directory's entry count: a previously-synced\n * dir still has one file and would falsely re-fire. Applied to both routes, or\n * backfilling an older version rewrites the tracked README.\n */\nfunction isNewerThanReadme(version: string, readme: string | null): boolean {\n const currentVersion = readme === null ? undefined : getReadmeVersion(readme);\n return !currentVersion || compareVersions(currentVersion, version) < 0;\n}\n\nexport function parseMkdirCommand(input: HookInput): ChangelogVersion | undefined {\n if (input.tool_name !== 'Bash') return;\n\n const command = getStringField(input, 'command');\n if (!command) return;\n\n // The path must be an argument of mkdir itself, not of a later command on the line (HSF18).\n const fullPath = commandInvocations(command)\n .filter((argv) => programOf(argv) === MKDIR_PROGRAM)\n .flatMap((argv) => argv.slice(1))\n .find((arg) => !isOptionArg(arg) && arg.includes(CHANGELOG_DIR_SEGMENT));\n if (!fullPath) return;\n\n const version = changelogVersionOf(fullPath, CHANGELOG_VERSION_PATTERN);\n if (!version) return;\n\n const projectRoot = pathBeforeChangelogDir(fullPath) || input.cwd;\n\n return { version, projectRoot, trigger: TRIGGER.MKDIR };\n}\n\n/** `readme` is null when README.md is missing or unreadable. */\nasync function syncReadmeLink({ version, projectRoot, trigger }: ChangelogVersion, readme: string | null): Promise<void> {\n await instrumentHook(HOOK_NAMES.CHANGELOG_VERSION_BUMP, async (ctx) => {\n ctx.addAttributes({\n 'integritystudio.changelog.version': version,\n 'integritystudio.changelog.trigger': trigger,\n });\n\n if (readme === null) return;\n\n // Undefined for a missing or unreadable changelog dir too.\n const latestVersion = await findLatestVersion(join(projectRoot, CHANGELOG_DIR_SEGMENT));\n if (!latestVersion) return;\n\n const changelogLinkMatch = readme.match(CHANGELOG_LINK_PATTERN);\n\n if (!changelogLinkMatch) {\n ctx.addAttribute('integritystudio.changelog.readme_link_found', false);\n return;\n }\n\n const newLink = changelogLink(latestVersion);\n if (changelogLinkMatch[0] === newLink) {\n ctx.addAttribute('integritystudio.changelog.readme_already_current', true);\n return;\n }\n\n const updatedReadme = readme.replace(CHANGELOG_LINK_PATTERN, newLink);\n const readmePath = readmePathOf(projectRoot);\n await writeFile(readmePath, updatedReadme, 'utf-8');\n\n ctx.addAttributes({\n 'integritystudio.changelog.readme_link_found': true,\n 'integritystudio.changelog.readme_updated': true,\n 'integritystudio.changelog.latest_version': latestVersion,\n 'integritystudio.changelog.previous_link': changelogLinkMatch[0],\n });\n\n ctx.recordMetric('integritystudio.changelog.readme_syncs', 1, undefined, { unit: UNITS.SYNC });\n\n // This edits a tracked file unasked; stderr at exit 0 reaches nobody (CCH0), so announce via additionalContext (HRV11).\n addAdditionalContext(\n `[changelog-version-bump] Rewrote the changelog link in ${readmePath} ` +\n `from ${changelogLinkMatch[0]} to ${newLink}. Include README.md in the commit, or revert it if unwanted.`\n );\n }, { [HOOK_TYPE_ATTR]: 'changelog-version-bump' });\n}\n\nexport async function handleChangelogVersionBump(input: HookInput): Promise<void> {\n const parsed = parseWritePath(input) ?? parseMkdirCommand(input);\n if (!parsed) return;\n const readme = await readFile(readmePathOf(parsed.projectRoot), 'utf-8').catch(() => null);\n if (!isNewerThanReadme(parsed.version, readme)) return;\n\n await syncReadmeLink(parsed, readme);\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,SAAS,SAAS,UAAU,iBAAiB;AAC7C,SAAS,YAAY;AAarB,IAAM,iBAAiB;AACvB,IAAM,uBAAuB,aAAa,qBAAqB;AAE/D,IAAM,4BAA4B,IAAI,OAAO,GAAG,oBAAoB,SAAS;AAE7E,IAAM,yBAAyB,IAAI,OAAO,GAAG,0BAA0B,MAAM,GAAG;AAChF,IAAM,gBAAgB,CAAC,YAA4B,eAAe,qBAAqB,GAAG,OAAO,IAAI,cAAc;AACnH,IAAM,yBAAyB,IAAI;AAAA,EACjC,qBAAqB,oBAAoB,WAAW,aAAa,cAAc,CAAC;AAClF;AACA,IAAM,gBAAgB;AACtB,IAAM,0BAA0B;AAChC,IAAM,cAAc;AAGpB,IAAM,UAAU,EAAE,OAAO,SAAS,OAAO,QAAQ;AAU1C,SAAS,iBAAiB,QAAoC;AACnE,SAAO,OAAO,MAAM,sBAAsB,IAAI,CAAC;AACjD;AAEA,IAAM,iBAAiB;AACvB,IAAM,qBAAqB,IAAI,KAAK,SAAS,MAAM,EAAE,SAAS,KAAK,CAAC,EAAE;AAGtE,SAAS,gBAAgB,GAAW,GAAmB;AACrD,SAAO,mBAAmB,EAAE,QAAQ,gBAAgB,EAAE,GAAG,EAAE,QAAQ,gBAAgB,EAAE,CAAC;AACxF;AAEA,SAAS,aAAa,aAA6B;AACjD,SAAO,KAAK,aAAa,WAAW;AACtC;AAEA,eAAe,kBAAkB,cAAmD;AAClF,MAAI;AACF,UAAM,UAAU,MAAM,QAAQ,cAAc,EAAE,eAAe,KAAK,CAAC;AACnE,UAAM,WAAW,QACd,OAAO,OAAK,EAAE,YAAY,KAAK,wBAAwB,KAAK,EAAE,IAAI,CAAC,EACnE,IAAI,OAAK,EAAE,IAAI,EACf,KAAK,eAAe;AAEvB,WAAO,SAAS,SAAS,SAAS,CAAC;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,uBAAuB,MAAsB;AACpD,SAAO,KAAK,UAAU,GAAG,KAAK,QAAQ,qBAAqB,CAAC,EAAE,QAAQ,OAAO,EAAE;AACjF;AAGA,SAAS,mBAAmB,MAAc,SAAqC;AAC7E,QAAM,UAAU,KAAK,MAAM,OAAO,IAAI,CAAC;AACvC,SAAO,WAAW,wBAAwB,KAAK,OAAO,IAAI,UAAU;AACtE;AAEA,SAAS,eAAe,OAAgD;AACtE,MAAI,MAAM,cAAc,QAAS;AAEjC,QAAM,WAAW,eAAe,OAAO,WAAW;AAClD,MAAI,CAAC,SAAU;AAEf,QAAM,UAAU,mBAAmB,UAAU,sBAAsB;AACnE,MAAI,CAAC,QAAS;AAEd,SAAO,EAAE,SAAS,aAAa,uBAAuB,QAAQ,KAAK,KAAK,SAAS,QAAQ,MAAM;AACjG;AAOA,SAAS,kBAAkB,SAAiB,QAAgC;AAC1E,QAAM,iBAAiB,WAAW,OAAO,SAAY,iBAAiB,MAAM;AAC5E,SAAO,CAAC,kBAAkB,gBAAgB,gBAAgB,OAAO,IAAI;AACvE;AAEO,SAAS,kBAAkB,OAAgD;AAChF,MAAI,MAAM,cAAc,OAAQ;AAEhC,QAAM,UAAU,eAAe,OAAO,SAAS;AAC/C,MAAI,CAAC,QAAS;AAGd,QAAM,WAAW,mBAAmB,OAAO,EACxC,OAAO,CAAC,SAAS,UAAU,IAAI,MAAM,aAAa,EAClD,QAAQ,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,EAC/B,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,KAAK,IAAI,SAAS,qBAAqB,CAAC;AACzE,MAAI,CAAC,SAAU;AAEf,QAAM,UAAU,mBAAmB,UAAU,yBAAyB;AACtE,MAAI,CAAC,QAAS;AAEd,QAAM,cAAc,uBAAuB,QAAQ,KAAK,MAAM;AAE9D,SAAO,EAAE,SAAS,aAAa,SAAS,QAAQ,MAAM;AACxD;AAGA,eAAe,eAAe,EAAE,SAAS,aAAa,QAAQ,GAAqB,QAAsC;AACvH,QAAM,eAAe,WAAW,wBAAwB,OAAO,QAAQ;AACrE,QAAI,cAAc;AAAA,MAChB,qCAAqC;AAAA,MACrC,qCAAqC;AAAA,IACvC,CAAC;AAED,QAAI,WAAW,KAAM;AAGrB,UAAM,gBAAgB,MAAM,kBAAkB,KAAK,aAAa,qBAAqB,CAAC;AACtF,QAAI,CAAC,cAAe;AAEpB,UAAM,qBAAqB,OAAO,MAAM,sBAAsB;AAE9D,QAAI,CAAC,oBAAoB;AACvB,UAAI,aAAa,+CAA+C,KAAK;AACrE;AAAA,IACF;AAEA,UAAM,UAAU,cAAc,aAAa;AAC3C,QAAI,mBAAmB,CAAC,MAAM,SAAS;AACrC,UAAI,aAAa,oDAAoD,IAAI;AACzE;AAAA,IACF;AAEA,UAAM,gBAAgB,OAAO,QAAQ,wBAAwB,OAAO;AACpE,UAAM,aAAa,aAAa,WAAW;AAC3C,UAAM,UAAU,YAAY,eAAe,OAAO;AAElD,QAAI,cAAc;AAAA,MAChB,+CAA+C;AAAA,MAC/C,4CAA4C;AAAA,MAC5C,4CAA4C;AAAA,MAC5C,2CAA2C,mBAAmB,CAAC;AAAA,IACjE,CAAC;AAED,QAAI,aAAa,0CAA0C,GAAG,QAAW,EAAE,MAAM,MAAM,KAAK,CAAC;AAG7F;AAAA,MACE,0DAA0D,UAAU,SAC5D,mBAAmB,CAAC,CAAC,OAAO,OAAO;AAAA,IAC7C;AAAA,EACF,GAAG,EAAE,CAAC,cAAc,GAAG,yBAAyB,CAAC;AACnD;AAEA,eAAsB,2BAA2B,OAAiC;AAChF,QAAM,SAAS,eAAe,KAAK,KAAK,kBAAkB,KAAK;AAC/D,MAAI,CAAC,OAAQ;AACb,QAAM,SAAS,MAAM,SAAS,aAAa,OAAO,WAAW,GAAG,OAAO,EAAE,MAAM,MAAM,IAAI;AACzF,MAAI,CAAC,kBAAkB,OAAO,SAAS,MAAM,EAAG;AAEhD,QAAM,eAAe,QAAQ,MAAM;AACrC;",
6
+ "names": []
7
+ }