Skip to content

CS-10625: Reimplement boxel realm history command#4553

Draft
FadhlanR wants to merge 2 commits intomainfrom
cs-10625-reimplement-boxel-realm-history-command
Draft

CS-10625: Reimplement boxel realm history command#4553
FadhlanR wants to merge 2 commits intomainfrom
cs-10625-reimplement-boxel-realm-history-command

Conversation

@FadhlanR
Copy link
Copy Markdown
Contributor

Status

Draft — plan doc only, implementation to follow. Opening early per CS-10900 workflow.

Summary

  • Port boxel history from the standalone cardstack/boxel-cli into packages/boxel-cli/src/commands/realm/history.ts (alias hist)
  • Namespaced under realm group (whole-realm checkpoint state, not per-file) — matches command-structure memory
  • Options: -r, --restore [number-or-hash], -m, --message <message>
  • Storage: git-based checkpoints in workspace's .boxel-history/ (legacy convention, confirm during port)
  • Safety net for destructive sync ops (--prefer-local, realm push --delete) — the inspiration CLAUDE.md insists on a checkpoint before each

Linear

CS-10625 — blocks Claude Code plugin marketplace submission in CS-10900

Plan doc

See docs/cs-10625-boxel-realm-history-plan.md in this PR.

Test plan

  • pnpm --filter @cardstack/boxel-cli test:unit passes
  • pnpm --filter @cardstack/boxel-cli test:integration passes
  • pnpm --filter @cardstack/boxel-cli build succeeds
  • boxel realm history --help documents -r and -m
  • Manual: in a synced staging workspace, edit files → boxel realm history . -m "test" creates checkpoint → boxel realm history . -r 1 rolls back

🤖 Generated with Claude Code

FadhlanR and others added 2 commits April 28, 2026 14:09
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Port the history command from the legacy boxel-cli into the monorepo
under `realm history` (alias `hist`). Three modes: view (default),
restore (`-r <number-or-hash>`), and manual checkpoint (`-m <message>`).
Backed by the existing CheckpointManager, so no new dependency.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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