Skip to content

Commit cee92ae

Browse files
committed
docs(agent): read the plan where --json carries it before rolling back
1 parent 918d47a commit cee92ae

1 file changed

Lines changed: 12 additions & 3 deletions

File tree

‎packages/cli/src/agent/recover-rule.md‎

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,12 @@ it prints:
2727

2828
- `check` gives git steps ("Restoring rules is not included in your
2929
organization's plan, so recover … from git") where it would name
30-
`rule restore`.
30+
`rule restore`. Under `--json` the same sentence is in `notices` and
31+
`failures`, so read it from there.
3132
- `rule revisions` ends with "Rolling back is not included in your
32-
organization's plan" where it would name `rule rollback`.
33+
organization's plan" where it would name `rule rollback`. That line
34+
is printed **only without `--json`**; the `--json` listing is the
35+
same on every plan and says nothing about it.
3336

3437
When either appears, the plan does not include recovery. Follow the
3538
git steps instead of running `rule restore` or `rule rollback`, which
@@ -79,7 +82,13 @@ below, and the service's answer settles it.
7982

8083
## Rolling back
8184

82-
1. **List the revisions.**
85+
1. **Check the plan, then list the revisions.** If `check` already
86+
gave git steps for this rule, the plan does not include rolling
87+
back; go to "When the plan does not include recovery". Otherwise
88+
run `%(TASKLESS_CLI)s rule revisions <ruleId>` once without
89+
`--json` and read its last line: "Rolling back is not included in
90+
your organization's plan" means the same. Then list them for
91+
reading:
8392
```
8493
%(TASKLESS_CLI)s rule revisions <ruleId> --json
8594
```

0 commit comments

Comments
 (0)