6 KiB
6 KiB
Handoff
Rolling note between work sessions. Update this file before you finish, then
commit it. It should be short and current; use git log for detail.
- Last updated: this session (2026-09-25), second-round
sysreview fixes. Follow-up tod3f676a. Three further confirmed defects are fixed with regression tests: unsafe cleanup previews, non-exact Flatpak/Snap update execution, and reverse-dependency self-reference.make testis green (661 → 683 tests). This corrects the earlier blanket claim that every review finding was already fixed. - Interface contract (unchanged): ordinary requests use AI; only explicit
--legacyselects deterministic handling; source flags constrain the AI and never bypass it; a missing model stops the workflow and offers the exact--legacycommand without executing it.
What this session changed (code)
- Cleanup previews are non-destructive (finding 1).
eclean-dist/eclean-pkgdelete by default, soportage_cleanersnow previews with--pretend --deep(same selection policy as execution) and executes with--deep; the Nix preview uses the documentednix-store --gc --print-dead. Items are read from stdout+stderr, sorted and bound. Tests prove a cleaner never runs destructively during planning, revalidation or cancelled approval. - Exact Flatpak/Snap update transactions (finding 2).
ResolvedPlan.updatescarriesUpdateTransactions: full Flatpak ref + full installed/remote commits (viaflatpak info, since thecommitcolumn is abbreviated), or snap name + old/new revisions + channel. Execution consumes the reviewed transaction (add_executable…flatpak update --commit=<c>), revalidates each source immediately before its mutation, verifies the resulting commit/revision, and refuses non-exact transactions. A source whose resolution failed is never re-discovered.PlanStoreaggregation includesupdates. - Reverse dependencies (finding 3). The reverse branch no longer drops valid matches; it excludes only a genuine self-reference (the dependent is the queried package).
- Determinism.
All selected packages:removals are sorted (depclean previews are now order-independent);emerge --depclean --ask=n.
Verified in disposable VMs
- Cache cleanup + depclean (real tools):
ecleanupstream preview is non-destructive;sys clean cachepreview/cancelled/approved/drift/failed all behave correctly; depclean cancel/approve with transaction history and preserved/home. - Reverse dependencies:
sys-libs/glibcandsys-libs/zlibreport real dependents (conditional/versioned included). - Flatpak: installed via Portage (
sys-apps/flatpak, enablingmedia-libs/freetype[harfbuzz]), flathub added, an app installed and downgraded, thensys apply updates --flatpakresolved full ref+commits, deployed the pinned commit, and verified it. - Custom ebuild: stage → build/install (VDB entry + installed file) → remove.
- Managed AppImage: acquire with pinned SHA-256, list, run the managed ELF, remove; a placeholder SHA is refused.
- Nix: a
NIX_ENABLED=yesinstall bootstraps Nix;nix profile install nixpkgs#nodejs-sliminto/nix/var/nix/profiles/profileis enumerated bysys list --nixand found bysys list nodejs --nix, with store paths and generations reported separately. - Non-root
pkexec sys --broker: with the shipped polkit action and the standard wheel-admin rule installed on the disposable image, a wheel user authenticated through a terminal agent; cancellations changed nothing, the approved removal returned the broker JSON outcome, and the replay was rejected. The shipped privilege policy is unchanged. - Read-only acceptance:
installer/tests/vm/sys-acceptance.shPASS=38 FAIL=0re-run against the final staticsys(dd61c610…), including the newrdeps-legacyreverse-dependency regression.
Not completed / blocked
- Snap install/refresh/remove: no snapd in the image. Prerequisite:
app-containers/snapd+ AppArmor + network, installed through the supported integration. The Snap transaction code is unit-tested only. - Live AI: a local OpenAI-compatible model (
llama-server+ a GGUF model) was served on the host; the AI workflow reached the model, but the sandboxed call exceeded the 120 s transport timeout on CPU (curlexit 28). Needs a faster model/GPU or a remote provider credential. Fixture-backed routing and failure tests pass (ask-offline, missing-model offer, source constraint). - Recovery boot (distinct from rollback): the recovery BLS entry is present and asserted in the rollback acceptance, but booting it interactively was not automated. Method: select "Phoebus Recovery (known-good snapshot)" in the systemd-boot menu with no network.
- Nix re-run flakiness: a later
sys list --nixre-run reported the profile link dangling (the profile store path was gone) and correctly listed no packages; the first run with a real profile is the positive evidence.
Known blockers / risks
- VM serial login is occasionally flaky; retry the boot when
detached-boot-loginfails. make doctorpasses (KVM accessible via an ACL). Disk is shared by build and VM; watch free space.- The pre-existing
test-disk.qcow2cannot be unlocked (unknown passphrase); do not guess or brute-force it.
Next actions (in order)
- Snap lane acceptance with
app-containers/snapd(install/refresh/remove, confinement recorded). - Recovery boot by selecting the recovery BLS entry with the network down.
- Live AI with a faster local model/GPU or an authorized provider credential (natural-language discovery, source constraints, reviewed install).
- Nix profile GC stability if the dangling re-run is reproducible.
Definition of a good stopping point
make testpasses;docs/STATUS.md,docs/CHANGELOG.mdand this file updated; committed (scripts/agent-commit.sh) and pushed (scripts/publish.sh).