docs: rename frank-default-large/small/sightsound to frank-large/small/npu across vault

Mechanical identity rename across the knowledge base, AGENTS.md, README, the
hermes config example, and homepage services.json. No behavior change; served
aliases on the LLM endpoints change with the deploy of commit 69f87c8.
This commit is contained in:
Frank committed 2026-09-03 16:17:14 -07:00
1 parent 5a083eee6c
commit 8212d4451a
68 files changed
+1053 -1207

No files matched your search

+48 -13
View File
@@ -11,6 +11,41 @@ timestamp: 2026-09-14
# Bundle Change Log
## 2026-09-03 — full fact-check sweep of the docs tree (docs-only, deploy no-op)
- Scope: every page under `/serverAppConfigs-docs/` re-verified against live
hosts (read-only SSH), quadlet unit files, and the Caddyfile; surgical edits
only — no pages created, renamed, or deleted. Per the deploy planner, a
docs-only change is a deploy no-op.
- Dankserver core rewritten to live quadlet facts: the *arr stack + qBittorrent
+ gluetun run on **FrankBook-Pro** (units installed to
`/home/core/.config/containers/systemd/` via the frankbook-pro deploy
handler; `PUID=0/PGID=0`, data roots `/Volumes/COMPLETE/<svc>-data:/config`;
qB pinned `4.6.7` sharing gluetun's netns with 8080 + 6881 published on the
gluetun unit; readarr pinned `amd64-1.0.980`; no vhosts — direct IP:port,
exempt by construction from the guard chain). Jellyfin, Plex, RomM (8085→8080
guarded), Calibre-Web (`0.6.27-ls397` + universal-calibre mod; no standalone
calibre-server), mariadb/redis/Tautulli/Entropy verified against live units.
- Caddy guard chain documented to the live mechanism end-to-end: Anubis :8923 →
internal :8016 → post-auth :8017 routing; guarded vhosts (search, grafana,
prometheus, loki, seerr) route post-auth to container-name upstreams;
exemptions named by construction reason (auth/IdP itself, gitea smart-HTTP,
ai→:3005 own auth, hermes/hermesadmin internal-only via DNS absence, pihole
basicauth edge → :8083).
- `Gitea.md`: data roots + secrets corrected to the live unit paths
(`/home/dank/Containers/gitea/{data,postgres,env}`); UID gotcha corrected —
the units carry no `User=`/UserNS override, so container uid 1000 is literally
host uid 1000 (no subuid offset for these containers).
- Dedupe: `Prowlarr.md`/`prowlarr.md` collapsed into one canonical lowercase
page via rename (git history retains both versions; index link unchanged).
- LLM docs: archive pages (`DFlash DSpark Speculative Decoding`,
`ling-3.0-flash-trial`) reworded from current-tense to dated historical
framing with pointers to the active runbook [[kingjones-strix-rocmfp4]];
LLM `index.md` + `deployment.md` fleet tables and health-gate text updated to
the 2026-08-30 fleet state (STRIX on the pinned ROCmFPX fork; Huihui
abliterated FP8 on FreeToken; sightsound = FLM v1.0.1 on XDNA2, port 7771,
health `/v1/version` — FLM has no `/health` route).
- Suite green after the sweep: `./tests/run.sh` → 233 pass / 0 fail, including
the docs-completeness seam that requires every page to stay index-linked.
## 2026-09-01 (late) — FrankBook-Pro stack completed: tunnel live, qB wired into the arrs
- WireGuard credentials provisioned (second Proton config, server `PA-12`,
endpoint `51.179.177.2:51820`) → `/home/core/Containers/gluetun/env`
@@ -95,9 +130,9 @@ timestamp: 2026-09-14
rules), [[Jellyfin]] gained the LDAP-Auth plugin section. Docs-only
commit → deploy no-op.
## 2026-09-01 — frank-default-small: two compressed-tensors FP8 swaps fail to load; Huihui restored
- `/scripts/frank-default-small.env`, `/scripts/serve-frank-small.sh`,
`/scripts/frank-default-small.service` (`af6cd72` → `34ab6b4` → reverted
## 2026-09-01 — frank-small: two compressed-tensors FP8 swaps fail to load; Huihui restored
- `/scripts/frank-small.env`, `/scripts/serve-frank-small.sh`,
`/scripts/frank-small.service` (`af6cd72` → `34ab6b4` → reverted
in `4d5bea4`) — attempted model swaps on FreeToken v0.1.2, both
live-verified as loader failures and reverted the same day to the Huihui
FP8 checkpoint:
@@ -114,7 +149,7 @@ timestamp: 2026-09-14
- Both failed cleanly at load (37 GB fits RAM — no swap-thrash, no
outage); service was back on Huihui within the hour and re-verified with
a real completion (reasoning parses; `17*23 → 391`, natural stop).
- `/serverAppConfigs-docs/LLM/freetoken-frank-default-small.md` — quant
- `/serverAppConfigs-docs/LLM/freetoken-frank-small.md` — quant
matrix updated: modelopt block-fp8 is the ONLY FP8 path that loads; both
compressed-tensors shapes documented with their exact errors.
- **Deploy health-check trap (second occurrence)**: `deploy.sh` reported
@@ -164,8 +199,8 @@ timestamp: 2026-09-14
+ the two ownership regimes; [[Deployment Flow]] service-manager table
corrected (dankserver media is no longer "bare containers, inventory only").
## 2026-08-30 (night II) — frank-default-sightsound deployed; NPU SVA/IOMMU root cause
- **Deployed** `frank-default-sightsound` on Dankclaw: FLM v1.0.1 (`/usr/bin/flm`,
## 2026-08-30 (night II) — frank-npu deployed; NPU SVA/IOMMU root cause
- **Deployed** `frank-npu` on Dankclaw: FLM v1.0.1 (`/usr/bin/flm`,
dpkg `fastflowlm`) serving the whole local registry (36 tags) on port 52626;
primary model Gemma4 E4B IT NPU2 (vision + audio towers). First deploy
crash-looped every 10 s: `Open /dev/accel/accel0 failed (err=-19)`.
@@ -177,7 +212,7 @@ timestamp: 2026-09-14
kernel line — a consequence, not a GPU fault.
- **Fix**: `iommu=pt` in `GRUB_CMDLINE_LINUX_DEFAULT` + reboot (passthrough keeps
the iGPU default domain identity-mapped — zero DMA-translation overhead for
frank-default-large — while enabling IOMMU hardware + PASID, which SVA needs;
frank-large — while enabling IOMMU hardware + PASID, which SVA needs;
PASID domains are paged regardless of the default-domain type). Post-boot:
30 IOMMU groups, zero SVA-bind errors since boot, unit `enabled`,
`NRestarts=0` since boot.
@@ -187,18 +222,18 @@ timestamp: 2026-09-14
279 prompt tokens consumed); audio tower proven with a control pair (440 Hz
tone via `input_audio` = 37 prompt tokens vs 15 for the identical text-only
control). Health probe is `/v1/version` — FLM has no `/health` route.
- `/scripts/frank-default-sightsound.env`, `/scripts/serve-frank-default-sightsound.sh`,
`/scripts/frank-default-sightsound.service` + deployer allowlist entries
- `/scripts/frank-npu.env`, `/scripts/serve-frank-npu.sh`,
`/scripts/frank-npu.service` + deployer allowlist entries
(`c3ed3a6`, `cf0c541`) — service files and deploy wiring; unit is boot-persistent
(`WantedBy=multi-user.target`, enabled, `Restart=on-failure`, `RestartSec=10`,
`LimitMEMLOCK=infinity` — FLM requires unlimited memlock).
- **Docs**: new runbook [[frank-default-sightsound]] (linked from both indexes),
- **Docs**: new runbook [[frank-npu]] (linked from both indexes),
AGENTS.md fleet table + runtime section updated with the IOMMU/SVA hard
requirement. Client wiring: pi `models.json` registers the endpoint under the
Dankclaw provider with the exact FLM registry tag as model id.
## 2026-08-30 (night) — frank fleet double swap: STRIX on its pinned fork, Huihui on FreeToken
- **Dankclaw / frank-default-large**: swapped to
- **Dankclaw / frank-large**: swapped to
`kingjones777/Qwen3.8-Flash-Next-ROCmFP4-STRIX-GGUF` on the card's
pinned `kingjones30/ROCmFPX` runtime (built at
`/home/dank/GitPackages/kingjones-ROCmFPX/build`, `LLAMA_BUILD_WEBUI=OFF`
@@ -212,7 +247,7 @@ timestamp: 2026-09-14
git flow; manual-process race during validation caught and fixed
(unit was crash-looping on a bound port while its health check
passed — check MainPID, not just /health).
- **Dankserver / frank-default-small**: swapped the model within
- **Dankserver / frank-small**: swapped the model within
FreeToken v0.1.2 to `batsclamp/Huihui-Qwen3.6-35B-A3B-abliterated-FP8`
(native block-fp8, same loader path and pool plan; 35 GB downloaded
via `hf`, official checkpoint retained for rollback). Learned:
@@ -220,7 +255,7 @@ timestamp: 2026-09-14
tok/s verified post-deploy. Both `.service` Descriptions refreshed.
- Docs: [[kingjones-strix-rocmfp4]] reactivated as the large runbook
(runtime build + swap procedure + validation), [[agentionai-fast-imatrix]]
marked RETIRED (rollback record), [[freetoken-frank-default-small]]
marked RETIRED (rollback record), [[freetoken-frank-small]]
model sections updated, LLM index + AGENTS fleet tables refreshed.
## 2026-08-30 (late) — download chain proven end to end; qB credentials persisted