@iowarp/clio-coder 0.3.0

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 (226) hide show
  1. package/CHANGELOG.md +407 -0
  2. package/CODE_OF_CONDUCT.md +21 -0
  3. package/CONTRIBUTING.md +224 -0
  4. package/LICENSE +202 -0
  5. package/NOTICE +9 -0
  6. package/README.md +798 -0
  7. package/SECURITY.md +72 -0
  8. package/assets/clio-coder-logo-128.webp +0 -0
  9. package/damage-control-rules.yaml +419 -0
  10. package/dist/acp-UMLFVA3F.js +92 -0
  11. package/dist/agents-Q4MYPMUW.js +91 -0
  12. package/dist/auth-O6HYIJ6J.js +521 -0
  13. package/dist/chunk-262G75JS.js +35 -0
  14. package/dist/chunk-26BZQOAD.js +1281 -0
  15. package/dist/chunk-2J63S4SF.js +508 -0
  16. package/dist/chunk-3DANZDGR.js +717 -0
  17. package/dist/chunk-4UQA7NCT.js +29 -0
  18. package/dist/chunk-527KG6XR.js +497 -0
  19. package/dist/chunk-5LDRNKX2.js +1063 -0
  20. package/dist/chunk-5N2FG33Q.js +25 -0
  21. package/dist/chunk-67MTHP2E.js +135 -0
  22. package/dist/chunk-6CWDTGUC.js +20 -0
  23. package/dist/chunk-7BHLZB3A.js +2115 -0
  24. package/dist/chunk-7RBKDI66.js +348 -0
  25. package/dist/chunk-AMFR5YA3.js +541 -0
  26. package/dist/chunk-BBUH4VAA.js +1224 -0
  27. package/dist/chunk-BYEU76JP.js +899 -0
  28. package/dist/chunk-CLJ5HLUD.js +458 -0
  29. package/dist/chunk-D5YD55AR.js +116 -0
  30. package/dist/chunk-DXQNI4PC.js +61 -0
  31. package/dist/chunk-E3NYWENM.js +1004 -0
  32. package/dist/chunk-GNGDQYDU.js +34688 -0
  33. package/dist/chunk-GOTUR54M.js +9 -0
  34. package/dist/chunk-HBU5MTAM.js +41 -0
  35. package/dist/chunk-HMYNFFY4.js +28 -0
  36. package/dist/chunk-JPOWPFCU.js +1010 -0
  37. package/dist/chunk-JWHCJDCI.js +1215 -0
  38. package/dist/chunk-KBR4MZZR.js +41 -0
  39. package/dist/chunk-KKKPTZLM.js +93 -0
  40. package/dist/chunk-ME6DNWIU.js +66 -0
  41. package/dist/chunk-NI4DEJMC.js +88 -0
  42. package/dist/chunk-O4EJEDHO.js +659 -0
  43. package/dist/chunk-PIDUD6M2.js +31 -0
  44. package/dist/chunk-PS4PFJQP.js +29459 -0
  45. package/dist/chunk-QV47YRF4.js +48 -0
  46. package/dist/chunk-RQDWMVRB.js +279 -0
  47. package/dist/chunk-TFSSEXL6.js +136 -0
  48. package/dist/chunk-TKHQ4DGZ.js +8290 -0
  49. package/dist/chunk-TPOCL34A.js +2876 -0
  50. package/dist/chunk-UGYAX5YI.js +565 -0
  51. package/dist/chunk-UHTSULZS.js +461 -0
  52. package/dist/chunk-UU3R62TT.js +128 -0
  53. package/dist/chunk-UWIJNAOB.js +3906 -0
  54. package/dist/chunk-VOO7NYPP.js +914 -0
  55. package/dist/chunk-VPAWTYLY.js +117 -0
  56. package/dist/chunk-WD6AJM35.js +1216 -0
  57. package/dist/chunk-X3BR7HWV.js +115 -0
  58. package/dist/chunk-X3NE4WVW.js +120 -0
  59. package/dist/chunk-XNISANGE.js +1395 -0
  60. package/dist/chunk-XV4ZJ6ZM.js +3177 -0
  61. package/dist/cli/index.js +236 -0
  62. package/dist/clio-KIQ5SNDS.js +53 -0
  63. package/dist/components-JVHMUBEB.js +653 -0
  64. package/dist/config-ZFCDBMDC.js +372 -0
  65. package/dist/configure-G4E3A2PG.js +27 -0
  66. package/dist/context-CDXTP2MP.js +293 -0
  67. package/dist/context-E3KIFVXI.js +185 -0
  68. package/dist/context-clear-3F4PLXOS.js +102 -0
  69. package/dist/context-index-Q7YSYTR3.js +106 -0
  70. package/dist/docs-YIETIWZI.js +280 -0
  71. package/dist/doctor-M5HJJZOL.js +61 -0
  72. package/dist/domains/agents/builtins/architect.md +33 -0
  73. package/dist/domains/agents/builtins/coder.md +31 -0
  74. package/dist/domains/agents/builtins/context-bootstrap.md +38 -0
  75. package/dist/domains/agents/builtins/debugger.md +30 -0
  76. package/dist/domains/agents/builtins/documenter.md +31 -0
  77. package/dist/domains/agents/builtins/git-master.md +30 -0
  78. package/dist/domains/agents/builtins/provenance.md +30 -0
  79. package/dist/domains/agents/builtins/researcher.md +71 -0
  80. package/dist/domains/agents/builtins/scout.md +42 -0
  81. package/dist/domains/agents/builtins/tester.md +31 -0
  82. package/dist/domains/agents/builtins/verifier.md +30 -0
  83. package/dist/domains/agents/builtins/wiki-writer.md +41 -0
  84. package/dist/eval-B3KZZESM.js +2674 -0
  85. package/dist/evidence-V67CHM35.js +233 -0
  86. package/dist/evolve-YDZSUQYA.js +518 -0
  87. package/dist/extensions-SRG7XCAH.js +207 -0
  88. package/dist/fleet-CA2CRTVG.js +760 -0
  89. package/dist/fleet-preflight-CLIAX7YR.js +21 -0
  90. package/dist/init-2OZDJE2D.js +227 -0
  91. package/dist/memory-3PIQQAKX.js +207 -0
  92. package/dist/models-DY35XI7Y.js +237 -0
  93. package/dist/paths-5OMXW7Z4.js +57 -0
  94. package/dist/preload-KZVHET2B.js +11 -0
  95. package/dist/reset-PIFYNOS3.js +216 -0
  96. package/dist/run-3VSPP24F.js +735 -0
  97. package/dist/share-D36RQCXM.js +241 -0
  98. package/dist/skills-F2MRLELY.js +445 -0
  99. package/dist/skills-eval-E2ZTW4PL.js +932 -0
  100. package/dist/targets-DZMEZAH4.js +977 -0
  101. package/dist/trace-7NYCUI2J.js +250 -0
  102. package/dist/uninstall-AD3JWHBB.js +322 -0
  103. package/dist/upgrade-WYYBKGDY.js +301 -0
  104. package/dist/usage-ULIDAGFF.js +755 -0
  105. package/dist/version-ROZ6CZKH.js +16 -0
  106. package/dist/wiki-generate-PKFIX6OB.js +377 -0
  107. package/dist/worker/entry.js +1739 -0
  108. package/docs/README.md +93 -0
  109. package/docs/acp.md +120 -0
  110. package/docs/alcf-provider.md +72 -0
  111. package/docs/architecture.md +172 -0
  112. package/docs/artifact-versions.md +54 -0
  113. package/docs/built-in-agents.md +265 -0
  114. package/docs/capacity-and-scheduling.md +97 -0
  115. package/docs/commands-and-modes.md +554 -0
  116. package/docs/config-knobs-audit.md +115 -0
  117. package/docs/configuration-and-targets.md +812 -0
  118. package/docs/context-engine.md +236 -0
  119. package/docs/dispatch-architecture-rationale.md +126 -0
  120. package/docs/documentation-coverage.md +46 -0
  121. package/docs/documentation-guide.md +166 -0
  122. package/docs/environment-variables.md +105 -0
  123. package/docs/eval-runner.md +205 -0
  124. package/docs/evals-internal.md +298 -0
  125. package/docs/evidence-and-memory.md +243 -0
  126. package/docs/evolution.md +143 -0
  127. package/docs/exit-codes-and-output.md +74 -0
  128. package/docs/extensions-and-sharing.md +306 -0
  129. package/docs/fleet-demo-runbook.md +179 -0
  130. package/docs/fleet-dispatch.md +591 -0
  131. package/docs/glossary.md +75 -0
  132. package/docs/html/agents_blueprint.html +936 -0
  133. package/docs/html/alcf_blueprint.html +324 -0
  134. package/docs/html/architecture_blueprint.html +850 -0
  135. package/docs/html/commands_blueprint.html +794 -0
  136. package/docs/html/config_knobs_audit_blueprint.html +178 -0
  137. package/docs/html/configuration_blueprint.html +1080 -0
  138. package/docs/html/context_blueprint.html +603 -0
  139. package/docs/html/documentation_blueprint.html +832 -0
  140. package/docs/html/environment_blueprint.html +404 -0
  141. package/docs/html/eval_blueprint.html +743 -0
  142. package/docs/html/evals_internal_blueprint.html +190 -0
  143. package/docs/html/evolution_blueprint.html +674 -0
  144. package/docs/html/extensions_blueprint.html +2065 -0
  145. package/docs/html/fleet_dispatch_blueprint.html +286 -0
  146. package/docs/html/index.html +919 -0
  147. package/docs/html/lifecycle_blueprint.html +723 -0
  148. package/docs/html/memory_blueprint.html +699 -0
  149. package/docs/html/middleware_blueprint.html +664 -0
  150. package/docs/html/models_blueprint.html +2366 -0
  151. package/docs/html/observability_blueprint.html +683 -0
  152. package/docs/html/provider_adapter_blueprint.html +245 -0
  153. package/docs/html/safety_blueprint.html +1386 -0
  154. package/docs/html/shared.css +571 -0
  155. package/docs/html/shared.js +143 -0
  156. package/docs/html/skills_blueprint.html +671 -0
  157. package/docs/html/soak_blueprint.html +182 -0
  158. package/docs/html/tool_usage_blueprint.html +350 -0
  159. package/docs/html/tools_blueprint.html +2249 -0
  160. package/docs/html/trace_blueprint.html +235 -0
  161. package/docs/html/tui_design_blueprint.html +314 -0
  162. package/docs/html/validation_blueprint.html +961 -0
  163. package/docs/html/worker_dispatch_blueprint.html +231 -0
  164. package/docs/installation-and-lifecycle.md +308 -0
  165. package/docs/middleware-and-components.md +148 -0
  166. package/docs/model-catalog.md +189 -0
  167. package/docs/observability.md +233 -0
  168. package/docs/proactive-memory.md +452 -0
  169. package/docs/prompt-envelope-and-tools.md +142 -0
  170. package/docs/provider-adapter-cookbook.md +148 -0
  171. package/docs/release-cut-checklist.md +138 -0
  172. package/docs/safety-model.md +357 -0
  173. package/docs/scientific-validation.md +105 -0
  174. package/docs/session-lifecycle.md +156 -0
  175. package/docs/skills-marketplace.md +46 -0
  176. package/docs/tool-usage.md +527 -0
  177. package/docs/trace-store.md +132 -0
  178. package/docs/troubleshooting.md +33 -0
  179. package/docs/tui-design.md +239 -0
  180. package/docs/worker-dispatch-mechanics.md +242 -0
  181. package/package.json +132 -0
  182. package/skills/README.md +408 -0
  183. package/skills/git/commit-crafting/SKILL.md +79 -0
  184. package/skills/git/commit-crafting/evals.md +92 -0
  185. package/skills/git/create-pr/SKILL.md +116 -0
  186. package/skills/git/create-pr/evals.md +114 -0
  187. package/skills/git/investigate-issue/SKILL.md +139 -0
  188. package/skills/git/investigate-issue/evals.md +94 -0
  189. package/skills/git/resolve-merge-conflicts/SKILL.md +96 -0
  190. package/skills/git/resolve-merge-conflicts/evals.md +58 -0
  191. package/skills/git/review-changes/SKILL.md +103 -0
  192. package/skills/git/review-changes/evals.md +85 -0
  193. package/skills/git/worktree-create/SKILL.md +92 -0
  194. package/skills/git/worktree-create/evals.md +97 -0
  195. package/skills/git/worktree-create/references/worktree-setup.md +66 -0
  196. package/skills/git/worktree-merge/SKILL.md +95 -0
  197. package/skills/git/worktree-merge/evals.md +114 -0
  198. package/skills/skill-marketplace.json +261 -0
  199. package/skills/workflow/cut-it/SKILL.md +86 -0
  200. package/skills/workflow/cut-it/evals.md +42 -0
  201. package/src/domains/agents/builtins/architect.md +33 -0
  202. package/src/domains/agents/builtins/coder.md +31 -0
  203. package/src/domains/agents/builtins/context-bootstrap.md +38 -0
  204. package/src/domains/agents/builtins/debugger.md +30 -0
  205. package/src/domains/agents/builtins/documenter.md +31 -0
  206. package/src/domains/agents/builtins/git-master.md +30 -0
  207. package/src/domains/agents/builtins/provenance.md +30 -0
  208. package/src/domains/agents/builtins/researcher.md +71 -0
  209. package/src/domains/agents/builtins/scout.md +42 -0
  210. package/src/domains/agents/builtins/tester.md +31 -0
  211. package/src/domains/agents/builtins/verifier.md +30 -0
  212. package/src/domains/agents/builtins/wiki-writer.md +41 -0
  213. package/src/domains/agents/fleets/build-review.md +34 -0
  214. package/src/domains/agents/fleets/build-test.md +35 -0
  215. package/src/domains/agents/fleets/sdlc.md +86 -0
  216. package/src/domains/prompts/fragments/identity/clio-worker.md +11 -0
  217. package/src/domains/prompts/fragments/identity/clio.md +26 -0
  218. package/src/domains/prompts/fragments/operating/contract.md +64 -0
  219. package/src/domains/prompts/fragments/safety/auto-edit.md +14 -0
  220. package/src/domains/prompts/fragments/safety/full-auto.md +14 -0
  221. package/src/domains/prompts/fragments/safety/read-only.md +13 -0
  222. package/src/domains/prompts/fragments/safety/suggest.md +13 -0
  223. package/src/domains/prompts/fragments/wiki/page.md +75 -0
  224. package/src/domains/prompts/fragments/wiki/plan.md +48 -0
  225. package/src/domains/providers/models/cloud-models/alcf.yaml +40 -0
  226. package/src/domains/providers/models/local-models/clio-local-coding-targets.yaml +993 -0
package/docs/html/environment_blueprint.html ADDED
@@ -0,0 +1,404 @@
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>Environment Variables Blueprint (v0.3.0)</title>
7
+ <link rel="stylesheet" href="shared.css">
8
+ <style>
9
+ /* Environment resolver custom styling */
10
+ .path-row {
11
+ display: flex;
12
+ justify-content: space-between;
13
+ align-items: center;
14
+ padding: 0.5rem 0;
15
+ border-bottom: 1px solid rgba(255, 255, 255, 0.03);
16
+ }
17
+ .path-label {
18
+ font-size: 0.85rem;
19
+ color: var(--text-muted);
20
+ }
21
+ .path-value {
22
+ font-family: var(--font-mono);
23
+ font-size: 0.8rem;
24
+ color: var(--color-cyan);
25
+ }
26
+
27
+ /* Env table custom styling */
28
+ .env-table {
29
+ width: 100%;
30
+ border-collapse: collapse;
31
+ margin-top: 1rem;
32
+ font-size: 0.85rem;
33
+ }
34
+ .env-table th, .env-table td {
35
+ padding: 0.75rem;
36
+ text-align: left;
37
+ border-bottom: 1px solid rgba(255, 255, 255, 0.05);
38
+ }
39
+ .env-table th {
40
+ color: #fff;
41
+ font-weight: 600;
42
+ background: rgba(255, 255, 255, 0.02);
43
+ }
44
+ .env-name {
45
+ font-family: var(--font-mono);
46
+ color: var(--color-cyan);
47
+ font-weight: 700;
48
+ }
49
+ </style>
50
+ </head>
51
+ <body>
52
+ <div class="container">
53
+ <header>
54
+ <div class="header-left">
55
+ <div class="header-logo">
56
+ <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>
57
+ <rect x="4" y="4" width="16" height="16" rx="2" ry="2"></rect>
58
+ <rect x="9" y="9" width="6" height="6"></rect>
59
+ <line x1="9" y1="1" x2="9" y2="4"></line>
60
+ <line x1="15" y1="1" x2="15" y2="4"></line>
61
+ <line x1="9" y1="20" x2="9" y2="23"></line>
62
+ <line x1="15" y1="20" x2="15" y2="23"></line>
63
+ <line x1="20" y1="9" x2="23" y2="9"></line>
64
+ <line x1="20" y1="15" x2="23" y2="15"></line>
65
+ <line x1="1" y1="9" x2="4" y2="9"></line>
66
+ <line x1="1" y1="15" x2="4" y2="15"></line>
67
+ </svg>
68
+ </div>
69
+ <div class="header-title-wrapper">
70
+ <h1>Environment Variables</h1>
71
+ <p>Process overrides, directory layout overrides, and internal plumbing variables</p>
72
+ <div class="meta-chips-row">
73
+ <span class="chip">Source: docs/environment-variables.md</span>
74
+ <span class="chip chip-orange">clio-coder docs environment</span>
75
+ </div>
76
+ </div>
77
+ </div>
78
+ <div class="header-right">
79
+ <span class="version-badge">Clio Coder v0.3.0</span>
80
+ <a href="index.html" class="back-btn">
81
+ <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
82
+ Dashboard Hub
83
+ </a>
84
+ </div>
85
+ </header>
86
+
87
+ <div class="page-layout-grid">
88
+ <nav class="sidebar" aria-label="Table of Contents">
89
+ <div class="toc-container">
90
+ <div class="toc-title">On This Page</div>
91
+ <ul class="toc-list">
92
+ <!-- Dynamically populated -->
93
+ </ul>
94
+ </div>
95
+ </nav>
96
+
97
+ <main>
98
+ <div class="glass-card">
99
+ <h2>Overview Summary</h2>
100
+ <p>Environment variables allow operator-scoped and process-scoped overrides (such as CI or one-off tests). The settings YAML file remains the primary home for durable configuration, but env vars override settings values on runtime startup.</p>
101
+ </div>
102
+
103
+ <div class="tabs-nav">
104
+ <button type="button" class="tab-btn active" onclick="switchTab('explorer')">
105
+ Env Variables Explorer
106
+ </button>
107
+ <button type="button" class="tab-btn" onclick="switchTab('resolver')">
108
+ Path Resolver
109
+ </button>
110
+ </div>
111
+
112
+ <!-- Tab 1: Explorer -->
113
+ <div class="tab-pane active" id="pane-explorer">
114
+ <div class="glass-card">
115
+ <h3>Variables Matrix</h3>
116
+ <p>Filter or search process environment variables:</p>
117
+
118
+ <div class="form-group" style="margin-top: 1rem;">
119
+ <input type="text" id="envSearch" placeholder="Search variables (e.g. CLIO_CODER_HOME, turn, budget)..." oninput="filterEnvTable()" style="padding: 0.65rem 0.85rem; font-size: 0.9rem;">
120
+ </div>
121
+
122
+ <div class="filter-tags" style="justify-content: flex-start; margin-bottom: 1rem;">
123
+ <button type="button" class="filter-tag active" id="btn-all" onclick="filterCategory('all')">All roles</button>
124
+ <button type="button" class="filter-tag" id="btn-guard" onclick="filterCategory('guardrail')">Guardrails</button>
125
+ <button type="button" class="filter-tag" id="btn-knob" onclick="filterCategory('knob')">Knobs</button>
126
+ <button type="button" class="filter-tag" id="btn-layout" onclick="filterCategory('layout')">Layout</button>
127
+ <button type="button" class="filter-tag" id="btn-debug" onclick="filterCategory('debug')">Debugging</button>
128
+ <button type="button" class="filter-tag" id="btn-plumbing" onclick="filterCategory('plumbing')">Plumbing</button>
129
+ <button type="button" class="filter-tag" id="btn-test" onclick="filterCategory('test')">Test-Only</button>
130
+ </div>
131
+
132
+ <table class="env-table">
133
+ <thead>
134
+ <tr>
135
+ <th>Variable</th>
136
+ <th>Default</th>
137
+ <th>Controls / Scope</th>
138
+ </tr>
139
+ </thead>
140
+ <tbody id="envTableBody">
141
+ <tr data-cat="guardrail">
142
+ <td class="env-name">CLIO_CODER_TURN_TOOL_CALL_BUDGET</td>
143
+ <td><code>60</code></td>
144
+ <td>Orchestrator per-turn soft tool-call budget; hard ceiling sits 15 above.</td>
145
+ </tr>
146
+ <tr data-cat="guardrail">
147
+ <td class="env-name">CLIO_CODER_WORKER_TOOL_CALL_CAP</td>
148
+ <td><code>150</code></td>
149
+ <td>Lifetime tool-call cap per dispatched worker process run.</td>
150
+ </tr>
151
+ <tr data-cat="guardrail">
152
+ <td class="env-name">CLIO_CODER_INTERNAL_DISPATCH_TIMEOUT_MS</td>
153
+ <td><code>900000</code></td>
154
+ <td>Internal dispatch execution timeout in milliseconds (15 minutes).</td>
155
+ </tr>
156
+ <tr data-cat="guardrail">
157
+ <td class="env-name">CLIO_CODER_MAX_RUNS</td>
158
+ <td><code>1000</code></td>
159
+ <td>Dispatch run-ledger retention cap.</td>
160
+ </tr>
161
+ <tr data-cat="guardrail">
162
+ <td class="env-name">CLIO_CODER_READ_MAX_BYTES</td>
163
+ <td><code>51200</code></td>
164
+ <td>Per-call byte cap for the file read tool (min 1024).</td>
165
+ </tr>
166
+ <tr data-cat="guardrail">
167
+ <td class="env-name">CLIO_CODER_OBSERVATION_TURN_BUDGET_BYTES</td>
168
+ <td><code>196608</code></td>
169
+ <td>Shared per-turn byte pool across observation tools.</td>
170
+ </tr>
171
+ <tr data-cat="knob">
172
+ <td class="env-name">CLIO_CODER_RIGOR</td>
173
+ <td><code>normal</code></td>
174
+ <td>Finish-contract evidence validation bar (normal or high).</td>
175
+ </tr>
176
+ <tr data-cat="knob">
177
+ <td class="env-name">CLIO_CODER_RESIDENCY</td>
178
+ <td><code>managed</code></td>
179
+ <td>Control local model residency managers (managed/observe/off).</td>
180
+ </tr>
181
+ <tr data-cat="knob">
182
+ <td class="env-name">CLIO_CODER_TRUST_PROJECT_SKILLS</td>
183
+ <td><code>off</code></td>
184
+ <td>Enable project-local skills execution (1/0).</td>
185
+ </tr>
186
+ <tr data-cat="knob">
187
+ <td class="env-name">CLIO_CODER_ALLOW_EXTERNAL_FULL_ACCESS</td>
188
+ <td><code>off</code></td>
189
+ <td>Let full-auto pass to external runtimes.</td>
190
+ </tr>
191
+ <tr data-cat="layout">
192
+ <td class="env-name">CLIO_CODER_HOME</td>
193
+ <td><code>unset</code></td>
194
+ <td>Override installation root path. Sets config, state, and cache relative to it.</td>
195
+ </tr>
196
+ <tr data-cat="layout">
197
+ <td class="env-name">CLIO_CODER_CONFIG_DIR</td>
198
+ <td><code>Platform XDG</code></td>
199
+ <td>Settings directory path override.</td>
200
+ </tr>
201
+ <tr data-cat="layout">
202
+ <td class="env-name">CLIO_CODER_DATA_DIR</td>
203
+ <td><code>Platform XDG</code></td>
204
+ <td>Data directory path override.</td>
205
+ </tr>
206
+ <tr data-cat="layout">
207
+ <td class="env-name">CLIO_CODER_STATE_DIR</td>
208
+ <td><code>Platform XDG</code></td>
209
+ <td>State and session directory path override.</td>
210
+ </tr>
211
+ <tr data-cat="layout">
212
+ <td class="env-name">CLIO_CODER_CACHE_DIR</td>
213
+ <td><code>Platform XDG</code></td>
214
+ <td>Marketplace/models caching path override.</td>
215
+ </tr>
216
+ <tr data-cat="debug">
217
+ <td class="env-name">CLIO_CODER_BUS_TRACE</td>
218
+ <td><code>off</code></td>
219
+ <td>Trace event-bus events to stderr.</td>
220
+ </tr>
221
+ <tr data-cat="debug">
222
+ <td class="env-name">CLIO_CODER_TIMING</td>
223
+ <td><code>off</code></td>
224
+ <td>Print boot timing reports.</td>
225
+ </tr>
226
+ <tr data-cat="plumbing">
227
+ <td class="env-name">CLIO_CODER_INTERACTIVE</td>
228
+ <td><code>off</code></td>
229
+ <td>Flag indicating interactive TUI mode. Cleaned from children.</td>
230
+ </tr>
231
+ <tr data-cat="plumbing">
232
+ <td class="env-name">CLIO_CODER_RUN_OVERRIDES</td>
233
+ <td><code>unset</code></td>
234
+ <td>JSON envelope for process option bindings.</td>
235
+ </tr>
236
+ <tr data-cat="test">
237
+ <td class="env-name">CLIO_CODER_WORKER_FAUX</td>
238
+ <td><code>unset</code></td>
239
+ <td>Fake LLM responses mapping framework for test assertions.</td>
240
+ </tr>
241
+ </tbody>
242
+ </table>
243
+ </div>
244
+ </div>
245
+
246
+ <!-- Tab 2: Resolver -->
247
+ <div class="tab-pane" id="pane-resolver">
248
+ <div class="blueprint-layout">
249
+ <div class="specs-col">
250
+ <div class="glass-card">
251
+ <h3>Directory Resolver Calculator</h3>
252
+ <p>Input variables to see where Clio resolves session and configuration folders:</p>
253
+
254
+ <div class="form-group">
255
+ <label for="osSelect">Operating System</label>
256
+ <select id="osSelect" onchange="resolvePaths()">
257
+ <option value="linux">Linux</option>
258
+ <option value="macos">macOS</option>
259
+ <option value="windows">Windows</option>
260
+ </select>
261
+ </div>
262
+
263
+ <div class="form-group">
264
+ <label for="clioHomeInput">CLIO_CODER_HOME (Override)</label>
265
+ <input type="text" id="clioHomeInput" value="" placeholder="e.g. /home/user/my_clio_tree" oninput="resolvePaths()">
266
+ </div>
267
+
268
+ <div class="form-group">
269
+ <label for="clioConfigInput">CLIO_CODER_CONFIG_DIR (Override)</label>
270
+ <input type="text" id="clioConfigInput" value="" placeholder="e.g. /etc/clio" oninput="resolvePaths()">
271
+ </div>
272
+ </div>
273
+ </div>
274
+
275
+ <div class="specs-col">
276
+ <div class="glass-card">
277
+ <h3>Effective Resolved Paths</h3>
278
+ <p>Resolution order: <code>env > settings > platform XDG</code></p>
279
+
280
+ <div class="path-row">
281
+ <span class="path-label">Config Folder</span>
282
+ <span class="path-value" id="valConfig">/home/user/.config/clio-coder</span>
283
+ </div>
284
+ <div class="path-row">
285
+ <span class="path-label">Data Folder</span>
286
+ <span class="path-value" id="valData">/home/user/.local/share/clio-coder</span>
287
+ </div>
288
+ <div class="path-row">
289
+ <span class="path-label">State Folder</span>
290
+ <span class="path-value" id="valState">/home/user/.local/state/clio-coder</span>
291
+ </div>
292
+ <div class="path-row">
293
+ <span class="path-label">Cache Folder</span>
294
+ <span class="path-value" id="valCache">/home/user/.cache/clio-coder</span>
295
+ </div>
296
+ </div>
297
+ </div>
298
+ </div>
299
+ </div>
300
+
301
+ <!-- Related Navigation -->
302
+ <nav class="related-nav" aria-label="Related Pages">
303
+ <a href="alcf_blueprint.html" class="nav-link-card">
304
+ <span class="nav-label">Previous Blueprint</span>
305
+ <span class="nav-title">ALCF Inference Provider</span>
306
+ </a>
307
+ <a href="tool_usage_blueprint.html" class="nav-link-card next">
308
+ <span class="nav-label">Next Blueprint</span>
309
+ <span class="nav-title">Tool Usage Reference</span>
310
+ </a>
311
+ </nav>
312
+ </main>
313
+ </div>
314
+
315
+ <footer>
316
+ <p>Clio Coder Env Blueprint &bull; Version 0.3.0 &bull; Gnosis Research Center</p>
317
+ </footer>
318
+ </div>
319
+
320
+ <script src="shared.js"></script>
321
+ <script>
322
+ let activeCat = 'all';
323
+
324
+ function filterCategory(cat) {
325
+ activeCat = cat;
326
+ document.querySelectorAll('.filter-tag').forEach(b => b.classList.remove('active'));
327
+ const activeBtn = document.getElementById(`btn-${cat}`);
328
+ if (activeBtn) activeBtn.classList.add('active');
329
+ filterEnvTable();
330
+ }
331
+
332
+ function filterEnvTable() {
333
+ const q = document.getElementById("envSearch").value.toLowerCase().trim();
334
+ const rows = document.querySelectorAll("#envTableBody tr");
335
+
336
+ rows.forEach(row => {
337
+ const name = row.querySelector(".env-name").innerText.toLowerCase();
338
+ const desc = row.cells[2].innerText.toLowerCase();
339
+ const cat = row.getAttribute("data-cat");
340
+
341
+ const matchesQ = !q || name.includes(q) || desc.includes(q);
342
+ const matchesCat = activeCat === 'all' || cat === activeCat;
343
+
344
+ if (matchesQ && matchesCat) {
345
+ row.style.display = "";
346
+ } else {
347
+ row.style.display = "none";
348
+ }
349
+ });
350
+ }
351
+
352
+ function resolvePaths() {
353
+ const os = document.getElementById("osSelect").value;
354
+ const clioHome = document.getElementById("clioHomeInput").value.trim();
355
+ const clioConfig = document.getElementById("clioConfigInput").value.trim();
356
+
357
+ let config = "";
358
+ let data = "";
359
+ let state = "";
360
+ let cache = "";
361
+
362
+ if (clioHome) {
363
+ config = `${clioHome}/config`;
364
+ data = `${clioHome}/data`;
365
+ state = `${clioHome}/state`;
366
+ cache = `${clioHome}/cache`;
367
+ } else {
368
+ if (os === "linux") {
369
+ config = "~/.config/clio-coder";
370
+ data = "~/.local/share/clio-coder";
371
+ state = "~/.local/state/clio-coder";
372
+ cache = "~/.cache/clio-coder";
373
+ } else if (os === "macos") {
374
+ config = "~/Library/Application Support/clio-coder";
375
+ data = "~/Library/Application Support/clio-coder";
376
+ state = "~/Library/Application Support/clio-coder/state";
377
+ cache = "~/Library/Caches/clio-coder";
378
+ } else {
379
+ config = "%APPDATA%\\clio-coder";
380
+ data = "%LOCALAPPDATA%\\clio-coder";
381
+ state = "%LOCALAPPDATA%\\clio-coder\\state";
382
+ cache = "%LOCALAPPDATA%\\clio-coder\\cache";
383
+ }
384
+ }
385
+
386
+ if (clioConfig) {
387
+ config = clioConfig;
388
+ }
389
+
390
+ document.getElementById("valConfig").innerText = config;
391
+ document.getElementById("valData").innerText = data;
392
+ document.getElementById("valState").innerText = state;
393
+ document.getElementById("valCache").innerText = cache;
394
+ }
395
+
396
+ // Init
397
+ window.onload = () => {
398
+ resolvePaths();
399
+ // Make functions globally available
400
+ window.filterCategory = filterCategory;
401
+ };
402
+ </script>
403
+ </body>
404
+ </html>