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,83 @@
+---
+type: reference
+title: Dankclaw
+description: Secondary inference server at 192.168.0.143. Runs llama.cpp (frank-default-large).
+tags:
+  - network
+  - llamacpp
+  - inference
+  - server
+  - comfyui
+  - unverified
+generated:
+  by: chief-designer/agent
+  at: 2026-08-26T00:00:00Z
+verified: 2026-08-28
+---
+
+# Dankclaw
+
+Secondary llama.cpp inference server for the Frank Program. Serves larger models used by planner, worker, reviewer, oracle, and context-builder subagents.
+
+## Connection Details
+
+| Property | Value |
+|----------|-------|
+| **Hostname** | dankclaw |
+| **IP Address** | 192.168.0.143 |
+| **Port** | 7770 |
+| **Base URL** | `http://192.168.0.143:7770/v1` |
+| **API** | OpenAI-compatible completions |
+| **Authentication** | API key configured |
+
+## Models
+
+| Model ID | Context Window | Reasoning | Input Types |
+|----------|---------------|-----------|-------------|
+| `frank-default-large` | 262,144 tokens | Yes | Text, *Image* (unverified) |
+
+## Services
+
+### llama.cpp
+
+| Property | Value |
+|----------|-------|
+| **Port** | 7770 |
+| **Models** | `frank-default-large` |
+
+## Hardware
+
+| Property | Value |
+|----------|-------|
+| **CPU** | AMD Ryzen AI MAX+ 395 (16C/16T, Strix Halo) |
+| **GPU** | Radeon 8060S integrated (gfx1151, amdgpu) |
+| **RAM** | 119 GiB |
+| **Storage** | Kingston SNV3S1000G NVMe (931.5 GB), ~676 GB free |
+| **OS** | Ubuntu 26.04 LTS, kernel 7.0.0-30-generic |
+| **ROCm** | 7.2.4 (driver: 7.0.0-30-generic) |
+| **Python** | 3.14.4 (system) |
+
+## Usage
+
+Dankclaw handles complex tasks delegated by subagent overrides. The `frank-default-large` model provides extended context. *Multimodal input support is unverified.*
+
+```bash
+# Health check
+curl http://192.168.0.143:7770/health
+
+# Test with large model
+curl http://192.168.0.143:7770/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <key>" \
+  -d '{"model":"frank-default-large","messages":[{"role":"user","content":"Hello"}],"max_tokens":32}'
+```
+
+## Related Knowledge Bases (sibling project on dankware)
+
+- **serverAppConfigs** — `/home/dank/Projects/serverAppConfigs/` — Podman deployment config for this host (AI, search, development, observability stack, incl. the Hermes compose service) **plus the LLM inference fleet** (frank-default-large, CIRU ROCmFPX llama.cpp, :7770). The former `vllmScripts` repo merged into it on 2026-08-22 (history preserved). Start at `/home/dank/Projects/serverAppConfigs/docs/index.md` (see `dankclaw/compose.yaml` + `docs/Dankclaw/`; LLM fleet at `docs/LLM/index.md`, deploy runbook at `docs/LLM/deployment.md`).
+
+## See Also
+
+- [[models|models]] — Provider definitions
+- [[dankserver|dankserver]] — Primary server
+- [[network|network]] — Network topology
@@ -0,0 +1,75 @@
+---
+type: reference
+title: Dankserver
+description: Primary llama.cpp inference server at 192.168.0.235:7770, serving frank-default-small with 163,840-token context window.
+tags:
+  - network
+  - llamacpp
+  - inference
+  - server
+  - unverified
+generated:
+  by: chief-designer/agent
+verified: 2026-08-28
+status: stable
+---
+
+# Dankserver
+
+Primary llama.cpp inference server for the Frank Program. Serves `frank-default-small` — a fast, capable model with image support.
+
+## Connection Details
+
+| Property | Value |
+|----------|-------|
+| **Hostname** | dankserver |
+| **IP Address** | 192.168.0.235 |
+| **Port** | 7770 |
+| **Base URL** | `http://192.168.0.235:7770/v1` |
+| **API** | OpenAI-compatible completions |
+| **Authentication** | None |
+
+## Model
+
+| Property | Value |
+|----------|-------|
+| **Model ID** | `frank-default-small` |
+| **Context Window** | 163,840 tokens |
+| **Reasoning** | Supported |
+| **Input Types** | Text, *Image* (unverified) |
+
+## Usage
+
+Dankserver serves the small subagent model `frank-default-small`. Small subagent roles route here unless a role override picks a different model.
+
+```bash
+# Health check
+curl http://192.168.0.235:7770/health
+
+# Quick test
+curl http://192.168.0.235:7770/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model":"frank-default-small","messages":[{"role":"user","content":"Hello"}],"max_tokens":32}'
+```
+
+## Hardware
+
+| Property | Value |
+|----------|-------|
+| **CPU** | AMD Ryzen 7 7700X (8C/16T, Raphael) |
+| **GPU** | NVIDIA GeForce RTX 3090 (24 GiB VRAM, EVGA) |
+| **RAM** | 60 GiB |
+| **Swap** | 64 GiB (/swapfile) |
+| **Storage** | Kingston SNV3S1000G NVMe (931.5 GB) + md0 RAID (6×18.2T Toshiba, /mnt/entropy, 91T) |
+| **OS** | Ubuntu 26.04 LTS, kernel 7.0.0-30-generic |
+| **NVIDIA Driver** | 595.84 |
+
+## Related Knowledge Bases (sibling project on dankware)
+
+- **serverAppConfigs** — `/home/dank/Projects/serverAppConfigs/` — Podman deployment config for this host (media and library stack: RomM, Copyparty, Calibre-Web) **plus the LLM inference fleet** (frank-default-small, llama.cpp, :7770). The former `vllmScripts` repo merged into it on 2026-08-22 (history preserved). Start at `/home/dank/Projects/serverAppConfigs/docs/index.md` (see `dankserver/compose.yaml` + `docs/Dankserver/`; LLM fleet at `docs/LLM/index.md`, deploy runbook at `docs/LLM/deployment.md`).
+
+## See Also
+
+- [[models|models]] — Provider definitions
+- [[dankclaw|dankclaw]] — Secondary server
+- [[network|network]] — Network topology
@@ -0,0 +1,123 @@
+---
+type: reference
+title: Display Configuration
+description: Three-monitor display setup on dankware — dual Samsung Odyssey G75F (portrait) and internal BOE panel.
+tags:
+  - display
+  - monitors
+  - niri
+  - unverified
+generated:
+  by: chief-designer/agent
+  at: 2026-08-26T00:00:00Z
+status: stable
+verified: 2026-08-28
+
+# Display Configuration — dankware
+
+Three displays in a horizontal arrangement. Two external Samsung Odyssey G75F monitors in portrait orientation flank the internal laptop panel.
+
+---
+
+## Layout
+
+```
+┌──────────────┬──────────────┬──────────────┐
+│              │              │              │
+│   DP-1       │     DP-3     │    eDP-1     │
+│  Samsung     │   Samsung    │    BOE       │
+│  1920x1200   │  1920x1200   │  2560x1600   │
+│  Portrait    │  Portrait    │  Landscape   │
+│  90° rotate  │  270° rotate │  1.5x scale  │
+│              │              │              │
+└──────────────┴──────────────┴──────────────┘
+     x=0,0          x=1200,0       auto-placed
+```
+
+---
+
+## Display Specifications
+
+### DP-1 — Samsung Odyssey G75F (Left)
+
+| Property | Value |
+|----------|-------|
+| **Make** | Samsung Electric Company |
+| **Model** | Odyssey G75F HNTY601056 |
+| **Resolution** | 1920x1200 @ 59.95 Hz (preferred) |
+| **Transform** | 90° (portrait) |
+| **Position** | x=0, y=0 |
+| **Scale** | 1.0 |
+
+### DP-3 — Samsung Odyssey G75F (Center)
+
+| Property | Value |
+|----------|-------|
+| **Make** | PNP(XYM) |
+| **Model** | PM1601 |
+| **Resolution** | 1920x1200 @ 59.95 Hz (preferred) |
+| **Transform** | 270° (portrait) |
+| **Position** | x=1200, y=0 |
+| **Scale** | 1.0 |
+
+### eDP-1 — Internal BOE Panel (Right)
+
+| Property | Value |
+|----------|-------|
+| **Make** | BOE |
+| **Model** | 0x0C06 |
+| **Resolution** | 2560x1600 @ 240 Hz (preferred) |
+| **Transform** | normal (landscape) |
+| **Position** | auto-placed |
+| **Scale** | 1.5 |
+| **Physical Size** | 340x220 mm |
+
+---
+
+## Niri Configuration
+
+**File:** `~/.config/niri/cfg/display.kdl`
+
+```kdl
+output "Samsung Electric Company Odyssey G75F HNTY601056" {
+    mode "3840x2160@60"
+    scale 1
+    transform "normal"
+    position x=0 y=0
+}
+
+output "DP-1" {
+    transform "90"
+    position x=0 y=0
+}
+
+output "DP-3" {
+    transform "270"
+    position x=1200 y=0
+}
+
+output "eDP-1" {
+    // no position - auto-placed to the right of DP-* outputs
+}
+```
+
+---
+
+## GPU Assignment
+
+The Intel Arc iGPU handles display output. The render node is explicitly assigned:
+
+```kdl
+// In ~/.config/niri/cfg/misc.kdl
+environment {
+    render-node "/dev/dri/renderD129"  // Intel Arc iGPU
+}
+```
+
+The NVIDIA RTX 4070 Mobile is available for compute tasks but does not drive displays.
+
+---
+
+## See Also
+
+- [niri](../../tools/niri/index.md) — Compositor configuration + full niri config breakdown
@@ -0,0 +1,106 @@
+---
+type: reference
+title: Hardware Specifications
+description: Complete hardware specifications for dankware — Alienware m16 R2.
+tags:
+  - hardware
+  - alienware
+  - specifications
+  - unverified
+generated:
+  by: chief-designer/agent
+  at: 2026-08-26T00:00:00Z
+verified: 2026-08-28
+---
+
+# Hardware Specifications — dankware
+
+## System
+
+| Property | Value |
+|----------|-------|
+| **Manufacturer** | Alienware |
+| **Model** | Alienware m16 R2 |
+| **BIOS Vendor** | Alienware |
+
+## Processor
+
+| Property | Value |
+|----------|-------|
+| **Model** | Intel Core Ultra 7 155H |
+| **Architecture** | Meteor Lake (6p+8e cores) |
+| **Threads** | 22 |
+| **Architecture** | x86_64 |
+
+## Graphics
+
+| Device | PCI Address | Details |
+|--------|-------------|---------|
+| **Intel Arc** | `00:02.0` | Meteor Lake-P [Intel Arc Graphics] (rev 08) |
+| **NVIDIA RTX 4070 Mobile** | `01:00.0` | AD106M [GeForce RTX 4070 Max-Q / Mobile] (rev a1) |
+| **NVIDIA Audio** | `01:00.1` | AD106M High Definition Audio Controller |
+
+**NVIDIA Driver:** 610.57.04
+
+## Accelerators
+
+| Device | PCI Address | Details |
+|--------|-------------|---------|
+| **NPU** | `00:0b.0` | Core Ultra 200H/200V Series NPU (rev 04) |
+| **GNNA** | `00:08.0` | Meteor Lake-P Gaussian & Neural-Network Accelerator |
+| **DTT** | `00:04.0` | Dynamic Tuning Technology |
+
+## Memory
+
+| Type | Size | Notes |
+|------|------|-------|
+| **RAM** | 62 GiB | System memory |
+| **Swap** | 62 GiB | zram0 (compressed RAM swap) |
+
+## Storage
+
+| Device | Model | Size | Mount |
+| **nvme0n1** | Samsung 990 EVO (2TB) | 1.8 TB | LUKS encrypted, `/` (4G boot, 1.8T root) |
+**Root filesystem:** 1.8 TB total, ~1.2 TB available (~39% used).
+
+## USB and Thunderbolt
+
+| Device | PCI Address | Details |
+|--------|-------------|---------|
+| **USB xHCI** | `00:0d.0` | Core Ultra 200 Series USB xHCI |
+| **Thunderbolt DMA** | `00:0d.3` | Core Ultra 200 Series Thunderbolt DMA1 |
+| **USB 3.2** | `00:14.0` | Meteor Lake-P USB 3.2 Gen 2x1 xHCI |
+
+## Network
+
+| Device | Details |
+| **Wi-Fi** | wlan0 — Intel Wi-Fi 7 BE202 (AX1775*) — connected to FRANKFI-5G (192.168.0.12/24) |
+| **USB Ethernet** | enp0s13f0u1u1 — no carrier |
+| **Built-in Ethernet** | enp47s0 (Killer E3000 2.5GbE) — UP, 192.168.0.226/24 |
+
+## Other
+
+| Device | PCI Address | Details |
+|--------|-------------|---------|
+| **Audio** | `00:1f.3` | Meteor Lake-P HD Audio Controller |
+| **Card Reader** | `2e:00.0` | Realtek RTS525A PCIe Card Reader |
+| **Sensor Hub** | `00:12.0` | Meteor Lake-P Integrated Sensor Hub |
+| **CSME HECI** | `00:16.0` | Meteor Lake-P CSME HECI |
+| **SMBus** | `00:1f.4` | Meteor Lake-P SMBus Controller |
+
+---
+
+## PCI Summary
+
+```
+├── Intel Host Bridge/DRAM (00:00.0)
+├── Intel Arc Graphics (00:02.0) ──── iGPU
+├── NVIDIA RTX 4070 Mobile (01:00.0) ── dGPU
+├── Intel NPU (00:0b.0) ──── AI acceleration
+├── Intel GNNA (00:08.0) ─── AI acceleration
+├── Samsung NVMe PM9C1a (02:00.0) ── primary SSD (/ + /boot)
+├── KIOXIA NVMe BG6 (2d:00.0) ── secondary SSD
+├── Killer E3000 2.5GbE (2f:00.0) ── built-in Ethernet
+├── Intel Wi-Fi 7 BE202 (30:00.0) ── Wi-Fi
+└── Realtek Card Reader (2e:00.0)
+```
@@ -0,0 +1,86 @@
+# System Overview — dankware
+
+**dankware** is an Alienware m16 R2 laptop. It runs CachyOS Linux with the Niri scrollable-tiling Wayland compositor and Noctalia Shell. It serves as the primary workstation for the Frank Program, running the pi coding agent locally and connecting to remote llama.cpp servers.
+
+---
+
+## Quick Facts
+
+| Property | Value |
+|----------|-------|
+| **Hostname** | `dankware` |
+| **System** | Alienware m16 R2 |
+| **OS** | CachyOS (Arch-based rolling) |
+| **Kernel** | `linux-cachyos 7.2.0-1` (EEVDF + LTO + AutoFDO + Propeller) |
+| **LTS Kernel** | `linux-cachyos-lts 6.18.42-1` |
+| **Desktop** | Niri 26.04 (Wayland) |
+| **Shell** | Noctalia Shell 4.7.7 |
+| **Terminal** | Ghostty 1.3.1 |
+| **Shell (CLI)** | zsh (fish also installed) |
+| **Display Manager** | SDDM |
+| **Bootloader** | GRUB |
+| **Init** | systemd (graphical.target) |
+
+---
+
+## Hardware Summary
+
+| Component | Specification |
+|-----------|---------------|
+| **CPU** | Intel Core Ultra 7 155H (Meteor Lake, 22 threads) |
+| **iGPU** | Intel Arc Graphics (Meteor Lake-P) |
+| **dGPU** | NVIDIA GeForce RTX 4070 Laptop (AD106M, Max-Q) |
+| **NVIDIA Driver** | 610.57.04 |
+| **RAM** | 62 GiB |
+| **Swap** | 62 GiB (zram0) |
+| **Boot Disk** | Samsung 990 EVO (1.8 TB), /boot + LUKS-encrypted / |
+| **Secondary Disk** | KIOXIA BG6 (953.9 GB) |
+| **Root** | LUKS encrypted, ~1.2 TB available |
+
+---
+
+## Software Stack
+
+### Compositor and Shell
+
+- **Niri 26.04** — Scrollable-tiling Wayland compositor
+- **Noctalia Shell 4.7.7** — Desktop shell built with Quickshell (qs 0.0.12)
+- **Shelly Notifications** — Notification tray service
+
+### Applications
+
+- **Ghostty 1.3.1** — Terminal emulator
+- **Firefox 153.0** — Primary browser
+- **Chromium 150.0** — Secondary browser
+- **Nautilus 50.2.2** — File manager
+- **Neovim 0.12.4** — Text editor
+- **Steam 1.0.0.86** — Gaming platform
+
+### Audio
+
+- **PipeWire 1.6.8** — Multimedia router
+- **WirePlumber 0.5.15** — Session manager
+- **pavucontrol** — Volume control GUI
+
+### Screenshots and Recording
+
+- **grim** — Wayland screenshot utility
+- **slurp** — Screen region selector
+- **swappy** —Screenshot annotator
+- **wl-clipboard 2.3.0** — Wayland clipboard
+- **hyprpicker** — Color picker
+- **wf-recorder** — Screen recording
+
+### Display Management
+
+- **wlr-randr** — Display configuration utility
+
+See [[hardware|hardware]] for full hardware details.
+See [[displays|displays]] for the three-monitor layout.
+See [[cachyos|cachyos]] for operating system details.
+
+  * [Display Configuration](displays.md) — Three-monitor display setup on dankware — dual Samsung Odyssey G75F (portrait) and internal BOE panel.
+
+  * [Hardware Specifications](hardware.md) — Complete hardware specifications for dankware — Alienware m16 R2.
+
+  * [Network Interfaces](network.md) — Network configuration for dankware — Wi-Fi, USB Ethernet, and local network topology.
@@ -0,0 +1,54 @@
+---
+type: reference
+title: Network Interfaces
+description: Network configuration for dankware — Wi-Fi, USB Ethernet, and local network topology.
+tags:
+  - network
+  - interfaces
+  - wifi
+  - unverified
+generated:
+  by: chief-designer/agent
+  at: 2026-08-26T00:00:00Z
+verified: 2026-08-28
+---
+
+# Network Interfaces — dankware
+
+## Active Interfaces
+
+| Interface | Type | Status | Address | Connection |
+| `wlan0` | Wi-Fi | Connected | 192.168.0.12/24 | FRANKFI-5G |
+| `enp0s13f0u1u1` | USB Ethernet | Down (no carrier) | — | — |
+| `enp47s0` | Built-in Ethernet (Killer E3000) | Connected | 192.168.0.226/24 | Wired connection 1 |
+| `lo` | Loopback | Connected | 127.0.0.1/8 | lo |
+
+## Network Manager
+
+| Property | Value |
+|----------|-------|
+| **Tool** | nmcli 1.58.0 |
+| **DNS** | systemd-resolved (127.0.0.53) |
+| **mDNS** | Enabled (resolve) |
+
+## Local Network
+
+| Host | IP | Service | Port |
+| **dankware** | 192.168.0.12 (Wi-Fi) / 192.168.0.226 (Built-in Eth) | This machine | — |
+| **dankserver** | 192.168.0.235 | llama.cpp | 7770 |
+| **dankclaw** | 192.168.0.143 | llama.cpp | 7770 |
+
+## Services
+
+| Service | Status |
+|---------|--------|
+| **sshd** | Active |
+| **bluetooth** | Active (BlueZ 5.87) |
+
+---
+
+## See Also
+
+- [[dankserver|dankserver]] — Primary llama.cpp server
+- [[dankclaw|dankclaw]] — Secondary llama.cpp server
+- ](../index.md) — System overview
@@ -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.