@iowarp/clio-coder 0.4.3 → 0.4.5

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 (670) hide show
  1. package/CHANGELOG.md +153 -0
  2. package/CONTRIBUTING.md +25 -15
  3. package/README.md +340 -27
  4. package/dist/{acp-H2NGRPWO.js → acp-H3CU2HBQ.js} +25 -25
  5. package/dist/{agents-TL5LLUQP.js → agents-IXQQZ7BD.js} +77 -75
  6. package/dist/assets/codewiki.json +1 -1
  7. package/dist/{auth-E5SW4HMS.js → auth-R7KYF7N3.js} +38 -39
  8. package/dist/builtins-CRFDQUVP.js +22 -0
  9. package/dist/{chunk-7DRAWPTZ.js → chunk-22PQ4TX4.js} +4 -4
  10. package/dist/{chunk-NEDJ26B5.js → chunk-2GPGAE5W.js} +6 -51
  11. package/dist/{chunk-IKCO5N3L.js → chunk-2QPI3TR3.js} +3 -3
  12. package/dist/{chunk-HRQMFLJP.js → chunk-32KJPXAM.js} +6 -6
  13. package/dist/{chunk-65DEGPJ6.js → chunk-3A3CUMKA.js} +6 -4
  14. package/dist/{chunk-5TSRNF4G.js → chunk-3T4DXWP6.js} +170 -12
  15. package/dist/{chunk-DR52UMZW.js → chunk-3UW3KU4A.js} +2 -2
  16. package/dist/{chunk-XIVNBFZS.js → chunk-4SVIVOMC.js} +208 -39
  17. package/dist/{chunk-NMJXSHBJ.js → chunk-5A6XR3RJ.js} +44 -19
  18. package/dist/{chunk-YPC6ZR5L.js → chunk-5CMARGPF.js} +119 -5
  19. package/dist/{chunk-KXDSS5WJ.js → chunk-5CY4Q6QI.js} +4 -4
  20. package/dist/chunk-5DDOTTG4.js +402 -0
  21. package/dist/{chunk-D4CJV46V.js → chunk-5GZICIYO.js} +3 -3
  22. package/dist/{chunk-4IUZQIJ3.js → chunk-5PHVPU4G.js} +2 -2
  23. package/dist/{chunk-PUVDKJ2Y.js → chunk-5VTJP36Q.js} +5 -7
  24. package/dist/{chunk-JGRC33J2.js → chunk-5ZMXGW7P.js} +90 -9
  25. package/dist/chunk-5ZSZEYJK.js +119 -0
  26. package/dist/chunk-633EXGZA.js +44 -0
  27. package/dist/{chunk-IWT4SF4R.js → chunk-6CDNRHWH.js} +361 -89
  28. package/dist/{chunk-EBY63B7G.js → chunk-6EXUUOSN.js} +2 -2
  29. package/dist/{chunk-SVNXH4L2.js → chunk-6ICZKDUC.js} +2 -2
  30. package/dist/{chunk-INY6HTFL.js → chunk-6SYEGZI3.js} +12 -12
  31. package/dist/{chunk-SKHCAU7K.js → chunk-6YA46L5A.js} +5 -4
  32. package/dist/{chunk-NZMNUPZZ.js → chunk-77CZRFTE.js} +3 -3
  33. package/dist/{chunk-L47TF46W.js → chunk-7HBHHVCK.js} +24 -3
  34. package/dist/{chunk-DWUOQKRU.js → chunk-7TKWWPD7.js} +5 -4
  35. package/dist/{chunk-2VTFPG5O.js → chunk-7WLRF2U5.js} +2 -2
  36. package/dist/chunk-7WUZEB2M.js +165 -0
  37. package/dist/{chunk-6PTFB5VS.js → chunk-7YJWEF2L.js} +59 -28
  38. package/dist/{chunk-3EBYEESD.js → chunk-A46ILRS2.js} +5 -5
  39. package/dist/{chunk-UOIZ7DA4.js → chunk-AP7HDJOP.js} +2 -2
  40. package/dist/{chunk-APJ265NV.js → chunk-B5GGDIHT.js} +146 -146
  41. package/dist/{chunk-PMZVFWSR.js → chunk-B5ZTR6KZ.js} +2 -2
  42. package/dist/chunk-B6UM3OZC.js +15 -0
  43. package/dist/{chunk-MCEPRMZW.js → chunk-BBV5TKE6.js} +5 -5
  44. package/dist/{chunk-4O6MANBS.js → chunk-BS4GAMUB.js} +14 -10
  45. package/dist/{chunk-S66XZJOF.js → chunk-C27U2TYG.js} +2 -2
  46. package/dist/{chunk-42FMPA75.js → chunk-CBSKDFWL.js} +3 -3
  47. package/dist/{chunk-2LEAKD4C.js → chunk-CKK25WN3.js} +3 -3
  48. package/dist/{chunk-BYP5D4HI.js → chunk-CTTI7G3T.js} +2 -2
  49. package/dist/{chunk-XAKHZX5N.js → chunk-CVDAFGPW.js} +4 -4
  50. package/dist/{chunk-RKKLTLYB.js → chunk-CXQ37WJH.js} +3 -3
  51. package/dist/{chunk-GTUD2WMY.js → chunk-DBREN25X.js} +44 -9
  52. package/dist/{chunk-WCXUNS7U.js → chunk-DIMRLNIC.js} +35 -66
  53. package/dist/{chunk-NDDGJUXD.js → chunk-DNCE23JJ.js} +2 -2
  54. package/dist/{chunk-HVDIIIQW.js → chunk-DNHVRBH4.js} +3 -3
  55. package/dist/{chunk-2UG5F4C5.js → chunk-DRD2A54W.js} +116 -52
  56. package/dist/{chunk-D7E7WCDF.js → chunk-DVNAPPXU.js} +2 -2
  57. package/dist/{chunk-YXLYO42X.js → chunk-DXVMLM3Z.js} +3 -2
  58. package/dist/{chunk-5MEZN6CB.js → chunk-DZK63TZJ.js} +6 -6
  59. package/dist/{chunk-IGLP3ODT.js → chunk-E3BQTQUP.js} +15 -15
  60. package/dist/{chunk-IWHMRKLL.js → chunk-E3LEPLQ2.js} +2 -2
  61. package/dist/{chunk-3R73A4XB.js → chunk-ECBHH7LU.js} +3 -3
  62. package/dist/chunk-ECOMVOHP.js +139 -0
  63. package/dist/chunk-EFSEIZE6.js +56 -0
  64. package/dist/{chunk-IJNZMHLA.js → chunk-EHCPSZJF.js} +4 -4
  65. package/dist/{chunk-K6BSR66V.js → chunk-EHOSNVVM.js} +6 -2
  66. package/dist/{chunk-RRNP2ANY.js → chunk-EQEJJ53P.js} +10 -10
  67. package/dist/{chunk-GWZNEVM2.js → chunk-EWD5P3GK.js} +9 -9
  68. package/dist/{chunk-JKKCYP3C.js → chunk-F34AR6O3.js} +21 -15
  69. package/dist/{chunk-GHS5EBTQ.js → chunk-FKIOX6DS.js} +29 -20
  70. package/dist/{chunk-HAXOFFRH.js → chunk-FQOOGXBH.js} +7 -7
  71. package/dist/{chunk-MWUZBSAQ.js → chunk-FSTIBAGM.js} +358 -63
  72. package/dist/{chunk-ZTJUVLTU.js → chunk-FXFVDPWY.js} +2 -2
  73. package/dist/{chunk-XPLRXC72.js → chunk-GD55RTIW.js} +3 -3
  74. package/dist/{chunk-5B2AEOW5.js → chunk-GH5ZR6JP.js} +472 -472
  75. package/dist/{chunk-JSC3U7TI.js → chunk-GJ24ODAX.js} +5 -5
  76. package/dist/{chunk-B4VEBZKF.js → chunk-GNQRWTMY.js} +139 -52
  77. package/dist/{chunk-5ICU3EUH.js → chunk-GVYWZNRK.js} +5 -5
  78. package/dist/chunk-GXCCHKN6.js +59 -0
  79. package/dist/{chunk-V2ANDPVT.js → chunk-HGSLRG33.js} +170 -8
  80. package/dist/{chunk-LLDJM5XK.js → chunk-HHVJNVUJ.js} +6 -6
  81. package/dist/{chunk-F4EKGO4N.js → chunk-HL26ADLH.js} +4 -2
  82. package/dist/{chunk-VA5FNYMT.js → chunk-HR3HPQ76.js} +42 -5
  83. package/dist/{chunk-ID64D7PE.js → chunk-HXHFDHB6.js} +24 -24
  84. package/dist/{chunk-OML5D5V5.js → chunk-I7VLWRK2.js} +8 -8
  85. package/dist/{chunk-VW6DOEDG.js → chunk-ICO4TQ2F.js} +16 -5
  86. package/dist/{chunk-SZAA6XDG.js → chunk-IFDRAD6F.js} +2 -2
  87. package/dist/{chunk-WBKFA554.js → chunk-ILJ7DWGE.js} +9 -9
  88. package/dist/{chunk-2JH2WHGE.js → chunk-J2FYEQ5L.js} +4 -4
  89. package/dist/{chunk-BMS5RKQY.js → chunk-JABWPKFY.js} +3 -3
  90. package/dist/{chunk-QDC3K2U3.js → chunk-K2BLQC5E.js} +3 -3
  91. package/dist/{chunk-EKCHAPYA.js → chunk-K2HL3GBL.js} +4 -4
  92. package/dist/{chunk-N2Z7HLVY.js → chunk-K6RDB7IA.js} +28 -28
  93. package/dist/{chunk-TM6LQDI3.js → chunk-KDWLXVMN.js} +85 -335
  94. package/dist/{chunk-OZNBF4L3.js → chunk-KECNXMDE.js} +2 -2
  95. package/dist/{chunk-RSJ25QSL.js → chunk-KF6GFW6O.js} +217 -50
  96. package/dist/{chunk-BTK3SSSK.js → chunk-KMF54VH3.js} +2 -2
  97. package/dist/chunk-KPRLAMP4.js +32 -0
  98. package/dist/{chunk-ECH6PKUQ.js → chunk-KQ6IDQIB.js} +2 -2
  99. package/dist/{chunk-IUE3Y34X.js → chunk-KTFSFCVN.js} +20 -9
  100. package/dist/{chunk-7E7I3WLS.js → chunk-KYKNBD4Y.js} +36 -34
  101. package/dist/chunk-L4N3DWNW.js +539 -0
  102. package/dist/{chunk-LCGCVYZ4.js → chunk-LQTKDAUO.js} +2 -2
  103. package/dist/{chunk-JIEGK6UF.js → chunk-LTR5QCLS.js} +51 -7
  104. package/dist/chunk-LUL5Z66S.js +221 -0
  105. package/dist/chunk-LVFANMOH.js +466 -0
  106. package/dist/{chunk-H7IXIC72.js → chunk-LY4N4TTL.js} +17 -3
  107. package/dist/{chunk-VKPAQYEB.js → chunk-LZBMXNLP.js} +5 -5
  108. package/dist/{chunk-UL3WSD3F.js → chunk-M4KFUXS7.js} +2 -2
  109. package/dist/{chunk-I7ZPNEJM.js → chunk-M6TAYK66.js} +8 -8
  110. package/dist/{chunk-NEKRRTYW.js → chunk-MC3JSVR6.js} +2 -2
  111. package/dist/{chunk-CFGTUFWB.js → chunk-MCJKEGHO.js} +2 -2
  112. package/dist/chunk-MDU3C27C.js +674 -0
  113. package/dist/{chunk-6XLNIQDB.js → chunk-MYI32N4R.js} +2 -2
  114. package/dist/{chunk-4UVU7BJ5.js → chunk-NC4KV7EL.js} +6 -6
  115. package/dist/{chunk-JEQ3XTHC.js → chunk-NF3BK5WR.js} +5 -5
  116. package/dist/chunk-NTK3WTHM.js +141 -0
  117. package/dist/{chunk-GYV6VZOC.js → chunk-NTTS3O53.js} +2 -2
  118. package/dist/{chunk-UPZU6GE4.js → chunk-NY6IWDVU.js} +6 -6
  119. package/dist/chunk-O2RQ7LCK.js +283 -0
  120. package/dist/{chunk-4BJ5BYCE.js → chunk-O3VV6IVK.js} +2 -2
  121. package/dist/{chunk-W6GROXXM.js → chunk-O5F25NIE.js} +2 -2
  122. package/dist/{chunk-WRBAGUNF.js → chunk-ODUTYZIU.js} +5 -5
  123. package/dist/{chunk-E3TPLWFX.js → chunk-ONRTXOZY.js} +4 -4
  124. package/dist/{chunk-B4OAX3SI.js → chunk-OQM5IVJY.js} +118 -225
  125. package/dist/{chunk-XRZT5WY5.js → chunk-P5SC4DLJ.js} +4 -4
  126. package/dist/{chunk-R6Q67RJH.js → chunk-PECBKCDK.js} +34 -6
  127. package/dist/{chunk-33YXPOE3.js → chunk-PPEZJWUG.js} +2 -2
  128. package/dist/{chunk-64I3JVYM.js → chunk-PWWSIB2A.js} +5 -5
  129. package/dist/{chunk-2STGEDFV.js → chunk-QEQISF75.js} +2 -2
  130. package/dist/{chunk-3DPEIQKN.js → chunk-QH3ZTUOA.js} +2 -2
  131. package/dist/{chunk-YAKGTXEV.js → chunk-QRFXEO6Y.js} +2 -2
  132. package/dist/{chunk-35MSIRKH.js → chunk-QUIJZSDW.js} +2 -2
  133. package/dist/{chunk-HHV2GANA.js → chunk-R2P2U3ZS.js} +2 -2
  134. package/dist/chunk-R6MAYTMS.js +108 -0
  135. package/dist/{chunk-MUW2BDDH.js → chunk-R6MICQYU.js} +6 -6
  136. package/dist/{chunk-JDAY6FIL.js → chunk-RLTT5GVY.js} +132 -17
  137. package/dist/{chunk-ZWPRK62N.js → chunk-RXIOCVBZ.js} +24 -6
  138. package/dist/{chunk-NIQJ66N4.js → chunk-S32UQ5GL.js} +62 -35
  139. package/dist/{chunk-AX2THNSA.js → chunk-SBZX6ARC.js} +12 -12
  140. package/dist/{chunk-TXOTCRLG.js → chunk-SD7SHNDW.js} +2 -2
  141. package/dist/{chunk-AF4YM7Z4.js → chunk-SDWNDICN.js} +10284 -3756
  142. package/dist/{chunk-UXCU4E3T.js → chunk-SE4ZKILO.js} +6 -6
  143. package/dist/chunk-SL2RDHKO.js +19 -0
  144. package/dist/{chunk-NUGM5KR6.js → chunk-SRCEQKQS.js} +2 -2
  145. package/dist/{chunk-KKOJXO6R.js → chunk-SRZOW5L2.js} +46 -14
  146. package/dist/{chunk-3M6DQK6S.js → chunk-T334FW2H.js} +7 -7
  147. package/dist/chunk-T52TPHYC.js +318 -0
  148. package/dist/{chunk-I7XBWTYH.js → chunk-T53XI6I7.js} +5 -5
  149. package/dist/{chunk-LDJG7DW3.js → chunk-T7FDXNRU.js} +13 -13
  150. package/dist/{chunk-XPWWI35G.js → chunk-TEG3RYVZ.js} +59 -41
  151. package/dist/{chunk-3I7MS7N2.js → chunk-TK2BMCBZ.js} +2 -2
  152. package/dist/{chunk-5OIVVPHF.js → chunk-TN5FW4XY.js} +13 -6
  153. package/dist/{chunk-PAJQJ7BS.js → chunk-TZ7MFRG4.js} +1263 -835
  154. package/dist/{chunk-GI7YYQ3F.js → chunk-U2JOLB7O.js} +415 -83
  155. package/dist/{chunk-LL4KHSZI.js → chunk-U2MSJ57E.js} +2 -2
  156. package/dist/{chunk-FTMGRKEF.js → chunk-U44YYLVV.js} +4 -4
  157. package/dist/{chunk-CE5AX47J.js → chunk-U7H5WRG5.js} +5 -5
  158. package/dist/{chunk-G76U63X4.js → chunk-U7VQ4NI4.js} +22 -22
  159. package/dist/{chunk-7ZYNNDKC.js → chunk-UFYNOQK4.js} +7 -7
  160. package/dist/{chunk-R346GLFC.js → chunk-UHW5V7HC.js} +2 -2
  161. package/dist/{chunk-QWGDJJYJ.js → chunk-UL36QJX6.js} +14 -14
  162. package/dist/{chunk-VIA6RFQZ.js → chunk-UQIVHSE4.js} +4 -4
  163. package/dist/{chunk-HEQY7ZFI.js → chunk-URBGEOH3.js} +5 -5
  164. package/dist/chunk-USZA7GWL.js +341 -0
  165. package/dist/{chunk-W6RRQCPQ.js → chunk-UTUNT5QL.js} +48 -579
  166. package/dist/{chunk-ZA4VCIGV.js → chunk-UUQ5G6EZ.js} +60 -41
  167. package/dist/{chunk-F5JHEYZM.js → chunk-UXAC2FX4.js} +73 -41
  168. package/dist/{chunk-VG7TBQIY.js → chunk-V552WL53.js} +68 -4
  169. package/dist/{chunk-BWH6N36D.js → chunk-VHKTOLEW.js} +272 -42
  170. package/dist/chunk-VLPTKCKT.js +396 -0
  171. package/dist/{chunk-336NSSKI.js → chunk-VNBICSS2.js} +2 -2
  172. package/dist/{chunk-VAVR4IJY.js → chunk-VQD7NH7Z.js} +3 -3
  173. package/dist/{chunk-LBMZMYH2.js → chunk-W2RJEH6Q.js} +3 -3
  174. package/dist/{chunk-7CR24IG7.js → chunk-WDV62RKY.js} +2 -2
  175. package/dist/{chunk-2UH2KFUP.js → chunk-WFKDPU7U.js} +4 -4
  176. package/dist/{chunk-ZDN3Y73Y.js → chunk-WJIMKGD6.js} +9 -51
  177. package/dist/{chunk-YQWYVTMC.js → chunk-WLMSOT73.js} +59 -12
  178. package/dist/{chunk-MXHC5QYU.js → chunk-WTQGRBHV.js} +5 -144
  179. package/dist/chunk-WXA2CFJO.js +23 -0
  180. package/dist/{chunk-QSNYB6ZV.js → chunk-XCUDZQLX.js} +3 -3
  181. package/dist/{chunk-2APPQIER.js → chunk-XXBQKW32.js} +11 -11
  182. package/dist/{chunk-2VIKGWFZ.js → chunk-YEJIG7LN.js} +332 -332
  183. package/dist/chunk-YGDMBK7O.js +567 -0
  184. package/dist/{chunk-4WR7VSYB.js → chunk-YYB3MC65.js} +23 -9
  185. package/dist/{chunk-2IR2NMPA.js → chunk-ZIDFQJRB.js} +2 -2
  186. package/dist/{chunk-54CBCGIR.js → chunk-ZMZQEBKI.js} +136 -81
  187. package/dist/{chunk-6EJMN2Y3.js → chunk-ZTNFYMIO.js} +2 -2
  188. package/dist/{chunk-WEPFGWHJ.js → chunk-ZZFWWYLX.js} +2 -2
  189. package/dist/cli/index.js +45 -44
  190. package/dist/clio-5I2IBFYL.js +26 -0
  191. package/dist/{code-nav-MDZNQS33.js → code-nav-YXIAEZVS.js} +48 -32
  192. package/dist/codewiki/build-worker.js +76 -29
  193. package/dist/{compile-cache-OQAVB7Y5.js → compile-cache-WJEPUZEJ.js} +4 -4
  194. package/dist/{components-UCUQ4QXW.js → components-TNIKXCBH.js} +13 -14
  195. package/dist/{config-SVM5P5YI.js → config-Y2JDJ3JJ.js} +210 -119
  196. package/dist/configure-SML6UBZ5.js +55 -0
  197. package/dist/{context-2OHRKS42.js → context-P5YSEO55.js} +125 -115
  198. package/dist/{context-VNCR7KAG.js → context-QQ53HSGJ.js} +91 -62
  199. package/dist/{context-E3VC7RX5.js → context-S2EEC3EJ.js} +62 -31
  200. package/dist/context-clear-TMEQCOTH.js +183 -0
  201. package/dist/{context-index-HNG3MOME.js → context-index-HP2JFUWA.js} +13 -11
  202. package/dist/{context-map-COB37XXN.js → context-map-INTXD54D.js} +71 -21
  203. package/dist/{context-working-set-VDS25HXZ.js → context-working-set-CNLSQN5K.js} +31 -31
  204. package/dist/detail-5572VLBO.js +114 -0
  205. package/dist/{dispatch-runner-5AHT53RF.js → dispatch-runner-FRHD6P2O.js} +214 -126
  206. package/dist/{docs-PD3EXDKU.js → docs-BL7ROUFN.js} +5 -7
  207. package/dist/{doctor-WNNVO6FY.js → doctor-N3LCM2LG.js} +89 -66
  208. package/dist/{eval-7G7SGAYO.js → eval-BUU3ZOUZ.js} +493 -197
  209. package/dist/{eval-inventory-Y6QRFOH5.js → eval-inventory-QOYZERXJ.js} +7 -7
  210. package/dist/evidence-DTGEN456.js +224 -0
  211. package/dist/{evidence-VD6736FQ.js → evidence-SQ5DNFEN.js} +114 -195
  212. package/dist/{evolve-AL3NGVRL.js → evolve-IJNUFZDS.js} +107 -88
  213. package/dist/{extensions-MOVJ32NM.js → extensions-YVRHX6ZI.js} +16 -17
  214. package/dist/{fleet-QZHUMAGI.js → fleet-ZNNVSYFO.js} +147 -141
  215. package/dist/{fleet-commands-BAYT5FJZ.js → fleet-commands-5YE7NPJL.js} +27 -23
  216. package/dist/{fleet-decisions-IREVMRU4.js → fleet-decisions-3SBSCTCW.js} +16 -15
  217. package/dist/{fleet-graph-YCTT3HTI.js → fleet-graph-6HHPWF5T.js} +39 -38
  218. package/dist/{fleet-inspect-QVJTDAVB.js → fleet-inspect-JEYMGCGC.js} +107 -87
  219. package/dist/{fleet-new-RDVJLHHH.js → fleet-new-RCKGSRDV.js} +3 -3
  220. package/dist/{fleet-preflight-25QAFPK4.js → fleet-preflight-QRSHIIDE.js} +10 -10
  221. package/dist/{fleet-validate-5O57AAJ7.js → fleet-validate-4PM4GDDL.js} +46 -42
  222. package/dist/{fleet-verify-CPH2W2T6.js → fleet-verify-NJDTHTO3.js} +105 -85
  223. package/dist/fleet-view-UP2BWQQY.js +117 -0
  224. package/dist/{init-J477LKZH.js → init-S3GZQ5ZF.js} +123 -117
  225. package/dist/{install-NKNG7KD4.js → install-3RZDDP23.js} +5 -5
  226. package/dist/{interop-3FCM6XLG.js → interop-YOTGXFJM.js} +25 -26
  227. package/dist/inventory-K2OZ36YJ.js +117 -0
  228. package/dist/{library-QUQEIUG6.js → library-GJI6W6OK.js} +45 -45
  229. package/dist/{memory-SGGSEP65.js → memory-OQOXQGYD.js} +107 -90
  230. package/dist/{models-HEKUAXXK.js → models-3IK2Y5WE.js} +64 -65
  231. package/dist/{monitor-HKU57TYQ.js → monitor-FTJLTKCQ.js} +136 -101
  232. package/dist/{orchestrator-VDFAEFAI.js → orchestrator-N47O7SFD.js} +1442 -1671
  233. package/dist/{panes-DN2SSFOH.js → panes-7BTYH3XQ.js} +8 -8
  234. package/dist/{panes-TALGNPZT.js → panes-WPOMEMRH.js} +22 -23
  235. package/dist/{paths-NBMFAIEZ.js → paths-J3KN7UAO.js} +12 -13
  236. package/dist/preload-65U34NG6.js +115 -0
  237. package/dist/{registry-LG64LTF4.js → registry-DESGAXWK.js} +3 -3
  238. package/dist/{reset-EAJFFJVB.js → reset-MUVQDLNL.js} +20 -21
  239. package/dist/{resources-OVKSEFVE.js → resources-LM76COAO.js} +41 -40
  240. package/dist/{run-7DP7ZF2J.js → run-3VFZQ33N.js} +168 -166
  241. package/dist/{share-WML67FT3.js → share-4JUB4BL7.js} +43 -43
  242. package/dist/{skills-SG662R2K.js → skills-S36AAJHU.js} +47 -47
  243. package/dist/{skills-eval-VVZEUU46.js → skills-eval-G6T57L7M.js} +127 -104
  244. package/dist/{skills-inventory-I2E23GET.js → skills-inventory-WLM46PJH.js} +41 -40
  245. package/dist/slash-commands-GBARG3Y7.js +91 -0
  246. package/dist/{steer-2LQOMCPB.js → steer-S7D7IKPU.js} +7 -7
  247. package/dist/{support-CC2UJBJ6.js → support-5VAEC32W.js} +14 -14
  248. package/dist/{targets-4QC3HIEW.js → targets-N5REUETU.js} +147 -98
  249. package/dist/tasks-6BVY5YZF.js +36 -0
  250. package/dist/{terminal-lease-TUHIJ6Y2.js → terminal-lease-57UEOJKS.js} +12 -11
  251. package/dist/tools-6OCQ6SVB.js +28 -0
  252. package/dist/{trace-FXMXUZUF.js → trace-JHLXWUMN.js} +18 -17
  253. package/dist/{tree-sitter-HGKH6LG4.js → tree-sitter-AQUUOSYM.js} +6 -6
  254. package/dist/{tui-primitives-K5PASC3O.js → tui-primitives-RCY2HN7G.js} +3 -3
  255. package/dist/{uninstall-5PEVOE5B.js → uninstall-FXYMFFRT.js} +19 -20
  256. package/dist/{upgrade-M4WXY6KN.js → upgrade-4HD5HAIV.js} +49 -45
  257. package/dist/{usage-N7ZNVLEM.js → usage-4GWM2WWP.js} +143 -103
  258. package/dist/{verifiers-DJTP4XX6.js → verifiers-GSKWKWVG.js} +162 -28
  259. package/dist/verify-3AS3ULCY.js +30 -0
  260. package/dist/{version-KGEG7EPO.js → version-RFPKO6T7.js} +4 -4
  261. package/dist/{web-fetch-MPARV2K7.js → web-fetch-MQN4FH3X.js} +169 -18
  262. package/dist/wiki-generate-7BV7XWIY.js +614 -0
  263. package/dist/{with-panes-4GCGSL7J.js → with-panes-OFTNAR4Y.js} +34 -20
  264. package/dist/worker/entry.js +99 -85
  265. package/dist/{workspace-ZJ6BFM3Q.js → workspace-DZ7JADBG.js} +6 -6
  266. package/docs/README.md +10 -8
  267. package/docs/architecture/acp.md +27 -0
  268. package/docs/architecture/architecture.md +5 -5
  269. package/docs/architecture/artifact-versions.md +1 -1
  270. package/docs/architecture/context-engine.md +44 -59
  271. package/docs/architecture/context-working-set.md +7 -9
  272. package/docs/architecture/dispatch-architecture-rationale.md +1 -1
  273. package/docs/architecture/dispatch-typed-intent.md +1 -1
  274. package/docs/architecture/evidence-and-memory.md +11 -1
  275. package/docs/architecture/observability.md +7 -1
  276. package/docs/architecture/pi-boundary.md +37 -7
  277. package/docs/architecture/prompt-envelope-and-tools.md +22 -12
  278. package/docs/architecture/safety-model.md +10 -17
  279. package/docs/architecture/session-lifecycle.md +4 -4
  280. package/docs/architecture/tui-design.md +1 -1
  281. package/docs/architecture/worker-dispatch-mechanics.md +4 -0
  282. package/docs/guide/built-in-agents.md +8 -8
  283. package/docs/guide/commands-and-modes.md +66 -38
  284. package/docs/guide/configuration-and-targets.md +10 -3
  285. package/docs/guide/configuration-reference.md +23 -8
  286. package/docs/guide/environment-variables.md +8 -4
  287. package/docs/guide/fleet-dispatch.md +12 -0
  288. package/docs/guide/installation-and-lifecycle.md +35 -9
  289. package/docs/guide/proactive-memory.md +1 -1
  290. package/docs/guide/skills-marketplace.md +11 -3
  291. package/docs/guide/tool-usage.md +87 -5
  292. package/docs/history/config-knobs-audit.md +2 -2
  293. package/docs/process/development-pipeline.md +15 -10
  294. package/docs/process/documentation-guide.md +2 -2
  295. package/docs/process/eval-runner.md +15 -0
  296. package/docs/process/evals-internal.md +1 -1
  297. package/docs/process/git-commit-provenance.md +15 -0
  298. package/docs/process/release-cut-checklist.md +207 -0
  299. package/docs/process/scientific-validation.md +18 -17
  300. package/evals/README.md +4 -0
  301. package/evals/behavioral-corpus-grader.mjs +147 -14
  302. package/evals/behavioral-machinery-support.ts +1 -0
  303. package/evals/behavioral-machinery.yaml +1 -1
  304. package/evals/behavioral-model-negative-control.yaml +1 -0
  305. package/evals/behavioral-model.yaml +266 -1
  306. package/evals/fixtures/docs-retrieval.json +102 -0
  307. package/evals/fixtures/scalar-decision.json +17 -0
  308. package/evals/fixtures/scout-citation-pipeline.json +55 -0
  309. package/evals/fixtures/source-explanation.json +74 -0
  310. package/evals/fixtures/tool-arguments.json +18 -0
  311. package/evals/fixtures/tool-surface/read.txt +4 -0
  312. package/evals/fixtures/tool-surface/subdir/keep.txt +1 -0
  313. package/evals/no-edit-memory-grader.mjs +149 -0
  314. package/evals/scalar-decision-grader.py +41 -0
  315. package/evals/scalar-decision-machinery.ts +145 -0
  316. package/evals/source-explanation-grader.mjs +118 -0
  317. package/evals/tool-surface-grader.mjs +53 -0
  318. package/evals/tool-surface-model.yaml +274 -0
  319. package/package.json +14 -14
  320. package/skills/README.md +6 -6
  321. package/skills/coding/coding-standards/SKILL.md +14 -4
  322. package/skills/context/context-handoff/SKILL.md +3 -3
  323. package/skills/context/context-prime/SKILL.md +3 -3
  324. package/skills/planning/architecture/SKILL.md +5 -5
  325. package/skills/planning/backlog/SKILL.md +4 -4
  326. package/skills/planning/prd/SKILL.md +4 -3
  327. package/skills/planning/product-intent/SKILL.md +8 -8
  328. package/skills/planning/tech-spec/SKILL.md +4 -4
  329. package/skills/registry.yaml +33 -33
  330. package/skills/research/arxiv-literature/SKILL.md +3 -3
  331. package/skills/research/experiment-protocol/SKILL.md +3 -3
  332. package/skills/research/scientific-debugging/SKILL.md +3 -2
  333. package/skills/research/scientific-modernization/SKILL.md +3 -3
  334. package/skills/skill-marketplace.json +17 -17
  335. package/skills/workflow/cut-it/SKILL.md +3 -4
  336. package/skills/workflow/design-council/SKILL.md +5 -10
  337. package/skills/workflow/grill-me/SKILL.md +14 -15
  338. package/skills/workflow/workflow-distiller/SKILL.md +4 -4
  339. package/src/cli/args.ts +0 -8
  340. package/src/cli/bootstrap-generate.ts +6 -0
  341. package/src/cli/config-inspect.ts +24 -7
  342. package/src/cli/config-trust.ts +62 -0
  343. package/src/cli/config.ts +8 -0
  344. package/src/cli/configure.ts +2 -1
  345. package/src/cli/context-map.ts +75 -14
  346. package/src/cli/context.ts +46 -17
  347. package/src/cli/doctor-state-size.ts +1 -12
  348. package/src/cli/doctor-validation-contract.ts +28 -0
  349. package/src/cli/doctor.ts +5 -0
  350. package/src/cli/eval.ts +17 -3
  351. package/src/cli/evidence-detail.ts +1 -75
  352. package/src/cli/evidence-inventory.ts +1 -167
  353. package/src/cli/index.ts +2 -0
  354. package/src/cli/modes/print.ts +32 -4
  355. package/src/cli/run.ts +16 -16
  356. package/src/cli/skills-eval.ts +10 -8
  357. package/src/cli/steer-channel.ts +31 -18
  358. package/src/cli/targets.ts +84 -32
  359. package/src/cli/tasks.ts +93 -0
  360. package/src/cli/upgrade.ts +19 -11
  361. package/src/cli/usage.ts +30 -0
  362. package/src/cli/verifiers.ts +147 -1
  363. package/src/cli/wiki-generate.ts +240 -96
  364. package/src/core/bash-exec.ts +43 -15
  365. package/src/core/bus-events.ts +15 -0
  366. package/src/core/commit-attribution.ts +41 -1
  367. package/src/core/config.ts +33 -14
  368. package/src/core/defaults.ts +5 -4
  369. package/src/core/file-references.ts +11 -1
  370. package/src/core/git-commit-attribution.ts +46 -3
  371. package/src/core/incomplete-installation.ts +3 -1
  372. package/src/core/run-overrides.ts +0 -5
  373. package/src/core/settings-layers.ts +21 -5
  374. package/src/core/skill-activation.ts +3 -0
  375. package/src/core/termination.ts +26 -9
  376. package/src/core/tool-names.ts +5 -2
  377. package/src/core/untrusted-content.ts +16 -0
  378. package/src/core/workspace-trust.ts +179 -0
  379. package/src/domains/agents/builtins/architect.md +1 -1
  380. package/src/domains/agents/builtins/coder.md +5 -3
  381. package/src/domains/agents/builtins/context-bootstrap.md +3 -1
  382. package/src/domains/agents/builtins/documenter.md +8 -5
  383. package/src/domains/agents/builtins/git-master.md +1 -1
  384. package/src/domains/agents/builtins/provenance.md +7 -7
  385. package/src/domains/agents/builtins/researcher.md +1 -0
  386. package/src/domains/agents/builtins/scout.md +7 -1
  387. package/src/domains/agents/builtins/tester.md +1 -1
  388. package/src/domains/agents/builtins/verifier.md +2 -2
  389. package/src/domains/agents/builtins/wiki-writer.md +4 -3
  390. package/src/domains/agents/result-contract.ts +199 -26
  391. package/src/domains/context/bootstrap-prompt.ts +11 -9
  392. package/src/domains/context/bootstrap.ts +74 -39
  393. package/src/domains/context/clio-md.ts +88 -26
  394. package/src/domains/context/codewiki/build-operation.ts +121 -0
  395. package/src/domains/context/codewiki/build-worker-protocol.ts +37 -3
  396. package/src/domains/context/codewiki/build-worker.ts +3 -35
  397. package/src/domains/context/codewiki/coordinator.ts +36 -6
  398. package/src/domains/context/codewiki/indexer.ts +59 -19
  399. package/src/domains/context/contract.ts +6 -2
  400. package/src/domains/context/extension.ts +97 -11
  401. package/src/domains/context/fingerprint.ts +39 -34
  402. package/src/domains/context/index.ts +7 -1
  403. package/src/domains/context/prompt-context.ts +55 -14
  404. package/src/domains/context/refresh.ts +12 -57
  405. package/src/domains/context/wiki/assemble.ts +14 -10
  406. package/src/domains/context/wiki/evidence.ts +209 -0
  407. package/src/domains/context/wiki/frontmatter.ts +5 -2
  408. package/src/domains/context/wiki/generate.ts +207 -67
  409. package/src/domains/context/wiki/meta.ts +10 -2
  410. package/src/domains/context/wiki/plan-store.ts +70 -14
  411. package/src/domains/context/wiki/plan.ts +71 -14
  412. package/src/domains/context/wiki/prompts.ts +85 -1
  413. package/src/domains/context/wiki/source-content.ts +106 -0
  414. package/src/domains/context/wiki/staleness.ts +33 -22
  415. package/src/domains/context/working-set/contract.ts +8 -2
  416. package/src/domains/context/working-set/engine.ts +17 -4
  417. package/src/domains/context/working-set/fold.ts +15 -2
  418. package/src/domains/context/working-set/marker.ts +2 -1
  419. package/src/domains/context/working-set/project.ts +18 -7
  420. package/src/domains/context/working-set/recall.ts +82 -56
  421. package/src/domains/dispatch/active-route-planner.ts +10 -3
  422. package/src/domains/dispatch/admission-queue.ts +19 -7
  423. package/src/domains/dispatch/admission.ts +3 -3
  424. package/src/domains/dispatch/budget-envelope.ts +47 -82
  425. package/src/domains/dispatch/capacity-lease.ts +57 -19
  426. package/src/domains/dispatch/code-step.ts +11 -4
  427. package/src/domains/dispatch/contract.ts +41 -9
  428. package/src/domains/dispatch/event-pump.ts +28 -7
  429. package/src/domains/dispatch/execution-role.ts +49 -2
  430. package/src/domains/dispatch/execution-scheduler.ts +4 -0
  431. package/src/domains/dispatch/extension.ts +240 -132
  432. package/src/domains/dispatch/fleet-commit-attribution.ts +5 -0
  433. package/src/domains/dispatch/fleet-run.ts +21 -0
  434. package/src/domains/dispatch/gate-role-prompts.ts +4 -2
  435. package/src/domains/dispatch/host-verification.ts +114 -13
  436. package/src/domains/dispatch/intent.ts +28 -18
  437. package/src/domains/dispatch/orphan-recovery.ts +2 -0
  438. package/src/domains/dispatch/parallel-writers.ts +34 -0
  439. package/src/domains/dispatch/receipt-integrity.ts +4 -0
  440. package/src/domains/dispatch/reservation-store.ts +13 -37
  441. package/src/domains/dispatch/route-approval.ts +3 -3
  442. package/src/domains/dispatch/route-observer.ts +4 -2
  443. package/src/domains/dispatch/route-quality.ts +6 -1
  444. package/src/domains/dispatch/state.ts +15 -2
  445. package/src/domains/dispatch/types.ts +21 -5
  446. package/src/domains/dispatch/worker-spawn.ts +58 -21
  447. package/src/domains/dispatch/workspace-checkpoint.ts +57 -0
  448. package/src/domains/eval/compare/behavioral.ts +81 -14
  449. package/src/domains/eval/compare/compare.ts +15 -5
  450. package/src/domains/eval/compare/envelope.ts +12 -5
  451. package/src/domains/eval/metrics/context.ts +24 -1
  452. package/src/domains/eval/metrics/tracked.ts +4 -28
  453. package/src/domains/eval/reports/comparison.ts +9 -9
  454. package/src/domains/eval/runners/clio-run.ts +17 -10
  455. package/src/domains/eval/runners/context-index.ts +2 -7
  456. package/src/domains/eval/runners/context-init.ts +3 -6
  457. package/src/domains/eval/runners/external-command.ts +29 -11
  458. package/src/domains/eval/schema/suite.ts +2 -0
  459. package/src/domains/eval/schema/validate.ts +1 -0
  460. package/src/domains/eval/suites/run.ts +189 -13
  461. package/src/domains/eval/verifiers/integrity.ts +39 -0
  462. package/src/domains/eval/verifiers/patch.ts +58 -2
  463. package/src/domains/eval/workspaces/temp-copy.ts +3 -0
  464. package/src/domains/evidence/build.ts +106 -17
  465. package/src/domains/evidence/detail.ts +69 -0
  466. package/src/domains/evidence/eval.ts +13 -1
  467. package/src/domains/evidence/finish-contract-map.ts +5 -1
  468. package/src/domains/evidence/inventory.ts +167 -0
  469. package/src/domains/evidence/store.ts +16 -0
  470. package/src/domains/evidence/types.ts +12 -0
  471. package/src/domains/extensions/resources.ts +7 -0
  472. package/src/domains/interop/registry.ts +2 -2
  473. package/src/domains/middleware/hooks-io.ts +45 -26
  474. package/src/domains/middleware/hooks.ts +6 -0
  475. package/src/domains/middleware/injection-screen.ts +23 -0
  476. package/src/domains/middleware/marketplace-offer.ts +20 -1
  477. package/src/domains/middleware/rules.ts +5 -1
  478. package/src/domains/middleware/runtime.ts +7 -3
  479. package/src/domains/middleware/stalled-turn.ts +18 -3
  480. package/src/domains/middleware/task-board-reminder.ts +4 -2
  481. package/src/domains/middleware/task-nudge.ts +4 -1
  482. package/src/domains/mux/contract.ts +34 -1
  483. package/src/domains/mux/detect.ts +3 -6
  484. package/src/domains/mux/dock-controller.ts +8 -1
  485. package/src/domains/mux/index.ts +1 -0
  486. package/src/domains/mux/socket-client.ts +13 -3
  487. package/src/domains/observability/accountability.ts +15 -1
  488. package/src/domains/observability/contract.ts +54 -9
  489. package/src/domains/observability/evidence-index.ts +10 -0
  490. package/src/domains/observability/extension.ts +9 -5
  491. package/src/domains/observability/projection.ts +423 -53
  492. package/src/{interactive → domains/observability}/worker-progress.ts +3 -3
  493. package/src/domains/prompts/compiler.ts +10 -2
  494. package/src/domains/prompts/contract.ts +7 -4
  495. package/src/domains/prompts/extension.ts +28 -64
  496. package/src/domains/prompts/fragments/identity/clio.md +23 -0
  497. package/src/domains/prompts/fragments/operating/contract.md +12 -0
  498. package/src/domains/prompts/fragments/operating/delegation.md +5 -0
  499. package/src/domains/prompts/fragments/wiki/page.md +36 -15
  500. package/src/domains/prompts/fragments/wiki/plan.md +4 -4
  501. package/src/domains/prompts/preload-prefix.ts +31 -0
  502. package/src/domains/prompts/preload.ts +135 -61
  503. package/src/domains/providers/auth/backend-file.ts +15 -11
  504. package/src/domains/providers/auth/storage.ts +3 -5
  505. package/src/domains/providers/catalog.ts +18 -3
  506. package/src/domains/providers/model-discovery.ts +1 -4
  507. package/src/domains/providers/models/local-models/clio-coder-local-coding-targets.yaml +16 -14
  508. package/src/domains/providers/runtime-resolution.ts +11 -9
  509. package/src/domains/providers/runtimes/claude/claude-code.ts +9 -0
  510. package/src/domains/providers/runtimes/cloud/openrouter.ts +2 -0
  511. package/src/domains/providers/support.ts +1 -1
  512. package/src/domains/providers/types/runtime-descriptor.ts +1 -1
  513. package/src/domains/resources/skills/promotion.ts +8 -1
  514. package/src/domains/safety/action-classifier.ts +16 -0
  515. package/src/domains/safety/autonomy.ts +10 -1
  516. package/src/domains/safety/contract.ts +5 -1
  517. package/src/domains/safety/default-path-policy.ts +13 -0
  518. package/src/domains/safety/extension.ts +11 -2
  519. package/src/domains/safety/finish-contract-registration.ts +29 -14
  520. package/src/domains/safety/finish-contract.ts +252 -40
  521. package/src/domains/safety/index.ts +20 -1
  522. package/src/domains/safety/policy-engine.ts +211 -34
  523. package/src/domains/safety/project-policy.ts +7 -2
  524. package/src/domains/safety/rigor.ts +53 -39
  525. package/src/domains/safety/validation-contract.ts +388 -0
  526. package/src/domains/safety/workspace-trust.ts +43 -0
  527. package/src/domains/session/archive-readers.ts +10 -1
  528. package/src/domains/session/compaction/compact.ts +384 -21
  529. package/src/domains/session/compaction/cut-point.ts +42 -5
  530. package/src/domains/session/compaction/tokens.ts +9 -1
  531. package/src/domains/session/decision-board.ts +137 -28
  532. package/src/domains/session/entries.ts +213 -11
  533. package/src/domains/session/extension.ts +4 -4
  534. package/src/domains/session/handoff.ts +2 -1
  535. package/src/domains/session/manager.ts +2 -3
  536. package/src/domains/session/prompt-manifest.ts +47 -8
  537. package/src/domains/session/task-board.ts +32 -1
  538. package/src/domains/session/tree/fork.ts +1 -2
  539. package/src/domains/session/tree/navigator.ts +1 -1
  540. package/src/domains/user-tasks/acceptance.ts +56 -0
  541. package/src/domains/user-tasks/active-acceptance.ts +40 -0
  542. package/src/domains/user-tasks/handoff.ts +16 -0
  543. package/src/domains/user-tasks/store.ts +34 -3
  544. package/src/engine/acp/adapter.ts +60 -10
  545. package/src/engine/acp/server.ts +22 -4
  546. package/src/engine/acp/transport.ts +55 -9
  547. package/src/engine/acp/types.ts +9 -0
  548. package/src/engine/antigravity/subprocess-runtime.ts +20 -4
  549. package/src/engine/api-registry.ts +19 -2
  550. package/src/engine/apis/ollama-native.ts +15 -0
  551. package/src/engine/apis/openai-completions.ts +13 -6
  552. package/src/engine/apis/output-budget.ts +26 -10
  553. package/src/engine/claude/sdk-runtime.ts +4 -3
  554. package/src/engine/claude/subprocess-runtime.ts +107 -60
  555. package/src/engine/env-api-keys.ts +2 -1
  556. package/src/engine/external-subprocess.ts +26 -7
  557. package/src/engine/loop-guard.ts +19 -2
  558. package/src/engine/provider-diagnostics.ts +129 -0
  559. package/src/engine/provider-payload.ts +3 -1
  560. package/src/engine/worker-runtime.ts +13 -2
  561. package/src/engine/worker-tools.ts +5 -1
  562. package/src/entry/extension-reload.ts +1 -0
  563. package/src/entry/orchestrator.ts +64 -17
  564. package/src/interactive/chat-loop-messages.ts +12 -4
  565. package/src/interactive/chat-loop.ts +115 -45
  566. package/src/interactive/chat-renderer.ts +60 -0
  567. package/src/interactive/context-recall-command.ts +2 -1
  568. package/src/interactive/dispatch-board.ts +58 -714
  569. package/src/interactive/editor-submit.ts +13 -0
  570. package/src/interactive/fleet-run-preview.ts +2 -1
  571. package/src/interactive/interactive-application.ts +11 -4
  572. package/src/interactive/interactive-event-projection.ts +7 -1
  573. package/src/interactive/interactive-presentation.ts +63 -12
  574. package/src/interactive/interactive-slash-runtime.ts +4 -1
  575. package/src/interactive/layout.ts +2 -1
  576. package/src/interactive/model-session-replay.ts +2 -2
  577. package/src/interactive/oracle.ts +5 -2
  578. package/src/interactive/overlay-frame.ts +1 -0
  579. package/src/interactive/overlay-general-openers.ts +3 -1
  580. package/src/interactive/overlay-session-lifecycle.ts +6 -0
  581. package/src/interactive/overlays/ask-user.ts +1 -0
  582. package/src/interactive/overlays/fleet-run-approval.ts +3 -2
  583. package/src/interactive/overlays/message-picker.ts +3 -3
  584. package/src/interactive/overlays/settings.ts +2 -2
  585. package/src/interactive/overlays/tree-selector.ts +2 -2
  586. package/src/interactive/renderers/branch-summary.ts +1 -1
  587. package/src/interactive/renderers/tool-execution.ts +17 -1
  588. package/src/interactive/renderers/worker-entry.ts +25 -10
  589. package/src/interactive/slash-autocomplete.ts +4 -6
  590. package/src/interactive/slash-commands.ts +31 -43
  591. package/src/interactive/slash-spec.ts +28 -0
  592. package/src/interactive/turn-context.ts +221 -53
  593. package/src/interactive/turn-middleware.ts +3 -1
  594. package/src/interactive/turn-persistence.ts +3 -0
  595. package/src/interactive/turn-runtime.ts +11 -2
  596. package/src/interactive/turn-state.ts +10 -9
  597. package/src/interactive/view/artifacts.ts +2 -0
  598. package/src/interactive/watch-pane.ts +18 -4
  599. package/src/interactive/worker-stream.ts +14 -10
  600. package/src/tools/agent-tools.ts +6 -3
  601. package/src/tools/bash.ts +1 -1
  602. package/src/tools/bootstrap.ts +4 -0
  603. package/src/tools/builtin-tool-catalog.ts +40 -2
  604. package/src/tools/codewiki/code-nav.ts +4 -10
  605. package/src/tools/compete-judge-task.ts +71 -0
  606. package/src/tools/compete-worktrees.ts +41 -1
  607. package/src/tools/context/index.ts +32 -7
  608. package/src/tools/context/surface.ts +15 -4
  609. package/src/tools/core-bootstrap.ts +16 -0
  610. package/src/tools/decide.ts +136 -0
  611. package/src/tools/dispatch-admission.ts +33 -1
  612. package/src/tools/dispatch-arguments.ts +38 -1
  613. package/src/tools/dispatch-plan.ts +12 -9
  614. package/src/tools/dispatch-runner.ts +63 -33
  615. package/src/tools/dispatch-schema.ts +30 -23
  616. package/src/tools/dispatch-scout-admission.ts +10 -44
  617. package/src/tools/dispatch-scout.ts +2 -3
  618. package/src/tools/dispatch-types.ts +6 -0
  619. package/src/tools/evidence.ts +96 -0
  620. package/src/tools/find.ts +13 -4
  621. package/src/tools/grep.ts +13 -1
  622. package/src/tools/limitation.ts +76 -0
  623. package/src/tools/ls.ts +7 -1
  624. package/src/tools/monitor.ts +26 -11
  625. package/src/tools/network-policy.ts +11 -24
  626. package/src/tools/observation.ts +39 -2
  627. package/src/tools/policy.ts +9 -0
  628. package/src/tools/presentation.ts +3 -0
  629. package/src/tools/read.ts +112 -15
  630. package/src/tools/registry.ts +55 -18
  631. package/src/tools/result-shaping.ts +127 -7
  632. package/src/tools/task-worktree.ts +13 -3
  633. package/src/tools/tasks.ts +40 -5
  634. package/src/tools/verify/authoring.ts +170 -83
  635. package/src/tools/verify/catalog.ts +122 -5
  636. package/src/tools/verify/frontend.ts +67 -30
  637. package/src/tools/verify/index.ts +2 -1
  638. package/src/tools/verify/numeric.ts +303 -0
  639. package/src/tools/verify/perf.ts +143 -0
  640. package/src/tools/verify/scripts.ts +229 -2
  641. package/src/tools/web-fetch-network.ts +179 -0
  642. package/src/tools/web-fetch-surface.ts +2 -1
  643. package/src/tools/web-fetch.ts +15 -13
  644. package/src/tools/worker-evidence.ts +27 -0
  645. package/src/worker/spec-contract.ts +12 -8
  646. package/dist/builtins-IA7V7FUC.js +0 -22
  647. package/dist/chunk-2WZ546HR.js +0 -792
  648. package/dist/chunk-5PSMVOLM.js +0 -56
  649. package/dist/chunk-7DICMOS6.js +0 -313
  650. package/dist/chunk-BEPZRGGU.js +0 -1560
  651. package/dist/chunk-JVCV3ICN.js +0 -47
  652. package/dist/chunk-KK4JZPBQ.js +0 -3982
  653. package/dist/chunk-MNJGS2IN.js +0 -33
  654. package/dist/chunk-NDINPTJ4.js +0 -641
  655. package/dist/chunk-O5CVSAG5.js +0 -122
  656. package/dist/chunk-OQE5J4C6.js +0 -73
  657. package/dist/chunk-RVG5JXAL.js +0 -41
  658. package/dist/chunk-T56WDKA5.js +0 -183
  659. package/dist/chunk-UUVG37B4.js +0 -244
  660. package/dist/chunk-VPKWYKEY.js +0 -169
  661. package/dist/chunk-Y3CBHOR6.js +0 -228
  662. package/dist/clio-CMMK4KRR.js +0 -25
  663. package/dist/configure-LE3IK2TJ.js +0 -56
  664. package/dist/context-clear-BW4O37TG.js +0 -176
  665. package/dist/fleet-view-SWBR3VGQ.js +0 -97
  666. package/dist/preload-P6DGH2PZ.js +0 -13
  667. package/dist/slash-commands-S7MBJDQK.js +0 -83
  668. package/dist/tools-TFGJICCU.js +0 -29
  669. package/dist/verify-RWE4PPEK.js +0 -27
  670. package/dist/wiki-generate-C7IQOXSP.js +0 -469
package/README.md CHANGED
@@ -58,11 +58,16 @@ looks wrong, `clio-coder doctor` performs a read-only health check.
58
58
  > [!NOTE]
59
59
  > Add `--omit=optional` to the npm install to skip the Claude Agent SDK's large
60
60
  > optional binary. Only the `claude-sdk` worker runtime needs it. See
61
- > [Optional dependencies](docs/guide/installation-and-lifecycle.md#optional-dependency-the-claude-agent-sdk).
61
+ > [Optional dependencies](#optional-dependency-the-claude-agent-sdk).
62
62
 
63
63
  | If you are… | Continue with… |
64
64
  | --- | --- |
65
65
  | Trying Clio on a project | [A first session](#a-first-session) and [Choose where models run](#choose-where-models-run) |
66
+ | Running automation, scripts, or editor hosts | [Headless and editor use](#headless-and-editor-use) |
67
+ | Exploring CLI commands and diagnostics | [CLI discovery and diagnostics](#cli-discovery-and-diagnostics) |
68
+ | Managing installation, upgrades, or uninstall | [Install](#install) |
69
+ | Using the desktop or browser GUI | [Canonical Workbench (Clio Coder GUI)](#canonical-workbench-clio-coder-gui) |
70
+ | Inspecting execution trace mirrors | [Trace viewer (source-only)](#trace-viewer-source-only) |
66
71
  | Responsible for sensitive or expensive work | [Safety and evidence](#safety-and-evidence) |
67
72
  | Bringing Clio to a workstation or cluster | [Project context](#project-context-that-stays-with-the-project) and [Delegation](#delegate-with-bounds) |
68
73
  | An agent entering this repository | [For agents working on Clio Coder](#for-agents-working-on-clio-coder) |
@@ -122,6 +127,7 @@ and activity visible without taking over the terminal.
122
127
  | Branch or resume a conversation | `/tree`, `/fork`, `/resume`, `/new` |
123
128
  | Carry current state into a fresh session | `/handoff <goal>` |
124
129
  | Browse agents, prompts, fleets, extensions, and skills | `/resources` |
130
+ | Load a specialized skill | `/skill <name>` |
125
131
  | Save a self-contained transcript | `/export` |
126
132
 
127
133
  Pressing Enter while Clio is working steers the active turn; `Alt+Enter` queues
@@ -306,6 +312,7 @@ clio-coder evidence list
306
312
  clio-coder evidence inspect <evidence-id>
307
313
  clio-coder trace phases <run-id>
308
314
  clio-coder trace tail <run-id>
315
+ clio-coder trace inspect --json
309
316
  ```
310
317
 
311
318
  `clio-coder usage report` preserves known failed-compaction spending and labels
@@ -335,12 +342,39 @@ clio-coder run "<task>" --agent coder
335
342
  clio-coder acp
336
343
  ```
337
344
 
338
- Text mode reserves stdout for the final answer. `--json` emits JSONL events for
339
- scripts, and `acp` serves Clio over stdio to Agent Client Protocol hosts. Exit
340
- codes and output guarantees are documented in
345
+ Text mode reserves stdout for the final answer. Diagnostics and progress go to
346
+ stderr. `--json` emits JSONL events for scripts, and `acp` serves Clio over
347
+ stdio to Agent Client Protocol hosts.
348
+
349
+ In headless runs (`clio-coder run`):
350
+
351
+ - Interactive confirmation prompts cannot be answered, so any tool call parking
352
+ for operator confirmation is automatically denied. Interactive session commands
353
+ (such as `/settings`, `/help`, or `/context compact`) are refused upfront with
354
+ an error. Skill invocations that include a task (such as
355
+ `/skill <name> <task>`) and declared prompt templates expand normally; a bare
356
+ `/skill` invocation without arguments is rejected.
357
+ - Dispatched workers follow `fleet.permissions.mode`: default `deny` records a
358
+ structured tool denial and continues execution, while `fail` aborts the worker.
359
+
360
+ Exit codes and output guarantees are documented in
341
361
  [Exit Codes and Output](docs/guide/exit-codes-and-output.md) and
342
362
  [ACP](docs/architecture/acp.md).
343
363
 
364
+ ## CLI discovery and diagnostics
365
+
366
+ Discover commands and inspect local health without guessing syntax:
367
+
368
+ | You want to… | Command | Description |
369
+ | --- | --- | --- |
370
+ | View standard operator commands | `clio-coder --help` | Day-to-day commands for chat, config, context, and fleets. |
371
+ | View complete command listing | `clio-coder --help --all` | Standard commands plus harness developer tools under `clio-coder dev`. |
372
+ | Run developer instruments | `clio-coder dev <command>` | Harness tools: `components`, `evolve`, and `share`. |
373
+ | Health check state and credentials | `clio-coder doctor` | Read-only scan of settings schema, credentials mode (`0o600`), and directories. |
374
+ | Repair missing skeletons | `clio-coder doctor --fix` | Non-destructively creates missing directories and repairs credential permissions. |
375
+ | Show resolved paths | `clio-coder paths [--json]` | Displays resolved configuration, data, state, and cache directories. |
376
+ | Inspect active settings | `clio-coder config inspect` | Displays layered configuration and provenance. |
377
+
344
378
  ## Settings and local state
345
379
 
346
380
  User configuration is a strict `version: 2` YAML document organized into seven
@@ -366,38 +400,173 @@ cache on the current machine. See the complete
366
400
 
367
401
  Requirements:
368
402
 
369
- - Node.js `>=22.19.0` and npm
403
+ - Node.js `>=22.19.0` on `PATH`, including when installing with Bun
370
404
  - Linux or macOS; Windows support is currently best effort
405
+ - A package manager for registry installation, or Git and pnpm for source builds
371
406
  - At least one local, institutional, subscription, or cloud model target
407
+ - Optional: Deno `>=2.9.5` for compiling or running the canonical Workbench GUI
372
408
 
373
- ### Install from npm
409
+ Registry commands below install the version published under `latest`. This
410
+ checkout prepares **0.4.5**; until that release is published, `latest` remains
411
+ **0.4.4**. The v0.4.5 source workflow uses pnpm **10.34.5**, pinned in
412
+ `package.json`, and Pi **0.85.1**.
413
+
414
+ ### Install with npm, pnpm, or Bun
415
+
416
+ Choose one global installation command:
417
+
418
+ | Package manager | Install | Global executable directory |
419
+ | --- | --- | --- |
420
+ | npm | `npm install -g @iowarp/clio-coder` | `$(npm prefix -g)/bin` on Unix; the prefix itself on Windows |
421
+ | pnpm | `pnpm add -g @iowarp/clio-coder` | `pnpm bin -g`; run `pnpm setup` and restart your shell if no global bin directory is configured |
422
+ | Bun | `bun add -g @iowarp/clio-coder` | `bun pm bin -g`, usually `~/.bun/bin` |
423
+
424
+ These managers install the same package from the npm registry. Bun manages the
425
+ installation; the CLI's executable uses Node.js. Keep the selected manager's
426
+ global executable directory on `PATH`, then verify and configure:
374
427
 
375
428
  ```bash
376
- npm install -g @iowarp/clio-coder
429
+ clio-coder --version
377
430
  clio-coder configure
431
+ clio-coder doctor
432
+ ```
433
+
434
+ To select a particular published version, append `@<version>` to the package
435
+ name. For example, `npm install -g @iowarp/clio-coder@0.4.4` installs v0.4.4.
436
+
437
+ ### Run without a global installation
438
+
439
+ | Package manager | Command |
440
+ | --- | --- |
441
+ | npm exec | `npm exec --package=@iowarp/clio-coder@latest -- clio-coder --help` |
442
+ | npx | `npx --yes @iowarp/clio-coder@latest --help` |
443
+ | pnpm dlx | `pnpm dlx @iowarp/clio-coder@latest --help` |
444
+ | bunx | `bunx @iowarp/clio-coder@latest --help` |
445
+ | Yarn 2+ | `yarn dlx -p @iowarp/clio-coder@latest clio-coder --help` |
446
+
447
+ Replace `--help` with `configure`, another CLI command, or nothing to start an
448
+ interactive session. These commands download packages into the manager's cache;
449
+ Clio still uses its normal configuration and session directories. Node.js is
450
+ required for every route; do not pass Bun's `--bun` runtime override.
451
+
452
+ Yarn Classic users can install with `yarn global add @iowarp/clio-coder` and
453
+ put `yarn global bin` on `PATH`. Modern Yarn uses the `dlx` route above.
454
+ For a repository-local CLI dependency, use `npm install --save-dev`,
455
+ `pnpm add -D`, or `bun add -d` with `@iowarp/clio-coder`, then invoke the local
456
+ binary through that manager's exec/run command. Source development in this
457
+ repository uses the pinned pnpm workflow below.
458
+
459
+ #### Optional dependency: the Claude Agent SDK
460
+
461
+ `@anthropic-ai/claude-agent-sdk` includes a large platform-specific binary.
462
+ Skip optional dependencies when you do not need the `claude-sdk` worker runtime:
463
+
464
+ | Package manager | Install without optional dependencies |
465
+ | --- | --- |
466
+ | npm | `npm install -g @iowarp/clio-coder --omit=optional` |
467
+ | pnpm | `pnpm add -g @iowarp/clio-coder --no-optional` |
468
+ | Bun | `bun add -g @iowarp/clio-coder --omit=optional` |
469
+
470
+ Other runtimes do not need that SDK. To include it later, reinstall with your
471
+ chosen manager and its optional dependencies enabled; for npm, use
472
+ `npm install -g @iowarp/clio-coder --include=optional`.
473
+ See [Optional dependencies](docs/guide/installation-and-lifecycle.md#optional-dependency-the-claude-agent-sdk).
474
+
475
+ #### Update or remove a registry installation
476
+
477
+ Use the manager that owns the installation:
478
+
479
+ | Package manager | Update | Remove package and executable |
480
+ | --- | --- | --- |
481
+ | npm | `npm install -g @iowarp/clio-coder@latest` | `npm uninstall -g @iowarp/clio-coder` |
482
+ | pnpm | `pnpm add -g @iowarp/clio-coder@latest` | `pnpm remove -g @iowarp/clio-coder` |
483
+ | Bun | `bun add -g @iowarp/clio-coder@latest` | `bun remove -g @iowarp/clio-coder` |
484
+ | Yarn Classic | `yarn global add @iowarp/clio-coder@latest` | `yarn global remove @iowarp/clio-coder` |
485
+
486
+ After a package-manager update, run the installed v0.4.5 CLI's local migration
487
+ and metadata checks without another package installation:
488
+
489
+ ```bash
490
+ clio-coder upgrade --post-install
491
+ clio-coder doctor
492
+ ```
493
+
494
+ Plain `clio-coder upgrade` can reinstall npm packages. For pnpm, Bun, Yarn,
495
+ repository-local, or cached executions, use the owning manager to update and
496
+ pass `--post-install`; automatic package replacement currently assumes npm.
497
+ For a cached execution, rerun the same runner with `@latest` to select the
498
+ latest release. Package-manager removal preserves Clio's configuration and
499
+ sessions. Clear your shell's command cache with `hash -r` (Bash) or `rehash`
500
+ (Zsh) after changing installations.
501
+
502
+ For deliberate removal of user-level configuration, data, state, and cache,
503
+ see [Lifecycle operations](#lifecycle-operations) and
504
+ [Installation and Lifecycle](docs/guide/installation-and-lifecycle.md).
505
+
506
+ ### Install from a release tarball
507
+
508
+ Download `iowarp-clio-coder-<version>.tgz` from the matching
509
+ [GitHub release](https://github.com/iowarp/clio-coder/releases), then install the
510
+ local artifact with your chosen manager:
511
+
512
+ ```bash
513
+ npm install -g ./iowarp-clio-coder-<version>.tgz
514
+ # Or: pnpm add -g ./iowarp-clio-coder-<version>.tgz
515
+ # Or: bun add -g ./iowarp-clio-coder-<version>.tgz
378
516
  clio-coder --version
379
517
  ```
380
518
 
519
+ The archive includes the built CLI and runtime resources. Installation still
520
+ resolves dependencies from the registry unless your package-manager cache
521
+ already contains them. GitHub's automatically generated source archives need
522
+ the source build steps below.
523
+
381
524
  ### Install from source
382
525
 
383
- From source, pinned to this version:
526
+ From source, the v0.4.5 release uses this pinned pnpm workflow. The tag becomes
527
+ available when the release is cut; before then, use an existing local `v045`
528
+ checkout with the steps following `cd clio-coder`:
384
529
 
385
530
  ```bash
386
- git clone --branch v0.4.3 https://github.com/iowarp/clio-coder.git
531
+ git clone --branch v0.4.5 https://github.com/iowarp/clio-coder.git
387
532
  cd clio-coder
388
- npm ci
389
- npm run install:local
533
+ corepack enable pnpm
534
+ pnpm run install:local
390
535
  export PATH="$HOME/.local/bin:$PATH"
391
536
  hash -r
392
537
  "$HOME/.local/bin/clio-coder" --version
393
538
  ```
394
539
 
395
- `npm run install:local` builds and links the launcher at
396
- `${CLIO_CODER_BIN_DIR:-$HOME/.local/bin}/clio-coder`. Run
397
- `command -v clio-coder` to see which installation the bare command reaches;
540
+ If Corepack is unavailable, install pnpm with `npm install -g pnpm@10.34.5`
541
+ instead of `corepack enable pnpm`. The `packageManager` field selects the
542
+ repository version when using Corepack. Published v0.4.4 and older source tags
543
+ use their own npm workflow (`npm ci` and `npm run install:local`); follow the
544
+ README at the tag you check out.
545
+
546
+ `pnpm run install:local` performs `pnpm install --frozen-lockfile`, builds, and
547
+ links the launcher at `${CLIO_CODER_BIN_DIR:-$HOME/.local/bin}/clio-coder`.
548
+ There is no need to install dependencies separately first. If you already
549
+ synced them, use `pnpm run install:local --skip-deps`. For an existing build,
550
+ `bash scripts/install-local.sh --skip-deps --no-build` only links and runs
551
+ local setup checks. Use `--dry-run` to inspect the planned actions.
552
+
553
+ Run `command -v clio-coder` to see which installation the bare command reaches;
398
554
  your shell may otherwise keep resolving an older launcher earlier on `PATH`.
399
- Clone the default branch instead only when you deliberately want the current
400
- development tree.
555
+
556
+ To use the source build without installing a launcher:
557
+
558
+ ```bash
559
+ pnpm install --frozen-lockfile
560
+ pnpm run build
561
+ node dist/cli/index.js --help
562
+ node dist/cli/index.js
563
+ ```
564
+
565
+ Rebuild automatically on source changes:
566
+
567
+ ```bash
568
+ pnpm run dev
569
+ ```
401
570
 
402
571
  Upgrade and diagnose without deleting state:
403
572
 
@@ -407,16 +576,155 @@ clio-coder doctor
407
576
  clio-coder doctor --fix
408
577
  ```
409
578
 
410
- To remove it, preview first:
579
+ After updating your chosen source revision, rerun `pnpm run install:local`,
580
+ `hash -r`, and `clio-coder upgrade`. `pnpm run dev` rebuilds the CLI bundles on
581
+ source changes; restart a running Clio process to load the new build.
582
+
583
+ To remove the launcher and deliberately purge Clio's user configuration, data,
584
+ sessions, and caches, preview the removal before confirming it:
411
585
 
412
586
  ```bash
413
587
  clio-coder uninstall --dry-run
414
- clio-coder uninstall --remove-binary --force
588
+ clio-coder uninstall --remove-binary
415
589
  ```
416
590
 
591
+ `clio-coder uninstall` purges the four home roots (`config`, `data`, `state`,
592
+ `cache`); `--remove-binary` unlinks the local launcher. Per-project `.clio-coder/`
593
+ state directories and authored `CLIO-CODER.md` handbooks are not deleted by
594
+ uninstall. Project reset options and selective preservation are described in the
595
+ lifecycle guide below.
596
+
597
+ ### Lifecycle operations
598
+
599
+ | Operation | Command | Scope and effect |
600
+ | --- | --- | --- |
601
+ | Health check | `clio-coder doctor` | Read-only audit of settings schema, credentials permissions (`0o600`), and state freshness. |
602
+ | Structure repair | `clio-coder doctor --fix` | Creates missing directory skeletons and restores credential permissions (does not migrate schemas). |
603
+ | Lifecycle upgrade | `clio-coder upgrade [--dry-run]` | Applies pending registered migrations (`migrations.json`) and refreshes install metadata. |
604
+ | Selective reset | `clio-coder reset --help` | Lists destructive reset options and their scopes; use `--dry-run` to preview. |
605
+ | Full uninstall | `clio-coder uninstall [--remove-binary] [--force]` | Removes user config, data, state, and cache roots; `--remove-binary` unlinks launcher. |
606
+
417
607
  The full directory, permission, reset, migration, and uninstall behavior is in
418
608
  [Installation and Lifecycle](docs/guide/installation-and-lifecycle.md).
419
609
 
610
+ ## Canonical Workbench (Clio Coder GUI)
611
+
612
+ The canonical desktop and browser GUI for Clio Coder lives in `apps/workbench/`.
613
+ It is a single Deno process that serves a built React/Vite web interface over
614
+ the loopback interface (`127.0.0.1`) and manages one child `clio-coder acp`
615
+ process per open project.
616
+
617
+ The standalone GUI executable is `clio-coder-gui`, or the interface can be run
618
+ directly using Deno tasks. The product shown to users is named **Clio Coder**;
619
+ the source directory retains the name `workbench`.
620
+
621
+ The Runs view filters the currently loaded run window by search, outcome,
622
+ agent, node, fleet lineage, and receipt state. The conversation's worker strip
623
+ has an optional running-only filter. **How this app works** opens searchable
624
+ help and keyboard shortcuts, and **Settings → About** identifies the GUI and
625
+ connected Clio versions and capabilities.
626
+
627
+ ### State and settings
628
+
629
+ The GUI launches `clio-coder` from `PATH` and uses the same Clio settings and
630
+ authentication as the TUI. Choose targets and models through Clio's settings;
631
+ no separate testing profile is needed.
632
+
633
+ The GUI persists only its recent-project list in `projects.json`. Its state root is resolved in order:
634
+ `$CLIO_CODER_GUI_STATE_DIR`, then deprecated `$CLIO_WORKBENCH_STATE_DIR`, then
635
+ `$XDG_STATE_HOME/clio-coder-gui`, and finally `~/.local/state/clio-coder-gui`.
636
+ On first start after upgrade, legacy `clio-workbench` directories are migrated atomically.
637
+
638
+ ### Running Workbench from source
639
+
640
+ Requirements: Deno `>=2.9.5`, workspace dependencies installed from the root
641
+ (`pnpm install --frozen-lockfile`), and `clio-coder` on `PATH`.
642
+
643
+ The supported full GUI runs through the Deno host on port 4173:
644
+
645
+ ```bash
646
+ cd apps/workbench
647
+
648
+ # Build dist/ and serve on http://127.0.0.1:4173:
649
+ deno task browser
650
+
651
+ # Serve an existing dist/ build directly:
652
+ deno task start
653
+
654
+ # Use any free port and open the default browser:
655
+ deno task start --port=0 --open
656
+ ```
657
+
658
+ `deno task browser` builds `dist/` once with Vite and starts the host. The Vite
659
+ configuration (`vite.config.ts`) has no backend proxy; restarting `deno task browser`
660
+ rebuilds and serves updated assets after edits. See the contributor notes in
661
+ [apps/workbench/README.md](apps/workbench/README.md).
662
+
663
+ ### GUI application lifecycle
664
+
665
+ Lifecycle tasks in `apps/workbench/` are managed via `scripts/gui-lifecycle.ts`:
666
+
667
+ ```bash
668
+ cd apps/workbench
669
+ deno task gui:install # builds dist/, compiles standalone binary, places application files
670
+ deno task gui:status # verifies version, per-file sha256 checksums, state dir, and PATH
671
+ deno task gui:upgrade # replaces recorded files in place and rewrites manifest
672
+ deno task gui:uninstall # removes recorded files and empty directories created at install
673
+ ```
674
+
675
+ Pass `--purge-state` to `gui:uninstall` to also remove the GUI state directory.
676
+
677
+ An installation places exactly three files plus an install manifest:
678
+
679
+ - Binary: `~/.local/bin/clio-coder-gui` (or `DIR/bin/clio-coder-gui` with `--prefix=DIR`)
680
+ - Desktop entry: `$XDG_DATA_HOME/applications/clio-coder-gui.desktop`
681
+ - Application icon: `$XDG_DATA_HOME/clio-coder-gui/clio-coder-gui.png`
682
+ - Manifest: `$XDG_DATA_HOME/clio-coder-gui/install.json`
683
+
684
+ The compiled binary (~105 MB on x86_64 Linux) has `dist/` embedded and runs
685
+ without the source checkout. Start it with `clio-coder-gui --open`, or use the
686
+ desktop launcher. The Clio CLI must still be on `PATH` for conversations.
687
+
688
+ ### Desktop limitations
689
+
690
+ - **Platform support:** Linux (including WSL2) is tested. Native Windows launch is
691
+ unavailable (`defaultClioLauncher` in `main.ts` refuses it); `desktop:windows` is an
692
+ unverified experimental webview build.
693
+ - **Network change resilience:** Transient `net::ERR_NETWORK_CHANGED` errors when
694
+ WSL2 or VPN interfaces cycle are recovered automatically via 3-stage bootstrap retries.
695
+ - **Release distribution:** Pre-packaged GUI binaries are not distributed as GitHub
696
+ release downloads; compile locally using `deno task gui:install`.
697
+
698
+ See [apps/workbench/README.md](apps/workbench/README.md) and
699
+ [apps/workbench/DESIGN_SYSTEM.md](apps/workbench/DESIGN_SYSTEM.md).
700
+
701
+ ## Trace viewer (source-only)
702
+
703
+ A small, local-only, read-only web view over Clio's durable dispatch trace
704
+ mirror (`trace.sqlite`) and provenance sidecars (`receipts/<runId>.json`,
705
+ `evidence-index.json`).
706
+
707
+ `apps/` is intentionally absent from the published npm package, so the trace
708
+ viewer is available **only from a source checkout**.
709
+
710
+ The CLI command defaults to an ephemeral free port (port 0), while direct server
711
+ launch defaults to port 4600:
712
+
713
+ ```bash
714
+ # Start viewer on port 4600 via the CLI:
715
+ clio-coder trace ui --port 4600
716
+
717
+ # Or start directly with pnpm:
718
+ pnpm run trace:ui --db /path/to/trace.sqlite --port 4600
719
+ ```
720
+
721
+ The server binds strictly to `127.0.0.1`, opens SQLite with read-only flags,
722
+ and polls active runs every 500 ms. Pass `--db <path>` to inspect an alternate
723
+ trace database location.
724
+
725
+ See [apps/trace-viewer/README.md](apps/trace-viewer/README.md) and
726
+ [Trace Store Architecture](docs/architecture/trace-store.md).
727
+
420
728
  ## Project status
421
729
 
422
730
  The latest release is available from npm as
@@ -433,7 +741,9 @@ model-dependent results as measurements rather than promises.
433
741
 
434
742
  | Problem | First check |
435
743
  | --- | --- |
436
- | `clio-coder: command not found` | Run `command -v clio-coder`; make sure the npm global bin or `${CLIO_CODER_BIN_DIR:-$HOME/.local/bin}` is on `PATH`, then run `hash -r`. |
744
+ | `clio-coder: command not found` | Run `command -v clio-coder`; make sure your package manager's global bin or `${CLIO_CODER_BIN_DIR:-$HOME/.local/bin}` is on `PATH`, then run `hash -r` (Bash) or `rehash` (Zsh). |
745
+ | GUI launcher not found | Run `clio-coder-gui` (or `cd apps/workbench && deno task browser`). There is no `clio-coder workbench` subcommand. |
746
+ | Trace viewer unavailable | The trace viewer is source-only. Run `clio-coder trace ui` or `pnpm run trace:ui` from a source checkout. |
437
747
  | No usable model target | Run `clio-coder configure`, then `clio-coder targets --probe`. |
438
748
  | A local server does not answer | Verify the server process, URL, advertised model id, and `clio-coder targets` health row. |
439
749
  | Cloud or subscription authentication fails | Run `clio-coder auth status <target-or-runtime>` and repeat the appropriate login flow. |
@@ -483,18 +793,19 @@ architecture boundaries, commit conventions, and review expectations. Report
483
793
  security issues through [SECURITY.md](SECURITY.md), not a public issue.
484
794
 
485
795
  ```bash
486
- npm ci
487
- npm run dev # rebuild on source changes
488
- npm run ci # types, hygiene, build, deterministic tests
489
- npm run ci:release # CI plus distribution and package audit
796
+ corepack enable pnpm
797
+ pnpm install --frozen-lockfile
798
+ pnpm run dev # rebuild on source changes
799
+ pnpm run ci # types, hygiene, build, deterministic tests
800
+ pnpm run ci:release # CI plus distribution and package audit
490
801
  ```
491
802
 
492
803
  | Check | Command |
493
804
  | --- | --- |
494
- | Types | `npm run typecheck` |
495
- | Formatting, lint, and architecture hygiene | `npm run lint` |
496
- | One contract file | `npm run test:file -- tests/contracts/<name>.test.ts` |
497
- | Deterministic suite | `npm test` |
805
+ | Types | `pnpm run typecheck` |
806
+ | Formatting, lint, and architecture hygiene | `pnpm run lint` |
807
+ | One contract file | `pnpm run test:file tests/contracts/<name>.test.ts` |
808
+ | Deterministic suite | `pnpm test` |
498
809
  | Distribution package | `node scripts/check-release.mjs` |
499
810
 
500
811
  Local imports end in `.js`, tests use `node:test`, and compile-time domain
@@ -518,6 +829,8 @@ the interactive blueprints locally. Frequently used pages:
518
829
  | Fleet and multi-node execution | [Fleet Dispatch](docs/guide/fleet-dispatch.md) |
519
830
  | Receipts, traces, and evidence | [Observability](docs/architecture/observability.md) |
520
831
  | Exact CLI output contracts | [Exit Codes and Output](docs/guide/exit-codes-and-output.md) |
832
+ | Canonical Workbench (Desktop & Browser GUI) | [apps/workbench/README.md](apps/workbench/README.md) |
833
+ | Trace Viewer (Read-only mirror UI) | [apps/trace-viewer/README.md](apps/trace-viewer/README.md) |
521
834
 
522
835
  ## Heritage
523
836
 
@@ -3,38 +3,38 @@ import {
3
3
  restoreStdout,
4
4
  takeOverStdout,
5
5
  writeRawStdout
6
- } from "./chunk-2VTFPG5O.js";
6
+ } from "./chunk-7WLRF2U5.js";
7
7
  import {
8
8
  runClioCommand
9
- } from "./chunk-AX2THNSA.js";
10
- import "./chunk-4WR7VSYB.js";
11
- import "./chunk-I7XBWTYH.js";
12
- import "./chunk-PUVDKJ2Y.js";
13
- import "./chunk-ZTJUVLTU.js";
9
+ } from "./chunk-SBZX6ARC.js";
10
+ import "./chunk-YYB3MC65.js";
11
+ import "./chunk-T53XI6I7.js";
12
+ import "./chunk-5VTJP36Q.js";
13
+ import "./chunk-FXFVDPWY.js";
14
14
  import {
15
15
  printError
16
- } from "./chunk-VPKWYKEY.js";
17
- import "./chunk-5TSRNF4G.js";
18
- import "./chunk-GHS5EBTQ.js";
19
- import "./chunk-D7E7WCDF.js";
20
- import "./chunk-IWHMRKLL.js";
21
- import "./chunk-UXCU4E3T.js";
22
- import "./chunk-LL4KHSZI.js";
23
- import "./chunk-S66XZJOF.js";
16
+ } from "./chunk-3T4DXWP6.js";
17
+ import "./chunk-NTK3WTHM.js";
18
+ import "./chunk-FKIOX6DS.js";
19
+ import "./chunk-DVNAPPXU.js";
20
+ import "./chunk-E3LEPLQ2.js";
21
+ import "./chunk-SE4ZKILO.js";
22
+ import "./chunk-U2MSJ57E.js";
23
+ import "./chunk-C27U2TYG.js";
24
24
  import {
25
25
  MAX_TIMER_DELAY_MS
26
- } from "./chunk-EBY63B7G.js";
27
- import "./chunk-ID64D7PE.js";
28
- import "./chunk-336NSSKI.js";
29
- import "./chunk-IKCO5N3L.js";
30
- import "./chunk-3I7MS7N2.js";
31
- import "./chunk-APJ265NV.js";
32
- import "./chunk-WEPFGWHJ.js";
33
- import "./chunk-YXLYO42X.js";
34
- import "./chunk-BYP5D4HI.js";
26
+ } from "./chunk-6EXUUOSN.js";
27
+ import "./chunk-HXHFDHB6.js";
28
+ import "./chunk-VNBICSS2.js";
29
+ import "./chunk-2QPI3TR3.js";
30
+ import "./chunk-TK2BMCBZ.js";
31
+ import "./chunk-B5GGDIHT.js";
32
+ import "./chunk-ZZFWWYLX.js";
33
+ import "./chunk-DXVMLM3Z.js";
34
+ import "./chunk-CTTI7G3T.js";
35
35
  import {
36
36
  init_esm_shims
37
- } from "./chunk-3R73A4XB.js";
37
+ } from "./chunk-ECBHH7LU.js";
38
38
 
39
39
  // src/cli/acp.ts
40
40
  init_esm_shims();
@@ -127,4 +127,4 @@ async function runAcpCommand(args, options = {}) {
127
127
  export {
128
128
  runAcpCommand
129
129
  };
130
- //# sourceMappingURL=acp-H2NGRPWO.js.map
130
+ //# sourceMappingURL=acp-H3CU2HBQ.js.map