@littlebearapps/platform-admin-sdk 2.0.0 → 2.2.0

package/templates/full/dashboard/src/lib/notifications/types.ts.hbs

@@ -0,0 +1,97 @@
+/**
+ * Notification Types
+ *
+ * TypeScript types for the platform notifications system.
+ *
+ * @module dashboard/lib/notifications/types
+ */
+
+/** Notification category (visual styling) */
+export type NotificationCategory = 'error' | 'warning' | 'info' | 'success';
+
+/** Notification priority (sorting/filtering) */
+export type NotificationPriority = 'critical' | 'high' | 'medium' | 'low' | 'info';
+
+/** Source systems that create notifications */
+export type NotificationSource =
+  | 'error-collector'
+  | 'pattern-discovery'
+  | 'circuit-breaker'
+  | 'usage'
+  | 'gatus'
+  | 'system';
+
+/** Project scope for notifications */
+export type NotificationProject = 'platform' | '{{projectSlug}}' | null;
+
+/** A single notification */
+export interface Notification {
+  id: string;
+  category: NotificationCategory;
+  source: NotificationSource | string;
+  source_id: string | null;
+  title: string;
+  description: string | null;
+  priority: NotificationPriority;
+  action_url: string | null;
+  action_label: string | null;
+  project: NotificationProject;
+  created_at: number;
+  expires_at: number | null;
+  is_read?: boolean;
+}
+
+/** Notification list response */
+export interface NotificationListResponse {
+  notifications: Notification[];
+  count: number;
+  offset: number;
+  limit: number;
+}
+
+/** Unread count response */
+export interface UnreadCountResponse {
+  count: number;
+}
+
+/** Mark as read response */
+export interface MarkReadResponse {
+  success: boolean;
+  id?: string;
+  marked_count?: number;
+}
+
+/** Digest frequency options */
+export type DigestFrequency = 'realtime' | 'hourly' | 'daily' | 'weekly';
+
+/** User notification preferences */
+export interface NotificationPreferences {
+  email_enabled: boolean;
+  slack_enabled: boolean;
+  in_app_enabled: boolean;
+  digest_frequency: DigestFrequency;
+  muted_sources: string[];
+}
+
+/** Request to create a notification */
+export interface CreateNotificationRequest {
+  category: NotificationCategory;
+  source: NotificationSource | string;
+  source_id?: string;
+  title: string;
+  description?: string;
+  priority?: NotificationPriority;
+  action_url?: string;
+  action_label?: string;
+  project?: NotificationProject;
+  expires_at?: number;
+}
+
+/** Query parameters for listing notifications */
+export interface NotificationQueryParams {
+  project?: string;
+  source?: string;
+  category?: NotificationCategory;
+  limit?: number;
+  offset?: number;
+}

package/templates/full/dashboard/src/lib/patterns/api.ts

@@ -0,0 +1,120 @@
+/**
+ * Pattern Discovery API Client
+ * Client functions for interacting with the pattern discovery API
+ */
+
+import type {
+  PatternStats,
+  PatternsResponse,
+  SuggestionsResponse,
+  ActionResponse,
+  DiscoveryResult,
+} from './types';
+
+const BASE_URL = '/api/patterns';
+
+/**
+ * Fetch approved patterns with match stats
+ */
+export async function fetchPatterns(
+  limit: number = 50,
+  offset: number = 0
+): Promise<PatternsResponse> {
+  const response = await fetch(`${BASE_URL}?limit=${limit}&offset=${offset}`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch patterns: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Fetch pattern statistics summary
+ */
+export async function fetchPatternStats(): Promise<PatternStats> {
+  const response = await fetch(`${BASE_URL}/stats`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch pattern stats: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Fetch pending suggestions for review
+ * Note: This now also includes shadow patterns that have review_context
+ */
+export async function fetchSuggestions(limit: number = 20): Promise<SuggestionsResponse> {
+  const response = await fetch(`${BASE_URL}/suggestions?limit=${limit}`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch suggestions: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Fetch shadow patterns that are ready for review (have review_context)
+ */
+export async function fetchReadyForReview(limit: number = 20): Promise<SuggestionsResponse> {
+  const response = await fetch(`${BASE_URL}/ready-for-review?limit=${limit}`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch ready for review: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Approve a pending suggestion
+ */
+export async function approveSuggestion(
+  id: string,
+  by: string = 'dashboard'
+): Promise<ActionResponse> {
+  const response = await fetch(`${BASE_URL}/${id}/approve?by=${encodeURIComponent(by)}`, {
+    method: 'POST',
+  });
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    throw new Error(data.error || `Failed to approve suggestion: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Reject a pending suggestion
+ */
+export async function rejectSuggestion(
+  id: string,
+  reason: string,
+  by: string = 'dashboard'
+): Promise<ActionResponse> {
+  const response = await fetch(
+    `${BASE_URL}/${id}/reject?by=${encodeURIComponent(by)}&reason=${encodeURIComponent(reason)}`,
+    { method: 'POST' }
+  );
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    throw new Error(data.error || `Failed to reject suggestion: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Refresh the KV cache of approved patterns
+ */
+export async function refreshPatternCache(): Promise<{ status: string }> {
+  const response = await fetch(`${BASE_URL}/cache-refresh`, { method: 'POST' });
+  if (!response.ok) {
+    throw new Error(`Failed to refresh cache: ${response.statusText}`);
+  }
+  return response.json();
+}
+
+/**
+ * Manually trigger pattern discovery
+ */
+export async function runDiscovery(): Promise<DiscoveryResult> {
+  const response = await fetch(`${BASE_URL}/discover`);
+  if (!response.ok) {
+    throw new Error(`Failed to run discovery: ${response.statusText}`);
+  }
+  return response.json();
+}

package/templates/full/dashboard/src/lib/patterns/types.ts

@@ -0,0 +1,127 @@
+/**
+ * Pattern Discovery Types
+ * TypeScript types for the pattern discovery dashboard
+ */
+
+export type PatternType = 'contains' | 'startsWith' | 'statusCode' | 'regex';
+export type PatternScope = 'global' | 'script';
+export type SuggestionStatus =
+  | 'pending'
+  | 'shadow'
+  | 'approved'
+  | 'stale'
+  | 'rejected'
+  | 'disabled';
+export type PatternSource = 'ai-discovered' | 'static-import' | 'manual';
+
+/** Review context for patterns ready for human approval */
+export interface PatternReviewContext {
+  // Match evidence
+  totalMatches: number;
+  matchesByProject: Record<string, number>;
+  matchesByScript: Record<string, number>;
+  sampleMessages: string[];
+  distinctDays: number;
+  firstMatchAt: number | null;
+  lastMatchAt: number | null;
+  // Evaluation metadata
+  evaluatedAt: number;
+  recommendation: 'likely-approve' | 'needs-investigation' | 'likely-reject';
+  reasoning: string;
+  shadowMatchCount: number;
+  matchSpreadDays: number;
+  matchRate: number;
+  // AI-generated explainer (optional)
+  aiExplainer?: string | null;
+  whatItCatches?: string | null;
+  whyTransient?: string | null;
+  affectedAreas?: string | null;
+  concerns?: string[];
+}
+
+export interface PatternSuggestion {
+  id: string;
+  patternType: PatternType;
+  patternValue: string;
+  category: string;
+  scope: PatternScope;
+  confidenceScore: number;
+  sampleMessages: string[];
+  aiReasoning: string;
+  clusterId: string | null;
+  status: SuggestionStatus;
+  reviewedBy: string | null;
+  reviewedAt: number | null;
+  rejectionReason: string | null;
+  backtestMatchCount: number | null;
+  backtestTotalErrors: number | null;
+  backtestMatchRate: number | null;
+  // Shadow mode tracking
+  shadowModeStart: number | null;
+  shadowModeEnd: number | null;
+  shadowModeMatches: number;
+  shadowMatchDays: string[];
+  // Lifecycle
+  enabledAt: number | null;
+  disabledAt: number | null;
+  lastMatchedAt: number | null;
+  matchCount: number;
+  // Self-tuning fields
+  isProtected: boolean;
+  source: PatternSource;
+  originalRegex: string | null;
+  // Review context for human approval (populated when ready for review)
+  reviewContext?: PatternReviewContext | null;
+  // Timestamps
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface PatternStats {
+  pendingCount: number;
+  shadowCount: number;
+  approvedCount: number;
+  staleCount: number;
+  rejectedCount: number;
+  disabledCount: number;
+  protectedCount: number;
+  staticCount: number;
+  totalMatches: number;
+  lastDiscoveryRun: number | null;
+  activeCategories: string[];
+}
+
+export interface DiscoveryResult {
+  runId: string;
+  runAt: number;
+  clustersFound: number;
+  clustersProcessed: number;
+  suggestionsCreated: number;
+  errors: string[];
+}
+
+export interface ShadowEvaluationResult {
+  evaluated: number;
+  promoted: number;
+  demoted: number;
+  enteredShadow: number;
+  staleDetected: number;
+}
+
+export interface PatternsResponse {
+  patterns: PatternSuggestion[];
+  count: number;
+  limit: number;
+  offset: number;
+}
+
+export interface SuggestionsResponse {
+  suggestions: PatternSuggestion[];
+  count: number;
+}
+
+export interface ActionResponse {
+  success: boolean;
+  action: 'approved' | 'rejected' | 'entered-shadow';
+  error?: string;
+}

package/templates/full/dashboard/src/lib/reports/types.ts

@@ -0,0 +1,231 @@
+/**
+ * Reports Types
+ * Types for the Reports section including warning digests
+ */
+
+// ============================================================================
+// Warning Digest Types
+// ============================================================================
+
+export interface WarningDigest {
+  id: string;
+  digest_date: string;
+  script_name: string;
+  fingerprint: string;
+  normalized_message: string;
+  github_repo: string;
+  github_issue_number: number | null;
+  github_issue_url: string | null;
+  occurrence_count: number;
+  first_occurrence_at: number;
+  last_occurrence_at: number;
+  created_at: number;
+  updated_at: number;
+}
+
+export interface DigestFilter {
+  script?: string;
+  days?: number;
+  limit?: number;
+  offset?: number;
+}
+
+export interface DigestListResponse {
+  digests: WarningDigest[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+
+// ============================================================================
+// Digest Statistics Types
+// ============================================================================
+
+export interface DateStat {
+  digest_date: string;
+  count: number;
+  occurrences: number;
+}
+
+export interface ScriptStat {
+  script_name: string;
+  count: number;
+  occurrences: number;
+}
+
+export interface RepoStat {
+  github_repo: string;
+  count: number;
+  occurrences: number;
+}
+
+export interface TopWarning {
+  normalized_message: string;
+  occurrences: number;
+  days_occurred: number;
+}
+
+export interface DigestStats {
+  byDate: DateStat[];
+  byScript: ScriptStat[];
+  byRepo: RepoStat[];
+  todayDigests: { count: number; occurrences: number };
+  yesterdayDigests: { count: number; occurrences: number };
+  totalDigests: number;
+  totalOccurrences: number;
+  topWarnings: TopWarning[];
+}
+
+// ============================================================================
+// Reports Hub Types
+// ============================================================================
+
+export type ReportType =
+  | 'warning-digests'
+  | 'sdk-audit'
+  | 'health-trends'
+  | 'circuit-breakers'
+  | 'gap-detection'
+  | 'feature-usage'
+  | 'error-trends'
+  | 'cost-trends';
+
+export interface ReportCard {
+  id: ReportType;
+  name: string;
+  description: string;
+  href: string;
+  icon: string;
+  status: 'available' | 'coming_soon';
+  category: 'operations' | 'costs' | 'quality' | 'compliance';
+}
+
+// ============================================================================
+// SDK Audit Report Types
+// ============================================================================
+
+export interface AuditResult {
+  id: number;
+  project: string;
+  status: 'HEALTHY' | 'ZOMBIE' | 'UNTRACKED' | 'BROKEN';
+  ai_judge_score: number | null;
+  ai_judge_summary: string | null;
+  sdk_score: number;
+  observability_score: number;
+  cost_score: number;
+  security_score: number;
+  created_at: number;
+}
+
+export interface HealthTrend {
+  id: number;
+  project: string;
+  audit_date: string;
+  composite_score: number;
+  sdk_score: number;
+  observability_score: number;
+  cost_score: number;
+  security_score: number;
+  trend: 'improving' | 'stable' | 'declining';
+  score_delta: number;
+}
+
+// ============================================================================
+// Circuit Breaker Report Types
+// ============================================================================
+
+export interface CircuitBreakerEvent {
+  id: number;
+  feature_id: string;
+  event_type: 'trip' | 'reset' | 'warning';
+  previous_state: string;
+  new_state: string;
+  reason: string;
+  threshold_value: number | null;
+  actual_value: number | null;
+  created_at: number;
+}
+
+export interface FeatureCircuitBreaker {
+  feature_id: string;
+  state: 'closed' | 'open' | 'half_open';
+  trip_count: number;
+  last_trip_at: number | null;
+  last_reset_at: number | null;
+}
+
+// ============================================================================
+// Gap Detection Report Types
+// ============================================================================
+
+export interface GapDetectionLog {
+  id: number;
+  detection_type: 'missing_hourly' | 'stale_project' | 'data_gap';
+  project: string | null;
+  resource_type: string | null;
+  gap_start: string;
+  gap_end: string | null;
+  gap_hours: number;
+  severity: 'low' | 'medium' | 'high';
+  resolved_at: number | null;
+  created_at: number;
+}
+
+// ============================================================================
+// Feature Usage Report Types
+// ============================================================================
+
+export interface FeatureUsageDaily {
+  id: number;
+  feature_id: string;
+  usage_date: string;
+  requests: number;
+  cpu_ms: number;
+  d1_reads: number;
+  d1_writes: number;
+  kv_reads: number;
+  kv_writes: number;
+  ai_neurons: number;
+  queue_messages: number;
+  estimated_cost_usd: number;
+}
+
+// ============================================================================
+// Error Trends Report Types
+// ============================================================================
+
+export interface ErrorTrendData {
+  date: string;
+  p0_count: number;
+  p1_count: number;
+  p2_count: number;
+  p3_count: number;
+  p4_count: number;
+  total_occurrences: number;
+  new_errors: number;
+  resolved_errors: number;
+}
+
+// ============================================================================
+// Cost Trends Report Types
+// ============================================================================
+
+export interface DailyCost {
+  date: string;
+  workers_cost: number;
+  d1_cost: number;
+  kv_cost: number;
+  r2_cost: number;
+  ai_cost: number;
+  queue_cost: number;
+  total_cost: number;
+}
+
+export interface ProjectCost {
+  project: string;
+  total_cost: number;
+  workers_cost: number;
+  d1_cost: number;
+  kv_cost: number;
+  percentage_of_total: number;
+}