@staff0rd/assist 0.239.1 → 0.241.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.
Files changed (3) hide show
  1. package/README.md +7 -2
  2. package/dist/index.js +506 -367
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -91,14 +91,19 @@ After installation, the `assist` command will be available globally. You can als
91
91
  - `assist prs fixed <comment-id> <sha>` - Reply with commit link and resolve thread
92
92
  - `assist prs wontfix <comment-id> <reason>` - Reply with reason and resolve thread
93
93
  - `assist prs comment <path> <line> <body>` - Add a line comment to the pending review
94
- - `assist review [sha] [options]` - Run Claude and Codex in parallel to review the open PR for the current branch. The diff is fetched from GitHub (base SHA → head SHA via `gh pr diff`), so stale local base branches don't pollute the review; fails fast if no PR is open. By default, prompts before posting line-bound comments and then prompts again to submit the pending review (defaulting to no). Cached `claude.md` / `codex.md` / `synthesis.md` are reused when present; if any reviewer is re-run, the synthesis is invalidated.
95
- - `[sha]` - Review that commit's diff (`sha^..sha`) instead of the open PR. Files land under `.assist/reviews/<shortSha>/`, no GitHub lookup or posting happens, and `--refine` / `--apply` / `--submit` are rejected
94
+ - `assist review [number] [options]` - Run Claude and Codex in parallel to review the open PR for the current branch. The diff is fetched from GitHub (base SHA → head SHA via `gh pr diff`), so stale local base branches don't pollute the review; fails fast if no PR is open. By default, prompts before posting line-bound comments and then prompts again to submit the pending review (defaulting to no). Cached `claude.md` / `codex.md` / `synthesis.md` are reused when present; if any reviewer is re-run, the synthesis is invalidated.
95
+ - `[number]` - Run `gh pr checkout <number>` first, then review that PR's branch. If the checkout fails (dirty working tree, unknown PR number), the review aborts
96
96
  - `--no-prompt` - Skip all confirmations
97
97
  - `--submit` - Default the submit prompt to yes (or auto-submit when combined with `--no-prompt`)
98
98
  - `--force` - Clear all cached files and re-run every phase
99
99
  - `--refine` - Skip posting; launch an interactive Claude session that walks through `synthesis.md` and edits it in place. A subsequent `assist review` reuses the refined file and posts only the surviving findings
100
100
  - `--apply` - Skip posting; launch an interactive Claude session that walks through each finding asking apply/skip. Applied findings are fixed in the working tree (unstaged) and removed from `synthesis.md`; skipped findings stay so a subsequent `assist review` posts them. Cannot be combined with `--refine`
101
+ - `--backlog` - Skip posting; launch an interactive Claude session running `/bug` that files all findings (including `already-raised`) as a single bug backlog item with one phase per finding. `synthesis.md` is left untouched; `--submit` is ignored. Cannot be combined with `--refine` or `--apply`
101
102
  - `--verbose` - Disable the stacked-spinner UI and fall back to per-line log output. Non-TTY environments (CI) automatically use this mode
103
+ - `assist github commits <org>` - Report commit activity across a GitHub organisation over the last 30 days: repos ranked by commits to their default branch, top committers, and a per-repo author breakdown (empty repos are skipped; commits with no linked GitHub account fall back to the raw author name)
104
+ - `--since <date>` - Start of the window as `YYYY-MM-DD` instead of the default 30 days ago
105
+ - `--top <n>` - Only report the top `n` repos by commit count; committers and the author breakdown then cover those repos only (also caps the per-repo author queries, which speeds up large orgs)
106
+ - `--json` - Output all three views as structured JSON instead of tables
102
107
  - `assist news` - Start the news web UI showing latest RSS feed items (same as `news web`)
103
108
  - `assist news add [url]` - Add an RSS feed URL to the config
104
109
  - `assist news web [-p, --port <number>]` - Start a web view of the news feeds (default port 3001)