@qontinui/shared-types 0.2.4 → 0.2.5

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   DEFAULT_SUMMARY_PROMPT,
   PHASE_INFO,
   STEP_TYPES
-} from "./chunk-ZK5MJEGT.js";
+} from "./chunk-CTBDIP7K.js";
 import {
   ActionStatus,
   ActionType,
@@ -11,7 +11,7 @@ import {
   RunStatus,
   RunType,
   ScreenshotType
-} from "./chunk-YXD4WCYQ.js";
+} from "./chunk-ZUZ3OLOH.js";
 
 // src/render-log.ts
 function isComponentRenderLog(entry) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/render-log.ts","../src/discovery.ts","../src/known-issues/index.ts"],"sourcesContent":["/**\r\n * Shared Render Log Types\r\n *\r\n * These types define the render logging schema used across:\r\n * - qontinui-runner (Tauri desktop app) - Component-level logging\r\n * - qontinui-web (Next.js web app) - Full DOM snapshot logging\r\n *\r\n * The runner reads both its own logs and web's logs for verification\r\n * in AI feedback loops.\r\n *\r\n * NOTE: Field names use snake_case to match Rust/Python JSON serialization.\r\n * This ensures compatibility across all services.\r\n */\r\n\r\n// =============================================================================\r\n// Common Types\r\n// =============================================================================\r\n\r\n/**\r\n * Trigger types for render log capture.\r\n * What caused the render log to be captured.\r\n */\r\nexport type RenderLogTrigger =\r\n  | \"mount\" // Component/page mounted\r\n  | \"navigation\" // Page navigation occurred\r\n  | \"mutation\" // DOM mutation detected (web only)\r\n  | \"data_update\" // Data changed (runner components)\r\n  | \"prop_change\" // Props changed (runner components)\r\n  | \"manual\" // Explicitly triggered capture\r\n  | \"interval\"; // Periodic capture\r\n\r\n/**\r\n * DOM mutation types (for web's MutationObserver).\r\n */\r\nexport type DomMutationType = \"childList\" | \"attributes\" | \"characterData\";\r\n\r\n// =============================================================================\r\n// Base Render Log Entry\r\n// =============================================================================\r\n\r\n/**\r\n * Base render log entry with common fields.\r\n * Extended by component logs and DOM snapshot logs.\r\n */\r\nexport interface RenderLogEntryBase {\r\n  /** Unique identifier for this log entry */\r\n  id: string;\r\n\r\n  /** Unix timestamp in milliseconds when the capture occurred */\r\n  timestamp: number;\r\n\r\n  /** What triggered this capture */\r\n  trigger: RenderLogTrigger;\r\n\r\n  /** Session ID for grouping related captures */\r\n  session_id?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Runner Component Render Log (Lightweight)\r\n// =============================================================================\r\n\r\n/**\r\n * Component-level render log entry.\r\n * Used by qontinui-runner to log what data components render.\r\n *\r\n * Components explicitly call logRender() with their rendered data.\r\n * This is lightweight and focused on verifying data display.\r\n */\r\nexport interface ComponentRenderLogEntry extends RenderLogEntryBase {\r\n  /** Type discriminator */\r\n  type: \"component\";\r\n\r\n  /** Component name (e.g., \"RunRecapTab\", \"StatusBanner\") */\r\n  component: string;\r\n\r\n  /** The data that was rendered (component-specific structure) */\r\n  data: Record<string, unknown>;\r\n\r\n  /** Sections that are visible/expanded in the component */\r\n  visible_sections?: string[];\r\n\r\n  /** Associated task run ID if applicable */\r\n  task_run_id?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Web DOM Snapshot Render Log (Comprehensive)\r\n// =============================================================================\r\n\r\n/**\r\n * Bounding rectangle for an element.\r\n */\r\nexport interface ElementRect {\r\n  x: number;\r\n  y: number;\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Single DOM element in a snapshot.\r\n * Recursive structure representing the DOM tree.\r\n */\r\nexport interface DomElementSnapshot {\r\n  /** HTML tag name (lowercase) */\r\n  tag: string;\r\n\r\n  /** Element ID if present */\r\n  id?: string;\r\n\r\n  /** CSS class list */\r\n  class_list: string[];\r\n\r\n  /** Direct text content (not from children) */\r\n  text_content?: string;\r\n\r\n  /** Length of innerHTML (for size estimation) */\r\n  inner_html_length?: number;\r\n\r\n  /** Bounding rectangle relative to viewport */\r\n  rect?: ElementRect;\r\n\r\n  /** Whether the element is visible */\r\n  is_visible: boolean;\r\n\r\n  /** Computed opacity */\r\n  opacity?: number;\r\n\r\n  /** Computed display value */\r\n  display?: string;\r\n\r\n  /** Key HTML attributes */\r\n  attributes: Record<string, string>;\r\n\r\n  /** Selected computed styles */\r\n  computed_styles?: Record<string, string>;\r\n\r\n  /** Child elements (recursive) */\r\n  children: DomElementSnapshot[];\r\n}\r\n\r\n/**\r\n * Form data extracted from the page.\r\n */\r\nexport interface FormSnapshot {\r\n  id?: string;\r\n  action?: string;\r\n  method?: string;\r\n  inputs: Array<{\r\n    type: string;\r\n    name: string;\r\n    value: string;\r\n  }>;\r\n}\r\n\r\n/**\r\n * Link data extracted from the page.\r\n */\r\nexport interface LinkSnapshot {\r\n  href: string;\r\n  text: string;\r\n}\r\n\r\n/**\r\n * Image data extracted from the page.\r\n */\r\nexport interface ImageSnapshot {\r\n  src: string;\r\n  alt?: string;\r\n  width?: number;\r\n  height?: number;\r\n}\r\n\r\n/**\r\n * Full DOM snapshot data.\r\n * Contains the entire page state for debugging.\r\n *\r\n * NOTE: The snapshot is stored as JSONB in the database, so field names\r\n * in the nested structure (root, forms, links, images) may vary by\r\n * implementation. The web frontend uses camelCase internally but that's\r\n * stored as-is in the JSONB field.\r\n */\r\nexport interface DomSnapshot {\r\n  /** Root element tree (document.body) */\r\n  root: DomElementSnapshot | null;\r\n\r\n  /** Total number of elements in the tree */\r\n  total_elements: number;\r\n\r\n  /** Concatenated visible text (truncated) */\r\n  visible_text?: string;\r\n\r\n  /** Forms on the page */\r\n  forms: FormSnapshot[];\r\n\r\n  /** Links on the page */\r\n  links: LinkSnapshot[];\r\n\r\n  /** Images on the page */\r\n  images: ImageSnapshot[];\r\n\r\n  /** JavaScript console errors captured */\r\n  errors: string[];\r\n\r\n  /** JavaScript console warnings captured */\r\n  warnings: string[];\r\n}\r\n\r\n/**\r\n * Full DOM snapshot render log entry.\r\n * Used by qontinui-web to capture entire page state.\r\n *\r\n * Automatically captured via MutationObserver on DOM changes.\r\n * Provides comprehensive debugging data.\r\n */\r\nexport interface DomSnapshotRenderLogEntry extends RenderLogEntryBase {\r\n  /** Type discriminator */\r\n  type: \"dom_snapshot\";\r\n\r\n  /** Current page URL */\r\n  page_url: string;\r\n\r\n  /** Page title */\r\n  page_title?: string;\r\n\r\n  /** Type of DOM mutation that triggered capture (if mutation trigger) */\r\n  mutation_type?: DomMutationType;\r\n\r\n  /** CSS selector of the element that was mutated */\r\n  target_selector?: string;\r\n\r\n  /** The full DOM snapshot */\r\n  snapshot: DomSnapshot;\r\n\r\n  /** Viewport dimensions */\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n\r\n  /** Scroll position */\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n\r\n  /** Time taken to capture the snapshot in milliseconds */\r\n  capture_duration_ms?: number;\r\n\r\n  /** Number of elements captured */\r\n  element_count?: number;\r\n\r\n  /** User ID if authenticated (web only) */\r\n  user_id?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Union Type\r\n// =============================================================================\r\n\r\n/**\r\n * Any render log entry.\r\n * Use the `type` field to discriminate.\r\n */\r\nexport type RenderLogEntry =\r\n  | ComponentRenderLogEntry\r\n  | DomSnapshotRenderLogEntry;\r\n\r\n// =============================================================================\r\n// API Types (for REST endpoints)\r\n// =============================================================================\r\n\r\n/**\r\n * Request to create a render log entry (web API).\r\n */\r\nexport interface CreateRenderLogRequest {\r\n  session_id: string;\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  target_selector?: string;\r\n  snapshot: DomSnapshot;\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n  capture_duration_ms?: number;\r\n  element_count?: number;\r\n}\r\n\r\n/**\r\n * Render log response from web API.\r\n * Includes database-generated fields.\r\n */\r\nexport interface RenderLogResponse {\r\n  id: number;\r\n  session_id: string;\r\n  timestamp: string; // ISO 8601 datetime\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  target_selector?: string;\r\n  snapshot: DomSnapshot;\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n  capture_duration_ms?: number;\r\n  element_count?: number;\r\n  user_id?: string;\r\n}\r\n\r\n/**\r\n * Summary of a render log (without full snapshot).\r\n */\r\nexport interface RenderLogSummary {\r\n  id: number;\r\n  session_id: string;\r\n  timestamp: string;\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  element_count?: number;\r\n  capture_duration_ms?: number;\r\n}\r\n\r\n/**\r\n * Paginated list of render logs.\r\n */\r\nexport interface RenderLogList {\r\n  items: RenderLogSummary[];\r\n  total: number;\r\n  page: number;\r\n  page_size: number;\r\n  has_more: boolean;\r\n}\r\n\r\n/**\r\n * Render logging statistics.\r\n */\r\nexport interface RenderLogStats {\r\n  enabled: boolean;\r\n  total_snapshots: number;\r\n  total_sessions: number;\r\n  oldest_snapshot?: string;\r\n  newest_snapshot?: string;\r\n  storage_used_bytes: number;\r\n  image_count: number;\r\n}\r\n\r\n// =============================================================================\r\n// Type Guards\r\n// =============================================================================\r\n\r\n/**\r\n * Check if a render log entry is a component log.\r\n */\r\nexport function isComponentRenderLog(\r\n  entry: RenderLogEntry,\r\n): entry is ComponentRenderLogEntry {\r\n  return entry.type === \"component\";\r\n}\r\n\r\n/**\r\n * Check if a render log entry is a DOM snapshot log.\r\n */\r\nexport function isDomSnapshotRenderLog(\r\n  entry: RenderLogEntry,\r\n): entry is DomSnapshotRenderLogEntry {\r\n  return entry.type === \"dom_snapshot\";\r\n}\r\n","/**\r\n * Unified State Discovery Result types.\r\n *\r\n * These types represent the output of state discovery from any source:\r\n * - Playwright (web extraction)\r\n * - UI Bridge (render log analysis)\r\n * - Recording (user session recording)\r\n * - Vision (screenshot analysis)\r\n * - Manual (user-defined)\r\n *\r\n * All types use camelCase field names to match the generated types from Rust\r\n * schemas. Converter functions are provided to transform snake_case API\r\n * responses into these typed objects.\r\n */\r\n\r\n// =============================================================================\r\n// Re-exports from generated types\r\n// =============================================================================\r\n\r\nexport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\r\nexport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\r\nexport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\r\nexport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\r\nexport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\r\nexport type { DiscoveredState } from \"./generated/DiscoveredState\";\r\nexport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\r\nexport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\r\nexport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\r\nexport type { StateDiscoveryResultListResponse } from \"./generated/StateDiscoveryResultListResponse\";\r\nexport type { StateDiscoveryResultCreate } from \"./generated/StateDiscoveryResultCreate\";\r\nexport type { StateDiscoveryResultUpdate } from \"./generated/StateDiscoveryResultUpdate\";\r\n\r\n// =============================================================================\r\n// Export/Import\r\n// =============================================================================\r\n\r\nexport type { StateMachineExport } from \"./generated/StateMachineExport\";\r\nexport type { StateMachineImport } from \"./generated/StateMachineImport\";\r\n\r\nimport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\r\nimport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\r\nimport type { DiscoveredState } from \"./generated/DiscoveredState\";\r\nimport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\r\n\r\n// =============================================================================\r\n// Display Helpers\r\n// =============================================================================\r\n\r\nexport const SOURCE_TYPE_LABELS: Record<DiscoverySourceType, string> = {\r\n  playwright: \"Web Extraction\",\r\n  ui_bridge: \"UI Bridge\",\r\n  recording: \"Recording\",\r\n  vision: \"Vision\",\r\n  manual: \"Manual\",\r\n};\r\n\r\nexport const SOURCE_TYPE_COLORS: Record<DiscoverySourceType, string> = {\r\n  playwright: \"bg-blue-500/20 text-blue-400 border-blue-500/30\",\r\n  ui_bridge: \"bg-purple-500/20 text-purple-400 border-purple-500/30\",\r\n  recording: \"bg-green-500/20 text-green-400 border-green-500/30\",\r\n  vision: \"bg-orange-500/20 text-orange-400 border-orange-500/30\",\r\n  manual: \"bg-gray-500/20 text-gray-400 border-gray-500/30\",\r\n};\r\n\r\n// =============================================================================\r\n// Converter Functions (snake_case API responses -> camelCase typed objects)\r\n// =============================================================================\r\n\r\nimport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\r\nimport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\r\nimport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\r\nimport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\r\nimport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\r\n\r\nexport function toStateDiscoveryResult(\r\n  data: Record<string, unknown>,\r\n): StateDiscoveryResult {\r\n  return {\r\n    id: data.id as string,\r\n    projectId: (data.projectId ?? data.project_id) as string,\r\n    name: data.name as string,\r\n    description: data.description as string | undefined,\r\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\r\n    sourceSessionId: (data.sourceSessionId ?? data.source_session_id) as\r\n      | string\r\n      | undefined,\r\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\r\n      | string\r\n      | undefined,\r\n    images: ((data.images as unknown[]) || []).map(toDiscoveredStateImage),\r\n    states: ((data.states as unknown[]) || []).map(toDiscoveredState),\r\n    transitions: ((data.transitions as unknown[]) || []).map(\r\n      toDiscoveredTransition,\r\n    ),\r\n    elementToRenders:\r\n      ((data.elementToRenders ?? data.element_to_renders) as Record<\r\n        string,\r\n        string[]\r\n      >) || {},\r\n    imageCount: (data.imageCount ?? data.image_count) as number,\r\n    stateCount: (data.stateCount ?? data.state_count) as number,\r\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\r\n    renderCount: (data.renderCount ?? data.render_count) as number,\r\n    uniqueElementCount: (data.uniqueElementCount ??\r\n      data.unique_element_count) as number,\r\n    confidence: data.confidence as number,\r\n    discoveryMetadata:\r\n      ((data.discoveryMetadata ?? data.discovery_metadata) as Record<\r\n        string,\r\n        unknown\r\n      >) || {},\r\n    createdAt: (data.createdAt ?? data.created_at) as string,\r\n    updatedAt: (data.updatedAt ?? data.updated_at) as string,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredStateImage(data: unknown): DiscoveredStateImage {\r\n  const d = data as Record<string, unknown>;\r\n  return {\r\n    id: d.id as string,\r\n    screenshotId: (d.screenshotId ?? d.screenshot_id) as string | undefined,\r\n    screenshotUrl: (d.screenshotUrl ?? d.screenshot_url) as string | undefined,\r\n    bbox: d.bbox as DiscoveryBoundingBox,\r\n    pixelHash: (d.pixelHash ?? d.pixel_hash) as string | undefined,\r\n    stateId: (d.stateId ?? d.state_id) as string | undefined,\r\n    elementType: (d.elementType ?? d.element_type) as string | undefined,\r\n    label: d.label as string | undefined,\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredState(data: unknown): DiscoveredState {\r\n  const d = data as Record<string, unknown>;\r\n  return {\r\n    id: d.id as string,\r\n    name: d.name as string,\r\n    imageIds: ((d.imageIds ?? d.image_ids) as string[]) || [],\r\n    renderIds: ((d.renderIds ?? d.render_ids) as string[]) || [],\r\n    elementIds: ((d.elementIds ?? d.element_ids) as string[]) || [],\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    description: d.description as string | undefined,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredTransition(data: unknown): DiscoveredTransition {\r\n  const d = data as Record<string, unknown>;\r\n  const trigger = d.trigger as Record<string, unknown> | undefined;\r\n  return {\r\n    id: d.id as string,\r\n    fromStateId: (d.fromStateId ?? d.from_state_id) as string,\r\n    toStateId: (d.toStateId ?? d.to_state_id) as string,\r\n    trigger: trigger\r\n      ? {\r\n          type: (trigger.type as TransitionTriggerType) ?? \"click\",\r\n          imageId: (trigger.imageId ?? trigger.image_id) as string | undefined,\r\n          elementId: (trigger.elementId ?? trigger.element_id) as\r\n            | string\r\n            | undefined,\r\n          selector: trigger.selector as string | undefined,\r\n          value: trigger.value as string | undefined,\r\n        }\r\n      : undefined,\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toStateDiscoveryResultSummary(\r\n  data: Record<string, unknown>,\r\n): StateDiscoveryResultSummary {\r\n  return {\r\n    id: data.id as string,\r\n    projectId: (data.projectId ?? data.project_id) as string,\r\n    name: data.name as string,\r\n    description: data.description as string | undefined,\r\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\r\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\r\n      | string\r\n      | undefined,\r\n    imageCount: (data.imageCount ?? data.image_count) as number,\r\n    stateCount: (data.stateCount ?? data.state_count) as number,\r\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\r\n    confidence: data.confidence as number,\r\n    createdAt: (data.createdAt ?? data.created_at) as string,\r\n  };\r\n}\r\n","/**\r\n * Known Issues Registry Types\r\n *\r\n * Persistent known issue tracking that survives across workflow runs.\r\n * Issues are scoped to specs, URLs, components, or global.\r\n */\r\n\r\nexport type IssueCategory =\r\n  | \"duplication\"\r\n  | \"rendering\"\r\n  | \"data_integrity\"\r\n  | \"timing\"\r\n  | \"layout\"\r\n  | \"state\"\r\n  | \"performance\"\r\n  | \"encoding\"\r\n  | \"navigation\"\r\n  | \"authentication\"\r\n  | \"other\";\r\n\r\nexport type ScopeType = \"global\" | \"spec\" | \"url\" | \"component\" | \"feature\";\r\n\r\nexport type DetectionMethod =\r\n  | \"algorithmic\"\r\n  | \"ai_judgment\"\r\n  | \"visual\"\r\n  | \"command\"\r\n  | \"ui_bridge\";\r\n\r\nexport type KnownIssueSeverity = \"critical\" | \"high\" | \"medium\" | \"low\";\r\n\r\nexport type IssueStatus = \"active\" | \"resolved\" | \"monitoring\" | \"wont_fix\";\r\n\r\nexport type IssueProvenance =\r\n  | \"manual\"\r\n  | \"auto_detected\"\r\n  | \"reflection\"\r\n  | \"imported\";\r\n\r\nexport interface KnownIssue {\r\n  id: string;\r\n  title: string;\r\n  description: string;\r\n  category: IssueCategory;\r\n  scope_type: ScopeType;\r\n  scope_value: string | null;\r\n  scope_tags: string[];\r\n  detection_method: DetectionMethod;\r\n  detection_config: Record<string, unknown>;\r\n  pattern_template_id: string | null;\r\n  reproduction_context: string | null;\r\n  trigger_conditions: string[];\r\n  severity: KnownIssueSeverity;\r\n  status: IssueStatus;\r\n  confidence: number;\r\n  provenance: IssueProvenance;\r\n  source_finding_ids: string[];\r\n  source_task_run_id: string | null;\r\n  verification_hint: string | null;\r\n  verification_step_template: Record<string, unknown> | null;\r\n  times_detected: number;\r\n  times_checked: number;\r\n  last_detected_at: string | null;\r\n  last_checked_at: string | null;\r\n  resolved_at: string | null;\r\n  created_at: string;\r\n  updated_at: string;\r\n}\r\n\r\nexport interface CreateKnownIssueRequest {\r\n  title: string;\r\n  description: string;\r\n  category: IssueCategory;\r\n  scope_type: ScopeType;\r\n  scope_value?: string | null;\r\n  scope_tags?: string[];\r\n  detection_method: DetectionMethod;\r\n  detection_config?: Record<string, unknown>;\r\n  pattern_template_id?: string | null;\r\n  reproduction_context?: string | null;\r\n  trigger_conditions?: string[];\r\n  severity: KnownIssueSeverity;\r\n  provenance?: IssueProvenance;\r\n  source_finding_ids?: string[];\r\n  source_task_run_id?: string | null;\r\n  verification_hint?: string | null;\r\n  verification_step_template?: Record<string, unknown> | null;\r\n}\r\n\r\nexport interface UpdateKnownIssueRequest {\r\n  title?: string;\r\n  description?: string;\r\n  category?: IssueCategory;\r\n  scope_type?: ScopeType;\r\n  scope_value?: string | null;\r\n  scope_tags?: string[];\r\n  detection_method?: DetectionMethod;\r\n  detection_config?: Record<string, unknown>;\r\n  pattern_template_id?: string | null;\r\n  reproduction_context?: string | null;\r\n  trigger_conditions?: string[];\r\n  severity?: KnownIssueSeverity;\r\n  status?: IssueStatus;\r\n  confidence?: number;\r\n  verification_hint?: string | null;\r\n  verification_step_template?: Record<string, unknown> | null;\r\n}\r\n\r\nexport interface ListKnownIssuesQuery {\r\n  scope_type?: string;\r\n  scope_value?: string;\r\n  category?: string;\r\n  severity?: string;\r\n  status?: string;\r\n  spec_id?: string;\r\n}\r\n\r\nexport interface CreatePatternTemplateRequest {\r\n  name: string;\r\n  description: string;\r\n  category: string;\r\n  detection_type: string;\r\n  ai_prompt_template?: string | null;\r\n  parameters?: string | null;\r\n}\r\n\r\nexport interface TemplateParameter {\r\n  name: string;\r\n  type: string;\r\n  description: string;\r\n  default?: unknown;\r\n}\r\n\r\nexport interface IssuePatternTemplate {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  category: string;\r\n  detection_type: string;\r\n  step_template: Record<string, unknown> | null;\r\n  ai_prompt_template: string | null;\r\n  parameters: TemplateParameter[];\r\n  built_in: boolean;\r\n  status: string;\r\n  created_at: string;\r\n  updated_at: string;\r\n}\r\n\r\n/** All issue categories with display labels */\r\nexport const ISSUE_CATEGORIES: { value: IssueCategory; label: string }[] = [\r\n  { value: \"duplication\", label: \"Duplication\" },\r\n  { value: \"rendering\", label: \"Rendering\" },\r\n  { value: \"data_integrity\", label: \"Data Integrity\" },\r\n  { value: \"timing\", label: \"Timing\" },\r\n  { value: \"layout\", label: \"Layout\" },\r\n  { value: \"state\", label: \"State\" },\r\n  { value: \"performance\", label: \"Performance\" },\r\n  { value: \"encoding\", label: \"Encoding\" },\r\n  { value: \"navigation\", label: \"Navigation\" },\r\n  { value: \"authentication\", label: \"Authentication\" },\r\n  { value: \"other\", label: \"Other\" },\r\n];\r\n\r\n/** All severity levels with display labels */\r\nexport const ISSUE_SEVERITIES: { value: KnownIssueSeverity; label: string }[] = [\r\n  { value: \"critical\", label: \"Critical\" },\r\n  { value: \"high\", label: \"High\" },\r\n  { value: \"medium\", label: \"Medium\" },\r\n  { value: \"low\", label: \"Low\" },\r\n];\r\n\r\n/** All detection methods with display labels */\r\nexport const DETECTION_METHODS: { value: DetectionMethod; label: string }[] = [\r\n  { value: \"algorithmic\", label: \"Algorithmic (automatic)\" },\r\n  { value: \"ai_judgment\", label: \"AI Judgment\" },\r\n  { value: \"visual\", label: \"Visual (screenshot)\" },\r\n  { value: \"command\", label: \"Shell Command\" },\r\n  { value: \"ui_bridge\", label: \"UI Bridge\" },\r\n];\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/render-log.ts","../src/discovery.ts","../src/known-issues/index.ts"],"sourcesContent":["/**\n * Shared Render Log Types\n *\n * These types define the render logging schema used across:\n * - qontinui-runner (Tauri desktop app) - Component-level logging\n * - qontinui-web (Next.js web app) - Full DOM snapshot logging\n *\n * The runner reads both its own logs and web's logs for verification\n * in AI feedback loops.\n *\n * NOTE: Field names use snake_case to match Rust/Python JSON serialization.\n * This ensures compatibility across all services.\n */\n\n// =============================================================================\n// Common Types\n// =============================================================================\n\n/**\n * Trigger types for render log capture.\n * What caused the render log to be captured.\n */\nexport type RenderLogTrigger =\n  | \"mount\" // Component/page mounted\n  | \"navigation\" // Page navigation occurred\n  | \"mutation\" // DOM mutation detected (web only)\n  | \"data_update\" // Data changed (runner components)\n  | \"prop_change\" // Props changed (runner components)\n  | \"manual\" // Explicitly triggered capture\n  | \"interval\"; // Periodic capture\n\n/**\n * DOM mutation types (for web's MutationObserver).\n */\nexport type DomMutationType = \"childList\" | \"attributes\" | \"characterData\";\n\n// =============================================================================\n// Base Render Log Entry\n// =============================================================================\n\n/**\n * Base render log entry with common fields.\n * Extended by component logs and DOM snapshot logs.\n */\nexport interface RenderLogEntryBase {\n  /** Unique identifier for this log entry */\n  id: string;\n\n  /** Unix timestamp in milliseconds when the capture occurred */\n  timestamp: number;\n\n  /** What triggered this capture */\n  trigger: RenderLogTrigger;\n\n  /** Session ID for grouping related captures */\n  session_id?: string;\n}\n\n// =============================================================================\n// Runner Component Render Log (Lightweight)\n// =============================================================================\n\n/**\n * Component-level render log entry.\n * Used by qontinui-runner to log what data components render.\n *\n * Components explicitly call logRender() with their rendered data.\n * This is lightweight and focused on verifying data display.\n */\nexport interface ComponentRenderLogEntry extends RenderLogEntryBase {\n  /** Type discriminator */\n  type: \"component\";\n\n  /** Component name (e.g., \"RunRecapTab\", \"StatusBanner\") */\n  component: string;\n\n  /** The data that was rendered (component-specific structure) */\n  data: Record<string, unknown>;\n\n  /** Sections that are visible/expanded in the component */\n  visible_sections?: string[];\n\n  /** Associated task run ID if applicable */\n  task_run_id?: number;\n}\n\n// =============================================================================\n// Web DOM Snapshot Render Log (Comprehensive)\n// =============================================================================\n\n/**\n * Bounding rectangle for an element.\n */\nexport interface ElementRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * Single DOM element in a snapshot.\n * Recursive structure representing the DOM tree.\n */\nexport interface DomElementSnapshot {\n  /** HTML tag name (lowercase) */\n  tag: string;\n\n  /** Element ID if present */\n  id?: string;\n\n  /** CSS class list */\n  class_list: string[];\n\n  /** Direct text content (not from children) */\n  text_content?: string;\n\n  /** Length of innerHTML (for size estimation) */\n  inner_html_length?: number;\n\n  /** Bounding rectangle relative to viewport */\n  rect?: ElementRect;\n\n  /** Whether the element is visible */\n  is_visible: boolean;\n\n  /** Computed opacity */\n  opacity?: number;\n\n  /** Computed display value */\n  display?: string;\n\n  /** Key HTML attributes */\n  attributes: Record<string, string>;\n\n  /** Selected computed styles */\n  computed_styles?: Record<string, string>;\n\n  /** Child elements (recursive) */\n  children: DomElementSnapshot[];\n}\n\n/**\n * Form data extracted from the page.\n */\nexport interface FormSnapshot {\n  id?: string;\n  action?: string;\n  method?: string;\n  inputs: Array<{\n    type: string;\n    name: string;\n    value: string;\n  }>;\n}\n\n/**\n * Link data extracted from the page.\n */\nexport interface LinkSnapshot {\n  href: string;\n  text: string;\n}\n\n/**\n * Image data extracted from the page.\n */\nexport interface ImageSnapshot {\n  src: string;\n  alt?: string;\n  width?: number;\n  height?: number;\n}\n\n/**\n * Full DOM snapshot data.\n * Contains the entire page state for debugging.\n *\n * NOTE: The snapshot is stored as JSONB in the database, so field names\n * in the nested structure (root, forms, links, images) may vary by\n * implementation. The web frontend uses camelCase internally but that's\n * stored as-is in the JSONB field.\n */\nexport interface DomSnapshot {\n  /** Root element tree (document.body) */\n  root: DomElementSnapshot | null;\n\n  /** Total number of elements in the tree */\n  total_elements: number;\n\n  /** Concatenated visible text (truncated) */\n  visible_text?: string;\n\n  /** Forms on the page */\n  forms: FormSnapshot[];\n\n  /** Links on the page */\n  links: LinkSnapshot[];\n\n  /** Images on the page */\n  images: ImageSnapshot[];\n\n  /** JavaScript console errors captured */\n  errors: string[];\n\n  /** JavaScript console warnings captured */\n  warnings: string[];\n}\n\n/**\n * Full DOM snapshot render log entry.\n * Used by qontinui-web to capture entire page state.\n *\n * Automatically captured via MutationObserver on DOM changes.\n * Provides comprehensive debugging data.\n */\nexport interface DomSnapshotRenderLogEntry extends RenderLogEntryBase {\n  /** Type discriminator */\n  type: \"dom_snapshot\";\n\n  /** Current page URL */\n  page_url: string;\n\n  /** Page title */\n  page_title?: string;\n\n  /** Type of DOM mutation that triggered capture (if mutation trigger) */\n  mutation_type?: DomMutationType;\n\n  /** CSS selector of the element that was mutated */\n  target_selector?: string;\n\n  /** The full DOM snapshot */\n  snapshot: DomSnapshot;\n\n  /** Viewport dimensions */\n  viewport_width?: number;\n  viewport_height?: number;\n\n  /** Scroll position */\n  scroll_x?: number;\n  scroll_y?: number;\n\n  /** Time taken to capture the snapshot in milliseconds */\n  capture_duration_ms?: number;\n\n  /** Number of elements captured */\n  element_count?: number;\n\n  /** User ID if authenticated (web only) */\n  user_id?: string;\n}\n\n// =============================================================================\n// Union Type\n// =============================================================================\n\n/**\n * Any render log entry.\n * Use the `type` field to discriminate.\n */\nexport type RenderLogEntry =\n  | ComponentRenderLogEntry\n  | DomSnapshotRenderLogEntry;\n\n// =============================================================================\n// API Types (for REST endpoints)\n// =============================================================================\n\n/**\n * Request to create a render log entry (web API).\n */\nexport interface CreateRenderLogRequest {\n  session_id: string;\n  page_url: string;\n  page_title?: string;\n  trigger: RenderLogTrigger;\n  mutation_type?: DomMutationType;\n  target_selector?: string;\n  snapshot: DomSnapshot;\n  viewport_width?: number;\n  viewport_height?: number;\n  scroll_x?: number;\n  scroll_y?: number;\n  capture_duration_ms?: number;\n  element_count?: number;\n}\n\n/**\n * Render log response from web API.\n * Includes database-generated fields.\n */\nexport interface RenderLogResponse {\n  id: number;\n  session_id: string;\n  timestamp: string; // ISO 8601 datetime\n  page_url: string;\n  page_title?: string;\n  trigger: RenderLogTrigger;\n  mutation_type?: DomMutationType;\n  target_selector?: string;\n  snapshot: DomSnapshot;\n  viewport_width?: number;\n  viewport_height?: number;\n  scroll_x?: number;\n  scroll_y?: number;\n  capture_duration_ms?: number;\n  element_count?: number;\n  user_id?: string;\n}\n\n/**\n * Summary of a render log (without full snapshot).\n */\nexport interface RenderLogSummary {\n  id: number;\n  session_id: string;\n  timestamp: string;\n  page_url: string;\n  page_title?: string;\n  trigger: RenderLogTrigger;\n  mutation_type?: DomMutationType;\n  element_count?: number;\n  capture_duration_ms?: number;\n}\n\n/**\n * Paginated list of render logs.\n */\nexport interface RenderLogList {\n  items: RenderLogSummary[];\n  total: number;\n  page: number;\n  page_size: number;\n  has_more: boolean;\n}\n\n/**\n * Render logging statistics.\n */\nexport interface RenderLogStats {\n  enabled: boolean;\n  total_snapshots: number;\n  total_sessions: number;\n  oldest_snapshot?: string;\n  newest_snapshot?: string;\n  storage_used_bytes: number;\n  image_count: number;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if a render log entry is a component log.\n */\nexport function isComponentRenderLog(\n  entry: RenderLogEntry,\n): entry is ComponentRenderLogEntry {\n  return entry.type === \"component\";\n}\n\n/**\n * Check if a render log entry is a DOM snapshot log.\n */\nexport function isDomSnapshotRenderLog(\n  entry: RenderLogEntry,\n): entry is DomSnapshotRenderLogEntry {\n  return entry.type === \"dom_snapshot\";\n}\n","/**\n * Unified State Discovery Result types.\n *\n * These types represent the output of state discovery from any source:\n * - Playwright (web extraction)\n * - UI Bridge (render log analysis)\n * - Recording (user session recording)\n * - Vision (screenshot analysis)\n * - Manual (user-defined)\n *\n * All types use camelCase field names to match the generated types from Rust\n * schemas. Converter functions are provided to transform snake_case API\n * responses into these typed objects.\n */\n\n// =============================================================================\n// Re-exports from generated types\n// =============================================================================\n\nexport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\nexport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\nexport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\nexport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\nexport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\nexport type { DiscoveredState } from \"./generated/DiscoveredState\";\nexport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\nexport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\nexport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\nexport type { StateDiscoveryResultListResponse } from \"./generated/StateDiscoveryResultListResponse\";\nexport type { StateDiscoveryResultCreate } from \"./generated/StateDiscoveryResultCreate\";\nexport type { StateDiscoveryResultUpdate } from \"./generated/StateDiscoveryResultUpdate\";\n\n// =============================================================================\n// Export/Import\n// =============================================================================\n\nexport type { StateMachineExport } from \"./generated/StateMachineExport\";\nexport type { StateMachineImport } from \"./generated/StateMachineImport\";\n\nimport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\nimport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\nimport type { DiscoveredState } from \"./generated/DiscoveredState\";\nimport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\n\n// =============================================================================\n// Display Helpers\n// =============================================================================\n\nexport const SOURCE_TYPE_LABELS: Record<DiscoverySourceType, string> = {\n  playwright: \"Web Extraction\",\n  ui_bridge: \"UI Bridge\",\n  recording: \"Recording\",\n  vision: \"Vision\",\n  manual: \"Manual\",\n};\n\nexport const SOURCE_TYPE_COLORS: Record<DiscoverySourceType, string> = {\n  playwright: \"bg-blue-500/20 text-blue-400 border-blue-500/30\",\n  ui_bridge: \"bg-purple-500/20 text-purple-400 border-purple-500/30\",\n  recording: \"bg-green-500/20 text-green-400 border-green-500/30\",\n  vision: \"bg-orange-500/20 text-orange-400 border-orange-500/30\",\n  manual: \"bg-gray-500/20 text-gray-400 border-gray-500/30\",\n};\n\n// =============================================================================\n// Converter Functions (snake_case API responses -> camelCase typed objects)\n// =============================================================================\n\nimport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\nimport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\nimport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\nimport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\nimport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\n\nexport function toStateDiscoveryResult(\n  data: Record<string, unknown>,\n): StateDiscoveryResult {\n  return {\n    id: data.id as string,\n    projectId: (data.projectId ?? data.project_id) as string,\n    name: data.name as string,\n    description: data.description as string | undefined,\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\n    sourceSessionId: (data.sourceSessionId ?? data.source_session_id) as\n      | string\n      | undefined,\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\n      | string\n      | undefined,\n    images: ((data.images as unknown[]) || []).map(toDiscoveredStateImage),\n    states: ((data.states as unknown[]) || []).map(toDiscoveredState),\n    transitions: ((data.transitions as unknown[]) || []).map(\n      toDiscoveredTransition,\n    ),\n    elementToRenders:\n      ((data.elementToRenders ?? data.element_to_renders) as Record<\n        string,\n        string[]\n      >) || {},\n    imageCount: (data.imageCount ?? data.image_count) as number,\n    stateCount: (data.stateCount ?? data.state_count) as number,\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\n    renderCount: (data.renderCount ?? data.render_count) as number,\n    uniqueElementCount: (data.uniqueElementCount ??\n      data.unique_element_count) as number,\n    confidence: data.confidence as number,\n    discoveryMetadata:\n      ((data.discoveryMetadata ?? data.discovery_metadata) as Record<\n        string,\n        unknown\n      >) || {},\n    createdAt: (data.createdAt ?? data.created_at) as string,\n    updatedAt: (data.updatedAt ?? data.updated_at) as string,\n  };\n}\n\nexport function toDiscoveredStateImage(data: unknown): DiscoveredStateImage {\n  const d = data as Record<string, unknown>;\n  return {\n    id: d.id as string,\n    screenshotId: (d.screenshotId ?? d.screenshot_id) as string | undefined,\n    screenshotUrl: (d.screenshotUrl ?? d.screenshot_url) as string | undefined,\n    bbox: d.bbox as DiscoveryBoundingBox,\n    pixelHash: (d.pixelHash ?? d.pixel_hash) as string | undefined,\n    stateId: (d.stateId ?? d.state_id) as string | undefined,\n    elementType: (d.elementType ?? d.element_type) as string | undefined,\n    label: d.label as string | undefined,\n    confidence: (d.confidence as number) ?? 1.0,\n    metadata: d.metadata as Record<string, unknown> | undefined,\n  };\n}\n\nexport function toDiscoveredState(data: unknown): DiscoveredState {\n  const d = data as Record<string, unknown>;\n  return {\n    id: d.id as string,\n    name: d.name as string,\n    imageIds: ((d.imageIds ?? d.image_ids) as string[]) || [],\n    renderIds: ((d.renderIds ?? d.render_ids) as string[]) || [],\n    elementIds: ((d.elementIds ?? d.element_ids) as string[]) || [],\n    confidence: (d.confidence as number) ?? 1.0,\n    description: d.description as string | undefined,\n    metadata: d.metadata as Record<string, unknown> | undefined,\n  };\n}\n\nexport function toDiscoveredTransition(data: unknown): DiscoveredTransition {\n  const d = data as Record<string, unknown>;\n  const trigger = d.trigger as Record<string, unknown> | undefined;\n  return {\n    id: d.id as string,\n    fromStateId: (d.fromStateId ?? d.from_state_id) as string,\n    toStateId: (d.toStateId ?? d.to_state_id) as string,\n    trigger: trigger\n      ? {\n          type: (trigger.type as TransitionTriggerType) ?? \"click\",\n          imageId: (trigger.imageId ?? trigger.image_id) as string | undefined,\n          elementId: (trigger.elementId ?? trigger.element_id) as\n            | string\n            | undefined,\n          selector: trigger.selector as string | undefined,\n          value: trigger.value as string | undefined,\n        }\n      : undefined,\n    confidence: (d.confidence as number) ?? 1.0,\n    metadata: d.metadata as Record<string, unknown> | undefined,\n  };\n}\n\nexport function toStateDiscoveryResultSummary(\n  data: Record<string, unknown>,\n): StateDiscoveryResultSummary {\n  return {\n    id: data.id as string,\n    projectId: (data.projectId ?? data.project_id) as string,\n    name: data.name as string,\n    description: data.description as string | undefined,\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\n      | string\n      | undefined,\n    imageCount: (data.imageCount ?? data.image_count) as number,\n    stateCount: (data.stateCount ?? data.state_count) as number,\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\n    confidence: data.confidence as number,\n    createdAt: (data.createdAt ?? data.created_at) as string,\n  };\n}\n","/**\n * Known Issues Registry Types\n *\n * Persistent known issue tracking that survives across workflow runs.\n * Issues are scoped to specs, URLs, components, or global.\n */\n\nexport type IssueCategory =\n  | \"duplication\"\n  | \"rendering\"\n  | \"data_integrity\"\n  | \"timing\"\n  | \"layout\"\n  | \"state\"\n  | \"performance\"\n  | \"encoding\"\n  | \"navigation\"\n  | \"authentication\"\n  | \"other\";\n\nexport type ScopeType = \"global\" | \"spec\" | \"url\" | \"component\" | \"feature\";\n\nexport type DetectionMethod =\n  | \"algorithmic\"\n  | \"ai_judgment\"\n  | \"visual\"\n  | \"command\"\n  | \"ui_bridge\";\n\nexport type KnownIssueSeverity = \"critical\" | \"high\" | \"medium\" | \"low\";\n\nexport type IssueStatus = \"active\" | \"resolved\" | \"monitoring\" | \"wont_fix\";\n\nexport type IssueProvenance =\n  | \"manual\"\n  | \"auto_detected\"\n  | \"reflection\"\n  | \"imported\";\n\nexport interface KnownIssue {\n  id: string;\n  title: string;\n  description: string;\n  category: IssueCategory;\n  scope_type: ScopeType;\n  scope_value: string | null;\n  scope_tags: string[];\n  detection_method: DetectionMethod;\n  detection_config: Record<string, unknown>;\n  pattern_template_id: string | null;\n  reproduction_context: string | null;\n  trigger_conditions: string[];\n  severity: KnownIssueSeverity;\n  status: IssueStatus;\n  confidence: number;\n  provenance: IssueProvenance;\n  source_finding_ids: string[];\n  source_task_run_id: string | null;\n  verification_hint: string | null;\n  verification_step_template: Record<string, unknown> | null;\n  times_detected: number;\n  times_checked: number;\n  last_detected_at: string | null;\n  last_checked_at: string | null;\n  resolved_at: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface CreateKnownIssueRequest {\n  title: string;\n  description: string;\n  category: IssueCategory;\n  scope_type: ScopeType;\n  scope_value?: string | null;\n  scope_tags?: string[];\n  detection_method: DetectionMethod;\n  detection_config?: Record<string, unknown>;\n  pattern_template_id?: string | null;\n  reproduction_context?: string | null;\n  trigger_conditions?: string[];\n  severity: KnownIssueSeverity;\n  provenance?: IssueProvenance;\n  source_finding_ids?: string[];\n  source_task_run_id?: string | null;\n  verification_hint?: string | null;\n  verification_step_template?: Record<string, unknown> | null;\n}\n\nexport interface UpdateKnownIssueRequest {\n  title?: string;\n  description?: string;\n  category?: IssueCategory;\n  scope_type?: ScopeType;\n  scope_value?: string | null;\n  scope_tags?: string[];\n  detection_method?: DetectionMethod;\n  detection_config?: Record<string, unknown>;\n  pattern_template_id?: string | null;\n  reproduction_context?: string | null;\n  trigger_conditions?: string[];\n  severity?: KnownIssueSeverity;\n  status?: IssueStatus;\n  confidence?: number;\n  verification_hint?: string | null;\n  verification_step_template?: Record<string, unknown> | null;\n}\n\nexport interface ListKnownIssuesQuery {\n  scope_type?: string;\n  scope_value?: string;\n  category?: string;\n  severity?: string;\n  status?: string;\n  spec_id?: string;\n}\n\nexport interface CreatePatternTemplateRequest {\n  name: string;\n  description: string;\n  category: string;\n  detection_type: string;\n  ai_prompt_template?: string | null;\n  parameters?: string | null;\n}\n\nexport interface TemplateParameter {\n  name: string;\n  type: string;\n  description: string;\n  default?: unknown;\n}\n\nexport interface IssuePatternTemplate {\n  id: string;\n  name: string;\n  description: string;\n  category: string;\n  detection_type: string;\n  step_template: Record<string, unknown> | null;\n  ai_prompt_template: string | null;\n  parameters: TemplateParameter[];\n  built_in: boolean;\n  status: string;\n  created_at: string;\n  updated_at: string;\n}\n\n/** All issue categories with display labels */\nexport const ISSUE_CATEGORIES: { value: IssueCategory; label: string }[] = [\n  { value: \"duplication\", label: \"Duplication\" },\n  { value: \"rendering\", label: \"Rendering\" },\n  { value: \"data_integrity\", label: \"Data Integrity\" },\n  { value: \"timing\", label: \"Timing\" },\n  { value: \"layout\", label: \"Layout\" },\n  { value: \"state\", label: \"State\" },\n  { value: \"performance\", label: \"Performance\" },\n  { value: \"encoding\", label: \"Encoding\" },\n  { value: \"navigation\", label: \"Navigation\" },\n  { value: \"authentication\", label: \"Authentication\" },\n  { value: \"other\", label: \"Other\" },\n];\n\n/** All severity levels with display labels */\nexport const ISSUE_SEVERITIES: { value: KnownIssueSeverity; label: string }[] = [\n  { value: \"critical\", label: \"Critical\" },\n  { value: \"high\", label: \"High\" },\n  { value: \"medium\", label: \"Medium\" },\n  { value: \"low\", label: \"Low\" },\n];\n\n/** All detection methods with display labels */\nexport const DETECTION_METHODS: { value: DetectionMethod; label: string }[] = [\n  { value: \"algorithmic\", label: \"Algorithmic (automatic)\" },\n  { value: \"ai_judgment\", label: \"AI Judgment\" },\n  { value: \"visual\", label: \"Visual (screenshot)\" },\n  { value: \"command\", label: \"Shell Command\" },\n  { value: \"ui_bridge\", label: \"UI Bridge\" },\n];\n"],"mappings":"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","names":[]}

package/dist/library.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/library/index.ts"],"sourcesContent":["export * from \"./_api\";\r\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/library/index.ts"],"sourcesContent":["export * from \"./_api\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/rag.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/rag/index.ts"],"sourcesContent":["export * from \"./_api\";\r\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/rag/index.ts"],"sourcesContent":["export * from \"./_api\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}