@iowarp/clio-coder 0.3.1 → 0.3.3

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 (601) hide show
  1. package/CHANGELOG.md +233 -373
  2. package/CONTRIBUTING.md +23 -23
  3. package/README.md +284 -613
  4. package/dist/{acp-FPR54DGL.js → acp-P2AQILE2.js} +43 -53
  5. package/dist/{agents-OGPIHPJH.js → agents-72W3BI7I.js} +43 -26
  6. package/dist/assets/codewiki.json +1 -1
  7. package/dist/{auth-IC3K6NIZ.js → auth-5TWEIYDN.js} +20 -12
  8. package/dist/chunk-2DJ2KNFG.js +2095 -0
  9. package/dist/{chunk-IS3ONKU3.js → chunk-2IR2NMPA.js} +6 -4
  10. package/dist/chunk-2SFS6XQE.js +122 -0
  11. package/dist/{chunk-PV4JUBVJ.js → chunk-2TLUCQVG.js} +40 -21
  12. package/dist/chunk-2VTFPG5O.js +48 -0
  13. package/dist/chunk-4BJ5BYCE.js +61 -0
  14. package/dist/{chunk-474KN5II.js → chunk-4BPJXDWC.js} +111 -181
  15. package/dist/chunk-4VP4KH3K.js +962 -0
  16. package/dist/chunk-4XUGQOHA.js +797 -0
  17. package/dist/chunk-4ZG3XFUR.js +77 -0
  18. package/dist/chunk-5B2AEOW5.js +5407 -0
  19. package/dist/{chunk-K2ITRMHZ.js → chunk-5TSRNF4G.js} +6 -138
  20. package/dist/{chunk-4QKXUHSR.js → chunk-5UFT4SUX.js} +70 -20
  21. package/dist/{chunk-OLBBMFRD.js → chunk-5UUP6MWO.js} +24 -62
  22. package/dist/chunk-65DEGPJ6.js +52 -0
  23. package/dist/chunk-6EJMN2Y3.js +17 -0
  24. package/dist/chunk-6N5PTWMY.js +136 -0
  25. package/dist/chunk-6SGHMWE3.js +277 -0
  26. package/dist/chunk-6XLNIQDB.js +27 -0
  27. package/dist/chunk-7CR24IG7.js +242 -0
  28. package/dist/chunk-7MNJORFF.js +22 -0
  29. package/dist/{chunk-KY56HMHH.js → chunk-A3CYT5EX.js} +125 -31
  30. package/dist/chunk-AGYYIBLL.js +1069 -0
  31. package/dist/{chunk-GB6QRBXN.js → chunk-APJ265NV.js} +54 -1187
  32. package/dist/{chunk-673JJUWJ.js → chunk-BMEMKKIT.js} +2 -2
  33. package/dist/chunk-CBCAPZAA.js +229 -0
  34. package/dist/chunk-CMZWFGD2.js +352 -0
  35. package/dist/chunk-COU2UHX6.js +400 -0
  36. package/dist/chunk-DSELYM6W.js +1077 -0
  37. package/dist/chunk-DUYJ5IO6.js +644 -0
  38. package/dist/chunk-ECH6PKUQ.js +39 -0
  39. package/dist/chunk-ED4KHGC3.js +143 -0
  40. package/dist/chunk-EKMEHE4H.js +340 -0
  41. package/dist/chunk-FCSXB6T2.js +338 -0
  42. package/dist/chunk-FJ3H4MN5.js +48 -0
  43. package/dist/{chunk-RPTR2H26.js → chunk-FNTMWMX5.js} +21 -15
  44. package/dist/chunk-FQ4SKYE4.js +29 -0
  45. package/dist/chunk-G4BMMOKF.js +182 -0
  46. package/dist/{chunk-ZPY3JZ5E.js → chunk-GGXXDWE4.js} +183 -1233
  47. package/dist/chunk-HC4CLZ2Y.js +68 -0
  48. package/dist/{chunk-LU4TK2PR.js → chunk-HFSBBKSQ.js} +5 -56
  49. package/dist/{chunk-PIUMUEMV.js → chunk-HKIYEGME.js} +10 -6
  50. package/dist/chunk-I4HZDVNP.js +73 -0
  51. package/dist/chunk-IKCO5N3L.js +162 -0
  52. package/dist/chunk-IR4CFBFN.js +56 -0
  53. package/dist/{chunk-R5KLMSBV.js → chunk-J5Q24KAG.js} +2 -2
  54. package/dist/chunk-J7CWMCQD.js +255 -0
  55. package/dist/{chunk-K5XEMXTI.js → chunk-JVCV3ICN.js} +1 -1
  56. package/dist/chunk-KZWTDYJF.js +217 -0
  57. package/dist/chunk-LBMZMYH2.js +285 -0
  58. package/dist/{chunk-G34LV2PF.js → chunk-LM5TQCJZ.js} +84 -170
  59. package/dist/chunk-LW6DSM3M.js +5135 -0
  60. package/dist/chunk-LWLEKMDQ.js +3482 -0
  61. package/dist/{chunk-H6F6BYOH.js → chunk-LZSJBIVT.js} +7003 -7434
  62. package/dist/{chunk-HQQID6OA.js → chunk-M6SHUN7Q.js} +5 -5
  63. package/dist/{chunk-FST4FYJB.js → chunk-MFFY33HR.js} +99 -140
  64. package/dist/{chunk-BSU2YIWB.js → chunk-MVVUPGPW.js} +131 -136
  65. package/dist/chunk-OAO4GE4M.js +619 -0
  66. package/dist/{chunk-Q3RUPKEJ.js → chunk-OC7FIQPC.js} +58 -189
  67. package/dist/chunk-OKGUZO2U.js +34 -0
  68. package/dist/{chunk-GAEBEQVI.js → chunk-OOJYHWRB.js} +32 -346
  69. package/dist/{chunk-Q5WJOSJ7.js → chunk-OQ33BKR3.js} +2 -1
  70. package/dist/chunk-OQE5J4C6.js +73 -0
  71. package/dist/{chunk-KKNLWXI6.js → chunk-ORBHGJC5.js} +8 -8
  72. package/dist/{chunk-MAR7Y6HW.js → chunk-PAJK6MAQ.js} +23 -16
  73. package/dist/{chunk-M5T5VO65.js → chunk-PIWWS5BL.js} +837 -635
  74. package/dist/chunk-POHLU5DW.js +1186 -0
  75. package/dist/chunk-QKMUKYO7.js +4961 -0
  76. package/dist/chunk-SRDMMSEP.js +16405 -0
  77. package/dist/chunk-SST6Z5JA.js +80 -0
  78. package/dist/chunk-STBPMHSX.js +2456 -0
  79. package/dist/chunk-T6YILFSB.js +80 -0
  80. package/dist/chunk-TZK7PACC.js +174 -0
  81. package/dist/chunk-TZTZS7QK.js +227 -0
  82. package/dist/{chunk-ASND7OZK.js → chunk-UFIIWP2H.js} +13 -13
  83. package/dist/chunk-UOV2BYIW.js +107 -0
  84. package/dist/{chunk-PFEFKVGL.js → chunk-V6RTAOC2.js} +13 -11
  85. package/dist/chunk-VAKQQHWR.js +434 -0
  86. package/dist/chunk-VG7TBQIY.js +128 -0
  87. package/dist/chunk-VJWL6YS5.js +244 -0
  88. package/dist/{chunk-EYOKLTMF.js → chunk-VPAYEGVX.js} +17 -3
  89. package/dist/chunk-WEH5XRJQ.js +32 -0
  90. package/dist/chunk-X4RCMKVQ.js +641 -0
  91. package/dist/{chunk-TEKV33Q5.js → chunk-X6IAEBZR.js} +65 -33
  92. package/dist/chunk-XBXAASKX.js +18 -0
  93. package/dist/chunk-XN3L4EYL.js +46 -0
  94. package/dist/{chunk-RDLVBZEO.js → chunk-YCWGATWI.js} +6 -4
  95. package/dist/chunk-YHZX5GEU.js +193 -0
  96. package/dist/chunk-YXLYO42X.js +91 -0
  97. package/dist/{chunk-NMOX6HFD.js → chunk-ZDOOVTXZ.js} +29 -77
  98. package/dist/chunk-ZI647VB5.js +37 -0
  99. package/dist/{chunk-C4PTHK7P.js → chunk-ZWLZP4ZT.js} +5 -5
  100. package/dist/chunk-ZWMF7253.js +1882 -0
  101. package/dist/cli/index.js +62 -54
  102. package/dist/clio-JOU4FXVA.js +25 -0
  103. package/dist/code-nav-7AX6FYE6.js +600 -0
  104. package/dist/codewiki/build-worker.js +66 -0
  105. package/dist/compile-cache-CVJMMODC.js +18 -0
  106. package/dist/{components-DMAOEKFB.js → components-KELWS457.js} +11 -6
  107. package/dist/{config-IRUQ7SE4.js → config-XCDVKR23.js} +92 -55
  108. package/dist/configure-4GAP54ZW.js +42 -0
  109. package/dist/{context-5RADCKTR.js → context-4UOGGLQ5.js} +71 -35
  110. package/dist/context-5VKGUVJJ.js +866 -0
  111. package/dist/{context-3KWFLHJG.js → context-77FM5DV5.js} +15 -13
  112. package/dist/{context-clear-7TSNPAAI.js → context-clear-XXJRLCJJ.js} +54 -28
  113. package/dist/{context-index-W4RLWOQH.js → context-index-BZ4UYMTC.js} +30 -24
  114. package/dist/dispatch-runner-QPRDDBDX.js +1997 -0
  115. package/dist/{docs-5AWSPS37.js → docs-2C2LTVT2.js} +23 -10
  116. package/dist/{doctor-UC5NAJYQ.js → doctor-HR46URBJ.js} +27 -17
  117. package/dist/{eval-U6TJHRLX.js → eval-XSSNATB4.js} +29 -16
  118. package/dist/{evidence-YEGUW4L3.js → evidence-6HG2PY2B.js} +46 -26
  119. package/dist/{evolve-TXARCTPG.js → evolve-K7YU3NCY.js} +45 -25
  120. package/dist/{extensions-OZFJ3A3G.js → extensions-QVDOHDGJ.js} +16 -7
  121. package/dist/{fleet-6G3DHNYE.js → fleet-VY3HHKN6.js} +163 -54
  122. package/dist/{fleet-preflight-DSNT37JK.js → fleet-preflight-DDN536IT.js} +7 -4
  123. package/dist/{init-KZ5QTF6M.js → init-JYGXI3FK.js} +69 -32
  124. package/dist/{memory-73ESV5YC.js → memory-WFZMGYHX.js} +48 -27
  125. package/dist/{models-A4PVNWJK.js → models-I5QWSEOM.js} +39 -25
  126. package/dist/monitor-GE4ID3IA.js +661 -0
  127. package/dist/{chunk-FCIH3BIZ.js → orchestrator-EM5MC3HM.js} +15979 -12407
  128. package/dist/{paths-C4H6IV77.js → paths-UXLN5YYZ.js} +10 -5
  129. package/dist/{preload-6WVMHX3A.js → preload-P6DGH2PZ.js} +2 -2
  130. package/dist/{reset-BGW6OGMV.js → reset-L2FQEE3E.js} +16 -10
  131. package/dist/{run-YTPEYQOH.js → run-ZU3QMZPZ.js} +101 -61
  132. package/dist/{share-YIFFV4NQ.js → share-S5BZQC5I.js} +15 -8
  133. package/dist/{skills-2V6RA3OQ.js → skills-X5VXCRNQ.js} +34 -14
  134. package/dist/{skills-eval-S2TVJO4F.js → skills-eval-WKIHWTHR.js} +70 -34
  135. package/dist/steer-GGWFUJUD.js +77 -0
  136. package/dist/{targets-TYXLPB23.js → targets-SNCPI2NR.js} +43 -27
  137. package/dist/terminal-lease-BNAHVHBS.js +395 -0
  138. package/dist/{trace-GGOJ6Q6Z.js → trace-PNCASAXC.js} +41 -16
  139. package/dist/{chunk-N6F52NLF.js → tree-sitter-HGKH6LG4.js} +28 -2306
  140. package/dist/{uninstall-LLLT4F4W.js → uninstall-FZCQCDKC.js} +10 -5
  141. package/dist/{upgrade-33G2LMM5.js → upgrade-JQHHPQ4K.js} +45 -25
  142. package/dist/{usage-ZAFSXKKG.js → usage-OR4O5SMZ.js} +62 -31
  143. package/dist/verify-375KUB3Y.js +716 -0
  144. package/dist/web-fetch-2YHJ3KTG.js +638 -0
  145. package/dist/{wiki-generate-NUQCVOQ3.js → wiki-generate-UEXP2ARI.js} +74 -34
  146. package/dist/worker/entry.js +221 -36
  147. package/dist/workspace-G4ZWUIPR.js +22 -0
  148. package/docs/README.md +22 -17
  149. package/docs/acp.md +168 -16
  150. package/docs/alcf-provider.md +1 -1
  151. package/docs/architecture.md +136 -7
  152. package/docs/artifact-versions.md +1 -1
  153. package/docs/built-in-agents.md +1 -1
  154. package/docs/capacity-and-scheduling.md +1 -1
  155. package/docs/commands-and-modes.md +114 -71
  156. package/docs/config-knobs-audit.md +1 -3
  157. package/docs/configuration-and-targets.md +174 -46
  158. package/docs/context-engine.md +29 -6
  159. package/docs/development-pipeline.md +26 -1
  160. package/docs/dispatch-architecture-rationale.md +1 -1
  161. package/docs/documentation-coverage.md +2 -2
  162. package/docs/documentation-guide.md +1 -1
  163. package/docs/environment-variables.md +13 -5
  164. package/docs/eval-runner.md +1 -1
  165. package/docs/evals-internal.md +1 -1
  166. package/docs/evidence-and-memory.md +6 -2
  167. package/docs/evolution.md +2 -2
  168. package/docs/exit-codes-and-output.md +15 -9
  169. package/docs/extensions-and-sharing.md +9 -9
  170. package/docs/fleet-dispatch.md +7 -5
  171. package/docs/git-commit-provenance.md +120 -0
  172. package/docs/glossary.md +1 -1
  173. package/docs/installation-and-lifecycle.md +34 -27
  174. package/docs/middleware-and-components.md +1 -1
  175. package/docs/model-catalog.md +45 -14
  176. package/docs/observability.md +8 -5
  177. package/docs/performance-methodology.md +491 -0
  178. package/docs/pi-boundary.md +72 -0
  179. package/docs/proactive-memory.md +3 -3
  180. package/docs/prompt-envelope-and-tools.md +24 -3
  181. package/docs/provider-adapter-cookbook.md +57 -4
  182. package/docs/release-cut-checklist.md +129 -115
  183. package/docs/safety-model.md +9 -5
  184. package/docs/scientific-validation.md +3 -3
  185. package/docs/session-lifecycle.md +55 -12
  186. package/docs/skills-marketplace.md +12 -8
  187. package/docs/time-conventions.md +1 -1
  188. package/docs/tool-usage.md +3 -3
  189. package/docs/trace-store.md +1 -1
  190. package/docs/troubleshooting.md +10 -7
  191. package/docs/tui-design.md +47 -10
  192. package/docs/worker-dispatch-mechanics.md +1 -1
  193. package/package.json +19 -22
  194. package/skills/coding/ast-grep/SKILL.md +136 -0
  195. package/skills/coding/ast-grep/evals.md +56 -0
  196. package/skills/coding/ast-grep/references/rule_reference.md +297 -0
  197. package/skills/coding/coding-standards/SKILL.md +113 -0
  198. package/skills/coding/coding-standards/evals.md +34 -0
  199. package/skills/coding/prototype/SKILL.md +86 -0
  200. package/skills/coding/prototype/evals.md +42 -0
  201. package/skills/coding/prototype/references/LOGIC.md +67 -0
  202. package/skills/coding/prototype/references/UI.md +112 -0
  203. package/skills/coding/tdd/SKILL.md +101 -0
  204. package/skills/coding/tdd/evals.md +41 -0
  205. package/skills/coding/tdd/references/mocking.md +59 -0
  206. package/skills/coding/tdd/references/tests.md +77 -0
  207. package/skills/context/context-handoff/SKILL.md +126 -0
  208. package/skills/context/context-handoff/evals.md +57 -0
  209. package/skills/context/context-handoff/scripts/new-handoff.sh +26 -0
  210. package/skills/context/context-prime/SKILL.md +95 -0
  211. package/skills/context/context-prime/evals.md +54 -0
  212. package/skills/meta/clio-dev/SKILL.md +91 -0
  213. package/skills/meta/clio-dev/evals.md +45 -0
  214. package/skills/meta/clio-test/SKILL.md +130 -0
  215. package/skills/meta/clio-test/evals.md +43 -0
  216. package/skills/meta/clio-test/references/harness.md +97 -0
  217. package/skills/meta/clio-test/references/test-map.md +59 -0
  218. package/skills/meta/credentials/SKILL.md +125 -0
  219. package/skills/meta/credentials/evals.md +104 -0
  220. package/skills/meta/find-skills/SKILL.md +72 -0
  221. package/skills/meta/find-skills/evals.md +47 -0
  222. package/skills/meta/herdr/SKILL.md +127 -0
  223. package/skills/meta/herdr/evals.md +38 -0
  224. package/skills/meta/skill-craft/SKILL.md +102 -0
  225. package/skills/meta/skill-craft/evals.md +41 -0
  226. package/skills/planning/architecture/SKILL.md +129 -0
  227. package/skills/planning/architecture/evals.md +36 -0
  228. package/skills/planning/backlog/SKILL.md +90 -0
  229. package/skills/planning/backlog/evals.md +43 -0
  230. package/skills/planning/prd/SKILL.md +82 -0
  231. package/skills/planning/prd/evals.md +49 -0
  232. package/skills/planning/product-intent/SKILL.md +112 -0
  233. package/skills/planning/product-intent/evals.md +36 -0
  234. package/skills/planning/tech-spec/SKILL.md +115 -0
  235. package/skills/planning/tech-spec/evals.md +47 -0
  236. package/skills/registry.yaml +136 -0
  237. package/skills/research/arxiv-literature/SKILL.md +104 -0
  238. package/skills/research/arxiv-literature/evals.md +58 -0
  239. package/skills/research/experiment-protocol/SKILL.md +122 -0
  240. package/skills/research/experiment-protocol/evals.md +91 -0
  241. package/skills/research/scientific-debugging/SKILL.md +119 -0
  242. package/skills/research/scientific-debugging/evals.md +138 -0
  243. package/skills/research/scientific-modernization/SKILL.md +138 -0
  244. package/skills/research/scientific-modernization/evals.md +84 -0
  245. package/skills/workflow/design-council/SKILL.md +139 -0
  246. package/skills/workflow/design-council/evals.md +97 -0
  247. package/skills/workflow/grill-me/SKILL.md +186 -0
  248. package/skills/workflow/grill-me/evals.md +78 -0
  249. package/skills/workflow/workflow-distiller/SKILL.md +136 -0
  250. package/skills/workflow/workflow-distiller/evals.md +107 -0
  251. package/src/cli/acp.ts +31 -4
  252. package/src/cli/clio.ts +68 -6
  253. package/src/cli/config-inspect.ts +28 -22
  254. package/src/cli/configure.ts +47 -9
  255. package/src/cli/context-clear.ts +2 -2
  256. package/src/cli/context-index.ts +21 -23
  257. package/src/cli/context.ts +13 -8
  258. package/src/cli/default-target.ts +9 -17
  259. package/src/cli/docs.ts +11 -5
  260. package/src/cli/evidence.ts +4 -1
  261. package/src/cli/extensions.ts +10 -1
  262. package/src/cli/fleet.ts +47 -6
  263. package/src/cli/index.ts +55 -26
  264. package/src/cli/memory.ts +3 -1
  265. package/src/cli/models.ts +1 -1
  266. package/src/cli/modes/json-stream.ts +37 -1
  267. package/src/cli/modes/print.ts +24 -9
  268. package/src/cli/run.ts +2 -2
  269. package/src/cli/skills-eval.ts +23 -8
  270. package/src/cli/skills.ts +19 -4
  271. package/src/cli/targets.ts +4 -0
  272. package/src/cli/text-layout.ts +15 -5
  273. package/src/cli/trace.ts +62 -14
  274. package/src/cli/upgrade.ts +18 -2
  275. package/src/cli/usage.ts +10 -3
  276. package/src/cli/wiki-generate.ts +2 -1
  277. package/src/core/agent-environment.ts +7 -0
  278. package/src/core/bash-exec.ts +72 -1
  279. package/src/core/boot-trace.ts +9 -4
  280. package/src/core/bus-events.ts +20 -4
  281. package/src/core/commit-attribution.ts +157 -0
  282. package/src/core/compile-cache.ts +159 -0
  283. package/src/core/config.ts +131 -2
  284. package/src/core/defaults.ts +39 -5
  285. package/src/core/domain-loader.ts +12 -5
  286. package/src/core/git-commit-attribution.ts +387 -0
  287. package/src/core/incomplete-installation.ts +45 -0
  288. package/src/core/response-schema.ts +1 -1
  289. package/src/core/safe-exec.ts +13 -1
  290. package/src/core/settings-layers.ts +155 -21
  291. package/src/core/skill-activation.ts +1 -1
  292. package/src/core/startup-timer.ts +3 -3
  293. package/src/core/state-file-lock.ts +13 -1
  294. package/src/core/termination.ts +78 -5
  295. package/src/domains/config/classify.ts +15 -3
  296. package/src/domains/config/extension.ts +19 -13
  297. package/src/domains/config/index.ts +10 -0
  298. package/src/domains/config/keybindings.ts +45 -9
  299. package/src/domains/context/bootstrap-prompt.ts +1 -1
  300. package/src/domains/context/bootstrap.ts +111 -18
  301. package/src/domains/context/clear.ts +16 -11
  302. package/src/domains/context/clio-md.ts +111 -9
  303. package/src/domains/context/codewiki/artifact.ts +400 -0
  304. package/src/domains/context/codewiki/build-worker-protocol.ts +24 -0
  305. package/src/domains/context/codewiki/build-worker.ts +54 -0
  306. package/src/domains/context/codewiki/coordinator.ts +182 -0
  307. package/src/domains/context/codewiki/indexer.ts +59 -144
  308. package/src/domains/context/codewiki/paths.ts +67 -0
  309. package/src/domains/context/codewiki/schema.ts +80 -0
  310. package/src/domains/context/codewiki/tree-sitter.ts +1 -1
  311. package/src/domains/context/contract.ts +11 -5
  312. package/src/domains/context/extension.ts +94 -143
  313. package/src/domains/context/fingerprint.ts +3 -1
  314. package/src/domains/context/index.ts +12 -22
  315. package/src/domains/context/project-metadata.ts +19 -0
  316. package/src/domains/context/prompt-context.ts +9 -10
  317. package/src/domains/context/refresh.ts +29 -21
  318. package/src/domains/context/runtime.ts +17 -0
  319. package/src/domains/context/wiki/generate.ts +39 -34
  320. package/src/domains/context/wiki/plan.ts +1 -1
  321. package/src/domains/context/wiki/prompts.ts +21 -8
  322. package/src/domains/dispatch/code-step.ts +20 -1
  323. package/src/domains/dispatch/extension.ts +158 -21
  324. package/src/domains/dispatch/failure-classification.ts +6 -0
  325. package/src/domains/dispatch/fleet-commit-attribution.ts +56 -0
  326. package/src/domains/dispatch/orphan-recovery.ts +50 -8
  327. package/src/domains/dispatch/receipt-integrity.ts +5 -0
  328. package/src/domains/dispatch/state.ts +31 -6
  329. package/src/domains/dispatch/transport.ts +2 -1
  330. package/src/domains/dispatch/types.ts +14 -0
  331. package/src/domains/dispatch/worker-spawn.ts +21 -2
  332. package/src/domains/eval/metrics/context.ts +1 -1
  333. package/src/domains/eval/types.ts +0 -1
  334. package/src/domains/evidence/build.ts +41 -1
  335. package/src/domains/lifecycle/migrations/2026-08-18-lmstudio-runtime-id.ts +52 -0
  336. package/src/domains/lifecycle/migrations/index.ts +24 -4
  337. package/src/domains/middleware/hooks-io.ts +12 -0
  338. package/src/domains/middleware/skills-reminder.ts +30 -15
  339. package/src/domains/prompts/compiler.ts +142 -84
  340. package/src/domains/prompts/contract.ts +18 -2
  341. package/src/domains/prompts/extension.ts +39 -7
  342. package/src/domains/prompts/fragment-loader.ts +0 -1
  343. package/src/domains/prompts/fragments/identity/clio.md +2 -4
  344. package/src/domains/prompts/fragments/identity/docs-routing.md +10 -0
  345. package/src/domains/prompts/fragments/identity/self-awareness.md +1 -45
  346. package/src/domains/prompts/fragments/operating/contract.md +4 -50
  347. package/src/domains/prompts/fragments/operating/delegation.md +42 -0
  348. package/src/domains/prompts/fragments/operating/skills.md +26 -0
  349. package/src/domains/prompts/fragments/operating/worker.md +16 -0
  350. package/src/domains/prompts/fragments/safety/auto-edit.md +5 -5
  351. package/src/domains/prompts/fragments/safety/full-auto.md +3 -3
  352. package/src/domains/prompts/fragments/safety/read-only.md +4 -4
  353. package/src/domains/prompts/fragments/safety/suggest.md +2 -2
  354. package/src/domains/prompts/fragments/wiki/page.md +10 -0
  355. package/src/domains/prompts/fragments/wiki/plan.md +10 -0
  356. package/src/domains/prompts/preload.ts +3 -3
  357. package/src/domains/providers/auth/api-key.ts +1 -1
  358. package/src/domains/providers/auth/backend-file.ts +20 -10
  359. package/src/domains/providers/auth/backend-memory.ts +59 -4
  360. package/src/domains/providers/auth/boot-status.ts +65 -0
  361. package/src/domains/providers/auth/oauth.ts +2 -1
  362. package/src/domains/providers/auth/storage.ts +97 -38
  363. package/src/domains/providers/capabilities.ts +12 -4
  364. package/src/domains/providers/contract.ts +15 -4
  365. package/src/domains/providers/extension.ts +18 -6
  366. package/src/domains/providers/model-runtime-capabilities.ts +15 -4
  367. package/src/domains/providers/models/local-models/clio-local-coding-targets.yaml +118 -35
  368. package/src/domains/providers/plugins.ts +5 -3
  369. package/src/domains/providers/probe/fingerprint.ts +25 -5
  370. package/src/domains/providers/registry.ts +31 -10
  371. package/src/domains/providers/runtimes/boot-manifest.ts +55 -0
  372. package/src/domains/providers/runtimes/builtins.ts +2 -2
  373. package/src/domains/providers/runtimes/common/lmstudio-http.ts +423 -0
  374. package/src/domains/providers/runtimes/common/local-synth.ts +6 -7
  375. package/src/domains/providers/runtimes/local-native/lmstudio.ts +241 -0
  376. package/src/domains/providers/support.ts +6 -3
  377. package/src/domains/providers/types/local-model-quirks.ts +7 -9
  378. package/src/domains/providers/types/runtime-descriptor.ts +12 -1
  379. package/src/domains/providers/types/target-descriptor.ts +22 -0
  380. package/src/domains/resources/contract.ts +0 -1
  381. package/src/domains/resources/extension.ts +1 -3
  382. package/src/domains/resources/loader.ts +3 -4
  383. package/src/domains/resources/prompts/loader.ts +16 -2
  384. package/src/domains/resources/prompts/substitute.ts +1 -65
  385. package/src/domains/resources/skills/content-hash.ts +2 -0
  386. package/src/domains/resources/skills/install.ts +17 -0
  387. package/src/domains/resources/skills/loader.ts +17 -10
  388. package/src/domains/resources/skills/marketplace.ts +55 -9
  389. package/src/domains/safety/action-classifier.ts +4 -2
  390. package/src/domains/safety/audit.ts +8 -2
  391. package/src/domains/safety/extension.ts +1 -1
  392. package/src/domains/session/compaction/branch-summary.ts +3 -2
  393. package/src/domains/session/compaction/cut-point.ts +2 -1
  394. package/src/domains/session/compaction/tokens.ts +2 -1
  395. package/src/domains/session/context-ledger.ts +14 -0
  396. package/src/domains/session/contract.ts +15 -0
  397. package/src/domains/session/decision-board.ts +190 -0
  398. package/src/domains/session/entries.ts +66 -3
  399. package/src/domains/session/extension.ts +93 -12
  400. package/src/domains/session/retry.ts +10 -18
  401. package/src/domains/session/session-artifacts.ts +107 -0
  402. package/src/domains/session/task-board.ts +207 -13
  403. package/src/domains/session/tree/active-path.ts +44 -5
  404. package/src/domains/session/tree/fork.ts +26 -27
  405. package/src/domains/session/tree/preview.ts +2 -2
  406. package/src/domains/session/workspace/git-probe.ts +17 -11
  407. package/src/domains/user-tasks/store.ts +297 -0
  408. package/src/engine/acp/errors.ts +96 -0
  409. package/src/engine/acp/server.ts +1728 -146
  410. package/src/engine/acp/transport.ts +135 -14
  411. package/src/engine/acp/types.ts +26 -0
  412. package/src/engine/agent.ts +3 -3
  413. package/src/engine/ai.ts +32 -27
  414. package/src/engine/alcf-oauth.ts +26 -19
  415. package/src/engine/api-registry.ts +223 -0
  416. package/src/engine/apis/index.ts +3 -7
  417. package/src/engine/apis/llamacpp-residency.ts +49 -9
  418. package/src/engine/apis/lmstudio-residency.ts +5 -21
  419. package/src/engine/apis/lmstudio.ts +243 -0
  420. package/src/engine/apis/ollama-native.ts +24 -3
  421. package/src/engine/apis/openai-completions.ts +170 -91
  422. package/src/engine/apis/residency.ts +139 -3
  423. package/src/engine/apis/types.ts +16 -0
  424. package/src/engine/env-api-keys.ts +98 -0
  425. package/src/engine/gemma-channel-filter.ts +223 -0
  426. package/src/engine/instrumented-tui.ts +192 -0
  427. package/src/engine/messages.ts +14 -0
  428. package/src/engine/models.ts +42 -0
  429. package/src/engine/oauth.ts +16 -12
  430. package/src/engine/prompt-templates.ts +1 -0
  431. package/src/engine/provider-payload.ts +16 -59
  432. package/src/engine/strip-tokenizer-sentinels.ts +1 -1
  433. package/src/engine/truncate.ts +9 -0
  434. package/src/engine/tui.ts +17 -9
  435. package/src/engine/types.ts +3 -6
  436. package/src/engine/worker-runtime-capabilities.ts +5 -0
  437. package/src/engine/worker-runtime.ts +1 -1
  438. package/src/engine/worker-tools.ts +9 -4
  439. package/src/entry/boot-options.ts +50 -0
  440. package/src/entry/orchestrator.ts +288 -150
  441. package/src/interactive/application-controller.ts +89 -2
  442. package/src/interactive/chat-loop.ts +266 -41
  443. package/src/interactive/chat-panel.ts +715 -278
  444. package/src/interactive/chat-renderer.ts +306 -85
  445. package/src/interactive/clio-editor.ts +3 -8
  446. package/src/interactive/command-fallbacks.ts +2 -2
  447. package/src/interactive/context-overlay.ts +27 -1
  448. package/src/interactive/editor-submit.ts +253 -24
  449. package/src/interactive/export-html/ansi-to-html.ts +161 -0
  450. package/src/interactive/export-html/index.ts +51 -0
  451. package/src/interactive/export-html/template.ts +45 -0
  452. package/src/interactive/export-html/tool-renderer.ts +54 -0
  453. package/src/interactive/footer/dashboard.ts +4 -0
  454. package/src/interactive/footer/notifications.ts +1 -1
  455. package/src/interactive/footer/widgets.ts +42 -22
  456. package/src/interactive/footer-panel.ts +8 -3
  457. package/src/interactive/format-time.ts +14 -2
  458. package/src/interactive/interactive-application.ts +203 -17
  459. package/src/interactive/interactive-event-projection.ts +18 -1
  460. package/src/interactive/interactive-input-runtime.ts +50 -4
  461. package/src/interactive/interactive-presentation.ts +151 -19
  462. package/src/interactive/interactive-shell.ts +268 -14
  463. package/src/interactive/interactive-slash-runtime.ts +184 -117
  464. package/src/interactive/interactive-tickers.ts +38 -7
  465. package/src/interactive/keybinding-manager.ts +1 -1
  466. package/src/interactive/layout.ts +40 -3
  467. package/src/interactive/overlay-frame.ts +1 -1
  468. package/src/interactive/overlay-general-openers.ts +58 -1
  469. package/src/interactive/overlay-key-routing.ts +3 -0
  470. package/src/interactive/overlay-lifecycle.ts +13 -0
  471. package/src/interactive/overlay-permission-lifecycle.ts +2 -1
  472. package/src/interactive/overlay-session-lifecycle.ts +69 -12
  473. package/src/interactive/overlays/ask-user.ts +146 -24
  474. package/src/interactive/overlays/decisions.ts +300 -0
  475. package/src/interactive/overlays/help-reference.ts +15 -10
  476. package/src/interactive/overlays/model-selector.ts +34 -16
  477. package/src/interactive/overlays/session-selector.ts +18 -0
  478. package/src/interactive/overlays/settings.ts +105 -17
  479. package/src/interactive/overlays/skills-hub.ts +4 -4
  480. package/src/interactive/overlays/tree-selector.ts +41 -6
  481. package/src/interactive/render-trace.ts +499 -90
  482. package/src/interactive/renderers/compaction-summary.ts +2 -2
  483. package/src/interactive/renderers/diff.ts +115 -104
  484. package/src/interactive/renderers/mermaid.ts +53 -0
  485. package/src/interactive/renderers/tool-execution.ts +516 -168
  486. package/src/interactive/renderers/worker-entry.ts +20 -4
  487. package/src/interactive/session-switch-settlement.ts +10 -0
  488. package/src/interactive/slash-autocomplete.ts +6 -114
  489. package/src/interactive/slash-commands.ts +135 -47
  490. package/src/interactive/slash-spec.ts +9 -38
  491. package/src/interactive/status/controller.ts +5 -1
  492. package/src/interactive/status/index.ts +12 -1
  493. package/src/interactive/status/reasoning.ts +87 -0
  494. package/src/interactive/status/summary.ts +13 -2
  495. package/src/interactive/stdout-backpressure.ts +99 -0
  496. package/src/interactive/stream-pacer.ts +530 -0
  497. package/src/interactive/stream-pacing-policy.ts +66 -0
  498. package/src/interactive/tasks-overlay.ts +368 -14
  499. package/src/interactive/terminal-lease.ts +485 -0
  500. package/src/interactive/theme/tokens.ts +1 -1
  501. package/src/interactive/transcript-detail.ts +120 -0
  502. package/src/interactive/turn-context.ts +4 -3
  503. package/src/interactive/turn-persistence.ts +30 -13
  504. package/src/interactive/turn-queues.ts +12 -0
  505. package/src/interactive/turn-recovery.ts +25 -8
  506. package/src/interactive/turn-runtime.ts +79 -12
  507. package/src/interactive/turn-state.ts +10 -0
  508. package/src/interactive/view/artifacts.ts +114 -4
  509. package/src/interactive/view/view-overlay.ts +3 -0
  510. package/src/interactive/welcome-dashboard.ts +17 -16
  511. package/src/interactive/worker-receipts.ts +52 -3
  512. package/src/interactive/worker-stream.ts +5 -1
  513. package/src/tools/agent-tools.ts +23 -3
  514. package/src/tools/artifact.ts +2 -2
  515. package/src/tools/ask-user.ts +23 -13
  516. package/src/tools/bash.ts +30 -2
  517. package/src/tools/bootstrap.ts +34 -431
  518. package/src/tools/builtin-tool-catalog.ts +271 -0
  519. package/src/tools/codewiki/code-nav-surface.ts +29 -0
  520. package/src/tools/codewiki/code-nav.ts +8 -22
  521. package/src/tools/codewiki/shared.ts +41 -38
  522. package/src/tools/context/docs-engine.ts +14 -3
  523. package/src/tools/context/index.ts +107 -28
  524. package/src/tools/context/surface.ts +19 -0
  525. package/src/tools/core-bootstrap.ts +168 -0
  526. package/src/tools/credential-present.ts +5 -5
  527. package/src/tools/dispatch-admission.ts +533 -0
  528. package/src/tools/dispatch-background.ts +54 -0
  529. package/src/tools/dispatch-event-text.ts +6 -0
  530. package/src/tools/dispatch-plan.ts +9 -4
  531. package/src/tools/dispatch-run-events.ts +238 -0
  532. package/src/tools/dispatch-runner.ts +2370 -0
  533. package/src/tools/dispatch-scout-admission.ts +295 -0
  534. package/src/tools/dispatch-types.ts +77 -0
  535. package/src/tools/dispatch.ts +67 -3161
  536. package/src/tools/find.ts +4 -2
  537. package/src/tools/grep.ts +2 -2
  538. package/src/tools/lazy-tool.ts +60 -0
  539. package/src/tools/ledger.ts +3 -3
  540. package/src/tools/monitor-surface.ts +36 -0
  541. package/src/tools/monitor.ts +2 -32
  542. package/src/tools/observers.ts +2 -2
  543. package/src/tools/presentation.ts +107 -0
  544. package/src/tools/registry.ts +45 -27
  545. package/src/tools/safe-exec.ts +2 -2
  546. package/src/tools/steer-surface.ts +17 -0
  547. package/src/tools/steer.ts +2 -13
  548. package/src/tools/tasks.ts +108 -11
  549. package/src/tools/truncate.ts +25 -184
  550. package/src/tools/verify/frontend.ts +3 -1
  551. package/src/tools/verify/index.ts +3 -38
  552. package/src/tools/verify/surface.ts +46 -0
  553. package/src/tools/web-fetch-surface.ts +23 -0
  554. package/src/tools/web-fetch.ts +2 -20
  555. package/src/tools/write.ts +7 -2
  556. package/src/worker/entry.ts +39 -2
  557. package/src/worker/spec-contract.ts +26 -5
  558. package/dist/chunk-7SS2CTV2.js +0 -61361
  559. package/dist/chunk-DKGKUHFA.js +0 -924
  560. package/dist/chunk-GEP36Y4X.js +0 -12796
  561. package/dist/chunk-XYWBQRDM.js +0 -137
  562. package/dist/clio-BZVGEUFJ.js +0 -58
  563. package/dist/configure-S7S6F6CL.js +0 -32
  564. package/docs/html/agents_blueprint.html +0 -936
  565. package/docs/html/alcf_blueprint.html +0 -324
  566. package/docs/html/architecture_blueprint.html +0 -850
  567. package/docs/html/commands_blueprint.html +0 -939
  568. package/docs/html/config_knobs_audit_blueprint.html +0 -178
  569. package/docs/html/configuration_blueprint.html +0 -1080
  570. package/docs/html/context_blueprint.html +0 -603
  571. package/docs/html/documentation_blueprint.html +0 -832
  572. package/docs/html/environment_blueprint.html +0 -404
  573. package/docs/html/eval_blueprint.html +0 -743
  574. package/docs/html/evals_internal_blueprint.html +0 -190
  575. package/docs/html/evolution_blueprint.html +0 -674
  576. package/docs/html/extensions_blueprint.html +0 -2065
  577. package/docs/html/fleet_dispatch_blueprint.html +0 -286
  578. package/docs/html/index.html +0 -919
  579. package/docs/html/lifecycle_blueprint.html +0 -723
  580. package/docs/html/memory_blueprint.html +0 -699
  581. package/docs/html/middleware_blueprint.html +0 -664
  582. package/docs/html/models_blueprint.html +0 -2366
  583. package/docs/html/observability_blueprint.html +0 -683
  584. package/docs/html/provider_adapter_blueprint.html +0 -245
  585. package/docs/html/safety_blueprint.html +0 -1386
  586. package/docs/html/shared.css +0 -571
  587. package/docs/html/shared.js +0 -143
  588. package/docs/html/skills_blueprint.html +0 -671
  589. package/docs/html/soak_blueprint.html +0 -182
  590. package/docs/html/tool_usage_blueprint.html +0 -350
  591. package/docs/html/tools_blueprint.html +0 -2249
  592. package/docs/html/trace_blueprint.html +0 -235
  593. package/docs/html/tui_design_blueprint.html +0 -374
  594. package/docs/html/validation_blueprint.html +0 -961
  595. package/docs/html/worker_dispatch_blueprint.html +0 -231
  596. package/src/core/release.ts +0 -2
  597. package/src/domains/providers/runtimes/common/lmstudio-logger.ts +0 -32
  598. package/src/domains/providers/runtimes/local-native/lmstudio-native.ts +0 -491
  599. package/src/engine/apis/lmstudio-native.ts +0 -1438
  600. package/src/engine/apis/thinking-replay.ts +0 -11
  601. package/src/tools/string-enum.ts +0 -15
package/docs/html/soak_blueprint.html DELETED
@@ -1,182 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Clio Coder Soak Benchmark Blueprint (v0.3.1)</title>
7
- <link rel="stylesheet" href="shared.css">
8
- <style>
9
- .suite-card {
10
- background: var(--bg-card);
11
- border: 1px solid var(--border-card);
12
- border-radius: 8px;
13
- padding: 1.25rem;
14
- margin-bottom: 1.5rem;
15
- transition: border-color 0.2s ease;
16
- }
17
- .suite-card:hover {
18
- border-color: var(--border-card-hover);
19
- }
20
- .suite-header {
21
- display: flex;
22
- justify-content: space-between;
23
- align-items: center;
24
- margin-bottom: 0.75rem;
25
- }
26
- .suite-title {
27
- font-family: var(--font-mono);
28
- color: var(--color-cyan);
29
- font-size: 1.15rem;
30
- font-weight: 600;
31
- }
32
- .badge-tag {
33
- display: inline-block;
34
- padding: 0.2rem 0.6rem;
35
- border-radius: 4px;
36
- font-size: 0.75rem;
37
- font-family: var(--font-mono);
38
- background: rgba(0, 212, 219, 0.1);
39
- color: var(--color-cyan);
40
- border: 1px solid rgba(0, 212, 219, 0.3);
41
- margin-right: 0.5rem;
42
- }
43
- .badge-orange {
44
- background: rgba(255, 126, 41, 0.1);
45
- color: var(--color-orange);
46
- border-color: rgba(255, 126, 41, 0.3);
47
- }
48
- .badge-emerald {
49
- background: rgba(16, 185, 129, 0.1);
50
- color: var(--color-emerald);
51
- border-color: rgba(16, 185, 129, 0.3);
52
- }
53
- .badge-purple {
54
- background: rgba(189, 0, 255, 0.1);
55
- color: var(--color-purple);
56
- border-color: rgba(189, 0, 255, 0.3);
57
- }
58
- .invariant-table {
59
- width: 100%;
60
- border-collapse: collapse;
61
- margin-top: 1rem;
62
- font-size: 0.85rem;
63
- }
64
- .invariant-table th, .invariant-table td {
65
- padding: 0.6rem 0.8rem;
66
- text-align: left;
67
- border-bottom: 1px solid var(--border-card);
68
- }
69
- .invariant-table th {
70
- font-family: var(--font-mono);
71
- color: var(--text-muted);
72
- background: rgba(255, 255, 255, 0.02);
73
- }
74
- </style>
75
- </head>
76
- <body>
77
- <div class="container">
78
- <header>
79
- <div>
80
- <h1>Soak Benchmark Blueprint</h1>
81
- <p style="color: var(--text-muted);">Interactive specification and invariant reference for Clio soak suites (v0.3.1)</p>
82
- </div>
83
- <div>
84
- <span class="badge-tag">v0.3.1</span>
85
- <span class="badge-tag badge-orange">Machinery Invariants</span>
86
- </div>
87
- </header>
88
-
89
- <div style="background: rgba(0, 212, 219, 0.05); border: 1px solid rgba(0, 212, 219, 0.2); border-radius: 8px; padding: 1.25rem; margin-bottom: 2rem;">
90
- <h3 style="color: var(--color-cyan); margin-bottom: 0.5rem;">Core Principle: Measuring Clio, Not the Model</h3>
91
- <p style="font-size: 0.95rem;">Every standard evaluation suite measures model capability and only incidentally touches Clio. The soak suite inverts that relationship. A weak model that never solves the task passes if the machinery behaves; a strong model that solves the task fails the moment Clio fails to seal a receipt, cannot authenticate one, or violates a system invariant.</p>
92
- </div>
93
-
94
- <main>
95
- <section style="margin-bottom: 3rem;">
96
- <h2>The 4 Soak Suites</h2>
97
-
98
- <div class="suite-card">
99
- <div class="suite-header">
100
- <div class="suite-title">clio-soak.yaml</div>
101
- <span class="badge-tag">Machinery Under Load</span>
102
- </div>
103
- <p style="color: var(--text-muted); margin-bottom: 0.75rem;">Compares the headless main-agent surface against a dispatched worker surface across single-file and multi-file bug fixtures, plus compaction continuity.</p>
104
- <ul style="padding-left: 1.25rem; font-size: 0.9rem; color: var(--text-main);">
105
- <li><strong>Tasks:</strong> <code>single-file-bug.main-agent</code>, <code>single-file-bug.dispatch</code>, <code>multi-file-bug.main-agent</code>, <code>multi-file-bug.dispatch</code>, <code>compaction-continuity.main-agent</code>.</li>
106
- <li><strong>Gate Invariants:</strong> <code>receipt.sealed == true</code>, <code>receipt.integrityValid == true</code>, <code>receipt.outcomeMatchesExit == true</code>, <code>tokens.measured == true</code>, <code>stream.cumulativeSnapshots == 0</code>, <code>stream.usageDoubleCounted == false</code>, <code>stream.segmentUsageMatchesMessages == true</code>.</li>
107
- </ul>
108
- </div>
109
-
110
- <div class="suite-card">
111
- <div class="suite-header">
112
- <div class="suite-title">clio-soak-boundary.yaml</div>
113
- <span class="badge-tag badge-orange">Write Boundaries</span>
114
- </div>
115
- <p style="color: var(--text-muted); margin-bottom: 0.75rem;">Tests per-step write boundary enforcement without model participation. Enforcement is detect-and-rollback, never sandboxing.</p>
116
- <ul style="padding-left: 1.25rem; font-size: 0.9rem; color: var(--text-main);">
117
- <li><strong>Tasks:</strong> <code>write-boundary.rolled-back</code> (clean detect and git restoration), <code>write-boundary.rollback-incomplete</code> (honest reporting when prior bytes were dirty before snapshot).</li>
118
- <li><strong>Task Assertions:</strong> <code>boundary.verdictCount == 1</code>, <code>boundary.verdictSealed == true</code>, <code>boundary.violationsDetected == 1</code>, <code>boundary.violationsRolledBack</code>, <code>boundary.rollbackIncomplete</code>.</li>
119
- </ul>
120
- </div>
121
-
122
- <div class="suite-card">
123
- <div class="suite-header">
124
- <div class="suite-title">clio-soak-chaos.yaml</div>
125
- <span class="badge-tag badge-purple">SIGINT Fault Injection</span>
126
- </div>
127
- <p style="color: var(--text-muted); margin-bottom: 0.75rem;">Fault injection testing for process interrupt signals mid tool execution.</p>
128
- <ul style="padding-left: 1.25rem; font-size: 0.9rem; color: var(--text-main);">
129
- <li><strong>Tasks:</strong> <code>chaos.sigint-mid-tool</code>. Prompts Clio for a long-running tool, injects SIGINT once child process initializes, verifies exit code 130 and zero orphaned children.</li>
130
- <li><strong>Task Assertions:</strong> <code>chaos.exitCode == 130</code>, <code>process.orphanedChildren == 0</code>, <code>receipt.sealed == true</code>, <code>receipt.integrityValid == true</code>, <code>tokens.measured == true</code>.</li>
131
- </ul>
132
- </div>
133
-
134
- <div class="suite-card">
135
- <div class="suite-header">
136
- <div class="suite-title">clio-soak-loop.yaml</div>
137
- <span class="badge-tag badge-emerald">Bounded Loops</span>
138
- </div>
139
- <p style="color: var(--text-muted); margin-bottom: 0.75rem;">Gates iteration bounds and receipt usage accounting for fleet repair loops.</p>
140
- <ul style="padding-left: 1.25rem; font-size: 0.9rem; color: var(--text-main);">
141
- <li><strong>Tasks:</strong> <code>bounded-loop.fleet</code>.</li>
142
- <li><strong>Task Assertions:</strong> <code>loop.attemptsSpent &lt;= 3</code>, <code>loop.receiptsMatchRepairs == true</code>, <code>loop.skippedNodes == 0</code>, <code>receiptUsage.measured == true</code>.</li>
143
- <li><strong>Token Accountings:</strong> Demonstrates difference between <code>tokens.*</code> (wire streaming; false on fleet runs) and <code>receiptUsage.*</code> (authenticated journal receipts; true).</li>
144
- </ul>
145
- </div>
146
- </section>
147
-
148
- <section>
149
- <h2>Three-Layer Metric Classification</h2>
150
- <table class="invariant-table">
151
- <thead>
152
- <tr>
153
- <th>Layer</th>
154
- <th>Source / Location</th>
155
- <th>Role &amp; Behavior</th>
156
- </tr>
157
- </thead>
158
- <tbody>
159
- <tr>
160
- <td><code>verify.measure</code></td>
161
- <td>Task definition in YAML</td>
162
- <td>Records whether the model solved the task (<code>task.solved</code>, <code>task.exitCode</code>). Nonzero exit is recorded and <strong>never fails</strong> the item.</td>
163
- </tr>
164
- <tr>
165
- <td><code>thresholds.fail</code></td>
166
- <td>Suite-wide thresholds</td>
167
- <td>Gates universal promises (receipt sealing, receipt integrity, outcome consistency, token reporting). Unmeasured metrics fail closed.</td>
168
- </tr>
169
- <tr>
170
- <td><code>verify.assertions</code></td>
171
- <td>Per-task verify section</td>
172
- <td>Gates surface-specific promises (session ledger invariants for main-agent, process group cleanup for workers, boundary verdicts).</td>
173
- </tr>
174
- </tbody>
175
- </table>
176
- </section>
177
- </main>
178
- </div>
179
-
180
- <script src="shared.js"></script>
181
- </body>
182
- </html>
package/docs/html/tool_usage_blueprint.html DELETED
@@ -1,350 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Tool Usage Reference Blueprint (v0.3.1)</title>
7
- <link rel="stylesheet" href="shared.css">
8
- <style>
9
- /* Custom calculator styling */
10
- .calc-row {
11
- display: flex;
12
- justify-content: space-between;
13
- align-items: center;
14
- margin-bottom: 0.75rem;
15
- }
16
- .atlas-grid {
17
- display: grid;
18
- grid-template-columns: 200px 1fr;
19
- gap: 1.5rem;
20
- }
21
- .atlas-menu {
22
- display: flex;
23
- flex-direction: column;
24
- gap: 0.5rem;
25
- }
26
- .atlas-btn {
27
- background: rgba(255, 255, 255, 0.02);
28
- border: 1px solid var(--border-card);
29
- color: var(--text-muted);
30
- padding: 0.6rem 0.85rem;
31
- border-radius: 6px;
32
- font-size: 0.8rem;
33
- cursor: pointer;
34
- text-align: left;
35
- font-weight: 600;
36
- transition: all 0.2s;
37
- }
38
- .atlas-btn:hover {
39
- background: rgba(255, 255, 255, 0.06);
40
- color: #fff;
41
- }
42
- .atlas-btn.active {
43
- border-color: var(--color-cyan);
44
- color: var(--color-cyan);
45
- background: rgba(0, 212, 219, 0.05);
46
- }
47
- .atlas-details {
48
- background: rgba(0,0,0,0.2);
49
- border: 1px solid var(--border-card);
50
- border-radius: 10px;
51
- padding: 1.25rem;
52
- }
53
- @media (max-width: 768px) {
54
- .atlas-grid {
55
- grid-template-columns: 1fr;
56
- }
57
- }
58
- </style>
59
- </head>
60
- <body>
61
- <div class="container">
62
- <header>
63
- <div class="header-left">
64
- <div class="header-logo">
65
- <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="color: var(--color-cyan);"><title>Icon</title>
66
- <polyline points="22 12 18 12 15 21 9 3 6 12 2 12"></polyline>
67
- </svg>
68
- </div>
69
- <div class="header-title-wrapper">
70
- <h1>Tool Usage Reference</h1>
71
- <p>The seven-plane tool surface, observation budgets, and dynamic continuation limits</p>
72
- <div class="meta-chips-row">
73
- <span class="chip">Source: docs/tool-usage.md</span>
74
- <span class="chip chip-orange">clio-coder docs tool_usage</span>
75
- </div>
76
- </div>
77
- </div>
78
- <div class="header-right">
79
- <span class="version-badge">Clio Coder v0.3.1</span>
80
- <a href="index.html" class="back-btn">
81
- <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
82
- Dashboard Hub
83
- </a>
84
- </div>
85
- </header>
86
-
87
- <div class="page-layout-grid">
88
- <nav class="sidebar" aria-label="Table of Contents">
89
- <div class="toc-container">
90
- <div class="toc-title">On This Page</div>
91
- <ul class="toc-list">
92
- <!-- Dynamically populated -->
93
- </ul>
94
- </div>
95
- </nav>
96
-
97
- <main>
98
- <div class="glass-card">
99
- <h2>Overview Summary</h2>
100
- <p>Clio Coder exposes 20 built-in tools organized across 7 distinct planes. This reference covers argument surfaces, result formatting, and turn budget mechanics.</p>
101
- </div>
102
-
103
- <div class="tabs-nav">
104
- <button type="button" class="tab-btn active" onclick="switchTab('atlas')">
105
- Seven-Plane Tool Atlas
106
- </button>
107
- <button type="button" class="tab-btn" onclick="switchTab('calc')">
108
- Observation Envelope Calculator
109
- </button>
110
- </div>
111
-
112
- <!-- Tab 1: Tool Atlas -->
113
- <div class="tab-pane active" id="pane-atlas">
114
- <div class="glass-card">
115
- <h3>Tool Surface Planes</h3>
116
- <p>Select a plane below to explore its available tools and parameters:</p>
117
-
118
- <div class="atlas-grid" style="margin-top:1.5rem;">
119
- <div class="atlas-menu">
120
- <button type="button" class="atlas-btn active" onclick="selectPlane(1)">1. Observe Plane (7)</button>
121
- <button type="button" class="atlas-btn" onclick="selectPlane(2)">2. Mutate Plane (2)</button>
122
- <button type="button" class="atlas-btn" onclick="selectPlane(3)">3. Execute Plane (3)</button>
123
- <button type="button" class="atlas-btn" onclick="selectPlane(4)">4. Orchestrate Plane (4)</button>
124
- <button type="button" class="atlas-btn" onclick="selectPlane(5)">5. Retrieve Plane (1)</button>
125
- <button type="button" class="atlas-btn" onclick="selectPlane(6)">6. Interact Plane (1)</button>
126
- <button type="button" class="atlas-btn" onclick="selectPlane(7)">7. Artifact Plane (1)</button>
127
- </div>
128
-
129
- <div class="atlas-details" id="planeDetails">
130
- <!-- Populated dynamically -->
131
- </div>
132
- </div>
133
- </div>
134
- </div>
135
-
136
- <!-- Tab 2: Truncation Calculator -->
137
- <div class="tab-pane" id="pane-calc">
138
- <div class="blueprint-layout">
139
- <div class="specs-col">
140
- <div class="glass-card">
141
- <h3>Envelope &amp; Budget Parameters</h3>
142
- <p>Simulate a tool result to calculate truncation thresholds, offload directories, and per-turn budget usages:</p>
143
-
144
- <div class="form-group">
145
- <label for="toolSelect">Tool Type</label>
146
- <select id="toolSelect" onchange="runCalc()">
147
- <option value="read">read (cap: 50KB)</option>
148
- <option value="grep">grep (cap: 16KB)</option>
149
- <option value="find">find (cap: 8KB)</option>
150
- <option value="ls">ls (cap: 8KB)</option>
151
- <option value="code_nav">code_nav (cap: 16KB)</option>
152
- <option value="context">context (cap: 50KB)</option>
153
- </select>
154
- </div>
155
-
156
- <div class="form-group">
157
- <label for="resultSize">Collected Result Size (KB)</label>
158
- <input type="range" id="resultSize" min="1" max="100" step="1" value="25" oninput="runCalc()">
159
- <span id="txtResultSize" style="font-family:var(--font-mono); font-size:0.8rem;">25 KB</span>
160
- </div>
161
-
162
- <div class="form-group">
163
- <label for="budgetUsed">Budget Already Used in Turn (KB)</label>
164
- <input type="range" id="budgetUsed" min="0" max="250" step="10" value="40" oninput="runCalc()">
165
- <span id="txtBudgetUsed" style="font-family:var(--font-mono); font-size:0.8rem;">40 KB</span>
166
- </div>
167
- </div>
168
- </div>
169
-
170
- <div class="specs-col">
171
- <div class="glass-card">
172
- <h3>Simulator Verdict</h3>
173
-
174
- <div id="calcVerdictBox" class="verdict-box normal">
175
- <strong id="calcTitle" style="display:block; font-size:1.1rem">FITS CLEANLY</strong>
176
- <span id="calcDesc">Output fits within per-call caps and turn budgets.</span>
177
- </div>
178
-
179
- <div id="noticePreviewBox" style="margin-top:1.5rem;">
180
- <div class="form-group">
181
- <label>Envelope Notice String</label>
182
- </div>
183
- <pre><code id="noticeText">None (full content returned)</code></pre>
184
- </div>
185
- </div>
186
- </div>
187
- </div>
188
- </div>
189
-
190
- <!-- Related Navigation -->
191
- <nav class="related-nav" aria-label="Related Pages">
192
- <a href="environment_blueprint.html" class="nav-link-card">
193
- <span class="nav-label">Previous Blueprint</span>
194
- <span class="nav-title">Environment Variables</span>
195
- </a>
196
- <a href="provider_adapter_blueprint.html" class="nav-link-card next">
197
- <span class="nav-label">Next Blueprint</span>
198
- <span class="nav-title">Provider Adapter Cookbook</span>
199
- </a>
200
- </nav>
201
- </main>
202
- </div>
203
-
204
- <footer>
205
- <p>Clio Coder Tool Usage Blueprint &bull; Version 0.3.1 &bull; Gnosis Research Center</p>
206
- </footer>
207
- </div>
208
-
209
- <script src="shared.js"></script>
210
- <script>
211
- const PLANES = {
212
- 1: {
213
- title: "Observe Plane (7 Tools)",
214
- tools: [
215
- { name: "read", params: "path, offset, limit, tail", desc: "Reads text files line by line, capped at 50KB or 2000 lines. Larger files must be paged or offset." },
216
- { name: "grep", params: "pattern, path, mode, glob, ignore_case, literal, context, limit, include_ignored", desc: "Ripgrep search across workspace directory models (capped at 16KB content / 8KB files)." },
217
- { name: "find", params: "pattern, path, order, limit, include_ignored", desc: "Locates files by regex/glob matching (capped at 8KB)." },
218
- { name: "ls", params: "path, limit, include_ignored", desc: "Lists directory contents with file sizes and recursive child counts (capped at 8KB)." },
219
- { name: "code_nav", params: "mode, query, limit", desc: "Navigates CodeWiki symbol indexes, outlines, dependencies, dependents, or architecture pages (capped at 16KB)." },
220
- { name: "context", params: "scope, query, limit, name, include_tree", desc: "Gathers workspace priming context, documentation folders, or installed skill definitions (capped at 16KB docs / 50KB skills/workspace)." },
221
- { name: "credential_present", params: "name, source, file", desc: "Checks whether a required credential exists in environment or files without exposing secret values." }
222
- ]
223
- },
224
- 2: {
225
- title: "Mutate Plane (2 Tools)",
226
- tools: [
227
- { name: "write", params: "path, content", desc: "Atomically writes or overwrites entire file contents under write boundary governance." },
228
- { name: "edit", params: "path, edits: {oldText, newText}[]", desc: "Surgical matching/patching edits in files. Uses exact, whitespace-relaxed, and fuzzy match strategies." }
229
- ]
230
- },
231
- 3: {
232
- title: "Execute Plane (3 Tools)",
233
- tools: [
234
- { name: "bash", params: "command, cwd, timeout_ms", desc: "Executes shell commands within workspace boundaries and timeout limits (default 300,000 ms)." },
235
- { name: "git", params: "op, path, cached, stat, name_only, limit, cwd", desc: "Runs safe git status, diff, and log inspections." },
236
- { name: "verify", params: "check, focus", desc: "Runs declared project verification suites (tests, lints, typechecks, builds)." }
237
- ]
238
- },
239
- 4: {
240
- title: "Orchestrate Plane (4 Tools)",
241
- tools: [
242
- { name: "dispatch", params: "task, tasks, mode, detach, agent, target, model, node, failover, allowed_candidates, thinking_level, cwd, timeout_ms, briefing, max_output_bytes", desc: "Dispatches worker agents, compete worktree groups, or fan-out batch execution plans." },
243
- { name: "monitor", params: "run_id, mode", desc: "Inspects active/dispatched worker execution timelines, statuses, and receipts." },
244
- { name: "steer", params: "run_id, action, message", desc: "Steers with guidance or cancels in-flight worker execution runs." },
245
- { name: "tasks", params: "action, title, tasks, id, note", desc: "Manages structured session task boards across plan, add, start, done, block, and drop actions." }
246
- ]
247
- },
248
- 5: {
249
- title: "Retrieve Plane (1 Tool)",
250
- tools: [
251
- { name: "web_fetch", params: "url, method, headers, body, timeout_ms, max_bytes, format", desc: "Fetches external web documentation, arXiv/AlphaXiv papers, and APIs with boilerplate stripping (default 600KB)." }
252
- ]
253
- },
254
- 6: {
255
- title: "Interact Plane (1 Tool)",
256
- tools: [
257
- { name: "ask_user", params: "action, mode, questions, decisions, summary, max_rounds", desc: "Asks clarification questions or gets structured multi-choice decisions from operator." }
258
- ]
259
- },
260
- 7: {
261
- title: "Artifact Plane (1 Tool)",
262
- tools: [
263
- { name: "artifact", params: "kind, content, title, path", desc: "Writes terminal markdown blueprints, plans, reviews, or reports at workspace root." }
264
- ]
265
- }
266
- };
267
-
268
- function selectPlane(planeId) {
269
- document.querySelectorAll(".atlas-btn").forEach((b, idx) => {
270
- b.classList.toggle("active", idx + 1 === planeId);
271
- });
272
-
273
- const p = PLANES[planeId];
274
- let html = `<h3>${p.title}</h3><div style="margin-top:1rem; display:flex; flex-direction:column; gap:1.25rem;">`;
275
-
276
- p.tools.forEach(t => {
277
- html += `
278
- <div>
279
- <strong style="color:var(--color-cyan); font-family:var(--font-mono); font-size:1.05rem;">${t.name}()</strong>
280
- <div style="font-size:0.8rem; color:var(--text-dim); margin-bottom:0.25rem;">Arguments: <code>${t.params}</code></div>
281
- <p style="font-size:0.875rem; color:var(--text-muted); margin:0;">${t.desc}</p>
282
- </div>
283
- `;
284
- });
285
- html += "</div>";
286
-
287
- document.getElementById("planeDetails").innerHTML = html;
288
- if (window.initTableOfContents) window.initTableOfContents();
289
- }
290
-
291
- function runCalc() {
292
- const tool = document.getElementById("toolSelect").value;
293
- const size = parseInt(document.getElementById("resultSize").value);
294
- const used = parseInt(document.getElementById("budgetUsed").value);
295
-
296
- document.getElementById("txtResultSize").innerText = `${size} KB`;
297
- document.getElementById("txtBudgetUsed").innerText = `${used} KB`;
298
-
299
- let cap = 8;
300
- if (tool === 'read' || tool === 'context') cap = 50;
301
- if (tool === 'grep' || tool === 'code_nav') cap = 16;
302
-
303
- const totalBudget = 192;
304
- const budgetLeft = Math.max(0, totalBudget - used);
305
-
306
- const vBox = document.getElementById("calcVerdictBox");
307
- const vTitle = document.getElementById("calcTitle");
308
- const vDesc = document.getElementById("calcDesc");
309
- const notice = document.getElementById("noticeText");
310
-
311
- if (used >= totalBudget) {
312
- vBox.className = "verdict-box error";
313
- vTitle.innerText = "BUDGET EXHAUSTED";
314
- vDesc.innerText = `The per-turn observation budget is depleted. The call will short-circuit immediately.`;
315
- notice.innerText = `[observation budget exhausted for this turn before ${tool} ...]`;
316
- return;
317
- }
318
-
319
- const effectiveCap = Math.min(cap, budgetLeft);
320
-
321
- if (size <= effectiveCap) {
322
- vBox.className = "verdict-box normal";
323
- vTitle.innerText = "FITS CLEANLY";
324
- vDesc.innerText = `Result (${size} KB) fits inside effective cap of ${effectiveCap} KB (budget remaining: ${budgetLeft} KB).`;
325
- notice.innerText = `None (full content returned)`;
326
- } else {
327
- vBox.className = "verdict-box warn";
328
- vTitle.innerText = "TRUNCATED & OFFLOADED";
329
- vDesc.innerText = `Result (${size} KB) exceeds cap limits. Clio will truncate output to ${effectiveCap} KB and write full content to local scratch folder.`;
330
-
331
- let noticeStr = `[${tool}: ${Math.floor(effectiveCap * 10)}/100 lines shown (${effectiveCap}KB of ${size}KB)`;
332
- if (tool !== 'read') {
333
- noticeStr += ` | full: .clio-coder/state/scratch/session_123/call_abc.txt`;
334
- }
335
- noticeStr += ` | next: offset=${Math.floor(effectiveCap * 10) + 1}]`;
336
-
337
- notice.innerText = noticeStr;
338
- }
339
- }
340
-
341
- // Init
342
- window.onload = () => {
343
- selectPlane(1);
344
- runCalc();
345
- window.selectPlane = selectPlane;
346
- window.runCalc = runCalc;
347
- };
348
- </script>
349
- </body>
350
- </html>