@useatlas/create 0.0.2 → 0.0.4

package/templates/docker/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/docker/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/docker/sidecar/Dockerfile

@@ -5,16 +5,15 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     bash coreutils grep findutils tree \
     && rm -rf /var/lib/apt/lists/*
 
-RUN useradd -r -s /bin/false -u 65534 -g 65534 sandbox
+RUN useradd -r -s /bin/false sandbox || true
 
 WORKDIR /app
 
-# Copy sidecar source (context is project root)
-COPY sidecar/server.ts ./server.ts
+# Copy sidecar source (root directory = sidecar/)
+COPY server.ts ./server.ts
 
-# Semantic layer from project root
-COPY semantic/ /semantic/
-RUN chmod -R a-w /semantic/
+# Create semantic directory — populated at runtime or via volume mount
+RUN mkdir -p /semantic && chmod a+r /semantic
 
 # Keep this image minimal — adding packages or env vars weakens the isolation model
 

package/templates/docker/sidecar/railway.json

@@ -2,8 +2,7 @@
   "$schema": "https://railway.com/railway.schema.json",
   "build": {
     "builder": "DOCKERFILE",
-    "dockerfilePath": "sidecar/Dockerfile",
-    "dockerfileContext": "."
+    "dockerfilePath": "Dockerfile"
   },
   "deploy": {
     "restartPolicyType": "ON_FAILURE",

package/templates/docker/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/docker/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/docker/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");
   });
 });