feat(config): select default warehouses per command group

Snowflake targets can set [targets.<name>.warehouses] build and query
warehouses, overridable per invocation with --warehouse. Every CLI
command is classified into the build or query group in one table, so a
command never mixes warehouses. sqb debug and the verbose build header
report the resolved warehouse and its source. Adapters without a session
warehouse reject the settings.

Author: kvlonge

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/audit.md

@@ -26,6 +26,7 @@ sqb --project-dir <path> audit [flags]
 | `--concurrency` | Maximum number of audits to run concurrently (default: `1`) |
 | `--json` | Print structured audit results |
 | `--json-output` | Write structured audit results to a file |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `build` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Concurrency
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/build.md

@@ -54,6 +54,7 @@ sqb --project-dir <path> build [flags]
 | `--manifest` | Generate `target/manifest.json` with plan-aware project metadata |
 | `--select`, `-s` | Select specific models |
 | `--exclude` | Exclude specific models |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `build` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Fast iteration
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/check.md

@@ -24,6 +24,7 @@ sqb --project-dir <path> check [flags]
 | `--json` | Print check results as JSON |
 | `--json-output` | Write check results JSON to a file path |
 | `--vars` | Override project variables |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `build` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 Selecting a non-check node is rejected; use [`sqb build`](build.md) to run tasks and assets.
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/clone.md

@@ -36,6 +36,7 @@ sqb --project-dir <path> clone --from <target> [--to <target>] [flags]
 | `--no-sql-analysis` | Disable compile-time SQL analysis (`--no-sql-validation` is an alias) |
 | `--select`, `-s` | Select specific models to clone |
 | `--exclude` | Exclude specific models from cloning |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `build` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Examples
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/contract.md

@@ -37,6 +37,7 @@ replace conflicts rather than preserving authored declarations.
 | `--vars` | both | Override project variables |
 | `--write` | generate | Apply generated repository changes |
 | `--overwrite` | generate | Replace conflicting declarations; requires `--write` |
+| `--warehouse <name>` | both | Snowflake warehouse for this invocation; overrides the target's `query` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 See [Contracts](../concepts/models/contracts.md#adopting-an-existing-schema) for ownership and safety
 guarantees.

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/dbt.md

@@ -91,3 +91,8 @@ target_path = "../dbt_project/target"
 ```
 
 See [Project Configuration](../concepts/project-configuration.md#dbt) for all fields.
+
+SQLBuild-owned work in `sqb dbt plan`, `run` and `build` connects with the target's `build`
+[warehouse group](../concepts/project-configuration.md#command-group-warehouses). dbt itself
+keeps using the warehouse from its profile. These commands do not accept `--warehouse`, because
+their remaining arguments pass through to dbt.

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/debug.md

@@ -20,16 +20,17 @@ The command runs three groups of checks:
 
 **Runtime** - SQLBuild version, Python version, Python path, OS info.
 
-**Configuration** - Finds and validates `sqlbuild_project.toml`, loads `sqlbuild_local.toml` if present, resolves the adapter and active target.
+**Configuration** - Finds and validates `sqlbuild_project.toml`, loads `sqlbuild_local.toml` if present, resolves the adapter and active target. For Snowflake it also shows the warehouse each [command group](../concepts/project-configuration.md#command-group-warehouses) connects with and where that value came from.
 
-**Connection** - Displays connection settings (secrets are masked), attempts to connect to the warehouse, and runs `SELECT 1` to verify query execution.
+**Connection** - Displays connection settings as `sqb debug` itself uses them, with the `query` warehouse group applied (secrets are masked), attempts to connect to the warehouse, and runs `SELECT 1` to verify query execution.
 
 ## Flags
 
 | Flag | Description |
 |------|-------------|
 | `--no-connection` | Skip the connection and query tests. Useful for validating config without warehouse access. |
 | `--json` | Output results as JSON instead of formatted text. |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `query` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Example
 
@@ -52,6 +53,8 @@ Configuration:
   project: waffle_shop [OK loaded]
   adapter: snowflake [OK found]
   target: dev [OK resolved]
+  build warehouse: BUILD_WH [OK sqlbuild_project.toml [targets.dev.warehouses] build]
+  query warehouse: SQB_WH [OK connection warehouse]
 
 Connection:
   account: FJMQFQV-OJ66172

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/diff.md

@@ -60,6 +60,7 @@ In query mode, omit `FROM:TO` and model selectors; each query identifies its own
 | `--json` | Print one JSON document to stdout |
 | `--select`, `-s` | Select specific models to diff (required in model mode) |
 | `--exclude` | Exclude specific models from diffing |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `query` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Examples
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/freshness.md

@@ -37,6 +37,7 @@ sqb --project-dir <path> freshness [flags]
 | `--no-sql-analysis` | Disable compile-time SQL analysis (`--no-sql-validation` is an alias) |
 | `--select`, `-s` | Select specific sources or models (sources upstream of selected models are included) |
 | `--exclude` | Exclude specific sources or models |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `query` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Source selection
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/cli/janitor.md

@@ -40,6 +40,7 @@ sqb --project-dir <path> janitor [flags]
 | `--retention-days` | Override the configured retention period (days) before a stale relation is archived |
 | `--direct-state-history-versions` | Override how many state-history versions are kept per identity |
 | `--drop-old-name-view <name>` | Drop the [compatibility view](../concepts/models/migrations.md#old-names) at a renamed model's old name before it expires. Repeat for several views. Fails with `C503` if no compatibility view is recorded at the name |
+| `--warehouse <name>` | Snowflake warehouse for this invocation; overrides the target's `build` [warehouse group](../concepts/project-configuration.md#command-group-warehouses) and the connection warehouse |
 
 ## Targets