docs(radiance): reference the engine — options, plugins, conversion, tools, operations #88

Merged
dank merged 3 commits from docs/radiance-engine-reference into main 2026-10-30 15:17:58 -07:00
Owner

Summary

Nine pages under serverAppConfigs-docs/LLM/, read from upstream codeberg.org/StillDeadcode/radiance at 8da043c (release 1.14.0, plugin ABI 31): GUIDE.md, TOOLS.md, PLUGIN.md, ARCHITECTURES.md, OPS.md, DOCKER.md, spec.md, every abi/ header, the core/config.cpp flag table, rad_convert.cpp's usage, the recipe parser, and a working kernel plugin (plugin/spechub).

serverAppConfigs-docs/LLM/
├── Radiance Engine.md                 140  shape, RAD2 container, selection key, ABI, env
├── Radiance Serve Options.md          240  every serve flag grouped + the law per knob
├── Radiance HTTP API.md               198  endpoints, request fields, guarded/refused/clamped
├── Radiance Conversion.md             354  rad-convert/rad-export, recipes, quantisers, imports, KL
├── Radiance Model Families.md         142  (arch id, quant) → plugin, recipe and command per family
├── Radiance Plugins.md                371  kernel + quantiser ABI, hooks, encodings, build, checks
├── Radiance Architecture Plugins.md   287  weights/buffers/KV/ops, step, mixed-step, probe, media
├── Radiance Tools.md                  322  rad-info/kbench/tune/schemas/avx/tokcheck + harnesses
└── Radiance Operations.md             239  container contract, host prereqs, receipt, restarts

Also: LLM/index.md gains a radiance section, the root index is regenerated, and frank-archon.md's dangling Related: line (ending in a comma) is completed with links to the set. Engine defaults are owned by the new pages; the fleet's 1.8.1 pin, shape, Eras and measured laws stay on frank-archon.

The branch carries a merge of origin/main (9085a80) and makes no code or service change.

Evidence

  • Before: no radiance engine reference in the vault; only the live endpoint page.
    After:
    • ./tests/run.sh → ==> ALL TESTS PASSED (589 tests, 95.32 s, run after the merge).
    • bats tests/docs_completeness.bats → 6/6 (index coverage, no unresolved links, one page per live endpoint, OKF v0.1, generated indices).
    • python3 scripts/check-okf.py serverAppConfigs-docs → 118 concept pages, 0 OKF violations.
    • python3 scripts/check-vault-links.py serverAppConfigs-docs → 118 pages, 0 unresolved links.
    • Tables checked for unescaped pipes: 0 rows.
  • Scope evidence: git show --stat bdc0613 and git diff --stat 3a04e34..HEAD show only serverAppConfigs-docs/** paths.

Merge Danger

Door: two-way — docs-only; a revert restores the previous pages, and the deploy planner treats documentation-only changes as a no-op.

Blast Radius: none operational — no compose, Caddyfile, quadlet, serve script or unit is touched; the only frank-archon.md change is the Related line.


cwd: /home/blank/.omp/wt/wt-20261030-143311-6d1fc1f · session: 01a18ebb-16f1-70c1-9f89-92bf07b2deae

## Summary Nine pages under `serverAppConfigs-docs/LLM/`, read from upstream `codeberg.org/StillDeadcode/radiance` at `8da043c` (release 1.14.0, plugin ABI 31): `GUIDE.md`, `TOOLS.md`, `PLUGIN.md`, `ARCHITECTURES.md`, `OPS.md`, `DOCKER.md`, `spec.md`, every `abi/` header, the `core/config.cpp` flag table, `rad_convert.cpp`'s usage, the recipe parser, and a working kernel plugin (`plugin/spechub`). ```text serverAppConfigs-docs/LLM/ ├── Radiance Engine.md 140 shape, RAD2 container, selection key, ABI, env ├── Radiance Serve Options.md 240 every serve flag grouped + the law per knob ├── Radiance HTTP API.md 198 endpoints, request fields, guarded/refused/clamped ├── Radiance Conversion.md 354 rad-convert/rad-export, recipes, quantisers, imports, KL ├── Radiance Model Families.md 142 (arch id, quant) → plugin, recipe and command per family ├── Radiance Plugins.md 371 kernel + quantiser ABI, hooks, encodings, build, checks ├── Radiance Architecture Plugins.md 287 weights/buffers/KV/ops, step, mixed-step, probe, media ├── Radiance Tools.md 322 rad-info/kbench/tune/schemas/avx/tokcheck + harnesses └── Radiance Operations.md 239 container contract, host prereqs, receipt, restarts ``` Also: `LLM/index.md` gains a radiance section, the root index is regenerated, and `frank-archon.md`'s dangling `Related:` line (ending in a comma) is completed with links to the set. Engine defaults are owned by the new pages; the fleet's 1.8.1 pin, shape, Eras and measured laws stay on `frank-archon`. The branch carries a merge of `origin/main` (`9085a80`) and makes no code or service change. ## Evidence - **Before:** no radiance engine reference in the vault; only the live endpoint page. **After:** - `./tests/run.sh` → `==> ALL TESTS PASSED` (589 tests, 95.32 s, run after the merge). - `bats tests/docs_completeness.bats` → 6/6 (index coverage, no unresolved links, one page per live endpoint, OKF v0.1, generated indices). - `python3 scripts/check-okf.py serverAppConfigs-docs` → `118 concept pages, 0 OKF violations`. - `python3 scripts/check-vault-links.py serverAppConfigs-docs` → `118 pages, 0 unresolved links`. - Tables checked for unescaped pipes: 0 rows. - **Scope evidence:** `git show --stat bdc0613` and `git diff --stat 3a04e34..HEAD` show only `serverAppConfigs-docs/**` paths. ## Merge Danger **Door:** two-way — docs-only; a revert restores the previous pages, and the deploy planner treats documentation-only changes as a no-op. **Blast Radius:** none operational — no compose, Caddyfile, quadlet, serve script or unit is touched; the only `frank-archon.md` change is the Related line. --- cwd: /home/blank/.omp/wt/wt-20261030-143311-6d1fc1f · session: 01a18ebb-16f1-70c1-9f89-92bf07b2deae
dank added 3 commits 2026-10-30 15:08:46 -07:00
Nine pages under LLM/ document the upstream radiance engine at 8da043c:
- engine shape, plugin model, RAD2 container, ABI and environment
- every serve flag grouped with defaults and the law behind each knob
- the HTTP surface, request fields and refusal classes
- rad-convert, the recipe language, quantisers, imports, reuse, rad-export, KL scoring
- the (arch id, quant) family table and the recipe of record per model
- kernel/quantiser plugin authoring, encodings, build and checks
- architecture plugin authoring: declare, step, probe, lane and media rules
- rad-info/radbench/radtune and the shell harnesses
- the container contract, host prerequisites, readiness and restart triage

Also completes the dangling Related line on the frank-archon endpoint page.
dank merged commit b45771e87e into main 2026-10-30 15:17:58 -07:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: dank/serverAppConfigs#88