@useatlas/create 0.0.1 → 0.0.3

package/templates/nextjs-standalone/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

package/templates/nextjs-standalone/semantic/metrics/accounts.yml

@@ -0,0 +1,77 @@
+metrics:
+  - id: total_mrr
+    label: Total MRR
+    description: Total Monthly Recurring Revenue across all active accounts.
+    type: atomic
+    unit: USD
+    source:
+      entity: Accounts
+      measure: total_mrr
+    sql: |-
+      SELECT SUM(monthly_value) AS total_mrr
+      FROM accounts
+      WHERE status = 'Active'
+    aggregation: sum
+    objective: maximize
+
+  - id: active_accounts
+    label: Active Accounts
+    description: Number of accounts with status = 'Active'.
+    type: atomic
+    sql: |-
+      SELECT COUNT(*) AS active_accounts
+      FROM accounts
+      WHERE status = 'Active'
+    aggregation: count
+
+  - id: arpa
+    label: ARPA (Avg Revenue Per Account)
+    description: Average MRR per active account.
+    type: derived
+    unit: USD
+    sql: |-
+      SELECT AVG(monthly_value) AS arpa
+      FROM accounts
+      WHERE status = 'Active'
+    aggregation: avg
+
+  - id: churn_rate
+    label: Churn Rate
+    description: Percentage of all accounts that have churned.
+    type: derived
+    unit: percent
+    sql: |-
+      SELECT ROUND(100.0 * COUNT(*) FILTER (WHERE status = 'Churned') / COUNT(*), 1) AS churn_rate
+      FROM accounts
+    aggregation: ratio
+    objective: minimize
+
+  - id: mrr_by_plan
+    label: MRR by Plan
+    description: MRR breakdown by subscription plan tier.
+    type: breakdown
+    unit: USD
+    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
+
+  - id: churn_by_plan
+    label: Churn Rate by Plan
+    description: Churn rate broken down by plan tier.
+    type: breakdown
+    unit: percent
+    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
+    objective: minimize

package/templates/nextjs-standalone/semantic/metrics/companies.yml

@@ -0,0 +1,63 @@
+metrics:
+  - id: total_customers
+    label: Total Customers
+    description: Number of unique customer companies.
+    type: atomic
+    sql: |-
+      SELECT COUNT(DISTINCT id) AS total_customers
+      FROM companies
+    aggregation: count_distinct
+
+  - id: avg_customer_revenue
+    label: Avg Customer Revenue
+    description: Average annual revenue across customer companies.
+    type: atomic
+    unit: USD
+    source:
+      entity: Companies
+      measure: avg_revenue
+    sql: |-
+      SELECT AVG(revenue) AS avg_customer_revenue
+      FROM companies
+    aggregation: avg
+
+  - id: customers_by_industry
+    label: Customers by Industry
+    description: Customer count and average revenue by industry vertical.
+    type: breakdown
+    sql: |-
+      SELECT industry,
+             COUNT(*) AS customer_count,
+             AVG(revenue) AS avg_revenue,
+             AVG(employee_count) AS avg_headcount
+      FROM companies
+      GROUP BY industry
+      ORDER BY customer_count DESC
+
+  - id: customers_by_country
+    label: Customers by Country
+    description: Customer distribution by HQ country.
+    type: breakdown
+    sql: |-
+      SELECT country,
+             COUNT(*) AS customer_count,
+             SUM(revenue) AS total_revenue
+      FROM companies
+      GROUP BY country
+      ORDER BY customer_count DESC
+
+  - id: revenue_per_customer
+    label: Revenue per Customer (our MRR)
+    description: Total MRR we earn from each customer company.
+    type: derived
+    unit: USD
+    sql: |-
+      SELECT c.name AS company,
+             c.industry,
+             SUM(a.monthly_value) AS total_mrr,
+             COUNT(a.id) AS account_count
+      FROM companies c
+      JOIN accounts a ON a.company_id = c.id
+      WHERE a.status = 'Active'
+      GROUP BY c.name, c.industry
+      ORDER BY total_mrr DESC

package/templates/nextjs-standalone/src/api/__tests__/admin.test.ts

@@ -153,6 +153,8 @@ mock.module("@atlas/api/lib/db/connection", () => ({
     getDBType: () => "postgres" as const,
     getTargetHost: () => "localhost",
     getValidator: () => undefined,
+    getParserDialect: () => undefined,
+    getForbiddenPatterns: () => [],
     list: () => ["default"],
     describe: () => [
       { id: "default", dbType: "postgres", description: "Test DB" },
@@ -161,8 +163,6 @@ mock.module("@atlas/api/lib/db/connection", () => ({
   },
   detectDBType: () => "postgres" as const,
   extractTargetHost: () => "localhost",
-  rewriteClickHouseUrl: (url: string) => url,
-  parseSnowflakeURL: () => ({}),
   ConnectionRegistry: class {},
 }));
 
@@ -197,13 +197,13 @@ const mockPluginHealthCheck: Mock<() => Promise<unknown>> = mock(() =>
 mock.module("@atlas/api/lib/plugins/registry", () => ({
   plugins: {
     describe: () => [
-      { id: "test-plugin", type: "context", version: "1.0.0", name: "Test Plugin", status: "healthy" },
+      { id: "test-plugin", types: ["context"], version: "1.0.0", name: "Test Plugin", status: "healthy" },
     ],
     get: (id: string) => {
       if (id === "test-plugin") {
         return {
           id: "test-plugin",
-          type: "context",
+          types: ["context"],
           version: "1.0.0",
           name: "Test Plugin",
           healthCheck: mockPluginHealthCheck,
@@ -212,7 +212,7 @@ mock.module("@atlas/api/lib/plugins/registry", () => ({
       if (id === "no-health-plugin") {
         return {
           id: "no-health-plugin",
-          type: "action",
+          types: ["action"],
           version: "0.1.0",
           name: "No Health Plugin",
         };
@@ -355,7 +355,7 @@ describe("Admin routes — auth enforcement", () => {
     expect(res.status).toBe(401);
   });
 
-  it("returns 403 when auth mode is none (no user object)", async () => {
+  it("allows access when auth mode is none (implicit admin in dev)", async () => {
     mockAuthenticateRequest.mockResolvedValue({
       authenticated: true,
       mode: "none",
@@ -363,7 +363,7 @@ describe("Admin routes — auth enforcement", () => {
     });
 
     const res = await app.fetch(adminRequest("/api/v1/admin/overview"));
-    expect(res.status).toBe(403);
+    expect(res.status).toBe(200);
   });
 
   it("returns 500 when authenticateRequest throws", async () => {

package/templates/nextjs-standalone/src/api/__tests__/health-plugin.test.ts

@@ -45,13 +45,20 @@ mock.module("@atlas/api/lib/db/connection", () => ({
     getDBType: () => "postgres" as const,
     getTargetHost: () => "localhost",
     getValidator: () => undefined,
+    getParserDialect: () => undefined,
+    getForbiddenPatterns: () => [],
     list: () => [],
     describe: () => [],
   },
   detectDBType: () => "postgres" as const,
+  resolveDatasourceUrl: () => process.env.ATLAS_DATASOURCE_URL || null,
   ConnectionRegistry: class {},
 }));
 
+mock.module("@atlas/api/lib/providers", () => ({
+  getDefaultProvider: () => "anthropic",
+}));
+
 mock.module("@atlas/api/lib/semantic", () => ({
   getWhitelistedTables: () => new Set(["companies"]),
   _resetWhitelists: () => {},

package/templates/nextjs-standalone/src/api/__tests__/health.test.ts

@@ -45,13 +45,20 @@ mock.module("@atlas/api/lib/db/connection", () => ({
     getDBType: () => "postgres" as const,
     getTargetHost: () => "localhost",
     getValidator: () => undefined,
+    getParserDialect: () => undefined,
+    getForbiddenPatterns: () => [],
     list: () => connMetadata.map((m) => m.id),
     describe: () => connMetadata,
   },
   detectDBType: () => "postgres" as const,
+  resolveDatasourceUrl: () => process.env.ATLAS_DATASOURCE_URL || null,
   ConnectionRegistry: class {},
 }));
 
+mock.module("@atlas/api/lib/providers", () => ({
+  getDefaultProvider: () => "anthropic",
+}));
+
 mock.module("@atlas/api/lib/semantic", () => ({
   getWhitelistedTables: () => new Set(["companies"]),
   _resetWhitelists: () => {},
@@ -180,12 +187,13 @@ describe("GET /api/health — sources section", () => {
     expect(sources.default).toBeDefined();
     const defaultSource = sources.default as Record<string, unknown>;
     expect(defaultSource.status).toBe("healthy");
-    expect(defaultSource.latencyMs).toBe(5);
+    // Live probe latency overrides the registry's cached value for default connection
+    expect(typeof defaultSource.latencyMs).toBe("number");
     expect(defaultSource.dbType).toBe("postgres");
     expect(defaultSource.checkedAt).toBe("2026-01-15T12:00:00.000Z");
   });
 
-  it("promotes top-level status to 'error' when a source is unhealthy", async () => {
+  it("promotes top-level status to 'error' when a non-default source is unhealthy", async () => {
     const unhealthy: HealthCheckResult = {
       status: "unhealthy",
       latencyMs: 5000,
@@ -193,7 +201,7 @@ describe("GET /api/health — sources section", () => {
       checkedAt: new Date(),
     };
     connMetadata = [
-      { id: "default", dbType: "postgres", health: unhealthy },
+      { id: "warehouse", dbType: "postgres", health: unhealthy },
     ];
 
     const response = await app.fetch(healthRequest());
@@ -202,10 +210,10 @@ describe("GET /api/health — sources section", () => {
     const body = (await response.json()) as Record<string, unknown>;
     expect(body.status).toBe("error");
     const sources = body.sources as Record<string, unknown>;
-    expect((sources.default as Record<string, unknown>).status).toBe("unhealthy");
+    expect((sources.warehouse as Record<string, unknown>).status).toBe("unhealthy");
   });
 
-  it("promotes top-level status to 'degraded' when a source is degraded and no other errors", async () => {
+  it("promotes top-level status to 'degraded' when a non-default source is degraded and no other errors", async () => {
     const degraded: HealthCheckResult = {
       status: "degraded",
       latencyMs: 2000,
@@ -213,7 +221,7 @@ describe("GET /api/health — sources section", () => {
       checkedAt: new Date(),
     };
     connMetadata = [
-      { id: "default", dbType: "postgres", health: degraded },
+      { id: "warehouse", dbType: "postgres", health: degraded },
     ];
 
     const response = await app.fetch(healthRequest());
@@ -246,7 +254,21 @@ describe("GET /api/health — sources section", () => {
     expect((sources.warehouse as Record<string, unknown>).dbType).toBe("mysql");
   });
 
-  it("returns status 'unknown' when source has no health check result", async () => {
+  it("returns status 'unknown' when non-default source has no health check result", async () => {
+    connMetadata = [
+      { id: "warehouse", dbType: "mysql" },
+    ];
+
+    const response = await app.fetch(healthRequest());
+    const body = (await response.json()) as Record<string, unknown>;
+    const sources = body.sources as Record<string, unknown>;
+    const warehouseSource = sources.warehouse as Record<string, unknown>;
+
+    expect(warehouseSource.status).toBe("unknown");
+  });
+
+  it("uses live probe results for default source status", async () => {
+    // Even if registry reports no health, the live probe succeeds → healthy
     connMetadata = [
       { id: "default", dbType: "postgres" },
     ];
@@ -256,6 +278,6 @@ describe("GET /api/health — sources section", () => {
     const sources = body.sources as Record<string, unknown>;
     const defaultSource = sources.default as Record<string, unknown>;
 
-    expect(defaultSource.status).toBe("unknown");
+    expect(defaultSource.status).toBe("healthy");
   });
 });