@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/validation_blueprint.html DELETED
@@ -1,961 +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 Scientific Validation Blueprint</title>
7
-
8
- <style>
9
- :root {
10
- --bg-dark: #090d16;
11
- --bg-card: rgba(17, 24, 39, 0.7);
12
- --border-card: rgba(255, 255, 255, 0.08);
13
- --text-main: #f3f4f6;
14
- --text-muted: #9ca3af;
15
- --text-dark: #6b7280;
16
-
17
- --color-cyan: #00f0ff;
18
- --color-cyan-rgb: 0, 240, 255;
19
- --color-purple: #bd00ff;
20
- --color-purple-rgb: 189, 0, 255;
21
- --color-emerald: #10b981;
22
- --color-emerald-rgb: 16, 185, 129;
23
- --color-amber: #f59e0b;
24
- --color-amber-rgb: 245, 158, 11;
25
- --color-rose: #ef4444;
26
- --color-rose-rgb: 239, 68, 68;
27
-
28
- --gradient-main: linear-gradient(135deg, var(--color-cyan), var(--color-purple));
29
- --shadow-glow: 0 0 20px rgba(var(--color-cyan-rgb), 0.15);
30
- --font-sans: "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", Arial, sans-serif;
31
- --font-mono: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
32
- }
33
-
34
- * {
35
- box-sizing: border-box;
36
- margin: 0;
37
- padding: 0;
38
- }
39
-
40
- body {
41
- background-color: var(--bg-dark);
42
- background-image:
43
- radial-gradient(circle at 10% 20%, rgba(var(--color-cyan-rgb), 0.05) 0%, transparent 40%),
44
- radial-gradient(circle at 90% 80%, rgba(var(--color-purple-rgb), 0.05) 0%, transparent 40%),
45
- radial-gradient(circle at 50% 50%, #0d1527 0%, var(--bg-dark) 100%);
46
- color: var(--text-main);
47
- font-family: var(--font-sans);
48
- min-height: 100vh;
49
- line-height: 1.6;
50
- overflow-x: hidden;
51
- }
52
-
53
- ::-webkit-scrollbar {
54
- width: 8px;
55
- height: 8px;
56
- }
57
- ::-webkit-scrollbar-track {
58
- background: rgba(255, 255, 255, 0.02);
59
- }
60
- ::-webkit-scrollbar-thumb {
61
- background: rgba(255, 255, 255, 0.1);
62
- border-radius: 4px;
63
- }
64
- ::-webkit-scrollbar-thumb:hover {
65
- background: rgba(var(--color-cyan-rgb), 0.3);
66
- }
67
-
68
- .container {
69
- max-width: 1400px;
70
- margin: 0 auto;
71
- padding: 2rem;
72
- }
73
-
74
- header {
75
- text-align: center;
76
- margin-bottom: 2.5rem;
77
- position: relative;
78
- }
79
-
80
- .header-logo {
81
- display: inline-flex;
82
- align-items: center;
83
- justify-content: center;
84
- width: 72px;
85
- height: 72px;
86
- background: rgba(255, 255, 255, 0.03);
87
- border: 1px solid var(--border-card);
88
- border-radius: 18px;
89
- margin-bottom: 1rem;
90
- box-shadow: var(--shadow-glow);
91
- position: relative;
92
- }
93
-
94
- .header-logo::after {
95
- content: '';
96
- position: absolute;
97
- inset: -2px;
98
- border-radius: 20px;
99
- background: var(--gradient-main);
100
- z-index: -1;
101
- opacity: 0.3;
102
- filter: blur(4px);
103
- }
104
-
105
- .header-logo img {
106
- width: 78%;
107
- height: 78%;
108
- object-fit: contain;
109
- filter: drop-shadow(0 0 8px rgba(0, 240, 255, 0.35));
110
- }
111
-
112
- h1 {
113
- font-size: 2.5rem;
114
- font-weight: 800;
115
- letter-spacing: -0.05em;
116
- margin-bottom: 0.5rem;
117
- background: linear-gradient(to right, #ffffff, #c7d2fe, var(--color-cyan));
118
- -webkit-background-clip: text;
119
- -webkit-text-fill-color: transparent;
120
- }
121
-
122
- .subtitle {
123
- font-size: 1.1rem;
124
- color: var(--text-muted);
125
- max-width: 600px;
126
- margin: 0 auto 1.5rem auto;
127
- font-weight: 400;
128
- }
129
-
130
- .meta-grid {
131
- display: flex;
132
- justify-content: center;
133
- gap: 1rem;
134
- margin-bottom: 2rem;
135
- flex-wrap: wrap;
136
- }
137
-
138
- .meta-badge {
139
- background: rgba(255, 255, 255, 0.04);
140
- border: 1px solid var(--border-card);
141
- padding: 0.5rem 1rem;
142
- border-radius: 8px;
143
- font-size: 0.85rem;
144
- display: flex;
145
- align-items: center;
146
- gap: 0.5rem;
147
- }
148
-
149
- .meta-badge .label {
150
- color: var(--text-muted);
151
- }
152
-
153
- .meta-badge .value {
154
- font-family: var(--font-mono);
155
- font-weight: 600;
156
- color: var(--color-cyan);
157
- }
158
-
159
- .tabs-nav {
160
- display: flex;
161
- justify-content: center;
162
- gap: 0.75rem;
163
- margin-bottom: 2rem;
164
- flex-wrap: wrap;
165
- }
166
-
167
- .tab-btn {
168
- background: rgba(255, 255, 255, 0.03);
169
- border: 1px solid var(--border-card);
170
- color: var(--text-muted);
171
- padding: 0.75rem 1.5rem;
172
- border-radius: 9999px;
173
- font-weight: 600;
174
- cursor: pointer;
175
- display: flex;
176
- align-items: center;
177
- gap: 0.5rem;
178
- transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
179
- }
180
-
181
- .tab-btn:hover {
182
- background: rgba(255, 255, 255, 0.08);
183
- color: var(--text-main);
184
- border-color: rgba(var(--color-cyan-rgb), 0.3);
185
- }
186
-
187
- .tab-btn.active {
188
- background: var(--gradient-main);
189
- color: #090d16;
190
- font-weight: 700;
191
- border-color: transparent;
192
- box-shadow: 0 4px 15px rgba(var(--color-cyan-rgb), 0.3);
193
- }
194
-
195
- .tab-btn svg {
196
- width: 18px;
197
- height: 18px;
198
- fill: none;
199
- stroke: currentColor;
200
- stroke-width: 2;
201
- }
202
-
203
- .tab-pane {
204
- display: none;
205
- animation: fadeIn 0.4s ease-out forwards;
206
- }
207
-
208
- .tab-pane.active {
209
- display: block;
210
- }
211
-
212
- @keyframes fadeIn {
213
- from {
214
- opacity: 0;
215
- transform: translateY(10px);
216
- }
217
- to {
218
- opacity: 1;
219
- transform: translateY(0);
220
- }
221
- }
222
-
223
- .glass-card {
224
- background: var(--bg-card);
225
- border: 1px solid var(--border-card);
226
- backdrop-filter: blur(16px);
227
- -webkit-backdrop-filter: blur(16px);
228
- border-radius: 16px;
229
- padding: 2rem;
230
- box-shadow: 0 10px 30px rgba(0, 0, 0, 0.2);
231
- margin-bottom: 2rem;
232
- }
233
-
234
- .card-title {
235
- font-size: 1.3rem;
236
- font-weight: 700;
237
- margin-bottom: 1.25rem;
238
- color: #ffffff;
239
- display: flex;
240
- align-items: center;
241
- gap: 0.75rem;
242
- border-bottom: 1px solid rgba(255, 255, 255, 0.05);
243
- padding-bottom: 0.75rem;
244
- }
245
-
246
- .card-title svg {
247
- width: 20px;
248
- height: 20px;
249
- stroke: var(--color-cyan);
250
- stroke-width: 2;
251
- fill: none;
252
- }
253
-
254
- .grid-2 {
255
- display: grid;
256
- grid-template-columns: 1fr 1fr;
257
- gap: 1.5rem;
258
- }
259
-
260
- @media (max-width: 900px) {
261
- .grid-2 {
262
- grid-template-columns: 1fr;
263
- }
264
- }
265
-
266
- .form-group {
267
- margin-bottom: 1.25rem;
268
- }
269
-
270
- label {
271
- display: block;
272
- font-size: 0.85rem;
273
- color: var(--text-muted);
274
- margin-bottom: 0.5rem;
275
- font-weight: 500;
276
- text-transform: uppercase;
277
- letter-spacing: 0.05em;
278
- }
279
-
280
- input[type="text"], input[type="number"], select, textarea {
281
- width: 100%;
282
- background: rgba(255, 255, 255, 0.03);
283
- border: 1px solid var(--border-card);
284
- border-radius: 8px;
285
- padding: 0.75rem 1rem;
286
- color: var(--text-main);
287
- font-family: var(--font-sans);
288
- font-size: 0.95rem;
289
- transition: all 0.2s ease;
290
- }
291
-
292
- input:focus, select:focus, textarea:focus {
293
- outline: none;
294
- border-color: var(--color-cyan);
295
- box-shadow: 0 0 10px rgba(var(--color-cyan-rgb), 0.15);
296
- background: rgba(255, 255, 255, 0.06);
297
- }
298
-
299
- textarea.code-area {
300
- font-family: var(--font-mono);
301
- font-size: 0.85rem;
302
- background: #05080e;
303
- resize: vertical;
304
- min-height: 250px;
305
- line-height: 1.5;
306
- }
307
-
308
- .btn {
309
- background: rgba(255, 255, 255, 0.05);
310
- border: 1px solid var(--border-card);
311
- color: var(--text-main);
312
- padding: 0.75rem 1.5rem;
313
- border-radius: 8px;
314
- font-weight: 600;
315
- cursor: pointer;
316
- display: inline-flex;
317
- align-items: center;
318
- gap: 0.5rem;
319
- transition: all 0.2s ease;
320
- }
321
-
322
- .btn:hover {
323
- background: rgba(255, 255, 255, 0.1);
324
- border-color: rgba(var(--color-cyan-rgb), 0.3);
325
- }
326
-
327
- .btn-primary {
328
- background: var(--gradient-main);
329
- color: #090d16;
330
- border-color: transparent;
331
- font-weight: 700;
332
- }
333
-
334
- .btn-primary:hover {
335
- background: linear-gradient(135deg, #2bf1ff, #d64eff);
336
- box-shadow: 0 0 15px rgba(var(--color-cyan-rgb), 0.3);
337
- }
338
-
339
- .status-panel {
340
- padding: 1rem;
341
- border-radius: 8px;
342
- margin-top: 1rem;
343
- font-size: 0.9rem;
344
- display: flex;
345
- align-items: flex-start;
346
- gap: 0.75rem;
347
- }
348
-
349
- .status-panel.success {
350
- background: rgba(16, 185, 129, 0.1);
351
- border: 1px solid rgba(16, 185, 129, 0.2);
352
- color: #34d399;
353
- }
354
-
355
- .status-panel.error {
356
- background: rgba(239, 68, 68, 0.1);
357
- border: 1px solid rgba(239, 68, 68, 0.2);
358
- color: #fca5a5;
359
- }
360
-
361
- .status-panel.warning {
362
- background: rgba(245, 158, 11, 0.1);
363
- border: 1px solid rgba(245, 158, 11, 0.2);
364
- color: #fcd34d;
365
- }
366
-
367
- .flowchart-container {
368
- background: #05080e;
369
- border: 1px solid var(--border-card);
370
- border-radius: 12px;
371
- padding: 1.5rem;
372
- overflow: auto;
373
- display: center;
374
- justify-content: center;
375
- }
376
-
377
- .console-box {
378
- background: #020408;
379
- border: 1px solid var(--border-card);
380
- border-radius: 8px;
381
- padding: 1rem;
382
- font-family: var(--font-mono);
383
- font-size: 0.85rem;
384
- color: #a7f3d0;
385
- white-space: pre-wrap;
386
- max-height: 300px;
387
- overflow-y: auto;
388
- }
389
-
390
- .formula-badge {
391
- background: rgba(255,255,255,0.02);
392
- border: 1px solid var(--border-card);
393
- border-radius: 8px;
394
- padding: 1rem;
395
- font-size: 1.1rem;
396
- font-family: var(--font-mono);
397
- text-align: center;
398
- color: var(--color-cyan);
399
- margin: 1rem 0;
400
- }
401
- </style>
402
- </head>
403
- <body>
404
- <div class="container">
405
- <header>
406
- <div class="header-left">
407
- <div class="header-logo">
408
- <svg viewBox="0 0 64 64" width="48" height="48" role="img" aria-label="Clio Coder logo"><title>Clio Coder logo</title><rect x="8" y="8" width="48" height="48" rx="12" fill="rgba(0,240,255,0.12)" stroke="rgba(0,240,255,0.65)"/><path d="M32 14 16 23l16 9 16-9-16-9Z" fill="none" stroke="#00f0ff" stroke-width="3" stroke-linejoin="round"/><path d="M16 32l16 9 16-9M16 41l16 9 16-9" fill="none" stroke="#bd00ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/></svg>
409
- </div>
410
- <div class="header-title-wrapper">
411
- <h1>Scientific Validation Contracts</h1>
412
- <p>Interactive Visual Specification for Numeric Tolerances & HPC Artifact Verifications</p>
413
- <div class="meta-chips-row">
414
- <span class="chip">Source: docs/scientific-validation.md</span>
415
- <span class="chip chip-orange">clio-coder docs validation</span>
416
- </div>
417
- </div>
418
- </div>
419
- <div class="header-right">
420
- <span class="version-badge">Clio Coder v0.3.1</span>
421
- <a href="index.html" class="back-btn">
422
- <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>
423
- Dashboard Hub
424
- </a>
425
- </div>
426
- </header>
427
-
428
-
429
- <div class="tabs-nav">
430
- <button type="button" class="tab-btn active" onclick="_switchTab('calculator')">
431
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M9 7h6m0 10v-3m-3-4h.01M9 17h.01M9 14h.01M12 17h.01M12 14h.01M15 11h.01M20 21H4a2 2 0 01-2-2V5a2 2 0 012-2h16a2 2 0 012 2v14a2 2 0 01-2 2z"/></svg>
432
- Tolerance Calculator
433
- </button>
434
- <button type="button" class="tab-btn" onclick="_switchTab('validator')">
435
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>
436
- Contract Validator
437
- </button>
438
- <button type="button" class="tab-btn" onclick="_switchTab('hpc')">
439
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10"/></svg>
440
- HPC Run Simulator
441
- </button>
442
- <button type="button" class="tab-btn" onclick="_switchTab('flowchart')">
443
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M7 21h10a2 2 0 002-2V5a2 2 0 00-2-2H7a2 2 0 00-2 2v14a2 2 0 002 2zM12 11h.01M12 7h.01M12 15h.01"/></svg>
444
- Validation Lifecycle
445
- </button>
446
- </div>
447
- </header>
448
-
449
- <!-- Tab 1: Tolerance Calculator -->
450
- <div id="calculator" class="tab-pane active">
451
- <div class="grid-2">
452
- <div class="glass-card">
453
- <div class="card-title">
454
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M9 7h6m0 10v-3m-3-4h.01M9 17h.01M9 14h.01M12 17h.01M12 14h.01M15 11h.01M20 21H4a2 2 0 01-2-2V5a2 2 0 012-2h16a2 2 0 012 2v14a2 2 0 01-2 2z"/></svg>
455
- Numerical Inputs
456
- </div>
457
-
458
- <div class="form-group">
459
- <label>Reference Value (ref)</label>
460
- <input type="text" id="tol-ref" value="0.000145" oninput="calculateTolerance()">
461
- </div>
462
-
463
- <div class="form-group">
464
- <label>Candidate Value (val)</label>
465
- <input type="text" id="tol-val" value="0.00014502" oninput="calculateTolerance()">
466
- </div>
467
-
468
- <div class="form-group">
469
- <label>Tolerance Formula Type</label>
470
- <select id="tol-type" onchange="_updateFormulaText(); calculateTolerance();">
471
- <option value="relative">relative (Fractional scaling)</option>
472
- <option value="absolute">absolute (Additive diff)</option>
473
- <option value="ulp">ulp (Unit in Last Place steps)</option>
474
- </select>
475
- </div>
476
-
477
- <div class="form-group">
478
- <label>Tolerance Threshold Bound</label>
479
- <input type="text" id="tol-threshold" value="1.5e-4" oninput="calculateTolerance()">
480
- </div>
481
- </div>
482
-
483
- <div class="glass-card">
484
- <div class="card-title">
485
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>
486
- Tolerance Check Verdict
487
- </div>
488
-
489
- <div id="tol-banner" class="status-panel success">
490
- Check Passed!
491
- </div>
492
-
493
- <div class="formula-badge" id="formula-display">
494
- |val - ref| / |ref| &le; threshold
495
- </div>
496
-
497
- <div style="margin-top:1.5rem; background:rgba(255,255,255,0.02); border:1px solid var(--border-card); padding:1rem; border-radius:8px;">
498
- <p style="margin-bottom:0.5rem;"><strong>Computed Delta:</strong> <span id="tol-calc-delta" style="font-family:var(--font-mono); color:var(--color-cyan); font-weight:600;">-</span></p>
499
- <p style="margin-bottom:0.5rem;"><strong>Allowed Threshold:</strong> <span id="tol-calc-thresh" style="font-family:var(--font-mono); color:var(--color-purple); font-weight:600;">-</span></p>
500
- </div>
501
- </div>
502
- </div>
503
- </div>
504
-
505
- <!-- Tab 2: Contract Validator -->
506
- <div id="validator" class="tab-pane">
507
- <div class="grid-2">
508
- <div class="glass-card">
509
- <div class="card-title">
510
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/></svg>
511
- Scientific Contract YAML Editor
512
- </div>
513
- <div class="form-group">
514
- <label>Raw validation-contract.yaml Content</label>
515
- <textarea id="raw-yaml" class="code-area" oninput="validateYaml()"></textarea>
516
- </div>
517
- <div style="display: flex; gap: 0.5rem;">
518
- <button type="button" class="btn btn-primary" onclick="loadSampleYaml('valid')">Load Valid netCDF/Slurm</button>
519
- <button type="button" class="btn" onclick="loadSampleYaml('invalid')">Load Invalid Contract</button>
520
- </div>
521
- </div>
522
-
523
- <div class="glass-card">
524
- <div class="card-title">
525
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"/></svg>
526
- Contract Schema Audit
527
- </div>
528
- <div id="validator-status" class="status-panel success">
529
- No syntax errors. Ready to audit.
530
- </div>
531
- <div style="margin-top: 1.5rem;">
532
- <h4 style="margin-bottom: 0.5rem; font-size: 0.95rem; color: #ffffff;">Validation Attributes:</h4>
533
- <div id="contract-properties" style="display: flex; flex-direction: column; gap: 0.5rem;">
534
- <!-- Dynamic metrics badges -->
535
- </div>
536
- </div>
537
- </div>
538
- </div>
539
- </div>
540
-
541
- <!-- Tab 3: HPC Run Simulator -->
542
- <div id="hpc" class="tab-pane">
543
- <div class="grid-2">
544
- <div class="glass-card">
545
- <div class="card-title">
546
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M12 6V4m0 2a2 2 0 100 4m0-4a2 2 0 110 4m-6 8a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4m6 6v10m6-2a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4"/></svg>
547
- HPC Queue & Cluster Setup
548
- </div>
549
-
550
- <div class="form-group">
551
- <label>Runtime Scheduler Kind</label>
552
- <select id="hpc-kind">
553
- <option value="slurm">Slurm (sbatch queue manager)</option>
554
- <option value="mpi">MPI rank-sensitive (mpirun launcher)</option>
555
- <option value="local">Local execution (direct process)</option>
556
- </select>
557
- </div>
558
-
559
- <div class="grid-2" style="gap:1rem; margin-bottom:0;">
560
- <div class="form-group">
561
- <label>Nodes allocation</label>
562
- <input type="number" id="hpc-nodes" value="4">
563
- </div>
564
- <div class="form-group">
565
- <label>Ranks count</label>
566
- <input type="number" id="hpc-ranks" value="64">
567
- </div>
568
- </div>
569
-
570
- <div class="form-group">
571
- <label>Environment Modules (One per line)</label>
572
- <textarea id="hpc-modules" style="font-family:var(--font-mono); min-height:80px;">intel/2024
573
- openmpi/5.0
574
- netcdf-c/4.9</textarea>
575
- </div>
576
-
577
- <div class="form-group">
578
- <label>Target Scientific Artifact Output Path</label>
579
- <input type="text" id="hpc-path" value="out/region_west.nc">
580
- </div>
581
-
582
- <div style="margin-bottom: 1.5rem;">
583
- <label style="text-transform:none; font-size:0.9rem; display:flex; align-items:center; gap:0.5rem; color:var(--text-main)">
584
- <input type="checkbox" id="hpc-preserve" checked> Preserve Output (prevent manual cleanup scripts from deleting checkpoints)
585
- </label>
586
- </div>
587
-
588
- <button type="button" class="btn btn-primary" style="width:100%; justify-content:center;" onclick="_simulateHpcRun()">
589
- Submit sbatch Job & Validate
590
- </button>
591
- </div>
592
-
593
- <div class="glass-card">
594
- <div class="card-title">
595
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/></svg>
596
- HPC Cluster Job Logs & Advisory Receipt
597
- </div>
598
-
599
- <div id="hpc-banner" class="status-panel success" style="display:none;">
600
- Validation Finished.
601
- </div>
602
-
603
- <div id="hpc-details" style="margin-top: 1rem; display:none;">
604
- <div style="background: rgba(255, 255, 255, 0.02); border: 1px solid var(--border-card); padding: 1.25rem; border-radius: 8px; margin-bottom: 1rem;">
605
- <p style="margin-bottom:0.5rem;"><strong>Slurm Job ID:</strong> <span id="res-jobid" style="font-family:var(--font-mono);">SBATCH-48195</span></p>
606
- <p style="margin-bottom:0.5rem;"><strong>Scientific Validator:</strong> <span id="res-verdict" style="color:#34d399; font-weight:700;">PASSED (Advisory)</span></p>
607
- <p style="margin-bottom:0.5rem;"><strong>Artifact Safeguard:</strong> <span id="res-preserve" style="font-family:var(--font-mono);">-</span></p>
608
- </div>
609
-
610
- <h4 style="margin-bottom: 0.5rem; font-size: 0.95rem; color:#ffffff;">HPC Cluster stdout/stderr:</h4>
611
- <div class="console-box" id="hpc-log">
612
- <!-- Logs go here -->
613
- </div>
614
- </div>
615
-
616
- <div id="hpc-placeholder" style="text-align: center; color: var(--text-dark); padding: 5rem 1rem;">
617
- Submit the job simulation on the left to review module loads, job submission queue, post-execution check triggers, and advisory receipts.
618
- </div>
619
- </div>
620
- </div>
621
- </div>
622
-
623
- <!-- Tab 4: Validation Lifecycle -->
624
- <div id="flowchart" class="tab-pane">
625
- <div class="glass-card">
626
- <div class="card-title">
627
- <svg aria-hidden="true" viewBox="0 0 24 24"><title>Icon</title><path d="M13 10V3L4 14h7v7l9-11h-7z"/></svg>
628
- HPC Validation Contract Workflow
629
- </div>
630
- <div class="flowchart-container">
631
- <p style="margin-bottom:1.5rem; font-size:0.925rem; color:var(--text-muted);">
632
- Scientific validations execute in four distinct stages. The Slurm/MPI queue manager submits jobs to execute the simulations. Post-run modules are loaded to run validation commands and check tolerances. The validation results generate advisory receipts while checkpoint policies preserve state. Finally, the artifacts and logs are transferred via <strong>Globus endpoints</strong> to high-performance facilities like <strong>Argonne ALCF</strong>.
633
- </p>
634
- <svg aria-hidden="true" width="850" height="420" viewBox="0 0 850 420" style="background:#020408; border-radius:10px;"><title>Icon</title>
635
- <defs>
636
- <marker id="arrow" viewBox="0 0 10 10" refX="5" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
637
- <path d="M 0 0 L 10 5 L 0 10 z" fill="#00f0ff" />
638
- </marker>
639
- <filter id="glow-cyan" x="-20%" y="-20%" width="140%" height="140%">
640
- <feGaussianBlur stdDeviation="4" result="blur" />
641
- <feComposite in="SourceGraphic" in2="blur" operator="over" />
642
- </filter>
643
- </defs>
644
-
645
- <!-- Grid background -->
646
- <path d="M 0 0 L 850 0 M 0 40 L 850 40 M 0 80 L 850 80 M 0 120 L 850 120 M 0 160 L 850 160 M 0 200 L 850 200 M 0 240 L 850 240 M 0 280 L 850 280 M 0 320 L 850 320 M 0 360 L 850 360 M 0 400 L 850 400" stroke="rgba(255,255,255,0.02)" stroke-width="1" />
647
- <path d="M 0 0 L 0 420 M 50 0 L 50 420 M 100 0 L 100 420 M 150 0 L 150 420 M 200 0 L 200 420 M 250 0 L 250 420 M 300 0 L 300 420 M 350 0 L 350 420 M 400 0 L 400 420 M 450 0 L 450 420 M 500 0 L 500 420 M 550 0 L 550 420 M 600 0 L 600 420 M 650 0 L 650 420 M 700 0 L 700 420 M 750 0 L 750 420 M 800 0 L 800 420" stroke="rgba(255,255,255,0.02)" stroke-width="1" />
648
-
649
- <!-- STAGE 1: SUBMIT -->
650
- <g transform="translate(10, 40)">
651
- <rect x="10" y="20" width="160" height="280" rx="8" fill="rgba(255,255,255,0.01)" stroke="rgba(255,255,255,0.05)" />
652
- <text x="90" y="45" fill="var(--text-dark)" font-size="11" font-weight="700" text-anchor="middle" letter-spacing="1">1. JOB QUEUE</text>
653
-
654
- <rect x="25" y="80" width="130" height="60" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
655
- <text x="90" y="105" fill="#fff" font-size="11" font-weight="600" text-anchor="middle">sbatch Submission</text>
656
- <text x="90" y="123" fill="var(--text-muted)" font-size="9" text-anchor="middle">Slurm / MPI run launcher</text>
657
-
658
- <rect x="25" y="180" width="130" height="60" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
659
- <text x="90" y="205" fill="#fff" font-size="11" font-weight="600" text-anchor="middle">Simulation Exec</text>
660
- <text x="90" y="223" fill="var(--text-muted)" font-size="9" text-anchor="middle">Writes NetCDF output</text>
661
- </g>
662
-
663
- <!-- STAGE 2: POST RUN CONTRACT VALIDATOR -->
664
- <g transform="translate(200, 40)">
665
- <rect x="10" y="20" width="200" height="280" rx="8" fill="rgba(0, 240, 255, 0.03)" stroke="var(--color-cyan)" stroke-width="1.5" filter="url(#glow-cyan)" />
666
- <text x="110" y="45" fill="var(--color-cyan)" font-size="12" font-weight="700" text-anchor="middle" letter-spacing="1">2. POST-RUN AUDIT</text>
667
-
668
- <!-- module load -->
669
- <rect x="25" y="80" width="170" height="50" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
670
- <text x="110" y="105" fill="#fff" font-size="11" text-anchor="middle">Module Loading</text>
671
- <text x="110" y="120" fill="var(--text-muted)" font-size="9" text-anchor="middle">Loads intel, MPI, netCDF-c</text>
672
-
673
- <!-- checks -->
674
- <rect x="25" y="170" width="170" height="60" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
675
- <text x="110" y="195" fill="#fff" font-size="11" text-anchor="middle">Numerical Checkers</text>
676
- <text x="110" y="213" fill="var(--text-muted)" font-size="9" text-anchor="middle">Relative/Absolute tolerances</text>
677
- </g>
678
-
679
- <!-- STAGE 3: RECEIPT -->
680
- <g transform="translate(430, 40)">
681
- <rect x="10" y="20" width="180" height="280" rx="8" fill="rgba(255,255,255,0.01)" stroke="rgba(255,255,255,0.05)" />
682
- <text x="100" y="45" fill="var(--text-dark)" font-size="11" font-weight="700" text-anchor="middle" letter-spacing="1">3. RECEIPT</text>
683
-
684
- <rect x="25" y="80" width="150" height="60" rx="6" fill="rgba(16, 185, 129, 0.05)" stroke="var(--color-emerald)" stroke-width="1" />
685
- <text x="100" y="105" fill="var(--color-emerald)" font-size="11" font-weight="700" text-anchor="middle">Advisory Receipt</text>
686
- <text x="100" y="123" fill="var(--text-muted)" font-size="9" text-anchor="middle">Validates dimensions & grid</text>
687
-
688
- <!-- Preserve Checkpoint -->
689
- <rect x="25" y="170" width="150" height="60" rx="6" fill="rgba(189, 0, 255, 0.05)" stroke="var(--color-purple)" stroke-width="1" />
690
- <text x="100" y="195" fill="var(--color-purple)" font-size="11" font-weight="700" text-anchor="middle">Safe Checkpoint</text>
691
- <text x="100" y="213" fill="var(--text-muted)" font-size="9" text-anchor="middle">Preserves state from cleanups</text>
692
- </g>
693
-
694
- <!-- STAGE 4: ARCHIVE & PROVENANCE -->
695
- <g transform="translate(640, 40)">
696
- <rect x="10" y="20" width="180" height="280" rx="8" fill="rgba(255,255,255,0.01)" stroke="rgba(255,255,255,0.05)" />
697
- <text x="100" y="45" fill="var(--text-dark)" font-size="11" font-weight="700" text-anchor="middle" letter-spacing="1">4. ARCHIVE</text>
698
-
699
- <rect x="25" y="80" width="150" height="60" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
700
- <text x="100" y="105" fill="#fff" font-size="11" font-weight="600" text-anchor="middle">Globus Transfer</text>
701
- <text x="100" y="123" fill="var(--text-muted)" font-size="9" text-anchor="middle">Secure cluster endpoints</text>
702
-
703
- <rect x="25" y="170" width="150" height="60" rx="6" fill="#111827" stroke="rgba(255,255,255,0.1)" />
704
- <text x="100" y="195" fill="#fff" font-size="11" font-weight="600" text-anchor="middle">ALCF Catalog</text>
705
- <text x="100" y="213" fill="var(--text-muted)" font-size="9" text-anchor="middle">Science model provenance</text>
706
- </g>
707
-
708
- <!-- Connections -->
709
- <path d="M 180 140 L 210 140" stroke="#00f0ff" stroke-width="1.5" marker-end="url(#arrow)" fill="none" />
710
- <path d="M 410 140 L 440 140" stroke="#00f0ff" stroke-width="1.5" marker-end="url(#arrow)" fill="none" />
711
- <path d="M 620 140 L 650 140" stroke="#00f0ff" stroke-width="1.5" marker-end="url(#arrow)" fill="none" />
712
- </svg>
713
- </div>
714
- </div>
715
- </div>
716
- </div>
717
-
718
- <script>
719
- function _switchTab(tabId) {
720
- document.querySelectorAll('.tab-pane').forEach(el => { el.classList.remove('active'); });
721
- document.querySelectorAll('.tab-btn').forEach(el => { el.classList.remove('active'); });
722
-
723
- document.getElementById(tabId).classList.add('active');
724
- event.currentTarget.classList.add('active');
725
- }
726
-
727
- // Tolerance calculator
728
- function calculateTolerance() {
729
- const ref = parseFloat(document.getElementById('tol-ref').value) || 0;
730
- const val = parseFloat(document.getElementById('tol-val').value) || 0;
731
- const type = document.getElementById('tol-type').value;
732
- const threshStr = document.getElementById('tol-threshold').value;
733
- const threshold = parseFloat(threshStr) || 0;
734
-
735
- let delta = 0;
736
- let pass = false;
737
-
738
- if (type === 'relative') {
739
- delta = Math.abs(val - ref) / Math.abs(ref);
740
- pass = delta <= threshold;
741
- } else if (type === 'absolute') {
742
- delta = Math.abs(val - ref);
743
- pass = delta <= threshold;
744
- } else if (type === 'ulp') {
745
- // Mock ULP calculation for standard JS float64 difference representation steps
746
- const view = new DataView(new ArrayBuffer(8));
747
- view.setFloat64(0, ref);
748
- const refInt = view.getBigUint64(0);
749
- view.setFloat64(0, val);
750
- const valInt = view.getBigUint64(0);
751
-
752
- // Compute integer steps
753
- const steps = Number(valInt > refInt ? valInt - refInt : refInt - valInt);
754
- delta = steps;
755
- pass = steps <= threshold;
756
- }
757
-
758
- const banner = document.getElementById('tol-banner');
759
- const deltaEl = document.getElementById('tol-calc-delta');
760
- const threshEl = document.getElementById('tol-calc-thresh');
761
-
762
- deltaEl.textContent = delta.toExponential(6);
763
- threshEl.textContent = threshold.toExponential(6);
764
-
765
- if (pass) {
766
- banner.className = 'status-panel success';
767
- banner.textContent = 'Tolerance Check: PASSED. Candidate output falls within mathematical bounds.';
768
- } else {
769
- banner.className = 'status-panel error';
770
- banner.textContent = 'Tolerance Check: FAILED. High deviation detected. Potential regression or crash.';
771
- }
772
- }
773
-
774
- function _updateFormulaText() {
775
- const type = document.getElementById('tol-type').value;
776
- const display = document.getElementById('formula-display');
777
- const thresholdInput = document.getElementById('tol-threshold');
778
-
779
- if (type === 'relative') {
780
- display.innerHTML = '|val - ref| / |ref| &le; threshold';
781
- thresholdInput.value = '1e-6';
782
- } else if (type === 'absolute') {
783
- display.innerHTML = '|val - ref| &le; threshold';
784
- thresholdInput.value = '1e-9';
785
- } else if (type === 'ulp') {
786
- display.innerHTML = 'StepsBetween(val, ref) &le; ULP_steps';
787
- thresholdInput.value = '4';
788
- }
789
- }
790
-
791
- // YAML Validation
792
- const validSample = `version: 1
793
- task: "Regenerate the regional climate output and confirm grid metadata."
794
- runtime:
795
- kind: slurm
796
- nodes: 4
797
- ranks: 64
798
- walltime: "01:30:00"
799
- modules:
800
- - "intel/2024"
801
- - "openmpi/5.0"
802
- - "netcdf-c/4.9"
803
- artifacts:
804
- - path: out/region_west.nc
805
- format: NetCDF
806
- expected_dimensions:
807
- time: 8760
808
- lat: 360
809
- lon: 720
810
- expected_attributes:
811
- Conventions: "CF-1.10"
812
- numerical_tolerances:
813
- relative: 1.0e-6
814
- preserve: false
815
- validators:
816
- - "ncdump -h out/region_west.nc"
817
- - "python tools/check_grid.py out/region_west.nc"`;
818
-
819
- const invalidSample = `version: "abc" # Error: must be 1
820
- task: "Missing artifacts list"
821
- runtime:
822
- kind: slurm
823
- artifacts: [] # Error: must be non-empty list`;
824
-
825
- function loadSampleYaml(type) {
826
- if (type === 'valid') {
827
- document.getElementById('raw-yaml').value = validSample;
828
- } else {
829
- document.getElementById('raw-yaml').value = invalidSample;
830
- }
831
- validateYaml();
832
- }
833
-
834
- function validateYaml() {
835
- const text = document.getElementById('raw-yaml').value;
836
- const statusPanel = document.getElementById('validator-status');
837
- const propertiesList = document.getElementById('contract-properties');
838
- propertiesList.innerHTML = '';
839
-
840
- if (!text.trim()) {
841
- statusPanel.className = 'status-panel warning';
842
- statusPanel.textContent = 'Contract is empty. Write or load a sample YAML.';
843
- return;
844
- }
845
-
846
- try {
847
- const lines = text.split('\n');
848
- const errors = [];
849
- let version = null;
850
- let artifactCount = 0;
851
- let modulesCount = 0;
852
-
853
- lines.forEach((line, idx) => {
854
- const trimmed = line.trim();
855
- if (trimmed.startsWith('#') || !trimmed) return;
856
-
857
- const parts = trimmed.split(':');
858
- if (parts.length >= 2) {
859
- const key = parts[0].trim();
860
- const val = parts[1].split('#')[0].trim();
861
-
862
- if (key === 'version') {
863
- version = val;
864
- if (val !== '1') {
865
- errors.push(`Line ${idx+1}: Contract schema version must be exactly 1`);
866
- }
867
- }
868
- if (trimmed.startsWith('- path:')) {
869
- artifactCount++;
870
- }
871
- if (trimmed.startsWith('- "intel') || trimmed.startsWith('- "openmpi') || trimmed.startsWith('- "netcdf')) {
872
- modulesCount++;
873
- }
874
- }
875
- });
876
-
877
- if (errors.length > 0) {
878
- statusPanel.className = 'status-panel error';
879
- statusPanel.innerHTML = `<strong>Contract Schema Failures:</strong><ul style="margin-left: 1.5rem; margin-top:0.5rem;">${errors.map(e => `<li>${e}</li>`).join('')}</ul>`;
880
- } else {
881
- statusPanel.className = 'status-panel success';
882
- statusPanel.innerHTML = `<strong>Success:</strong> Scientific Validation Contract is valid. Ready to be saved alongside research code.`;
883
-
884
- addPropertyBadge('Contract Version', version || '1', 'cyan');
885
- addPropertyBadge('Validated Artifacts', artifactCount || '1', 'purple');
886
- addPropertyBadge('Cluster Modules', modulesCount || '3', 'emerald');
887
- }
888
- } catch (err) {
889
- statusPanel.className = 'status-panel error';
890
- statusPanel.textContent = `Parse Error: ${err.message}`;
891
- }
892
- }
893
-
894
- function addPropertyBadge(label, val, color) {
895
- const container = document.getElementById('contract-properties');
896
- const item = document.createElement('div');
897
- item.className = 'meta-badge';
898
- item.style.borderLeft = `3px solid var(--color-${color})`;
899
- item.innerHTML = `<span class="label">${label}:</span> <span class="value" style="color:var(--color-${color})">${val}</span>`;
900
- container.appendChild(item);
901
- }
902
-
903
- // HPC Run Simulator
904
- function _simulateHpcRun() {
905
- document.getElementById('hpc-placeholder').style.display = 'none';
906
- document.getElementById('hpc-details').style.display = 'block';
907
- const banner = document.getElementById('hpc-banner');
908
- banner.style.display = 'flex';
909
-
910
- const kind = document.getElementById('hpc-kind').value;
911
- const nodes = document.getElementById('hpc-nodes').value;
912
- const ranks = document.getElementById('hpc-ranks').value;
913
- const path = document.getElementById('hpc-path').value;
914
- const preserve = document.getElementById('hpc-preserve').checked;
915
- const modules = document.getElementById('hpc-modules').value.split('\n').filter(m => m.trim());
916
-
917
- const logs = [];
918
- logs.push(`[info] [scientific-executor] Parsing validation contract...`);
919
- logs.push(`[info] Target environment declared: nodes=${nodes}, ranks=${ranks}, runtime=${kind}`);
920
-
921
- modules.forEach(m => {
922
- logs.push(`[info] [module-manager] Loading dependency module: ${m}`);
923
- });
924
-
925
- logs.push(`\n[sbatch-agent] Submitting simulation script to cluster queue...`);
926
- logs.push(`[sbatch-agent] Job submitted successfully. Assigned ID: SBATCH-48195`);
927
- logs.push(`[sbatch-agent] Job status: PENDING -> RUNNING`);
928
-
929
- logs.push(`\n[cluster-node] Execution started on ranks [0..${ranks-1}]`);
930
- logs.push(`[cluster-node] Simulation output written to filesystem.`);
931
- logs.push(`[sbatch-agent] Job completed with exit status 0 (Success).`);
932
-
933
- logs.push(`\n[scientific-executor] Commencing post-execution validation...`);
934
- logs.push(`[info] Validating artifact at path: "${path}"`);
935
- logs.push(`[info] format netCDF: checking coordinates dimensions (time: 8760, lat: 360, lon: 720)`);
936
- logs.push(`[success] Dimensions match expectations.`);
937
- logs.push(`[info] Running validator: "python tools/check_grid.py ${path}"`);
938
- logs.push(`[success] check_grid.py completed successfully. Grid metadata matches CF-1.10 Conventions.`);
939
-
940
- if (preserve) {
941
- logs.push(`[safeguard] Checked 'preserve: true'. Output file registered in session state. Hard cleanups will protect this path.`);
942
- document.getElementById('res-preserve').textContent = 'PRESERVED (Stateful)';
943
- document.getElementById('res-preserve').style.color = '#bd00ff';
944
- } else {
945
- logs.push(`[safeguard] Checked 'preserve: false'. Temp/restart files eligible for standard session cleanups.`);
946
- document.getElementById('res-preserve').textContent = 'ELIGIBLE FOR CLEANUP';
947
- document.getElementById('res-preserve').style.color = 'var(--text-muted)';
948
- }
949
-
950
- logs.push(`[success] validation run finished. Advisory receipt created.`);
951
-
952
- document.getElementById('hpc-log').textContent = logs.join('\n');
953
- }
954
-
955
- window.onload = () => {
956
- calculateTolerance();
957
- loadSampleYaml('valid');
958
- }
959
- </script>
960
- </body>
961
- </html>