Files

T

Mikhail ChusavitinandClaude Sonnet 5 6d13c17d36 iso: give the live image a real hostname instead of live-build's default "debian"

Adds BEE_HOSTNAME, derived with the same easy-bee-<variant>-v<version>
scheme already used for ISO_BASENAME/SQUASHFS_FILENAME/BEE_ISO_VOLUME, and
wires it into auto/config via lb config --hostname. Documented the shared
naming scheme as a runtime-flows.md invariant.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-28 10:30:40 +03:00

architecture

iso: give the live image a real hostname instead of live-build's default "debian"

2026-07-28 10:30:40 +03:00

decisions

boot: drop pci=realloc from default/toram GRUB entries, fold into troubleshooting entry

2026-07-28 09:34:25 +03:00

docs

gpu: collect reset-required/row-remap status and classify Xid codes by severity

2026-07-07 19:28:59 +03:00

proposals

proposals: RFC for sfp_modules[] contract extension (v2.10 → v2.11)

2026-06-19 18:14:46 +03:00

rules/patterns/ascii-safe-text

Update bible submodule to remote HEAD, preserve ascii-safe-text contract locally

2026-04-29 10:30:27 +03:00

backlog.md

backlog: add SFP module collection with contract gap analysis

2026-06-19 16:25:57 +03:00

README.md

boot: drop pci=realloc from default/toram GRUB entries, fold into troubleshooting entry

2026-07-28 09:34:25 +03:00

README.md

bee — Project Bible

Project-specific architecture, decisions, and runtime contracts. Generic engineering rules live in bible/rules/patterns/.

Files

File	Contents
`architecture/system-overview.md`	What bee does, scope, tech stack
`architecture/runtime-flows.md`	Boot sequence, audit flow, service order
`docs/customer-gpu-test-methodology.md`	Customer-facing GPU PCIe Validate / Validate -> Stress test list
`docs/hardware-ingest-contract.md`	Current Reanimator hardware ingest JSON contract
`docs/validate-vs-burn.md`	Validate and Validate -> Stress hardware test policy
`decisions/`	Architectural decision log, including read-only submodule policy
`proposals/`	RFCs and contract change proposals for Reanimator Core

Validate Test Matrix

Validate

CPU check
- lscpu
- sensors
- stress-ng
Memory check
- free
- timeout <timeout_sec> memtester
- free
NVMe storage check
- nvme id-ctrl
- nvme smart-log
- nvme device-self-test
SATA/SAS storage check
- smartctl -H -A
- smartctl -t short
Basic NVIDIA GPU check
- nvidia-smi -pm 1
- nvidia-smi -q
- dmidecode -t baseboard
- dmidecode -t system
- dcgmi diag -r 2
Inter-GPU communication check
- all_reduce_perf
GPU bandwidth check
- dcgmi diag -r nvbandwidth (per CPU socket, then all selected GPUs, on multi-socket systems -- see decisions/2026-07-27-nvbandwidth-per-socket-split.md)

Validate -> Stress

Extended NVIDIA GPU check
- nvidia-smi -pm 1
- nvidia-smi -q
- dmidecode -t baseboard
- dmidecode -t system
- dcgmi diag -r 3
NVIDIA targeted stress
- nvidia-smi -pm 1
- nvidia-smi -q
- dcgmi diag -r targeted_stress
NVIDIA targeted power
- nvidia-smi -pm 1
- nvidia-smi -q
- dcgmi diag -r targeted_power
NVIDIA pulse test
- nvidia-smi -pm 1
- nvidia-smi -q
- dcgmi diag -r pulse_test
Inter-GPU communication check
- all_reduce_perf
GPU bandwidth check
- dcgmi diag -r nvbandwidth (per CPU socket, then all selected GPUs, on multi-socket systems -- see decisions/2026-07-27-nvbandwidth-per-socket-split.md)