[sdairs]

Part of #1173 (6 of 6: models/clickstack). Stacked on #1180.

Summary

This splits src/models/clickstack.rs (6.7k lines) into src/models/clickstack/ and moves src/models/clickstack_enums.rs in as clickstack/enums.rs. Behaviour and the public surface are unchanged. mod.rs glob re-exports every submodule, so every crate-root and models::* path still resolves.

I chose the seams from the type-reference graph, starting at the request and response types of each Client method. Each resource's types are reachable only from that resource. Dashboard-only types are split into dashboards.rs and tiles.rs. The only types that alerts and dashboards share stay in mod.rs.

File	Lines	Contents
mod.rs	340	mod/pub use facade, plus the chart building blocks that alert and tile chart configs share: SelectItem, Formula, NumberFormat, BackgroundChart, NumberTileColorCondition and the between/equality/numeric colour conditions
alerts.rs	1469	alert request/response, channels, Alert*ChartConfig unions and their builder/raw-SQL variants, silenced/execution-error, overlay
dashboards.rs	806	dashboard create/update/response, containers and tabs, the Filter unions (query-expression, Prometheus label, source, static list), saved filter values (SQL and variable), validate-dashboard response
tiles.rs	2393	TileInput/TileOutput, TileConfig, every dashboard chart config (bar, categorical bar, line, stacked line, number, pie, table, heatmap, markdown, search, event patterns) and series, on-click types
sources.rs	1162	Source union; log, trace, metric, session and PromQL sources; materialized views, highlighted attributes, filter settings; connections
saved_searches.rs	75	saved search, input, filters
webhooks.rs	221	Webhook union and its variants, webhook input, validate-webhook response
roles.rs	284	role create/update, CASL permissions (ClickHouse and MongoDB conditions)
enums.rs	3303	git mv of clickstack_enums.rs, unchanged

Commits

1. Pure git mvs, plus the minimal edit to compile. clickstack.rs → clickstack/mod.rs (99%) and clickstack_enums.rs → clickstack/enums.rs (100%), so blame follows both files. In mod.rs, use super::clickstack_enums::* becomes mod enums; pub use enums::*;. models.rs drops mod clickstack_enums and its re-export.
2. Moves only. A script cut the items out at top-level boundaries and kept each file in the original order. Each union's trailing Default impl moved with its type. I compared the sorted line multisets before and after this commit. No line was removed, and the only added lines are mod, pub use and use lines. One of those is a #[cfg(doc)] import in alerts.rs, so the alert chart configs' rustdoc links to their tile counterparts still resolve (cargo doc -D warnings is clean). Review it with git show --color-moved=dimmed-zebra.
3. Classifier. Every new models/clickstack/*.rs maps to NO_SUITES, as both parents did. The old paths stay mapped, as the classifier requires for deleted files. The install classifier needs no change.
4. .git-blame-ignore-revs entry for commit 2. This SHA must be updated if the stack is rebased before merge.
5. Docs. The crate's AGENTS.md layout section and the README layout table now describe src/models/clickstack/.

Visibility widenings

None. Every moved item was already pub. Submodules import shared types explicitly from super and the enums through super::enums::*.

Tests

• Counts match before and after: 916 tests listed (887 passed, 29 ignored). The full sorted --list output is identical, module paths included. spec_coverage_test and model_facade_test pass untouched.
• python3 scripts/check-openapi-drift.py --dry-run reports the same findings before and after (0 actionable).
• cargo fmt --all, both clippy configurations, cargo check -p clickhousectl --no-default-features, cargo check --workspace --all-features, cargo test -p clickhouse-cloud-api -p clickhouse-openapi-analyzer and the Python classifier tests all pass.

Merge with a merge commit, not a squash. The .git-blame-ignore-revs entry names this PR's move commit. A squash merge would leave it pointing at a commit that isn't on main, and git would silently ignore it.

🤖 Generated with Claude Code

---

Note

Low Risk
Mechanical file moves and re-exports with no serde or type surface changes; risk is limited to merge/rebase hygiene for blame-ignore metadata.

Overview
Reorganizes the large monolithic ClickStack model layer into src/models/clickstack/, mirroring the existing clickpipes/ split pattern without changing API behavior or public paths.

clickstack.rs and clickstack_enums.rs become a directory: shared chart primitives stay in mod.rs, while alerts, dashboards, tiles, sources, saved searches, webhooks, roles, and enums live in dedicated modules re-exported through the facade. models.rs drops the separate clickstack_enums module; pub use clickstack::* still exposes the same crate-root types.

Supporting updates only: .git-blame-ignore-revs for the move commit, AGENTS.md / README layout notes, and the cloud integration classifier (new models/clickstack/*.rs paths mapped to NO_SUITES).

^{Reviewed by Cursor Bugbot for commit 5d5996b. Bugbot is set up for automated code reviews on this repo. Configure here.}