fix(cli): umbrella CLI standardization slice 5 — mounts, dedupe, completion group, categorized help

[ywatanabe1989]

Slice 5 of the CLI-standardization plan (scitex-dev proposal 2026-0707-cli-standardization.md; slices 1-4 landed in scitex-dev as #306/#307/#308/#310). Four logical commits, verified against the real CLI from this branch (PYTHONPATH=<worktree>/src, /opt/venv-sac interpreter).

1. Fix broken mounts (writer crash, scholar missing)

• scitex writer --help crashed (AttributeError: 'function' object has no attribute 'make_context'): the generic registry probe picked up scitex_writer._cli.main — a plain console-script function — instead of the click group. New doctrine §5b re-export shim scitex/cli/writer.py mounts scitex_writer._cli.main_group, and LazyGroup._load_lazy now skips any probed attribute that is not a click command, so this crash class is closed for every peer.
• scitex scholar was not mounted: no probe shape matched the standalone entry point scitex_scholar._cli_main:cli. Added that probe.

Verified: scitex writer --help and scitex scholar --help both exit 0 and render the standalone groups.

2. Dedupe duplicate namespaces

notify→notification, verify→clew, events→event, socialia→social. The old names are no longer registered; when scitex-dev ships click_compat (present in the repo, not yet in the released 0.21.0) they come back as hidden warn-phase deprecated aliases that forward to the canonical command (3-phase ladder, removed in v3.0); with an older scitex-dev they are simply excluded.

• events was a dead entry: the scitex-events peer ships no CLI, so scitex events appeared in help but failed on invocation.
• figrecipe/plt is intentionally kept: scitex-plt is a published identity-alias package (scitex_plt is figrecipe → True) and doctrine §5b's brand table documents scitex plt as a figrecipe mount. figrecipe is canonical; plt self-describes as "(alias for figrecipe)".

3. Canonical completion noun group (doctrine §1b, amended 2026-07-07)

• Moved out of main.py into scitex/cli/completion.py (lazily mounted; main.py drops to 276 lines).
• Bare scitex completion now shows group help — it no longer silently auto-installs.
• completion install gains --dry-run (prints target rc file + script, writes nothing) — subsumes the old bash/zsh/fish script-dump leaves, which remain as hidden warn-phase deprecated leaves (still print the script, warn on stderr, removed in v3.0).
• completion status unchanged.

4. Root help: categories, -V, real one-liners

• Root help renders the doctrine §4a fixed ordered headers (Core / Data & Sync / Service / Diagnostics / Introspection / Shell; Other catch-all stays empty). Implemented inside LazyGroup.format_commands — scitex-dev's CategorizedGroup resolves real command objects, which would defeat the lazy mount and reintroduce the ~45 s cold start, hence the local implementation following the same seven-category order.
• -V added as the short form of --version.
• ~25 mounted groups whose one-liner degraded to the bare package name when the peer wasn't installed (dataset dataset, git git, hpc hpc, ...) now fall back to curated one-liners sourced from each package's own pyproject description.

Tests

tests/scitex/cli/{test_main,test_completion,test__lazy_subcommands}.py — 84 passed, 2 skipped (the two skips are the click_compat-gated alias-forward tests; that helper is not in the released scitex-dev yet). Existing tests/scitex/test___main__.py and tests/scitex/cli/test___init__.py still green.

Notes / follow-ups

• src/scitex/cli/scholar/ (in-tree scholar implementation) is a pre-existing parallel implementation of the standalone scholar CLI; it keeps its own tests and is untouched here. Reconciling it with the standalone (doctrine §5b single-source rule) is a follow-up.
• The socialia registry record should eventually get umbrella_subcommand: "social" in scitex-dev; src/scitex/cli/social.py is also a §5b-forbidden subprocess wrapper — out of scope here.
• develop CI is currently red from a pre-existing py3.13 pytest segfault (run 28854068590), unrelated to this change.

🤖 Generated with Claude Code