hive-forge: post inline review comments with pr reviews --at, number diff lines with pr diff --numbered

docs/4-implementation/agent-tools/forge-cli.md

@@ -609,6 +609,7 @@ List a PR's reviews, or submit one
 * `--request-changes` — Request changes on the PR (submit a `REQUEST_CHANGES` review)
 * `--comment` — Leave a comment review (submit a COMMENT review)
 * `-m`, `--body <BODY>` — Optional body / message for the review (used with --approve, --request-changes, or --comment)
+* `--at <PATH:LINE>` — An inline comment on a line of the new file: `--at path:LINE "text"`. Repeat it to put several comments in the same review. LINE is the new-file line number, which `pr diff --numbered` prints. Needs --approve, --request-changes or --comment
 * `--only <ONLY>` — When listing: narrow the inline comments shown (and leave out the reviews with none left). `unresolved` keeps every comment nobody has resolved yet: what a re-review has to check
 
   Possible values:
@@ -666,6 +667,7 @@ Print the PR's unified diff
 ###### **Options:**
 
 * `--full` — Print the unfiltered diff. By default, hive-forge collapses autogenerated-file hunks (`flake.lock`, `Cargo.lock`, …) to a placeholder so human-authored changes stay readable
+* `--numbered` — Prefix every added or unchanged line with its new-file line number, the number `pr reviews --at path:LINE` takes. Removed lines get no number: an inline comment sits on the new file
 
 
 

docs/4-implementation/agent-tools/forge.md

@@ -83,11 +83,13 @@ hive-forge pr timeline 42                  # review rows list their line comment
 hive-forge pr reviews 42 --approve         # submit APPROVED review
 hive-forge pr reviews 42 --request-changes -m "msg"  # submit REQUEST_CHANGES review
 hive-forge pr reviews 42 --comment -m "msg"  # submit COMMENT review
+hive-forge pr reviews 42 --request-changes -m "msg" --at src/a.rs:12 "off by one" --at src/b.rs:3 "why?"  # one review carrying line comments; LINE is the new-file line `pr diff --numbered` prints
 hive-forge pr assign-reviewer 42 argus      # set argus as a requested reviewer on the PR
 hive-forge pr assign-reviewer 42 argus --remove  # withdraw the request; fails if argus is still listed afterwards (a reviewer who already reviewed stays listed)
 hive-forge pr assign-committer 42 damocles  # add damocles to the PR's assignee list
 hive-forge pr diff 42                       # unified diff (lockfile hunks collapsed by default)
 hive-forge pr diff 42 --full                # include unfiltered lockfile hunks
+hive-forge pr diff 42 --numbered            # prefix added/unchanged lines with their new-file line number, for `pr reviews --at path:LINE`
 hive-forge list                             # open issues/PRs
 hive-forge list --kind pr --state all --page 2  # page 2 of all PRs (walk --page 1,2,… with --limit as page size for a repo-wide sweep)
 hive-forge list --search "trust bundle" --state all  # full-text over title AND body — the duplicate check