feat: add auths pair to generated CLI docs and pre-commit hook

- Add `auths pair` to xtask gen-docs command list (primary.md)
- Add gen-docs --check as a pre-commit hook (scoped to CLI/xtask/docs files)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: bordumb

.pre-commit-config.yaml

@@ -35,6 +35,13 @@ repos:
         types: [rust]
         pass_filenames: false
 
+      - id: gen-docs-check
+        name: cargo xtask gen-docs --check
+        entry: cargo xtask gen-docs --check
+        language: system
+        files: (crates/auths-cli/src/|crates/xtask/src/gen_docs|docs/cli/commands/)
+        pass_filenames: false
+
       - id: cargo-deny
         name: cargo deny (licenses + bans)
         entry: bash -c 'cargo deny check > .cargo/cargo-deny.log 2>&1; exit $?'

crates/xtask/src/gen_docs.rs

@@ -29,6 +29,11 @@ const COMMANDS: &[Cmd] = &[
         marker: "auths status",
         doc_file: "docs/cli/commands/primary.md",
     },
+    Cmd {
+        args: &["pair"],
+        marker: "auths pair",
+        doc_file: "docs/cli/commands/primary.md",
+    },
     // --- device ---
     Cmd {
         args: &["device", "link"],

docs/cli/commands/primary.md

@@ -62,3 +62,26 @@ auths status
 | `-q, --quiet` | — | Suppress non-essential output |
 | `--repo <REPO>` | — | Override the local storage directory (default: ~/.auths) |
 <!-- END GENERATED: auths status -->
+
+---
+
+## auths pair
+
+```bash
+auths pair
+```
+
+<!-- BEGIN GENERATED: auths pair -->
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--join <CODE>` | — |  |
+| `--registry <URL>` | — |  |
+| `--no-qr` | — |  |
+| `--timeout <SECONDS>` | — |  |
+| `--offline` | — |  |
+| `--capabilities <CAPABILITIES>` | — |  |
+| `--no-mdns` | — |  |
+| `--json` | — |  |
+| `-q, --quiet` | — |  |
+| `--repo <REPO>` | — |  |
+<!-- END GENERATED: auths pair -->