Summary

Fixes #1974. vibetuner worker-health paid the full CLI/app bootstrap before it ever read the streaq health key. The console script was vibetuner.cli:app, so importing the CLI package eagerly imported every sub-command and ran load_app_config(), which imports the user's entire tune.py (config, BlobService, rate limiter). On a real deploy that bootstrap takes ~5s, so every probe was killed at the scaffolded healthcheck's timeout: 5s (ExitCode -1) before the check logic ran, and a healthy worker flapped to permanently unhealthy.

Fix

This is the issue's suggested fix #1 (lightweight fast path), done at the root cause — the entry point.

• The console entry is now vibetuner.cli:main. main() dispatches worker-health straight to a lightweight check before the heavy Typer app is imported.
• New vibetuner/cli/health.py holds the check: it imports only vibetuner.config and a Redis client, then reads the streaq:{queue}:health:* key. Same exit-code contract as before.
• The full Typer app (every command + the user CLI via load_app_config()) moved to vibetuner/cli/root.py, built lazily. vibetuner.cli.__init__ stays tiny and re-exposes app/AsyncTyper lazily via __getattr__ for existing importers.
• python -m vibetuner now routes through main() too, so the fast path applies there as well.
• Template pyproject.toml.j2 entry point bumped to vibetuner.cli:main so new scaffolds get the fast path.

The healthcheck now returns in well under a second, comfortably inside the existing 5s timeout — no timeout bump needed (issue suggestion #2 left untouched).

Verification

• uv run vibetuner worker-health and python -m vibetuner worker-health complete in ~0.4s; the fast path does not import vibetuner.cli.root, scaffold, or copier (verified via a fresh-interpreter regression test).
• version and all other commands still build the full app unchanged.
• Full unit suite green (961 passed), including the existing 4 worker-health tests plus a new fast-path regression test.

Docs

• cli-reference.md notes the fast-path behavior for ops users tuning healthcheck timeouts.

🤖 Generated with Claude Code