@littlebearapps/platform-admin-sdk 2.1.0 → 2.2.0

package/templates/full/dashboard/src/components/search/SearchResultGroup.tsx

@@ -0,0 +1,46 @@
+/**
+ * SearchResultGroup Component
+ *
+ * Renders a group header for search results by content type.
+ *
+ * @module dashboard/components/search/SearchResultGroup
+ * @created 2026-02-03
+ * @task task-303.3
+ */
+
+import type { SearchContentType } from '../../lib/search/types';
+
+/** Labels for each content type */
+const CONTENT_TYPE_LABELS: Record<SearchContentType, string> = {
+  error: 'Errors',
+  pattern: 'Patterns',
+  setting: 'Settings',
+  page: 'Pages',
+  service: 'Services',
+  opportunity: 'Opportunities',
+  draft: 'Drafts',
+  project: 'Projects',
+};
+
+interface SearchResultGroupProps {
+  contentType: SearchContentType;
+  count: number;
+}
+
+export function SearchResultGroup({
+  contentType,
+  count,
+}: SearchResultGroupProps): JSX.Element {
+  const label = CONTENT_TYPE_LABELS[contentType] || contentType;
+
+  return (
+    <div className="px-3 py-2 flex items-center justify-between">
+      <span className="text-xs font-semibold text-gray-500 dark:text-gray-400 uppercase tracking-wider">
+        {label}
+      </span>
+      <span className="text-xs text-gray-400 dark:text-gray-500">
+        {count} {count === 1 ? 'result' : 'results'}
+      </span>
+    </div>
+  );
+}

package/templates/full/dashboard/src/components/search/SearchResultItem.tsx

@@ -0,0 +1,212 @@
+/**
+ * SearchResultItem Component
+ *
+ * Renders a single search result with icon, title, snippet, and content type indicator.
+ *
+ * @module dashboard/components/search/SearchResultItem
+ * @created 2026-02-03
+ * @task task-303.3
+ */
+
+import type { SearchResult, SearchContentType } from '../../lib/search/types';
+
+/** Icons for each content type */
+const CONTENT_TYPE_ICONS: Record<SearchContentType, JSX.Element> = {
+  error: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+    </svg>
+  ),
+  pattern: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z" />
+    </svg>
+  ),
+  setting: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+    </svg>
+  ),
+  page: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+    </svg>
+  ),
+  service: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01" />
+    </svg>
+  ),
+  opportunity: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
+    </svg>
+  ),
+  draft: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+    </svg>
+  ),
+  project: (
+    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
+    </svg>
+  ),
+};
+
+/** Colour classes for each content type */
+const CONTENT_TYPE_COLORS: Record<SearchContentType, string> = {
+  error: 'text-red-500 dark:text-red-400 bg-red-100 dark:bg-red-900/30',
+  pattern: 'text-purple-500 dark:text-purple-400 bg-purple-100 dark:bg-purple-900/30',
+  setting: 'text-gray-500 dark:text-gray-400 bg-gray-100 dark:bg-gray-700',
+  page: 'text-blue-500 dark:text-blue-400 bg-blue-100 dark:bg-blue-900/30',
+  service: 'text-green-500 dark:text-green-400 bg-green-100 dark:bg-green-900/30',
+  opportunity: 'text-orange-500 dark:text-orange-400 bg-orange-100 dark:bg-orange-900/30',
+  draft: 'text-cyan-500 dark:text-cyan-400 bg-cyan-100 dark:bg-cyan-900/30',
+  project: 'text-indigo-500 dark:text-indigo-400 bg-indigo-100 dark:bg-indigo-900/30',
+};
+
+/** Labels for each content type */
+const CONTENT_TYPE_LABELS: Record<SearchContentType, string> = {
+  error: 'Error',
+  pattern: 'Pattern',
+  setting: 'Setting',
+  page: 'Page',
+  service: 'Service',
+  opportunity: 'Opportunity',
+  draft: 'Draft',
+  project: 'Project',
+};
+
+interface SearchResultItemProps {
+  result: SearchResult;
+  isSelected: boolean;
+  query: string;
+  onClick: () => void;
+}
+
+export function SearchResultItem({
+  result,
+  isSelected,
+  query,
+  onClick,
+}: SearchResultItemProps): JSX.Element {
+  const icon = CONTENT_TYPE_ICONS[result.content_type] || CONTENT_TYPE_ICONS.page;
+  const colorClass = CONTENT_TYPE_COLORS[result.content_type] || CONTENT_TYPE_COLORS.page;
+  const label = CONTENT_TYPE_LABELS[result.content_type] || result.content_type;
+
+  // Highlight matching terms in the snippet - sanitized by only allowing alphanumeric matches wrapped in mark tags
+  const snippetText = result.snippet || result.content || '';
+  const highlightedParts = getHighlightedParts(snippetText, query);
+
+  return (
+    <a
+      href={result.url}
+      onClick={(e) => {
+        e.preventDefault();
+        onClick();
+      }}
+      className={`flex items-start gap-3 px-3 py-2 rounded-lg cursor-pointer transition-colors ${
+        isSelected
+          ? 'bg-blue-50 dark:bg-blue-900/30'
+          : 'hover:bg-gray-100 dark:hover:bg-gray-700'
+      }`}
+    >
+      {/* Icon */}
+      <span
+        className={`flex-shrink-0 w-8 h-8 rounded-lg flex items-center justify-center ${colorClass}`}
+      >
+        {icon}
+      </span>
+
+      {/* Content */}
+      <div className="flex-1 min-w-0">
+        <div className="flex items-center gap-2">
+          <span className="font-medium text-gray-900 dark:text-white truncate">
+            {result.title}
+          </span>
+          <span
+            className={`text-xs px-1.5 py-0.5 rounded ${colorClass}`}
+          >
+            {label}
+          </span>
+        </div>
+        {snippetText && (
+          <p className="text-sm text-gray-500 dark:text-gray-400 line-clamp-2 mt-0.5">
+            {highlightedParts.map((part, i) =>
+              part.isMatch ? (
+                <mark key={i} className="bg-yellow-200 dark:bg-yellow-800 rounded px-0.5">
+                  {part.text}
+                </mark>
+              ) : (
+                <span key={i}>{part.text}</span>
+              )
+            )}
+          </p>
+        )}
+        {result.project && (
+          <span className="text-xs text-gray-400 dark:text-gray-500">
+            {result.project}
+          </span>
+        )}
+      </div>
+
+      {/* Arrow indicator when selected */}
+      {isSelected && (
+        <kbd className="flex-shrink-0 text-xs text-gray-400 border border-gray-200 dark:border-gray-600 rounded px-1.5 py-0.5">
+          ↵
+        </kbd>
+      )}
+    </a>
+  );
+}
+
+interface HighlightPart {
+  text: string;
+  isMatch: boolean;
+}
+
+/**
+ * Get highlighted parts of text matching search terms
+ * Returns array of parts with isMatch flag for safe rendering
+ */
+function getHighlightedParts(text: string, query: string): HighlightPart[] {
+  if (!text || !query.trim()) {
+    return [{ text, isMatch: false }];
+  }
+
+  const terms = query
+    .toLowerCase()
+    .split(/\s+/)
+    .filter((t) => t.length > 2);
+
+  if (terms.length === 0) {
+    return [{ text, isMatch: false }];
+  }
+
+  // Escape special regex characters
+  const escaped = terms.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+  const pattern = new RegExp(`(${escaped.join('|')})`, 'gi');
+
+  const parts: HighlightPart[] = [];
+  let lastIndex = 0;
+  let match: RegExpExecArray | null;
+
+  while ((match = pattern.exec(text)) !== null) {
+    // Add non-matching text before this match
+    if (match.index > lastIndex) {
+      parts.push({ text: text.slice(lastIndex, match.index), isMatch: false });
+    }
+    // Add the matching text
+    parts.push({ text: match[0], isMatch: true });
+    lastIndex = pattern.lastIndex;
+  }
+
+  // Add remaining text after last match
+  if (lastIndex < text.length) {
+    parts.push({ text: text.slice(lastIndex), isMatch: false });
+  }
+
+  return parts.length > 0 ? parts : [{ text, isMatch: false }];
+}

package/templates/full/dashboard/src/pages/api/patterns/[id]/approve.ts

@@ -0,0 +1,49 @@
+/**
+ * POST /api/patterns/:id/approve - Proxy to pattern-discovery /suggestions/:id?action=approve
+ * Approves a pending pattern suggestion
+ */
+import type { APIRoute } from 'astro';
+
+interface Env {
+  PATTERN_DISCOVERY_API?: Fetcher;
+}
+
+export const POST: APIRoute = async ({ locals, params, url }) => {
+  const api = (locals.runtime?.env as Env)?.PATTERN_DISCOVERY_API;
+
+  if (!api) {
+    return new Response(JSON.stringify({ error: 'Pattern Discovery API not configured' }), {
+      status: 503,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  const { id } = params;
+  if (!id) {
+    return new Response(JSON.stringify({ error: 'Missing suggestion ID' }), {
+      status: 400,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const by = url.searchParams.get('by') || 'dashboard';
+
+    const response = await api.fetch(
+      `https://pattern-discovery.littlebearapps.workers.dev/suggestions/${id}?action=approve&by=${by}`,
+      { method: 'POST' }
+    );
+
+    const data = await response.json();
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  } catch (error) {
+    console.error('Error approving suggestion:', error);
+    return new Response(JSON.stringify({ error: 'Failed to approve suggestion' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/full/dashboard/src/pages/api/patterns/[id]/reject.ts

@@ -0,0 +1,50 @@
+/**
+ * POST /api/patterns/:id/reject - Proxy to pattern-discovery /suggestions/:id?action=reject
+ * Rejects a pending pattern suggestion
+ */
+import type { APIRoute } from 'astro';
+
+interface Env {
+  PATTERN_DISCOVERY_API?: Fetcher;
+}
+
+export const POST: APIRoute = async ({ locals, params, url }) => {
+  const api = (locals.runtime?.env as Env)?.PATTERN_DISCOVERY_API;
+
+  if (!api) {
+    return new Response(JSON.stringify({ error: 'Pattern Discovery API not configured' }), {
+      status: 503,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  const { id } = params;
+  if (!id) {
+    return new Response(JSON.stringify({ error: 'Missing suggestion ID' }), {
+      status: 400,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const by = url.searchParams.get('by') || 'dashboard';
+    const reason = url.searchParams.get('reason') || 'Rejected via dashboard';
+
+    const response = await api.fetch(
+      `https://pattern-discovery.littlebearapps.workers.dev/suggestions/${id}?action=reject&by=${by}&reason=${encodeURIComponent(reason)}`,
+      { method: 'POST' }
+    );
+
+    const data = await response.json();
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  } catch (error) {
+    console.error('Error rejecting suggestion:', error);
+    return new Response(JSON.stringify({ error: 'Failed to reject suggestion' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/full/dashboard/src/pages/api/reports/digests/stats.ts

@@ -0,0 +1,38 @@
+/**
+ * GET /api/reports/digests/stats - Proxy to error-collector /digests/stats
+ */
+import type { APIRoute } from 'astro';
+
+interface Env {
+  ERROR_COLLECTOR_API?: Fetcher;
+}
+
+export const GET: APIRoute = async ({ locals }) => {
+  const api = (locals.runtime?.env as Env)?.ERROR_COLLECTOR_API;
+
+  if (!api) {
+    return new Response(JSON.stringify({ error: 'Error Collector API not configured' }), {
+      status: 503,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const response = await api.fetch(
+      'https://error-collector.littlebearapps.workers.dev/digests/stats',
+      { method: 'GET' }
+    );
+
+    const data = await response.json();
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  } catch (error) {
+    console.error('Error fetching digest stats:', error);
+    return new Response(JSON.stringify({ error: 'Failed to fetch digest stats' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/full/dashboard/src/pages/api/reports/digests.ts

@@ -0,0 +1,39 @@
+/**
+ * GET /api/reports/digests - Proxy to error-collector /digests
+ */
+import type { APIRoute } from 'astro';
+
+interface Env {
+  ERROR_COLLECTOR_API?: Fetcher;
+}
+
+export const GET: APIRoute = async ({ request, locals }) => {
+  const api = (locals.runtime?.env as Env)?.ERROR_COLLECTOR_API;
+
+  if (!api) {
+    return new Response(JSON.stringify({ error: 'Error Collector API not configured' }), {
+      status: 503,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const url = new URL(request.url);
+    const response = await api.fetch(
+      `https://error-collector.littlebearapps.workers.dev/digests${url.search}`,
+      { method: 'GET' }
+    );
+
+    const data = await response.json();
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  } catch (error) {
+    console.error('Error fetching digests:', error);
+    return new Response(JSON.stringify({ error: 'Failed to fetch digests' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/full/dashboard/src/pages/api/search/reindex/[type].ts

@@ -0,0 +1,56 @@
+/**
+ * Reindex API Proxy
+ *
+ * Proxies reindex requests to platform-search worker.
+ *
+ * @module dashboard/pages/api/search/reindex
+ * @created 2026-02-03
+ * @task task-303.3
+ */
+
+import type { APIRoute } from 'astro';
+
+/**
+ * POST /api/search/reindex/:type - Reindex all documents of a content type
+ */
+export const POST: APIRoute = async ({ params, locals }) => {
+  const api = (locals.runtime?.env as { SEARCH_API?: Fetcher })?.SEARCH_API;
+  const { type } = params;
+
+  if (!api) {
+    return new Response(JSON.stringify({ error: 'Search API not available' }), {
+      status: 503,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  if (!type) {
+    return new Response(JSON.stringify({ error: 'Content type required' }), {
+      status: 400,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  try {
+    const response = await api.fetch(
+      new Request(
+        `https://platform-search.littlebearapps.workers.dev/search/reindex/${encodeURIComponent(type)}`,
+        {
+          method: 'POST',
+        }
+      )
+    );
+
+    const data = await response.json();
+    return new Response(JSON.stringify(data), {
+      status: response.status,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  } catch (error) {
+    console.error('Reindex error:', error);
+    return new Response(JSON.stringify({ error: 'Failed to reindex content type' }), {
+      status: 500,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+};

package/templates/full/dashboard/src/pages/api/test-reports/[id].ts

@@ -0,0 +1,102 @@
+/**
+ * Test Reports API Endpoint
+ *
+ * Serves HTML test reports from KV storage
+ * Reports are stored by platform-ingest-tester worker
+ * TTL: 7 days (passes) or 90 days (failures)
+ */
+
+export const GET = async ({ params, locals }: any) => {
+  const { id: runId } = params;
+  const env = locals.runtime.env;
+
+  if (!runId) {
+    return new Response(
+      JSON.stringify({
+        error: 'Missing run ID',
+        message: 'Run ID is required',
+      }),
+      {
+        status: 400,
+        headers: { 'Content-Type': 'application/json' },
+      }
+    );
+  }
+
+  try {
+    // First, get the run from D1 to find the KV key
+    const run = await env.PLATFORM_DB.prepare(
+      `SELECT id, project, kv_report_key, timestamp, pass_rate
+       FROM runs
+       WHERE id = ?`
+    )
+      .bind(runId)
+      .first();
+
+    if (!run) {
+      return new Response(
+        JSON.stringify({
+          error: 'Run not found',
+          message: `No test run found with ID: ${runId}`,
+        }),
+        {
+          status: 404,
+          headers: { 'Content-Type': 'application/json' },
+        }
+      );
+    }
+
+    if (!run.kv_report_key) {
+      return new Response(
+        JSON.stringify({
+          error: 'Report not available',
+          message: 'HTML report was not uploaded for this run',
+        }),
+        {
+          status: 404,
+          headers: { 'Content-Type': 'application/json' },
+        }
+      );
+    }
+
+    // Fetch HTML report from KV
+    const htmlReport = await env.PLATFORM_CACHE.get(run.kv_report_key);
+
+    if (!htmlReport) {
+      return new Response(
+        JSON.stringify({
+          error: 'Report expired',
+          message: 'HTML report has expired or been deleted (TTL: 7d for passes, 90d for failures)',
+        }),
+        {
+          status: 410, // Gone
+          headers: { 'Content-Type': 'application/json' },
+        }
+      );
+    }
+
+    // Return HTML report
+    return new Response(htmlReport, {
+      headers: {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Cache-Control': 'public, max-age=3600', // Cache for 1 hour
+        'X-Run-ID': runId,
+        'X-Project': run.project as string,
+        'X-Timestamp': run.timestamp as string,
+      },
+    });
+  } catch (error: any) {
+    console.error('Failed to fetch test report:', error);
+
+    return new Response(
+      JSON.stringify({
+        error: 'Internal server error',
+        message: error.message,
+      }),
+      {
+        status: 500,
+        headers: { 'Content-Type': 'application/json' },
+      }
+    );
+  }
+};