ci(#1555): prose-ify legacy tracker tags; add lint:allow escape hatch

Clean the legacy backlog so the tracker-tag lint can become a required
gate (mara's warn-during-cleanup -> full-tree-enforcement path). Rewrite
the ~33 real `closes/see #NNN` provenance refs in doc-comments to prose
across hive-forge, hive-c0re, hive-ag3nt, hive-matrix-mcp, hive-sh4re,
and add a `lint:allow` line marker to check-issue-refs.sh for genuine
non-tracker `#<digits>` (a hash-digit heading-detection test input).
Tree is now lint-clean; tracker-tag lint ready to promote to required.
This commit is contained in:
atlas 2026-06-10 01:40:57 +02:00 committed by mara
commit ab1b07acce
23 changed files with 55 additions and 47 deletions

View file

@ -8,7 +8,7 @@
//! Single binary with verb subcommands. Replaces the prior bash
//! script (`hive-forge-tools.nix`) so that agents and operators get
//! the same error handling, exit codes, and JSON shapes regardless
//! of how the bash mood was that day (closes #280).
//! of how the bash mood was that day.
#![warn(missing_docs)]
// Clap-derived `Args` structs are intentionally consumed by their
@ -26,7 +26,7 @@ use clap::{Parser, Subcommand};
#[derive(Parser)]
#[command(
name = "hive-forge",
about = "Forgejo CLI wrapper for hyperhive (closes #280)",
about = "Forgejo CLI wrapper for hyperhive",
disable_help_subcommand = true
)]
struct Cli {
@ -36,7 +36,7 @@ struct Cli {
#[arg(short = 'r', long, global = true)]
repo: Option<String>,
/// Emit JSON output instead of the verb's default human-readable
/// shape, for verbs that support both (closes #421). Verbs whose
/// shape, for verbs that support both. Verbs whose
/// only output is already JSON (`issue`, `pr`, etc.) ignore this
/// flag — they always print JSON regardless.
#[arg(long, global = true)]
@ -100,7 +100,7 @@ enum Verb {
Subscription(verbs::subscription::Args),
/// List timeline events on an issue or PR (closes, label adds,
/// assignments, commit refs, pushes, etc.) — the audit trail
/// `view` + `comments` don't surface (closes #783).
/// `view` + `comments` don't surface.
Timeline(verbs::timeline::Args),
/// Upload a file as an attachment to an issue.
AttachIssue(verbs::attach::IssueArgs),