@invariant.guru/cli 0.6.1 → 0.6.3

package/README.md

@@ -164,11 +164,15 @@ invariant plan:complete <session-id> --summary "Booking command + tests"
 ### 6. `invariant review` — have the diff read by someone who did not write it
 
 Composes a *review session*: a second session whose job is to review the branch
-and write the result into `doc/review/<branch>.md`.
+and write the result into `doc/review/<branch>.xml`.
+
+A review is a verdict **on** something, so it always names the session whose
+work is under review — `--session` is required. Without it the command refuses
+and lists the sessions it could have reviewed.
 
 ```bash
 invariant review --session <session-id>   # review the work that session produced
-invariant review --base origin/develop    # diff against something else
+invariant review --session <id> --base origin/develop   # diff against something else
 ```
 
 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
 invariant sync
 invariant plan "add the cargo booking command"
 invariant ui                            # follow it through to done
-invariant review                        # then have the diff reviewed
+invariant review --session <session-id> # then have that session's diff reviewed
 ```
 
 ---
@@ -449,9 +453,8 @@ waits for you to rule on every comment, and then implements the ones you
 accepted — one file, one conversation.
 
 ```bash
-invariant review                               # review the current branch
-invariant review --session <session-id>        # link it to the work under review
-invariant review --base origin/develop         # diff against another ref
+invariant review --session <session-id>        # the session whose work is reviewed (required)
+invariant review --session <id> --base origin/develop   # diff against another ref
 invariant review list                          # every review document
 invariant review show <branch> --open          # what still needs a decision
 invariant review plan-changes <branch>         # accepted comments → the session's Plan
@@ -466,10 +469,10 @@ invariant review plan-changes <branch>         # accepted comments → the sessi
 
 | Option | Description |
 |--------|-------------|
-| `-s, --session <session>` | The plan session whose work is under review |
+| `-s, --session <session>` | The plan session whose work is under review (**required**) |
 | `-b, --base <ref>` | Ref to diff against (default: `origin/main`, then `origin/master`, `main`, `master`) |
 
-Reviews land in `doc/review/<branch>.md`, one file per branch, appended to on
+Reviews land in `doc/review/<branch>.xml`, one file per branch, appended to on
 each pass. **`plan-changes` refuses while any comment is still undecided** —
 partial triage silently drops the comments nobody looked at, so it is not
 allowed. Nothing here touches the index or a remote: the git commands this tool