From 8895bfc63f45ecb56855c1f165f9d7f3ccb35e0e Mon Sep 17 00:00:00 2001 From: atlas Date: Tue, 27 Oct 2026 14:30:53 +0100 Subject: [PATCH] document the cycle refusal in dependency add help --- docs/tools/forge-cli.md | 8 ++++++-- hive-forge/src/verbs/dependency.rs | 4 ++++ 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/tools/forge-cli.md b/docs/tools/forge-cli.md index 9c588470..8e6610f6 100644 --- a/docs/tools/forge-cli.md +++ b/docs/tools/forge-cli.md @@ -370,7 +370,9 @@ List dependencies (default when you give no action) — the issues/PRs blocking ## `hive-forge issue dependency add` -Add one or more issues/PRs that block this one +Add one or more issues/PRs that block this one. + +The command refuses an add that would close a cycle, directly or through other issues, before it sends any request, and the error names the existing path. **Usage:** `hive-forge issue dependency add [DEPS]...` @@ -833,7 +835,9 @@ List dependencies (default when you give no action) — the issues/PRs blocking ## `hive-forge pr dependency add` -Add one or more issues/PRs that block this one +Add one or more issues/PRs that block this one. + +The command refuses an add that would close a cycle, directly or through other issues, before it sends any request, and the error names the existing path. **Usage:** `hive-forge pr dependency add [DEPS]...` diff --git a/hive-forge/src/verbs/dependency.rs b/hive-forge/src/verbs/dependency.rs index ff2d7ece..7142d217 100644 --- a/hive-forge/src/verbs/dependency.rs +++ b/hive-forge/src/verbs/dependency.rs @@ -34,6 +34,10 @@ enum Action { /// issues/PRs blocking this one. List, /// Add one or more issues/PRs that block this one. + /// + /// The command refuses an add that would close a cycle, directly or + /// through other issues, before it sends any request, and the error + /// names the existing path. Add { /// Issue/PR numbers to add as dependencies. deps: Vec,