docs: OKF v0.1 compliance pass + fact-check + 3 research briefs

- Migrate all 127 non-reserved docs to OKF v0.1 frontmatter (type/description/tags/timestamp); fix 13 YAML issues, 2 duplicate-FM blocks, strip reserved-page FM - Restructure log.md to OKF (## YYYY-MM-DD, newest-first) - Fact-check against scripts/AGENTS.md ground truth: fix 6 false 'Active' banners on retired runbooks, 96->114 GiB GTT, deployment.md vs deploy-plan.py/deploy-remote.sh, Deployment Flow frank-medium=Quadlet, Calibre 9.9.0->9.15.0 + CVE-2025-7404 conflation, Copyparty v1.20.24, RomM 5.3.0 breaking change - Move *arr docs to new FrankBook-Pro/ section (git mv, link-safe) - Write active runbook bodies from ground truth (frank-large, frank-small) - Add 3 research briefs + HTML report: Local TTS and Voice Cloning, AI Job Search and Resume Tools, Most Popular Self-Hosted AI Apps (Jun-Sep 2026) - Add upstream-version rows to ComfyUI/OpenWebUI/Hermes app docs - All 336 tests pass; 136 pages, 0 unresolved wikilinks
2026-09-22 02:09:41 -07:00
1 parent 24f7a7772d
commit 93d1181fee
@@ -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/...` |
@@ -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.
@@ -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]].
@@ -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 |
@@ -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,6 +21,7 @@ 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` |
 | 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) |
@@ -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.
@@ -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
@@ -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.
@@ -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.
@@ -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.