@duckcodeailabs/dql-cli 0.5.2 → 0.7.0

package/dist/assets/dql-notebook/index.html

@@ -7,7 +7,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-Dp-Vko5m.js"></script>
+    <script type="module" crossorigin src="/assets/index-B_X7pyPz.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/react-CRB3T2We.js">
     <link rel="modulepreload" crossorigin href="/assets/codemirror-CCrEt63p.js">
   </head>

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

@@ -0,0 +1,30 @@
+# 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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,18 @@
+{
+  "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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,30 @@
+# 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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,18 @@
+{
+  "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

@@ -0,0 +1 @@
+

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

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-This template packages a realistic e-commerce analytics sandbox for DQL.
+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
 
@@ -25,3 +25,9 @@ dql preview blocks/revenue_by_segment.dql --open
 - 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/finance-kpi/README.md

@@ -0,0 +1,31 @@
+# Finance KPI
+
+Smallest runnable DQL project — a single KPI block over local CSV data.
+
+## Scaffold
+
+```bash
+dql init my-project --template finance-kpi
+cd my-project
+```
+
+## What it demonstrates
+
+- Reusable `custom` block syntax
+- Local CSV-backed query execution
+- KPI visualization
+- Preview, build, and serve flow
+
+## Run it
+
+```bash
+dql doctor
+dql preview blocks/arr_kpi.dql --open
+```
+
+## Build it
+
+```bash
+dql build blocks/arr_kpi.dql
+dql serve dist/arr_kpi --open
+```

package/dist/assets/templates/finance-kpi/blocks/arr_kpi.dql

@@ -0,0 +1,21 @@
+block "ARR KPI" {
+    domain = "finance"
+    type = "custom"
+    description = "Simple ARR KPI block backed by local CSV sample data"
+    owner = "dql-example"
+    tags = ["finance", "kpi", "local-data"]
+
+    query = """
+        SELECT SUM(amount) AS arr_total
+        FROM read_csv_auto('./data/revenue.csv')
+    """
+
+    visualization {
+        chart = "kpi"
+        y = arr_total
+    }
+
+    tests {
+        assert row_count > 0
+    }
+}

package/dist/assets/templates/finance-kpi/data/revenue.csv

@@ -0,0 +1,7 @@
+month,segment,amount
+2026-01,Enterprise,120000
+2026-01,SMB,48000
+2026-02,Enterprise,132000
+2026-02,SMB,51000
+2026-03,Enterprise,141000
+2026-03,SMB,56000

package/dist/assets/templates/finance-kpi/dql.config.json

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

package/dist/assets/templates/finance-kpi/semantic-layer/.gitkeep

@@ -0,0 +1 @@
+

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

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-This template packages a SaaS KPI sandbox focused on MRR, retention, and expansion.
+This template packages a SaaS KPI sandbox focused on MRR, retention, and expansion. It covers recurring revenue tracking, churn pressure analysis, cohort retention, and semantic metrics for subscription businesses.
 
 ## Included assets
 
@@ -18,3 +18,15 @@ dql doctor
 dql notebook
 dql preview blocks/revenue_by_segment.dql --open
 ```
+
+## What to explore
+
+- Track MRR growth and expansion by plan tier
+- Identify at-risk accounts by churn pressure signals
+- Analyze cohort retention curves over rolling periods
+
+## 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 MRR and churn metrics
+- [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/starter/README.md

@@ -5,16 +5,13 @@ previewing, notebook exploration, and experimentation.
 
 ```text
 blocks/
-dashboards/
 data/
 dql.config.json
 notebooks/
-workbooks/
 semantic-layer/
   metrics/
   dimensions/
   hierarchies/
-  blocks/
 ```
 
 ## Quick Start
@@ -23,9 +20,6 @@ semantic-layer/
 dql doctor
 dql notebook
 dql new block "Pipeline Health"
-dql new semantic-block "ARR Growth"
-dql new dashboard "Revenue Overview"
-dql new workbook "Quarterly Review"
 dql parse blocks/pipeline_health.dql
 dql preview blocks/pipeline_health.dql --open
 dql build blocks/pipeline_health.dql
@@ -35,11 +29,9 @@ dql serve dist/pipeline_health
 ## What's Included
 
 - `blocks/` — example charted and query-only DQL blocks
-- `dashboards/` — empty folder for dashboard scaffolds
 - `data/` — sample revenue CSV for local DuckDB/file preview flows
 - `dql.config.json` — starter project configuration
 - `notebooks/welcome.dqlnb` — guided notebook walkthrough for the browser notebook
-- `workbooks/` — empty folder for workbook scaffolds
 - `semantic-layer/` — example metrics, dimensions, hierarchies, and companion metadata
 
 ## Adopt the Starter Safely
@@ -49,6 +41,8 @@ dql serve dist/pipeline_health
 - run `dql doctor` before previewing if setup feels off
 - add tests to every reusable block
 
-## Learn More
+## Next Steps
 
-- See the main DQL documentation for `project-config` and `data-sources` guidance.
+- [Getting Started](https://github.com/duckcodeailabs/dql/blob/main/docs/getting-started.md) — full install options, tutorials, and your first block
+- [Authoring Blocks](https://github.com/duckcodeailabs/dql/blob/main/docs/authoring-blocks.md) — create, validate, certify, and commit custom and semantic blocks
+- [Semantic Layer Guide](https://github.com/duckcodeailabs/dql/blob/main/docs/semantic-layer-guide.md) — define metrics, dimensions, and cubes in YAML

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

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-This template packages a city mobility analytics sandbox with taxi trip data.
+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
 
@@ -17,3 +17,15 @@ 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/workbook/README.md

@@ -0,0 +1,30 @@
+# 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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,18 @@
+{
+  "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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,32 @@
+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"
+    )
+  }
+}

package/dist/commands/build.test.js

@@ -35,6 +35,7 @@ describe('runBuild', () => {
             template: 'starter',
             connection: '',
             verbose: false,
+            skipTests: false,
         });
         expect(readFileSync(join(outDir, 'index.html'), 'utf-8')).toContain('Revenue Preview');
         expect(readFileSync(join(outDir, 'dql-metadata.json'), 'utf-8')).toContain('Revenue Preview');

package/dist/commands/build.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.test.js","sourceRoot":"","sources":["../../src/commands/build.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAEvC,aAAa,CAAC,UAAU,EAAE;;;;;;;;;;;EAW5B,CAAC,CAAC;QAEA,MAAM,QAAQ,CAAC,UAAU,EAAE;YACzB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,EAAE;YACT,MAAM;YACN,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACvF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"build.test.js","sourceRoot":"","sources":["../../src/commands/build.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAEvC,aAAa,CAAC,UAAU,EAAE;;;;;;;;;;;EAW5B,CAAC,CAAC;QAEA,MAAM,QAAQ,CAAC,UAAU,EAAE;YACzB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,EAAE;YACT,MAAM;YACN,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACvF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/certify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"certify.d.ts","sourceRoot":"","sources":["../../src/commands/certify.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEjF"}
+{"version":3,"file":"certify.d.ts","sourceRoot":"","sources":["../../src/commands/certify.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA0I3C,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGjF"}