Skip to content

Commit 2a03484

Browse files
committed
Merge origin/main into feat/validator-framework
Resolves CHANGELOG.md conflict by keeping the Unreleased validator entry above the 0.7.3 release section that landed on main while this PR was in review.
2 parents 44d65db + 4a8fca8 commit 2a03484

52 files changed

Lines changed: 4050 additions & 394 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/release.yml‎

Lines changed: 25 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -59,19 +59,17 @@ jobs:
5959
matrix:
6060
include:
6161
# Each target builds ONE binary in parallel (~5 min each)
62-
# Index matches allTargets array in build.ts
62+
# Index matches allTargets array in build.ts. Targets without a
63+
# @altimateai/altimate-core NAPI prebuild (linux-*-musl, win32-arm64)
64+
# are intentionally excluded — see allTargets in build.ts.
6365
- { index: 0, name: "linux-arm64" }
6466
- { index: 1, name: "linux-x64" }
6567
- { index: 2, name: "linux-x64-baseline" }
66-
- { index: 3, name: "linux-arm64-musl" }
67-
- { index: 4, name: "linux-x64-musl" }
68-
- { index: 5, name: "linux-x64-baseline-musl" }
69-
- { index: 6, name: "darwin-arm64" }
70-
- { index: 7, name: "darwin-x64" }
71-
- { index: 8, name: "darwin-x64-baseline" }
72-
- { index: 9, name: "win32-arm64" }
73-
- { index: 10, name: "win32-x64" }
74-
- { index: 11, name: "win32-x64-baseline" }
68+
- { index: 3, name: "darwin-arm64" }
69+
- { index: 4, name: "darwin-x64" }
70+
- { index: 5, name: "darwin-x64-baseline" }
71+
- { index: 6, name: "win32-x64" }
72+
- { index: 7, name: "win32-x64-baseline" }
7573
steps:
7674
- uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
7775

@@ -106,17 +104,22 @@ jobs:
106104
- name: Smoke test binary
107105
if: matrix.name == 'linux-x64'
108106
run: |
109-
BINARY=$(find packages/opencode/dist -name altimate -type f | head -1)
107+
# Resolve to an absolute path before we cd away from the workspace.
108+
BINARY=$(find "$(pwd)/packages/opencode/dist" -name altimate -type f | head -1)
110109
if [ -z "$BINARY" ]; then
111110
echo "::error::No binary found in dist/"
112111
exit 1
113112
fi
114113
chmod +x "$BINARY"
115114
116-
# Set NODE_PATH so the binary can resolve external NAPI modules
117-
# (mirrors what the npm bin wrapper does at runtime)
118-
NODE_PATH="$(pwd)/packages/opencode/node_modules:$(pwd)/node_modules" "$BINARY" --version
119-
echo "Smoke test passed: binary starts and prints version"
115+
# Run with NO pre-set NODE_PATH AND from a directory with no
116+
# node_modules anywhere upward. Bun's compiled binary would
117+
# otherwise walk the workspace tree for node_modules and resolve
118+
# altimate-core that way — the test would pass for the wrong
119+
# reason if the staged shim ever silently misses.
120+
cd "${RUNNER_TEMP:-/tmp}"
121+
env -u NODE_PATH "$BINARY" --version
122+
echo "Smoke test passed: standalone binary starts hermetically"
120123
121124
- name: Upload build artifact
122125
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
@@ -256,13 +259,18 @@ jobs:
256259
# compile-time checks miss (e.g. missing NAPI externals like v0.5.10).
257260
- name: Pre-publish smoke test
258261
run: |
259-
BINARY=$(find packages/opencode/dist -path '*altimate-code-linux-x64/bin/altimate' -type f | head -1)
262+
# Resolve to an absolute path before we cd away from the workspace.
263+
BINARY=$(find "$(pwd)/packages/opencode/dist" -path '*altimate-code-linux-x64/bin/altimate' -type f | head -1)
260264
if [ -z "$BINARY" ]; then
261265
echo "::error::No linux-x64 binary found in artifacts — cannot verify release"
262266
exit 1
263267
else
264268
chmod +x "$BINARY"
265-
NODE_PATH="$(pwd)/packages/opencode/node_modules:$(pwd)/node_modules" "$BINARY" --version
269+
# No NODE_PATH AND hermetic cwd: see the build-time smoke test
270+
# comment for why this matters. The binary must start without
271+
# walking the workspace for node_modules.
272+
cd "${RUNNER_TEMP:-/tmp}"
273+
env -u NODE_PATH "$BINARY" --version
266274
echo "Pre-publish smoke test passed"
267275
fi
268276

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,3 +44,4 @@ __pycache__
4444
**/.github/meta/commit.txt
4545
**/.github/meta/diff.txt
4646
**/.github/meta/pr-body-*.md
47+
*.bak

‎CHANGELOG.md‎

Lines changed: 112 additions & 2 deletions
Large diffs are not rendered by default.

‎README.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,14 @@ into CI pipelines and orchestration DAGs. Precision data tooling for any LLM.
2828
npm install -g altimate-code
2929
```
3030

31+
Or via curl (installs the `altimate` binary to `~/.altimate/bin`):
32+
33+
```bash
34+
curl -fsSL https://www.altimate.sh/install | bash
35+
```
36+
37+
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.
38+
3139
Then — in order:
3240

3341
**Step 1: Configure your LLM provider** (required before anything works):

‎docs/docs/data-engineering/tools/finops-tools.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@
22

33
Cost optimization and warehouse governance. These tools help you find where money is being wasted and fix it.
44

5+
!!! note "v0.7.3+ — warehouse parameter is now optional"
6+
Every `finops_*` tool used to require an explicit `warehouse=<connection-name>` argument. As of v0.7.3, the parameter is optional — if omitted, the tool auto-picks the first configured warehouse whose driver type supports the operation. Pass `warehouse=` explicitly when you have multiple compatible connections and want a specific one. The bare form (`finops_query_history --days 7`) works.
7+
58
## finops_query_history
69

710
Fetch recent query execution history from your warehouse.
@@ -27,11 +30,11 @@ Summary:
2730
```
2831

2932
**Parameters:**
30-
- `warehouse` (required): Connection name
33+
- `warehouse` (optional, since v0.7.3): Connection name. If omitted, the first configured Snowflake / BigQuery / Databricks / PostgreSQL warehouse is auto-picked.
3134
- `days` (optional, default: 7): Lookback period
3235
- `limit` (optional, default: 100): Max queries returned
3336
- `user` (optional): Filter by username
34-
- `warehouse_filter` (optional): Filter by compute warehouse name
37+
- `warehouse_filter` (optional, Snowflake-only): Filter the result rows by the in-warehouse compute name (different from the `warehouse` connection parameter). Use `warehouse` to pick which connection to query; use `warehouse_filter` to narrow which Snowflake virtual warehouse's queries appear in the output.
3538

3639
**Data sources by warehouse:**
3740
- Snowflake: `QUERY_HISTORY` function
@@ -46,7 +49,8 @@ Summary:
4649
Break down credit consumption by warehouse, time, and user.
4750

4851
```
49-
> finops_analyze_credits prod-snowflake --days 30
52+
> finops_analyze_credits --days 30
53+
# equivalent: finops_analyze_credits prod-snowflake --days 30
5054
5155
Credit Analysis (last 30 days):
5256

‎docs/docs/reference/troubleshooting.md‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,57 @@
11
# Troubleshooting
22

3+
## Installation
4+
5+
### Standalone binary not found after curl install
6+
7+
**Symptoms:** `altimate-code: command not found` after running `curl -fsSL https://www.altimate.sh/install | bash`.
8+
9+
As of v0.7.1 the curl-installed binary is named `altimate`, not `altimate-code`. The npm package continues to ship both names. If you scripted against the curl install:
10+
11+
```bash
12+
# Before (v0.7.0 and earlier curl install):
13+
~/.altimate-code/bin/altimate-code run "..."
14+
15+
# After (v0.7.1+ curl install):
16+
~/.altimate/bin/altimate run "..."
17+
```
18+
19+
Or stay on the `altimate-code` name by installing via npm: `npm install -g altimate-code`.
20+
21+
### `Cannot find module '@altimateai/altimate-code-core'`
22+
23+
**Symptoms:** Binary crashes on first run with the above error (curl-installed v0.7.0 and earlier).
24+
25+
The v0.7.0 curl install shipped without the NAPI native module. Fixed in v0.7.1 — the native module is now embedded directly into the binary. Re-install with:
26+
27+
```bash
28+
curl -fsSL https://www.altimate.sh/install | bash
29+
```
30+
31+
### Alpine Linux (musl) not supported
32+
33+
**Symptoms:** `Alpine Linux (musl) is not currently supported by the standalone install` during curl install, or `altimate-code is not currently supported on Alpine Linux (musl)` during `npm install` postinstall.
34+
35+
`@altimateai/altimate-core` has no NAPI prebuild for musl. Workarounds:
36+
37+
```bash
38+
# Run the glibc binary under Alpine (recommended):
39+
apk add gcompat
40+
41+
# Then either:
42+
curl -fsSL https://www.altimate.sh/install | bash # standalone binary
43+
# or:
44+
apk add gcompat && npm install -g altimate-code # npm install
45+
```
46+
47+
Or use a glibc-based base image (`debian`, `ubuntu`, `node:slim`).
48+
49+
### Windows on ARM64 not supported
50+
51+
**Symptoms:** `altimate-code is not currently built for Windows on ARM64` during install.
52+
53+
Run the x64 build under Windows-on-ARM's x64 emulation layer, or use WSL.
54+
355
## Log Files
456

557
Logs are stored at:

‎github/action.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,22 +52,22 @@ runs:
5252
id: cache
5353
uses: actions/cache@v4
5454
with:
55-
path: ~/.altimate-code/bin
55+
path: ~/.altimate/bin
5656
key: altimate-code-${{ runner.os }}-${{ runner.arch }}-${{ steps.version.outputs.version }}
5757

5858
- name: Install altimate-code
5959
if: steps.cache.outputs.cache-hit != 'true'
6060
shell: bash
61-
run: curl -fsSL https://altimate.ai/install | bash
61+
run: curl -fsSL https://www.altimate.sh/install | bash
6262

6363
- name: Add altimate-code to PATH
6464
shell: bash
65-
run: echo "$HOME/.altimate-code/bin" >> $GITHUB_PATH
65+
run: echo "$HOME/.altimate/bin" >> $GITHUB_PATH
6666

6767
- name: Run altimate-code
6868
shell: bash
6969
id: run_altimate_code
70-
run: altimate-code github run
70+
run: altimate github run
7171
env:
7272
MODEL: ${{ inputs.model }}
7373
AGENT: ${{ inputs.agent }}

0 commit comments

Comments
 (0)