mlx-bun 0.0.4

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 (210) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +362 -0
  3. package/THIRD_PARTY_LICENSES.md +41 -0
  4. package/bin/mlx-bun.mjs +32 -0
  5. package/docs/curve-designer.html +303 -0
  6. package/docs/design/adapters-end-to-end.md +201 -0
  7. package/docs/design/compat-cli-surface-design.md +227 -0
  8. package/docs/design/docs-reorg-plan.md +152 -0
  9. package/docs/design/hlg-sampling.md +340 -0
  10. package/docs/design/memory-system.md +339 -0
  11. package/docs/design/optimization_plan.md +344 -0
  12. package/docs/design/parallel-slots.md +515 -0
  13. package/docs/design/runtime-isolation.md +247 -0
  14. package/docs/design/segmented-backward-training.md +508 -0
  15. package/docs/investigations/chunk-finetune-experiment.md +84 -0
  16. package/docs/investigations/curve-bisector-routing.md +123 -0
  17. package/docs/investigations/curve-runs/bisector-route.json +98 -0
  18. package/docs/investigations/curve-runs/bisector-trace.json +1393 -0
  19. package/docs/investigations/curve-runs/curve-terrain.json +1179 -0
  20. package/docs/investigations/curve-runs/curve-terrain.svg +42 -0
  21. package/docs/investigations/curve-terrain.html +105 -0
  22. package/docs/investigations/expert-offload-single-user-moe.md +292 -0
  23. package/docs/investigations/hlg-ab.html +34 -0
  24. package/docs/investigations/hlg-explorer.html +238 -0
  25. package/docs/investigations/hlg-figs/cliff.svg +1 -0
  26. package/docs/investigations/hlg-figs/cross.svg +1 -0
  27. package/docs/investigations/hlg-figs/edges.svg +1 -0
  28. package/docs/investigations/hlg-figs/k20-grids.svg +1 -0
  29. package/docs/investigations/hlg-figs/k20-peaks.svg +1 -0
  30. package/docs/investigations/hlg-figs/lw-curve.svg +1 -0
  31. package/docs/investigations/hlg-figs/terrain.svg +1 -0
  32. package/docs/investigations/hlg-report.html +262 -0
  33. package/docs/investigations/hlg-runs/hlg-ab.json +149 -0
  34. package/docs/investigations/hlg-runs/hlg-blind-prompts.md +87 -0
  35. package/docs/investigations/hlg-runs/hlg-blind.json +107 -0
  36. package/docs/investigations/hlg-runs/hlg-cliff.json +197 -0
  37. package/docs/investigations/hlg-runs/hlg-cross.json +505 -0
  38. package/docs/investigations/hlg-runs/hlg-edge.json +388 -0
  39. package/docs/investigations/hlg-runs/hlg-eval1.json +25 -0
  40. package/docs/investigations/hlg-runs/hlg-frontier.json +86 -0
  41. package/docs/investigations/hlg-runs/hlg-grid.json +242 -0
  42. package/docs/investigations/hlg-runs/hlg-grid2.json +343 -0
  43. package/docs/investigations/hlg-runs/hlg-lw-coarse.json +110 -0
  44. package/docs/investigations/hlg-runs/hlg-map.json +383 -0
  45. package/docs/investigations/hlg-runs/run0-original.log +159 -0
  46. package/docs/investigations/hlg-runs/runA-recommended.log +131 -0
  47. package/docs/investigations/hlg-runs/runAA-cliff-cpm5.log +26 -0
  48. package/docs/investigations/hlg-runs/runAB-grid2-e4b.log +18 -0
  49. package/docs/investigations/hlg-runs/runAC-peak-e4b-partial.log +25 -0
  50. package/docs/investigations/hlg-runs/runAD-ab-samples.log +8 -0
  51. package/docs/investigations/hlg-runs/runAE-edge-e4b.log +51 -0
  52. package/docs/investigations/hlg-runs/runAF-logit-calibration.log +10 -0
  53. package/docs/investigations/hlg-runs/runAG-eval-config2.log +16 -0
  54. package/docs/investigations/hlg-runs/runB-gain-variants.log +192 -0
  55. package/docs/investigations/hlg-runs/runC-pivots.log +162 -0
  56. package/docs/investigations/hlg-runs/runD-oetf.log +132 -0
  57. package/docs/investigations/hlg-runs/runE-eotf.log +162 -0
  58. package/docs/investigations/hlg-runs/runF-shaper-working.log +86 -0
  59. package/docs/investigations/hlg-runs/runG-shaper-sweep.log +101 -0
  60. package/docs/investigations/hlg-runs/runH-wsweep.log +176 -0
  61. package/docs/investigations/hlg-runs/runI-asweep.log +176 -0
  62. package/docs/investigations/hlg-runs/runJ-knobmap.log +49 -0
  63. package/docs/investigations/hlg-runs/runK-frontier.log +19 -0
  64. package/docs/investigations/hlg-runs/runL-widemap.log +65 -0
  65. package/docs/investigations/hlg-runs/runM-frontier-emb.log +15 -0
  66. package/docs/investigations/hlg-runs/runN-verify.log +116 -0
  67. package/docs/investigations/hlg-runs/runO-frontier-seed5000.log +15 -0
  68. package/docs/investigations/hlg-runs/runP-grid-AxSm.log +15 -0
  69. package/docs/investigations/hlg-runs/runQ-grid-tgW.log +15 -0
  70. package/docs/investigations/hlg-runs/runR-blind-transcript.log +79 -0
  71. package/docs/investigations/hlg-runs/runS-cross-coherence.log +33 -0
  72. package/docs/investigations/hlg-runs/runT-cross-cpm5.log +33 -0
  73. package/docs/investigations/hlg-runs/runU-cross-12b.log +33 -0
  74. package/docs/investigations/hlg-runs/runV-lw-e4b.log +22 -0
  75. package/docs/investigations/hlg-runs/runW-lw-12b.log +22 -0
  76. package/docs/investigations/hlg-runs/runX-lw-cpm5.log +22 -0
  77. package/docs/investigations/hlg-runs/runY-cliff-e4b.log +26 -0
  78. package/docs/investigations/hlg-runs/runZ-cliff-12b.log +26 -0
  79. package/docs/investigations/hlg-sampling-investigation.md +970 -0
  80. package/docs/investigations/lab-build-journal.md +157 -0
  81. package/docs/investigations/pi-builtin-investigation.md +308 -0
  82. package/docs/investigations/starter-model-port-handoff.md +323 -0
  83. package/docs/planning/IDEAS.md +26 -0
  84. package/docs/planning/PRODUCT_ROADMAP.md +426 -0
  85. package/docs/planning/ResearchTopics.md +119 -0
  86. package/docs/planning/chunk-task-roadmap.md +77 -0
  87. package/docs/planning/journal.md +155 -0
  88. package/docs/reference/distribution.md +121 -0
  89. package/docs/reference/embedding.md +168 -0
  90. package/docs/reference/library-api.md +153 -0
  91. package/docs/reference/server-api.md +224 -0
  92. package/docs/reference/server-config.md +243 -0
  93. package/docs/segmented-backward-handoff.md +148 -0
  94. package/package.json +68 -0
  95. package/src/anthropic.ts +491 -0
  96. package/src/chat-template.ts +186 -0
  97. package/src/cli.ts +1075 -0
  98. package/src/config.ts +229 -0
  99. package/src/curve-sampler.ts +122 -0
  100. package/src/dataset/generators.ts +1087 -0
  101. package/src/dataset/index.ts +12 -0
  102. package/src/dataset/job.ts +81 -0
  103. package/src/dataset/llm.ts +71 -0
  104. package/src/dataset/registry.ts +528 -0
  105. package/src/download.ts +283 -0
  106. package/src/eval/README.md +86 -0
  107. package/src/eval/kl-prompts.ts +29 -0
  108. package/src/eval/kl.ts +294 -0
  109. package/src/eval/quality-db.ts +92 -0
  110. package/src/eval/runner.ts +102 -0
  111. package/src/eval/score.ts +49 -0
  112. package/src/eval/tasks/bfcl.ts +500 -0
  113. package/src/eval/tasks/gsm8k.ts +85 -0
  114. package/src/eval/tasks/hashhop.ts +109 -0
  115. package/src/eval/tasks/humaneval.ts +252 -0
  116. package/src/eval/tasks/ifeval.ts +354 -0
  117. package/src/eval/tasks/mmlu.ts +145 -0
  118. package/src/evaldb.ts +199 -0
  119. package/src/expert-offload-build.ts +77 -0
  120. package/src/expert-offload.ts +61 -0
  121. package/src/expert-trace.ts +67 -0
  122. package/src/fit.ts +254 -0
  123. package/src/generate.ts +451 -0
  124. package/src/harness-pi.ts +177 -0
  125. package/src/hf-push.ts +628 -0
  126. package/src/index.ts +22 -0
  127. package/src/jobs/db.ts +139 -0
  128. package/src/jobs/index.ts +29 -0
  129. package/src/jobs/job-entry.ts +106 -0
  130. package/src/jobs/runner.ts +304 -0
  131. package/src/jobs/sse.ts +114 -0
  132. package/src/jobs/types.ts +58 -0
  133. package/src/kv-store.ts +185 -0
  134. package/src/lora.ts +314 -0
  135. package/src/md-modules.d.ts +7 -0
  136. package/src/mlx/array.ts +237 -0
  137. package/src/mlx/autograd.ts +267 -0
  138. package/src/mlx/checkpoint.ts +116 -0
  139. package/src/mlx/compile.ts +158 -0
  140. package/src/mlx/custom-vjp.ts +140 -0
  141. package/src/mlx/ffi.ts +433 -0
  142. package/src/mlx/metal-kernel.ts +130 -0
  143. package/src/mlx/ops.ts +707 -0
  144. package/src/mmap.ts +90 -0
  145. package/src/model/batched-mask.ts +204 -0
  146. package/src/model/batched-rotating.ts +300 -0
  147. package/src/model/compiled-decode.ts +681 -0
  148. package/src/model/factory.ts +27 -0
  149. package/src/model/fingerprint.ts +33 -0
  150. package/src/model/flash-attention.ts +674 -0
  151. package/src/model/fused-decode-kernel.ts +305 -0
  152. package/src/model/fused-geglu-kernel.ts +87 -0
  153. package/src/model/gemma4-base.ts +1616 -0
  154. package/src/model/gemma4.ts +1012 -0
  155. package/src/model/generated/gemma4-12b.ts +526 -0
  156. package/src/model/generated/gemma4-26b.ts +500 -0
  157. package/src/model/generated/gemma4-e4b.ts +757 -0
  158. package/src/model/generated/index.ts +18 -0
  159. package/src/model/minicpm5.ts +278 -0
  160. package/src/model/qwen3-delta.ts +224 -0
  161. package/src/model/qwen3_5.ts +429 -0
  162. package/src/model/support.ts +46 -0
  163. package/src/native-pack.ts +152 -0
  164. package/src/pi-provider.ts +95 -0
  165. package/src/pi-terminal.ts +264 -0
  166. package/src/pi-web.ts +924 -0
  167. package/src/preflight.ts +123 -0
  168. package/src/prompt-cache.ts +113 -0
  169. package/src/quantize/allocator.ts +627 -0
  170. package/src/quantize/calibration.ts +180 -0
  171. package/src/quantize/config-writer.ts +132 -0
  172. package/src/quantize/index.ts +57 -0
  173. package/src/quantize/job.ts +136 -0
  174. package/src/quantize/quantizer.ts +462 -0
  175. package/src/quantize/safetensors-writer.ts +171 -0
  176. package/src/quantize/sensitivity.ts +234 -0
  177. package/src/registry.ts +336 -0
  178. package/src/responses.ts +774 -0
  179. package/src/safetensors.ts +158 -0
  180. package/src/sampler.ts +517 -0
  181. package/src/serve/batch-scheduler.ts +362 -0
  182. package/src/serve/generation-gateway.ts +160 -0
  183. package/src/server.ts +1891 -0
  184. package/src/spec/drafter.ts +261 -0
  185. package/src/spec/generate.ts +221 -0
  186. package/src/status-page.html +497 -0
  187. package/src/tokenizer.ts +38 -0
  188. package/src/tool-call.ts +242 -0
  189. package/src/train/dataset.ts +461 -0
  190. package/src/train/export.ts +32 -0
  191. package/src/train/forward.ts +229 -0
  192. package/src/train/index.ts +43 -0
  193. package/src/train/job.ts +148 -0
  194. package/src/train/lora-params.ts +194 -0
  195. package/src/train/loss.ts +342 -0
  196. package/src/train/merge.ts +195 -0
  197. package/src/train/optimizer.ts +176 -0
  198. package/src/train/rank.ts +101 -0
  199. package/src/train/segmented.ts +520 -0
  200. package/src/train/trainer.ts +600 -0
  201. package/src/tui.ts +161 -0
  202. package/src/vision/embedder.ts +168 -0
  203. package/src/vision/preprocess.ts +247 -0
  204. package/src/vision/prompt.ts +158 -0
  205. package/src/vision/siglip.ts +599 -0
  206. package/src/web/app.html +2471 -0
  207. package/src/web/skills/web-research/SKILL.md +44 -0
  208. package/src/web/skills.ts +59 -0
  209. package/src/web-tools.ts +426 -0
  210. package/src/weights.ts +91 -0
package/docs/investigations/hlg-figs/k20-grids.svg ADDED
@@ -0,0 +1 @@
1
+ <svg viewBox="0 0 900 360" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="t d" font-family="ui-sans-serif,system-ui,sans-serif"><title id="t">K=20 coherence surfaces</title><desc id="d">Two fine 2-D coherence grids at K=20. The target_gap cliff slides monotonically with s_m; the W edge slides with A. Cells show mean junk percent; dot = coherent.</desc><text x="450" y="26" text-anchor="middle" font-size="16" font-weight="700" fill="var(--text-primary,#1f2937)">Coherence is a tilted surface, not a fixed wall (K=20)</text><text x="450" y="45" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">cell = mean canary junk% over 20 seeds · green dot = coherent · red = junk, darker = worse</text><text x="215" y="69" text-anchor="middle" font-size="13.5" font-weight="700" fill="var(--text-primary,#1f2937)">target_gap ramp × s_m</text><text x="215" y="85" text-anchor="middle" font-size="10.5" fill="var(--text-secondary,#6b7280)">the cliff slides with the coupling hub</text><rect x="95" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="114" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="135" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="154" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="175" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="194" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="215" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="234" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="255" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="274" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="295" y="95" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="314" y="118" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="95" y="135" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.80" stroke="#dc2626" stroke-opacity="0.28"/><text x="114" y="158" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">24</text><rect x="135" y="135" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.67" stroke="#dc2626" stroke-opacity="0.28"/><text x="154" y="158" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">20</text><rect x="175" y="135" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.23" stroke="#dc2626" stroke-opacity="0.28"/><text x="194" y="158" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">7</text><rect x="215" y="135" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="234" y="158" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="255" y="135" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="274" y="158" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="295" y="135" width="38" height="38" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="314" y="158" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="95" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="114" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="135" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="154" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="175" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.90" stroke="#dc2626" stroke-opacity="0.28"/><text x="194" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">27</text><rect x="215" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.77" stroke="#dc2626" stroke-opacity="0.28"/><text x="234" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">23</text><rect x="255" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.50" stroke="#dc2626" stroke-opacity="0.28"/><text x="274" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">15</text><rect x="295" y="175" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.33" stroke="#dc2626" stroke-opacity="0.28"/><text x="314" y="198" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">10</text><rect x="95" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="114" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="135" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="154" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="175" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="194" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="215" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.80" stroke="#dc2626" stroke-opacity="0.28"/><text x="234" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">24</text><rect x="255" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.80" stroke="#dc2626" stroke-opacity="0.28"/><text x="274" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">24</text><rect x="295" y="215" width="38" height="38" rx="3" fill="#dc2626" fill-opacity="0.67" stroke="#dc2626" stroke-opacity="0.28"/><text x="314" y="238" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">20</text><text x="114" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">7</text><text x="154" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">8</text><text x="194" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">9</text><text x="234" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">10</text><text x="274" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">11</text><text x="314" y="268" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">12</text><text x="88" y="118" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">0.2</text><text x="88" y="158" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">0.7</text><text x="88" y="198" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">2</text><text x="88" y="238" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">4</text><text x="215" y="285" text-anchor="middle" font-size="10.5" fill="var(--text-tertiary,#9ca3af)">target_gap →</text><text x="65" y="175" text-anchor="middle" font-size="10.5" fill="var(--text-tertiary,#9ca3af)" transform="rotate(-90 65 175)">s_m →</text><text x="697" y="69" text-anchor="middle" font-size="13.5" font-weight="700" fill="var(--text-primary,#1f2937)">W sharp edge × A</text><text x="697" y="85" text-anchor="middle" font-size="10.5" fill="var(--text-secondary,#6b7280)">the channel-close slides with A (≈4 at low A, ≈8 at A=100)</text><rect x="545" y="95" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.20" stroke="#dc2626" stroke-opacity="0.28"/><text x="563" y="117" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">6</text><rect x="583" y="95" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.20" stroke="#dc2626" stroke-opacity="0.28"/><text x="601" y="117" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">6</text><rect x="621" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="639" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="659" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="677" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="697" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="715" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="735" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="753" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="773" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="791" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="811" y="95" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="829" y="117" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="545" y="133" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.20" stroke="#dc2626" stroke-opacity="0.28"/><text x="563" y="155" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">6</text><rect x="583" y="133" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.18" stroke="#dc2626" stroke-opacity="0.28"/><text x="601" y="155" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">5</text><rect x="621" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="639" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="659" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="677" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="697" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="715" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="735" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="753" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="773" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="791" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="811" y="133" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="829" y="155" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="545" y="171" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="563" y="193" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="583" y="171" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.83" stroke="#dc2626" stroke-opacity="0.28"/><text x="601" y="193" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">25</text><rect x="621" y="171" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.87" stroke="#dc2626" stroke-opacity="0.28"/><text x="639" y="193" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">26</text><rect x="659" y="171" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.53" stroke="#dc2626" stroke-opacity="0.28"/><text x="677" y="193" text-anchor="middle" font-size="10.5" font-weight="600" fill="#fff">16</text><rect x="697" y="171" width="36" height="36" rx="3" fill="#dc2626" fill-opacity="0.20" stroke="#dc2626" stroke-opacity="0.28"/><text x="715" y="193" text-anchor="middle" font-size="10.5" font-weight="600" fill="var(--text-primary,#1f2937)">6</text><rect x="735" y="171" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="753" y="193" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="773" y="171" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="791" y="193" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><rect x="811" y="171" width="36" height="36" rx="3" fill="var(--positive,#16a34a)" fill-opacity="0.16" stroke="var(--positive,#16a34a)" stroke-opacity="0.28"/><text x="829" y="193" text-anchor="middle" font-size="10.5" font-weight="400" fill="var(--text-primary,#1f2937)">·</text><text x="563" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">3</text><text x="601" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">4</text><text x="639" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">5</text><text x="677" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">6</text><text x="715" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">7</text><text x="753" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">8</text><text x="791" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">9</text><text x="829" y="222" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">10</text><text x="538" y="117" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">1</text><text x="538" y="155" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">10</text><text x="538" y="193" text-anchor="end" font-size="10" fill="var(--text-secondary,#6b7280)">100</text><text x="697" y="239" text-anchor="middle" font-size="10.5" fill="var(--text-tertiary,#9ca3af)">window (W) →</text><text x="515" y="152" text-anchor="middle" font-size="10.5" fill="var(--text-tertiary,#9ca3af)" transform="rotate(-90 515 152)">A →</text></svg>
package/docs/investigations/hlg-figs/k20-peaks.svg ADDED
@@ -0,0 +1 @@
1
+ <svg viewBox="0 0 900 300" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="t2 d2" font-family="ui-sans-serif,system-ui,sans-serif"><title id="t2">K=20 diversity sweeps</title><desc id="d2">At K=20, L_W diversity sits uniformly below the default; the A gradient is a clean monotone that only beats default at the loosest A.</desc><text x="450" y="24" text-anchor="middle" font-size="16" font-weight="700" fill="var(--text-primary,#1f2937)">Settled diversity at K=20 — one claim dies, one confirms</text><text x="239" y="48" text-anchor="middle" font-size="13.5" font-weight="700" fill="var(--text-primary,#1f2937)">L_W around the supposed peak</text><text x="239" y="64" text-anchor="middle" font-size="10.5" fill="#2563eb">K=20: uniformly BELOW default — the K=6 peak was noise</text><line x1="42" y1="307.06666666666666" x2="436" y2="307.06666666666666" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="36" y="311.06666666666666" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.30</text><line x1="42" y1="245.73333333333332" x2="436" y2="245.73333333333332" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="36" y="249.73333333333332" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.40</text><line x1="42" y1="184.40000000000003" x2="436" y2="184.40000000000003" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="36" y="188.40000000000003" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.50</text><line x1="42" y1="123.06666666666669" x2="436" y2="123.06666666666669" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="36" y="127.06666666666669" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.60</text><line x1="42" y1="102.82666666666668" x2="436" y2="102.82666666666668" stroke="var(--text-tertiary,#9ca3af)" stroke-width="1.3" stroke-dasharray="6 4"/><text x="436" y="97.82666666666668" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">default 0.633</text><line x1="82.7586206896552" y1="258" x2="82.7586206896552" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="82.7586206896552" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.8</text><line x1="232.20689655172413" y1="258" x2="232.20689655172413" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="232.20689655172413" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">1.0</text><line x1="368.06896551724134" y1="258" x2="368.06896551724134" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="368.06896551724134" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">1.2</text><text x="239" y="291" text-anchor="middle" font-size="10.5" fill="var(--text-secondary,#6b7280)">OOTF γ →</text><path d="M82.8 232.9 L130.3 234.7 L177.9 238.4 L225.4 226.1 L273.0 221.8 L320.5 217.5 L368.1 219.4 L415.6 220.6" fill="none" stroke="#2563eb" stroke-width="2.5"/><circle cx="82.7586206896552" cy="232.85333333333335" r="3.5" fill="#2563eb" /><circle cx="130.3103448275862" cy="234.69333333333336" r="3.5" fill="#2563eb" /><circle cx="177.86206896551727" cy="238.37333333333336" r="3.5" fill="#2563eb" /><circle cx="225.41379310344828" cy="226.10666666666668" r="3.5" fill="#2563eb" /><circle cx="272.9655172413793" cy="221.81333333333333" r="3.5" fill="#2563eb" /><circle cx="320.51724137931024" cy="217.52" r="3.5" fill="#2563eb" /><circle cx="368.06896551724134" cy="219.36" r="3.5" fill="#2563eb" /><circle cx="415.62068965517244" cy="220.58666666666667" r="3.5" fill="#2563eb" /><text x="689" y="48" text-anchor="middle" font-size="13.5" font-weight="700" fill="var(--text-primary,#1f2937)">A diversity gradient</text><text x="689" y="64" text-anchor="middle" font-size="10.5" fill="#16a34a">clean monotone — the free lever; only loosest A beats default</text><line x1="492" y1="248.8" x2="886" y2="248.8" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="486" y="252.8" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.30</text><line x1="492" y1="202.8" x2="886" y2="202.8" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="486" y="206.8" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.40</text><line x1="492" y1="156.8" x2="886" y2="156.8" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="486" y="160.8" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.50</text><line x1="492" y1="110.80000000000004" x2="886" y2="110.80000000000004" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="486" y="114.80000000000004" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">0.60</text><line x1="492" y1="95.62" x2="886" y2="95.62" stroke="var(--text-tertiary,#9ca3af)" stroke-width="1.3" stroke-dasharray="6 4"/><text x="886" y="90.62" text-anchor="end" font-size="9.5" fill="var(--text-tertiary,#9ca3af)">default 0.633</text><line x1="510.76190476190476" y1="258" x2="510.76190476190476" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="510.76190476190476" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.01</text><line x1="641.9019912897102" y1="258" x2="641.9019912897102" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="641.9019912897102" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.05</text><line x1="698.3809523809524" y1="258" x2="698.3809523809524" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="698.3809523809524" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.1</text><line x1="800.4584807019089" y1="258" x2="800.4584807019089" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="800.4584807019089" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.35</text><line x1="856.937441793151" y1="258" x2="856.937441793151" y2="262" stroke="var(--text-tertiary,#9ca3af)"/><text x="856.937441793151" y="274" text-anchor="middle" font-size="9.5" fill="var(--text-secondary,#6b7280)">0.7</text><text x="689" y="291" text-anchor="middle" font-size="10.5" fill="var(--text-secondary,#6b7280)">A (shoulder) →</text><path d="M510.8 81.8 L641.9 140.2 L698.4 160.0 L754.9 180.7 L800.5 185.8 L856.9 242.4" fill="none" stroke="#16a34a" stroke-width="2.5"/><circle cx="510.76190476190476" cy="81.82" r="5" fill="#16a34a" stroke="#16a34a" stroke-width="2"/><circle cx="641.9019912897102" cy="140.24" r="3.5" fill="#16a34a" /><circle cx="698.3809523809524" cy="160.02000000000004" r="3.5" fill="#16a34a" /><circle cx="754.8599134721946" cy="180.72000000000003" r="3.5" fill="#16a34a" /><circle cx="800.4584807019089" cy="185.78000000000003" r="3.5" fill="#16a34a" /><circle cx="856.937441793151" cy="242.36" r="3.5" fill="#16a34a" /></svg>
package/docs/investigations/hlg-figs/lw-curve.svg ADDED
@@ -0,0 +1 @@
1
+ <svg viewBox="0 0 800 480" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="t d" font-family="ui-sans-serif,system-ui,sans-serif"><title id="t">L_W (OOTF γ) — diversity curve</title><desc id="d">Diversity vs OOTF gamma for the L_W knob; coherent band shaded, walls at gamma below 0 and above ~2.4, interior diversity peak near gamma 1.</desc><text x="400" y="28" text-anchor="middle" font-size="16" font-weight="700" fill="var(--text-primary,#1f2937)">L_W across 3 models — a coherence-robust curvature knob; diversity response differs</text><text x="400" y="46" text-anchor="middle" font-size="11.5" fill="var(--text-secondary,#6b7280)">x = OOTF γ (= 1.2 + 0.42·log₁₀(L_W/1000)) · y = diversity (1−self-BLEU) · 3 models · coherent across ~5 decades, walls only at the extremes</text><rect x="165.78947368421052" y="70" width="466.66666666666663" height="326" fill="var(--positive,#16a34a)" fill-opacity="0.06"/><text x="399.12280701754383" y="84" text-anchor="middle" font-size="10.5" fill="var(--positive,#16a34a)" font-weight="600">coherent band (L_W 3 … 100k+)</text><line x1="131.4035087719298" y1="70" x2="131.4035087719298" y2="396" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="4 3" stroke-opacity="0.7"/><text x="127.40350877192981" y="390" text-anchor="end" font-size="10" fill="#b91c1c">γ&lt;0 inverts → wall (all)</text><line x1="720.8771929824561" y1="70" x2="720.8771929824561" y2="396" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="4 3" stroke-opacity="0.7"/><text x="715.8771929824561" y="98" text-anchor="end" font-size="10" fill="#b91c1c">over-sharpen wall (Gemmas only)</text><line x1="70" y1="375.625" x2="770" y2="375.625" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="379.625" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.50</text><line x1="70" y1="324.6875" x2="770" y2="324.6875" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="328.6875" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.55</text><line x1="70" y1="273.7499999999999" x2="770" y2="273.7499999999999" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="277.7499999999999" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.60</text><line x1="70" y1="222.8124999999999" x2="770" y2="222.8124999999999" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="226.8124999999999" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.65</text><line x1="70" y1="171.87499999999986" x2="770" y2="171.87499999999986" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="175.87499999999986" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.70</text><line x1="70" y1="120.93749999999983" x2="770" y2="120.93749999999983" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="124.93749999999983" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.75</text><line x1="70" y1="69.99999999999979" x2="770" y2="69.99999999999979" stroke="var(--border,#e5e7eb)" stroke-opacity="0.6"/><text x="62" y="73.99999999999979" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">0.80</text><line x1="131.4035087719298" y1="396" x2="131.4035087719298" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="131.4035087719298" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">0.0</text><text x="131.4035087719298" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 100</text><line x1="254.21052631578945" y1="396" x2="254.21052631578945" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="254.21052631578945" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">0.5</text><text x="254.21052631578945" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 21</text><line x1="377.0175438596491" y1="396" x2="377.0175438596491" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="377.0175438596491" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">1.0</text><text x="377.0175438596491" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 334</text><line x1="426.14035087719293" y1="396" x2="426.14035087719293" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="426.14035087719293" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">1.2</text><text x="426.14035087719293" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 1k</text><line x1="499.82456140350877" y1="396" x2="499.82456140350877" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="499.82456140350877" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">1.5</text><text x="499.82456140350877" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 5k</text><line x1="622.6315789473684" y1="396" x2="622.6315789473684" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="622.6315789473684" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">2.0</text><text x="622.6315789473684" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 80k</text><line x1="745.438596491228" y1="396" x2="745.438596491228" y2="401" stroke="var(--text-tertiary,#9ca3af)"/><text x="745.438596491228" y="414" text-anchor="middle" font-size="10" fill="var(--text-secondary,#6b7280)">2.5</text><text x="745.438596491228" y="427" text-anchor="middle" font-size="8.5" fill="var(--text-tertiary,#9ca3af)">L_W 1.4M</text><text x="420" y="466" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">OOTF γ → sharper</text><text x="18" y="233" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)" transform="rotate(-90 18 233)">diversity →</text><rect x="70" y="151.50000000000006" width="700" height="40.749999999999886" fill="var(--text-tertiary,#9ca3af)" fill-opacity="0.13"/><line x1="70" y1="192.24999999999994" x2="770" y2="192.24999999999994" stroke="var(--text-tertiary,#9ca3af)" stroke-width="1" stroke-dasharray="6 4" stroke-opacity="0.7"/><line x1="70" y1="151.50000000000006" x2="770" y2="151.50000000000006" stroke="var(--text-tertiary,#9ca3af)" stroke-width="1" stroke-dasharray="6 4" stroke-opacity="0.7"/><text x="766" y="146.50000000000006" text-anchor="end" font-size="10" fill="var(--text-tertiary,#9ca3af)">default recipes (0.68–0.72)</text><path d="M165.8 202.4 L219.8 182.1 L268.9 192.2 L323.0 182.1 L372.1 110.8 L426.1 151.5 L475.3 283.9 L529.3 263.6 L578.4 263.6 L632.5 304.3" fill="none" stroke="#2563eb" stroke-width="2.5"/><circle cx="165.78947368421052" cy="202.43749999999997" r="3.5" fill="#2563eb"/><circle cx="219.82456140350877" cy="182.06250000000006" r="3.5" fill="#2563eb"/><circle cx="268.9473684210526" cy="192.24999999999994" r="3.5" fill="#2563eb"/><circle cx="322.9824561403509" cy="182.06250000000006" r="3.5" fill="#2563eb"/><circle cx="372.1052631578947" cy="110.75000000000003" r="3.5" fill="#2563eb"/><circle cx="426.14035087719293" cy="151.50000000000006" r="3.5" fill="#2563eb"/><circle cx="475.26315789473676" cy="283.9375" r="3.5" fill="#2563eb"/><circle cx="529.2982456140351" cy="263.5625" r="3.5" fill="#2563eb"/><circle cx="578.421052631579" cy="263.5625" r="3.5" fill="#2563eb"/><circle cx="632.4561403508771" cy="304.3125000000001" r="3.5" fill="#2563eb"/><text x="116.66666666666666" y="392" text-anchor="middle" font-size="13" fill="#b91c1c" font-weight="700">✗</text><text x="735.6140350877192" y="392" text-anchor="middle" font-size="13" fill="#b91c1c" font-weight="700">✗</text><path d="M165.8 345.1 L219.8 365.4 L268.9 365.4 L323.0 365.4 L372.1 314.5 L426.1 334.9 L475.3 334.9 L529.3 324.7 L578.4 324.7 L632.5 324.7" fill="none" stroke="#d97706" stroke-width="2.5"/><circle cx="165.78947368421052" cy="345.06249999999994" r="3.5" fill="#d97706"/><circle cx="219.82456140350877" cy="365.43749999999994" r="3.5" fill="#d97706"/><circle cx="268.9473684210526" cy="365.43749999999994" r="3.5" fill="#d97706"/><circle cx="322.9824561403509" cy="365.43749999999994" r="3.5" fill="#d97706"/><circle cx="372.1052631578947" cy="314.4999999999999" r="3.5" fill="#d97706"/><circle cx="426.14035087719293" cy="334.87499999999994" r="3.5" fill="#d97706"/><circle cx="475.26315789473676" cy="334.87499999999994" r="3.5" fill="#d97706"/><circle cx="529.2982456140351" cy="324.6875" r="3.5" fill="#d97706"/><circle cx="578.421052631579" cy="324.6875" r="3.5" fill="#d97706"/><circle cx="632.4561403508771" cy="324.6875" r="3.5" fill="#d97706"/><text x="116.66666666666666" y="392" text-anchor="middle" font-size="13" fill="#b91c1c" font-weight="700">✗</text><text x="735.6140350877192" y="392" text-anchor="middle" font-size="13" fill="#b91c1c" font-weight="700">✗</text><path d="M165.8 233.0 L219.8 283.9 L268.9 263.6 L323.0 304.3 L372.1 304.3 L426.1 314.5 L475.3 324.7 L529.3 294.1 L578.4 314.5 L632.5 345.1 L735.6 314.5" fill="none" stroke="#0891b2" stroke-width="2.5"/><circle cx="165.78947368421052" cy="233" r="3.5" fill="#0891b2"/><circle cx="219.82456140350877" cy="283.9375" r="3.5" fill="#0891b2"/><circle cx="268.9473684210526" cy="263.5625" r="3.5" fill="#0891b2"/><circle cx="322.9824561403509" cy="304.3125000000001" r="3.5" fill="#0891b2"/><circle cx="372.1052631578947" cy="304.3125000000001" r="3.5" fill="#0891b2"/><circle cx="426.14035087719293" cy="314.4999999999999" r="3.5" fill="#0891b2"/><circle cx="475.26315789473676" cy="324.6875" r="3.5" fill="#0891b2"/><circle cx="529.2982456140351" cy="294.125" r="3.5" fill="#0891b2"/><circle cx="578.421052631579" cy="314.4999999999999" r="3.5" fill="#0891b2"/><circle cx="632.4561403508771" cy="345.06249999999994" r="3.5" fill="#0891b2"/><circle cx="735.6140350877192" cy="314.4999999999999" r="3.5" fill="#0891b2"/><text x="116.66666666666666" y="392" text-anchor="middle" font-size="13" fill="#b91c1c" font-weight="700">✗</text><line x1="295" y1="61" x2="315" y2="61" stroke="#2563eb" stroke-width="2.5"/><circle cx="305" cy="61" r="3.5" fill="#2563eb"/><text x="321" y="65" font-size="11" fill="var(--text-secondary,#6b7280)">e4b</text><line x1="365" y1="61" x2="385" y2="61" stroke="#d97706" stroke-width="2.5"/><circle cx="375" cy="61" r="3.5" fill="#d97706"/><text x="391" y="65" font-size="11" fill="var(--text-secondary,#6b7280)">12B</text><line x1="435" y1="61" x2="455" y2="61" stroke="#0891b2" stroke-width="2.5"/><circle cx="445" cy="61" r="3.5" fill="#0891b2"/><text x="461" y="65" font-size="11" fill="var(--text-secondary,#6b7280)">CPM5</text></svg>
package/docs/investigations/hlg-figs/terrain.svg ADDED
@@ -0,0 +1 @@
1
+ <svg viewBox="0 0 900 470" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="ht htd" font-family="ui-sans-serif,system-ui,sans-serif"><title id="ht">HLG diversity terrain — two planes</title><desc id="htd">Heatmaps of self-BLEU diversity across the A×s_m and target_gap×W planes; darker = more diverse; ✗ = incoherent; green outline = above the default contour.</desc><text x="450" y="28" text-anchor="middle" font-size="17" font-weight="700" fill="var(--text-primary,#1f2937)">HLG diversity terrain (e4b) — coherent basin + diversity (self-BLEU)</text><text x="235" y="60" text-anchor="middle" font-size="15" font-weight="700" fill="var(--text-primary,#1f2937)">A × s_m</text><text x="235" y="78" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">A (shoulder) → tighter</text><text x="84" y="215" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)" transform="rotate(-90 84 215)">s_m →</text><text x="135" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">0.01</text><text x="185" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">0.05</text><text x="235" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">0.2</text><text x="285" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">1</text><text x="335" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">5</text><text x="102" y="119" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">0.05</text><text x="102" y="169" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">0.2</text><text x="102" y="219" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">0.7</text><text x="102" y="269" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">1.5</text><text x="102" y="319" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">3</text><rect x="110" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.78" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="134" y="118" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.81</text><rect x="160" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.82" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="184" y="118" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.83</text><rect x="210" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.90" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="234" y="118" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.86</text><rect x="260" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.80" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="284" y="118" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.82</text><rect x="310" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.15" stroke="var(--border,#e5e7eb)"/><text x="334" y="118" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.56</text><rect x="110" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.87" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="134" y="168" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.85</text><rect x="160" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.57" stroke="var(--border,#e5e7eb)"/><text x="184" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.73</text><rect x="210" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.90" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="234" y="168" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.86</text><rect x="260" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.65" stroke="var(--border,#e5e7eb)"/><text x="284" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.76</text><rect x="310" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.20" stroke="var(--border,#e5e7eb)"/><text x="334" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.58</text><rect x="110" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.75" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="134" y="218" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.80</text><rect x="160" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.60" stroke="var(--border,#e5e7eb)"/><text x="184" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.74</text><rect x="210" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.78" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="234" y="218" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.81</text><rect x="260" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.55" stroke="var(--border,#e5e7eb)"/><text x="284" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.72</text><rect x="310" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.43" stroke="var(--border,#e5e7eb)"/><text x="334" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.67</text><rect x="110" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.73" stroke="var(--border,#e5e7eb)"/><text x="134" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.79</text><rect x="160" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.52" stroke="var(--border,#e5e7eb)"/><text x="184" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.71</text><rect x="210" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.60" stroke="var(--border,#e5e7eb)"/><text x="234" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.74</text><rect x="260" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.40" stroke="var(--border,#e5e7eb)"/><text x="284" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.66</text><rect x="310" y="240" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="334" y="269" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="110" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.70" stroke="var(--border,#e5e7eb)"/><text x="134" y="318" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.78</text><rect x="160" y="290" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="184" y="319" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="210" y="290" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="234" y="319" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="260" y="290" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="284" y="319" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="310" y="290" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="334" y="319" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><text x="725" y="60" text-anchor="middle" font-size="15" font-weight="700" fill="var(--text-primary,#1f2937)">target_gap × W</text><text x="725" y="78" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">target_gap → sharper</text><text x="574" y="215" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)" transform="rotate(-90 574 215)">W →</text><text x="625" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">10</text><text x="675" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">13</text><text x="725" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">16</text><text x="775" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">25</text><text x="825" y="356" text-anchor="middle" font-size="11" fill="var(--text-secondary,#6b7280)">50</text><text x="592" y="119" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">4</text><text x="592" y="169" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">5</text><text x="592" y="219" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">6</text><text x="592" y="269" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">10</text><text x="592" y="319" text-anchor="end" font-size="11" fill="var(--text-secondary,#6b7280)">20</text><rect x="600" y="90" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="624" y="119" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="650" y="90" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="674" y="119" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="700" y="90" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="724" y="119" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="750" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.70" stroke="var(--border,#e5e7eb)"/><text x="774" y="118" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.78</text><rect x="800" y="90" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.17" stroke="var(--border,#e5e7eb)"/><text x="824" y="118" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.57</text><rect x="600" y="140" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="624" y="169" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="650" y="140" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="674" y="169" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="700" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.63" stroke="var(--border,#e5e7eb)"/><text x="724" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.75</text><rect x="750" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.70" stroke="var(--border,#e5e7eb)"/><text x="774" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.78</text><rect x="800" y="140" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.17" stroke="var(--border,#e5e7eb)"/><text x="824" y="168" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.57</text><rect x="600" y="190" width="48" height="48" rx="4" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="624" y="219" text-anchor="middle" font-size="15" fill="var(--text-tertiary,#9ca3af)">✗</text><rect x="650" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.78" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="674" y="218" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.81</text><rect x="700" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.52" stroke="var(--border,#e5e7eb)"/><text x="724" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.71</text><rect x="750" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.52" stroke="var(--border,#e5e7eb)"/><text x="774" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.71</text><rect x="800" y="190" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.07" stroke="var(--border,#e5e7eb)"/><text x="824" y="218" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.50</text><rect x="600" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.63" stroke="var(--border,#e5e7eb)"/><text x="624" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.75</text><rect x="650" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.70" stroke="var(--border,#e5e7eb)"/><text x="674" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.78</text><rect x="700" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.60" stroke="var(--border,#e5e7eb)"/><text x="724" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.74</text><rect x="750" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.57" stroke="var(--border,#e5e7eb)"/><text x="774" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="#fff">0.73</text><rect x="800" y="240" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.17" stroke="var(--border,#e5e7eb)"/><text x="824" y="268" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.57</text><rect x="600" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.95" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="624" y="318" text-anchor="middle" font-size="11" font-weight="700" fill="#fff">0.88</text><rect x="650" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.20" stroke="var(--border,#e5e7eb)"/><text x="674" y="318" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.58</text><rect x="700" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.33" stroke="var(--border,#e5e7eb)"/><text x="724" y="318" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.63</text><rect x="750" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.25" stroke="var(--border,#e5e7eb)"/><text x="774" y="318" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.60</text><rect x="800" y="290" width="48" height="48" rx="4" fill="var(--accent,#2563eb)" fill-opacity="0.20" stroke="var(--border,#e5e7eb)"/><text x="824" y="318" text-anchor="middle" font-size="11" font-weight="400" fill="var(--text-primary,#1f2937)">0.58</text><g transform="translate(110,442)"><rect x="0" y="-10" width="16" height="16" rx="3" fill="var(--bg-tertiary,#e5e7eb)" stroke="var(--border,#d1d5db)"/><text x="22" y="3" font-size="11" fill="var(--text-secondary,#6b7280)">✗ incoherent (canary broke)</text><rect x="200" y="-10" width="16" height="16" rx="3" fill="var(--accent,#2563eb)" fill-opacity="0.3"/><rect x="218" y="-10" width="16" height="16" rx="3" fill="var(--accent,#2563eb)" fill-opacity="0.85"/><text x="240" y="3" font-size="11" fill="var(--text-secondary,#6b7280)">diversity: light → dark = more diverse</text><rect x="540" y="-10" width="16" height="16" rx="3" fill="none" stroke="var(--positive,#16a34a)" stroke-width="2"/><text x="562" y="3" font-size="11" fill="var(--text-secondary,#6b7280)">above default contour (0.799)</text></g></svg>