fix: address CodeRabbit review comments

1. Replace `process.exit()` with `process.exitCode` + `return` so the
   outer `finally` block in `index.ts` can run `Telemetry.shutdown()`.

2. Preserve A-F grade value from `altimate_core.grade` response in
   `CheckCategoryResult` metadata (`grade`, `score` fields).

3. Skip DB migration for `check` command — it only needs `Dispatcher`
   and has zero database dependencies. Prevents startup failure on
   read-only CI environments and removes multi-minute overhead.

4. Remove unused `--dialect`, `--dbt-project`, `--manifest` from docs
   options table (code already removed in prior commit).

5. Add `text` language specifier to fenced code block in `check.md`.

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

Author: anandgupta42

docs/docs/usage/check.md

@@ -67,11 +67,8 @@ altimate-code check --checks lint
 | `--checks`      | string   | `lint,safety` | Comma-separated list of checks to run                     |
 | `--schema`      | string   | -             | Path to schema file for validation context                |
 | `--policy`      | string   | -             | Path to policy JSON file (required for `policy` check)    |
-| `--dialect`     | string   | -             | SQL dialect (`snowflake`, `bigquery`, `postgres`, etc.)   |
 | `--severity`    | string   | `info`        | Minimum severity level to report: `info`, `warning`, `error` |
 | `--fail-on`     | string   | `none`        | Exit 1 if findings at this level or above: `none`, `warning`, `error` |
-| `--dbt-project` | string   | -             | Path to dbt project directory                             |
-| `--manifest`    | string   | -             | Path to dbt `manifest.json`                               |
 
 ---
 
@@ -151,7 +148,7 @@ When using `--format json`, the command writes structured JSON to stdout (diagno
 
 The default `text` format is designed for human consumption:
 
-```
+```text
 Checked 3 file(s) with [lint, safety]
 
 --- LINT ---

packages/opencode/src/cli/cmd/check.ts

@@ -233,7 +233,11 @@ async function runSemantic(sql: string, file: string, schemaPath?: string): Prom
   }
 }
 
-async function runGrade(sql: string, file: string, schemaPath?: string): Promise<Finding[]> {
+async function runGrade(
+  sql: string,
+  file: string,
+  schemaPath?: string,
+): Promise<{ findings: Finding[]; grade?: string; score?: number }> {
   try {
     const result = await Dispatcher.call("altimate_core.grade", {
       sql,
@@ -243,7 +247,7 @@ async function runGrade(sql: string, file: string, schemaPath?: string): Promise
     const issues = (result.data.issues ?? result.data.findings ?? result.data.recommendations ?? []) as Array<
       Record<string, unknown>
     >
-    return issues.map((f) => ({
+    const findings = issues.map((f) => ({
       file,
       line: f.line as number | undefined,
       column: f.column as number | undefined,
@@ -253,9 +257,13 @@ async function runGrade(sql: string, file: string, schemaPath?: string): Promise
       message: (f.message ?? f.description ?? "") as string,
       suggestion: f.suggestion as string | undefined,
     }))
+    // Preserve the primary A-F grade value from the backend
+    const grade = (result.data.grade ?? result.data.letter_grade) as string | undefined
+    const score = (result.data.score ?? result.data.numeric_score) as number | undefined
+    return { findings, grade, score }
   } catch (e) {
     console.error(`[grade] error processing ${file}: ${e instanceof Error ? e.message : String(e)}`)
-    return [dispatcherErrorFinding("grade", file, e)]
+    return { findings: [dispatcherErrorFinding("grade", file, e)] }
   }
 }
 
@@ -321,18 +329,21 @@ export const CheckCommand = cmd({
     })
     if (checks.length === 0) {
       console.error("Error: no valid checks specified.")
-      process.exit(1)
+      process.exitCode = 1
+      return
     }
 
     // 2. Validate policy requirement
     if (checks.includes("policy")) {
       if (!args.policy) {
         console.error("Error: --policy is required when running the policy check.")
-        process.exit(1)
+        process.exitCode = 1
+        return
       }
       if (!existsSync(args.policy)) {
         console.error(`Error: policy file not found: ${args.policy}`)
-        process.exit(1)
+        process.exitCode = 1
+        return
       }
     }
 
@@ -366,7 +377,7 @@ export const CheckCommand = cmd({
 
     if (files.length === 0) {
       console.error("No SQL files found to check.")
-      process.exit(0)
+      return
     }
 
     console.error(`Found ${files.length} SQL file(s) to check with [${checks.join(", ")}]`)
@@ -379,13 +390,16 @@ export const CheckCommand = cmd({
         policyJson = readFileSync(args.policy, "utf-8")
       } catch (e) {
         console.error(`Error reading policy file: ${e instanceof Error ? e.message : String(e)}`)
-        process.exit(1)
+        process.exitCode = 1
+        return
       }
     }
 
     // 5. Run checks on all files in batches of 10
     const BATCH_SIZE = 10
     const allResults: Record<string, Finding[]> = {}
+    let gradeValue: string | undefined
+    let gradeScore: number | undefined
     for (const check of checks) {
       allResults[check] = []
     }
@@ -425,9 +439,13 @@ export const CheckCommand = cmd({
             case "semantic":
               findings = await runSemantic(sql, relFile, schemaPath)
               break
-            case "grade":
-              findings = await runGrade(sql, relFile, schemaPath)
+            case "grade": {
+              const gradeResult = await runGrade(sql, relFile, schemaPath)
+              findings = gradeResult.findings
+              if (gradeResult.grade) gradeValue = gradeResult.grade
+              if (gradeResult.score != null) gradeScore = gradeResult.score
               break
+            }
           }
           allResults[check].push(...findings)
         }
@@ -452,7 +470,13 @@ export const CheckCommand = cmd({
       results[check] = toCategoryResult(filterBySeverity(findings, minSeverity))
     }
 
-    // 8. Build output using the helper
+    // 8. Attach grade metadata if available
+    if (results.grade) {
+      if (gradeValue) results.grade.grade = gradeValue
+      if (gradeScore != null) results.grade.score = gradeScore
+    }
+
+    // 9. Build output using the helper
     const output = buildCheckOutput({
       filesChecked: files.length,
       checksRun: checks,
@@ -463,7 +487,7 @@ export const CheckCommand = cmd({
     // Override pass with our pre-computed value from unfiltered findings
     output.summary.pass = pass
 
-    // 9. Output
+    // 10. Output
     const duration = Date.now() - startTime
     if (args.format === "json") {
       process.stdout.write(JSON.stringify(output, null, 2) + "\n")
@@ -472,9 +496,10 @@ export const CheckCommand = cmd({
     }
     console.error(`Completed in ${duration}ms`)
 
-    // 10. Exit code
+    // 11. Exit code — use process.exitCode instead of process.exit() to allow
+    // the outer finally block in index.ts to run Telemetry.shutdown().
     if (!pass) {
-      process.exit(1)
+      process.exitCode = 1
     }
   },
 })

packages/opencode/src/index.ts

@@ -134,10 +134,13 @@ let cli = yargs(hideBin(process.argv))
       args: process.argv.slice(2),
     })
 
+    // altimate_change start — check: skip DB migration for stateless commands (check only needs Dispatcher)
+    const isStatelessCommand = process.argv[2] === "check"
+    // altimate_change end
     // altimate_change start - db marker name
     const marker = path.join(Global.Path.data, "altimate-code.db")
     // altimate_change end
-    if (!(await Filesystem.exists(marker))) {
+    if (!isStatelessCommand && !(await Filesystem.exists(marker))) {
       const tty = process.stderr.isTTY
       process.stderr.write("Performing one time database migration, may take a few minutes..." + EOL)
       const width = 36

packages/opencode/test/cli/check-e2e.test.ts

@@ -130,10 +130,12 @@ const origExit = process.exit
 beforeEach(async () => {
   resetDispatcherMocks()
   exitCode = undefined
+  process.exitCode = 0
   stdoutData = ""
   stderrData = ""
   tmpDir = await mktmp()
 
+  // Keep process.exit mock as safety net
   process.exit = ((code?: number) => {
     exitCode = code ?? 0
     throw new Error(`__EXIT_${code ?? 0}__`)
@@ -154,13 +156,16 @@ beforeEach(async () => {
 
 afterEach(async () => {
   process.exit = origExit
+  process.exitCode = 0
   mock.restore()
   await tmpDir.cleanup()
 })
 
 async function runHandler(
   args: HandlerArgs,
 ): Promise<{ exitCode: number | undefined; stdout: string; stderr: string }> {
+  exitCode = undefined
+  process.exitCode = 0
   try {
     const savedCwd = process.cwd
     ;(process as any).cwd = () => tmpDir.dir
@@ -171,12 +176,16 @@ async function runHandler(
     }
   } catch (e) {
     if (e instanceof Error && e.message.startsWith("__EXIT_")) {
-      // expected
+      // expected — from legacy process.exit() mock
     } else {
       throw e
     }
   }
-  return { exitCode, stdout: stdoutData, stderr: stderrData }
+  // Handler uses process.exitCode (preferred) or process.exit() (mocked to set exitCode)
+  // Note: Bun doesn't support process.exitCode = undefined, so we use 0 as "no error"
+  const code = exitCode ?? (process.exitCode === 0 ? undefined : (process.exitCode as number))
+  process.exitCode = 0
+  return { exitCode: code, stdout: stdoutData, stderr: stderrData }
 }
 
 function parseJson(stdout: string): any {
@@ -475,9 +484,10 @@ describe("check command E2E", () => {
     expect(j.files_checked).toBe(1)
   })
 
-  test("exits 0 when no SQL files found", async () => {
+  test("returns cleanly when no SQL files found (exit 0)", async () => {
     const r = await runHandler(baseArgs({ files: ["/nonexistent.sql"], checks: "lint" }))
-    expect(r.exitCode).toBe(0)
+    // No exitCode set — handler just returns without error
+    expect(r.exitCode).toBeUndefined()
     expect(r.stderr).toContain("No SQL files found")
   })