From 527dff0200edaf4d90b2cefa20e3b5f73e8c4677 Mon Sep 17 00:00:00 2001
From: damocles <damocles@hyperhive.local>
Date: Wed, 24 Jun 2026 23:28:58 +0200
Subject: [PATCH] feat(#1985): add # Errors doc to subscription run (argus
 review)

---
 hive-forge/src/verbs/subscription.rs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/hive-forge/src/verbs/subscription.rs b/hive-forge/src/verbs/subscription.rs
index abc0467e..2c6a51fd 100644
--- a/hive-forge/src/verbs/subscription.rs
+++ b/hive-forge/src/verbs/subscription.rs
@@ -32,6 +32,13 @@ pub struct Args {
     list: bool,
 }
 
+/// Run the `subscription` verb: `--list` all watched repos, set the
+/// current repo's watch (`--watch` / `--ignore` / `--unwatch`), or get
+/// its current state.
+///
+/// # Errors
+/// Propagates transport / non-2xx errors from the Forgejo client calls
+/// (`get_json` / `put_json` / `delete`) and from `print_json`.
 pub fn run(client: &Client, args: Args) -> Result<()> {
     if args.list {
         // List every repo the authed user watches, so an agent can audit