Skip to content

feat(tui): add standalone Gum-powered Rotatui companion (WIP) - #317

Merged
drawmeanelephant merged 1 commit into
mainfrom
feat/rotatui
Sep 5, 2026
Merged

drawmeanelephant merged 1 commit into
mainfrom
feat/rotatui

Conversation

@drawmeanelephant

Copy link
Copy Markdown
Owner

Summary

Introduces rotatui.sh, a standalone, optional Terminal User Interface (TUI) companion powered by Charm Gum.

Marked as a Work in Progress (WIP) to allow testing and further iteration.

Key Architecture Decisions

  • Zero Operator Intrusion: rotkeeper.sh remains 100% untouched. The TUI lives in rotatui.sh and executes rituals through bash rotkeeper.sh <command>, ensuring that core headless CLI workflows, traps, and validation are preserved.
  • Spooky Dark Palette: Styled with Rotkeeper's signature theme—ethereal violet (#9d4edd), phosphor green (#06d6a0), ghostly amber (#ffb703), and slate accents.
  • Terminal Leak Fix: Bypasses the known macOS terminal capability query leak (^[[?2026;2$y... from Gum v2.0.0 / Bubbletea) by implementing a smooth, native Bash braille spinner (spooky_spin) and input-draining helper.
  • Complete Ritual Coverage: Interactive support for render, new (tomb wizard), pack, status, assets, links, a11y, preflight, glue, showcase, book, scan, autopsy, dip, bump, release, and test.
  • Packaging Allowlist: Registered rotatui.sh in bones/scripts/rc-release.sh allowlist.

Verification

  • bash -n rotatui.sh bones/scripts/rc-release.sh (passed)
  • shellcheck rotatui.sh bones/scripts/rc-release.sh (passed, 0 warnings)
  • bash rotkeeper.sh test --dry-run (passed)
  • bash rotkeeper.sh status --short (passed)
  • bash rotkeeper.sh release 0.8.0 --dry-run (passed)

- Scaffold standalone necropolis TUI in rotatui.sh without modifying rotkeeper.sh
- Provide interactive coverage for all Rotkeeper rituals and audits
- Style with spooky dark palette (ethereal violet, phosphor green, amber, slate)
- Implement custom spooky_spin and input draining to prevent Gum v2 terminal query leak
- Add rotatui.sh to allowed_root list in rc-release.sh
@drawmeanelephant
drawmeanelephant marked this pull request as ready for review September 5, 2026 16:37
@drawmeanelephant
drawmeanelephant merged commit a03a06b into main Sep 5, 2026
3 checks passed
@drawmeanelephant
drawmeanelephant deleted the feat/rotatui branch September 5, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant