@staff0rd/assist 0.94.0 → 0.95.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
@@ -41,6 +41,7 @@ After installation, the `assist` command will be available globally. You can als
41
41
  - `/review-comments` - Process PR review comments one by one
42
42
  - `/journal` - Append a journal entry summarising recent work, decisions, and notable observations
43
43
  - `/standup` - Summarise recent journal entries as a standup update
44
+ - `/generate-cli-read-verbs <cli>` - Discover CLI commands and classify read vs write verbs
44
45
  - `/sync` - Sync commands and settings to ~/.claude
45
46
  - `/verify` - Run all verification commands in parallel
46
47
  - `/transcript-format` - Format meeting transcripts from VTT files
@@ -92,6 +93,8 @@ After installation, the `assist` command will be available globally. You can als
92
93
  - `assist devlog next` - Show commits for the day after the last versioned entry
93
94
  - `assist devlog skip <date>` - Add a date to the skip list
94
95
  - `assist devlog version` - Show current repo name and version info
96
+ - `assist cli-discover <cli>` - Discover a CLI's command tree via recursive `--help` parsing (outputs JSON)
97
+ - `assist cli-hook` - PreToolUse hook for auto-approving read-only CLI commands (reads JSON from stdin)
95
98
  - `assist update` - Update assist to the latest version and sync commands
96
99
  - `assist vscode init` - Add VS Code configuration files
97
100
  - `assist deploy init` - Initialize Netlify project and configure deployment
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Discover CLI commands and classify read vs write verbs
3
+ allowed_args: "<cli-name>"
4
+ ---
5
+
6
+ Generate read verb classifications for a CLI tool. This discovers all commands via `assist cli-discover` and classifies them as read or write operations.
7
+
8
+ 1. Run `assist cli-discover $ARGUMENTS 2>&1` to get the command tree (output is human-readable, one command per line formatted as ` path — description`)
9
+ 2. Review the discovered commands and classify the **leaf verb** (last word in the path) of each command as either read (safe, no side effects) or write (modifies state)
10
+ - Read examples: list, view, show, get, diff, status, search, checks, describe, inspect, logs, cat, top, explain
11
+ - Write examples: create, delete, merge, close, reopen, edit, update, set, apply, patch, drain, cordon, taint, push, deploy
12
+ - Use your judgment for ambiguous verbs — consider what the command actually does in context of this specific CLI
13
+ - De-duplicate: only include unique verb strings (e.g. if "list" appears in multiple paths, include it once)
14
+ 3. Read the current `assist.yml` config file
15
+ 4. Update the `cliReadVerbs` section, adding or replacing the entry for this CLI with the classified read verbs:
16
+ ```yaml
17
+ cliReadVerbs:
18
+ <cli>: [verb1, verb2, verb3, ...]
19
+ ```
20
+ 5. Report a summary showing the read verbs and write verbs identified
21
+
22
+ ARGUMENTS: $ARGUMENTS