@invariant.guru/cli 0.6.3 → 0.6.5

package/README.md

@@ -166,15 +166,20 @@ invariant plan:complete <session-id> --summary "Booking command + tests"
 Composes a *review session*: a second session whose job is to review the branch
 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.
+A review says what it is about, and one of the two forms is required. Without
+either the command refuses and lists the sessions it could have reviewed —
+which is what stops a review ending up attached to nothing by accident.
 
 ```bash
 invariant review --session <session-id>   # review the work that session produced
-invariant review --session <id> --base origin/develop   # diff against something else
+invariant review --standalone             # review this branch on its own
+invariant review --standalone --base origin/develop     # diff against something else
 ```
 
+`--standalone` is for work no session of yours covers: pull a colleague's
+branch, review it, and get the same triage flow with nothing of your own behind
+it.
+
 Paste its execute line into a **new** agent conversation. That is the point: a
 fresh one has not seen the plan, so it reads the diff as evidence rather than as
 confirmation. It reviews exactly `git diff --cached $(git merge-base <base> HEAD)`
@@ -453,7 +458,8 @@ waits for you to rule on every comment, and then implements the ones you
 accepted — one file, one conversation.
 
 ```bash
-invariant review --session <session-id>        # the session whose work is reviewed (required)
+invariant review --session <session-id>        # the session whose work is reviewed
+invariant review --standalone                  # a branch tied to no session
 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
@@ -469,7 +475,8 @@ invariant review plan-changes <branch>         # accepted comments → the sessi
 
 | Option | Description |
 |--------|-------------|
-| `-s, --session <session>` | The plan session whose work is under review (**required**) |
+| `-s, --session <session>` | The plan session whose work is under review |
+| `--standalone` | Review this branch on its own, tied to no session |
 | `-b, --base <ref>` | Ref to diff against (default: `origin/main`, then `origin/master`, `main`, `master`) |
 
 Reviews land in `doc/review/<branch>.xml`, one file per branch, appended to on