@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 <
|
|
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 <
|
|
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
|
-
- `
|
|
39
|
-
- `
|
|
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
|
|
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
|
-
- `
|
|
39
|
-
- `
|
|
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
|
|
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' \
|