Add CLI and TUI posting moves

[robzolkos]

Summary

• add hey move <posting-id>... --to <box> with bulk moves and destination lookup by name, kind, or ID
• add an m destination picker to the TUI while preserving the existing one-key box actions
• exclude the current box and Bubble Up from the picker, reject Bubble Up in the CLI, and avoid same-box TUI requests that could change seen state
• document posting IDs, destination semantics, and the new command across help, README, API coverage, and the embedded HEY skill

Behavior

Supported destinations are Imbox, The Feed, Set Aside, Reply Later, and Paper Trail. Moving to boxes other than Imbox marks the posting seen, which the TUI explains before confirmation. Bubble Up continues to use HEY's scheduled flow.

Validation

• make check
• make race-test
• smoke test package compilation
• local build and command help
• authenticated production validation:
  • moved and restored one posting through the CLI
  • moved and restored two postings in one bulk CLI request
  • moved a posting from Imbox to Paper Trail through the TUI and restored it
  • confirmed destination box membership after every move and restore
  • confirmed Bubble Up is rejected before a move request

All production-validation postings were restored to Imbox.

---

Summary by cubic

Adds posting moves to both the CLI and TUI so users can move messages between HEY boxes without the web app. Moving to non‑Imbox marks messages seen; Bubble Up is excluded and must use HEY’s scheduled flow.

• CLI: hey move <posting-id>... --to <box> supports bulk IDs and resolves destinations by name, kind, or ID; rejects Bubble Up; prints a concise summary; adds help and breadcrumbs.
• TUI: press m to open a destination picker; excludes the current box and Bubble Up; Enter moves, Esc cancels; explains that non‑Imbox moves mark the message seen; existing one‑key moves remain and skip no‑op same‑box requests.
• API/docs/tests: uses /postings/moves.json via SDK Postings().Move; updates .surface, README, help text, skills/hey/SKILL.md, and API-COVERAGE.md; adds unit and smoke tests for success and error cases.

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

[Copilot]

Pull request overview

Adds bulk posting moves to the CLI and an interactive destination picker to the TUI.

Changes:

• Adds hey move with destination resolution and Bubble Up rejection.
• Adds the TUI move picker while preventing same-box moves.
• Updates tests, help, documentation, API coverage, and skill metadata.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
.surface	Registers the move command surface.
API-COVERAGE.md	Documents move endpoint coverage.
README.md	Documents CLI and TUI moves.
internal/cmd/box.go	Adds a move breadcrumb.
internal/cmd/help.go	Adds move to categorized help.
internal/cmd/help_test.go	Updates help expectations.
internal/cmd/move.go	Implements the move command.
internal/cmd/move_test.go	Tests move behavior and errors.
internal/cmd/root.go	Registers the move command.
internal/tui/mail.go	Integrates posting moves into mail.
internal/tui/mail_test.go	Tests picker and same-box behavior.
internal/tui/move.go	Implements the destination picker.
internal/tui/tui_test.go	Tests picker input ownership.
skills/hey/SKILL.md	Documents move usage for agents.
tests/smoke/boxes_test.go	Adds end-to-end move coverage.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.