schub 0.1.23 → 0.1.25

package/README.md

@@ -66,7 +66,7 @@ Project-scoped DB commands use the project id from `.schub/config.json`.
 
 - `schub proposals write` - Write a new proposal locally from the template (allocates a DB shorthand but does not upload).
 - `schub proposals create` - Create a proposal directly in the database with `--content` (programmatic/API use).
-- `schub proposals save` - Save all files in one proposal folder to DB/storage (`--proposal-id`) or save all local proposals (`--all`).
+- `schub proposals save` - Save all files in one proposal folder to DB/storage (`--id`) or save all local proposals (`--all`).
 - `schub proposals pull` - Pull a proposal from the database into the local `.schub` folder (requires local `.schub/config.json`).
 - `schub proposals update` - Update a proposal status in frontmatter and sync to DB.
 - `schub proposals list` - List proposals (`--show-all` includes archived/rejected).
@@ -76,12 +76,12 @@ Project-scoped DB commands use the project id from `.schub/config.json`.
 
 ##### Proposal IDs
 
-Proposal ids are stored as `P####_<slug>`. Any command that accepts `--proposal-id` also accepts the shorthand `P####` when it uniquely matches a proposal directory under `.schub/proposals` or `.schub/archive/proposals`.
+Proposal ids are stored as `P####_<slug>`. Any command that accepts proposal ids via `--id` also accepts the shorthand `P####` when it uniquely matches a proposal directory under `.schub/proposals` or `.schub/archive/proposals`.
 
 ```bash
-schub proposals save --proposal-id P0003
+schub proposals save --id P0003
 schub proposals save --all
-schub proposals pull --proposal-id P0003
+schub proposals pull --id P0003
 ```
 
 #### Docs
@@ -106,7 +106,12 @@ schub proposals pull --proposal-id P0003
 - `schub tickets implement` - Move a ticket to `wip` and launch Opencode.
 - `schub tickets save` - Validate and save one ticket (`--id`) or all local tickets (`--all`) to DB/storage.
 - `schub tickets pull` - Pull tickets from the database into the local `.schub/tickets` folder (requires local `.schub/config.json`).
+- `schub tickets refine` - Refine a ticket using an LLM prompt (`--id`).
 - `schub tickets files` - List local and DB files for a ticket (`--id`).
+- `schub tickets swap --id <ticket> [--attempt <attempt>]` - Swap the repo to a ticket attempt's worktree state.
+- `schub tickets swap --back` - Restore the original repo state after a swap.
+- `schub tickets swap --status` - Show current swap state.
+- `schub tickets merge --id <ticket> [--attempt <attempt>]` - Squash-merge a ticket attempt into the current branch.
 
 ##### Ticket implementation
 
@@ -135,11 +140,45 @@ schub tickets update --id T0004 --id T0005 --status reviewed
 - `--id` (repeatable) selects backlog ticket IDs to move.
 - `--status` sets the target status and must match a project ticket status in DB.
 
+##### Swap, merge, and worktree cleanup
+
+```bash
+# Preview an agent's work
+schub tickets swap --id TK0084 --attempt A0022
+
+# Return to your original branch
+schub tickets swap --back
+
+# Squash-merge an attempt into the current branch
+schub tickets merge --id TK0084 --attempt A0022
+
+# Remove the attempt's worktree after merging
+schub worktree delete --ticket-id TK0084 --attempt A0022
+```
+
 ##### Overview view shortcut
 
 In Overview view, press `s` on a selected backlog or reviewed ticket to open the status modal.
 For backlog tickets choose `Reviewed` or `Archive`. For reviewed tickets choose `Backlog` or `Archive`, then press enter to confirm or esc to cancel.
 
+#### Worktree
+
+- `schub worktree delete --ticket-id <ticket> [--attempt <attempt>]` - Remove a ticket attempt's worktree from disk and git tracking.
+
+#### Setup
+
+- `schub setup --agent <agent>` - Install all skill templates for a coding agent. Supported agents: `opencode`, `claude`, `codex`.
+
+```bash
+schub setup --agent opencode --agent claude --agent codex
+```
+
+Install paths per agent:
+
+- `opencode` → `~/.opencode/skills/<name>/SKILL.md`
+- `claude` → `~/.claude/skills/<name>.md`
+- `codex` → `~/.codex/skills/<name>.md`
+
 #### Templates & Reviews
 
 - `schub templates create --name adr` - Create a new Architectural Decision Record file.
@@ -154,7 +193,7 @@ For backlog tickets choose `Reviewed` or `Archive`. For reviewed tickets choose
 
 - `create-proposal` - Scaffold and update proposals, including review requirements.
 - `create-ticket` - Create a ticket for any requested repo change.
-- `create-tickets-for-proposal` - Generate actionable ticket files under `.schub/tickets/` from a proposal id.
+- `create-sub-tickets` - Generate actionable child ticket files under `.schub/tickets/` from a parent ticket id.
 - `implement-ticket` - Implement a single ticket end-to-end and move it across ticket status folders.
 - `review-proposal` - Run a proposal review session with open questions and Q&A updates.
 - `refine-ticket` - Refine an existing ticket into the ticket template.