Linux TUI publish run manifest

• Run ID: linux-tui-2026-07-27-019fa510
• Mode: publish
• Milestone: deliver the first Linux-first, mouse-capable Desktop Material TUI preview with real editable text controls, keyboard parity for primary actions, packages, CI, honest feature-parity mapping, documentation, and off-screen Linux evidence.
• Product boundary: the new Python/Textual terminal edition targets Linux. The Electron graphical edition and its installer/E2E lanes remain Windows-only.
• Starting branch: codex/linux-tui-clone
• Starting commit: 821ab93d57948a7e17d3e41fc5ae804202d9ab82
• Expected integration branch: main
• Remote: https://github.com/Ding-Ding-Projects/desktop-material.git
• Verification target: package and interaction evidence was captured from TUI implementation commit eee005c7f4bc0afeaefdd4606153deb14cfc5f8c; merge commit ba45dcfbaf8e76786ca975752c125e0b0e4299e1 adds the then-current origin/main without changing any file below tui/. Remote CI, Pages, and release receipts remain separate post-push evidence.
• Expected UI state: a real mouse-reporting terminal opens a deterministic Git fixture in the full-screen TUI. Repositories and workspace tabs are clickable; Inputs and TextAreas accept/edit text; keyboard focus is visible; tables, lists, dialogs, and scroll views remain reachable; wide, compact, and narrow layouts do not clip primary controls; language, search, notifications, and confirmation states remain factual.
• Automation boundary: use Lowlevel MCP's Linux virtual display/Xvfb route. Do not show, focus, or disturb the user's visible Windows desktop. Resolve display, process, terminal window, and control coordinates at run time; never reuse a hard-coded handle or display.
• Disposable root: a fresh mktemp -d beneath /tmp whose resolved basename begins desktop-material-tui-proof-019fa510-. It may own only the fixture, bare origin, XDG config/data/state/cache/runtime roots, wheel-smoke environment, raw captures, and run logs listed in the cleanup ledger.
• Source checkout: the current repository mounted into the Linux environment; it is read-only to the interaction harness except for tracked screenshot promotion performed later from the host checkout.
• Fixture: one local repository with a configured local bare origin, an initial pushed main, one tracked Markdown file, one controlled unstaged edit, one branch, one tag, and one named stash. No provider credential or external remote is created.
• GitHub state: exercise binding, fields, tabs, empty/auth/error/read-only rendering only. The headless proof must not create, comment, close, review, merge, dispatch, rerun, cancel, upload, or otherwise mutate GitHub.
• Expected terminal: xterm or another Xvfb-compatible UTF-8 terminal at a wide starting geometry (approximately 140×42 cells), with mouse reporting enabled by the TUI.
• Screenshot targets after original-resolution inspection: docs/assets/screenshots/linux-tui-overview.png, docs/assets/screenshots/linux-tui-text-input.png, docs/assets/screenshots/linux-tui-regex-builder.png, and docs/assets/screenshots/linux-tui-bilingual-narrow.png, and docs/assets/screenshots/linux-tui-cheap-lfs.png. Promote only real captures from the built artifact; do not substitute mockups or edited images.
• Documentation allowlist: README.md, ROADMAP.md, HANDOFF.md, docs/README.md, docs/installation.md, docs/readme-tabs/**, docs/features/README.md, docs/features/linux-tui/**, docs/verification/README.md, docs/verification/linux-tui-2026-07-27/**, docs/assets/screenshots/linux-tui-*.png, tui/README.md, tui/contracts/**, and the relevant CI/package metadata.

Recorded environment

• Disposable runtime: Debian GNU/Linux 13 (trixie), x86_64, Python 3.13.5, Git 2.47.3, rxvt-unicode 9.31, Xvfb 21.1.16, Openbox 3.6.1, and Lowlevel computer-use MCP 0.1.0. GitHub CLI was intentionally absent from this isolated interaction distro; GitHub mutation was outside the proof.
• Host quality/build tools: uv 0.11.26, Python 3.12.10, Git 2.54.0.windows.1, and GitHub CLI 2.95.0.
• Docker proof host: remote Linux x86_64, Docker 29.5.3, 14 logical CPUs, and 33 GB memory. Existing workloads were enumerated and left untouched.
• Package artifacts: wheel desktop_material_tui-0.1.0-py3-none-any.whl (164,719 bytes, SHA-256 e2d398a9962e8a173e6a4ebbcb24ee961e0832df4907b6e8657245250a31eade) and source distribution (281,881 bytes, SHA-256 fd0e29ffd9f8ae37f892a3fe0450d2742131d8edb6338f70d6c1f5073afe54b2). The wheel contains 53 files, including styles.tcss, py.typed, and the github, dmt, and desktop-material-tui entry points. The accepted 96-file tui/** source manifest remained unchanged across the build at SHA-256 be94c5ce07f08c6f7d4f139c8fa9596c68c4775c27011f3e99c5a20ab8e109fa.

Preflight and build

• Record Linux distribution, architecture, Python, uv, Git, gh, terminal, and Lowlevel MCP versions without environment or credential dumps.
• Confirm the source branch/commit and inspect the complete worktree diff.
• Confirm linux_status, create exactly one virtual display, and record its opaque runtime identifier.
• Create the disposable root with mktemp -d, resolve it, prove its basename prefix, and write that exact path into cleanup-ledger.md.
• Point XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, XDG_CACHE_HOME, and XDG_RUNTIME_DIR at owned children. Do not override HOME.
• Create and prove the deterministic fixture and local bare remote; record git status --porcelain=v2 --branch, branches, stashes, tags, and remotes.
• Install the locked Linux environment and run the source quality gates.
• Build wheel and sdist, inspect the wheel for styles.tcss, py.typed, metadata, and entry points, then install it into a fresh owned environment.
• Prove the installed desktop-material-tui --version reports 0.1.0.

Interaction script

Golden order for every state-changing interaction: capture the current terminal, resolve the target, act in the background, then capture and inspect the result.

• Launch the installed wheel against the fixture on the virtual display and record TUI PID 8009 and terminal window identifier 2097158.
• Capture the overview; prove nonblank Changes, repository rail, toolbar, tab strip, focus treatment, and three fixture changes.
• Click the commit-summary Input and type TUI mouse proof; click the multiline body TextArea, type two lines, edit the second line, and prove Enter inserted a newline without submitting.
• Capture the text-input state. Do not click Commit in the publish capture; automated tests own commit mutation and the fixture must remain disposable.
• In Regex, click and edit the raw (alpha|beta) pattern, enter multiline sample text, click case-insensitive mode, and prove two live matches plus capture groups. Invalid, multiline, dot-all, Unicode, zero-width, and bounded adversarial cases are covered by the automated search/UI suite.
• Dismiss a real non-blocking notification through a mouse click.
• Change to bilingual mode, resize to a 100-column terminal layout, and inspect the longest bilingual labels for clipping.
• In Cheap LFS, render a canonical pointer and a 101 MiB auto-pin candidate, click editable repository/provider fields, click Preview, and prove the local plan made no provider mutation.
• Capture all five accepted states at original resolution and inspect each before promotion.

The broader keyboard/tab, literal/fuzzy/regex synchronization, command-palette, destructive-confirmation, notification-history, theme, reduced-motion, and scrolling matrix was exercised through 193 cross-platform Textual/core tests and the dedicated real-Linux PTY test. Unchecked manual scenarios from the planning draft are not silently claimed as captured interactions.

Automated and static gates

• node tui/tools/generate-parity-contract.mjs --check
• uv sync --locked --extra dev
• uv run pytest: 193 passed and 1 Linux-only PTY case skipped on Windows; the skipped PTY case separately passed on real Debian Linux.
• the same complete 194-case collection passed under isolated CPython 3.10.20 and 3.12.10 environments after the merged-source CI correction.
• uv run ruff check . and uv run ruff format --check .
• uv run mypy src: strict typing clean across 47 source files, including an explicit Linux-platform mypy pass for the Windows lock boundary.
• 164 focused Windows Cheap LFS tests, including all 16 cloud-compression action cases, plus root TypeScript and focused ESLint/Prettier
• uv build --clear
• fresh-wheel install and all three aliases report version 0.1.0
• package content inspection
• workflow YAML parse and CI job contract inspection
• Markdown links and focused formatting checks for every new/touched TUI document
• secret/credential-pattern scan of the diff and promoted captures
• final integration branch/worktree/stash/remote inspection and guarded cleanup left one clean main worktree, no task branches, and no stashes.
• merged delivery 2abccae8fd is the exact pushed origin/main; Pages and the Cheap LFS cloud-compression workflow succeeded.
• compatibility correction f555d374a6 is contained in origin/main; CI run 30317262582 passed its Linux TUI Python matrix and Windows TUI core job.
• repository-wide CI acceptance: run 30317262582 failed overall in the unrelated Windows x64 unit job.
• installer/release acceptance: run 30318769692 failed and published no Release.

Evidence table

Every capture is an original 1600×1000 Xvfb window image from the installed wheel at eee005c7f4bc0afeaefdd4606153deb14cfc5f8c. The interaction coordinates and window handle were resolved at run time.

Cleanup gate

Cleanup is part of acceptance, not a later courtesy.

• Gracefully quit the TUI with Ctrl+Q and prove PID 8009 exited.
• Close the exact virtual-display terminal window 2097158.
• Stop display :98 and prove Xvfb PID 7003 and Openbox PID 7006 exited.
• Remove only the resolved disposable root after validating its prefix and contents against the ledger.
• Prove no fixture, bare remote, XDG override, wheel-smoke environment, recorder, terminal, or raw capture from this run remains.
• Update cleanup-ledger.md with exact identifiers, hashes for promoted captures, and final Complete or factual blocker state.

Current local interaction status: Complete. The packaged Linux run, real mouse/text-field acceptance, five captures, and guarded cleanup are proven locally. The merged source and Pages/wiki publication are live; the first merged-source matrix exposed Python 3.10 timestamp and Linux-mypy portability defects that now pass the full local correction gates. Correction commit f555d374a6 is contained in origin/main, and its Linux TUI matrix plus Windows TUI core job passed in run 30317262582. That workflow still failed overall in the unrelated Windows x64 unit job. Installer run 30318769692 failed and published no Release; neither failed top-level gate is claimed as accepted.