yamchart 0.1.2 → 0.3.1

package/dist/templates/default/docs/yamchart-reference.md

@@ -0,0 +1,315 @@
+# Yamchart Configuration Reference
+
+Yamchart is a Git-native BI framework. Dashboards are defined as YAML configs and SQL models — if it's not in Git, it doesn't exist.
+
+## Project Structure
+
+```
+{{name}}/
+├── yamchart.yaml          # Project config + default connection
+├── connections/            # Database connection configs (.yaml)
+├── models/                 # SQL models with Jinja templating (.sql)
+├── charts/                 # Chart definitions (.yaml)
+└── dashboards/             # Dashboard layouts (.yaml)
+```
+
+## Commands
+
+```bash
+yamchart dev                          # Start dev server with hot reload
+yamchart validate                     # Validate all config files
+yamchart validate --dry-run           # Also test queries with EXPLAIN
+yamchart test                         # Run model @returns and @tests assertions
+yamchart test <model>                 # Test specific model
+```
+
+## SQL Models (`models/*.sql`)
+
+Models are SQL files with metadata comments and Jinja templating.
+
+```sql
+-- @name: model_name
+-- @description: What this model computes
+-- @returns:
+--   - column1: type
+--   - column2: type
+
+SELECT
+  date_trunc('{{ granularity }}', order_date) AS period,
+  SUM(amount) AS revenue
+FROM {{ ref('orders') }}
+WHERE order_date BETWEEN '{{ start_date }}' AND '{{ end_date }}'
+{% if category and category != 'All' %}
+  AND category = '{{ category }}'
+{% endif %}
+GROUP BY 1
+ORDER BY 1
+```
+
+**Metadata tags:** `@name` (required), `@description`, `@param name: type = default`, `@returns` (column: type list), `@tests` (SQL assertions where zero rows = pass)
+
+**Templating:** `{{ variable }}` for substitution, `{% if %}` / `{% endif %}` for conditionals, `{{ ref('table') }}` for table references, `{{ user.attribute }}` for row-level security.
+
+**Date parameters:** When a chart has `type: date_range`, the model receives `start_date` and `end_date` automatically.
+
+## Charts (`charts/*.yaml`)
+
+### Common Structure
+
+```yaml
+name: my-chart                # Unique identifier (required)
+title: My Chart               # Display title (required)
+description: Description      # Optional
+source:
+  model: model_name           # SQL model to use
+parameters: []                # Interactive filters (optional)
+chart:
+  type: line                  # Chart type
+  # ... type-specific config
+```
+
+### Chart Types
+
+**Line / Bar / Area** — time series and categories:
+```yaml
+chart:
+  type: line          # or bar, area
+  x: { field: date, type: temporal }
+  y: { field: revenue, format: "$,.0f" }
+  series:
+    field: category   # Multi-series by grouping field (optional)
+```
+
+**Pie / Donut** — part-to-whole:
+```yaml
+chart:
+  type: pie           # or donut
+  x: { field: segment, type: nominal }
+  y: { field: amount, format: "$,.0f" }
+```
+
+**Scatter** — correlations with optional size/group/regression:
+```yaml
+chart:
+  type: scatter
+  x: { field: revenue, type: quantitative }
+  y: { field: orders, type: quantitative }
+  size: { field: avg_value, min: 8, max: 40 }
+  group: { field: region }
+  regression: { type: linear, show_equation: true, show_r_squared: true }
+```
+
+**KPI** — single metric with comparison:
+```yaml
+chart:
+  type: kpi
+  value: { field: value }
+  format: { type: currency, currency: USD, decimals: 0 }
+  comparison: { enabled: true, field: previous_value, type: percent_change }
+```
+
+**Heatmap** — two-dimensional intensity:
+```yaml
+chart:
+  type: heatmap
+  x: { field: hour, type: ordinal }
+  y: { field: day, type: ordinal }
+  value: { field: count }
+  color_range: { min: '#EBF5FB', max: '#1A5276' }
+```
+
+**Funnel** — conversion stages:
+```yaml
+chart:
+  type: funnel
+  stage: { field: stage_name }
+  value: { field: user_count }
+```
+
+**Waterfall** — incremental deltas:
+```yaml
+chart:
+  type: waterfall
+  category: { field: label }
+  value: { field: amount }
+  total_field: is_total
+```
+
+**Gauge** — single metric dial:
+```yaml
+chart:
+  type: gauge
+  value: { field: score }
+  min: 0
+  max: 100
+  thresholds:
+    - { value: 60, color: '#EF4444' }
+    - { value: 85, color: '#F59E0B' }
+    - { value: 100, color: '#22C55E' }
+```
+
+**Combo** — mixed types with dual y-axes:
+```yaml
+chart:
+  type: combo
+  x: { field: date, type: temporal }
+  series:
+    columns:
+      - { field: revenue, type: bar, axis: left, color: "#3B82F6" }
+      - { field: margin_pct, type: line, axis: right, color: "#10B981" }
+  axes:
+    left: { format: "$,.0f", label: Revenue }
+    right: { format: ".0%", label: Margin }
+```
+
+### Multi-Series
+
+**Long format** — group by a field:
+```yaml
+series:
+  field: region
+  colors:
+    North: "#3B82F6"
+    South: "#EF4444"
+```
+
+**Wide format** — explicit columns:
+```yaml
+series:
+  columns:
+    - { field: revenue, name: Revenue, color: "#3B82F6" }
+    - { field: cost, name: Cost, color: "#EF4444", style: dashed }
+```
+
+### Stacking
+
+```yaml
+chart:
+  type: bar
+  stacking: stacked    # or "percent" (normalizes to 100%)
+```
+
+### Parameters
+
+```yaml
+parameters:
+  - name: date_range
+    type: date_range
+    default: last_30_days
+
+  - name: region
+    type: select
+    options: [North, South, East, West]
+    default: North
+
+  - name: category
+    type: dynamic_select
+    source: { model: category_options, value_field: id, label_field: name }
+```
+
+**Presets for date_range:** today, yesterday, last_7_days, last_30_days, last_90_days, last_365_days, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year
+
+### Drill-Down
+
+```yaml
+drillDown:
+  chart: detail-chart    # Target chart name
+  field: category        # Field to pass as filter
+  columns:               # Optional table columns on landing
+    - { field: name, label: Name }
+    - { field: revenue, label: Revenue, format: "$,.0f" }
+```
+
+### Gradients and Colors
+
+```yaml
+chart:
+  gradient: true                        # Auto gradient
+  color: "#3B82F6"                      # Single color override
+  color:                                # Conditional coloring
+    conditions:
+      - { when: "> 0", color: "#10B981" }
+      - { when: "< 0", color: "#EF4444" }
+    default: "#6B7280"
+```
+
+## Dashboards (`dashboards/*.yaml`)
+
+12-column grid layout with chart and text widgets.
+
+```yaml
+name: overview
+title: Executive Overview
+
+filters:
+  - { name: date_range, type: date_range, default: last_30_days }
+
+layout:
+  gap: 16
+  rows:
+    - height: 180
+      widgets:
+        - { type: chart, ref: revenue-kpi, cols: 3 }
+        - { type: chart, ref: orders-kpi, cols: 3 }
+        - { type: chart, ref: customers-kpi, cols: 6 }
+    - height: 400
+      widgets:
+        - { type: chart, ref: revenue-trend, cols: 8 }
+        - type: text
+          cols: 4
+          content: |
+            ## Summary
+            Revenue: **{{revenue-kpi}}**
+            vs last month: {{revenue-kpi@previous_month}}
+```
+
+**KPI references in text:** `{{chart}}`, `{{chart.field}}`, `{{chart@preset}}`
+
+## Connections (`connections/*.yaml`)
+
+```yaml
+# DuckDB (local file)
+name: local
+type: duckdb
+path: ./data/analytics.duckdb
+
+# PostgreSQL
+name: warehouse
+type: postgres
+host: ${DB_HOST}
+port: 5432
+database: analytics
+user: ${DB_USER}
+password: ${DB_PASSWORD}
+ssl: true
+```
+
+**Supported:** DuckDB, PostgreSQL, MySQL, SQLite, Snowflake
+
+Use `${ENV_VAR}` for credentials. Never commit secrets.
+
+## Axis Types
+
+| Type | Use | Example |
+|------|-----|---------|
+| `temporal` | Dates/times | `2024-01-15` |
+| `ordinal` | Categories | `Electronics` |
+| `quantitative` | Numbers | `250.5` |
+
+## Number Formats (d3-format)
+
+| Format | Output | Use |
+|--------|--------|-----|
+| `$,.0f` | $1,234 | Currency |
+| `,.0f` | 1,234 | Numbers |
+| `.2%` | 12.34% | Percentages |
+| `.2s` | 1.2M | SI prefix |
+
+## Theme (`yamchart.yaml`)
+
+```yaml
+theme:
+  palette: ["#3B82F6", "#EF4444", "#10B981", "#F59E0B"]
+  gradient: false
+  opacity: 1.0
+```

package/dist/test-N4KIIKQN.js

@@ -0,0 +1,221 @@
+import {
+  detail,
+  error,
+  header,
+  newline,
+  success,
+  warning
+} from "./chunk-HJVVHYVN.js";
+
+// src/commands/test.ts
+import { readFile, readdir, access } from "fs/promises";
+import { join, extname } from "path";
+import { parse as parseYaml } from "yaml";
+import {
+  parseModelMetadata,
+  DuckDBConnector,
+  runAll,
+  renderTemplate,
+  createTemplateContext,
+  expandDatePreset,
+  isDatePreset
+} from "@yamchart/query";
+async function testProject(projectDir, modelFilter, options) {
+  const projectPath = join(projectDir, "yamchart.yaml");
+  const projectContent = await readFile(projectPath, "utf-8");
+  const projectConfig = parseYaml(projectContent);
+  const connName = options.connection || projectConfig.defaults?.connection;
+  if (!connName) {
+    throw new Error(
+      "No connection specified. Use --connection or set defaults.connection in yamchart.yaml"
+    );
+  }
+  const connConfig = await loadConnectionConfig(projectDir, connName);
+  if (connConfig.type !== "duckdb") {
+    throw new Error(`Test command currently supports DuckDB only, got "${connConfig.type}"`);
+  }
+  const dbPathRaw = connConfig.config.path;
+  const dbPath = dbPathRaw.startsWith("/") ? dbPathRaw : join(projectDir, dbPathRaw);
+  const modelsDir = join(projectDir, "models");
+  const allModels = await loadModels(modelsDir);
+  let modelsToTest = allModels;
+  if (modelFilter) {
+    modelsToTest = allModels.filter((m) => m.name === modelFilter);
+    if (modelsToTest.length === 0) {
+      throw new Error(`Model "${modelFilter}" not found`);
+    }
+  }
+  const refs = {};
+  for (const m of allModels) {
+    refs[m.name] = m.name;
+  }
+  const testInputs = [];
+  for (const model of modelsToTest) {
+    try {
+      const compiledSql = compileWithDefaults(model.sql, model.metadata, refs);
+      testInputs.push({ compiledSql, metadata: model.metadata });
+    } catch {
+      testInputs.push({ compiledSql: model.sql, metadata: model.metadata });
+    }
+  }
+  const connector = new DuckDBConnector({ path: dbPath });
+  try {
+    await connector.connect();
+    const suite = await runAll(testInputs, connector);
+    return { success: suite.failed === 0, suite, connectionName: connName };
+  } finally {
+    await connector.disconnect();
+  }
+}
+async function loadConnectionConfig(projectDir, connName) {
+  const yamlPath = join(projectDir, "connections", `${connName}.yaml`);
+  const ymlPath = join(projectDir, "connections", `${connName}.yml`);
+  let connPath = yamlPath;
+  try {
+    await access(yamlPath);
+  } catch {
+    try {
+      await access(ymlPath);
+      connPath = ymlPath;
+    } catch {
+      throw new Error(`Connection "${connName}" not found at connections/${connName}.yaml`);
+    }
+  }
+  const connContent = await readFile(connPath, "utf-8");
+  return parseYaml(connContent);
+}
+function resolveDynamicDefault(value) {
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "current_date()" || trimmed === "current_date" || trimmed === "now()" || trimmed.includes("current_date")) {
+    return formatISODate(/* @__PURE__ */ new Date());
+  }
+  return value;
+}
+function formatISODate(date) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+function compileWithDefaults(sql, metadata, refs) {
+  const params = {};
+  if (metadata.params) {
+    for (const p of metadata.params) {
+      if (p.default !== void 0) {
+        params[p.name] = resolveDynamicDefault(p.default);
+      }
+    }
+  }
+  if (typeof params.date_range === "string" && isDatePreset(params.date_range)) {
+    const range = expandDatePreset(params.date_range);
+    if (range) {
+      params.start_date = range.start_date;
+      params.end_date = range.end_date;
+    }
+  }
+  const context = createTemplateContext(params, refs);
+  return renderTemplate(sql, context);
+}
+async function loadModels(dir) {
+  const models = [];
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return models;
+  }
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      const subModels = await loadModels(fullPath);
+      models.push(...subModels);
+    } else if (extname(entry.name) === ".sql") {
+      const content = await readFile(fullPath, "utf-8");
+      try {
+        const parsed = parseModelMetadata(content);
+        models.push({ name: parsed.name, sql: parsed.sql, metadata: parsed });
+      } catch {
+      }
+    }
+  }
+  return models;
+}
+function formatTestOutput(result, connectionName) {
+  const { suite } = result;
+  const testedModels = suite.models.filter(
+    (m) => m.schemaCheck || m.assertions.length > 0 || m.error
+  );
+  header(`Testing ${suite.models.length} model(s) against ${connectionName}...`);
+  for (const model of suite.models) {
+    const hasChecks = model.schemaCheck || model.assertions.length > 0 || model.error;
+    if (!hasChecks) continue;
+    console.log(`  ${model.modelName}`);
+    if (model.error) {
+      error(`    error: ${model.error}`);
+      continue;
+    }
+    if (model.schemaCheck) {
+      formatSchemaCheck(model.schemaCheck);
+    }
+    for (const assertion of model.assertions) {
+      formatAssertion(assertion);
+    }
+    newline();
+  }
+  const totalChecks = suite.passed + suite.failed;
+  const summary = `${testedModels.length} model(s), ${totalChecks} check(s): ${suite.passed} passed, ${suite.failed} failed`;
+  const skippedSuffix = suite.skipped > 0 ? ` (${suite.skipped} skipped)` : "";
+  const durationSuffix = ` (${suite.durationMs.toFixed(0)}ms)`;
+  if (suite.failed === 0) {
+    success(`${summary}${skippedSuffix}${durationSuffix}`);
+  } else {
+    error(`${summary}${skippedSuffix}${durationSuffix}`);
+  }
+}
+function formatSchemaCheck(check) {
+  if (check.passed) {
+    success(`    schema: returns expected columns (${check.expectedColumns.join(", ")})`);
+    return;
+  }
+  const issues = [];
+  if (check.missingColumns.length > 0) {
+    issues.push(`missing: ${check.missingColumns.join(", ")}`);
+  }
+  for (const m of check.typeMismatches) {
+    issues.push(`${m.column}: expected ${m.expected}, got ${m.actual}`);
+  }
+  error(`    schema: ${issues.join("; ")}`);
+}
+function formatAssertion(assertion) {
+  const label = extractAssertionLabel(assertion.sql);
+  if (assertion.warning) {
+    warning(`    ${label}`);
+    detail(`      ${assertion.warning}`);
+  }
+  if (assertion.error) {
+    error(`    test: ${label} -- error`);
+    detail(`      ${assertion.error}`);
+  } else if (assertion.passed) {
+    success(`    test: ${label}`);
+  } else {
+    error(`    test: ${label} -- ${assertion.violationCount} failing row(s)`);
+    if (assertion.sampleViolations) {
+      for (const row of assertion.sampleViolations.slice(0, 3)) {
+        detail(`      ${JSON.stringify(row)}`);
+      }
+    }
+  }
+}
+function extractAssertionLabel(sql) {
+  const whereMatch = sql.match(/WHERE\s+(.+?)$/i);
+  if (whereMatch?.[1]) {
+    const clause = whereMatch[1].trim();
+    return clause.length > 60 ? clause.slice(0, 57) + "..." : clause;
+  }
+  return sql.length > 60 ? sql.slice(0, 57) + "..." : sql;
+}
+export {
+  formatTestOutput,
+  testProject
+};
+//# sourceMappingURL=test-N4KIIKQN.js.map

package/dist/test-N4KIIKQN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/test.ts"],"sourcesContent":["import { readFile, readdir, access } from 'fs/promises';\nimport { join, extname } from 'path';\nimport { parse as parseYaml } from 'yaml';\nimport {\n  parseModelMetadata,\n  DuckDBConnector,\n  runAll,\n  renderTemplate,\n  createTemplateContext,\n  expandDatePreset,\n  isDatePreset,\n  type TestSuiteResult,\n  type TestModelInput,\n} from '@yamchart/query';\nimport type { ModelMetadata } from '@yamchart/schema';\nimport * as output from '../utils/output.js';\n\nexport interface TestOptions {\n  connection?: string;\n  json?: boolean;\n}\n\nexport interface TestResult {\n  success: boolean;\n  suite: TestSuiteResult;\n  connectionName: string;\n}\n\nexport async function testProject(\n  projectDir: string,\n  modelFilter: string | undefined,\n  options: TestOptions,\n): Promise<TestResult> {\n  const projectPath = join(projectDir, 'yamchart.yaml');\n  const projectContent = await readFile(projectPath, 'utf-8');\n  const projectConfig = parseYaml(projectContent) as {\n    name: string;\n    defaults?: { connection?: string };\n  };\n\n  const connName = options.connection || projectConfig.defaults?.connection;\n  if (!connName) {\n    throw new Error(\n      'No connection specified. Use --connection or set defaults.connection in yamchart.yaml',\n    );\n  }\n\n  const connConfig = await loadConnectionConfig(projectDir, connName);\n\n  if (connConfig.type !== 'duckdb') {\n    throw new Error(`Test command currently supports DuckDB only, got \"${connConfig.type}\"`);\n  }\n\n  const dbPathRaw = connConfig.config.path as string;\n  const dbPath = dbPathRaw.startsWith('/') ? dbPathRaw : join(projectDir, dbPathRaw);\n\n  const modelsDir = join(projectDir, 'models');\n  const allModels = await loadModels(modelsDir);\n\n  let modelsToTest = allModels;\n  if (modelFilter) {\n    modelsToTest = allModels.filter((m) => m.name === modelFilter);\n    if (modelsToTest.length === 0) {\n      throw new Error(`Model \"${modelFilter}\" not found`);\n    }\n  }\n\n  // Build refs map: model name -> model name (identity for standalone execution)\n  const refs: Record<string, string> = {};\n  for (const m of allModels) {\n    refs[m.name] = m.name;\n  }\n\n  const testInputs: TestModelInput[] = [];\n  for (const model of modelsToTest) {\n    try {\n      const compiledSql = compileWithDefaults(model.sql, model.metadata, refs);\n      testInputs.push({ compiledSql, metadata: model.metadata });\n    } catch {\n      // If compilation fails, include raw SQL so the error is reported during test execution\n      testInputs.push({ compiledSql: model.sql, metadata: model.metadata });\n    }\n  }\n\n  const connector = new DuckDBConnector({ path: dbPath });\n  try {\n    await connector.connect();\n    const suite = await runAll(testInputs, connector);\n    return { success: suite.failed === 0, suite, connectionName: connName };\n  } finally {\n    await connector.disconnect();\n  }\n}\n\nasync function loadConnectionConfig(\n  projectDir: string,\n  connName: string,\n): Promise<{ type: string; config: Record<string, unknown> }> {\n  const yamlPath = join(projectDir, 'connections', `${connName}.yaml`);\n  const ymlPath = join(projectDir, 'connections', `${connName}.yml`);\n\n  let connPath = yamlPath;\n  try {\n    await access(yamlPath);\n  } catch {\n    try {\n      await access(ymlPath);\n      connPath = ymlPath;\n    } catch {\n      throw new Error(`Connection \"${connName}\" not found at connections/${connName}.yaml`);\n    }\n  }\n\n  const connContent = await readFile(connPath, 'utf-8');\n  return parseYaml(connContent) as { type: string; config: Record<string, unknown> };\n}\n\nfunction resolveDynamicDefault(value: string): string {\n  const trimmed = value.trim().toLowerCase();\n  if (\n    trimmed === 'current_date()' ||\n    trimmed === 'current_date' ||\n    trimmed === 'now()' ||\n    trimmed.includes('current_date')\n  ) {\n    return formatISODate(new Date());\n  }\n  return value;\n}\n\nfunction formatISODate(date: Date): string {\n  const y = date.getFullYear();\n  const m = String(date.getMonth() + 1).padStart(2, '0');\n  const d = String(date.getDate()).padStart(2, '0');\n  return `${y}-${m}-${d}`;\n}\n\nfunction compileWithDefaults(\n  sql: string,\n  metadata: ModelMetadata,\n  refs: Record<string, string>,\n): string {\n  const params: Record<string, unknown> = {};\n  if (metadata.params) {\n    for (const p of metadata.params) {\n      if (p.default !== undefined) {\n        params[p.name] = resolveDynamicDefault(p.default);\n      }\n    }\n  }\n\n  // Expand date presets into start_date/end_date\n  if (typeof params.date_range === 'string' && isDatePreset(params.date_range)) {\n    const range = expandDatePreset(params.date_range);\n    if (range) {\n      params.start_date = range.start_date;\n      params.end_date = range.end_date;\n    }\n  }\n\n  const context = createTemplateContext(params, refs);\n  return renderTemplate(sql, context);\n}\n\ninterface LoadedModel {\n  name: string;\n  sql: string;\n  metadata: ModelMetadata;\n}\n\nasync function loadModels(dir: string): Promise<LoadedModel[]> {\n  const models: LoadedModel[] = [];\n\n  let entries;\n  try {\n    entries = await readdir(dir, { withFileTypes: true });\n  } catch {\n    return models;\n  }\n\n  for (const entry of entries) {\n    const fullPath = join(dir, entry.name);\n    if (entry.isDirectory()) {\n      const subModels = await loadModels(fullPath);\n      models.push(...subModels);\n    } else if (extname(entry.name) === '.sql') {\n      const content = await readFile(fullPath, 'utf-8');\n      try {\n        const parsed = parseModelMetadata(content);\n        models.push({ name: parsed.name, sql: parsed.sql, metadata: parsed });\n      } catch {\n        // Skip unparseable models\n      }\n    }\n  }\n\n  return models;\n}\n\nexport function formatTestOutput(result: TestResult, connectionName: string): void {\n  const { suite } = result;\n\n  const testedModels = suite.models.filter(\n    (m) => m.schemaCheck || m.assertions.length > 0 || m.error,\n  );\n\n  output.header(`Testing ${suite.models.length} model(s) against ${connectionName}...`);\n\n  for (const model of suite.models) {\n    const hasChecks = model.schemaCheck || model.assertions.length > 0 || model.error;\n    if (!hasChecks) continue;\n\n    console.log(`  ${model.modelName}`);\n\n    if (model.error) {\n      output.error(`    error: ${model.error}`);\n      continue;\n    }\n\n    if (model.schemaCheck) {\n      formatSchemaCheck(model.schemaCheck);\n    }\n\n    for (const assertion of model.assertions) {\n      formatAssertion(assertion);\n    }\n\n    output.newline();\n  }\n\n  // Summary line\n  const totalChecks = suite.passed + suite.failed;\n  const summary = `${testedModels.length} model(s), ${totalChecks} check(s): ${suite.passed} passed, ${suite.failed} failed`;\n  const skippedSuffix = suite.skipped > 0 ? ` (${suite.skipped} skipped)` : '';\n  const durationSuffix = ` (${suite.durationMs.toFixed(0)}ms)`;\n\n  if (suite.failed === 0) {\n    output.success(`${summary}${skippedSuffix}${durationSuffix}`);\n  } else {\n    output.error(`${summary}${skippedSuffix}${durationSuffix}`);\n  }\n}\n\nfunction formatSchemaCheck(check: NonNullable<TestSuiteResult['models'][0]['schemaCheck']>): void {\n  if (check.passed) {\n    output.success(`    schema: returns expected columns (${check.expectedColumns.join(', ')})`);\n    return;\n  }\n\n  const issues: string[] = [];\n  if (check.missingColumns.length > 0) {\n    issues.push(`missing: ${check.missingColumns.join(', ')}`);\n  }\n  for (const m of check.typeMismatches) {\n    issues.push(`${m.column}: expected ${m.expected}, got ${m.actual}`);\n  }\n  output.error(`    schema: ${issues.join('; ')}`);\n}\n\nfunction formatAssertion(assertion: TestSuiteResult['models'][0]['assertions'][0]): void {\n  const label = extractAssertionLabel(assertion.sql);\n\n  if (assertion.warning) {\n    output.warning(`    ${label}`);\n    output.detail(`      ${assertion.warning}`);\n  }\n\n  if (assertion.error) {\n    output.error(`    test: ${label} -- error`);\n    output.detail(`      ${assertion.error}`);\n  } else if (assertion.passed) {\n    output.success(`    test: ${label}`);\n  } else {\n    output.error(`    test: ${label} -- ${assertion.violationCount} failing row(s)`);\n    if (assertion.sampleViolations) {\n      for (const row of assertion.sampleViolations.slice(0, 3)) {\n        output.detail(`      ${JSON.stringify(row)}`);\n      }\n    }\n  }\n}\n\nfunction extractAssertionLabel(sql: string): string {\n  const whereMatch = sql.match(/WHERE\\s+(.+?)$/i);\n  if (whereMatch?.[1]) {\n    const clause = whereMatch[1].trim();\n    return clause.length > 60 ? clause.slice(0, 57) + '...' : clause;\n  }\n  return sql.length > 60 ? sql.slice(0, 57) + '...' : sql;\n}\n"],"mappings":"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","names":[]}

package/dist/update-QHLCWS56.js

@@ -0,0 +1,75 @@
+import {
+  checkForUpdate
+} from "./chunk-3CLMQNNR.js";
+import {
+  detail,
+  error,
+  info,
+  spinner,
+  success
+} from "./chunk-HJVVHYVN.js";
+
+// src/commands/update.ts
+import { execSync } from "child_process";
+import { readFile, writeFile, mkdir, access } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+async function runUpdate(currentVersion) {
+  const spin = spinner("Checking for updates...");
+  const update = await checkForUpdate(currentVersion);
+  spin.stop();
+  if (!update) {
+    success(`yamchart ${currentVersion} is the latest version`);
+  } else {
+    info(`Update available: ${update.current} \u2192 ${update.latest}`);
+    const installSpin = spinner("Installing yamchart@latest...");
+    try {
+      execSync("npm install -g yamchart@latest", { stdio: "pipe" });
+      installSpin.stop();
+      success(`Updated yamchart ${update.current} \u2192 ${update.latest}`);
+    } catch {
+      installSpin.stop();
+      error("Automatic install failed. Run manually:");
+      detail("npm install -g yamchart@latest");
+      return;
+    }
+  }
+  await refreshDocs();
+}
+async function refreshDocs() {
+  const projectFile = join(process.cwd(), "yamchart.yaml");
+  try {
+    await access(projectFile);
+  } catch {
+    return;
+  }
+  const bundled = await readBundledReference();
+  if (!bundled) return;
+  const refPath = join(process.cwd(), "docs", "yamchart-reference.md");
+  try {
+    const existing = await readFile(refPath, "utf-8");
+    if (existing === bundled) return;
+  } catch {
+  }
+  await mkdir(join(process.cwd(), "docs"), { recursive: true });
+  await writeFile(refPath, bundled, "utf-8");
+  success("Updated docs/yamchart-reference.md");
+}
+async function readBundledReference() {
+  const distPath = join(__dirname, "templates", "default", "docs", "yamchart-reference.md");
+  const srcPath = join(__dirname, "..", "templates", "default", "docs", "yamchart-reference.md");
+  for (const path of [distPath, srcPath]) {
+    try {
+      return await readFile(path, "utf-8");
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+export {
+  refreshDocs,
+  runUpdate
+};
+//# sourceMappingURL=update-QHLCWS56.js.map

package/dist/update-QHLCWS56.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/update.ts"],"sourcesContent":["import { execSync } from 'child_process';\nimport { readFile, writeFile, mkdir, access } from 'fs/promises';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\nimport * as output from '../utils/output.js';\nimport { checkForUpdate } from '../utils/update-check.js';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport async function runUpdate(currentVersion: string): Promise<void> {\n  const spin = output.spinner('Checking for updates...');\n\n  const update = await checkForUpdate(currentVersion);\n\n  spin.stop();\n\n  if (!update) {\n    output.success(`yamchart ${currentVersion} is the latest version`);\n  } else {\n    output.info(`Update available: ${update.current} → ${update.latest}`);\n    const installSpin = output.spinner('Installing yamchart@latest...');\n    try {\n      execSync('npm install -g yamchart@latest', { stdio: 'pipe' });\n      installSpin.stop();\n      output.success(`Updated yamchart ${update.current} → ${update.latest}`);\n    } catch {\n      installSpin.stop();\n      output.error('Automatic install failed. Run manually:');\n      output.detail('npm install -g yamchart@latest');\n      return;\n    }\n  }\n\n  // Refresh project docs if we're in a yamchart project\n  await refreshDocs();\n}\n\n/**\n * Refresh docs/yamchart-reference.md from the bundled template.\n * Only runs when yamchart.yaml exists in the current directory.\n */\nexport async function refreshDocs(): Promise<void> {\n  const projectFile = join(process.cwd(), 'yamchart.yaml');\n  try {\n    await access(projectFile);\n  } catch {\n    return; // Not in a yamchart project\n  }\n\n  const bundled = await readBundledReference();\n  if (!bundled) return;\n\n  const refPath = join(process.cwd(), 'docs', 'yamchart-reference.md');\n\n  try {\n    const existing = await readFile(refPath, 'utf-8');\n    if (existing === bundled) return; // Already up to date\n  } catch {\n    // File doesn't exist — create it\n  }\n\n  await mkdir(join(process.cwd(), 'docs'), { recursive: true });\n  await writeFile(refPath, bundled, 'utf-8');\n  output.success('Updated docs/yamchart-reference.md');\n}\n\nasync function readBundledReference(): Promise<string | null> {\n  // Production: dist/templates/default/docs/yamchart-reference.md\n  const distPath = join(__dirname, 'templates', 'default', 'docs', 'yamchart-reference.md');\n  // Development: src/commands → src/templates\n  const srcPath = join(__dirname, '..', 'templates', 'default', 'docs', 'yamchart-reference.md');\n\n  for (const path of [distPath, srcPath]) {\n    try {\n      return await readFile(path, 'utf-8');\n    } catch {\n      continue;\n    }\n  }\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,gBAAgB;AACzB,SAAS,UAAU,WAAW,OAAO,cAAc;AACnD,SAAS,MAAM,eAAe;AAC9B,SAAS,qBAAqB;AAI9B,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAExD,eAAsB,UAAU,gBAAuC;AACrE,QAAM,OAAc,QAAQ,yBAAyB;AAErD,QAAM,SAAS,MAAM,eAAe,cAAc;AAElD,OAAK,KAAK;AAEV,MAAI,CAAC,QAAQ;AACX,IAAO,QAAQ,YAAY,cAAc,wBAAwB;AAAA,EACnE,OAAO;AACL,IAAO,KAAK,qBAAqB,OAAO,OAAO,WAAM,OAAO,MAAM,EAAE;AACpE,UAAM,cAAqB,QAAQ,+BAA+B;AAClE,QAAI;AACF,eAAS,kCAAkC,EAAE,OAAO,OAAO,CAAC;AAC5D,kBAAY,KAAK;AACjB,MAAO,QAAQ,oBAAoB,OAAO,OAAO,WAAM,OAAO,MAAM,EAAE;AAAA,IACxE,QAAQ;AACN,kBAAY,KAAK;AACjB,MAAO,MAAM,yCAAyC;AACtD,MAAO,OAAO,gCAAgC;AAC9C;AAAA,IACF;AAAA,EACF;AAGA,QAAM,YAAY;AACpB;AAMA,eAAsB,cAA6B;AACjD,QAAM,cAAc,KAAK,QAAQ,IAAI,GAAG,eAAe;AACvD,MAAI;AACF,UAAM,OAAO,WAAW;AAAA,EAC1B,QAAQ;AACN;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,qBAAqB;AAC3C,MAAI,CAAC,QAAS;AAEd,QAAM,UAAU,KAAK,QAAQ,IAAI,GAAG,QAAQ,uBAAuB;AAEnE,MAAI;AACF,UAAM,WAAW,MAAM,SAAS,SAAS,OAAO;AAChD,QAAI,aAAa,QAAS;AAAA,EAC5B,QAAQ;AAAA,EAER;AAEA,QAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;AAC5D,QAAM,UAAU,SAAS,SAAS,OAAO;AACzC,EAAO,QAAQ,oCAAoC;AACrD;AAEA,eAAe,uBAA+C;AAE5D,QAAM,WAAW,KAAK,WAAW,aAAa,WAAW,QAAQ,uBAAuB;AAExF,QAAM,UAAU,KAAK,WAAW,MAAM,aAAa,WAAW,QAAQ,uBAAuB;AAE7F,aAAW,QAAQ,CAAC,UAAU,OAAO,GAAG;AACtC,QAAI;AACF,aAAO,MAAM,SAAS,MAAM,OAAO;AAAA,IACrC,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yamchart",
-  "version": "0.1.2",
+  "version": "0.3.1",
   "description": "Git-native business intelligence dashboards",
   "type": "module",
   "license": "MIT",
@@ -33,14 +33,19 @@
     }
   },
   "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.0",
+    "fast-glob": "^3.3.3",
+    "minimatch": "^10.1.2",
     "ora": "^8.0.0",
     "picocolors": "^1.1.0",
     "yaml": "^2.7.0",
+    "zod": "^3.24.0",
+    "@yamchart/auth-local": "0.1.0",
     "@yamchart/query": "0.1.2",
-    "@yamchart/schema": "0.1.2",
-    "@yamchart/server": "0.1.2"
+    "@yamchart/server": "0.1.2",
+    "@yamchart/schema": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",