docs: rebuild KB in OKF v0.1 with live-verified facts

Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
2026-08-28 07:57:13 -07:00
parent 552d1ef8bf
commit 02883d3ed2
116 changed files with 13008 additions and 0 deletions
@@ -0,0 +1,52 @@
+# System Documentation
+
+Hardware, operating system, and network documentation for the Frank Program
+infrastructure. dankware is the primary workstation; Dankserver and Dankclaw are
+the llama.cpp inference servers it talks to.
+
+## Local System
+
+- [System Overview](/system/dankware/index.md) — dankware: Alienware m16 R2 laptop running CachyOS with Niri Wayland.
+- [Hardware Specifications](/system/dankware/hardware.md) — CPU, GPU, memory, storage, network controllers, and PCI devices for dankware.
+- [Display Configuration](/system/dankware/displays.md) — Three-monitor setup: dual Samsung Odyssey G75F (portrait) plus the internal BOE panel.
+- [Network Interfaces](/system/dankware/network.md) — Wi-Fi (Intel BE202), built-in Ethernet (Killer E3000), USB Ethernet, and local network topology.
+
+## Network Systems
+
+- [Dankserver](/system/dankserver.md) — Primary llama.cpp inference server at 192.168.0.235:7770, serving `frank-default-small` (163,840-token context). AMD Ryzen 7 7700X, RTX 3090, Ubuntu 26.04.
+- [Dankclaw](/system/dankclaw.md) — Secondary inference server at 192.168.0.143:7770, serving `frank-default-large` (262,144-token context). AMD Ryzen AI MAX+ 395 (Strix Halo), Ubuntu 26.04, ROCm.
+
+## Infrastructure Diagram
+
+```mermaid
+graph TB
+    subgraph Local[dankware - Alienware m16 R2]
+        A[Niri Wayland]
+        B[Noctalia Shell]
+        C[Ghostty Terminal]
+        D[Pi Agent]
+    end
+
+    subgraph Network[192.168.0.0/24]
+        E[dankserver<br/>192.168.0.235:7770<br/>frank-default-small]
+        F[dankclaw<br/>192.168.0.143:7770<br/>frank-default-large]
+    end
+
+    D --> E
+    D --> F
+    C --> D
+    B --> C
+    A --> B
+```
+
+## Related Knowledge Bases (sibling projects on dankware)
+
+The fleet has one sibling OKF knowledge base outside this bundle. Read it for
+deployment and inference details. This bundle links to it from the server pages.
+
+* **serverAppConfigs** — `/home/dank/Projects/serverAppConfigs/` (index: `/home/dank/Projects/serverAppConfigs/docs/index.md`). Podman deployment configuration for both servers: compose files, Caddy reverse proxy, deploy scripts, bats tests, and the Obsidian-vault service docs (Dankclaw, Dankserver, Architecture, Infrastructure) — **plus the LLM inference fleet** (merged from the former `vllmScripts` repo on 2026-08-22, history preserved): llama.cpp on Dankserver (:7770, `frank-default-small`) and CIRU ROCmFPX llama.cpp on Dankclaw (:7770, `frank-default-large`). LLM fleet docs: `docs/LLM/index.md`; deploy runbook: `docs/LLM/deployment.md`.
+
+## Related
+
+- [Root Index](/index.md) — bundle navigation.
+- [Engineering](/engineering/index.md) — best practices behind the ops.