@staff0rd/assist 0.963.0 → 0.965.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
@@ -150,7 +150,7 @@ Every command supports `--help` for full detail on its flags and behaviour.
150
150
  - `--checkout-only` - Skip the review; check the PR out and leave an idle Claude session in it. In a clone whose remote is on Azure DevOps it checks out with `az repos pr checkout` instead of `gh` (see [Azure DevOps PRs](#azure-devops-prs))
151
151
  - `--high-level` - Open the high-level review checklist in the web preview pane and post it to the PR as an Approve, Comment or Request changes review. Comments on lines selected in a diff or a test's source are either sent to the agent or added to the review, where those on lines in the PR diff post as line-level comments. See [docs/high-level-review.md](docs/high-level-review.md)
152
152
  - `--configure` - With `--high-level`: configure the checklist's `review.highLevel.*` keys instead of reviewing
153
- - `--scope <repo|project>` - With `--configure`: write to this repo's override in the shared assist database or the project `assist.yml` instead of asking
153
+ - `--scope <db|git>` - With `--configure`: write to repo (db), this repo's override in the shared assist database, or repo (git), the repo's `assist.yml`, instead of asking
154
154
  - `--answer <key=value>` - With `--configure`: answer one key without prompting, repeatable; an empty value leaves the key unset
155
155
  - `--address-comments` - Start an Address Comments session for the PR once comments are posted and the review submitted
156
156
  - `--announce` - Announce the PR in Slack at the end of the chain
@@ -176,7 +176,7 @@ Every command supports `--help` for full detail on its flags and behaviour.
176
176
  - `assist news remove <url>` - Remove a feed URL from `news.feeds`
177
177
  - `news.feeds` - The feed URLs, stored in the assist database so every machine shares them; `assist config set news.feeds <url1>,<url2>` replaces the whole list
178
178
  - `assist releases [list]` - Print the release promotion streams declared in `releases.streams`
179
- - `assist releases configure --streams <file> [--scope <project|repo>]` - Write release streams from a JSON or YAML file (`-` for stdin) to `releases.streams`, in the project `assist.yml` (default) or this repo's shared override in the assist database
179
+ - `assist releases configure --streams <file> [--scope <git|db>]` - Write release streams from a JSON or YAML file (`-` for stdin) to `releases.streams`, in repo (git), the repo's `assist.yml` (default), or repo (db), this repo's shared override in the assist database
180
180
 
181
181
  ### Backlog
182
182
 
@@ -35,8 +35,8 @@ A job with `uses: <owner>/<name>/.github/workflows/<file>@<ref>` calls a reusabl
35
35
 
36
36
  Show the nodes and edges you intend to write, and say which workflow file each node came from — including the reusable ones, so the user can see the chain you followed. Ask them to accept or edit, and ask which config file it goes to:
37
37
 
38
- - `project` — the repo's own `assist.yml`, checked in, so the team sees the same graph
39
- - `repo` — this repo's block in `~/.assist.yml`, personal to this machine
38
+ - `git` — repo (git), the repo's own `assist.yml`, checked in, so the team sees the same graph
39
+ - `db` — repo (db), this repo's override in the shared assist database, personal to the user and seen by every node
40
40
 
41
41
  Ask rather than guess: which jobs deserve a node at all, how jobs split into streams, what to call a stream, and any environment name that is computed rather than written literally.
42
42
 
@@ -45,7 +45,7 @@ Ask rather than guess: which jobs deserve a node at all, how jobs split into str
45
45
  Write the accepted streams to a JSON file and pass it in. Run the command from the repo you are in, never from another checkout: the config it writes belongs to the directory it runs in, whichever repos its streams point at. Set `repo` on any stream that releases another repo; one left out defaults to the repo you are in.
46
46
 
47
47
  ```
48
- assist releases configure --scope project --streams /tmp/streams.json
48
+ assist releases configure --scope git --streams /tmp/streams.json
49
49
  ```
50
50
 
51
51
  ```json
@@ -35,8 +35,8 @@ Do not ask in chat. Write the proposal as markdown to a scratch file with the Wr
35
35
  - `descriptionWordCap` with its value
36
36
  - `collapsedPaths`, each glob as its own bullet like the others
37
37
  - the scope you propose, with the other one named so the user can swap it:
38
- - `repo` — this repo's override in the shared assist database, personal to the user and seen by every node (propose this unless the user has said otherwise)
39
- - `project` — the repo's own `assist.yml`, a file to check in so the team reviews against the same globs; only when the user asks for it, since it leaves a new file in a repo they may not own
38
+ - `db` — repo (db), this repo's override in the shared assist database, personal to the user and seen by every node (propose this unless the user has said otherwise)
39
+ - `git` — repo (git), the repo's own `assist.yml`, a file to check in so the team reviews against the same globs; only when the user asks for it, since it leaves a new file in a repo they may not own
40
40
 
41
41
  Then run, **as a background task**, doing no other work until it returns:
42
42
 
@@ -55,7 +55,7 @@ Outside a web session `assist ask` only prints the markdown and exits 0 without
55
55
  Pass every key, so nothing is prompted for — you have already asked:
56
56
 
57
57
  ```
58
- assist review --high-level --configure --scope repo \
58
+ assist review --high-level --configure --scope db \
59
59
  --answer 'review.highLevel.criticalPaths=**/*.graphql,en-AU/translation.json' \
60
60
  --answer 'review.highLevel.uiPaths=src/ui/**' \
61
61
  --answer 'review.highLevel.descriptionWordCap=300' \