[lawrencecchen]

Summary

This is item 4 of the compiled-load plan (STATUS 4801). It answers the SWITCH FRAMES owner's request for a compiled beacon. The spec and decoder are in cp/switch-frames-kit scripts/journeys/ext_switch.py (ansi, rows). This PR is stacked on #31764; its own change is the top commit, 43989b9.

• tk-beacon: it draws the same three rows as ext_switch.py:
  • row 0: Y, ws[6], pane[4], parity, R;
  • row 1: Y, gray(clock) bits 17..9, parity, R;
  • row 2: Y, gray(clock) bits 8..0, parity, R.
  • Magenta is 1 and cyan is 0. Each block is --cell-cols columns wide.
  • The clock is CLOCK_UPTIME_RAW, in 2 ms units, 18 bits. The SWITCH owner asked for this clock because the recorder's frames.json uses it. The Python beacon reads time.time_ns.
  • Each frame is one DEC 2026 update. The label row is WS n PANE m frame k, and --fill adds the moving shade.
  • The end event has achieved_hz, target_hz and verdict (NOT RUN below 95 %).
  • tuikit.py beacon --ws N --pane M execs it. There is no Python engine.
• New pace mode rt (macOS): the thread becomes a time-constraint thread (thread_policy_set: period 1/hz, computation 0.75 ms, constraint 1.5 ms) and waits with mach_wait_until. This avoids timer coalescing, and it does not spin.
  • The beacon defaults to rt. A SWITCH profile runs 18 beacons at 240 Hz, and 18 spinning cores would become the load under test.
  • The gradient keeps spin, which is proven on a mini.
  • pace_probe adds a rust-rt variant to compare the two.
  • The start event records whether the kernel accepted the real-time policy (realtime).

Testing

Observed / Not run

Observed (cmux-orchestrator-1):

• test_tuikit.py: 37 tests OK, 3 skipped. The skipped tests are the Rust ones, because no Rust is built on this VM. The new BeaconRust test decodes the rows from a real pty: the ws and pane ids, the parity, and a clock that advances, at no less than 95 % of 240 Hz.
• test_load_profiles.py: 15 tests OK.
• rustfmt --check: clean.
• prepush-gate.py: no new violations.

Not run:

• Nothing here is compiled yet. The macOS self-test after the merge compiles it and runs the parity, decode and rate tests with CMUX_TUIKIT_REQUIRE_RUST=1.
• Whether rt holds 240 Hz without spinning on a mini is unknown. The rust-rt pace_probe row and each run's verdict will say.

Changelog

none

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Adds tk-beacon, a compiled Rust binary that draws the SWITCH FRAMES beacon spec (ext_switch.py ansi/rows) on CLOCK_UPTIME_RAW in 2 ms units, so the beacon matches the clock the recorder's frames.json uses. tuikit.py beacon execs it; there is no Python engine.

Adds a new rt pace mode on macOS: a time-constraint thread (thread_policy_set with period 1/hz, computation 0.75 ms, constraint 1.5 ms) that waits via mach_wait_until, avoiding timer coalescing without spinning. The beacon defaults to rt because 18 spinning beacons at 240 Hz would be the load under test; both the beacon and tk-gradient accept it, while the gradient keeps spin as its default. pace_probe adds a rust-rt variant to compare against spin. Runs below 95 % of the asked rate now record verdict NOT RUN across the gradients, storms, and beacons.

Migration

• Run tuikit.py build-bins once per Mac to compile tk-gradient, tk-storm, and tk-beacon (std only, no dependencies, not built by CI).

^{Written for commit 7958050. Summary will update on new commits.}

[lawrencecchen]

Review (subagent, correctness first): SHIP at 43989b9

No blocker. I checked compiling by reading only. The mach FFI types and the time-constraint struct layout are right. Parity with ext_switch.py is exact, except for the clock change on purpose. judge_switch.py fits a clock offset for each pane, so the clock domain is safe. The BeaconRust decoder is correct.
Not blocking, for a follow-up:

• The shared Pacer catches up on late frames in a burst until it is 0.25 s behind, while ext_switch.py resets its schedule. A beacon option to reset, or a count of late frames, would make short stalls visible.
• 18 real-time beacons outrank cmux's threads. The rate data on the mini decides whether rt or spin is the default.
• The Python engines take --pace rt but sleep.
• The rt help text is missing.
  Note: the fleet cannot run the self-test at a branch head. The worker refuses a measure script that is not on feat-cmux-next, so the first compile runs after the merge.

[github-actions]

cmux status _{(one comment, edited in place; each line is updated by the job that owns it)}

Review 26e52fa: HQ feed card · gallery before/after runs · checks

App of this head (app.zip, kept 1 day)

gh workflow run reload-build.yml -R manaflow-ai/cmux --ref feat-cmux-next -f tag=pr31784 -f ref=cp/tui-kit-rust-beacon -f platform=macos -f backend_mode=local

Shipped in:

• cmux NEXT nightly 1.0.0-nightly.4140259429701 (49aee507d9)
• cmux NEXT nightly 1.0.0-nightly.4140296966501 (9e1c48fa22)
• cmux NEXT nightly 1.0.0-nightly.4140454331101 (6996915557)
• cmux NEXT nightly 1.0.0-nightly.4140634564401 (418c43550e)

[lawrencecchen]

Review (subagent, correctness first): SHIP at cccc81a

This is the re-review after the merge of the updated #31764 branch (which has origin/feat-cmux-next in it). The net diff against the merged feat parent 4e9b96d matches the reviewed 8bda9e9..43989b9 line for line: 16 files, +1402 -28. There are no conflict markers and no duplicate lines from the merge. In a clean copy, test_tuikit.py ran 37 tests OK and test_load_profiles.py 16 OK. The Rust paths skip until the fleet build runs.

[blacksmith-sh]

Found 2 test failures on Blacksmith runners:

Failures

Test	View Logs
test_every_compile_job_names_its_warm_sources (main.ThisTree.test_every_compile_job _names_its_warm_sources)/ test_every_compile_job_names_its_warm_sources (main.ThisTree.test_every_compile_job _names_its_warm_sources)	View Logs
test_the_repository_highlights_validate (main.DigestTests.test_the_repository_highl ights_validate)/ test_the_repository_highlights_validate (main.DigestTests.test_the_repository_highl ights_validate)	View Logs

^{Need help on this PR? Tag @codesmith-bot with what you need.}

[lawrencecchen]

Review (subagent, correctness first): SHIP at 26e52fa

This review is after the merge of origin/feat-cmux-next 05415d3, which contains the #31764 squash. The net diff against feat equals the tk-beacon commit 43989b9 line for line: 11 files, +553 -6. The merge left no conflict markers and no duplicate bins or functions, and it undoes nothing from the storm squash. In a clean copy, test_tuikit.py ran 37 tests OK and test_load_profiles.py ran 16 tests OK.

[cursor]

Bugbot needs on-demand usage enabled

Bugbot uses usage-based billing for this team and requires on-demand usage to be enabled.

A team admin can enable on-demand usage in the Cursor dashboard.