feat(command): tweak command and coordinator skeleton (#660)

[plastikfan]

Summary by CodeRabbit

• New Features

  • Added a new interactive theme tweaking command and a corresponding screen to browse and edit theme-related options.
  • Introduced keyboard shortcuts for undo, quitting, and navigating the new theme editor flow.
  • Added localized command descriptions for the new interactive theme editor.

• Bug Fixes

  • Improved cancel behavior so quitting via keyboard interrupt is handled cleanly.

• Tests

  • Added coverage for the new tweak flow, including state updates, undo behavior, key handling, and UI content.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: fe234daf-1fe5-4672-8948-f08aae37e320

📥 Commits

Reviewing files that changed from the base of the PR and between 2e1182b and 6153eb3.

⛔ Files ignored due to path filters (1)

• go.sum is excluded by !**/*.sum

📒 Files selected for processing (8)

• go.mod
• src/app/command/bootstrap.go
• src/app/command/tweak-cmd.go
• src/app/controller/tweak-coordinator.go
• src/app/controller/tweak-coordinator_test.go
• src/app/controller/tweak-home-model.go
• src/app/controller/tweak-home-model_test.go
• src/locale/tweak-cmd-cobra.go

---

📝 Walkthrough

Walkthrough

This PR introduces a new tweak CLI command backed by a TweakCoordinator that manages a three-layer palette state and a Bubble Tea TUI lifecycle. A TweakHomeModel screen is added for the home view, plus locale message templates and expanded go.mod indirect dependencies.

Changes

Tweak command feature

Layer / File(s)	Summary
Command entry point and wiring src/app/command/tweak-cmd.go, src/app/command/bootstrap.go, src/locale/tweak-cmd-cobra.go	Adds buildTweakCommand/runTweak, registers the tweak command in Bootstrap.Root(), and adds long/short description locale templates.
TweakCoordinator state and lifecycle src/app/controller/tweak-coordinator.go, src/app/controller/tweak-coordinator_test.go	Adds TweakCoordinatorOptions/TweakCoordinator with Run, Stop, a preview loop skeleton, and palette operations (WorkingPalette, Undo, IsDirty, ExitFlow), with tests.
Tweak home TUI screen src/app/controller/tweak-home-model.go, src/app/controller/tweak-home-model_test.go	Adds TweakHomeModel with styles, entries, and Init/Update/View implementations wired to the coordinator, with tests.
Dependency updates go.mod	Expands indirect dependency list to support new TUI-related packages.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant CLI
  participant runTweak
  participant TweakCoordinator
  participant TweakHomeModel

  User->>CLI: jay tweak
  CLI->>runTweak: execute command
  runTweak->>runTweak: load palette from theme
  runTweak->>TweakCoordinator: NewTweakCoordinator(opts)
  runTweak->>TweakCoordinator: Run(ctx)
  TweakCoordinator->>TweakHomeModel: start Bubble Tea program
  User->>TweakHomeModel: key press (z/Z, q/Q, ctrl+c)
  TweakHomeModel->>TweakCoordinator: Undo() / ExitFlow()
  TweakCoordinator-->>TweakHomeModel: updated state
  TweakHomeModel-->>User: rendered View()

Loading

Possibly related issues

• tweak command and coordinator skeleton #660: Adds the same jay tweak command flow and supporting TweakCoordinator/TweakHomeModel skeleton described here.

Possibly related PRs

• snivilised/jaywalk#462: Both PRs modify Bootstrap.Root()'s Cobra command-tree wiring in bootstrap.go.
• snivilised/jaywalk#464: Both PRs register additional subcommands in Bootstrap.Root().
• snivilised/jaywalk#652: Part of the same tweak feature foundation, modifying Bootstrap.Root for tweak-related bootstrapping.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/tweak-command-and-coordinator-skeleton

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}