Extract cloud runtime dispatch and shared helpers from main.rs

[sdairs]

Closes #383

Summary

• Move cloud authentication, client construction, OAuth write guarding, dispatch, and CloudError adaptation into cloud::run.
• Move managed Postgres dispatch into its domain module and remove cloud-domain imports from main.rs.
• Keep agent detection/final JSON resolution at the top level and pass the resolved mode into the cloud runtime.
• Add shared organization, enum/tag, and date/time parsing helpers to remove Postgres backward dependencies.

Tests

• cargo fmt --all
• cargo check --workspace --all-features
• cargo test -p clickhousectl
• cargo clippy -p clickhousectl --all-targets -- -D warnings

[Copilot]

Pull request overview

This PR refactors the ClickHouse Cloud command runtime in the clickhousectl CLI crate by extracting cloud authentication/client setup, OAuth write-guarding, command dispatch, and CloudError → top-level error adaptation out of main.rs and into crate::cloud::run, establishing a clearer runtime boundary for future domain moves.

Changes:

• Delegate the top-level cloud command from main.rs to cloud::run, keeping JSON-mode resolution (flag + agent detection) at the top level.
• Introduce cloud::run + cloud::dispatch in src/cloud/mod.rs, moving over auth/client construction, OAuth write rejection, and CloudError/exit-code preservation logic (with tests).
• Add cloud::shared helpers (org resolution, enum/tag parsing, date/time parsers) and update Postgres + cloud CLI/commands to use them; move Postgres dispatch into cloud::postgres::run.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
crates/clickhousectl/src/main.rs	Removes inlined cloud runtime/dispatch and delegates Commands::Cloud to cloud::run after resolving JSON mode.
crates/clickhousectl/src/cloud/mod.rs	Adds cloud::run + dispatch, plus error adaptation and tests, centralizing cloud runtime behavior outside main.rs.
crates/clickhousectl/src/cloud/shared.rs	New internal shared helpers for org resolution, tag/enum parsing, and date/time clap parsers to avoid domain back-dependencies.
crates/clickhousectl/src/cloud/postgres.rs	Moves Postgres dispatch into postgres::run and switches to shared helpers.
crates/clickhousectl/src/cloud/commands.rs	Replaces local helper implementations with imports from cloud::shared.
crates/clickhousectl/src/cloud/cli.rs	Switches date/time clap parsers to cloud::shared.
crates/clickhousectl/src/cli.rs	Stops re-exporting cloud domain enums/args; keeps only what’s needed for top-level CLI assembly.
AGENTS.md	Updates contributor docs to reflect the new cloud runtime/dispatch structure (cloud::run, cloud::dispatch, postgres::run).

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[iskakaushik]

LGTM