hive-forge: say which flat forms were removed and which are staying

`docs/tools/forge.md` said the flat forms "still work as hidden
back-compat aliases" and named `pr-create` and `pr-status` as its
examples. Both refuse now: nine flat verbs parse only far enough to
print the namespaced form that replaced them.

The doc had no way to be read correctly, because the seven that do still
work are hidden too and `--help` shows neither group. Naming the split
here is the only place the difference is visible.

At the enum the kind-agnostic seven now read as staying rather than as
"still work", and `credential-helper` is marked as belonging to neither
group: it is hidden because git invokes it, so a sweep reading
`hide = true` as "deprecated" would remove checkout auth.

Refs #3974.
This commit is contained in:
atlas 2026-09-03 01:57:53 +02:00 committed by mara
commit 529e9416c1
2 changed files with 21 additions and 7 deletions

View file

@ -71,10 +71,15 @@ enum Verb {
// no `issue <verb>` form, so a caller holding just a number can be
// sent somewhere unambiguous.
// - **Kind-agnostic** (`view`, `comment`, `comments`, `close`,
// `assign`, `labels`, `timeline`, …) still work. Each exists as both
// `issue <verb>` and `pr <verb>`, so there is no single replacement
// to send a caller to when all they hold is a number — refusing
// these would remove a capability rather than rename one.
// `assign`, `labels`, `timeline`) **stay** — hidden, not deprecated.
// Each exists as both `issue <verb>` and `pr <verb>`, so there is no
// single replacement to send a caller to when all they hold is a
// number: refusing these would remove a capability rather than
// rename one.
//
// `credential-helper` is hidden for a third reason and is in neither
// group — git invokes it, no human does. A sweep that reads
// `hide = true` as "deprecated" would take out checkout auth.
/// Dump title + body + all comments for an issue or PR.
#[command(hide = true)]
View(verbs::view::Args),