@duckcodeailabs/dql-cli 0.1.1 → 0.1.4

package/dist/assets/notebook-browser/styles.css

@@ -0,0 +1,336 @@
+:root {
+  color-scheme: dark;
+  --bg: #09111f;
+  --panel: #0f172a;
+  --panel-2: #111c31;
+  --border: #243248;
+  --text: #e5eefc;
+  --muted: #93a4bf;
+  --accent: #59c2ff;
+  --accent-2: #2563eb;
+  --danger: #ef4444;
+  --success: #22c55e;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: Inter, system-ui, sans-serif;
+  background: radial-gradient(circle at top, #10203c, var(--bg) 48%);
+  color: var(--text);
+}
+
+button,
+select,
+input,
+textarea {
+  font: inherit;
+}
+
+button {
+  border: 1px solid var(--border);
+  background: var(--panel-2);
+  color: var(--text);
+  border-radius: 10px;
+  padding: 0.6rem 0.9rem;
+  cursor: pointer;
+}
+
+button.primary {
+  background: linear-gradient(135deg, var(--accent), var(--accent-2));
+  color: #08111f;
+  border-color: transparent;
+}
+
+button.secondary {
+  background: transparent;
+}
+
+.app-shell {
+  display: grid;
+  grid-template-columns: 300px 1fr;
+  min-height: 100vh;
+}
+
+.sidebar {
+  border-right: 1px solid var(--border);
+  background: rgba(9, 17, 31, 0.88);
+  padding: 1.25rem;
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  overflow: auto;
+}
+
+.brand {
+  display: flex;
+  gap: 0.9rem;
+  align-items: center;
+  margin-bottom: 1.5rem;
+}
+
+.brand p,
+.subtitle,
+.status,
+.field-help,
+.cell-status {
+  color: var(--muted);
+}
+
+.brand-mark {
+  width: 48px;
+  height: 48px;
+  border-radius: 14px;
+  background: linear-gradient(135deg, var(--accent), #8b5cf6);
+  color: #05111f;
+  display: grid;
+  place-items: center;
+  font-weight: 700;
+}
+
+.section-title {
+  font-size: 0.82rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--muted);
+  margin: 1.25rem 0 0.75rem;
+}
+
+.panel,
+.cell,
+.chart-editor,
+.table-shell {
+  background: rgba(17, 28, 49, 0.82);
+  border: 1px solid var(--border);
+  border-radius: 16px;
+}
+
+.panel {
+  padding: 0.85rem;
+}
+
+.panel.small {
+  margin-bottom: 0.8rem;
+}
+
+.main {
+  padding: 1.25rem 1.4rem 2rem;
+}
+
+.toolbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+
+.toolbar h1 {
+  margin: 0 0 0.3rem;
+}
+
+.toolbar-actions,
+.row-actions,
+.cell-actions {
+  display: flex;
+  gap: 0.55rem;
+  flex-wrap: wrap;
+}
+
+.cells {
+  display: grid;
+  gap: 1rem;
+}
+
+.cell {
+  overflow: hidden;
+}
+
+.cell-header {
+  padding: 0.85rem 1rem;
+  border-bottom: 1px solid var(--border);
+  display: flex;
+  justify-content: space-between;
+  gap: 0.75rem;
+  align-items: center;
+}
+
+.cell-type {
+  display: inline-block;
+  min-width: 88px;
+  font-size: 0.76rem;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--accent);
+}
+
+.cell-title,
+select,
+.field input {
+  width: 100%;
+  padding: 0.65rem 0.75rem;
+  border-radius: 10px;
+  border: 1px solid var(--border);
+  background: rgba(9, 17, 31, 0.8);
+  color: var(--text);
+}
+
+.cell-title {
+  margin-top: 0.35rem;
+}
+
+.cell-body {
+  padding: 1rem;
+}
+
+.cell-source {
+  width: 100%;
+  min-height: 200px;
+  padding: 0.85rem;
+  border-radius: 12px;
+  border: 1px solid var(--border);
+  background: #07101d;
+  color: var(--text);
+  resize: vertical;
+}
+
+.cell-output {
+  margin-top: 1rem;
+}
+
+.file-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.file-list li {
+  padding: 0.42rem 0;
+  color: var(--muted);
+  border-bottom: 1px solid rgba(36, 50, 72, 0.35);
+}
+
+.field {
+  margin-top: 0.75rem;
+}
+
+.field-label {
+  display: block;
+  margin-top: 0.6rem;
+  margin-bottom: 0.35rem;
+  color: var(--muted);
+}
+
+.checkbox {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.chart-editor {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+  gap: 0.75rem;
+  padding: 0.9rem;
+  margin-bottom: 1rem;
+}
+
+.chart-card {
+  padding: 1rem;
+  background: linear-gradient(180deg, rgba(12, 21, 37, 0.98), rgba(17, 28, 49, 0.9));
+  border-radius: 14px;
+  border: 1px solid var(--border);
+}
+
+.kpi-value {
+  font-size: 2rem;
+  font-weight: 700;
+  margin-top: 0.5rem;
+}
+
+.bar-row {
+  display: grid;
+  grid-template-columns: 140px 1fr 90px;
+  gap: 0.75rem;
+  align-items: center;
+  margin-bottom: 0.5rem;
+}
+
+.bar-track {
+  height: 12px;
+  background: rgba(255, 255, 255, 0.06);
+  border-radius: 999px;
+  overflow: hidden;
+}
+
+.bar-fill {
+  height: 100%;
+  background: linear-gradient(90deg, var(--accent), #8b5cf6);
+}
+
+.table-shell {
+  overflow: auto;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+th,
+td {
+  text-align: left;
+  padding: 0.7rem 0.85rem;
+  border-bottom: 1px solid rgba(36, 50, 72, 0.6);
+}
+
+th {
+  color: var(--muted);
+  font-size: 0.85rem;
+}
+
+.markdown-preview {
+  padding: 1rem;
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  background: rgba(7, 16, 29, 0.7);
+  line-height: 1.6;
+}
+
+.markdown-preview h1,
+.markdown-preview h2,
+.markdown-preview h3 {
+  margin-top: 0;
+}
+
+.status.ok {
+  color: var(--success);
+}
+
+.status.error {
+  color: var(--danger);
+}
+
+.hidden {
+  display: none;
+}
+
+@media (max-width: 1100px) {
+  .app-shell {
+    grid-template-columns: 1fr;
+  }
+
+  .sidebar {
+    position: static;
+    height: auto;
+    border-right: 0;
+    border-bottom: 1px solid var(--border);
+  }
+
+  .toolbar {
+    flex-direction: column;
+  }
+}

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

@@ -0,0 +1,27 @@
+# __PROJECT_NAME__
+
+This template packages a realistic e-commerce analytics sandbox for DQL.
+
+## 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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+name: channel
+label: Channel
+domain: commerce
+description: Order acquisition channel.

package/dist/assets/templates/ecommerce/semantic-layer/metrics/gmv.yaml

@@ -0,0 +1,4 @@
+name: gmv
+label: Gross Merchandise Value
+domain: commerce
+description: Total order value across the commerce sample dataset.

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,20 @@
+# __PROJECT_NAME__
+
+This template packages a SaaS KPI sandbox focused on MRR, retention, and expansion.
+
+## Included assets
+
+- `blocks/revenue_by_segment.dql` — MRR by plan tier
+- `blocks/churn_pressure.dql` — at-risk and churned revenue view
+- `dashboards/growth_scorecard.dql` — executive SaaS KPI dashboard
+- `data/subscriptions.csv` — recurring revenue and expansion sample data
+- `data/cohorts.csv` — cohort retention snapshot
+- `notebooks/welcome.dqlnb` — browser notebook walkthrough
+
+## Quick start
+
+```bash
+dql doctor
+dql notebook
+dql preview blocks/revenue_by_segment.dql --open
+```

package/dist/assets/templates/saas/blocks/churn_pressure.dql

@@ -0,0 +1,25 @@
+block "Churn Pressure by Segment" {
+    domain = "saas"
+    type = "custom"
+    description = "MRR currently flagged as at risk or churned"
+    tags = ["saas", "churn"]
+    owner = "template"
+
+    query = """
+        SELECT risk_bucket, ROUND(SUM(mrr), 2) AS at_risk_mrr
+        FROM read_csv_auto('./data/subscriptions.csv')
+        WHERE status != 'active' OR risk_bucket IN ('high', 'critical')
+        GROUP BY risk_bucket
+        ORDER BY at_risk_mrr DESC
+    """
+
+    visualization {
+        chart = "bar"
+        x = risk_bucket
+        y = at_risk_mrr
+    }
+
+    tests {
+        assert row_count > 0
+    }
+}

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

@@ -0,0 +1,25 @@
+block "MRR by Plan Tier" {
+    domain = "saas"
+    type = "custom"
+    description = "Monthly recurring revenue by plan tier"
+    tags = ["saas", "mrr"]
+    owner = "template"
+
+    query = """
+        SELECT plan_tier, ROUND(SUM(mrr), 2) AS revenue
+        FROM read_csv_auto('./data/subscriptions.csv')
+        WHERE status = 'active'
+        GROUP BY plan_tier
+        ORDER BY revenue DESC
+    """
+
+    visualization {
+        chart = "bar"
+        x = plan_tier
+        y = revenue
+    }
+
+    tests {
+        assert row_count > 0
+    }
+}

package/dist/assets/templates/saas/dashboards/growth_scorecard.dql

@@ -0,0 +1,25 @@
+dashboard "Growth Scorecard" {
+  chart.kpi(
+    SELECT ROUND(SUM(mrr), 2) AS active_mrr
+    FROM read_csv_auto('./data/subscriptions.csv')
+    WHERE status = 'active',
+    metrics = ["active_mrr"],
+    title = "Active MRR"
+  )
+
+  chart.line(
+    SELECT cohort_month, retained_accounts
+    FROM read_csv_auto('./data/cohorts.csv')
+    ORDER BY cohort_month,
+    x = cohort_month,
+    y = retained_accounts,
+    title = "Retained Accounts by Cohort"
+  )
+
+  chart.table(
+    SELECT account_name, owner_segment, plan_tier, status, mrr, expansion_mrr, risk_bucket
+    FROM read_csv_auto('./data/subscriptions.csv')
+    ORDER BY mrr DESC,
+    title = "Account Revenue Snapshot"
+  )
+}

package/dist/assets/templates/saas/data/cohorts.csv

@@ -0,0 +1,7 @@
+cohort_month,starting_accounts,retained_accounts,retention_rate
+2024-07,24,22,0.92
+2024-08,31,27,0.87
+2024-09,28,24,0.86
+2024-10,34,28,0.82
+2024-11,29,23,0.79
+2024-12,37,28,0.76

package/dist/assets/templates/saas/data/subscriptions.csv

@@ -0,0 +1,13 @@
+account_id,account_name,owner_segment,plan_tier,status,mrr,expansion_mrr,risk_bucket,renewal_month
+A-100,Acme Cloud,Enterprise,Enterprise,active,48000,6200,low,2025-06
+A-101,North Ridge,Mid-Market,Growth,active,18400,2400,medium,2025-05
+A-102,Blue Orbit,SMB,Starter,active,3400,200,low,2025-04
+A-103,Helio Systems,Enterprise,Enterprise,at_risk,52100,0,high,2025-03
+A-104,Vector Health,Mid-Market,Growth,active,19600,1800,medium,2025-08
+A-105,Studio Works,SMB,Starter,churned,2200,0,critical,2025-02
+A-106,SignalWare,Enterprise,Enterprise,active,43500,4100,low,2025-07
+A-107,Maple Commerce,Mid-Market,Growth,active,17100,1200,medium,2025-04
+A-108,Linea Labs,SMB,Starter,active,2800,0,medium,2025-06
+A-109,Quartz Energy,Enterprise,Enterprise,active,50300,7300,low,2025-09
+A-110,Summit Bio,Mid-Market,Growth,at_risk,15800,0,high,2025-03
+A-111,Glider Ops,SMB,Starter,active,2600,150,low,2025-05

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

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

package/dist/assets/templates/saas/semantic-layer/metrics/mrr.yaml

@@ -0,0 +1,4 @@
+name: mrr
+label: Monthly Recurring Revenue
+domain: saas
+description: Monthly recurring revenue across active subscriptions.

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

@@ -0,0 +1 @@
+