@littlebearapps/platform-admin-sdk 1.4.2 → 1.5.0

package/templates/shared/dashboard/src/pages/api/overview/summary.ts

@@ -0,0 +1,311 @@
+import type { APIRoute } from 'astro';
+
+interface Env {
+  PLATFORM_DB?: D1Database;
+  PLATFORM_CACHE?: KVNamespace;
+  USAGE_API?: Fetcher;
+}
+
+export const GET: APIRoute = async ({ locals }) => {
+  const env = locals.runtime?.env as Env | undefined;
+  const db = env?.PLATFORM_DB;
+  const kv = env?.PLATFORM_CACHE;
+
+  const summary = {
+    health: {
+      servicesTotal: 0,
+      servicesUp: 0,
+      servicesDown: 0,
+      uptimePct: 100,
+      lastAuditScore: null as number | null,
+      lastAuditDate: null as string | null,
+    },
+    errors: {
+      p0Count: 0,
+      p1Count: 0,
+      p2Count: 0,
+      p3Count: 0,
+      p4Count: 0,
+      newToday: 0,
+      dailyTrend: [] as number[],
+      topErrors: [] as Array<{
+        fingerprint: string;
+        message: string;
+        script_name: string;
+        priority: string;
+        occurrence_count: number;
+      }>,
+    },
+    costs: {
+      mtdSpend: 0,
+      dailyBurnRate: 0,
+      projectedMonthly: 0,
+      budgetPct: 0,
+      monthlyBudget: 100,
+      dailyTrend: [] as number[],
+    },
+    activity: {
+      notifications: [] as Array<{
+        id: string;
+        title: string;
+        category: string;
+        priority: string;
+        source: string;
+        created_at: number;
+        action_url: string | null;
+      }>,
+      pendingPatterns: 0,
+    },
+    alerts: {
+      hasP0P1: false,
+      trippedBreakers: 0,
+      warningBreakers: 0,
+      servicesDown: 0,
+    },
+    dataQuality: {
+      latestSnapshot: null as string | null,
+      snapshotAgeMinutes: -1,
+      status: 'unknown' as 'fresh' | 'stale' | 'unknown',
+    },
+  };
+
+  const promises: Promise<void>[] = [];
+
+  // 1. Service health from D1 project_registry
+  promises.push(
+    (async () => {
+      if (!db) return;
+      try {
+        const services = await db
+          .prepare(
+            `SELECT status FROM resource_project_mapping
+             WHERE resource_type = 'worker'
+             LIMIT 100`
+          )
+          .all<{ status: string }>();
+        if (services.results) {
+          summary.health.servicesTotal = services.results.length;
+          summary.health.servicesUp = services.results.filter((s) => s.status !== 'inactive').length;
+          summary.health.servicesDown = services.results.filter((s) => s.status === 'inactive').length;
+          summary.alerts.servicesDown = summary.health.servicesDown;
+        }
+      } catch {
+        // Table may not exist
+      }
+    })()
+  );
+
+  // 2. Error counts from D1
+  promises.push(
+    (async () => {
+      if (!db) return;
+      try {
+        const stats = await db
+          .prepare(
+            `SELECT priority, COUNT(*) as cnt
+             FROM error_occurrences
+             WHERE status = 'open'
+             GROUP BY priority
+             LIMIT 10`
+          )
+          .all<{ priority: string; cnt: number }>();
+        if (stats.results) {
+          for (const row of stats.results) {
+            if (row.priority === 'P0') summary.errors.p0Count = row.cnt;
+            else if (row.priority === 'P1') summary.errors.p1Count = row.cnt;
+            else if (row.priority === 'P2') summary.errors.p2Count = row.cnt;
+            else if (row.priority === 'P3') summary.errors.p3Count = row.cnt;
+            else if (row.priority === 'P4') summary.errors.p4Count = row.cnt;
+          }
+        }
+        summary.alerts.hasP0P1 = summary.errors.p0Count > 0 || summary.errors.p1Count > 0;
+      } catch {
+        // Table may not exist
+      }
+
+      // Top 3 errors
+      try {
+        const topErrors = await db
+          .prepare(
+            `SELECT fingerprint, normalized_message as message, script_name, priority, occurrence_count
+             FROM error_occurrences
+             WHERE status = 'open'
+             ORDER BY
+               CASE priority WHEN 'P0' THEN 1 WHEN 'P1' THEN 2 WHEN 'P2' THEN 3 WHEN 'P3' THEN 4 ELSE 5 END,
+               occurrence_count DESC
+             LIMIT 3`
+          )
+          .all();
+        summary.errors.topErrors = (topErrors.results ?? []) as typeof summary.errors.topErrors;
+      } catch {
+        // Table may not exist
+      }
+
+      // 7-day error trend
+      try {
+        const trend = await db
+          .prepare(
+            `SELECT DATE(first_seen_at) as day, COUNT(*) as count
+             FROM error_occurrences
+             WHERE first_seen_at >= DATE('now', '-7 days')
+             GROUP BY DATE(first_seen_at)
+             ORDER BY day ASC
+             LIMIT 7`
+          )
+          .all<{ day: string; count: number }>();
+        if (trend.results) {
+          const today = new Date();
+          const dailyCounts: number[] = [];
+          for (let i = 6; i >= 0; i--) {
+            const d = new Date(today);
+            d.setDate(d.getDate() - i);
+            const key = d.toISOString().slice(0, 10);
+            const match = trend.results.find((r) => r.day === key);
+            dailyCounts.push(match?.count ?? 0);
+          }
+          summary.errors.dailyTrend = dailyCounts;
+        }
+      } catch {
+        // Table may not exist
+      }
+    })()
+  );
+
+  // 3. Cost data from D1
+  promises.push(
+    (async () => {
+      if (!db) return;
+      try {
+        const now = new Date();
+        const billingStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString().slice(0, 10);
+
+        const costResult = await db
+          .prepare(
+            `SELECT SUM(total_cost_usd) as mtd_cost, COUNT(*) as days_tracked
+             FROM daily_usage_rollups
+             WHERE project = 'all' AND snapshot_date >= ?
+             LIMIT 1`
+          )
+          .bind(billingStart)
+          .first<{ mtd_cost: number; days_tracked: number }>();
+
+        if (costResult?.mtd_cost) {
+          summary.costs.mtdSpend = Math.round(costResult.mtd_cost * 100) / 100;
+        }
+
+        const daysInMonth = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
+        const daysSoFar = now.getDate();
+        summary.costs.dailyBurnRate = daysSoFar > 0 ? Math.round((summary.costs.mtdSpend / daysSoFar) * 100) / 100 : 0;
+        summary.costs.projectedMonthly = Math.round(summary.costs.dailyBurnRate * daysInMonth * 100) / 100;
+        summary.costs.budgetPct = summary.costs.monthlyBudget > 0
+          ? Math.round((summary.costs.projectedMonthly / summary.costs.monthlyBudget) * 100)
+          : 0;
+
+        // 7-day cost trend
+        const sevenDaysAgo = new Date();
+        sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
+        const trendStart = sevenDaysAgo.toISOString().slice(0, 10);
+        const costTrend = await db
+          .prepare(
+            `SELECT snapshot_date as day, total_cost_usd as daily_cost
+             FROM daily_usage_rollups
+             WHERE project = 'all' AND snapshot_date >= ?
+             ORDER BY snapshot_date ASC
+             LIMIT 7`
+          )
+          .bind(trendStart)
+          .all<{ day: string; daily_cost: number }>();
+        if (costTrend.results) {
+          const today = new Date();
+          const dailyCosts: number[] = [];
+          for (let i = 6; i >= 0; i--) {
+            const d = new Date(today);
+            d.setDate(d.getDate() - i);
+            const key = d.toISOString().slice(0, 10);
+            const match = costTrend.results.find((r) => r.day === key);
+            dailyCosts.push(Math.round((match?.daily_cost ?? 0) * 100) / 100);
+          }
+          summary.costs.dailyTrend = dailyCosts;
+        }
+      } catch {
+        // Table may not exist
+      }
+    })()
+  );
+
+  // 4. Activity data
+  promises.push(
+    (async () => {
+      if (!db) return;
+      try {
+        const notifications = await db
+          .prepare(
+            `SELECT id, title, category, priority, source, created_at, action_url
+             FROM notifications
+             WHERE created_at >= unixepoch() - (7 * 24 * 60 * 60)
+             ORDER BY created_at DESC
+             LIMIT 5`
+          )
+          .all();
+        summary.activity.notifications = (notifications.results ?? []) as typeof summary.activity.notifications;
+      } catch {
+        // Table may not exist
+      }
+    })()
+  );
+
+  // 5. Circuit breaker status from KV
+  promises.push(
+    (async () => {
+      if (!kv) return;
+      try {
+        const cbKeys = await kv.list({ prefix: 'cb:' });
+        let tripped = 0;
+        let warning = 0;
+        for (const key of cbKeys.keys) {
+          const state = (await kv.get(key.name, 'json')) as { status?: string } | null;
+          if (state?.status === 'stopped' || state?.status === 'paused') tripped++;
+          else if (state?.status === 'warning') warning++;
+        }
+        summary.alerts.trippedBreakers = tripped;
+        summary.alerts.warningBreakers = warning;
+      } catch {
+        // KV may not be available
+      }
+    })()
+  );
+
+  // 6. Data quality
+  promises.push(
+    (async () => {
+      if (!db) return;
+      try {
+        const quality = await db
+          .prepare(
+            `SELECT MAX(snapshot_hour) as latest
+             FROM hourly_usage_snapshots
+             WHERE snapshot_hour >= datetime('now', '-24 hours') AND project = 'all'
+             LIMIT 1`
+          )
+          .first<{ latest: string | null }>();
+        if (quality?.latest) {
+          summary.dataQuality.latestSnapshot = quality.latest;
+          const ageMs = Date.now() - new Date(quality.latest + 'Z').getTime();
+          summary.dataQuality.snapshotAgeMinutes = Math.round(ageMs / 60000);
+          summary.dataQuality.status = summary.dataQuality.snapshotAgeMinutes < 120 ? 'fresh' : 'stale';
+        }
+      } catch {
+        // Table may not exist
+      }
+    })()
+  );
+
+  await Promise.all(promises);
+
+  return new Response(JSON.stringify(summary), {
+    headers: {
+      'Content-Type': 'application/json',
+      'Cache-Control': 'max-age=60',
+    },
+  });
+};

package/templates/shared/dashboard/src/pages/api/usage/circuit-breakers.ts

@@ -0,0 +1,44 @@
+import type { APIRoute } from 'astro';
+
+export const GET: APIRoute = async ({ locals }) => {
+  const kv = (locals.runtime?.env as { PLATFORM_CACHE?: KVNamespace } | undefined)?.PLATFORM_CACHE;
+
+  if (!kv) {
+    return new Response(JSON.stringify({ breakers: [] }), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const cbKeys = await kv.list({ prefix: 'cb:' });
+    const breakers = [];
+
+    for (const key of cbKeys.keys) {
+      const state = (await kv.get(key.name, 'json')) as {
+        status?: string;
+        feature?: string;
+        reason?: string;
+        trippedAt?: string;
+      } | null;
+      if (state) {
+        breakers.push({
+          key: key.name,
+          feature: state.feature ?? key.name.replace('cb:', ''),
+          status: state.status ?? 'unknown',
+          reason: state.reason ?? null,
+          trippedAt: state.trippedAt ?? null,
+        });
+      }
+    }
+
+    return new Response(JSON.stringify({ breakers }), {
+      headers: { 'Content-Type': 'application/json', 'Cache-Control': 'max-age=30' },
+    });
+  } catch (error) {
+    console.error('[circuit-breakers] Error:', error);
+    return new Response(JSON.stringify({ breakers: [], error: 'Failed to fetch circuit breakers' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/shared/dashboard/src/pages/api/usage/status.ts

@@ -0,0 +1,42 @@
+import type { APIRoute } from 'astro';
+
+export const GET: APIRoute = async ({ locals }) => {
+  const db = (locals.runtime?.env as { PLATFORM_DB?: D1Database } | undefined)?.PLATFORM_DB;
+
+  if (!db) {
+    return new Response(JSON.stringify({ status: 'no_database' }), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const latestSnapshot = await db
+      .prepare(
+        `SELECT snapshot_hour, project, total_cost_usd
+         FROM hourly_usage_snapshots
+         WHERE project = 'all'
+         ORDER BY snapshot_hour DESC
+         LIMIT 1`
+      )
+      .first<{ snapshot_hour: string; project: string; total_cost_usd: number }>();
+
+    const featureCount = await db
+      .prepare(`SELECT COUNT(DISTINCT feature_id) as count FROM feature_usage_daily LIMIT 1`)
+      .first<{ count: number }>();
+
+    return new Response(
+      JSON.stringify({
+        status: 'active',
+        latestSnapshot: latestSnapshot?.snapshot_hour ?? null,
+        latestCost: latestSnapshot?.total_cost_usd ?? 0,
+        trackedFeatures: featureCount?.count ?? 0,
+      }),
+      { headers: { 'Content-Type': 'application/json', 'Cache-Control': 'max-age=60' } }
+    );
+  } catch {
+    return new Response(JSON.stringify({ status: 'error' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/shared/dashboard/src/pages/dashboard.astro

@@ -0,0 +1,11 @@
+---
+import DashboardLayout from '../layouts/DashboardLayout.astro';
+import { MissionControl } from '../components/overview/MissionControl';
+---
+
+<DashboardLayout title="Overview">
+  <div class="max-w-7xl mx-auto">
+    <h2 class="text-xl font-bold text-gray-900 dark:text-white mb-4">Mission Control</h2>
+    <MissionControl client:load />
+  </div>
+</DashboardLayout>

package/templates/shared/dashboard/src/pages/index.astro

@@ -0,0 +1,3 @@
+---
+return Astro.redirect('/dashboard');
+---

package/templates/shared/dashboard/src/pages/resources.astro

@@ -0,0 +1,11 @@
+---
+import DashboardLayout from '../layouts/DashboardLayout.astro';
+import { ResourceTabs } from '../components/resources/ResourceTabs';
+---
+
+<DashboardLayout title="Resources">
+  <div class="max-w-7xl mx-auto">
+    <h2 class="text-xl font-bold text-gray-900 dark:text-white mb-4">Resources</h2>
+    <ResourceTabs client:load />
+  </div>
+</DashboardLayout>

package/templates/shared/dashboard/src/pages/settings/index.astro

@@ -0,0 +1,28 @@
+---
+import DashboardLayout from '../../layouts/DashboardLayout.astro';
+import { SettingsCard } from '../../components/settings/SettingsCard';
+---
+
+<DashboardLayout title="Settings">
+  <div class="max-w-3xl mx-auto space-y-4">
+    <h2 class="text-xl font-bold text-gray-900 dark:text-white mb-4">Settings</h2>
+    <SettingsCard
+      client:load
+      label="Monthly Budget"
+      description="Soft budget limit for cost alerts. Configure in budgets.yaml."
+      value="$100"
+    />
+    <SettingsCard
+      client:load
+      label="Circuit Breakers"
+      description="Automatic feature pause when budgets are exceeded."
+      value="Enabled"
+    />
+    <SettingsCard
+      client:load
+      label="Data Collection"
+      description="Hourly Cloudflare GraphQL snapshots and SDK telemetry."
+      value="Active"
+    />
+  </div>
+</DashboardLayout>

package/templates/shared/dashboard/src/styles/global.css

@@ -0,0 +1,29 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer components {
+  .nav-link {
+    @apply text-gray-700 transition-colors hover:text-blue-600 dark:text-gray-300 dark:hover:text-blue-400 font-medium;
+  }
+
+  .metric-card {
+    @apply rounded-lg bg-white p-6 shadow dark:bg-gray-800;
+  }
+
+  .metric-title {
+    @apply text-sm font-medium uppercase tracking-wide text-gray-600 dark:text-gray-400;
+  }
+
+  .metric-value {
+    @apply mt-2 text-3xl font-bold text-gray-900 dark:text-white;
+  }
+
+  .alert-critical {
+    @apply rounded border-l-4 border-red-500 bg-red-50 p-4 dark:bg-red-900/20;
+  }
+
+  .alert-warning {
+    @apply rounded border-l-4 border-yellow-500 bg-yellow-50 p-4 dark:bg-yellow-900/20;
+  }
+}

package/templates/shared/dashboard/tailwind.config.mjs

@@ -0,0 +1,9 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: ['./src/**/*.{astro,html,js,jsx,ts,tsx}'],
+  darkMode: 'class',
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/templates/shared/dashboard/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}

package/templates/shared/dashboard/wrangler.json.hbs

@@ -0,0 +1,47 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-dashboard",
+  "pages_build_output_dir": "dist",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat"],
+  "upload_source_maps": true,
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "YOUR_DATABASE_NAME",
+      "database_id": "YOUR_DATABASE_ID"
+    }
+  ],
+  "kv_namespaces": [
+    {
+      "binding": "PLATFORM_CACHE",
+      "id": "YOUR_PLATFORM_CACHE_KV_ID"
+    }
+  ],
+  "services": [
+    {
+      "binding": "USAGE_API",
+      "service": "{{projectSlug}}-usage"
+    }{{#if isStandard}},
+    {
+      "binding": "ERROR_COLLECTOR_API",
+      "service": "{{projectSlug}}-error-collector"
+    }{{/if}}{{#if isFull}},
+    {
+      "binding": "PATTERN_DISCOVERY_API",
+      "service": "{{projectSlug}}-pattern-discovery"
+    },
+    {
+      "binding": "NOTIFICATIONS_API",
+      "service": "{{projectSlug}}-notifications"
+    },
+    {
+      "binding": "SETTINGS_API",
+      "service": "{{projectSlug}}-settings"
+    },
+    {
+      "binding": "SEARCH_API",
+      "service": "{{projectSlug}}-search"
+    }{{/if}}
+  ]
+}

package/templates/shared/package.json.hbs

@@ -6,7 +6,16 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "sync:config": "npx tsx scripts/sync-config.ts",
-    "deploy:usage": "wrangler deploy -c wrangler.{{projectSlug}}-usage.jsonc"
+    "deploy:usage": "wrangler deploy -c wrangler.{{projectSlug}}-usage.jsonc",
+    "backfill": "npx tsx scripts/ops/backfill-cloudflare-hourly.ts",
+    "reset-cb": "npx tsx scripts/ops/reset-budget-state.ts",
+    "verify": "npx tsx scripts/ops/verify-account-completeness.ts",
+    "validate:pipeline": "npx tsx scripts/ops/validate-pipeline.ts",
+    "validate:schemas": "node scripts/validate-schemas.js",
+    "deploy:auditor": "wrangler deploy -c wrangler.{{projectSlug}}-auditor.jsonc",
+    "deploy:mapper": "wrangler deploy -c wrangler.{{projectSlug}}-mapper.jsonc",
+    "deploy:test-client": "wrangler deploy -c wrangler.{{projectSlug}}-sdk-test-client.jsonc",
+    "discover:datasets": "npx tsx scripts/ops/discover-graphql-datasets.ts"
   },
   "dependencies": {
     "@littlebearapps/platform-consumer-sdk": "^{{sdkVersion}}",
@@ -14,6 +23,8 @@
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20250214.0",
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.3",
     "wrangler": "^3.100.0"