Make omitted local server selection deliberate

[sdairs]

Summary

• preserve omitted ClickHouse server names through clap and dispatch while retaining positional and compatibility --name forms
• make bare project-scoped server stop prefer an existing default, otherwise select the sole known ClickHouse server, succeed as a no-op with none, and require a name or stop-all with multiple non-default servers
• keep bare server remove conservative: remove only an existing default, never infer a custom server, and return safe available-state guidance
• distinguish implicit selection failures from explicit unknown-name typos in human and structured JSON output without expanding the bounded local error-code taxonomy
• document the stop/remove policy and update the structured-error example

Closes #473

Tests

• isolated subprocess coverage for zero, one, many, default, custom, running, stopped, Postgres-only, positional, and compatibility --name states
• cargo fmt --all --check
• cargo build -p clickhousectl
• cargo check -p clickhousectl --no-default-features
• cargo test -p clickhousectl
• cargo clippy -p clickhousectl --all-targets -- -D warnings

Stack

• Position: child 7 of 7 in gh-stack #489
• Base: Emit structured local runtime errors in JSON mode #510 (issue-475-local-structured-errors)
• Parent PR is unchanged and should merge first.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit ebf0cbb. Configure here.}

[cursor]

Postgres leftovers miscounted as ClickHouse

High Severity

list_clickhouse_server_names treats any servers/*/data directory as ClickHouse unless that exact name already has Postgres metadata. A failed local postgres start removes the .json file but leaves the {name}-pg{major}/data directory, so that leftover is counted as ClickHouse. Omitted server stop then falsely reports multiple non-default servers (or “already stopped” for the Postgres dir) even when server list shows only the real ClickHouse instance.

Additional Locations (1)

• crates/clickhousectl/src/local/mod.rs#L773-L829

 

^{Reviewed by Cursor Bugbot for commit ebf0cbb. Configure here.}