diff --git a/data/backlog.json b/data/backlog.json index c1bd301..991210a 100644 --- a/data/backlog.json +++ b/data/backlog.json @@ -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 (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"} @@ -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"} diff --git a/data/session_log.json b/data/session_log.json index 07b01a1..a1fe210 100644 --- a/data/session_log.json +++ b/data/session_log.json @@ -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"} diff --git a/docs/backlog.md b/docs/backlog.md index ce69d84..a6d57cd 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -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 (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 @@ -4304,3 +4304,31 @@ Rank About : sxmo-utils-lab-apk + + + +### 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 diff --git a/docs/index.md b/docs/index.md index e59b5d7..c4b6a9e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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 @@ -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 diff --git a/docs/session_log.md b/docs/session_log.md index 9da9362..ae3b0b2 100644 --- a/docs/session_log.md +++ b/docs/session_log.md @@ -2552,3 +2552,27 @@ Rejected About : host-install-atomic + +--- + + + +### 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