@littlebearapps/platform-admin-sdk 1.4.2 → 1.5.0

package/templates/standard/dashboard/src/components/errors/ErrorsTable.tsx

@@ -0,0 +1,133 @@
+import { useState, useEffect } from 'react';
+
+interface ErrorRow {
+  fingerprint: string;
+  message: string;
+  script_name: string;
+  priority: string;
+  occurrence_count: number;
+  status: string;
+  first_seen_at: string;
+  last_seen_at: string;
+  github_issue_url: string | null;
+}
+
+const priorityColours: Record<string, string> = {
+  P0: 'bg-red-100 text-red-800 dark:bg-red-900/50 dark:text-red-300',
+  P1: 'bg-orange-100 text-orange-800 dark:bg-orange-900/50 dark:text-orange-300',
+  P2: 'bg-yellow-100 text-yellow-800 dark:bg-yellow-900/50 dark:text-yellow-300',
+  P3: 'bg-blue-100 text-blue-800 dark:bg-blue-900/50 dark:text-blue-300',
+  P4: 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-300',
+};
+
+export function ErrorsTable() {
+  const [errors, setErrors] = useState<ErrorRow[]>([]);
+  const [total, setTotal] = useState(0);
+  const [page, setPage] = useState(1);
+  const [filterPriority, setFilterPriority] = useState<string>('');
+  const [sortField, setSortField] = useState<'priority' | 'occurrence_count' | 'last_seen_at'>('priority');
+
+  useEffect(() => {
+    const params = new URLSearchParams({ page: String(page), limit: '20' });
+    if (filterPriority) params.set('priority', filterPriority);
+
+    fetch(`/api/errors?${params}`)
+      .then(res => res.json())
+      .then((data: { errors: ErrorRow[]; total: number }) => {
+        setErrors(data.errors ?? []);
+        setTotal(data.total ?? 0);
+      })
+      .catch(() => {});
+  }, [page, filterPriority]);
+
+  const sorted = [...errors].sort((a, b) => {
+    if (sortField === 'occurrence_count') return b.occurrence_count - a.occurrence_count;
+    if (sortField === 'last_seen_at') return new Date(b.last_seen_at).getTime() - new Date(a.last_seen_at).getTime();
+    return 0; // Default server sort by priority
+  });
+
+  return (
+    <div className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700">
+      <div className="p-4 border-b border-gray-200 dark:border-gray-700 flex items-center justify-between">
+        <h3 className="text-sm font-medium text-gray-900 dark:text-white">
+          Errors ({total})
+        </h3>
+        <select
+          value={filterPriority}
+          onChange={(e) => { setFilterPriority(e.target.value); setPage(1); }}
+          className="text-sm border border-gray-300 dark:border-gray-600 rounded px-2 py-1 bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
+        >
+          <option value="">All Priorities</option>
+          <option value="P0">P0</option>
+          <option value="P1">P1</option>
+          <option value="P2">P2</option>
+          <option value="P3">P3</option>
+          <option value="P4">P4</option>
+        </select>
+      </div>
+
+      <div className="overflow-x-auto">
+        <table className="w-full text-sm">
+          <thead>
+            <tr className="border-b border-gray-200 dark:border-gray-700">
+              <th className="text-left py-2 px-4 text-gray-500 dark:text-gray-400 font-medium">Priority</th>
+              <th className="text-left py-2 px-4 text-gray-500 dark:text-gray-400 font-medium">Message</th>
+              <th className="text-left py-2 px-4 text-gray-500 dark:text-gray-400 font-medium">Worker</th>
+              <th
+                className="text-right py-2 px-4 text-gray-500 dark:text-gray-400 font-medium cursor-pointer hover:text-gray-700 dark:hover:text-gray-200"
+                onClick={() => setSortField('occurrence_count')}
+              >
+                Count {sortField === 'occurrence_count' ? '↓' : ''}
+              </th>
+              <th
+                className="text-right py-2 px-4 text-gray-500 dark:text-gray-400 font-medium cursor-pointer hover:text-gray-700 dark:hover:text-gray-200"
+                onClick={() => setSortField('last_seen_at')}
+              >
+                Last Seen {sortField === 'last_seen_at' ? '↓' : ''}
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            {sorted.map((err) => (
+              <tr key={err.fingerprint} className="border-b border-gray-100 dark:border-gray-800 hover:bg-gray-50 dark:hover:bg-gray-700/50">
+                <td className="py-2 px-4">
+                  <span className={`text-xs px-1.5 py-0.5 rounded font-medium ${priorityColours[err.priority] ?? priorityColours.P4}`}>
+                    {err.priority}
+                  </span>
+                </td>
+                <td className="py-2 px-4 text-gray-900 dark:text-white max-w-md truncate">{err.message}</td>
+                <td className="py-2 px-4 text-gray-500 dark:text-gray-400 font-mono text-xs">{err.script_name}</td>
+                <td className="py-2 px-4 text-right text-gray-900 dark:text-white">{err.occurrence_count}</td>
+                <td className="py-2 px-4 text-right text-gray-500 dark:text-gray-400 text-xs">
+                  {new Date(err.last_seen_at).toLocaleDateString('en-AU', { day: 'numeric', month: 'short', hour: '2-digit', minute: '2-digit' })}
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+
+      {total > 20 && (
+        <div className="p-4 border-t border-gray-200 dark:border-gray-700 flex items-center justify-between">
+          <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/standard/dashboard/src/components/errors/index.ts

@@ -0,0 +1,2 @@
+export { ErrorsTable } from './ErrorsTable';
+export { ErrorStats } from './ErrorStats';

package/templates/standard/dashboard/src/components/health/DlqStatusCard.tsx

@@ -0,0 +1,52 @@
+import { useState, useEffect } from 'react';
+
+interface DlqStatus {
+  depth: number;
+  oldestAgeMinutes: number | null;
+  status: 'healthy' | 'warning' | 'critical' | 'unknown';
+}
+
+export function DlqStatusCard() {
+  const [data, setData] = useState<DlqStatus | null>(null);
+
+  useEffect(() => {
+    fetch('/api/health/dlq')
+      .then(res => res.json())
+      .then((dlq: DlqStatus) => setData(dlq))
+      .catch(() => {});
+  }, []);
+
+  const statusColour = data?.status === 'healthy'
+    ? 'text-green-600 dark:text-green-400'
+    : data?.status === 'warning'
+      ? 'text-yellow-600 dark:text-yellow-400'
+      : data?.status === 'critical'
+        ? 'text-red-600 dark:text-red-400'
+        : 'text-gray-500 dark:text-gray-400';
+
+  return (
+    <div className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 p-4">
+      <h3 className="text-sm font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wide mb-3">
+        Dead Letter Queue
+      </h3>
+      <div className="grid grid-cols-3 gap-4">
+        <div>
+          <div className="text-2xl font-bold text-gray-900 dark:text-white">{data?.depth ?? 0}</div>
+          <div className="text-xs text-gray-500 dark:text-gray-400">Pending</div>
+        </div>
+        <div>
+          <div className="text-2xl font-bold text-gray-900 dark:text-white">
+            {data?.oldestAgeMinutes != null ? `${data.oldestAgeMinutes}m` : '\u2014'}
+          </div>
+          <div className="text-xs text-gray-500 dark:text-gray-400">Oldest</div>
+        </div>
+        <div>
+          <div className={`text-2xl font-bold ${statusColour}`}>
+            {data?.status ?? 'Unknown'}
+          </div>
+          <div className="text-xs text-gray-500 dark:text-gray-400">Status</div>
+        </div>
+      </div>
+    </div>
+  );
+}

package/templates/standard/dashboard/src/components/health/HealthTabs.tsx

@@ -0,0 +1,86 @@
+import { useState, useEffect } from 'react';
+import { DlqStatusCard } from './DlqStatusCard';
+
+type Tab = 'overview' | 'workers' | 'queues' | 'storage';
+
+export function HealthTabs() {
+  const [activeTab, setActiveTab] = useState<Tab>('overview');
+  const [cbData, setCbData] = useState<Array<{
+    key: string;
+    feature: string;
+    status: string;
+    reason: string | null;
+  }>>([]);
+
+  useEffect(() => {
+    fetch('/api/usage/circuit-breakers')
+      .then(res => res.json())
+      .then((data: { breakers: typeof cbData }) => setCbData(data.breakers ?? []))
+      .catch(() => {});
+  }, []);
+
+  const tabs: { id: Tab; label: string }[] = [
+    { id: 'overview', label: 'Overview' },
+    { id: 'workers', label: 'Workers' },
+    { id: 'queues', label: 'Queues' },
+    { id: 'storage', label: 'Storage' },
+  ];
+
+  return (
+    <div>
+      <div className="border-b border-gray-200 dark:border-gray-700 mb-4">
+        <nav className="flex gap-4">
+          {tabs.map(tab => (
+            <button
+              key={tab.id}
+              onClick={() => setActiveTab(tab.id)}
+              className={`py-2 px-1 text-sm font-medium border-b-2 transition-colors ${
+                activeTab === tab.id
+                  ? 'border-blue-500 text-blue-600 dark:text-blue-400'
+                  : 'border-transparent text-gray-500 dark:text-gray-400 hover:text-gray-700 dark:hover:text-gray-300'
+              }`}
+            >
+              {tab.label}
+            </button>
+          ))}
+        </nav>
+      </div>
+
+      {activeTab === 'overview' && (
+        <div className="space-y-4">
+          <DlqStatusCard />
+          {/* Circuit Breakers */}
+          <div className="bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 p-4">
+            <h3 className="text-sm font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wide mb-3">
+              Circuit Breakers
+            </h3>
+            {cbData.length === 0 ? (
+              <p className="text-sm text-gray-500 dark:text-gray-400">No circuit breakers configured.</p>
+            ) : (
+              <div className="space-y-2">
+                {cbData.map(cb => (
+                  <div key={cb.key} className="flex items-center justify-between py-1">
+                    <span className="text-sm text-gray-900 dark:text-white">{cb.feature}</span>
+                    <span className={`text-xs px-2 py-0.5 rounded-full font-medium ${
+                      cb.status === 'active' ? 'bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400'
+                        : cb.status === 'warning' ? 'bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400'
+                          : 'bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400'
+                    }`}>
+                      {cb.status}
+                    </span>
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+      )}
+
+      {activeTab !== 'overview' && (
+        <div className="text-center py-8 text-gray-500 dark:text-gray-400">
+          <p>{activeTab} health details will appear here once monitoring data is collected.</p>
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/standard/dashboard/src/components/health/index.ts

@@ -0,0 +1,2 @@
+export { HealthTabs } from './HealthTabs';
+export { DlqStatusCard } from './DlqStatusCard';

package/templates/standard/dashboard/src/lib/errors.ts

@@ -0,0 +1,28 @@
+export interface ErrorOccurrence {
+  fingerprint: string;
+  message: string;
+  script_name: string;
+  priority: string;
+  occurrence_count: number;
+  status: string;
+  first_seen_at: string;
+  last_seen_at: string;
+  github_issue_url: string | null;
+}
+
+export interface ErrorStats {
+  byPriority: Record<string, number>;
+  byWorker: Array<{ script_name: string; count: number }>;
+  total: number;
+}
+
+export function getPriorityColour(priority: string): string {
+  const colours: Record<string, string> = {
+    P0: 'bg-red-100 text-red-800 dark:bg-red-900/50 dark:text-red-300',
+    P1: 'bg-orange-100 text-orange-800 dark:bg-orange-900/50 dark:text-orange-300',
+    P2: 'bg-yellow-100 text-yellow-800 dark:bg-yellow-900/50 dark:text-yellow-300',
+    P3: 'bg-blue-100 text-blue-800 dark:bg-blue-900/50 dark:text-blue-300',
+    P4: 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-300',
+  };
+  return colours[priority] ?? colours.P4;
+}

package/templates/standard/dashboard/src/pages/api/errors/index.ts

@@ -0,0 +1,58 @@
+import type { APIRoute } from 'astro';
+
+export const GET: APIRoute = async ({ locals, url }) => {
+  const db = (locals.runtime?.env as { PLATFORM_DB?: D1Database } | undefined)?.PLATFORM_DB;
+
+  if (!db) {
+    return new Response(JSON.stringify({ errors: [], total: 0 }), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  const page = parseInt(url.searchParams.get('page') ?? '1');
+  const limit = Math.min(parseInt(url.searchParams.get('limit') ?? '20'), 100);
+  const offset = (page - 1) * limit;
+  const priority = url.searchParams.get('priority');
+  const status = url.searchParams.get('status') ?? 'open';
+
+  try {
+    let query = `SELECT fingerprint, normalized_message as message, script_name, priority,
+                        occurrence_count, status, first_seen_at, last_seen_at, github_issue_url
+                 FROM error_occurrences WHERE status = ?`;
+    const params: unknown[] = [status];
+
+    if (priority) {
+      query += ` AND priority = ?`;
+      params.push(priority);
+    }
+
+    query += ` ORDER BY
+      CASE priority WHEN 'P0' THEN 1 WHEN 'P1' THEN 2 WHEN 'P2' THEN 3 WHEN 'P3' THEN 4 ELSE 5 END,
+      last_seen_at DESC
+      LIMIT ? OFFSET ?`;
+    params.push(limit, offset);
+
+    const errors = await db.prepare(query).bind(...params).all();
+
+    const countQuery = priority
+      ? `SELECT COUNT(*) as total FROM error_occurrences WHERE status = ? AND priority = ? LIMIT 1`
+      : `SELECT COUNT(*) as total FROM error_occurrences WHERE status = ? LIMIT 1`;
+    const countParams = priority ? [status, priority] : [status];
+    const countResult = await db.prepare(countQuery).bind(...countParams).first<{ total: number }>();
+
+    return new Response(
+      JSON.stringify({
+        errors: errors.results ?? [],
+        total: countResult?.total ?? 0,
+        page,
+        limit,
+      }),
+      { headers: { 'Content-Type': 'application/json', 'Cache-Control': 'max-age=30' } }
+    );
+  } catch {
+    return new Response(JSON.stringify({ errors: [], total: 0, error: 'Query failed' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/standard/dashboard/src/pages/api/errors/stats.ts

@@ -0,0 +1,55 @@
+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({ byPriority: {}, byWorker: [], total: 0 }), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const byPriority = await db
+      .prepare(
+        `SELECT priority, COUNT(*) as count
+         FROM error_occurrences WHERE status = 'open'
+         GROUP BY priority
+         LIMIT 10`
+      )
+      .all<{ priority: string; count: number }>();
+
+    const byWorker = await db
+      .prepare(
+        `SELECT script_name, COUNT(*) as count
+         FROM error_occurrences WHERE status = 'open'
+         GROUP BY script_name
+         ORDER BY count DESC
+         LIMIT 10`
+      )
+      .all<{ script_name: string; count: number }>();
+
+    const total = await db
+      .prepare(`SELECT COUNT(*) as count FROM error_occurrences WHERE status = 'open' LIMIT 1`)
+      .first<{ count: number }>();
+
+    const priorityMap: Record<string, number> = {};
+    for (const row of byPriority.results ?? []) {
+      priorityMap[row.priority] = row.count;
+    }
+
+    return new Response(
+      JSON.stringify({
+        byPriority: priorityMap,
+        byWorker: byWorker.results ?? [],
+        total: total?.count ?? 0,
+      }),
+      { headers: { 'Content-Type': 'application/json', 'Cache-Control': 'max-age=30' } }
+    );
+  } catch {
+    return new Response(JSON.stringify({ byPriority: {}, byWorker: [], total: 0 }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/standard/dashboard/src/pages/api/health/dlq.ts

@@ -0,0 +1,43 @@
+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({ depth: 0, oldestAge: null, status: 'unknown' }), {
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const depth = await db
+      .prepare(`SELECT COUNT(*) as count FROM dlq_messages WHERE status = 'pending' LIMIT 1`)
+      .first<{ count: number }>();
+
+    const oldest = await db
+      .prepare(
+        `SELECT MIN(received_at) as oldest
+         FROM dlq_messages WHERE status = 'pending'
+         LIMIT 1`
+      )
+      .first<{ oldest: string | null }>();
+
+    let oldestAgeMinutes: number | null = null;
+    if (oldest?.oldest) {
+      oldestAgeMinutes = Math.round((Date.now() - new Date(oldest.oldest).getTime()) / 60000);
+    }
+
+    const dlqDepth = depth?.count ?? 0;
+    const status = dlqDepth === 0 ? 'healthy' : dlqDepth < 100 ? 'warning' : 'critical';
+
+    return new Response(
+      JSON.stringify({ depth: dlqDepth, oldestAgeMinutes, status }),
+      { headers: { 'Content-Type': 'application/json', 'Cache-Control': 'max-age=30' } }
+    );
+  } catch {
+    return new Response(JSON.stringify({ depth: 0, oldestAgeMinutes: null, status: 'unknown' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/standard/dashboard/src/pages/errors.astro

@@ -0,0 +1,13 @@
+---
+import DashboardLayout from '../../layouts/DashboardLayout.astro';
+import { ErrorsTable } from '../../components/errors/ErrorsTable';
+import { ErrorStats } from '../../components/errors/ErrorStats';
+---
+
+<DashboardLayout title="Errors">
+  <div class="max-w-7xl mx-auto space-y-6">
+    <h2 class="text-xl font-bold text-gray-900 dark:text-white mb-4">Error Management</h2>
+    <ErrorStats client:load />
+    <ErrorsTable client:load />
+  </div>
+</DashboardLayout>

package/templates/standard/dashboard/src/pages/health.astro

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

package/templates/standard/migrations/009_topology_mapper.sql

@@ -0,0 +1,65 @@
+-- Migration 009: Topology Mapper Tables
+--
+-- Purpose: Infrastructure topology tracking for the platform-mapper worker.
+-- Stores discovered Cloudflare resources, service connections, and historical snapshots.
+--
+-- Tables:
+--   services                — Discovered/defined infrastructure services
+--   connections             — Relationships between services
+--   topology_snapshots      — Historical topology snapshots for trend analysis
+--
+-- Tier: Standard+
+-- Worker: platform-mapper (15-minute cron)
+
+-- Services discovered or defined
+CREATE TABLE IF NOT EXISTS services (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,                    -- 'cloudflare-worker', 'cloudflare-pages', etc.
+  tier INTEGER NOT NULL,                 -- 0 (critical), 1 (high), 2 (medium)
+  status TEXT NOT NULL,                  -- 'deployed', 'partial', 'not-deployed', 'unknown'
+  version TEXT,
+  health_endpoint TEXT,
+  health_status TEXT DEFAULT 'unknown',  -- 'up', 'degraded', 'down', 'unknown'
+  last_seen TIMESTAMP,
+  metadata TEXT,                         -- JSON: Type-specific data
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_services_type ON services(type);
+CREATE INDEX IF NOT EXISTS idx_services_tier ON services(tier);
+CREATE INDEX IF NOT EXISTS idx_services_status ON services(status);
+CREATE INDEX IF NOT EXISTS idx_services_health ON services(health_status);
+
+-- Connections between services
+CREATE TABLE IF NOT EXISTS connections (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_service TEXT NOT NULL,
+  to_service TEXT NOT NULL,
+  connection_type TEXT NOT NULL,          -- 'webhook', 'api', 'data-flow', 'deployment', 'service-binding'
+  protocol TEXT,                          -- 'https', 'rest', 'queue', etc.
+  status TEXT NOT NULL,                   -- 'active', 'planned', 'not-integrated', 'broken'
+  metadata TEXT,                          -- JSON: Connection-specific data
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE (from_service, to_service, connection_type),
+  FOREIGN KEY (from_service) REFERENCES services(id),
+  FOREIGN KEY (to_service) REFERENCES services(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_connections_from ON connections(from_service);
+CREATE INDEX IF NOT EXISTS idx_connections_to ON connections(to_service);
+CREATE INDEX IF NOT EXISTS idx_connections_status ON connections(status);
+
+-- Historical snapshots (for topology change tracking)
+CREATE TABLE IF NOT EXISTS topology_snapshots (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  data TEXT NOT NULL,                     -- JSON: Full topology snapshot
+  change_summary TEXT,                    -- What changed since last snapshot
+  service_count INTEGER,
+  connection_count INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_snapshots_timestamp ON topology_snapshots(timestamp);

package/templates/standard/workers/lib/error-collector/email-health-alerts.ts

@@ -198,14 +198,48 @@ export async function processEmailHealthAlerts(
     }
 
     try {
-      // Create a focused issue for this specific check failure
+      const issueTitle = `Email Health: ${brandName} ${failure.check_type} failing`;
+
+      // Search for an existing OPEN issue before creating a new one.
+      // This prevents daily duplicate issues when a problem persists across days.
+      const openIssues = await github.searchIssues(
+        owner,
+        repo,
+        `"${issueTitle}" is:open label:cf:email-health`
+      );
+
+      if (openIssues.length > 0) {
+        const existing = openIssues[0];
+        await github.addComment(
+          owner,
+          repo,
+          existing.number,
+          `### Still failing (${getDateKey()})\n\n` +
+            `Check \`${failure.check_type}\` continues to fail: ${failure.error_msg}\n\n` +
+            `Run ID: \`${event.run_id}\``
+        );
+        await setDedup(env.PLATFORM_CACHE, event.brand_id, failure.check_type, existing.number);
+
+        console.log(
+          `Commented on existing email health issue #${existing.number} for ${event.brand_id}:${failure.check_type}`
+        );
+
+        results.skipped++;
+        results.skippedChecks.push({
+          check_type: failure.check_type,
+          reason: `Commented on existing issue #${existing.number}`,
+        });
+        continue;
+      }
+
+      // No existing open issue — create a new one
       const issue = await github.createIssue({
         owner,
         repo,
-        title: `Email Health: ${brandName} ${failure.check_type} failing`,
+        title: issueTitle,
         body: formatIssueBody({
           ...event,
-          failures: [failure], // Only include this specific failure
+          failures: [failure],
         }),
         labels: EMAIL_HEALTH_LABELS,
       });

package/templates/standard/workers/lib/error-collector/gap-alerts.ts

@@ -237,7 +237,38 @@ export async function processGapAlert(
   const github = new GitHubClient(env);
 
   try {
-    // Create the issue
+    // Search for an existing OPEN gap alert issue before creating a new one.
+    // This prevents daily duplicate issues when coverage stays below threshold.
+    const openIssues = await github.searchIssues(
+      owner,
+      repo,
+      `"Data Coverage Gap: ${event.project}" is:open label:cf:gap-alert`
+    );
+
+    if (openIssues.length > 0) {
+      const existing = openIssues[0];
+      await github.addComment(
+        owner,
+        repo,
+        existing.number,
+        `### Coverage still below threshold (${getDateKey()})\n\n` +
+          `Coverage: **${event.coveragePct}%** (threshold: 90%)\n` +
+          `Hours with data: ${event.hoursWithData}/${event.expectedHours}\n` +
+          `Missing hours: ${event.missingHours.length}`
+      );
+      await setGapAlertDedup(env.PLATFORM_CACHE, event.project, existing.number);
+
+      console.log(
+        `Commented on existing gap alert issue #${existing.number} for ${event.project}`
+      );
+
+      return {
+        processed: false,
+        skipped: `Commented on existing issue #${existing.number}`,
+      };
+    }
+
+    // No existing open issue — create a new one
     const issue = await github.createIssue({
       owner,
       repo,