@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/trace_blueprint.html DELETED
@@ -1,235 +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 Trace Store Blueprint (v0.3.1)</title>
7
- <link rel="stylesheet" href="shared.css">
8
- <style>
9
- .subcommand-card {
10
- background: var(--bg-card);
11
- border: 1px solid var(--border-card);
12
- border-radius: 8px;
13
- padding: 1.25rem;
14
- margin-bottom: 1rem;
15
- transition: border-color 0.2s ease;
16
- }
17
- .subcommand-card:hover {
18
- border-color: var(--border-card-hover);
19
- }
20
- .subcommand-title {
21
- font-family: var(--font-mono);
22
- color: var(--color-cyan);
23
- font-size: 1.1rem;
24
- font-weight: 600;
25
- margin-bottom: 0.5rem;
26
- }
27
- .badge-tag {
28
- display: inline-block;
29
- padding: 0.2rem 0.6rem;
30
- border-radius: 4px;
31
- font-size: 0.75rem;
32
- font-family: var(--font-mono);
33
- background: rgba(0, 212, 219, 0.1);
34
- color: var(--color-cyan);
35
- border: 1px solid rgba(0, 212, 219, 0.3);
36
- margin-right: 0.5rem;
37
- }
38
- .table-schema-grid {
39
- display: grid;
40
- grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
41
- gap: 1rem;
42
- margin-top: 1rem;
43
- }
44
- .schema-card {
45
- background: var(--bg-card);
46
- border: 1px solid var(--border-card);
47
- border-radius: 8px;
48
- padding: 1rem;
49
- }
50
- .schema-card h4 {
51
- font-family: var(--font-mono);
52
- color: var(--color-orange);
53
- margin-bottom: 0.5rem;
54
- }
55
- .sql-demo-box {
56
- background: rgba(13, 20, 38, 0.8);
57
- border: 1px solid var(--border-card);
58
- border-radius: 8px;
59
- padding: 1.25rem;
60
- margin-top: 1.5rem;
61
- }
62
- .sql-input {
63
- width: 100%;
64
- background: #060911;
65
- border: 1px solid var(--border-card);
66
- color: var(--text-main);
67
- font-family: var(--font-mono);
68
- padding: 0.75rem;
69
- border-radius: 6px;
70
- font-size: 0.9rem;
71
- margin-bottom: 0.75rem;
72
- }
73
- .sql-input:focus {
74
- outline: none;
75
- border-color: var(--color-cyan);
76
- }
77
- .sql-result {
78
- font-family: var(--font-mono);
79
- font-size: 0.85rem;
80
- background: #04060c;
81
- padding: 1rem;
82
- border-radius: 6px;
83
- white-space: pre-wrap;
84
- max-height: 250px;
85
- overflow-y: auto;
86
- }
87
- .sql-result.error {
88
- color: var(--color-rose);
89
- border-left: 3px solid var(--color-rose);
90
- }
91
- .sql-result.success {
92
- color: var(--color-emerald);
93
- border-left: 3px solid var(--color-emerald);
94
- }
95
- </style>
96
- </head>
97
- <body>
98
- <div class="container">
99
- <header>
100
- <div>
101
- <h1>Trace Store Blueprint</h1>
102
- <p style="color: var(--text-muted);">Interactive reference and query validator simulator for the SQLite trace mirror (v0.3.1)</p>
103
- </div>
104
- <div>
105
- <span class="badge-tag">v0.3.1</span>
106
- <span class="badge-tag" style="color: var(--color-orange); border-color: rgba(255, 126, 41, 0.3); background: rgba(255, 126, 41, 0.1);">Trace Mirror</span>
107
- </div>
108
- </header>
109
-
110
- <div style="margin-bottom: 2rem;">
111
- <p>Clio's trace database is a rebuildable, queryable SQLite mirror located at <code>&lt;stateDir&gt;/trace.sqlite</code>. Authoritative state remains in receipts, ledgers, and gate artifacts. Removing <code>trace.sqlite</code> causes no data loss. Writers enforce WAL journal mode and busy_timeout=5000; readers open in read-only mode.</p>
112
- </div>
113
-
114
- <main>
115
- <section style="margin-bottom: 3rem;">
116
- <h2>clio-coder trace Subcommands</h2>
117
- <p style="color: var(--text-muted); margin-bottom: 1.5rem;">The CLI exposes six dedicated subcommands for operational tracing and diagnostics:</p>
118
-
119
- <div class="subcommand-card">
120
- <div class="subcommand-title">clio-coder trace runs [--db PATH] [--limit N]</div>
121
- <p>Queries and formats recent execution runs up to limit N (1 to 500, default 50). Displays run status, start timestamp, total tokens, USD cost, and run ID.</p>
122
- </div>
123
-
124
- <div class="subcommand-card">
125
- <div class="subcommand-title">clio-coder trace phases &lt;runId&gt; [--db PATH]</div>
126
- <p>Lists execution phases for a specified run. Displays phase status, attempt index, owner, token count, USD cost, and phase name.</p>
127
- </div>
128
-
129
- <div class="subcommand-card">
130
- <div class="subcommand-title">clio-coder trace tail &lt;runId&gt; [--follow] [--db PATH]</div>
131
- <p>Streams append-ordered trace events by SQLite <code>rowid</code>. When <code>--follow</code> is enabled, polls every 500 ms until two consecutive idle polls observe a completed run status.</p>
132
- </div>
133
-
134
- <div class="subcommand-card">
135
- <div class="subcommand-title">clio-coder trace procs &lt;runId&gt; [--db PATH]</div>
136
- <p>Displays process records (orchestrator and worker) registered for a run. Shows process state (<code>live</code> or <code>ended</code>), PID, kind, name, and command line.</p>
137
- </div>
138
-
139
- <div class="subcommand-card">
140
- <div class="subcommand-title">clio-coder trace sql &lt;SELECT query&gt; [--db PATH]</div>
141
- <p>Executes a single read-only <code>SELECT</code> or <code>WITH</code> query against the trace store. Rejects semicolons and data modification statements (<code>INSERT</code>, <code>UPDATE</code>, <code>DELETE</code>, etc.).</p>
142
- </div>
143
-
144
- <div class="subcommand-card">
145
- <div class="subcommand-title">clio-coder trace ui [--db PATH] [--port N]</div>
146
- <p>Launches the web-based trace viewer server on the specified port. Requires source checkout with <code>apps/trace-viewer/server.mjs</code>.</p>
147
- </div>
148
- </section>
149
-
150
- <section style="margin-bottom: 3rem;">
151
- <h2>Database Schema</h2>
152
- <div class="table-schema-grid">
153
- <div class="schema-card">
154
- <h4>runs</h4>
155
- <p style="font-size: 0.85rem; color: var(--text-muted);">Terminal run records, statuses, models, targets, node, timing, total tokens, total USD cost. Interactive session turns are recorded here too, under assignment_id "session".</p>
156
- </div>
157
- <div class="schema-card">
158
- <h4>phases</h4>
159
- <p style="font-size: 0.85rem; color: var(--text-muted);">Sequence phases, attempt index, retries, worker owner, itemized token and dollar spend, context occupancy.</p>
160
- </div>
161
- <div class="schema-card">
162
- <h4>events</h4>
163
- <p style="font-size: 0.85rem; color: var(--text-muted);">Append-ordered events by rowid. Tool calls are spans with ended_at; point events have null ended_at.</p>
164
- </div>
165
- <div class="schema-card">
166
- <h4>envelopes</h4>
167
- <p style="font-size: 0.85rem; color: var(--text-muted);">Agent output envelopes, valid flags, attempt indices, and output types.</p>
168
- </div>
169
- <div class="schema-card">
170
- <h4>gate_results</h4>
171
- <p style="font-size: 0.85rem; color: var(--text-muted);">Typed reviewer/judge verdicts, passed status, and itemized checks JSON array.</p>
172
- </div>
173
- <div class="schema-card">
174
- <h4>agent_sessions</h4>
175
- <p style="font-size: 0.85rem; color: var(--text-muted);">Mirrored worker/model/session context occupancy records.</p>
176
- </div>
177
- <div class="schema-card">
178
- <h4>processes</h4>
179
- <p style="font-size: 0.85rem; color: var(--text-muted);">Registered worker processes, PIDs, redacted command string, and SHA-256 command digest.</p>
180
- </div>
181
- <div class="schema-card">
182
- <h4>meta</h4>
183
- <p style="font-size: 0.85rem; color: var(--text-muted);">Schema version metadata table (enforces schema_version = 1).</p>
184
- </div>
185
- </div>
186
- </section>
187
-
188
- <section>
189
- <h2>Interactive Read-Only SQL Query Simulator</h2>
190
- <p style="color: var(--text-muted);">Test SQL queries against the strict <code>clio-coder trace sql</code> read-only validator rule set:</p>
191
-
192
- <div class="sql-demo-box">
193
- <input type="text" id="sqlQueryInput" class="sql-input" value="SELECT run_id, status, total_tokens, total_cost_usd FROM runs LIMIT 10">
194
- <button type="button" id="sqlTestBtn" style="background: var(--gradient-main); color: #000; border: none; padding: 0.5rem 1.25rem; border-radius: 6px; font-weight: 600; cursor: pointer; margin-bottom: 1rem;">Validate Query</button>
195
- <div id="sqlOutput" class="sql-result success">Validation passed: Read-only SELECT query is valid.</div>
196
- </div>
197
- </section>
198
- </main>
199
- </div>
200
-
201
- <script src="shared.js"></script>
202
- <script>
203
- document.addEventListener("DOMContentLoaded", () => {
204
- const input = document.getElementById("sqlQueryInput");
205
- const btn = document.getElementById("sqlTestBtn");
206
- const output = document.getElementById("sqlOutput");
207
-
208
- function validateSql(sql) {
209
- const trimmed = sql.trim();
210
- if (!/^(SELECT|WITH)\b/i.test(trimmed)) {
211
- return { ok: false, msg: "Error: trace sql accepts SELECT or read-only WITH queries only." };
212
- }
213
- if (trimmed.includes(";")) {
214
- return { ok: false, msg: "Error: trace sql accepts exactly one statement (no semicolons allowed)." };
215
- }
216
- if (/\b(INSERT|UPDATE|DELETE|REPLACE|CREATE|ALTER|DROP|ATTACH|DETACH|VACUUM|PRAGMA)\b/i.test(trimmed)) {
217
- return { ok: false, msg: "Error: trace sql query is not read-only (mutation keyword detected)." };
218
- }
219
- return { ok: true, msg: "Validation passed: Query is strictly read-only SELECT/WITH." };
220
- }
221
-
222
- btn.addEventListener("click", () => {
223
- const result = validateSql(input.value);
224
- if (result.ok) {
225
- output.className = "sql-result success";
226
- output.textContent = result.msg;
227
- } else {
228
- output.className = "sql-result error";
229
- output.textContent = result.msg;
230
- }
231
- });
232
- });
233
- </script>
234
- </body>
235
- </html>
package/docs/html/tui_design_blueprint.html DELETED
@@ -1,374 +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>TUI Design System Blueprint (v0.3.1)</title>
7
- <link rel="stylesheet" href="shared.css">
8
- <style>
9
- /* Terminal custom styles */
10
- .terminal-container {
11
- background: #060913;
12
- border: 1px solid #1f354f;
13
- border-radius: 8px;
14
- font-family: var(--font-mono);
15
- font-size: 0.85rem;
16
- padding: 1.25rem;
17
- color: #b0c4de;
18
- box-shadow: inset 0 0 10px rgba(0,0,0,0.8);
19
- position: relative;
20
- }
21
- .terminal-header {
22
- border-bottom: 1px solid #1f354f;
23
- padding-bottom: 0.5rem;
24
- margin-bottom: 0.75rem;
25
- display: flex;
26
- justify-content: space-between;
27
- align-items: center;
28
- font-size: 0.75rem;
29
- color: #6a7c85;
30
- }
31
-
32
- .tui-accent { color: #46e5d0; }
33
- .tui-accent-deep { color: #1fb7a6; font-weight: bold; }
34
- .tui-action { color: #ff7e29; }
35
- .tui-success { color: #57e389; }
36
- .tui-warn { color: #ffb454; }
37
- .tui-error { color: #ff5c66; }
38
- .tui-reason { color: #9d8cff; }
39
- .tui-dim { color: #6a7a85; }
40
- .tui-muted { color: #8a99a4; }
41
-
42
- .color-swatch {
43
- width: 20px;
44
- height: 20px;
45
- border-radius: 4px;
46
- border: 1px solid rgba(255,255,255,0.1);
47
- display: inline-block;
48
- vertical-align: middle;
49
- }
50
- </style>
51
- </head>
52
- <body>
53
- <div class="container">
54
- <header>
55
- <div class="header-left">
56
- <div class="header-logo">
57
- <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>
58
- <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
59
- <line x1="9" y1="3" x2="9" y2="21"></line>
60
- </svg>
61
- </div>
62
- <div class="header-title-wrapper">
63
- <h1>Clio TUI Design System</h1>
64
- <p>Glyph vocabularies, layout rules, and live CLI transcript terminal formatting</p>
65
- <div class="meta-chips-row">
66
- <span class="chip">Source: docs/tui-design.md</span>
67
- <span class="chip chip-orange">clio-coder docs tui_design</span>
68
- </div>
69
- </div>
70
- </div>
71
- <div class="header-right">
72
- <span class="version-badge">Clio Coder v0.3.1</span>
73
- <a href="index.html" class="back-btn">
74
- <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>
75
- Dashboard Hub
76
- </a>
77
- </div>
78
- </header>
79
-
80
- <div class="page-layout-grid">
81
- <nav class="sidebar" aria-label="Table of Contents">
82
- <div class="toc-container">
83
- <div class="toc-title">On This Page</div>
84
- <ul class="toc-list">
85
- <!-- Dynamically populated -->
86
- </ul>
87
- </div>
88
- </nav>
89
-
90
- <main>
91
- <div class="glass-card">
92
- <h2>Overview Summary</h2>
93
- <p>Clio's interactive TUI operates under the core design tenet: color indicates state, boxes outline structure, and brand icons represent identity. Everything that is not state or structure remains visually quiet.</p>
94
- </div>
95
-
96
- <div class="tabs-nav">
97
- <button type="button" class="tab-btn active" onclick="switchTab('token-lab')">
98
- Color &amp; Glyph Lab
99
- </button>
100
- <button type="button" class="tab-btn" onclick="switchTab('terminal-sim')">
101
- Transcript Previewer
102
- </button>
103
- </div>
104
-
105
- <!-- Tab 1: Token Lab -->
106
- <div class="tab-pane active" id="pane-token-lab">
107
- <div class="blueprint-layout">
108
- <div class="specs-col">
109
- <div class="glass-card">
110
- <h3>TUI Color Semantic Tokens</h3>
111
- <p>Click any token row to highlight in the simulator:</p>
112
-
113
- <table class="env-table" style="cursor: pointer;">
114
- <thead>
115
- <tr>
116
- <th>Token</th>
117
- <th>Color Value</th>
118
- <th>Typical Role</th>
119
- </tr>
120
- </thead>
121
- <tbody>
122
- <tr onclick="previewToken('accent')">
123
- <td class="env-name" style="color:#46e5d0;">accent</td>
124
- <td><span class="color-swatch" style="background:#46e5d0;"></span> #46E5D0</td>
125
- <td>Brand headers, cursor, tool actions, interactive prompts</td>
126
- </tr>
127
- <tr onclick="previewToken('accentDeep')">
128
- <td class="env-name" style="color:#1fb7a6;">accentDeep</td>
129
- <td><span class="color-swatch" style="background:#1fb7a6;"></span> #1FB7A6</td>
130
- <td>Structural emphasis only: bold CAPS section tags (WORKSPACE, ROUTE, NEXT)</td>
131
- </tr>
132
- <tr onclick="previewToken('action')">
133
- <td class="env-name" style="color:#ff7e29;">action</td>
134
- <td><span class="color-swatch" style="background:#ff7e29;"></span> #FF7E29</td>
135
- <td>Active operations only: dispatching, running connect/probe, STEER mode tag</td>
136
- </tr>
137
- <tr onclick="previewToken('success')">
138
- <td class="env-name" style="color:#57e389;">success</td>
139
- <td><span class="color-swatch" style="background:#57e389;"></span> #57E389</td>
140
- <td>Success ticks, clean state status, verified health</td>
141
- </tr>
142
- <tr onclick="previewToken('warning')">
143
- <td class="env-name" style="color:#ffb454;">warning</td>
144
- <td><span class="color-swatch" style="background:#ffb454;"></span> #FFB454</td>
145
- <td>Warnings, truncations, cache issues, retry state</td>
146
- </tr>
147
- <tr onclick="previewToken('error')">
148
- <td class="env-name" style="color:#ff5c66;">error</td>
149
- <td><span class="color-swatch" style="background:#ff5c66;"></span> #FF5C66</td>
150
- <td>Failures, bad loops, errors, critical alerts</td>
151
- </tr>
152
- <tr onclick="previewToken('reason')">
153
- <td class="env-name" style="color:#9d8cff;">reason</td>
154
- <td><span class="color-swatch" style="background:#9d8cff;"></span> #9D8CFF</td>
155
- <td>Purple reasoning fields, thinking rails, compacting state</td>
156
- </tr>
157
- <tr onclick="previewToken('dim')">
158
- <td class="env-name" style="color:#6a7a85;">dim</td>
159
- <td><span class="color-swatch" style="background:#6a7a85;"></span> #6A7A85</td>
160
- <td>Keys, delimiters, separators, usage receipts</td>
161
- </tr>
162
- <tr onclick="previewToken('muted')">
163
- <td class="env-name" style="color:#8a99a4;">muted</td>
164
- <td><span class="color-swatch" style="background:#8a99a4;"></span> #8A99A4</td>
165
- <td>Secondary content, paths, previews, telemetry values</td>
166
- </tr>
167
- </tbody>
168
- </table>
169
- </div>
170
- </div>
171
-
172
- <div class="specs-col">
173
- <div class="glass-card">
174
- <h3>Glyph Vocabulary Constants</h3>
175
- <p>Glyph representations loaded from <code>glyphs.ts</code>:</p>
176
-
177
- <table class="env-table">
178
- <thead>
179
- <tr>
180
- <th>Symbol</th>
181
- <th>Token Key</th>
182
- <th>Role</th>
183
- </tr>
184
- </thead>
185
- <tbody>
186
- <tr>
187
- <td style="font-size:1.1rem; text-align:center;"><code>✦</code></td>
188
- <td><code>agent</code></td>
189
- <td>Voice character for Clio Agent response lines (accent; red on error)</td>
190
- </tr>
191
- <tr>
192
- <td style="font-size:1.1rem; text-align:center;"><code>›</code></td>
193
- <td><code>user</code></td>
194
- <td>Voice character for user prompts (accent)</td>
195
- </tr>
196
- <tr>
197
- <td style="font-size:1.1rem; text-align:center;"><code>✓</code></td>
198
- <td><code>ok</code></td>
199
- <td>Success indicator checks</td>
200
- </tr>
201
- <tr>
202
- <td style="font-size:1.1rem; text-align:center;"><code>✗</code></td>
203
- <td><code>error</code></td>
204
- <td>Failure indicator cross</td>
205
- </tr>
206
- <tr>
207
- <td style="font-size:1.1rem; text-align:center;"><code>▸</code></td>
208
- <td><code>toolHeader</code></td>
209
- <td>Tool ledger header and subline indicator</td>
210
- </tr>
211
- <tr>
212
- <td style="font-size:1.1rem; text-align:center;"><code>◆</code></td>
213
- <td><code>active</code></td>
214
- <td>Active/selected entity mark (Settings profile workbench)</td>
215
- </tr>
216
- <tr>
217
- <td style="font-size:1.1rem; text-align:center;"><code>▰ ▒ ▱</code></td>
218
- <td><code>contextMeters</code></td>
219
- <td>Context gauge cells (used, reserve, free)</td>
220
- </tr>
221
- </tbody>
222
- </table>
223
- </div>
224
- </div>
225
- </div>
226
- </div>
227
-
228
- <!-- Tab 2: Transcript Sim -->
229
- <div class="tab-pane" id="pane-terminal-sim">
230
- <div class="blueprint-layout">
231
- <div class="specs-col">
232
- <div class="glass-card">
233
- <h3>Choreography Options</h3>
234
- <p>Configure the state of the active step in our simulated terminal:</p>
235
-
236
- <div class="form-group">
237
- <label for="stepState">Active Step State</label>
238
- <select id="stepState" onchange="renderTerminalSim()">
239
- <option value="launchpad">Launchpad (Pre-Submit)</option>
240
- <option value="thinking">Model Thinking (reasoning Purple)</option>
241
- <option value="executing">Tool Executing (gear Cyan)</option>
242
- <option value="success">Success Final (Voice Turn + Hanging Indent)</option>
243
- <option value="error">Failure Blocked (cross Red)</option>
244
- </select>
245
- </div>
246
-
247
- <div class="form-group">
248
- <label for="inputText">Simulated Prompt</label>
249
- <input type="text" id="inputText" value="Summarize repository boundaries and verify compilation." oninput="renderTerminalSim()">
250
- </div>
251
- </div>
252
- </div>
253
-
254
- <div class="specs-col">
255
- <div class="glass-card">
256
- <h3>Simulated CLI Frame Preview</h3>
257
-
258
- <div class="terminal-container" id="terminalSim">
259
- <!-- Generated dynamically -->
260
- </div>
261
- </div>
262
- </div>
263
- </div>
264
- </div>
265
-
266
- <!-- Related Navigation -->
267
- <nav class="related-nav" aria-label="Related Pages">
268
- <a href="provider_adapter_blueprint.html" class="nav-link-card">
269
- <span class="nav-label">Previous Blueprint</span>
270
- <span class="nav-title">Provider Adapter Cookbook</span>
271
- </a>
272
- <a href="worker_dispatch_blueprint.html" class="nav-link-card next">
273
- <span class="nav-label">Next Blueprint</span>
274
- <span class="nav-title">Worker Dispatch Mechanics</span>
275
- </a>
276
- </nav>
277
- </main>
278
- </div>
279
-
280
- <footer>
281
- <p>Clio Coder TUI Blueprint &bull; Version 0.3.1 &bull; Gnosis Research Center</p>
282
- </footer>
283
- </div>
284
-
285
- <script src="shared.js"></script>
286
- <script>
287
- function previewToken(token) {
288
- alert(`Token ${token} clicked. Semantics are loaded natively under themes/tokens.ts`);
289
- }
290
-
291
- function renderTerminalSim() {
292
- const state = document.getElementById("stepState").value;
293
- const cmd = document.getElementById("inputText").value;
294
- const container = document.getElementById("terminalSim");
295
-
296
- let html = "";
297
-
298
- if (state === 'launchpad') {
299
- html += `
300
- <div class="terminal-header"><span>&gt;C_ Clio Coder v0.3.1</span><span class="tui-warn">EXPERIMENTAL</span></div>
301
- <div style="margin-bottom:0.75rem;">
302
- <div>&nbsp;&nbsp;<span class="tui-accent-deep">WORKSPACE</span>&nbsp;&nbsp;<span class="tui-muted">clio-coder &middot; git v0.3.1</span></div>
303
- <div>&nbsp;&nbsp;<span class="tui-accent-deep">ROUTE</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="tui-success">local-lmstudio/qwen &middot; ready</span></div>
304
- <div>&nbsp;&nbsp;<span class="tui-accent-deep">NEXT</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="tui-success">ctx ready &middot; type a task</span></div>
305
- </div>
306
- <div style="border-top:1px solid #1f354f; padding-top:0.5rem; color:#6a7c85;">
307
- Ask Clio&hellip; &nbsp;/ for commands
308
- </div>
309
- <div style="margin-top:0.75rem; padding-top:0.5rem; border-top:1px solid #1f354f; font-size:0.75rem; color:#8a99a4;">
310
- clio-coder &middot; git v0.3.1<br>
311
- <span class="tui-dim">ctx 8k/128k &middot; turn &middot; in 0 &middot; out 0</span>
312
- </div>
313
- `;
314
- } else {
315
- html += `<div class="terminal-header"><span>&gt;C_ Clio Coder v0.3.1 &middot; EXPERIMENTAL &middot; ctx ready</span></div>`;
316
- html += `<div><span class="tui-accent">›</span> <span style="color:#fff;">${cmd}</span></div>`;
317
-
318
- if (state === 'thinking') {
319
- html += `
320
- <div style="margin-top:0.5rem;"><span class="tui-dim">Thinking (142 tokens)&hellip;</span></div>
321
- <div style="margin-top:0.25rem; border-left: 2px solid #9d8cff; padding-left: 0.5rem; color:#888;">
322
- Analyzing source module boundaries and key contracts&hellip;<br>
323
- Checking compilation targets under dist/&hellip;
324
- </div>
325
- `;
326
- } else if (state === 'executing') {
327
- html += `
328
- <div style="margin-top:0.5rem; color:#8a99a4;">
329
- <span class="tui-accent">▸</span> <strong class="tui-accent">bash</strong> command="npm run build" &middot; 240ms <span class="tui-success">✓</span>
330
- </div>
331
- `;
332
- } else if (state === 'success') {
333
- html += `
334
- <div style="margin-top:0.5rem; color:#8a99a4;">
335
- <span class="tui-accent">▸</span> <strong class="tui-accent">read_file</strong> path="docs/tui-design.md" &middot; 14kB <span class="tui-success">✓</span>
336
- </div>
337
- <div style="margin-top:0.5rem; line-height: 1.4;">
338
- <div><span class="tui-accent">✦</span> The codebase enforces strict separation between interactive presentation layers</div>
339
- <div style="padding-left: 1rem; color: #b0c4de;">and core domain primitives. All 12 revamped TUI surfaces are fully aligned.</div>
340
- </div>
341
- <div style="margin-top:0.4rem; font-size:0.75rem; color:#6a7a85;">
342
- &nbsp;&nbsp;turn &middot; in 1.4k &middot; out 420
343
- </div>
344
- `;
345
- } else if (state === 'error') {
346
- html += `
347
- <div style="margin-top:0.5rem; line-height: 1.4;">
348
- <div><span class="tui-error">✦</span> Build verification failed with unresolved type errors.</div>
349
- <div style="padding-left: 1rem; color: #ff5c66;">Error: Cannot find module './missing-component.js'</div>
350
- </div>
351
- `;
352
- }
353
-
354
- html += `
355
- <div style="margin-top:0.75rem; padding-top:0.5rem; border-top:1px solid #1f354f; font-size:0.75rem; color:#8a99a4;">
356
- clio-coder &middot; git v0.3.1<br>
357
- <span class="tui-dim">ctx 14k/128k &middot; turn &middot; in 1.4k &middot; out 420</span>
358
- </div>
359
- `;
360
- }
361
-
362
- container.innerHTML = html;
363
- if (window.initTableOfContents) window.initTableOfContents();
364
- }
365
-
366
- // Init
367
- window.onload = () => {
368
- renderTerminalSim();
369
- window.previewToken = previewToken;
370
- window.renderTerminalSim = renderTerminalSim;
371
- };
372
- </script>
373
- </body>
374
- </html>