@invariant.guru/cli 0.6.2 → 0.6.4

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
@@ -166,9 +166,13 @@ invariant plan:complete <session-id> --summary "Booking command + tests"
166
166
  Composes a *review session*: a second session whose job is to review the branch
167
167
  and write the result into `doc/review/<branch>.xml`.
168
168
 
169
+ A review is a verdict **on** something, so it always names the session whose
170
+ work is under review — `--session` is required. Without it the command refuses
171
+ and lists the sessions it could have reviewed.
172
+
169
173
  ```bash
170
174
  invariant review --session <session-id> # review the work that session produced
171
- invariant review --base origin/develop # diff against something else
175
+ invariant review --session <id> --base origin/develop # diff against something else
172
176
  ```
173
177
 
174
178
  Paste its execute line into a **new** agent conversation. That is the point: a
@@ -210,7 +214,7 @@ invariant add nest-clean-architecture # activate the whole module
210
214
  invariant sync
211
215
  invariant plan "add the cargo booking command"
212
216
  invariant ui # follow it through to done
213
- invariant review # then have the diff reviewed
217
+ invariant review --session <session-id> # then have that session's diff reviewed
214
218
  ```
215
219
 
216
220
  ---
@@ -449,9 +453,8 @@ waits for you to rule on every comment, and then implements the ones you
449
453
  accepted — one file, one conversation.
450
454
 
451
455
  ```bash
452
- invariant review # review the current branch
453
- invariant review --session <session-id> # link it to the work under review
454
- invariant review --base origin/develop # diff against another ref
456
+ invariant review --session <session-id> # the session whose work is reviewed (required)
457
+ invariant review --session <id> --base origin/develop # diff against another ref
455
458
  invariant review list # every review document
456
459
  invariant review show <branch> --open # what still needs a decision
457
460
  invariant review plan-changes <branch> # accepted comments → the session's Plan
@@ -466,7 +469,7 @@ invariant review plan-changes <branch> # accepted comments → the sessi
466
469
 
467
470
  | Option | Description |
468
471
  |--------|-------------|
469
- | `-s, --session <session>` | The plan session whose work is under review |
472
+ | `-s, --session <session>` | The plan session whose work is under review (**required**) |
470
473
  | `-b, --base <ref>` | Ref to diff against (default: `origin/main`, then `origin/master`, `main`, `master`) |
471
474
 
472
475
  Reviews land in `doc/review/<branch>.xml`, one file per branch, appended to on