@qontinui/shared-types 0.2.1

package/src/known-issues/index.ts

@@ -0,0 +1,179 @@
+/**
+ * Known Issues Registry Types
+ *
+ * Persistent known issue tracking that survives across workflow runs.
+ * Issues are scoped to specs, URLs, components, or global.
+ */
+
+export type IssueCategory =
+  | "duplication"
+  | "rendering"
+  | "data_integrity"
+  | "timing"
+  | "layout"
+  | "state"
+  | "performance"
+  | "encoding"
+  | "navigation"
+  | "authentication"
+  | "other";
+
+export type ScopeType = "global" | "spec" | "url" | "component" | "feature";
+
+export type DetectionMethod =
+  | "algorithmic"
+  | "ai_judgment"
+  | "visual"
+  | "command"
+  | "ui_bridge";
+
+export type KnownIssueSeverity = "critical" | "high" | "medium" | "low";
+
+export type IssueStatus = "active" | "resolved" | "monitoring" | "wont_fix";
+
+export type IssueProvenance =
+  | "manual"
+  | "auto_detected"
+  | "reflection"
+  | "imported";
+
+export interface KnownIssue {
+  id: string;
+  title: string;
+  description: string;
+  category: IssueCategory;
+  scope_type: ScopeType;
+  scope_value: string | null;
+  scope_tags: string[];
+  detection_method: DetectionMethod;
+  detection_config: Record<string, unknown>;
+  pattern_template_id: string | null;
+  reproduction_context: string | null;
+  trigger_conditions: string[];
+  severity: KnownIssueSeverity;
+  status: IssueStatus;
+  confidence: number;
+  provenance: IssueProvenance;
+  source_finding_ids: string[];
+  source_task_run_id: string | null;
+  verification_hint: string | null;
+  verification_step_template: Record<string, unknown> | null;
+  times_detected: number;
+  times_checked: number;
+  last_detected_at: string | null;
+  last_checked_at: string | null;
+  resolved_at: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateKnownIssueRequest {
+  title: string;
+  description: string;
+  category: IssueCategory;
+  scope_type: ScopeType;
+  scope_value?: string | null;
+  scope_tags?: string[];
+  detection_method: DetectionMethod;
+  detection_config?: Record<string, unknown>;
+  pattern_template_id?: string | null;
+  reproduction_context?: string | null;
+  trigger_conditions?: string[];
+  severity: KnownIssueSeverity;
+  provenance?: IssueProvenance;
+  source_finding_ids?: string[];
+  source_task_run_id?: string | null;
+  verification_hint?: string | null;
+  verification_step_template?: Record<string, unknown> | null;
+}
+
+export interface UpdateKnownIssueRequest {
+  title?: string;
+  description?: string;
+  category?: IssueCategory;
+  scope_type?: ScopeType;
+  scope_value?: string | null;
+  scope_tags?: string[];
+  detection_method?: DetectionMethod;
+  detection_config?: Record<string, unknown>;
+  pattern_template_id?: string | null;
+  reproduction_context?: string | null;
+  trigger_conditions?: string[];
+  severity?: KnownIssueSeverity;
+  status?: IssueStatus;
+  confidence?: number;
+  verification_hint?: string | null;
+  verification_step_template?: Record<string, unknown> | null;
+}
+
+export interface ListKnownIssuesQuery {
+  scope_type?: string;
+  scope_value?: string;
+  category?: string;
+  severity?: string;
+  status?: string;
+  spec_id?: string;
+}
+
+export interface CreatePatternTemplateRequest {
+  name: string;
+  description: string;
+  category: string;
+  detection_type: string;
+  ai_prompt_template?: string | null;
+  parameters?: string | null;
+}
+
+export interface TemplateParameter {
+  name: string;
+  type: string;
+  description: string;
+  default?: unknown;
+}
+
+export interface IssuePatternTemplate {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  detection_type: string;
+  step_template: Record<string, unknown> | null;
+  ai_prompt_template: string | null;
+  parameters: TemplateParameter[];
+  built_in: boolean;
+  status: string;
+  created_at: string;
+  updated_at: string;
+}
+
+/** All issue categories with display labels */
+export const ISSUE_CATEGORIES: { value: IssueCategory; label: string }[] = [
+  { value: "duplication", label: "Duplication" },
+  { value: "rendering", label: "Rendering" },
+  { value: "data_integrity", label: "Data Integrity" },
+  { value: "timing", label: "Timing" },
+  { value: "layout", label: "Layout" },
+  { value: "state", label: "State" },
+  { value: "performance", label: "Performance" },
+  { value: "encoding", label: "Encoding" },
+  { value: "navigation", label: "Navigation" },
+  { value: "authentication", label: "Authentication" },
+  { value: "other", label: "Other" },
+];
+
+/** All severity levels with display labels */
+export const ISSUE_SEVERITIES: { value: KnownIssueSeverity; label: string }[] = [
+  { value: "critical", label: "Critical" },
+  { value: "high", label: "High" },
+  { value: "medium", label: "Medium" },
+  { value: "low", label: "Low" },
+];
+
+/** All detection methods with display labels */
+export const DETECTION_METHODS: { value: DetectionMethod; label: string }[] = [
+  { value: "algorithmic", label: "Algorithmic (automatic)" },
+  { value: "ai_judgment", label: "AI Judgment" },
+  { value: "visual", label: "Visual (screenshot)" },
+  { value: "command", label: "Shell Command" },
+  { value: "ui_bridge", label: "UI Bridge" },
+];

package/src/library/_api.ts

@@ -0,0 +1,326 @@
+/**
+ * Library Types
+ *
+ * Normalized types for library items that both apps agree on.
+ * These represent the various reusable building blocks available
+ * in the workflow builder's library pickers.
+ */
+
+// ============================================================================
+// Base Library Item
+// ============================================================================
+
+export interface LibraryItem {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+// ============================================================================
+// Check Items
+// ============================================================================
+
+export interface CheckItem extends LibraryItem {
+  check_type: string;
+  tool?: string;
+  command?: string;
+  working_directory?: string;
+  config_path?: string;
+  auto_fix?: boolean;
+  fail_on_warning?: boolean;
+  timeout_seconds?: number;
+  enabled?: boolean;
+}
+
+export interface CheckGroup extends LibraryItem {
+  checks: string[];
+  parallel?: boolean;
+  stop_on_first_failure?: boolean;
+}
+
+// ============================================================================
+// Shell Commands
+// ============================================================================
+
+export interface ShellCommand extends LibraryItem {
+  command: string;
+  working_directory?: string;
+  timeout_seconds?: number;
+  platform?: string;
+}
+
+// ============================================================================
+// Saved Prompts
+// ============================================================================
+
+export interface SavedPrompt extends LibraryItem {
+  content: string;
+  provider?: string;
+  model?: string;
+  category?: string;
+  language?: string;
+}
+
+// ============================================================================
+// Saved API Requests
+// ============================================================================
+
+export interface SavedApiRequest extends LibraryItem {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  body?: string;
+  content_type?: string;
+  auth_type?: string;
+  variables?: Record<string, string>;
+}
+
+// ============================================================================
+// Contexts
+// ============================================================================
+
+export interface Context extends LibraryItem {
+  content: string;
+  auto_include?: boolean;
+  priority?: number;
+}
+
+// ============================================================================
+// Macros
+// ============================================================================
+
+export interface Macro extends LibraryItem {
+  actions: MacroAction[];
+  timeout_seconds?: number;
+}
+
+export interface MacroAction {
+  type: string;
+  config: Record<string, unknown>;
+  delay_ms?: number;
+}
+
+// ============================================================================
+// Findings Types (runner-side finding system)
+// ============================================================================
+
+export type BuiltInCategoryId =
+  | "code_bug"
+  | "todo"
+  | "config_issue"
+  | "already_fixed"
+  | "expected_behavior"
+  | "data_migration"
+  | "runtime_issue"
+  | "test_issue"
+  | "enhancement"
+  | "warning"
+  | "documentation"
+  | "security"
+  | "performance";
+
+export type FindingActionType =
+  | "auto_fix"
+  | "needs_user_input"
+  | "manual"
+  | "informational";
+
+export type FindingStatus =
+  | "detected"
+  | "in_progress"
+  | "needs_input"
+  | "resolved"
+  | "wont_fix"
+  | "deferred";
+
+export type FindingSeverity = "critical" | "high" | "medium" | "low" | "info";
+
+export type UserInputType = "text" | "choice" | "boolean" | "code";
+
+export interface FindingCategory {
+  id: string;
+  name: string;
+  description: string;
+  icon: string;
+  color: string;
+  isBuiltIn: boolean;
+  defaultActionType: FindingActionType;
+  sortOrder: number;
+}
+
+export interface UserInputOption {
+  value: string;
+  label: string;
+  description?: string;
+}
+
+export interface UserInputRequest {
+  id: string;
+  findingId: string;
+  question: string;
+  context?: string;
+  inputType: UserInputType;
+  options?: UserInputOption[];
+  required: boolean;
+  defaultValue?: string;
+}
+
+export interface CodeContext {
+  file?: string;
+  line?: number;
+  endLine?: number;
+  snippet?: string;
+}
+
+export interface Finding {
+  id: string;
+  categoryId: string;
+  severity: FindingSeverity;
+  status: FindingStatus;
+  title: string;
+  description: string;
+  sourceSessionId?: string;
+  sourcePromptName?: string;
+  detectedAt: number;
+  actionType: FindingActionType;
+  actionable: boolean;
+  pendingQuestion?: UserInputRequest;
+  userResponse?: string;
+  resolvedAt?: number;
+  resolution?: string;
+  codeContext?: CodeContext;
+  metadata?: Record<string, unknown>;
+}
+
+export interface CategorySummary {
+  count: number;
+  actionable: number;
+  resolved: number;
+}
+
+export interface ReportSummary {
+  totalFindings: number;
+  byCategory: Record<string, CategorySummary>;
+  bySeverity: Record<FindingSeverity, number>;
+  byStatus: Record<FindingStatus, number>;
+  actionable: number;
+  needsUserInput: number;
+  autoFixed: number;
+  informational: number;
+}
+
+export type ReportStatus =
+  | "running"
+  | "completed"
+  | "paused_for_input"
+  | "failed"
+  | "cancelled";
+
+export interface PhaseInfo {
+  phase: number;
+  startedAt: number;
+  completedAt?: number;
+  findingsDetected: number;
+  findingsResolved: number;
+}
+
+export interface ExecutionReport {
+  id: string;
+  sessionId: string;
+  promptName: string;
+  promptId?: string;
+  startedAt: number;
+  completedAt?: number;
+  duration?: number;
+  status: ReportStatus;
+  findings: Finding[];
+  summary: ReportSummary;
+  pendingInputs: UserInputRequest[];
+  phases: PhaseInfo[];
+}
+
+export interface ParsedFinding {
+  categoryId: string;
+  severity: FindingSeverity;
+  title: string;
+  description: string;
+  needsInput: boolean;
+  question?: string;
+  options?: string[];
+  file?: string;
+  line?: number;
+  resolution?: string;
+}
+
+export interface CategoryStore {
+  customCategories: FindingCategory[];
+  categoryOrder: string[];
+  hiddenCategories: string[];
+}
+
+// ============================================================================
+// Color Types (design-system colors)
+// ============================================================================
+
+/** @deprecated Use FindingSeverity instead */
+export type SeverityLevel = FindingSeverity;
+
+export interface SeverityColorClasses {
+  bg: string;
+  text: string;
+  border: string;
+  dot: string;
+}
+
+export type StatusColorType =
+  | "idle"
+  | "running"
+  | "success"
+  | "error"
+  | "warning"
+  | "pending"
+  | "paused"
+  | "cancelled";
+
+export interface StatusColorClasses {
+  bg: string;
+  text: string;
+  border: string;
+  icon: string;
+  pulse?: string;
+}
+
+export type ActionColorType =
+  | "auto_fix"
+  | "needs_user_input"
+  | "manual"
+  | "informational"
+  | "skip"
+  | "defer";
+
+export interface ActionColorClasses {
+  bg: string;
+  text: string;
+  border: string;
+  badge: string;
+}
+
+export type AccentColor =
+  | "red"
+  | "orange"
+  | "amber"
+  | "yellow"
+  | "green"
+  | "emerald"
+  | "blue"
+  | "cyan"
+  | "purple"
+  | "rose"
+  | "slate";
+
+export interface AccentColorClasses {
+  bg: string;
+  bgSolid: string;
+  text: string;
+  border: string;
+}

package/src/library/index.ts

@@ -0,0 +1 @@
+export * from "./_api";

package/src/rag/_api.ts

@@ -0,0 +1,47 @@
+/**
+ * RAG (Retrieval-Augmented Generation) API Types
+ *
+ * Covers embedding computation (qontinui-api), sync (runner → backend),
+ * progress events, dashboard stats, semantic search, and state filter.
+ *
+ * Source of truth: qontinui-schemas/rust/src/rag.rs.
+ */
+
+// Enums
+export type { JobStatus } from "../generated/JobStatus";
+export type { RagProcessingStatus } from "../generated/RagProcessingStatus";
+
+// Embedding computation
+export type { ComputeTextEmbeddingRequest } from "../generated/ComputeTextEmbeddingRequest";
+export type { ComputeTextEmbeddingResponse } from "../generated/ComputeTextEmbeddingResponse";
+export type { ComputeEmbeddingRequest } from "../generated/ComputeEmbeddingRequest";
+export type { ComputeEmbeddingResponse } from "../generated/ComputeEmbeddingResponse";
+export type { BatchComputeEmbeddingRequest } from "../generated/BatchComputeEmbeddingRequest";
+export type { BatchEmbeddingResult } from "../generated/BatchEmbeddingResult";
+export type { BatchComputeEmbeddingResponse } from "../generated/BatchComputeEmbeddingResponse";
+
+// Embedding sync
+export type { EmbeddingResultItem } from "../generated/EmbeddingResultItem";
+export type { EmbeddingResultsRequest } from "../generated/EmbeddingResultsRequest";
+export type { EmbeddingResultsResponse } from "../generated/EmbeddingResultsResponse";
+
+// Progress events
+export type { RagProgressEvent } from "../generated/RagProgressEvent";
+export type { RagCompletionEvent } from "../generated/RagCompletionEvent";
+
+// Dashboard
+export type { JobSummary } from "../generated/JobSummary";
+export type { RAGDashboardStats } from "../generated/RAGDashboardStats";
+export type { EmbeddingItem } from "../generated/EmbeddingItem";
+export type { EmbeddingListResponse } from "../generated/EmbeddingListResponse";
+export type { JobItem } from "../generated/JobItem";
+export type { JobListResponse } from "../generated/JobListResponse";
+
+// Semantic search
+export type { SemanticSearchRequest } from "../generated/SemanticSearchRequest";
+export type { SearchResultItem } from "../generated/SearchResultItem";
+export type { SemanticSearchResponse } from "../generated/SemanticSearchResponse";
+
+// State filter
+export type { StateFilterItem } from "../generated/StateFilterItem";
+export type { StatesResponse } from "../generated/StatesResponse";

package/src/rag/index.ts

@@ -0,0 +1 @@
+export * from "./_api";