frank-primary: PLE ready timeout 1800s + bench matrix runbook; index/doc-link fixes

- frank-primary.env: R9V_PLE_READY_TIMEOUT=1800 (PLE registration measured
  740s under page-cache churn; engine default 600s killed a prod boot
  2026-09-28; launch.sh 2de0357 forwards it)
- runbook: prefill/decode bench matrix section (chunk ceiling 4096,
  80-slot policy max, MTP6 3.7x worse, prefix-caching evidence +
  recommendation), fork commit list, residency wording
- index: q8 runbook ACTIVE, uncensored RETIRED (rollback); log entry
  incl. the 9h downtime incident

.gitignore

@@ -37,3 +37,4 @@ __pycache__/
 # Editor/OS noise
 *.swp
 .DS_Store
+third_party/

AGENTS.md

@@ -9,10 +9,10 @@ services run from `/home/dank/serverAppConfigs` on each host (the 2026-08-22
 merge absorbed the former `vllmScripts` repo, history preserved).
 
 - **Dankserver** (192.168.0.235) — media/library stack (RomM, Copyparty,
-  Calibre-Web, Jellyfin, Plex) plus the `frank-medium` LLM service.
+  Calibre-Web, Jellyfin, Plex) plus the `frank-primary` LLM service.
 - **Dankclaw** (192.168.0.143) — AI/search/dev/observability stack (SearXNG
   via Gluetun, ComfyUI, OpenWebUI, Hermes, Gitea, Grafana, Prometheus, Loki,
-  Alloy, Pi-hole) plus TWO LLM services: `frank-large` (halogen-flash-server on
+  Alloy, Pi-hole) plus TWO LLM services: `frank-large` (stock llama.cpp on
   the gfx1151 iGPU) and `frank-small` (llama.cpp on the RTX 3090). Caddy on
   Dankclaw reverse-proxies both hosts.
 - **FrankBook-Pro** (192.168.0.112) — macOS mini running the *arr stack
@@ -24,9 +24,9 @@ merge absorbed the former `vllmScripts` repo, history preserved).
 
 | Target | Service | Runtime | Model | Port |
 |--------|---------|---------|-------|------|
-| Dankserver | `frank-medium` | mainline llama.cpp master fb27a525 (root systemd unit, gfx1201 HIP build) | ajgazin Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP UD-Q8_K_XL + z-lab Qwen3.8-27B-DFlash2 Q8_0 drafter, 2x Radeon AI PRO R9700 in ONE layer-split process (35:30), 262144 ctx over 2 slots, batch 6144x512, text only | 7770 |
-| Dankclaw | `frank-large` | halogen-flash-server 0.5.8 (rootless Quadlet) | peonist-ai Qwen3.8-Flash-Next w4b `.hgn` on the gfx1151 iGPU (Strix Halo LPDDR), 200192 ctx per conversation over one 400384-position KV pool / 2 slots, text only | 7770 |
-| Dankclaw | `frank-small` | mainline llama.cpp master 37b53fd (root systemd unit) | ISTA-DASLab Qwen3.8-27B-GSQ-RCO IQ3_S (`-mtp` + BF16 mmproj) on the RTX 3090, 131072 ctx / 1 slot, MTP speculative decoding, the fleet's vision endpoint | 7771 |
+| Dankserver | `frank-primary` | R9V radiance-vLLM fork `drwolfen/radiance-vllm-qwen4exp` (docker-pinned image bundle `2dac17a2`, docker→podman shim, root systemd unit) | unsloth Qwen3.8-Flash-Next-GGUF Q8_0 (175.30 GiB, 6 GGUF shards) with the blockfp8 MTP4 head (depth 4) and mmproj, TP=2 tiered experts (80-slot LRU cache; PLE n-gram PINNED in host RAM 54.4 GB; quantized inject-shard dev-overlay adapter), CED off, 131072 ctx single stream, Qwen-Sharp template, tool parser `qwen3_coder`, reasoning channel `reasoning` | 7770 |
+| Dankclaw | `frank-large` | unsloth llama.cpp b11030 prebuilt (ROCm gfx1151, root systemd unit) | unsloth Qwen3.8-27B-GGUF:UD-Q8_K_XL (27B dense, 31.5 GiB) with the z-lab DFlash2 Q4_K_M drafter (depth 4) on the gfx1151 iGPU (Strix Halo LPDDR, 114 GiB GTT), 262144 ctx single stream (1 slot), q8_0 KV, text only | 7770 |
+| Dankclaw | `frank-small` | mainline llama.cpp master 37b53fd (root systemd unit) | HauhauCS Gemma4-12B-QAT-Uncensored-Balanced Q4_K_M (BF16 mmproj + MTP assistant sidecar, `draft-mtp,ngram-mod`) on the RTX 3090, 1048576 pool / 4 slots of 262,144, q8_0 KV, the fleet's fastest vision endpoint | 7771 |
 
 Retired endpoints (`frank-npu`, and every prior runtime) are in
 the [runbook index](#runbook-index). The full swap history lives in
@@ -61,15 +61,16 @@ All edits flow through git. Never edit files on a remote machine directly.
 ./scripts/deploy.sh dankclaw
 ./scripts/deploy.sh dankserver
 ./scripts/deploy.sh dankclaw --service searxng
-./scripts/deploy.sh dankserver --service frank-medium
+./scripts/deploy.sh dankserver --service frank-primary
 ./scripts/deploy.sh dankclaw --dry-run
 ```
 
 The planner maps changed paths to services; the remote runner restarts only
 the selected service and records its revision outside the checkout.
 Documentation-only changes are a no-op. LLM services are selected only by
-their own files — frank-large by `dankclaw/frank-large/quadlet/`, frank-small
-and frank-medium by their unit/env/serve trio in `scripts/` — so unrelated
+their own files — every endpoint (`frank-large`/`frank-small`/`frank-primary`)
+by its unit/env/serve trio in `scripts/` — so
+unrelated
 container changes cannot interrupt inference. Set `FRANK_SUDO_PW` for headless
 runs on a host without passwordless sudo; the value never enters the repo.
 
@@ -122,14 +123,18 @@ This rule exists because reboots found gaps twice (2026-08-26: Caddy as a
 bare compose container never returned; 2026-09-11: five observability
 services had no units). The observability services now have units under
 `dankclaw/observability/quadlet/` and their compose definitions were removed —
-one owner per container name. The stack is **configured as of 2026-09-16**: a
-Grafana datasource and the `llm-fleet` dashboard are provisioned from
-`shared/grafana/provisioning/`, and `shared/prometheus/rules/llm-fleet.yml`
-loads 5 alert rules + 1 recording rule. Nothing is *delivered* — there is no
-Alertmanager, so a firing alert reaches nobody (an operator decision, not an
-oversight). Five Prometheus targets read down for structural reasons
-(HTML-scraped "probes", Gitea metrics off); the remedy is a blackbox exporter.
-See `serverAppConfigs-docs/Infrastructure/Observability.md`.
+one owner per container name. The stack is **configured and delivering as of
+2026-09-17**: a Grafana datasource and the `llm-fleet` dashboard are
+provisioned from `shared/grafana/provisioning/`, `shared/prometheus/rules/
+llm-fleet.yml` loads 5 alert rules + 1 recording rule, and firing rules are
+delivered: Prometheus → Alertmanager (`dankclaw/observability/quadlet/
+alertmanager.container`, loopback :9093) → host-side Signal relay
+(`scripts/signal-relay.py`, user unit, 192.168.0.143:18093 — the host LAN
+IP, the one bind a container can reach as `host.containers.internal`;
+iptables admits loopback, the host and the podman bridge subnet only) → signal-cli account 318311.
+Prometheus targets read down for structural reasons (HTML-scraped "probes",
+Gitea metrics off); the remedy is a blackbox exporter. See
+`serverAppConfigs-docs/Infrastructure/Observability.md`.
 
 ## Testing
 
@@ -203,9 +208,8 @@ archive.
 
 **STOP the production service BEFORE benchmarking** — these servers serve
 real users, and a bench beside a live service starves the GPU and corrupts
-results. Use the runtime's own harness: `llama-bench` (llama.cpp), `vllm
-bench` (vLLM), and halogen-flash-server's own `bench`/`sweep` modes for
-frank-large, which is the active runtime there again. Rolling your own bench
+results. Use the runtime's own harness: `llama-bench` for every llama.cpp
+endpoint (all three are llama.cpp now). Rolling your own bench
 requires asking first.
 Scratch ports are not used on LLM hosts — a
 test process cannot share the single GPU anyway; validate against the service
@@ -223,16 +227,17 @@ one: `ip neigh show <ip>` from a peer — FAILED means off/NIC dead, while a
 merely wedged kernel usually still answers ARP.
 
 1. Stop and mask (self-healing would restart it):
-   - Dankclaw `frank-large` (rootless Quadlet again since 2026-09-16):
-     `systemctl --user stop frank-large`, then move its
-     `~/.config/containers/systemd/frank-large.container` aside and
-     `systemctl --user daemon-reload` — the quadlet generator re-creates that
-     unit from the file on every reload, so the source is the lever, not `mask`.
+   - Dankclaw `frank-large` (root unit, stock llama.cpp on the iGPU):
+     `sudo systemctl stop frank-large && sudo systemctl mask frank-large`
    - Dankclaw `frank-small` (root unit, llama.cpp on the 3090):
      `sudo systemctl stop frank-small && sudo systemctl mask frank-small`
-   - Dankserver `frank-medium` (system unit):
-     `sudo systemctl stop frank-medium && sudo systemctl mask frank-medium`
+   - Dankserver `frank-primary` (root unit, R9V radiance on the 2x R9700):
+     `sudo systemctl stop frank-primary && sudo systemctl mask frank-primary`
 2. Bench.
+   NOTE: `systemctl mask` FAILS on a relinked unit (the unit file in
+   `/etc/systemd/system/` is itself a symlink into the checkout — mask
+   refuses to replace it). Stop is enough for the bench window; the deploy
+   restores the unit, so re-deploy after benching instead of unmasking.
 3. Unmask and start; verify `curl http://192.168.0.<host>:7770/health`.
 
 **CRITICAL:** never `systemctl disable` a system unit on these hosts — it
@@ -244,9 +249,8 @@ deletes the unit file from `/etc/systemd/system/`, not just the symlink.
 The harness reaches the fleet through `.omp/agent/models.yml` in the
 operator's home — `/home/blank/.omp/agent/models.yml` on the dev box, which is
 where the harness runs; there is no copy on the servers. Each provider is one
-HOST:PORT; each model `id` is the served alias: `frank-medium` →
+HOST:PORT; each model `id` is the served alias: `frank-primary` →
 `192.168.0.235:7770`, `frank-large` → `192.168.0.143:7770`, `frank-small` →
-`192.168.0.143:7771`. Per-role routing lives beside it in `config.yml` under
 `modelRoles`.
 
 Resolution rules: the default model resolves as a `defaultProvider` +
@@ -259,102 +263,168 @@ When renaming a service, retiring an endpoint, or moving a model: update the
 provider block, model `id`, `contextWindow`, `maxTokens`, `input` in
 `models.yml`, then fix every `modelRoles` entry that named the old endpoint —
 a role pointing at a provider the file does not define fails at call time. As
-of 2026-09-16 the image path is `frank-small` (`input: [text, image]`), and
-`frank-large` is text-only because its halogen deployment loads no vision
-tower. There is **no audio** input anywhere in the fleet: that capability left
-with the FLM NPU endpoint on 2026-09-11.
+of 2026-09-26 both `frank-small` and `frank-primary` accept images
+(`input: [text, image]`) — frank-primary loads the BF16 mmproj explicitly
+(this build never autoloads projectors); `frank-large` remains text-only
+because its stock llama.cpp deployment loads no
+vision projector (the mmproj is not loaded). Note also that
+the reasoning channel differs by runtime: llama.cpp endpoints emit
+`reasoning_content`, vLLM emits `reasoning` — academic since the
+2026-09-26 swap, as every endpoint in the fleet is llama.cpp now.
+There is **no audio**
+input anywhere in the fleet except frank-small: that capability left with the
+FLM NPU endpoint on 2026-09-11 and returned on 2026-09-17 with the Gemma4
+projector's audio encoder (frank-small transcribes WAV verbatim even though
+`audio` is omitted from its `input` list — OMP's schema rejects it).
 
-### frank-large — halogen-flash-server (Dankclaw, ACTIVE)
+### frank-large — stock llama.cpp Qwen3.8-27B UD-Q8_K_XL (Dankclaw, ACTIVE)
 
-halogen-flash-server 0.5.8 as a **rootless Quadlet again since 2026-09-16**
-(`dankclaw/frank-large/quadlet/frank-large.container`), serving
-`peonist-ai/halogen-qwen3.8-flash-next` (115.55 GiB w4b `.hgn` checkpoint + a
-quality overlay that re-fetched to 2.40 GiB on 2026-09-16) on port 7770 from
-the gfx1151 iGPU. Two conversations of 200,192 tokens resident (pool 400,384,
-2 slots), greedy default, reasoning extracted to `reasoning_content`, and **no
-vision tower** — that moved to frank-small. It replaced ik_llama.cpp, which had
-replaced it for two days.
+The unsloth llama.cpp prebuilt `app-b11030-mix-5ff778e` (ROCm gfx1151,
+`/home/dank/GitPackages/unsloth-llama-b11030/`, bundles its own ROCm
+runtime — no host SDK gate) as a **root systemd unit**
+(`scripts/frank-large.service`, `User=dank`), serving
+`unsloth/Qwen3.8-27B-GGUF:UD-Q8_K_XL` (27B dense, 31.5 GiB,
+sha256-verified) on port 7770 from the gfx1151 iGPU. One stream, full
+262,144 ctx (the model's native window, `PARALLEL_SLOTS=1`), DFlash2 spec
+decode (the z-lab `Qwen3.8-27B-DFlash2-Q4_K_M` drafter, depth 4,
+`SPEC_DRAFT_N_MAX=4`), reasoning extracted to `reasoning_content`, and
+**no vision projector**. It replaced the Kairic Edge ROCmFPX build (jcbtc
+Qwen3.8-27B-IU4-Kairic-Edge), which had replaced the unsloth
+Qwen3.8-Flash-Next UD-IQ4_XS.
 
-The engine **fetches its own weights on first start** (`HALOGEN_DOWNLOAD`, into
-the `/home/dank/models/halogen` bind mount): clearing that directory and
-restarting the unit is the supported way to pick up upstream updates, and it
-needs the directory to exist **empty** — a missing directory fails the
-container with `Error: statfs /home/dank/models/halogen: no such file or
-directory` and the unit loops on `Restart=on-failure` until `mkdir -p` brings
-it back. The sidecars are versioned in place, so a stale copy is invisible from
-the file name (both overlays were ~95 MB larger upstream than the copies this
-host had been serving).
+The spec method is DFlash2 (block-diffusion drafter) at depth 4. The
+drafter is loaded via `--model-draft`; the chain is `--spec-type
+draft-dflash` with `--spec-draft-device ROCm0`. KV is **q8_0** (the
+unsloth b11030 build does not support fp8 KV; q8_0 is the
+highest-precision 8-bit option, ~8 GiB at 262k). The serve script
+(`scripts/serve-frank-large.sh`) validates binary → main GGUF → drafter
+and exits with a pointer message if any is missing, then `exec`s
+`llama-server` with `--jinja --alias frank-large --chat-template-kwargs
+'{"preserve_thinking":true}' --chat-template-file $TEMPLATE_FILE` (the
+Qwen-Sharp v22.4.0 template; without `--chat-template-file` the binary
+falls back to the built-in `peg-native` template, which produces a
+~73,600-token prompt for a ~250-token request).
 
-Measured boot ledger (2026-09-16, `HALOGEN_VERBOSE=1` ships in the unit):
-device budget `121 − 67.7 − 20 = 33.5 GiB` against a need of `~27.2 GiB`, so
-the configured pool was **not clamped**; 68.0 GiB of weights locked + 11.0 GiB
-of KV pool + 16.5 GiB of working memory = 95.4 GiB in all, leaving 14.7 GiB
-(475 contiguous 2 MiB blocks) for everything else: frank-small on the 3090 and
-~28 co-tenant containers. The engine printed its co-tenant stall NOTE and
-logged 4,350 compaction stalls (285 failed) while reserving the pool, so read
-that as "tight and fragmented", not "out of memory".
+The iGPU addresses **114 GiB** (the GTT aperture over the shared LPDDR,
+`gtt_total` in `/sys/class/drm/card1/device/`; `rocm-smi`'s 2 GiB "dedicated"
+is not the budget). The 27B dense model (31.5 GiB) is mmap'd in with
+`--n-gpu-layers 999`; budget at 262k ≈ 41-43 GiB (weights + KV + buffers),
+leaving ~71 GiB of aperture headroom. The 8 GiB prompt-cache budget
+(`CACHE_RAM=8192`) is the qualified config.
 
-Runbook: `serverAppConfigs-docs/LLM/halogen-flash-server.md`.
-Rollback: [[frank-large-ik-uncensored]].
+Fetch: `scripts/download-frank-large.sh` (per-file, each file verified
+against its declared byte count + sha256; `--verify-only` re-checks).
+
+Runbook: `serverAppConfigs-docs/LLM/frank-large-unsloth-qwen38-27b-q8xl.md`.
+Rollback: [[frank-large-kairic-edge-qwen38-27b]] (payload and runtime
+intact on disk).
 
 ### frank-small — llama.cpp on the RTX 3090 (Dankclaw, ACTIVE)
 
-Mainline llama.cpp master `37b53fd` as a **root systemd unit** (repo
+Mainline llama.cpp master `37b53fd` (CUDA build with
+`-DGGML_CUDA_FA_ALL_QUANTS=ON`) as a **root systemd unit** (repo
 `scripts/frank-small.service`, `relink_unit`ed into `/etc/systemd/system/`),
-serving `ISTA-DASLab/Qwen3.8-27B-GSQ-RCO-GGUF` at IQ3_S — the `-mtp` build, so
-the model's own Multi-Token Prediction head drives speculative decoding — with
-the BF16 mmproj, on port 7771, 131,072 ctx / 1 slot, f16 KV, greedy default.
-Deployed flags are in `scripts/frank-small.env`; the serve script refuses to
-start if the weights, the projector or the binary are missing.
+serving `HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced` at Q4_K_M.
+The MTP head is a SEPARATE assistant file (`mtp-gemma-4-12B-it.gguf`, 4
+nextn layers) loaded via `--model-draft`; the draftless **ngram-mod**
+matcher chains behind it in the same `--spec-type` value. BF16 mmproj,
+port 7771, q8_0 KV, `CTX_SIZE=1048576` / `PARALLEL=4`
+(four FULL 262,144-token slots — the measured card ceiling), batch
+**8192/1024**, greedy default. Deployed flags are in
+`scripts/frank-small.env`; the serve script refuses to start if the
+weights, the projector, the sidecar or the binary are missing.
 
-Verified at deploy (2026-09-16): `/v1/models` reports `frank-small`; a chat
-completion returns content plus `reasoning_content`; a tool call returns
-`tool_calls`; the slot timing lines show `draft acceptance = 0.66–0.94, mean
-len ≈ 3` (MTP engaged); an image request is answered from the projector while
-the halogen side refuses images with a named reason; 22,362 MiB of the card's
-24,576 MiB is in use; `n_slots = 1, n_ctx_slot = 131072`.
+Verified at deploy (2026-09-17): `/v1/models` reports `frank-small`; a
+chat completion returns content plus `reasoning_content`; a tool call
+returns `tool_calls`; an image request is answered from the projector;
+an `input_audio` WAV transcribes verbatim. Post-tuning live numbers at
+max length: pp@254k ~965 t/s, tg@253k 226–302 t/s with ~94% draft
+acceptance; idle 23,300 MiB of 24,576. The throughput sweep (and why
+ubatch 2048 OOMs the draft's pp buffer, and why draft depth 4 + poll
+100 is WORSE at long ctx) is tabled in the runbook.
+Runbook: `serverAppConfigs-docs/LLM/frank-small-gemma4-12b.md`.
+Rollback: [[frank-small-qwen38-gsq-rco]].
 
-### frank-medium — llama.cpp layer split, DFlash2 + ngram-mod (Dankserver, ACTIVE)
+### frank-primary — R9V radiance-vLLM Qwen3.8-Flash-Next Q8_0 (Dankserver, ACTIVE)
 
-Mainline llama.cpp at **`fb27a525`** (a gfx1201 HIP build, `Root=`-less root
-systemd unit `scripts/frank-medium.service`) serving
-`ajgazin/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF` at **UD-Q8_K_XL**
-(29.29 GiB) with the **z-lab DFlash2** `Q8_0` drafter chained to the
-draftless **ngram-mod** matcher, in **one process across both R9700s**,
-`--split-mode layer` at a **35:30 tensor split** (the balance point for the
-deployed batch: the drafter rides ROCm1, so it takes fewer target layers),
-262144 ctx over **2 slots** of 131072, batch 6144x512, text only.  DSpark was
-put up in the drafter's place the same day and reverted: it declares no sliding
-window, so its draft KV spanned the whole context (5.0 GiB) and cost ROCm1 four
-layers of the split.
+The **R9V radiance-vLLM fork** (`drwolfen/radiance-vllm-qwen4exp`, docker-pinned
+prebuilt image bundle `r9v-qwen38-flash-next-wmma@sha256:2dac17a2…`) serving
+the **unsloth Qwen3.8-Flash-Next-GGUF Q8_0** (175.30 GiB, 6 GGUF shards)
+with the blockfp8 MTP4 head (depth 4) and the mmproj on **both** Radeon AI
+PRO R9700s (gfx1201, BDFs `0000:03:00.0` / `0000:07:00.0`), one stream at
+**131,072 ctx**, **TP=2 tiered experts** (80-slot LRU expert cache; PLE
+n-gram table PINNED in host RAM, 54.4 GB), the **Qwen-Sharp v22.4.0
+template** (via the launcher's `R9V_CHAT_TEMPLATE_FILE` passthrough, fork
+`30d4a32`), tool parser `qwen3_coder`, reasoning channel `reasoning`. Cut
+over 2026-09-27 from the uncensored IQ4_XS payload (itself cut over from
+llama.cpp b11030 the same day) at Frank's direction.
 
-**Layer split is why both cards now serve ONE model.** Tensor parallelism is
-impossible (see the PCIe lesson below), and so is vLLM's pipeline parallelism —
-its stage handoff is an RCCL `send`/`recv` of the hidden state, the exact
-primitive that cannot be dispatched on card #2. llama.cpp's layer split needs
-no collective at all: layers are distributed in order and the boundary
-activation is a per-backend copy, once per forward pass. Measured on this host
-(the predecessor runtime): 1991 t/s prefill layer-split vs 272 tensor.
+**The tuned shape lives on-host, not in the repo.** The q8 profile's setup
+run qualified the `R9V_*` config into
+`/home/dank/r9v-state/q8xl/setup.json` (`ready: true`); the repo env
+file `scripts/frank-primary.env` carries ONLY production overrides
+(`R9V_HOST_BIND=0.0.0.0`, `R9V_HOST_PORT=7770`,
+`R9V_SERVED_MODEL_NAME=frank-primary`, `R9V_CONTAINER_NAME=frank-primary-r9v`,
+`R9V_EXPECTED_GPU_BDFS`) plus two q8-only keys: the dev-overlay adapter
+(`R9V_DEV_QWEN4_EXP_ADAPTER_PY`, fork commit `363d606` — the Q8_0 payload
+quantizes BOTH fused hyper-connection shards, so the shard-uniformity
+check needs the in-stream dequant) and `R9V_FULL_MUTABLE_CACHE=0` (the
+overlay's env.always injects the uncensored 160-slot cache geometry, which
+the q8 80-slot tiered cache rejects). Never copy tuned values from the
+state into the repo — it would drift from the qualification.
 
-This is the box's **only** LLM runtime: the vllm-radiance replica pair and its
-routing proxy (`frank-medium-a/-b/-proxy`) were retired the same day they went
-live, with their units moved to `~/.AGENTTRASH/20260916-vllm-radiance-retire/`.
+**Spec decoding is MTP4 only.** The fork's `speculative_config` is a
+single dict — one method per engine, NO chaining — so the llama.cpp
+`draft-mtp,ngram-mod` pattern is NOT expressible here. MTP4 is wired
+(`R9V_MTP_SPEC_TOKENS=4`, draft TP=2); the PLE n-gram rides along
+architecturally (`ngram_embedding`); `ngram_gpu` exists as an alternative
+single method, not a chainable one.
 
-Files: `scripts/build-llama-rdna4.sh` (builds the runtime, gfx1201 only, private
-ROCm 7.14 toolchain bundled beside the binary), `scripts/download-frank-medium-gguf.sh`
-(resumable, byte-verified payload), `scripts/frank-medium.env`,
-`scripts/serve-frank-medium.sh`, `scripts/frank-medium.service`. The deploy
-handler refuses to start a unit whose runtime or payload is missing, retires
-the vLLM quadlets, waits for 7770 to be released (the retired proxy held it) and
-gates on `/health`.
+**Serving = the fork's own launcher through a docker→podman shim.** The R9V
+tooling is docker-pinned; the shim at
+`/home/dank/GitPackages/radiance-vllm-qwen4exp/.podman-shim/docker` carries
+three laws: (1) the bundle is a containerd/OCI docker-save, so docker keys
+the image by its OCI manifest digest while podman keys by config digest but
+preserves the manifest digest in `RepoDigests` — the shim answers
+`image inspect sha256:X` from RepoDigests and rewrites bare `sha256:X` run
+refs to `repo@sha256:X`; (2) podman inspect answers
+`HostConfig.LogConfig.Config: null` where docker returns the log-opts map
+(the fork's doctor crashes on it) — the shim records `run --log-opt` pairs
+and normalizes inspect output; (3) podman lacks docker's `SecurityOptions`
+/`ServerVersion` info fields — the shim answers them.
 
-The ref is pinned by two features and must not float: **DFlash2**
-(ggml-org/llama.cpp#27342) and **qwen35 MTP**. The ROCmFPX fork the endpoint
-used earlier that day has neither.
+**Unit and self-healing.** Root systemd unit (`scripts/frank-primary.service`,
+`User=dank`, `LimitMEMLOCK=infinity`) — the PLE pinned residency alone is
+54.4 GB, and a root unit grants the pin budget via PID1 (a rootless
+quadlet would be capped by the user manager's limit).
+The serve script (`scripts/serve-frank-primary.sh`) gates the setup state
+(ready + paths), the pinned image (RepoDigests), the PLE byte count
+(`stat -c %s`), every GGUF shard + the mmproj and the GPU device nodes,
+clears a stale container, then execs the fork's `scripts/launch.sh` through
+the shim and **blocks on `docker wait`** — the launcher `--detach`es, so
+without the wait a crashed engine is a green unit; `docker wait` cannot stop
+the container child, hence `ExecStop=podman stop -t 120
+frank-primary-r9v`. The deployer's `deploy_llm_primary` gates state/image/
+PLE/shards, `podman rm -f`s the container, waits out :7770, relinks/enables/
+restarts the unit and health-gates with the MainPID check (the false-green
+stray law).
 
-Runbook: `serverAppConfigs-docs/LLM/frank-medium-llamacpp-dflash2.md`.
-Retired runtimes: [[frank-medium-radiance-mxfp4]] (vLLM replicas, same day),
-[[frank-medium-rocmfpx]] (llama.cpp fork, earlier that day).
+Verified at cutover (2026-09-27): q8 setup state `ready: true`, all 20
+payload artifacts sha256-verified (175.30 GiB); the scratch-port bring-up
+battery answered vision ("Red" for a 64×64 red PNG), MTP4 mean acceptance
+length 3.19–5.00, and the PLE pinned proof (`mapping_bytes =
+mapping_rss_bytes = 54,400,261,120`, fully RSS-resident); wire + tool
+round-trip + template probe re-verified on :7770 after the deploy. No
+throughput bench was run (Frank declined); the probe-era 11 tok/s decode
+was residency-bound (halved expert headroom at double the bytes/expert),
+not the production number.
+
+Runbook: `serverAppConfigs-docs/LLM/frank-primary-r9v-radiance-qwen38-q8.md`.
+Rollback: the uncensored payload — flip `R9V_STATE_FILE` back to
+`/home/dank/r9v-state/uncensored/setup.json`, drop the two q8-only keys
+and the template keys, redeploy (state + `restore-config-20260927.env` +
+payload intact on disk) — see
+[[frank-primary-r9v-radiance-qwen38-uncensored]].
 
 ## Key Lessons Learned
 Durable operational lessons from the fleet's history. Full detail in the
@@ -376,29 +446,40 @@ linked runbooks.
   and the rest behind the chipset (usually not) — that asymmetry is what
   blocked frank-medium's TP=2. A one-card collective proves nothing: NCCL
   short-circuits at `world_size=1`.
-- **The fix is physical — and cheap on this board.** Two paths put both cards
-  on CPU root ports, which restores the atomics routing and therefore TP=2: an
-  M.2→PCIe x4 riser into a *CPU-attached* M.2 slot (on dankserver's TUF
-  GAMING B650-E WIFI that is M.2_2, which is free — per ASUS's spec page;
-  `PCIEX16_2`, where card #2 sits today, is chipset and x1-mode), or a board
-  whose CPU x16 bifurcates to x8/x8. Bandwidth is not the constraint: a 27B
-  TP=2 allreduce at batch 4 is ≈10 MB per token-step, ≈1.4 ms at Gen4 x4.
-  RCCL's P2P `send`/`recv` fails on such a card too, so pipeline parallelism is
-  not an escape either. Full evidence matrix, the open rebuild hypothesis, and
-  the test plan: [[Dual-R9700-Cooperation]].
+- **That wall was physical, and it was fixed on 2026-09-20 by a board swap.**
+  Both paths that put two cards on CPU root ports were: an M.2→PCIe x4 riser
+  into a *CPU-attached* M.2 slot, or a board whose CPU lanes bifurcate to
+  x8/x8. dankserver took the second: **ASUS ProArt B850-Creator WiFi NEO**,
+  `PCIEX16_1` + `PCIEX16_2` at x8/x8 Gen5 on root ports `00:01.1` / `00:01.3`,
+  every bridge now `Routing+` and **both endpoints `ReqEn+`** — the exact
+  precondition the old test plan named. Bandwidth was never the constraint (a
+  27B TP=2 allreduce at batch 4 is ≈10 MB per token-step, ≈1.4 ms at Gen4 x4
+  and under 0.4 ms at Gen5 x8).
+  **Proven on the same day.** vLLM's R4D one-shot allreduce runs TP=2 here and
+  frank-medium serves on it; llama.cpp's RCCL path was built too
+  (`GGML_HIP_RCCL=ON`) and its tensor mode measured — real collective, slower
+  shape. Note the collective choice matters: TheRock's RCCL builds lack gfx1201
+  device code (`invalid device function`), which is why R4D is the path vLLM
+  uses at all. Evidence matrix and the measured three-arm verdict:
+  [[Dual-R9700-Cooperation]].
 - **When a GPU collective dies, read the runtime, not the framework.** The
   message that identified the cause came from `AMD_LOG_LEVEL=3`
   (`Pcie atomics not enabled, hostcall not supported` → `AQL dispatch
   failed!`), not from vLLM or RCCL. `AMD_LOG_LEVEL` costs one env var and
   prints the failing HIP call with its return code.
-- **The one software path that lets both cards serve ONE model: llama.cpp's
-  layer split.** vLLM cannot do it here in any of its parallelisms — TP needs
-  an allreduce, PP needs the same p2p primitive, and both die on the card that
-  cannot dispatch an RCCL kernel. `--split-mode layer` in llama.cpp needs no
+- **The software path that puts both cards on ONE model without a collective:
+  llama.cpp's layer split.** On the old board vLLM could not do it in any of its
+  parallelisms — TP needs an allreduce, PP needs the same p2p primitive, and both
+  died on the card that could not dispatch an RCCL kernel. `--split-mode
+  layer` in llama.cpp needs no
   collective: layers are distributed in order and only the boundary activation
   crosses PCIe, once per forward pass. Measured here: 1991 t/s prefill /
   18.8 tok/s decode layer-split, against 272 / 26.3 tensor (butterfly
-  fallback). That is what `frank-medium` runs — see
+  fallback).
+  This was what `frank-medium` ran until 2026-09-20, when the board swap made
+  collectives legal and radiance TP=2 beat it on every axis (95.8 vs 45.7 t/s
+  decode, 0.21 vs 0.72 s TTFT, 259 vs 72 t/s burst-4) — see
+  [[frank-medium-radiance-mxfp4]]; the llama shape is the rollback target
   [[frank-medium-llamacpp-dflash2]].
 - **Layer split is also the cross-vendor answer — and `-ot` is what cannot be
   combined with it.** On Dankclaw (2026-09-16) a CUDA 3090 + Vulkan iGPU layer
@@ -437,9 +518,10 @@ linked runbooks.
 
 **ROCm / GPU**
 
-- **Layer split is the deployed shape on both multi-device llama.cpp services,
-  for two different reasons.** On Dankserver it is the *only* way both R9700s
-  serve one model (no collective can be dispatched on card #2). On a
+- **Layer split was the deployed shape on both multi-device llama.cpp services,
+  for two different reasons.** On Dankserver it was the *only* way both R9700s
+  served one model (no collective could be dispatched on card #2) until the
+  2026-09-20 board swap; frank-medium now runs radiance TP=2 instead. On a
   RCCL-less fork build it is also the fast one: tensor parallel falls back to
   a butterfly allreduce and collapses prefill ~7x (measured 271.8 vs 1991 t/s).
   Pin the spec-decode drafter to one device — an unpinned draft under tensor
@@ -472,9 +554,13 @@ linked runbooks.
 - **QSA flash-attn assert:** `GGML_ASSERT(a-type == GGML_TYPE_F32)` on
   qwen4exp needs `scripts/patches/qwen4exp-qsa-f32-mask.patch` — but only on
   the agentionai FAST layer set; the kingjones STRIX set works unpatched.
-- **GPU budget on Dankclaw is the rocm-smi figure** (64 GiB, SVM-backed).
-  `free`/`dmidecode` show the CPU-side carve-out — intentional, do not
-  change.
+- **GPU budget on Dankclaw is the GTT aperture (~114 GiB), not the
+  rocm-smi "dedicated" figure.** The Radeon 8060S (gfx1151) reports
+  116,732 MiB (`llama-server --list-devices`;
+  `gtt_total=122402963456` in `/sys/class/drm/card1/device/`). The older
+  "64 GiB, SVM-backed" lesson was already stale — the CIRU Orca predecessor
+  held 92.6 GiB of weights on the iGPU. `free`/`dmidecode` show the
+  CPU-side carve-out — intentional, do not change.
 
 **Load / crash diagnosis**
 
@@ -593,7 +679,9 @@ linked runbooks.
   returns `tool_calls`. Check tool support before routing a role at an endpoint.
 - **Quantized KV on CUDA needs `GGML_CUDA_FA_ALL_QUANTS=ON`** — the same
   option and the same ~12x prefill collapse described in the ROCm note above.
-  f16 KV needs nothing, which is why frank-small runs f16.
+  f16 KV needs nothing; frank-small ran f16 for that reason until
+  2026-09-17, when `build-cuda` was rebuilt with the option ON so the
+  endpoint could take q8_0 KV.
 - **llama-bench separates a LIST with `/` and SWEEP values with `,`.** Both
   `-dev` and `-ts` follow this: `-dev CUDA0,Vulkan1` is two *single-device*
   configurations, never one two-device run, and `-ts 0.85,0.15` is two sweep
@@ -683,9 +771,9 @@ Active:
 
 | Service | Runbook |
 |---------|---------|
-| frank-large (halogen-flash-server, Dankclaw) | `serverAppConfigs-docs/LLM/halogen-flash-server.md` |
-| frank-small (llama.cpp Qwen3.8-27B GSQ-RCO, Dankclaw) | `serverAppConfigs-docs/LLM/frank-small-qwen38-gsq-rco.md` |
-| frank-medium (llama.cpp + DFlash2, Dankserver) | `serverAppConfigs-docs/LLM/frank-medium-llamacpp-dflash2.md` |
+| frank-large (stock llama.cpp Qwen3.8-27B UD-Q8_K_XL, Dankclaw) | `serverAppConfigs-docs/LLM/frank-large-unsloth-qwen38-27b-q8xl.md` |
+| frank-small (llama.cpp Gemma4-12B QAT, Dankclaw) | `serverAppConfigs-docs/LLM/frank-small-gemma4-12b.md` |
+| frank-primary (R9V radiance-vLLM Qwen3.8-Flash-Next Q8_0, Dankserver) | `serverAppConfigs-docs/LLM/frank-primary-r9v-radiance-qwen38-q8.md` |
 | Dankclaw kernel posture (`amd_iommu=off`) | `serverAppConfigs-docs/LLM/dankclaw-iommu-translation-off.md` |
 | Deployment flow + incidents | `serverAppConfigs-docs/LLM/deployment.md` |
 
@@ -693,8 +781,18 @@ Retired (rollback targets and history):
 
 | Runtime | Host | Window | Runbook |
 |---------|------|--------|---------|
-| kingjones STRIX Qwen3.8-Flash-Next ROCmFP4 | Dankclaw | 2026-08-30 → 09-11 | `kingjones-strix-rocmfp4.md` |
+| R9V radiance-vLLM Qwen3.8-Flash-Next-Uncensored IQ4_XS (`frank-primary`) | Dankserver | 2026-09-27 (same-day swap to Q8_0) | `frank-primary-r9v-radiance-qwen38-uncensored.md` |
+| llama.cpp b11030 Qwen3.8-Flash-Next Q8_0 + shared MTP (`frank-primary`) | Dankserver | 2026-09-26 → 09-27 | `frank-primary-llamacpp-qwen38-flash-next-q8.md` |
 | ik_llama.cpp Qwen3.8-Flash-Next-Uncensored i1-Q4_K_M (`frank-large`) | Dankclaw | 2026-09-15 → 09-16 | `frank-large-ik-uncensored.md` |
+| vllm-radiance TP=2 MXFP4 + DFlash2 (`frank-medium`) | Dankserver | 2026-09-20 → 09-26 | `frank-medium-radiance-mxfp4.md` |
+| Lucebox DS4.1 DeepSeek-V4.1-Flash ROCmFP23 (`frank-primary`) | Dankserver | 2026-09-26 (same-day swap) | `frank-primary-lucebox-ds4.md` |
+| kingjones STRIX Qwen3.8-Flash-Next ROCmFP4 | Dankclaw | 2026-08-30 → 09-11 | `kingjones-strix-rocmfp4.md` |
+| halogen-flash-server Qwen3.8-Flash-Next w4b (`frank-large`) | Dankclaw | 2026-09-16 → 09-19 | `halogen-flash-server.md` |
+| CIRU v4.4.1 Orca Qwen3.8-Flash (`frank-large`) | Dankclaw | 2026-09-19 → 09-21 | `frank-large-ciru-orca.md` |
+| unsloth llama.cpp b11030 Qwen3.8-Flash-Next UD-IQ4_XS (`frank-large`) | Dankclaw | 2026-09-21 (same-day swap) | `frank-large-unsloth-qwen38-flash-next.md` |
+| Kairic Edge Qwen3.8-27B IU4 W4A4 (`frank-large`) | Dankclaw | 2026-09-21 (same-day swap) | `frank-large-kairic-edge-qwen38-27b.md` |
+| ISTA-DASLab Qwen3.8-27B-GSQ-RCO IQ3_S (`frank-small`) | Dankclaw | 2026-09-16 → 09-17 | `frank-small-qwen38-gsq-rco.md` |
+| vLLM Gemma4-12B w4a16 (`frank-small`) | Dankclaw | 2026-09-19 (same-day revert) | `frank-small-vllm-gemma4.md` |
 | agentionai ROCmFP4-FAST imatrix | Dankclaw | 2026-08-29 → 08-30 | `agentionai-fast-imatrix.md` |
 | eemin Qwen3.8-27B ROCmI4 W4A4 MTP | Dankclaw | 2026-08-18 → 08-25 | `eemin-rocmi4-mtp.md` |
 | Kairic Edge IU4 | Dankclaw | 2026-08-22 (same-day revert) | `kairic-edge.md` |
@@ -704,6 +802,7 @@ Retired (rollback targets and history):
 | FreeToken (official + Huihui FP8, `frank-small`) | Dankserver | 2026-09-02 → 09-15 | `freetoken-frank-small.md` |
 | FastMTP patched llama.cpp | Dankserver | retired 2026-08-18 | `qwen3.8-spec-matrix.md` |
 | ik_llama.cpp Ornith CRACK | Dankserver | retired 2026-09-02 | `ikllama-ornith-dankserver.md` |
+| llama.cpp layer split + DFlash2 (`frank-medium`) | Dankserver | 2026-09-16 → 09-20 | `frank-medium-llamacpp-dflash2.md` |
 
 Retired runbooks are under `serverAppConfigs-docs/LLM/`. Retired scripts live
 in `old/` and `.AGENTTRASH/`.

dankclaw/.env.example

@@ -4,6 +4,11 @@
 # SearXNG
 SEARXNG_SECRET=changeme
 SEARXNG_BASE_URL=http://search.franksdank.cloud/
+# Kagi search API key (https://help.kagi.com/kagi/api/). Powers the paid
+# `kagi` engine in shared/searxng/settings.yml; deploy-remote.sh bakes it into
+# the live settings.yml via scripts/searxng-render-settings.py. The quadlet
+# does NOT pass it into the container environment.
+KAGI_API_KEY=changeme
 
 # Gluetun VPN (see https://github.com/qdm12/gluetun-wiki)
 # Single-peer WireGuard model. Fill from your provider's WireGuard config.

dankclaw/Caddyfile

@@ -309,6 +309,10 @@ http://:8017 {
 	@home host www.franksdank.cloud
 	handle @home {
 		root * /srv/homepage
+		# Deploys overwrite /srv/homepage in place; without revalidation a
+		# browser keeps serving the pre-deploy CSS/JS/HTML. no-cache forces an
+		# ETag round-trip on every load (a cheap 304 when unchanged).
+		header Cache-Control "no-cache"
 		# RBAC (2026-09-01): /admin requires membership in the homepage-admins
 		# authentik group. In proxy-provider mode the outpost injects
 		# X-Authentik-Groups on its upstream request to this listener and strips
@@ -323,6 +327,16 @@ http://:8017 {
 			}
 			respond "Forbidden: homepage admins only" 403
 		}
+		# User docs page (static). Anchors (#models etc.) are client-side,
+		# so both /docs and /docs/ map onto the single docs.html.
+		handle /docs {
+			try_files /docs.html
+			file_server
+		}
+		handle /docs/ {
+			try_files /docs.html
+			file_server
+		}
 		@data path /services.json /status.json /app.js /style.css /deployed.js
 		handle @data {
 			file_server

dankclaw/Containerfile.comfyui

@@ -21,4 +21,20 @@ RUN mkdir -p /opt/ComfyUI/models /opt/ComfyUI/input /opt/ComfyUI/output /opt/Com
 RUN grep -viE '^(torch|torchvision|torchaudio)([^a-z]|$)' requirements.txt > /tmp/req-notorch.txt \
     && pip install --no-cache-dir -r /tmp/req-notorch.txt
 
+# The city96/ComfyUI-GGUF custom node (loaded from the host's custom_nodes
+# volume) needs the gguf library to decode GGUF-quantized diffusion models.
+# sentencepiece and protobuf are its optional tokenizer deps. Baking them into
+# the image keeps the dependency across container recreations — the node itself
+# lives in the host volume, which persists, but the Python env does not.
+RUN pip install --no-cache-dir "gguf>=0.13.0" sentencepiece protobuf
+
+# Bake the qwen_image21 patch script into the image. It is run by the
+# startup wrapper before ComfyUI starts, so the patch survives container
+COPY dankclaw/apply_qwen21_patch.py /opt/ComfyUI/apply_qwen21_patch.py
+COPY dankclaw/comfyui-start.sh /opt/ComfyUI/comfyui-start.sh
+RUN chmod +x /opt/ComfyUI/comfyui-start.sh
+
+CMD ["/opt/ComfyUI/comfyui-start.sh"]
 EXPOSE 8188
+# v2: VAE 4D-to-5D latent expansion for video VAEs (qwen_image21)
+# v3: fix in_channels to use shape[0] (latent input dim) not shape[1] (hidden dim)

dankclaw/apply_qwen21_patch.py

@@ -0,0 +1,52 @@
+import os
+
+# Apply qwen_image21 detection patch
+f = "/opt/ComfyUI/comfy/model_detection.py"
+with open(f) as fh:
+    code = fh.read()
+if "qwen_image21" not in code:
+    qwen21_check = (
+        "    if '{}txt_in.text_norm.weight'.format(key_prefix) in state_dict_keys:  # Qwen Image 2.1\n"
+        "        dit_config = {}\n"
+        '        dit_config["image_model"] = "qwen_image21"\n'
+        "        dit_config[\"in_channels\"] = state_dict['{}img_in.weight'.format(key_prefix)].shape[0]\n"
+        "        dit_config[\"num_layers\"] = count_blocks(state_dict_keys, '{}transformer_blocks.'.format(key_prefix) + '{}.')\n"
+        "        return dit_config\n"
+    )
+    anchor = "    if '{}txt_norm.weight'.format(key_prefix) in state_dict_keys:  # Qwen Image"
+    code = code.replace(anchor, qwen21_check + "\n" + anchor)
+    with open(f, "w") as fh:
+        fh.write(code)
+    print("Applied qwen_image21 detection patch")
+
+# Add qwen_image21 to GGUF node arch list
+loader = "/opt/ComfyUI/custom_nodes/ComfyUI-GGUF/loader.py"
+if os.path.exists(loader):
+    with open(loader) as fh:
+        lcode = fh.read()
+    if '"qwen_image21"' not in lcode:
+        old = '"lumina2", "qwen_image"}'
+        new = '"lumina2", "qwen_image", "qwen_image21"}'
+        if old in lcode:
+            lcode = lcode.replace(old, new)
+            with open(loader, "w") as fh:
+                fh.write(lcode)
+            print("Applied qwen_image21 arch list patch")
+
+# Patch VAE decode to expand 4D latents to 5D for video VAEs (latent_dim=3)
+sd = "/opt/ComfyUI/comfy/sd.py"
+with open(sd) as fh:
+    sdc = fh.read()
+if "self.latent_dim == 3 and samples_in.ndim == 4" not in sdc:
+    anchor = "        if self.latent_dim == 2 and samples_in.ndim == 5:\n            samples_in = samples_in[:, :, 0]"
+    replacement = (
+        "        if self.latent_dim == 2 and samples_in.ndim == 5:\n"
+        "            samples_in = samples_in[:, :, 0]\n"
+        "        elif self.latent_dim == 3 and samples_in.ndim == 4:\n"
+        "            samples_in = samples_in.unsqueeze(2)"
+    )
+    if anchor in sdc:
+        sdc = sdc.replace(anchor, replacement)
+        with open(sd, "w") as fh:
+            fh.write(sdc)
+        print("Applied VAE 4D-to-5D latent expansion patch")

dankclaw/authentik/quadlet/authentik-outpost-ldap.container

@@ -20,10 +20,10 @@ Wants=authentik-server.service
 [Container]
 ContainerName=authentik-outpost-ldap
 Network=dankclaw_default
-# Image=ghcr.io/goauthentik/ldap:2026.8.0 (amd64 digest; podman 5.7.0 refuses
+# Image=ghcr.io/goauthentik/ldap:2026.8.3 (amd64 digest; podman 5.7.0 refuses
 # the tag's nested manifest list, so pin the single-platform digest).
 EnvironmentFile=/home/dank/serverAppConfigs/dankclaw/.env
-Image=ghcr.io/goauthentik/ldap@sha256:fa33bc8f522113830e1662f4c034352f9eb08e0a7d3da2ddadad9a4b33b4cbf4
+Image=ghcr.io/goauthentik/ldap@sha256:2e7b259eb8c37faac916946ddf48ec681ee9d3a9f724fe8521bf161973f13cf9
 Environment=AUTHENTIK_HOST=https://auth.franksdank.cloud
 Environment=AUTHENTIK_INSECURE=false
 Environment=AUTHENTIK_TOKEN=${AUTHENTIK_LDAP_OUTPOST_TOKEN}

dankclaw/authentik/quadlet/authentik-outpost.container

@@ -20,7 +20,7 @@ Wants=authentik-server.service
 
 [Container]
 ContainerName=authentik-outpost
-Image=ghcr.io/goauthentik/server:2026.8.0
+Image=ghcr.io/goauthentik/server:2026.8.3
 Exec=worker
 Network=dankclaw_default
 EnvironmentFile=/home/dank/serverAppConfigs/dankclaw/.env

dankclaw/authentik/quadlet/authentik-server.container

@@ -19,7 +19,7 @@ Wants=authentik-postgres.service
 
 [Container]
 ContainerName=authentik-server
-Image=ghcr.io/goauthentik/server:2026.8.0
+Image=ghcr.io/goauthentik/server:2026.8.3
 Exec=server
 Network=dankclaw_default
 EnvironmentFile=/home/dank/serverAppConfigs/dankclaw/.env

dankclaw/authentik/quadlet/authentik-worker.container

@@ -16,7 +16,7 @@ Wants=authentik-server.service
 
 [Container]
 ContainerName=authentik-worker
-Image=ghcr.io/goauthentik/server:2026.8.0
+Image=ghcr.io/goauthentik/server:2026.8.3
 Exec=worker
 Network=dankclaw_default
 EnvironmentFile=/home/dank/serverAppConfigs/dankclaw/.env

dankclaw/comfyui-start.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Apply qwen_image21 patches before starting ComfyUI
+python3 /opt/ComfyUI/apply_qwen21_patch.py 2>/dev/null
+exec python main.py --listen 0.0.0.0 --port 8188

dankclaw/comfyui/quadlet/comfyui.container

@@ -21,11 +21,13 @@
 # user-unit spawn — which carries no supplementary groups — can still open them.
 # Both halves are asserted by tests/comfyui_rocm.bats.
 #
-# EXPOSURE. Loopback only. ComfyUI has no authentication and executes arbitrary
-# node graphs, and it has no Caddy vhost, so the repository's rule applies:
-# an unguarded service is internal-only. The homepage status card probes
-# 127.0.0.1:8188, which this satisfies. To reach the UI from another machine,
-# guard it behind the auth chain and give it a vhost — do not widen the bind.
+# EXPOSURE. LAN-reachable, no auth. ComfyUI has no authentication and executes
+# arbitrary node graphs. It is internal-only (no public vhost, no guard chain);
+# it is reached on the LAN via the Pi-hole DNS record
+# (comfyui.franksdank.cloud -> 192.168.0.143, in dankclaw/pihole/addn-hosts),
+# which resolves to this host's IP — so the bind is widened from loopback to
+# 0.0.0.0:8188. The homepage admin card links to that URL and probes
+# 127.0.0.1:8188.
 #
 # DATA. Models, input, output and custom_nodes live under
 # /home/dank/comfyui-data (host state, not in the repo).
@@ -39,7 +41,7 @@ ContainerName=comfyui
 Image=localhost/comfyui-rocm:gfx1151
 Pull=never
 Network=dankclaw_default
-PublishPort=127.0.0.1:8188:8188
+PublishPort=0.0.0.0:8188:8188
 AddDevice=/dev/kfd
 AddDevice=/dev/dri
 GroupAdd=keep-groups
@@ -48,7 +50,7 @@ Volume=/home/dank/comfyui-data/input:/opt/ComfyUI/input
 Volume=/home/dank/comfyui-data/output:/opt/ComfyUI/output
 Volume=/home/dank/comfyui-data/custom_nodes:/opt/ComfyUI/custom_nodes
 Volume=/home/dank/serverAppConfigs/dankclaw/comfyui/comfyui-healthcheck.py:/usr/local/bin/comfyui-healthcheck.py:ro
-Exec=python main.py --listen 0.0.0.0 --port 8188
+Exec=/opt/ComfyUI/comfyui-start.sh
 # The probe lives in a file because the podman 5.x v1 generator splits
 # HealthCmd on spaces into an argv array; an inline `python3 -c "..."` becomes
 # a puzzle of quoting that fails silently.

dankclaw/frank-large/quadlet/frank-large.container

@@ -1,219 +0,0 @@
-# Quadlet unit: frank-large (rootless, boot-persistent).
-#
-# Install path on dankclaw: ~/.config/containers/systemd/frank-large.container
-# Unit name: frank-large.service (container name: frank-large)
-#
-# The large inference service. The halogen-flash-server runtime (since
-# 2026-09-11, restored 2026-09-16 after a two-day ik_llama.cpp hybrid
-# interlude) serving peonist-ai/halogen-qwen3.8-flash-next (Qwen3.8-Flash-Next,
-# w4b .hgn checkpoint + quality overlay sidecar). It replaced the llama.cpp /
-# kingjones30-ROCmFPX STRIX deployment because the engine is ~4x faster on
-# prefill (the dominant cost of any real prompt) on this exact SKU. The RTX
-# 3090 it briefly shared with frank-large is now frank-small's card.
-#
-# SHAPE. The image runs both halves in one container: the engine on container
-# loopback (:8730, UNAUTHENTICATED — never publish it) and the OpenAI
-# front-end on :8731, published here as host 7770 so the fleet's clients,
-# services.json probe and docs keep the port they have always used. Same for
-# HALOGEN_MODEL_ID=frank-large: it is the id at /v1/models, in /health and in
-# every response, so no client had to be renamed. Halogen never rejects a
-# request for naming a different model, it just serves it.
-#
-# DEVICES. gfx1151 through the amdgpu/KFD stack: /dev/kfd plus the DRM render
-# node. Both are 0666 on this host, so the rootless user namespace can open
-# them (id dank is also in render/video). seccomp=unconfined and --ipc=host are
-# the image's documented requirements; memlock must be unlimited.
-#
-# DO NOT name an environment variable TEMP, HOST or GPU_MAX_HEAP_SIZE: the HIP
-# runtime reads bare TEMP for its JIT cache path (2026-08-13 incident).
-#
-# MEMORY. Weights are pinned (HALOGEN_FLASH_PIN_TRUNK default 1) — that is the
-# configuration the published decode numbers were measured with, and `free`,
-# MemAvailable and every monitor built on them will overstate free memory by
-# the size of the model (~68 GiB) because the kernel counts the locked weights
-# as reclaimable page cache. Halogen prints the corrected figure at startup.
-# The pinned trunk means this container holds most of the host; a co-tenant
-# that then takes the remainder can stall both for minutes at full CPU with no
-# disk activity and no output. That is documented behaviour, not a crash, and
-# the escape hatch is HALOGEN_FLASH_PIN_TRUNK=0 (at several times the decode
-# cost). Sizing is chosen for a SHARED 121 GiB host, and HALOGEN_KV_POOL_FIT
-# stays on as the safety net: if the machine refuses the configured pool the
-# engine lowers it itself and prints what it settled on. Read that ledger on
-# every restart — it is the ground truth for sizing, not this comment.
-#
-# POOL RETUNED 2026-09-16: 400,384 positions -- exactly two 200,192-token
-# conversations -- beside a per-conversation ceiling of 200,192 and two slots.
-# It replaces the 401,408 the 2026-09-13 trim left behind, which held one full
-# native-262k conversation beside a ~139k one, or three at 131k.
-#
-# MEASURED AT 401,408 (2026-09-13 deploy ledger): 68.0 weights + 11.0 KV +
-# 21.0 working = 100.0 GiB held, 9.1 GiB / 1396 contiguous 2 MiB blocks left,
-# engine need printed ~31.5 against the modelled ~33.4, and NO stall-warning
-# NOTE. Fit-check budget here: 121.2 - 67.7 - 20 = 33.5. That boot is the
-# baseline the 09-16 retune is measured against: the vision tower (1.97 GiB)
-# and roughly 4.2 GiB of arena come back to the host, which is what pays for
-# the co-tenant below.
-#
-# CO-TENANT since 2026-09-16: this host also serves frank-small on the RTX
-# 3090 (llama.cpp, ~12.2 GiB of weights that load through the page cache and
-# then live in VRAM, plus a CUDA context). It is the first real co-tenant this
-# service has had, which is why the arena was halved and the reserve raised.
-#
-# BOOT NOTE: on the first request after a (re)start the engine can go silent
-# for ~45-60 s ("has not answered PING") while it first-touches the freshly
-# reserved pool; /health reads engine_unresponsive during it and recovers by
-# itself. The quadlet health check's HealthStartPeriod=300s covers it; do not
-# restart the unit over it.
-#
-# WEIGHTS. HALOGEN_DOWNLOAD fetches the whole weights repo on FIRST START ONLY
-# (the entrypoint checks whether the checkpoint is absent) into the bind mount
-# below, which must therefore be read-WRITE. huggingface_hub resumes partial
-# files natively, and the quadlet runs the container with --replace --rm, so a
-# restart mid-fetch continues rather than starting over. Roughly 127 GB: the
-# 115.55 GiB checkpoint, the 2.31 GiB quality overlay, the 0.84 GiB vision
-# tower and the tokenizer. The repo is public and ungated, so no token is
-# needed; later starts open no outbound connections at all.
-#
-# VISION. Deliberately NOT set since 2026-09-16. The tower is a 1.97 GiB
-# charge against the same device budget as the pool and the arena, and the
-# fleet's image path moved to frank-small (llama.cpp on the RTX 3090, loaded
-# with --mmproj mmproj-Qwen3.8-27B-BF16). This server refuses image content
-# parts, and models.yml declares frank-large text-only to match.
-#
-# CLIENT CONTRACT (see serverAppConfigs-docs/LLM/halogen-flash-server.md).
-# There are no server-side sampler defaults: a request that sends no
-# temperature decodes GREEDY. The per-request budget defaults to 8,192 tokens
-# and REASONING COUNTS AGAINST IT, so a budget that runs out mid-thought
-# returns finish_reason "length" with empty content and the partial reasoning
-# in reasoning_content. The cap is 65,536; above it a request is a 400, never a
-# silent truncation.
-#
-# IMAGE. The unit runs the localhost/-aliased tag: this host's podman quadlet
-# path cannot resolve registry-prefixed refs from local storage at create
-# time. deploy-remote.sh pulls the ghcr.io ref and re-tags it before the
-# restart. Pull=never keeps boots off the registry.
-[Unit]
-Description=frank-large — halogen-flash-server, Qwen3.8-Flash-Next (w4b) on gfx1151
-After=network-online.target
-
-[Container]
-ContainerName=frank-large
-Image=localhost/peonist-ai/halogen-flash-server:0.5.8
-# Published port stays 7770: Hermes, open-webui, the harness and the homepage
-# probe all point here. 8730 (the engine) is deliberately not published.
-PublishPort=7770:8731
-AddDevice=/dev/kfd
-AddDevice=/dev/dri
-# Read-write: the first start downloads into it. Contains only weights.
-Volume=/home/dank/models/halogen:/models
-# Fetch the weights on first start only (absent checkpoint gates it).
-Environment=HALOGEN_DOWNLOAD=peonist-ai/halogen-qwen3.8-flash-next
-# Fleet identity: the id at /v1/models, /health and every response body.
-Environment=HALOGEN_MODEL_ID=frank-large
-# Per-conversation ceiling: exactly half the pool, so two conversations of the
-# full window are always resident. 200,192 rather than a round 200,000 is
-# pool/2. The model's native window is 262,144; a conversation past this
-# ceiling is refused, never silently truncated. Clients declare 200192 (see
-# the frank-large contextWindow in models.yml).
-Environment=HALOGEN_CTX=200192
-# The KV pool: 400,384 positions = 2 x 200,192 (the 2026-09-16 retune, down
-# from 401,408). ~28 KiB per position including block scratch, so ~11.0 GiB
-# held -- the 401,408 ledger entry measured exactly 11.0. The two slots still
-# OVERSUBSCRIBE the pool for any real request, because admission reserves
-# prompt + max_tokens: two full-window conversations each holding an output
-# budget are pool-bound, and the second waits in arrival order for the first
-# to release its region. Read the `kv pool:` lines on every boot;
-# HALOGEN_KV_POOL_FIT lowers the pool itself if the budget refuses the
-# configured one, and a green health check does not mean the pool you asked
-# for is the pool you got.
-Environment=HALOGEN_KV_POOL_POSITIONS=400384
-# Concurrency cap: two, one per half of the pool. Each slot is 111.0 MiB of
-# O(1) state, so this hands ~111 MiB back against the three set on 2026-09-12
-# for the fleet size of the time.
-Environment=HALOGEN_KV_SLOTS=2
-# Sizing is budget arithmetic, all of it. ONE budget covers the KV pool, the
-# per-call prefill arena and the vision tower together:
-#
-#   budget = 121.2 host - 67.7 resident weights - reserve
-#   need   = KV (~28 KiB/position) + arena + vision
-#   arena  = 3.80 GiB + 8.40 GiB x (HALOGEN_MAX_TOK / 16384)
-#
-# The arena term is linear in max_tok, and it reproduces five live restarts
-# AND upstream's three published "on the device" figures to within 0.1 GiB —
-# note those published figures are pool+arena totals, not pool alone, which is
-# the misreading that first made a doubling look affordable here. Corners this
-# box offered at a reserve of 24, at the old 262,144-position pool:
-#
-#   16384 -> need 28.6 vs 29.5  FITS, 0.9 spare   (doubling, 8-9% prefill cost)
-#   32768 -> need 37.0 vs 29.5  POOL CLAMPED to 262144, deploy still green
-#   65536 -> need 46.5 vs 29.5  OOM, will not boot; unit still reads ACTIVE
-#
-# LOWERED 32768 -> 24576 on 2026-09-16 for the frank-small co-tenant on this
-# same host. The arena's variable term goes 8.40 x 2 -> 8.40 x 1.5, handing
-# ~4.2 GiB back to the host at roughly a 4-5 % prefill cost -- the same lever
-# at 16,384 costs 8-9 %. The vendor's own notes name 24,576 as the largest
-# arena that allocated with headroom to spare, so this stays inside the range
-# it has tested.
-#
-# The arena is a PER-CALL PREFILL CHUNK, not a prompt ceiling: the
-# 200,192-token conversation is prefilled in arena-sized pieces, so a smaller
-# arena means more pieces and a slower prefill, not a smaller conversation.
-#
-# THE POOL, ARENA AND RESERVE ARE A MATCHED SET, NOT independent tunables --
-# the fit check's printed ledger on each boot is the arbiter, not these
-# comments.
-Environment=HALOGEN_MAX_TOK=24576
-# RAM the fit check refuses to count on, watched over by the engine's own
-# n-gram lookup table (47.7 GiB, read through the page cache and never held)
-# and, since 2026-09-16, by frank-small on the same host.
-#
-# RAISED 15 -> 20 with the 2026-09-16 retune. This knob feeds the fit-check
-# budget and is NOT an allocation: raising it cannot hand memory back to the
-# host, because the actual footprint is weights + KV + arena + vision, none of
-# which it touches — it can only take the pool away. What it does is keep the
-# fit check honest at the smaller arena. With the arena at 24,576 and no
-# vision tower, the engine's printed need falls to roughly 25 GiB against a
-# budget of 121.2 - 67.7 - 20 = 33.5, leaving ~8 GiB of margin, so the pool is
-# not clamped.
-#
-# The 2026-09-13 profile for comparison: 103.5 GiB held and "7.1 GiB left for
-# everything else" (310 contiguous 2 MiB blocks) at the doubled 524,288 pool,
-# which is why the pool came down; at 401,408 the same ledger read 9.1 GiB /
-# 1396 blocks. The 09-16 retune gives back the vision tower (1.97) and ~4.2 of
-# arena on top of that for the co-tenant, so the expected figure at this boot
-# is ~15 GiB left. Read the ledger; do not trust this arithmetic.
-#
-# To free host memory, change the POOL or the ARENA, and the reserve then
-# becomes free to rise: HALOGEN_KV_POOL_POSITIONS=262144 hands back 3.6 GiB,
-# HALOGEN_MAX_TOK=16384 hands back another 4.2. Both are one-line edits the
-# fit check confirms on the next boot.
-Environment=HALOGEN_HOST_RESERVE_GIB=20
-# Verbose engine logging: the vendor's first-line evidence for load,
-# allocation and admission questions. Shipping it on means an incident report
-# already has the full startup account instead of needing a restart-into-debug.
-# HALOGEN_DMALLOC_LOG is deliberately NOT set — it logs every allocation
-# over 64 MB, which is steady-state noise here; raise it only for a live
-# OOM hunt.
-Environment=HALOGEN_VERBOSE=1
-# Required by the image: the engine maps the checkpoint and registers it with
-# the GPU in place, which needs host IPC and an unconfined seccomp profile.
-PodmanArgs=--ipc=host --security-opt seccomp=unconfined
-Ulimit=memlock=-1:-1
-# The image ships its own HEALTHCHECK; this pins it. /health asks the ENGINE
-# for a PONG before answering, so 200 means "ready to serve", not "process
-# alive". During the first-start download it stays unhealthy by design.
-HealthCmd=halogen-healthcheck api
-HealthInterval=30s
-HealthTimeout=10s
-HealthRetries=3
-HealthStartPeriod=300s
-Pull=never
-
-[Service]
-# The first start reads ~68 GiB off disk and pins it before serving.
-TimeoutStartSec=900
-Restart=on-failure
-RestartSec=10
-
-[Install]
-WantedBy=default.target

dankclaw/observability/quadlet/alertmanager.container

@@ -0,0 +1,54 @@
+# Quadlet unit: alertmanager (rootless, boot-persistent).
+#
+# Install path on dankclaw: ~/.config/containers/systemd/alertmanager.container
+# Unit name: alertmanager.service (container name: alertmanager)
+#
+# The delivery half of the LLM alert rules. Until 2026-09-17 the rules in
+# shared/prometheus/rules/llm-fleet.yml evaluated and reached nobody — a
+# firing alert was visible in Prometheus and on the Grafana dashboard and
+# nowhere else, and an undelivered alert looks identical to a quiet one.
+# This unit closes that gap: Prometheus pushes to alertmanager:9093 over the
+# dankclaw_default network, and the single receiver webhooks the host-side
+# signal-relay user unit, which hands the text to signal-cli under Frank's
+# existing Signal account.
+#
+# PUBLISHING. 127.0.0.1 only, like every other observability unit: the
+# unauthenticated Alertmanager API (lifecycle endpoints are always on in
+# this binary — there is no flag to gate them) has no business on a host
+# interface, and no off-host consumer needs it. Caddy gains no vhost for
+# it; the homepage timer probes loopback.
+#
+# CONFIG. /opt/alertmanager/config/alertmanager.yml is installed from
+# shared/prometheus/alertmanager.yml by deploy-remote.sh on every deploy, so
+# the repo copy is the source of truth. STATE lives in /opt/alertmanager/data.
+#
+# Rootless: container root maps to the invoking user (dank) in this user
+# namespace and dank owns /opt/alertmanager/data. The image's default user
+# (nobody) maps to a subuid that cannot write it — same User=0:0 as prometheus.
+
+[Unit]
+Description=Alertmanager alert delivery (Dankclaw)
+After=network-online.target
+Wants=network-online.target
+
+[Container]
+ContainerName=alertmanager
+Image=docker.io/prom/alertmanager:latest
+Network=dankclaw_default
+User=0:0
+Exec=--config.file=/etc/alertmanager/alertmanager.yml --storage.path=/alertmanager
+PublishPort=127.0.0.1:9093:9093
+Volume=/opt/alertmanager/config:/etc/alertmanager
+Volume=/opt/alertmanager/data:/alertmanager
+HealthCmd=wget --spider -q http://localhost:9093/-/healthy
+HealthInterval=30s
+HealthTimeout=10s
+HealthRetries=3
+HealthStartPeriod=30s
+
+[Service]
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=default.target

dankclaw/observability/quadlet/prometheus.container

@@ -27,10 +27,11 @@
 #
 # RULES. Five LLM alert rules and one recording rule load from
 # /etc/prometheus/rules/ (installed from shared/prometheus/rules/ by the
-# deployer). There is still **no Alertmanager**, so nothing is delivered: a
-# firing alert is visible in Prometheus and on the Grafana dashboard's ALERTS
-# panel and reaches nobody. Delivery is an operator decision, not an oversight;
-# the fragility is that an undelivered alert looks identical to a quiet one.
+# deployer). Delivery went live 2026-09-17: the alerting block in
+# prometheus.yml points at alertmanager:9093, which webhooks every firing
+# group to the host-side Signal relay (192.168.0.143:18093, reached from
+# the container as host.containers.internal), which sends through signal-cli account 318311.
+# The Grafana dashboard's ALERTS panel remains the second surface.
 #
 # The config volume is also why rules belong in git: editing them in the UI is
 # lost on the next deploy, since the deployer overwrites the whole directory.

dankclaw/open-webui/quadlet/open-webui.container

@@ -32,6 +32,52 @@ PublishPort=3005:8080
 Environment=OPENAI_API_BASE_URL=http://192.168.0.143:7770
 Environment=ANONYMIZED_TELEMETRY=False
 Environment=DO_NOT_TRACK=True
+
+# SSO via authentik (OIDC authorization-code flow, 2026-09-24). The OAuth
+# client (application slug "open-webui") lives in authentik; the client
+# SECRET stays off-repo in the git-ignored host env file (mode 600). The
+# container reaches the IdP over the public URL: Caddy publishes 0.0.0.0:443
+# and Pi-hole resolves auth.franksdank.cloud to the host LAN IP, so the
+# server-side code exchange works from this bridge. Roles come from the
+# "Open WebUI roles" scope mapping (entitlements "Open WebUI Users" /
+# "Open WebUI Admins"); OAUTH_MERGE_ACCOUNTS_BY_EMAIL folds SSO logins into
+# the existing local account (frank8465@protonmail.com). The OAuth vars are
+# read directly from the environment at runtime (the per-key config DB holds
+# only Admin-Panel overrides, so nothing is seeded on the live data dir).
+# NOTE: the OAUTH_SCOPES value MUST stay quoted — systemd splits unquoted
+# Environment= values on whitespace (unquoted, only "openid" survived).
+EnvironmentFile=/home/dank/Containers/open-webui/env
+Environment=OAUTH_CLIENT_ID=KmtzKc0bjWjaIFeM0puYudI1CLXR2p0jnPCSf4N0
+Environment=OAUTH_PROVIDER_NAME=authentik
+Environment=OPENID_PROVIDER_URL=https://auth.franksdank.cloud/application/o/open-webui/.well-known/openid-configuration
+Environment=OPENID_REDIRECT_URI=https://ai.franksdank.cloud/oauth/oidc/callback
+Environment=WEBUI_URL=https://ai.franksdank.cloud
+Environment=ENABLE_OAUTH_SIGNUP=true
+Environment=OAUTH_MERGE_ACCOUNTS_BY_EMAIL=true
+Environment="OAUTH_SCOPES=openid email profile roles"
+Environment=ENABLE_OAUTH_ROLE_MANAGEMENT=true
+# SSO-only (2026-09-24): the OIDC round-trip is verified, so the local
+# username/password path is retired. ENABLE_LOGIN_FORM hides the form;
+# ENABLE_PASSWORD_AUTH refuses password logins entirely, so the only way in
+# is the authentik OIDC flow (which folds into the local account by email).
+# The per-key config DB override (ui.enable_login_form) is flipped to false
+# in the same change — the DB wins over env, so both must agree.
+Environment=ENABLE_LOGIN_FORM=false
+Environment=ENABLE_PASSWORD_AUTH=false
+
+# Web search -> SearXNG, reached over the host-published port (NOT the
+# search.franksdank.cloud vhost): the Anubis->Authentik guard chain is a
+# browser mechanism and a plain HTTP client cannot solve it. The internal
+# port bypasses Caddy entirely. These env vars SEED the per-key config DB on
+# first run (fill-missing only); once the keys exist in /app/backend/data the
+# DB is authoritative, so this block documents the intent and makes a fresh
+# data dir come up wired. SearXNG's limiter exempts this source (the bridge
+# egress 10.89.x is in pass_ip), so the 4-req/IP/hour JSON cap never applies.
+Environment=ENABLE_WEB_SEARCH=True
+Environment=WEB_SEARCH_ENGINE=searxng
+Environment=SEARXNG_QUERY_URL=http://192.168.0.143:8081/search
+Environment=SEARXNG_LANGUAGE=all
+Environment=WEB_SEARCH_RESULT_COUNT=6
 Volume=/home/dank/Containers/open-webui/data:/app/backend/data
 
 # App liveness (/health) AND network liveness (a non-loopback interface must

dankserver/.AGENTTRASH/20260916-vllm-radiance/frank-medium-healthcheck.py

@@ -1,21 +0,0 @@
-#!/usr/bin/env python3
-"""frank-medium container healthcheck: the port's /health must answer 200.
-
-Runs INSIDE the container. The vLLM /health endpoint only answers once the
-engine is up (weights loaded, cudagraphs captured), so a healthy container is
-a serving container, not merely a live process. PORT selects the endpoint so
-the single-GPU replicas (:7771/:7772) and the round-robin proxy (:7770) can
-share this probe. The HealthCmd in the quadlet splits on spaces into an argv
-array (podman 5.x v1 generator), which is why this lives in a file rather
-than an inline python one-liner.
-"""
-import os
-import sys
-import urllib.request
-
-port = os.environ.get("PORT", "7770")
-try:
-    with urllib.request.urlopen(f"http://127.0.0.1:{port}/health", timeout=5) as r:
-        sys.exit(0 if r.status == 200 else 1)
-except Exception:
-    sys.exit(1)

dankserver/.AGENTTRASH/20260916-vllm-radiance/frank-medium.container

@@ -1,147 +0,0 @@
-# Quadlet unit: frank-medium (rootless, boot-persistent).
-#
-# Install path on dankserver: ~/.config/containers/systemd/frank-medium.container
-# Unit name: frank-medium.service (container name: frank-medium)
-#
-# The dankserver LLM endpoint (:7770, alias frank-medium), since 2026-09-15
-# running the vllm-radiance MXFP4 stack (stilldeadcode/vllm-radiance:0.9.3
-# image + the ggz14/radiance-vllm-mxfp4 patches) serving
-# just1moremodel/Qwen3.8-27B-Uncensored-MXFP4-awq on the 2x Radeon AI PRO
-# R9700 (gfx1201) cards. It replaced the charlie12345/ROCmFPX llama.cpp
-# deployment, which served the same alias from the Q8_0_ROCMFPX_AGENT GGUF;
-# the MXFP4 stack is tensor-parallel (TP=2, R4D one-shot all-reduce) with the
-# DFlash2-FP8 block-diffusion drafter (SPEC=7) — the measured production
-# configuration of the upstream repo, on our exact hardware signature
-# (2x7551-32624, see the KV pin below).
-#
-# SHAPE. The launcher the upstream repo ships binds the server with
-# --network=host (vLLM takes --host 0.0.0.0 --port 7770 directly), which is
-# what this unit does too — no PublishPort. The fleet contract is unchanged:
-# :7770, served model name frank-medium (SERVED_NAMES), OpenAI /v1.
-#
-# NOT INSTALLED ON THIS HOST. This is the target shape: one tensor-parallel
-# process across both R9700s. It cannot launch a collective here — RCCL's
-# kernels need PCIe atomics and the second card sits behind chipset bridges
-# advertising `AtomicOpsCap: Routing-` — so the active deployment is the
-# two-replica trio in this directory (frank-medium-a/b/proxy) and
-# deploy-remote.sh deliberately does not install this unit. Keep it for a
-# host whose second card is on an atomic-capable root port; the full evidence
-# is in serverAppConfigs-docs/LLM/frank-medium-radiance-mxfp4.md.
-#
-# DEVICES. /dev/kfd + /dev/dri through the amdgpu/KFD stack; HIP/ROCR device
-# indices 0,1 (the two R9700s). The 2 GiB Raphael iGPU enumerates as index 2
-# and is excluded both by the index pin and by the upstream MIN_GPU_MIB=8192
-# logic this unit replaces. --privileged --ipc=host --security-opt
-# seccomp=unconfined --cap-add SYS_PTRACE is the upstream launcher's exact
-# podman posture.
-#
-# MOUNTS. /models (rw checkpoints), the HF cache (tokenizer files),
-# /cache (Triton/inductor/aiter/vLLM compile cache — first start compiles for
-# several minutes, later starts reuse), /patches (the pinned radiance clone —
-# its patches are applied at EVERY container start by the entrypoint), /r4d
-# (the patched libr4d build; the image's shipped r4d.so NaNs the
-# gated-delta-net and must never be used), and the entrypoint + healthcheck
-# scripts from this checkout (mounted read-only straight out of
-# /home/dank/serverAppConfigs — deploy.sh git-pulls the checkout before
-# dispatching).
-#
-# IMAGE. The unit runs the localhost/-aliased tag: this host's podman quadlet
-# path cannot resolve registry-prefixed refs from local storage at create
-# time (same as frank-large on dankclaw). deploy-remote.sh pulls the
-# docker.io ref and re-tags it before the restart. Pull=never keeps boots off
-# the registry.
-#
-# KEEP IN SYNC: the radiance clone is pinned (97353293...); if it is updated,
-# re-diff dankserver/frank-medium/radiance-entrypoint.sh against the new
-# serve-mxfp4.sh container command and bump the pin deliberately.
-#
-# DO NOT name an environment variable TEMP, HOST or GPU_MAX_HEAP_SIZE: the
-# HIP runtime reads bare TEMP for its JIT cache path (2026-08-13 incident).
-[Unit]
-Description=frank-medium — vllm-radiance MXFP4 Qwen3.8-27B-Uncensored on 2x R9700 (gfx1201)
-After=network-online.target
-
-[Container]
-ContainerName=frank-medium
-Image=localhost/radiance-vllm:0.9.3
-# vLLM binds 0.0.0.0:7770 on the host network directly; no PublishPort.
-AddDevice=/dev/kfd
-AddDevice=/dev/dri
-GroupAdd=keep-groups
-# The upstream launcher's exact podman posture (rootless; podman-only flags
-# like --replace are not needed under systemd management).
-PodmanArgs=--privileged --ipc=host --security-opt seccomp=unconfined --cap-add SYS_PTRACE --network=host
-# The two R9700s. The Raphael iGPU (index 2, 2 GiB) stays out: shared system
-# memory is not a compute target.
-Environment=ROCR_VISIBLE_DEVICES=0,1
-Environment=HIP_VISIBLE_DEVICES=0,1
-# The uncensored MXFP4 checkpoint ships its fp8 MTP head already, so no
-# fp8_mtp.py rewrite step exists or is needed (unlike amd/Qwen3.8-27B-Quark-AWQ-MXFP4).
-Environment=SNAP=/models/Qwen3.8-27B-Uncensored-MXFP4-awq
-Environment=DRAFTER=/models/Qwen3.8-27B-DFlash2-FP8
-Environment=CHAT_TEMPLATE=/patches/qwen-fixed-v22.3.jinja
-# Fleet identity: the id at /v1/models and in every response body. Every
-# client (Hermes, the harness, services.json) points at frank-medium.
-Environment=SERVED_NAMES=frank-medium
-Environment=PORT=7770
-# Fixed 2-card tensor parallel: the tested configuration of the upstream
-# repo; the R4D one-shot all-reduce kernel serves it natively.
-Environment=TP=2
-# Measured production batch shape (upstream README): MAXSEQS 8 peaks
-# aggregate throughput at 573 t/s; MAXLEN is the model's native context.
-Environment=MAXSEQS=8
-Environment=CHUNK=8192
-Environment=MAXLEN=262144
-Environment=GPU_UTIL=0.98
-# Speculative decoding: the DFlash2 drafter at depth 7 is the configuration
-# every published number (224 t/s single-stream decode, 4749-4810 t/s
-# prefill) was measured with.
-Environment=SPEC_METHOD=dflash
-Environment=SPEC=7
-# KV cache pin, bytes. From the upstream repo's shipped kv-profiles.tsv row
-#   sig=2x7551-32624 maxseqs=8 chunk=8192 maxlen=262144 spec=dflash
-# which is EXACTLY this host (2x R9700 DID 0x7551, 32624 MiB each). Pinned
-# explicitly because this unit does not run the launcher's lookup; valid
-# only at this batch shape (change MAXSEQS/CHUNK/SPEC_METHOD => recalibrate
-# with calibrate-kv.sh or set KV_MEM=0 to let vLLM profile). Worth
-# 943,581 KV tokens vs ~892,799 profiled (~5.7%).
-Environment=KV_MEM=18563072000
-# Checkpoints (rw: nothing downloads at runtime, but vLLM mmaps the shards;
-# keep parity with the launcher's rw mount).
-Volume=/home/dank/models:/models
-# Tokenizer files ride the HF cache; HF_HUB_OFFLINE=1 is set in the
-# entrypoint.
-Volume=/home/dank/.cache/huggingface:/root/.cache/huggingface
-# Compile cache. Keyed on model + stack version + every graph-changing knob;
-# never share it across configurations (upstream rule).
-Volume=/home/dank/.radiance-cache-w4a8-093-gdnm-nqft-fp8s-gnq:/cache
-# The pinned radiance clone: patches applied at every container start.
-Volume=/home/dank/GitPackages/radiance-vllm-mxfp4:/patches:z
-# The patched libr4d (pin b9e42ab + repo extras, key b9e42ab-rx6). The
-# image's shipped r4d.so predates the GDN overflow fix and NaNs this model.
-Volume=/home/dank/.cache/radiance-libr4d/b9e42ab-rx6:/r4d:z
-# Entrypoint + healthcheck from this checkout, mounted read-only.
-Volume=/home/dank/serverAppConfigs/dankserver/frank-medium/radiance-entrypoint.sh:/usr/local/bin/frank-medium-entrypoint.sh:ro
-Volume=/home/dank/serverAppConfigs/dankserver/frank-medium/frank-medium-healthcheck.py:/usr/local/bin/frank-medium-healthcheck.py:ro
-# The entrypoint must be the container command; the image's own entrypoint
-# (which the patched script execs at the end) must not run unpatched.
-PodmanArgs=--entrypoint /usr/local/bin/frank-medium-entrypoint.sh
-# 200 only once the engine serves; during first-start compilation the
-# container is legitimately unhealthy. HealthCmd is split on spaces into an
-# argv array by the podman 5.x v1 generator, hence the file-based probe.
-HealthCmd=python3 /usr/local/bin/frank-medium-healthcheck.py
-HealthInterval=60s
-HealthTimeout=30s
-HealthRetries=3
-HealthStartPeriod=1800s
-Pull=never
-
-[Service]
-# First start compiles Triton/inductor kernels (several minutes) before the
-# engine loads ~9.5 GiB of weights per card.
-TimeoutStartSec=1800
-Restart=on-failure
-RestartSec=10
-
-[Install]
-WantedBy=default.target

dankserver/.AGENTTRASH/20260916-vllm-radiance/radiance-entrypoint.sh

@@ -1,229 +0,0 @@
-#!/usr/bin/env bash
-# frank-medium container entrypoint: vllm-radiance MXFP4 on 2x Radeon AI PRO
-# R9700 (gfx1201), serving just1moremodel/Qwen3.8-27B-Uncensored-MXFP4-awq.
-#
-# This is a fork of the patch-and-serve block inside radiance-vllm-mxfp4's
-# serve-mxfp4.sh (clone at /home/dank/GitPackages/radiance-vllm-mxfp4, pinned
-# commit 9735329348ae1c9319f01cbe5f7004ec5f4dba63). The published image alone
-# is NOT sufficient for this model: the shipped libr4d predates the
-# gated-delta-net overflow fix and NaNs the output, and the MXFP4 gates need
-# relaxing, so the repo's patches are applied at every container start from
-# the /patches mount. It runs INSIDE the container (executed as the image
-# command by the frank-medium quadlet); the launcher's host-side GPU/TP/KV
-# detection is not needed here because this fleet is fixed 2x gfx1201 and the
-# KV pin is pinned explicitly in the quadlet.
-#
-# KEEP IN SYNC: if the radiance clone is updated, re-diff this file against
-# the new serve-mxfp4.sh container command and against the DRY_RUN output.
-#
-# Env contract: every knob below is ${VAR:-default}; the quadlet sets the
-# fleet-specific ones (SNAP, PORT, SERVED_NAMES, TP, KV_MEM, ...).
-set -euo pipefail
-
-# ---------------------------------------------------------------- serving shape
-: "${SNAP:=/models/Qwen3.8-27B-Uncensored-MXFP4-awq}"
-: "${DRAFTER:=/models/Qwen3.8-27B-DFlash2-FP8}"
-: "${CHAT_TEMPLATE:=/patches/qwen-fixed-v22.3.jinja}"
-: "${PORT:=7770}"
-: "${SERVED_NAMES:=frank-medium}"
-: "${MAXLEN:=262144}"
-: "${MAXSEQS:=8}"
-# KV_MEM=0 is passed THROUGH as --kv-cache-memory 0, which the image's
-# patched KV sizing reads as "profile the shape" (the launcher's rule).
-# Blanking the variable instead omits the flag and makes vLLM size the cache
-# from --gpu-memory-utilization alone: measured on the single-GPU replicas
-# that overshoots and the allocation dies with torch.OutOfMemoryError right
-# after the weights load (2.16 GiB requested, 116 MiB free). Do not "fix"
-# this into an empty expansion.
-: "${KV_MEM:=18563072000}"   # shipped kv-profiles.tsv row 2x7551-32624 @ 8/8192/262144/dflash
-: "${SPEC_METHOD:=dflash}"
-if [ "$SPEC_METHOD" = dflash ]; then : "${SPEC:=7}"; else : "${SPEC:=4}"; fi
-: "${MIN_M:=0}"              # 0 = the W4A8 kernel serves every M (MIN_M=1 still routes M=1 to aiter)
-: "${R4D_ATTN:=1}"
-: "${ASYNC:=0}"
-
-if [ "$R4D_ATTN" = "1" ]; then ATTN=R4D; else ATTN=ROCM_AITER_UNIFIED_ATTN; fi
-if [ "$ASYNC" = 1 ]; then ASYNC_FLAG="--async-scheduling"; UNPAD=false; else
-  ASYNC_FLAG="--no-async-scheduling"; UNPAD=true; fi
-
-# Drafting config. dflash: the DFlash2-FP8 block-diffusion drafter (its
-# attention backend must support full cuda graphs -> TRITON_ATTN). The
-# disable_padded_drafter_batch unpad is the single-stream lever (~+50%).
-if [ "$SPEC_METHOD" = dflash ]; then
-  if [ ! -f "$DRAFTER/config.json" ]; then
-    echo "frank-medium: no dflash drafter at $DRAFTER" >&2
-    exit 1
-  fi
-  DRAFT_SAMPLE=${DRAFT_SAMPLE:-greedy}
-  SPEC_CFG="{\"method\":\"dflash\",\"model\":\"$DRAFTER\",\"num_speculative_tokens\":$SPEC,\"attention_backend\":\"TRITON_ATTN\",\"disable_padded_drafter_batch\":$UNPAD,\"draft_sample_method\":\"$DRAFT_SAMPLE\"}"
-  RADIANCE_DRAFT_RERANK=${RADIANCE_DRAFT_RERANK:-80}
-  RADIANCE_VERIFY_HEAD=${RADIANCE_VERIFY_HEAD:-1}
-else
-  SPEC_CFG="{\"method\":\"mtp\",\"num_speculative_tokens\":$SPEC,\"attention_backend\":\"$ATTN\",\"disable_padded_drafter_batch\":$UNPAD}"
-  RADIANCE_DRAFT_RERANK=${RADIANCE_DRAFT_RERANK:-32}
-  RADIANCE_VERIFY_HEAD=${RADIANCE_VERIFY_HEAD:-0}
-fi
-
-# The AR size gate compares raw bf16 bytes: CHUNK x hidden(5120) x 2. Derived
-# so changing CHUNK cannot silently drop prefill back onto RCCL.
-export RADIANCE_AR_MAX_KB=$(( (CHUNK * 5120 * 2) / 1024 + 4096 ))
-
-# ---------------------------------------------------------------- runtime env
-export HF_HUB_OFFLINE=1
-export VLLM_LOGGING_LEVEL=${VLLM_LOGGING_LEVEL:-INFO}
-export VLLM_NO_USAGE_STATS=${VLLM_NO_USAGE_STATS:-1}
-export VLLM_ROCM_USE_AITER=1 VLLM_ROCM_USE_AITER_UNIFIED_ATTENTION=1
-export VLLM_ROCM_USE_AITER_MHA=0 VLLM_ROCM_USE_AITER_MLA=0 VLLM_ROCM_USE_AITER_MOE=0
-export VLLM_ROCM_USE_AITER_LINEAR=0 VLLM_ROCM_USE_AITER_FP8BMM=0
-export VLLM_ROCM_USE_AITER_FP4BMM=0 VLLM_ROCM_USE_AITER_RMSNORM=0
-export NCCL_PROTO=Simple
-export RADIANCE_USE_R4D=${RADIANCE_USE_R4D:-1} RADIANCE_USE_R4D_AR=${RADIANCE_USE_R4D_AR:-1}
-export RADIANCE_DFLASH_SELECTOR_TOPK="${RADIANCE_DFLASH_SELECTOR_TOPK:-}"
-export RADIANCE_R4D_REPORT=1
-export RADIANCE_PRESHUFFLE=${RADIANCE_PRESHUFFLE:-1}
-export RADIANCE_MXFP4_SANITIZE="${RADIANCE_MXFP4_SANITIZE:-0}"
-export RADIANCE_MXFP4=1 RADIANCE_MXFP4_W4A8=1 RADIANCE_MXFP4_W4A8_MIN_M="$MIN_M"
-export RADIANCE_FAST_DRAFT=${RADIANCE_FAST_DRAFT:-1}
-export RADIANCE_DRAFT_TAU=${RADIANCE_DRAFT_TAU:-0.20}
-export RADIANCE_DRAFT_RERANK
-export RADIANCE_VERIFY_HEAD
-export RADIANCE_VERIFY_HEAD_MAX_M=${RADIANCE_VERIFY_HEAD_MAX_M:-32}
-export RADIANCE_MXFP4_DEBUG=${RADIANCE_MXFP4_DEBUG:-0}
-export RADIANCE_MXFP4_PUREQUANT=${RADIANCE_MXFP4_PUREQUANT:-0}
-export RADIANCE_MXFP4_SYNC=${RADIANCE_MXFP4_SYNC:-0}
-export RADIANCE_MXFP4_CLONE=${RADIANCE_MXFP4_CLONE:-0}
-export RADIANCE_MXFP4_CHECKX=${RADIANCE_MXFP4_CHECKX:-0}
-export RADIANCE_MXFP4_PADOUT=${RADIANCE_MXFP4_PADOUT:-0}
-export RADIANCE_MXFP4_TN4_MIN_M=${RADIANCE_MXFP4_TN4_MIN_M:-2048}
-# The decode-kernel band must cover MAXSEQS x (SPEC+1) rows: 64 covers 8x8.
-if [ "${MAXSEQS}" -gt 8 ]; then
-  export RADIANCE_MXFP4_DECODE_MAX_M=${RADIANCE_MXFP4_DECODE_MAX_M:-128}
-fi
-export RADIANCE_MXFP4_DECODE_NT=${RADIANCE_MXFP4_DECODE_NT:-1}
-export RADIANCE_MXFP4_A_TILED_MIN_M=${RADIANCE_MXFP4_A_TILED_MIN_M:-513}
-export RADIANCE_MXFP4_WPERM=${RADIANCE_MXFP4_WPERM:-1}
-export RADIANCE_TP_PAD=${RADIANCE_TP_PAD:-0}   # TP=2 here; 3 is the only non-zero value upstream supports
-export RADIANCE_TP_PAD_DRAFTER=${RADIANCE_TP_PAD_DRAFTER:-1}
-export RADIANCE_TP_PAD_STRICT=${RADIANCE_TP_PAD_STRICT:-1}
-export RADIANCE_GDN_MERGE_INPROJ=${RADIANCE_GDN_MERGE_INPROJ:-1}
-export RADIANCE_GDN_NORM_QUANT=${RADIANCE_GDN_NORM_QUANT:-1}
-export RADIANCE_GDN_STRIDED_GATES=${RADIANCE_GDN_STRIDED_GATES:-0}
-export RADIANCE_GDN_EMPTY_OUT=${RADIANCE_GDN_EMPTY_OUT:-0}
-export R4D_ATTN_FP8=${R4D_ATTN_FP8:-3}
-export RADIANCE_DFLASH_CALIB="${RADIANCE_DFLASH_CALIB:-}"
-export RADIANCE_DFLASH_CALIB_TOKENS="${RADIANCE_DFLASH_CALIB_TOKENS:-200000}"
-export RADIANCE_MXFP4_SHADOW="${RADIANCE_MXFP4_SHADOW:-}"
-export RADIANCE_MXFP4_KERNEL_N="${RADIANCE_MXFP4_KERNEL_N:-}"
-export RADIANCE_MXFP4_KERNEL_NK="${RADIANCE_MXFP4_KERNEL_NK:-}"
-export RADIANCE_MXFP4_CHECKALL="${RADIANCE_MXFP4_CHECKALL:-}"
-export RADIANCE_MXFP4_DECODE_KS="${RADIANCE_MXFP4_DECODE_KS:-}"
-export RADIANCE_MXFP4_DECODE_BK="${RADIANCE_MXFP4_DECODE_BK:-}"
-export RADIANCE_MXFP4_PERBLOCK_NK="${RADIANCE_MXFP4_PERBLOCK_NK:-}"
-export RADIANCE_MXFP4_REFLINEAR="${RADIANCE_MXFP4_REFLINEAR:-0}"
-export PYTORCH_CUDA_ALLOC_CONF="${PYTORCH_CUDA_ALLOC_CONF:-}"
-export RADIANCE_MXFP4_EPIFAST="${RADIANCE_MXFP4_EPIFAST:-1}"
-export RADIANCE_AR_OVERLAP=${RADIANCE_AR_OVERLAP:-0}
-export RADIANCE_GDN_FUSED_UPDATE=${RADIANCE_GDN_FUSED_UPDATE:-1}
-export RADIANCE_DYNAMIC_WIDTH=${RADIANCE_DYNAMIC_WIDTH:-1}
-export RADIANCE_DYNW_ALPHA=${RADIANCE_DYNW_ALPHA:-0.35}
-export RADIANCE_DYNW_MARGIN=${RADIANCE_DYNW_MARGIN:-2}
-export RADIANCE_DYNW_MIN=${RADIANCE_DYNW_MIN:-2}
-export RADIANCE_DYNW_MIN_BATCH=${RADIANCE_DYNW_MIN_BATCH:-3}
-export RADIANCE_AR_QNB=${RADIANCE_AR_QNB:-96}
-export RADIANCE_AR_QNT=${RADIANCE_AR_QNT:-1024}
-export MXFP4_CUMODE=${MXFP4_CUMODE:-0}
-export RADIANCE_STEP_TRACE=${RADIANCE_STEP_TRACE:-0}
-export RADIANCE_AR_OVERLAP_MIN_M=${RADIANCE_AR_OVERLAP_MIN_M:-2048}
-export RADIANCE_AR_OVERLAP_SLICES=${RADIANCE_AR_OVERLAP_SLICES:-4}
-export RADIANCE_MXFP4_EPIFAST=${RADIANCE_MXFP4_EPIFAST:-1}
-export RADIANCE_MXFP4_R4D_DECODE_MAX_M=${RADIANCE_MXFP4_R4D_DECODE_MAX_M:-0}
-export RADIANCE_TOPK_TRITON_MIN_ROWS=${RADIANCE_TOPK_TRITON_MIN_ROWS:-1}
-export RADIANCE_SKINNY_GEMM=${RADIANCE_SKINNY_GEMM:-1}
-export RADIANCE_MXFP4_HOIST_QUANT=${RADIANCE_MXFP4_HOIST_QUANT:-1}
-export RADIANCE_MXFP4_TRACED_QUANT=${RADIANCE_MXFP4_TRACED_QUANT:-1}
-export RADIANCE_FP8_STREAM=${RADIANCE_FP8_STREAM:-1}
-export RADIANCE_RMS_QUANT_FUSION=${RADIANCE_RMS_QUANT_FUSION:-1}
-export RADIANCE_NVFP4_MXFP4=${RADIANCE_NVFP4_MXFP4:-0}
-export RADIANCE_NVFP4_EXP=${RADIANCE_NVFP4_EXP:-mse}
-export RADIANCE_NVFP4_FP8_LAYERS=${RADIANCE_NVFP4_FP8_LAYERS:-mxfp4}
-export RADIANCE_NVFP4_BF16_LAYERS=${RADIANCE_NVFP4_BF16_LAYERS:-in_proj_ba}
-export RADIANCE_NVFP4_LMHEAD=${RADIANCE_NVFP4_LMHEAD:-bf16}
-export RADIANCE_GDN_PATHS=${RADIANCE_GDN_PATHS:-both}
-export RADIANCE_GDN_NANTRACE=${RADIANCE_GDN_NANTRACE:-0}
-export RADIANCE_MXFP4_CHECK_MAX_M=${RADIANCE_MXFP4_CHECK_MAX_M:-128}
-export RADIANCE_MXFP4_MHIST=${RADIANCE_MXFP4_MHIST:-0}
-export VLLM_CACHE_ROOT=/cache/vllm
-export TORCHINDUCTOR_CACHE_DIR=/cache/inductor
-export TRITON_CACHE_DIR=/cache/triton
-export AITER_ROOT_DIR=/cache/aiter
-export TRITON_CACHE_AUTOTUNING=1
-# The patched libr4d built by setup-mxfp4.sh, bind-mounted at /r4d.
-R4D_SO=${R4D_SO:-/r4d}
-
-# The norm+quant fusion turns on vLLM's passes (one --compilation-config
-# instance; argparse keeps the last, so entries accumulate into one flag).
-CC_ITEMS=""
-if [ "${RADIANCE_NORMQUANT_FUSION:-1}" != "0" ]; then
-  CC_ITEMS="\"pass_config\":{\"fuse_norm_quant\":true,\"fuse_act_quant\":true}"
-fi
-EXTRA=${EXTRA:-}
-if [ -n "$CC_ITEMS" ]; then
-  EXTRA="$EXTRA --compilation-config {$CC_ITEMS}"
-fi
-
-# ---------------------------------------------------------------- patch block
-# Byte-for-byte the launcher's container-start block. The patches come from
-# the /patches mount (the pinned radiance clone). SP must match the image's
-# venv layout; the image tag is pinned in the quadlet.
-SP=/opt/vllm/lib/python3.12/site-packages
-cd /patches
-python3 patch_quark_mxfp4.py
-python3 patch_nvfp4_mxfp4.py
-python3 patch_tp3_pad.py
-python3 patch_ar_maxbytes.py
-python3 patch_topk_triton_rows.py
-python3 patch_dflash_calib.py
-python3 patch_dflash_mxfp4_kv.py
-python3 patch_rmsquant_fusion.py
-python3 patch_verify_head.py
-python3 patch_kv_group_size.py
-python3 patch_topk_composite.py
-python3 patch_gdn_shared_build.py
-python3 patch_dflash_selector_topk.py
-python3 patch_gdn_merge_inproj.py
-python3 patch_dynwidth.py
-python3 patch_async_dynwidth.py
-python3 patch_step_trace.py
-python3 patch_ar_geometry.py
-python3 patch_ar_3rank.py
-python3 patch_gdn_glue.py
-# Non-fatal: fixes content=null on thinking-off requests; not required to serve.
-python3 patch_qwen3_thinkoff.py \
-  || echo "[radiance] WARNING: thinkoff patch did not apply; thinking-off requests will return empty content"
-cp mxfp4-configs/*.json "$SP"/aiter/ops/triton/configs/gemm/
-cp radiance_preamble.py /opt/radiance_preamble.py
-cp radiance_nvfp4.py radiance_mxfp4.py radiance_gdn.py radiance_rmsquant.py radiance_drafthead.py \
-   radiance_verifyhead.py radiance_gdnmerge.py radiance_aroverlap.py radiance_topk.py \
-   radiance_arnq.py radiance_tp3pad.py "$SP"/
-hipcc -O3 -w -std=c++17 -fPIC -shared --offload-arch=gfx1201 $([ "${MXFP4_CUMODE:-0}" = 1 ] && echo -mcumode) \
-  $(python3 -m pybind11 --includes) radiance_mxfp4_fp8.hip -o "$SP"/radiance_mxfp4_fp8.so
-if [ -n "${R4D_SO:-}" ] && [ -f /r4d/r4d.so ]; then
-  cp /r4d/r4d.so "$SP"/r4d.so
-  echo "[radiance] using patched r4d.so from $R4D_SO"
-fi
-# Leave /patches before exec: a stale radiance_mxfp4_fp8.so there would shadow
-# the one just compiled into site-packages (cwd precedes it on sys.path).
-cd /
-exec /opt/radiance_entrypoint.sh "$SNAP" --served-model-name $SERVED_NAMES \
-  --host 0.0.0.0 --port "$PORT" \
-  --kv-cache-dtype fp8 --tensor-parallel-size "$TP" \
-  --gpu-memory-utilization "$GPU_UTIL" \
-  ${KV_MEM:+--kv-cache-memory "$KV_MEM"} \
-  --max-model-len "$MAXLEN" --max-num-seqs "$MAXSEQS" --max-num-batched-tokens "$CHUNK" \
-  --attention-backend "$ATTN" \
-  --speculative-config "$SPEC_CFG" \
-  $ASYNC_FLAG $EXTRA \
-  --enable-prefix-caching --mamba-cache-mode align --enable-auto-tool-choice \
-  --tool-call-parser qwen3_coder --reasoning-parser qwen3 \
-  --override-generation-config '{"temperature":0.7,"top_p":0.95,"top_k":20}' \
-  --chat-template "$CHAT_TEMPLATE"

dankserver/calibre-server/quadlet/calibre-server.container

@@ -0,0 +1,63 @@
+# Quadlet unit: Calibre Content Server (rootless, boot-persistent).
+#
+# Install path on dankserver:
+# ~/.config/containers/systemd/calibre-server.container
+# Unit name: calibre-server.service (podman 5.x drops the container- prefix)
+#
+# The image is the CURRENT linuxserver/calibre (9.15.0), which is a desktop
+# image (Selkies web-streamed GUI on 8080/8181) with the headless
+# calibre-server available inside. The compose-era snippet in
+# serverAppConfigs-docs/Dankserver/Calibre.md predates the desktop revamp;
+# the dedicated headless images (ta264/docker-calibre, agentgreen) are
+# dormant (calibre 6.10 / 2017), so this unit runs calibre-server as the
+# image's s6-overlay main service via Exec=; the desktop also runs but its
+# ports are internal-only (see the port map below).
+#
+# Port map: Network=pasta is port-FORWARD mode on this host (the container
+# keeps its own netns; only PublishPort'd ports reach the host — verified
+# 2026-09-21: 8080/8090/8182 inside the container are not visible on the
+# host, only the 8084 forward). So the ONLY exposed surface is:
+#   8090 -> host 8084  calibre-server (the content server; 8080 inside the
+#                      container is the image's own nginx, 8083 on the host
+#                      is calibre-web)
+# The desktop GUI (nginx 8080/8181 + WS 8082, inside the container) runs but
+# is internal-only: no PublishPort. Exposing it is one PublishPort line away
+# if the browser GUI is ever wanted (the basic-auth credential is already in
+# the env file).
+# Auth: calibre-server 9.x keeps its users in a SQLite userdb (the pw column
+# is PLAINTEXT, so the file is mode 600). The single admin account is
+# bootstrapped once by the deploy handler (deploy_calibre_server) via
+# `calibre-server --manage-users -- add`, password piped on stdin with
+# printf (a trailing newline from echo lands in the stored password and
+# breaks every login). The desktop's basic auth (CUSTOM_USER/CUSTOM_PASSWORD)
+# reuses the same credential pair. Both live in the machine-local env file;
+# this unit holds no secrets.
+#
+# --auth-mode=basic is required: on a non-SSL port the server defaults to
+# Digest auth, which rejects plain Basic clients with 400 "Unsupported
+# authentication method".
+
+[Unit]
+Description=Calibre content server container
+After=network.target
+
+[Container]
+ContainerName=calibre-server
+Image=lscr.io/linuxserver/calibre:9.15.0
+Network=pasta
+EnvironmentFile=/home/dank/Containers/calibre-server/env
+Environment=PUID=1000
+Environment=PGID=1000
+Environment=TZ=America/Vancouver
+Volume=/home/dank/Containers/calibre-web/books:/books
+Volume=/home/dank/Containers/calibre-server/userdb.sqlite:/userdb.sqlite
+Exec=calibre-server --port 8090 --enable-auth --auth-mode=basic --userdb /userdb.sqlite /books
+PublishPort=8084:8090
+
+[Service]
+TimeoutStartSec=300
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target

dankserver/calibre-web/quadlet/calibre-web.container

@@ -16,7 +16,7 @@ After=network.target
 
 [Container]
 ContainerName=calibre-web
-Image=lscr.io/linuxserver/calibre-web:0.6.27-ls397
+Image=lscr.io/linuxserver/calibre-web:0.6.27-ls402
 Network=pasta
 Environment=DOCKER_MODS=linuxserver/mods:universal-calibre
 Environment=LANG=en_US.UTF-8

dankserver/compose.yaml

@@ -127,7 +127,7 @@ services:
   # Calibre-Web — e-book web frontend
   # ═══════════════════════════════════════════════
   calibre-web:
-    image: lscr.io/linuxserver/calibre-web:0.6.27-ls397
+    image: lscr.io/linuxserver/calibre-web:0.6.27-ls402
     container_name: calibre-web
     restart: unless-stopped
     environment:

dankserver/plex/quadlet/plex.container

@@ -4,7 +4,7 @@ After=network-online.target
 Wants=network-online.target
 
 [Container]
-Image=lscr.io/linuxserver/plex:1.43.3.10896-cb3ebc72d-ls322
+Image=lscr.io/linuxserver/plex:1.43.4.10903-e5521bd8c-ls325
 ContainerName=plex
 Network=dankserver_appnet:alias=plex
 Environment=PUID=0

dankserver/tautulli/quadlet/tautulli.container

@@ -4,7 +4,7 @@ After=network-online.target
 Wants=network-online.target
 
 [Container]
-Image=lscr.io/linuxserver/tautulli:v2.18.1-ls242
+Image=lscr.io/linuxserver/tautulli:v2.18.1-ls245
 ContainerName=tautulli
 Network=dankserver_appnet:alias=tautulli
 Environment=PUID=0

old/download-frank-primary-fp8.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# download-frank-primary-fp8.sh — fetch/verify the Qwen3.8-Flash-Next-FP8
+# payload (131 safetensors shards, 172.78 GiB total, plus aux files) for the
+# vLLM frank-primary deployment on dankserver.
+#
+#   bash scripts/download-frank-primary-fp8.sh [dest_dir]
+#
+# The manifest (scripts/manifests/qwen3.8-flash-next-fp8.manifest) carries
+# per-file sizes + LFS sha256s from the Hub; hf-fetch.sh is idempotent — an
+# interrupted re-run fetches only what is missing or corrupt, and a complete
+# on-disk payload is re-verified (full sha256 pass) with zero downloads.
+# The repo is public; no HF_TOKEN required.
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+dest="${1:-/home/dank/models/Qwen3.8-Flash-Next-FP8}"
+
+exec bash "$REPO_ROOT/scripts/hf-fetch.sh" "$dest" \
+    "$REPO_ROOT/scripts/manifests/qwen3.8-flash-next-fp8.manifest" \
+    Qwen/Qwen3.8-Flash-Next-FP8

old/qwen3.8-flash-next-fp8.manifest

@@ -0,0 +1,144 @@
+.gitattributes 1635 
+LICENSE 3235 
+README.md 65400 
+chat_template.jinja 8952 
+config.json 72514 
+generation_config.json 202 
+merges.txt 3353259 
+model-00001-of-00131.safetensors 1040155912 774f0ceeadb40d165f2b3ff397d5f3840e6ca8fcb8f3d39d8acb4fea9e52c941
+model-00002-of-00131.safetensors 1678209208 6841fe21fa8a8a7a693c585efe65cd2732889095b696da88bda0cb287366910b
+model-00003-of-00131.safetensors 993901136 974a2a2ab551f8f1405a4955ab32a8721c68c73dd85b382491d9f0e6a34ee752
+model-00004-of-00131.safetensors 1678209208 591f488ab5cd5f0bd4fe28266099523761b9b9339137800734c34ffd84595538
+model-00005-of-00131.safetensors 1717267690 c50bf465a4a0129f1a1196c0e75d881048238f7107b356fc734007eac0d3b123
+model-00006-of-00131.safetensors 1600008328 57f103367fe36c9dc355c648d521d026caabb4ce5ba51038c78bd935f6593736
+model-00007-of-00131.safetensors 1600008328 cde2a12854770c706a74a5c7b85ffc140e3d4dba93dd4bee1cd7aa07cc348c90
+model-00008-of-00131.safetensors 1600008328 98ae323b5a61abdcf58a0dc9db7eb1a5a748cebc1ef1932804a1411500c09d84
+model-00009-of-00131.safetensors 1600008328 70f4b66bca5c4c0b441cf4284d4ab311670e182bfc5ec51c7294a4054baeb20f
+model-00010-of-00131.safetensors 1600008328 6d5dfa1dfa9a6c482f100f6e75c1f5e8ac02391c62e844e53f4a53996baf2206
+model-00011-of-00131.safetensors 1600008328 de085adb563e530e7ad157220cd1a219be189a1db0fcc3f2507886a2d78bd4e1
+model-00012-of-00131.safetensors 1600008328 97dac7c366ba19858d78c01364054136449ccb3cf60768587461cbf0bb582c90
+model-00013-of-00131.safetensors 1600008328 467be10b473d25e0581f8fb1bc986916c8b9301272f72e7a05762484ffc080a9
+model-00014-of-00131.safetensors 1600008328 38def6e9bbe6f242c2f92858c3e9a2b356d74d0180e323677158016dbee32ae7
+model-00015-of-00131.safetensors 1600008328 90c6c665f1f819bc6350714652c8fb77064fec57832ef51b878a0cdf9f602236
+model-00016-of-00131.safetensors 1600008328 88185c2530641b37dcad80d37b505c5257035e87ad29fa86640aae4814903e4f
+model-00017-of-00131.safetensors 1600008328 42e3b96359116d7471a74cb7de08f6a4e9e173830d562f1f74ff09d1d253ad38
+model-00018-of-00131.safetensors 1600008328 040adc7270efca6498c6f6a07dd7da14925d20217fe6de67223d6856fb4f2ad7
+model-00019-of-00131.safetensors 1600008328 b8a831992deb1a694439e37b7136ff2e181457a8683bff65f1f4b99772cabe58
+model-00020-of-00131.safetensors 1600008328 9426112fbd49ef4f5e9dd38dc2f93b046602e6d92cff732d33b96413ff1b40dc
+model-00021-of-00131.safetensors 1600008328 fce8426665f749ef38c4fad33b612f892b728c0f74fe60cab0e43ece785b4e77
+model-00022-of-00131.safetensors 1600008328 a20dd415f280774321538e6b9e78fba9f8e218a9090eae52ea7172b85b9c5a6d
+model-00023-of-00131.safetensors 1600008328 4100591839471a8721d9cedb251554dcef5ebc1dfd96ea7dce8912dd1e9921b2
+model-00024-of-00131.safetensors 1600008328 bbd6d7a4b54b6a6032e15b7c2fc9d6526377f89992d61da8837ad059f3210b45
+model-00025-of-00131.safetensors 1600008328 f9fa7b04de155dd2be74b5693d5b36e5463dabf956b9be36f67d4aae6b8dd304
+model-00026-of-00131.safetensors 1600008328 193c6b9da2c6b69c34d8a14b65234871db272761e712c2e56bac3f13c2d0cbf7
+model-00027-of-00131.safetensors 1600008328 d7efa372552c07ee8783e27c4b8ebd12fc75333f92553861bec8c7c0155a03fe
+model-00028-of-00131.safetensors 1600008328 5fc13d084d62c06b928dfb388a1b36f5c27cd25bd3cbb68a0b21e1c4cfc68e6e
+model-00029-of-00131.safetensors 1600008328 a11f5a6360b349159575871db5c553c40c37be68382b82551a2c2372f15f2811
+model-00030-of-00131.safetensors 1600008336 cac780a675f87fc699435a5207cbecb30a887271b5514b60b7e45d9bebe0e1ec
+model-00031-of-00131.safetensors 1600008336 d390a872eb3928b9d7c0a720ced792cc111613812a163d9fd6c97fd35d633897
+model-00032-of-00131.safetensors 1600008336 3b36fe4e7215a12cdc6c7499aafde51cfbce51266785184b99d3838a6b37b2c8
+model-00033-of-00131.safetensors 1600008336 3fb0504f406c0c71ee40e9e158492973c5c35337889c81b974892b407620c64c
+model-00034-of-00131.safetensors 1600008336 6d989a812a8d8d9330c8c4d21d7be98a0114705ca3bd7834d43bb268bad6be08
+model-00035-of-00131.safetensors 1600008336 8e56ba0a714198bd07a2d8fe9d91fbf5c72601c1b98edf09b289a2538445cb75
+model-00036-of-00131.safetensors 1600008336 c23fd6f6cfa9acfa961ba26e7c9c0dd7b05782c5bbf8f55e2526119b5c516fd4
+model-00037-of-00131.safetensors 942343240 b824a11bf460bd78c068e3d301e914a0bec2f243a6eea4679be7200d179248e7
+model-00038-of-00131.safetensors 1678211256 716eda81a763ffdefd1ac5306b4c80eef123c4dee24ed3a565a22438497581cb
+model-00039-of-00131.safetensors 877983696 b91e3bfbcd765ce704db85b78f69055da59456ae733df635e3973ff2f966a148
+model-00040-of-00131.safetensors 1678211256 3311ed7821b68bddb1542f06ca349feec72e68288113fe4899b08a3b8156343f
+model-00041-of-00131.safetensors 1103350296 1d79949b61730a0fa1f6cd1af149fa50fedc051566cdea48283de8c7a32d972c
+model-00042-of-00131.safetensors 1678211256 3f61684338e203cb2ccff6e451eda5705e10043d386b7ed55d4732d23eb5c77b
+model-00043-of-00131.safetensors 1000455912 bab92cfefbb811ee63c4e32595024117c7df3537f5359606eb1de23fe4f115b2
+model-00044-of-00131.safetensors 1678211256 1d05f138848edca4138c3d1c6be4a432a0817eb29fa65f12d8611ecc7685c493
+model-00045-of-00131.safetensors 993902176 4610384e28f7a91b8bf2a1527178c82cbe7d50ecd9a33b61ee878fa8e8bced85
+model-00046-of-00131.safetensors 1678211256 5ee9b0e45810300cbd4fd6f2acfe85080e7032a9ce5d77038b86f357b6700c23
+model-00047-of-00131.safetensors 878065752 efa6c0cc0e527486dc5955b00fa75665151d99997b722d8e56bd32da575e414c
+model-00048-of-00131.safetensors 1678211256 57b148a266c55a896f171b5c98b350092bf394c1fb836658c58c589a0a317ccf
+model-00049-of-00131.safetensors 1096817160 801dd3b475b43413ade810f4e8d3ace69d6ef5ee4bac5cb98d15e369343a5569
+model-00050-of-00131.safetensors 1678211256 b4d00aca34ba7a9f8427983fd0829408fb5e15b2bb7268199e4010bf0c460a04
+model-00051-of-00131.safetensors 993902176 f430125e9ac92c2de15bbb74bcd3c91bc5374eef389a1be1bc4a592f3a082f0c
+model-00052-of-00131.safetensors 1678211256 06c3d64136b097919b7e5a1715a70a60b8c2302fc4e80a33235607bb99d00f35
+model-00053-of-00131.safetensors 1000455920 147d38f786512f1a8f570a00100b46a3faab1bd649b3445ca0a50c00aa2e99a3
+model-00054-of-00131.safetensors 1678211256 31c08218039a246c333bfe0b068b8027fd92dddd542e581997af546eb104dd4d
+model-00055-of-00131.safetensors 877983696 971cd69c8d955bef6d557ebab3f170807a599517f7c69e9d8a6ba375214137f4
+model-00056-of-00131.safetensors 1678211256 a6a975ac346aa3bd1176cb816d8bbd31a4d7542aa3de9306ca5899bea44bd159
+model-00057-of-00131.safetensors 1103350288 d6acae1622abfa1e0253ae548bc1bdd4bc38cd9b096082acd455b6be592f4a54
+model-00058-of-00131.safetensors 1678209208 f02b6bd8f5cbd742e8bac3ba9537aa14a64c5a8f3fc75495227a14e1a5cec4ec
+model-00059-of-00131.safetensors 877982872 f3e2c94b8157a021b27e1efdb659333a8d1db330da5cd72ab9012fa0e5351506
+model-00060-of-00131.safetensors 1794100080 908cce7f5fe8dc34f4cca1fc8a676569ab6ce08bad536bd0091c4d75e7b65a05
+model-00061-of-00131.safetensors 1678211256 718532c88f4b7a4f402a50e4f1b6efc3cf71484c9e5a083ee30e96d5094a1bb3
+model-00062-of-00131.safetensors 1832994688 3c21b895a5a4f0dc03b669c730f8d8d9ce9a29cbc7628a25894a16ffda6f0a7a
+model-00063-of-00131.safetensors 1678211256 91d215e2135b2f5db5bc5a9541e5f6bf761205d67c6e7b8955ac73c815198f58
+model-00064-of-00131.safetensors 993902176 03a11cad2c283fb9752c6ac01c8f1d8b3127dcda963c5a8225b78f567239d872
+model-00065-of-00131.safetensors 1678211256 0f2f96331120779ce1ebd3f957882092d3c733aa9a6073ca87fc86c6eb4e9465
+model-00066-of-00131.safetensors 880605240 5dbe501e4e0cb9e3f37cc43da46673b4157fdffba09c065ca0b12d75092a79f2
+model-00067-of-00131.safetensors 1678211256 3ece325d2ca53eddf7b1782d5bbc4c376bc75c6d3da67813e110fd0af67cd09b
+model-00068-of-00131.safetensors 1096796552 0c5ef706afd6b3058af5bf8fdc1e0938cb6e29d0a526c771893c9dcb8e702463
+model-00069-of-00131.safetensors 1678211256 84999b24e3c55d2eae3ca187219a2e1a1872436ae9bafc91cc3e301180f36cfd
+model-00070-of-00131.safetensors 993907416 eac7940317ee401859caf38089b2b924274ab81a3e5fbd87c42d89923361aad8
+model-00071-of-00131.safetensors 1678211256 5ac60e474ccdab21257245630ed8240d75bc7115b3adb27ca65e39eb9ea8f20e
+model-00072-of-00131.safetensors 1000456024 b50a05c4c426fb00635d513a733a290da1007a89b8785f1ec02aad8e4d93d955
+model-00073-of-00131.safetensors 1678211256 9e0594d389debdfb26d22259725831ff34280edeef4144e683d70205050919d9
+model-00074-of-00131.safetensors 877983696 1b1a0294f8df2a431885783185cdb185106228c9567e67224fe2c3c6a2467f5a
+model-00075-of-00131.safetensors 1678211256 7dba189804ef7a8f9d926b27e1ddbe73767f1213cb7bb3cc582ab15fffec1792
+model-00076-of-00131.safetensors 1100073480 d95ebacb144b4220f2df60cce85a2c86e87cb8291b836d1bd04f9902fcbb9297
+model-00077-of-00131.safetensors 1678211256 26046977983e025defdf0f84cf5fc5f4ddfeabbd27e7abc43ff2b413265ab062
+model-00078-of-00131.safetensors 993984232 6fd46a95777392265b2afa66bf71d488856dafb7b76ff0337a0fe4ac857e961c
+model-00079-of-00131.safetensors 1678211256 77398002634ce852917c59cd642bec7dd3903381239da68912bf69743631e54e
+model-00080-of-00131.safetensors 877983688 f44aad95d36c443995b965aeef844c8e3a30ed172647dc57fcc0c5476c18d024
+model-00081-of-00131.safetensors 1678209208 b295a48088573654d1b4754e861ec329956504cb6687e9e2a8eb652b35eaf988
+model-00082-of-00131.safetensors 1096816112 83e0e171116c22eb8fdddfa3c387bebb9017eb0586410fd704ce70e7b3d23d68
+model-00083-of-00131.safetensors 1678211256 7e1021cde06c970e4b1d9eb3d02f66f29786c59a0da8a3f8879de1a4e3fbf6c0
+model-00084-of-00131.safetensors 877983696 8938fd3c7f88d61fd5b5306eb0ab253d3e42e7f64baf3c3e494d315c8ad5ab55
+model-00085-of-00131.safetensors 1678211256 cd5875a29d28d52578ae699fdd8891f605a0953cd64516bd88dc45dab50c383a
+model-00086-of-00131.safetensors 1103350296 885e570a662aaf266fd9af9562c65116998df5710b2a27d1bf6aa0c8708b3b74
+model-00087-of-00131.safetensors 1678211256 1472604826f0a0c2bbf7cd0f4a0c5b29f3012e4b3a4424d024d1ec17a3c9d0ea
+model-00088-of-00131.safetensors 1000455920 e7273f5435571e761429330ece81732e8fb3f8b5f0087bf80db693630cf702a1
+model-00089-of-00131.safetensors 1678211256 eb349562d23e330bbbd0a5f5ba90ac25ed0baa660dff230538a0fcaaf4c8b875
+model-00090-of-00131.safetensors 997179104 532915eebd4e231a240e185ba838a95a00ee14277e28fb04ad21508da5ff50aa
+model-00091-of-00131.safetensors 1678211256 68d8f46ffcd0ff46f4e73c848525cc6fd6af15eebbb9311ce9b4eb14638f5660
+model-00092-of-00131.safetensors 877983696 91abc087cd244ae62b8469576e209c8e25bc7726bc4fc020b687378059f5b5bd
+model-00093-of-00131.safetensors 1678211256 dacd0f2e5215fbf18fb7c6803f61963333e6243f404de83fcd5dfd38f43fe0d1
+model-00094-of-00131.safetensors 1096796928 cac515a778e89fb37e9f38fde6c8fdfa01ebf9d8944a2d6ff35c51ecf4bc875f
+model-00095-of-00131.safetensors 1678211256 a35975c2d21f18d58f21cb59e4eaf34a4bce11440e5112948e7fa6923658f8c4
+model-00096-of-00131.safetensors 993902176 03fd77f9d35024bba9e894c811300ef8aaf5b5ff99ebc2c89c9d9f87685adfe8
+model-00097-of-00131.safetensors 1678211256 f7b81ae09d97b8e2bb96a1916ede51da92209ec8481a31c56fb446acd691b8a8
+model-00098-of-00131.safetensors 993902176 70f208f47d99c25d5413cd32e0553cce22524cd3863c7797e2cfa37c2d526319
+model-00099-of-00131.safetensors 1678211256 de5c33dd717495657496067ea715442356fd9f7b64384d1a4c10c9f8fe6f9b7d
+model-00100-of-00131.safetensors 877984072 43752e81a5c2b376073d5d0d7b70da8d08c49bdbbfcfeb695ea947a2913e4bc8
+model-00101-of-00131.safetensors 1678211256 c2e978f7238036063914fe909214246730640be77eca215e3cf66d65724de9f1
+model-00102-of-00131.safetensors 1096797160 639efed3ea400a8dddeae25db120096898a514697dfc4cbbc0cd15f621c18421
+model-00103-of-00131.safetensors 1678209208 f8da1b61296e012dc268b4f0d84c127ef0967df488fe65b037f74c8f893decd1
+model-00104-of-00131.safetensors 993901144 adff0f2aee7b7b701e39247cfdfa135c0cab8dfa4f8c7662352c0233adb78829
+model-00105-of-00131.safetensors 1678211256 6643d71382f00f7ffe16b05879e6ff0f6e56986dee8ec079a84aae82912c6987
+model-00106-of-00131.safetensors 1025359600 680495ea0a23e73844e91670437b7b2a5ac5d46f9582923fb7fa91fe640821df
+model-00107-of-00131.safetensors 1678211256 886528d121b77433c1d66654294c13b4f61a004f1e6d1abf2d445fb0a99f7234
+model-00108-of-00131.safetensors 1062060032 a966c28a6267d43052fe87cb19e2e5730bad6154b12eb806b9ce49e007bfec96
+model-00109-of-00131.safetensors 1678211256 f6074252e492ee5b0933f78cc48f3b90694a8096befb7666cc379c3d47093756
+model-00110-of-00131.safetensors 877983696 e3e45e96bc13b52b748a0e2f397a624ad49958396468667d73ed4d725c8b5c1c
+model-00111-of-00131.safetensors 1678211256 d1d354e691eab0b77607faf7eb4adf00a75ee7f270c1cbcbad06aefc19aeac94
+model-00112-of-00131.safetensors 1096797168 e61a9a6ef0e538afca09d97a3ccbf3e7e2c647f65cc8eeebebb18621d7779b02
+model-00113-of-00131.safetensors 1678211256 a14b94db5326bfaab1d8029296b8938f6daf91ba2dc07a4950a38afafa84f776
+model-00114-of-00131.safetensors 993907400 ce4aeac52776038ec0c885915bb270dc65ee07d70d5f71827d5fba1045e2b43b
+model-00115-of-00131.safetensors 1678211256 8185d8822428d2125876a9aa05aea11c8165713bc99e04ace29921eef0e1b683
+model-00116-of-00131.safetensors 993902176 65954dccfa3be20611728311d97679e7f5d78ad519e52312524aa7cf666a48e5
+model-00117-of-00131.safetensors 1678211256 12c8027363b1a7bb782282293314fa57b07be27d17670861858c0aed1e28a3ac
+model-00118-of-00131.safetensors 878004272 2d06ec9c1726f42bfc9ce0bbb47129917d8ab373c88eed4e758fb6940c92ad4a
+model-00119-of-00131.safetensors 1678211256 36008b48c4480085bfd1a81439d70d1029cfaf06cfdd037cec19b491a40659ec
+model-00120-of-00131.safetensors 1109903856 49e4f90d92f60f6489bfe6d3e5250d8fe879c5995ae72ce67379cc7187fa4b0a
+model-00121-of-00131.safetensors 1678209208 ae8e07cceeef2f568df035a7bc0c555656acb566ba5936f61a8a019df23361ad
+model-00122-of-00131.safetensors 993901136 b3b21d33b925e31d475a509757cf7459aa4d3e73cb493706f40461387541e137
+model-00123-of-00131.safetensors 1678209208 f32fec30685afadd76f09bbb1dda680445ad765a97ff1febfc3122b7f73d7ec3
+model-00124-of-00131.safetensors 891089968 e857f36ddd0db135f858c2c87c9fcf39c758965c626b280e47cb0c1e6c1423f8
+model-00125-of-00131.safetensors 1678209208 b9de3774218d3cd7946cdbf913dedfc82591c18212d9c3fc9b9484e7dc68e9fe
+model-00126-of-00131.safetensors 1096795496 29b39319522a00b1ef4ac909c4fb306059999f0a48fd07ca73cea687647631ee
+model-00127-of-00131.safetensors 1678209208 bf48ccb3b4ba75c288d9db2b94817c6a3993e9f84a5b9410d9f24edcec12e177
+model-00128-of-00131.safetensors 993901136 7feaa51c906a1a735e5fb52fd5499b59c473d442d77b44cbd610c9b6a3a9e0ba
+model-00129-of-00131.safetensors 1678209208 a5374c8d86aea48f21a4be2ad6cda37fbfbb01eff333d1179939a2e55d8db816
+model-00130-of-00131.safetensors 2136177320 204b122d02425f61115db9ab896648d95f6dadd6a716c65daf6aec297392ed56
+model-00131-of-00131.safetensors 1271398496 ba6fc69ebb6a9da1938c2e041b8ef625f4550b641812da75845bc7dd7c361d80
+model.safetensors.index.json 17410140 0419e2c2dfbb925257d7409405433a793cf7ff7d96f3eba882a815ec6d9fe7a6
+preprocessor_config.json 390 
+tokenizer.json 12809320 0997f410c57a1f4e53b09e4be8f4a172d90edd9564368fb0847030937229b9f3
+tokenizer_config.json 17928 
+video_preprocessor_config.json 385 
+vocab.json 6722759 

scripts/.AGENTTRASH/20260920-llama-layersplit/frank-medium.env.llamacpp-layersplit

@@ -1,7 +1,7 @@
-# Tunables for frank-medium (ajgazin/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP
-# UD-Q8_K_XL + z-lab/Qwen3.8-27B-DFlash2-GGUF Q8_0 drafter), mainline llama.cpp
-# on Dankserver, 2x AMD Radeon AI PRO R9700 (gfx1201).  Since 2026-09-16 this
-# is the SOLE LLM runtime on the box: the vllm-radiance replica pair and its
+# Tunables for frank-medium (orcarouter/Qwen3.8-27B-Uncensored-GGUF Q8_0 +
+# z-lab/Qwen3.8-27B-DFlash2-GGUF Q4_K_M drafter), mainline llama.cpp on
+# Dankserver, 2x AMD Radeon AI PRO R9700 (gfx1201).  Since 2026-09-16 this is
+# the SOLE LLM runtime on the box: the vllm-radiance replica pair and its
 # routing proxy are retired.
 #
 # Hardware: two R9700 (Navi 48, RDNA4, 32,624 MiB each), no XGMI, different
@@ -31,17 +31,17 @@
 # The ref is pinned by TWO features: DFlash2 (ggml-org/llama.cpp#27342 -- the
 # drafter is detected from its GGUF) and qwen35 MTP.  Do not float it.
 #
-# Model: ajgazin/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF @ UD-Q8_K_XL,
-# 29.29 GiB, arch qwen35, Unsloth Dynamic 3.0 (per-tensor types from Unsloth's
-# own quant of the same size, on Unsloth's importance matrix).  Abliteration is
-# orcarouter's single refusal direction projected out of 131 tensors; the vision
-# tower loads from mmproj-BF16.gguf (see NO_MMPROJ).  The file also
-# carries the model's MTP head (blk.64.nextn.*), so a file-level switch to
-# --spec-type draft-mtp is available without a second copy in VRAM.
+# Model: orcarouter/Qwen3.8-27B-Uncensored-GGUF @ Q8_0, 27.0 GiB, arch qwen35
+# (verified from the GGUF header 2026-09-19: 262144 trained window, 24 heads /
+# 4 KV heads, nextn_predict_layers=1).  The file ALSO carries the model's MTP
+# head (blk.64.nextn.*), so --spec-type draft-mtp is available without a second
+# copy in VRAM -- one SPEC_TYPE change, the drafter below stays on disk.
 #
-# Drafter: z-lab/Qwen3.8-27B-DFlash2-GGUF @ Q8_0, 1.92 GiB: 5 layers, hidden
+# Drafter: z-lab/Qwen3.8-27B-DFlash2-GGUF @ Q4_K_M, 1.06 GiB (operator call
+# 2026-09-19: the Q4 rung -- the drafter's job is throughput, not output
+# quality, and the target verifies every drafted token).  5 layers, hidden
 # 5120, a block-diffusion proposal (block_size 8) under a 2048-token sliding
-# window.  Decoding stays lossless -- the target verifies every drafted token.
+# window (dflash.attention.sliding_window=2048, verified from the header).
 # The window is what makes it cheap HERE: its KV is bounded at 2048 positions
 # (~40 MiB) instead of spanning the context (see SIZING).
 #
@@ -52,10 +52,14 @@
 # in the attention layers only, plus ~0.16 GiB per sequence of f32 DeltaNet
 # state at any depth.
 #
-# SIZING, measured (rocm-smi, 2026-09-16).  Weights split across the two cards;
-# the drafter AND its KV ride the second.  The loader's compute buffers are part
-# of what is seen below -- they are allocated at load, not per request, and they
-# scale with --ubatch-size:
+# SIZING, the deployed shape (32:33 / ctx 327680 / 6144x512 / two slots /
+# DFlash2 Q4_K_M), measured 2026-09-19 after the model swap (rocm-smi):
+#
+#   card 0 (x16)  26.9 GiB used, 5.7 GiB free
+#   card 1 (x1)   27.8 GiB used, 4.8 GiB free
+#
+# The predecessor's measured table (rocm-smi, 2026-09-16, UD-Q8_K_XL target)
+# stays as the calibration history:
 #
 #   CTX     split  batch  slots  drafter  GPU 0 free  GPU 1 free   note (ubatch 1536)
 #   262144   1,1   2048   1      DFlash2   8.64 GiB    4.43 GiB   day's start
@@ -71,7 +75,7 @@
 # batch block below):
 #
 #   262144  36,29  6144   512    2      DFlash2   6.01 GiB    7.32 GiB   ubatch only
-#   262144  35,30  6144   512    2      DFlash2   6.44 GiB    6.90 GiB   <- deployed
+#   262144  35,30  6144   512    2      DFlash2   6.44 GiB    6.90 GiB
 #
 # ONE -ts STEP IS ONE LAYER, AND LAYERS ARE NOT THE SAME SIZE.  This is a hybrid
 # stack -- 16 x (3 Gated DeltaNet + 1 Gated Attention) blocks -- so moving a
@@ -80,36 +84,27 @@
 # were measured, which is why the balance is found by measurement rather than by
 # interpolating between splits.
 #
-# 262144 is the window the model ships (n_ctx_train) and it fits with room, so
-# the fleet gets the whole thing; the arithmetic that used to cap this endpoint
-# at 114688 was the vLLM predecessor's, not this runtime's.  If a future change
-# adds VRAM (a longer drafter, quantized KV, more slots) re-read the numbers
-# rather than assuming, and prefer CTX_SIZE over --gpu-layers.
+# WHY THE SPLIT IS 32:33 (operator call, 2026-09-19).  The operator asked for
+# the tensors BALANCED across the two cards, which for 65 layers is 32:33 --
+# the most even split that exists.  The predecessor's 35:30 skew existed to lean
+# work onto the x16 card (ROCm0), because ROCm1's Gen4 x1 chipset path made it
+# the 98 % utilization bottleneck; the measured trade of the balanced point is
+# that the x1 card runs hotter while the x16 card idles a little more, and the
+# operator accepted that for symmetry.  Do not re-skew without asking.
 #
-# WHY THE SPLIT IS 35:30.  Three effects decide it, and all three are measured:
-#   * THE DRAFTER AND ITS OUTPUT LAYERS RIDE ROCm1.  It carries the drafter's
-#     weights, the draft graph and the last target layers, so it takes fewer
-#     than half the layer count.
-#   * THE UBATCH BUFFERS COST ROCm1 MORE THAN ROCm0, and shrinking them pays
-#     ROCm1 back more: 1536 -> 512 freed 1.30 GiB on ROCm0 but 2.41 GiB on
-#     ROCm1 at this shape.  Read the other way, that is exactly why the smaller
-#     batch moved the balance toward ROCm1 -- and cost ROCm0 one layer.
-#   * THE LAYER GRANULARITY IS THE FLOOR ON HOW WELL ANY SPLIT CAN BALANCE.  One
-#     -ts step is one layer -- ~0.43 GiB DeltaNet, ~1.43 GiB attention -- so the
-#     reachable minimum gap is comparable to one step rather than to zero.  35:30
-#     sits at 0.46 GiB, i.e. one DeltaNet layer's worth, against 1.31 GiB at
-#     36:29.
-# It also leaves the most room: 6.44 / 6.90 GiB free clears the operator's 1.5
-# GiB-per-card floor by ~5 GiB, so no headroom has to be bought out of CTX_SIZE
-# and the full window stays.
+# THE TWO CARDS' PATHS ARE NOT SYMMETRIC (measured, 2026-09-17): ROCm0
+# (03:00.0) hangs off CPU root port 00:01.1 at Gen4 x16 end to end (~31.5 GB/s);
+# ROCm1 (0b:00.0) rides the B650 chipset through bridges that each negotiate
+# Gen4 x1 (~1.97 GB/s).  The layer-split boundary itself is not the cost
+# (~5.2 MB of activation per 512-token ubatch rides the wire); the x1 card is
+# COMPUTE-bound, not PCIe-bound.
 #
 # A FAULT TO WATCH.  A 39:26 split, at 1x batch / 1 slot, died on its eighth
 # request: the amdgpu driver logged SDMA0 UTCL2 page faults and the engine
 # surfaced `ROCm error: an illegal memory access was encountered` -> ggml_abort,
 # i.e. a fault in the cross-card boundary copy, this layer split's hot path.  It
-# has not reproduced (36:29 served this file's verification battery and the e2e
-# gate, and 35:30 is the deployed shape), but the signature is worth recognising
-# -- it is NOT an OOM, and no amount of headroom prevents it.
+# has not reproduced since, but the signature is worth recognising -- it is NOT
+# an OOM, and no amount of headroom prevents it.
 #
 # WARNING: do not name any variable TEMP, HOST, or GPU_MAX_HEAP_SIZE (HIP reads
 # those bare vars; 2026-08-13 incident).  llama.cpp takes --host/--port/--temp
@@ -119,15 +114,15 @@
 LLAMA_BIN=/home/dank/GitPackages/llama.cpp-dflash2/build-rdna4-rocm714/bin/llama-server
 
 # Payload, fetched with scripts/download-frank-medium-gguf.sh.
-MODEL_DIR=/home/dank/models/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF
-MODEL_FILE=Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-UD-Q8_K_XL.gguf
-# The BF16 vision projector, same repo as the target.  llama-server autoloads
-# any mmproj*.gguf beside the model; the serve script refuses to start without
-# it when vision is enabled, so a missing file is a deploy error, not a
-# text-only server that pretends to be multimodal.
-MM_PROJ_FILE=mmproj-BF16.gguf
+MODEL_DIR=/home/dank/models/Qwen3.8-27B-Uncensored-GGUF
+MODEL_FILE=Qwen3.8-27B-Uncensored-Q8_0.gguf
+# The f16 vision projector, same repo as the target.  llama-server loads it via
+# the explicit --mmproj flag (no autoload in this build); the serve script
+# refuses to start without it when vision is enabled, so a missing file is a
+# deploy error, not a text-only server that pretends to be multimodal.
+MM_PROJ_FILE=mmproj-Qwen3.8-27B-Uncensored-f16.gguf
 DRAFT_MODEL_DIR=/home/dank/models/Qwen3.8-27B-DFlash2-GGUF
-DRAFT_MODEL_FILE=Qwen3.8-27B-DFlash2-Q8_0.gguf
+DRAFT_MODEL_FILE=Qwen3.8-27B-DFlash2-Q4_K_M.gguf
 
 # Fleet identity.  7770 is the fleet's dankserver endpoint; the alias is the id
 # at /v1/models and what every client asks for.
@@ -141,17 +136,11 @@ HIP_VISIBLE_DEVICES=0,1
 DEVICES=ROCm0,ROCm1
 SPLIT_MODE=layer
 
-# 36:29 -- one layer over the 35:30 balance, moved to buy headroom on ROCm1,
-# the card that carries the drafter, its KV, the output layers and the heavier
-# compute buffers, now that the context grew to 327680 (see below).  Fit at
-# the deployed point (36:29, ctx 327680, batch 6144 x ubatch 512, two slots,
-# DFlash2 + ngram-mod, mmproj on ROCm0): ROCm0 29.19 / ROCm1 26.04 GiB of
-# 31.86, i.e. 2.67 / 5.82 GiB free and a 3.15 GiB gap BY CONSTRUCTION -- the
-# balance point at this context is 34:31 (0.11 GiB gap) and the operator chose
-# headroom on the drafter card over balance.  See SIZING above for the
-# measurement table; one -ts step is one LAYER, worth ~0.43 GiB (DeltaNet) or
-# ~1.43 GiB (attention), so do not move it without re-measuring.
-TENSOR_SPLIT=36,29
+# 32:33 -- balanced (operator call 2026-09-19): 65 layers split as evenly as
+# they can be, ROCm1 (the last-layers card, which also carries the drafter and
+# the output layers) holding the extra one.  See the WHY THE SPLIT IS 32:33
+# block above for the trade against the predecessor's 35:30 x16-lean.
+TENSOR_SPLIT=32,33
 
 NGL=999
 # Auto-fit has no business resizing a context we set explicitly.
@@ -160,10 +149,9 @@ FLASH_ATTN=on
 
 # 327680 positions over TWO slots, so each conversation gets 163840 --
 # --parallel DIVIDES --ctx-size, so more slots would shrink every
-# conversation rather than grow the cache.  The checkpoint's trained window is
-# 262144 and the GGUF carries NO rope scaling (freq_base 1e7, no YaRN keys),
-# so positions beyond 262144 extrapolate on the base rope: it runs, and 1.25x
-# is a modest ask of it, but the extra 65k is untrained territory.
+# conversation rather than grow the cache.  163840 is inside the checkpoint's
+# trained 262144 window, so the whole pool is trained territory (no rope
+# extrapolation, unlike the predecessor's 393216).
 CTX_SIZE=327680
 PARALLEL=2
 
@@ -211,11 +199,32 @@ THREAD_BATCH=8
 # f16 K/V: an agentic checkpoint is the wrong place to spend KV precision.
 CACHE_TYPE_K=f16
 CACHE_TYPE_V=f16
-# Context checkpoints: 0 is the build's default -- no per-slot KV snapshots, so
-# a re-sent or rewound conversation re-prefills instead of rewinding.  Stated
+# Context checkpoints: 0 -- no per-slot KV snapshots at all.  The build's
+# default is 32 (this binary's --help), so the 0 below is a deliberate
+# deviation, not an inherited default: a checkpoint is a VRAM->host-RAM copy
+# of part of a slot's KV, taken so a partially-matching prompt can be restored
+# instead of re-prefilled.  This endpoint trades that away -- its reuse comes
+# from the slot prompt and from the RAM-side prompt cache below.  Stated
 # explicitly so the tunable stays visible rather than merely absent.
 CTX_CHECKPOINTS=0
-CACHE_RAM=8192
+# PROMPT CACHE, HOST RAM -- this is the one cache tunable that is NOT VRAM.
+# --cache-ram caps the total bytes of saved prompt states
+# (server_prompt_cache, tools/server/server-task.cpp): update() evicts
+# oldest-first past the cap, and alloc() REFUSES outright any single state
+# bigger than the whole cap.  A state is the serialized KV of a whole sequence
+# plus its DeltaNet state plus the draft context's own KV, so at this shape it
+# costs ~68 KiB per token --
+#   16 full-attention layers x 4 kv heads x 256 dim x 2 B x 2 (K,V) = 64 KiB
+#   plus the draft context's window-bounded KV (a ~40 MiB constant for DFlash2)
+# -- which makes the cap a TOKEN budget in disguise: 16384 MiB holds ~240k
+# tokens, i.e. a FULL 163840-token slot (~10.6 GiB) with ~5 GiB of the budget
+# spare for a second entry.
+#
+# The cost is host RAM, allocated on demand and never pinned (plain heap
+# vectors), so no VRAM number above moves.  dankserver has 62 GiB beside the
+# media-stack co-tenants, so the cache is bounded rather than unlimited (-1):
+# the seam test refuses a budget over half the host's RAM.
+CACHE_RAM=16384
 
 # Sampling defaults for requests that send none -- the values the vLLM
 # predecessor served on this endpoint (`--override-generation-config`), so a
@@ -238,35 +247,33 @@ REASONING_BUDGET=-1
 CHAT_TEMPLATE_FILE=
 CHAT_TEMPLATE_KWARGS='{"enable_thinking":true,"preserve_thinking":true}'
 
-# Speculative decoding: the DFlash2 block-diffusion drafter PLUS the draftless
-# n-gram matcher.  DFlash2's GGUF carries block_size 8, so at most 7 draft
-# tokens per verification step (llama.cpp asserts n_max <= block_size - 1).
-# The drafter rides ROCm1, the card that ends up holding the target's last
-# layers.
-SPEC_TYPE=draft-dflash,ngram-mod
+# Speculative decoding: the DFlash2 sidecar (operator call 2026-09-19).  The
+# target file also carries its own MTP head (nextn_predict_layers=1), so
+# draft-mtp is one SPEC_TYPE change away -- the drafter file stays on disk.
+# n_max 7 is the measured DFlash2 winner (see the table below); the drafter
+# rides ROCm1, the card that holds the last layers.
+SPEC_TYPE=draft-dflash
 SPEC_DRAFT_N_MAX=7
 SPEC_DRAFT_NGL=999
 SPEC_DRAFT_DEVICE=ROCm1
 SPEC_DRAFT_TYPE_K=f16
 SPEC_DRAFT_TYPE_V=f16
 
-# MTP (the model's own head) vs the drafter -- MEASURED 2026-09-16 (temperature
-# 0, 1k prompt / 512 out; the autoregressive baseline and both MTP depths were
-# run against the deployed configuration in one session, same binary, same
-# prompts):
+# DFlash2 vs the model's own MTP head -- MEASURED 2026-09-16 on the predecessor
+# payload (temperature 0, 1k prompt / 512 out; the autoregressive baseline and
+# both MTP depths were run in one session, same binary, same prompts):
 #
 #   none            17.7 tok/s                     card1 26.07 GB
 #   draft-mtp  n=3  32.4 tok/s  58 % accepted       card1 29.35 GB
 #   draft-mtp  n=7  26.7 tok/s  33 % accepted       card1 29.65 GB
 #   draft-dflash 7  43.5 tok/s  41 % accepted       card1 29.42 GB
 #
-# All four produced IDENTICAL greedy text, so verification is lossless whichever
-# proposer runs.  DFlash2 is worth 2.46x over autoregressive and 34 % over the
-# best MTP; deeper MTP drafting costs more than it returns (n=7 accepts 33 % of
-# 147 proposals, n=3 accepts 58 % of 72).  The MTP head is not free either:
-# selecting it loads blk.64.nextn.* and adds ~3.3 GB to the card that holds it,
-# against 2.06 GB for the drafter's file.  Do not switch this without
-# re-measuring.
+# All four produced IDENTICAL greedy text, so verification is lossless
+# whichever proposer runs.  DFlash2 is the faster proposer (2.46x over
+# autoregressive, 34 % over the best MTP).  The MTP head adds ~3.3 GB to the
+# card that holds it, against 1.06 GB for the Q4_K_M drafter's file -- at the
+# 327680 pool the drafter's window-bounded KV (~40 MiB) leaves headroom on
+# both cards, so the speed wins.
 #
 # THE TWO CANNOT BE CHAINED. `--spec-type draft-mtp,draft-dflash` dies at load:
 #   context type MTP requested but model doesn't contain MTP layers
@@ -278,16 +285,17 @@ SPEC_DRAFT_TYPE_V=f16
 # tuning question. See serverAppConfigs-docs/LLM/frank-medium-llamacpp-dflash2.md.
 
 # ngram-mod: the draftless n-gram matcher (CPU hash table in host RAM, no VRAM,
-# no model file, no draft context). It joins the chain unconditionally --
+# no model file, no draft context).  It joins the chain unconditionally --
 # unlike MTP, which needs a draft context and therefore cannot share one with
-# DFlash2. Verified on the loaded server: with ngram-mod as the ONLY spec type,
-# a prose prompt produces ZERO drafts (plain autoregressive) while a
-# prompt-echo prompt accepts 100 % of them, so its drafts are unmistakable.
+# DFlash2.  NOT CURRENTLY ACTIVE: SPEC_TYPE is draft-dflash alone, and the serve
+# script only passes --spec-ngram-mod-* when the type contains "ngram".  The
+# window below is retained because the DFlash2 + ngram chain was measured free
+# on prose and 2.6x on prompt-echo -- one SPEC_TYPE change brings it back.
 #
 # WINDOW MEASURED 2026-09-16 (chain at each window, decode tok/s):
 #
 #   n_min/n_max    prose 1k/512   prompt-echo 1.5k/400
-#   48/64          43.9           200.6     <- deployed
+#   48/64          43.9           200.6
 #   16/32          36.0           161.0
 #    8/16          36.2           113.8
 #
@@ -304,9 +312,7 @@ SPEC_NGRAM_N_MATCH=24
 SPEC_NGRAM_N_MIN=48
 SPEC_NGRAM_N_MAX=64
 
-# Vision enabled: llama-server autoloads mmproj-BF16.gguf from MODEL_DIR
-# (888 MiB, lands on ROCm0 -- the fit above charges it there).  frank-small
-# (Dankclaw, RTX 3090) remains the fleet's dedicated image endpoint; this
-# makes frank-medium multimodal too, which is why the seam flips from
-# "text only" to "vision loads with the model".
+# Vision enabled: llama-server loads mmproj-Qwen3.8-27B-Uncensored-f16.gguf
+# (931 MiB, lands on ROCm0 -- the fit charges it there) via the explicit
+# --mmproj flag.  This keeps frank-medium multimodal across the model swap.
 NO_MMPROJ=0

scripts/.AGENTTRASH/20260920-llama-layersplit/serve-frank-medium.sh.llamacpp-layersplit

@@ -161,8 +161,13 @@ TEMPLATE_ARGS+=(--chat-template-kwargs "$CHAT_TEMPLATE_KWARGS")
 PLACEMENT_ARGS=(--device "$DEVICES" --split-mode "$SPLIT_MODE" --tensor-split "$TENSOR_SPLIT")
 
 MMPROJ_ARGS=()
-[[ "$NO_MMPROJ" == "1" ]] && MMPROJ_ARGS=(--no-mmproj)
-
+if [[ "$NO_MMPROJ" == "1" ]]; then
+    MMPROJ_ARGS=(--no-mmproj)
+else
+    # No autoload in this build: a server without the flag starts text-only
+    # and answers image requests with a 500, so name the projector.
+    MMPROJ_ARGS=(--mmproj "$MM_PROJ")
+fi
 exec "$LLAMA_BIN" \
     --model "$MODEL" \
     --alias "$ALIAS" \

scripts/bench-conversation.py

@@ -0,0 +1,269 @@
+#!/usr/bin/env python3
+"""bench-conversation.py — what an endpoint actually feels like, in tokens/s.
+
+The other harnesses here answer engine questions (which batch, which proposer,
+which cache). This one answers the user question: give the same ten jobs to an
+OpenAI-compatible endpoint and report the rate it answers them at. Every job is
+a real conversation turn — system prompt plus one user turn — because that is
+the shape the fleet serves, and it is measured by STREAMING so prefill and
+decode are separated:
+
+  ttft          seconds to the first content delta  -> prefill + queue
+  decode tok/s  completion_tokens / (total - ttft)  -> the rate you read at
+
+Both arms of a comparison must run the SAME prompt bytes, so a per-run salt
+rides in the system prompt: it changes the prompt itself, which is llama.cpp's
+prefix-cache key and vLLM's APC key, so no arm silently inherits a warm cache
+from the one before it. Run one arm, restart the engine, run the next with a
+new salt.
+
+Answers are generated at temperature 0 so arms serving the SAME model can be
+compared for identity as well as speed; different runtimes serving different
+quants legitimately answer differently, which is why the first line of every
+answer is printed.
+
+Usage:
+    bench-conversation.py <base-url> [--model NAME] [--salt TAG]
+                          [--max-tokens N] [--burst N] [--out file.json]
+
+    bench-conversation.py http://127.0.0.1:7770 --model frank-medium --salt L1
+    bench-conversation.py http://127.0.0.1:7770 --model frank-medium --salt R2 --burst 4
+
+One engine at a time: on a single GPU pair there is no room for two copies of a
+27B model, and the benchmarking policy requires the production service to be
+stopped while anything measures.
+"""
+
+import argparse
+import json
+import statistics
+import sys
+import threading
+import time
+import urllib.error
+import urllib.request
+
+# Ten jobs that cover what this fleet is actually asked to do. Ordered roughly
+# by prefill size so a runtime that is good at short prompts and one that is
+# good at long ones cannot hide behind an average.
+SYSTEM = (
+    "You are a staff engineer on a homelab fleet. Be concise and concrete. "
+    "Salt: {salt}"
+)
+
+BATTERY = [
+    ("greet", 128, "Say hello in one sentence."),
+    ("shell", 192, "One bash command: find every file under /home modified in "
+     "the last 2 days, sorted by size, largest first."),
+    ("math", 256, "A train covers 180 km in 1h40m, then 240 km in 2h20m. "
+     "What is the average speed in km/h? Show the arithmetic."),
+    ("json", 384, "Emit exactly 12 JSON records, one per line, no prose, each "
+     'with keys "host", "service", "port" and "up" for hosts dankclaw, '
+     "dankserver and dankware running llama-server, caddy and grafana."),
+    ("review", 512, "Review this function for bugs and name the failure mode:\n"
+     "def rotate(cfg, n):\n    for k in cfg:\n        cfg[k] = cfg[k][n:] + cfg[k][:n]\n"
+     "    return cfg\n"),
+    ("explain", 448, "Explain in four sentences why PCIe atomic operation routing "
+     "matters for GPU collectives, and what fails when a bridge reports "
+     "AtomicOpsCap: Routing-."),
+    ("translate", 256, "Translate to German, then to Japanese, one line each: "
+     "The load balancer refused the connection because the port was still held."),
+    ("plan", 640, "Give a 6-step runbook for swapping the model behind a live "
+     "LLM endpoint on a host that serves real users, with a rollback at each step."),
+    ("debug", 512, "A systemd user service restarts every 10 seconds and its log "
+     "ends with 'Error starting server failed to bind udp listener on 10.89.1.1:53: "
+     "Cannot assign requested address'. What is the root cause and the repair?"),
+    ("longdoc", 512, None),  # filled from LONG_FILES at runtime
+]
+
+# The long-context job reads real repo files so prefill is large and identical
+# across arms (~30k characters).
+LONG_FILES = [
+    "/home/dank/serverAppConfigs/AGENTS.md",
+    "/home/dank/serverAppConfigs/serverAppConfigs-docs/LLM/"
+    "frank-medium-llamacpp-dflash2.md",
+]
+LONG_CHARS = 30_000
+
+
+def long_prompt() -> str:
+    parts = []
+    for path in LONG_FILES:
+        try:
+            with open(path, encoding="utf-8", errors="replace") as handle:
+                parts.append(handle.read())
+        except OSError:
+            continue
+    text = "\n\n".join(parts)[:LONG_CHARS]
+    return ("Using only this document, answer: which deployment shapes for "
+            "two GPUs are ruled out by missing PCIe atomics, and what is the "
+            "one software path that still lets both cards serve one model? "
+            "Cite the measured numbers.\n\n---\n" + text)
+
+
+def stream_chat(base: str, model: str, messages, max_tokens: int, timeout: int):
+    """One streamed chat completion -> (ttft, total, usage, delta_count, text).
+
+    usage is the engine's own {prompt_tokens, completion_tokens}, asked for with
+    stream_options.include_usage.  There is deliberately NO cheap non-streamed
+    pre-probe to learn the prompt length: that probe would populate the prefix
+    cache and turn the measured run's prefill into a cache hit, which is exactly
+    the difference between runtimes this harness is trying to see.
+
+    ttft is None when the engine produced no content delta.
+    """
+    body = {
+        "model": model,
+        "messages": messages,
+        "max_tokens": max_tokens,
+        "temperature": 0,
+        "stream": True,
+        "stream_options": {"include_usage": True},
+    }
+    request = urllib.request.Request(
+        base + "/v1/chat/completions",
+        data=json.dumps(body).encode(),
+        headers={"Content-Type": "application/json"},
+    )
+    start = time.perf_counter()
+    ttft = None
+    deltas = 0
+    usage = {}
+    text = []
+    with urllib.request.urlopen(request, timeout=timeout) as response:
+        for raw in response:
+            line = raw.decode("utf-8", "replace").strip()
+            if not line.startswith("data:"):
+                continue
+            payload = line[5:].strip()
+            if payload == "[DONE]":
+                break
+            try:
+                chunk = json.loads(payload)
+            except json.JSONDecodeError:
+                continue
+            if chunk.get("usage"):
+                usage.update(chunk["usage"])
+            for choice in chunk.get("choices", []):
+                piece = choice.get("delta") or {}
+                # llama.cpp streams thinking as reasoning_content; vLLM's
+                # reasoning parser streams it as reasoning.  Either one is a
+                # generated token, so TTFT must be the first token of ANY kind —
+                # counting only `content` made a thinking-heavy arm look like it
+                # answered instantly (measured 2026-09-20: radiance's geomean
+                # read 994 tok/s with 6 of 10 jobs recorded as "(empty)").
+                content = next((piece[k] for k in ("content", "reasoning",
+                               "reasoning_content") if piece.get(k)), "")
+                if content:
+                    if ttft is None:
+                        ttft = time.perf_counter() - start
+                    deltas += 1
+                    text.append(content)
+    total = time.perf_counter() - start
+    return ttft, total, usage, deltas, "".join(text)
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser()
+    ap.add_argument("base")
+    ap.add_argument("--model", default="frank-medium")
+    ap.add_argument("--salt", default=f"C{int(time.time())}")
+    ap.add_argument("--max-tokens", type=int, default=None)
+    ap.add_argument("--burst", type=int, default=0,
+                    help="also run N concurrent copies of the plan job")
+    ap.add_argument("--timeout", type=int, default=1800)
+    ap.add_argument("--out", default=None)
+    args = ap.parse_args()
+
+    base = args.base.rstrip("/")
+    rows = []
+    print(f"# battery salt={args.salt} model={args.model} base={base}\n")
+    print(f"{'job':<10} {'ptok':>7} {'ctok':>6} {'ttft_s':>8} {'dec_tps':>8} "
+          f"{'total_s':>8}  answer")
+
+    for name, cap, prompt in BATTERY:
+        if prompt is None:
+            prompt = long_prompt()
+        messages = [
+            {"role": "system", "content": SYSTEM.format(salt=args.salt)},
+            {"role": "user", "content": prompt},
+        ]
+        limit = args.max_tokens or cap
+        try:
+            ttft, total, usage, deltas, text = stream_chat(
+                base, args.model, messages, limit, args.timeout)
+        except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError) as exc:
+            print(f"{name:<10} FAILED {exc}")
+            rows.append({"job": name, "error": str(exc)})
+            continue
+        ptok = usage.get("prompt_tokens")
+        ctok = usage.get("completion_tokens") or deltas
+        decode = None
+        if ttft is not None and ctok and total > ttft:
+            decode = (ctok - 1) / (total - ttft)
+        prefill = (ptok / ttft) if (ptok and ttft) else None
+        first = text.strip().splitlines()[0][:48] if text.strip() else "(empty)"
+        print(f"{name:<10} {ptok or 0:>7} {ctok:>6} "
+              f"{(ttft or 0):>8.2f} {(decode or 0):>8.1f} {total:>8.2f}  {first}")
+        rows.append({"job": name, "prompt_tokens": ptok, "completion_tokens": ctok,
+                     "ttft_s": ttft, "decode_tps": decode, "prefill_tps": prefill,
+                     "total_s": total, "answer_head": first})
+
+    good = [r for r in rows if r.get("decode_tps")]
+    if good:
+        rates = [r["decode_tps"] for r in good]
+        ttfts = [r["ttft_s"] for r in good]
+        pre = [r["prefill_tps"] for r in good if r.get("prefill_tps")]
+        print(f"\ngeomean decode  {statistics.geometric_mean(rates):8.1f} tok/s"
+              f"   (min {min(rates):.1f} / max {max(rates):.1f})")
+        print(f"mean ttft       {statistics.mean(ttfts):8.2f} s")
+        if pre:
+            print(f"geomean prefill {statistics.geometric_mean(pre):8.1f} tok/s")
+
+    if args.burst > 1:
+        prompt = next(p for n, _, p in BATTERY if n == "plan")
+        messages = [
+            {"role": "system", "content": SYSTEM.format(salt=args.salt + "B")},
+            {"role": "user", "content": prompt},
+        ]
+        results = []
+        lock = threading.Lock()
+
+        def worker():
+            try:
+                ttft, total, usage, deltas, _ = stream_chat(
+                    base, args.model, messages, 640, args.timeout)
+                ctok = usage.get("completion_tokens") or deltas
+                with lock:
+                    results.append((ttft, total, ctok))
+            except Exception as exc:  # noqa: BLE001 - report, do not abort the burst
+                with lock:
+                    results.append((None, 0.0, str(exc)))
+
+        threads = [threading.Thread(target=worker) for _ in range(args.burst)]
+        t0 = time.perf_counter()
+        for thread in threads:
+            thread.start()
+        for thread in threads:
+            thread.join()
+        wall = time.perf_counter() - t0
+        ok = [r for r in results if r[0] is not None]
+        if ok:
+            tokens = sum(r[2] for r in ok if isinstance(r[2], int))
+            print(f"burst {args.burst}x plan: wall {wall:.1f}s  aggregate "
+                  f"{tokens / wall:.1f} tok/s  "
+                  f"per-stream {statistics.mean([r[2] / r[1] for r in ok]):.1f} tok/s"
+                  f"  mean ttft {statistics.mean([r[0] for r in ok]):.2f}s")
+        else:
+            print(f"burst {args.burst}x plan: all failed: {results[0][2]}")
+
+    if args.out:
+        with open(args.out, "w", encoding="utf-8") as handle:
+            json.dump({"salt": args.salt, "model": args.model, "base": base,
+                       "rows": rows, "burst": args.burst}, handle, indent=1)
+        print(f"wrote {args.out}")
+    return 0 if good else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/build-kairic-edge-gfx1151.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+readonly repo_root="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+readonly ck_root="${KAIRIC_CK_ROOT:-$repo_root/third_party/composable_kernel}"
+readonly ck_commit=fdf4bb7fcc984811cef48ce817d89aac064b984a
+readonly ck_patch="$repo_root/patches/composable-kernel-gfx1151-iu4.patch"
+readonly build_dir="${BUILD_DIR:-$repo_root/build-kairic}"
+readonly rocm="${ROCM_PATH:-/opt/rocm}"
+readonly jobs="${JOBS:-$(nproc)}"
+
+for tool in cmake git ninja; do
+  command -v "$tool" >/dev/null || {
+    echo "missing required tool: $tool" >&2
+    exit 1
+  }
+done
+
+[[ -f "$ck_patch" ]] || {
+  echo "missing Composable Kernel patch: $ck_patch" >&2
+  exit 1
+}
+
+if [[ ! -d "$ck_root/.git" ]]; then
+  mkdir -p "$(dirname -- "$ck_root")"
+  git clone https://github.com/ROCm/composable_kernel.git "$ck_root"
+fi
+
+git -C "$ck_root" checkout "$ck_commit"
+if git -C "$ck_root" diff --quiet; then
+  git -C "$ck_root" apply --check "$ck_patch"
+  git -C "$ck_root" apply "$ck_patch"
+elif git -C "$ck_root" apply --reverse --check "$ck_patch"; then
+  echo "Composable Kernel release patch is already applied"
+else
+  echo "Composable Kernel checkout does not match the pinned patch" >&2
+  exit 1
+fi
+
+if [[ -x "$rocm/bin/amdclang++" ]]; then
+  hip_compiler="$rocm/bin/amdclang++"
+elif [[ -x "$rocm/llvm/bin/clang++" ]]; then
+  hip_compiler="$rocm/llvm/bin/clang++"
+else
+  echo "cannot find a HIP compiler below ROCM_PATH=$rocm" >&2
+  exit 1
+fi
+
+if [[ -n "${CC:-}" ]]; then
+  c_compiler="$(command -v "$CC")"
+elif [[ -x /usr/bin/gcc ]]; then
+  c_compiler=/usr/bin/gcc
+else
+  c_compiler="$(command -v gcc)"
+fi
+if [[ -n "${CXX:-}" ]]; then
+  cxx_compiler="$(command -v "$CXX")"
+elif [[ -x /usr/bin/g++ ]]; then
+  cxx_compiler=/usr/bin/g++
+else
+  cxx_compiler="$(command -v g++)"
+fi
+
+export ROCM_PATH="$rocm"
+export PATH="$rocm/bin:$rocm/lib/llvm/bin:$rocm/llvm/bin:$PATH"
+export LD_LIBRARY_PATH="$rocm/lib:$rocm/lib/rocm_sysdeps/lib:$rocm/lib/llvm/lib:$rocm/llvm/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"
+readonly hip_flags="-DGGML_ROCMFPX_RDNA35_MMID_MAX_BATCH=5 -DGGML_ROCMFPX_MOE_MMVQ_ROWS_PER_BLOCK=4${KAIRIC_HIP_TOOLCHAIN_FLAGS:+ $KAIRIC_HIP_TOOLCHAIN_FLAGS}"
+
+cmake -S "$repo_root" -B "$build_dir" -G Ninja \
+  -DCMAKE_BUILD_TYPE=Release \
+  -DCMAKE_C_COMPILER="$c_compiler" \
+  -DCMAKE_CXX_COMPILER="$cxx_compiler" \
+  -DCMAKE_HIP_COMPILER="$hip_compiler" \
+  -DCMAKE_HIP_FLAGS="$hip_flags" \
+  -DCMAKE_PREFIX_PATH="$rocm" \
+  -DBUILD_SHARED_LIBS=ON \
+  -DGGML_CPU=ON -DGGML_OPENMP=ON -DGGML_HIP=ON -DGGML_CUDA=OFF \
+  -DGGML_VULKAN=OFF -DGGML_HIP_FORCE_MMQ=ON -DGGML_HIP_GRAPHS=ON \
+  -DGGML_HIP_MMQ_MFMA=ON -DGGML_HIP_NO_VMM=ON \
+  -DGGML_HIP_ROCWMMA_FATTN=OFF -DGGML_NATIVE=ON \
+  -DAMDGPU_TARGETS=gfx1151 -DGPU_BUILD_TARGETS=gfx1151 \
+  -DPROMPTFORGE_CK_ROOT="$ck_root" \
+  -DLLAMA_BUILD_WEBUI=OFF \
+  -DGGML_BUILD_TESTS=OFF -DLLAMA_BUILD_TESTS=OFF -DLLAMA_BUILD_SERVER=ON
+
+cmake --build "$build_dir" --target llama-server -j"$jobs"
+
+"$build_dir/bin/llama-server" --version
+"$build_dir/bin/llama-server" --help | grep -A1 -- '--kairic-edge'
+ldd "$build_dir/bin/llama-server" 2>&1 | tee "$build_dir/llama-server.ldd.txt"
+if grep -Eiq 'not found|version .* required by .* not found' "$build_dir/llama-server.ldd.txt"; then
+  echo "runtime dependency verification failed" >&2
+  exit 1
+fi
+
+echo "Kairic Edge runtime built at $build_dir/bin/llama-server"

scripts/build-llama-rdna4.sh

@@ -38,6 +38,7 @@ JOBS="${JOBS:-$(nproc)}"
 ROCM_VERSION="${ROCM_VERSION:-7.14.0a20260624}"
 ROCM_LOCAL_PATH="${ROCM_LOCAL_PATH:-${XDG_DATA_HOME:-$HOME/.local/share}/rocm-${ROCM_VERSION}}"
 HIP_ARCH="${HIP_ARCH:-gfx1201}"
+GGML_HIP_RCCL="${GGML_HIP_RCCL:-OFF}"
 
 # ── Source ────────────────────────────────────────────────────────────
 if [[ ! -d "$LLAMA_SRC/.git" ]]; then
@@ -70,11 +71,13 @@ export ROCM_PATH="$ROCM_LOCAL_PATH"
 export HIP_PATH="$ROCM_LOCAL_PATH"
 
 # ── Configure ─────────────────────────────────────────────────────────
-# GGML_HIP_RCCL stays OFF: this host's second card cannot dispatch a RCCL
-# kernel at all (its PCIe path has no atomic routing), and layer-split serving
-# needs no collectives.  With RCCL off, llama.cpp logs "internal AllReduce init
-# failed ... falling back to meta-backend butterfly" and only --split-mode
-# tensor pays for it.
+# GGML_HIP_RCCL defaults OFF: layer-split serving needs no collectives, and
+# until 2026-09-20 this host's second card could not dispatch a RCCL kernel at
+# all (its PCIe path had no atomic routing).  With RCCL off, llama.cpp logs
+# "internal AllReduce init failed ... falling back to meta-backend butterfly"
+# and only --split-mode row/tensor pays for it.  Set GGML_HIP_RCCL=ON (with a
+# distinct BUILD_DIR) for the collective-backed runtime; the atomics
+# precondition now holds on both cards.
 cmake -S "$LLAMA_SRC" -B "$BUILD_DIR" \
     -G Ninja \
     -DCMAKE_BUILD_TYPE=Release \
@@ -83,7 +86,7 @@ cmake -S "$LLAMA_SRC" -B "$BUILD_DIR" \
     -DCMAKE_CXX_FLAGS="-I${ROCM_LOCAL_PATH}/include" \
     -DCMAKE_POSITION_INDEPENDENT_CODE=ON \
     -DGGML_HIP=ON \
-    -DGGML_HIP_RCCL=OFF \
+    -DGGML_HIP_RCCL="$GGML_HIP_RCCL" \
     -DGGML_CUDA=OFF \
     -DGGML_VULKAN=OFF \
     -DGGML_NATIVE=OFF \
@@ -108,7 +111,7 @@ if command -v patchelf >/dev/null; then
     mkdir -p "$LIB_DIR"
     for pat in libamdhip64 librocblas libhipblas libhipblaslt librocsolver \
                libroctx64 libamd_comgr libhsa-runtime64 librocm_kpack \
-               librocroller librocprofiler-register; do
+               librocroller librocprofiler-register librocm-core; do
         cp -v "$ROCM_LOCAL_PATH/lib/$pat".so* "$LIB_DIR/" 2>/dev/null || true
     done
     cp -v "$ROCM_LOCAL_PATH/lib/llvm/lib"/libLLVM.so* \
@@ -116,6 +119,13 @@ if command -v patchelf >/dev/null; then
           "$ROCM_LOCAL_PATH/lib/llvm/lib"/libomp.so* \
           "$ROCM_LOCAL_PATH/lib/llvm/lib"/libomptarget.so* "$LIB_DIR/" 2>/dev/null || true
     cp -v "$ROCM_LOCAL_PATH/lib/rocm_sysdeps/lib"/librocm_sysdeps_*.so* "$LIB_DIR/" 2>/dev/null || true
+    # A RCCL build links librccl.so.1 (imported shared even with
+    # BUILD_SHARED_LIBS=OFF), and the binaries resolve libraries through
+    # $ORIGIN/../lib — so the collective library must ride beside the rest or
+    # llama-server fails to exec at all.
+    if [[ "$GGML_HIP_RCCL" == "ON" ]]; then
+        cp -v "$ROCM_LOCAL_PATH"/lib/librccl.so* "$LIB_DIR/" 2>/dev/null || true
+    fi
     # rocBLAS and hipBLASLt look for their device code at a FIXED depth under
     # the binary's lib dir: $ORIGIN/../lib/rocblas/library and
     # $ORIGIN/../lib/hipblaslt/library/<arch>. `cp -r SRC DST/` with a missing

scripts/dankserver-route-primary.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# Pin Dankserver's fleet NIC (eno1, 192.168.0.235) as the primary default route.
+#
+# The 2026-09-20 board swap (TUF GAMING B650-E -> ProArt B850-Creator WiFi NEO)
+# brought up a second port, eno2, which took DHCP and — with NetworkManager's
+# default per-connection metric of 100 — came up with metric 101 while eno1's
+# static gateway got 102. Outbound traffic therefore started leaving by eno2
+# even though every fleet peer, Caddy upstream and monitoring target addresses
+# this host as .235. Keep eno2 (it is a real second link) but make it secondary:
+# route metrics decide the default route, so eno1 wins while eno2 stays a
+# failover.
+#
+# Run on Dankserver.  Idempotent; NetworkManager owns these connections (the
+# netplan files under /etc/netplan are its generated shim, so edit via nmcli).
+#
+#   bash scripts/dankserver-route-primary.sh [--check]
+set -euo pipefail
+
+PRIMARY='Wired connection 1'      # eno1, static 192.168.0.235, fleet address
+SECONDARY='Wired connection 2'    # eno2, DHCP 192.168.0.247
+PRIMARY_IF='eno1'
+SECONDARY_IF='eno2'
+PRIMARY_METRIC=100
+SECONDARY_METRIC=200
+
+show() {
+    printf 'routes:\n'; ip route show default
+    printf 'wanted: %s metric %s, %s metric %s\n' \
+        "$PRIMARY" "$PRIMARY_METRIC" "$SECONDARY" "$SECONDARY_METRIC"
+}
+
+if [[ "${1:-}" == '--check' ]]; then
+    for conn in "$PRIMARY" "$SECONDARY"; do
+        printf '%s: ipv4=%s ipv6=%s\n' "$conn" \
+            "$(nmcli -g ipv4.route-metric connection show "$conn")" \
+            "$(nmcli -g ipv6.route-metric connection show "$conn")"
+    done
+    show
+    exit 0
+fi
+
+nmcli connection modify "$PRIMARY" \
+    ipv4.route-metric "$PRIMARY_METRIC" ipv6.route-metric "$PRIMARY_METRIC"
+nmcli connection modify "$SECONDARY" \
+    ipv4.route-metric "$SECONDARY_METRIC" ipv6.route-metric "$SECONDARY_METRIC"
+
+# `nmcli device reapply <ifname>` pushes the edited profile without tearing the
+# link down.  `nmcli connection up` would re-run DHCP and briefly drop the route
+# this session rides on, and `connection reapply` is not a verb (NM 1.54).
+nmcli device reapply "$PRIMARY_IF"
+nmcli device reapply "$SECONDARY_IF"
+
+show
+if [[ "$(ip route show default | head -1)" != *"dev $PRIMARY_IF"* ]]; then
+    printf 'ERROR: eno1 is still not the preferred default route\n' >&2
+    exit 1
+fi
+printf 'eno1 is the preferred default route; eno2 remains up as failover.\n'

scripts/deploy-plan.py

@@ -38,6 +38,7 @@ SERVICE_ORDER = (
     "loki",
     "alloy",
     "node-exporter",
+    "alertmanager",
     "authentik-postgres",
     "authentik-server",
     "authentik-worker",
@@ -51,6 +52,7 @@ SERVICE_ORDER = (
     "copyparty",
     "jellyfin",
     "calibre-web",
+    "calibre-server",
     "plex",
     "tautulli",
     "prowlarr",
@@ -61,7 +63,7 @@ SERVICE_ORDER = (
     "readarr",
     "frank-large",
     "frank-small",
-    "frank-medium",
+    "frank-primary",
 )
 
 DANKCLAW_SERVICES = {
@@ -83,6 +85,7 @@ DANKCLAW_SERVICES = {
     "loki",
     "alloy",
     "node-exporter",
+    "alertmanager",
     "authentik-postgres",
     "authentik-server",
     "authentik-worker",
@@ -101,6 +104,7 @@ DANKSERVER_SERVICES = {
     "copyparty",
     "jellyfin",
     "calibre-web",
+    "calibre-server",
     "plex",
     "tautulli",
     "prowlarr",
@@ -109,7 +113,7 @@ DANKSERVER_SERVICES = {
     "sonarr",
     "lidarr",
     "readarr",
-    "frank-medium",
+    "frank-primary",
     "node-exporter",
 }
 
@@ -246,6 +250,10 @@ def services_for_path(path: str, target: str) -> set[str]:
             _add(services, "searxng")
         elif group == "prometheus":
             _add(services, "prometheus")
+            if len(parts) >= 3 and parts[2] == "alertmanager.yml":
+                # The Alertmanager config ships from this directory: a change
+                # to it must redeploy the service that installs it.
+                _add(services, "alertmanager")
         elif group == "loki":
             _add(services, "loki")
         elif group == "alloy":
@@ -308,11 +316,8 @@ def services_for_path(path: str, target: str) -> set[str]:
         if len(parts) >= 2 and parts[1] == "open-webui":
             _add(services, "open-webui")
             return services
-        if len(parts) >= 2 and parts[1] == "frank-large":
-            # The service is a rootless Quadlet container since 2026-09-11;
-            # its unit and fleet settings live in one .container file.
-            _add(services, "frank-large")
-            return services
+        # frank-large left the quadlet shape on 2026-09-19 (CIRU v4.4.1 host
+        # build, root unit): its files live in scripts/ and map there.
         if len(parts) >= 2 and parts[1] == "observability":
             # The five observability containers became Quadlet units on
             # 2026-09-11. A unit change selects exactly its own service;
@@ -320,7 +325,7 @@ def services_for_path(path: str, target: str) -> set[str]:
             # consumer (prometheus before grafana, loki before alloy).
             if len(parts) >= 4 and parts[2] == "quadlet":
                 name = parts[3].removesuffix(".container")
-                if name in {"prometheus", "grafana", "loki", "alloy", "node-exporter"}:
+                if name in {"prometheus", "grafana", "loki", "alloy", "node-exporter", "alertmanager"}:
                     _add(services, name)
             return services
         if len(parts) >= 2 and parts[1] == "gitea":
@@ -350,6 +355,7 @@ def services_for_path(path: str, target: str) -> set[str]:
                 "romm": {"romm", "romm-mariadb", "romm-redis"},
                 "jellyfin": {"jellyfin"},
                 "calibre-web": {"calibre-web"},
+                "calibre-server": {"calibre-server"},
                 "copyparty": {"copyparty"},
                 "plex": {"plex"},
                 "tautulli": {"tautulli"},
@@ -365,13 +371,11 @@ def services_for_path(path: str, target: str) -> set[str]:
                 if name == "node-exporter":
                     _add(services, "node-exporter")
             return services
-        if len(parts) >= 2 and parts[1] == "frank-medium":
-            # frank-medium is a ROOT llama.cpp unit since 2026-09-16: its
-            # runtime is a native gfx1201 binary, not a container, so there is
-            # nothing under dankserver/frank-medium/ to plan any more. The
-            # retired vllm-radiance quadlets live in .AGENTTRASH/, which is
-            # archive material and plans nothing.
-            return services
+        # frank-primary's quadlet-era directory left the tree on 2026-09-26
+        # (the Lucebox DS4.1 unit was retired for the llama.cpp root unit —
+        # the trio in scripts/ now maps it). Nothing lives under
+        # dankserver/frank-primary/ except dated trash, and trash plans
+        # nothing (the retire rule above the service blocks).
         return services
 
     if parts[0] == "frankbook-pro":
@@ -391,18 +395,37 @@ def services_for_path(path: str, target: str) -> set[str]:
         name = p.name
         if name in {"homepage-status.py", "homepage-status.service", "homepage-status.timer"}:
             _add(services, "homepage")
+        if name in {"signal-relay.py", "signal-relay.service"}:
+            # The Signal relay is installed by the alertmanager deploy, so a
+            # change to it redeploying alertmanager is the only path that
+            # reaches it on the host.
+            _add(services, "alertmanager")
         if name in {"frank-small.env", "frank-small.service", "serve-frank-small.sh"}:
             # llama.cpp frank-small (2026-09-16) keeps its unit, env and serve
             # files here; each one selects frank-small only. The ik_llama.cpp
             # trio that lived here for two days is in scripts/.AGENTTRASH/,
             # which is archive material and plans nothing.
             _add(services, "frank-small")
-        if name in {"frank-medium.env", "frank-medium.service", "serve-frank-medium.sh"}:
-            # llama.cpp frank-medium (2026-09-16) keeps its unit, env and serve
-            # files here the same way. The files that BUILD and FETCH its
-            # runtime and payload are host-side one-offs: they change no
-            # deployed state, so they select nothing.
-            _add(services, "frank-medium")
+        if name in {"frank-large.env", "frank-large.service", "serve-frank-large.sh"}:
+            # CIRU v4.4.1 frank-large (2026-09-19) keeps its unit, env and
+            # serve files here the same way: a root unit on a host-built
+            # runtime. The download script fetches the payload, which is
+            # host-side state, so it selects nothing.
+            _add(services, "frank-large")
+        if name == "qwen-sharp-v22.4.0.jinja":
+            # The Qwen-Sharp chat template frank-large loads via
+            # --chat-template-file. It lived under dankserver/frank-medium/ until
+            # the 2026-09-26 cutover retired that directory; editing it changes
+            # what the live frank-large endpoint renders, so it plans
+            # frank-large.
+            _add(services, "frank-large")
+        if name in {"frank-primary.env", "frank-primary.service", "serve-frank-primary.sh"}:
+            # llama.cpp frank-primary (2026-09-26, replacing the Lucebox
+            # DS4.1 quadlet) keeps its unit, env and serve files here the
+            # same way: a root unit on the unsloth b11030-mix prebuilt
+            # serving Qwen3.8-Flash-Next Q8_0. The download script fetches
+            # the payload, which is host-side state, so it selects nothing.
+            _add(services, "frank-primary")
         # Deployment/test/benchmark scripts and other repo tooling do not
         # restart a runtime service.
         return services
@@ -412,7 +435,6 @@ def services_for_path(path: str, target: str) -> set[str]:
         return services
     return services
 
-
 def changed_paths(repo: str, base: str, head: str) -> list[str]:
     result = subprocess.run(
         ["git", "-C", repo, "diff", "--name-only", "--diff-filter=ACDMRTUXB", base, head],

scripts/deploy-remote.sh

@@ -86,16 +86,16 @@ service_is_allowed() {
         dankclaw:open-webui|dankclaw:gitea-postgres|dankclaw:gitea-server|\
         dankclaw:comfyui|dankclaw:hermes|\
         dankclaw:hermes-dashboard|dankclaw:hermes-webui|dankclaw:prometheus|dankclaw:grafana|\
-        dankclaw:loki|dankclaw:alloy|dankclaw:node-exporter|\
+        dankclaw:loki|dankclaw:alloy|dankclaw:node-exporter|dankclaw:alertmanager|\
         dankclaw:authentik-postgres|dankclaw:authentik-server|\
         dankclaw:authentik-worker|dankclaw:authentik-outpost|dankclaw:authentik-outpost-ldap|dankclaw:anubis|\
         dankclaw:caddy|dankclaw:homepage|dankclaw:seerr|dankclaw:marreta|\
         dankclaw:frank-large|dankclaw:frank-small|\
         dankserver:romm-mariadb|dankserver:romm-redis|dankserver:romm|\
-        dankserver:copyparty|dankserver:jellyfin|dankserver:calibre-web|dankserver:plex|dankserver:tautulli|\
+        dankserver:copyparty|dankserver:jellyfin|dankserver:calibre-web|dankserver:calibre-server|dankserver:plex|dankserver:tautulli|\
         dankserver:prowlarr|dankserver:qbittorrent|dankserver:radarr|\
         dankserver:sonarr|dankserver:lidarr|dankserver:readarr|\
-        dankserver:frank-medium|dankserver:node-exporter|\
+        dankserver:frank-primary|dankserver:node-exporter|\
         frankbook-pro:gluetun|frankbook-pro:qbittorrent|frankbook-pro:prowlarr|\
         frankbook-pro:radarr|frankbook-pro:sonarr|frankbook-pro:lidarr|\
         frankbook-pro:readarr)
@@ -177,6 +177,17 @@ add_pending_services() {
         if [[ "$status" != deployed ]]; then
             # A pending service was intentionally skipped or its handler
             # failed. Retry it even when the checkout has not advanced.
+            # But a pending entry for a service RETIRED from this target can
+            # never be deployable: retrying it fails the whole run before
+            # the e2e gate (the frank-default-sightsound lockout, found
+            # 2026-09-17). Drop such entries into the host trash instead.
+            if ! service_is_allowed "$service"; then
+                local trash="$HOME/.AGENTTRASH/$(date +%Y%m%d)-retired-deploy-state"
+                mkdir -p "$trash"
+                mv -- "$state_file" "$trash/$service"
+                echo "WARN: $service is retired on $TARGET; dropped its stale $status state to $trash" >&2
+                continue
+            fi
             SERVICES+=("$service")
             continue
         fi
@@ -198,6 +209,11 @@ copy_searxng_config() {
     run_privileged mkdir -p /opt/searxng/config
     run_privileged cp shared/searxng/settings.yml /opt/searxng/config/settings.yml
     run_privileged cp shared/searxng/limiter.toml /opt/searxng/config/limiter.toml
+    # Bake ${KAGI_API_KEY}/${SEARXNG_SECRET}/${SEARXNG_BASE_URL} into the live
+    # copy from the host-side /opt/searxng/.env (SearXNG does not expand env
+    # vars in settings.yml). Fails the deploy if a placeholder is unresolvable.
+    run_privileged python3 scripts/searxng-render-settings.py \
+        /opt/searxng/.env /opt/searxng/config/settings.yml
 }
 
 copy_prometheus_config() {
@@ -210,6 +226,53 @@ copy_prometheus_config() {
         /opt/prometheus/config/rules/llm-fleet.yml
 }
 
+# Alertmanager config ships beside the Prometheus config: the two halves of
+# the alerting path change together, and a receiver with no route (or a
+# route with no receiver) fails silently.
+copy_alertmanager_config() {
+    run_privileged mkdir -p /opt/alertmanager/config /opt/alertmanager/data
+    run_privileged cp shared/prometheus/alertmanager.yml /opt/alertmanager/config/alertmanager.yml
+}
+
+# The Signal relay is Alertmanager's only webhook consumer and the only
+# thing on this host that talks to signal-cli. It is a plain systemd USER
+# unit (not a quadlet): it runs python3 from the checkout, so a deploy
+# updates it without a copy step, and — unlike generated quadlet units,
+# which this host's podman 5.x v1 generator rejects — a hand-written user
+# unit can be enabled, and Linger=yes for dank starts it at boot.
+install_signal_relay() {
+    local unit_dir="$HOME/.config/systemd/user"
+    mkdir -p "$unit_dir"
+    cp scripts/signal-relay.service "$unit_dir/signal-relay.service"
+    systemctl --user daemon-reload
+    systemctl --user enable signal-relay.service
+    systemctl --user restart signal-relay.service
+    # The relay binds the host's LAN IP (the one address a bridge container
+    # can reach as host.containers.internal), so keep the unauthenticated
+    # endpoint off the rest of the LAN: admit loopback, the host itself
+    # (its own health probe) and the podman bridge subnet only. Idempotent:
+    # -C before -I.
+    run_privileged iptables -C INPUT -p tcp --dport 18093 -s 127.0.0.1 -j ACCEPT 2>/dev/null \
+        || run_privileged iptables -I INPUT -p tcp --dport 18093 -s 127.0.0.1 -j ACCEPT
+    run_privileged iptables -C INPUT -p tcp --dport 18093 -s 192.168.0.143 -j ACCEPT 2>/dev/null \
+        || run_privileged iptables -I INPUT -p tcp --dport 18093 -s 192.168.0.143 -j ACCEPT
+    run_privileged iptables -C INPUT -p tcp --dport 18093 -s 10.89.0.0/16 -j ACCEPT 2>/dev/null \
+        || run_privileged iptables -I INPUT -p tcp --dport 18093 -s 10.89.0.0/16 -j ACCEPT
+    run_privileged iptables -C INPUT -p tcp --dport 18093 -j DROP 2>/dev/null \
+        || run_privileged iptables -I INPUT -p tcp --dport 18093 -j DROP
+    # The interpreter needs a moment to bind after restart; a one-shot curl
+    # raced the socket on 2026-09-17 and failed a healthy deploy.
+    local i
+    for i in $(seq 1 15); do
+        if curl -fsS -m 5 http://192.168.0.143:18093/health >/dev/null; then
+            return 0
+        fi
+        sleep 1
+    done
+    echo "signal-relay is not answering on 192.168.0.143:18093" >&2
+    return 1
+}
+
 copy_loki_config() {
     run_privileged mkdir -p /opt/loki/config
     run_privileged cp shared/loki/loki-config.yaml /opt/loki/config/loki-config.yaml
@@ -255,7 +318,7 @@ deploy_homepage() {
     fi
     run_privileged mkdir -p /srv/homepage
     run_privileged cp shared/homepage/index.html shared/homepage/admin.html shared/homepage/app.js \
-        shared/homepage/style.css shared/homepage/services.json /srv/homepage/
+        shared/homepage/style.css shared/homepage/services.json shared/homepage/docs.html /srv/homepage/
     if [[ -d shared/homepage/fonts ]]; then
         run_privileged cp -r shared/homepage/fonts /srv/homepage/
     fi
@@ -426,13 +489,17 @@ seed_grafana_env() {
 deploy_observability() {
     local service="$1"
     # Observability units live under <target>/observability/quadlet: Dankclaw
-    # has five, Dankserver one (node-exporter, since 2026-09-16). The config
+    # has six, Dankserver one (node-exporter, since 2026-09-16). The config
     # copies below are Dankclaw-owned state and run only there.
     local unit_dir="$TARGET/observability/quadlet"
     case "$service" in
         prometheus)
             copy_prometheus_config
             ;;
+        alertmanager)
+            copy_alertmanager_config
+            install_signal_relay
+            ;;
         loki)
             copy_loki_config
             build_compose_image loki
@@ -456,6 +523,7 @@ deploy_observability() {
     systemctl --user restart "$service.service"
     case "$service" in
         prometheus) wait_for_health prometheus http://127.0.0.1:9090/-/healthy 60 ;;
+        alertmanager) wait_for_health alertmanager http://127.0.0.1:9093/-/healthy 60 ;;
         grafana) wait_for_health grafana http://127.0.0.1:3002/api/health 90 ;;
         loki) wait_for_health loki http://127.0.0.1:3100/ready 60 ;;
         alloy) wait_for_health alloy http://127.0.0.1:12345/-/healthy 60 ;;
@@ -787,6 +855,50 @@ deploy_calibre_web() {
     systemctl --user restart calibre-web.service
 }
 
+# The content server's single admin account and the desktop's basic-auth
+# credential (same pair) are bootstrapped exactly once: the env file is the
+# plaintext store (mode 600), the userdb's pw column is plaintext too, so
+# its file is mode 600 as well. The password is piped on stdin with printf -
+# a trailing newline from echo lands in the stored password and breaks every
+# login (verified 2026-09-21).
+deploy_calibre_server() {
+    local data_root=/home/dank/Containers/calibre-server
+    mkdir -p "$data_root"
+    if [[ ! -f $data_root/env ]]; then
+        local pw
+        pw=$(openssl rand -base64 18 | tr -d '/+=' | head -c 20)
+        printf 'CUSTOM_USER=calibre\nCUSTOM_PASSWORD=%s\n' "$pw" > "$data_root/env"
+        chmod 600 "$data_root/env"
+        echo "calibre-server: generated credential (shown once): calibre / $pw"
+    fi
+    [[ -f $data_root/env ]] || {
+        echo "FAIL: $data_root/env does not exist; seed it before the first calibre-server deploy" >&2
+        return 1
+    }
+    if [[ ! -f $data_root/userdb.sqlite ]]; then
+        local pw
+        pw=$(grep '^CUSTOM_PASSWORD=' "$data_root/env" | cut -d= -f2)
+        touch "$data_root/userdb.sqlite"
+        printf '%s' "$pw" | podman run --rm -i --entrypoint /usr/bin/calibre-server \
+            -v "$data_root/userdb.sqlite:/userdb.sqlite" \
+            lscr.io/linuxserver/calibre:9.15.0 \
+            --userdb /userdb.sqlite --manage-users -- add calibre
+        chown 1000:1000 "$data_root/userdb.sqlite"
+        chmod 600 "$data_root/userdb.sqlite"
+    fi
+    [[ -f $data_root/userdb.sqlite && -s $data_root/userdb.sqlite ]] || {
+        echo "FAIL: $data_root/userdb.sqlite missing or empty; the --manage-users bootstrap failed" >&2
+        return 1
+    }
+    cp "dankserver/calibre-server/quadlet/calibre-server.container" "$quadlet_unit_dir/"
+    systemctl --user daemon-reload
+    if ! systemctl --user is-active -q calibre-server.service; then
+        podman stop calibre-server 2>/dev/null || true
+        podman rm calibre-server 2>/dev/null || true
+    fi
+    systemctl --user restart calibre-server.service
+}
+
 deploy_copyparty() {
     # The admin account is created from ${COPAY_ACCOUNT}:${COPAY_PASSWORD} expanded
     # at ExecStart time; a missing env file must fail the unit, not boot copyparty
@@ -965,41 +1077,30 @@ deploy_anubis() {
     wait_container_healthy anubis 60 || return 1
 }
 
-# frank-large runs as a rootless Quadlet unit again since 2026-09-16: the
-# halogen-flash-server runtime is back (it replaced ik_llama.cpp, which had
-# replaced it), and the RTX 3090 it shared during that interlude now belongs
-# to frank-small.
+# frank-large is the stock llama.cpp prebuilt (unsloth b11030, ROCm
+# gfx1151) serving unsloth/Qwen3.8-27B-GGUF:UD-Q8_K_XL with the DFlash2
+# drafter (z-lab/Qwen3.8-27B-DFlash2-GGUF:Q4_K_M) on the Strix Halo iGPU,
+# as a ROOT unit since the 2026-09-19 cutover: the runtime is a prebuilt
+# binary, so there is no container image to install and no generated unit
+# to dodge. relink_unit points /etc/systemd/system/frank-large.service at
+# the repo file and boot persistence is that unit's [Install] section.
 #
-# TWO MANAGERS, ONE UNIT NAME. The ik incarnation ran as a ROOT unit whose
-# file is a symlink into this checkout; the halogen unit is a USER (quadlet)
-# unit. Both must never exist at once — they would race for port 7770 — so the
-# root unit is retired first: stop, disable, move the /etc symlink into the
-# home trash (never `rm`), reload the root manager. This host's `systemctl
-# disable` has been observed to delete the unit file itself (2026-08-26
-# incident), so the move tolerates a file that is already gone.
-#
-# FIRST START fetches ~127 GB of weights, and /health cannot answer while it
-# does. wait_for_llm_large_ready recognises that (checkpoint absent) and waits
-# for the file instead of burning the health budget on a failure that is not
-# one.
-LLM_LARGE_CHECKPOINT="${LLM_LARGE_CHECKPOINT:-/home/dank/models/halogen/qwen38-flash-next-w4b.hgn}"
+# It replaces the Kairic Edge runtime (ciru-ai/ROCmFPX), which had
+# replaced the unsloth llama.cpp prebuilt serving
+# unsloth/Qwen3.8-Flash-Next-GGUF:UD-IQ4_XS. The port gate is the same as
+# every cutover since 2026-09-16: nothing starts until 7770 is released.
+LLM_LARGE_MODEL="${LLM_LARGE_MODEL:-/home/dank/models/Qwen3.8-27B-UD-Q8_K_XL/Qwen3.8-27B-UD-Q8_K_XL.gguf}"
+LLM_LARGE_DRAFT="${LLM_LARGE_DRAFT:-/home/dank/models/Qwen3.8-27B-UD-Q8_K_XL/Qwen3.8-27B-DFlash2-Q4_K_M.gguf}"
 
-retire_root_llm_large() {
-    local trash="$HOME/.AGENTTRASH/20260916-halogen-restore/host-units"
-    run_privileged systemctl stop frank-large.service 2>/dev/null || true
-    run_privileged systemctl disable frank-large.service 2>/dev/null || true
-    if [[ -e /etc/systemd/system/frank-large.service || -L /etc/systemd/system/frank-large.service ]]; then
+retire_halogen_large_quadlet() {
+    local trash="$HOME/.AGENTTRASH/20260919-orca-cutover/quadlet"
+    systemctl --user stop frank-large.service 2>/dev/null || true
+    if [[ -e "$quadlet_unit_dir/frank-large.container" ]]; then
         mkdir -p "$trash"
-        run_privileged mv -- /etc/systemd/system/frank-large.service \
-            "$trash/frank-large.service"
-        echo "retired root unit frank-large.service -> $trash"
-    else
-        # This host's `systemctl disable` is allowed to delete the unit file
-        # outright (2026-08-26 incident), so there is often nothing left to
-        # move. Say so: previously no message meant no evidence either way.
-        echo "root unit frank-large.service was already removed by disable"
+        mv -- "$quadlet_unit_dir/frank-large.container" "$trash/frank-large.container"
+        echo "retired quadlet frank-large.container -> $trash"
     fi
-    run_privileged systemctl daemon-reload
+    systemctl --user daemon-reload
 }
 
 # Wait until a TCP port has no socket on it at all -- listening, accepted, or
@@ -1022,58 +1123,40 @@ wait_port_free() {
 }
 
 deploy_llm_large() {
-    retire_root_llm_large
-    # The predecessor can also be THIS quadlet -- a redeploy of a running
-    # frank-large -- so stop the user unit before waiting on the port. On a
-    # first cutover it is not running and this is a no-op.
-    systemctl --user stop frank-large.service 2>/dev/null || true
-    # Pull once, then run the localhost/-aliased tag: this host's quadlet path
-    # cannot resolve registry-prefixed refs from local storage at create time
-    # (same workaround as anubis/hermes), and Pull=never keeps boots off the
-    # registry.
-    local image="ghcr.io/peonist-ai/halogen-flash-server:0.5.8"
-    local alias="localhost/peonist-ai/halogen-flash-server:0.5.8"
-    podman pull "$image"
-    podman tag "$image" "$alias"
-    # The weights volume must exist, and the container needs it read-write:
-    # that is where a first start downloads into.
-    mkdir -p /home/dank/models/halogen
-    # Nothing may start until the predecessor has released the port. On
-    # 2026-09-16 this sequence failed exactly here: the ik server logged
-    # "Deactivated successfully", pasta tried to bind 7770 a second later and
-    # reported "Address already in use", and the unit exited 126. Restart=
-    # on-failure recovered it minutes later, but a deploy that starts a doomed
-    # container has not deployed anything -- so gate on the port, not on hope.
-    wait_port_free 7770 || return 1
-    install_quadlet frank-large dankclaw/frank-large/quadlet frank-large
-    # No enable: generated units cannot be enabled on this host (v1 quadlet
-    # generator); boot persistence comes from [Install] in the unit file.
-    systemctl --user restart frank-large.service
-    wait_for_llm_large_ready
-    wait_for_health frank-large http://127.0.0.1:7770/health 1200
-}
-
-# Bootstrap-aware gate: if the checkpoint is absent the container is fetching
-# it; wait for the file (the fetch resumes, and the unit restarts it on
-# failure) rather than gating on a /health that cannot answer yet. Reports
-# success either way, so a first deploy does not look like a failure while the
-# engine does exactly what it was told to.
-wait_for_llm_large_ready() {
-    [[ -f "$LLM_LARGE_CHECKPOINT" ]] && return 0
-    echo "frank-large: checkpoint absent at $LLM_LARGE_CHECKPOINT"
-    echo "frank-large: first start — the container is downloading ~127 GB from"
-    echo "frank-large: peonist-ai/halogen-qwen3.8-flash-next (resumes if interrupted)."
-    local i
-    for ((i = 1; i <= 1200; i++)); do
-        if [[ -f "$LLM_LARGE_CHECKPOINT" ]]; then
-            echo "frank-large: weights landed after approximately $((i * 2))s; gating on /health"
-            return 0
+    # Refuse rather than restart-loop. A unit whose runtime or payload is
+    # missing never becomes healthy, and a green deploy would leave the
+    # endpoint dark with nothing in the deploy log to say why.
+    local missing=0 f
+    for f in "$LLM_LARGE_MODEL" "$LLM_LARGE_DRAFT"; do
+        if [[ ! -f "$f" ]]; then
+            echo "ERROR: payload absent at $f" >&2
+            echo "frank-large: fetch it: bash scripts/download-frank-large.sh" >&2
+            missing=1
         fi
-        sleep 2
     done
-    echo "WARN: frank-large download still in progress after 40m — NOT a failure." >&2
-    echo "WARN: the unit keeps fetching; re-run this deploy (or re-check /health) later." >&2
-    return 0
+    [[ "$missing" -eq 0 ]] || return 1
+
+    retire_halogen_large_quadlet
+    # On a re-deploy the predecessor is THIS unit: stop it before waiting on
+    # the port, or the wait deadlocks on the server it just stopped serving.
+    # Then sweep a stray manual run of the SAME model -- that is how a bench
+    # harness leaves the port busy. Match the model path, not the binary name:
+    # frank-small on this host is also a llama-server and must not be killed.
+    # The pattern never appears in the deploying shell's own command line, so
+    # -f is safe here (it is not in `bash deploy-remote.sh`).
+    run_privileged systemctl stop frank-large.service 2>/dev/null || true
+    pkill -f 'Qwen3.8-27B-UD-Q8_K_XL' 2>/dev/null || true
+    # Nothing may start until the predecessor has released the port. On
+    # 2026-09-16 the cutover failed exactly here: the old server logged
+    # "Deactivated successfully", the next engine tried to bind 7770 a second
+    # later and reported "Address already in use". Gate on the port, not on
+    # hope.
+    wait_port_free 7770 || return 1
+    relink_unit frank-large
+    run_privileged systemctl daemon-reload
+    run_privileged systemctl enable frank-large.service
+    run_privileged systemctl restart frank-large.service
+    wait_for_health frank-large http://127.0.0.1:7770/health 1200
 }
 
 # deploy_llm_small — frank-small is mainline llama.cpp on the RTX 3090, as a
@@ -1083,13 +1166,13 @@ wait_for_llm_large_ready() {
 # is that unit's [Install] section.
 #
 # It is a SEPARATE endpoint on port 7771; frank-large keeps 7770. The 3090 is
-# not shared: frank-large's halogen engine runs on the gfx1151 iGPU.
-LLM_SMALL_MODEL="${LLM_SMALL_MODEL:-/home/dank/models/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp.gguf}"
+# not shared: frank-large's engine runs on the gfx1151 iGPU.
+LLM_SMALL_MODEL="${LLM_SMALL_MODEL:-/home/dank/models/Gemma4-12B-QAT/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-Q4_K_M.gguf}"
 
 deploy_llm_small() {
     if [[ ! -f "$LLM_SMALL_MODEL" ]]; then
         echo "ERROR: model absent at $LLM_SMALL_MODEL" >&2
-        echo "frank-small: fetch ISTA-DASLab/Qwen3.8-27B-GSQ-RCO-GGUF (the -mtp build plus the mmproj) first;" >&2
+        echo "frank-small: fetch HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced (Q4_K_M, the mmproj and the MTP sidecar) first;" >&2
         echo "frank-small: refusing to start a unit that cannot load." >&2
         return 1
     fi
@@ -1100,88 +1183,108 @@ deploy_llm_small() {
     wait_for_health frank-small http://127.0.0.1:7771/health 900
 }
 
-# deploy_llm_medium — frank-medium is mainline llama.cpp on the two R9700s as a
-# ROOT unit since the 2026-09-16 cutover: the runtime is a native gfx1201 HIP
-# binary, so there is no image to install and no generated unit to dodge. It
-# replaces the vllm-radiance replica pair + routing proxy, which held this
-# endpoint for a day and could never use both cards for one model (TP=2 needs
-# an RCCL collective, and the second card cannot dispatch one).
+# deploy_llm_primary — frank-primary is the R9V radiance-vLLM fork (docker-
+# pinned prebuilt, gfx1201, driven through the docker->podman shim) serving
+# the unsloth Qwen3.8-Flash-Next Q8_0 payload (6 GGUF shards) with the MTP4
+# drafter on the two R9700s as a ROOT unit whose serve script execs the
+# fork's launcher through rootless podman as dank. Same port and alias as
+# the endpoints it replaced (the 2026-09-27 cutover from uncensored
+# IQ4_XS); the harness models.yml id is unchanged. The uncensored state dir
+# (/home/dank/r9v-state/uncensored) stays on disk as the rollback target.
 #
-# Layer split in ONE process is what the successor does instead: layers are
-# distributed across the cards and only the activation at the boundary crosses
-# PCIe, once per forward pass. That is the "pipeline parallelism" the endpoint
-# wanted, with no collective anywhere in it.
-LLM_MEDIUM_BIN="${LLM_MEDIUM_BIN:-/home/dank/GitPackages/llama.cpp-dflash2/build-rdna4-rocm714/bin/llama-server}"
-LLM_MEDIUM_MODEL="${LLM_MEDIUM_MODEL:-/home/dank/models/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-UD-Q8_K_XL.gguf}"
-LLM_MEDIUM_DRAFT="${LLM_MEDIUM_DRAFT:-/home/dank/models/Qwen3.8-27B-DFlash2-GGUF/Qwen3.8-27B-DFlash2-Q8_0.gguf}"
-LLM_MEDIUM_MMPROJ="${LLM_MEDIUM_MMPROJ:-/home/dank/models/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF/mmproj-BF16.gguf}"
+# Gates: the on-host R9V setup state must exist and be ready (it carries the
+# pinned image digest and every payload path), the pinned runtime image must
+# be loadable from dank's rootless storage by its OCI manifest digest, the
+# PLE payload must match its pinned byte count, and every GGUF shard + the
+# mmproj must exist (per-file sha256 verification was setup's job at fetch
+# time, never re-hashed here).
+LLM_PRIMARY_STATE=/home/dank/r9v-state/q8xl/setup.json
+LLM_PRIMARY_CONTAINER=frank-primary-r9v
 
-# The three vLLM user units are retired HERE, not left to rot: the proxy
-# published 7770 on the host network, so the llama-server below cannot bind
-# until they are stopped and the port is released. Never `rm` — the unit files
-# move into the home trash; the images stay in local storage.
-retire_vllm_medium_quadlets() {
-    local trash="$HOME/.AGENTTRASH/20260916-vllm-radiance-retire" unit
-    systemctl --user stop frank-medium-a.service frank-medium-b.service \
-        frank-medium-proxy.service 2>/dev/null || true
-    for unit in frank-medium-a frank-medium-b frank-medium-proxy frank-medium; do
-        if [[ -e "$quadlet_unit_dir/$unit.container" ]]; then
-            mkdir -p "$trash"
-            mv -- "$quadlet_unit_dir/$unit.container" "$trash/$unit.container"
-            echo "retired quadlet $unit.container -> $trash"
+deploy_llm_primary() {
+    # Refuse rather than restart-loop: a unit whose image or payload is
+    # missing never becomes healthy, and a green deploy would leave the
+    # endpoint dark with nothing in the log to say why.
+    if [[ ! -f "$LLM_PRIMARY_STATE" ]]; then
+        echo "ERROR: R9V setup state absent: $LLM_PRIMARY_STATE" >&2
+        echo "frank-primary: run the profile setup on this host first" >&2
+        return 1
+    fi
+    local state_json image_digest model_dir ple_path ple_bytes
+    state_exports="$(python3 - "$LLM_PRIMARY_STATE" <<'PY'
+import json, shlex, sys
+state = json.load(open(sys.argv[1]))
+config = state.get("config") or {}
+if state.get("ready") is not True:
+    sys.exit("R9V setup state is not ready")
+for key in ("R9V_IMAGE", "R9V_MODEL_DIR", "R9V_PLE_PATH", "R9V_PLE_EXPECTED_BYTES",
+            "R9V_TARGET_REL", "R9V_TARGET_SHARD2_REL", "R9V_TARGET_SHARD3_REL",
+            "R9V_TARGET_SHARD4_REL", "R9V_TARGET_SHARD5_REL", "R9V_TARGET_SHARD6_REL",
+            "R9V_MMPROJ_REL"):
+    print(f"{key}={shlex.quote(config.get(key, ''))}")
+PY
+)" || return 1
+    eval "$state_exports"
+    if [[ -z "$R9V_IMAGE" || -z "$R9V_MODEL_DIR" || -z "$R9V_PLE_PATH" ]]; then
+        echo "ERROR: R9V setup state is missing image/model/PLE paths" >&2
+        return 1
+    fi
+    if ! podman images --format '{{.RepoDigests}}' | grep -qF "${R9V_IMAGE#sha256:}"; then
+        echo "ERROR: pinned R9V runtime image absent from rootless storage: $R9V_IMAGE" >&2
+        echo "frank-primary: load the image bundle (./r9v setup ...)" >&2
+        return 1
+    fi
+    if [[ -n "$R9V_PLE_EXPECTED_BYTES" ]]; then
+        ple_bytes="$(stat -c %s "$R9V_PLE_PATH" 2>/dev/null || echo 0)"
+        if [[ "$ple_bytes" != "$R9V_PLE_EXPECTED_BYTES" ]]; then
+            echo "ERROR: PLE payload wrong size: $R9V_PLE_PATH (expected $R9V_PLE_EXPECTED_BYTES, found $ple_bytes)" >&2
+            echo "frank-primary: re-run the PLE derivation (./r9v setup ...)" >&2
+            return 1
+        fi
+    fi
+    local rel
+    for rel in "$R9V_TARGET_REL" "${R9V_TARGET_SHARD2_REL:-}" "${R9V_TARGET_SHARD3_REL:-}" \
+        "${R9V_TARGET_SHARD4_REL:-}" "${R9V_TARGET_SHARD5_REL:-}" "${R9V_TARGET_SHARD6_REL:-}" \
+        "$R9V_MMPROJ_REL"; do
+        [[ -z "$rel" ]] && continue
+        if [[ ! -f "$R9V_MODEL_DIR/$rel" ]]; then
+            echo "ERROR: payload file missing: $R9V_MODEL_DIR/$rel" >&2
+            echo "frank-primary: re-run the profile setup to fetch/verify the payload" >&2
+            return 1
         fi
     done
-    systemctl --user daemon-reload
-}
 
-deploy_llm_medium() {
-    # Refuse rather than restart-loop. A unit whose runtime or payload is
-    # missing never becomes healthy, and a green deploy would leave the
-    # endpoint dark with nothing in the deploy log to say why.
-    local missing=0
-    if [[ ! -x "$LLM_MEDIUM_BIN" ]]; then
-        echo "ERROR: llama-server absent at $LLM_MEDIUM_BIN" >&2
-        echo "frank-medium: build it ON the host (gfx1201): bash scripts/build-llama-rdna4.sh" >&2
-        missing=1
-    fi
-    if [[ ! -f "$LLM_MEDIUM_MODEL" ]]; then
-        echo "ERROR: target model absent at $LLM_MEDIUM_MODEL" >&2
-        echo "frank-medium: fetch it: bash scripts/download-frank-medium-gguf.sh" >&2
-        missing=1
-    fi
-    if [[ ! -f "$LLM_MEDIUM_DRAFT" ]]; then
-        echo "ERROR: DFlash2 drafter absent at $LLM_MEDIUM_DRAFT" >&2
-        echo "frank-medium: fetch it: bash scripts/download-frank-medium-gguf.sh" >&2
-        missing=1
-    fi
-    if [[ ! -f "$LLM_MEDIUM_MMPROJ" ]]; then
-        echo "ERROR: vision projector absent at $LLM_MEDIUM_MMPROJ" >&2
-        echo "frank-medium: fetch it: bash scripts/download-frank-medium-gguf.sh" >&2
-        missing=1
-    fi
-    [[ "$missing" -eq 0 ]] || return 1
-
-    retire_vllm_medium_quadlets
-    # The thing holding 7770 is now THIS service: on a re-deploy the previous
-    # llama-server is still bound to it, so waiting for the port without
-    # stopping the unit deadlocks the deploy (measured 2026-09-16: "FAIL: port
-    # 7770 is still held after 90s", with the old server happily serving a
-    # scrape). Stop the unit first, then sweep a stray manual run of the same
-    # binary -- that is how a benchmark harness leaves the port busy. `pkill -x
-    # llama-server` matches the process name exactly and can never match the
-    # deploying shell; never `pkill -f` here.
-    run_privileged systemctl stop frank-medium.service 2>/dev/null || true
-    pkill -x llama-server 2>/dev/null || true
-    sleep 2
-    # pasta released the retired proxy's socket at container teardown, and a
-    # stopped engine lingers in TIME_WAIT just past that. Same gate as
-    # frank-large's cutover (2026-09-16 addressed-in-use failure).
+    # A stale container with the same name makes `podman run --name` fail at
+    # start; remove any leftover from a failed previous attempt.
+    podman rm -f "$LLM_PRIMARY_CONTAINER" >/dev/null 2>&1 || true
+    # A stopped unit can leave its container running: systemd's cgroup kill
+    # races conmon's --rm cleanup, and the orphan holds the port and GPUs.
+    # Stop the unit, then remove the container BEFORE waiting on the port.
+    run_privileged systemctl stop frank-primary.service 2>/dev/null || true
+    podman rm -f "$LLM_PRIMARY_CONTAINER" >/dev/null 2>&1 || true
+    # Nothing starts until the port is released: the lucebox cutover
+    # (2026-09-26) and the frank-large cutover (2026-09-16) both failed
+    # exactly here when the next engine bound 7770 a second too early.
     wait_port_free 7770 || return 1
-    relink_unit frank-medium
+    relink_unit frank-primary
     run_privileged systemctl daemon-reload
-    run_privileged systemctl enable frank-medium.service
-    run_privileged systemctl restart frank-medium.service
-    wait_for_health frank-medium http://127.0.0.1:7770/health 900
+    run_privileged systemctl enable frank-primary.service
+    run_privileged systemctl restart frank-primary.service
+    # Cold start: the launcher's preflight doctor plus payload page-in
+    # (~93 GiB cold; expert cache fills after /health). Parity with every
+    # predecessor on this port.
+    wait_for_health frank-primary http://127.0.0.1:7770/health 1800 || return 1
+    # False-green hardening (the 2026-09-26 lesson): a bare curl against the
+    # port cannot tell WHO answers — a stray probe holding :7770 satisfies
+    # it while the unit is stopped. The deploy is only green if the unit
+    # itself is active with a live MainPID behind the health answer.
+    local main_pid
+    main_pid="$(run_privileged systemctl show -p MainPID --value frank-primary.service)"
+    if [[ -z "$main_pid" || "$main_pid" == "0" ]]; then
+        echo "FAIL: :7770 answered but frank-primary.service has no MainPID — a stray process holds the port" >&2
+        return 1
+    fi
+    echo "frank-primary: health answered by unit MainPID $main_pid"
 }
 
 wait_for_health() {
@@ -1370,15 +1473,16 @@ deploy_service() {
         marreta) deploy_marreta ;;
         frank-large) deploy_llm_large ;;
         frank-small) deploy_llm_small ;;
-        frank-medium) deploy_llm_medium ;;
+        frank-primary) deploy_llm_primary ;;
         hermes|hermes-dashboard|hermes-webui) deploy_hermes ;;
         romm|romm-mariadb|romm-redis|mariadb|redis) deploy_romm_stack "$service" ;;
         jellyfin) deploy_jellyfin ;;
         calibre-web) deploy_calibre_web ;;
+        calibre-server) deploy_calibre_server ;;
         copyparty) deploy_copyparty ;;
         plex) deploy_plex ;;
         tautulli) deploy_tautulli ;;
-        prometheus|grafana|loki|alloy|node-exporter) deploy_observability "$service" ;;
+        prometheus|grafana|loki|alloy|node-exporter|alertmanager) deploy_observability "$service" ;;
         comfyui) deploy_comfyui ;;
         *) deploy_compose_service "$service" ;;
     esac

scripts/deploy.sh

@@ -35,7 +35,7 @@ Options:
 Examples:
   ./scripts/deploy.sh dankclaw
   ./scripts/deploy.sh dankclaw --service searxng
-  ./scripts/deploy.sh dankserver --service frank-medium
+  ./scripts/deploy.sh dankserver --service frank-primary
   ./scripts/deploy.sh dankclaw --dry-run
 EOF
 }
@@ -138,14 +138,15 @@ valid_service() {
         dankclaw:gitea-server|dankclaw:homepage|\
         dankclaw:comfyui|dankclaw:hermes|dankclaw:hermes-dashboard|\
         dankclaw:hermes-webui|dankclaw:prometheus|dankclaw:grafana|dankclaw:loki|dankclaw:alloy|\
+        dankclaw:alertmanager|\
         dankclaw:node-exporter|dankclaw:authentik-postgres|dankclaw:authentik-server|\
         dankclaw:authentik-worker|dankclaw:authentik-outpost|dankclaw:authentik-outpost-ldap|dankclaw:anubis|dankclaw:seerr|\
         dankclaw:frank-large|dankclaw:frank-small|\
         dankserver:romm-mariadb|dankserver:romm-redis|dankserver:romm|\
-        dankserver:copyparty|dankserver:jellyfin|dankserver:calibre-web|dankserver:plex|dankserver:tautulli|\
+        dankserver:copyparty|dankserver:jellyfin|dankserver:calibre-web|dankserver:calibre-server|dankserver:plex|dankserver:tautulli|\
         dankserver:qbittorrent|dankserver:radarr|dankserver:sonarr|\
         dankserver:lidarr|dankserver:readarr|dankserver:node-exporter|\
-        dankserver:frank-medium|\
+        dankserver:frank-primary|\
         frankbook-pro:gluetun|frankbook-pro:qbittorrent|frankbook-pro:prowlarr|\
         frankbook-pro:radarr|frankbook-pro:sonarr|frankbook-pro:lidarr|\
         frankbook-pro:readarr)

scripts/download-frank-large-orca.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# Download and assemble jcbtc/Qwen3.8-Flash-CIRU-STRIX-Orca (the frank-large
+# model) on Dankclaw.
+#
+#   bash scripts/download-frank-large-orca.sh
+#   bash scripts/download-frank-large-orca.sh --verify-only
+#
+# The package is 136 GB of Hub-sized transport parts (HF caps new uploads at
+# 50 GB, so the 79 GB main GGUF, the 52 GB PLE payload and the 4 GB MTP head
+# ship as .partNofM fragments).  assemble.py (from the repo) concatenates the
+# parts, verifies every part and final SHA-256, and consumes the parts.
+#
+# Integrity: every part is checked against the per-part sha256 in parts.json
+# (fetched from the repo, not trusted from disk), then the assembled files
+# against SHA256SUMS.  The repo is public (gated: false); an HF token at
+# ~/.cache/huggingface/token is used when present to clear the anonymous
+# rate limit on a 136 GB transfer.
+#
+# Layout after a successful run (MODEL_DIR):
+#   Qwen3.8-Flash-CIRU-STRIX-Orca.gguf          79,397,818,912  main model
+#   mtp/Qwen3.8-Flash-CIRU-STRIX-Orca-MTP-Q8_0.gguf  4,135,893,440  draft
+#   ple/ple.payload.bin                         52,429,053,952  external PLE
+#   ple/ple.manifest.json, ple/ple.scale.bf16               PLE metadata
+#   vision/mmproj-Qwen3.8-Flash-Orca-F16.mmproj  904,004,320    projector
+#   assemble.py, parts.json, SHA256SUMS                     (kept for --verify-only)
+set -euo pipefail
+
+REPO="jcbtc/Qwen3.8-Flash-CIRU-STRIX-Orca"
+MODEL_DIR="/home/dank/models/Qwen3.8-Flash-CIRU-STRIX-Orca"
+BASE="https://huggingface.co/$REPO/resolve/main"
+
+mode="download"
+[[ "${1:-}" == "--verify-only" ]] && mode="verify"
+
+token=""
+auth=()
+if [[ -r "$HOME/.cache/huggingface/token" ]]; then
+    token="$(cat "$HOME/.cache/huggingface/token")"
+    auth=(-H "Authorization: Bearer $token")
+else
+    echo "no HF token at ~/.cache/huggingface/token; downloading anonymously"
+fi
+
+dl() { # dl <relpath>
+    local dest="$MODEL_DIR/$1"
+    mkdir -p "$(dirname "$dest")"
+    echo "  fetching $1"
+    curl -fL -C - -o "$dest" --retry 10 --retry-delay 5 --retry-max-time 21600 \
+        "${auth[@]}" "$BASE/$1"
+}
+
+if [[ "$mode" == "download" ]]; then
+    # Manifest + small files first: the part hashes below come from the
+    # freshly fetched parts.json, so a stale/corrupt copy cannot pass.
+    dl "assemble.py"
+    dl "parts.json"
+    dl "SHA256SUMS"
+    dl "ple/ple.manifest.json"
+    dl "ple/ple.scale.bf16"
+    dl "vision/SHA256SUMS"
+    dl "vision/mmproj-Qwen3.8-Flash-Orca-F16.mmproj"
+
+    echo "fetching the five transport parts (136 GB)"
+    while IFS= read -r part; do
+        dl "$part"
+    done < <(python3 -c "
+import json
+for item in json.load(open('$MODEL_DIR/parts.json'))['files']:
+    for p in item['parts']:
+        print(p['path'])
+")
+fi
+
+echo "verifying part sha256 (against the repo parts.json)"
+python3 - "$MODEL_DIR" <<'PY'
+import hashlib, json, sys
+from pathlib import Path
+root = Path(sys.argv[1])
+manifest = json.loads((root / 'parts.json').read_text())
+ok = True
+def digest(p):
+    h = hashlib.sha256()
+    with p.open('rb') as f:
+        for data in iter(lambda: f.read(8 * 1024 * 1024), b''):
+            h.update(data)
+    return h.hexdigest()
+for item in manifest['files']:
+    for p in item['parts']:
+        path = root / p['path']
+        if not path.exists():
+            print(f"  MISSING {p['path']}"); ok = False; continue
+        if path.stat().st_size != p['bytes']:
+            print(f"  BAD-SIZE {p['path']}"); ok = False; continue
+        if digest(path) != p['sha256']:
+            print(f"  BAD-SHA  {p['path']}"); ok = False; continue
+        print(f"  OK   {p['path']}")
+sys.exit(0 if ok else 1)
+PY
+
+if [[ "$mode" == "download" ]]; then
+    echo "assembling (consumes verified parts)"
+    (cd "$MODEL_DIR" && python3 assemble.py)
+fi
+
+echo "verifying assembled files against SHA256SUMS"
+(cd "$MODEL_DIR" && sha256sum -c SHA256SUMS)
+(cd "$MODEL_DIR/vision" && sha256sum -c SHA256SUMS)
+echo "frank-large payload complete: $MODEL_DIR"

scripts/download-frank-large-unsloth.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+# Download unsloth/Qwen3.8-Flash-Next-GGUF:UD-IQ4_XS (the
+# frank-large model) on Dankclaw.
+#
+#   bash scripts/download-frank-large-unsloth.sh
+#   bash scripts/download-frank-large-unsloth.sh --verify-only
+#
+# The UD-IQ4_XS GGUF ships as three llama.cpp split parts (HF caps uploads at
+# 50 GB). The parts ARE the canonical payload: the serve script points -m at
+# part 1 and llama.cpp loads the 3-way split natively. Do NOT concatenate
+# them into a single file to serve — part 1's header carries
+# ggml.file_count=3, so a byte-correct concatenation still advertises itself
+# as a split and the loader rejects the non-split filename.
+# The MTP shared-Q8_0 head borrows the token embedding and the output
+# projection from the main model at runtime (it is the 2.6 GB remainder of
+# the 4B MTP layer). The F16 projector is fetched for a future vision flip;
+# the serve script does not load it while ENABLE_VISION=0.
+#
+# Integrity: every part is checked against its LFS sha256 (fetched live from
+# the Hub tree API, not trusted from disk). The repo is public (gated:
+# false); an HF token at ~/.cache/huggingface/token is used when present to
+# clear the anonymous rate limit on a 94 GB transfer.
+#
+# Layout after a successful run (MODEL_DIR):
+#   UD-IQ4_XS/Qwen3.8-Flash-Next-UD-IQ4_XS-0000{1,2,3}-of-00003.gguf  the 3-way split
+#   mtp/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf   2,786,568,256  draft head
+#   vision/mmproj-F16.gguf                         904,004,000  projector
+set -euo pipefail
+
+REPO="unsloth/Qwen3.8-Flash-Next-GGUF"
+MODEL_DIR="/home/dank/models/Qwen3.8-Flash-Next-UD-IQ4_XS"
+BASE="https://huggingface.co/$REPO/resolve/main"
+
+mode="download"
+[[ "${1:-}" == "--verify-only" ]] && mode="verify"
+
+token=""
+auth=()
+if [[ -r "$HOME/.cache/huggingface/token" ]]; then
+    token="$(tr -d '[:space:]' < "$HOME/.cache/huggingface/token")"
+    auth=(-H "Authorization: Bearer $token")
+fi
+
+dl() { # dl <relpath>
+    local rel="$1" dest="$MODEL_DIR/$rel"
+    [[ -s "$dest" ]] && return 0
+    mkdir -p "$(dirname "$dest")"
+    echo "fetching $rel"
+    curl -fL -C - "${auth[@]}" --retry 5 --retry-delay 3 -o "$dest" "$BASE/$rel"
+}
+
+# relpath size sha256 — the LFS oids from the Hub tree API (2026-09-21)
+FILES=(
+    "UD-IQ4_XS/Qwen3.8-Flash-Next-UD-IQ4_XS-00001-of-00003.gguf 10946624 5ce89370720f8bf90890f439361282104c1aa1482d4013bb9a50923e758e71a4"
+    "UD-IQ4_XS/Qwen3.8-Flash-Next-UD-IQ4_XS-00002-of-00003.gguf 49835229856 577a38a2392b40ca2193cea502e1d92f60b8cd370675d308e0ec21885d9daaa7"
+    "UD-IQ4_XS/Qwen3.8-Flash-Next-UD-IQ4_XS-00003-of-00003.gguf 43836407744 d4634e6d84f0ebb0940be15c90d3790bf6464e3dea3a1cddc567dc0e83ad8833"
+    "MTP/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf 2786568256 5ff54097406a905cf3a724c709124ceb0e3e10235ee862298969e91c96fa96e6"
+    "mmproj-F16.gguf 904004000 1f7b7f0b984cf065c604360c29c8098362ed61b290db0ff12c6f360bb1a8a980"
+)
+
+RELS=()
+for line in "${FILES[@]}"; do
+    read -r rel size _ <<<"$line"
+    RELS+=("$rel")
+    if [[ "$mode" == "download" ]]; then
+        dl "$rel"
+    fi
+done
+
+echo "verifying parts against the live Hub tree API"
+python3 - "$MODEL_DIR" "$REPO" "${RELS[@]}" <<'PY'
+import hashlib, json, os, sys, urllib.request
+
+model_dir, repo = sys.argv[1], sys.argv[2]
+tree = json.load(urllib.request.urlopen(
+    f"https://huggingface.co/api/models/{repo}/tree/main?recursive=true"))
+want = {}
+for f in tree:
+    if f["type"] == "file" and f.get("lfs"):
+        want[f["path"]] = (f["lfs"]["size"], f["lfs"]["oid"])
+
+def sha256(path):
+    h = hashlib.sha256()
+    with open(path, "rb") as fh:
+        for chunk in iter(lambda: fh.read(1 << 24), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+ok = True
+expected = set(sys.argv[3:])
+for rel in sorted(expected):
+    if rel not in want:
+        print(f"NOT IN HUB TREE {rel}"); ok = False; continue
+    size, oid = want[rel]
+    path = os.path.join(model_dir, rel)
+    if not os.path.isfile(path):
+        print(f"MISSING {rel}"); ok = False; continue
+    actual_size = os.path.getsize(path)
+    if actual_size != size:
+        print(f"SIZE MISMATCH {rel}: {actual_size} != {size}"); ok = False; continue
+    digest = sha256(path)
+    if digest != oid:
+        print(f"SHA256 MISMATCH {rel}"); ok = False; continue
+    print(f"ok {rel}")
+sys.exit(0 if ok else 1)
+PY
+
+if [[ "$mode" == "download" ]]; then
+    mkdir -p "$MODEL_DIR/mtp" "$MODEL_DIR/vision"
+    [[ -e "$MODEL_DIR/mtp/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf" ]] ||
+        mv "$MODEL_DIR/MTP/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf" "$MODEL_DIR/mtp/"
+    [[ -e "$MODEL_DIR/vision/mmproj-F16.gguf" ]] || mv "$MODEL_DIR/mmproj-F16.gguf" "$MODEL_DIR/vision/"
+fi
+
+echo "frank-large payload complete: $MODEL_DIR"

scripts/download-frank-large.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# Download the frank-large payload on Dankclaw:
+#   - unsloth/Qwen3.8-27B-GGUF:UD-Q8_K_XL (the 27B dense main GGUF)
+#   - z-lab/Qwen3.8-27B-DFlash2-GGUF:Q4_K_M (the DFlash2 drafter)
+#
+#   bash scripts/download-frank-large.sh
+#   bash scripts/download-frank-large.sh --verify-only
+#
+# Integrity: every file is checked against its declared byte count and sha256
+# (the values below are the LFS oids from the Hub, 2026-09-21). An HF token
+# at ~/.cache/huggingface/token is used when present to clear the anonymous
+# rate limit on a 31 GB transfer.
+#
+# Layout after a successful run (MODEL_DIR):
+#   Qwen3.8-27B-UD-Q8_K_XL.gguf        31457991680  main GGUF
+#   Qwen3.8-27B-DFlash2-Q4_K_M.gguf    1143006816  DFlash2 drafter
+set -euo pipefail
+
+MODEL_DIR="/home/dank/models/Qwen3.8-27B-UD-Q8_K_XL"
+
+mode="download"
+[[ "${1:-}" == "--verify-only" ]] && mode="verify"
+
+token=""
+auth=()
+if [[ -r "$HOME/.cache/huggingface/token" ]]; then
+    token="$(tr -d '[:space:]' < "$HOME/.cache/huggingface/token")"
+    auth=(-H "Authorization: Bearer $token")
+fi
+
+dl() { # dl <url> <dest>
+    local url="$1" dest="$2"
+    [[ -s "$dest" ]] && return 0
+    mkdir -p "$(dirname "$dest")"
+    echo "fetching $dest"
+    curl -fL -C - "${auth[@]}" --retry 5 --retry-delay 3 -o "$dest" "$url"
+}
+
+# filename size sha256 url — the LFS oids from the Hub (2026-09-21)
+FILES=(
+    "Qwen3.8-27B-UD-Q8_K_XL.gguf 31457991680 af36ecb6b5db1407953345b746c14ac93f0657dda413910b4348683a2d990377 https://huggingface.co/unsloth/Qwen3.8-27B-GGUF/resolve/main/Qwen3.8-27B-UD-Q8_K_XL.gguf"
+    "Qwen3.8-27B-DFlash2-Q4_K_M.gguf 1143006816 1a25c56858e1ebe93f2718ac1d49d1151f9323325c1bbfd6209370f4db131ebd https://huggingface.co/z-lab/Qwen3.8-27B-DFlash2-GGUF/resolve/main/Qwen3.8-27B-DFlash2-Q4_K_M.gguf"
+)
+
+# Verify each file's byte count and sha256 (idempotent: a complete file is
+# re-checked, not re-downloaded).
+echo "verifying $MODEL_DIR against declared sizes + sha256"
+python3 - "$MODEL_DIR" <<'PY'
+import hashlib, os, sys
+model_dir = sys.argv[1]
+# (rel, size, sha256) triples — the LFS oids from the Hub (2026-09-21).
+specs = {
+    "Qwen3.8-27B-UD-Q8_K_XL.gguf": (31457991680, "af36ecb6b5db1407953345b746c14ac93f0657dda413910b4348683a2d990377"),
+    "Qwen3.8-27B-DFlash2-Q4_K_M.gguf": (1143006816, "1a25c56858e1ebe93f2718ac1d49d1151f9323325c1bbfd6209370f4db131ebd"),
+}
+ok = True
+for rel, (size, sha) in specs.items():
+    dest = os.path.join(model_dir, rel)
+    if not os.path.isfile(dest):
+        print(f"  MISSING {rel}")
+        ok = False
+        continue
+    actual_size = os.path.getsize(dest)
+    if actual_size != size:
+        print(f"  SIZE MISMATCH {rel}: {actual_size} != {size}")
+        ok = False
+        continue
+    h = hashlib.sha256()
+    with open(dest, "rb") as f:
+        for chunk in iter(lambda: f.read(1 << 24), b""):
+            h.update(chunk)
+    actual_sha = h.hexdigest()
+    if actual_sha != sha:
+        print(f"  SHA256 MISMATCH {rel}: {actual_sha}")
+        ok = False
+        continue
+    print(f"  OK {rel} ({actual_size} bytes)")
+if not ok:
+    sys.exit(1)
+PY
+
+if [[ "$mode" == "download" ]]; then
+    for line in "${FILES[@]}"; do
+        read -r rel _ _ url <<<"$line"
+        dl "$url" "$MODEL_DIR/$rel"
+    done
+fi
+
+echo "frank-large payload complete: $MODEL_DIR"

scripts/download-frank-medium-gguf.sh

@@ -1,84 +0,0 @@
-#!/usr/bin/env bash
-# the target GGUF, the BF16 vision projector and the DFlash2 draft model.
-#
-#   bash scripts/download-frank-medium-gguf.sh
-#   bash scripts/download-frank-medium-gguf.sh --verify-only
-#
-# Both repositories are public (anonymous download; no token needed).  If a
-# token exists at ~/.cache/huggingface/token it is used, which keeps a 31 GB
-# transfer clear of the anonymous rate limit.  The script is resumable
-# (curl -C -) and checks every artifact's exact byte count afterwards, so a
-# truncated file fails here instead of load-crashing the server.
-#
-# WHY THESE TWO FILES:
-#   * Target: ajgazin/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF at
-#     UD-Q8_K_XL -- Unsloth Dynamic 3.0 quant (per-tensor types from Unsloth's
-#     own quant of the same size, on Unsloth's importance matrix).  The file
-#     carries the model's MTP layer (`blk.64.nextn.*`), so llama.cpp can also
-#     draft from the model itself with no second copy in VRAM.
-#   * Draft: z-lab/Qwen3.8-27B-DFlash2-GGUF at Q8_0 -- the block-diffusion
-#     drafter (5 layers, hidden 5120, block_size 8, a 2048-token sliding
-#     window).  Q8_0 is 1.92 GiB against BF16's 3.6 GiB and the drafter's job is
-#     throughput, not output quality (the target verifies every drafted token).
-set -euo pipefail
-
-MODEL_REPO="ajgazin/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF"
-MODEL_DIR="/home/dank/models/Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-GGUF"
-MODEL_FILE="Swift-Qwen3.8-27B-Uncensored-Dynamic-MTP-UD-Q8_K_XL.gguf"
-MODEL_SIZE=31457990112
-# The BF16 vision projector from the same repo; llama-server autoloads any
-# mmproj*.gguf beside the target, so it must land in MODEL_DIR.
-MM_PROJ_FILE="mmproj-BF16.gguf"
-MM_PROJ_SIZE=931145888
-
-DRAFT_REPO="z-lab/Qwen3.8-27B-DFlash2-GGUF"
-DRAFT_DIR="/home/dank/models/Qwen3.8-27B-DFlash2-GGUF"
-DRAFT_FILE="Qwen3.8-27B-DFlash2-Q8_0.gguf"
-DRAFT_SIZE=2056414816
-
-mode="download"
-[[ "${1:-}" == "--verify-only" ]] && mode="verify"
-
-token=""
-auth=()
-if [[ -r "$HOME/.cache/huggingface/token" ]]; then
-    token="$(cat "$HOME/.cache/huggingface/token")"
-    auth=(-H "Authorization: Bearer $token")
-else
-    echo "no HF token at ~/.cache/huggingface/token; downloading anonymously"
-fi
-
-dl() { # dl <repo> <dir> <file>
-    mkdir -p "$2"
-    echo "  fetching $3"
-    curl -fL -C - -o "$2/$3" --retry 10 --retry-delay 5 --retry-max-time 21600 \
-        "${auth[@]}" "https://huggingface.co/$1/resolve/main/$3"
-}
-
-if [[ "$mode" == "download" ]]; then
-    echo "target: $MODEL_REPO"
-    dl "$MODEL_REPO" "$MODEL_DIR" "$MODEL_FILE"
-    echo "projector: $MODEL_REPO"
-    dl "$MODEL_REPO" "$MODEL_DIR" "$MM_PROJ_FILE"
-    echo "draft: $DRAFT_REPO"
-    dl "$DRAFT_REPO" "$DRAFT_DIR" "$DRAFT_FILE"
-fi
-
-echo "verifying sizes"
-ok=1
-check() { # check <path> <expected>
-    local act
-    act="$(stat -c%s "$1" 2>/dev/null || echo 0)"
-    if [[ "$act" -eq "$2" ]]; then
-        echo "  OK   $1 ($act bytes)"
-    else
-        echo "  BAD  $1 ($act bytes, want $2)" >&2
-        ok=0
-    fi
-}
-check "$MODEL_DIR/$MODEL_FILE" "$MODEL_SIZE"
-check "$MODEL_DIR/$MM_PROJ_FILE" "$MM_PROJ_SIZE"
-check "$DRAFT_DIR/$DRAFT_FILE" "$DRAFT_SIZE"
-[[ -z "$token" ]] && echo "note: no token used; the byte counts above are the integrity check"
-[[ "$ok" -eq 1 ]] || exit 1
-echo "all artifacts present and sized correctly"

scripts/download-frank-primary.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Fetch the frank-primary payload: the Qwen3.8-Flash-Next Q8_0 target (six
+# split parts), the shared Q8_0 MTP drafter head and the BF16 vision
+# projector.
+#
+#   bash scripts/download-frank-primary.sh
+#   bash scripts/download-frank-primary.sh --verify-only
+#
+# The repo (unsloth/Qwen3.8-Flash-Next-GGUF) is PUBLIC and anonymous: no HF
+# token is needed, and none is accepted on the command line (a -H auth
+# header is world-readable in /proc/<pid>/cmdline -- the 2026-09-16 leak).
+#
+# WHY THESE FILES:
+#   * Target: Q8_0/ -- unsloth's Q8_0 of Qwen3.8-Flash-Next (125B total /
+#     6B active MoE + the 51B n-gram embedding table). Q_8 is the
+#     operator's requested quant (2026-09-26 swap off the lucebox DS4.1
+#     engine). The six parts ARE the payload: part 1's header advertises
+#     file_count=6, so they are never concatenated (concatenation trips
+#     "invalid split file name").
+#   * Drafter: MTP/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf -- the shared
+#     MTP head (1 layer). "shared" means it borrows the target's embedding
+#     tensors instead of carrying its own copy: 2.6 GiB instead of 3.9,
+#     and unsloth's own MTP guide names it as the recommended head. It is
+#     loaded via -md (this build never autoloads drafters or projectors).
+#   * Vision: mmproj-BF16.gguf -- the BF16 projector, RDNA4-native per the
+#     frank-small precedent. Loaded via --mmproj explicitly.
+#
+# The script is resumable (curl -C -) and checks every artifact's exact byte
+# count AND sha256 against the Hub's declared values, so a truncated or
+# mis-fetched file fails here instead of load-crashing the server. Sizes and
+# hashes were captured from the resolve endpoint's x-linked-etag/x-linked-size
+# on 2026-09-26.
+#
+# Total: 191,919,144,448 bytes (178.74 GiB), of which 175.30 GiB is the
+# target itself. Destination keeps the Hub layout so the serve script can
+# name paths exactly as they appear upstream.
+set -euo pipefail
+
+REPO="unsloth/Qwen3.8-Flash-Next-GGUF"
+DEST="/home/dank/models/Qwen3.8-Flash-Next-GGUF"
+
+# path|bytes|sha256
+MANIFEST=(
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00001-of-00006.gguf|10946624|2dabcbb53ca537a7947bc7d20414fd464eeaf4d66d43021b5b2556cc87544ad2"
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00002-of-00006.gguf|682434912|494ca4ed3dbf97bc28da88af3890b8877b9032f909812d00c0526a9ca5e91d2e"
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00003-of-00006.gguf|54400261312|34efd79a80a1ce540a517a5d56171924b66ce1c38b04c904f17ad6d8ef17cf20"
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00004-of-00006.gguf|49446841216|bfa634025fabbd2658bf7694bc80b90e571699c768723f844c934c7ef06c691a"
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00005-of-00006.gguf|49668930400|232a8f14cc0fa4262e7efe8593774b136fe40909e39c7a020342ddaa27259a97"
+  "Q8_0/Qwen3.8-Flash-Next-Q8_0-00006-of-00006.gguf|34015618784|538a93bca918064983409a41187ad4c68640f9aced6f29564da8f551bf86d7a5"
+  "MTP/mtp-Qwen3.8-Flash-Next-shared-Q8_0.gguf|2786568256|5ff54097406a905cf3a724c709124ceb0e3e10235ee862298969e91c96fa96e6"
+  "mmproj-BF16.gguf|907542944|2e788f8c511d8093c7b43cb87b2fd7e14228340318057f8fb20c86df2efe2355"
+)
+
+mode="download"
+[[ "${1:-}" == "--verify-only" ]] && mode="verify"
+
+if [[ "$mode" == "download" ]]; then
+    for entry in "${MANIFEST[@]}"; do
+        path="${entry%%|*}"
+        mkdir -p "$DEST/$(dirname "$path")"
+        echo "fetching $path"
+        # -f: a 401/403 must FAIL the fetch, not write the error body as
+        # the artifact (the 2026-09-16 gated-repo incident). -C -: resume
+        # partial files.
+        curl -fL -C - -o "$DEST/$path" --retry 10 --retry-delay 5 \
+            --retry-max-time 21600 \
+            "https://huggingface.co/$REPO/resolve/main/$path"
+    done
+fi
+
+echo "verifying sizes and sha256"
+ok=1
+for entry in "${MANIFEST[@]}"; do
+    path="${entry%%|*}"; rest="${entry#*|}"
+    size="${rest%%|*}"; sha256="${rest#*|}"
+    file="$DEST/$path"
+    act="$(stat -c%s "$file" 2>/dev/null || echo 0)"
+    if [[ "$act" -ne "$size" ]]; then
+        echo "  BAD-SIZE  $file ($act bytes, want $size)" >&2
+        ok=0
+        continue
+    fi
+    act_sha="$(sha256sum "$file" | cut -d' ' -f1)"
+    if [[ "$act_sha" != "$sha256" ]]; then
+        echo "  BAD-SHA   $file ($act_sha)" >&2
+        ok=0
+        continue
+    fi
+    echo "  OK   $path ($act bytes)"
+done
+[[ "$ok" -eq 1 ]] || exit 1
+echo "all artifacts present, sized and hashed correctly"

scripts/dump-gguf.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+"""Dump GGUF part headers: split metadata, tensor names/dims/types/bytes.
+
+Reads ONLY the header region (metadata + tensor-info table); tensor data is
+never touched, so a 50 GiB part scans in milliseconds. Split GGUFs are valid
+GGUFs per part; part 1 of this payload is metadata-only (ntensors=0) and
+parts 2-6 carry the tensors. Confirmed layout for this payload: GGUF v3 —
+magic, u32 version, u64 ntensors, u64 nkv, then kvs (v3: u64-length strings),
+then tensor infos (v3: u64-length names).
+"""
+import struct, sys, traceback
+
+TYPE_SIZE = {0:4,1:2,2:1,3:1/2,4:4,5:8,6:2,7:1,8:0.4375,9:1.4375,10:1,11:0.5,
+             12:2,13:4/3,14:2,15:2,16:4,17:2,18:2,19:1,20:2,21:1,22:2,23:2,
+             24:2,25:1.0625,26:1,27:1.375,28:2,29:2,30:2,31:4,32:8,33:2.125,
+             34:2.5,35:2,36:2.375,37:1.5625,38:2.3125,39:2.1875,40:0,41:1.75,
+             42:1.75,43:1.8125,44:2,45:2.25,46:1.5,47:2.0625,48:2.625,49:1.0625,
+             50:2.3125,51:2.875,52:2,53:2.3125,54:2.75,55:2.5,56:2.875,57:2.25,
+             58:2,59:3.8125,60:2.8125,61:1.5625,62:1.5,63:0.5}
+
+class P:
+    def __init__(self, f):
+        self.f = f
+        self.ver = 2
+    def rd(self, n):
+        b = self.f.read(n)
+        if len(b) != n:
+            raise EOFError(f"short read {len(b)}/{n}")
+        return b
+    def u8(self): return self.rd(1)[0]
+    def u32(self): return struct.unpack("<I", self.rd(4))[0]
+    def u64(self): return struct.unpack("<Q", self.rd(8))[0]
+    def f32(self): return struct.unpack("<f", self.rd(4))[0]
+    def f64(self): return struct.unpack("<d", self.rd(8))[0]
+    def s(self):
+        # GGUF v3 strings carry a u64 length; v2 used u32.
+        n = self.u64() if self.ver >= 3 else self.u32()
+        return self.rd(n).decode("utf-8", "replace")
+    def val(self, t):
+        # GGUF kv value types: 0 u8, 1 i8, 2 u16, 3 i16, 4 u32, 5 i32,
+        # 6 f32, 7 bool, 8 string, 9 array, 10 u64, 11 i64, 12 f64.
+        if t == 8: return self.s()
+        if t == 9:
+            et = self.u32(); n = self.u64()
+            return [self.val(et) for _ in range(n)]
+        if t == 0: return self.u8()
+        if t == 1: return struct.unpack("<b", self.rd(1))[0]
+        if t == 2: return struct.unpack("<H", self.rd(2))[0]
+        if t == 3: return struct.unpack("<h", self.rd(2))[0]
+        if t == 4: return self.u32()
+        if t == 5: return struct.unpack("<i", self.rd(4))[0]
+        if t == 6: return self.f32()
+        if t == 7: return self.u8()
+        if t == 10: return self.u64()
+        if t == 11: return struct.unpack("<q", self.rd(8))[0]
+        if t == 12: return self.f64()
+        raise ValueError(f"unknown kv type {t}")
+
+def main(path):
+    tensors = []
+    kvs = {}
+    with open(path, "rb") as f:
+        p = P(f)
+        magic = p.rd(4)
+        assert magic == b"GGUF", magic
+        p.ver = p.u32()
+        ntens = p.u64()
+        nkv = p.u64()
+        for _ in range(nkv):
+            k = p.s()
+            kvs[k] = p.val(p.u32())
+        for _ in range(ntens):
+            name = p.s()
+            nd = p.u32()
+            dims = [p.u64() for _ in range(nd)]
+            t = p.u32()
+            off = p.u64()
+            numel = 1
+            for d in dims: numel *= d
+            tensors.append((name, dims, t, numel))
+    print(f"== {path}  (gguf v{p.ver}, {ntens} tensors, {nkv} kv)")
+    for k in ("general.architecture", "general.name", "split.no", "split.count",
+              "split.tensors", "qwen4exp.expert_count", "qwen4exp.expert_used_count",
+              "qwen4exp.ngram.tensors"):
+        if k in kvs: print(f"  kv {k} = {kvs[k]}")
+    ngram_kvs = {k: v for k, v in kvs.items() if "ngram" in k.lower()}
+    if ngram_kvs: print("  ngram kvs:", ngram_kvs)
+    big = []
+    for name, dims, t, numel in tensors:
+        big.append((numel * TYPE_SIZE.get(t, 0), name, dims, t, numel))
+    big.sort(reverse=True)
+    print(f"  -- {min(12, len(big))} largest of {len(big)}:")
+    for bytes_, name, dims, t, numel in big[:12]:
+        print(f"    {bytes_/2**30:9.3f} GiB  {name}  dims={dims} type={t} ({numel:,} elems)")
+    named = [(b, n, d, t) for b, n, d, t, e in big
+             if any(s in n.lower() for s in ("ngram", "ple", "token_embd", "exps"))]
+    if named:
+        print("  -- ngram/ple/embed/experts-named:")
+        for bytes_, name, dims, t in named[:20]:
+            print(f"    {bytes_/2**30:9.3f} GiB  {name}  dims={dims} type={t}")
+
+for pth in sys.argv[1:]:
+    try:
+        main(pth)
+    except Exception:
+        print(f"== {pth}: FAILED")
+        traceback.print_exc()

scripts/frank-large.env

@@ -0,0 +1,36 @@
+# frank-large — stock llama.cpp (mainline, the unsloth b11030 prebuilt)
+# serving unsloth/Qwen3.8-27B-GGUF:UD-Q8_K_XL on the Strix Halo iGPU
+# (gfx1151).
+#
+# These are the tunables read by scripts/serve-frank-large.sh. The flag
+# list is owned by the serve script; this file only sets fleet values.
+#
+# DO NOT name a new tunable TEMP, HOST or GPU_MAX_HEAP_SIZE: the HIP
+# runtime reads those bare (the 2026-08-13 TEMP incident). HOST is the one
+# exception because the serve script itself consumes it for --host.
+
+# The payload (scripts/download-frank-large.sh): the serve script refuses to
+# start without the main GGUF and the DFlash2 drafter.
+MODEL_DIR=/home/dank/models/Qwen3.8-27B-UD-Q8_K_XL
+
+# The stock llama.cpp runtime (the unsloth b11030 prebuilt).
+RUNTIME_DIR=/home/dank/GitPackages/unsloth-llama-b11030
+
+# Fleet endpoint: the same port and alias the prior deployments served, so
+# no client, probe or models.yml entry changes address.
+HOST=0.0.0.0
+PORT=7770
+
+# One stream, full 262144 context (the model's native window).
+CONTEXT_SIZE=262144
+PARALLEL_SLOTS=1
+
+# DFlash2 spec decode (a block-diffusion drafter) at depth 4. The drafter
+# has a sliding window of 2048 (small draft KV, ~40 MiB).
+SPEC_DRAFT_N_MAX=4
+
+# Prompt-cache budget: 8 GiB. The model is a 27B hybrid (16 full attention
+# + 48 Gated DeltaNet linear attention); its DeltaNet state is smaller than
+# a primarily-DeltaNet model, so the fleet's 12.8 GiB DeltaNet floor does
+# not apply.
+CACHE_RAM=8192

scripts/frank-large.service

@@ -0,0 +1,20 @@
+[Unit]
+Description=stock llama.cpp (unsloth b11030, ROCm gfx1151) Qwen3.8-27B UD-Q8_K_XL, DFlash2 spec decode, fp8 KV, 262144 ctx / 1 slot, root systemd unit (dankclaw, frank-large, Strix Halo iGPU)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=dank
+Group=dank
+# The engine pins staging buffers; keep the memlock budget unbounded so an
+# RLIMIT smaller than the pinned set cannot fail the load. Parity with the
+# other LLM units on this fleet.
+LimitMEMLOCK=infinity
+Environment="FRANK_LARGE_ENV_FILE=/home/dank/serverAppConfigs/scripts/frank-large.env"
+ExecStart=/home/dank/serverAppConfigs/scripts/serve-frank-large.sh
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target

scripts/frank-primary-expert-activity.py

@@ -0,0 +1,202 @@
+#!/usr/bin/env python3
+"""Measure per-block / per-expert expert-routing activity on live frank-primary.
+
+Method: AMD IBS op sampling (data addresses, `perf record -e ibs_op// --data`)
+on the llama-server process while concurrent generations of mixed content run.
+Sampled load addresses are mapped through /proc/<pid>/maps (mmap VMAs of the
+6 GGUF parts) back to individual tensors, then aggregated per expert block
+and per expert WITHIN each block (512 experts, row-major expert-major layout).
+
+Tensor extents are DERIVED from consecutive GGUF header offsets — no quant
+type-size table (those are easy to get subtly wrong; a wrong per-element size
+silently under-covers each tensor and dumps tail samples into a junk bucket).
+
+Fleet law this instrument established (2026-09-26, 75 s window, 4 mixed
+streams, 2.7M expert-tensor samples): per-BLOCK read volume is FLAT
+(0.93x-1.08x of mean across all 40 CPU-resident blocks) because MoE top-k
+routing fires every block every token — there are no "most active layers" at
+`-ot` granularity. The real skew is per-EXPERT (top 10% of (block,expert)
+cells carry ~40% of samples), which tensor-level overrides cannot reach.
+Any 8 GPU-resident blocks are therefore equivalent; COUNT is the only lever.
+
+Usage (needs passwordless sudo for perf only; model files must be readable):
+  fp-expert-activity.py <pid> [duration_s]        # dump + sample + analyze
+  fp-expert-activity.py <pid> --analyze-only     # re-analyze saved samples
+Artifacts: /tmp/fp-tensors.tsv, /tmp/fp-ibs.perf, /tmp/fp-addrs.txt
+"""
+import bisect, json, os, re, struct, subprocess, sys, threading, time
+import urllib.request
+
+MODEL_DIR = "/home/dank/models/Qwen3.8-Flash-Next-GGUF/Q8_0"
+N_PARTS, N_BLOCKS, N_EXPERTS = 6, 48, 512
+TSV, PERF_OUT, ADDRS = "/tmp/fp-tensors.tsv", "/tmp/fp-ibs.perf", "/tmp/fp-addrs.txt"
+PORT = 7770
+
+# ---------------------------------------------------------------- GGUF header
+class P:
+    def __init__(self, f): self.f, self.ver = f, 2
+    def rd(self, n):
+        b = self.f.read(n)
+        assert len(b) == n, "eof"
+        return b
+    def u8(self): return self.rd(1)[0]
+    def u32(self): return struct.unpack("<I", self.rd(4))[0]
+    def u64(self): return struct.unpack("<Q", self.rd(8))[0]
+    def s(self):
+        n = self.u64() if self.ver >= 3 else self.u32()
+        return self.rd(n).decode("utf-8", "replace")
+    def val(self, t):
+        if t == 8: return self.s()
+        if t == 9:
+            et, n = self.u32(), self.u64()
+            for _ in range(n): self.val(et)
+            return None
+        if t in (0, 7): return self.u8()
+        if t == 1: return struct.unpack("<b", self.rd(1))[0]
+        if t == 2: return struct.unpack("<H", self.rd(2))[0]
+        if t == 3: return struct.unpack("<h", self.rd(2))[0]
+        if t == 4: return self.u32()
+        if t == 5: return struct.unpack("<i", self.rd(4))[0]
+        if t == 6: return struct.unpack("<f", self.rd(4))[0]
+        if t == 10: return self.u64()
+        if t == 11: return struct.unpack("<q", self.rd(8))[0]
+        if t == 12: return struct.unpack("<d", self.rd(8))[0]
+        raise ValueError(t)
+
+def dump_part(path):
+    """[(name, start, end)] with extents derived from consecutive offsets."""
+    with open(path, "rb") as f:
+        p = P(f)
+        assert p.rd(4) == b"GGUF"
+        p.ver = p.u32()
+        ntens, nkv = p.u64(), p.u64()
+        for _ in range(nkv):
+            p.s(); p.val(p.u32())
+        infos = []
+        for _ in range(ntens):
+            name = p.s()
+            nd = p.u32()
+            for _ in range(nd): p.u64()
+            p.u32()
+            infos.append((name, p.u64()))
+        data_start = (f.tell() + 31) & ~31
+    fsz = os.path.getsize(path)
+    out = []
+    for i, (name, off) in enumerate(infos):
+        start = data_start + off
+        end = (data_start + infos[i + 1][1]) if i + 1 < len(infos) else fsz
+        out.append((name, start, end))
+    return out
+
+# ------------------------------------------------------------------- workload
+PROMPTS = [
+    [{"role": "user", "content": "Write a Rust function that parses a simple binary log format (u32 length-prefixed records) with proper error handling, then explain the unsafe choices you avoided."}],
+    [{"role": "user", "content": "Compare the strategic logic of Soviet deep-battle doctrine and Blitzkrieg: where did they agree, where did they diverge, and what did each assume about logistics that proved wrong?"}],
+    [{"role": "system", "content": "You have tools: get_weather(city), book_flight(from,to,date). Plan a 3-city trip for next week; call tools as needed and explain each decision."},
+     {"role": "user", "content": "Seattle, Denver, Austin. Cheapest reasonable plan."}],
+    [{"role": "user", "content": "Explain how DNS recursive resolution works end to end, then write a small Python stub that walks a referral chain."}],
+]
+
+def fire(idx, results, dur):
+    body = json.dumps({"messages": PROMPTS[idx], "max_tokens": 260,
+                       "temperature": 0.7, "cache_prompt": False}).encode()
+    req = urllib.request.Request(f"http://127.0.0.1:{PORT}/v1/chat/completions",
+                                 data=body, headers={"Content-Type": "application/json"})
+    t0 = time.time()
+    try:
+        with urllib.request.urlopen(req, timeout=dur + 60) as r:
+            d = json.load(r)
+        results[idx] = (r.status, round(time.time() - t0),
+                        len(d.get("choices", [{}])[0].get("message", {}).get("content", "")))
+    except Exception as e:
+        results[idx] = ("ERR", str(e)[:120])
+
+# --------------------------------------------------------------------- main
+def main():
+    pid = int(sys.argv[1])
+    analyze_only = "--analyze-only" in sys.argv
+    dur = 75.0
+    for a in sys.argv[2:]:
+        if a.isdigit(): dur = float(a)
+    parts = {i: f"{MODEL_DIR}/Qwen3.8-Flash-Next-Q8_0-0000{i}-of-0000{N_PARTS}.gguf"
+             for i in range(1, N_PARTS + 1)}
+
+    vmas = []
+    with open(f"/proc/{pid}/maps") as f:
+        for line in f:
+            m = re.match(r"([0-9a-f]+)-([0-9a-f]+) (\S+) ([0-9a-f]+) (\S+) (\d+)\s*(.*)", line)
+            if not m: continue
+            start, end, pgoff, path = int(m.group(1), 16), int(m.group(2), 16), int(m.group(4), 16), m.group(7)
+            for i, p in parts.items():
+                if path == p: vmas.append((start, end, pgoff, i))
+    vmas.sort()
+    assert vmas, "no GGUF VMAs in maps — wrong pid?"
+    print(f"[rig] {len(vmas)} GGUF VMAs across {len({v[3] for v in vmas})} parts")
+
+    tensors = {}
+    with open(TSV, "w") as tsv:
+        for i, p in parts.items():
+            for name, start, end in dump_part(p):
+                tsv.write(f"{p}\t{name}\t{start}\t{end}\n")
+                tensors.setdefault(i, ([], [], []))
+                tensors[i][0].append(start); tensors[i][1].append(end); tensors[i][2].append(name)
+    n_exp = sum(1 for i in tensors for nm in tensors[i][2] if "exps" in nm)
+    print(f"[rig] {n_exp} exps tensors, extents offset-derived")
+
+    if not analyze_only:
+        results = {}
+        perf = subprocess.Popen(["sudo", "perf", "record", "-e", "ibs_op//", "-c", "50000",
+                                 "--data", "-o", PERF_OUT, "-p", str(pid), "--", "sleep", str(dur)],
+                                stdout=subprocess.DEVNULL, stderr=subprocess.PIPE)
+        time.sleep(2)
+        threads = [threading.Thread(target=fire, args=(i, results, dur)) for i in range(4)]
+        for t in threads: t.start()
+        for t in threads: t.join(dur + 120)
+        err = perf.communicate(timeout=60)[1].decode()[-200:]
+        for i, r in sorted(results.items()):
+            print(f"[work] slot{i}: {r}")
+        print("[perf]", err.strip())
+        with open(ADDRS, "w") as f:
+            f.write(subprocess.run(["sudo", "perf", "script", "-i", PERF_OUT, "-F", "addr"],
+                                    capture_output=True, text=True).stdout)
+
+    block, expert = {}, {}
+    n_exps = n_ple = n_named = n_gap = n_out = 0
+    for line in open(ADDRS):
+        tok = line.split()
+        if not tok: continue
+        try: a = int(tok[0], 16)
+        except ValueError: continue
+        if a == 0 or a > 0xffff000000000000: continue
+        vi = bisect.bisect_right(vmas, (a, 1 << 62, 0, 0)) - 1
+        if vi < 0: n_out += 1; continue
+        start, end, pgoff, pi = vmas[vi]
+        if not start <= a < end: n_out += 1; continue
+        foff = pgoff + (a - start)
+        st, en, nm = tensors[pi]
+        ti = bisect.bisect_right(st, foff) - 1
+        if ti < 0 or foff >= en[ti]: n_gap += 1; continue
+        name, lo, span = nm[ti], foff - st[ti], en[ti] - st[ti]
+        if "exps" in name:
+            n_exps += 1
+            b = int(re.match(r"blk\.(\d+)\.", name).group(1))
+            e = int(lo / (span / N_EXPERTS))
+            block[b] = block.get(b, 0) + 1
+            expert[(b, e)] = expert.get((b, e), 0) + 1
+        elif "per_layer" in name: n_ple += 1
+        else: n_named += 1
+    print(f"\n[rig] attribution: exps={n_exps} ple={n_ple} named={n_named} "
+          f"gap={n_gap} outside={n_out}")
+    tot = sum(block.values())
+    print(f"== BLOCK histogram ({tot} samples, {len(block)} CPU-resident blocks):")
+    for b, c in sorted(block.items(), key=lambda kv: -kv[1]):
+        print(f"  blk{b:2d}: {c:7d} {100*c/tot:5.2f}%")
+    mean = tot / max(len(block), 1)
+    print(f"block spread: max={max(block.values())/mean:.3f}x mean, min={min(block.values())/mean:.3f}x mean")
+    ev = sorted(expert.values(), reverse=True); et = sum(ev)
+    print(f"== EXPERT skew: {len(ev)} distinct (block,expert) cells hit of {N_BLOCKS*N_EXPERTS}")
+    print(f"   top-half of cells carry {100*sum(ev[:len(ev)//2])/et:.1f}%; "
+          f"top-10% {100*sum(ev[:len(ev)//10])/et:.1f}%; hottest cell {100*ev[0]/et:.3f}%")
+
+if __name__ == "__main__":
+    main()

scripts/frank-primary.env

@@ -0,0 +1,47 @@
+# frank-primary.env — R9V radiance-vLLM production overrides (dankserver :7770).
+#
+# The full tuned engine shape (tiered-expert placement, CPU offload budgets
+# per rank, MTP4 drafter, TP=2, qwen3_coder tool parser, 131072 model len,
+# 80-slot tiered expert cache, PLE pinned residency 54.4 GB) lives on-host
+# in the R9V setup state — /home/dank/r9v-state/q8xl/setup.json — written by
+# the q8 profile's setup run (ready: true; doctor PASS, artifacts
+# sha256-verified at fetch time). serve-frank-primary.sh layers that state
+# first and THIS FILE second, so the keys below win. Never copy tuned values
+# from the state into this file — the state is the single source of truth
+# for engine shape.
+R9V_HOME=/home/dank/GitPackages/radiance-vllm-qwen4exp
+R9V_STATE_FILE=/home/dank/r9v-state/q8xl/setup.json
+# Fleet identity: LAN bind, the single frank-primary port, the harness's
+# model id, our own container name (the launcher default r9v-qwen38-flash-next
+# is the scratch identity).
+R9V_HOST_BIND=0.0.0.0
+R9V_HOST_PORT=7770
+R9V_SERVED_MODEL_NAME=frank-primary
+R9V_CONTAINER_NAME=frank-primary-r9v
+R9V_EXPECTED_GPU_BDFS=0000:03:00.0,0000:07:00.0
+# PLE registration (54.4 GB mmap -> HIP) can exceed the engine's 600 s
+# VLLM_PLE_OFFLOAD_READY_TIMEOUT default under page-cache churn (measured
+# 740 s on 2026-09-28, right after a bench teardown; a production boot
+# failed on it the same morning). launch.sh 2de0357 forwards this to the
+# engine; 1800 s covers the slowest observed registration with margin.
+R9V_PLE_READY_TIMEOUT=1800
+# The Q8_0 payload quantizes BOTH fused hyper-connection shards (the IQ4_XS
+# package ships inject as F32), so the shard-uniformity check rejects the
+# fused projection at load. This dev-overlay adapter dequantizes a quantized
+# inject shard in-stream (fork commit 363d606): opt-in mount, uncensored
+# payloads pass through unchanged.
+R9V_DEV_QWEN4_EXP_ADAPTER_PY=/home/dank/GitPackages/radiance-vllm-qwen4exp/runtimes/dev-overrides/qwen4_exp.py
+# The runtime overlay's env.always injects R9V_FULL_MUTABLE_CACHE=1 — the
+# qualified 160-slot uncensored IQ4_XS cache geometry — which the q8
+# profile's 80-slot tiered cache fails with a baseline mismatch. This flips
+# that injection off for this payload (launch.sh passes it after the overlay
+# envs; docker last-wins).
+R9V_FULL_MUTABLE_CACHE=0
+# The Qwen-Sharp template (the frank-large fleet law): folds reasoning
+# efforts (high/xhigh/max -> xhigh, minimal/low -> low) and defaults
+# preserve_thinking true. --chat-template wins over the tokenizer dir's
+# metadata/chat_template.jinja; request-level kwargs still win per request.
+# Braces in values get the same single-quote law as parentheses (source
+# parses assignment values).
+R9V_CHAT_TEMPLATE_FILE=/home/dank/serverAppConfigs/scripts/qwen-sharp-v22.4.0.jinja
+R9V_CHAT_TEMPLATE_KWARGS='{"preserve_thinking":true}'

scripts/frank-primary.service

@@ -0,0 +1,44 @@
+# frank-primary.service — R9V radiance-vLLM endpoint (unsloth
+# Qwen3.8-Flash-Next Q8_0, MTP4, TP=2, tiered experts, 6-shard payload) on
+# the 2x R9700 pair, dankserver :7770. 2026-09-27 cutover from the
+# uncensored IQ4_XS payload (its state dir stays on disk as rollback).
+#
+# Replaces the llama.cpp frank-primary unit (same port, same served alias;
+# harness models.yml unchanged in id, retuned for the 131072 window). The
+# serve script drives the R9V fork's own launcher through the docker->podman
+# shim and then waits on the container, so a crashed engine is a nonzero
+# ExecStart and Restart=on-failure is real.
+#
+# WHY A ROOT UNIT (not a rootless quadlet): the tiered-expert shape pins tens
+# of GiB of host RAM (the UVA expert host copy plus the 16 GiB PLE pinned
+# reserve). Pinned pages are charged against RLIMIT_MEMLOCK; dank's login
+# session on this host carries 8 MiB and a user quadlet is capped by the user
+# manager's own hard limit — raising that means restarting user@1000.service
+# and bouncing every user container on the host. A root unit grants
+# LimitMEMLOCK=infinity to the dank process via PID1, and the image stays in
+# dank's rootless podman storage (the shim drives podman as dank).
+[Unit]
+Description=frank-primary — R9V radiance-vLLM Qwen3.8-Flash-Next Q8_0 on 2x R9700
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+User=dank
+Group=dank
+# The tiered-expert offloader pins host RAM; an RLIMIT_MEMLOCK smaller than
+# the pinned set fails the load mid-start. PID1 grants infinity here —
+# parity with the fleet's other LLM units.
+LimitMEMLOCK=infinity
+Environment="FRANK_PRIMARY_ENV_FILE=/home/dank/serverAppConfigs/scripts/frank-primary.env"
+ExecStart=/home/dank/serverAppConfigs/scripts/serve-frank-primary.sh
+# systemd stop: wait alone cannot stop the container child; stop it
+# explicitly. vLLM 0.26 drains gracefully on SIGTERM.
+ExecStop=/usr/bin/podman stop -t 120 frank-primary-r9v
+# Boot cost: the launcher's preflight doctor (~1 min) after a warm page
+# cache; cold (post-reboot) payload page-in of ~175 GiB dominates.
+TimeoutStartSec=1800
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target

scripts/frank-small.env

@@ -1,110 +1,115 @@
-# Tunables for frank-small (ISTA-DASLab/Qwen3.8-27B-GSQ-RCO-GGUF, the IQ3_S
-# build with the MTP head, plus the BF16 vision projector) on mainline
-# llama.cpp, Dankclaw's RTX 3090, since 2026-09-16.
+# Tunables for frank-small (HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-
+# Balanced, Q4_K_M, plus the BF16 vision projector and the separate MTP
+# sidecar) on mainline llama.cpp, Dankclaw's RTX 3090, since 2026-09-17.
 #
-# Runtime: llama.cpp master 37b53fd (2026-09-16), CUDA build for sm_86:
+# Runtime: llama.cpp master 37b53fd, CUDA build for sm_86:
 #   cmake -B build-cuda -DCMAKE_BUILD_TYPE=Release -DGGML_NATIVE=ON \
-#     -DGGML_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=86
+#     -DGGML_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=86 -DGGML_CUDA_FA_ALL_QUANTS=ON
 #   cmake --build build-cuda --target llama-server -j
-# GGML_CUDA_FA_ALL_QUANTS is deliberately OFF in that build: it is only needed
-# for QUANTIZED KV with flash attention, and this service runs f16 KV (below).
+# GGML_CUDA_FA_ALL_QUANTS is ON: this service runs q8_0 KV with flash
+# attention, and without the flag quantized-KV prefill collapses ~12x on
+# CUDA (see the CUDA lesson in AGENTS.md).
 #
-# Model: ISTA-DASLab/Qwen3.8-27B-GSQ-RCO-GGUF, the `-mtp` build of IQ3_S.
-# GSQ-RCO assigns a separate quantization type to every tensor from a
-# gradient-based search under a total size budget, rather than applying one
-# type throughout; IQ3_S at 3.50 bpw is the release's task-lossless operating
-# point (AIME25 100.00 and LiveCodeBench v6 85.71 match BF16 exactly,
-# GPQA-Diamond 0.51 behind, at 11.8 GB against 53.8).
+# Model: HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced at Q4_K_M
+# (6.87 GiB). Architecture (GGUF arch gemma4): 48 layers, MHA with 16 kv
+# heads x 512 head_dim, rope freq_base 1e6, final logit softcapping 30,
+# per-layer token embeddings (PLE) inside the file, and a sliding-window
+# attention pattern (attention.sliding_window = 1024) -- most layers cache
+# only a 1024-position window, which is why the KV pool is a fraction of
+# the full-ctx x all-layers number.
 #
-# WHY THAT FILE: the `-mtp` build is ~0.35 GB larger because it carries the
-# model's Multi-Token Prediction head as GGUF block `blk.64.nextn.*`
-# (qwen35.nextn_predict_layers = 1). llama.cpp loads it from the SAME file --
-# `--spec-type draft-mtp` sets load_mtp, and the draft context runs on the main
-# model's weights (common/common.cpp passes shares_model when there is no
-# --model-draft; speculative.cpp gives it LLAMA_CONTEXT_TYPE_MTP), so there is
-# no second 12 GB copy in VRAM. MTP is therefore a property of the FILE, not of
-# the flags: the plain IQ3_S build has no MTP tensors to load.
+# MTP: the Multi-Token Prediction head ships as a SEPARATE file
+# (mtp-gemma-4-12B-it.gguf, arch gemma4-assistant, 4 nextn layers, 0.24
+# GiB). Unlike the Qwen3.8 -mtp build (head inside the main file), this one
+# is passed via --model-draft with --spec-type draft-mtp, so the draft
+# context loads the assistant model. The same --spec-type value chains the
+# draftless ngram-mod matcher, which attaches unconditionally; two
+# context-backed drafters cannot share one process, so draft-mtp,ngram-mod
+# is the only legal shape that carries both.
 #
-# Architecture (GGUF arch qwen35): 64 layers laid out as 16 x (3 x (Gated
-# DeltaNet -> FFN) + 1 x (Gated Attention -> FFN)) -- 48 linear-attention
-# layers with CONSTANT-SIZE per-sequence state and 16 full-attention layers,
-# 4 KV heads x 256 head_dim. Only the attention layers take KV, so a token
-# costs 2 (K,V) x 4 heads x 256 x 2 B = 64 KiB at f16 (34 KiB at q8_0, 18 KiB
-# at q4_0), and the DeltaNet layers add ~0.16 GiB per sequence in f32 at any
-# depth.
+# SIZING (RTX 3090, 24576 MiB): CTX_SIZE = PARALLEL x 262144 -- four
+# FULL-window slots, measured to fit: the 4-slot boot idles at 22,346
+# MiB and each extra full-context slot costs 3,450 MiB (measured 1-slot
+# 11,996 -> 4-slot 22,346). A fifth slot projects to ~25.8 GiB, past the
+# card, and the KV pool allocates upfront -- so 4 is the max. Explicit
+# CTX_SIZE bypasses --fit on purpose: --fit maximises the TOTAL pool,
+# which would shrink each slot below the full 262144 window once
+# parallel > 1.
 #
-# SIZING (RTX 3090, 24576 MiB) -- modelled, and the loader's own ledger
-# ("KV self size", "compute buffer size") outranks it:
-#   weights                            11.29 GiB (12,120,016,960 B)
-#   mmproj                              0.87 GiB (931,146,528 B, 27 blocks)
-#   MTP draft KV                        0.50 GiB (its context is n_ctx long
-#                                       over one nextn layer: 4 KiB/token)
-#   DeltaNet state                      0.16 GiB (one sequence)
-#   CUDA context + prefill/decode bufs  ~1.5 GiB
-#   KV at CTX_SIZE                      8.00 GiB (131,072 x 64 KiB)
-#                                      --------
-#                                      ~22.3 GiB of 24, ~2 GiB of slack
-# The binding number is the KV: ~9.5 GiB is left after the fixed terms, which
-# at 64 KiB/token is ~155k tokens across all slots. The deployed shape is one
-# slot at 131,072, full f16 precision, no KV quantization risk, no rebuild.
-# Alternatives inside the same budget: 2 x 65536 at f16; 4 x 65536 or
-# 1 x 262144 at q8_0, both of which need a rebuild with
-# -DGGML_CUDA_FA_ALL_QUANTS=ON (without it quantized-KV prefill collapses
-# ~12x on CUDA -- see the CUDA lesson in AGENTS.md).
-# --parallel N DIVIDES --ctx-size between slots; it does not multiply. One slot
-# means a second concurrent request queues behind the first.
+# Vision + audio: --mmproj loads the BF16 projector (11 tensors, 52M
+# params; it carries an audio encoder too). The fleet's image path lives
+# here, which is why halogen no longer sets HALOGEN_VISION_TOWER. Audio
+# WORKS: input_audio content parts transcribe verbatim (verified
+# 2026-09-17 with a 16k mono WAV).
 #
-# Sampling: greedy by default, which is the fleet contract (a request that
-# sends no temperature decodes greedy; a client that sends one gets its own).
-# Qwen's own agentic evaluations used temperature 1.0 / top_p 0.95, and the
-# harness applies exactly that per model in models.yml (extraBody), the same
-# way it did for the earlier frank-large runtime.
+# Sampling: greedy by default (the fleet contract); a client that sends a
+# temperature gets its own, and the harness applies per-model overrides
+# from models.yml.
 #
-# WARNING: do not name any variable TEMP, HOST, or GPU_MAX_HEAP_SIZE (HIP reads
-# those bare vars on the ROCm hosts -- see the 2026-08-13 incident in
+# WARNING: do not name any variable TEMP, HOST, or GPU_MAX_HEAP_SIZE (HIP
+# reads those bare vars on the ROCm hosts -- see the 2026-08-13 incident in
 # AGENTS.md). This box is CUDA, but the rule keeps env files portable.
 
-# llama.cpp runtime binary: mainline master 37b53fd, CUDA sm_86.
+# llama.cpp runtime binary: mainline master 37b53fd, CUDA sm_86,
+# FA_ALL_QUANTS=ON.
 LLAMA_BIN=/home/dank/GitPackages/llama.cpp-mainline/build-cuda/bin/llama-server
 
-# Model package. The -mtp file is required for speculative decoding.
-MODEL_DIR=/home/dank/models/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp
-MODEL_FILE=Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp.gguf
-MMPROJ_PATH=/home/dank/models/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp/mmproj-Qwen3.8-27B-BF16.gguf
+# Model package. The MTP sidecar file is required for speculative decoding.
+MODEL_DIR=/home/dank/models/Gemma4-12B-QAT
+MODEL_FILE=Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-Q4_K_M.gguf
+MMPROJ_PATH=/home/dank/models/Gemma4-12B-QAT/mmproj-Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-BF16.gguf
+DRAFT_FILE=mtp-gemma-4-12B-it.gguf
 
-# Fleet identity and network. 7771 is this service's own endpoint on Dankclaw;
-# 7770 stays frank-large's. The alias is the id at /v1/models and what clients
-# ask for -- the harness entry in models.yml names it.
+# Fleet identity and network. 7771 is this service's own endpoint on
+# Dankclaw; 7770 stays frank-large's. The alias is the id at /v1/models and
+# what clients ask for -- the harness entry in models.yml names it.
 ALIAS=frank-small
 BIND_ADDR=0.0.0.0
 LISTEN_PORT=7771
 
-# One slot at 131,072 tokens with f16 KV (see the sizing note above).
-CTX_SIZE=131072
-PARALLEL=1
-CACHE_TYPE_K=f16
-CACHE_TYPE_V=f16
+# Four FULL 262144-token contexts, one per slot (CTX_SIZE is the total
+# pool; --parallel divides it). See the SIZING note above for the fit
+# arithmetic; a fifth slot does not fit.
+CTX_SIZE=1048576
+PARALLEL=4
+CACHE_TYPE_K=q8_0
+CACHE_TYPE_V=q8_0
+# CPU RAM cache cap in MiB (build default 8192). This host is memory-tight
+# (frank-large's 70 GiB GTT plus the rest of the stack), and Gemma4 runs
+# fully on the 3090 (-ngl 999), so the CPU-side cache is not the hot path;
+# cap it at 2048 to give back ~6 GiB of LPDDR. Gemma4 is not a DeltaNet
+# model, so the >12.8 GiB CACHE_RAM floor does not apply.
+CACHE_RAM=2048
 
-# Batch geometry: llama.cpp's own defaults (2048 logical / 512 physical). The
-# prefill wall clock at this model size is set by the card, not by ubatch, and
-# the small ubatch keeps the DeltaNet chunk buffers small. Raise UBATCH_SIZE
-# only after reading the compute buffer size the loader reports.
-BATCH_SIZE=2048
-UBATCH_SIZE=512
+# Batch geometry: 8192 logical / 1024 physical. Measured on this card at
+# max length (254k-token prefill / 253k-ctx decode, 4 slots, q8 KV):
+# ubatch 512 -> pp 915 t/s, tg@250k 90-204; ubatch 1024 -> pp 962,
+# tg 257-302. Larger ubatches (2048) OOM the MTP draft context's pp
+# compute buffer (~3.3 GiB against 2.2 GiB headroom) and must not be
+# tried. Idle VRAM is 23,300 MiB at this geometry.
+BATCH_SIZE=8192
+UBATCH_SIZE=1024
 
 # CPU threads: this service runs entirely on the GPU (NGL=999), so threads
-# cover tokenization, sampling and the HTTP layer only. Deliberately modest --
-# this host's CPU is shared with halogen's engine, which is CPU-hungry.
+# cover tokenization, sampling and the HTTP layer only. Deliberately modest
+# -- this host's CPU is shared with halogen's engine, which is CPU-hungry.
 NUM_THREADS=8
 THREAD_BATCH=8
 
-# Every layer on the 3090, with flash attention.
+# Every layer on the 3090, with flash attention (required for q8 KV).
 NGL=999
 FLASH_ATTN=on
 
-# Speculative decoding from the model's own MTP head (see the model note).
-# Draft depth stays llama.cpp's default of 3 tokens.
-SPEC_TYPE=draft-mtp
+# Speculative decoding: the MTP sidecar (draft context) chained with the
+# draftless ngram-mod matcher. Draft depth and busy-wait level are made
+# explicit here (both were the implicit build defaults: 3 and 50).
+# Measured at 250k ctx: depth 4 + poll 100 DECODED WORSE (230-257 t/s)
+# than depth 3 + poll 50 (257-302 t/s) — the longer verification round
+# costs more attention re-read at long context than the extra accepted
+# token earns. Keep 3/50.
+SPEC_TYPE=draft-mtp,ngram-mod
+SPEC_DRAFT_N_MAX=3
+POLL_LEVEL=50
 
 # Greedy default (fleet contract); reasoning is extracted into
 # reasoning_content with an unlimited budget (the model decides).

scripts/hf-fetch.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# hf-fetch.sh — resumable, verified HuggingFace fetch (gated or public repos).
+#
+#   bash scripts/hf-fetch.sh <dest_dir> <manifest>
+#
+# Manifest: one line per file, three tab/space-separated fields:
+#   <filename> <size_bytes> <sha256>
+# A blank sha256 field means "check size only". Lines starting with '#' and
+# blank lines are ignored. The first field is a path relative to <dest_dir>.
+#
+# Token: $HF_TOKEN, else ~/.cache/huggingface/token, else the llamaswap conf
+# (grep hf_...). Passed out-of-band via a mode-600 curl -K file — a -H header
+# is world-readable in /proc/<pid>/cmdline (the 2026-09-16 HF-token leak).
+#
+# Idempotent: a file whose size AND sha256 already match is skipped, so a
+# re-run after an interruption only fetches what is missing or corrupt.
+set -euo pipefail
+
+dest="${1:?usage: hf-fetch.sh <dest_dir> <manifest>}"
+manifest="${2:?usage: hf-fetch.sh <dest_dir> <manifest>}"
+repo="${3:?usage: hf-fetch.sh <dest_dir> <manifest> <owner/repo>}"
+
+mkdir -p "$dest"
+
+# --- token resolution --------------------------------------------------------
+token="${HF_TOKEN:-}"
+if [[ -z "$token" && -r "$HOME/.cache/huggingface/token" ]]; then
+    token="$(tr -d '[:space:]' < "$HOME/.cache/huggingface/token")"
+fi
+if [[ -z "$token" && -r "$HOME/.config/llamaswap.conf.yaml" ]]; then
+    token="$(grep -oE 'hf_[a-zA-Z0-9]+' "$HOME/.config/llamaswap.conf.yaml" | head -1)"
+fi
+[[ -n "$token" ]] || { echo "hf-fetch: no HF token (set HF_TOKEN or ~/.cache/huggingface/token)" >&2; exit 3; }
+
+auth_file="$(mktemp)"
+chmod 600 "$auth_file"
+printf 'header = "Authorization: Bearer %s"\n' "$token" > "$auth_file"
+cleanup() { rm -f "$auth_file"; }
+trap cleanup EXIT
+
+base="https://huggingface.co/${repo}/resolve/main"
+
+# --- per-file fetch + verify -------------------------------------------------
+fetch_one() {
+    local name="$1" size="$2" sha="$3"
+    local url="$base/$name"
+    local path="$dest/$name"
+    mkdir -p "$(dirname "$path")"
+
+    # idempotent skip
+    if [[ -f "$path" ]]; then
+        local cur_size sha_ok
+        cur_size="$(wc -c < "$path")"
+        sha_ok=true
+        if [[ -n "$sha" && "$(sha256sum "$path" | cut -d' ' -f1)" != "$sha" ]]; then
+            sha_ok=false
+        fi
+        if [[ "$cur_size" == "$size" && "$sha_ok" == "true" ]]; then
+            echo "  ok   $name ($size bytes)"
+            return 0
+        fi
+        echo "  refetch $name (have $cur_size, want $size)"
+    fi
+
+    # Resumable download; -f fails on HTTP error so a 401/403 is not written as a file.
+    # -C - only when a non-empty partial exists: with a missing file it sends
+    # Range: bytes=0-, which HF's xethub CDN rejects with 400 (xet-backed repos).
+    local resume_args=()
+    [[ -f "$path" && -s "$path" ]] && resume_args=(-C -)
+    curl -fsSL "${resume_args[@]}" -K "$auth_file" -o "$path" "$url"
+
+    # verify byte count
+    local got
+    got="$(wc -c < "$path")"
+    if [[ "$got" != "$size" ]]; then
+        echo "  FAIL $name: size $got != $size" >&2
+        return 1
+    fi
+    # verify sha256
+    if [[ -n "$sha" ]]; then
+        local actual
+        actual="$(sha256sum "$path" | cut -d' ' -f1)"
+        if [[ "$actual" != "$sha" ]]; then
+            echo "  FAIL $name: sha256 $actual != $sha" >&2
+            return 1
+        fi
+    fi
+    echo "  done $name ($size bytes)"
+}
+
+echo "hf-fetch: $repo -> $dest"
+status=0
+while IFS= read -r line || [[ -n "$line" ]]; do
+    [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue
+    name="$(awk '{print $1}' <<<"$line")"
+    size="$(awk '{print $2}' <<<"$line")"
+    sha="$(awk '{print $3}' <<<"$line")"
+    fetch_one "$name" "$size" "$sha" || status=1
+done < "$manifest"
+
+if [[ "$status" -ne 0 ]]; then
+    echo "hf-fetch: FAILED (see above)" >&2
+    exit 1
+fi
+echo "hf-fetch: all files verified"

scripts/hf-manifest.py

@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""hf-manifest.py — generate an hf-fetch.sh manifest from a HuggingFace repo.
+
+Usage: python3 scripts/hf-manifest.py <owner/repo> [outfile]
+
+Lists the repo tree via the HF API and, for each file, records the size and
+the content sha256. LFS and Xet-backed files redirect the resolve endpoint to
+a CDN (302), whose own headers carry the truth: X-Linked-Size is the byte
+count and X-Linked-ETag is the sha256 of the file's bytes. The redirect must
+NOT be followed: on Xet-backed repos the bridge answers with ETag = the Xet
+CAS chunk-dag hash, which is NOT the content sha256 (seen on
+Qwen/Qwen3.8-Flash-Next-FP8, 2026-09-26: every shard "failed" verification
+against a hash no download could ever match). Non-LFS files (config.json,
+tokenizer, ...) are answered directly (200) and carry no 64-hex etag, so they
+get a blank hash field — hf-fetch.sh then checks size only for them.
+
+Output: one line per file, three space-separated fields:
+    <filename> <size_bytes> <sha256-or-blank>
+
+Token: $HF_TOKEN, else ~/.cache/huggingface/token, else the llamaswap conf
+(grep hf_...). Gated repos need a token that has been granted access.
+"""
+import http.client
+import json
+import os
+import re
+import sys
+import urllib.request
+from urllib.parse import urljoin, urlsplit
+
+def get_token():
+    t = os.environ.get("HF_TOKEN", "")
+    if not t:
+        p = os.path.expanduser("~/.cache/huggingface/token")
+        if os.path.exists(p):
+            with open(p) as f:
+                t = f.read().strip()
+    if not t:
+        p = os.path.expanduser("~/.config/llamaswap.conf.yaml")
+        if os.path.exists(p):
+            with open(p) as f:
+                m = re.search(r"hf_[a-zA-Z0-9]+", f.read())
+                if m:
+                    t = m.group(0)
+    return t
+
+
+def head(url, token):
+    """HEAD via http.client, which does not follow redirects.
+
+    urllib's default opener follows the resolve endpoint's 302, and the Xet
+    bridge's ETag is the Xet CAS hash, not the content sha256 — so the 302's
+    own X-Linked-* headers must be read instead. Returns an http.client
+    response; the caller reads r.status and r.headers.
+    """
+    parts = urlsplit(url)
+    conn = http.client.HTTPSConnection(parts.netloc, timeout=30)
+    path = parts.path + (f"?{parts.query}" if parts.query else "")
+    h = {"User-Agent": "hf-manifest/1.0"}
+    if token:
+        h["Authorization"] = f"Bearer {token}"
+    conn.request("HEAD", path, headers=h)
+    return conn.getresponse()
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(f"usage: {sys.argv[0]} <owner/repo> [outfile]", file=sys.stderr)
+        sys.exit(2)
+    repo = sys.argv[1]
+    outfile = sys.argv[2] if len(sys.argv) > 2 else None
+    token = get_token()
+    # 1. List the repo tree (siblings[].rfilename). Sizes and content sha256s
+    # come from the resolve endpoint's HEAD (not followed — see head());
+    # the API's siblings carry only rfilename.
+    api = f"https://huggingface.co/api/models/{repo}"
+    req = urllib.request.Request(
+        api, headers={"User-Agent": "hf-manifest/1.0",
+                      **({"Authorization": f"Bearer {token}"} if token else {})})
+    with urllib.request.urlopen(req, timeout=30) as r:
+        meta = json.load(r)
+    siblings = meta.get("siblings", [])
+    print(f"# {repo}: {len(siblings)} entries", file=sys.stderr)
+
+    lines = []
+    for s in siblings:
+        name = s.get("rfilename", "")
+        if not name or name.endswith("/"):
+            continue
+        # 2. Size + content sha256 from the resolve endpoint's HEAD. 200 =
+        # direct answer (Content-Length + ETag). 3xx WITH X-Linked-Size =
+        # LFS/Xet redirect: X-Linked-Size + X-Linked-ETag are the byte
+        # count and the sha256 of the file's bytes, and the redirect must
+        # NOT be followed — the Xet bridge's own ETag is the Xet CAS hash,
+        # not the content sha256. 3xx WITHOUT X-Linked-Size = non-LFS
+        # redirect (307 to HF's own /api/resolve-cache): the stub's
+        # Content-Length is NOT the file size, so follow ONCE; the final
+        # ETag there is the git blob sha (40 hex), so the 64-hex gate
+        # leaves the hash blank (hf-fetch.sh then checks size only).
+        size = 0
+        sha = ""
+        resolve = f"https://huggingface.co/{repo}/resolve/main/{name}"
+        try:
+            with head(resolve, token) as r:
+                if r.status == 404:
+                    raise FileNotFoundError(name)
+                if r.status == 200:
+                    size = int(r.headers.get("Content-Length") or 0)
+                    etag = (r.headers.get("ETag") or "").strip('"')
+                else:
+                    linked = r.headers.get("X-Linked-Size")
+                    if linked is not None:
+                        size = int(linked)
+                        etag = (r.headers.get("X-Linked-ETag") or "").strip('"')
+                    else:
+                        loc = r.headers.get("Location", "")
+                        with head(urljoin(resolve, loc), token) as r2:
+                            if r2.status == 200:
+                                size = int(r2.headers.get("Content-Length") or 0)
+                                etag = (r2.headers.get("ETag") or "").strip('"')
+                            else:
+                                etag = ""
+                if re.fullmatch(r"[0-9a-f]{64}", etag):
+                    sha = etag
+        except FileNotFoundError:
+            pass
+        lines.append(f"{name} {size} {sha}")
+        print(f"  {name}  {size:>12}  {sha or '(size only)'}", file=sys.stderr)
+
+    out = "\n".join(lines) + "\n"
+    if outfile:
+        with open(outfile, "w") as f:
+            f.write(out)
+        print(f"wrote {outfile}", file=sys.stderr)
+    else:
+        sys.stdout.write(out)
+
+
+if __name__ == "__main__":
+    main()

scripts/homepage-status.py

@@ -2,7 +2,8 @@
 """homepage-status.py — the homepage status checker.
 
 Reads a service config (a JSON array of service entries), probes each backend,
-and writes a status.json atomically. A wip service is not probed.
+and writes a status.json atomically. A wip service is not probed; its state
+is "wip-open" or "wip-closed" following the wip value in the config.
 
 Usage: homepage-status.py <services.json> <out.json>
 """
@@ -48,8 +49,9 @@ def main(argv):
 
     results = []
     for svc in services:
-        if svc.get("wip"):
-            state = "wip"
+        wip = svc.get("wip")
+        if wip:
+            state = "wip-%s" % wip
         else:
             host, _, port = svc["probe"].rpartition(":")
             state = probe(host, int(port), svc.get("method", "tcp"))

scripts/qwen-sharp-v22.4.0.jinja

@@ -0,0 +1,453 @@
+{%- set template_version = "qwen3.8-froggeric-v22.4.0" %}
+{%- set _tool_format = tool_call_format if tool_call_format is defined else 'xml' %}
+{%- set image_count = namespace(value=0) %}
+{%- set video_count = namespace(value=0) %}
+{%- set add_vision_id = add_vision_id if add_vision_id is defined else false %}
+{%- set enable_thinking = enable_thinking if enable_thinking is defined else true %}
+{%- set auto_disable_thinking_with_tools = auto_disable_thinking_with_tools if auto_disable_thinking_with_tools is defined else false %}
+{%- if preserve_reasoning is defined and preserve_reasoning is not none %}
+    {%- set _preserve_thinking = preserve_reasoning %}
+{%- elif preserve_thinking is defined and preserve_thinking is not none %}
+    {%- set _preserve_thinking = preserve_thinking %}
+{%- else %}
+    {%- set _preserve_thinking = true %}
+{%- endif %}
+{%- set max_tool_arg_chars = max_tool_arg_chars if max_tool_arg_chars is defined else 0 %}
+{%- set max_tool_response_chars = max_tool_response_chars if max_tool_response_chars is defined else 0 %}
+{%- set _default_reasoning_effort = 'medium' %}
+{%- set _has_tools = (tools is defined and tools and tools is iterable and tools is not mapping) %}
+{%- set _effort_raw = (reasoning_effort | string | lower) if reasoning_effort is defined and reasoning_effort is not none else _default_reasoning_effort %}
+{%- set _initial_thinking = enable_thinking %}
+{%- if _effort_raw in ('none', 'off') %}
+    {%- set _initial_thinking = false %}
+    {%- set _initial_effort = 'medium' %}
+{%- elif _effort_raw in ('minimal', 'low') %}
+    {%- set _initial_effort = 'low' %}
+{%- elif _effort_raw in ('high', 'xhigh', 'max', 'ultracode', 'extreme') %}
+    {%- set _initial_effort = 'xhigh' %}
+{%- else %}
+    {%- set _initial_effort = 'medium' %}
+{%- endif %}
+{%- set ns_state = namespace(thinking=_initial_thinking, effort=_initial_effort) %}
+{%- if auto_disable_thinking_with_tools and _has_tools %}
+    {%- set ns_state.thinking = false %}
+{%- endif %}
+{%- for msg in messages %}
+    {%- if msg.role == 'system' or msg.role == 'developer' or msg.role == 'user' %}
+        {%- if msg.content is string %}
+            {%- if '<|think_off|>' in msg.content %}
+                {%- set ns_state.thinking = false %}
+            {%- elif '<|think_on|>' in msg.content %}
+                {%- set ns_state.thinking = true %}
+            {%- elif '<|think_xhigh|>' in msg.content or '<|think_high|>' in msg.content or '<|think_ultracode|>' in msg.content or '<|think_extreme|>' in msg.content or '<|think_max|>' in msg.content %}
+                {%- set ns_state.thinking = true %}
+                {%- set ns_state.effort = 'xhigh' %}
+            {%- elif '<|think_low|>' in msg.content or '<|think_minimal|>' in msg.content %}
+                {%- set ns_state.thinking = true %}
+                {%- set ns_state.effort = 'low' %}
+            {%- elif '<|think_medium|>' in msg.content %}
+                {%- set ns_state.thinking = true %}
+                {%- set ns_state.effort = 'medium' %}
+            {%- endif %}
+        {%- elif msg.content is iterable and msg.content is not mapping %}
+            {%- for item in msg.content %}
+                {%- if item is string %}
+                    {%- set _item_text = item %}
+                {%- elif item is mapping and 'text' in item and item.text is string %}
+                    {%- set _item_text = item.text %}
+                {%- else %}
+                    {%- set _item_text = '' %}
+                {%- endif %}
+                {%- if _item_text %}
+                    {%- if '<|think_off|>' in _item_text %}
+                        {%- set ns_state.thinking = false %}
+                    {%- elif '<|think_on|>' in _item_text %}
+                        {%- set ns_state.thinking = true %}
+                    {%- elif '<|think_xhigh|>' in _item_text or '<|think_high|>' in _item_text or '<|think_ultracode|>' in _item_text or '<|think_extreme|>' in _item_text or '<|think_max|>' in _item_text %}
+                        {%- set ns_state.thinking = true %}
+                        {%- set ns_state.effort = 'xhigh' %}
+                    {%- elif '<|think_low|>' in _item_text or '<|think_minimal|>' in _item_text %}
+                        {%- set ns_state.thinking = true %}
+                        {%- set ns_state.effort = 'low' %}
+                    {%- elif '<|think_medium|>' in _item_text %}
+                        {%- set ns_state.thinking = true %}
+                        {%- set ns_state.effort = 'medium' %}
+                    {%- endif %}
+                {%- endif %}
+            {%- endfor %}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- set reasoning_instructions = '' %}
+{%- if ns_state.thinking %}
+    {%- if ns_state.effort == 'xhigh' %}
+        {%- set reasoning_instructions = 'Reasoning effort is set to xhigh. Please think carefully through the task, validate key assumptions, consider plausible alternatives, and prioritize correctness, consistency, and clarity in the final answer.' %}
+    {%- elif ns_state.effort == 'low' %}
+        {%- set reasoning_instructions = 'Reasoning effort is set to low. Keep your thinking brief and focused, moving directly to the conclusion without unnecessary elaboration.' %}
+    {%- endif %}
+{%- endif %}
+{%- macro render_content(content, do_vision_count, is_system_content=false) %}
+    {%- if content is string %}
+        {{- content }}
+    {%- elif content is iterable and content is not mapping %}
+        {%- for item in content %}
+            {%- if item is mapping %}
+                {%- if item.type == 'image' or 'image' in item or 'image_url' in item %}
+                    {%- if is_system_content %}
+                        {{- raise_exception('System message cannot contain images.') }}
+                    {%- endif %}
+                    {%- if do_vision_count %}
+                        {%- set image_count.value = image_count.value + 1 %}
+                    {%- endif %}
+                    {%- if add_vision_id %}
+                        {{- 'Picture ' ~ image_count.value ~ ': ' }}
+                    {%- endif %}
+                    {{- '<|vision_start|><|image_pad|><|vision_end|>' }}
+                {%- elif item.type == 'video' or 'video' in item %}
+                    {%- if is_system_content %}
+                        {{- raise_exception('System message cannot contain videos.') }}
+                    {%- endif %}
+                    {%- if do_vision_count %}
+                        {%- set video_count.value = video_count.value + 1 %}
+                    {%- endif %}
+                    {%- if add_vision_id %}
+                        {{- 'Video ' ~ video_count.value ~ ': ' }}
+                    {%- endif %}
+                    {{- '<|vision_start|><|video_pad|><|vision_end|>' }}
+                {%- elif 'text' in item %}
+                    {{- item.text }}
+                {%- else %}
+                    {{- raise_exception('Unexpected item type in content.') }}
+                {%- endif %}
+            {%- else %}
+                {{- item | string }}
+            {%- endif %}
+        {%- endfor %}
+    {%- elif content is none or content is undefined %}
+        {{- '' }}
+    {%- else %}
+        {{- raise_exception('Unexpected content type.') }}
+    {%- endif %}
+{%- endmacro %}
+{%- if not messages %}
+    {{- raise_exception('No messages provided.') }}
+{%- endif %}
+{%- set head = namespace(count=0, seen_non_system=false) %}
+{%- for message in messages %}
+    {%- set _is_sys = (message.role == 'system' or message.role == 'developer') %}
+    {%- if _is_sys and not head.seen_non_system %}
+        {%- set head.count = head.count + 1 %}
+    {%- else %}
+        {%- set head.seen_non_system = true %}
+    {%- endif %}
+{%- endfor %}
+{%- set sys_state = namespace(content='') %}
+{%- for message in messages[:head.count] %}
+    {%- set _part = render_content(message.content, false, true) | trim %}
+    {%- if '<|think_off|>' in _part %}{%- set _part = _part.split('<|think_off|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_on|>' in _part %}{%- set _part = _part.split('<|think_on|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_xhigh|>' in _part %}{%- set _part = _part.split('<|think_xhigh|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_high|>' in _part %}{%- set _part = _part.split('<|think_high|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_ultracode|>' in _part %}{%- set _part = _part.split('<|think_ultracode|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_extreme|>' in _part %}{%- set _part = _part.split('<|think_extreme|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_max|>' in _part %}{%- set _part = _part.split('<|think_max|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_medium|>' in _part %}{%- set _part = _part.split('<|think_medium|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_low|>' in _part %}{%- set _part = _part.split('<|think_low|>') | join('') | trim %}{%- endif %}
+    {%- if '<|think_minimal|>' in _part %}{%- set _part = _part.split('<|think_minimal|>') | join('') | trim %}{%- endif %}
+    {%- if _part %}
+        {%- if sys_state.content %}
+            {%- set sys_state.content = sys_state.content ~ '\n\n' ~ _part %}
+        {%- else %}
+            {%- set sys_state.content = _part %}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- set _sc = sys_state.content %}
+{%- set _msgs = messages[head.count:] %}
+{%- if ns_state.thinking %}
+    {%- set _terse_lead = 'Answer directly, after thinking. Lead with the answer, then only what it needs to be correct and usable.' %}
+{%- else %}
+    {%- set _terse_lead = 'Answer directly and concisely. Give the answer with only what it needs to be correct and usable.' %}
+{%- endif %}
+{%- set _terse_core %}
+Never: open with preamble or pleasantries; restate the question; add filler transitions; hedge with niceties; or repeat a point you've already made.
+Always: keep essential steps, caveats, uncertainties, and specifics — never drop correctness or a needed warning for brevity. Keep the final answer lean. Use the least structure that conveys it (plain prose when short; lists or code only when they earn their place). If genuinely uncertain, say so and explain why — never omit uncertainty for the sake of brevity.
+If a user request is genuinely ambiguous, ask a sharp question, don't guess.
+{%- endset %}
+{%- set _terse = _terse_lead ~ '\n' ~ (_terse_core | trim) %}
+{#- `terse` chat-template kwarg: default true, so behaviour is unchanged unless a caller opts out.
+    Pass {"terse": false} via chat_template_kwargs to serve the model with only its own system
+    prompt -- useful for A/B-ing the terseness effect, or when a downstream prompt conflicts. #}
+{%- set _terse_on = terse if terse is defined else true %}
+{%- if _terse_on %}
+    {%- if not _sc %}
+        {%- set _sc = _terse | trim %}
+    {%- else %}
+        {%- set _sc = (_sc | trim) ~ '\n\n' ~ (_terse | trim) %}
+    {%- endif %}
+{%- endif %}
+{%- if _has_tools %}
+    {{- '<|im_start|>system\n' }}
+    {%- if reasoning_instructions %}
+        {{- reasoning_instructions + '\n\n' }}
+    {%- endif %}
+    {{- '# Tools\n\nYou have access to the following functions:\n\n<tools>' }}
+    {%- for tool in tools %}
+        {{- '\n' }}
+        {{- tool | tojson }}
+    {%- endfor %}
+    {{- '\n</tools>' }}
+    {%- if _tool_format == 'json' %}
+        {{- '\n\nIf you choose to call a function ONLY reply in the following format with NO suffix:\n\n' }}{%- if ns_state.thinking %}{{- '<think>\nBrief explanation of tool call\n</think>\n' }}{%- endif %}{{- '<tool_call>\n{"name": "example_function_name", "arguments": {"example_parameter_1": "value_1", "example_parameter_2": "This is the value for the second parameter"}}\n</tool_call>\n\n<IMPORTANT>\nReminder:\n' }}{%- if ns_state.thinking %}{{- '- You can use the <think></think> block to plan your next tool call OR to synthesize data and formulate your final response to the user.\n- ALL explanation and reasoning MUST be placed strictly inside the <think></think> block.\n' }}{%- endif %}{{- '- Function calls MUST follow the specified format: a single JSON object with "name" and "arguments" keys inside <tool_call></tool_call> XML tags.\n- If you choose to call a tool, you MUST output the <tool_call> block IMMEDIATELY' }}{%- if ns_state.thinking %}{{- ' after thinking' }}{%- endif %}{{- ', with NO conversational text before it.\n- The <tool_call> tag MUST be at the very beginning of a new line, with NO spaces or indentation before it.\n- To call multiple functions, output a separate, completely closed <tool_call></tool_call> block for EACH function. Do NOT nest <tool_call> blocks.\n- If you have all necessary data, provide your final answer directly to the user without any tool call.\n</IMPORTANT>' }}
+    {%- else %}
+        {{- '\n\nIf you choose to call a function ONLY reply in the following format with NO suffix:\n\n' }}{%- if ns_state.thinking %}{{- '<think>\nBrief explanation of tool call\n</think>\n' }}{%- endif %}{{- '<tool_call>\n<function=example_function_name>\n<parameter=example_parameter_1>\nvalue_1\n</parameter>\n<parameter=example_parameter_2>\nThis is the value for the second parameter\nthat can span\nmultiple lines\n</parameter>\n</function>\n</tool_call>\n\n<IMPORTANT>\nReminder:\n' }}{%- if ns_state.thinking %}{{- '- You can use the <think></think> block to plan your next tool call OR to synthesize data and formulate your final response to the user.\n- ALL explanation and reasoning MUST be placed strictly inside the <think></think> block.\n' }}{%- endif %}{{- '- Function calls MUST follow the specified format: an inner <function=...></function> block must be nested within <tool_call></tool_call> XML tags.\n- If you choose to call a tool, you MUST output the <tool_call> block IMMEDIATELY' }}{%- if ns_state.thinking %}{{- ' after thinking' }}{%- endif %}{{- ', with NO conversational text before it.\n- The <tool_call> and <function> tags MUST be at the very beginning of a new line, with NO spaces or indentation before them.\n- To call multiple functions, output a separate, completely closed <tool_call></tool_call> block for EACH function. Do NOT nest <tool_call> blocks.\n- If you have all necessary data, provide your final answer directly to the user without any tool call.\n</IMPORTANT>' }}
+    {%- endif %}
+    {%- if _sc %}
+        {{- '\n\n' + _sc }}
+    {%- endif %}
+    {{- '<|im_end|>\n' }}
+{%- else %}
+    {%- if _sc %}
+        {{- '<|im_start|>system\n' + (reasoning_instructions + '\n\n' if reasoning_instructions else '') + _sc + '<|im_end|>\n' }}
+    {%- elif reasoning_instructions %}
+        {{- '<|im_start|>system\n' + reasoning_instructions + '<|im_end|>\n' }}
+    {%- endif %}
+{%- endif %}
+{%- set _last_idx = _msgs | length - 1 %}
+{%- set ns = namespace(multi_step_tool=true, last_query_index=_last_idx) %}
+{%- for message in _msgs[::-1] %}
+    {%- set index = (_msgs | length - 1) - loop.index0 %}
+    {%- if ns.multi_step_tool and message.role == 'user' %}
+        {%- set _rc = render_content(message.content, false) | trim %}
+        {%- if not (_rc.startswith('<tool_response>') and _rc.endswith('</tool_response>')) %}
+            {%- set ns.multi_step_tool = false %}
+            {%- set ns.last_query_index = index %}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- if ns.multi_step_tool %}
+    {%- if _last_idx > 50 %}
+        {%- set ns.last_query_index = _last_idx %}
+    {%- else %}
+        {%- set ns.last_query_index = 0 %}
+    {%- endif %}
+{%- endif %}
+{%- set ns2 = namespace(prev_role='', consecutive_failures=0) %}
+{%- for message in _msgs %}
+    {%- set is_system = (message.role == "system" or message.role == "developer") %}
+    {%- set content = render_content(message.content, true, is_system) | trim %}
+    {%- if is_system or message.role == 'user' %}
+        {%- if '<|think_off|>' in content %}{%- set content = content.split('<|think_off|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_on|>' in content %}{%- set content = content.split('<|think_on|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_xhigh|>' in content %}{%- set content = content.split('<|think_xhigh|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_high|>' in content %}{%- set content = content.split('<|think_high|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_ultracode|>' in content %}{%- set content = content.split('<|think_ultracode|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_extreme|>' in content %}{%- set content = content.split('<|think_extreme|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_max|>' in content %}{%- set content = content.split('<|think_max|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_medium|>' in content %}{%- set content = content.split('<|think_medium|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_low|>' in content %}{%- set content = content.split('<|think_low|>') | join('') | trim %}{%- endif %}
+        {%- if '<|think_minimal|>' in content %}{%- set content = content.split('<|think_minimal|>') | join('') | trim %}{%- endif %}
+    {%- endif %}
+    {%- if is_system %}
+        {{- '<|im_start|>system\n' + content + '<|im_end|>\n' }}
+    {%- elif message.role == 'user' %}
+        {%- set ns2.consecutive_failures = 0 %}
+        {{- '<|im_start|>user\n' + content + '<|im_end|>\n' }}
+    {%- elif message.role == 'assistant' %}
+        {%- set reasoning_content = '' %}
+        {%- set _explicit_reasoning = '' %}
+        {%- if message.reasoning_content is defined and message.reasoning_content is not none %}
+            {%- if message.reasoning_content is string %}
+                {%- set _explicit_reasoning = message.reasoning_content %}
+            {%- else %}
+                {%- set _explicit_reasoning = message.reasoning_content | string %}
+            {%- endif %}
+        {%- elif message.thinking is defined and message.thinking is not none %}
+            {%- if message.thinking is string %}
+                {%- set _explicit_reasoning = message.thinking %}
+            {%- else %}
+                {%- set _explicit_reasoning = message.thinking | string %}
+            {%- endif %}
+        {%- elif message.reasoning is defined and message.reasoning is not none %}
+            {%- if message.reasoning is string %}
+                {%- set _explicit_reasoning = message.reasoning %}
+            {%- else %}
+                {%- set _explicit_reasoning = message.reasoning | string %}
+            {%- endif %}
+        {%- endif %}
+        {%- if _explicit_reasoning %}
+            {%- set _lead_end = '' %}
+            {%- if content.startswith('<think>') and '</think>' in content %}
+                {%- set _lead_end = '</think>' %}
+            {%- elif content.startswith('<thinking>') and '</thinking>' in content %}
+                {%- set _lead_end = '</thinking>' %}
+            {%- elif content.startswith('</think>') %}
+                {%- set _lead_end = '</think>' %}
+            {%- elif content.startswith('</thinking>') %}
+                {%- set _lead_end = '</thinking>' %}
+            {%- endif %}
+            {%- if _lead_end %}
+                {%- set content = content.split(_lead_end)[-1].lstrip('\n') %}
+            {%- endif %}
+            {%- set reasoning_content = _explicit_reasoning %}
+        {%- else %}
+            {%- set _think_end = '' %}
+            {%- if content.startswith('</think>') %}
+                {%- set _think_end = '</think>' %}
+            {%- elif content.startswith('</thinking>') %}
+                {%- set _think_end = '</thinking>' %}
+            {%- elif '\n</think>' in content %}
+                {%- set _think_end = '\n</think>' %}
+            {%- elif '\n</thinking>' in content %}
+                {%- set _think_end = '\n</thinking>' %}
+            {%- elif '\n</ think>' in content %}
+                {%- set _think_end = '\n</ think>' %}
+            {%- elif '\n</think >' in content %}
+                {%- set _think_end = '\n</think >' %}
+            {%- elif content.startswith('<think>') and '</think>' in content %}
+                {%- set _think_end = '</think>' %}
+            {%- elif content.startswith('<thinking>') and '</thinking>' in content %}
+                {%- set _think_end = '</thinking>' %}
+            {%- endif %}
+            {%- if _think_end %}
+                {%- if 'thinking' in _think_end %}
+                    {%- set _think_start = '<thinking>' %}
+                {%- else %}
+                    {%- set _think_start = '<think>' %}
+                {%- endif %}
+                {%- set reasoning_content = content.split(_think_end)[0].rstrip('\n') %}
+                {%- if _think_start in reasoning_content %}
+                    {%- set reasoning_content = reasoning_content.split(_think_start)[-1].lstrip('\n') %}
+                {%- endif %}
+                {%- set content = content.split(_think_end)[-1].lstrip('\n') %}
+            {%- endif %}
+        {%- endif %}
+        {%- set reasoning_content = reasoning_content | trim %}
+        {%- if (_preserve_thinking or loop.index0 > ns.last_query_index) %}
+            {{- '<|im_start|>assistant\n<think>\n' + reasoning_content + '\n</think>\n\n' + content }}
+        {%- else %}
+            {{- '<|im_start|>assistant\n' + content }}
+        {%- endif %}
+        {%- if message.tool_calls is defined and message.tool_calls and message.tool_calls is iterable and message.tool_calls is not mapping %}
+            {%- for tool_call in message.tool_calls %}
+                {%- if tool_call.function is defined and tool_call.function is not none %}
+                    {%- set tc = tool_call.function %}
+                {%- else %}
+                    {%- set tc = tool_call %}
+                {%- endif %}
+                {%- set tc_name = tc.name if (tc.name is defined and tc.name is not none) else '' %}
+                {%- if _tool_format == 'json' %}
+                    {%- if loop.first %}
+                        {%- if content | trim %}
+                            {{- '\n\n' }}
+                        {%- endif %}
+                    {%- else %}
+                        {{- '\n' }}
+                    {%- endif %}
+                    {%- set _args = '{}' %}
+                    {%- if tc.arguments is defined and tc.arguments is not none %}
+                        {%- if tc.arguments is mapping %}
+                            {%- set _args = tc.arguments | tojson %}
+                        {%- elif tc.arguments is string %}
+                            {%- if tc.arguments %}
+                                {%- set _args = tc.arguments %}
+                            {%- endif %}
+                        {%- else %}
+                            {%- set _args = tc.arguments | tojson %}
+                        {%- endif %}
+                    {%- endif %}
+                    {{- '<tool_call>\n{"name": ' }}{{- tc_name | tojson }}{{- ', "arguments": ' }}{{- _args }}{{- '}\n</tool_call>' }}
+                {%- else %}
+                    {%- if loop.first %}
+                        {%- if content | trim %}
+                            {{- '\n\n<tool_call>\n<function=' + tc_name + '>\n' }}
+                        {%- else %}
+                            {{- '<tool_call>\n<function=' + tc_name + '>\n' }}
+                        {%- endif %}
+                    {%- else %}
+                        {{- '\n<tool_call>\n<function=' + tc_name + '>\n' }}
+                    {%- endif %}
+                    {%- if tc.arguments is defined and tc.arguments is not none %}
+                        {%- if tc.arguments is mapping %}
+                            {%- for args_name, args_value in tc.arguments.items() %}
+                                {{- '<parameter=' + args_name + '>\n' }}
+                                {%- if args_value is string %}
+                                    {%- set _av = args_value %}
+                                {%- else %}
+                                    {%- set _av = args_value | tojson %}
+                                {%- endif %}
+                                {%- if max_tool_arg_chars > 0 and _av | length > max_tool_arg_chars %}
+                                    {{- _av[:max_tool_arg_chars] + '\n[TRUNCATED - original length ' ~ (_av | length | string) ~ ' chars]' }}
+                                {%- else %}
+                                    {{- _av }}
+                                {%- endif %}
+                                {{- '\n</parameter>\n' }}
+                            {%- endfor %}
+                        {%- else %}
+                            {%- if tc.arguments is string %}
+                                {%- set _raw_args = tc.arguments %}
+                            {%- else %}
+                                {%- set _raw_args = tc.arguments | tojson %}
+                            {%- endif %}
+                            {%- if _raw_args %}
+                                {%- if max_tool_arg_chars > 0 and _raw_args | length > max_tool_arg_chars %}
+                                    {{- _raw_args[:max_tool_arg_chars] + '\n[TRUNCATED - original length ' ~ (_raw_args | length | string) ~ ' chars]' }}
+                                {%- else %}
+                                    {{- _raw_args }}
+                                {%- endif %}
+                            {%- endif %}
+                        {%- endif %}
+                    {%- endif %}
+                    {{- '</function>\n</tool_call>' }}
+                {%- endif %}
+            {%- endfor %}
+        {%- endif %}
+        {{- '<|im_end|>\n' }}
+    {%- elif message.role == 'tool' %}
+        {%- set _content_lower = content | lower %}
+        {%- set _content_head = _content_lower[:120] %}
+        {%- set _is_code_or_grep = ('throw new ' in _content_lower or 'throw error' in _content_lower or 'console.error' in _content_lower or 'logger.error' in _content_lower or 'logging.error' in _content_lower or 'import ' in _content_head or 'def ' in _content_head or 'function ' in _content_head) %}
+        {%- set _exit_code_zero = ('exit code: 0' in _content_head or 'process exited with code 0' in _content_head) %}
+        {%- set _error_field_ok = ('"error": null' in _content_head or '"error":null' in _content_head or '"error": false' in _content_head or '"error":false' in _content_head or '"error": ""' in _content_head or '"error":""' in _content_head) %}
+        {%- set _strong_error = (('"error":' in _content_head and not _error_field_ok) or '"status": "error"' in _content_head or '"status":"error"' in _content_head or 'traceback (most recent call last):' in _content_head or 'command not found' in _content_head or 'invalid syntax' in _content_head or 'fatal:' in _content_head or (('exit code: ' in _content_head or 'process exited with code' in _content_head) and not _exit_code_zero) or _content_head.startswith('exception:') or _content_head.startswith('failed to ')) %}
+        {%- set _weak_error = ('error:' in _content_head or 'err!' in _content_head) %}
+        {%- set _weak_suppressed = ('$ ' in _content_head or 'took ' in _content_head or content | length >= 600) %}
+        {%- if not _is_code_or_grep and (_strong_error or (_weak_error and not _weak_suppressed)) %}
+            {%- set ns2.consecutive_failures = ns2.consecutive_failures + 1 %}
+        {%- else %}
+            {%- set ns2.consecutive_failures = 0 %}
+        {%- endif %}
+        {%- if ns2.prev_role != 'tool' %}
+            {{- '<|im_start|>user' }}
+        {%- endif %}
+        {%- if _tool_format != 'json' and max_tool_response_chars > 0 and content | length > max_tool_response_chars %}
+            {%- set content = content[:max_tool_response_chars] + '\n[TRUNCATED - original length ' ~ (content | length | string) ~ ' chars]' %}
+        {%- endif %}
+        {{- '\n<tool_response>\n' + content }}
+        {%- if ns2.consecutive_failures >= 2 %}
+            {{- '\n\n⚠️ SYSTEM WARNING: ' ~ ns2.consecutive_failures ~ ' consecutive tool errors detected. Your previous approach is incorrect. You MUST use a fundamentally different approach or corrected arguments.' }}
+        {%- elif ns2.consecutive_failures == 1 %}
+            {{- '\n\n⚠️ SYSTEM WARNING: The previous tool call returned an error. Diagnose the failure and retry with completely corrected arguments.' }}
+        {%- endif %}
+        {{- '\n</tool_response>' }}
+        {%- if loop.last %}
+            {{- '<|im_end|>\n' }}
+        {%- else %}
+            {%- set _next_role = _msgs[loop.index0 + 1].role %}
+            {%- if _next_role != 'tool' %}
+                {{- '<|im_end|>\n' }}
+            {%- endif %}
+        {%- endif %}
+    {%- else %}
+        {{- '<|im_start|>user\n[' + message.role + ']: ' + content + '<|im_end|>\n' }}
+    {%- endif %}
+    {%- set ns2.prev_role = message.role %}
+{%- endfor %}
+{%- if add_generation_prompt %}
+    {{- '<|im_start|>assistant\n' }}
+    {%- if not ns_state.thinking %}
+        {{- '<think>\n\n</think>\n\n' }}
+    {%- else %}
+        {{- '<think>\n' }}
+    {%- endif %}
+{%- endif %}

scripts/searxng-render-settings.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""Render ${VAR} placeholders in the live SearXNG settings.yml from the
+host-side env file.
+
+Why this exists: SearXNG does NOT expand environment variables inside
+settings.yml. The repo-tracked shared/searxng/settings.yml deliberately keeps
+secrets as "${KAGI_API_KEY}"-style placeholders so no key ever enters git; the
+deployer copies that file to /opt/searxng/config/settings.yml and runs this
+script to bake in the real values. Without it the app runs with the literal
+placeholder strings (observed 2026-09-26: secret_key literally
+"${SEARXNG_SECRET}" and the Kagi engine failing setup() on an empty key).
+
+Only the allowlisted names are substituted. A placeholder that has no value in
+the env file is a deploy-blocking error: serving a paid-API engine with a
+literal "${KAGI_API_KEY}" bearer would waste requests and hide the misconfig.
+
+Usage: searxng-render-settings.py ENV_FILE SETTINGS_FILE
+Both paths are taken as arguments; secrets never appear in any argv.
+Exit codes: 0 rendered (idempotent on an already-rendered file), 1 unresolved
+placeholder, 2 usage error.
+"""
+
+import sys
+
+ALLOWED = ("KAGI_API_KEY", "SEARXNG_SECRET", "SEARXNG_BASE_URL")
+
+
+def load_env(path: str) -> dict[str, str]:
+    values: dict[str, str] = {}
+    with open(path, encoding="utf-8") as fh:
+        for line in fh:
+            line = line.strip()
+            if not line or line.startswith("#") or "=" not in line:
+                continue
+            key, _, value = line.partition("=")
+            if key in ALLOWED:
+                values[key] = value
+    return values
+
+
+def main(argv: list[str]) -> int:
+    args = [a for a in argv[1:]]
+    if len(args) != 2:
+        print(
+            "usage: searxng-render-settings.py ENV_FILE SETTINGS_FILE",
+            file=sys.stderr,
+        )
+        return 2
+    env_file, settings_file = args
+
+    values = load_env(env_file)
+    with open(settings_file, encoding="utf-8") as fh:
+        text = fh.read()
+
+    for name in ALLOWED:
+        if name in values:
+            text = text.replace("${%s}" % name, values[name])
+
+    unresolved = [n for n in ALLOWED if "${%s}" % n in text]
+    if unresolved:
+        print(
+            "unresolved placeholders in %s: %s (missing from %s)"
+            % (settings_file, ", ".join(unresolved), env_file),
+            file=sys.stderr,
+        )
+        return 1
+
+    with open(settings_file, "w", encoding="utf-8") as fh:
+        fh.write(text)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv))

scripts/serve-frank-large.sh

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# Serve unsloth/Qwen3.8-27B-GGUF:UD-Q8_K_XL as frank-large on
+# Dankclaw's Strix Halo iGPU (gfx1151), using stock llama.cpp
+# (mainline, the unsloth b11030 prebuilt).
+#
+# Runtime: /home/dank/GitPackages/unsloth-llama-b11030/llama-server
+# (mainline, ROCm gfx1151 prebuilt). The build supports the qwen3_5
+# architecture and the DFlash2 drafter (llama_model_qwen35,
+# llama_model_dflash, common_speculative_impl_draft_dflash).
+#
+# Shape: one stream, full 262144 context (the model's native window), all
+# layers on the iGPU (--n-gpu-layers 999). The 27B dense model (31.46 GiB GGUF) + the
+# DFlash2 drafter (1.14 GiB) + q8_0 KV (~8.6 GiB) + compute buffers fits the
+# iGPU's GTT aperture (~114 GiB).
+#
+# Spec method: DFlash2 (a block-diffusion drafter) at depth 4. The drafter
+# has a sliding window of 2048 (small draft KV, ~40 MiB).
+#
+# KV: q8_0 quantized (--cache-type-k q8_0 --cache-type-v q8_0). The unsloth b11030
+# build does not support fp8 KV (allowed: f32/f16/bf16/q8_0/q4_0/q4_1/iq4_nl/q5_0/
+# q5_1); q8_0 is the highest-precision 8-bit option and preserves the ~8 GiB footprint.
+#
+# Text-only (no mmproj) — matching the prior frank-large.
+#
+# The Qwen3.8 family template keeps prior thinking blocks across turns when
+# preserve_thinking is set; pass --jinja and the kwarg so multi-turn agents
+# do not lose the trail. The template gates reasoning_effort to {xhigh,
+# medium, low} — the harness folds its levels onto that set in models.yml
+# (reasoningEffortMap).
+#
+# Tunables come from frank-large.env unless FRANK_LARGE_ENV_FILE overrides
+# it; anything not set there falls through to the defaults below.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+ENV_FILE="${FRANK_LARGE_ENV_FILE:-$SCRIPT_DIR/frank-large.env}"
+if [[ -f "$ENV_FILE" ]]; then
+    set -a
+    source "$ENV_FILE"
+    set +a
+fi
+
+# --- defaults (used when the env file does not set them) ------------------
+: "${RUNTIME_DIR:=/home/dank/GitPackages/unsloth-llama-b11030}"
+: "${MODEL_DIR:=/home/dank/models/Qwen3.8-27B-UD-Q8_K_XL}"
+: "${HOST:=0.0.0.0}"
+: "${PORT:=7770}"
+: "${CONTEXT_SIZE:=262144}"
+: "${PARALLEL_SLOTS:=1}"
+: "${SPEC_DRAFT_N_MAX:=4}"
+: "${CACHE_RAM:=8192}"
+TEMPLATE_FILE="${TEMPLATE_FILE:-$SCRIPT_DIR/qwen-sharp-v22.4.0.jinja}"
+
+SERVER_BIN="$RUNTIME_DIR/llama-server"
+MODEL_FILE="$MODEL_DIR/Qwen3.8-27B-UD-Q8_K_XL.gguf"
+DRAFTER_FILE="$MODEL_DIR/Qwen3.8-27B-DFlash2-Q4_K_M.gguf"
+
+if [[ ! -x "$SERVER_BIN" ]]; then
+    echo "runtime not found at $SERVER_BIN" >&2
+    exit 1
+fi
+for f in "$MODEL_FILE" "$DRAFTER_FILE"; do
+    if [[ ! -f "$f" ]]; then
+        echo "missing asset $f (run scripts/download-frank-large.sh)" >&2
+        exit 1
+    fi
+done
+
+# --- env (the unsloth build's ROCm setup) --------------------------------
+export HIP_VISIBLE_DEVICES=0
+export HSA_OVERRIDE_GFX_VERSION=11.5.1
+export LD_LIBRARY_PATH="/opt/rocm/lib:/opt/rocm/llvm/lib:${LD_LIBRARY_PATH:-}"
+
+# --- the serve command ---------------------------------------------------
+ARGS=(
+    --host "$HOST"
+    --port "$PORT"
+    --model "$MODEL_FILE"
+    --alias frank-large
+    --ctx-size "$CONTEXT_SIZE"
+    --parallel "$PARALLEL_SLOTS"
+    --n-gpu-layers 999
+    --jinja
+    --metrics
+    --chat-template-file "$TEMPLATE_FILE"
+    --chat-template-kwargs '{"preserve_thinking":true}'
+    --cache-type-k q8_0
+    --cache-type-v q8_0
+    --cache-ram "$CACHE_RAM"
+    # DFlash2 spec decode (a block-diffusion drafter)
+    --spec-type draft-dflash
+    --model-draft "$DRAFTER_FILE"
+    --spec-draft-n-max "$SPEC_DRAFT_N_MAX"
+    --spec-draft-n-min 0
+    --spec-draft-device ROCm0
+    # Greedy sampling (the DFlash2 drafter needs greedy verification)
+    --temp 0
+    --top-p 1.0
+    --top-k 0
+    --min-p 0.0
+    # Reasoning (thoughts land in reasoning_content)
+    --reasoning auto
+    --reasoning-format deepseek
+    --reasoning-budget -1
+)
+
+exec "$SERVER_BIN" "${ARGS[@]}"

scripts/serve-frank-primary.sh

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+# serve-frank-primary.sh — frank-primary endpoint (R9V radiance-vLLM fork,
+# unsloth Qwen3.8-Flash-Next Q8_0 + MTP4 drafter, 2x R9700, dankserver
+# :7770; 2026-09-27 cutover from the uncensored IQ4_XS payload, whose state
+# dir stays on disk as the rollback target).
+#
+# The engine is the upstream R9V launcher (scripts/launch.sh in the fork
+# checkout), NOT a hand-frozen podman argv: launch.sh owns the resolved
+# docker/podman args (binds, overlays, device passthrough, publish lines)
+# and the fork's qualification was measured through it. This script's job:
+#
+#   1. layer the on-host R9V setup state (the 104-key tuned shape the
+#      profile setup qualified) under this repo's frank-primary.env
+#      overrides (bind/port/alias/container);
+#   2. gate on the pinned runtime image (by its OCI manifest digest, the
+#      podman RepoDigest), the exact-size PLE payload, and the GGUF shards;
+#   3. exec the launcher, then wait on the container: launch.sh --detach
+#      exits as soon as the container is created, so without the wait the
+#      unit would be "green" while the engine crashes — the wait is what
+#      keeps systemd's Restart=on-failure self-healing real.
+#
+# The root unit (scripts/frank-primary.service, User=dank,
+# LimitMEMLOCK=infinity) grants the pin budget for the tiered-expert UVA
+# host copy and the PLE pinned residency (54.4 GB on the q8 payload). A
+# plain shell session also works (proven 2026-09-27: podman rootless
+# inherits usable limits here), but the unit is the fleet-parity
+# boot-persistent shape.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ENV_FILE="${FRANK_PRIMARY_ENV_FILE:-$SCRIPT_DIR/frank-primary.env}"
+
+if [ ! -f "$ENV_FILE" ]; then
+    echo "serve-frank-primary: env file missing: $ENV_FILE" >&2
+    exit 1
+fi
+set -a
+# shellcheck disable=SC1090
+source "$ENV_FILE"
+set +a
+
+: "${R9V_HOME:?R9V_HOME must name the fork checkout}"
+: "${R9V_STATE_FILE:?R9V_STATE_FILE must name the setup state}"
+: "${R9V_HOST_BIND:?R9V_HOST_BIND must be set}"
+: "${R9V_HOST_PORT:?R9V_HOST_PORT must be set}"
+: "${R9V_SERVED_MODEL_NAME:?R9V_SERVED_MODEL_NAME must be set}"
+: "${R9V_CONTAINER_NAME:?R9V_CONTAINER_NAME must be set}"
+
+LAUNCHER="$R9V_HOME/scripts/launch.sh"
+if [ ! -x "$LAUNCHER" ]; then
+    echo "serve-frank-primary: R9V launcher missing: $LAUNCHER" >&2
+    exit 1
+fi
+
+# The docker->podman shim is REQUIRED: the launcher and its doctor speak
+# docker (OCI-manifest-digest image IDs, LogConfig fields) that podman's
+# native CLI answers differently. The shim carries those laws.
+SHIM_DIR="$R9V_HOME/.podman-shim"
+if [ ! -x "$SHIM_DIR/docker" ]; then
+    echo "serve-frank-primary: docker->podman shim missing: $SHIM_DIR/docker" >&2
+    exit 1
+fi
+export PATH="$SHIM_DIR:$PATH"
+
+# --- layer 1: the qualified setup state (production overrides never come
+# from here; keys already defined in the env file are skipped) -------------
+STATE_FILE="$R9V_STATE_FILE"
+if [ ! -f "$STATE_FILE" ]; then
+    echo "serve-frank-primary: R9V setup state missing: $STATE_FILE" >&2
+    echo "  run the profile setup first (tools/setup_profile.py setup --state-dir ...)" >&2
+    exit 1
+fi
+STATE_EXPORTS="$(python3 - "$STATE_FILE" <<'PY'
+import json, shlex, sys, os
+state = json.load(open(sys.argv[1]))
+config = state.get("config") or {}
+if state.get("ready") is not True:
+    sys.exit("R9V setup state is not ready; rerun setup before serving")
+env_keys = {k for k in os.environ if k.startswith("R9V_")}
+for key in sorted(config):
+    if key.startswith("R9V_") and key not in env_keys:
+        print(f"export {key}={shlex.quote(config[key])}")
+PY
+)"
+eval "$STATE_EXPORTS"
+
+: "${R9V_IMAGE:?state must carry R9V_IMAGE}"
+: "${R9V_MODEL_DIR:?state must carry R9V_MODEL_DIR}"
+: "${R9V_PLE_PATH:?state must carry R9V_PLE_PATH}"
+
+# --- gates: never serve a half-finished payload or a missing image --------
+# Runtime image by pinned OCI manifest digest (podman keys images by config
+# digest but preserves the manifest digest in RepoDigests — the shim's ID law).
+if ! podman images --format '{{.RepoDigests}}' | grep -qF "${R9V_IMAGE#sha256:}"; then
+    echo "serve-frank-primary: pinned R9V image absent: $R9V_IMAGE" >&2
+    echo "  load the pinned image bundle into podman rootless storage" >&2
+    exit 1
+fi
+
+# PLE payload at its pinned byte count (stat -c %s, never wc -c), plus the
+# six target GGUF shards (mradermacher-style split parts) and the mmproj
+# the launcher mounts.
+PLE_BYTES="${R9V_PLE_EXPECTED_BYTES:-}"
+if [ -n "$PLE_BYTES" ]; then
+    ACTUAL="$(stat -c %s "$R9V_PLE_PATH" 2>/dev/null || echo 0)"
+    if [ "$ACTUAL" != "$PLE_BYTES" ]; then
+        echo "serve-frank-primary: PLE payload wrong size: $R9V_PLE_PATH" >&2
+        echo "  expected $PLE_BYTES, found $ACTUAL" >&2
+        exit 1
+    fi
+else
+    if [ ! -f "$R9V_PLE_PATH" ]; then
+        echo "serve-frank-primary: PLE payload missing: $R9V_PLE_PATH" >&2
+        exit 1
+    fi
+fi
+for rel in "$R9V_TARGET_REL" "${R9V_TARGET_SHARD2_REL:-}" "${R9V_TARGET_SHARD3_REL:-}" \
+    "${R9V_TARGET_SHARD4_REL:-}" "${R9V_TARGET_SHARD5_REL:-}" "${R9V_TARGET_SHARD6_REL:-}" \
+    "$R9V_MMPROJ_REL"; do
+    if [ -z "$rel" ]; then continue; fi
+    if [ ! -f "$R9V_MODEL_DIR/$rel" ]; then
+        echo "serve-frank-primary: payload file missing: $R9V_MODEL_DIR/$rel" >&2
+        exit 1
+    fi
+done
+
+if [ ! -e /dev/kfd ] || [ ! -d /dev/dri ]; then
+    echo "serve-frank-primary: GPU device nodes absent (/dev/kfd, /dev/dri)" >&2
+    exit 1
+fi
+
+# A crashed/killed unit can leave the container name registered (systemd
+# SIGKILLs conmon before cleanup runs); the launcher refuses an existing
+# name forever after. Clear any orphan of OUR name first — idempotent.
+docker rm -f "$R9V_CONTAINER_NAME" >/dev/null 2>&1 || true
+
+# launch.sh detaches after preflight; from here on, this script's lifetime
+# IS the container's: wait returns the container's exit code, so a crash is
+# a nonzero ExecStart and Restart=on-failure fires. (systemd stop goes
+# through ExecStop in the unit — docker wait alone cannot stop the child.)
+"$LAUNCHER"
+exec docker wait "$R9V_CONTAINER_NAME"

scripts/serve-frank-small.sh

@@ -1,20 +1,29 @@
 #!/usr/bin/env bash
-# Serve ISTA-DASLab/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp as frank-small on Dankclaw's
-# RTX 3090 via mainline llama.cpp.
+# Serve HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced (Q4_K_M) as
+# frank-small on Dankclaw's RTX 3090 via mainline llama.cpp.
 #
-# Topology: the whole model lives in VRAM (-ngl 999) -- 11.29 GiB of IQ3_S-mtp
-# weights, 0.87 GiB of BF16 vision projector and ~8 GiB of f16 KV inside the
-# card's 24 GiB. The host CPU only tokenizes and samples here; this box's CPU
+# Topology: the whole model lives in VRAM (-ngl 999) -- 6.87 GiB of Q4_K_M
+# weights plus the BF16 vision projector and q8_0 KV inside the card's
+# 24 GiB. The host CPU only tokenizes and samples here; this box's CPU
 # belongs to the halogen engine that serves frank-large.
 #
-# MTP: the `-mtp` build carries the NextN block (blk.64.nextn.*), and
-# `--spec-type draft-mtp` makes llama.cpp load it and run the draft context on
-# the SAME weights. There is no --model-draft here on purpose: a separate draft
-# path would load a second 12 GB copy of a 12 GB model. Draft depth is
-# llama.cpp's default (--spec-draft-n-max 3).
+# MTP: this model's Multi-Token Prediction head ships as a SEPARATE file
+# (mtp-gemma-4-12B-it.gguf, arch gemma4-assistant, 4 nextn layers). It is
+# passed via --model-draft with --spec-type draft-mtp: the draft context
+# loads the assistant model. The same --spec-type value chains the
+# draftless ngram-mod matcher, which attaches unconditionally; two
+# context-backed drafters cannot share one process, so this chain is the
+# only shape that carries both.
 #
-# Vision: --mmproj loads the BF16 projector, so image content parts work. The
-# fleet's image path moved here from frank-large on 2026-09-16, which is why
+# Context: CTX_SIZE is set explicitly to PARALLEL x 262144 so every slot
+# gets the model's FULL window; --fit (the CTX_SIZE-unset branch below)
+# maximises the TOTAL pool instead, which would divide a smaller window
+# across slots. The 4-slot layout is measured to fit the card (see the
+# SIZING note in frank-small.env); more slots would fail the KV allocation.
+#
+# Vision + audio: --mmproj loads the BF16 projector, which also carries
+# an audio encoder — input_audio content parts transcribe verbatim
+# (verified 2026-09-17). The fleet's image path lives here, which is why
 # halogen no longer sets HALOGEN_VISION_TOWER.
 #
 # Sampling: greedy by default (the fleet contract). Clients that send their own
@@ -40,16 +49,23 @@ fi
 : "${LLAMA_BIN:=/home/dank/GitPackages/llama.cpp-mainline/build-cuda/bin/llama-server}"
 : "${MODEL_DIR:=/home/dank/models/Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp}"
 : "${MODEL_FILE:=Qwen3.8-27B-GSQ-RCO-IQ3_S-mtp.gguf}"
-: "${MMPROJ_PATH:=$MODEL_DIR/mmproj-Qwen3.8-27B-BF16.gguf}"
+: "${MMPROJ_PATH:=$MODEL_DIR/mmproj-Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-BF16.gguf}"
+: "${DRAFT_FILE:=}"
 : "${ALIAS:=frank-small}"
 : "${BIND_ADDR:=0.0.0.0}"
 : "${LISTEN_PORT:=7771}"
-: "${CTX_SIZE:=131072}"
+: "${CTX_SIZE:=}"
 : "${PARALLEL:=1}"
 : "${CACHE_TYPE_K:=f16}"
 : "${CACHE_TYPE_V:=f16}"
+: "${CACHE_RAM:=8192}"
 : "${BATCH_SIZE:=2048}"
 : "${UBATCH_SIZE:=512}"
+# Decode-shape knobs: the MTP drafter's per-round proposal length (build
+# default 3; the Gemma4 sidecar carries 4 nextn layers) and the engine's
+# busy-wait level (build default 50).
+: "${SPEC_DRAFT_N_MAX:=3}"
+: "${POLL_LEVEL:=50}"
 : "${NUM_THREADS:=8}"
 : "${THREAD_BATCH:=8}"
 : "${NGL:=999}"
@@ -65,6 +81,9 @@ fi
 for path in "$LLAMA_BIN" "$MODEL_DIR/$MODEL_FILE" "$MMPROJ_PATH"; do
     [[ -e "$path" ]] || { echo "frank-small: missing $path" >&2; exit 1; }
 done
+if [[ -n "${DRAFT_FILE:-}" ]]; then
+    [[ -e "$MODEL_DIR/$DRAFT_FILE" ]] || { echo "frank-small: missing $MODEL_DIR/$DRAFT_FILE" >&2; exit 1; }
+fi
 
 # The UVM device node is created lazily by nvidia-modprobe on the first CUDA
 # open after boot; make sure it exists before the server needs it.
@@ -77,25 +96,42 @@ fi
 
 SPEC_ARGS=()
 if [[ -n "${SPEC_TYPE:-}" && "$SPEC_TYPE" != "none" ]]; then
-    SPEC_ARGS=(--spec-type "$SPEC_TYPE")
+    SPEC_ARGS=(--spec-type "$SPEC_TYPE" --spec-draft-n-max "$SPEC_DRAFT_N_MAX")
+fi
+
+DRAFT_ARGS=()
+if [[ -n "${DRAFT_FILE:-}" ]]; then
+    DRAFT_ARGS=(--model-draft "$MODEL_DIR/$DRAFT_FILE")
+fi
+
+# CTX_SIZE set -> pinned context. Unset -> --fit sizes the KV pool against
+# whatever the weights, projector, draft context and compute buffers leave
+# on the card; the engine prints the chosen value at startup.
+if [[ -n "${CTX_SIZE:-}" ]]; then
+    CTX_ARGS=(--ctx-size "$CTX_SIZE")
+else
+    CTX_ARGS=(--fit on)
 fi
 
 exec "$LLAMA_BIN" \
     --model "$MODEL_DIR/$MODEL_FILE" \
     "${MMPROJ_ARGS[@]}" \
+    "${DRAFT_ARGS[@]}" \
     --alias "$ALIAS" \
     --host "$BIND_ADDR" \
     --port "$LISTEN_PORT" \
     --gpu-layers "$NGL" \
     --flash-attn "$FLASH_ATTN" \
-    --ctx-size "$CTX_SIZE" \
+    "${CTX_ARGS[@]}" \
     --parallel "$PARALLEL" \
     --batch-size "$BATCH_SIZE" \
     --ubatch-size "$UBATCH_SIZE" \
     --threads "$NUM_THREADS" \
     --threads-batch "$THREAD_BATCH" \
+    --poll "$POLL_LEVEL" \
     --cache-type-k "$CACHE_TYPE_K" \
     --cache-type-v "$CACHE_TYPE_V" \
+    --cache-ram "$CACHE_RAM" \
     "${SPEC_ARGS[@]}" \
     --jinja \
     --metrics \

scripts/signal-relay.py

@@ -0,0 +1,176 @@
+#!/usr/bin/env python3
+"""Alertmanager-to-Signal relay for the homelab (Dankclaw).
+Listens on 192.168.0.143:18093 (the host's LAN IP) and receives
+Alertmanager's webhook payload from the container as
+host.containers.internal:18093 — netavark delivers that address to the
+host's LAN IP, which is the one bind a bridge container can reach (a
+loopback bind refuses it, and 169.254.1.2 is not a local address here).
+The group is formatted into a short message and handed to signal-cli under
+the existing account on this host. Runs as a systemd user unit
+(scripts/signal-relay.service); logs go to the journal.
+
+The phone number and account name are numbers, not credentials — the
+credential is the signal-cli account state under
+~/.local/share/signal-cli, which never leaves the host.
+
+Stdlib only: this box's user units run the system python3.
+"""
+
+import json
+import shutil
+import subprocess
+import sys
+import time
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+
+# The bind address is the one detail this design gets wrong twice
+# (2026-09-17): a loopback bind refuses container traffic ("dial tcp
+# 169.254.1.2:18093: connection refused"), and 169.254.1.2 itself is not a
+# local address on this host ("Cannot assign requested address") — netavark
+# runs the bridges in aardvark-dns' netns, not the host's. Traffic that
+# arrives as 169.254.1.2 lands on the host's LAN IP, so bind THAT. The
+# deployer installs an iptables INPUT rule that admits 18093/tcp from the
+# podman bridge subnet (10.89.0.0/16) only, keeping the unauthenticated
+# endpoint off the rest of the LAN.
+LISTEN_ADDR = ("192.168.0.143", 18093)
+# The account is addressed by phone number: signal-cli 0.14.7's -a flag
+# parses an all-digit value as a phone number and never falls back to the
+# accounts.json name (the numeric name 318311 dies with "Invalid account
+# (phone number)"). The number is a number, not a credential — the
+# credential is the account state under ~/.local/share/signal-cli.
+SIGNAL_ACCOUNT = "+12062476336"
+SIGNAL_TO = "+12062476336"
+SIGNAL_CLI = "/usr/local/bin/signal-cli"
+
+# The relay is a safety net, not the rate limiter: Alertmanager already
+# repeats on repeat_interval. This suppresses exact duplicates that arrive
+# inside the window (config reloads, double-fires) so a misconfiguration
+# cannot fill the phone.
+DEDUPE_SECONDS = 15 * 60
+_last_sent = {}
+
+# Cap on the instances listed per group; the count is always stated.
+MAX_INSTANCES = 3
+
+
+def log(msg):
+    print(f"signal-relay: {msg}", file=sys.stderr, flush=True)
+
+
+def format_group(alerts):
+    """One message per webhook delivery (Alertmanager groups by alertname)."""
+    if not alerts:
+        return None
+    first = alerts[0]
+    name = first.get("labels", {}).get("alertname", "unknown")
+    state = "firing" if first.get("status") == "firing" else "resolved"
+    severity = first.get("labels", {}).get("severity", "info").upper()
+    lines = [f"[{severity}] {name} ({len(alerts)} {state})"]
+    for a in alerts[:MAX_INSTANCES]:
+        labels = a.get("labels", {})
+        ident = labels.get("instance") or labels.get("job") or "?"
+        summary = (a.get("annotations") or {}).get("summary")
+        line = f"  {ident}"
+        if summary:
+            line += f": {summary}"
+        lines.append(line)
+    if len(alerts) > MAX_INSTANCES:
+        lines.append(f"  … and {len(alerts) - MAX_INSTANCES} more")
+    return "\n".join(lines)
+
+
+def dedupe_key(alerts):
+    first = alerts[0]
+    labels = tuple(sorted(first.get("labels", {}).items()))
+    return (first.get("status"),) + labels
+
+
+def send_signal(text):
+    if shutil.which(SIGNAL_CLI) is None:
+        log(f"signal-cli not found at {SIGNAL_CLI}")
+        return False
+    try:
+        proc = subprocess.run(
+            [SIGNAL_CLI, "-a", SIGNAL_ACCOUNT, "-o", "json", "send", SIGNAL_TO,
+             "-m", text],
+            capture_output=True, text=True, timeout=30,
+        )
+    except subprocess.TimeoutExpired:
+        log("signal-cli timed out after 30s")
+        return False
+    if proc.returncode != 0:
+        log(f"signal-cli failed rc={proc.returncode}: {proc.stderr.strip()[:300]}")
+        return False
+    return True
+
+
+def handle_alertmanager(payload):
+    alerts = payload.get("alerts", [])
+    text = format_group(alerts)
+    if text is None:
+        log("empty alert group, nothing sent")
+        return
+    now = time.monotonic()
+    key = dedupe_key(alerts)
+    # Prune in place: rebinding _last_sent here would make it local to this
+    # function and the read above the assignment raises UnboundLocalError
+    # (measured 2026-09-17: every webhook died on it).
+    stale = [k for k, v in _last_sent.items() if now - v >= DEDUPE_SECONDS]
+    for k in stale:
+        del _last_sent[k]
+    if key in _last_sent:
+        log(f"suppressed duplicate: {key[0]}")
+        return
+    if send_signal(text):
+        _last_sent[key] = now
+        log(f"sent to {SIGNAL_TO}: {text.splitlines()[0]}")
+    else:
+        # Do not mark a failed send: the next repeat should retry.
+        log("send failed; will retry on the next delivery")
+
+
+class Handler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        if self.path == "/health":
+            self.send_response(200)
+            self.end_headers()
+            self.wfile.write(b"ok")
+        else:
+            self.send_response(404)
+            self.end_headers()
+
+    def do_POST(self):
+        if self.path != "/alertmanager":
+            self.send_response(404)
+            self.end_headers()
+            return
+        length = int(self.headers.get("Content-Length", 0))
+        try:
+            payload = json.loads(self.rfile.read(length))
+        except (ValueError, UnicodeDecodeError) as e:
+            log(f"bad payload: {e}")
+            self.send_response(400)
+            self.end_headers()
+            return
+        try:
+            handle_alertmanager(payload)
+        except Exception as e:  # a relay bug must not 500 Alertmanager
+            log(f"handler error: {e!r}")
+        self.send_response(200)
+        self.end_headers()
+        self.wfile.write(b"ok")
+
+    def log_message(self, fmt, *args):
+        # Default access log is per-request noise; the journal keeps the
+        # send/suppress lines, which are the ones that matter.
+        pass
+
+
+def main():
+    server = ThreadingHTTPServer(LISTEN_ADDR, Handler)
+    log(f"listening on {'.'.join(map(str, LISTEN_ADDR))}, account {SIGNAL_ACCOUNT}")
+    server.serve_forever()
+
+
+if __name__ == "__main__":
+    main()

scripts/signal-relay.service

@@ -0,0 +1,37 @@
+# Systemd USER unit: signal-relay (Dankclaw).
+#
+# Install path: ~/.config/systemd/user/signal-relay.service
+# Installed and enabled by install_signal_relay in scripts/deploy-remote.sh
+# (part of the alertmanager deploy).
+#
+# The webhook consumer for Alertmanager: it listens on loopback only and is
+# the only thing on this host that talks to signal-cli. It is a plain user
+# unit, not a quadlet, on purpose:
+#
+#   * it runs python3 straight from the checkout, so a deploy updates the
+#     relay without a copy step (the homepage timer copies to
+#     /usr/local/bin; this one has no root side);
+#   * generated quadlet units cannot be enabled on this host's podman 5.x
+#     v1 generator — a hand-written user unit can, and with Linger=yes for
+#     dank it starts at boot;
+#   * it needs no container: its only dependencies are /usr/bin/python3
+#     (system) and /usr/local/bin/signal-cli (host install, account state
+#     under ~/.local/share/signal-cli).
+#
+# Loopback-only for the same reason every observability port is: an
+# unauthenticated message-sending endpoint has no business on a host
+# interface. Alertmanager reaches it from its container via
+# host.containers.internal.
+
+[Unit]
+Description=Alertmanager-to-Signal relay (Dankclaw)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=/usr/bin/python3 /home/dank/serverAppConfigs/scripts/signal-relay.py
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target

scripts/test-changed.sh

@@ -180,18 +180,30 @@ for path in "${CHANGED[@]}"; do
         scripts/mount-entropy.sh)
             add_test tests/mount_entropy.bats
             ;;
-        # frank-medium is llama.cpp on the two R9700s as a ROOT unit since
-        # 2026-09-16: a native gfx1201 HIP binary, so (like frank-small) its
-        # env, unit and serve script all live in scripts/, and this case has to
-        # precede the generic scripts/*.service fallback below. The retired
-        # vllm-radiance service dir is under dankserver/.AGENTTRASH/, which is
-        # archive material and maps to nothing.
-        scripts/frank-medium.*|scripts/serve-frank-medium.sh)
-            add_test tests/frank_medium_unit.bats
+        # Archive material: a path under any .AGENTTRASH/ directory is
+        # retired-by-policy (deploy-plan.py plans nothing from it), so it
+        # selects no focused test. It still needs its own case: without one
+        # the wrapper refuses retirement commits, whose trash moves show up
+        # as additions, with "no focused-test mapping".
+        .AGENTTRASH/*|*/.AGENTTRASH/*)
+            ;;
+        # frank-primary is llama.cpp (the unsloth b11030-mix prebuilt) on the
+        # two R9700s as a ROOT unit — the 2026-09-26 swap that replaced the
+        # Lucebox DS4.1 quadlet on :7770. Its env, unit and serve script all
+        # live in scripts/, which is why this case has to precede the generic
+        # scripts/*.service and scripts/* fallbacks below.
+        scripts/frank-primary.*|scripts/serve-frank-primary.sh)
+            add_test tests/frank_primary_unit.bats
             add_test tests/llm_units.bats
             add_test tests/deployment_scoping.bats
             add_test tests/scripts_syntax.bats
             ;;
+        # frank-large's chat template lives in scripts/ (moved there on
+        # 2026-09-26 when its old home was retired): a template edit changes
+        # what the live endpoint renders, so it selects the large unit seam.
+        scripts/qwen-sharp-v22.4.0.jinja)
+            add_test tests/frank_large_unit.bats
+            ;;
         # frank-small is llama.cpp on the 3090 as a ROOT unit: a native CUDA
         # binary, so no generated quadlet is involved. Its env, unit and serve
         # script all live in scripts/, which is why this case has to precede

serverAppConfigs-docs/Architecture/Deployment Flow.md

@@ -62,13 +62,14 @@ service on the other host.
 |---|---|---|
 | Dankclaw compose services | `podman-compose -f dankclaw/compose.yaml up -d --no-deps NAME` | Recreates only `NAME`; Caddy is handled separately because it fronts both hosts. |
 | SearXNG, Gluetun, Valkey, OpenWebUI, Pi-hole, Gitea database/server | user Quadlet + `systemctl --user` | Installs the selected unit and restarts only the required dependency-coupled units. Gitea's web proxy is the canonical Caddy compose service. |
-| `frank-large` | systemd + `systemctl` | Relinks and restarts only the large inference service; waits up to 20 minutes for `/health`. |
-| `frank-medium` | systemd + `systemctl` | Retires the legacy frank-small unit on first deploy, then relinks and restarts only the inference service; waits up to 20 minutes for `/health`. |
+| `frank-large` | systemd + `systemctl` (root unit) | Relinks and restarts only the large inference service; waits up to 20 minutes for `/health`. |
+| `frank-small` | systemd + `systemctl` (root unit) | Relinks and restarts only the small inference service; waits up to 20 minutes for `/health`. |
+| `frank-medium` | rootless Quadlet + `systemctl --user` | Installs `dankserver/frank-medium/quadlet/frank-medium.container`; on first deploy retires the llama.cpp root unit and the vLLM replica quadlets into the home trash, then restarts the generated unit. Waits up to 20 minutes for `/health`. |
 | Dankserver media stack (RomM trio, Jellyfin, Calibre-Web, Copyparty) | user Quadlet + `systemctl --user` | Installs `dankserver/<svc>/quadlet/*.container`, restarts the generated unit. The first cutover per service is idempotent: it retires the compose-era bare container, rescues any anonymous volume into the data root, and merge-moves `/opt/<svc>` to `/home/dank/Containers/<svc>` (mapped-uid roots move without chown). Steady state is restart-only. |
 
 The shared chat template maps to the inference service on the selected target.
-The inactive `frank-npu` unit is relink-only when explicitly selected;
-it is not restarted by an unrelated large-model deployment.
+The `frank-npu` endpoint is retired (2026-09-11) and has no deploy handler;
+an unrelated large-model deployment never touches it.
 
 ## Caddy safety
 

serverAppConfigs-docs/Architecture/E2E Suite.md

@@ -1,3 +1,13 @@
+---
+type: reference
+description: "`tests/e2e/` drives the **live fleet** through a real browser: fresh contexts"
+tags:
+  - architecture
+  - e2e
+  - homepage
+timestamp: 2026-09-01
+---
+
 # E2E Suite — homepage + guard chain (Playwright)
 
 `tests/e2e/` drives the **live fleet** through a real browser: fresh contexts

serverAppConfigs-docs/Architecture/Network Architecture.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "One Caddy fronts both hosts."
+tags:
+  - architecture
+  - network
+timestamp: 2026-09-02
+---
+
 # Network Architecture
 
 One Caddy fronts both hosts. It runs as a container on Dankclaw (192.168.0.143) and terminates TLS for every service on the LAN. Pi-hole on Dankclaw answers the service names for LAN clients; Porkbun answers them for the WAN. The G36 router firewall governs external access. SearXNG outbound traffic exits through the Gluetun VPN container.

serverAppConfigs-docs/Architecture/Storage Policy.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "All persistent data uses **bind mounts**: a host directory mapped directly into the container."
+tags:
+  - architecture
+  - storage
+timestamp: 2026-09-01
+---
+
 # Storage Policy
 
 All persistent data uses **bind mounts**: a host directory mapped directly into the container. No named volumes. This matches the preference of this repo and the existing Gitea stack on Dankclaw.

serverAppConfigs-docs/Architecture/Testing Policy.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "This repository tests its configuration at defined seams."
+tags:
+  - architecture
+  - testing
+timestamp: 2026-09-01
+---
+
 # Testing Policy
 
 This repository tests its configuration at defined seams. The tests run with `bats`; run them with `./tests/run.sh` before every push.

serverAppConfigs-docs/Dankclaw/ComfyUI.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "ComfyUI is a node-based AI image generation engine."
+tags:
+  - dankclaw
+  - comfyui
+timestamp: 2026-09-16
+---
+
 # ComfyUI
 
 ComfyUI is a node-based AI image generation engine. Workflows are built from nodes that load models, sample latents, and post-process images; everything is scriptable through a web UI and an API.
@@ -13,6 +22,7 @@ https://github.com/Comfy-Org/ComfyUI
 |------|-------|
 | Image | `comfyui-rocm:gfx1151` — built from `dankclaw/Containerfile.comfyui` |
 | Base image | `docker.io/rocm/vllm:rocm7.12.0_gfx1151_ubuntu24.04_py3.12_pytorch_2.9.1_vllm_0.16.0` |
+| Upstream latest | 0.37.0 (2026-09-21) — ships **native Qwen-Image 2.1** support (CORE-423, `comfy/ldm/qwen_image21/`). The image's custom GGUF patches may be unnecessary on the next rebuild; check before re-applying. |
 | Port | 8188 (host) → 8188 (container) |
 | Backend | ROCm GPU (gfx1151 / Radeon 8060S). No `--cpu` flag. |
 | Data | `/home/dank/comfyui-data/{models,input,output,custom_nodes}` → `/opt/ComfyUI/...` |

serverAppConfigs-docs/Dankclaw/Gluetun.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Gluetun is a lightweight VPN client container."
+tags:
+  - dankclaw
+  - gluetun
+timestamp: 2026-08-28
+---
+
 # Gluetun
 
 Gluetun is a lightweight VPN client container. It connects to a VPN provider (WireGuard or OpenVPN) and shares that tunnel with other containers that attach to its network namespace.

serverAppConfigs-docs/Dankclaw/Hermes-Dashboard.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "The Hermes web dashboard is a browser UI for managing the agent."
+tags:
+  - dankclaw
+  - hermes
+timestamp: 2026-09-16
+---
+
 # Hermes-Dashboard
 
 The Hermes web dashboard is a browser UI for managing the agent. It shows config, API keys, and sessions. It is a management tool. It is not a chat window. Chat happens over Signal or the CLI. See [[Hermes]].

serverAppConfigs-docs/Dankclaw/Hermes.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Hermes is the self-improving AI agent from Nous Research."
+tags:
+  - dankclaw
+  - hermes
+timestamp: 2026-09-15
+---
+
 # Hermes
 
 Hermes is the self-improving AI agent from Nous Research. It runs in a terminal, Telegram, Discord, Slack, WhatsApp, or Signal, and keeps a persistent learning loop: it creates skills from experience, searches past conversations, and builds a model of the user across sessions.
@@ -20,6 +29,7 @@ is not durable. The tracked, sanitized configuration baseline is
 | Item | Value |
 |------|-------|
 | Image | built from `NousResearch/hermes-agent` (official Dockerfile in repo) |
+| Upstream latest | agent v0.21.4 / CalVer `v2026.9.21` (2026-09-21); hermes-webui v0.52.113 (2026-08-14). Pin the CalVer tag, not `:latest`. |
 | License | MIT |
 | Model backends | Nous Portal, OpenRouter, OpenAI, or any custom endpoint |
 | Interfaces | TUI, Telegram, Discord, Slack, WhatsApp, Signal |

serverAppConfigs-docs/Dankclaw/OpenWebUI.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "OpenWebUI is a self-hosted chat interface for LLMs."
+tags:
+  - dankclaw
+  - openwebui
+timestamp: 2026-09-21
+---
+
 # OpenWebUI
 
 OpenWebUI is a self-hosted chat interface for LLMs. It connects to OpenAI-compatible endpoints (vLLM, llama.cpp, Ollama) and adds RAG, plugins, tool calling, and multi-user support.
@@ -12,32 +21,110 @@ https://github.com/open-webui/open-webui
 | Item | Value |
 |------|-------|
 | Image | `ghcr.io/open-webui/open-webui:main` (verified from the live quadlet unit) |
+| Upstream latest | 0.11.4 (2026-09-21) — security/access-control advisory; `:main` is the rolling image, not a stable pin. Imagegen endpoint is `POST /api/v1/images/generations` (the `comfyui` engine is still upstream). |
 | Port | 3005 (host) → 8080 (container). Port 3000 is Gitea's HTTP, so it is not usable. |
 | Data volume | `/home/dank/Containers/open-webui/data` → `/app/backend/data` |
-| Default backend | `frank-large` on Dankclaw `:7770` (ROCmFPX llama.cpp fork — see the LLM knowledge base below) — reached via host LAN IP `192.168.0.143:7770` |
+| Backends | Three fleet endpoints: `frank-large` (host.containers.internal:7770), `frank-medium` (192.168.0.235:7770), `frank-small` (host.containers.internal:7771) — see [The LLM backends](#the-llm-backends) |
 | Network | Pinned bridge `systemd-open-webui` (`10.89.3.0/24`, gateway `10.89.3.1`) — see [History](#history) |
 | Persistence | Quadlet unit `open-webui.service`; `[Install] WantedBy=default.target` |
 | Deploy | `scripts/deploy-open-webui-quadlet.sh dankclaw` |
 
 ## The LLM backends
 
-The fleet runs two OpenAI-compatible endpoints. This mapping is the **live**
-state (verified 2026-09-03). Both services listen on `:7770`, distinguished by
-host; `frank-large` moved from `:52625` to `:7770` on 2026-08-22.
+OpenWebUI serves the three fleet LLM endpoints. The model picker is built from
+the `model` table in `webui.db` (one row per model), NOT from live connection
+discovery — so the picker shows exactly the models seeded there.
 
-| Endpoint | Model name | Host | Capability |
-|----------|-----------|------|------------|
-| `:7770` (ROCmFPX llama.cpp fork) | `frank-large` | Dankclaw | completion |
-| `:7770` (ROCmFPX llama.cpp fork) | `frank-medium` | Dankserver | completion |
+| Picker model | Connection URL | Runtime | Host |
+|--------------|----------------|---------|------|
+| `frank-large` | `http://host.containers.internal:7770/v1` | unsloth llama.cpp (Strix Halo iGPU, 200k ctx) | Dankclaw |
+| `frank-medium` | `http://192.168.0.235:7770/v1` | vllm-radiance TP=2 (FP8, DFlash2, 262k ctx) | Dankserver |
+| `frank-small` | `http://host.containers.internal:7771/v1` | llama.cpp (RTX 3090, Gemma4-12B, 262k ctx) | Dankclaw |
 
-The default connection points at the on-host endpoint (`frank-large`).
-To add the other backend, open **Admin → Connections** in the UI and point an
-OpenAI connection at `http://192.168.0.235:7770/v1` (key `none`).
+Two gotchas make the wiring non-obvious:
+
+- **llama.cpp `/v1/models` is Ollama-shaped.** llama.cpp returns
+  `{"models":[{"name":...}]}`; OpenWebUI's `extract_data()` only reads the
+  OpenAI `{"data":[{"id":...}]}` shape, so connection discovery silently misses
+  the llama.cpp endpoints (frank-large, frank-small). The fix is to set
+  `model_ids` in each connection's `api_config` — when non-empty, OpenWebUI
+  builds the model list directly and never fetches `/v1/models`. frank-medium
+  (vLLM) serves the OpenAI shape and would discover fine, but uses `model_ids`
+  too for consistency.
+- **The host's own services are reached via `host.containers.internal`.** The
+  container sits on a netavark bridge; it can hairpin to a *different* host's
+  LAN IP (dankserver `192.168.0.235`) but not to its *own* host's non-published
+  ports via the host LAN IP (`192.168.0.143:7770/7771` is refused).
+  `host.containers.internal` (169.254.1.2) resolves to the host on the bridge
+  and reaches both llama.cpp services.
+
+The Ollama connection is disabled (`ollama.enable=false`).
+
+> All three endpoints are bare-metal systemd services managed by this
+> repository. Model swaps, context sizing, and spec tuning happen there. See
+> the [LLM knowledge base](../LLM/index.md).
+
+## Web search
+
+Chat web search is served by [[SearXNG]] on this host, wired in the quadlet
+(`ENABLE_WEB_SEARCH`, `WEB_SEARCH_ENGINE=searxng`, `SEARXNG_QUERY_URL`).
+
+- **Access path:** the backend calls `http://192.168.0.143:8081/search?format=json`
+  directly — gluetun's published port, NOT the `search.franksdank.cloud` vhost.
+  The Anubis→Authentik guard chain is a browser mechanism (proof-of-work +
+  session flow); a plain HTTP client cannot solve it, and the internal port
+  bypasses Caddy entirely.
+- **Limiter:** SearXNG caps non-HTML (JSON) requests at 4/IP/hour (`API_MAX`,
+  a hardcoded Python constant — no config knob). The `pass_ip` list is checked
+  FIRST and short-circuits the whole botdetection chain, and OpenWebUI's bridge
+  egress (`10.89.x`) is in `pass_ip`, so the cap never applies. Verified: an
+  8-request burst from the container returned 8×200.
+- **Config storage:** OpenWebUI keeps web-search settings per-key in its SQLite
+  config table (`webui.db`, `web.search.*`). The quadlet env vars seed that
+  table on first start (fill-missing only); afterwards the DB is authoritative
+  and Admin-UI edits persist there.
+
+## SSO (authentik)
+
+Login is authentik via the OIDC authorization-code flow (wired 2026-09-24).
+The vhost stays exempt from the Anubis guard chain: the OAuth dance is
+browser-driven and only touches the two exempt vhosts (`ai.` and `auth.`).
+
+- **authentik objects** (created via the admin API, 2026-09-24): application
+  `open-webui` (slug `open-webui`) with the OAuth2 provider `Open WebUI`
+  (confidential client, `authorization_code` + `refresh_token`, Strict
+  redirect URI `https://ai.franksdank.cloud/oauth/oidc/callback`, implicit
+  consent flow). The client ID is in the quadlet; the client secret lives in
+  the git-ignored host file `/home/dank/Containers/open-webui/env` (mode 600,
+  loaded via `EnvironmentFile=`).
+- **Roles:** the scope mapping `Open WebUI roles` (scope `roles`) reads the
+  application entitlements `Open WebUI Users` → `user` and `Open WebUI
+  Admins` → `admin`. The entitlements are bound to the groups
+  `openwebui_users` / `openwebui_admins`. `akadmin` (frank8465@protonmail.com)
+  is in `openwebui_admins`; `qa-e2e-admin` is in `openwebui_users`.
+- **Account merge:** `OAUTH_MERGE_ACCOUNTS_BY_EMAIL=true` folds an SSO login
+  into the existing local account with the same email — the pre-SSO admin
+  (frank8465@protonmail.com) keeps its data. `ENABLE_OAUTH_SIGNUP=true` lets
+  other `openwebui_users` create accounts on first login.
+- **IdP reachability:** the container is on its own bridge (10.89.3.0/24) and
+  cannot reach `authentik-server:9000` by name. It reaches the IdP over the
+  public URL `https://auth.franksdank.cloud` — Caddy publishes `0.0.0.0:443`
+  (netavark DNATs published ports from other containers) and Pi-hole resolves
+  the name to the host LAN IP. The server-side code exchange rides that path.
+- **Config authority:** the OAuth env vars in the quadlet seed the per-key
+  config DB on first run (fill-missing only); on the live data dir the Admin
+  Panel is authoritative. To rotate the client secret: create a new token in
+  authentik, update the host env file, and set the new value in the Admin
+  Panel (or the DB), then restart the container.
+- **SSO-only (2026-09-24):** after the OIDC round-trip was verified, the local
+  username/password path was retired. `ENABLE_LOGIN_FORM=false` hides the form
+  and `ENABLE_PASSWORD_AUTH=false` refuses password logins, so the only way in
+  is the authentik OIDC flow. The `ui.enable_login_form` config-DB override was
+  flipped to `false` in the same change — the per-key DB wins over env, so both
+  must agree, and the DB value is the one to change on a live data dir. To
+  restore the password form: set `ui.enable_login_form` back to `true` in the
+  Admin Panel (or DB) and drop the two env vars from the quadlet.
 
-> Both endpoints are bare-metal systemd services managed by this repository
-(the former `vllmScripts` repo, merged in 2026-08-22). Model swaps, context
-sizing, and spec tuning happen there. See the [LLM knowledge
-base](../LLM/index.md).
 
 ## Boot persistence (Quadlet)
 
@@ -71,12 +158,18 @@ The quadlet carries a built-in healthcheck (30s interval, 3 retries, 300s start
 - The image tracks upstream `main`; pin a digest in the quadlet unit if reproducible rollback matters more than tracking. (The old "CPU-only host" framing is stale: this APU runs the gfx1151 ROCm build — see [[ComfyUI]].)
 - The default admin account is created on first login; secure it immediately.
 - If the backend is loading (3–8 minute model load), OpenWebUI shows connection errors until the model is ready.
-- The LLM is reached via the host LAN IP `192.168.0.143:7770`, not the bridge gateway: the gateway (`10.89.3.1`) lives in the rootless netns, while llama-server runs in the host netns, so the gateway refuses. `host.containers.internal` is slirp4netns-only and does not resolve on a bridge either. To reach the Dankserver backend, use the LAN address `192.168.0.235:7770`.
+- The on-host LLM services (frank-large `:7770`, frank-small `:7771`) are reached via `host.containers.internal`, NOT the host LAN IP: the container's netavark bridge cannot hairpin to its own host's non-published ports via `192.168.0.143` (connection refused), and the bridge gateway (`10.89.3.1`) lives in the rootless netns while llama-server runs in the host netns, so it refuses too. `host.containers.internal` (169.254.1.2) resolves to the host on the bridge and works — verified end-to-end for both endpoints. The Dankserver backend (frank-medium) is a different host, reached via its LAN IP `192.168.0.235:7770`.
 
 ## History
 
 - **2026-08-22 — slirp4netns → pinned bridge.** The unit ran on `Network=slirp4netns`. The slirp4netns helper process died (no OOM, no kill entry, no crash log found), and the container kept running with only `lo` in its netns: published port 3005 accepted TCP and reset every request, so chat served empty responses for ~2 days. Nothing logged an error. Moving to a kernel bridge removes the per-container helper entirely, and the healthcheck's interface check makes the zombie state visible if it ever returns.
 
+- **2026-09-21 — model picker rebuilt for the 3-model fleet.** The picker carried 39 stale rows (37 dead Ollama models + 2 `frank-default-*`) and was missing `frank-medium`. Rebuilt the `model` table to exactly `frank-large`/`frank-medium`/`frank-small` and set `model_ids` on each connection (llama.cpp's Ollama-shaped `/v1/models` is invisible to OpenWebUI's discovery). Pointed the two on-host endpoints at `host.containers.internal` — the bridge refuses the host LAN IP for non-published ports. All three verified end-to-end via `/openai/chat/completions`.
+
+- **2026-09-24 — SSO via authentik.** OIDC authorization-code flow wired per the [SSO (authentik)](#sso-authentik) section: application/provider/entitlements created in authentik, client secret in the host env file, roles from the `roles` scope claim. E2E coverage in `tests/e2e/specs/18-openwebui-sso.spec.ts`.
+
+- **2026-09-24 — flipped to SSO-only.** The OIDC round-trip verified in a real browser (login view renders no password form, only "Continue with authentik", and the flow lands on a signed-in session), so the local username/password path was retired: `ENABLE_LOGIN_FORM=false` + `ENABLE_PASSWORD_AUTH=false` in the quadlet and `ui.enable_login_form` set to `false` in the config DB (the DB wins over env, so both were changed together). `qa-e2e-admin` was demoted out of the `authentik Admins` group (it keeps `openwebui_users` / `homepage-admins` for app access).
+
 ## See Also
 
 - [[Dankclaw Stack]]

serverAppConfigs-docs/Dankclaw/Postgres.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "PostgreSQL is the database backend for Gitea."
+tags:
+  - dankclaw
+  - postgres
+timestamp: 2026-09-03
+---
+
 # Postgres
 
 PostgreSQL is the database backend for Gitea. It runs on the same podman network as Gitea and holds the repository metadata, users, and issue data.

serverAppConfigs-docs/Dankclaw/SearXNG Providers.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "How Google and other upstream search engines get blocked behind the Gluetun"
+tags:
+  - dankclaw
+  - searxng
+timestamp: 2026-08-28
+---
+
 # SearXNG Providers
 
 How Google and other upstream search engines get blocked behind the Gluetun
@@ -354,8 +363,15 @@ misleading).
    disable pagination for rate-sensitive engines.
 3. **Promote by evidence** — raise `weight` only for engines that return useful
    results consistently; weight is not a health check.
-4. **Avoid credentials** — do not add API-backed engines unless the provider is
-   genuinely free, anonymous, and compatible with our privacy requirements.
+4. **Avoid credentials, with one carve-out** — do not add API-backed engines
+   unless the provider is genuinely free, anonymous, and compatible with our
+   privacy requirements. Carve-out (2026-09-26): a paid, user-ordered API
+   engine (Kagi) is acceptable when the blast radius is bounded — the
+   `kagi` engine runs with `paging: false` and weight 2, so it spends exactly
+   one API credit per aggregated query, and its key never enters git
+   (deploy-time rendering from `/opt/searxng/.env`; see [[SearXNG]]). It is
+   also immune to the shared-VPN-exit-IP blocking this page is about: it
+   authenticates, so reputation of the exit IP is irrelevant.
 5. **Verify first** — `/json` + `?engines=google` and the searx-checker to see
    exactly which engines are down and why. Confirm the running SearXNG version
    (check whether `parsers`/`rate_limit` exist in the pinned build).

serverAppConfigs-docs/Dankclaw/SearXNG.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "SearXNG is a privacy-respecting metasearch engine."
+tags:
+  - dankclaw
+  - searxng
+timestamp: 2026-09-03
+---
+
 # SearXNG
 
 SearXNG is a privacy-respecting metasearch engine. It aggregates results from many upstream search engines into one result set and serves both an HTML UI and a JSON API for agents.
@@ -51,8 +60,8 @@ Deploy with `scripts/deploy-searxng-quadlet.sh dankclaw`. It copies the units, d
 ```yaml
 use_default_settings: true
 server:
-  secret_key: "${SEARXNG_SECRET}"   # from .env
-  base_url: "${SEARXNG_BASE_URL}"  # resolves to http://192.168.0.143:8081/
+  secret_key: "${SEARXNG_SECRET}"   # rendered at deploy by scripts/searxng-render-settings.py
+  base_url: "${SEARXNG_BASE_URL}"   # same renderer; SearXNG does NOT expand env vars itself
   limiter: true
   method: "POST"
 
@@ -81,8 +90,16 @@ engines:
   - name: duckduckgo
     disabled: false
     weight: 2
-    paging: false
-    timeout: 5.0
+  - name: kagi
+    engine: kagi
+    categories: [general, web]
+    shortcut: kg
+    api_key: "${KAGI_API_KEY}"      # rendered at deploy from /opt/searxng/.env
+    kagi_categ: search
+    disabled: false
+    weight: 2
+    paging: false                  # one API credit per aggregated query
+    timeout: 8.0
   - name: google cse
     disabled: true
   - name: brave
@@ -159,10 +176,39 @@ root cause, the suspend-model table, the `engines:` config, and the
   LAN by construction (no public route to the LAN IP). No second agent-only
   instance is needed; a duplicate would double upstream request volume from the
   same rate-sensitive VPN exit IP for zero benefit.
-- The config file is root-owned (uid of the rootless podman namespace). Update it with a one-off `sudo cp`, then run `systemctl --user restart searxng.service` to reload.
+- The config file is root-owned (uid of the rootless podman namespace). The
+  official path is `deploy.sh --service searxng`: it copies the repo settings
+  and renders the `${VAR}` placeholders via `scripts/searxng-render-settings.py`
+  from `/opt/searxng/.env`. A hotfix can still hand-copy with `sudo cp`, but
+  remember the renderer: an unrendered copy silently serves the literal
+  placeholders (before 2026-09-26 the live `secret_key` literally was
+  `"${SEARXNG_SECRET}"` and nobody noticed).
 - `base_url` must match the public address or proxy rewrites break.
 - Keep the valkey cache container on the same podman network as searxng.
 
+
+## Kagi (paid API engine)
+
+Added 2026-09-26 (user-ordered). The stock SearXNG image ships a native
+`kagi` engine module (`searx/engines/kagi.py`); it authenticates with
+`Authorization: Bearer <key>` against `POST https://kagi.com/api/v1/search`.
+
+- **Enabled**: `weight: 2` alongside bing/duckduckgo, categories
+  `[general, web]`, shortcut `kg`, `kagi_categ: search`.
+- **Cost control**: `paging: false` — exactly one API credit per aggregated
+  query; `timeout: 8.0` so a slow paid query is not wasted (scrapers use 5.0).
+- **Key handling**: the repo file keeps `api_key: "${KAGI_API_KEY}"`;
+  `deploy-remote.sh` bakes the real key into the live settings.yml via
+  `scripts/searxng-render-settings.py`, reading `/opt/searxng/.env`
+  (dank-owned, mode 600). The key never enters git and never appears in any
+  process argv. SearXNG itself does NOT expand env vars in settings.yml —
+  without the renderer the engine fails `setup()` and is dropped at load.
+- **Immune to the VPN-exit-IP problem**: Kagi authenticates, so it does not
+  care about the shared Gluetun exit IP reputation (see [[SearXNG Providers]]).
+- **Verified live 2026-09-26**: direct API probe through the gluetun netns
+  (200, `data.search[]` shape), then a live aggregated query returned
+  29/29 results tagged `kagi`, zero unresponsive engines.
+
 ## See Also
 
 - [[Dankclaw Stack]]

serverAppConfigs-docs/Dankclaw/Seerr.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Seerr is the unified request manager for the *arr stack (the maintained `seerr-team/seerr` successor to the archived Overseerr/Jellyseerr line)."
+tags:
+  - dankclaw
+  - seerr
+timestamp: 2026-09-02
+---
+
 # Seerr
 
 Seerr is the unified request manager for the *arr stack (the maintained `seerr-team/seerr` successor to the archived Overseerr/Jellyseerr line). Frank's household uses it to request movies/TV/music; Seerr routes approvals to Sonarr/Radarr/Lidarr/Readarr on FrankBook-Pro and pushes downloads to qBittorrent.

serverAppConfigs-docs/Dankclaw/Valkey.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Valkey is the cache and limiter store for SearXNG."
+tags:
+  - dankclaw
+  - valkey
+timestamp: 2026-08-28
+---
+
 # Valkey
 
 Valkey is the cache and limiter store for SearXNG. It replaces Redis as the default in the official SearXNG deployment.

serverAppConfigs-docs/Dankserver/ARR-Stack.md

@@ -1,189 +0,0 @@
----
-type: reference
-title: *arr Stack
-description: The *arr automation stack (Prowlarr, Sonarr, Radarr, Lidarr, Readarr, qBittorrent) — FrankBook-Pro only, every container on the gluetun WireGuard netns (all egress VPN): topology, wiring, auth posture, and gotchas.
-tags: [arr-stack, prowlarr, sonarr, radarr, lidarr, readarr, qbittorrent, frankbook-pro, dankserver]
-timestamp: 2026-09-04T00:00:00Z
----
-
-# *arr Stack
-
-The *arr suite is a collection of automated media management tools for Usenet
-and BitTorrent. It runs in exactly one place: **FrankBook-Pro** — the Mac mini
-that fronts this household's downloads — as quadlet units inside its podman
-machine, with every container (the five arrs AND qBittorrent) sharing the
-[[Gluetun]] WireGuard tunnel's network namespace so **all egress exits
-through the VPN**. A short-lived Dankserver compose copy was removed on
-2026-09-04 (see below). The stack provides automatic downloading and library
-management that Copyparty alone does not cover: quality profile enforcement,
-series/movie discovery, metadata enrichment, and automated file organization.
-
-The core chain is: **Prowlarr** (indexer API aggregator) →
-**Sonarr/Radarr/Lidarr/Readarr** (media-specific managers) → **qBittorrent**
-(download client, sharing the [[Gluetun]] WireGuard tunnel netns) →
-**Jellyfin** (media server scan → auto-refresh).
-
-## Service Overview
-
-| Service | Role | Image | Port | Min RAM |
-|---------|------|-------|------|---------|
-| Prowlarr | Indexer management | `lscr.io/linuxserver/prowlarr:latest` | 9696 | 256 MB |
-| Radarr | Movie management | `lscr.io/linuxserver/radarr:latest` | 7878 | 512 MB |
-| Sonarr | TV show management | `lscr.io/linuxserver/sonarr:latest` | 8989 | 512 MB |
-| Lidarr | Music management | `lscr.io/linuxserver/lidarr:latest` | 8686 | 256 MB |
-| Readarr | Ebook/audiobook management | `lscr.io/linuxserver/readarr:amd64-1.0.980` (pinned — LSIO ships no untagged `latest` for readarr) | 8787 | 256 MB |
-| qBittorrent | Torrent download client | `lscr.io/linuxserver/qbittorrent:4.6.7` (pinned; see [[qBittorrent]]) | 8080 (published by the gluetun unit) | 512 MB |
-
-Jackett and Whisparr were evaluated as optional extras but never deployed
-(no unit, no vhost, no live container).
-
-## Deployment shape (current)
-
-Each service is a quadlet `.container` unit in this repo under
-`frankbook-pro/<svc>/quadlet/`, installed inside the podman machine at
-`/home/core/.config/containers/systemd/<svc>.service` by the frankbook-pro
-handler in `scripts/deploy-remote.sh`. Every unit runs with
-`PUID=0 PGID=0 TZ=America/Los_Angeles UMASK_SET=022`, mounts its config root at
-`/Volumes/COMPLETE/<svc>-data:/config`, publishes its API port on the host, and
-runs `Restart=always` with `TimeoutStartSec=900`.
-
-qBittorrent is special: it shares the [[Gluetun]] container's network namespace
-(`Network=gluetun.container`) so torrent egress never touches the residential
-IP. A netns-sharer publishes no ports of its own — qB's WebUI (8080) and
-BitTorrent port (6881 TCP+UDP) are published on the gluetun unit instead.
-
-## Dankserver compose copy (removed 2026-09-04)
-
-A copy of the stack lived in `dankserver/compose.yaml` (`/opt/<svc>/config`
-data roots) from 2026-08-20 to 2026-09-04 and never ran healthy: the config
-dirs were created root-owned (`root:root 755`), so every app died at logger
-init (`UnauthorizedAccessException: Access to the path '/config/Sentry' is
-denied`) before binding any port — which read as dead ports, not a boot
-crash, until `podman logs <svc>` was checked. After a one-day revival it was
-removed by operator decision: **FrankBook-Pro is the sole *arr deployment.**
-Config roots moved to `~/.AGENTTRASH/20260904-dankserver-arr-teardown/` on
-Dankserver (recoverable until purged).
-
-### Rootless identity model on Dankserver (verified, keep for reference)
-
-- On Dankserver's podman 5.7.0 rootless, a container's default user namespace
-  maps **container root (PUID=0) → host uid 1000 (dank)** and container uid
-  *N* → host `100000 + N - 1`. Verified via `/proc/<pid>/uid_map`
-  (`0 1000 1` / `1 100000 65536`) across plex, tautulli, jellyfin,
-  calibre-web, copyparty, romm. This is why PUID=0 services write as `dank`
-  and why data roots are owned `1000:1000` on that host.
-- **Never add `userns_mode: host` to a podman-compose service.**
-  podman-compose 1.5.0 runs every compose service inside a pod, and podman
-  rejects the combination (`--userns and --pod cannot be set together`) —
-  the stack then fails to recreate with no recourse. The default mapping
-  already gives the fleet identity; PUID=0 + `1000:1000`-owned data roots is
-  the whole recipe. (The compose file briefly carried `userns_mode: host` on
-  all six arr services on 2026-09-04 — reverted in `e454159`, same day.)
-- qBittorrent's first boot (PUID=0, empty config) prints a one-time WebUI
-  admin password in `podman logs qbittorrent` — persist it via the PBKDF2
-  recipe in [[qBittorrent]] before restarting the container.
-
-## Access / auth posture
-
-No *arr app sits behind the Anubis guard chain — the stack is exempt by
-construction (its own auth), with an exemption comment in the Caddyfile per
-vhost. Five TLS vhosts (`<svc>.franksdank.cloud`) terminate on Caddy on
-Dankclaw and route to FrankBook-Pro's published ports
-(`192.168.0.112:<port>`, all exposed by the gluetun unit since the netns
-consolidation); the same ports are reachable directly on the LAN. Sonarr is
-the exception: internal-only by construction — no vhost, no public DNS record;
-admins reach it at `http://192.168.0.112:8989` from the LAN only (retired
-2026-09-04; users request TV through [[Seerr]] instead).
-
-Auth-config history (verified live 2026-08-29): all five arrs shipped with
-`AuthenticationMethod=None` **plus** `AuthenticationRequired=Enabled`. On the
-v1 (.NET) apps that combo is self-contradictory — UI Save is permanently
-disabled and any settings save throws `DryIoc.ScopedItemException` inside
-`AuthorizationMiddleware` (500 sprawl on every page after restart). The valid
-representation of "no auth" in v1 is **absence of the `<AuthenticationRequired>`
-key**, not the literal string `Disabled` — readarr's config (key absent) booted
-clean while its three siblings (key=`Disabled`) 500-sprawled, which is how it
-was caught. Fix applied live: key deleted on sonarr/radarr/lidarr/prowlarr,
-containers restarted, all five verified serving. Posture = zero-auth arrs on
-LAN and WAN; the Anubis wall guards homepage/search/hermes/prometheus/romm/files
-but **not** the arrs — first-account-wins is the current race condition if that
-ever flips to `External` auth (needs an IdP first; auth method choice remains an
-operator decision). Sonarr is exempt from even that exposure since 2026-09-04:
-with no vhost and no public DNS record, its zero-auth UI has no WAN path at all.
-
-## Chain wiring (verified live 2026-08-30)
-
-The download chain is wired and test-first verified: **indexers → Prowlarr →
-per-arr qBittorrent clients (category = app name) → import**.
-
-- qB webUI auth is ON (`admin` + generated password; verify before writing it
-  into any config — it was generated at first boot, not a default).
-- Per-arr QBittorrent download clients exist on sonarr/radarr/lidarr
-  (enabled) and readarr (**parked**: its qB proxy fails auth live even with
-  correct creds — known defect of the abandoned upstream; retest needed
-  after the 2026-09-04 netns move). All four clients were re-pointed to
-  **loopback** (`127.0.0.1:8080`, same netns) on 2026-09-04 when the arrs
-  joined gluetun's netns — the old `10.88.0.1:8080` gateway hack routes
-  into the VPN tunnel (AllowedIPs=0.0.0.0/0) and is dead from inside the
-  netns. Verified live: `podman exec sonarr curl` reaches qB with 200, and
-  a real qB login from inside the netns returns 200.
-- Prowlarr runs v2.5.2 where apps are first-class rows (`Applications`
-  table): four Application rows (sonarr/radarr/lidarr/readarr) carried each
-  arr's real baseUrl+apiKey with `SyncLevel=FullSync` as of 2026-08-30.
-  **Status 2026-09-04: the table is EMPTY again** (live API check — 8 rows,
-  all Cardigann/Torznab, zero Application rows; lost with the dankserver
-  config migration). Prowlarr sync is broken until the four rows are
-  rebuilt with baseUrl `127.0.0.1:<arr port>` (same netns).
-- Indexers are **test-before-enable**: EZTV and 1337x stay disabled with
-  reason "blocked by CloudFlare Protection" (this host's egress ASN was
-  CF-blocked at those trackers). **2026-09-04: arr egress moved onto the
-  ProtonVPN tunnel** — the parked reason may no longer hold; retest before
-  enabling. Nyaa.si, sukebei, RuTor, Byrutor, YTS passed live tests and
-  are enabled. A failed test = parked with reason, never enabled blind.
-- Prowlarr v2 sync model: indexers stay in Prowlarr; arrs search *through* it
-  and hand off to their own qB download client (category routing). Mappings
-  materialize at grab time — zero mappings right after wiring is expected,
-  not a fault.
-
-## Disk layout (current)
-
-```
-/Volumes/COMPLETE            <- completed-media volume (Mac volume)
-├── sonarr-data:/config      <- per-app config roots, one per unit
-├── radarr-data:/config
-├── lidarr-data:/config
-├── readarr-data:/config
-├── qbittorrent-data:/config
-└── <movie/tv/music/books roots>   <- arr import roots live here
-/Volumes/INCOMPLETE          <- qB in-flight downloads (same path inside qB)
-```
-
-qB mounts both volumes at their identical host paths
-(`Volume=/Volumes/COMPLETE:/Volumes/COMPLETE`,
-`Volume=/Volumes/INCOMPLETE:/Volumes/INCOMPLETE`), so a category's download path
-is the same string on every container that touches it — no remapping between
-download and import.
-
-## Gotchas
-
-- **Timezone:** every unit runs `TZ=America/Los_Angeles`; Sonarr's scheduler is timezone-sensitive — keep them uniform.
-- **File permissions:** `UMASK_SET=022` on qBittorrent; arr apps run PUID=0 so they can read/move qB downloads.
-- **Network conflicts:** *arr apps use many ports. On the machine VM, only the API ports (8989/7878/8686/8787/9696) and gluetun's published 8080 + 6881 are host-published; netns-sharers (qB) publish none of their own.
-- **Prowlarr API key rotation:** If rotated, update it in every arr app (`Applications` table rows carry the real keys).
-- **qBittorrent WebUI password:** generated at first boot, not a default — persist it via the PBKDF2 conf recipe in [[qBittorrent]] before any restart.
-- **Readarr stability:** abandoned upstream (retired May 2026); its qB download client is parked pending a successor image. Do not rely on it for mission-critical collections.
-
-## Best Practices
-
-1. Use tags to route content to specific download clients or categories.
-2. Enable the Blocklist in arr apps to prevent re-downloading failed torrents.
-3. Set download limits in qBittorrent to avoid bandwidth saturation.
-4. Back up arr configs regularly (they are small SQLite DBs + JSON) — each lives at `/Volumes/COMPLETE/<svc>-data/config`.
-5. Monitor Prowlarr indexer health — broken indexers hide new content.
-6. Start with default quality profiles. Add custom formats gradually.
-
-## See Also
-
-- [[Sonarr]] · [[Radarr]] · [[Lidarr]] · [[Readarr]] · [[Prowlarr]] · [[qBittorrent]] — per-service pages
-- [[Jellyfin]] — media server that consumes *arr downloads
-- [[Copyparty]] — alternative file viewer

serverAppConfigs-docs/Dankserver/Calibre-Web.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Calibre-Web is a web application that browses, reads, and downloads eBooks from an existing Calibre library database."
+tags:
+  - dankserver
+  - calibre
+timestamp: 2026-09-03
+---
+
 # Calibre-Web
 
 Calibre-Web is a web application that browses, reads, and downloads eBooks from an existing Calibre library database. It serves as the web frontend for the Calibre e-book manager.
@@ -10,7 +19,7 @@ vhost — Calibre-Web serves its own login; direct proxy to
 
 | Item | Value |
 |------|-------|
-| Running image | `lscr.io/linuxserver/calibre-web:0.6.27-ls397` — **pinned** (verified from the live quadlet unit; the pin was chosen so the cutover changed zero bits of application code) |
+| Running image | `lscr.io/linuxserver/calibre-web:0.6.27-ls402` — **pinned** (verified from the live quadlet unit; the pin was chosen so the cutover changed zero bits of application code) |
 | Network | `pasta` (the default rootless-podman userslide network); only 8083 is host-published |
 | Base OS | Ubuntu Noble (24.04 LTS, since 2024-12-05) |
 | Port | 8083 (host) → 8083 (container) |
@@ -60,7 +69,7 @@ Deployment since 2026-09-01 is a quadlet unit
 (`dankserver/calibre-web/quadlet/calibre-web.container` →
 `calibre-web.service`, deploy with
 `./scripts/deploy.sh dankserver --service calibre-web`), image pinned to
-`0.6.27-ls397`, healthcheck on `/`, `PublishPort=8083:8083`. This service was
+`0.6.27-ls402`, healthcheck on `/`, `PublishPort=8083:8083`. This service was
 already on the Containers data-root layout before the standardization, so the
 cutover was a bare-container retire + unit start with no data movement.
 
@@ -69,7 +78,7 @@ cutover was a bare-container retire + unit start with no data movement.
 ```yaml
 services:
   calibre-web:
-    image: lscr.io/linuxserver/calibre-web:0.6.27-ls397
+    image: lscr.io/linuxserver/calibre-web:0.6.27-ls402
     container_name: calibre-web
     restart: unless-stopped
     environment:

serverAppConfigs-docs/Dankserver/Calibre.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Calibre is the e-book library manager that backs Calibre-Web."
+tags:
+  - dankserver
+  - calibre
+timestamp: 2026-09-21
+---
+
 # Calibre
 
 Calibre is the e-book library manager that backs Calibre-Web. It manages metadata, formats, and conversions for the library that Calibre-Web serves.
@@ -18,10 +27,10 @@ The actual library files (`.epub`, `.mobi`, `.pdf`) and the Calibre database (`.
 
 ## Current Version
 
-Calibre 9.2.1 is the version on the live host (9.9.0 is the upstream latest). Major features include:
+Calibre 9.15.0 is the version on the live host (the upstream latest as of 2026-09-22). Major features include:
 - Bookshelf view
 - Opt-in AI features
-- Content server security fix (CVE-2025-7404 equivalent): a bug since v6.16.0 allows any user with server access to read non-Calibre files on the host. Upgrade to 9.9.0+ if serving content to untrusted users.
+- Content-server path-traversal fix: a bug since v6.16.0 allowed any user with server access to read non-Calibre files on the host. (The CVE-2025-7404 advisory is tracked against Calibre-Web, see [[Calibre-Web]].) Upgrade to 9.15.0+ if serving content to untrusted users.
 
 ## Library Directory
 
@@ -39,33 +48,50 @@ gone; the quadlet unit mounts the Containers data root.)
 - Read/write access to the library directory. Calibre-Web edits metadata through the database file.
 - Ownership matching `PUID=1000` / `PGID=1000` (the `dank` user on Dankserver).
 
-## Optional: Calibre Content Server (not running)
+## Calibre Content Server (running)
 
-Calibre includes a built-in HTTP content server (`calibre-server`) that can serve the library via OPDS feeds and a mobile-friendly web interface. This enables:
-- OPDS feeds for mobile reading apps (FBReader, Moon+ Reader)
-- Mobile-optimized UI via the `--mobile` flag
-- Direct Kindle push
+Calibre includes a built-in HTTP content server (`calibre-server`) that serves
+the library via OPDS feeds and a web interface:
+- OPDS feeds for mobile reading apps (FBReader, Moon+ Reader, KyBook)
+- Web UI for browsing, metadata editing, and uploads
+- Direct device push (from the GUI, not the content server)
 
-To run as a container:
+**Live shape (deployed 2026-09-21):** a rootless Quadlet unit
+(`dankserver/calibre-server/quadlet/calibre-server.container`), boot-persistent
+and self-healing, on `lscr.io/linuxserver/calibre:9.15.0`.
 
-```yaml
-services:
-  calibre-server:
-    image: lscr.io/linuxserver/calibre:latest
-    container_name: calibre-server
-    restart: unless-stopped
-    environment:
-      PUID: "1000"
-      PGID: "1000"
-      TZ: Etc/UTC
-    command: calibre-server --daemonize --port 8080 --enable-auth --url-prefix /calibre /books
-    volumes:
-      - /opt/calibre-web/books:/books
-    ports:
-      - "8084:8080"
-```
+The image is the current **desktop** build (Selkies web-streamed GUI), not the
+headless image the old compose snippet assumed — the dedicated headless images
+(ta264/docker-calibre, agentgreen/calibre-server) are dormant (calibre 6.10 /
+2017, both below the 9.9.0 content-server fix). The unit therefore runs
+`calibre-server` as the image's s6-overlay main service via `Exec=`.
 
-Note: The content server runs headless in `--daemonize` mode. It requires the full Calibre package, not a minimal server.
+| Surface | Host port | Auth |
+|---------|-----------|------|
+| Content server (OPDS + web UI) | **8084** (internal 8090) | HTTP Basic, single admin `calibre` in the SQLite userdb |
+| Desktop GUI (internal only) | none (8080/8181/8082 inside the container) | HTTP Basic ready (`CUSTOM_USER`/`CUSTOM_PASSWORD` in the env file) |
+
+Port notes: `Network=pasta` on this host is port-FORWARD mode — the container
+keeps its own netns and only `PublishPort`'d ports reach the host (verified
+2026-09-21). The desktop GUI runs but is unreachable: exposing the browser
+GUI is one `PublishPort` line away. 8080 *inside* the container is the
+image's own nginx (the desktop), so the content server runs on internal 8090.
+
+**Auth model (calibre 9.x):** users live in a SQLite userdb whose `pw` column
+is **plaintext** — the file is mode 600. The single admin account is
+bootstrapped once by the deploy handler
+(`deploy_calibre_server` in `scripts/deploy-remote.sh`) via
+`calibre-server --manage-users -- add`, the password piped on stdin with
+`printf` (a trailing newline from `echo` lands in the stored password and
+breaks every login). The desktop's basic auth (`CUSTOM_USER`/`CUSTOM_PASSWORD`)
+reuses the same pair. Both live in the machine-local env file
+`/home/dank/Containers/calibre-server/env` (mode 600); the repo holds no
+secrets. `--auth-mode=basic` is pinned: on a non-SSL port the server defaults
+to Digest auth, which rejects plain Basic clients with
+`400 Unsupported authentication method`.
+
+LAN-only (no vhost, no public DNS). The library is mounted read-write — the
+content server writes metadata, the same library Calibre-Web uses.
 
 ## See Also
 

serverAppConfigs-docs/Dankserver/Copyparty.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Copyparty is a lightweight file server and media streamer that runs as a single Python binary."
+tags:
+  - dankserver
+  - copyparty
+timestamp: 2026-09-03
+---
+
 # Copyparty
 
 Copyparty is a lightweight file server and media streamer that runs as a single Python binary. It handles large payloads, media streaming, resumable uploads, directory browsing, and WebDAV from one process.
@@ -11,7 +20,7 @@ LAN — **Docs:** https://github.com/9001/copyparty
 
 | Item | Value |
 |------|-------|
-| Running image | `ghcr.io/9001/copyparty-ac:latest` (ac = full edition; the bare `copyparty:latest` tag does not exist — ghcr answers 403 on the token request for nonexistent repos). Version at research time (2026-08): v1.20.21 |
+| Running image | `ghcr.io/9001/copyparty-ac:latest` (ac = full edition; the bare `copyparty:latest` tag does not exist — ghcr answers 403 on the token request for nonexistent repos). Upstream latest v1.20.24 (2026-09-19); v1.20.21 at research time (2026-08) |
 | Port | 3923 (host) → 3923 (container) |
 | Volume | bind mount the shared root directory |
 | Auth | Per-directory `.cpy` config files, HTTP basic auth, `dirkeys`, `filekeys` |

serverAppConfigs-docs/Dankserver/Dankserver Stack.md

@@ -1,3 +1,11 @@
+---
+type: reference
+description: "Dankserver (192.168.0.235) runs the media and library stack."
+tags:
+  - dankserver
+timestamp: 2026-09-03
+---
+
 # Dankserver Stack
 
 Dankserver (192.168.0.235) runs the media and library stack. Public access

serverAppConfigs-docs/Dankserver/Entropy Volume.md

@@ -1,3 +1,11 @@
+---
+type: reference
+description: "The Dankserver entropy volume is a RAID-backed LUKS filesystem mounted at"
+tags:
+  - dankserver
+timestamp: 2026-08-28
+---
+
 # Entropy Volume
 
 The Dankserver entropy volume is a RAID-backed LUKS filesystem mounted at

serverAppConfigs-docs/Dankserver/Jellyfin.md

@@ -55,6 +55,56 @@ Client access paths and the public-exposure policy (auth wall required before
 any public vhost; Plex-style claim tokens do not exist here — Jellyfin uses its
 own users/API keys) follow the fleet [[Authentik]]/[[Anubis]] chain pattern.
 
+## Authentik LDAP authentication (2026-09-25)
+
+Jellyfin has no native external-auth, so it authenticates users through the
+**LDAP-Auth plugin** (`jellyfin-plugin-ldapauth`) against an [[Authentik]] LDAP
+provider. A user logs in with their **authentik username + password**; the
+plugin binds as a service account, searches the directory, and rebinds as the
+user to verify the password.
+
+**authentik side** (on Dankclaw):
+- LDAP provider `Jellyfin LDAP` (Base DN `dc=franksdank,dc=cloud`, bind/search
+  mode `direct`) + application `Jellyfin`.
+- LDAP outpost `Jellyfin LDAP Outpost` → container `authentik-outpost-ldap`
+  (quadlet `dankclaw/authentik/quadlet/authentik-outpost-ldap.container`),
+  publishing `389`/`636` on the Dankclaw host for cross-host binds.
+- Service account `svc-jellyfin-ldap` (DN
+  `cn=svc-jellyfin-ldap,ou=users,dc=franksdank,dc=cloud`).
+- Access groups `jellyfin_users` (search filter
+  `(memberOf=cn=jellyfin_users,ou=groups,dc=franksdank,dc=cloud)`) and
+  `jellyfin_admins` (admin filter `(cn=jellyfin_admins)`). Add a user to
+  `jellyfin_users` to grant them Jellyfin access; `jellyfin_admins` grants
+  the Jellyfin admin role.
+
+**Jellyfin side** (plugin config, set via admin → Plugins → LDAP-Auth):
+- Server `192.168.0.143:389` (plain LDAP over the trusted LAN), Base DN
+  `dc=franksdank,dc=cloud`, bind user = the service-account DN, search
+  attributes `uid,cn,mail,displayName`, uid attr `uid`, username attr `cn`,
+  `CreateUsersFromLdap=true`, all folders enabled.
+
+**Gotcha — the bind credential is a PASSWORD, not a token.** The LDAP bind is
+verified by authentik's default authentication flow (standard-password
+backend). The service account must have a password set (admin → user →
+Recovery → Set password); an API/app token is *not* accepted as the bind
+password and the bind fails with `flow error password: Invalid`. The
+service-account password is stored only in the Jellyfin plugin config (the
+`LdapBindPassword` field) — it is never committed to this repo.
+
+**Verification (2026-09-25):** `ldapsearch` bind + the `jellyfin_users`
+search both succeed from Dankclaw; a real user (`alex`, in `jellyfin_users`)
+logged into the web UI with their authentik password and the plugin created
+the matching Jellyfin user.
+**Gotcha — the login endpoint changed in Jellyfin 12.1.** The legacy
+`POST /Users/Auth/Password` route (and its `LegacyEmbyRouteRewriteMiddleware`)
+was removed; probing it now returns a silent 401 with no plugin log, which
+reads like an auth failure but is just a dead route. The web UI and modern
+clients use `POST /Users/AuthenticateByName` (with the `Authorization:
+MediaBrowser Client=…, DeviceId=…, Device=…, Version=…` header), which is
+where the LDAP plugin runs. Verified 2026-09-25: `alex` authenticates over
+`AuthenticateByName` (HTTP 200; full plugin flow logged — service bind,
+search, `ldapUid`, user bind, token).
+
 ## Configuration workflow
 
 1. Create libraries pointing at `/data` folders (movies, shows, audio).

serverAppConfigs-docs/Dankserver/Plex.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Plex Media Server is a **containerized media server on Dankserver**: a podman"
+tags:
+  - dankserver
+  - plex
+timestamp: 2026-09-15
+---
+
 # Plex
 
 Plex Media Server is a **containerized media server on Dankserver**: a podman
@@ -15,7 +24,7 @@ public traffic can be fronted by Caddy like every other vhost.
 | Item | Value |
 |------|-------|
 | Runtime | podman quadlet, `plex.service` (user manager) — migrated from the native `plexmediaserver.service` OS-package unit (2026-09) |
-| Image | `lscr.io/linuxserver/plex:1.43.3.10896-cb3ebc72d-ls322` (pinned; verified == the ghcr `latest` manifest digest at pin time) |
+| Image | `lscr.io/linuxserver/plex:1.43.4.10903-e5521bd8c-ls325` (pinned; verified == the ghcr `latest` manifest digest at pin time) |
 | Data root | `/var/lib/plexmediaserver` bind-mounted **in place** as `/config` (RW) — the migration moved zero bytes |
 | Media | `/mnt/entropy` mounted at the same absolute path **read-only** — every library path in the PMS database stayed valid, zero re-scan |
 | Identity | fleet rootless model — container root maps to the `dank` user (1000:1000); the deployer chowns the data root on first cutover |

serverAppConfigs-docs/Dankserver/RomM-Scraping.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "This guide covers metadata providers, cover art, ROM naming conventions, emulator integration, and the scraping workflow for RomM on Dankserver."
+tags:
+  - dankserver
+  - romm
+timestamp: 2026-08-28
+---
+
 # RomM Scraping & Asset Management
 
 This guide covers metadata providers, cover art, ROM naming conventions, emulator integration, and the scraping workflow for RomM on Dankserver.

serverAppConfigs-docs/Dankserver/RomM.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "RomM (ROM Manager) is a self-hosted ROM library manager and player."
+tags:
+  - dankserver
+  - romm
+timestamp: 2026-09-03
+---
+
 # RomM
 
 RomM (ROM Manager) is a self-hosted ROM library manager and player. It scans a ROM collection, enriches it with metadata and cover art from multiple providers, and serves it through a clean web interface. RomM also supports browser-based emulation via EmulatorJS and native emulator streaming.
@@ -208,6 +217,7 @@ healthcheck:
 
 - **First login overwrites env credentials.** The `ROMM_PASSWORD` env var sets the initial password. After first login, the admin password is controlled in the UI. The env var only applies on first boot.
 - **MariaDB and Redis are required.** RomM 5.2.0 no longer supports SQLite-only deployments. Both MariaDB and Redis must be running.
+- **5.3.0 breaking change (2026-09-21).** `filesystem.roms_folder` / `firmware_folder` are removed; the scan root must be expressed via `filesystem.structure` in `config.yml` (see the Config File section above). New env vars: `SCAN_WORKERS`, `WEB_SERVER_CONCURRENCY`, `DB_POOL_RECYCLE_SECONDS`. The rolling `:latest` tag will pick this up on the next pull — migrate `config.yml` before redeploying, or the scan root silently goes empty.
 - **Reverse proxy cache stale index.html.** Purge Caddy proxy cache after RomM version bumps to avoid serving a stale frontend after an upgrade.
 - **RAHasher build time.** Enabling RetroAchievements hashing increases the first image build. Skip unless you need achievement data.
 - **MobyGames is paid.** The hobbyist API has strict rate limits. Screenscraper is the recommended free alternative.

serverAppConfigs-docs/Dankserver/Tautulli.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Tautulli is the statistics, monitoring, and notification companion for"
+tags:
+  - dankserver
+  - tautulli
+timestamp: 2026-09-01
+---
+
 # Tautulli
 
 Tautulli is the statistics, monitoring, and notification companion for
@@ -14,7 +23,7 @@ it; it talks to PMS over the appnet at `http://plex:32400`).
 | Item | Value |
 |------|-------|
 | Runtime | podman quadlet, `tautulli.service` (user manager) — migrated from snap `snap.tautulli.tautulli.service` |
-| Image | `lscr.io/linuxserver/tautulli:v2.18.1-ls242` (pinned; verified == the ghcr `latest` manifest digest at pin time) |
+| Image | `lscr.io/linuxserver/tautulli:v2.18.1-ls245` (pinned; verified == the ghcr `latest` manifest digest at pin time) |
 | Data root | `/home/dank/Containers/tautulli` bind-mounted as `/config` (fresh at cutover — the snap's `/var/snap/tautulli/common` was empty) |
 | Identity | fleet rootless model — container root maps to the `dank` user (1000:1000) |
 | Port | `8181/tcp` published on `0.0.0.0` |

serverAppConfigs-docs/FrankBook-Pro/ARR-Stack.md

@@ -0,0 +1,7 @@
+---
+type: reference
+title: "*arr Stack"
+description: "The *arr automation stack (Prowlarr, Sonarr, Radarr, Lidarr, Readarr, qBittorrent) — FrankBook-Pro only, every container on the gluetun WireGuard netns (all egress VPN): topology, wiring, auth posture, and gotchas."
+tags: [arr-stack, prowlarr, sonarr, radarr, lidarr, readarr, qbittorrent, frankbook-pro, dankserver]
+timestamp: 2026-09-04T00:00:00Z
+---

serverAppConfigs-docs/FrankBook-Pro/index.md

@@ -0,0 +1,16 @@
+# FrankBook-Pro
+
+The macOS mini (192.168.0.112) that hosts the *arr download stack and
+qBittorrent as quadlets inside its podman machine. All egress rides the
+Gluetun WireGuard netns. The host overview lives at [[FrankBook-Pro]]
+(Infrastructure); this section holds the per-service pages.
+
+## *arr Stack
+
+- [[ARR-Stack]] — the full *arr stack: indexers, managers, and the download client
+- [[sonarr]] — TV show management
+- [[radarr]] — movie management
+- [[lidarr]] — music management
+- [[readarr]] — ebook/audiobook management
+- [[prowlarr]] — indexer management
+- [[qbittorrent]] — torrent download client

serverAppConfigs-docs/Infrastructure/Alertmanager.md

@@ -0,0 +1,60 @@
+---
+type: reference
+description: "Alertmanager receives firing rules from Prometheus, groups and dedupes them, and forwards each group as a webhook to the host-side Signal relay — which sends it through..."
+tags:
+  - infrastructure
+timestamp: 2026-09-17
+---
+
+# Alertmanager
+
+Alertmanager receives firing rules from Prometheus, groups and dedupes them, and forwards each group as a webhook to the host-side Signal relay — which sends it through signal-cli to Frank's phone. It is the first delivery path in the observability stack (2026-09-17); before it, a firing alert was visible in Prometheus and on the Grafana dashboard's ALERTS panel and reached nobody.
+
+**Host:** Dankclaw — **Port:** 9093 (loopback) — **Docs:** https://prometheus.io/docs/alerting/latest/alertmanager/
+
+## Facts
+
+| Item | Value |
+|------|-------|
+| Image | `docker.io/prom/alertmanager:latest` |
+| Published | `127.0.0.1:9093` → 9093, loopback only (see [[Observability]] → Exposure) |
+| Unit | `dankclaw/observability/quadlet/alertmanager.container` → `alertmanager.service` |
+| Config | `/opt/alertmanager/config/alertmanager.yml`, installed from `shared/prometheus/alertmanager.yml` on every deploy |
+| Data | `/opt/alertmanager/data` (silences, notification log) |
+| Health | `wget --spider -q http://localhost:9093/-/healthy` |
+| Receiver | one `signal` receiver → webhook `http://host.containers.internal:18093/alertmanager` |
+| Grouping | `group_by: [alertname]`, `group_wait` 30 s, `group_interval` 5 m, `repeat_interval` 4 h |
+
+## Why the webhook address is `host.containers.internal`
+
+The Signal relay is a host-side process, and the address it must bind is the one detail this design gets wrong twice (2026-09-17). From a bridge container, loopback is the container's own, and netavark DNATs *published* ports only — so a relay bound to 127.0.0.1 refused the first webhook with `dial tcp 169.254.1.2:18093: connection refused`. The obvious fix — bind `host.containers.internal` itself — fails too: on this host netavark runs its bridges in aardvark-dns' netns, so 169.254.1.2 is not a local address in the host's namespace (`OSError: [Errno 99] Cannot assign requested address`). What works: bind the **host's LAN IP** (192.168.0.143) — netavark delivers the container's `169.254.1.2` dial to that address (proven with a probe socket: container → `169.254.1.2:18094` → host socket bound to `192.168.0.143:18094`, while the LAN IP refused from the container, the usual netavark quirk). Since that puts an unauthenticated endpoint on a host interface, the deployer installs an iptables INPUT set admitting 18093/tcp from loopback, the host itself (its own health probe) and the podman bridge subnet (10.89.0.0/16) only — the rest of the LAN gets a DROP.
+
+## The Signal relay
+
+`scripts/signal-relay.py` is a systemd **user** unit (`scripts/signal-relay.service`), not a Quadlet: it runs `python3` from the checkout, so a deploy reaches it with no copy step, and a hand-written user unit can be `enable`d (generated quadlet units cannot on this host). Linger is on for `dank`, so `WantedBy=default.target` is the whole boot story.
+
+- POST `/alertmanager` — the Alertmanager webhook handler; formats the group and sends it.
+- GET `/health` — liveness for the deployer's health wait.
+- Dedupes per group for 15 minutes, so a stuck alert cannot out-repeat the 4 h `repeat_interval` during a relay hiccup.
+- Sends through `/usr/local/bin/signal-cli -a +12062476336 -o json send +12062476336 -m <text>` — Frank's existing account (state dir `318311`); the credential is the account state under `~/.local/share/signal-cli`, and the account/phone are numbers, not secrets.
+
+## Deployment
+
+```bash
+./scripts/deploy.sh dankclaw --service alertmanager
+```
+
+`deploy_observability` installs the quadlet unit, `copy_alertmanager_config` installs the config, and `install_signal_relay` copies the user unit, installs the iptables rules, enables and restarts the relay, then waits on `192.168.0.143:18093/health` before the container's own `/-/healthy` wait. The planner selects `alertmanager` for its quadlet file, `shared/prometheus/alertmanager.yml`, and the two relay files; `prometheus` ships the `alerting:` block that points at `alertmanager:9093`.
+
+## Gotchas
+
+- The webhook URL and the relay's listen port are a **cross-file contract**: the relay moves ports and the webhook string does not move with it, and every alert is then dropped with no error anywhere. `tests/observability_quadlet.bats` pins both halves.
+- The container address is `alertmanager:9093`, never the published port: Prometheus is in a container and the port is loopback-only.
+- signal-cli account state is on the host, not in the container — a wiped `~/.local/share/signal-cli` silences delivery while every status page stays green.
+- signal-cli 0.14.7's `-a` flag parses an all-digit value as a **phone number** and never falls back to the `accounts.json` name: the account's numeric name (`318311`) dies with `Invalid account (phone number)`, while `-a +12062476336` works. The message goes via `-m`, not a positional — a positional message is parsed as a second recipient (`Invalid phone number '…'`).
+- A failed send is **not** marked in the dedupe map, so the next Alertmanager repeat retries it — but the relay returns 200 to the webhook regardless (a relay bug must not 500 Alertmanager), so a dead signal-cli shows up only in the relay's journal, not in Alertmanager's.
+
+## See Also
+
+- [[Prometheus]] — the rule evaluator that ships the alerts
+- [[Observability]] — the full stack

serverAppConfigs-docs/Infrastructure/Alloy.md

@@ -1,3 +1,11 @@
+---
+type: reference
+description: "Alloy is Grafana's log and telemetry shipper."
+tags:
+  - infrastructure
+timestamp: 2026-09-11
+---
+
 # Alloy
 
 Alloy is Grafana's log and telemetry shipper. It replaces Promtail (EOL 2026-03-02). It forwards container and journal logs to Loki.

serverAppConfigs-docs/Infrastructure/Anubis.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Anubis is the bot-challenge proxy that fronts the guarded public vhosts on"
+tags:
+  - infrastructure
+  - anubis
+timestamp: 2026-09-01
+---
+
 # Anubis — bot challenge proxy
 
 Anubis is the bot-challenge proxy that fronts the guarded public vhosts on

serverAppConfigs-docs/Infrastructure/Authentik.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Authentik is the single sign-on (SSO) and OpenID Connect (OIDC) provider for the"
+tags:
+  - infrastructure
+  - authentik
+timestamp: 2026-09-16
+---
+
 # Authentik — the homelab's SSO / OIDC provider
 
 Authentik is the single sign-on (SSO) and OpenID Connect (OIDC) provider for the
@@ -6,7 +15,7 @@ application-level authentication with its embedded proxy outpost. Apps that
 have their own login (Grafana, Gitea, OpenWebUI, Jellyfin, the *arr stack,
 Pi-hole) are not wrapped — they handle their own session.
 
-- **Version:** `2026.8.0` (pinned in `dankclaw/authentik/quadlet/*.container`)
+- **Version:** `2026.8.3` (pinned in `dankclaw/authentik/quadlet/*.container`)
 - **Host:** dankclaw (`192.168.0.143`)
 - **Name:** `auth.franksdank.cloud`
 - **Stack:** 3 compose services — `authentik-postgres`, `authentik-server`,
@@ -61,8 +70,8 @@ contract:
 | Service | Role | Image |
 |---|---|---|
 | `authentik-postgres` | PostgreSQL 16 (users, flows, sessions, events) | `docker.io/library/postgres:16-alpine` |
-| `authentik-server` | Core + admin API + the embedded Caddy outpost (port 9000) | `ghcr.io/goauthentik/server:2026.8.0` |
-| `authentik-worker` | Background tasks (event processing, provider sync, flows) | `ghcr.io/goauthentik/server:2026.8.0` |
+| `authentik-server` | Core + admin API + the embedded Caddy outpost (port 9000) | `ghcr.io/goauthentik/server:2026.8.3` |
+| `authentik-worker` | Background tasks (event processing, provider sync, flows) | `ghcr.io/goauthentik/server:2026.8.3` |
 
 - **Postgres** is the only stateful store. Sessions, caching, and WebSockets
   moved to PostgreSQL in 2025.10 (Redis removed).
@@ -263,6 +272,47 @@ Two secrets live in the host `.env` (git-ignored; placeholders in
   `dankclaw/authentik/quadlet/`, run `./scripts/deploy.sh dankclaw`. Authentik
   migrates the schema on startup.
 
+## Self-serve user-settings flow (password change)
+
+Users change their own account details through the `default-user-settings-flow`
+(`https://auth.franksdank.cloud/if/flow/default-user-settings-flow/`) — the
+target of the homepage footer's "account" link. It is a `stage_configuration`
+designated flow, so it renders every bound `ConfigurableStage` for the logged-in
+user.
+
+Stages, in execution order (the `FlowStageBinding.order` field, not the M2M
+insertion order):
+
+| order | stage | type | what it does |
+|---|---|---|---|
+| 20 | `default-user-settings` | `PromptStage` | name / email / locale **+ password** |
+| 100 | `default-user-settings-write` | `UserWriteStage` | writes the prompt data to the user |
+
+**Password change is a prompt field, not a stage.** The `UserWriteStage`
+writes whatever the preceding `PromptStage` collected: for the key `password`
+it calls `user.set_password(value)` (`stages/user_write/stage.py`). So the fix
+is a `password` field on the `default-user-settings` prompt
+(`field_key=password`, `type=password`, `required=False`, order 204) — NOT a
+`PasswordStage`. A `PasswordStage` is an *authentication* stage: its
+`validate_password` runs `authenticate()` against the backends to check the
+*current* password; it never sets a new one. (A `PasswordStage` was added on
+2026-09-25 and removed the same day for exactly this reason.)
+
+Two ORM gotchas: `Flow.stages.add()` fails on this through model
+(`Can't bulk create a multi-table inherited model` — `FlowStageBinding` is
+MTI), so create the `FlowStageBinding` row directly with an explicit `order`;
+and a prompt field is a `Prompt` row linked through `PromptStageField`
+(`prompt_stage` + `prompt`; the order comes from `Prompt.order`).
+
+**A blank password must not set an empty password.** `set_password("")` would
+make the account log in with no password, so a validation policy
+(`default-user-settings-no-empty-password`, bound to the prompt via
+`PromptStageValidationPolicy`) denies the form when `prompt_data["password"]`
+is `""` and allows it when set. Verified with the `PolicyEvaluator`
+(empty → deny, set → allow, absent → allow) and end-to-end by driving
+`UserWriteStageView.update_user` on a throwaway user (new password valid, old
+invalid).
+
 ## Outpost claim cache (`proxysession`) — 403 after a group add
 
 The embedded outpost does not re-evaluate group membership per request. Each

serverAppConfigs-docs/Infrastructure/Caddy.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Caddy is the single reverse proxy for both hosts."
+tags:
+  - infrastructure
+  - caddy
+timestamp: 2026-08-29
+---
+
 # Caddy
 
 Caddy is the single reverse proxy for both hosts. It runs as a boot-persistent quadlet container (`caddy.service`) on Dankclaw (192.168.0.143), terminates TLS with real Let's Encrypt certificates, routes hostnames to containers on both hosts, and protects the homepage and sensitive services with HTTP basic auth.

serverAppConfigs-docs/Infrastructure/Grafana.md

@@ -1,3 +1,12 @@
+---
+type: reference
+description: "Grafana visualizes the metrics that Prometheus collects from every service."
+tags:
+  - infrastructure
+  - grafana
+timestamp: 2026-09-11
+---
+
 # Grafana
 
 Grafana visualizes the metrics that Prometheus collects from every service. It runs on Dankclaw and is reachable at `grafana.franksdank.cloud` (via Caddy, behind the Anubis challenge + embedded-outpost gate; login happens inside Grafana via the Authentik OAuth2 button).