fix: address code review — remove build-project command, update help text, add stderr test

- Remove `build-project` from command map and switch case in `index.ts`
  (now redundant since `build` without `--model` does the same thing)
- Update `build` help text to reflect optional `--model`
- Remove unused `project` import from `build.test.ts`
- Add test for `format()` stderr error path
- Fix comment alignment in all 5 `altimate-dbt-commands.md` reference files

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: anandgupta42

.opencode/skills/dbt-analyze/references/altimate-dbt-commands.md

@@ -20,7 +20,7 @@ altimate-dbt info                          # Project name, adapter, root
 ## Build & Run
 
 ```bash
-altimate-dbt build                                    # full project build (compile + run + test)
+altimate-dbt build                                  # full project build (compile + run + test)
 altimate-dbt build --model <name> [--downstream]   # build a single model
 altimate-dbt run --model <name> [--downstream]      # materialize only
 altimate-dbt test --model <name>                     # run tests only

.opencode/skills/dbt-develop/references/altimate-dbt-commands.md

@@ -20,7 +20,7 @@ altimate-dbt info                          # Project name, adapter, root
 ## Build & Run
 
 ```bash
-altimate-dbt build                                    # full project build (compile + run + test)
+altimate-dbt build                                  # full project build (compile + run + test)
 altimate-dbt build --model <name> [--downstream]   # build a single model
 altimate-dbt run --model <name> [--downstream]      # materialize only
 altimate-dbt test --model <name>                     # run tests only

.opencode/skills/dbt-docs/references/altimate-dbt-commands.md

@@ -20,7 +20,7 @@ altimate-dbt info                          # Project name, adapter, root
 ## Build & Run
 
 ```bash
-altimate-dbt build                                    # full project build (compile + run + test)
+altimate-dbt build                                  # full project build (compile + run + test)
 altimate-dbt build --model <name> [--downstream]   # build a single model
 altimate-dbt run --model <name> [--downstream]      # materialize only
 altimate-dbt test --model <name>                     # run tests only

.opencode/skills/dbt-test/references/altimate-dbt-commands.md

@@ -20,7 +20,7 @@ altimate-dbt info                          # Project name, adapter, root
 ## Build & Run
 
 ```bash
-altimate-dbt build                                    # full project build (compile + run + test)
+altimate-dbt build                                  # full project build (compile + run + test)
 altimate-dbt build --model <name> [--downstream]   # build a single model
 altimate-dbt run --model <name> [--downstream]      # materialize only
 altimate-dbt test --model <name>                     # run tests only

.opencode/skills/dbt-troubleshoot/references/altimate-dbt-commands.md

@@ -20,7 +20,7 @@ altimate-dbt info                          # Project name, adapter, root
 ## Build & Run
 
 ```bash
-altimate-dbt build                                    # full project build (compile + run + test)
+altimate-dbt build                                  # full project build (compile + run + test)
 altimate-dbt build --model <name> [--downstream]   # build a single model
 altimate-dbt run --model <name> [--downstream]      # materialize only
 altimate-dbt test --model <name>                     # run tests only

packages/dbt-tools/src/index.ts

@@ -11,10 +11,9 @@ const USAGE = {
     info: "Get project info (paths, targets, version)",
     compile: "Compile a model (Jinja to SQL) --model <name>",
     "compile-query": "Compile a raw query --query <sql> [--model <name>]",
-    build: "Build a model --model <name> [--downstream]",
+    build: "Build project, or a single model with --model <name> [--downstream]",
     run: "Run a model --model <name> [--downstream]",
     test: "Test a model --model <name>",
-    "build-project": "Build entire project",
     execute: "Execute SQL --query <sql> [--model <name>] [--limit <n>]",
     columns: "Get columns of model --model <name>",
     "columns-source": "Get columns of source --source <name> --table <name>",
@@ -171,9 +170,6 @@ async function main() {
       case "test":
         result = await (await import("./commands/build")).test(adapter, rest)
         break
-      case "build-project":
-        result = await (await import("./commands/build")).project(adapter)
-        break
       case "execute":
         result = await (await import("./commands/execute")).execute(adapter, rest)
         break

packages/dbt-tools/test/build.test.ts

@@ -1,5 +1,5 @@
 import { describe, test, expect, mock } from "bun:test"
-import { build, project } from "../src/commands/build"
+import { build } from "../src/commands/build"
 import type { DBTProjectIntegrationAdapter } from "@altimateai/dbt-integration"
 
 function makeAdapter(overrides: Partial<DBTProjectIntegrationAdapter> = {}): DBTProjectIntegrationAdapter {
@@ -44,4 +44,14 @@ describe("build command", () => {
       plusOperatorRight: "+",
     })
   })
+
+  test("build surfaces stderr as error", async () => {
+    const adapter = makeAdapter({
+      unsafeBuildProjectImmediately: mock(() =>
+        Promise.resolve({ stdout: "partial output", stderr: "compilation error" }),
+      ),
+    })
+    const result = await build(adapter, [])
+    expect(result).toEqual({ error: "compilation error", stdout: "partial output" })
+  })
 })