Expose project scope in managed local client errors

[sdairs]

Summary

• identify managed local client mode and the canonical current project directory for missing, stopped, and missing-binary failures
• preserve inherited structured error codes while adding safe mode and project fields, concise human guidance, and fixed recovery commands
• cover exact-directory lookup, including empty projects, child directories, explicit names, stopped metadata, and telemetry redaction

Closes #467

Tests

• cargo fmt --all --check
• cargo build -p clickhousectl
• cargo check -p clickhousectl --no-default-features
• cargo test -p clickhousectl (636 unit tests plus all integration suites)
• cargo clippy -p clickhousectl --all-targets -- -D warnings
• cargo clippy -p clickhousectl --no-default-features --all-targets -- -D warnings

Stack

• Position: child 10 of 10 in gh-stack #519
• Base: Expose project scope in local server errors #517 (issue-477-server-project-scope-errors)
• Parent PR should merge first; this PR is not intended to merge independently.

[macroscopeapp]

🟡 Medium local/mod.rs:280

When ServerLock::acquire(server_name) cannot create or open the lock, run_client returns the raw metadata error, so managed-client JSON omits mode and project and human output omits the project-scope recovery guidance. Map this error through with_managed_client_scope(project.clone()) like load_info and is_running.

Suggested change

	let lock = server::ServerLock::acquire(server_name)?;
	let lock = server::ServerLock::acquire(server_name)
	.map_err(|error| error.with_managed_client_scope(project.clone()))?;

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @crates/clickhousectl/src/local/mod.rs around line 280:

When `ServerLock::acquire(server_name)` cannot create or open the lock, `run_client` returns the raw metadata error, so managed-client JSON omits `mode` and `project` and human output omits the project-scope recovery guidance. Map this error through `with_managed_client_scope(project.clone())` like `load_info` and `is_running`.

[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 1eb8e3e. Configure here.}

[cursor]

Managed scope skips lock acquire

Medium Severity

ServerLock::acquire in managed local client is not passed through with_managed_client_scope, unlike recover, load_info, ServerNotFound, is_running, and ServerNotRunning. Lock and permission failures that already produce whitelisted ServerMetadata* errors therefore omit mode, project, and the managed recovery text, even though those variants have dedicated recovery copy in with_managed_client_scope.

Additional Locations (1)

• crates/clickhousectl/src/error.rs#L276-L283

 

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