ctxtop 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,471 @@
1
+ /**
2
+ * @file src/core-isomorphic/diagnostics/micro_skills.mjs
3
+ * RSI-04 ("micro-skills") — Zero-LLM-Cost Deterministic Command-Pair Micro-Skills Engine.
4
+ *
5
+ * Strictly zero `node:*` imports (Claude Code Mod Law 4 compliant).
6
+ * Captures verified shell recovery pairs (`failedCmd` -> `workingCmd` within <= 3 turns),
7
+ * promotes after >= N distinct sessions (default 2), evicts contradicted skills,
8
+ * rejects secret-bearing or Ring-0 unsafe bypass commands, and formats <80-token StateBaton snippets.
9
+ */
10
+
11
+ import { path, getCwd, readJsonSafe, writeJsonAtomic } from '../utils/runtime.mjs';
12
+
13
+ export const MAX_MICRO_SKILL_BATON_TOKENS = 80;
14
+ export const MAX_MICRO_SKILL_BATON_CHARS = 300; // ~75-78 tokens
15
+
16
+ const LIVE_SECRET_PATTERNS = Object.freeze([
17
+ /\bsk-(?:ant-|proj-|live-|test-)?[A-Za-z0-9_-]{16,}\b/,
18
+ /\bgh[pousr]_[A-Za-z0-9]{20,}\b/,
19
+ /\bgithub_pat_[A-Za-z0-9_]{24,}\b/,
20
+ /\bAKIA[0-9A-Z]{16}\b/,
21
+ /\bAIza[0-9A-Za-z_-]{30,}\b/,
22
+ /\bxox[baprs]-[0-9A-Za-z-]{16,}\b/,
23
+ /\bBearer\s+[A-Za-z0-9._-]{16,}\b/i,
24
+ /-----BEGIN\s+[A-Z0-9\s]*PRIVATE\s+KEY-----/,
25
+ /[a-z0-9+.-]+:\/\/[^/\s:@]+:[^/\s@]+@[^\s]+/i,
26
+ /\b(?:API_KEY|SECRET|TOKEN|PASSWORD|PASSWD|PRIVATE_KEY|AUTH_TOKEN|ACCESS_KEY|STRIPE_KEY|OPENAI_API_KEY|ANTHROPIC_API_KEY)\s*=\s*['"]?[^\s'"]{6,}/i,
27
+ /--(?:token|password|api-key|secret|auth)(?:=|\s+)['"]?[^\s'"]+/i
28
+ ]);
29
+
30
+ const UNSAFE_BYPASS_PATTERNS = Object.freeze([
31
+ /--no-verify\b/i,
32
+ /--no-gpg-sign\b/i,
33
+ /\bgit\s+commit\b[^\r\n]*\s-[a-z]*n[a-z]*\b/i,
34
+ /\bgit\s+reset\s+--hard\b/i,
35
+ /\bgit\s+clean\s+-[a-z]*f/i,
36
+ /\bgit\s+push\b[^\r\n]*(?:--force\b|--force-with-lease\b|\s-f\b)/i,
37
+ /\brm\s+-[a-z]*r[a-z]*f\b/i,
38
+ /\brm\s+-[a-z]*f[a-z]*r\b/i,
39
+ /\bRemove-Item\b[^\r\n]*-Recurse[^\r\n]*-Force\b/i,
40
+ /\bdel\s+\/[sqf]/i,
41
+ /\bsudo\s+/i,
42
+ /\bchmod\s+777\b/i,
43
+ /\bNODE_TLS_REJECT_UNAUTHORIZED\s*=\s*['"]?0/i,
44
+ /\b(?:curl|wget)\b[^\r\n]*\|\s*(?:sh|bash|zsh|pwsh|powershell)\b/i
45
+ ]);
46
+
47
+ function shannonEntropy(str = '') {
48
+ if (!str) return 0;
49
+ const freq = new Map();
50
+ for (let i = 0; i < str.length; i++) {
51
+ const ch = str[i];
52
+ freq.set(ch, (freq.get(ch) || 0) + 1);
53
+ }
54
+ let entropy = 0;
55
+ const len = str.length;
56
+ for (const count of freq.values()) {
57
+ const p = count / len;
58
+ entropy -= p * Math.log2(p);
59
+ }
60
+ return entropy;
61
+ }
62
+
63
+ /**
64
+ * Validates that a shell command string is safe to record (contains zero secrets
65
+ * and zero Ring-0 destructive / hook-bypass flags).
66
+ *
67
+ * @param {string} rawCommand
68
+ * @returns {{ safe: boolean, reason: string | null }}
69
+ */
70
+ export function inspectCommandSafetyForMicroSkill(rawCommand = '') {
71
+ const text = String(rawCommand || '').trim();
72
+ if (!text || text.length > 400 || /[\r\n]/.test(text)) {
73
+ return { safe: false, reason: 'INVALID_LENGTH_OR_MULTILINE' };
74
+ }
75
+
76
+ for (const re of LIVE_SECRET_PATTERNS) {
77
+ if (re.test(text)) {
78
+ return { safe: false, reason: 'SECRET_DETECTED' };
79
+ }
80
+ }
81
+
82
+ // Check inline KEY=VALUE env assignments for high-entropy secrets
83
+ const envMatches = text.matchAll(/\b([A-Za-z_][A-Za-z0-9_]{1,})\s*=\s*(['"]?)([^\s'"]{16,})\2/g);
84
+ for (const m of envMatches) {
85
+ const val = m[3] || '';
86
+ if (shannonEntropy(val) >= 3.55) {
87
+ return { safe: false, reason: 'SECRET_DETECTED' };
88
+ }
89
+ }
90
+
91
+ for (const re of UNSAFE_BYPASS_PATTERNS) {
92
+ if (re.test(text)) {
93
+ return { safe: false, reason: 'UNSAFE_BYPASS_COMMAND' };
94
+ }
95
+ }
96
+
97
+ return { safe: true, reason: null };
98
+ }
99
+
100
+ function isFileTargetToken(tok = '') {
101
+ const clean = String(tok || '').replace(/^['"]|['"]$/g, '');
102
+ if (!clean || clean === './...' || clean.startsWith('-')) return false;
103
+ if (clean.includes('::')) return true;
104
+ if (/^(?:\.{1,2}[\\/]|[A-Za-z]:[\\/]|tests?[\\/]|src[\\/]|lib[\\/]|packages[\\/]|app[\\/])/i.test(clean)) {
105
+ return true;
106
+ }
107
+ if (/\.(?:py|js|mjs|cjs|ts|tsx|jsx|rs|go|rb|java|kt|cs|php|json|ya?ml|toml|md)$/i.test(clean)) {
108
+ return true;
109
+ }
110
+ return false;
111
+ }
112
+
113
+ /**
114
+ * Normalizes a shell command down to its canonical reusable runner invocation and detects its `commandFamily`.
115
+ * E.g. `poetry run pytest tests/test_auth.py::test_login` -> `{ canonical: 'poetry run pytest', commandFamily: 'pytest' }`.
116
+ *
117
+ * @param {string} rawCommand
118
+ * @returns {{ valid: boolean, canonical: string, commandFamily: string | null, rejectedReason: string | null }}
119
+ */
120
+ export function canonicalizeMicroSkillCommand(rawCommand = '') {
121
+ const safety = inspectCommandSafetyForMicroSkill(rawCommand);
122
+ if (!safety.safe) {
123
+ return { valid: false, canonical: '', commandFamily: null, rejectedReason: safety.reason };
124
+ }
125
+
126
+ // Reject compound multi-statement shell pipelines (`&&`, `||`, `;`, `|`) to keep micro-skills atomic
127
+ const trimmed = String(rawCommand || '').trim().replace(/\s+/g, ' ');
128
+ if (/(?:\|\||&&|;|\|)/.test(trimmed)) {
129
+ return { valid: false, canonical: '', commandFamily: null, rejectedReason: 'COMPOUND_COMMAND' };
130
+ }
131
+
132
+ const tokens = trimmed.split(' ').filter(Boolean);
133
+ // Strip trailing specific file targets while keeping runner, subcommand, and structural flags like `--workspace` / `run`
134
+ const kept = [];
135
+ for (let i = 0; i < tokens.length; i++) {
136
+ const tok = tokens[i];
137
+ if (i >= 1 && isFileTargetToken(tok)) {
138
+ continue;
139
+ }
140
+ kept.push(tok);
141
+ }
142
+
143
+ const canonical = kept.join(' ').trim();
144
+ const lower = canonical.toLowerCase();
145
+
146
+ let commandFamily = null;
147
+ if (/\bpytest\b/.test(lower)) {
148
+ commandFamily = 'pytest';
149
+ } else if (/\b(?:vitest|jest|mocha|ava)\b/.test(lower) || /\b(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?test\b/.test(lower) || /^node\s+--test\b/.test(lower)) {
150
+ commandFamily = 'js-test';
151
+ } else if (/\bcargo\s+test\b/.test(lower)) {
152
+ commandFamily = 'cargo-test';
153
+ } else if (/\bcargo\s+(?:build|check)\b/.test(lower)) {
154
+ commandFamily = 'cargo-build';
155
+ } else if (/\bgo\s+test\b/.test(lower)) {
156
+ commandFamily = 'go-test';
157
+ } else if (/\btsc\b/.test(lower) || /\b(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?typecheck\b/.test(lower)) {
158
+ commandFamily = 'typecheck';
159
+ } else if (/\b(?:eslint|biome)\b/.test(lower) || /\b(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?lint\b/.test(lower)) {
160
+ commandFamily = 'js-lint';
161
+ } else if (/\b(?:ruff|flake8|black)\b/.test(lower)) {
162
+ commandFamily = 'py-lint';
163
+ } else if (/\bmypy\b|\bpyright\b/.test(lower)) {
164
+ commandFamily = 'py-typecheck';
165
+ } else if (/\b(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?build\b/.test(lower)) {
166
+ commandFamily = 'js-build';
167
+ }
168
+
169
+ if (!commandFamily) {
170
+ return { valid: false, canonical, commandFamily: null, rejectedReason: 'UNSUPPORTED_FAMILY' };
171
+ }
172
+
173
+ return { valid: true, canonical, commandFamily, rejectedReason: null };
174
+ }
175
+
176
+ export function createEmptyMicroSkillsRegistry() {
177
+ return {
178
+ schemaVersion: '1.0.0',
179
+ skills: [],
180
+ pendingFailuresBySession: {}
181
+ };
182
+ }
183
+
184
+ /**
185
+ * Pure state-transition function recording a shell command's exit outcome in the Micro-Skills registry.
186
+ *
187
+ * @param {object} currentRegistry
188
+ * @param {object} event
189
+ * @param {string} event.command
190
+ * @param {number} event.exitCode
191
+ * @param {number} [event.turn=1]
192
+ * @param {string} [event.sessionId='default']
193
+ * @param {number} [event.confirmSessions=2]
194
+ * @param {string} [event.nowIso]
195
+ */
196
+ export function recordShellOutcomeInRegistry(currentRegistry = {}, event = {}) {
197
+ const base = currentRegistry && typeof currentRegistry === 'object'
198
+ ? currentRegistry
199
+ : createEmptyMicroSkillsRegistry();
200
+
201
+ const skills = Array.isArray(base.skills) ? base.skills.map((s) => ({
202
+ ...s,
203
+ confirmedSessionIds: Array.isArray(s.confirmedSessionIds) ? [...s.confirmedSessionIds] : []
204
+ })) : [];
205
+ const pendingMap = base.pendingFailuresBySession && typeof base.pendingFailuresBySession === 'object'
206
+ ? { ...base.pendingFailuresBySession }
207
+ : {};
208
+
209
+ const parsed = canonicalizeMicroSkillCommand(event.command || '');
210
+ if (!parsed.valid) {
211
+ return {
212
+ updated: false,
213
+ rejectedReason: parsed.rejectedReason,
214
+ promotedSkill: null,
215
+ capturedCandidate: null,
216
+ evictedContradictions: [],
217
+ registry: { schemaVersion: '1.0.0', skills, pendingFailuresBySession: pendingMap }
218
+ };
219
+ }
220
+
221
+ const sessionId = String(event.sessionId || 'default');
222
+ const turn = Math.max(1, Number(event.turn ?? 1));
223
+ const exitCode = Number(event.exitCode ?? 0);
224
+ const confirmSessions = Math.max(1, Number(event.confirmSessions ?? 2));
225
+ const nowIso = event.nowIso || new Date().toISOString();
226
+ const sessionFailures = Array.isArray(pendingMap[sessionId]) ? [...pendingMap[sessionId]] : [];
227
+
228
+ if (exitCode !== 0) {
229
+ // Prune stale failures (> 3 turns old) and record this failed command
230
+ const fresh = sessionFailures.filter((f) => turn - Number(f.turn || 0) <= 3 && f.failedCmd !== parsed.canonical);
231
+ fresh.push({
232
+ failedCmd: parsed.canonical,
233
+ commandFamily: parsed.commandFamily,
234
+ turn,
235
+ recordedAt: nowIso
236
+ });
237
+ pendingMap[sessionId] = fresh.slice(-8);
238
+
239
+ // Track if an existing promoted workingCmd just failed in this session
240
+ for (const sk of skills) {
241
+ if (sk.workingCmd === parsed.canonical && sk.commandFamily === parsed.commandFamily) {
242
+ sk.lastWorkingFailedSession = sessionId;
243
+ sk.lastWorkingFailedTurn = turn;
244
+ }
245
+ }
246
+
247
+ return {
248
+ updated: true,
249
+ rejectedReason: null,
250
+ promotedSkill: null,
251
+ capturedCandidate: null,
252
+ evictedContradictions: [],
253
+ registry: { schemaVersion: '1.0.0', skills, pendingFailuresBySession: pendingMap }
254
+ };
255
+ }
256
+
257
+ // exitCode === 0: Check contradiction eviction & candidate capture within <= 3 turns
258
+ const evictedContradictions = [];
259
+ for (let i = skills.length - 1; i >= 0; i--) {
260
+ const sk = skills[i];
261
+ const failedCmdNowWorks =
262
+ sk.failedCmd === parsed.canonical &&
263
+ sk.commandFamily === parsed.commandFamily;
264
+ const workingCmdSuperseded =
265
+ sk.commandFamily === parsed.commandFamily &&
266
+ sk.workingCmd !== parsed.canonical &&
267
+ sk.lastWorkingFailedSession === sessionId &&
268
+ typeof sk.lastWorkingFailedTurn === 'number' &&
269
+ turn - sk.lastWorkingFailedTurn >= 0 &&
270
+ turn - sk.lastWorkingFailedTurn <= 3;
271
+
272
+ if (failedCmdNowWorks || workingCmdSuperseded) {
273
+ evictedContradictions.push({ ...sk });
274
+ skills.splice(i, 1);
275
+ }
276
+ }
277
+
278
+ // Match most recent failure in the same commandFamily within <= 3 turns
279
+ const matchingFailure = [...sessionFailures]
280
+ .reverse()
281
+ .find(
282
+ (f) =>
283
+ f.commandFamily === parsed.commandFamily &&
284
+ f.failedCmd !== parsed.canonical &&
285
+ turn - Number(f.turn || 0) >= 0 &&
286
+ turn - Number(f.turn || 0) <= 3
287
+ );
288
+
289
+ if (!matchingFailure) {
290
+ return {
291
+ updated: evictedContradictions.length > 0,
292
+ rejectedReason: null,
293
+ promotedSkill: null,
294
+ capturedCandidate: null,
295
+ evictedContradictions,
296
+ registry: { schemaVersion: '1.0.0', skills, pendingFailuresBySession: pendingMap }
297
+ };
298
+ }
299
+
300
+ // Clear consumed failure from session pending list
301
+ pendingMap[sessionId] = sessionFailures.filter((f) => f !== matchingFailure);
302
+
303
+ let target = skills.find(
304
+ (s) => s.failedCmd === matchingFailure.failedCmd && s.commandFamily === parsed.commandFamily
305
+ );
306
+
307
+ if (!target) {
308
+ target = {
309
+ failedCmd: matchingFailure.failedCmd,
310
+ workingCmd: parsed.canonical,
311
+ commandFamily: parsed.commandFamily,
312
+ confirmedSessionIds: [sessionId],
313
+ confirmedSessions: 1,
314
+ promoted: 1 >= confirmSessions,
315
+ lastVerifiedAt: nowIso
316
+ };
317
+ skills.push(target);
318
+ } else if (target.workingCmd !== parsed.canonical) {
319
+ // Working command changed for this failedCmd -> reset confirmation to new workingCmd
320
+ target.workingCmd = parsed.canonical;
321
+ target.confirmedSessionIds = [sessionId];
322
+ target.confirmedSessions = 1;
323
+ target.promoted = 1 >= confirmSessions;
324
+ target.lastVerifiedAt = nowIso;
325
+ } else {
326
+ if (!target.confirmedSessionIds.includes(sessionId)) {
327
+ target.confirmedSessionIds.push(sessionId);
328
+ }
329
+ target.confirmedSessions = target.confirmedSessionIds.length;
330
+ target.promoted = target.confirmedSessions >= confirmSessions;
331
+ target.lastVerifiedAt = nowIso;
332
+ }
333
+
334
+ delete target.lastWorkingFailedSession;
335
+ delete target.lastWorkingFailedTurn;
336
+
337
+ return {
338
+ updated: true,
339
+ rejectedReason: null,
340
+ promotedSkill: target.promoted ? { ...target } : null,
341
+ capturedCandidate: { ...target },
342
+ evictedContradictions,
343
+ registry: { schemaVersion: '1.0.0', skills, pendingFailuresBySession: pendingMap }
344
+ };
345
+ }
346
+
347
+ /**
348
+ * Evaluates a `PreToolUse` shell command against promoted Repo Micro-Skills (`RSI-04`).
349
+ *
350
+ * @param {object} registry
351
+ * @param {object} params
352
+ * @param {string} params.command
353
+ * @param {string} [params.flightMode='COACH']
354
+ * @param {string} [params.overrideMode='default']
355
+ */
356
+ export function evaluateMicroSkillIntercept(registry = {}, {
357
+ command = '',
358
+ flightMode = 'COACH',
359
+ overrideMode = 'default'
360
+ } = {}) {
361
+ const normOverride = String(overrideMode || 'default').toLowerCase();
362
+ if (normOverride === 'off') {
363
+ return { triggered: false, detectorId: 'RSI-04', decision: 'allow' };
364
+ }
365
+
366
+ const parsed = canonicalizeMicroSkillCommand(command);
367
+ if (!parsed.valid) {
368
+ return { triggered: false, detectorId: 'RSI-04', decision: 'allow' };
369
+ }
370
+
371
+ const skills = Array.isArray(registry?.skills) ? registry.skills : [];
372
+ const match = skills.find(
373
+ (s) => s && s.promoted === true && s.failedCmd === parsed.canonical && s.workingCmd !== parsed.canonical
374
+ );
375
+
376
+ if (!match) {
377
+ return { triggered: false, detectorId: 'RSI-04', decision: 'allow' };
378
+ }
379
+
380
+ const fMode = String(flightMode || 'COACH').toUpperCase();
381
+ const shouldBlock =
382
+ normOverride === 'block' || (normOverride === 'default' && fMode === 'AUTO_PILOT');
383
+
384
+ const reason = `[RSI-04 Repo Micro-Skill] "${match.failedCmd}" previously failed in this repo; use verified command "${match.workingCmd}" instead.`;
385
+
386
+ return {
387
+ triggered: true,
388
+ detectorId: 'RSI-04',
389
+ slug: 'micro-skills',
390
+ subType: 'KNOWN_BROKEN_REPO_COMMAND',
391
+ failedCmd: match.failedCmd,
392
+ workingCmd: match.workingCmd,
393
+ commandFamily: match.commandFamily,
394
+ decision: shouldBlock ? 'deny' : 'allow',
395
+ reason,
396
+ hudAlert: reason
397
+ };
398
+ }
399
+
400
+ /**
401
+ * Formats promoted repo Micro-Skills into a compact `SessionStart` StateBaton line
402
+ * strictly capped under `<80` tokens (`<= 300` chars).
403
+ *
404
+ * @param {object} registry
405
+ * @returns {{ snippet: string, estimatedTokens: number, count: number }}
406
+ */
407
+ export function formatMicroSkillsBatonSnippet(registry = {}) {
408
+ const skills = Array.isArray(registry?.skills)
409
+ ? registry.skills.filter((s) => s && s.promoted === true && s.failedCmd && s.workingCmd)
410
+ : [];
411
+
412
+ if (skills.length === 0) {
413
+ return { snippet: '', estimatedTokens: 0, count: 0 };
414
+ }
415
+
416
+ const prefix = '[RSI-04 Verified Repo Commands] ';
417
+ const pairs = [];
418
+ let currentLen = prefix.length;
419
+ for (const sk of skills) {
420
+ const item = `"${sk.failedCmd}" -> "${sk.workingCmd}"`;
421
+ const sepLen = pairs.length > 0 ? 2 : 0;
422
+ if (currentLen + sepLen + item.length > MAX_MICRO_SKILL_BATON_CHARS) {
423
+ break;
424
+ }
425
+ pairs.push(item);
426
+ currentLen += sepLen + item.length;
427
+ }
428
+
429
+ if (pairs.length === 0) {
430
+ return { snippet: '', estimatedTokens: 0, count: 0 };
431
+ }
432
+
433
+ const snippet = `${prefix}${pairs.join('; ')}`;
434
+ const estimatedTokens = Math.ceil(snippet.length / 4);
435
+ return {
436
+ snippet,
437
+ estimatedTokens,
438
+ count: pairs.length
439
+ };
440
+ }
441
+
442
+ export function resolveMicroSkillsPath(options = {}) {
443
+ const cwd = getCwd(options);
444
+ return path.join(cwd, '.agents', 'state', 'micro_skills.json');
445
+ }
446
+
447
+ export function loadMicroSkillsRegistry(options = {}) {
448
+ const filePath = resolveMicroSkillsPath(options);
449
+ const parsed = readJsonSafe(filePath, null, options);
450
+ if (!parsed || typeof parsed !== 'object') {
451
+ return createEmptyMicroSkillsRegistry();
452
+ }
453
+ return {
454
+ schemaVersion: '1.0.0',
455
+ skills: Array.isArray(parsed.skills) ? parsed.skills : [],
456
+ pendingFailuresBySession:
457
+ parsed.pendingFailuresBySession && typeof parsed.pendingFailuresBySession === 'object'
458
+ ? parsed.pendingFailuresBySession
459
+ : {}
460
+ };
461
+ }
462
+
463
+ export function recordWorkspaceShellOutcome(event = {}, options = {}) {
464
+ const current = loadMicroSkillsRegistry(options);
465
+ const res = recordShellOutcomeInRegistry(current, event);
466
+ if (res.updated) {
467
+ const filePath = resolveMicroSkillsPath(options);
468
+ writeJsonAtomic(filePath, res.registry, options);
469
+ }
470
+ return res;
471
+ }