yamchart 0.7.2 → 0.8.0

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

@@ -71,6 +71,10 @@ yamchart sync-warehouse --json       # Output sync summary as JSON
 yamchart lineage <model>             # Show upstream dependency tree
 yamchart lineage <model> --depth 2   # Limit recursion depth
 yamchart lineage <model> --json      # JSON output
+yamchart semantic                    # List semantic layer entities
+yamchart semantic --json             # JSON output
+yamchart semantic query -e <entity> -m <measures>   # Structured query
+yamchart semantic query -e <entity> -m <measures> --sql  # SQL only
 ```
 
 ## SQL Models (`models/*.sql`)
@@ -264,6 +268,28 @@ Column headers are automatically humanized (`total_revenue` → "Total Revenue")
 **Summary row:** Per-column `summary` with `sum`, `avg`, `min`, `max`, or `count`. Computed client-side, formatted with the column's `format`, sticky at the bottom.
 **Default sort:** `sort: { field: revenue, direction: desc }` sets the initial sort column and direction. Users can still click headers to change sorting interactively.
 
+**Pivot table** — transform flat query results into grouped, pivoted tables with subtotals and heatmap coloring:
+```yaml
+chart:
+  type: table
+  pivot:
+    rows: [plan, event]          # Row grouping fields (first = group, rest = detail)
+    columns: quarter             # Field whose distinct values become column headers
+    values:
+      - field: event_count
+        aggregate: sum           # sum | avg | min | max | count (default: sum)
+        format: "$"              # Optional number format
+        heatmap: true            # Enable green heatmap coloring (optional, off by default)
+    subtotals: true              # Per-group subtotal rows (default: true)
+    grandTotals: true            # Grand total row (default: true)
+    heatmap:
+      color: "#4CAF50"           # Heatmap color (default: green)
+      scope: column              # column | global — scale per-column or across all
+```
+
+The SQL model should return flat rows with all fields (e.g. `SELECT plan, event, quarter, count(*) as event_count FROM events GROUP BY plan, event, quarter`). Yamchart pivots client-side.
+Row groups are collapsible (click to toggle). Heatmap coloring auto-scales per column by default.
+
 **Combo** — mixed types with dual y-axes:
 ```yaml
 chart:
@@ -357,7 +383,7 @@ parameters:
 
 ### Drill-Down
 
-Right-click any chart element to navigate to a related detail chart with filtered data.
+Click any chart element to open a context menu with options to cross-filter, view detail data, or navigate to a related chart.
 
 ```yaml
 drillDown:
@@ -772,6 +798,77 @@ fct_revenue
 
 **Note:** dbt lineage data requires `sync-dbt` with a dbt project that has run `dbt compile` or `dbt run` (which generates `target/manifest.json`). If the manifest is missing, `sync-dbt` will warn you. Yamchart model lineage works independently by parsing SQL files directly.
 
+## Semantic Layer
+
+The semantic layer auto-generates structured query entities from your catalog. It classifies columns as measures (numeric, aggregatable) or dimensions (categorical, temporal), enabling structured queries without writing SQL.
+
+### How It Works
+
+1. Run `yamchart sync-dbt` or `yamchart sync-warehouse` to populate `.yamchart/catalog.json`
+2. The semantic layer automatically builds entities from gold/marts/core tables (or tables prefixed with `dim_`, `fct_`, `fact_`)
+3. Query entities using the CLI or the AI advisor
+
+### Configuration
+
+Optional in `yamchart.yaml`:
+
+```yaml
+semantic:
+  include:
+    paths: [gold/, marts/, core/]       # Catalog paths to include (default)
+    prefixes: [dim_, fct_, fact_]        # Table name prefixes to include (default)
+```
+
+### CLI Commands
+
+```bash
+yamchart semantic                  # List all semantic entities
+yamchart semantic --json           # JSON output
+
+yamchart semantic query -e fct_revenue -m revenue,order_count -d region
+yamchart semantic query -e fct_revenue -m revenue -f region=US --limit 50
+yamchart semantic query -e fct_revenue -m revenue -d region --order revenue --desc
+yamchart semantic query -e fct_revenue -m revenue --sql    # Print SQL only
+yamchart semantic query -e fct_revenue -m revenue --json   # JSON output
+```
+
+| Option | Description |
+|--------|-------------|
+| `-e, --entity <name>` | Entity name (required) |
+| `-m, --measures <m1,m2>` | Comma-separated measures (required) |
+| `-d, --dimensions <d1,d2>` | Comma-separated dimensions |
+| `-f, --filter <dim=value>` | Filter (repeatable) |
+| `--order <field>` | Order by field |
+| `--desc` | Descending order |
+| `-l, --limit <n>` | Row limit (default: 100) |
+| `-c, --connection <name>` | Override connection |
+| `--sql` | Print compiled SQL without executing |
+| `--json` | JSON output |
+
+### Supported Aggregations
+
+| Type | SQL Generated |
+|------|--------------|
+| `sum` | `SUM("column")` |
+| `count` | `COUNT("column")` |
+| `avg` | `AVG("column")` |
+| `min` | `MIN("column")` |
+| `max` | `MAX("column")` |
+| `count_distinct` | `COUNT(DISTINCT "column")` |
+
+### Advisor Integration
+
+The AI advisor can discover and query the semantic layer:
+
+- **`list_semantic_entities`** — Lists all entities with measures and dimensions
+- **`semantic_query`** — Compiles a structured query to SQL
+
+```bash
+yamchart advisor "What is total revenue by region?"
+```
+
+The advisor uses `list_semantic_entities` to discover available fields, then `semantic_query` to compile and execute the query.
+
 ## Axis Types
 
 | Type | Use | Example |
@@ -781,6 +878,130 @@ fct_revenue
 | `nominal` | Unordered categories | `Electronics` |
 | `quantitative` | Numbers | `250.5` |
 
+## Chart Events (`events.yaml`)
+
+Annotate time-series charts with notable dates — product launches, outages, campaigns, etc. Events appear as dashed vertical lines (point events) or shaded regions (range events) on line, bar, area, and combo charts.
+
+Create `events.yaml` in your project root:
+
+```yaml
+events:
+  - date: "2025-01-15"
+    label: "V2 Launch"
+    description: "Shipped new pricing page"
+    color: "#10b981"
+
+  - date: "2025-02-01"
+    endDate: "2025-02-14"
+    label: "Promo Campaign"
+    color: "#3b82f6"
+
+  - date: "2025-03-01"
+    label: "Outage"
+    charts: [revenue-trend, orders-trend]   # Scope to specific charts
+```
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `date` | Yes | Event start date (ISO format) |
+| `endDate` | No | Event end date — creates a shaded range instead of a line |
+| `label` | Yes | Short label shown on the chart |
+| `description` | No | Longer description shown in tooltip and management UI |
+| `color` | No | Hex color for the line/region (default: theme text color) |
+| `charts` | No | Array of chart names — limits which charts show this event. Omit for all charts. |
+
+**Point events** (no `endDate`) render as dashed vertical lines. **Range events** (with `endDate`) render as semi-transparent shaded regions.
+
+**Management UI:** Access via the events icon in the top bar. Add, edit, and delete events with inline editing, date pickers, and chart scope selection.
+
+**Date clamping:** Events outside the chart's visible date range are automatically clamped to the chart boundaries, so a range extending beyond the data still renders correctly.
+
+## Chart Goals
+
+Add target lines, cumulative targets, or model-driven goal lines to line, bar, area, and combo charts. KPI and gauge charts support simple target values with progress display.
+
+### Fixed Goal — constant horizontal target line
+
+```yaml
+chart:
+  type: bar
+  x: { field: month, type: temporal }
+  y: { field: revenue, format: "$,.0f" }
+  goals:
+    - type: fixed
+      value: 100000
+      label: "Monthly Target"
+      color: "#22c55e"
+      style: dashed              # solid, dashed, or dotted
+      zone:
+        tolerance: 0.10          # Shaded band at ±10% of target
+```
+
+### Cumulative Goal — target value to reach by a deadline
+
+```yaml
+goals:
+  - type: cumulative
+    value: 1000000               # Target to reach
+    by: "2025-12-31"             # Deadline date
+    from: "2025-01-01"           # Optional start date (defaults to first data point)
+    label: "Annual Target"
+    color: "#f59e0b"
+    style: dashed
+    zone:
+      tolerance: 0.05
+```
+
+Renders as a diagonal line from `from` (or chart start) to `by`, showing the ideal pace toward the target.
+
+### Model Goal — target values from a SQL model
+
+```yaml
+goals:
+  - type: model
+    source:
+      model: revenue_targets     # SQL model name
+      value_field: target        # Column with target values
+      date_field: month          # Optional date column (aligns to x-axis)
+    label: "Plan"
+    color: "#8b5cf6"
+    style: dotted
+    zone:
+      tolerance: 0.10
+```
+
+The model is queried alongside the chart data. Each row provides a target value, plotted as a goal line that can vary over time.
+
+### KPI / Gauge Goal — target value with progress
+
+```yaml
+# KPI chart
+chart:
+  type: kpi
+  value: { field: revenue }
+  format: { type: currency, currency: USD }
+  goal:
+    value: 500000
+    label: "Q1 Target"
+    show_progress: true          # Shows progress bar and percentage
+    color: "#22c55e"
+
+# Gauge chart
+chart:
+  type: gauge
+  value: { field: score }
+  min: 0
+  max: 100
+  goal:
+    value: 85
+    label: "Target"
+    show_progress: true
+```
+
+### Goal Zones
+
+All goal types (fixed, cumulative, model) support a `zone` with `tolerance` (0–1). This renders a semi-transparent shaded band around the goal line at ±tolerance of the target value. For example, `tolerance: 0.10` on a target of 100,000 shades the 90,000–110,000 range.
+
 ## Number Formats (d3-format)
 
 | Format | Output | Use |

package/dist/{test-JSAWS5ZP.js → test-TXRZWNXK.js}

@@ -1,7 +1,7 @@
 import {
   createConnector,
   resolveConnection
-} from "./chunk-565OEBW7.js";
+} from "./chunk-OTAUP5RC.js";
 import {
   detail,
   error,
@@ -10,7 +10,7 @@ import {
   success,
   warning
 } from "./chunk-HJVVHYVN.js";
-import "./chunk-UDRJFEJU.js";
+import "./chunk-X6LQGWUX.js";
 import {
   createTemplateContext,
   expandDatePreset,
@@ -18,7 +18,8 @@ import {
   parseModelMetadata,
   renderTemplate,
   runAll
-} from "./chunk-SSUVEADJ.js";
+} from "./chunk-JYQKDWLG.js";
+import "./chunk-UND73EOB.js";
 import "./chunk-DGUM43GV.js";
 
 // src/commands/test.ts
@@ -191,4 +192,4 @@ export {
   formatTestOutput,
   testProject
 };
-//# sourceMappingURL=test-JSAWS5ZP.js.map
+//# sourceMappingURL=test-TXRZWNXK.js.map

package/dist/{test-JSAWS5ZP.js.map → test-TXRZWNXK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/test.ts"],"sourcesContent":["import { readFile, readdir } from 'fs/promises';\nimport { join, extname } from 'path';\nimport {\n  parseModelMetadata,\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';\nimport { resolveConnection, createConnector } from './connection-utils.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 connection = await resolveConnection(projectDir, options.connection);\n  const connector = createConnector(connection, projectDir);\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  try {\n    await connector.connect();\n    const suite = await runAll(testInputs, connector);\n    return { success: suite.failed === 0, suite, connectionName: connection.name };\n  } finally {\n    await connector.disconnect();\n  }\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":[]}
+{"version":3,"sources":["../src/commands/test.ts"],"sourcesContent":["import { readFile, readdir } from 'fs/promises';\nimport { join, extname } from 'path';\nimport {\n  parseModelMetadata,\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';\nimport { resolveConnection, createConnector } from './connection-utils.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 connection = await resolveConnection(projectDir, options.connection);\n  const connector = createConnector(connection, projectDir);\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  try {\n    await connector.connect();\n    const suite = await runAll(testInputs, connector);\n    return { success: suite.failed === 0, suite, connectionName: connection.name };\n  } finally {\n    await connector.disconnect();\n  }\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-UKMEWCSO.js

@@ -0,0 +1,220 @@
+import {
+  checkForUpdate,
+  fetchReleaseNotes
+} from "./chunk-F6QAWPYU.js";
+import {
+  detail,
+  error,
+  header,
+  info,
+  newline,
+  spinner,
+  success
+} from "./chunk-HJVVHYVN.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/update.ts
+import { execSync } from "child_process";
+import { createInterface } from "readline";
+import { readFile, writeFile, mkdir, access, readdir } from "fs/promises";
+import { join, dirname, basename } from "path";
+import { fileURLToPath } from "url";
+import { parse as parseYaml } from "yaml";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+async function runUpdate(currentVersion) {
+  const spin = spinner("Checking for updates...");
+  const update = await checkForUpdate(currentVersion, { skipCache: true });
+  spin.stop();
+  if (!update) {
+    success(`yamchart ${currentVersion} is the latest version`);
+  } else {
+    info(`Update available: ${update.current} \u2192 ${update.latest}`);
+    const notes = await fetchReleaseNotes(update.latest);
+    if (notes) {
+      newline();
+      header(`What's new in ${update.latest}:`);
+      for (const line of notes.split("\n")) {
+        detail(line);
+      }
+      newline();
+    }
+    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 refreshProjectFiles();
+}
+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;
+}
+async function refreshProjectFiles() {
+  const projectFile = join(process.cwd(), "yamchart.yaml");
+  try {
+    await access(projectFile);
+  } catch {
+    return;
+  }
+  await refreshDocs();
+  await refreshSkills();
+  await refreshClaudeMd();
+}
+async function refreshSkills() {
+  try {
+    await access(join(process.cwd(), "yamchart.yaml"));
+  } catch {
+    return;
+  }
+  const bundledDir = await getBundledSkillsDir();
+  if (!bundledDir) return;
+  let entries;
+  try {
+    entries = await readdir(bundledDir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  let updated = 0;
+  let created = 0;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const skillFile = join(bundledDir, entry.name, "SKILL.md");
+    let bundledContent;
+    try {
+      bundledContent = await readFile(skillFile, "utf-8");
+    } catch {
+      continue;
+    }
+    const targetDir = join(process.cwd(), ".claude", "skills", entry.name);
+    const targetFile = join(targetDir, "SKILL.md");
+    let isNew = false;
+    try {
+      const existing = await readFile(targetFile, "utf-8");
+      if (existing === bundledContent) continue;
+    } catch {
+      isNew = true;
+    }
+    await mkdir(targetDir, { recursive: true });
+    await writeFile(targetFile, bundledContent, "utf-8");
+    if (isNew) created++;
+    else updated++;
+  }
+  if (created > 0 || updated > 0) {
+    const parts = [];
+    if (created > 0) parts.push(`${created} new`);
+    if (updated > 0) parts.push(`${updated} updated`);
+    success(`Synced .claude/skills/ (${parts.join(", ")})`);
+  }
+}
+async function refreshClaudeMd(options = {}) {
+  try {
+    await access(join(process.cwd(), "yamchart.yaml"));
+  } catch {
+    return;
+  }
+  const bundled = await readBundledFile("CLAUDE.md");
+  if (!bundled) return;
+  const projectName = await getProjectName();
+  const content = bundled.replace(/\{\{name\}\}/g, projectName);
+  const targetPath = join(process.cwd(), "CLAUDE.md");
+  try {
+    const existing = await readFile(targetPath, "utf-8");
+    if (existing === content) return;
+    const confirmFn = options.confirm ?? promptConfirm;
+    const shouldOverwrite = await confirmFn(
+      "CLAUDE.md differs from the current template. Overwrite? (y/n) "
+    );
+    if (!shouldOverwrite) {
+      info("Skipped CLAUDE.md update");
+      return;
+    }
+  } catch {
+  }
+  await writeFile(targetPath, content, "utf-8");
+  success("Updated CLAUDE.md");
+}
+async function getBundledSkillsDir() {
+  const distPath = join(__dirname, "templates", "default", ".claude", "skills");
+  const srcPath = join(__dirname, "..", "templates", "default", ".claude", "skills");
+  for (const path of [distPath, srcPath]) {
+    try {
+      await access(path);
+      return path;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+async function readBundledFile(relativePath) {
+  const distPath = join(__dirname, "templates", "default", relativePath);
+  const srcPath = join(__dirname, "..", "templates", "default", relativePath);
+  for (const path of [distPath, srcPath]) {
+    try {
+      return await readFile(path, "utf-8");
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+async function getProjectName() {
+  try {
+    const raw = await readFile(join(process.cwd(), "yamchart.yaml"), "utf-8");
+    const parsed = parseYaml(raw);
+    if (parsed?.name) return parsed.name;
+  } catch {
+  }
+  return basename(process.cwd());
+}
+async function promptConfirm(message) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(message, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() === "y");
+    });
+  });
+}
+export {
+  refreshClaudeMd,
+  refreshDocs,
+  refreshProjectFiles,
+  refreshSkills,
+  runUpdate
+};
+//# sourceMappingURL=update-UKMEWCSO.js.map

package/dist/update-UKMEWCSO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/update.ts"],"sourcesContent":["import { execSync } from 'child_process';\nimport { createInterface } from 'readline';\nimport { readFile, writeFile, mkdir, access, readdir } from 'fs/promises';\nimport { join, dirname, basename } from 'path';\nimport { fileURLToPath } from 'url';\nimport { parse as parseYaml } from 'yaml';\nimport * as output from '../utils/output.js';\nimport { checkForUpdate, fetchReleaseNotes } 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, { skipCache: true });\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\n    // Fetch and display release notes\n    const notes = await fetchReleaseNotes(update.latest);\n    if (notes) {\n      output.newline();\n      output.header(`What's new in ${update.latest}:`);\n      for (const line of notes.split('\\n')) {\n        output.detail(line);\n      }\n      output.newline();\n    }\n\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 files if we're in a yamchart project\n  await refreshProjectFiles();\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\n/**\n * Refresh all managed project files (docs, skills, CLAUDE.md).\n * Only runs when yamchart.yaml exists in the current directory.\n */\nexport async function refreshProjectFiles(): 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  await refreshDocs();\n  await refreshSkills();\n  await refreshClaudeMd();\n}\n\n/**\n * Refresh .claude/skills/ from bundled templates.\n * Overwrites bundled skills (managed by yamchart), leaves user-created skills alone.\n * Only runs when yamchart.yaml exists in the current directory.\n */\nexport async function refreshSkills(): Promise<void> {\n  try {\n    await access(join(process.cwd(), 'yamchart.yaml'));\n  } catch {\n    return;\n  }\n\n  const bundledDir = await getBundledSkillsDir();\n  if (!bundledDir) return;\n\n  let entries: Awaited<ReturnType<typeof readdir>>;\n  try {\n    entries = await readdir(bundledDir, { withFileTypes: true });\n  } catch {\n    return;\n  }\n\n  let updated = 0;\n  let created = 0;\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n\n    const skillFile = join(bundledDir, entry.name, 'SKILL.md');\n    let bundledContent: string;\n    try {\n      bundledContent = await readFile(skillFile, 'utf-8');\n    } catch {\n      continue; // Skip directories without SKILL.md\n    }\n\n    const targetDir = join(process.cwd(), '.claude', 'skills', entry.name);\n    const targetFile = join(targetDir, 'SKILL.md');\n\n    let isNew = false;\n    try {\n      const existing = await readFile(targetFile, 'utf-8');\n      if (existing === bundledContent) continue; // Already up to date\n    } catch {\n      isNew = true; // File doesn't exist\n    }\n\n    await mkdir(targetDir, { recursive: true });\n    await writeFile(targetFile, bundledContent, 'utf-8');\n    if (isNew) created++;\n    else updated++;\n  }\n\n  if (created > 0 || updated > 0) {\n    const parts: string[] = [];\n    if (created > 0) parts.push(`${created} new`);\n    if (updated > 0) parts.push(`${updated} updated`);\n    output.success(`Synced .claude/skills/ (${parts.join(', ')})`);\n  }\n}\n\n/**\n * Refresh CLAUDE.md from bundled template.\n * If the file exists and differs, prompts the user before overwriting.\n * Only runs when yamchart.yaml exists in the current directory.\n */\nexport async function refreshClaudeMd(\n  options: { confirm?: (message: string) => Promise<boolean> } = {}\n): Promise<void> {\n  try {\n    await access(join(process.cwd(), 'yamchart.yaml'));\n  } catch {\n    return;\n  }\n\n  const bundled = await readBundledFile('CLAUDE.md');\n  if (!bundled) return;\n\n  // Substitute {{name}} with project name from yamchart.yaml\n  const projectName = await getProjectName();\n  const content = bundled.replace(/\\{\\{name\\}\\}/g, projectName);\n\n  const targetPath = join(process.cwd(), 'CLAUDE.md');\n\n  try {\n    const existing = await readFile(targetPath, 'utf-8');\n    if (existing === content) return; // Already up to date\n\n    // File exists and differs — prompt user\n    const confirmFn = options.confirm ?? promptConfirm;\n    const shouldOverwrite = await confirmFn(\n      'CLAUDE.md differs from the current template. Overwrite? (y/n) '\n    );\n    if (!shouldOverwrite) {\n      output.info('Skipped CLAUDE.md update');\n      return;\n    }\n  } catch {\n    // File doesn't exist — create without prompting\n  }\n\n  await writeFile(targetPath, content, 'utf-8');\n  output.success('Updated CLAUDE.md');\n}\n\nasync function getBundledSkillsDir(): Promise<string | null> {\n  const distPath = join(__dirname, 'templates', 'default', '.claude', 'skills');\n  const srcPath = join(__dirname, '..', 'templates', 'default', '.claude', 'skills');\n\n  for (const path of [distPath, srcPath]) {\n    try {\n      await access(path);\n      return path;\n    } catch {\n      continue;\n    }\n  }\n  return null;\n}\n\nasync function readBundledFile(relativePath: string): Promise<string | null> {\n  const distPath = join(__dirname, 'templates', 'default', relativePath);\n  const srcPath = join(__dirname, '..', 'templates', 'default', relativePath);\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\nasync function getProjectName(): Promise<string> {\n  try {\n    const raw = await readFile(join(process.cwd(), 'yamchart.yaml'), 'utf-8');\n    const parsed = parseYaml(raw) as { name?: string };\n    if (parsed?.name) return parsed.name;\n  } catch {\n    // Fall through to basename\n  }\n  return basename(process.cwd());\n}\n\nasync function promptConfirm(message: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  return new Promise((resolve) => {\n    rl.question(message, (answer) => {\n      rl.close();\n      resolve(answer.trim().toLowerCase() === 'y');\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAChC,SAAS,UAAU,WAAW,OAAO,QAAQ,eAAe;AAC5D,SAAS,MAAM,SAAS,gBAAgB;AACxC,SAAS,qBAAqB;AAC9B,SAAS,SAAS,iBAAiB;AAInC,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAExD,eAAsB,UAAU,gBAAuC;AACrE,QAAM,OAAc,QAAQ,yBAAyB;AAErD,QAAM,SAAS,MAAM,eAAe,gBAAgB,EAAE,WAAW,KAAK,CAAC;AAEvE,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;AAGpE,UAAM,QAAQ,MAAM,kBAAkB,OAAO,MAAM;AACnD,QAAI,OAAO;AACT,MAAO,QAAQ;AACf,MAAO,OAAO,iBAAiB,OAAO,MAAM,GAAG;AAC/C,iBAAW,QAAQ,MAAM,MAAM,IAAI,GAAG;AACpC,QAAO,OAAO,IAAI;AAAA,MACpB;AACA,MAAO,QAAQ;AAAA,IACjB;AAEA,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,oBAAoB;AAC5B;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;AAMA,eAAsB,sBAAqC;AACzD,QAAM,cAAc,KAAK,QAAQ,IAAI,GAAG,eAAe;AACvD,MAAI;AACF,UAAM,OAAO,WAAW;AAAA,EAC1B,QAAQ;AACN;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,QAAM,cAAc;AACpB,QAAM,gBAAgB;AACxB;AAOA,eAAsB,gBAA+B;AACnD,MAAI;AACF,UAAM,OAAO,KAAK,QAAQ,IAAI,GAAG,eAAe,CAAC;AAAA,EACnD,QAAQ;AACN;AAAA,EACF;AAEA,QAAM,aAAa,MAAM,oBAAoB;AAC7C,MAAI,CAAC,WAAY;AAEjB,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,QAAQ,YAAY,EAAE,eAAe,KAAK,CAAC;AAAA,EAC7D,QAAQ;AACN;AAAA,EACF;AAEA,MAAI,UAAU;AACd,MAAI,UAAU;AAEd,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAC,MAAM,YAAY,EAAG;AAE1B,UAAM,YAAY,KAAK,YAAY,MAAM,MAAM,UAAU;AACzD,QAAI;AACJ,QAAI;AACF,uBAAiB,MAAM,SAAS,WAAW,OAAO;AAAA,IACpD,QAAQ;AACN;AAAA,IACF;AAEA,UAAM,YAAY,KAAK,QAAQ,IAAI,GAAG,WAAW,UAAU,MAAM,IAAI;AACrE,UAAM,aAAa,KAAK,WAAW,UAAU;AAE7C,QAAI,QAAQ;AACZ,QAAI;AACF,YAAM,WAAW,MAAM,SAAS,YAAY,OAAO;AACnD,UAAI,aAAa,eAAgB;AAAA,IACnC,QAAQ;AACN,cAAQ;AAAA,IACV;AAEA,UAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,UAAM,UAAU,YAAY,gBAAgB,OAAO;AACnD,QAAI,MAAO;AAAA,QACN;AAAA,EACP;AAEA,MAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAM,QAAkB,CAAC;AACzB,QAAI,UAAU,EAAG,OAAM,KAAK,GAAG,OAAO,MAAM;AAC5C,QAAI,UAAU,EAAG,OAAM,KAAK,GAAG,OAAO,UAAU;AAChD,IAAO,QAAQ,2BAA2B,MAAM,KAAK,IAAI,CAAC,GAAG;AAAA,EAC/D;AACF;AAOA,eAAsB,gBACpB,UAA+D,CAAC,GACjD;AACf,MAAI;AACF,UAAM,OAAO,KAAK,QAAQ,IAAI,GAAG,eAAe,CAAC;AAAA,EACnD,QAAQ;AACN;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,gBAAgB,WAAW;AACjD,MAAI,CAAC,QAAS;AAGd,QAAM,cAAc,MAAM,eAAe;AACzC,QAAM,UAAU,QAAQ,QAAQ,iBAAiB,WAAW;AAE5D,QAAM,aAAa,KAAK,QAAQ,IAAI,GAAG,WAAW;AAElD,MAAI;AACF,UAAM,WAAW,MAAM,SAAS,YAAY,OAAO;AACnD,QAAI,aAAa,QAAS;AAG1B,UAAM,YAAY,QAAQ,WAAW;AACrC,UAAM,kBAAkB,MAAM;AAAA,MAC5B;AAAA,IACF;AACA,QAAI,CAAC,iBAAiB;AACpB,MAAO,KAAK,0BAA0B;AACtC;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,QAAM,UAAU,YAAY,SAAS,OAAO;AAC5C,EAAO,QAAQ,mBAAmB;AACpC;AAEA,eAAe,sBAA8C;AAC3D,QAAM,WAAW,KAAK,WAAW,aAAa,WAAW,WAAW,QAAQ;AAC5E,QAAM,UAAU,KAAK,WAAW,MAAM,aAAa,WAAW,WAAW,QAAQ;AAEjF,aAAW,QAAQ,CAAC,UAAU,OAAO,GAAG;AACtC,QAAI;AACF,YAAM,OAAO,IAAI;AACjB,aAAO;AAAA,IACT,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,gBAAgB,cAA8C;AAC3E,QAAM,WAAW,KAAK,WAAW,aAAa,WAAW,YAAY;AACrE,QAAM,UAAU,KAAK,WAAW,MAAM,aAAa,WAAW,YAAY;AAE1E,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;AAEA,eAAe,iBAAkC;AAC/C,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,KAAK,QAAQ,IAAI,GAAG,eAAe,GAAG,OAAO;AACxE,UAAM,SAAS,UAAU,GAAG;AAC5B,QAAI,QAAQ,KAAM,QAAO,OAAO;AAAA,EAClC,QAAQ;AAAA,EAER;AACA,SAAO,SAAS,QAAQ,IAAI,CAAC;AAC/B;AAEA,eAAe,cAAc,SAAmC;AAC9D,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAG,SAAS,SAAS,CAAC,WAAW;AAC/B,SAAG,MAAM;AACT,cAAQ,OAAO,KAAK,EAAE,YAAY,MAAM,GAAG;AAAA,IAC7C,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yamchart",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Git-native business intelligence dashboards",
   "type": "module",
   "license": "MIT",
@@ -61,19 +61,21 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "snowflake-sdk": "^2.3.4",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
     "@yamchart/advisor": "0.1.0",
-    "@yamchart/config": "0.1.2",
     "@yamchart/auth-local": "0.1.0",
+    "@yamchart/config": "0.1.2",
     "@yamchart/query": "0.1.2",
     "@yamchart/schema": "0.1.2",
     "@yamchart/server": "0.1.2"
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "CLAUDE.md"
   ],
   "publishConfig": {
     "access": "public"