Rebuild runbook + state capture + docs sync to current reality (#615)

REBUILD.md maps a full rebuild (PVE qm spec incl. nested-virt flag,
guest OS/accounts/dotfiles bootstrap, script order, package baseline,
verification checklist). 14-capture-state.sh regenerates docs/state
snapshots (guest apt/units/sysctl/fstab/docker + PVE 5111 config).
Docs sync: stale multiqueue-owed text removed from NEXT/REPORT/RUNBOOK;
README script list + open-work list current.

Details: https://projects.knownelement.com/issues/615
This commit is contained in:
2026-09-01 13:31:38 -05:00
parent eeeca9bde9
commit 46fe0cb6a5
15 changed files with 1014 additions and 21 deletions
+13 -6
View File
@@ -10,7 +10,9 @@ are manual-only by ruling.
#605 k8s + proxmox token (blocked by #601), #606 GPU passthrough,
#607 account map/mkacct, #608 compose cgroup_parent wiring (gateway
starvation fix on 8 vCPU), #609 Fri 09-04 troubleshooting-only outage;
pass record: #602.
#611 RDP big-monitor fix (live, human UAT pending), #612 dotfiles v2 +
Kali addendum (human UAT pending), #615 microvm + rebuild capture,
#616 macOS VM (blocked by #601); pass record: #602.
https://projects.knownelement.com/projects/55
- Discourse doc: pending (house cross-link rule: create at next doc pass).
- Docs live in-repo (runbook exception per house rules):
@@ -18,14 +20,19 @@ are manual-only by ruling.
- NEXT.md — current state / what is owed (usually: nothing)
- TRACKING.md — rolling HUD table + decisions log
- GROW-ROOT-RUNBOOK.md — manual root-growth checklist (#603)
- REBUILD.md — full-rebuild runbook, guest + PVE sides (#615);
docs/state/ holds regenerable state snapshots (14-capture-state.sh)
- RUNBOOK-TODAY.md, questions-v1.md
- Scripts (human-run unless noted): 1-guest-prep.sh, 2-host-one-shot.sh,
3-post-reboot-fixes.sh, 4-host-netcheck.sh (crush may run via ssh),
5-activate-multiqueue.sh (the one remaining reboot), 6-remove-agent-stacks.sh
(boot-time screen/crush relauncher teardown; backups in
removed-agent-stacks/), 7-open-terminal-install.sh + 8-open-terminal-users.sh
(Open Terminal fleet, #610), 9-uat-openwebui.sh (OpenWebUI<->terminal UAT
harness; uat/ holds its compose). staged/ holds the gated configs.
5-activate-multiqueue.sh (historical — multiqueue live 2026-09-01),
6-remove-agent-stacks.sh (boot-time screen/crush relauncher teardown;
backups in removed-agent-stacks/), 7-open-terminal-install.sh +
8-open-terminal-users.sh (Open Terminal fleet, #610), 9-uat-openwebui.sh
(OpenWebUI<->terminal UAT harness; uat/ holds its compose),
12-fix-rdp-bigres.sh (xrdp EGFX frame budget, #611),
13-microvm-setup.sh + microvm/ (microVM tooling, #615),
14-capture-state.sh (refresh docs/state). staged/ holds the gated configs.
- OPEN-TERMINAL.md — ops note for the terminal fleet: ports, keys location,
production OpenWebUI wiring, UAT record.
- crush.md = session preferences for agents working in this repo.