create-dql-app 1.6.0 → 1.6.1

package/templates/acme-bank/data/transactions.csv

@@ -1,20 +0,0 @@
-txn_id,customer_id,merchant_id,amount_usd,status,region,branch_id,txn_ts
-T001,C001,M-amzn,84.20,approved,NA-NE,NYC-042,2026-04-20T08:14:00Z
-T002,C002,M-walmart,162.00,approved,NA-W,SFO-007,2026-04-20T08:32:00Z
-T003,C001,M-amzn,4900.00,approved,NA-NE,NYC-042,2026-04-20T22:11:00Z
-T004,C004,M-darknet1,2700.00,declined,EMEA,LON-018,2026-04-20T22:14:00Z
-T005,C008,M-darknet1,3200.00,declined,EMEA,LON-018,2026-04-20T22:18:00Z
-T006,C005,M-target,242.50,approved,NA-SE,ATL-011,2026-04-21T09:04:00Z
-T007,C006,M-apple,1180.00,approved,NA-W,SEA-004,2026-04-21T10:41:00Z
-T008,C010,M-home,1580.25,approved,NA-W,SFO-007,2026-04-21T15:30:00Z
-T009,C003,M-amzn,440.00,approved,NA-NE,BOS-015,2026-04-22T11:01:00Z
-T010,C004,M-travel,5200.00,approved,EMEA,LON-018,2026-04-22T14:18:00Z
-T011,C007,M-grocery,76.11,approved,NA-SE,ATL-011,2026-04-23T07:40:00Z
-T012,C008,M-darknet1,4100.00,declined,EMEA,LON-018,2026-04-23T23:09:00Z
-T013,C001,M-travel,2200.00,approved,NA-NE,NYC-042,2026-04-24T18:21:00Z
-T014,C002,M-amzn,93.42,approved,NA-W,SFO-007,2026-04-24T19:44:00Z
-T015,C009,M-apple,890.00,approved,NA-NE,NYC-042,2026-04-25T13:17:00Z
-T016,C005,M-darknet1,1800.00,declined,NA-SE,ATL-011,2026-04-25T23:22:00Z
-T017,C006,M-walmart,338.20,approved,NA-W,SEA-004,2026-04-26T09:30:00Z
-T018,C003,M-home,2800.00,approved,NA-NE,BOS-015,2026-04-26T12:08:00Z
-

package/templates/acme-bank/dql.config.json

@@ -1,21 +0,0 @@
-{
-  "project": "{{PROJECT_NAME}}",
-  "connections": {
-    "default": {
-      "driver": "duckdb",
-      "filepath": ":memory:"
-    }
-  },
-  "semanticLayer": {
-    "provider": "dql",
-    "path": "semantic-layer"
-  },
-  "dbt": {
-    "projectDir": "{{DBT_PROJECT_DIR}}",
-    "manifestPath": "target/manifest.json"
-  },
-  "governance": {
-    "required_fields": ["domain", "owner", "description"]
-  }
-}
-

package/templates/acme-bank/notebooks/cards_fraud_ops.dqlnb

@@ -1,47 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "Cards Fraud Operations",
-    "description": "Daily card volume, approval rate, and fraud exposure review for Cards Operations.",
-    "status": "certified",
-    "categories": ["cards", "fraud", "operations"],
-    "owner": "mei.chen@acme-bank.com"
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Cards Fraud Operations\n\nUse this notebook when fraud analysts need to inspect the same certified logic that powers the Cards Operations App.\n\nRun the SQL cells for raw context, then run the certified block cells to compare with the packaged App dashboard."
-    },
-    {
-      "id": "daily_status_volume",
-      "title": "Daily card volume by status",
-      "type": "sql",
-      "source": "SELECT\n  CAST(txn_ts AS DATE) AS day,\n  status,\n  COUNT(*) AS txn_count,\n  ROUND(SUM(amount_usd), 2) AS volume_usd\nFROM read_csv_auto('./data/transactions.csv')\nGROUP BY 1, 2\nORDER BY 1, 2"
-    },
-    {
-      "id": "approval_rate",
-      "title": "Approval rate (certified block)",
-      "type": "dql",
-      "source": "@block(\"card_approval_rate\")"
-    },
-    {
-      "id": "fraud_region",
-      "title": "Fraud exposure by region and branch (certified block)",
-      "type": "dql",
-      "source": "@block(\"fraud_alerts_by_region\")"
-    },
-    {
-      "id": "merchant_watchlist",
-      "title": "Merchant watchlist",
-      "type": "sql",
-      "source": "SELECT\n  m.merchant_name,\n  m.merchant_category,\n  m.risk_band,\n  COUNT(*) AS alerts,\n  ROUND(SUM(f.amount_usd), 2) AS exposure_usd\nFROM read_csv_auto('./data/fraud_alerts.csv') f\nJOIN read_csv_auto('./data/merchants.csv') m ON f.merchant_id = m.merchant_id\nGROUP BY 1, 2, 3\nORDER BY exposure_usd DESC"
-    },
-    {
-      "id": "next_step",
-      "type": "markdown",
-      "source": "## App handoff\n\nOpen Apps -> Cards Operations -> Fraud Watch to see these same certified blocks packaged for stakeholders with persona preview."
-    }
-  ]
-}

package/templates/acme-bank/notebooks/credit_risk_review.dqlnb

@@ -1,42 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "Credit Risk Review",
-    "description": "Regional delinquency, probability of default, and high-risk exposure for risk office review.",
-    "status": "certified",
-    "categories": ["lending", "risk", "delinquency"],
-    "owner": "anika.shah@acme-bank.com"
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Credit Risk Review\n\nRisk analysts can use this notebook to inspect lending exposure before sending a dashboard to the Risk Office App."
-    },
-    {
-      "id": "risk_grade_exposure",
-      "title": "Exposure by risk grade",
-      "type": "sql",
-      "source": "SELECT\n  risk_grade,\n  COUNT(*) AS loan_count,\n  ROUND(SUM(outstanding_usd), 2) AS outstanding_usd,\n  ROUND(AVG(probability_default), 4) AS avg_probability_default\nFROM read_csv_auto('./data/loans.csv')\nGROUP BY 1\nORDER BY risk_grade"
-    },
-    {
-      "id": "delinquency_region",
-      "title": "Delinquency by region (certified block)",
-      "type": "dql",
-      "source": "@block(\"loan_delinquency_by_region\")"
-    },
-    {
-      "id": "high_risk_exposure",
-      "title": "High risk exposure (certified block)",
-      "type": "dql",
-      "source": "@block(\"high_risk_loan_exposure\")"
-    },
-    {
-      "id": "past_due_detail",
-      "title": "Loans past due by product",
-      "type": "sql",
-      "source": "SELECT\n  product,\n  COUNT(*) AS loans,\n  ROUND(SUM(outstanding_usd), 2) AS outstanding_usd,\n  ROUND(SUM(CASE WHEN days_past_due >= 30 THEN outstanding_usd ELSE 0 END), 2) AS delinquent_balance_usd\nFROM read_csv_auto('./data/loans.csv')\nGROUP BY 1\nORDER BY delinquent_balance_usd DESC"
-    }
-  ]
-}

package/templates/acme-bank/notebooks/executive_weekly_review.dqlnb

@@ -1,47 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "Executive Weekly Review",
-    "description": "Cross-domain CXO notebook combining cards, deposits, lending, and the executive scorecard.",
-    "status": "certified",
-    "categories": ["executive", "weekly-review", "cxo"],
-    "owner": "sara.fitch@acme-bank.com"
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Executive Weekly Review\n\nThis notebook is the analyst working surface behind the Executive Cockpit App. It combines certified blocks across cards, deposits, and lending."
-    },
-    {
-      "id": "scorecard",
-      "title": "Bank health scorecard (certified block)",
-      "type": "dql",
-      "source": "@block(\"bank_health_scorecard\")"
-    },
-    {
-      "id": "deposit_trend",
-      "title": "Deposit trend",
-      "type": "dql",
-      "source": "@block(\"deposit_trend\")"
-    },
-    {
-      "id": "fraud_exposure",
-      "title": "Fraud exposure",
-      "type": "dql",
-      "source": "@block(\"fraud_alerts_by_region\")"
-    },
-    {
-      "id": "credit_risk",
-      "title": "Credit risk",
-      "type": "dql",
-      "source": "@block(\"loan_delinquency_by_region\")"
-    },
-    {
-      "id": "action_notes",
-      "type": "markdown",
-      "source": "## Action notes\n\n- Fraud analysts review branch-level alerts in the Cards Operations App.\n- Retail leaders monitor net-new deposits in the Retail Deposits App.\n- Risk office reviews high-risk exposure in the Risk Office App.\n- Executives consume the packaged summary in the Executive Cockpit App."
-    }
-  ]
-}

package/templates/acme-bank/notebooks/retail_deposits_review.dqlnb

@@ -1,42 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "Retail Deposits Review",
-    "description": "Deposit balance trend, segment mix, and branch leaders for retail banking.",
-    "status": "certified",
-    "categories": ["deposits", "retail", "growth"],
-    "owner": "diego.ramos@acme-bank.com"
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Retail Deposits Review\n\nRetail leaders use this notebook to inspect deposit growth before packaging the same metrics into the Retail Deposits App."
-    },
-    {
-      "id": "deposit_snapshot",
-      "title": "Deposit snapshot by region",
-      "type": "sql",
-      "source": "SELECT\n  as_of_date,\n  region,\n  ROUND(SUM(balance_usd), 2) AS balance_usd,\n  ROUND(SUM(net_new_usd), 2) AS net_new_usd\nFROM read_csv_auto('./data/deposits.csv')\nGROUP BY 1, 2\nORDER BY 1, 2"
-    },
-    {
-      "id": "deposit_trend",
-      "title": "Deposit trend (certified block)",
-      "type": "dql",
-      "source": "@block(\"deposit_trend\")"
-    },
-    {
-      "id": "segment_balance",
-      "title": "Deposits by segment (certified block)",
-      "type": "dql",
-      "source": "@block(\"deposits_by_segment\")"
-    },
-    {
-      "id": "branch_leaders",
-      "title": "Branch deposit leaders (certified block)",
-      "type": "dql",
-      "source": "@block(\"branch_deposit_leaders\")"
-    }
-  ]
-}

package/templates/acme-bank/notebooks/welcome.dqlnb

@@ -1,44 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "{{PROJECT_NAME}} - Acme Bank Walkthrough",
-    "description": "Run certified banking blocks, then open Apps for stakeholder dashboards."
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Acme Bank\n\nThis notebook uses the packaged Acme Bank CSV warehouse and certified DQL blocks.\n\nRun the cells top-to-bottom, then click Apps in the left rail to open Cards Operations, Retail Deposits, Risk Office, and Executive Cockpit.\n\nAdditional sample notebooks are included for cards fraud operations, retail deposits, credit risk, and executive review."
-    },
-    {
-      "title": "Raw transaction health",
-      "id": "raw_transaction_health",
-      "type": "sql",
-      "source": "SELECT status, COUNT(*) AS transactions, ROUND(SUM(amount_usd), 2) AS volume_usd\nFROM read_csv_auto('./data/transactions.csv')\nGROUP BY 1\nORDER BY volume_usd DESC"
-    },
-    {
-      "title": "Fraud alerts by region (certified block)",
-      "id": "fraud_alerts_by_region",
-      "type": "dql",
-      "source": "@block(\"fraud_alerts_by_region\")"
-    },
-    {
-      "title": "Deposit trend (certified block)",
-      "id": "deposit_trend",
-      "type": "dql",
-      "source": "@block(\"deposit_trend\")"
-    },
-    {
-      "title": "Executive scorecard (certified block)",
-      "id": "bank_health_scorecard",
-      "type": "dql",
-      "source": "@block(\"bank_health_scorecard\")"
-    },
-    {
-      "id": "next_notebooks",
-      "type": "markdown",
-      "source": "## Next sample notebooks\n\n- `notebooks/cards_fraud_ops.dqlnb` - branch-aware fraud monitoring\n- `notebooks/retail_deposits_review.dqlnb` - deposit growth and segment mix\n- `notebooks/credit_risk_review.dqlnb` - delinquency and high-risk exposure\n- `notebooks/executive_weekly_review.dqlnb` - CXO scorecard and cross-domain review"
-    }
-  ]
-}

package/templates/acme-bank/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Acme Bank DQL analytics project.",
-  "scripts": {
-    "notebook": "dql notebook",
-    "compile": "dql compile",
-    "app:build": "dql app build",
-    "agent:reindex": "dql agent reindex",
-    "verify": "dql verify .",
-    "doctor": "dql doctor",
-    "test": "dql test"
-  },
-  "devDependencies": {
-    "@duckcodeailabs/dql-cli": "^1.5.3"
-  }
-}

package/templates/acme-bank/semantic-layer/dimensions/banking.yaml

@@ -1,36 +0,0 @@
-dimensions:
-  - name: region
-    label: Region
-    type: string
-    sql: region
-    table: customers
-    domain: banking
-
-  - name: branch_id
-    label: Branch
-    type: string
-    sql: branch_id
-    table: customers
-    domain: banking
-
-  - name: customer_segment
-    label: Customer Segment
-    type: string
-    sql: segment
-    table: customers
-    domain: deposits
-
-  - name: merchant_category
-    label: Merchant Category
-    type: string
-    sql: merchant_category
-    table: merchants
-    domain: cards
-
-  - name: risk_grade
-    label: Loan Risk Grade
-    type: string
-    sql: risk_grade
-    table: loans
-    domain: lending
-

package/templates/acme-bank/semantic-layer/metrics/banking.yaml

@@ -1,37 +0,0 @@
-metrics:
-  - name: card_volume
-    label: Card Volume
-    description: Total card transaction volume in USD.
-    type: sum
-    sql: amount_usd
-    table: transactions
-    domain: cards
-    tags: [cards, volume]
-
-  - name: fraud_exposure
-    label: Fraud Exposure
-    description: Total fraud alert exposure in USD.
-    type: sum
-    sql: amount_usd
-    table: fraud_alerts
-    domain: cards
-    tags: [fraud, risk]
-
-  - name: deposit_balance
-    label: Deposit Balance
-    description: Total customer deposit balance.
-    type: sum
-    sql: balance_usd
-    table: deposits
-    domain: deposits
-    tags: [deposits, balance]
-
-  - name: loan_outstanding
-    label: Loan Outstanding
-    description: Total outstanding loan balance.
-    type: sum
-    sql: outstanding_usd
-    table: loans
-    domain: lending
-    tags: [lending, exposure]
-

package/templates/empty/README.md

@@ -1,19 +0,0 @@
-# {{PROJECT_NAME}}
-
-An empty DQL project, scaffolded by `create-dql-app --template empty`.
-
-## Connect your warehouse
-
-Edit `dql.config.json` — DQL ships 15 drivers out of the box:
-[docs/reference/connectors.md](https://github.com/duckcode-ai/dql/blob/main/docs/reference/connectors.md).
-
-```bash
-npm install
-npm run doctor
-```
-
-## Start the notebook
-
-```bash
-npm run notebook
-```

package/templates/empty/dql.config.json

@@ -1,13 +0,0 @@
-{
-  "project": "{{PROJECT_NAME}}",
-  "connections": {
-    "default": {
-      "driver": "duckdb",
-      "filepath": ":memory:"
-    }
-  },
-  "semanticLayer": {
-    "provider": "dql",
-    "path": "semantic-layer"
-  }
-}

package/templates/empty/package.json

@@ -1,13 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "notebook": "dql notebook",
-    "compile": "dql compile",
-    "doctor": "dql doctor"
-  },
-  "devDependencies": {
-    "@duckcodeailabs/dql-cli": "^1.5.3"
-  }
-}

package/templates/jaffle-shop/README.md

@@ -1,48 +0,0 @@
-# {{PROJECT_NAME}}
-
-A DQL analytics project, scaffolded by `create-dql-app`.
-
-## Run
-
-```bash
-npm install
-npm run notebook
-```
-
-Opens the notebook at <http://127.0.0.1:3474>. (`pnpm install && pnpm notebook`
-works too.)
-
-## Layout
-
-```
-dql.config.json        project config (connections, dbt, semantic layer)
-package.json           npm scripts — `notebook`, `compile`, `sync`, `doctor`
-notebooks/             .dqlnb notebooks (JSON format)
-blocks/                certified reusable .dql blocks
-semantic-layer/        metrics + dimensions authored locally
-dashboards/            compiled static HTML dashboards (git-ignored)
-```
-
-## Using with dbt
-
-If your dbt project is a sibling (e.g. `../dbt`), it was auto-wired into
-`dql.config.json` under the `dbt:` key. Then:
-
-```bash
-(cd ../dbt && dbt parse)   # produces target/manifest.json
-npm run sync               # refreshes the DQL cache from dbt
-npm run compile            # builds dql-manifest.json with lineage
-```
-
-## Next steps
-
-1. **Run the welcome notebook** — `notebooks/welcome.dqlnb`
-2. **Connect your warehouse** — [docs/guides/connect-warehouse.md](https://github.com/duckcode-ai/dql/blob/main/docs/guides/connect-warehouse.md)
-3. **Import your dbt project** — [docs/guides/import-dbt.md](https://github.com/duckcode-ai/dql/blob/main/docs/guides/import-dbt.md)
-4. **Author a certified block** — [docs/guides/authoring-blocks.md](https://github.com/duckcode-ai/dql/blob/main/docs/guides/authoring-blocks.md)
-
-## Learn
-
-- [Quickstart](https://github.com/duckcode-ai/dql/blob/main/docs/01-quickstart.md)
-- [Concepts](https://github.com/duckcode-ai/dql/blob/main/docs/02-concepts.md)
-- [CLI reference](https://github.com/duckcode-ai/dql/blob/main/docs/reference/cli.md)

package/templates/jaffle-shop/blocks/revenue_by_segment.dql

@@ -1,26 +0,0 @@
-// dql-format: 1
-
-block "Revenue by segment" {
-  domain = "finance"
-  type = "custom"
-  description = "Gross revenue grouped by customer segment."
-  tags = ["revenue", "sample"]
-  query = """
-    SELECT
-      c.customer_segment AS segment,
-      SUM(o.amount) AS revenue,
-      COUNT(DISTINCT o.customer_id) AS customers
-    FROM orders o
-    JOIN customers c ON c.customer_id = o.customer_id
-    GROUP BY 1
-    ORDER BY revenue DESC
-  """
-  visualization {
-    chart = "bar"
-    x = segment
-    y = revenue
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/jaffle-shop/dashboards/overview.dql

@@ -1,27 +0,0 @@
-// dql-format: 1
-
-dashboard "{{PROJECT_NAME}} — Overview" {
-  chart.kpi(
-    SELECT SUM(amount) as revenue FROM orders,
-    metrics = ["revenue"]
-  )
-  chart.bar(
-    SELECT customer_id, SUM(amount) as spend
-    FROM orders
-    GROUP BY customer_id
-    ORDER BY spend DESC
-    LIMIT 10,
-    x = customer_id,
-    y = spend,
-    title = "Top 10 customers by spend"
-  )
-  chart.line(
-    SELECT order_date, SUM(amount) as revenue
-    FROM orders
-    GROUP BY order_date
-    ORDER BY order_date,
-    x = order_date,
-    y = revenue,
-    title = "Daily revenue"
-  )
-}

package/templates/jaffle-shop/notebooks/welcome.dqlnb

@@ -1,33 +0,0 @@
-{
-  "dqlnbVersion": 1,
-  "version": 1,
-  "metadata": {
-    "title": "{{PROJECT_NAME}} — Welcome",
-    "description": "A tour of DQL in four cells. Run them top-to-bottom with Cmd+Enter."
-  },
-  "cells": [
-    {
-      "id": "intro",
-      "type": "markdown",
-      "source": "# Welcome to {{PROJECT_NAME}}\n\nThis notebook runs against a DuckDB-backed Jaffle Shop dataset — the same demo data dbt ships.\n\n- Run each cell with `Cmd/Ctrl + Enter`.\n- Charts render inline from SQL results.\n- The certified block in cell 4 lives in `blocks/revenue_by_segment.dql` and can be reused across notebooks and dashboards."
-    },
-    {
-      "title": "Orders overview",
-      "id": "orders_overview",
-      "type": "sql",
-      "source": "select\n  count(*) as total_orders,\n  count(distinct customer_id) as unique_customers,\n  sum(amount) as lifetime_revenue\nfrom orders"
-    },
-    {
-      "title": "Daily revenue",
-      "id": "daily_revenue",
-      "type": "sql",
-      "source": "select\n  order_date,\n  sum(amount) as revenue\nfrom orders\ngroup by 1\norder by 1"
-    },
-    {
-      "title": "Revenue by segment (certified block)",
-      "id": "revenue_by_segment",
-      "type": "dql",
-      "source": "@block(\"Revenue by segment\")"
-    }
-  ]
-}

package/templates/jaffle-shop/semantic-layer/dimensions/customer.yaml

@@ -1,14 +0,0 @@
-dimensions:
-  - name: segment
-    label: Customer segment
-    type: string
-    sql: segment
-    table: customers
-    domain: finance
-
-  - name: region
-    label: Region
-    type: string
-    sql: region
-    table: customers
-    domain: finance

package/templates/jaffle-shop/semantic-layer/metrics/revenue.yaml

@@ -1,9 +0,0 @@
-metrics:
-  - name: revenue
-    label: Revenue
-    description: Gross revenue across all orders
-    type: sum
-    sql: order_total
-    table: orders
-    domain: finance
-    tags: [revenue, core]