Lawrence Chenandaustinpower1258
80f40831da
* test: cover kitty placement frame reuse * fix: cache kitty placement frames * test: cover pixel-accurate kitty clipping * fix: clip kitty placements in pixel space * test: cover pixel-accurate kitty replay clipping * fix: clip kitty replay in pixel space * test: cover number-only kitty image attach * test: cover both numbered kitty image aliases * fix: preserve kitty number aliases across attach * test: cover inflight kitty replay across resize * fix: preserve inflight kitty replay * test: cover anonymous kitty replay collisions * fix: preserve anonymous kitty placements in replay * test: cover kitty object count limits * fix: bound kitty graphics object counts * test: cover Kitty graphics in web render mode * test: cover host kitty scene invalidation * fix: restore kitty graphics after host resize * feat: render Kitty graphics in web terminal * test: cover graphics writer shutdown quiescence * fix: layer Kitty graphics above cell backgrounds * fix: draw web graphics from callback ref * fix: quiesce graphics before terminal restore * test: cover kitty replay allocation order * fix: preserve kitty replay allocation order * test: cover incremental render graphics deltas * test(tui): cover linear graphics state maintenance * fix: send incremental render graphics deltas * test: cover bounded kitty replay semantics * test(tui): cover late Kitty image ordering * test: cover render transport size boundaries * fix(tui): maintain Kitty graphic IDs linearly * test: cover atomic cell geometry updates * test(tui): cover Kitty PNG compatibility * test: cover full render metadata budget * test: preserve measured cell pixels across resize * test: bound kitty pixel cache lookups * fix: make cell geometry updates atomic * test: bound kitty placement grouping * fix: align render transport size budgets * test: bound render taps and resize replay * fix: preserve kitty images in bounded vt replay * fix: bound render taps and skip unused replay * docs(tui): document inline Kitty image support * style(tui): format merged changes * test: cover UTF-8 before kitty replay * test: cover large kitty resize replay * fix: distinguish UTF-8 from C1 kitty APC * fix: preserve kitty upload across resize * test(tui-sdk): cover retained render metadata overflow * fix(tui-sdk): bound retained render events * test(tui-web): expose placement canvas memory blowup * fix(tui-web): bound graphic canvas backing * test: preserve hosted Kitty image aliases * fix: preserve hosted Kitty image aliases * test(tui): cover stale Kitty write after resize clear * fix(tui): discard stale Kitty writes after resize clear * test(browser): expose terminal host alias protocol gap * fix(browser): support terminal host Kitty aliases * test(cmux-tui): expect resize alias sidecars * test(tui): preserve sparse viewport across replay * fix(tui): preserve sparse rows in terminal replay * fix(tui): align replayed scrollback rows * test(tui): await terminal host process exit * test(tui): cover Kitty alias history and sparse replay * fix(tui): preserve Kitty alias and sparse row history * fix(tui): address Kitty graphics review findings * fix(tui): harden Kitty graphics integration * fix(tui): resolve final Kitty autoreview findings * fix(tui): close Kitty autoreview findings * test(tui): cover final Kitty review regressions * fix(tui): close final Kitty autoreview findings * test(tui): reject overflowing PTY pixel geometry * fix(tui): reject invalid PTY pixel geometry * test(tui): cover remaining Kitty review regressions * fix(tui): close remaining Kitty review findings * fix(cmux-tui): close graphics review gaps * fix(cmux-tui): preserve attach and startup progress * fix(tui): reconcile image render geometry * fix(tui): align attach wire progress * fix(tui): bound inline image rendering resources * fix(tui): close inline image review gaps * fix(tui): bound inline graphics hot paths * test(tui): cover graphics attachment memory regressions * fix(tui): bound graphics attachment allocations * test(tui): budget retained render capacity * test(tui): cover graphics review regressions * fix(tui): close graphics autoreview gaps * test(tui): cover second graphics review regressions * fix(tui): close remaining graphics review gaps * test(tui): cover remaining graphics review regressions * fix(tui): close graphics review findings * test(tui): cover final graphics review regressions * fix(tui): close final graphics review findings * test(tui): cover graphics admission regressions * fix(tui): make graphics admission lazy and refillable * test(tui): cover final host lifecycle findings * fix(tui): bound host lifecycle work * test(tui): cover final protocol review findings * fix(tui): close final protocol review gaps * test(tui): cover bounded graphics writer failure * fix(tui): bound graphics output failure lifecycle * test(tui): cover final remote graphics review gaps * fix(tui): validate and localize remote attach data * test(tui): cover final graphics ownership findings * fix(tui): scope graphics output ownership * test(tui): cover graphics resource safety gaps * fix(tui): bound graphics resource lifecycles * test(tui): cover graphics budget scan fanout * fix(tui): make graphics admission single-pass * test(tui): cover review resource safety gaps * fix(tui): bound graphics attachment resources * test(tui): cover enhanced input adapter compatibility * fix(tui): reconcile shortcut merge with graphics input * test(tui): reconcile merged attach fixtures * test(tui): bound inline surface state * fix(tui): keep libghostty state out of line * test(tui): cover cell pixel fanout retry gap * fix(tui): reconcile skipped cell pixel fanout * test(tui): cover aggregate graphics ownership gaps * fix(tui): bound aggregate graphics ownership * test(tui): cover graphics teardown ownership * fix(tui): rebalance graphics ownership on teardown * test(tui): cover aggregate graphics recovery * fix(tui): recover aggregate graphics capacity * test(tui): isolate graphics counters per thread * test(tui): cover graphics resource ownership gaps * fix(tui): close graphics resource ownership gaps * test(tui): cover Kitty replay state divergence * fix(tui): preserve Kitty replay state across mirrors * test(tui): cover terminal resource lifecycle stalls * fix(tui): decouple terminal resource lifecycle work * test(tui): cover review lifecycle regressions * fix(tui): close review lifecycle gaps * test(tui): cover graphics review regressions * fix(tui): reconcile graphics lifecycle under load * test(tui): cover graphics baseline and quota exhaustion * fix(tui): reconcile graphics baselines and quota overflow * test(tui): make graphics backpressure deterministic * test(tui): cover exited quota and reset replay ordering * fix(tui): preserve graphics state across resets and exits * test(tui): cover scrolled Kitty placement alignment * fix(tui): align Kitty graphics with scrolled viewports * test(tui): bound stalled renderer output * fix(tui): preserve renderer output backpressure * test(tui): cover relabel and retry bounds * fix(tui): bound graphics recovery work * fix(ci): isolate fork-agent singleton default * test(tui): bound persistent graphics recovery * fix(tui): bound persistent graphics recovery * test(tui): drain stalled quota worker * test(tui): cover panic and fanout lifecycles * fix(tui): bound graphics worker lifecycles * test(web): cover exhausted graphics decode queue * fix(web): retire exhausted graphics decode jobs * test(tui): cover final Kitty review findings * fix(tui): close final Kitty replay gaps * test(tui): cover encoded Kitty quota * fix(tui): budget encoded Kitty uploads * test(browser): sync Kitty replay ceilings * fix(browser): match Kitty replay ceilings * test(tui): cover unsupported Kitty grayscale * fix(tui): bound Kitty snapshot formats * test(tui): cover Kitty quota recovery * fix(tui): reconcile Kitty quota recovery * test(tui): cover reconnect completion retry * fix(tui): retry failed host reconnect completion * test(tui): cover attach priority and replay cursor state * fix(tui): preserve attach priority and replay state * test(tui): cover superseded attach resize failure * fix(tui): settle the latest promoted resize * chore(tui): satisfy strict attach lifecycle lint * test(tui): cover numeric Kitty final chunks * fix(tui): parse Kitty chunk flags numerically * test(tui): cover Kitty images in web scrollback * fix(tui): render Kitty images in web scrollback * test(tui): admit terminals after graphics quota failure * fix(tui): degrade graphics after quota failure * test(tui): finish graphics probe at DA1 marker * fix(tui): end graphics probe at DA1 marker * test(tui): reject stale scrollback image epochs * fix(tui): version scrollback image anchors * test(tui): refresh active scrollback epochs * fix(tui): refresh active scrollback epochs * test(tui): ignore screen-only history epochs * fix(tui): scope history epochs to retained rows * test(tui): keep image frames out of history epochs * fix(tui): keep image frames out of history epochs * test(tui): assert stable screen-only history epochs * test(tui): bound deferred work and reserve attaches * fix(tui): bound deferred graphics coordination * test(tui): exhaust saturated Kitty quota retries * fix(tui): exhaust saturated Kitty quota retries * test(tui): retain overlapping Kitty replay placements * fix(tui): clip Kitty placements at replay boundaries * fix(tui): preserve merged attach invariants * test(ci): cover Ghostty path metadata * fix(ci): inspect executable Ghostty consumers * test(ios): replace wall-clock synchronization * chore(xcode): normalize project ordering * fix(ssh): simplify retry script assembly * test(app): update detached transfer fixture * test: update remote PTY lifecycle fake * test: require explicit app-host test mode * fix: declare app-host test launch mode * fix: clear Xcode 26.3 warning gate * test: detect embedded app-host test bundle * fix: detect app-host tests from embedded bundle * chore: drop unreliable app-host scheme marker * test: avoid async ARC lifetime assertion * test: require app-host build identity * fix: stamp app-host test builds before launch * test: require test-runner app-host marker * fix: forward app-host test identity through xcodebuild * fix: keep completed iroh dial single-flight through install * test: re-report lifecycle after status clear * Fix cmux-tui merge integration * test(web): cover render attach WebSocket budget * fix(web): admit full render attach frames --------- Co-authored-by: austinpower1258 <[email protected]>
cmux Browser
cmux Browser combines Chromium web surfaces with Ghostty terminal frontends backed by the cmux TUI process. It is being moved into this repository so the Browser, its terminal protocol, and its exact Ghostty dependency can be built and reviewed from one public source tree.
The Browser is maintained as a small source overlay and patch set against an exact Chromium revision. Chromium itself is not vendored into this repository.
Import status
The public import is staged deliberately:
- establish the provenance, licensing, and reproducibility contract;
- import one curated source snapshot without private Git history;
- make monorepo-relative build and dependency changes in reviewable commits;
- add public CI and release-compliance gates; and
- publish a Browser artifact only after the full build and UI matrix passes.
The source snapshot is not release-ready until every item in
IMPORT_PROVENANCE.md is resolved.
Current public slices
The first source slice is the host-compilable browser-to-cmux-TUI protocol core:
overlay/chrome/browser/cmux_term/cmux_tui_protocol.{h,cc}overlay/chrome/browser/cmux_term/cmux_tui_protocol_test.cc
It covers protocol identity, durable-registry revision fencing, ordered workspace events, input backpressure, resize coalescing, replay palette filtering, and JSON-lines framing.
The second source slice adds the host-compilable binary protocol shared by the terminal-host process and each renderer:
overlay/chrome/services/cmux_terminal_renderer/public/cpp/cmux_terminal_host_protocol.{h,cc}overlay/chrome/services/cmux_terminal_renderer/public/cpp/cmux_terminal_host_protocol_test.cc
It covers framed streaming, authenticated renderer grants, bootstrap and snapshot payloads, sparse terminal colors and cursor state, viewer-size acknowledgements, and protocol error handling. Run both slices without Chromium:
./cmux-browser/scripts/run-host-tests.sh
That command first runs a fail-closed desktop license check: the project package declarations and Manaflow-owned Browser source areas must remain GPL-3.0-or-later, and an AGPL SPDX declaration is rejected. Explanatory AGPL discussion in the policy documents remains allowed.
The exact private source object and imported blob identities are recorded in
SOURCE_SNAPSHOT.md. Later slices remain gated by
IMPORT_PROVENANCE.md.
Planned layout
overlay/mirrors paths in the Chromium source tree.patches/contains reviewable changes to existing Chromium files.scripts/bootstraps, applies, builds, tests, packages, and verifies the pinned product.tests/contains UI and end-to-end coverage.tools/contains focused local test harnesses.docs/contains durable architecture and contributor documentation.
License
This import does not change cmux's root license. Browser code for which Manaflow controls the necessary rights is available under GPL-3.0-or-later. Manaflow may separately offer commercial terms only for those rights-controlled portions. This is not a blanket dual-license claim over the Browser binary or every file in this directory.
Third-party and derived files retain their original licenses. In particular, Chromium-derived material is BSD-3-Clause, Helium-derived material and uBlock Origin are GPL-3.0-only, and Ghostty and Bonsplit are MIT; none is relicensed merely by being stored or distributed with the Browser.
AGPL is not the default for the desktop Browser. Its additional protection is aimed at modified software offered for remote network use, while GPL already requires source for distributed desktop forks. A future hosted service may use AGPL as a separately reviewed component decision, but changing this directory to AGPL would require a distinct policy and legal review.
Manaflow may offer later versions of code for which it controls the copyright under different terms. That does not revoke the rights already granted for a published GPL version, and it does not extend to third-party code or outside contributions without the necessary relicensing rights.
See IMPORT_PROVENANCE.md for the import boundary and
the repository's THIRD_PARTY_LICENSES.md for the current cmux dependency
inventory. That root inventory is not a complete Browser binary notice bundle;
target-specific Browser notices remain a release gate.