@useatlas/create 0.0.2 → 0.0.4

package/templates/docker/package.json

@@ -20,14 +20,26 @@
     "@ai-sdk/anthropic": "^3.0.46",
     "@ai-sdk/openai": "^3.0.31",
     "@ai-sdk/react": "^3.0.99",
+    "@better-auth/api-key": "^1.5.1",
     "ai": "^6.0.97",
+    "better-auth": "^1.5.1",
+    "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "croner": "^9.0.0",
+    "hono": "^4.12.3",
+    "jose": "^6.1.3",
     "js-yaml": "^4.1.1",
-    "lucide-react": "^0.576.0",
     "just-bash": "^2.10.2",
+    "lucide-react": "^0.577.0",
+    "mysql2": "^3.18.0",
     "next": "^16.1.6",
     "node-sql-parser": "^5.4.0",
+    "nuqs": "^2.8.9",
     "pg": "^8.18.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "radix-ui": "^1.4.3",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-markdown": "^10.1.0",
@@ -41,6 +53,7 @@
     "@vercel/sandbox": "^1"
   },
   "devDependencies": {
+    "@clack/prompts": "^0.10.0",
     "@eslint/js": "^10.0.1",
     "@next/eslint-plugin-next": "^16.1.6",
     "@tailwindcss/postcss": "^4.2.1",
@@ -50,9 +63,12 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
+    "@types/bun": "^1.3.9",
     "@typescript/native-preview": "^7.0.0-dev.20260226.1",
     "eslint": "^10.0.2",
     "tailwindcss": "^4.2.1",
+    "shadcn": "^3.8.5",
+    "picocolors": "^1.1.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.56.1"
   }

package/templates/docker/semantic/catalog.yml

@@ -1,5 +1,64 @@
-# Atlas Semantic Layer — Catalog
-# Run `bun run atlas -- init` to auto-generate from your database.
 version: "1.0"
-entities: []
+name: Atlas Demo — SaaS CRM
+description: |
+  B2B SaaS company CRM dataset. Tracks companies (customers), the people who work
+  there (contacts), and subscription accounts with plan tiers and MRR.
+  Use this dataset to explore revenue analysis, customer segmentation,
+  churn patterns, and org-level reporting.
+
+entities:
+  - name: Companies
+    file: entities/companies.yml
+    grain: one row per customer company
+    description: >
+      Customer companies with firmographic data — industry, headcount,
+      geography, revenue, and valuation.
+    use_for:
+      - Firmographic segmentation (industry, country, company size)
+      - Revenue and valuation analysis
+      - Customer base composition
+    common_questions:
+      - What industries make up our customer base?
+      - Which countries have the most customers?
+      - What is the average company revenue by industry?
+      - How many enterprise-size companies (500+ employees) do we have?
+
+  - name: People
+    file: entities/people.yml
+    grain: one row per contact
+    description: >
+      Contacts at customer companies — department, seniority, title,
+      and start date. Linked to companies via company_id.
+    use_for:
+      - Stakeholder mapping by department and seniority
+      - Org chart analysis per company
+      - Tenure and hiring trend analysis
+    common_questions:
+      - How many contacts do we have per company?
+      - What is the department breakdown across all contacts?
+      - Which companies have the most executive-level contacts?
+      - What seniority levels are most common?
+
+  - name: Accounts
+    file: entities/accounts.yml
+    grain: one row per subscription account
+    description: >
+      Subscription accounts with plan tier, billing status, MRR
+      (monthly_value), and contract dates. Linked to companies via company_id.
+    use_for:
+      - MRR and revenue analysis by plan
+      - Churn and retention analysis
+      - Contract lifecycle tracking
+      - Cross-entity analysis joining to companies and people
+    common_questions:
+      - What is total MRR by plan type?
+      - How many accounts are churned vs active?
+      - What is the average contract length?
+      - Which companies have the highest MRR?
+
 glossary: glossary.yml
+metrics:
+  - file: metrics/accounts.yml
+    description: Subscription and revenue metrics (MRR, churn rate, ARPA)
+  - file: metrics/companies.yml
+    description: Customer base metrics (count, avg revenue, industry breakdown)

package/templates/docker/semantic/entities/accounts.yml

@@ -0,0 +1,162 @@
+name: Accounts
+type: fact_table
+table: accounts
+grain: one row per subscription account
+description: |
+  Subscription accounts representing our billing relationship with each customer.
+  Each account belongs to one company and has a plan tier (Free, Starter, Pro,
+  Enterprise), a billing status (Active, Inactive, Suspended, Churned), and a
+  monthly_value representing MRR contribution. Contract dates track the lifecycle.
+  A company can have multiple accounts (e.g. separate subscriptions for different teams).
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique account identifier
+    primary_key: true
+
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies — which customer owns this account
+
+  - name: plan
+    sql: plan
+    type: string
+    description: |
+      Subscription tier. Determines pricing and feature access.
+      Free = $0, Starter = ~$49-89, Pro = ~$299-500, Enterprise = ~$5K-15K.
+    sample_values: [Enterprise, Pro, Starter, Free]
+
+  - name: status
+    sql: status
+    type: string
+    description: |
+      Current billing status. Active = paying, Inactive = paused,
+      Suspended = payment issue, Churned = cancelled.
+    sample_values: [Active, Churned, Inactive, Suspended]
+
+  - name: monthly_value
+    sql: monthly_value
+    type: number
+    description: |
+      Monthly Recurring Revenue (MRR) from this account in dollars.
+      Free accounts have $0. This is the core revenue metric.
+
+  - name: contract_start
+    sql: contract_start
+    type: date
+    description: Date the subscription began
+
+  - name: contract_end
+    sql: contract_end
+    type: date
+    description: |
+      Date the subscription ended. NULL means the account is still under contract.
+      Set when an account churns or is terminated.
+
+  - name: monthly_value_bucket
+    sql: |-
+      CASE
+        WHEN monthly_value = 0 THEN 'Free'
+        WHEN monthly_value < 100 THEN 'Low'
+        WHEN monthly_value < 1000 THEN 'Mid'
+        ELSE 'High'
+      END
+    type: string
+    description: MRR tier bucket — Free / Low / Mid / High
+    virtual: true
+    sample_values: [Free, Low, Mid, High]
+
+  - name: contract_start_year
+    sql: EXTRACT(YEAR FROM contract_start)
+    type: number
+    description: Year the contract started — useful for cohort analysis
+    virtual: true
+
+  - name: contract_start_month
+    sql: TO_CHAR(contract_start, 'YYYY-MM')
+    type: string
+    description: Year-month the contract started
+    virtual: true
+
+  - name: is_churned
+    sql: CASE WHEN status = 'Churned' THEN true ELSE false END
+    type: boolean
+    description: Whether this account has churned
+    virtual: true
+
+measures:
+  - name: account_count
+    sql: id
+    type: count_distinct
+    description: Number of unique accounts
+
+  - name: total_mrr
+    sql: monthly_value
+    type: sum
+    description: Total Monthly Recurring Revenue
+
+  - name: avg_mrr
+    sql: monthly_value
+    type: avg
+    description: Average MRR per account
+
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each account belongs to one company (customer)
+
+use_cases:
+  - MRR analysis — total, by plan, by status, over time
+  - Churn analysis — churned vs active accounts, churn rate by plan
+  - Revenue segmentation — which plans drive the most revenue
+  - Contract lifecycle — average duration, upcoming renewals
+  - Cross-entity joins to companies for firmographic revenue analysis
+
+query_patterns:
+  - name: mrr_by_plan
+    description: Total MRR and account count by plan tier
+    sql: |-
+      SELECT plan,
+             SUM(monthly_value) AS total_mrr,
+             COUNT(*) AS account_count,
+             AVG(monthly_value) AS avg_mrr
+      FROM accounts
+      WHERE status = 'Active'
+      GROUP BY plan
+      ORDER BY total_mrr DESC
+
+  - name: churn_rate_by_plan
+    description: Churn rate by plan type
+    sql: |-
+      SELECT plan,
+             COUNT(*) FILTER (WHERE status = 'Churned') AS churned,
+             COUNT(*) AS total,
+             ROUND(100.0 * COUNT(*) FILTER (WHERE status = 'Churned') / COUNT(*), 1) AS churn_pct
+      FROM accounts
+      GROUP BY plan
+      ORDER BY churn_pct DESC
+
+  - name: accounts_by_status
+    description: Account distribution by billing status
+    sql: |-
+      SELECT status, COUNT(*) AS count
+      FROM accounts
+      GROUP BY status
+      ORDER BY count DESC
+
+  - name: mrr_by_contract_year
+    description: MRR cohort analysis by contract start year
+    sql: |-
+      SELECT EXTRACT(YEAR FROM contract_start) AS cohort_year,
+             SUM(monthly_value) AS total_mrr,
+             COUNT(*) AS accounts
+      FROM accounts
+      WHERE status = 'Active'
+      GROUP BY cohort_year
+      ORDER BY cohort_year

package/templates/docker/semantic/entities/companies.yml

@@ -0,0 +1,143 @@
+name: Companies
+type: dimension_table
+table: companies
+grain: one row per customer company
+description: |
+  Customer companies (our B2B clients). Contains firmographic data including
+  industry vertical, headcount, founding year, HQ country, annual revenue,
+  and valuation. Each company can have multiple accounts (subscriptions)
+  and multiple people (contacts). This is the central dimension table for
+  customer-level analysis.
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique company identifier
+    primary_key: true
+
+  - name: name
+    sql: name
+    type: string
+    description: Company name
+    sample_values: [Acme Corp, DataFlow Inc, CloudSync, RetailHub]
+
+  - name: industry
+    sql: industry
+    type: string
+    description: Business sector / vertical
+    sample_values: [Education, Energy, Finance, Healthcare, Manufacturing, Media, Retail, Technology]
+
+  - name: employee_count
+    sql: employee_count
+    type: number
+    description: Total headcount at the company
+
+  - name: founded_year
+    sql: founded_year
+    type: number
+    description: Year the company was founded
+
+  - name: country
+    sql: country
+    type: string
+    description: ISO 2-letter code for company HQ location
+    sample_values: [AU, BR, CA, DE, FR, IN, JP, SG, UK, US]
+
+  - name: revenue
+    sql: revenue
+    type: number
+    description: Annual revenue in dollars (the company's own revenue, not what they pay us)
+
+  - name: valuation
+    sql: valuation
+    type: number
+    description: Company valuation in dollars
+
+  - name: company_size
+    sql: |-
+      CASE
+        WHEN employee_count < 100 THEN 'Small'
+        WHEN employee_count < 300 THEN 'Mid-Market'
+        ELSE 'Enterprise'
+      END
+    type: string
+    description: Company size segment based on headcount
+    virtual: true
+    sample_values: [Small, Mid-Market, Enterprise]
+
+  - name: revenue_tier
+    sql: |-
+      CASE
+        WHEN revenue < 10000000 THEN 'Under $10M'
+        WHEN revenue < 50000000 THEN '$10M-$50M'
+        WHEN revenue < 100000000 THEN '$50M-$100M'
+        ELSE '$100M+'
+      END
+    type: string
+    description: Revenue tier for segmentation
+    virtual: true
+    sample_values: [Under $10M, $10M-$50M, $50M-$100M, $100M+]
+
+measures:
+  - name: company_count
+    sql: id
+    type: count_distinct
+    description: Number of unique companies
+
+  - name: avg_employee_count
+    sql: employee_count
+    type: avg
+    description: Average headcount per company
+
+  - name: total_revenue
+    sql: revenue
+    type: sum
+    description: Combined annual revenue of all companies
+
+  - name: avg_revenue
+    sql: revenue
+    type: avg
+    description: Average annual revenue per company
+
+  - name: avg_valuation
+    sql: valuation
+    type: avg
+    description: Average company valuation
+
+use_cases:
+  - Customer segmentation by industry, country, company size
+  - Revenue and valuation analysis across the customer base
+  - Firmographic profiling for ICP (ideal customer profile) analysis
+  - Join to accounts for revenue-per-company analysis
+  - Join to people for stakeholder density per company
+
+query_patterns:
+  - name: companies_by_industry
+    description: Customer count and avg revenue by industry
+    sql: |-
+      SELECT industry,
+             COUNT(*) AS company_count,
+             AVG(revenue) AS avg_revenue,
+             AVG(employee_count) AS avg_headcount
+      FROM companies
+      GROUP BY industry
+      ORDER BY company_count DESC
+
+  - name: companies_by_country
+    description: Customer distribution by country
+    sql: |-
+      SELECT country,
+             COUNT(*) AS company_count,
+             SUM(revenue) AS total_revenue
+      FROM companies
+      GROUP BY country
+      ORDER BY company_count DESC
+
+  - name: top_companies_by_revenue
+    description: Largest customers by annual revenue
+    sql: |-
+      SELECT name, industry, country, revenue, employee_count
+      FROM companies
+      ORDER BY revenue DESC
+      LIMIT 10

package/templates/docker/semantic/entities/people.yml

@@ -0,0 +1,132 @@
+name: People
+type: dimension_table
+table: people
+grain: one row per contact
+description: |
+  Contacts at customer companies. Each person has a department, seniority level,
+  job title, and start date. Linked to companies via company_id. Use for
+  stakeholder mapping, org analysis, and understanding who we're selling to
+  and supporting at each company.
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique contact identifier
+    primary_key: true
+
+  - name: name
+    sql: name
+    type: string
+    description: Full name of the contact
+
+  - name: email
+    sql: email
+    type: string
+    description: Work email address
+
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies — which company this person works at
+
+  - name: department
+    sql: department
+    type: string
+    description: Functional department within the company
+    sample_values: [Engineering, Finance, Marketing, Operations, Product, Sales]
+
+  - name: seniority
+    sql: seniority
+    type: string
+    description: Career level — indicates decision-making authority
+    sample_values: [Executive, Senior, Mid, Junior]
+
+  - name: title
+    sql: title
+    type: string
+    description: Job title (e.g. CFO, Backend Engineer, Account Executive)
+
+  - name: start_date
+    sql: start_date
+    type: date
+    description: Date the person started at their company
+
+  - name: start_date_year
+    sql: EXTRACT(YEAR FROM start_date)
+    type: number
+    description: Year the person started — useful for tenure analysis
+    virtual: true
+
+  - name: tenure_years
+    sql: EXTRACT(YEAR FROM AGE(CURRENT_DATE, start_date))
+    type: number
+    description: Approximate years of tenure at the company
+    virtual: true
+
+measures:
+  - name: contact_count
+    sql: id
+    type: count_distinct
+    description: Number of unique contacts
+
+  - name: avg_tenure
+    sql: EXTRACT(YEAR FROM AGE(CURRENT_DATE, start_date))
+    type: avg
+    description: Average tenure in years
+
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each contact belongs to one company
+
+use_cases:
+  - Stakeholder mapping — who are the key contacts at each company
+  - Department breakdown — what functions are represented
+  - Seniority analysis — how many executives vs individual contributors
+  - Hiring trends — when were contacts added, by year
+  - Join to companies + accounts for full customer intelligence
+
+query_patterns:
+  - name: contacts_by_department
+    description: Contact count by department
+    sql: |-
+      SELECT department,
+             COUNT(*) AS contact_count
+      FROM people
+      GROUP BY department
+      ORDER BY contact_count DESC
+
+  - name: contacts_by_seniority
+    description: Contact distribution by seniority level
+    sql: |-
+      SELECT seniority,
+             COUNT(*) AS contact_count
+      FROM people
+      GROUP BY seniority
+      ORDER BY contact_count DESC
+
+  - name: executives_by_company
+    description: Executive contacts per company
+    sql: |-
+      SELECT c.name AS company,
+             COUNT(*) AS executive_count
+      FROM people p
+      JOIN companies c ON p.company_id = c.id
+      WHERE p.seniority = 'Executive'
+      GROUP BY c.name
+      ORDER BY executive_count DESC
+
+  - name: contacts_per_company
+    description: Contact density per company
+    sql: |-
+      SELECT c.name AS company,
+             COUNT(*) AS contact_count,
+             c.employee_count AS total_employees
+      FROM people p
+      JOIN companies c ON p.company_id = c.id
+      GROUP BY c.name, c.employee_count
+      ORDER BY contact_count DESC

package/templates/docker/semantic/glossary.yml

@@ -1,6 +1,118 @@
-# Atlas Glossary — Business term definitions
-# Run `bun run atlas -- init` to auto-generate terms from your database.
 terms:
-  example_term:
+  MRR:
     status: defined
-    definition: Replace this with your own business terms
+    definition: >
+      Monthly Recurring Revenue. The sum of monthly_value across all active accounts.
+      Use accounts.monthly_value and filter by status = 'Active' for current MRR.
+    tables:
+      - accounts
+
+  ARR:
+    status: defined
+    definition: >
+      Annual Recurring Revenue. MRR * 12. Not stored directly — calculate from
+      accounts.monthly_value.
+    tables:
+      - accounts
+
+  ARPA:
+    status: defined
+    definition: >
+      Average Revenue Per Account. Total MRR divided by active account count.
+      Use AVG(monthly_value) on active accounts.
+    tables:
+      - accounts
+
+  churn:
+    status: defined
+    definition: >
+      An account with status = 'Churned'. Churned accounts have monthly_value = 0
+      and typically have a contract_end date set.
+    tables:
+      - accounts
+
+  plan:
+    status: defined
+    definition: >
+      Subscription tier. Four levels: Free ($0), Starter (~$49-89/mo),
+      Pro (~$299-500/mo), Enterprise (~$5,000-15,000/mo).
+    tables:
+      - accounts
+
+  status:
+    status: ambiguous
+    note: >
+      "status" appears on accounts only, but could be confused with general
+      state. Always refers to subscription status: Active, Inactive,
+      Suspended, or Churned.
+    possible_mappings:
+      - accounts.status
+
+  name:
+    status: ambiguous
+    note: >
+      "name" appears in both companies and people. ASK the user which
+      entity they mean — company name or person name.
+    possible_mappings:
+      - companies.name
+      - people.name
+
+  company:
+    status: defined
+    definition: >
+      Refers to the companies entity (our customers). Linked from accounts
+      and people via company_id -> companies.id.
+    tables:
+      - companies
+      - accounts
+      - people
+
+  industry:
+    status: defined
+    definition: >
+      Business sector of a customer company. Values: Education, Energy,
+      Finance, Healthcare, Manufacturing, Media, Retail, Technology.
+    tables:
+      - companies
+
+  country:
+    status: defined
+    definition: >
+      ISO 2-letter country code for company HQ location. Values: AU, BR,
+      CA, DE, FR, IN, JP, SG, UK, US.
+    tables:
+      - companies
+
+  department:
+    status: defined
+    definition: >
+      Functional department of a contact. Values: Engineering, Finance,
+      Marketing, Operations, Product, Sales.
+    tables:
+      - people
+
+  seniority:
+    status: defined
+    definition: >
+      Career level of a contact. Values: Executive, Senior, Mid, Junior.
+    tables:
+      - people
+
+  revenue:
+    status: ambiguous
+    note: >
+      Could mean company revenue (companies.revenue — annual total revenue
+      of the customer) or account revenue (accounts.monthly_value — our MRR
+      from that account). Clarify which is meant.
+    possible_mappings:
+      - companies.revenue
+      - accounts.monthly_value
+
+  contract:
+    status: defined
+    definition: >
+      Subscription agreement period. contract_start is when billing began;
+      contract_end is set when an account churns or is terminated.
+      NULL contract_end means the account is still under contract.
+    tables:
+      - accounts