feat(install)!: always delegate play install, update, and repair to rote

[roberts-pumpurs]

Play ships its own installer and repair commands, and they fight rote install play over the same launchers and skill links.

This is the Play side of the rote install stack (modiqo/rote#2819 to modiqo/rote#2845). Merge it after the rote release that ships that stack, because every entry point here calls rote install play.

Before

rote install play   # Play under ~/.rote/play/current
play update         # runs Play's install.sh, which runs play-bootstrap

play update, play restore, play-activate, and install-all install a second copy under ~/.local/share/modiqo/play and repoint the ~/.local/bin launchers and <skills root>/play links at it. The next rote update points them back, so the active Play flips between copies with no message. The play@play-skills plugin carries a third copy, a full repo mirror.

rote's install also finds no play-setup to run, and play-intercept rejects the --harness cursor that rote's Cursor hook passes (inferred from code, not reproduced).

flowchart LR
  update["play update or install.sh"]
  repair["play restore, play-activate, install-all"]
  rote["rote install play"]
  copy[".local/share/modiqo/play copy"]
  current[".rote/play/current"]
  links["launchers and skill links"]
  plugin["play-skills plugin"]
  mirror["full repo mirror in the plugin"]
  update --> copy
  repair --> copy
  copy --> links
  rote --> current
  current --> links
  plugin --> mirror
  update ~~~ rote
  plugin ~~~ current
  classDef bad fill:#f8d7da,stroke:#b02a37,color:#000
  class copy,mirror,repair bad
  linkStyle 0,1,2 stroke:#b02a37,stroke-width:2px

Loading

After

Run the same commands. Only rote places Play.

• play update runs rote install play with its arguments. Without rote on PATH it prints curl -fsSL https://getrote.dev/install | bash and exits 1.
• install.sh is a shim: no rote runs the rote installer, a rote without install play --from runs rote update first, then it runs rote install play. just install runs rote install play --from ..
• The marketplace plugin is a pointer SKILL.md that reads ~/.rote/play/current/SKILL.md, or tells the user to run rote install play.
• New play-setup seeds the routing policy, journal settings, and model assets and prints play.setup/v1. rote runs it after placing Play and rolls back a release whose model_assets step fails.
• play-intercept prompt --harness cursor prints {"continue": true}.
• Preflight hints and the Grok pointer name rote install play and read ~/.rote/play/current.

flowchart LR
  update["play update or install.sh"]
  repair["play restore, play-activate, install-all"]
  rote["rote install play"]
  copy[".local/share/modiqo/play copy"]
  current[".rote/play/current"]
  links["launchers and skill links"]
  plugin["play-skills plugin"]
  mirror["full repo mirror in the plugin"]
  update ~~~ copy
  repair ~~~ copy
  copy ~~~ links
  rote --> current
  current --> links
  plugin ~~~ mirror
  update --> rote
  plugin --> current
  classDef gone fill:#eeeeee,stroke:#999999,stroke-dasharray:4 3,color:#777777
  classDef added fill:#d1e7dd,stroke:#146c43,color:#000
  class copy,mirror,repair gone
  class update,plugin added
  linkStyle 6,7 stroke:#146c43,stroke-width:2px

Loading

Grey dashed parts are removed. Green parts now hand off to rote's single copy at ~/.rote/play/current.

Compatibility

• Breaking: play backup and play restore are removed. Run rote install play to repair an install.
• Breaking: play-bootstrap, play-activate, install-all, and play-profile are removed, with the just recipes that wrapped them (bootstrap-plan, bootstrap-apply, install-copy, update, plan, uninstall, status, status-roots, verify-profile).
• Breaking: play update requires rote.
• play@play-skills is still published so marketplaces list Play; rote removes it once it links the real skill.

Validation

In a sandboxed home on macOS arm64, rote at the stack tip installed this branch with just barebones-install-sh --non-tty --play-from <checkout>. Setup reported READY, Play LOCAL CHECKOUT. ~/.rote/play/verify.log showed play-setup creating routing_policy, journal_settings, and model_assets. The Cursor hook rote wrote to ~/.cursor/hooks.json printed {"continue": true}.

BREAKING CHANGE: play backup, play restore, play-bootstrap, play-activate, install-all, play-profile, and their just recipes are removed, and play update now requires rote. Install, update, and repair Play with rote install play.