@duckcodeailabs/dql-cli 0.7.0 → 0.8.0

package/dist/assets/templates/dashboard/README.md

@@ -1,30 +0,0 @@
-# Dashboard
-
-Multi-chart dashboard over local CSV data — KPI, bar, and table charts in one file.
-
-## Scaffold
-
-```bash
-dql init my-project --template dashboard
-cd my-project
-```
-
-## What it demonstrates
-
-- Dashboard syntax
-- KPI, bar, and table charts in one file
-- Local file-based preview without warehouse credentials
-
-## Run it
-
-```bash
-dql doctor
-dql preview dashboards/pipeline_overview.dql --open
-```
-
-## Build it
-
-```bash
-dql build dashboards/pipeline_overview.dql
-dql serve dist/pipeline_overview --open
-```

package/dist/assets/templates/dashboard/blocks/.gitkeep

@@ -1 +0,0 @@
-

package/dist/assets/templates/dashboard/dashboards/pipeline_overview.dql

@@ -1,23 +0,0 @@
-dashboard "Pipeline Overview" {
-  chart.kpi(
-    SELECT SUM(amount) AS total_pipeline FROM read_csv_auto('./data/pipeline.csv'),
-    metrics = ["total_pipeline"],
-    title = "Open Pipeline"
-  )
-
-  chart.bar(
-    SELECT stage, SUM(amount) AS pipeline_amount
-    FROM read_csv_auto('./data/pipeline.csv')
-    GROUP BY stage,
-    x = stage,
-    y = pipeline_amount,
-    title = "Pipeline by Stage"
-  )
-
-  chart.table(
-    SELECT rep_name, region, stage, amount, close_month
-    FROM read_csv_auto('./data/pipeline.csv')
-    ORDER BY amount DESC,
-    title = "Top Opportunities"
-  )
-}

package/dist/assets/templates/dashboard/data/pipeline.csv

@@ -1,7 +0,0 @@
-rep_name,region,stage,amount,close_month
-Ava,North America,Qualified,42000,2026-04
-Ava,North America,Proposal,76000,2026-05
-Leo,EMEA,Qualified,52000,2026-04
-Mina,APAC,Negotiation,68000,2026-05
-Omar,EMEA,Proposal,47000,2026-06
-Sara,North America,Negotiation,83000,2026-06

package/dist/assets/templates/dashboard/dql.config.json

@@ -1,18 +0,0 @@
-{
-  "project": "__PROJECT_NAME__",
-  "defaultConnection": {
-    "driver": "file",
-    "filepath": ":memory:"
-  },
-  "dataDir": "./data",
-
-  "semanticLayer": {
-    "provider": "dql"
-  },
-
-  "preview": {
-    "port": 3474,
-    "open": true,
-    "theme": "dark"
-  }
-}

package/dist/assets/templates/dashboard/semantic-layer/.gitkeep

@@ -1 +0,0 @@
-

package/dist/assets/templates/dql.config.reference.json

@@ -1,154 +0,0 @@
-{
-  "_comment": "DQL Config Reference — copy sections you need into your dql.config.json",
-
-  "project": "my-project-name",
-
-  "_comment_connections": "=== CONNECTION OPTIONS ===",
-
-  "_option_1_duckdb_memory": {
-    "defaultConnection": {
-      "driver": "file",
-      "filepath": ":memory:"
-    }
-  },
-
-  "_option_2_duckdb_file": {
-    "defaultConnection": {
-      "driver": "duckdb",
-      "filepath": "./data/warehouse.duckdb"
-    }
-  },
-
-  "_option_3_snowflake": {
-    "defaultConnection": {
-      "driver": "snowflake",
-      "account": "your-account.snowflakecomputing.com",
-      "username": "your_user",
-      "password": "${SNOWFLAKE_PASSWORD}",
-      "database": "ANALYTICS",
-      "schema": "PUBLIC",
-      "warehouse": "COMPUTE_WH",
-      "role": "ANALYST"
-    }
-  },
-
-  "_option_4_bigquery": {
-    "defaultConnection": {
-      "driver": "bigquery",
-      "project": "your-gcp-project-id",
-      "dataset": "analytics",
-      "keyFilename": "./service-account.json"
-    }
-  },
-
-  "_option_5_postgres": {
-    "defaultConnection": {
-      "driver": "postgres",
-      "host": "localhost",
-      "port": 5432,
-      "database": "analytics",
-      "username": "your_user",
-      "password": "${POSTGRES_PASSWORD}"
-    }
-  },
-
-  "_option_6_sqlite": {
-    "defaultConnection": {
-      "driver": "sqlite",
-      "database": "./data/analytics.sqlite"
-    }
-  },
-
-  "_comment_semantic": "=== SEMANTIC LAYER OPTIONS ===",
-
-  "_semantic_option_1_dql_native": {
-    "semanticLayer": {
-      "provider": "dql"
-    },
-    "_directory_structure": {
-      "semantic-layer/metrics/":    "one YAML file per metric",
-      "semantic-layer/dimensions/": "one YAML file per dimension",
-      "semantic-layer/hierarchies/":"one YAML file per hierarchy",
-      "semantic-layer/cubes/":      "one YAML file per cube (groups measures + dimensions + joins)"
-    }
-  },
-
-  "_semantic_option_2_dql_custom_path": {
-    "semanticLayer": {
-      "provider": "dql",
-      "path": "./my-definitions"
-    }
-  },
-
-  "_semantic_option_3_dbt": {
-    "semanticLayer": {
-      "provider": "dbt",
-      "projectPath": "/absolute/path/to/your/dbt-project"
-    },
-    "_notes": {
-      "how_it_works": "Reads semantic_models and metrics from your dbt models/**/*.yml files",
-      "requires": "dbt 1.6+ with semantic_models defined in YAML",
-      "relative_path": "You can also use a relative path: ../my-dbt-repo"
-    }
-  },
-
-  "_semantic_option_4_cubejs": {
-    "semanticLayer": {
-      "provider": "cubejs",
-      "projectPath": "/absolute/path/to/your/cube-project"
-    },
-    "_notes": {
-      "how_it_works": "Reads cube definitions from model/ or schema/ directory",
-      "relative_path": "You can also use a relative path: ../my-cube-project"
-    }
-  },
-
-  "_semantic_option_5_dbt_remote_github": {
-    "semanticLayer": {
-      "provider": "dbt",
-      "source": "github",
-      "repoUrl": "https://github.com/your-org/dbt-metrics.git",
-      "branch": "main",
-      "subPath": "models"
-    },
-    "_notes": {
-      "how_it_works": "Clones the remote repo into ~/.dql/cache/repos/ and reads dbt semantic models from it",
-      "auth": "For private repos, set GITHUB_TOKEN environment variable",
-      "cache": "Cached for 10 minutes; use 'dql semantic pull' to force refresh"
-    }
-  },
-
-  "_semantic_option_6_cubejs_remote_gitlab": {
-    "semanticLayer": {
-      "provider": "cubejs",
-      "source": "gitlab",
-      "repoUrl": "https://gitlab.com/your-org/cube-schema.git",
-      "branch": "main",
-      "subPath": ""
-    },
-    "_notes": {
-      "auth": "For private repos, set GITLAB_TOKEN environment variable"
-    }
-  },
-
-  "_semantic_option_7_snowflake": {
-    "semanticLayer": {
-      "provider": "snowflake",
-      "projectPath": "MY_DATABASE"
-    },
-    "_notes": {
-      "how_it_works": "Introspects Snowflake semantic views (SHOW SEMANTIC VIEWS) via the active connection",
-      "requires": "Snowflake account with semantic views (CREATE SEMANTIC VIEW) and a configured Snowflake connection",
-      "projectPath_usage": "Optional: filters semantic views to a specific database"
-    }
-  },
-
-  "_comment_preview": "=== PREVIEW / NOTEBOOK OPTIONS ===",
-
-  "dataDir": "./data",
-  "preview": {
-    "port": 3474,
-    "open": true,
-    "theme": "dark"
-  }
-}

package/dist/assets/templates/duckdb-local/README.md

@@ -1,30 +0,0 @@
-# DuckDB Local
-
-Local-first analytics using the `duckdb` driver — no warehouse credentials needed.
-
-## Scaffold
-
-```bash
-dql init my-project --template duckdb-local
-cd my-project
-```
-
-## What it demonstrates
-
-- DuckDB as the default connection
-- Local CSV-backed analytics with DuckDB execution
-- Line chart preview and static export
-
-## Run it
-
-```bash
-dql doctor
-dql preview blocks/orders_by_region.dql --open
-```
-
-## Build it
-
-```bash
-dql build blocks/orders_by_region.dql
-dql serve dist/orders_by_region --open
-```

package/dist/assets/templates/duckdb-local/blocks/orders_by_region.dql

@@ -1,24 +0,0 @@
-block "Orders by Region" {
-    domain = "sales"
-    type = "custom"
-    description = "Local DuckDB-backed revenue trend example"
-    owner = "dql-example"
-    tags = ["duckdb", "sales", "local-data"]
-
-    query = """
-        SELECT order_month, SUM(revenue) AS total_revenue
-        FROM read_csv_auto('./data/orders.csv')
-        GROUP BY order_month
-        ORDER BY order_month
-    """
-
-    visualization {
-        chart = "line"
-        x = order_month
-        y = total_revenue
-    }
-
-    tests {
-        assert row_count > 0
-    }
-}

package/dist/assets/templates/duckdb-local/data/orders.csv

@@ -1,7 +0,0 @@
-order_month,region,revenue,orders
-2026-01,North America,112000,320
-2026-01,EMEA,87000,250
-2026-02,North America,126000,345
-2026-02,EMEA,91000,268
-2026-03,North America,134000,360
-2026-03,EMEA,96000,280

package/dist/assets/templates/duckdb-local/dql.config.json

@@ -1,18 +0,0 @@
-{
-  "project": "__PROJECT_NAME__",
-  "defaultConnection": {
-    "driver": "duckdb",
-    "filepath": ":memory:"
-  },
-  "dataDir": "./data",
-
-  "semanticLayer": {
-    "provider": "dql"
-  },
-
-  "preview": {
-    "port": 3474,
-    "open": true,
-    "theme": "dark"
-  }
-}

package/dist/assets/templates/duckdb-local/semantic-layer/.gitkeep

@@ -1 +0,0 @@
-

package/dist/assets/templates/ecommerce/README.md

@@ -1,33 +0,0 @@
-# __PROJECT_NAME__
-
-This template packages a realistic e-commerce analytics sandbox for DQL. It covers channel revenue analysis, repeat purchase behavior, funnel analysis, and semantic metrics — a complete starting point for commerce analytics.
-
-## Included assets
-
-- `blocks/revenue_by_segment.dql` — channel revenue block
-- `blocks/repeat_rate.dql` — repeat purchase mix block
-- `dashboards/revenue_command_center.dql` — KPI + bar + table dashboard
-- `data/orders.csv` — orders with channel, region, and repeat purchase flags
-- `data/funnel.csv` — acquisition and checkout funnel snapshot
-- `data/customers.csv` — customer dimension data
-- `notebooks/welcome.dqlnb` — browser notebook walkthrough
-
-## Quick start
-
-```bash
-dql doctor
-dql notebook
-dql preview blocks/revenue_by_segment.dql --open
-```
-
-## What to explore
-
-- Compare performance across paid, partner, organic, and lifecycle channels
-- Track repeat order contribution by region and segment
-- Use the notebook to iterate on funnel SQL before promoting it into reusable blocks
-
-## Next Steps
-
-- [Authoring Blocks](https://github.com/duckcodeailabs/dql/blob/main/docs/authoring-blocks.md) — promote your notebook queries into certified, reusable `.dql` blocks
-- [Semantic Layer Guide](https://github.com/duckcodeailabs/dql/blob/main/docs/semantic-layer-guide.md) — extend the included semantic layer with your own metrics and dimensions
-- [Getting Started](https://github.com/duckcodeailabs/dql/blob/main/docs/getting-started.md) — connect to a cloud database or add DQL to an existing repo

package/dist/assets/templates/ecommerce/blocks/repeat_rate.dql

@@ -1,26 +0,0 @@
-block "Repeat Revenue Mix" {
-    domain = "commerce"
-    type = "custom"
-    description = "Repeat versus first-time order revenue mix"
-    tags = ["commerce", "retention"]
-    owner = "template"
-
-    query = """
-        SELECT
-            CASE WHEN is_repeat THEN 'Repeat' ELSE 'First Order' END AS order_type,
-            ROUND(SUM(order_total), 2) AS revenue
-        FROM read_csv_auto('./data/orders.csv')
-        GROUP BY order_type
-        ORDER BY revenue DESC
-    """
-
-    visualization {
-        chart = "bar"
-        x = order_type
-        y = revenue
-    }
-
-    tests {
-        assert row_count > 0
-    }
-}

package/dist/assets/templates/ecommerce/blocks/revenue_by_segment.dql

@@ -1,24 +0,0 @@
-block "GMV by Channel" {
-    domain = "commerce"
-    type = "custom"
-    description = "Gross merchandise value by acquisition channel"
-    tags = ["commerce", "gmv", "channel"]
-    owner = "template"
-
-    query = """
-        SELECT channel, ROUND(SUM(order_total), 2) AS revenue
-        FROM read_csv_auto('./data/orders.csv')
-        GROUP BY channel
-        ORDER BY revenue DESC
-    """
-
-    visualization {
-        chart = "bar"
-        x = channel
-        y = revenue
-    }
-
-    tests {
-        assert row_count > 0
-    }
-}

package/dist/assets/templates/ecommerce/dashboards/revenue_command_center.dql

@@ -1,25 +0,0 @@
-dashboard "Revenue Command Center" {
-  chart.kpi(
-    SELECT ROUND(SUM(order_total), 2) AS gmv
-    FROM read_csv_auto('./data/orders.csv'),
-    metrics = ["gmv"],
-    title = "Gross Merchandise Value"
-  )
-
-  chart.bar(
-    SELECT channel, ROUND(SUM(order_total), 2) AS revenue
-    FROM read_csv_auto('./data/orders.csv')
-    GROUP BY channel
-    ORDER BY revenue DESC,
-    x = channel,
-    y = revenue,
-    title = "Revenue by Channel"
-  )
-
-  chart.table(
-    SELECT order_date, customer_id, channel, region, order_total, is_repeat
-    FROM read_csv_auto('./data/orders.csv')
-    ORDER BY order_total DESC,
-    title = "Top Orders"
-  )
-}

package/dist/assets/templates/ecommerce/data/customers.csv

@@ -1,11 +0,0 @@
-customer_id,customer_name,segment,region,acquisition_channel,first_order_date,health_score
-C-001,Northstar Health,Enterprise,North America,Paid Search,2025-01-03,92
-C-002,Blue Pine Retail,Mid-Market,EMEA,Organic Search,2024-11-19,87
-C-003,Maple & Co,SMB,North America,Lifecycle,2024-12-01,79
-C-004,Harbor Commerce,Enterprise,APAC,Partner,2025-01-11,90
-C-005,Studio Relay,Mid-Market,North America,Paid Social,2025-01-14,74
-C-006,Rio Goods,SMB,LATAM,Organic Search,2024-10-08,82
-C-007,Vertex Home,Enterprise,North America,Partner,2024-09-22,95
-C-008,Atlas Europe,Mid-Market,EMEA,Paid Search,2025-02-02,71
-C-009,North Loop,SMB,North America,Organic Search,2025-02-06,77
-C-010,Pacific Devices,Enterprise,APAC,Lifecycle,2024-08-12,88

package/dist/assets/templates/ecommerce/data/funnel.csv

@@ -1,6 +0,0 @@
-step,users,conversion_rate,sort_order
-Landing Session,18000,1.00,1
-Product View,13420,0.75,2
-Add to Cart,6280,0.35,3
-Checkout Start,3125,0.17,4
-Purchase,1543,0.09,5

package/dist/assets/templates/ecommerce/data/orders.csv

@@ -1,16 +0,0 @@
-order_id,order_date,customer_id,segment,channel,region,order_total,gross_margin,is_repeat,payment_method
-1001,2025-01-03,C-001,Enterprise,Paid Search,North America,12400,0.41,false,Card
-1002,2025-01-05,C-002,Mid-Market,Organic Search,EMEA,8600,0.37,true,Card
-1003,2025-01-08,C-003,SMB,Lifecycle,North America,2400,0.54,true,ACH
-1004,2025-01-11,C-004,Enterprise,Partner,APAC,15200,0.46,false,Wire
-1005,2025-01-14,C-005,Mid-Market,Paid Social,North America,5400,0.35,false,Card
-1006,2025-01-18,C-006,SMB,Organic Search,LATAM,1800,0.51,true,Card
-1007,2025-01-22,C-002,Mid-Market,Lifecycle,EMEA,9200,0.39,true,Card
-1008,2025-01-27,C-007,Enterprise,Partner,North America,17600,0.48,true,Wire
-1009,2025-02-02,C-008,Mid-Market,Paid Search,EMEA,7300,0.36,false,Card
-1010,2025-02-06,C-009,SMB,Organic Search,North America,2100,0.56,false,ACH
-1011,2025-02-10,C-010,Enterprise,Lifecycle,APAC,13800,0.43,true,Card
-1012,2025-02-15,C-011,Mid-Market,Partner,LATAM,6900,0.34,false,Wire
-1013,2025-02-18,C-012,Enterprise,Paid Social,North America,9800,0.38,false,Card
-1014,2025-02-21,C-007,Enterprise,Lifecycle,North America,12100,0.45,true,Wire
-1015,2025-02-25,C-013,SMB,Organic Search,EMEA,1700,0.53,true,Card

package/dist/assets/templates/ecommerce/dql.config.json

@@ -1,18 +0,0 @@
-{
-  "project": "__PROJECT_NAME__",
-  "defaultConnection": {
-    "driver": "file",
-    "filepath": ":memory:"
-  },
-  "dataDir": "./data",
-
-  "semanticLayer": {
-    "provider": "dql"
-  },
-
-  "preview": {
-    "port": 3474,
-    "open": true,
-    "theme": "dark"
-  }
-}

package/dist/assets/templates/ecommerce/semantic-layer/cubes/customers_cube.yaml

@@ -1,49 +0,0 @@
-# Customers cube — joinable from the orders cube.
-
-name: customers
-label: Customers Cube
-description: Customer master data.
-table: customers
-domain: commerce
-
-measures:
-  - name: customer_count
-    label: Customer Count
-    sql: COUNT(DISTINCT customer_id)
-    type: count_distinct
-  - name: avg_health_score
-    label: Average Health Score
-    sql: AVG(health_score)
-    type: avg
-
-dimensions:
-  - name: customer_name
-    label: Customer Name
-    sql: customer_name
-    type: string
-  - name: segment
-    label: Segment
-    sql: segment
-    type: string
-  - name: region
-    label: Region
-    sql: region
-    type: string
-  - name: acquisition_channel
-    label: Acquisition Channel
-    sql: acquisition_channel
-    type: string
-
-time_dimensions:
-  - name: first_order_date
-    label: First Order Date
-    sql: first_order_date
-    primary_time: true
-    granularities:
-      - month
-      - quarter
-      - year
-
-tags:
-  - commerce
-  - customers

package/dist/assets/templates/ecommerce/semantic-layer/cubes/orders_cube.yaml

@@ -1,70 +0,0 @@
-# Multi-table cube with joins — demonstrates cross-table semantic queries.
-# This cube joins orders with customers to enable queries like:
-#   "total GMV by customer health_score and region"
-
-name: orders
-label: Orders Cube
-description: E-commerce orders cube with customer join.
-table: orders
-domain: commerce
-
-measures:
-  - name: gmv
-    label: Gross Merchandise Value
-    sql: SUM(order_total)
-    type: sum
-  - name: order_count
-    label: Order Count
-    sql: COUNT(order_id)
-    type: count
-  - name: avg_order_value
-    label: Average Order Value
-    sql: AVG(order_total)
-    type: avg
-  - name: avg_margin
-    label: Average Margin
-    sql: AVG(gross_margin)
-    type: avg
-
-dimensions:
-  - name: segment
-    label: Segment
-    sql: segment
-    type: string
-  - name: channel
-    label: Channel
-    sql: channel
-    type: string
-  - name: region
-    label: Region
-    sql: region
-    type: string
-  - name: payment_method
-    label: Payment Method
-    sql: payment_method
-    type: string
-  - name: is_repeat
-    label: Repeat Customer
-    sql: is_repeat
-    type: boolean
-
-time_dimensions:
-  - name: order_date
-    label: Order Date
-    sql: order_date
-    primary_time: true
-    granularities:
-      - day
-      - week
-      - month
-      - quarter
-      - year
-
-joins:
-  - name: customers
-    type: left
-    sql: "${left}.customer_id = ${right}.customer_id"
-
-tags:
-  - commerce
-  - ecommerce

package/dist/assets/templates/ecommerce/semantic-layer/dimensions/channel.yaml

@@ -1,8 +0,0 @@
-name: channel
-label: Channel
-description: Order acquisition channel.
-sql: channel
-type: string
-table: orders
-tags:
-  - commerce

package/dist/assets/templates/ecommerce/semantic-layer/dimensions/order_date.yaml

@@ -1,9 +0,0 @@
-name: order_date
-label: Order Date
-description: Date the order was placed.
-sql: order_date
-type: date
-table: orders
-tags:
-  - commerce
-  - time

package/dist/assets/templates/ecommerce/semantic-layer/dimensions/region.yaml

@@ -1,9 +0,0 @@
-name: region
-label: Region
-description: Geographic region of the order.
-sql: region
-type: string
-table: orders
-tags:
-  - commerce
-  - geo

package/dist/assets/templates/ecommerce/semantic-layer/dimensions/segment.yaml

@@ -1,8 +0,0 @@
-name: segment
-label: Customer Segment
-description: Customer segment (Enterprise, Mid-Market, SMB).
-sql: segment
-type: string
-table: orders
-tags:
-  - commerce

package/dist/assets/templates/ecommerce/semantic-layer/hierarchies/customer_geo.yaml

@@ -1,18 +0,0 @@
-name: customer_geo
-label: Customer Geography
-description: Drill from region down to customer segment.
-domain: commerce
-levels:
-  - name: region
-    label: Region
-    dimension: region
-    order: 1
-  - name: segment
-    label: Segment
-    dimension: segment
-    order: 2
-  - name: channel
-    label: Channel
-    dimension: channel
-    order: 3
-defaultRollup: sum