docs(functions): merge remaining manual-only facts into headers

Word-level diff of every manual entry against its generated counterpart
surfaced 546 tokens present in the manual and absent from the header —
losses reconcile.py missed, because it compared description length and
these headers are longer overall thanks to ARGUMENTS/RETURNS.

Merged the substantive ones (546 -> 202 residual tokens, the remainder
being synonym drift). Notable real fixes:

- git-clean: -f/--force was missing from ARGUMENTS entirely
- pkg: per-package-manager query table
- qc: cli-role rationale, role paths, --role passthrough
- config-help: site URL, xdg-open, man page path, case-insensitivity
- agents-init: idempotency, .gitignore paths, upstream pull, wrapper callers
- smart_exit: exit-builtin wiring note, $SCROLLBACK_HISTORY_DIR

The manual's claim that claude/agy pass `agents-init --agents` is stale;
both pass `--quiet` (full setup). Header wins, manual dropped.

functions/auto-pull.fish

@@ -15,8 +15,9 @@
 #   background fast-forwarded when you enter them (see conf.d/auto-pull.fish
 #   and _auto_pull_sync). The fish-config repo is always covered as a baseline
 #   and does not need to be added. The registry is a plain text file, one
-#   absolute git-toplevel path per line, stored machine-locally in
-#   ~/.config/.user-dots/fish/auto-pull.list (never committed to the config).
+#   absolute git-toplevel path per line, stored machine-locally at
+#   $__fish_user_dots_path/auto-pull.list (defaults to
+#   ~/.config/.user-dots/fish/auto-pull.list) and never committed.
 #
 #   Registry management works regardless of the C2 auto-execution guard; only
 #   the background sync itself is gated by __fish_config_op_autoexec.
@@ -25,7 +26,7 @@
 #   list               Show registered repos (default when no subcommand given)
 #   add [PATH]         Register PATH's git root; defaults to the current repo
 #   remove <NAME|PATH> Unregister by basename or exact path
-#   status             Show whether auto-pull is enabled and the registry path
+#   status             Show enabled/disabled state, repo count, and registry path
 #   -h, --help         Show this help message
 #
 # RETURNS