From 1ced5f84a20637b87acca1ac8a15682b5fb28efb Mon Sep 17 00:00:00 2001 From: Phoebus Date: Tue, 29 Sep 2026 10:48:10 -0700 Subject: [PATCH] docs(kernel): state the real source-kernel build time; record the VM journey --- docs/HANDOFF.md | 18 ++++++++++++++++++ docs/STATUS.md | 4 ++-- .../crates/phoebus-core/src/fastinstall.rs | 7 +++++-- 3 files changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index 85156e1..5f085dd 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -25,6 +25,24 @@ commit it. It should be short and current; use `git log` for detail. call (`sys ask` with a real provider is still VM/live NotRun) but it closes the "connected-model path only tested with fake transports" gap. Gates: `cargo test --workspace` 841 passed / 0 failed. +- **Three kernel choices + VM-found kernel bugs (2026-09-29):** added a + first-class three-way kernel choice (`bin` default, `balanced` source kernel + with broad hot-plug coverage, `tuned` source kernel) via the new + `BuildBalancedKernel` action / `sys build balanced kernel`; both source + choices keep `gentoo-kernel-bin` as the known-good fallback and create a + separate BLS entry. The first VM journey started the balanced build and found + two real bugs, both fixed: `vdb_has_atom("sys-kernel/gentoo-kernel")` matched + the sibling `gentoo-kernel-bin` record (prefix overlap), and the separate BLS + entry was looked up in `EFI/Linux` instead of the real `loader/entries` + directory. The build is in progress on a disposable overlay with + `MAKEOPTS="-j10 -l14"` (the installed default `-j3 -l8` is memory-derived and + too slow for a test build). Source conversion remains to be started. + **Result:** the full distribution config did **not** finish in 3 h (guest + `timeout` killed it at `RC=124`; 7.7 GiB build artifacts, no system change — + build-only is fail-safe). The review text now says "allow several hours" + instead of the earlier "20–60 min". Completing this journey needs a multi-hour + build window; the separate BLS entry path is unit-tested with the corrected + `loader/entries` directory. - **OpenCode transport standardized (2026-09-29, VM-VERIFIED):** the OpenCode backend no longer runs outside the model sandbox and no longer has a stricter endpoint policy than the direct provider. It is sandboxed by default (curl diff --git a/docs/STATUS.md b/docs/STATUS.md index 114c38d..7c5c58a 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -81,8 +81,8 @@ Booting that recovery entry offline remains a manual gate. | Fast `-bin` defaults (firefox-bin/libreoffice-bin/thunderbird-bin, fail-closed) | yes | yes (atoms, policy, binary-capability refusal) | yes (installed identities verified in Gentoo VDB on detached boot) | no | | Single generic kernel default (no second generic kernel) | yes | yes (guard + tuned path keeps the fallback) | yes (existing boot path unchanged) | no | | User-initiated source builds (`convert_to_source`) | yes | yes (table incl. thunderbird, review, build-before-remove, Brave/unknown refusals) | no (no conversion journey run in a VM) | no | -| Tuned-kernel build (`build_tuned_kernel`, separate BLS, fallback kept) | yes | yes (refusal without fallback, entry creation, default never blind-switched) | no (no build/boot-test in a VM) | no | -| Balanced source kernel (`build_balanced_kernel`, broad hardware, bin fallback) | yes | yes (plan/fragment/review, refusal without fallback, separate `phoebus-balanced.conf`, default untouched) | in progress (VM build/boot journey started 2026-09-29) | no | +| Tuned-kernel build (`build_tuned_kernel`, separate BLS, fallback kept) | yes | yes (refusal without fallback, entry creation, default never blind-switched) | no (same long build; VM attempt recorded under the balanced row) | no | +| Balanced source kernel (`build_balanced_kernel`, broad hardware, bin fallback) | yes | yes (plan/fragment/review, refusal without fallback, separate `phoebus-balanced.conf`, default untouched; two VM-found bugs fixed: exact VDB match, `loader/entries` path) | **started, not completed** (disposable VM 2026-09-29: full distribution-config kernel build exceeded 3 h with 10 jobs, `RC=124`, no system change; needs a multi-hour window) | no | | Installed first-login welcome (once per user, reopenable, non-blocking) | yes | yes (assets, launcher, autostart, QML guards, DMS seed) | no (first login + graphical checks not run) | no | | Install metrics (time, download, peak disk, installed size) | yes | yes (report rendering; orchestration hooks) | yes (Run 13 recorded 588 compile times into target metrics) | no | | XWayland / polkit agent / kitty / wofi | yes | no | installed, not launched | no | diff --git a/installer-rs/crates/phoebus-core/src/fastinstall.rs b/installer-rs/crates/phoebus-core/src/fastinstall.rs index 255984f..7353aad 100644 --- a/installer-rs/crates/phoebus-core/src/fastinstall.rs +++ b/installer-rs/crates/phoebus-core/src/fastinstall.rs @@ -345,8 +345,11 @@ pub fn kernel_build_review(plan: &KernelBuildPlan) -> String { ); } o.push_str( - " Expected work : typically 20–60 min on 8 vCPUs; ~15 GiB temporary space;\n\ - \x20 keep AC power connected.\n", + " Expected work : the full distribution configuration compiles for a long\n\ + \x20 time — allow several hours (measured >3 h with 10 build\n\ + \x20 jobs on a 10-vCPU VM); >=15 GiB temporary space; keep AC\n\ + \x20 power connected. Start it only when the machine can stay\n\ + \x20 powered: an interrupted build changes nothing.\n", ); o.push_str(&format!( " Boot entry : {} (separate entry; boot-tested first)\n",