Frank
671222b881
Measured fixes, one line each, from the review of everything that landed on 2026-10-20 (issue #60). Each page keeps its own facts; nothing was moved. - inventory/index, index: the census blurb says what the page actually covers (tracked-vs-box-only per file), not "all userspace configuration" - dotfiles-deploy: the wallpaper re-fetch recipe resolves the CDN URL through the wallhaven API — /w/<id> answers text/html, so curl -L never yields a JPEG; description widened to the whole page, tools/index blurb matched - okf-maintenance: the link example and the mistake bullet now agree with okf-spec, which RECOMMENDS absolute bundle paths (they said the opposite) - decisions/index: the unlisted-page gate is kb-coverage.py, not kb-lint - AGENTS.md: the three skill-config subsections are pointers again; the pages own issue tracker, labels and domain docs - swayidle-lock.service: Description names what the unit does (arms the idle lock over noctalia-shell IPC); suspend belongs to noctalia's inhibitor - common.pkgs: git-lfs re-justified by the tracked .gitattributes filter contract; the swayidle comment drops its lid-policy claim
2.5 KiB
Command Center Knowledge Base
System configuration knowledge base for Frank's fleet (Dankclaw, Dankserver, and the client workstations) and the agent tooling that runs on it. Every concept has its own file; every directory index links its complete contents. Format: OKF v0.1 — a directory of markdown files with YAML frontmatter (see references/okf-spec.md).
Verification discipline: facts carry verified: stamps when probed against the
live fleet, and an unverified tag where a claim could not be checked on
2026-08-28. Trust stamped facts over memory; re-verify before acting on
unverified ones.
System
Hardware, OS, and network of the three-box fleet — verified against live probes on 2026-08-28.
Caddy
The reverse proxy fronting every service on both servers (Podman Quadlet, Porkbun DNS-01, hot reload).
Gitea and tooling
Installed software: Gitea, llama.cpp, niri, ghostty, tmux, ComfyUI, CachyOS, skills tooling — each with its verified operational facts.
Pi-era agent setup
The legacy pi agent configuration (~/.pi era): settings, models, packages,
skills. Kept for reference; the live harness is OMP under ~/.omp.
Skills tooling
The Agent Skills standard, the skills CLI, this fleet's store wiring, and
the registries — for the live OMP harness. Pi-era packages are archived under
Pi-era agent setup.
Core config
The live agent configuration itself: settings, models, AGENTS.md conventions.
Engineering references
Practice notes: SDLC, languages, infra tooling (Terraform, K8s, containers).
Research
Decision-support research: agentic web tooling, chezmoi evaluation, secrets-for-agents. Research docs inform decisions; they are not facts yet.
Agentic web research
Self-hosted web-agent stack research: SearXNG tuning, VPN routing, agentic search practices, open models, MCP.
Inventory
Per-file tracked-vs-box-only census of ~/.config on blankpad — the input for the
dotfiles pruning/adoption session.
Decisions
Architecture decision records — the choices that are no longer up for debate, with what was rejected and why. Currently empty; the format rule is in its index.
Change history
Chronological update history of this bundle — incident lessons land here first, then settle into concept pages.