docs(kernel): state the real source-kernel build time; record the VM journey
Some checks are pending
ci / test (push) Waiting to run

This commit is contained in:
Phoebus 2026-09-29 10:48:10 -07:00
parent f18505aee9
commit 1ced5f84a2
3 changed files with 25 additions and 4 deletions

View file

@ -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 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: the "connected-model path only tested with fake transports" gap. Gates:
`cargo test --workspace` 841 passed / 0 failed. `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 - **OpenCode transport standardized (2026-09-29, VM-VERIFIED):** the OpenCode
backend no longer runs outside the model sandbox and no longer has a stricter 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 endpoint policy than the direct provider. It is sandboxed by default (curl

View file

@ -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 | | 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 | | 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 | | 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 | | 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) | in progress (VM build/boot journey started 2026-09-29) | 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 | | 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 | | 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 | | XWayland / polkit agent / kitty / wofi | yes | no | installed, not launched | no |

View file

@ -345,8 +345,11 @@ pub fn kernel_build_review(plan: &KernelBuildPlan) -> String {
); );
} }
o.push_str( o.push_str(
" Expected work : typically 20–60 min on 8 vCPUs; ~15 GiB temporary space;\n\ " Expected work : the full distribution configuration compiles for a long\n\
\x20 keep AC power connected.\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!( o.push_str(&format!(
" Boot entry : {} (separate entry; boot-tested first)\n", " Boot entry : {} (separate entry; boot-tested first)\n",