diff --git a/data/backlog.json b/data/backlog.json
index 5778eef1..ad7d5bd1 100644
--- a/data/backlog.json
+++ b/data/backlog.json
@@ -182,7 +182,7 @@
{"project":"linux-phone-oco/google-walleye-lab","id":"walleye-follows-template","title":"google-walleye-lab follows device-template's release: its copy of the list gone, its rust job in its own workflow, the pin a release, stale PR 208 closed","status":"open","note":"Migration for decision 2026-11-18-device-template-follows-by-release; no phone. Measured drift today: generic copy 5 entries behind, ffs-acm-rs job inside the template's check.yml, devicebase.toml template = 2026-11-17, PR #208 (the template's #15 by hand) open though main has it.","opened":"2026-11-18","waits":null,"blocked_by":"template-releases","hardware":null,"needs":"build","device":"google-walleye","proof":"docs research/device-template/2026-11-18/template-drift.sh device-template ideal-knowledge-base google-walleye-lab: every google-walleye-lab line says ok","rank":null,"about":"device-template"}
{"project":"linux-phone-oco/docs","id":"bringup-steps","title":"Bring-up steps as data: every step that makes Linux run on a machine, generic in docs, each device's status claimed in its own base, a guidebook and helpers made from it","status":"open","note":"Decided 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base (research bringup-steps-landscape). The pieces are the items about bringup-steps, unranked for the author.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,bringup-steps-seed,feed-device-steps,walleye-steps-claimed","hardware":null,"needs":null,"device":null,"proof":"research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes in docs: tad q bringup-chain --device google-walleye lists walleye's steps in order, each proven one with its proof and run, none unknown (fails today: no query bringup-chain)","rank":null,"about":"commons-only"}
{"project":"linux-phone-oco/docs","id":"bringup-steps-schema","title":"The bring-up step tables in docs: bringup_steps, bringup_step_edges, step_status, the records bringup-step and bringup-edge, and the query bringup-chain","status":"done","note":"Landed: tables bringup_stages (the stage list as rows, so it changes with ikb bringup-stage and no schema change), bringup_steps, bringup_step_edges, step_status (declared only; a feed fills it); records bringup-step, bringup-edge (refuses a cycle, a self-edge, a group mixing hard and soft), bringup-stage; query bringup-chain [--device] with a computed ready/waits. Reviewed by the programmer subagent (group-name collision, UNION for the depth walk, stage tie, device guard fixed). tad check: 37 tables; make verify twice clean. Test research/bringup-steps/2026-11-18/bringup-chain-walleye.sh: was 'no query bringup-chain'; with the schema and seed it gets 26 steps in order and fails only for lack of claims (walleye kernel-reaches-init is unknown, not done): walleye-steps-claimed and feed-device-steps make it pass.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":null,"device":null,"proof":"tad check passes with the three tables; tad r bringup-edge refuses an edge that closes a cycle; tad q bringup-chain answers with no device (every status unknown)","rank":null,"about":"bringup-steps"}
-{"project":"linux-phone-oco/docs","id":"bringup-steps-seed","title":"Seed the generic steps: 26 steps and 37 edges from walleye's real chain, surya's road checked against it","status":"open","note":"sh research/bringup-steps/2026-11-18/seed.sh in docs, through the records","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema","hardware":null,"needs":null,"device":null,"proof":"tad q bringup-chain lists 26 steps, bootloader and stock steps at depth 0, health-suite-runs last; tad check passes","rank":null,"about":"bringup-steps"}
+{"project":"linux-phone-oco/docs","id":"bringup-steps-seed","title":"Seed the generic steps: 26 steps and 37 edges from walleye's real chain, surya's road checked against it","status":"done","note":"Landed: 8 stages, 26 steps and 37 edges recorded through ikb bringup-stage, bringup-step and bringup-edge (research/bringup-steps/2026-11-18/seed.sh, rerunnable). tad q bringup-chain lists 26 steps in order: stock-measured, stock-facts-read, slot-state-known and initramfs-gadget-emulated at depth 0, bootloader-unlocked at 1 (a soft need on stock-measured: an unlock may wipe the stock system), health-suite-runs last at 12; every status unknown until a base claims. Stages are rows of bringup_stages (prepare, boot, console, kernel, power, storage, userspace, lab), the draft awaiting the author's word: change them with ikb bringup-stage, no schema change. tad check passes; make verify twice clean.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema","hardware":null,"needs":null,"device":null,"proof":"tad q bringup-chain lists 26 steps, bootloader and stock steps at depth 0, health-suite-runs last; tad check passes","rank":null,"about":"bringup-steps"}
{"project":"linux-phone-oco/device-template","id":"steps-contract","title":"The steps contract in the template: a steps table, the record step, contract steps = 1 in devicebase.toml, data/steps.json empty, in the template's followed files","status":"open","note":"Reaches labs by the template release (decision 2026-11-18-device-template-follows-by-release), never by hand. A new device starts with no claim: every step not known yet.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,template-releases","hardware":null,"needs":null,"device":null,"proof":"in the template, tad check passes with an empty steps table; tad r step --step shell-on-console --status done --proof X --run Y writes one row and refuses a status outside the six","rank":null,"about":"bringup-steps"}
{"project":"linux-phone-oco/docs","id":"feed-device-steps","title":"Pull each device base's steps into step_status: records/feed-device-steps.sql and a device-steps-unknown fallback in bin/run-feeds.sh","status":"open","note":"As feed-device-parts: read devicebase.toml (steps = 1) and data/steps.json from the base on main; a step not claimed is unknown, not known yet; a claim of a step docs does not know is dropped and named.","opened":"2026-11-18","waits":null,"blocked_by":"bringup-steps-schema,steps-contract","hardware":null,"needs":null,"device":null,"proof":"run against a base without steps = 1, every step of that device is unknown with the reason; against google-walleye-lab after its claims, research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes","rank":null,"about":"bringup-steps"}
{"project":"linux-phone-oco/google-walleye-lab","id":"walleye-steps-claimed","title":"walleye claims its bring-up steps in its own base, from its records","status":"open","note":"The 26 claims are written out in research/bringup-steps/2026-11-18/claims-walleye.sh, each run a record of google-walleye-lab. Data only; no phone.","opened":"2026-11-18","waits":null,"blocked_by":"steps-contract,walleye-follows-template","hardware":null,"needs":"build","device":"google-walleye","proof":"research/bringup-steps/2026-11-18/bringup-chain-walleye.sh passes in docs after make feeds","rank":null,"about":"bringup-steps"}
diff --git a/data/bringup_stages.json b/data/bringup_stages.json
new file mode 100644
index 00000000..07e3d7e9
--- /dev/null
+++ b/data/bringup_stages.json
@@ -0,0 +1,8 @@
+{"id":"prepare","ord":1,"title":"Prepare","what":"Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back."}
+{"id":"boot","ord":2,"title":"Boot","what":"Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it."}
+{"id":"console","ord":3,"title":"Console","what":"A window onto the running kernel: a banner, a shell, over UART or the USB gadget."}
+{"id":"kernel","ord":4,"title":"Kernel","what":"Our kernel builds, reaches its init and says nothing worse than it should."}
+{"id":"power","ord":5,"title":"Power","what":"The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running."}
+{"id":"storage","ord":6,"title":"Storage","what":"Internal storage seen, first read-only."}
+{"id":"userspace","ord":7,"title":"Userspace","what":"A distribution's root boots, the network is up and the health suite runs on every boot."}
+{"id":"lab","ord":8,"title":"Lab","what":"What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick."}
diff --git a/data/bringup_step_edges.json b/data/bringup_step_edges.json
new file mode 100644
index 00000000..9fce8f55
--- /dev/null
+++ b/data/bringup_step_edges.json
@@ -0,0 +1,37 @@
+{"step":"bootloader-unlocked","requires":"stock-measured","kind":"soft","group":null,"why":"an unlock may wipe the stock system"}
+{"step":"control-image-boots","requires":"bootloader-unlocked","kind":"hard","group":null,"why":"fastboot boot needs an unlocked bootloader"}
+{"step":"control-image-boots","requires":"slot-state-known","kind":"hard","group":null,"why":"walleye: refusals were the slot state (walleye-load-error-first-state)"}
+{"step":"boot-image-packs","requires":"stock-facts-read","kind":"hard","group":null,"why":"the header and offsets are the stock image's"}
+{"step":"kernel-builds","requires":"stock-facts-read","kind":"soft","group":null,"why":"the dtb ids the bootloader matches"}
+{"step":"dtbo-accepted","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our dtb that must merge"}
+{"step":"stock-kernel-runs-our-init","requires":"control-image-boots","kind":"hard","group":null,"why":"the control is the image swapped into"}
+{"step":"stock-kernel-runs-our-init","requires":"boot-image-packs","kind":"hard","group":null,"why":"the swap repacks"}
+{"step":"stock-kernel-runs-our-init","requires":"initramfs-gadget-emulated","kind":"soft","group":null,"why":"an init proven emulated spends no phone time"}
+{"step":"crash-window","requires":"stock-facts-read","kind":"soft","group":null,"why":"the ramoops region is the stock fdt's"}
+{"step":"reference-kernel-boots","requires":"control-image-boots","kind":"hard","group":null,"why":"same bootloader path"}
+{"step":"reference-kernel-boots","requires":"boot-image-packs","kind":"hard","group":null,"why":"packed the device's way"}
+{"step":"kernel-reaches-init","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our kernel"}
+{"step":"kernel-reaches-init","requires":"boot-image-packs","kind":"hard","group":null,"why":"packed the device's way"}
+{"step":"kernel-reaches-init","requires":"control-image-boots","kind":"hard","group":null,"why":"the bootloader accepts images"}
+{"step":"kernel-reaches-init","requires":"dtbo-accepted","kind":"hard","group":null,"why":"walleye: no start without the merge (walleye-dtbo-overlay-merge-why)"}
+{"step":"kernel-reaches-init","requires":"crash-window","kind":"soft","group":null,"why":"without one a dead kernel says nothing"}
+{"step":"kernel-reaches-init","requires":"reference-kernel-boots","kind":"soft","group":null,"why":"the bisect reference"}
+{"step":"uart-console","requires":"kernel-builds","kind":"hard","group":null,"why":"it is our kernel's log"}
+{"step":"gadget-enumerates","requires":"kernel-reaches-init","kind":"hard","group":null,"why":"our kernel's gadget"}
+{"step":"gadget-enumerates","requires":"initramfs-gadget-emulated","kind":"hard","group":null,"why":"the init makes the gadget"}
+{"step":"banner-on-console","requires":"gadget-enumerates","kind":"hard","group":"console","why":"the console over the gadget"}
+{"step":"banner-on-console","requires":"uart-console","kind":"hard","group":"console","why":"or over UART"}
+{"step":"shell-on-console","requires":"banner-on-console","kind":"hard","group":null,"why":"a console that carries text first"}
+{"step":"first-dmesg-mapped","requires":"shell-on-console","kind":"hard","group":null,"why":"dmesg is read through the shell"}
+{"step":"dmesg-clean","requires":"first-dmesg-mapped","kind":"hard","group":null,"why":"the map names what to clean"}
+{"step":"pmic-bound","requires":"shell-on-console","kind":"hard","group":null,"why":"read through the shell"}
+{"step":"pmic-bound","requires":"first-dmesg-mapped","kind":"soft","group":null,"why":"the map names the PMIC's faults"}
+{"step":"charger-online","requires":"pmic-bound","kind":"hard","group":null,"why":"the charger is a PMIC child"}
+{"step":"watchdog-way-back","requires":"kernel-reaches-init","kind":"hard","group":null,"why":"it is our kernel that hangs"}
+{"step":"watchdog-way-back","requires":"pmic-bound","kind":"soft","group":null,"why":"walleye's way is the PMIC watchdog"}
+{"step":"storage-readonly","requires":"shell-on-console","kind":"hard","group":null,"why":"read through the shell"}
+{"step":"storage-readonly","requires":"dmesg-clean","kind":"soft","group":null,"why":"smmu and supplier faults stop DMA devices"}
+{"step":"usb-network","requires":"gadget-enumerates","kind":"hard","group":null,"why":"the network rides the gadget"}
+{"step":"rootfs-boots","requires":"storage-readonly","kind":"hard","group":null,"why":"the root is on the storage"}
+{"step":"rootfs-boots","requires":"usb-network","kind":"hard","group":null,"why":"ssh is the proof"}
+{"step":"health-suite-runs","requires":"rootfs-boots","kind":"hard","group":null,"why":"the suite runs on the root"}
diff --git a/data/bringup_steps.json b/data/bringup_steps.json
new file mode 100644
index 00000000..4925ff2f
--- /dev/null
+++ b/data/bringup_steps.json
@@ -0,0 +1,26 @@
+{"id":"bootloader-unlocked","title":"Bootloader unlocked","stage":"prepare","ord":1,"applies":"boot:android","done_when":"fastboot getvar all says unlocked: yes","proof":"fastboot-unlocked","proof_kind":"host-check","helper":"lpoco lab fastboot getvar","component":null,"guide":"Unlocking wipes the user's data and is the owner's act. Read the state before anything else (walleye google-walleye-bootloader-first-look, surya first-fastboot-probe).","sources":null,"checked_on":"2026-11-18"}
+{"id":"stock-measured","title":"The stock system measured","stage":"prepare","ord":2,"applies":"any","done_when":"what works on the stock system, its battery and its partitions are recorded as the reference","proof":"android-reference","proof_kind":"research","helper":null,"component":null,"guide":"Measure the stock system before anything is flashed: it is the reference 'as good as Android' is judged by, and an unlock may wipe it (walleye android-reference-walleye-measured).","sources":null,"checked_on":"2026-11-18"}
+{"id":"stock-facts-read","title":"The stock boot's facts read","stage":"prepare","ord":3,"applies":"any","done_when":"the stock cmdline, boot header and offsets, dtb ids (msm-id, board-id), running fdt and ramoops region are recorded","proof":"stock-facts-recorded","proof_kind":"research","helper":"lpoco bringup image info","component":null,"guide":"Read them from the running stock system and its boot image (walleye walleye-stock-ids-recorded, walleye-boot-cmdline-known). The running fdt is worth keeping whole: on walleye it named the cause of the dead dtbs (walleye-our-dts-gpio-reserved).","sources":null,"checked_on":"2026-11-18"}
+{"id":"slot-state-known","title":"Slots read, a way back known","stage":"prepare","ord":4,"applies":"boot:android-ab","done_when":"both slots' flags are reported before and after every try, and the phone returns to the stock system by itself","proof":"slot-report","proof_kind":"host-check","helper":"lpoco lab fastboot state","component":null,"guide":"On walleye the Load Error was the slot state left by refusals, not the image: restore the first state (Android booted to completion on a good slot) before each try (walleye-load-error-first-state).","sources":null,"checked_on":"2026-11-18"}
+{"id":"control-image-boots","title":"A known-good image boots from memory","stage":"boot","ord":1,"applies":"boot:android","done_when":"fastboot boot of a known-good stock-format image leaves fastboot and runs, nothing written","proof":"fastboot-boot-control","proof_kind":"host-check","helper":"lpoco lab fastboot boot","component":null,"guide":"The control tells 'the bootloader refuses' from 'our image is wrong' (walleye walleye-loaderror-control).","sources":null,"checked_on":"2026-11-18"}
+{"id":"boot-image-packs","title":"Our boot image packs as the device wants","stage":"boot","ord":2,"applies":"boot:android","done_when":"header version, offsets, page size, dtb placement and os word match the control where they should","proof":"bringup-pack-matches-mkbootimg","proof_kind":"build-check","helper":"lpoco bringup image pack, check","component":null,"guide":"Pack from the device's [boot] declaration and count it against the control (walleye walleye-bootimage). The helper packs header v0 only.","sources":null,"checked_on":"2026-11-18"}
+{"id":"dtbo-accepted","title":"The bootloader's dtbo overlay accepted","stage":"boot","ord":3,"applies":"boot:android-dtbo","done_when":"our dtb, built with -@ and the overlay's labels, merges with the stock dtbo, or the bootloader does not need it","proof":"dtbo-overlay-merges","proof_kind":"build-check","helper":null,"component":null,"guide":"On walleye our dtb with -@ and the 137 labels merged; the dtbo stub that was planned was never needed (walleye-dtb-overlay-symbols-build, walleye-loaderror-dtbo-stub).","sources":null,"checked_on":"2026-11-18"}
+{"id":"initramfs-gadget-emulated","title":"Our initramfs brings the gadget up, emulated","stage":"boot","ord":4,"applies":"usb:gadget","done_when":"in QEMU with dummy_hcd our initramfs makes the gadget (ACM console and a window) and the host side sees it","proof":"selftest-initramfs","proof_kind":"build-check","helper":"lpoco bringup initramfs build","component":null,"guide":"Prove the init before any phone time (walleye walleye-initramfs-usb-gadget). The generic init under lpoco is backlog bringup-generic-init.","sources":null,"checked_on":"2026-11-18"}
+{"id":"stock-kernel-runs-our-init","title":"The stock kernel runs our init","stage":"boot","ord":5,"applies":"boot:android","done_when":"the stock kernel with only our ramdisk swapped runs our /init, and it shows (a gadget, a mass-storage window)","proof":"massstorage-window-read","proof_kind":"host-check","helper":"lpoco bringup image swap","component":null,"guide":"Proves the image path apart from our kernel. On walleye the NCM function panics the vendor 4.4 kernel; a mass-storage window works (walleye-ncm-split, walleye-massstorage-window).","sources":null,"checked_on":"2026-11-18"}
+{"id":"crash-window","title":"A window on a dead boot","stage":"boot","ord":6,"applies":"any","done_when":"a dead or hung boot leaves something the host reads: UART, pstore at the phone's own ramoops region, or a timing channel","proof":"crash-window-read","proof_kind":"host-check","helper":null,"component":null,"guide":"On walleye ramoops survives only at the region the stock fdt names and only across a warm reset (walleye-pstore-warm-reset, walleye-pstore-t1-try); a timing channel told alive from dead (walleye-ml4-timing-channel); UART waits a cable (walleye-get-uart-setup).","sources":null,"checked_on":"2026-11-18"}
+{"id":"kernel-builds","title":"Our kernel and dts build","stage":"kernel","ord":1,"applies":"any","done_when":"the mainline kernel and the device's dts build with no dtc warning from our file, and the dtb carries the ids the bootloader matches","proof":"dtb-builds-with-ids","proof_kind":"build-check","helper":null,"component":null,"guide":"Start from the nearest sibling's dts in mainline (walleye from taimen, walleye-kernel-dts).","sources":null,"checked_on":"2026-11-18"}
+{"id":"reference-kernel-boots","title":"Someone else's mainline kernel boots here","stage":"kernel","ord":2,"applies":"any","done_when":"another project's mainline kernel and dtb for this device or a sibling reach their init on this phone","proof":"reference-alive","proof_kind":"host-check","helper":"lpoco bringup image bisect","component":null,"guide":"The reference to bisect against when ours is dead: swap one part at a time (walleye pk5 alive against ours dead: walleye-bisect-porthole-vs-ours, walleye-our-dtb-bisect, walleye-property-bisect).","sources":null,"checked_on":"2026-11-18"}
+{"id":"kernel-reaches-init","title":"Our kernel reaches our init","stage":"kernel","ord":3,"applies":"any","done_when":"our kernel and our dtb reach /init: the phone stays up as long as /init says, with no early reset","proof":"kernel-alive","proof_kind":"host-check","helper":"lpoco bringup image bisect","component":null,"guide":"Two traps on walleye: earlycon on an undeclared UART kills the kernel (walleye-no-earlycon); a pinctrl node without gpio-reserved-ranges touches the secure world's pins and resets the phone (walleye-our-dts-gpio-reserved).","sources":null,"checked_on":"2026-11-18"}
+{"id":"uart-console","title":"Kernel log on UART","stage":"console","ord":1,"applies":"any","done_when":"the kernel's log reaches the host over the debug UART","proof":"uart-log","proof_kind":"host-check","helper":null,"component":null,"guide":"Needs the device's debug cable or pads; on walleye it waits the cable (walleye-get-uart-setup), so the USB gadget was the console.","sources":null,"checked_on":"2026-11-18"}
+{"id":"gadget-enumerates","title":"The host sees our gadget","stage":"console","ord":2,"applies":"usb:gadget","done_when":"the host enumerates our own kernel's gadget by its vendor:product and serial","proof":"gadget-enumerates","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye y2: 1d6b:0104 18 s after the jump (walleye-try-y).","sources":null,"checked_on":"2026-11-18"}
+{"id":"banner-on-console","title":"The banner on the console","stage":"console","ord":3,"applies":"any","done_when":"/init's banner with a heartbeat reaches the host on the console, read as the lab user","proof":"banner-seen","proof_kind":"host-check","helper":null,"component":null,"guide":"The gadget serial must be the one the host's udev rule names, or the tty is root's (walleye-banner-serial-fix, walleye-try-banner2).","sources":null,"checked_on":"2026-11-18"}
+{"id":"shell-on-console","title":"A shell answers on the console","stage":"console","ord":4,"applies":"any","done_when":"commands sent on the console answer, one at a time, reliably across hangups","proof":"shell-answers","proof_kind":"host-check","helper":null,"component":null,"guide":"On walleye an interactive ash stayed silent; a plain read/exec loop and the host tty raw and -hupcl made it answer (walleye-shell-reliable, walleye-command-loop, walleye-try-z6).","sources":null,"checked_on":"2026-11-18"}
+{"id":"first-dmesg-mapped","title":"The first dmesg mapped","stage":"kernel","ord":4,"applies":"any","done_when":"the first full dmesg of our kernel is read and every line placed: works, defers, fails, and whose","proof":"dmesg-map","proof_kind":"research","helper":null,"component":null,"guide":"The map orders what follows (walleye-z6-dmesg-map, research walleye-bringup-order-plan).","sources":null,"checked_on":"2026-11-18"}
+{"id":"dmesg-clean","title":"dmesg clean","stage":"kernel","ord":5,"applies":"any","done_when":"no WARN, oops or -110, and no probe deferred but the known ones","proof":"dmesg-clean","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye z7: the GPU smmu off cleared the gpu_gx WARNs (walleye-dmesg-clean); on a rootfs the suite's no-oops and boot-warnings carry it.","sources":null,"checked_on":"2026-11-18"}
+{"id":"pmic-bound","title":"The PMIC bound","stage":"power","ord":1,"applies":"any","done_when":"the PMIC's children bind on their bus, the RTC and the power-on reason read","proof":"pmic-bound","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye: pm8998 and pmi8998 on SPMI (walleye-pmic-spmi, proven in z7). UFS rails are RPM regulators and do not wait for it (walleye-bringup-order-plan).","sources":null,"checked_on":"2026-11-18"}
+{"id":"charger-online","title":"The charger online","stage":"power","ord":2,"applies":"power:battery","done_when":"a power_supply of type USB appears, online follows the cable, and the voltage rises while connected","proof":"charger-online","proof_kind":"host-check","helper":null,"component":null,"guide":"Until it works, tries are rationed by the battery. walleye c2: the charger defers on its tps61099 supplier (walleye-charger-wait-tps61099, walleye-charger-supplier).","sources":null,"checked_on":"2026-11-18"}
+{"id":"watchdog-way-back","title":"A hung kernel comes back by itself","stage":"power","ord":3,"applies":"any","done_when":"a hung kernel resets by itself and the phone returns to a known system without hands","proof":"way-back","proof_kind":"host-check","helper":null,"component":null,"guide":"surya: qcom_wdt kept armed through sleep (way-back.sh). walleye: the PMIC watchdog (walleye-pmic-wdt-proof).","sources":null,"checked_on":"2026-11-18"}
+{"id":"storage-readonly","title":"Internal storage read-only","stage":"storage","ord":1,"applies":"any","done_when":"the internal storage lists its partitions by name, nothing written","proof":"storage-lists","proof_kind":"host-check","helper":null,"component":null,"guide":"Gives the firmware partitions every later part needs (walleye-ufs-readonly).","sources":null,"checked_on":"2026-11-18"}
+{"id":"usb-network","title":"Network over USB","stage":"userspace","ord":1,"applies":"usb:gadget","done_when":"ssh over the USB gadget's network answers","proof":"gadget-up","proof_kind":"host-check","helper":null,"component":null,"guide":"walleye: walleye-usb-net. surya had the distribution's own gadget.","sources":null,"checked_on":"2026-11-18"}
+{"id":"rootfs-boots","title":"A distribution root boots","stage":"userspace","ord":2,"applies":"any","done_when":"a distribution's root filesystem boots to its init and ssh answers","proof":"rootfs-ssh","proof_kind":"host-check","helper":"lpoco lab flash, provision","component":null,"guide":"surya boots Nura through U-Boot, systemd-boot and an EFI kernel (first-fastboot-probe).","sources":null,"checked_on":"2026-11-18"}
+{"id":"health-suite-runs","title":"The health suite runs after every boot","stage":"userspace","ord":3,"applies":"any","done_when":"the phone's own suite runs after every boot and its run is filed in the device's base","proof":"suite-filed","proof_kind":"phone-suite","helper":"lpoco lab suite put, run","component":null,"guide":"From here a part's status is measured, not judged (surya 2026-11-17-health-on-the-phone).","sources":null,"checked_on":"2026-11-18"}
diff --git a/docs/backlog.md b/docs/backlog.md
index 6049bb66..605e6761 100644
--- a/docs/backlog.md
+++ b/docs/backlog.md
@@ -4578,10 +4578,10 @@ Project
: linux-phone-oco/docs
Status
-: open
+: done
Note
-: sh research/bringup-steps/2026-11-18/seed.sh in docs, through the records
+: Landed: 8 stages, 26 steps and 37 edges recorded through ikb bringup-stage, bringup-step and bringup-edge (research/bringup-steps/2026-11-18/seed.sh, rerunnable). tad q bringup-chain lists 26 steps in order: stock-measured, stock-facts-read, slot-state-known and initramfs-gadget-emulated at depth 0, bootloader-unlocked at 1 (a soft need on stock-measured: an unlock may wipe the stock system), health-suite-runs last at 12; every status unknown until a base claims. Stages are rows of bringup_stages (prepare, boot, console, kernel, power, storage, userspace, lab), the draft awaiting the author's word: change them with ikb bringup-stage, no schema change. tad check passes; make verify twice clean.
Opened
: 2026-11-18
diff --git a/docs/bringup_stages.md b/docs/bringup_stages.md
index 1b1036b9..b800f073 100644
--- a/docs/bringup_stages.md
+++ b/docs/bringup_stages.md
@@ -1,3 +1,82 @@
# Bringup Stages
+
+
+### Prepare
+
+Ord
+: 1
+
+What
+: Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back.
+
+
+
+### Boot
+
+Ord
+: 2
+
+What
+: Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it.
+
+
+
+### Console
+
+Ord
+: 3
+
+What
+: A window onto the running kernel: a banner, a shell, over UART or the USB gadget.
+
+
+
+### Kernel
+
+Ord
+: 4
+
+What
+: Our kernel builds, reaches its init and says nothing worse than it should.
+
+
+
+### Power
+
+Ord
+: 5
+
+What
+: The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running.
+
+
+
+### Storage
+
+Ord
+: 6
+
+What
+: Internal storage seen, first read-only.
+
+
+
+### Userspace
+
+Ord
+: 7
+
+What
+: A distribution's root boots, the network is up and the health suite runs on every boot.
+
+
+
+### Lab
+
+Ord
+: 8
+
+What
+: What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick.
diff --git a/docs/bringup_step_edges.md b/docs/bringup_step_edges.md
index 40811b10..20207561 100644
--- a/docs/bringup_step_edges.md
+++ b/docs/bringup_step_edges.md
@@ -1,3 +1,563 @@
# Bringup Step Edges
+
+### Row 1
+
+Step
+: bootloader-unlocked
+
+Requires
+: stock-measured
+
+Kind
+: soft
+
+Why
+: an unlock may wipe the stock system
+
+
+### Row 2
+
+Step
+: control-image-boots
+
+Requires
+: bootloader-unlocked
+
+Kind
+: hard
+
+Why
+: fastboot boot needs an unlocked bootloader
+
+
+### Row 3
+
+Step
+: control-image-boots
+
+Requires
+: slot-state-known
+
+Kind
+: hard
+
+Why
+: walleye: refusals were the slot state (walleye-load-error-first-state)
+
+
+### Row 4
+
+Step
+: boot-image-packs
+
+Requires
+: stock-facts-read
+
+Kind
+: hard
+
+Why
+: the header and offsets are the stock image's
+
+
+### Row 5
+
+Step
+: kernel-builds
+
+Requires
+: stock-facts-read
+
+Kind
+: soft
+
+Why
+: the dtb ids the bootloader matches
+
+
+### Row 6
+
+Step
+: dtbo-accepted
+
+Requires
+: kernel-builds
+
+Kind
+: hard
+
+Why
+: it is our dtb that must merge
+
+
+### Row 7
+
+Step
+: stock-kernel-runs-our-init
+
+Requires
+: control-image-boots
+
+Kind
+: hard
+
+Why
+: the control is the image swapped into
+
+
+### Row 8
+
+Step
+: stock-kernel-runs-our-init
+
+Requires
+: boot-image-packs
+
+Kind
+: hard
+
+Why
+: the swap repacks
+
+
+### Row 9
+
+Step
+: stock-kernel-runs-our-init
+
+Requires
+: initramfs-gadget-emulated
+
+Kind
+: soft
+
+Why
+: an init proven emulated spends no phone time
+
+
+### Row 10
+
+Step
+: crash-window
+
+Requires
+: stock-facts-read
+
+Kind
+: soft
+
+Why
+: the ramoops region is the stock fdt's
+
+
+### Row 11
+
+Step
+: reference-kernel-boots
+
+Requires
+: control-image-boots
+
+Kind
+: hard
+
+Why
+: same bootloader path
+
+
+### Row 12
+
+Step
+: reference-kernel-boots
+
+Requires
+: boot-image-packs
+
+Kind
+: hard
+
+Why
+: packed the device's way
+
+
+### Row 13
+
+Step
+: kernel-reaches-init
+
+Requires
+: kernel-builds
+
+Kind
+: hard
+
+Why
+: it is our kernel
+
+
+### Row 14
+
+Step
+: kernel-reaches-init
+
+Requires
+: boot-image-packs
+
+Kind
+: hard
+
+Why
+: packed the device's way
+
+
+### Row 15
+
+Step
+: kernel-reaches-init
+
+Requires
+: control-image-boots
+
+Kind
+: hard
+
+Why
+: the bootloader accepts images
+
+
+### Row 16
+
+Step
+: kernel-reaches-init
+
+Requires
+: dtbo-accepted
+
+Kind
+: hard
+
+Why
+: walleye: no start without the merge (walleye-dtbo-overlay-merge-why)
+
+
+### Row 17
+
+Step
+: kernel-reaches-init
+
+Requires
+: crash-window
+
+Kind
+: soft
+
+Why
+: without one a dead kernel says nothing
+
+
+### Row 18
+
+Step
+: kernel-reaches-init
+
+Requires
+: reference-kernel-boots
+
+Kind
+: soft
+
+Why
+: the bisect reference
+
+
+### Row 19
+
+Step
+: uart-console
+
+Requires
+: kernel-builds
+
+Kind
+: hard
+
+Why
+: it is our kernel's log
+
+
+### Row 20
+
+Step
+: gadget-enumerates
+
+Requires
+: kernel-reaches-init
+
+Kind
+: hard
+
+Why
+: our kernel's gadget
+
+
+### Row 21
+
+Step
+: gadget-enumerates
+
+Requires
+: initramfs-gadget-emulated
+
+Kind
+: hard
+
+Why
+: the init makes the gadget
+
+
+### Row 22
+
+Step
+: banner-on-console
+
+Requires
+: gadget-enumerates
+
+Kind
+: hard
+
+Group
+: console
+
+Why
+: the console over the gadget
+
+
+### Row 23
+
+Step
+: banner-on-console
+
+Requires
+: uart-console
+
+Kind
+: hard
+
+Group
+: console
+
+Why
+: or over UART
+
+
+### Row 24
+
+Step
+: shell-on-console
+
+Requires
+: banner-on-console
+
+Kind
+: hard
+
+Why
+: a console that carries text first
+
+
+### Row 25
+
+Step
+: first-dmesg-mapped
+
+Requires
+: shell-on-console
+
+Kind
+: hard
+
+Why
+: dmesg is read through the shell
+
+
+### Row 26
+
+Step
+: dmesg-clean
+
+Requires
+: first-dmesg-mapped
+
+Kind
+: hard
+
+Why
+: the map names what to clean
+
+
+### Row 27
+
+Step
+: pmic-bound
+
+Requires
+: shell-on-console
+
+Kind
+: hard
+
+Why
+: read through the shell
+
+
+### Row 28
+
+Step
+: pmic-bound
+
+Requires
+: first-dmesg-mapped
+
+Kind
+: soft
+
+Why
+: the map names the PMIC's faults
+
+
+### Row 29
+
+Step
+: charger-online
+
+Requires
+: pmic-bound
+
+Kind
+: hard
+
+Why
+: the charger is a PMIC child
+
+
+### Row 30
+
+Step
+: watchdog-way-back
+
+Requires
+: kernel-reaches-init
+
+Kind
+: hard
+
+Why
+: it is our kernel that hangs
+
+
+### Row 31
+
+Step
+: watchdog-way-back
+
+Requires
+: pmic-bound
+
+Kind
+: soft
+
+Why
+: walleye's way is the PMIC watchdog
+
+
+### Row 32
+
+Step
+: storage-readonly
+
+Requires
+: shell-on-console
+
+Kind
+: hard
+
+Why
+: read through the shell
+
+
+### Row 33
+
+Step
+: storage-readonly
+
+Requires
+: dmesg-clean
+
+Kind
+: soft
+
+Why
+: smmu and supplier faults stop DMA devices
+
+
+### Row 34
+
+Step
+: usb-network
+
+Requires
+: gadget-enumerates
+
+Kind
+: hard
+
+Why
+: the network rides the gadget
+
+
+### Row 35
+
+Step
+: rootfs-boots
+
+Requires
+: storage-readonly
+
+Kind
+: hard
+
+Why
+: the root is on the storage
+
+
+### Row 36
+
+Step
+: rootfs-boots
+
+Requires
+: usb-network
+
+Kind
+: hard
+
+Why
+: ssh is the proof
+
+
+### Row 37
+
+Step
+: health-suite-runs
+
+Requires
+: rootfs-boots
+
+Kind
+: hard
+
+Why
+: the suite runs on the root
diff --git a/docs/bringup_steps.md b/docs/bringup_steps.md
index 62842ba9..74b8d116 100644
--- a/docs/bringup_steps.md
+++ b/docs/bringup_steps.md
@@ -1,3 +1,763 @@
# Bringup Steps
+
+
+### Bootloader unlocked
+
+Stage
+: prepare
+
+Ord
+: 1
+
+Applies
+: boot:android
+
+Done when
+: fastboot getvar all says unlocked: yes
+
+Proof
+: fastboot-unlocked
+
+Proof kind
+: host-check
+
+Helper
+: lpoco lab fastboot getvar
+
+Guide
+: Unlocking wipes the user's data and is the owner's act. Read the state before anything else (walleye google-walleye-bootloader-first-look, surya first-fastboot-probe).
+
+Checked on
+: 2026-11-18
+
+
+
+### The stock system measured
+
+Stage
+: prepare
+
+Ord
+: 2
+
+Applies
+: any
+
+Done when
+: what works on the stock system, its battery and its partitions are recorded as the reference
+
+Proof
+: android-reference
+
+Proof kind
+: research
+
+Guide
+: Measure the stock system before anything is flashed: it is the reference 'as good as Android' is judged by, and an unlock may wipe it (walleye android-reference-walleye-measured).
+
+Checked on
+: 2026-11-18
+
+
+
+### The stock boot's facts read
+
+Stage
+: prepare
+
+Ord
+: 3
+
+Applies
+: any
+
+Done when
+: the stock cmdline, boot header and offsets, dtb ids (msm-id, board-id), running fdt and ramoops region are recorded
+
+Proof
+: stock-facts-recorded
+
+Proof kind
+: research
+
+Helper
+: lpoco bringup image info
+
+Guide
+: Read them from the running stock system and its boot image (walleye walleye-stock-ids-recorded, walleye-boot-cmdline-known). The running fdt is worth keeping whole: on walleye it named the cause of the dead dtbs (walleye-our-dts-gpio-reserved).
+
+Checked on
+: 2026-11-18
+
+
+
+### Slots read, a way back known
+
+Stage
+: prepare
+
+Ord
+: 4
+
+Applies
+: boot:android-ab
+
+Done when
+: both slots' flags are reported before and after every try, and the phone returns to the stock system by itself
+
+Proof
+: slot-report
+
+Proof kind
+: host-check
+
+Helper
+: lpoco lab fastboot state
+
+Guide
+: On walleye the Load Error was the slot state left by refusals, not the image: restore the first state (Android booted to completion on a good slot) before each try (walleye-load-error-first-state).
+
+Checked on
+: 2026-11-18
+
+
+
+### A known-good image boots from memory
+
+Stage
+: boot
+
+Ord
+: 1
+
+Applies
+: boot:android
+
+Done when
+: fastboot boot of a known-good stock-format image leaves fastboot and runs, nothing written
+
+Proof
+: fastboot-boot-control
+
+Proof kind
+: host-check
+
+Helper
+: lpoco lab fastboot boot
+
+Guide
+: The control tells 'the bootloader refuses' from 'our image is wrong' (walleye walleye-loaderror-control).
+
+Checked on
+: 2026-11-18
+
+
+
+### Our boot image packs as the device wants
+
+Stage
+: boot
+
+Ord
+: 2
+
+Applies
+: boot:android
+
+Done when
+: header version, offsets, page size, dtb placement and os word match the control where they should
+
+Proof
+: bringup-pack-matches-mkbootimg
+
+Proof kind
+: build-check
+
+Helper
+: lpoco bringup image pack, check
+
+Guide
+: Pack from the device's [boot] declaration and count it against the control (walleye walleye-bootimage). The helper packs header v0 only.
+
+Checked on
+: 2026-11-18
+
+
+
+### The bootloader's dtbo overlay accepted
+
+Stage
+: boot
+
+Ord
+: 3
+
+Applies
+: boot:android-dtbo
+
+Done when
+: our dtb, built with -@ and the overlay's labels, merges with the stock dtbo, or the bootloader does not need it
+
+Proof
+: dtbo-overlay-merges
+
+Proof kind
+: build-check
+
+Guide
+: On walleye our dtb with -@ and the 137 labels merged; the dtbo stub that was planned was never needed (walleye-dtb-overlay-symbols-build, walleye-loaderror-dtbo-stub).
+
+Checked on
+: 2026-11-18
+
+
+
+### Our initramfs brings the gadget up, emulated
+
+Stage
+: boot
+
+Ord
+: 4
+
+Applies
+: usb:gadget
+
+Done when
+: in QEMU with dummy_hcd our initramfs makes the gadget (ACM console and a window) and the host side sees it
+
+Proof
+: selftest-initramfs
+
+Proof kind
+: build-check
+
+Helper
+: lpoco bringup initramfs build
+
+Guide
+: Prove the init before any phone time (walleye walleye-initramfs-usb-gadget). The generic init under lpoco is backlog bringup-generic-init.
+
+Checked on
+: 2026-11-18
+
+
+
+### The stock kernel runs our init
+
+Stage
+: boot
+
+Ord
+: 5
+
+Applies
+: boot:android
+
+Done when
+: the stock kernel with only our ramdisk swapped runs our /init, and it shows (a gadget, a mass-storage window)
+
+Proof
+: massstorage-window-read
+
+Proof kind
+: host-check
+
+Helper
+: lpoco bringup image swap
+
+Guide
+: Proves the image path apart from our kernel. On walleye the NCM function panics the vendor 4.4 kernel; a mass-storage window works (walleye-ncm-split, walleye-massstorage-window).
+
+Checked on
+: 2026-11-18
+
+
+
+### A window on a dead boot
+
+Stage
+: boot
+
+Ord
+: 6
+
+Applies
+: any
+
+Done when
+: a dead or hung boot leaves something the host reads: UART, pstore at the phone's own ramoops region, or a timing channel
+
+Proof
+: crash-window-read
+
+Proof kind
+: host-check
+
+Guide
+: On walleye ramoops survives only at the region the stock fdt names and only across a warm reset (walleye-pstore-warm-reset, walleye-pstore-t1-try); a timing channel told alive from dead (walleye-ml4-timing-channel); UART waits a cable (walleye-get-uart-setup).
+
+Checked on
+: 2026-11-18
+
+
+
+### Our kernel and dts build
+
+Stage
+: kernel
+
+Ord
+: 1
+
+Applies
+: any
+
+Done when
+: the mainline kernel and the device's dts build with no dtc warning from our file, and the dtb carries the ids the bootloader matches
+
+Proof
+: dtb-builds-with-ids
+
+Proof kind
+: build-check
+
+Guide
+: Start from the nearest sibling's dts in mainline (walleye from taimen, walleye-kernel-dts).
+
+Checked on
+: 2026-11-18
+
+
+
+### Someone else's mainline kernel boots here
+
+Stage
+: kernel
+
+Ord
+: 2
+
+Applies
+: any
+
+Done when
+: another project's mainline kernel and dtb for this device or a sibling reach their init on this phone
+
+Proof
+: reference-alive
+
+Proof kind
+: host-check
+
+Helper
+: lpoco bringup image bisect
+
+Guide
+: The reference to bisect against when ours is dead: swap one part at a time (walleye pk5 alive against ours dead: walleye-bisect-porthole-vs-ours, walleye-our-dtb-bisect, walleye-property-bisect).
+
+Checked on
+: 2026-11-18
+
+
+
+### Our kernel reaches our init
+
+Stage
+: kernel
+
+Ord
+: 3
+
+Applies
+: any
+
+Done when
+: our kernel and our dtb reach /init: the phone stays up as long as /init says, with no early reset
+
+Proof
+: kernel-alive
+
+Proof kind
+: host-check
+
+Helper
+: lpoco bringup image bisect
+
+Guide
+: Two traps on walleye: earlycon on an undeclared UART kills the kernel (walleye-no-earlycon); a pinctrl node without gpio-reserved-ranges touches the secure world's pins and resets the phone (walleye-our-dts-gpio-reserved).
+
+Checked on
+: 2026-11-18
+
+
+
+### Kernel log on UART
+
+Stage
+: console
+
+Ord
+: 1
+
+Applies
+: any
+
+Done when
+: the kernel's log reaches the host over the debug UART
+
+Proof
+: uart-log
+
+Proof kind
+: host-check
+
+Guide
+: Needs the device's debug cable or pads; on walleye it waits the cable (walleye-get-uart-setup), so the USB gadget was the console.
+
+Checked on
+: 2026-11-18
+
+
+
+### The host sees our gadget
+
+Stage
+: console
+
+Ord
+: 2
+
+Applies
+: usb:gadget
+
+Done when
+: the host enumerates our own kernel's gadget by its vendor:product and serial
+
+Proof
+: gadget-enumerates
+
+Proof kind
+: host-check
+
+Guide
+: walleye y2: 1d6b:0104 18 s after the jump (walleye-try-y).
+
+Checked on
+: 2026-11-18
+
+
+
+### The banner on the console
+
+Stage
+: console
+
+Ord
+: 3
+
+Applies
+: any
+
+Done when
+: /init's banner with a heartbeat reaches the host on the console, read as the lab user
+
+Proof
+: banner-seen
+
+Proof kind
+: host-check
+
+Guide
+: The gadget serial must be the one the host's udev rule names, or the tty is root's (walleye-banner-serial-fix, walleye-try-banner2).
+
+Checked on
+: 2026-11-18
+
+
+
+### A shell answers on the console
+
+Stage
+: console
+
+Ord
+: 4
+
+Applies
+: any
+
+Done when
+: commands sent on the console answer, one at a time, reliably across hangups
+
+Proof
+: shell-answers
+
+Proof kind
+: host-check
+
+Guide
+: On walleye an interactive ash stayed silent; a plain read/exec loop and the host tty raw and -hupcl made it answer (walleye-shell-reliable, walleye-command-loop, walleye-try-z6).
+
+Checked on
+: 2026-11-18
+
+
+
+### The first dmesg mapped
+
+Stage
+: kernel
+
+Ord
+: 4
+
+Applies
+: any
+
+Done when
+: the first full dmesg of our kernel is read and every line placed: works, defers, fails, and whose
+
+Proof
+: dmesg-map
+
+Proof kind
+: research
+
+Guide
+: The map orders what follows (walleye-z6-dmesg-map, research walleye-bringup-order-plan).
+
+Checked on
+: 2026-11-18
+
+
+
+### dmesg clean
+
+Stage
+: kernel
+
+Ord
+: 5
+
+Applies
+: any
+
+Done when
+: no WARN, oops or -110, and no probe deferred but the known ones
+
+Proof
+: dmesg-clean
+
+Proof kind
+: host-check
+
+Guide
+: walleye z7: the GPU smmu off cleared the gpu_gx WARNs (walleye-dmesg-clean); on a rootfs the suite's no-oops and boot-warnings carry it.
+
+Checked on
+: 2026-11-18
+
+
+
+### The PMIC bound
+
+Stage
+: power
+
+Ord
+: 1
+
+Applies
+: any
+
+Done when
+: the PMIC's children bind on their bus, the RTC and the power-on reason read
+
+Proof
+: pmic-bound
+
+Proof kind
+: host-check
+
+Guide
+: walleye: pm8998 and pmi8998 on SPMI (walleye-pmic-spmi, proven in z7). UFS rails are RPM regulators and do not wait for it (walleye-bringup-order-plan).
+
+Checked on
+: 2026-11-18
+
+
+
+### The charger online
+
+Stage
+: power
+
+Ord
+: 2
+
+Applies
+: power:battery
+
+Done when
+: a power_supply of type USB appears, online follows the cable, and the voltage rises while connected
+
+Proof
+: charger-online
+
+Proof kind
+: host-check
+
+Guide
+: Until it works, tries are rationed by the battery. walleye c2: the charger defers on its tps61099 supplier (walleye-charger-wait-tps61099, walleye-charger-supplier).
+
+Checked on
+: 2026-11-18
+
+
+
+### A hung kernel comes back by itself
+
+Stage
+: power
+
+Ord
+: 3
+
+Applies
+: any
+
+Done when
+: a hung kernel resets by itself and the phone returns to a known system without hands
+
+Proof
+: way-back
+
+Proof kind
+: host-check
+
+Guide
+: surya: qcom_wdt kept armed through sleep (way-back.sh). walleye: the PMIC watchdog (walleye-pmic-wdt-proof).
+
+Checked on
+: 2026-11-18
+
+
+
+### Internal storage read-only
+
+Stage
+: storage
+
+Ord
+: 1
+
+Applies
+: any
+
+Done when
+: the internal storage lists its partitions by name, nothing written
+
+Proof
+: storage-lists
+
+Proof kind
+: host-check
+
+Guide
+: Gives the firmware partitions every later part needs (walleye-ufs-readonly).
+
+Checked on
+: 2026-11-18
+
+
+
+### Network over USB
+
+Stage
+: userspace
+
+Ord
+: 1
+
+Applies
+: usb:gadget
+
+Done when
+: ssh over the USB gadget's network answers
+
+Proof
+: gadget-up
+
+Proof kind
+: host-check
+
+Guide
+: walleye: walleye-usb-net. surya had the distribution's own gadget.
+
+Checked on
+: 2026-11-18
+
+
+
+### A distribution root boots
+
+Stage
+: userspace
+
+Ord
+: 2
+
+Applies
+: any
+
+Done when
+: a distribution's root filesystem boots to its init and ssh answers
+
+Proof
+: rootfs-ssh
+
+Proof kind
+: host-check
+
+Helper
+: lpoco lab flash, provision
+
+Guide
+: surya boots Nura through U-Boot, systemd-boot and an EFI kernel (first-fastboot-probe).
+
+Checked on
+: 2026-11-18
+
+
+
+### The health suite runs after every boot
+
+Stage
+: userspace
+
+Ord
+: 3
+
+Applies
+: any
+
+Done when
+: the phone's own suite runs after every boot and its run is filed in the device's base
+
+Proof
+: suite-filed
+
+Proof kind
+: phone-suite
+
+Helper
+: lpoco lab suite put, run
+
+Guide
+: From here a part's status is measured, not judged (surya 2026-11-17-health-on-the-phone).
+
+Checked on
+: 2026-11-18
diff --git a/docs/index.md b/docs/index.md
index 237a081c..0f447008 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -5,9 +5,9 @@
The memory of linux-phone-oco, whose goal is Linux phones as good as Android for everyday use, and better: which phone supports which hardware, how we know, why decisions were made, and what is next. Plain versioned data; see AGENTS.md. The plan, and where Linux phones stand against Android and iOS: [the grand picture](picture.md), and the main screen, [features against Android and iOS](feature_support.md).
- [Backlog](backlog.md): 194
-- [Bringup Stages](bringup_stages.md): 0
-- [Bringup Step Edges](bringup_step_edges.md): 0
-- [Bringup Steps](bringup_steps.md): 0
+- [Bringup Stages](bringup_stages.md): 8
+- [Bringup Step Edges](bringup_step_edges.md): 37
+- [Bringup Steps](bringup_steps.md): 26
- [Components](components.md): 21
- [Concepts](concepts.md): 10
- [Decisions](decisions.md): 72
diff --git a/research/bringup-steps/2026-11-18/seed.sh b/research/bringup-steps/2026-11-18/seed.sh
index e5ec2c24..6e401ec1 100755
--- a/research/bringup-steps/2026-11-18/seed.sh
+++ b/research/bringup-steps/2026-11-18/seed.sh
@@ -1,10 +1,21 @@
#!/bin/sh
-# Seeds the generic bring-up steps and their edges through the records (decision
-# 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base). Run in docs once records/bringup-step.sql and
-# records/bringup-edge.sql exist. The steps are walleye's real chain generalised; surya's path checked them.
+# Seeds the stages, the generic bring-up steps and their edges through the records (ikb; decision
+# 2026-11-18-bringup-steps-generic-in-docs-status-in-each-base). Run in docs; the records are bringup-stage,
+# bringup-step and bringup-edge. The steps are walleye's real chain generalised; surya's path checked them.
+# The stage list is the draft's and waits the author's word: stages are rows, changed with ikb bringup-stage.
set -eu
-st() { tad r bringup-step --checked-on 2026-11-18 "$@" >/dev/null; }
-ed() { tad r bringup-edge "$@" >/dev/null; }
+st() { ikb bringup-step --checked-on 2026-11-18 "$@" >/dev/null; }
+ed() { ikb bringup-edge "$@" >/dev/null; }
+sg() { ikb bringup-stage "$@" >/dev/null; }
+
+sg --id prepare --ord 1 --title "Prepare" --what "Read what the machine is and what it allows before anything is changed: the stock system, the boot facts, the way back."
+sg --id boot --ord 2 --title "Boot" --what "Get an image of ours accepted by the bootloader and run, one part swapped at a time, until it is known what refuses it."
+sg --id console --ord 3 --title "Console" --what "A window onto the running kernel: a banner, a shell, over UART or the USB gadget."
+sg --id kernel --ord 4 --title "Kernel" --what "Our kernel builds, reaches its init and says nothing worse than it should."
+sg --id power --ord 5 --title "Power" --what "The PMIC, the charger and the watchdog: what keeps the machine alive and safe to leave running."
+sg --id storage --ord 6 --title "Storage" --what "Internal storage seen, first read-only."
+sg --id userspace --ord 7 --title "Userspace" --what "A distribution's root boots, the network is up and the health suite runs on every boot."
+sg --id lab --ord 8 --title "Lab" --what "What the lab needs of a machine to work on it without hands: the ways in, a try that cannot brick."
st --id bootloader-unlocked --title "Bootloader unlocked" --stage prepare --ord 1 --applies boot:android \
--done-when "fastboot getvar all says unlocked: yes" --proof fastboot-unlocked --proof-kind host-check \