create-dql-app 1.6.0 → 1.6.2

package/templates/acme-bank/apps/executive-cockpit/dql.app.json

@@ -1,82 +0,0 @@
-{
-  "version": 1,
-  "id": "executive-cockpit",
-  "name": "Executive Cockpit",
-  "description": "CXO scorecard that summarizes cards, fraud, deposits, and lending risk.",
-  "domain": "executive",
-  "owners": ["sara.fitch@acme-bank.com"],
-  "tags": ["executive", "cxo", "scorecard", "audience:cxo"],
-  "members": [
-    {
-      "userId": "sara.fitch@acme-bank.com",
-      "displayName": "Sara Fitch - CFO",
-      "roles": ["owner"],
-      "attributes": { "department": "finance" }
-    },
-    {
-      "userId": "nora.evans@acme-bank.com",
-      "displayName": "Nora Evans - COO",
-      "roles": ["viewer"],
-      "attributes": { "department": "operations" }
-    }
-  ],
-  "roles": [
-    { "id": "owner", "displayName": "Owner", "description": "Full App configuration and execution." },
-    { "id": "analyst", "displayName": "Analyst", "description": "Can execute dashboards and review proposed blocks." },
-    { "id": "viewer", "displayName": "Viewer", "description": "Can view and run certified dashboard tiles." }
-  ],
-  "policies": [
-    {
-      "id": "executive-dashboard-execute",
-      "domain": "executive",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "executive-cards-readthrough",
-      "domain": "cards",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "executive-deposits-readthrough",
-      "domain": "deposits",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "executive-lending-readthrough",
-      "domain": "lending",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "executive-owner-admin",
-      "domain": "executive",
-      "minClassification": "restricted",
-      "allowedRoles": ["owner"],
-      "accessLevel": "admin",
-      "enabled": true
-    }
-  ],
-  "rlsBindings": [],
-  "schedules": [
-    {
-      "id": "monday-cxo-scorecard",
-      "cron": "0 7 * * 1",
-      "dashboard": "bank-overview",
-      "deliver": [{ "kind": "slack", "channel": "#cxo-weekly" }],
-      "description": "Monday morning CXO scorecard.",
-      "enabled": true
-    }
-  ],
-  "homepage": { "type": "dashboard", "id": "bank-overview" }
-}

package/templates/acme-bank/apps/executive-cockpit/drafts/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/apps/executive-cockpit/notebooks/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/apps/retail-deposits/README.md

@@ -1,9 +0,0 @@
-# Retail Deposits
-
-Audience: retail banking leaders tracking deposit growth and branch leaders.
-
-Homepage dashboard: `dashboards/deposit-growth.dqld`
-
-Certified blocks stay in root `blocks/deposits/`. This App packages the
-deposit growth dashboard with programmable OSS governance.
-

package/templates/acme-bank/apps/retail-deposits/dashboards/deposit-growth.dqld

@@ -1,48 +0,0 @@
-{
-  "version": 1,
-  "id": "deposit-growth",
-  "metadata": {
-    "title": "Deposit Growth",
-    "description": "Certified deposit growth dashboard by segment, branch, and snapshot date.",
-    "domain": "deposits",
-    "tags": ["deposits", "growth", "retail"]
-  },
-  "layout": {
-    "kind": "grid",
-    "cols": 12,
-    "rowHeight": 80,
-    "items": [
-      {
-        "i": "deposit-trend",
-        "x": 0,
-        "y": 0,
-        "w": 12,
-        "h": 3,
-        "block": { "blockId": "deposit_trend" },
-        "viz": { "type": "line" },
-        "title": "Total Deposit Trend"
-      },
-      {
-        "i": "segment-balance",
-        "x": 0,
-        "y": 3,
-        "w": 6,
-        "h": 3,
-        "block": { "blockId": "deposits_by_segment" },
-        "viz": { "type": "bar" },
-        "title": "Deposits by Segment"
-      },
-      {
-        "i": "branch-leaders",
-        "x": 6,
-        "y": 3,
-        "w": 6,
-        "h": 4,
-        "block": { "blockId": "branch_deposit_leaders" },
-        "viz": { "type": "table" },
-        "title": "Branch Leaders"
-      }
-    ]
-  }
-}
-

package/templates/acme-bank/apps/retail-deposits/dql.app.json

@@ -1,59 +0,0 @@
-{
-  "version": 1,
-  "id": "retail-deposits",
-  "name": "Retail Deposits",
-  "description": "Deposit growth and branch leaderboard App for retail banking leaders.",
-  "domain": "deposits",
-  "owners": ["diego.ramos@acme-bank.com"],
-  "tags": ["deposits", "retail", "growth", "audience:retail-leaders"],
-  "members": [
-    {
-      "userId": "diego.ramos@acme-bank.com",
-      "displayName": "Diego Ramos - Retail Analytics",
-      "roles": ["owner", "analyst"],
-      "attributes": { "department": "retail" }
-    },
-    {
-      "userId": "nora.evans@acme-bank.com",
-      "displayName": "Nora Evans - Retail COO",
-      "roles": ["viewer"],
-      "attributes": { "department": "retail" }
-    }
-  ],
-  "roles": [
-    { "id": "owner", "displayName": "Owner", "description": "Full App configuration and execution." },
-    { "id": "analyst", "displayName": "Analyst", "description": "Can execute dashboards and review proposed blocks." },
-    { "id": "viewer", "displayName": "Viewer", "description": "Can view and run certified dashboard tiles." }
-  ],
-  "policies": [
-    {
-      "id": "deposits-dashboard-view",
-      "domain": "deposits",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "deposits-owner-admin",
-      "domain": "deposits",
-      "minClassification": "restricted",
-      "allowedRoles": ["owner"],
-      "accessLevel": "admin",
-      "enabled": true
-    }
-  ],
-  "rlsBindings": [],
-  "schedules": [
-    {
-      "id": "weekly-deposit-growth",
-      "cron": "0 9 * * 1",
-      "dashboard": "deposit-growth",
-      "deliver": [{ "kind": "slack", "channel": "#retail-deposits" }],
-      "description": "Weekly deposits growth digest.",
-      "enabled": true
-    }
-  ],
-  "homepage": { "type": "dashboard", "id": "deposit-growth" }
-}
-

package/templates/acme-bank/apps/retail-deposits/drafts/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/apps/retail-deposits/notebooks/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/apps/risk-office/README.md

@@ -1,8 +0,0 @@
-# Risk Office
-
-Audience: credit and fraud risk committee.
-
-Homepage dashboard: `dashboards/credit-risk.dqld`
-
-Certified lending and card-fraud blocks are shared from root `blocks/`.
-

package/templates/acme-bank/apps/risk-office/dashboards/credit-risk.dqld

@@ -1,48 +0,0 @@
-{
-  "version": 1,
-  "id": "credit-risk",
-  "metadata": {
-    "title": "Credit Risk",
-    "description": "Certified lending risk dashboard for delinquency and high-risk exposure.",
-    "domain": "lending",
-    "tags": ["risk", "lending", "credit-risk"]
-  },
-  "layout": {
-    "kind": "grid",
-    "cols": 12,
-    "rowHeight": 80,
-    "items": [
-      {
-        "i": "delinquency-region",
-        "x": 0,
-        "y": 0,
-        "w": 6,
-        "h": 3,
-        "block": { "blockId": "loan_delinquency_by_region" },
-        "viz": { "type": "bar" },
-        "title": "Delinquency by Region"
-      },
-      {
-        "i": "high-risk-exposure",
-        "x": 6,
-        "y": 0,
-        "w": 6,
-        "h": 4,
-        "block": { "blockId": "high_risk_loan_exposure" },
-        "viz": { "type": "table" },
-        "title": "High-Risk Loan Exposure"
-      },
-      {
-        "i": "merchant-fraud",
-        "x": 0,
-        "y": 4,
-        "w": 6,
-        "h": 3,
-        "block": { "blockId": "fraud_by_merchant_recent" },
-        "viz": { "type": "bar" },
-        "title": "Merchant Fraud Watch"
-      }
-    ]
-  }
-}
-

package/templates/acme-bank/apps/risk-office/dql.app.json

@@ -1,57 +0,0 @@
-{
-  "version": 1,
-  "id": "risk-office",
-  "name": "Risk Office",
-  "description": "Credit and fraud exposure App for risk management leaders.",
-  "domain": "lending",
-  "owners": ["anika.shah@acme-bank.com"],
-  "tags": ["risk", "lending", "fraud", "audience:risk-committee"],
-  "members": [
-    {
-      "userId": "anika.shah@acme-bank.com",
-      "displayName": "Anika Shah - Chief Risk Officer",
-      "roles": ["owner"],
-      "attributes": { "department": "risk" }
-    },
-    {
-      "userId": "omar.ali@acme-bank.com",
-      "displayName": "Omar Ali - Risk Analyst",
-      "roles": ["analyst"],
-      "attributes": { "department": "risk" }
-    }
-  ],
-  "roles": [
-    { "id": "owner", "displayName": "Owner", "description": "Full App configuration and execution." },
-    { "id": "analyst", "displayName": "Analyst", "description": "Can execute dashboards and review proposed blocks." },
-    { "id": "viewer", "displayName": "Viewer", "description": "Can view and run certified dashboard tiles." }
-  ],
-  "policies": [
-    {
-      "id": "risk-dashboard-execute",
-      "domain": "lending",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "risk-fraud-readthrough",
-      "domain": "cards",
-      "minClassification": "internal",
-      "allowedRoles": ["viewer", "analyst", "owner"],
-      "accessLevel": "execute",
-      "enabled": true
-    },
-    {
-      "id": "risk-admin",
-      "domain": "lending",
-      "minClassification": "restricted",
-      "allowedRoles": ["owner"],
-      "accessLevel": "admin",
-      "enabled": true
-    }
-  ],
-  "rlsBindings": [],
-  "schedules": [],
-  "homepage": { "type": "dashboard", "id": "credit-risk" }
-}

package/templates/acme-bank/apps/risk-office/drafts/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/apps/risk-office/notebooks/.gitkeep

@@ -1 +0,0 @@
-

package/templates/acme-bank/blocks/cards/card_approval_rate.dql

@@ -1,24 +0,0 @@
-// dql-format: 1
-
-block "card_approval_rate" {
-  domain = "cards"
-  type = "custom"
-  status = "certified"
-  description = "Card approval rate across the seeded card transaction stream."
-  tags = ["cards", "kpi", "approval-rate", "ops"]
-  owner = "mei.chen@acme-bank.com"
-  llmContext = "Use this single-value KPI when stakeholders ask about card approval rate or transaction decline pressure."
-  examples = [{ question = "What is our card approval rate?" }]
-  invariants = ["approval_rate_pct >= 0", "approval_rate_pct <= 100"]
-  query = """
-    SELECT
-      ROUND(100.0 * SUM(CASE WHEN status = 'approved' THEN 1 ELSE 0 END) / COUNT(*), 2) AS approval_rate_pct
-    FROM read_csv_auto('./data/transactions.csv')
-  """
-  visualization {
-    chart = "single_value"
-  }
-  tests {
-    assert row_count == 1
-  }
-}

package/templates/acme-bank/blocks/cards/daily_transaction_volume.dql

@@ -1,34 +0,0 @@
-// dql-format: 1
-
-@rls("region", "{user.region}")
-@rls("branch_id", "{user.branch}")
-block "daily_transaction_volume" {
-  domain = "cards"
-  type = "custom"
-  status = "certified"
-  description = "Daily approved and declined card transaction volume."
-  tags = ["cards", "volume", "daily", "ops"]
-  owner = "mei.chen@acme-bank.com"
-  llmContext = "Use for daily card transaction count, card spend volume, and approval or decline trend questions."
-  examples = [{ question = "What was card volume this week?" }, { question = "Show transaction volume by day." }]
-  invariants = ["volume_usd >= 0", "txn_count >= 0"]
-  query = """
-    SELECT
-      CAST(txn_ts AS DATE) AS day,
-      region,
-      branch_id,
-      COUNT(*) AS txn_count,
-      ROUND(SUM(amount_usd), 2) AS volume_usd
-    FROM read_csv_auto('./data/transactions.csv')
-    GROUP BY 1, 2, 3
-    ORDER BY 1, 2, 3
-  """
-  visualization {
-    chart = "line"
-    x = "day"
-    y = "volume_usd"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/cards/fraud_alerts_by_region.dql

@@ -1,33 +0,0 @@
-// dql-format: 1
-
-@rls("region", "{user.region}")
-@rls("branch_id", "{user.branch}")
-block "fraud_alerts_by_region" {
-  domain = "cards"
-  type = "custom"
-  status = "certified"
-  description = "Confirmed and review fraud exposure by region and branch."
-  tags = ["fraud", "cards", "ops", "risk"]
-  owner = "mei.chen@acme-bank.com"
-  llmContext = "Use this block for card fraud exposure, fraud alert counts, and branch-level fraud monitoring. It supports persona RLS on region and branch_id."
-  examples = [{ question = "Which regions have the most card fraud exposure?" }, { question = "Show fraud alerts for my branch." }]
-  invariants = ["exposure_usd >= 0", "alert_count >= 0"]
-  query = """
-    SELECT
-      region,
-      branch_id,
-      COUNT(*) AS alert_count,
-      ROUND(SUM(amount_usd), 2) AS exposure_usd
-    FROM read_csv_auto('./data/fraud_alerts.csv')
-    GROUP BY 1, 2
-    ORDER BY exposure_usd DESC
-  """
-  visualization {
-    chart = "bar"
-    x = "region"
-    y = "exposure_usd"
-  }
-  tests {
-    assert row_count >= 0
-  }
-}

package/templates/acme-bank/blocks/cards/fraud_by_merchant_recent.dql

@@ -1,33 +0,0 @@
-// dql-format: 1
-
-block "fraud_by_merchant_recent" {
-  domain = "cards"
-  type = "custom"
-  status = "certified"
-  description = "Fraud exposure grouped by merchant and merchant risk band."
-  tags = ["fraud", "merchant", "cards", "risk"]
-  owner = "mei.chen@acme-bank.com"
-  llmContext = "Use this block when users ask which merchants are driving fraud, merchant risk, blocklist exposure, or card fraud concentration."
-  examples = [{ question = "Which merchants are driving card fraud?" }, { question = "Show fraud exposure by merchant risk band." }]
-  invariants = ["exposure_usd >= 0", "alerts >= 0"]
-  query = """
-    SELECT
-      m.merchant_name,
-      m.merchant_category,
-      m.risk_band,
-      COUNT(*) AS alerts,
-      ROUND(SUM(f.amount_usd), 2) AS exposure_usd
-    FROM read_csv_auto('./data/fraud_alerts.csv') f
-    JOIN read_csv_auto('./data/merchants.csv') m USING (merchant_id)
-    GROUP BY 1, 2, 3
-    ORDER BY exposure_usd DESC
-  """
-  visualization {
-    chart = "bar"
-    x = "merchant_name"
-    y = "exposure_usd"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/deposits/branch_deposit_leaders.dql

@@ -1,30 +0,0 @@
-// dql-format: 1
-
-block "branch_deposit_leaders" {
-  domain = "deposits"
-  type = "custom"
-  status = "certified"
-  description = "Branches ranked by current deposit balance and weekly net-new deposits."
-  tags = ["deposits", "branch", "leaderboard", "retail"]
-  owner = "diego.ramos@acme-bank.com"
-  llmContext = "Use this block for branch deposit leaderboards, branch ranking, and regional retail growth conversations."
-  examples = [{ question = "Which branches lead deposits?" }]
-  invariants = ["balance_usd >= 0"]
-  query = """
-    SELECT
-      region,
-      branch_id,
-      ROUND(SUM(balance_usd), 2) AS balance_usd,
-      ROUND(SUM(net_new_usd), 2) AS net_new_usd
-    FROM read_csv_auto('./data/deposits.csv')
-    WHERE as_of_date = (SELECT MAX(as_of_date) FROM read_csv_auto('./data/deposits.csv'))
-    GROUP BY 1, 2
-    ORDER BY balance_usd DESC
-  """
-  visualization {
-    chart = "table"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/deposits/deposit_trend.dql

@@ -1,30 +0,0 @@
-// dql-format: 1
-
-block "deposit_trend" {
-  domain = "deposits"
-  type = "custom"
-  status = "certified"
-  description = "Total deposit balance trend by snapshot date."
-  tags = ["deposits", "trend", "growth", "retail"]
-  owner = "diego.ramos@acme-bank.com"
-  llmContext = "Use for total deposit trend, retail deposit growth, and balance movement over time."
-  examples = [{ question = "Are deposits growing?" }, { question = "Show deposit balance trend." }]
-  invariants = ["balance_usd >= 0"]
-  query = """
-    SELECT
-      as_of_date,
-      ROUND(SUM(balance_usd), 2) AS balance_usd,
-      ROUND(SUM(net_new_usd), 2) AS net_new_usd
-    FROM read_csv_auto('./data/deposits.csv')
-    GROUP BY 1
-    ORDER BY 1
-  """
-  visualization {
-    chart = "line"
-    x = "as_of_date"
-    y = "balance_usd"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/deposits/deposits_by_segment.dql

@@ -1,33 +0,0 @@
-// dql-format: 1
-
-@rls("region", "{user.region}")
-block "deposits_by_segment" {
-  domain = "deposits"
-  type = "custom"
-  status = "certified"
-  description = "Current deposit balance and net-new deposits by customer segment."
-  tags = ["deposits", "retail", "segment", "balance"]
-  owner = "diego.ramos@acme-bank.com"
-  llmContext = "Use for deposit balances, net-new deposits, and segment mix questions in the retail deposits domain."
-  examples = [{ question = "Which customer segments hold the most deposits?" }, { question = "How much net-new deposit growth did we see?" }]
-  invariants = ["balance_usd >= 0"]
-  query = """
-    SELECT
-      segment,
-      region,
-      ROUND(SUM(balance_usd), 2) AS balance_usd,
-      ROUND(SUM(net_new_usd), 2) AS net_new_usd
-    FROM read_csv_auto('./data/deposits.csv')
-    WHERE as_of_date = (SELECT MAX(as_of_date) FROM read_csv_auto('./data/deposits.csv'))
-    GROUP BY 1, 2
-    ORDER BY balance_usd DESC
-  """
-  visualization {
-    chart = "bar"
-    x = "segment"
-    y = "balance_usd"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/executive/bank_health_scorecard.dql

@@ -1,34 +0,0 @@
-// dql-format: 1
-
-block "bank_health_scorecard" {
-  domain = "executive"
-  type = "custom"
-  status = "certified"
-  description = "Executive scorecard with cards volume, fraud exposure, deposits, and high-risk lending exposure."
-  tags = ["executive", "cxo", "scorecard", "bank-health"]
-  owner = "sara.fitch@acme-bank.com"
-  llmContext = "Use for CXO questions about overall Acme Bank health across cards, fraud, deposits, and lending risk."
-  examples = [{ question = "Give me the bank health scorecard." }, { question = "What should the CFO review this week?" }]
-  invariants = ["metric_value >= 0"]
-  query = """
-    SELECT 'card_volume_usd' AS metric, ROUND(SUM(amount_usd), 2) AS metric_value
-    FROM read_csv_auto('./data/transactions.csv')
-    UNION ALL
-    SELECT 'fraud_exposure_usd' AS metric, ROUND(SUM(amount_usd), 2) AS metric_value
-    FROM read_csv_auto('./data/fraud_alerts.csv')
-    UNION ALL
-    SELECT 'current_deposits_usd' AS metric, ROUND(SUM(balance_usd), 2) AS metric_value
-    FROM read_csv_auto('./data/deposits.csv')
-    WHERE as_of_date = (SELECT MAX(as_of_date) FROM read_csv_auto('./data/deposits.csv'))
-    UNION ALL
-    SELECT 'high_risk_loans_usd' AS metric, ROUND(SUM(outstanding_usd), 2) AS metric_value
-    FROM read_csv_auto('./data/loans.csv')
-    WHERE risk_grade IN ('C', 'D')
-  """
-  visualization {
-    chart = "table"
-  }
-  tests {
-    assert row_count == 4
-  }
-}

package/templates/acme-bank/blocks/lending/high_risk_loan_exposure.dql

@@ -1,31 +0,0 @@
-// dql-format: 1
-
-block "high_risk_loan_exposure" {
-  domain = "lending"
-  type = "custom"
-  status = "certified"
-  description = "High-risk loan exposure for risk grades C and D."
-  tags = ["lending", "credit-risk", "exposure", "risk"]
-  owner = "anika.shah@acme-bank.com"
-  llmContext = "Use for high-risk loan exposure, watchlist balances, risk grades C and D, and credit-risk committee reviews."
-  examples = [{ question = "How much exposure is in high-risk loans?" }, { question = "Show the credit watchlist." }]
-  invariants = ["outstanding_usd >= 0"]
-  query = """
-    SELECT
-      risk_grade,
-      product,
-      COUNT(*) AS loans,
-      ROUND(SUM(outstanding_usd), 2) AS outstanding_usd,
-      ROUND(AVG(probability_default), 4) AS avg_probability_default
-    FROM read_csv_auto('./data/loans.csv')
-    WHERE risk_grade IN ('C', 'D')
-    GROUP BY 1, 2
-    ORDER BY outstanding_usd DESC
-  """
-  visualization {
-    chart = "table"
-  }
-  tests {
-    assert row_count > 0
-  }
-}

package/templates/acme-bank/blocks/lending/loan_delinquency_by_region.dql

@@ -1,32 +0,0 @@
-// dql-format: 1
-
-@rls("region", "{user.region}")
-block "loan_delinquency_by_region" {
-  domain = "lending"
-  type = "custom"
-  status = "certified"
-  description = "Loan delinquency exposure by region."
-  tags = ["lending", "credit-risk", "delinquency", "risk"]
-  owner = "anika.shah@acme-bank.com"
-  llmContext = "Use for delinquent loan exposure, days-past-due summaries, and regional lending risk questions."
-  examples = [{ question = "Which regions have the most delinquent loan exposure?" }, { question = "Show credit risk by region." }]
-  invariants = ["delinquent_balance_usd >= 0"]
-  query = """
-    SELECT
-      region,
-      COUNT(*) AS loan_count,
-      ROUND(SUM(CASE WHEN days_past_due >= 30 THEN outstanding_usd ELSE 0 END), 2) AS delinquent_balance_usd,
-      ROUND(AVG(probability_default), 4) AS avg_probability_default
-    FROM read_csv_auto('./data/loans.csv')
-    GROUP BY 1
-    ORDER BY delinquent_balance_usd DESC
-  """
-  visualization {
-    chart = "bar"
-    x = "region"
-    y = "delinquent_balance_usd"
-  }
-  tests {
-    assert row_count > 0
-  }
-}