Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

docs: note rolling-buffer boot detection and bump to v1.1.5 in skill.md/CLAUDE.md

ExTv4d16863c55fb
diff --git a/CLAUDE.md b/CLAUDE.md
index f954961..605af64 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -58,7 +58,7 @@ The terminal layer uses three QEMU Unix sockets, each with a single role:
### Key Components
-**`engine/PodroidQemu.kt`** — the core singleton. Builds and launches the QEMU process, monitors boot output from serial, manages `TerminalSession` lifecycle, and auto-starts `podroid-bridge` after boot. State machine: `Idle → Starting → Running → Stopped` (see `VmState.kt`).
+**`engine/PodroidQemu.kt`** — the core singleton. Builds and launches the QEMU process, monitors boot output from serial, manages `TerminalSession` lifecycle, and auto-starts `podroid-bridge` after boot. State machine: `Idle → Starting → Running → Stopped` (see `VmState.kt`). `detectBootStage()` scans the last 1024 chars of the rolling `consoleBuilder` rather than each `read()` chunk — required because fast devices (Pixel 10 Pro XL) split markers like `Ready!` across reads and the old per-chunk match silently fell through to the 60 s boot-timeout fallback.
**`service/PodroidService.kt`** — foreground service that owns the QEMU process. Holds a `WakeLock`, updates the persistent notification with boot stages, and handles graceful stop when the app is swiped from recents.
diff --git a/skill.md b/skill.md
index 0e9376c..7f18aad 100644
--- a/skill.md
+++ b/skill.md
@@ -1,6 +1,7 @@
# Podroid AI Context
-> **Last updated:** 2026-04-23
+> **Last updated:** 2026-04-25
+> **Current version:** 1.1.5 (versionCode 17)
> **Purpose:** Complete project context for AI-assisted development. Read this before touching any file.
---
@@ -308,8 +309,8 @@ Mouse → TerminalView touch handler → PTY → bridge → terminal.sock
| Method | What it does |
|--------|-------------|
| `start(portForwards, ramMb, cpus, sshEnabled, androidIp)` | Launches QEMU process, starts boot monitor coroutine, 60s timeout fallback |
-| `monitorBootSerial(proc)` | Reads serial.sock, writes console.log, calls detectBootStage() |
-| `detectBootStage(text)` | Matches boot stage strings, sets _bootStage and _state |
+| `monitorBootSerial(proc)` | Reads serial.sock, appends to consoleBuilder + console.log, calls detectBootStage() |
+| `detectBootStage()` | Scans the last 1024 chars of `consoleBuilder` (stateful rolling buffer) and matches boot-stage strings; sets _bootStage and _state. The rolling buffer was added in 1.1.5 to survive markers split across `read()` chunks on fast devices (e.g. Pixel 10 Pro XL was missing "Ready!" and falling back to the 60 s timeout). |
| `releaseSerial()` | shutdownInput + shutdownOutput + close on bootSocket |
| `autoStartBridge()` | Posts to MainLooper, calls releaseSerial(), 500ms delay, creates TerminalSession |
| `createTerminalSession(client)` | Returns pre-started session or creates new one; sets sessionClientDelegate |
@@ -591,7 +592,7 @@ adb shell run-as com.excp.podroid.debug cat files/console.log
---
-## Pending Work (as of 2026-04-22)
+## Pending Work (as of 2026-04-25)
### Next Feature: Container Hub
Full container management screen — SSH into VM at `127.0.0.1:9922`, run `podman ps`, one-tap deploy from a catalog of services (Pi-hole, Vaultwarden, code-server, Gitea, Jellyfin, Uptime Kuma, Filebrowser, Nginx, Grafana). Requires JSch dependency.