altimate-code 0.8.7 → 0.8.8

package/README.md

@@ -30,13 +30,19 @@ into CI pipelines and orchestration DAGs. Precision data tooling for any LLM.
 npm install -g altimate-code
 ```
 
-Or via curl (installs the `altimate` binary to `~/.altimate/bin`):
+Or via curl on macOS/Linux (installs the `altimate` binary to `~/.altimate/bin`):
 
 ```bash
 curl -fsSL https://www.altimate.sh/install | bash
 ```
 
-The curl install drops a single self-contained binary named `altimate`. The npm install exposes both `altimate` and `altimate-code` on PATH; the curl install only exposes `altimate`. Alpine Linux (musl) and Windows on ARM64 are not currently supported by the standalone binary — use `apk add gcompat` on Alpine, or use WSL on Windows-on-ARM.
+On Windows, install the same self-contained binary (to `%USERPROFILE%\.altimate\bin`) from PowerShell — no Node required:
+
+```powershell
+powershell -c "irm https://www.altimate.sh/install.ps1 | iex"
+```
+
+The standalone install drops a single self-contained binary named `altimate`. The npm install exposes both `altimate` and `altimate-code` on PATH; the standalone install only exposes `altimate`. Alpine Linux (musl) and Windows on ARM64 are not currently supported by the standalone binary — use `apk add gcompat` on Alpine, or use WSL on Windows-on-ARM.
 
 For GitHub, [install the Altimate Code App](https://github.com/apps/altimate-code-agent/installations/new)
 to select repositories for interactive agent tasks. Automatic dbt pull-request

package/dbt-tools/dist/index.js

@@ -321,16 +321,25 @@ function getDbt() {
   }
   return resolvedDbt;
 }
+function toExecFileError(e) {
+  if (e instanceof Error)
+    return e;
+  return new Error(String(e));
+}
 function run2(args) {
   const dbt2 = getDbt();
   const env = buildDbtEnv(dbt2);
   const cwd = globalOptions.projectRoot ?? process.cwd();
   return new Promise((resolve4, reject2) => {
     execFile(dbt2.path, args, { timeout: 120000, maxBuffer: 10 * 1024 * 1024, env, cwd }, (err, stdout, stderr) => {
-      if (err)
-        reject2(err);
-      else
+      if (err) {
+        const execErr = err;
+        execErr.stdout = stdout;
+        execErr.stderr = stderr;
+        reject2(execErr);
+      } else {
         resolve4({ stdout, stderr });
+      }
     });
   });
 }
@@ -439,41 +448,43 @@ async function execDbtShow(sql, limit) {
   const args = ["show", "--inline", sql, "--output", "json", "--log-format", "json"];
   if (limit !== undefined)
     args.push("--limit", String(limit));
-  let lines;
+  let primaryRunError;
+  let lines = [];
   try {
     const { stdout } = await run2(args);
     lines = parseJsonLines(stdout);
-  } catch {
-    lines = [];
-  }
-  const previewLine = lines.find((l) => l.data?.preview) ?? lines.find((l) => l.data?.rows) ?? lines.find((l) => l.result?.preview) ?? lines.find((l) => l.result?.rows);
-  const sqlLine = lines.find((l) => l.data?.sql) ?? lines.find((l) => l.data?.compiled_sql) ?? lines.find((l) => l.result?.sql);
-  if (previewLine) {
-    const preview = previewLine.data?.preview ?? previewLine.data?.rows ?? previewLine.result?.preview ?? previewLine.result?.rows;
-    let rows;
-    if (typeof preview === "string") {
-      const parsed = safeJsonParse(preview);
-      if (Array.isArray(parsed)) {
-        rows = parsed;
+  } catch (e) {
+    primaryRunError = toExecFileError(e);
+  }
+  if (!primaryRunError) {
+    const previewLine = lines.find((l) => l.data?.preview) ?? lines.find((l) => l.data?.rows) ?? lines.find((l) => l.result?.preview) ?? lines.find((l) => l.result?.rows);
+    const sqlLine = lines.find((l) => l.data?.sql) ?? lines.find((l) => l.data?.compiled_sql) ?? lines.find((l) => l.result?.sql);
+    if (previewLine) {
+      const preview = previewLine.data?.preview ?? previewLine.data?.rows ?? previewLine.result?.preview ?? previewLine.result?.rows;
+      let rows;
+      if (typeof preview === "string") {
+        const parsed = safeJsonParse(preview);
+        rows = Array.isArray(parsed) ? parsed : [];
+      } else if (Array.isArray(preview)) {
+        rows = preview;
       } else {
         rows = [];
       }
-    } else {
-      rows = preview;
-    }
-    const columnNames = rows.length > 0 && rows[0] ? Object.keys(rows[0]) : [];
-    const compiledSql = sqlLine?.data?.sql ?? sqlLine?.data?.compiled_sql ?? sqlLine?.result?.sql ?? sql;
-    return { columnNames, columnTypes: columnNames.map(() => "string"), data: rows, rawSql: sql, compiledSql };
-  }
-  for (const line of lines) {
-    const found = deepFind(line, (val) => looksLikeRowData(val));
-    if (found) {
-      const rows = typeof found === "string" ? JSON.parse(found) : found;
       const columnNames = rows.length > 0 && rows[0] ? Object.keys(rows[0]) : [];
-      const compiledSql = deepFind(line, (val) => looksLikeSql(val)) ?? sql;
+      const compiledSql = sqlLine?.data?.sql ?? sqlLine?.data?.compiled_sql ?? sqlLine?.result?.sql ?? sql;
       return { columnNames, columnTypes: columnNames.map(() => "string"), data: rows, rawSql: sql, compiledSql };
     }
+    for (const line of lines) {
+      const found = deepFind(line, (val) => looksLikeRowData(val));
+      if (found) {
+        const rows = typeof found === "string" ? JSON.parse(found) : found;
+        const columnNames = rows.length > 0 && rows[0] ? Object.keys(rows[0]) : [];
+        const compiledSql = deepFind(line, (val) => looksLikeSql(val)) ?? sql;
+        return { columnNames, columnTypes: columnNames.map(() => "string"), data: rows, rawSql: sql, compiledSql };
+      }
+    }
   }
+  let plainRunError;
   try {
     const plainArgs = ["show", "--inline", sql];
     if (limit !== undefined)
@@ -489,62 +500,135 @@ async function execDbtShow(sql, limit) {
         compiledSql: sql
       };
     }
-  } catch {}
+  } catch (e) {
+    plainRunError = toExecFileError(e);
+  }
+  if (primaryRunError) {
+    const errorLogLines = parseJsonLines(primaryRunError.stdout?.toString() ?? "");
+    const realError = extractDbtError(errorLogLines, primaryRunError, plainRunError);
+    if (realError) {
+      const hasDbtCategoryPrefix = /^(Compilation|Database|Runtime|Parsing|Validation|Dependency)\s+Error\b/.test(realError);
+      throw new Error(hasDbtCategoryPrefix ? realError : `dbt show failed: ${realError}`);
+    }
+  }
+  if (plainRunError) {
+    const fallback = extractDbtError([], undefined, plainRunError) ?? fallbackExitMessage(undefined, plainRunError) ?? "unknown error";
+    throw new Error(`Could not parse dbt show JSON output, and plain-text fallback failed: ${fallback}`);
+  }
   throw new Error("Could not parse dbt show output in any format (JSON, heuristic, or plain text). " + `Got ${lines.length} JSON lines.`);
 }
+function extractDbtError(lines, primary, plain) {
+  if (!primary && !plain)
+    return;
+  const errorMessages = lines.map((l) => {
+    const line = l;
+    const isError = line.info?.level === "error" || line.level === "error";
+    if (!isError)
+      return;
+    return line.info?.msg ?? line.msg;
+  }).filter((m) => typeof m === "string" && m.trim().length > 0);
+  const structuredMsg = errorMessages.at(-1);
+  const primaryStderr = primary?.stderr?.toString().trim();
+  const plainStderr = plain?.stderr?.toString().trim();
+  const chosen = (structuredMsg && structuredMsg.length > 0 ? structuredMsg : undefined) ?? (primaryStderr && primaryStderr.length > 0 ? primaryStderr : undefined) ?? (plainStderr && plainStderr.length > 0 ? plainStderr : undefined) ?? fallbackExitMessage(primary, plain);
+  return chosen ? stripAnsi(chosen) : undefined;
+}
+function fallbackExitMessage(primary, plain) {
+  const err = primary ?? plain;
+  if (!err)
+    return;
+  const looksLikeCommandFailed = typeof err.message === "string" && err.message.startsWith("Command failed:");
+  if (!looksLikeCommandFailed)
+    return err.message;
+  if (typeof err.code === "number")
+    return `dbt exited with status ${err.code}`;
+  if (err.signal)
+    return `dbt killed by signal ${err.signal}`;
+  if (typeof err.code === "string")
+    return `dbt failed: ${err.code}`;
+  return "dbt failed (no exit code reported)";
+}
+function bubbleDbtError(label, primary, plain) {
+  const errorLogLines = primary?.stdout ? parseJsonLines(primary.stdout.toString()) : [];
+  const real = extractDbtError(errorLogLines, primary, plain);
+  if (real) {
+    const hasDbtCategoryPrefix = /^(Compilation|Database|Runtime|Parsing|Validation|Dependency)\s+Error\b/.test(real);
+    return hasDbtCategoryPrefix ? real : `${label}: ${real}`;
+  }
+  return `${label}: ${fallbackExitMessage(primary, plain) ?? "unknown error"}`;
+}
 async function execDbtCompile(model) {
   const args = ["compile", "--select", model, "--output", "json", "--log-format", "json"];
-  let lines;
+  let lines = [];
+  let primaryRunError;
   try {
     const { stdout } = await run2(args);
     lines = parseJsonLines(stdout);
-  } catch {
-    lines = [];
+  } catch (e) {
+    primaryRunError = toExecFileError(e);
   }
-  const sql = findCompiledSql(lines);
-  if (sql)
-    return { sql };
-  for (const line of lines) {
-    const found = deepFind(line, (val) => looksLikeSql(val));
-    if (found)
-      return { sql: found };
+  if (!primaryRunError) {
+    const sql = findCompiledSql(lines);
+    if (sql)
+      return { sql };
+    for (const line of lines) {
+      const found = deepFind(line, (val) => looksLikeSql(val));
+      if (found)
+        return { sql: found };
+    }
   }
+  let manifestRunError;
   try {
     await run2(["compile", "--select", model]);
-  } catch {}
+  } catch (e) {
+    manifestRunError = toExecFileError(e);
+  }
   const fromManifest = readCompiledFromManifest(model);
   if (fromManifest)
     return { sql: fromManifest };
+  let plainRunError;
   try {
     const { stdout: plainOut } = await run2(["compile", "--select", model]);
     return { sql: plainOut.trim() };
   } catch (e) {
-    throw new Error(`Could not compile model '${model}' in any format (JSON, heuristic, or manifest). ` + `Last error: ${e instanceof Error ? e.message : String(e)}`);
+    plainRunError = toExecFileError(e);
+  }
+  if (primaryRunError || plainRunError || manifestRunError) {
+    throw new Error(bubbleDbtError("dbt compile failed", primaryRunError, plainRunError ?? manifestRunError));
   }
+  throw new Error(`Could not compile model '${model}' in any format (JSON, heuristic, or manifest).`);
 }
 async function execDbtCompileInline(sql, _model) {
   const args = ["compile", "--inline", sql, "--output", "json", "--log-format", "json"];
-  let lines;
+  let lines = [];
+  let primaryRunError;
   try {
     const { stdout } = await run2(args);
     lines = parseJsonLines(stdout);
-  } catch {
-    lines = [];
+  } catch (e) {
+    primaryRunError = toExecFileError(e);
   }
-  const compiled = findCompiledSql(lines);
-  if (compiled)
-    return { sql: compiled };
-  for (const line of lines) {
-    const found = deepFind(line, (val) => looksLikeSql(val));
-    if (found)
-      return { sql: found };
+  if (!primaryRunError) {
+    const compiled = findCompiledSql(lines);
+    if (compiled)
+      return { sql: compiled };
+    for (const line of lines) {
+      const found = deepFind(line, (val) => looksLikeSql(val));
+      if (found)
+        return { sql: found };
+    }
   }
+  let plainRunError;
   try {
     const { stdout: plainOut } = await run2(["compile", "--inline", sql]);
     return { sql: plainOut.trim() };
   } catch (e) {
-    throw new Error(`Could not compile inline SQL in any format (JSON, heuristic, or plain text). ` + `Last error: ${e instanceof Error ? e.message : String(e)}`);
+    plainRunError = toExecFileError(e);
+  }
+  if (primaryRunError || plainRunError) {
+    throw new Error(bubbleDbtError("dbt compile inline failed", primaryRunError, plainRunError));
   }
+  throw new Error("Could not compile inline SQL in any format (JSON, heuristic, or plain text).");
 }
 function findCompiledSql(lines) {
   const compiledLine = lines.find((l) => l.data?.compiled) ?? lines.find((l) => l.data?.compiled_code) ?? lines.find((l) => l.result?.node?.compiled_code) ?? lines.find((l) => l.result?.compiled_code) ?? lines.find((l) => l.data?.compiled_sql);

package/package.json

@@ -14,20 +14,20 @@
   "scripts": {
     "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
   },
-  "version": "0.8.7",
+  "version": "0.8.8",
   "license": "MIT",
   "dependencies": {
     "@altimateai/altimate-core": "0.5.1"
   },
   "optionalDependencies": {
-    "@altimateai/altimate-code-linux-x64-baseline": "0.8.7",
-    "@altimateai/altimate-code-windows-x64": "0.8.7",
-    "@altimateai/altimate-code-linux-x64": "0.8.7",
-    "@altimateai/altimate-code-darwin-x64": "0.8.7",
-    "@altimateai/altimate-code-darwin-x64-baseline": "0.8.7",
-    "@altimateai/altimate-code-darwin-arm64": "0.8.7",
-    "@altimateai/altimate-code-windows-x64-baseline": "0.8.7",
-    "@altimateai/altimate-code-linux-arm64": "0.8.7"
+    "@altimateai/altimate-code-linux-x64-baseline": "0.8.8",
+    "@altimateai/altimate-code-windows-x64": "0.8.8",
+    "@altimateai/altimate-code-linux-x64": "0.8.8",
+    "@altimateai/altimate-code-darwin-x64": "0.8.8",
+    "@altimateai/altimate-code-darwin-x64-baseline": "0.8.8",
+    "@altimateai/altimate-code-darwin-arm64": "0.8.8",
+    "@altimateai/altimate-code-windows-x64-baseline": "0.8.8",
+    "@altimateai/altimate-code-linux-arm64": "0.8.8"
   },
   "peerDependencies": {
     "pg": ">=8",