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
3 changes: 2 additions & 1 deletion data/backlog.json
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@
{"project":"linux-phone-oco/lab-tools","id":"host-undeclared-gadget-serial","title":"lpoco host check names a gadget that enumerated with a serial no device declares","status":"done","note":"Done in lpoco-host 0.6.1 (lab-tools PR 131/132): proof tests check_names_a_gadget_that_enumerated_with_a_serial_no_device_declares and check_does_not_report_a_gadget_whose_serial_a_device_declares. Not yet run on the lab against a live log; pin the lab to 0.6.1 by prepare now.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"google-walleye","proof":"a check test from a fixture kernel log: a 1d6b gadget with SerialNumber walleye-banner while device.toml declares walleye-first-boot is reported (device, serial seen, serial declared, when); a declared one is not","rank":1,"about":"lpoco-host"}
{"project":"linux-phone-oco/lab-tools","id":"host-watch-declared","title":"lpoco host watches only the devices whose device.toml asks to be watched","status":"done","note":"Landed lab-tools #135, released v0.7.0 (#134), read back from main. Open for others: surya-lab device.toml needs [host] watch = true before the lab's prepare.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"google-walleye","proof":"a plan test from fixtures: a device with [host] watch = true gets its devlab-watch@ instance enabled; one without it gets none, and an enabled instance of a device that no longer asks is named in the plan (never stopped silently); surya-lab's device.toml declaring watch = true is the lane's change, read from origin/main","rank":1,"about":"lpoco-host"}
{"project":"linux-phone-oco/lab-tools","id":"phone-side-pieces","title":"Phone-side pieces under the roof: carried by the lab-tools package, named by token in device.toml, a stale copy named by lpoco host check","status":"open","note":"Decision 2026-11-18-phone-side-pieces-under-the-roof. Steps: phone-pieces-drift-named (its failing test first), health-reports-pieces, lpoco-awake; then surya-awake-from-package on the phone. The manifest's one schema is manifest-one-schema (decision 2026-11-18-device-manifest-schema-from-rust).","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"host/tests/phone_pieces.rs check_names_a_stale_phone_piece and check_names_a_package_off_its_pin_and_passes_a_current_phone pass; acceptance: on the lab, lpoco host check names no stale piece of surya while surya holds the wake lock from the package, with no /usr/local/bin/devlab-usb-awake","rank":null,"about":"dt-any-phone"}
{"project":"linux-phone-oco/lab-tools","id":"phone-pieces-drift-named","title":"lpoco host check names a stale phone-side piece, from the phone's last gathered report","status":"open","note":"Write the failing test first: the full text is in docs research/phone-side-pieces/2026-11-18/inventory.md (not landed - lab-tools has no ignored/expected-fail convention and it does not compile until the function exists). lpoco_host gains blob_id (git's blob id), stale_pieces(device, report, main) -> Vec<Stale> (File {path, found, main} for each declared overlay/install/device check whose reported blob differs from origin/main's; Package {name, found, pin} for a lab-tools package off the [tools] lpoco pin). check reads each device's newest tests/results/*.jsonl at origin/main, names the commit the installed copy came from (git log --find-object) and the report's age. Then lpoco lab names the same at every change's end from the report it reads back.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"host/tests/phone_pieces.rs check_names_a_stale_phone_piece, check_names_a_package_off_its_pin_and_passes_a_current_phone (to write, failing first)","rank":6,"about":"phone-side-pieces"}
{"project":"linux-phone-oco/lab-tools","id":"phone-pieces-drift-named","title":"lpoco host check names a stale phone-side piece, from the phone's last gathered report","status":"done","note":"Landed in lab-tools PR 165 (7b4a36a): lpoco host check names a stale or missing phone-side piece and a package off the pin, from the device's newest tests/results/*.jsonl at origin/main. Proof: host/tests/phone_pieces.rs (3 tests, seen failing first, now pass). Not built: lpoco lab naming the same at every change's end - see phone-pieces-drift-in-lab.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"host/tests/phone_pieces.rs check_names_a_stale_phone_piece, check_names_a_package_off_its_pin_and_passes_a_current_phone (to write, failing first)","rank":6,"about":"phone-side-pieces"}
{"project":"linux-phone-oco/lab-tools","id":"health-reports-pieces","title":"lpoco-health reports what lab pieces the phone holds: each package's version and each declared file's git blob id","status":"done","note":"Done: lab-tools PR 150 (feat(health): lab-pieces check reports each declared file's blob id and package version), read back from main; released with the family after 0.12.1. The phone's report is proven once surya-awake-from-package puts the suite on surya. Next: phone-pieces-drift-named reads it.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"health/tests/pieces_report.rs under LPOCO_HEALTH_ROOT: a made-up phone with one declared file and one package reports both rows with the blob id git hash-object gives for that file (to write)","rank":5,"about":"phone-side-pieces"}
{"project":"linux-phone-oco/lab-tools","id":"lpoco-awake","title":"The lab phone's keep-awake as lpoco-health awake: a unit in the package, gates named by device.toml, its generic check","status":"done","note":"Landed lab-tools PR 148 (3ac4c46): lpoco-health awake [--once], unit lpoco-awake.service and check 93-awake.sh in the package, [health] awake_gates in devlab. Proof health/tests/awake.rs (4 tests, seen failing first). Not yet on a phone: surya-awake-from-package enables the unit, retires the hand copy and moves /etc/devlab-allow-autosleep to /etc/lpoco/allow-autosleep; suite put does not enable the unit. Release PR from release-plz not seen yet.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"health/tests/awake.rs under LPOCO_HEALTH_ROOT: the lock written always; with allow-autosleep, released when the UDC state is not configured and held again when the gate reports unsafe (to write); acceptance: surya-awake-from-package","rank":4,"about":"phone-side-pieces"}
{"project":"linux-phone-oco/lab-tools","id":"manifest-one-schema","title":"device.toml declared once in Rust: one manifest crate all lpoco programs read, unknown fields refused everywhere, its JSON Schema projected per release","status":"open","note":"Decision 2026-11-18-device-manifest-schema-from-rust. Today devlab, host and bringup each parse device.toml in their own shape and devlab ignores a misspelled table. One crate (lpoco-manifest) holds the serde types with doc comments; devlab, host and bringup read it; schemars (draft-07, already in Cargo.lock via rmcp) projects device.schema.json, committed and published with each release; roof pieces are an enum with tokens. A generated device.toml template with every field's doc beside it is the device-template file.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"manifest/tests/schema.rs a_misspelled_table_is_refused ([[flash.overlays]] refused - fails against today's devlab Device), schema_is_current (the committed schema equals the projection), every_lab_manifest_validates (surya, walleye and template fixtures) (to write, the first failing first)","rank":7,"about":"phone-side-pieces"}
Expand All @@ -172,3 +172,4 @@
{"project":"linux-phone-oco/lab-tools","id":"test-bisect-parallel-flake","title":"bringup_bisect_runs_declared_series fails in a parallel workspace run, passes alone","status":"open","note":"Sign (coordinator, 2026-11-18): failed once in a parallel workspace run, passes alone. Likely shared state between tests (a fixed temp path, cwd, or env var); give each test its own dir/env.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"google-walleye","proof":"cargo test --workspace passes 20 runs in a row with default parallelism","rank":10,"about":"bringup"}
{"project":"linux-phone-oco/lab-tools","id":"test-hold-parallel-flake","title":"hold::tests::the_phone_is_held_by_one_change_at_a_time fails in a parallel workspace run, passes alone","status":"open","note":"Sign (coordinator, 2026-11-18): failed once in a parallel workspace run, passes alone. Likely a shared lease file or lock path across tests; give each test its own.","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"cargo test --workspace passes 20 runs in a row with default parallelism","rank":10,"about":null}
{"project":"linux-phone-oco/lab-tools","id":"sxmo-utils-lab-apk-deliver","title":"Build, sign and publish the sxmo-utils lab apk as the sxmo-utils@lab repository","status":"open","note":"Blocked on the conveyor (linux-package-distribution-oco/conveyor, alpine.yml v1), not on lab-tools. Read 2026-11-18: it takes a declaration input and a tag, but (1) it copies only the APKBUILD into the build folder, while sxmo-utils has 7 local source files beside it (rootfs-*, *.post-install), so abuild fetch/verify fails; (2) it builds one Pages site per repository from this run's artifacts alone, so a second package in lab-tools would replace lpoco-health's repository (and the verify step reads the page for one NAME). Needs of the conveyor: copy the APKBUILD's whole folder; merge into the existing site (or one site per package), verify per package. Then lab-tools adds packaging/sxmo-utils/conveyor.toml (tag-prefix sxmo-utils-v, tag sxmo-utils-v1.18.1_p20261118) and a second packages job with declaration:. Nothing landed in lab-tools: a trigger now would clobber the live lpoco-health page.","opened":"2026-11-18","waits":"a conveyor tag (linux-package-distribution-oco/conveyor alpine.yml) that copies the APKBUILD folder whole and deploys a second package without replacing the first, with verify per package","blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"suspend-retry-backs-off","rank":4,"about":"sxmo-utils-lab-apk"}
{"project":"linux-phone-oco/lab-tools","id":"phone-pieces-drift-in-lab","title":"lpoco lab names a stale phone-side piece at every change's end, from the report it reads back","status":"open","note":"Rest of phone-pieces-drift-named: reuse lpoco_host::stale_pieces. Also from review: picking the newest report by file name assumes names sort by time (check that).","opened":"2026-11-18","waits":null,"blocked_by":null,"hardware":null,"needs":"build","device":"xiaomi-surya","proof":"a test in lab-tools lpoco/tests (to write, failing first): after a change the lab output names a piece off main","rank":null,"about":"phone-pieces-drift-named"}
1 change: 1 addition & 0 deletions data/session_log.json
Original file line number Diff line number Diff line change
Expand Up @@ -113,3 +113,4 @@
{"project":"linux-phone-oco/lab-tools","id":"2026-11-18-sxmo-utils-lab-apk-declaration","entry_date":"2026-11-18","title":"sxmo-utils lab apk declaration","done":"Built the lab apk declaration from Alpine's community/sxmo-utils (1.18.1-r5) in lab-tools packaging/sxmo-utils, source grenudi tag lab-20261118.1, pkgver 1.18.1_p20261118, every subpackage kept; the proof check (shell, in CI) was seen failing first, then reviewed by the programmer subagent, which found it could not fail on builddir or river - fixed - and landed as PR 157, read back from main.","considered":"Putting the APKBUILD in the fork repository; a Rust checker (a shell check of one declaration needs no program).","rejected":"Marking the item done: the apk is not built, signed or published, and its phone proof is not run. Copied from Alpine and left: typos in the river post-install (srmo.desktop) - for the upstreams lane.","date":null,"about":"sxmo-utils-lab-apk"}
{"project":"linux-phone-oco/lab-tools","id":"2026-11-18-sxmo-apk-deliver-blocked","entry_date":"2026-11-18","title":"sxmo-utils lab apk delivery: blocked on the conveyor","done":"Read the conveyor's alpine.yml against packaging/sxmo-utils and lab-tools' packages.yml; found two gaps (sibling source files not copied; one Pages site per repository, replaced by each run). Recorded them on the row; changed nothing in the conveyor or lab-tools.","considered":"A second declaration plus a second job in lab-tools alone (fixes neither gap); a workflow of our own that builds and signs (copies the conveyor, against its idea: called, not copied).","rejected":"Landing the declaration and job now: the first run would replace the lpoco-health repository on the live page and fail on the missing sources.","date":null,"about":"sxmo-utils-lab-apk-deliver"}
{"project":"linux-phone-oco/lab-tools","id":"2026-11-18-lab-tools-builder-host-install-atomic","entry_date":"2026-11-18","title":"lpoco host: atomic install","done":"Test first (old script run by bash while prepare replaces it; failed on the in-place copy), then replace_file: temp beside, fsync, rename, fsync dir; used for Copy, Stamp and the unit. Programmer review found a flaky test (text file busy on exec, shell-dependent, no deadline): fixed by running it via /bin/bash with a deadline and a release guard.","considered":"Cargo install: left to cargo's own rename.","rejected":"Writing in place with a lock: a reader of a shell script holds no lock. Test via exec of the fresh file: races with parallel tests (text file busy).","date":null,"about":"host-install-atomic"}
{"project":"linux-phone-oco/lab-tools","id":"2026-11-18-lpoco-host-check-names-stale-phone-side-pieces","entry_date":"2026-11-18","title":"lpoco host check names stale phone-side pieces","done":"Wrote host/tests/phone_pieces.rs first (failing), built blob_id, stale_pieces, Stale and check's print_stale_pieces in lpoco-host; landed as lab-tools PR 165, read back from main.","considered":"Making a stale piece fail the check: it only names it, as the item asks. Naming a missing piece as its own finding.","rejected":"My first report format (test piece / blob word): invented; review found health's 94-lab-pieces.sh writes piece-file:PATH and piece-package-NAME rows, so the parser follows those. Silent skips of unreadable lines: now an error and 'not measured'.","date":null,"about":"phone-pieces-drift-named"}
32 changes: 30 additions & 2 deletions docs/backlog.md
Original file line number Diff line number Diff line change
Expand Up @@ -3738,10 +3738,10 @@ Project
: linux-phone-oco/lab-tools

Status
: open
: done

Note
: Write the failing test first: the full text is in docs research/phone-side-pieces/2026-11-18/inventory.md (not landed - lab-tools has no ignored/expected-fail convention and it does not compile until the function exists). lpoco_host gains blob_id (git's blob id), stale_pieces(device, report, main) -> Vec<Stale> (File {path, found, main} for each declared overlay/install/device check whose reported blob differs from origin/main's; Package {name, found, pin} for a lab-tools package off the [tools] lpoco pin). check reads each device's newest tests/results/*.jsonl at origin/main, names the commit the installed copy came from (git log --find-object) and the report's age. Then lpoco lab names the same at every change's end from the report it reads back.
: Landed in lab-tools PR 165 (7b4a36a): lpoco host check names a stale or missing phone-side piece and a package off the pin, from the device's newest tests/results/*.jsonl at origin/main. Proof: host/tests/phone_pieces.rs (3 tests, seen failing first, now pass). Not built: lpoco lab naming the same at every change's end - see phone-pieces-drift-in-lab.

Opened
: 2026-11-18
Expand Down Expand Up @@ -4304,3 +4304,31 @@ Rank

About
: sxmo-utils-lab-apk


<a id="phone-pieces-drift-in-lab"></a>
### lpoco lab names a stale phone-side piece at every change's end, from the report it reads back

Project
: linux-phone-oco/lab-tools

Status
: open

Note
: Rest of phone-pieces-drift-named: reuse lpoco_host::stale_pieces. Also from review: picking the newest report by file name assumes names sort by time (check that).

Opened
: 2026-11-18

Needs
: build

Device
: xiaomi-surya

Proof
: a test in lab-tools lpoco/tests (to write, failing first): after a change the lab output names a piece off main

About
: phone-pieces-drift-named
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

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): 174
- [Backlog](backlog.md): 175
- [Components](components.md): 21
- [Concepts](concepts.md): 10
- [Decisions](decisions.md): 70
Expand All @@ -22,7 +22,7 @@ The memory of linux-phone-oco, whose goal is Linux phones as good as Android for
- [Platforms](platforms.md): 7
- [Problems](problems.md): 17
- [Research](research.md): 54
- [Session Log](session_log.md): 115
- [Session Log](session_log.md): 116
- [Shell Releases](shell_releases.md): 2
- [Sources](sources.md): 232
- [Summaries](summaries.md): 7
Expand Down
24 changes: 24 additions & 0 deletions docs/session_log.md
Original file line number Diff line number Diff line change
Expand Up @@ -2552,3 +2552,27 @@ Rejected

About
: host-install-atomic

---


<a id="2026-11-18-lpoco-host-check-names-stale-phone-side-pieces"></a>
### lpoco host check names stale phone-side pieces

Project
: linux-phone-oco/lab-tools

Entry date
: 2026-11-18

Done
: Wrote host/tests/phone_pieces.rs first (failing), built blob_id, stale_pieces, Stale and check's print_stale_pieces in lpoco-host; landed as lab-tools PR 165, read back from main.

Considered
: Making a stale piece fail the check: it only names it, as the item asks. Naming a missing piece as its own finding.

Rejected
: My first report format (test piece / blob word): invented; review found health's 94-lab-pieces.sh writes piece-file:PATH and piece-package-NAME rows, so the parser follows those. Silent skips of unreadable lines: now an error and 'not measured'.

About
: phone-pieces-drift-named
Loading