[User Story] Harden CLI command guidance, command inventory, and package-manager runtime checks

[djm81]

User Story

As a SpecFact CLI adopter working in a heterogeneous Python environment, I want command errors, command docs, generated command inventories, upgrade repair, and package-manager runtime checks to reflect the actual installed CLI so I can trust guidance from docs, prompts, and AI agents.

Parent Features

• [Feature] CLI Behavior Validation Suite #375 CLI Behavior Validation Suite
• [Feature] Documentation & Discrepancy Remediation #356 Documentation & Discrepancy Remediation
• [Feature] Marketplace Module Distribution #353 Marketplace Module Distribution
• [Feature] Developer Workflow & CI Pipeline #355 Developer Workflow & CI Pipeline
• [Feature] Code Review Analysis Runners #404 Code Review Analysis Runners

Source Tracking

• Fixes core ownership for CLI UX: unknown command error for specfact hello should suggest next steps #585.
• Owns the core side of sync bridge reports specfact-project module missing immediately after successful install check #587, Docs outdated: core-cli modes page shows old code import syntax (--repo no longer valid) #588, Semgrep diagnostic reports disabled even when semgrep is installed via uv #590.
• Fixes Upgrade flow misdetects pipx when launched via uv run #589.
• Fixes specfact upgrade succeeds but pipx launcher can stay stale/broken #593.
• Coordinates module-side follow-up for specfact project regenerate crashes with NoneType during bundle processing #586, Backlog auth command group errors with "Missing command" when invoked directly #591, Inconsistent backlog CLI UX: daily works from adapter defaults, delta status requires project-id and reports undocumented repo requirements #592 in nold-ai/specfact-cli-modules.

Acceptance Criteria

• Unknown commands, missing subcommands, and missing required parameters show relevant help plus actionable missing/invalid information.
• Core publishes deterministic generated command overview artifacts for humans and AI agents.
• Docs, prompts, templates, and code guidance are validated against the generated command contract.
• CI blocks PRs on uv, pip, pipx, and hatch runtime mismatches.
• Upgrade and semgrep diagnostics prefer the effective active environment over stale global package-manager inventory.
• Pipx upgrades validate the installed specfact launcher and repair stale/broken pipx shims with pipx reinstall specfact-cli.

OpenSpec

• Change: tester-cli-reliability