From 3036472a55500ee7030235dd44f29030b68ae808 Mon Sep 17 00:00:00 2001 From: iris Date: Thu, 2 Jul 2026 12:43:48 +0200 Subject: [PATCH] docs(tools/forge): note that comments verb includes PR review bodies hive-forge comments on a PR now merges review bodies (the summary text from approve / request-changes / comment reviews) into the comment listing, fixed in 1cff77f5. The verb list inline comment and the 'Which read verb when' table row both said 'only the comments' which was stale. Updated both to reflect the review-body inclusion. --- docs/tools/forge.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tools/forge.md b/docs/tools/forge.md index fb5c5821..8ff08374 100644 --- a/docs/tools/forge.md +++ b/docs/tools/forge.md @@ -34,7 +34,7 @@ hive-forge pr status --pr 42 # PR health (mergeable / CI / review hive-forge issue create --title "..." --body "..." # --- flat aliases below remain valid (hidden) --- hive-forge view 42 # title + body + comments (marks thread read) -hive-forge comments 42 # list all comments (human-readable; marks thread read) +hive-forge comments 42 # list all comments (human-readable; marks thread read); for PRs, review bodies merged in hive-forge comments 42 --tail 10 # last 10 comments (count-then-page; efficient on long threads) hive-forge --json comments 42 # same as above, JSON array (global flag) hive-forge comment 42 --body "..." # post comment (inline body) @@ -95,7 +95,7 @@ distinct output shape — pick by what you need: |------|------|-------| | The full human view of one item — title, body, **and** every comment in order | `view ` | prose dump; **marks the thread read** (clears the read-before-comment guard). Top-level `view` auto-detects issue-or-PR by number; scoped `issue view ` / `pr view ` do the same when you already know the kind | | Just the structured metadata of one item (state, labels, assignees, head sha…) | `issue ` / `pr ` | JSON object | -| Only the comments (skip the body), e.g. to catch up a long thread | `comments ` [`--tail N`] | comment list; **marks read** | +| Only the comments (skip the body), e.g. to catch up a long thread; for PRs, review bodies (approve/request-changes/comment summaries) are merged in too | `comments ` [`--tail N`] | comment + review-body list; **marks read** | | One specific comment by its id | `comment-show ` | single comment | | The audit trail — closes, label/assignee changes, commit refs, merges (no comment bodies) | `timeline ` | event list | | The code change | `diff ` | unified diff |