From 96a27cef3c3b592373e2c8108f46d3141793c990 Mon Sep 17 00:00:00 2001 From: damocles Date: Tue, 18 Aug 2026 12:47:46 +0200 Subject: [PATCH] docs: cover the reaction verb and comments --show-reactions --- docs/tools/forge.md | 15 ++++++++++++++- hive-forge/src/main.rs | 4 ++-- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/tools/forge.md b/docs/tools/forge.md index e9228a0a..dbebf681 100644 --- a/docs/tools/forge.md +++ b/docs/tools/forge.md @@ -21,7 +21,7 @@ under `issue` and `pr` parent commands — `hive-forge pr close 42`, refuses an issue number, which the old generic `close` couldn't). Run `hive-forge pr --help` / `hive-forge issue --help` for the full subcommand list (show/create/edit/status/merge/reviews/commits/diff/view/comment/ -comments/close/reopen/labels/assign/dependency/timeline as applicable). +comments/close/reopen/labels/assign/dependency/reaction/timeline as applicable). The flat forms below (`close 42`, `pr-create …`, `pr-status …`, …) still work as **hidden back-compat aliases** during the transition and are dropped from @@ -53,6 +53,10 @@ hive-forge issue dependency 42 # list #42's dependencies (issues hive-forge issue dependency 42 add 40 41 # #42 is now blocked by #40 and #41 hive-forge issue dependency 42 remove 40 # drop the #40 dependency link hive-forge pr dependency 55 add 42 # same verb, PR-scoped (Forgejo shares the issue/PR index) +hive-forge issue reaction 42 # list #42's reactions +hive-forge issue reaction 42 add heart # react to #42 with :heart: +hive-forge issue reaction 42 --comment 18042 add +1 # react to a specific comment instead +hive-forge issue reaction 42 remove heart # remove your own :heart: reaction hive-forge issue-create --title "..." --body "..." hive-forge issue-create --title "..." --body "..." --label area/ops --label type/bug # repeatable hive-forge issue-edit 42 --title "new title" @@ -287,6 +291,15 @@ to discover valid label names before triaging or to audit the label set. forge UI's dependency panel). Same-repo only, matching the web UI (no cross-repo dependency support). `list` (the default action) and `add`/ `remove` all print the resulting dependency list as JSON. +- `issue reaction add ` / `pr reaction add ` add + an emoji reaction (Forgejo's shortcode vocabulary — `+1`, `heart`, + `rocket`, …, same set the web UI's picker offers, not a raw emoji + character); `--comment ` targets a specific comment's reactions + instead of the issue/PR itself. `list`/`add`/`remove` all print the + resulting reaction list as JSON, same shape as `dependency`. `view`, + `issue`, `pr`, and `comment-show` always show a reaction summary; + `comments --show-reactions` adds one per comment shown (opt-in — one + extra request per comment, no server-side inline count). - Do NOT use raw `curl` for forge access -- the CLI handles auth, error checking, and output formatting. - `issue-create --label ` / `pr-create --label ` are diff --git a/hive-forge/src/main.rs b/hive-forge/src/main.rs index b5a44b27..736d9942 100644 --- a/hive-forge/src/main.rs +++ b/hive-forge/src/main.rs @@ -67,7 +67,7 @@ enum Verb { /// Dump title + body + all comments for an issue or PR. #[command(hide = true)] View(verbs::view::Args), - /// Issue-scoped commands: `issue …`. + /// Issue-scoped commands: `issue …`. Issue(verbs::issue_cmd::Args), /// Create an issue. Prints the issue URL on success. #[command(hide = true)] @@ -75,7 +75,7 @@ enum Verb { /// Edit an issue's title, body, state, or milestone. #[command(hide = true)] IssueEdit(verbs::issue_edit::Args), - /// PR-scoped commands: `pr …`. + /// PR-scoped commands: `pr …`. Pr(verbs::pr_cmd::Args), /// List a PR's commits as JSON (sha, message, author date, author). #[command(hide = true)]