Repository navigation
chore: move four distros into Images, and bring the docs up to date - #18
Merged
Merged
Conversation
The container list now offers Alpine (latest and edge), Debian (stable and testing), Fedora and Ubuntu. Arch Linux, Manjaro, openSUSE and Rocky Linux move to the Images suggestions on the custom-image card, where one tap fills the image reference and alias. Containers already installed under those aliases still appear in the list, which also shows installed containers that are not in the catalog.
Describe the container list with its Images suggestions instead of "5 more", background sessions (Back prompt, End, Keep CPU awake, the battery-optimization banner, the session-ended notice) and the list operations (live output, Cancel, Remove ending a session first, surviving rotation and dark mode). Testing now covers the app's JVM unit tests (128), pr-cli's tests (178) with the guest binary they embed, the proot-engine instrumented tests (8) and the on-device suite (55 in 11 suites), and notes that CI runs both unit suites. Project structure lists the session package; the documentation table adds the APK architecture doc, the background sessions design and the historical plans.
The APK architecture doc listed ProotLauncher and PtyNative in the app module, said Back ran cleanup and finish(), onDestroy() closed the session and install/remove ran in a PTY, and kept the APK build as an open follow-up. Point those to the current behaviour: the engine module, background sessions, DistroOperations and ProcessRunner, and the catalog plus Images suggestions. The background sessions design described the pre-session behaviour in the present tense, listed pr-cli as unchanged although its OCI layer download changed, and counted 169 host tests (now 178). The integration test doc described a Play/BugReport/Delete row; Test and Remove are in the row's overflow menu. The follow-ups plan gains the same historical note as the main plan.
pr-cli's 178 tests are 153 library, 11 binary and 14 integration. The on-device suite is started from Test in a row's menu, not a separate BugReport button.
oonid
force-pushed
the
chore/trim-distro-list
branch
from
October 19, 2026 07:50
3e6c7f7 to
59007dd
Compare
README: qualify Cancel's cleanup (only installs with a known alias), say when the Keep CPU awake switch and the battery banner show, that the session-ended notice is for sessions that end on their own, and that the phantom-process limit and Task Manager "Stop" can still end sessions. CI runs on pushes to main and on pull requests. Command blocks use subshells so they paste as one block. AGENTS.md: add the app JVM suite (128 tests) and the note that the guest test binary must be built before cargo test. APK architecture doc: mark the T4.x sections as the Phase 4 record and point to the current-behaviour sections, and bring the file tree to the current layout (proot-engine, InstalledContainers.kt, SessionBanners.kt, the remaining assets, Compose BOM 2025.05.00).
An installed container whose alias is not in the list's catalog was shown under its alias. When the alias matches an Images suggestion (archlinux, manjaro, opensuse, rockylinux), show the suggestion's title instead, such as "Arch Linux" or "Rocky Linux"; other aliases keep showing the alias.
oonid
force-pushed
the
chore/trim-distro-list
branch
from
October 19, 2026 11:04
59007dd to
b394d6c
Compare
Background sessions serve any long-running server, such as an AI agent's gateway. The design and plan now say so, with Hermes named as one example and as the program the target check used. The proot note keeps the bug's evidence but names it as one agent's discovery.
oonid
force-pushed
the
chore/trim-distro-list
branch
from
October 19, 2026 11:16
443443e to
8989295
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Keeps the container list focused on the distributions in use.
What changes
Docs brought up to date with #16 and #17
docs/plans/is marked historical.cargo test.Verification
cargo test).docker.io/library/rockylinux:latestwith aliasrockylinux.rockylinuxcontainer shows as "Rocky Linux" in the list.Docs brought up to date with #16 and #17
docs/plans/is marked historical.cargo test.Verification
docker.io/library/rockylinux:latestwith aliasrockylinux.