@staff0rd/assist 0.565.2 → 0.567.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -110,7 +110,7 @@ Every command supports `--help` for full detail on its flags and behaviour.
110
110
  - `assist prs edit [--title <t>] [--what <w>] [--why <y>] [--how <h>] [--resolves <key>]` - Update only the supplied sections of the current PR's body. In a web session the resulting title and body are previewed for approve/reject first (with inline comments and pasted screenshots, as for `raise`); on approval the edit is applied with any screenshots appended, on rejection the reviewer's comments are printed and nothing is changed. Outside a session the edit applies directly
111
111
  - `assist prs list-comments` - List all comments on the current branch's pull request
112
112
  - `assist prs fixed <comment-id> <sha>` - Reply with commit link and resolve thread
113
- - `assist prs wontfix <comment-id> <reason>` - Reply with reason and resolve thread. Pass `-` as the reason to read it from stdin. A body containing markdown — backticks around identifiers, `$(...)`, `$VAR` — must be piped in rather than passed as an argument, or the calling shell expands it before assist sees it:
113
+ - `assist prs wontfix <comment-id> <reason>` - Reply with reason and resolve thread. In a web session the reason is previewed for approve/reject first (with inline comments); on rejection nothing is posted, the reviewer's comments are printed and the command exits non-zero. Pass `-` as the reason to read it from stdin. A body containing markdown — backticks around identifiers, `$(...)`, `$VAR` — must be piped in rather than passed as an argument, or the calling shell expands it before assist sees it:
114
114
 
115
115
  ```bash
116
116
  assist prs wontfix 3718677497 - <<'EOF'
@@ -118,8 +118,8 @@ Every command supports `--help` for full detail on its flags and behaviour.
118
118
  EOF
119
119
  ```
120
120
 
121
- - `assist prs reply <comment-id> <body>` - Reply to a comment thread without resolving it. Pass `-` as the body to read it from stdin
122
- - `assist prs comment <path> <line> <body>` - Add a line comment to the pending review. Pass `-` as the body to read it from stdin
121
+ - `assist prs reply <comment-id> <body>` - Reply to a comment thread without resolving it. In a web session the body is previewed for approve/reject first (with inline comments), as for `wontfix`. Pass `-` as the body to read it from stdin
122
+ - `assist prs comment <path> <line> <body>` - Add a line comment to the pending review. In a web session the comment is previewed for approve/reject first (with inline comments), headed `Comment on <path>:<line>`; nothing is posted until it is approved. Pass `-` as the body to read it from stdin
123
123
  - `assist review [number]` - Run Claude and Codex in parallel to review the current branch's PR, then post line-bound comments. The diff comes from GitHub, so stale local base branches don't pollute the review; cached `claude.md` / `codex.md` / `synthesis.md` are reused when present
124
124
  - `[number]` - `gh pr checkout <number>` first, placed by the worktree allocator on a repo with parallel work enabled (see [docs/parallel-work.md](docs/parallel-work.md))
125
125
  - `--no-prompt` - Skip all confirmations
@@ -168,7 +168,7 @@ Backlog item ids are written and displayed in an `a`-prefixed form (e.g. item 55
168
168
  - `assist backlog set-status <id> <status>` - Set status (`todo`, `in-progress`, `done`, `wontdo`)
169
169
  - `assist backlog star <id>` / `assist backlog unstar <id>` - Pin an item ahead of unstarred items in the web view
170
170
  - `assist backlog delete <id>` - Delete a backlog item
171
- - `assist backlog comment <id> <text>` - Add a comment to a backlog item (inside a web session the comment is shown in the preview pane and only written once approved)
171
+ - `assist backlog comment <id> <text>` - Add a comment to a backlog item. Set `backlog.previewComments` to `true` to have the comment shown in the web preview pane and only written once approved; by default it is written immediately
172
172
  - `assist backlog comments <id>` - List comments and summaries for a backlog item
173
173
  - `assist backlog delete-comment <id> <comment-id>` - Delete a comment (summaries cannot be deleted)
174
174
  - `assist backlog phase-done <id> <phase> <summary>` - Signal that a plan phase is complete