altimate-code 0.4.7 → 0.5.0

package/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-03-18
+
+### Added
+
+- Smooth streaming mode for TUI response rendering (#281)
+- Ship builtin skills to customers via `postinstall` (#279)
+- `/configure-claude` and `/configure-codex` built-in commands (#235)
+
+### Fixed
+
+- Brew formula stuck at v0.3.1 — version normalization in publish pipeline (#286)
+- Harden auth field handling for all warehouse drivers (#271)
+- Suppress console logging that corrupts TUI display (#269)
+
+## [0.4.9] - 2026-03-18
+
+### Added
+
+- Script to build and run compiled binary locally (#262)
+
+### Fixed
+
+- Snowflake auth — support all auth methods (`password`, `keypair`, `externalbrowser`, `oauth`), fix field name mismatches (#268)
+- dbt tool regression — schema format mismatch, silent failures, wrong results (#263)
+- `altimate-dbt compile`, `execute`, and children commands fail with runtime errors (#255)
+- `Cannot find module @altimateai/altimate-core` on `npm install` (#259)
+- Dispatcher tests fail in CI due to shared module state (#257)
+
+### Changed
+
+- CI: parallel per-target builds — 12 jobs, ~5 min wall clock instead of ~20 min (#254)
+- CI: faster release — build parallel with test, lower compression, tighter timeouts (#251)
+- Docker E2E tests skip in CI unless explicitly opted in (#253)
+
 ## [0.4.1] - 2026-03-16
 ## [0.4.2] - 2026-03-18
 

package/bin/altimate

@@ -5,9 +5,55 @@ const fs = require("fs")
 const path = require("path")
 const os = require("os")
 
+// Resolve script location early — needed by both run() and findBinary().
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+// Collect ALL node_modules directories walking upward from startDir.
+// Bun's single-file executable uses a virtual filesystem (/$bunfs/root/) without
+// node_modules. External packages are resolved via NODE_PATH instead.
+// We collect every node_modules in the hierarchy (not just the first) to handle
+// pnpm strict layouts, hoisted monorepos, and npm flat installs alike.
+function findAllNodeModules(startDir) {
+  const paths = []
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) paths.push(modules)
+    const parent = path.dirname(current)
+    if (parent === current) break
+    current = parent
+  }
+  return paths
+}
+
 function run(target) {
+  // Resolve NODE_PATH so the compiled Bun binary can find external packages
+  // installed alongside the wrapper (e.g. @altimateai/altimate-core NAPI module).
+  // Search from BOTH the binary's location AND the wrapper script's location
+  // to cover npm flat installs, pnpm isolated stores, and hoisted monorepos.
+  const env = { ...process.env }
+  try {
+    const resolvedTarget = fs.realpathSync(target)
+    const targetDir = path.dirname(path.dirname(resolvedTarget))
+
+    const targetModules = findAllNodeModules(targetDir)
+    const scriptModules = findAllNodeModules(scriptDir)
+    const allPaths = [...new Set([...scriptModules, ...targetModules])]
+
+    if (allPaths.length > 0) {
+      const sep = process.platform === "win32" ? ";" : ":"
+      const joined = allPaths.join(sep)
+      env.NODE_PATH = env.NODE_PATH ? joined + sep + env.NODE_PATH : joined
+    }
+  } catch {
+    // realpathSync failed (e.g. target doesn't exist) — continue without
+    // NODE_PATH; spawnSync will report the missing binary via result.error.
+  }
+
   const result = childProcess.spawnSync(target, process.argv.slice(2), {
     stdio: "inherit",
+    env,
   })
   if (result.error) {
     console.error(result.error.message)
@@ -22,9 +68,6 @@ if (envPath) {
   run(envPath)
 }
 
-const scriptPath = fs.realpathSync(__filename)
-const scriptDir = path.dirname(scriptPath)
-
 //
 const cached = path.join(scriptDir, ".altimate-code")
 if (fs.existsSync(cached)) {

package/bin/altimate-code

@@ -5,9 +5,55 @@ const fs = require("fs")
 const path = require("path")
 const os = require("os")
 
+// Resolve script location early — needed by both run() and findBinary().
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+// Collect ALL node_modules directories walking upward from startDir.
+// Bun's single-file executable uses a virtual filesystem (/$bunfs/root/) without
+// node_modules. External packages are resolved via NODE_PATH instead.
+// We collect every node_modules in the hierarchy (not just the first) to handle
+// pnpm strict layouts, hoisted monorepos, and npm flat installs alike.
+function findAllNodeModules(startDir) {
+  const paths = []
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) paths.push(modules)
+    const parent = path.dirname(current)
+    if (parent === current) break
+    current = parent
+  }
+  return paths
+}
+
 function run(target) {
+  // Resolve NODE_PATH so the compiled Bun binary can find external packages
+  // installed alongside the wrapper (e.g. @altimateai/altimate-core NAPI module).
+  // Search from BOTH the binary's location AND the wrapper script's location
+  // to cover npm flat installs, pnpm isolated stores, and hoisted monorepos.
+  const env = { ...process.env }
+  try {
+    const resolvedTarget = fs.realpathSync(target)
+    const targetDir = path.dirname(path.dirname(resolvedTarget))
+
+    const targetModules = findAllNodeModules(targetDir)
+    const scriptModules = findAllNodeModules(scriptDir)
+    const allPaths = [...new Set([...scriptModules, ...targetModules])]
+
+    if (allPaths.length > 0) {
+      const sep = process.platform === "win32" ? ";" : ":"
+      const joined = allPaths.join(sep)
+      env.NODE_PATH = env.NODE_PATH ? joined + sep + env.NODE_PATH : joined
+    }
+  } catch {
+    // realpathSync failed (e.g. target doesn't exist) — continue without
+    // NODE_PATH; spawnSync will report the missing binary via result.error.
+  }
+
   const result = childProcess.spawnSync(target, process.argv.slice(2), {
     stdio: "inherit",
+    env,
   })
   if (result.error) {
     console.error(result.error.message)
@@ -22,9 +68,6 @@ if (envPath) {
   run(envPath)
 }
 
-const scriptPath = fs.realpathSync(__filename)
-const scriptDir = path.dirname(scriptPath)
-
 //
 const cached = path.join(scriptDir, ".altimate-code")
 if (fs.existsSync(cached)) {

package/package.json

@@ -14,20 +14,23 @@
   "scripts": {
     "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
   },
-  "version": "v0.4.7",
+  "version": "0.5.0",
   "license": "MIT",
+  "dependencies": {
+    "@altimateai/altimate-core": "^0.2.3"
+  },
   "optionalDependencies": {
-    "@altimateai/altimate-code-linux-x64": "v0.4.7",
-    "@altimateai/altimate-code-windows-arm64": "v0.4.7",
-    "@altimateai/altimate-code-linux-arm64-musl": "v0.4.7",
-    "@altimateai/altimate-code-darwin-x64": "v0.4.7",
-    "@altimateai/altimate-code-windows-x64": "v0.4.7",
-    "@altimateai/altimate-code-linux-x64-musl": "v0.4.7",
-    "@altimateai/altimate-code-darwin-x64-baseline": "v0.4.7",
-    "@altimateai/altimate-code-linux-x64-baseline-musl": "v0.4.7",
-    "@altimateai/altimate-code-linux-x64-baseline": "v0.4.7",
-    "@altimateai/altimate-code-linux-arm64": "v0.4.7",
-    "@altimateai/altimate-code-darwin-arm64": "v0.4.7",
-    "@altimateai/altimate-code-windows-x64-baseline": "v0.4.7"
+    "@altimateai/altimate-code-linux-x64": "0.5.0",
+    "@altimateai/altimate-code-windows-arm64": "0.5.0",
+    "@altimateai/altimate-code-linux-arm64-musl": "0.5.0",
+    "@altimateai/altimate-code-darwin-x64": "0.5.0",
+    "@altimateai/altimate-code-windows-x64": "0.5.0",
+    "@altimateai/altimate-code-linux-x64-musl": "0.5.0",
+    "@altimateai/altimate-code-darwin-x64-baseline": "0.5.0",
+    "@altimateai/altimate-code-linux-x64-baseline-musl": "0.5.0",
+    "@altimateai/altimate-code-linux-x64-baseline": "0.5.0",
+    "@altimateai/altimate-code-linux-arm64": "0.5.0",
+    "@altimateai/altimate-code-darwin-arm64": "0.5.0",
+    "@altimateai/altimate-code-windows-x64-baseline": "0.5.0"
   }
 }

package/postinstall.mjs

@@ -115,6 +115,39 @@ function printWelcome(version) {
   out(bot)
 }
 
+function copyDirRecursive(src, dst) {
+  fs.mkdirSync(dst, { recursive: true })
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name)
+    const dstPath = path.join(dst, entry.name)
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, dstPath)
+    } else {
+      fs.copyFileSync(srcPath, dstPath)
+    }
+  }
+}
+
+/**
+ * Copy bundled skills to ~/.altimate/builtin/ on every install/upgrade.
+ * The entire directory is wiped and replaced so each release is the single
+ * source of truth. Intentionally separate from ~/.altimate/skills/ which users own.
+ */
+function copySkillsToAltimate() {
+  try {
+    const skillsSrc = path.join(__dirname, "skills")
+    if (!fs.existsSync(skillsSrc)) return // skills not in package (shouldn't happen)
+
+    const builtinDst = path.join(os.homedir(), ".altimate", "builtin")
+
+    // Full wipe-and-replace — each release owns this directory entirely
+    if (fs.existsSync(builtinDst)) fs.rmSync(builtinDst, { recursive: true, force: true })
+    copyDirRecursive(skillsSrc, builtinDst)
+  } catch {
+    // Non-fatal — skills can be installed manually
+  }
+}
+
 /**
  * Write a marker file so the CLI can show a welcome/upgrade banner on first run.
  * npm v7+ silences postinstall stdout, so the CLI reads this marker at startup instead.
@@ -144,6 +177,7 @@ async function main() {
       // On Windows, the .exe is already included in the package and bin field points to it
       // No postinstall setup needed
       if (version) writeUpgradeMarker(version)
+      copySkillsToAltimate()
       return
     }
 
@@ -161,6 +195,7 @@ async function main() {
     // Write marker only — npm v7+ suppresses all postinstall output.
     // The CLI picks up the marker and shows the welcome box on first run.
     if (version) writeUpgradeMarker(version)
+    copySkillsToAltimate()
   } catch (error) {
     console.error("Failed to setup altimate-code binary:", error.message)
     process.exit(1)

package/skills/cost-report/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: cost-report
+description: Analyze Snowflake query costs and identify optimization opportunities
+---
+
+# Cost Report
+
+## Requirements
+**Agent:** any (read-only analysis)
+**Tools used:** sql_execute, sql_analyze, finops_analyze_credits, finops_expensive_queries, finops_warehouse_advice, finops_unused_resources, finops_query_history
+
+Analyze Snowflake warehouse query costs, identify the most expensive queries, detect anti-patterns, and recommend optimizations.
+
+## Workflow
+
+1. **Query SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY** for the top 20 most expensive queries by credits used:
+
+   ```sql
+   SELECT
+       query_id,
+       query_text,
+       user_name,
+       warehouse_name,
+       query_type,
+       credits_used_cloud_services,
+       bytes_scanned,
+       rows_produced,
+       total_elapsed_time,
+       execution_status,
+       start_time
+   FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY
+   WHERE start_time >= DATEADD('day', -30, CURRENT_TIMESTAMP())
+     AND execution_status = 'SUCCESS'
+     AND credits_used_cloud_services > 0
+   ORDER BY credits_used_cloud_services DESC
+   LIMIT 20;
+   ```
+
+   Use `sql_execute` to run this query against the connected Snowflake warehouse.
+
+2. **Group and summarize** the results by:
+   - **User**: Which users are driving the most cost?
+   - **Warehouse**: Which warehouses consume the most credits?
+   - **Query type**: SELECT vs INSERT vs CREATE TABLE AS SELECT vs MERGE, etc.
+
+   Present each grouping as a markdown table.
+
+3. **Analyze the top offenders** - For each of the top 10 most expensive queries:
+   - Run `sql_analyze` on the query text to detect anti-patterns (SELECT *, missing LIMIT, cartesian products, correlated subqueries, etc.)
+   - Summarize anti-patterns found and their severity
+
+4. **Classify each query into a cost tier**:
+
+   | Tier | Credits | Label | Action |
+   |------|---------|-------|--------|
+   | 1 | < $0.01 | Cheap | No action needed |
+   | 2 | $0.01 - $1.00 | Moderate | Review if frequent |
+   | 3 | $1.00 - $100.00 | Expensive | Optimize or review warehouse sizing |
+   | 4 | > $100.00 | Dangerous | Immediate review required |
+
+5. **Warehouse analysis** - Run `finops_warehouse_advice` to check if warehouses used by the top offenders are right-sized.
+
+6. **Unused resource detection** - Run `finops_unused_resources` to find:
+   - **Stale tables**: Tables not accessed in the last 30+ days (candidates for archival/drop)
+   - **Idle warehouses**: Warehouses with no query activity (candidates for suspension/removal)
+
+   Include findings in the report under a "Waste Detection" section.
+
+7. **Query history enrichment** - Run `finops_query_history` to fetch recent execution patterns:
+   - Identify frequently-run expensive queries (high frequency × high cost = top optimization target)
+   - Find queries that could benefit from result caching or materialization
+
+8. **Output the final report** as a structured markdown document:
+
+   ```
+   # Snowflake Cost Report (Last 30 Days)
+
+   ## Summary
+   - Total credits consumed: X
+   - Number of unique queries: Y
+   - Most expensive query: Z credits
+
+   ## Cost by User
+   | User | Total Credits | Query Count | Avg Credits/Query |
+   |------|--------------|-------------|-------------------|
+
+   ## Cost by Warehouse
+   | Warehouse | Total Credits | Query Count | Avg Credits/Query |
+   |-----------|--------------|-------------|-------------------|
+
+   ## Cost by Query Type
+   | Query Type | Total Credits | Query Count | Avg Credits/Query |
+   |------------|--------------|-------------|-------------------|
+
+   ## Top 10 Expensive Queries (Detailed Analysis)
+
+   ### Query 1 (X credits) - DANGEROUS
+   **User:** user_name | **Warehouse:** wh_name | **Type:** SELECT
+   **Anti-patterns found:**
+   - SELECT_STAR (warning): Query uses SELECT * ...
+   - MISSING_LIMIT (info): ...
+
+   **Optimization suggestions:**
+   1. Select only needed columns
+   2. Add LIMIT clause
+   3. Consider partitioning strategy
+
+   **Cost tier:** Tier 1 (based on credits used)
+
+   ...
+
+   ## Waste Detection
+   ### Unused Tables
+   | Table | Last Accessed | Size | Recommendation |
+   |-------|--------------|------|----------------|
+
+   ### Idle Warehouses
+   | Warehouse | Last Query | Size | Recommendation |
+   |-----------|-----------|------|----------------|
+
+   ## Recommendations
+   1. Top priority optimizations
+   2. Warehouse sizing suggestions
+   3. Unused resource cleanup
+   4. Scheduling recommendations
+   ```
+
+## Usage
+
+The user invokes this skill with:
+- `/cost-report` -- Analyze the last 30 days
+- `/cost-report 7` -- Analyze the last 7 days (adjust the DATEADD interval)
+
+Use the tools: `sql_execute`, `sql_analyze`, `finops_analyze_credits`, `finops_expensive_queries`, `finops_warehouse_advice`, `finops_unused_resources`, `finops_query_history`.

package/skills/data-viz/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: data-viz
+description: >
+  Build modern, interactive data visualizations and dashboards using code-based
+  component libraries (shadcn/ui, Recharts, Tremor, Nivo, D3, Victory, visx).
+  Use this skill whenever the user asks to visualize data, build dashboards,
+  create analytics views, chart metrics, tell a data story, build a reporting
+  interface, create KPI cards, plot graphs, or explore a dataset — even if they
+  mention PowerBI, Tableau, Streamlit, Metabase, Looker, Grafana, or similar
+  tools. Also trigger when the user says "make a dashboard", "show me the data",
+  "chart this", "visualize trends", "build an analytics page", "data story", or
+  anything involving turning raw data into interactive visual interfaces. If the
+  task involves presenting data visually — this is the skill. Always prefer
+  building a real, interactive, code-based UI over exporting to or recommending
+  a BI platform.
+---
+
+# AI-First Data Visualization
+
+## Philosophy
+
+Build production-quality interactive data interfaces with modern component libraries — no vendor lock-in, embeddable anywhere. When no tool is specified, build code-first. When the user explicitly names a BI tool, use it — only suggest code-first if they ask for options or hit a technical blocker.
+
+## Technology Stack
+
+Full API patterns & code: `references/component-guide.md`
+
+### Framework Priority
+
+1. **React + Tailwind** — Default when JSX/TSX supported
+2. **HTML + CSS + Vanilla JS** — Fallback (use D3 or Chart.js)
+3. **Python (Plotly/Dash)** — Python-only environments only
+
+### Library Selection
+
+| Library | Best For |
+|---------|----------|
+| **shadcn/ui charts** | Default first choice — general dashboards, most chart types |
+| **Recharts** | Line, bar, area, composed, radar — fine-grained control |
+| **Tremor** | KPI cards, metric displays, full dashboard layouts |
+| **Nivo** | Heatmaps, treemaps, choropleth, calendar, Sankey, funnel |
+| **visx** | Bespoke custom viz — D3-level control with React |
+| **D3.js** | Force-directed graphs, DAGs, maps — maximum flexibility |
+| **Victory** | When animation quality matters most |
+
+**Supporting**: Tailwind CSS · Radix UI · Framer Motion · Lucide React · date-fns · Papaparse · lodash
+
+## Building a Visualization
+
+### Step 1: Understand the Data Story
+
+Before code, identify: **What question does the data answer?** Who is the audience (exec → KPIs only, analyst → drill-down, public → narrative)? **What's the ONE key insight?** Design around it.
+
+### Step 2: Choose Chart Type
+
+| Data Relationship | Chart Type | Library |
+|---|---|---|
+| Trend over time | Line, Area | shadcn/Recharts |
+| Category comparison | Bar (horizontal if many) | shadcn/Recharts |
+| Part of whole | Donut, Treemap | shadcn/Nivo |
+| Distribution | Histogram, Box, Violin | Nivo/visx |
+| Correlation | Scatter, Bubble | Recharts/visx |
+| Geographic | Choropleth, Dot map | Nivo/D3 |
+| Hierarchical | Treemap, Sunburst | Nivo |
+| Flow / Process | Sankey, Funnel | Nivo/D3 |
+| Single KPI | Metric card, Gauge, Sparkline | Tremor/shadcn |
+| Multi-metric overview | Dashboard grid of cards | Tremor + shadcn |
+| Ranking | Horizontal bar, Bar list | Tremor |
+| Column/model lineage | Force-directed DAG | D3 |
+| Pipeline dependencies | Hierarchical tree, DAG | D3/Nivo |
+| Multi-dimensional quality | Radar/Spider | Recharts |
+| Activity density over time | Calendar heatmap | Nivo |
+| Incremental change breakdown | Waterfall | Recharts (custom) |
+
+### Step 3: Build the Interface
+
+Start from this layout — remove what the data doesn't need:
+
+```
+┌─────────────────────────────────────────┐
+│ Header: Title + Description + Date Range│
+├─────────────────────────────────────────┤
+│ KPI Row: 3-5 metric cards + sparklines  │
+├─────────────────────────────────────────┤
+│ Primary Visualization (largest chart)   │
+├──────────────────┬──────────────────────┤
+│ Secondary Chart  │ Supporting Chart/Tbl │
+├──────────────────┴──────────────────────┤
+│ Detail Table (sortable, filterable)     │
+└─────────────────────────────────────────┘
+```
+
+A single insight might just be one chart with a headline and annotation. Scale complexity to audience.
+
+### Step 4: Design Principles
+
+- **Data-ink ratio**: Remove chartjunk — unnecessary gridlines, redundant labels, decorative borders
+- **Color with purpose**: Encode meaning (red=bad, green=good, blue=neutral). Max 5-7 colors. Single-hue gradient for sequential data
+- **Typography hierarchy**: Title → subtitle (muted) → axis labels (small) → data labels
+- **Responsive**: `min-h-[VALUE]` on all charts. Grid stacks on mobile
+- **Animation**: Entry transitions only, `duration-300` to `duration-500`. Never continuous
+- **Accessibility**: `aria-label` on charts, WCAG AA contrast, don't rely on color alone
+
+### Step 5: Interactivity & Annotations
+
+**Priority**: Tooltips (every chart) → Filtering → Sorting → Drill-down → Cross-filtering → Export → Annotations
+
+**Annotations** turn charts into stories. Mark: inflection points, threshold crossings (amber), external events (indigo/red), anomalies (red), achievements (green). **Limit 3 per chart.** Implementation: `references/component-guide.md` → Annotation Patterns.
+
+### Step 6: Tell the Story
+
+- **Headline states insight**: "Revenue grew 23% QoQ, driven by enterprise" — not "Q3 Revenue Chart"
+- **Annotate key moments** directly on chart
+- **Contextual comparisons**: vs. prior period, vs. target, vs. benchmark
+- **Progressive disclosure**: Overview first — detail on demand
+
+## Environment-Specific Guidance
+
+| Environment | Approach |
+|---|---|
+| **Claude Artifacts** | React (JSX), single file, default export. Available: `recharts`, `lodash`, `d3`, `lucide-react`, shadcn via `@/components/ui/*`, Tailwind |
+| **Claude Code / Terminal** | Vite + React + Tailwind. Add shadcn/ui + Recharts. Structure: `src/components/charts/`, `src/components/cards/`, `src/data/` |
+| **Python / Jupyter** | Plotly for charts, Plotly Dash for dashboards |
+| **Cursor / Bolt / other IDEs** | Match existing framework. Prefer shadcn/ui if present |
+
+## Anti-Patterns
+
+- Screenshot/static charts — build interactive components
+- Defaulting to BI tools unprompted — build code-first when no tool specified
+- Default matplotlib — always customize in Python
+- Rainbow palettes — use deliberate, meaningful colors
+- 3D charts — almost never appropriate
+- Pie charts > 5 slices — use horizontal bar
+- Unlabeled dual y-axes — use two separate charts
+- Truncated bar axes — always start at zero