@littlebearapps/platform-admin-sdk 1.4.2 → 1.5.0

package/dist/templates.d.ts

@@ -6,7 +6,7 @@
  */
 import type { Tier } from './prompts.js';
 /** Single source of truth for the SDK version. */
-export declare const SDK_VERSION = "1.4.2";
+export declare const SDK_VERSION = "1.5.0";
 /** Returns true if `to` is the same or higher tier than `from`. */
 export declare function isTierUpgradeOrSame(from: Tier, to: Tier): boolean;
 /** Check if a template file is a numbered migration (not seed.sql). */

package/dist/templates.js

@@ -5,7 +5,7 @@
  * All other files are copied verbatim.
  */
 /** Single source of truth for the SDK version. */
-export const SDK_VERSION = '1.4.2';
+export const SDK_VERSION = '1.5.0';
 /** Tier ordering for upgrade validation. */
 const TIER_ORDER = { minimal: 0, standard: 1, full: 2 };
 /** Returns true if `to` is the same or higher tier than `from`. */
@@ -22,6 +22,16 @@ const SHARED_FILES = [
     { src: 'shared/config/budgets.yaml.hbs', dest: 'platform/config/budgets.yaml', template: true },
     // Scripts
     { src: 'shared/scripts/sync-config.ts', dest: 'scripts/sync-config.ts', template: false },
+    { src: 'shared/scripts/validate-schemas.js', dest: 'scripts/validate-schemas.js', template: false },
+    // Operational scripts
+    { src: 'shared/scripts/ops/backfill-cloudflare-hourly.ts', dest: 'scripts/ops/backfill-cloudflare-hourly.ts', template: false },
+    { src: 'shared/scripts/ops/reset-budget-state.ts', dest: 'scripts/ops/reset-budget-state.ts', template: false },
+    { src: 'shared/scripts/ops/verify-account-completeness.ts', dest: 'scripts/ops/verify-account-completeness.ts', template: false },
+    { src: 'shared/scripts/ops/validate-pipeline.ts', dest: 'scripts/ops/validate-pipeline.ts', template: false },
+    // Contracts — JSON schemas + TypeScript types
+    { src: 'shared/contracts/schemas/envelope.v1.schema.json', dest: 'contracts/schemas/envelope.v1.schema.json', template: false },
+    { src: 'shared/contracts/schemas/error_report.v1.schema.json', dest: 'contracts/schemas/error_report.v1.schema.json', template: false },
+    { src: 'shared/contracts/types/telemetry-envelope.types.ts', dest: 'contracts/types/telemetry-envelope.types.ts', template: false },
     // Migrations (minimal tier)
     { src: 'shared/migrations/001_core_tables.sql', dest: 'storage/d1/migrations/001_core_tables.sql', template: false },
     { src: 'shared/migrations/002_usage_warehouse.sql', dest: 'storage/d1/migrations/002_usage_warehouse.sql', template: false },
@@ -79,11 +89,64 @@ const SHARED_FILES = [
     { src: 'shared/workers/lib/usage/scheduled/anomaly-detection.ts', dest: 'workers/lib/usage/scheduled/anomaly-detection.ts', template: false },
     { src: 'shared/workers/lib/usage/scheduled/rollups.ts', dest: 'workers/lib/usage/scheduled/rollups.ts', template: false },
     { src: 'shared/workers/lib/usage/scheduled/error-digest.ts', dest: 'workers/lib/usage/scheduled/error-digest.ts', template: false },
-    // Workers — lib/usage/collectors (pluggable interface + example)
+    // Workers — lib/usage/collectors (framework + 10 provider collectors + example)
     { src: 'shared/workers/lib/usage/collectors/index.ts', dest: 'workers/lib/usage/collectors/index.ts', template: false },
     { src: 'shared/workers/lib/usage/collectors/example.ts', dest: 'workers/lib/usage/collectors/example.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/openai.ts', dest: 'workers/lib/usage/collectors/openai.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/anthropic.ts', dest: 'workers/lib/usage/collectors/anthropic.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/github.ts', dest: 'workers/lib/usage/collectors/github.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/stripe.ts', dest: 'workers/lib/usage/collectors/stripe.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/apify.ts', dest: 'workers/lib/usage/collectors/apify.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/resend.ts', dest: 'workers/lib/usage/collectors/resend.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/deepseek.ts', dest: 'workers/lib/usage/collectors/deepseek.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/minimax.ts', dest: 'workers/lib/usage/collectors/minimax.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/gemini.ts', dest: 'workers/lib/usage/collectors/gemini.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/custom-http.ts', dest: 'workers/lib/usage/collectors/custom-http.ts', template: false },
     // Documentation
     { src: 'shared/docs/kv-key-patterns.md', dest: 'docs/kv-key-patterns.md', template: false },
+    // Observability config
+    { src: 'shared/config/observability.yaml.hbs', dest: 'platform/config/observability.yaml', template: true },
+    // GraphQL dataset discovery script
+    { src: 'shared/scripts/ops/discover-graphql-datasets.ts', dest: 'scripts/ops/discover-graphql-datasets.ts', template: false },
+    // CI workflow (caller for reusable consumer-check)
+    { src: 'shared/.github/workflows/platform-check.yml.hbs', dest: '.github/workflows/platform-check.yml', template: true },
+    // Dashboard — shared tier (Astro SSR + Cloudflare Pages)
+    { src: 'shared/dashboard/package.json.hbs', dest: 'dashboard/package.json', template: true },
+    { src: 'shared/dashboard/astro.config.mjs', dest: 'dashboard/astro.config.mjs', template: false },
+    { src: 'shared/dashboard/tailwind.config.mjs', dest: 'dashboard/tailwind.config.mjs', template: false },
+    { src: 'shared/dashboard/tsconfig.json', dest: 'dashboard/tsconfig.json', template: false },
+    { src: 'shared/dashboard/wrangler.json.hbs', dest: 'dashboard/wrangler.json', template: true },
+    { src: 'shared/dashboard/src/env.d.ts.hbs', dest: 'dashboard/src/env.d.ts', template: true },
+    { src: 'shared/dashboard/src/styles/global.css', dest: 'dashboard/src/styles/global.css', template: false },
+    { src: 'shared/dashboard/src/middleware/auth.ts', dest: 'dashboard/src/middleware/auth.ts', template: false },
+    { src: 'shared/dashboard/src/middleware/index.ts', dest: 'dashboard/src/middleware/index.ts', template: false },
+    { src: 'shared/dashboard/src/layouts/DashboardLayout.astro', dest: 'dashboard/src/layouts/DashboardLayout.astro', template: false },
+    { src: 'shared/dashboard/src/components/Nav.astro.hbs', dest: 'dashboard/src/components/Nav.astro', template: true },
+    { src: 'shared/dashboard/src/components/Header.astro', dest: 'dashboard/src/components/Header.astro', template: false },
+    { src: 'shared/dashboard/src/pages/index.astro', dest: 'dashboard/src/pages/index.astro', template: false },
+    { src: 'shared/dashboard/src/pages/dashboard.astro', dest: 'dashboard/src/pages/dashboard.astro', template: false },
+    { src: 'shared/dashboard/src/pages/resources.astro', dest: 'dashboard/src/pages/resources.astro', template: false },
+    { src: 'shared/dashboard/src/pages/settings/index.astro', dest: 'dashboard/src/pages/settings/index.astro', template: false },
+    { src: 'shared/dashboard/src/pages/api/overview/summary.ts', dest: 'dashboard/src/pages/api/overview/summary.ts', template: false },
+    { src: 'shared/dashboard/src/pages/api/usage/circuit-breakers.ts', dest: 'dashboard/src/pages/api/usage/circuit-breakers.ts', template: false },
+    { src: 'shared/dashboard/src/pages/api/usage/status.ts', dest: 'dashboard/src/pages/api/usage/status.ts', template: false },
+    { src: 'shared/dashboard/src/components/overview/MissionControl.tsx', dest: 'dashboard/src/components/overview/MissionControl.tsx', template: false },
+    { src: 'shared/dashboard/src/components/overview/HealthQuadrant.tsx', dest: 'dashboard/src/components/overview/HealthQuadrant.tsx', template: false },
+    { src: 'shared/dashboard/src/components/overview/ErrorsQuadrant.tsx', dest: 'dashboard/src/components/overview/ErrorsQuadrant.tsx', template: false },
+    { src: 'shared/dashboard/src/components/overview/CostQuadrant.tsx', dest: 'dashboard/src/components/overview/CostQuadrant.tsx', template: false },
+    { src: 'shared/dashboard/src/components/overview/ActivityFeed.tsx', dest: 'dashboard/src/components/overview/ActivityFeed.tsx', template: false },
+    { src: 'shared/dashboard/src/components/ui/AlertBanner.tsx', dest: 'dashboard/src/components/ui/AlertBanner.tsx', template: false },
+    { src: 'shared/dashboard/src/components/ui/Sparkline.tsx', dest: 'dashboard/src/components/ui/Sparkline.tsx', template: false },
+    { src: 'shared/dashboard/src/components/ui/StatusDot.tsx', dest: 'dashboard/src/components/ui/StatusDot.tsx', template: false },
+    { src: 'shared/dashboard/src/components/ui/index.ts', dest: 'dashboard/src/components/ui/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/resources/ResourceTabs.tsx', dest: 'dashboard/src/components/resources/ResourceTabs.tsx', template: false },
+    { src: 'shared/dashboard/src/components/resources/CostCentreOverview.tsx', dest: 'dashboard/src/components/resources/CostCentreOverview.tsx', template: false },
+    { src: 'shared/dashboard/src/components/resources/AllowanceStatus.tsx', dest: 'dashboard/src/components/resources/AllowanceStatus.tsx', template: false },
+    { src: 'shared/dashboard/src/components/resources/index.ts', dest: 'dashboard/src/components/resources/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/settings/SettingsCard.tsx', dest: 'dashboard/src/components/settings/SettingsCard.tsx', template: false },
+    { src: 'shared/dashboard/src/components/settings/index.ts', dest: 'dashboard/src/components/settings/index.ts', template: false },
+    { src: 'shared/dashboard/src/lib/types.ts', dest: 'dashboard/src/lib/types.ts', template: false },
+    { src: 'shared/dashboard/src/lib/fetch.ts', dest: 'dashboard/src/lib/fetch.ts', template: false },
 ];
 const STANDARD_FILES = [
     // Additional migrations
@@ -105,6 +168,28 @@ const STANDARD_FILES = [
     { src: 'standard/workers/lib/sentinel/gap-detection.ts', dest: 'workers/lib/sentinel/gap-detection.ts', template: false },
     // Workers — shared lib (used by standard-tier workers)
     { src: 'standard/workers/lib/shared/slack-alerts.ts', dest: 'workers/lib/shared/slack-alerts.ts', template: false },
+    // Topology mapper (infrastructure discovery + attribution)
+    { src: 'standard/migrations/009_topology_mapper.sql', dest: 'storage/d1/migrations/009_topology_mapper.sql', template: false },
+    { src: 'standard/wrangler.mapper.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-mapper.jsonc', template: true },
+    { src: 'standard/workers/platform-mapper.ts', dest: 'workers/platform-mapper.ts', template: false },
+    { src: 'standard/workers/lib/mapper/index.ts', dest: 'workers/lib/mapper/index.ts', template: false },
+    { src: 'standard/workers/lib/mapper/attribution-check.ts', dest: 'workers/lib/mapper/attribution-check.ts', template: false },
+    // SDK test client (telemetry + circuit breaker validation)
+    { src: 'standard/wrangler.sdk-test-client.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-sdk-test-client.jsonc', template: true },
+    { src: 'standard/workers/platform-sdk-test-client.ts', dest: 'workers/platform-sdk-test-client.ts', template: false },
+    // Dashboard — standard tier (error management, health, DLQ)
+    { src: 'standard/dashboard/src/pages/health.astro', dest: 'dashboard/src/pages/health.astro', template: false },
+    { src: 'standard/dashboard/src/pages/errors.astro', dest: 'dashboard/src/pages/errors.astro', template: false },
+    { src: 'standard/dashboard/src/pages/api/errors/index.ts', dest: 'dashboard/src/pages/api/errors/index.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/errors/stats.ts', dest: 'dashboard/src/pages/api/errors/stats.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/health/dlq.ts', dest: 'dashboard/src/pages/api/health/dlq.ts', template: false },
+    { src: 'standard/dashboard/src/components/health/HealthTabs.tsx', dest: 'dashboard/src/components/health/HealthTabs.tsx', template: false },
+    { src: 'standard/dashboard/src/components/health/DlqStatusCard.tsx', dest: 'dashboard/src/components/health/DlqStatusCard.tsx', template: false },
+    { src: 'standard/dashboard/src/components/health/index.ts', dest: 'dashboard/src/components/health/index.ts', template: false },
+    { src: 'standard/dashboard/src/components/errors/ErrorsTable.tsx', dest: 'dashboard/src/components/errors/ErrorsTable.tsx', template: false },
+    { src: 'standard/dashboard/src/components/errors/ErrorStats.tsx', dest: 'dashboard/src/components/errors/ErrorStats.tsx', template: false },
+    { src: 'standard/dashboard/src/components/errors/index.ts', dest: 'dashboard/src/components/errors/index.ts', template: false },
+    { src: 'standard/dashboard/src/lib/errors.ts', dest: 'dashboard/src/lib/errors.ts', template: false },
 ];
 const FULL_FILES = [
     // Additional migrations
@@ -133,6 +218,40 @@ const FULL_FILES = [
     { src: 'full/workers/platform-search.ts', dest: 'workers/platform-search.ts', template: false },
     // Workers — platform-settings (settings management API)
     { src: 'full/workers/platform-settings.ts', dest: 'workers/platform-settings.ts', template: false },
+    // Additional migrations — auditor
+    { src: 'full/migrations/008_auditor.sql', dest: 'storage/d1/migrations/008_auditor.sql', template: false },
+    // Auditor config
+    { src: 'full/config/audit-targets.yaml', dest: 'config/audit-targets.yaml', template: false },
+    // Wrangler config — auditor
+    { src: 'full/wrangler.auditor.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-auditor.jsonc', template: true },
+    // Workers — platform-auditor (SDK integration auditor + AI Judge)
+    { src: 'full/workers/platform-auditor.ts', dest: 'workers/platform-auditor.ts', template: false },
+    { src: 'full/workers/lib/ai-judge-schema.ts', dest: 'workers/lib/ai-judge-schema.ts', template: false },
+    { src: 'full/workers/lib/auditor/index.ts', dest: 'workers/lib/auditor/index.ts', template: false },
+    { src: 'full/workers/lib/auditor/types.ts', dest: 'workers/lib/auditor/types.ts', template: false },
+    { src: 'full/workers/lib/auditor/feature-coverage.ts', dest: 'workers/lib/auditor/feature-coverage.ts', template: false },
+    { src: 'full/workers/lib/auditor/comprehensive-report.ts', dest: 'workers/lib/auditor/comprehensive-report.ts', template: false },
+    // Pricing version tracking
+    { src: 'full/migrations/010_pricing_versions.sql', dest: 'storage/d1/migrations/010_pricing_versions.sql', template: false },
+    // Multi-account Cloudflare support
+    { src: 'full/migrations/011_multi_account.sql', dest: 'storage/d1/migrations/011_multi_account.sql', template: false },
+    // KV pricing configuration script
+    { src: 'full/scripts/ops/set-kv-pricing.ts', dest: 'scripts/ops/set-kv-pricing.ts', template: false },
+    // Dashboard — full tier (patterns, notifications, search)
+    { src: 'full/dashboard/src/pages/notifications.astro', dest: 'dashboard/src/pages/notifications.astro', template: false },
+    { src: 'full/dashboard/src/pages/api/patterns/index.ts', dest: 'dashboard/src/pages/api/patterns/index.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/patterns/approve.ts', dest: 'dashboard/src/pages/api/patterns/approve.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/patterns/reject.ts', dest: 'dashboard/src/pages/api/patterns/reject.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/notifications/index.ts', dest: 'dashboard/src/pages/api/notifications/index.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/notifications/unread-count.ts', dest: 'dashboard/src/pages/api/notifications/unread-count.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/search/index.ts', dest: 'dashboard/src/pages/api/search/index.ts', template: false },
+    { src: 'full/dashboard/src/components/patterns/SuggestionsQueue.tsx', dest: 'dashboard/src/components/patterns/SuggestionsQueue.tsx', template: false },
+    { src: 'full/dashboard/src/components/patterns/PatternStats.tsx', dest: 'dashboard/src/components/patterns/PatternStats.tsx', template: false },
+    { src: 'full/dashboard/src/components/patterns/index.ts', dest: 'dashboard/src/components/patterns/index.ts', template: false },
+    { src: 'full/dashboard/src/components/notifications/NotificationBell.tsx', dest: 'dashboard/src/components/notifications/NotificationBell.tsx', template: false },
+    { src: 'full/dashboard/src/components/notifications/NotificationList.tsx', dest: 'dashboard/src/components/notifications/NotificationList.tsx', template: false },
+    { src: 'full/dashboard/src/components/notifications/index.ts', dest: 'dashboard/src/components/notifications/index.ts', template: false },
+    { src: 'full/dashboard/src/components/search/SearchModal.tsx', dest: 'dashboard/src/components/search/SearchModal.tsx', template: false },
 ];
 export function getFilesForTier(tier) {
     const files = [...SHARED_FILES];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littlebearapps/platform-admin-sdk",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Platform Admin SDK — scaffold backend infrastructure with workers, circuit breakers, and cost protection for Cloudflare",
   "type": "module",
   "bin": {

package/templates/full/config/audit-targets.yaml

@@ -0,0 +1,72 @@
+# =============================================================================
+# Audit Targets Configuration
+# =============================================================================
+# Define the projects that the platform-auditor worker should audit.
+# Sync this to KV via: npm run sync:config
+#
+# Each target specifies:
+#   repo           — GitHub org/repo path (for fetching source files)
+#   wranglerPath   — Path to main wrangler config (for config checks)
+#   entryPoint     — Primary SDK integration file (for code smell detection)
+#   expectedStatus — Expected audit result: HEALTHY, ZOMBIE, UNTRACKED, BROKEN
+#   notes          — Human-readable description
+#   deepScanFiles  — Files per audit dimension (for AI Judge analysis)
+#
+# Status definitions:
+#   HEALTHY        — SDK integrated, heartbeats fresh, config correct
+#   ZOMBIE         — Was integrated but dormant (no recent heartbeats)
+#   UNTRACKED      — Running in production but not using SDK
+#   BROKEN         — SDK integration present but misconfigured
+#   NOT_INTEGRATED — No SDK integration detected
+# =============================================================================
+
+targets: {}
+  # Example target (uncomment and customise):
+  #
+  # my-project:
+  #   repo: my-org/my-project
+  #   wranglerPath: wrangler.jsonc
+  #   entryPoint: src/index.ts
+  #   entryPointFallback: src/worker.ts
+  #   expectedStatus: HEALTHY
+  #   notes: Main application worker
+  #   deepScanFiles:
+  #     sdk:
+  #       - src/index.ts
+  #       - src/middleware/platform-sdk.ts
+  #       - src/lib/features.ts
+  #     observability:
+  #       - src/lib/logger.ts
+  #       - src/middleware/tracing.ts
+  #     cost:
+  #       - src/lib/budgets.ts
+  #       - src/middleware/circuit-breaker.ts
+  #     security:
+  #       - src/middleware/auth.ts
+  #       - src/lib/validation.ts
+
+# SDK patterns to detect in source code (for code smell checks)
+sdkPatterns:
+  - withFeatureBudget
+  - withCronBudget
+  - withQueueBudget
+  - trackedEnv
+  - platform-sdk
+  - completeTracking
+  - CircuitBreakerError
+  - PLATFORM_CACHE
+  - PLATFORM_TELEMETRY
+
+# Rubric weights for composite score calculation (must sum to 1.0)
+rubricWeights:
+  sdk: 0.3
+  observability: 0.25
+  costProtection: 0.25
+  security: 0.2
+
+# Thresholds
+heartbeatFreshnessHours: 24
+focusedScanThreshold: 90
+aiCacheTtlSeconds: 259200  # 3 days
+behavioralAnalysisDays: 30
+hotspotMinCommits: 3

package/templates/full/dashboard/src/components/notifications/NotificationBell.tsx

@@ -0,0 +1,30 @@
+import { useState, useEffect, useRef } from 'react';
+
+export function NotificationBell() {
+  const [count, setCount] = useState(0);
+  const intervalRef = useRef<ReturnType<typeof setInterval>>();
+
+  useEffect(() => {
+    function fetchCount() {
+      fetch('/api/notifications/unread-count')
+        .then(res => res.json())
+        .then((data: { count: number }) => setCount(data.count ?? 0))
+        .catch(() => {});
+    }
+
+    fetchCount();
+    intervalRef.current = setInterval(fetchCount, 30000);
+    return () => clearInterval(intervalRef.current);
+  }, []);
+
+  return (
+    <a href="/notifications" className="relative p-2 rounded-md text-gray-500 dark:text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-700">
+      <span className="text-lg">&#128276;</span>
+      {count > 0 && (
+        <span className="absolute -top-1 -right-1 inline-flex items-center justify-center w-5 h-5 text-xs font-bold text-white bg-red-500 rounded-full">
+          {count > 99 ? '99+' : count}
+        </span>
+      )}
+    </a>
+  );
+}

package/templates/full/dashboard/src/components/notifications/NotificationList.tsx

@@ -0,0 +1,116 @@
+import { useState, useEffect } from 'react';
+
+interface Notification {
+  id: string;
+  title: string;
+  body: string | null;
+  category: string;
+  priority: string;
+  source: string;
+  created_at: number;
+  read_at: number | null;
+  action_url: string | null;
+}
+
+export function NotificationList() {
+  const [notifications, setNotifications] = useState<Notification[]>([]);
+  const [total, setTotal] = useState(0);
+  const [page, setPage] = useState(1);
+
+  useEffect(() => {
+    fetch(`/api/notifications?page=${page}&limit=20`)
+      .then(res => res.json())
+      .then((data: { notifications: Notification[]; total: number }) => {
+        setNotifications(data.notifications ?? []);
+        setTotal(data.total ?? 0);
+      })
+      .catch(() => {});
+  }, [page]);
+
+  function formatTime(ts: number): string {
+    const now = Date.now();
+    const diffMs = now - ts * 1000;
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMs / 3600000);
+    const diffDays = Math.floor(diffMs / 86400000);
+
+    if (diffMins < 1) return 'Just now';
+    if (diffMins < 60) return `${diffMins}m ago`;
+    if (diffHours < 24) return `${diffHours}h ago`;
+    if (diffDays < 7) return `${diffDays}d ago`;
+    return new Date(ts * 1000).toLocaleDateString('en-AU', { day: 'numeric', month: 'short' });
+  }
+
+  const categoryIcons: Record<string, string> = {
+    error: '[ERR]',
+    warning: '[WARN]',
+    info: '[INFO]',
+    success: '[OK]',
+  };
+
+  return (
+    <div className="space-y-3">
+      {notifications.length === 0 ? (
+        <div className="text-center py-8 text-gray-500 dark:text-gray-400">
+          No notifications.
+        </div>
+      ) : (
+        notifications.map(n => (
+          <div
+            key={n.id}
+            className={`bg-white dark:bg-gray-800 rounded-lg border p-4 ${
+              n.read_at ? 'border-gray-200 dark:border-gray-700' : 'border-blue-300 dark:border-blue-700'
+            }`}
+          >
+            <div className="flex items-start gap-3">
+              <span className="text-xs font-mono text-gray-500 dark:text-gray-400 mt-0.5">
+                {categoryIcons[n.category] ?? '[INFO]'}
+              </span>
+              <div className="flex-1 min-w-0">
+                <div className="flex items-center justify-between gap-2">
+                  <h4 className="text-sm font-medium text-gray-900 dark:text-white truncate">
+                    {n.action_url ? (
+                      <a href={n.action_url} className="hover:text-blue-600 dark:hover:text-blue-400">{n.title}</a>
+                    ) : n.title}
+                  </h4>
+                  <span className="text-xs text-gray-400 dark:text-gray-500 flex-shrink-0">
+                    {formatTime(n.created_at)}
+                  </span>
+                </div>
+                {n.body && (
+                  <p className="text-xs text-gray-500 dark:text-gray-400 mt-1 line-clamp-2">{n.body}</p>
+                )}
+                <div className="flex items-center gap-2 mt-1.5">
+                  <span className="text-xs text-gray-400 dark:text-gray-500">{n.source}</span>
+                  <span className="text-xs text-gray-400 dark:text-gray-500">{n.priority}</span>
+                </div>
+              </div>
+            </div>
+          </div>
+        ))
+      )}
+
+      {total > 20 && (
+        <div className="flex items-center justify-between pt-2">
+          <button
+            onClick={() => setPage(p => Math.max(1, p - 1))}
+            disabled={page === 1}
+            className="text-sm text-blue-600 dark:text-blue-400 disabled:opacity-50"
+          >
+            Previous
+          </button>
+          <span className="text-sm text-gray-500 dark:text-gray-400">
+            Page {page} of {Math.ceil(total / 20)}
+          </span>
+          <button
+            onClick={() => setPage(p => p + 1)}
+            disabled={page >= Math.ceil(total / 20)}
+            className="text-sm text-blue-600 dark:text-blue-400 disabled:opacity-50"
+          >
+            Next
+          </button>
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/full/dashboard/src/components/notifications/index.ts

@@ -0,0 +1,2 @@
+export { NotificationBell } from './NotificationBell';
+export { NotificationList } from './NotificationList';

package/templates/full/dashboard/src/components/patterns/PatternStats.tsx

@@ -0,0 +1,60 @@
+import { useState, useEffect } from 'react';
+
+interface Stats {
+  pending: number;
+  shadow: number;
+  approved: number;
+  rejected: number;
+}
+
+export function PatternStats() {
+  const [stats, setStats] = useState<Stats | null>(null);
+
+  useEffect(() => {
+    Promise.all([
+      fetch('/api/patterns?status=pending').then(r => r.json()),
+      fetch('/api/patterns?status=shadow').then(r => r.json()),
+      fetch('/api/patterns?status=approved').then(r => r.json()),
+    ])
+      .then(([pending, shadow, approved]) => {
+        setStats({
+          pending: (pending as { suggestions: unknown[] }).suggestions?.length ?? 0,
+          shadow: (shadow as { suggestions: unknown[] }).suggestions?.length ?? 0,
+          approved: (approved as { suggestions: unknown[] }).suggestions?.length ?? 0,
+          rejected: 0,
+        });
+      })
+      .catch(() => {});
+  }, []);
+
+  if (!stats) {
+    return (
+      <div className="grid grid-cols-4 gap-4">
+        {Array.from({ length: 4 }).map((_, i) => (
+          <div key={i} className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 p-4 animate-pulse">
+            <div className="h-4 bg-gray-200 dark:bg-gray-700 rounded w-12 mb-2" />
+            <div className="h-8 bg-gray-200 dark:bg-gray-700 rounded w-8" />
+          </div>
+        ))}
+      </div>
+    );
+  }
+
+  const items = [
+    { label: 'Pending', value: stats.pending, colour: 'text-yellow-600 dark:text-yellow-400' },
+    { label: 'Shadow', value: stats.shadow, colour: 'text-purple-600 dark:text-purple-400' },
+    { label: 'Approved', value: stats.approved, colour: 'text-green-600 dark:text-green-400' },
+    { label: 'Rejected', value: stats.rejected, colour: 'text-red-600 dark:text-red-400' },
+  ];
+
+  return (
+    <div className="grid grid-cols-4 gap-4">
+      {items.map(item => (
+        <div key={item.label} className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 p-4">
+          <div className="text-xs font-medium text-gray-500 dark:text-gray-400 uppercase">{item.label}</div>
+          <div className={`text-2xl font-bold mt-1 ${item.colour}`}>{item.value}</div>
+        </div>
+      ))}
+    </div>
+  );
+}

package/templates/full/dashboard/src/components/patterns/SuggestionsQueue.tsx

@@ -0,0 +1,115 @@
+import { useState, useEffect, useCallback } from 'react';
+
+interface PatternSuggestion {
+  id: number;
+  pattern_type: string;
+  pattern_value: string;
+  error_type: string;
+  priority: string;
+  status: string;
+  match_count: number;
+  source: string;
+  created_at: string;
+  reviewed_at: string | null;
+  reviewer_notes: string | null;
+}
+
+export function SuggestionsQueue() {
+  const [suggestions, setSuggestions] = useState<PatternSuggestion[]>([]);
+  const [filter, setFilter] = useState<string>('pending');
+  const [actioningId, setActioningId] = useState<number | null>(null);
+
+  const loadSuggestions = useCallback(() => {
+    fetch(`/api/patterns?status=${filter}`)
+      .then(res => res.json())
+      .then((data: { suggestions: PatternSuggestion[] }) => setSuggestions(data.suggestions ?? []))
+      .catch(() => {});
+  }, [filter]);
+
+  useEffect(() => { loadSuggestions(); }, [loadSuggestions]);
+
+  async function handleAction(id: number, action: 'approve' | 'reject') {
+    setActioningId(id);
+    try {
+      const res = await fetch(`/api/patterns/${action}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ id }),
+      });
+      if (res.ok) {
+        setSuggestions(prev => prev.filter(s => s.id !== id));
+      }
+    } catch {
+      // Silently fail
+    }
+    setActioningId(null);
+  }
+
+  return (
+    <div className="space-y-4">
+      <div className="flex gap-2">
+        {['pending', 'shadow', 'approved', 'rejected'].map(s => (
+          <button
+            key={s}
+            onClick={() => setFilter(s)}
+            className={`text-sm px-3 py-1 rounded-full transition-colors ${
+              filter === s
+                ? 'bg-blue-100 text-blue-700 dark:bg-blue-900/40 dark:text-blue-300'
+                : 'bg-gray-100 text-gray-600 dark:bg-gray-700 dark:text-gray-400 hover:bg-gray-200 dark:hover:bg-gray-600'
+            }`}
+          >
+            {s.charAt(0).toUpperCase() + s.slice(1)}
+          </button>
+        ))}
+      </div>
+
+      {suggestions.length === 0 ? (
+        <div className="text-center py-8 text-gray-500 dark:text-gray-400">
+          No {filter} patterns.
+        </div>
+      ) : (
+        <div className="space-y-3">
+          {suggestions.map(s => (
+            <div key={s.id} className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 p-4">
+              <div className="flex items-start justify-between gap-4">
+                <div className="flex-1 min-w-0">
+                  <div className="flex items-center gap-2 mb-1">
+                    <span className="text-xs px-1.5 py-0.5 rounded bg-purple-100 text-purple-700 dark:bg-purple-900/40 dark:text-purple-300 font-mono">
+                      {s.pattern_type}
+                    </span>
+                    <span className="text-xs text-gray-500 dark:text-gray-400">
+                      {s.source} · {s.match_count} matches
+                    </span>
+                  </div>
+                  <p className="text-sm text-gray-900 dark:text-white font-mono truncate">{s.pattern_value}</p>
+                  <p className="text-xs text-gray-500 dark:text-gray-400 mt-1">
+                    {s.error_type} · {s.priority} · {new Date(s.created_at).toLocaleDateString('en-AU')}
+                  </p>
+                </div>
+
+                {filter === 'pending' && (
+                  <div className="flex gap-2 flex-shrink-0">
+                    <button
+                      onClick={() => handleAction(s.id, 'approve')}
+                      disabled={actioningId === s.id}
+                      className="text-xs px-3 py-1.5 rounded bg-green-100 text-green-700 dark:bg-green-900/40 dark:text-green-300 hover:bg-green-200 dark:hover:bg-green-900/60 disabled:opacity-50"
+                    >
+                      Approve
+                    </button>
+                    <button
+                      onClick={() => handleAction(s.id, 'reject')}
+                      disabled={actioningId === s.id}
+                      className="text-xs px-3 py-1.5 rounded bg-red-100 text-red-700 dark:bg-red-900/40 dark:text-red-300 hover:bg-red-200 dark:hover:bg-red-900/60 disabled:opacity-50"
+                    >
+                      Reject
+                    </button>
+                  </div>
+                )}
+              </div>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/full/dashboard/src/components/patterns/index.ts

@@ -0,0 +1,2 @@
+export { SuggestionsQueue } from './SuggestionsQueue';
+export { PatternStats } from './PatternStats';