Make CLI startup lazy and benchmark command paths

[Alek99]

What changed

• Register component, cloud, and deploy through lazy Click command proxies so root CLI discovery does not import their implementations.
• Lazily expose Reflex Base plugin/compiler and SQLAlchemy-aware type helpers while preserving the existing public import surfaces, EAGER_IMPORT behavior, Click metadata, and missing-package help.
• Narrow the frontend dependency cache key to inputs that actually affect package installation.
• Add per-package version-check TTLs, with a shorter retry cooldown after failed checks.
• Add fresh-process CLI benchmarks and update CodSpeed simulation to follow fork/exec subprocesses on the existing Run benchmarks job.

Measured impact

Controlled fresh-process measurements on the same machine:

Metric	main	This branch	Change
reflex --version p50	460.8 ms	66.2 ms	85.6% faster (7.0x)
Root CLI max RSS	147–154 MB	35.1 MB	about 76% lower

Current p50s are 66.2 ms for root help, 66.1 ms for run --help, 67.6 ms for component --help, 78.0 ms for cloud --help, and 68.1 ms for deploy --help.

Validation

• uv run pytest -q tests/units — 8,329 passed, 18 skipped
• uv run pytest -q tests/benchmarks/test_cli.py — 8 passed
• uv run ruff check .
• uv run ruff format --check .
• uv run pyright reflex tests
• Compatibility coverage for lazy command metadata/invocation, missing hosting CLI guidance, plugin exports and eager mode, hybrid properties, version-check caching, and frontend cache invalidation.

Related work

#7049 targets backend/dev-process import overhead. This PR is scoped to CLI command discovery and cold-start latency; the two changes overlap in type/prerequisite tests and may need rebase ordering if both land.

Checklist

• Followed CONTRIBUTING.md.
• Checked existing open pull requests and documented the related overlap above.
• Added tests and performance benchmarks for core changes.
• Ran the unit suite, lint, formatting, and type checks locally.
• Added news fragments for user-visible performance changes.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[cubic-dev-ai]

No issues found across 17 files

_{Re-trigger cubic}

[greptile-apps]

Greptile Summary

This PR reduces cold CLI startup work by lazily resolving selected commands, plugin exports, and optional SQLAlchemy helpers. It also narrows frontend dependency cache inputs, adds per-package version-check cooldowns, and introduces fresh-process CLI benchmarks under CodSpeed simulation.

• Registers component, cloud, and deploy through lazy Click proxies while preserving command metadata and missing-package guidance.
• Defers plugin/compiler and optional SQLAlchemy imports while retaining compatibility exports.
• Keys frontend installation caching on resolved package inputs and lockfile behavior rather than unrelated backend configuration.
• Caches successful version checks for one day and failed attempts for one hour.
• Runs fresh-process CLI benchmarks with subprocess tracking and a workflow-configured timeout.

Confidence Score: 4/5

The code changes appear functionally safe, but the outstanding repository requirement for human-readable comments on the version-check durations must be satisfied before merging.

No new actionable defect was found in the changes since the previous review. The persisted-key finding was manually resolved and is fixed by named constants, while the existing duration-comment finding remains unresolved because the one-day and one-hour timedelta constants still lack the comments required by the repository rule.

Files Needing Attention: reflex/utils/prerequisites.py

Important Files Changed

Filename	Overview
reflex/reflex.py	Adds lazy Click command proxies and defers component and hosting CLI imports until command use.
packages/reflex-base/src/reflex_base/plugins/init.py	Converts plugin package exports to lazy module and attribute resolution while preserving the public surface.
packages/reflex-base/src/reflex_base/utils/types.py	Lazily resolves optional SQLAlchemy property classes and retains wildcard-import compatibility.
reflex/utils/types.py	Re-exports reflex-base type utilities without eagerly resolving the optional property-class tuple.
reflex/utils/js_runtimes.py	Narrows the frontend package installation cache key to dependencies and installation-affecting configuration.
reflex/utils/prerequisites.py	Adds per-package success and failure TTLs; the previously reported duration-comment rule violation remains outstanding.
tests/benchmarks/test_cli.py	Adds fresh-process CLI benchmarks with a configurable subprocess timeout.
.github/workflows/performance.yml	Switches CodSpeed to subprocess-aware simulation and supplies the benchmark timeout through the job environment.

_{Reviews (4): Last reviewed commit: "ci: configure CLI benchmark timeout expl..." | Re-trigger Greptile}

[codspeed-hq]

Merging this PR will not alter performance

✅ 32 untouched benchmarks
⏩ 8 skipped benchmarks¹

---

_{Comparing codex/cli-startup-performance (44661b1) with main (c49a85d)}

Footnotes

1. 8 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[FarhanAliRaza]

Will need to set reflex-base floor on release.

[masenf]

Will need to set reflex-base floor on release.

At least for now, all reflex packages are hard pinned to the matching reflex-base, so that shouldn't be an issue.

That said, it seems like the reflex and reflex-base changes are not actually interdependent...unless i'm missing something