Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion data/backlog.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"}
Expand Down
8 changes: 8 additions & 0 deletions data/bringup_stages.json
Original file line number Diff line number Diff line change
@@ -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."}
37 changes: 37 additions & 0 deletions data/bringup_step_edges.json
Original file line number Diff line number Diff line change
@@ -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"}
Loading
Loading