@duckcodeailabs/dql-cli 0.7.1 → 0.8.1

package/dist/assets/templates/starter/semantic-layer/cubes/revenue_cube.yaml

@@ -1,77 +0,0 @@
-# Cube Definition — groups measures, dimensions, time dimensions, and joins
-# into a single semantic model. This is the recommended way to define
-# complex, multi-table semantic layers.
-#
-# The DQL notebook will automatically discover this cube and display
-# its measures and dimensions in the Semantic Layer sidebar panel.
-
-name: revenue
-label: Revenue Cube
-description: Core revenue analysis cube built on the starter revenue data.
-table: read_csv_auto('./data/revenue.csv')
-domain: revenue
-owner: analytics-team
-
-# Measures — aggregate calculations shown as "Metrics" in the UI
-measures:
-  - name: total_revenue
-    label: Total Revenue
-    description: Sum of all recognized revenue.
-    sql: SUM(amount)
-    type: sum
-    tags:
-      - revenue
-      - kpi
-
-  - name: deal_count
-    label: Deal Count
-    description: Number of revenue deals.
-    sql: COUNT(*)
-    type: count
-
-  - name: avg_deal_size
-    label: Average Deal Size
-    description: Average revenue per deal.
-    sql: AVG(amount)
-    type: avg
-    tags:
-      - revenue
-
-# Dimensions — grouping columns shown as "Dimensions" in the UI
-dimensions:
-  - name: segment_tier
-    label: Segment Tier
-    description: Customer segment (Enterprise, Mid-Market, SMB).
-    sql: segment_tier
-    type: string
-
-  - name: fiscal_period
-    label: Fiscal Period
-    description: Fiscal period classification.
-    sql: fiscal_period
-    type: string
-
-# Time Dimensions — date columns with granularity support (day/week/month/quarter/year)
-time_dimensions:
-  - name: recognized_at
-    label: Recognition Date
-    description: Date revenue was recognized.
-    sql: recognized_at
-    primary_time: true
-    granularities:
-      - day
-      - week
-      - month
-      - quarter
-      - year
-
-# Joins — connect this cube to other cubes for cross-table queries
-# Example (uncomment if you have a customers cube):
-# joins:
-#   - name: customers
-#     type: left
-#     sql: "${left}.customer_id = ${right}.id"
-
-tags:
-  - revenue
-  - starter

package/dist/assets/templates/starter/semantic-layer/dimensions/segment_tier.yaml

@@ -1,6 +0,0 @@
-name: segment_tier
-label: Segment Tier
-description: Customer segment tier
-sql: segment_tier
-type: string
-table: read_csv_auto('./data/revenue.csv')

package/dist/assets/templates/starter/semantic-layer/hierarchies/revenue_time.yaml

@@ -1,12 +0,0 @@
-name: revenue_time
-label: Revenue Time
-description: Example fiscal calendar hierarchy
-domain: revenue
-levels:
-  - name: fiscal_year
-    dimension: fiscal_year
-    order: 1
-  - name: fiscal_quarter
-    dimension: fiscal_quarter
-    order: 2
-defaultRollup: sum

package/dist/assets/templates/starter/semantic-layer/metrics/revenue.yaml

@@ -1,7 +0,0 @@
-name: total_revenue
-label: Total Revenue
-description: Sum of recognized revenue
-domain: revenue
-sql: SUM(amount)
-type: sum
-table: read_csv_auto('./data/revenue.csv')

package/dist/assets/templates/starter/workbooks/.gitkeep

@@ -1 +0,0 @@
-

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

@@ -1,31 +0,0 @@
-# __PROJECT_NAME__
-
-This template packages a city mobility analytics sandbox with taxi trip data. It covers trip volume trends, fare analysis, borough breakdowns, and time-series patterns — a strong starting point for operational and geospatial analytics.
-
-## Included assets
-
-- `blocks/revenue_by_segment.dql` — trip volume by pickup borough
-- `blocks/airport_mix.dql` — airport trip fare mix
-- `dashboards/city_operations.dql` — operations dashboard with fares and trip counts
-- `data/trips.csv` — local taxi trip sample dataset
-- `notebooks/welcome.dqlnb` — browser notebook walkthrough
-
-## Quick start
-
-```bash
-dql doctor
-dql notebook
-dql preview blocks/revenue_by_segment.dql --open
-```
-
-## What to explore
-
-- Analyze trip volume and fare trends by borough and time of day
-- Compare airport vs. non-airport trip economics
-- Build time-series line charts for daily or weekly trip counts
-
-## 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) — define trip-level metrics and borough dimensions in YAML
-- [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/taxi/blocks/airport_mix.dql

@@ -1,25 +0,0 @@
-block "Airport Fare Mix" {
-    domain = "mobility"
-    type = "custom"
-    description = "Average fare for airport versus non-airport trips"
-    tags = ["taxi", "airport"]
-    owner = "template"
-
-    query = """
-        SELECT CASE WHEN airport_flag THEN 'Airport' ELSE 'City' END AS trip_type,
-               ROUND(AVG(fare_amount), 2) AS avg_fare
-        FROM read_csv_auto('./data/trips.csv')
-        GROUP BY trip_type
-        ORDER BY avg_fare DESC
-    """
-
-    visualization {
-        chart = "bar"
-        x = trip_type
-        y = avg_fare
-    }
-
-    tests {
-        assert row_count > 0
-    }
-}

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

@@ -1,24 +0,0 @@
-block "Trips by Borough" {
-    domain = "mobility"
-    type = "custom"
-    description = "Trip count by pickup borough"
-    tags = ["taxi", "operations"]
-    owner = "template"
-
-    query = """
-        SELECT pickup_borough, COUNT(*) AS revenue
-        FROM read_csv_auto('./data/trips.csv')
-        GROUP BY pickup_borough
-        ORDER BY revenue DESC
-    """
-
-    visualization {
-        chart = "bar"
-        x = pickup_borough
-        y = revenue
-    }
-
-    tests {
-        assert row_count > 0
-    }
-}

package/dist/assets/templates/taxi/dashboards/city_operations.dql

@@ -1,25 +0,0 @@
-dashboard "City Operations" {
-  chart.kpi(
-    SELECT COUNT(*) AS total_trips
-    FROM read_csv_auto('./data/trips.csv'),
-    metrics = ["total_trips"],
-    title = "Total Trips"
-  )
-
-  chart.line(
-    SELECT pickup_hour, ROUND(AVG(fare_amount), 2) AS avg_fare
-    FROM read_csv_auto('./data/trips.csv')
-    GROUP BY pickup_hour
-    ORDER BY pickup_hour,
-    x = pickup_hour,
-    y = avg_fare,
-    title = "Average Fare by Hour"
-  )
-
-  chart.table(
-    SELECT pickup_date, pickup_borough, dropoff_borough, trip_miles, fare_amount, tip_amount
-    FROM read_csv_auto('./data/trips.csv')
-    ORDER BY fare_amount DESC,
-    title = "Highest Fare Trips"
-  )
-}

package/dist/assets/templates/taxi/data/trips.csv

@@ -1,13 +0,0 @@
-trip_id,pickup_date,pickup_hour,pickup_borough,dropoff_borough,payment_type,fare_amount,tip_amount,trip_miles,airport_flag
-T-001,2025-01-03,6,Manhattan,Queens,Card,32.5,6.2,8.4,true
-T-002,2025-01-03,7,Brooklyn,Manhattan,Card,21.4,4.1,5.6,false
-T-003,2025-01-04,8,Queens,Manhattan,Cash,27.8,0,7.1,true
-T-004,2025-01-04,9,Manhattan,Brooklyn,Card,18.9,3.7,4.9,false
-T-005,2025-01-05,11,Bronx,Manhattan,Card,25.7,5.1,6.8,false
-T-006,2025-01-05,12,Manhattan,Queens,Card,34.2,6.8,8.9,true
-T-007,2025-01-06,13,Queens,Brooklyn,Card,19.3,3.5,5.2,false
-T-008,2025-01-06,15,Manhattan,Manhattan,Card,14.6,3.2,2.8,false
-T-009,2025-01-07,17,Brooklyn,Queens,Cash,16.8,0,4.1,false
-T-010,2025-01-07,18,Manhattan,Staten Island,Card,41.1,7.4,12.3,false
-T-011,2025-01-08,19,Queens,Manhattan,Card,29.6,5.9,7.7,true
-T-012,2025-01-08,21,Brooklyn,Manhattan,Card,22.1,4.6,5.9,false

package/dist/assets/templates/taxi/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/taxi/semantic-layer/.gitkeep

@@ -1 +0,0 @@
-

package/dist/assets/templates/taxi/semantic-layer/dimensions/airport_flag.yaml

@@ -1,8 +0,0 @@
-name: airport_flag
-label: Airport Trip
-description: Whether the trip was to or from an airport.
-sql: airport_flag
-type: boolean
-table: trips
-tags:
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/dimensions/dropoff_borough.yaml

@@ -1,9 +0,0 @@
-name: dropoff_borough
-label: Dropoff Borough
-description: Borough where the trip ended.
-sql: dropoff_borough
-type: string
-table: trips
-tags:
-  - geo
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/dimensions/payment_type.yaml

@@ -1,8 +0,0 @@
-name: payment_type
-label: Payment Type
-description: Payment method used (Card, Cash).
-sql: payment_type
-type: string
-table: trips
-tags:
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/dimensions/pickup_borough.yaml

@@ -1,9 +0,0 @@
-name: pickup_borough
-label: Pickup Borough
-description: Borough where the trip started.
-sql: pickup_borough
-type: string
-table: trips
-tags:
-  - geo
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/dimensions/pickup_date.yaml

@@ -1,9 +0,0 @@
-name: pickup_date
-label: Pickup Date
-description: Date the trip started.
-sql: pickup_date
-type: date
-table: trips
-tags:
-  - time
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/hierarchies/trip_route.yaml

@@ -1,14 +0,0 @@
-name: trip_route
-label: Trip Route
-description: Drill from pickup borough to dropoff borough.
-domain: transportation
-levels:
-  - name: pickup_borough
-    label: Pickup Borough
-    dimension: pickup_borough
-    order: 1
-  - name: dropoff_borough
-    label: Dropoff Borough
-    dimension: dropoff_borough
-    order: 2
-defaultRollup: sum

package/dist/assets/templates/taxi/semantic-layer/metrics/avg_trip_miles.yaml

@@ -1,10 +0,0 @@
-name: avg_trip_miles
-label: Average Trip Miles
-description: Average distance per trip.
-domain: transportation
-sql: AVG(trip_miles)
-type: avg
-table: trips
-tags:
-  - trips
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/metrics/total_fare.yaml

@@ -1,10 +0,0 @@
-name: total_fare
-label: Total Fare
-description: Sum of all fare amounts.
-domain: transportation
-sql: SUM(fare_amount)
-type: sum
-table: trips
-tags:
-  - revenue
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/metrics/total_tips.yaml

@@ -1,10 +0,0 @@
-name: total_tips
-label: Total Tips
-description: Sum of tip amounts.
-domain: transportation
-sql: SUM(tip_amount)
-type: sum
-table: trips
-tags:
-  - revenue
-  - taxi

package/dist/assets/templates/taxi/semantic-layer/metrics/trip_count.yaml

@@ -1,10 +0,0 @@
-name: trip_count
-label: Trip Count
-description: Total number of trips.
-domain: transportation
-sql: COUNT(trip_id)
-type: count
-table: trips
-tags:
-  - trips
-  - taxi

package/dist/assets/templates/taxi/workbooks/.gitkeep

@@ -1 +0,0 @@
-

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

@@ -1,30 +0,0 @@
-# Workbook
-
-Multi-page workbook that compiles into a tabbed HTML report.
-
-## Scaffold
-
-```bash
-dql init my-project --template workbook
-cd my-project
-```
-
-## What it demonstrates
-
-- Workbook syntax
-- Multiple pages in one file
-- Local-first reporting flow with CSV data
-
-## Run it
-
-```bash
-dql doctor
-dql preview workbooks/quarterly_business_review.dql --open
-```
-
-## Build it
-
-```bash
-dql build workbooks/quarterly_business_review.dql
-dql serve dist/quarterly_business_review --open
-```

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

@@ -1 +0,0 @@
-

package/dist/assets/templates/workbook/data/finance.csv

@@ -1,7 +0,0 @@
-month,region,revenue,expense
-2026-01,North America,120000,64000
-2026-01,EMEA,98000,52000
-2026-02,North America,133000,70000
-2026-02,EMEA,105000,56000
-2026-03,North America,141000,73000
-2026-03,EMEA,112000,59000

package/dist/assets/templates/workbook/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/workbook/semantic-layer/.gitkeep

@@ -1 +0,0 @@
-

package/dist/assets/templates/workbook/workbooks/quarterly_business_review.dql

@@ -1,32 +0,0 @@
-workbook "Quarterly Business Review" {
-  page "Executive Summary" {
-    chart.kpi(
-      SELECT SUM(revenue) AS total_revenue FROM read_csv_auto('./data/finance.csv'),
-      metrics = ["total_revenue"],
-      title = "Total Revenue"
-    )
-  }
-
-  page "Revenue Trend" {
-    chart.line(
-      SELECT month, SUM(revenue) AS total_revenue
-      FROM read_csv_auto('./data/finance.csv')
-      GROUP BY month
-      ORDER BY month,
-      x = month,
-      y = total_revenue,
-      title = "Revenue Trend"
-    )
-  }
-
-  page "Cost by Region" {
-    chart.bar(
-      SELECT region, SUM(expense) AS total_expense
-      FROM read_csv_auto('./data/finance.csv')
-      GROUP BY region,
-      x = region,
-      y = total_expense,
-      title = "Cost by Region"
-    )
-  }
-}