hive-forge: drop boilerplate # Errors from pure-GET verbs (mara on #827, option A)

mara: 'those comments seem very redundant'. true — the 16 pure-GET
verbs all got the same 'transport error + stdout I/O' boilerplate,
which just restates the Result<()> contract that's trivially
derivable from the type.

dropped # Errors from: assign, branches, close, comment_show,
comments, diff, issue, labels, lint, list, milestone, pr,
pr_reviews, subscription, timeline, tree_sha, view (17 files).

kept on the 7 verbs that have a non-Forgejo failure surface worth
documenting:
- comment, comment_edit, issue_create, issue_edit — body input I/O
  via --body-file / stdin
- pr_create — body input + --push shellout to git
- attach::run_issue, attach::run_comment — explicit bail! on
  missing file

net: 23 verbs touched in the original PR → 17 trimmed back to
no-doc, 6 kept (with the 7th call being attach::run_comment in the
same file). 38 tests still pass.

hive-forge/src/verbs/attach.rs

@@ -26,6 +26,12 @@ pub struct CommentArgs {
     file: PathBuf,
 }
 
+/// # Errors
+///
+/// Returns an error if the input file doesn't exist or can't be
+/// read. Propagates any transport error from the Forgejo REST call
+/// (network unreachable, 4xx/5xx response, token missing/invalid)
+/// and any I/O error from writing the browser download URL to stdout.
 pub fn run_issue(client: &Client, args: IssueArgs) -> Result<()> {
     if !args.file.is_file() {
         bail!(
@@ -42,6 +48,12 @@ pub fn run_issue(client: &Client, args: IssueArgs) -> Result<()> {
     Ok(())
 }
 
+/// # Errors
+///
+/// Returns an error if the input file doesn't exist or can't be
+/// read. Propagates any transport error from the Forgejo REST call
+/// (network unreachable, 4xx/5xx response, token missing/invalid)
+/// and any I/O error from writing the browser download URL to stdout.
 pub fn run_comment(client: &Client, args: CommentArgs) -> Result<()> {
     if !args.file.is_file() {
         bail!(

hive-forge/src/verbs/comment.rs

@@ -21,6 +21,12 @@ pub struct Args {
     body_file: Option<String>,
 }
 
+/// # Errors
+///
+/// Propagates any I/O error from the body input (`--body-file`,
+/// stdin), any transport error from the Forgejo REST call (network
+/// unreachable, 4xx/5xx response, token missing/invalid), and any
+/// I/O error from writing the response to stdout.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     let body = body::resolve_required(args.body.as_deref(), args.body_file.as_deref(), "comment")?;
     let repo = client.repo();

hive-forge/src/verbs/comment_edit.rs

@@ -21,6 +21,12 @@ pub struct Args {
     body_file: Option<String>,
 }
 
+/// # Errors
+///
+/// Propagates any I/O error from the body input (`--body-file`,
+/// stdin), any transport error from the Forgejo REST call (network
+/// unreachable, 4xx/5xx response, token missing/invalid), and any
+/// I/O error from writing the response to stdout.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     let body = body::resolve_required(
         args.body.as_deref(),

hive-forge/src/verbs/issue_create.rs

@@ -24,6 +24,12 @@ pub struct Args {
     assignee: Option<String>,
 }
 
+/// # Errors
+///
+/// Propagates any I/O error from the body input (`--body-file`,
+/// stdin), any transport error from the Forgejo REST call (network
+/// unreachable, 4xx/5xx response, token missing/invalid), and any
+/// I/O error from writing the issue URL to stdout.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     let body = body::resolve(args.body.as_deref(), args.body_file.as_deref())?.unwrap_or_default();
     let repo = client.repo();

hive-forge/src/verbs/issue_edit.rs

@@ -46,6 +46,12 @@ pub struct Args {
     milestone: Option<u64>,
 }
 
+/// # Errors
+///
+/// Propagates any I/O error from the body input (`--body-file`,
+/// stdin), any transport error from the Forgejo REST call (network
+/// unreachable, 4xx/5xx response, token missing/invalid), and any
+/// I/O error from writing the response to stdout.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     // Body is partial: only update the body field if a source was
     // actually given. Piped stdin without --body/--body-file leaves

hive-forge/src/verbs/pr_create.rs

@@ -51,6 +51,13 @@ pub struct Args {
     remote: String,
 }
 
+/// # Errors
+///
+/// Propagates any I/O error from the body input (`--body-file`,
+/// stdin) or the `--push` shellout to git, any transport error from
+/// the Forgejo REST call (network unreachable, 4xx/5xx response,
+/// token missing/invalid), and any I/O error from writing the PR
+/// URL to stdout.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     let body = body::resolve(args.body.as_deref(), args.body_file.as_deref())?.unwrap_or_default();
     if args.push {