From 6c3741178168d6383f3d8fc6abd40a01fefc3c28 Mon Sep 17 00:00:00 2001 From: atlas Date: Thu, 10 Sep 2026 16:19:59 +0200 Subject: [PATCH] regenerate the hive-forge CLI reference The doc-comment sweep changed --help text, so the generated reference went stale and hive-forge-docs-fresh caught it. Regenerated with the command the check itself prints; the diff is five lines, all propagations of the sweep. Kept as its own commit rather than an amend: argus approved d090a9fb, and a force-push clears both the verdict and the review request. Refs #4155 --- docs/tools/forge-cli.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/tools/forge-cli.md b/docs/tools/forge-cli.md index 35d28bd2..857817ef 100644 --- a/docs/tools/forge-cli.md +++ b/docs/tools/forge-cli.md @@ -98,7 +98,7 @@ Forgejo CLI wrapper for hyperhive * `pr` — PR-scoped commands: `pr …` * `comment-show` — Print the body (or full JSON) of a single comment by id * `comment-edit` — Edit an existing comment by id -* `clone` — Clone a forge repo (default `-r`/`HIVE_FORGE_REPO`) with credentials autoinjected. Pairs with `pr-create --agit` +* `clone` — Clone a forge repo (default `-r`/`HIVE_FORGE_REPO`) with credentials autoinjected. Pairs with `pr create --agit` * `repo-create` — Create a forge repo under the current user (or `--org`). Prints the repo URL * `repo-add-collaborator` — Add a collaborator to the active repo (`-r`/`HIVE_FORGE_REPO`) with a permission level. Companion to `repo-create` * `repo-labels` — List every label defined on the repo (name + description), optionally filtered by a name substring @@ -540,7 +540,7 @@ Create a pull request * `--remote ` — Remote to push to (default: `forge`, or `origin` in `--agit` mode) * `--agit` — Open the PR via Forgejo's `AGit` flow instead of pushing a branch — works for read-only collaborators. Run from inside a cloned repo * `--topic ` — `AGit` topic — groups repeated pushes into one PR (re-run with the same topic to update it). Defaults to the branch name. Only meaningful with `--agit` -* `--label ` — Label name to attach, repeatable (for example `--label area/ops --label type/bug`). Same spelling `labels add` accepts — an unresolved name errors out rather than silently attaching fewer labels than asked for. In `--agit` mode `pr-create` applies this as a follow-up call once it learns the PR number (the `AGit` push itself has no label field), so it silently skips them (not a label-resolution error) if it couldn't parse the PR URL back out of the push output — same fallback as the deferred multi-line body +* `--label ` — Label name to attach, repeatable (for example `--label area/ops --label type/bug`). Same spelling `labels add` accepts — an unresolved name errors out rather than silently attaching fewer labels than asked for. In `--agit` mode `pr create` applies this as a follow-up call once it learns the PR number (the `AGit` push itself has no label field), so it silently skips them (not a label-resolution error) if it couldn't parse the PR URL back out of the push output — same fallback as the deferred multi-line body @@ -956,7 +956,7 @@ Edit an existing comment by id ## `hive-forge clone` -Clone a forge repo (default `-r`/`HIVE_FORGE_REPO`) with credentials autoinjected. Pairs with `pr-create --agit` +Clone a forge repo (default `-r`/`HIVE_FORGE_REPO`) with credentials autoinjected. Pairs with `pr create --agit` **Usage:** `hive-forge clone [OPTIONS] [DEST]` @@ -1338,7 +1338,7 @@ Download a CI Actions artifact from a run (` --run `). Saves a zip, or ###### **Options:** -* `--run ` — Workflow run number — the `runs/` in the run-page URL, which `pr-status` surfaces as a CI context's `target_url`. (This is the per-repo run number, not the global run id; the verb translates.) +* `--run ` — Workflow run number — the `runs/` in the run-page URL, which `pr status` surfaces as a CI context's `target_url`. (This is the per-repo run number, not the global run id; the verb translates.) * `-o`, `--output ` — Output path. Defaults to `/tmp/forge-artifact-.zip` (Forgejo serves artifacts zipped). Pass `-` to stream raw bytes to stdout @@ -1351,7 +1351,7 @@ Print a CI Actions run's job step logs (`--run [--job i] [--step i]`) ###### **Options:** -* `--run ` — Workflow run number — the `runs/` in the run-page URL (shown by `pr-status`) +* `--run ` — Workflow run number — the `runs/` in the run-page URL (shown by `pr status`) * `--job ` — Job index within the run (0-based, default 0) Default value: `0`