@qontinui/shared-types 0.2.4 → 0.3.0

package/src/geometry/_api.ts

@@ -1,16 +1,16 @@
-/**
- * Geometry Types
- *
- * Screen coordinates, regions, monitors, and virtual-desktop layouts.
- * Source of truth: `qontinui-schemas/rust/src/geometry.rs`.
- *
- * Multi-monitor setups use three distinct coordinate systems — see
- * `CoordinateSystem` for the semantics.
- */
-
-export type { CoordinateSystem } from "../generated/CoordinateSystem";
-export type { Coordinates } from "../generated/Coordinates";
-export type { Region } from "../generated/Region";
-export type { MonitorPosition } from "../generated/MonitorPosition";
-export type { Monitor } from "../generated/Monitor";
-export type { VirtualDesktop } from "../generated/VirtualDesktop";
+/**
+ * Geometry Types
+ *
+ * Screen coordinates, regions, monitors, and virtual-desktop layouts.
+ * Source of truth: `qontinui-schemas/rust/src/geometry.rs`.
+ *
+ * Multi-monitor setups use three distinct coordinate systems — see
+ * `CoordinateSystem` for the semantics.
+ */
+
+export type { CoordinateSystem } from "../generated/CoordinateSystem";
+export type { Coordinates } from "../generated/Coordinates";
+export type { Region } from "../generated/Region";
+export type { MonitorPosition } from "../generated/MonitorPosition";
+export type { Monitor } from "../generated/Monitor";
+export type { VirtualDesktop } from "../generated/VirtualDesktop";

package/src/geometry/index.ts

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

package/src/index.ts

@@ -1,73 +1,78 @@
-/**
- * @qontinui/shared-types
- *
- * Shared TypeScript types for the Qontinui ecosystem.
- */
-
-// Render logging types
-export * from "./render-log";
-
-// State discovery types
-export * from "./discovery";
-
-// Workflow types — import from _api directly (not the ./workflow entry) so
-// rollup's dts bundler doesn't see the same types in two entry graphs and
-// suffix collisions with $1/$2/$3. See tsup.config.ts for the entry list.
-export * from "./workflow/_api";
-
-// Task run types
-export * from "./task-run/_api";
-
-// Execution types
-export * from "./execution/_api";
-
-// Scheduler types
-export * from "./scheduler/_api";
-
-// Runner types (canonical Runner entity)
-export * from "./runner/_api";
-
-// Library types
-export * from "./library/_api";
-
-// Chat types
-export * from "./chat/_api";
-
-// Canvas types
-export * from "./canvas";
-
-// Known Issues types
-export * from "./known-issues";
-
-// State Machine types
-export * from "./state-machine/_api";
-
-// Constraint Engine types
-export * from "./constraints/_api";
-
-// Geometry types (screen coordinates, regions, monitors) — see
-// `@qontinui/shared-types/geometry` subpath export.
-export * from "./geometry/_api";
-
-// Tree event types (execution logging) are NOT re-exported here because
-// `tree_events.ActionType` collides with `execution.ActionType` (different
-// enums, same name). Consumers should import from the subpath:
-//   import { TreeEvent, ActionType } from "@qontinui/shared-types/tree-events";
-
-// Accessibility tree types (CDP / UIA / AT-SPI / AX capture + selectors).
-export * from "./accessibility/_api";
-
-// Config types (AI context + workflow category) are NOT re-exported here
-// because `config.Context` (AI-task context) collides with `library.Context`
-// (library item with richer shape). Consumers use the subpath:
-//   import { Context, Category } from "@qontinui/shared-types/config";
-
-// Target configuration (discriminated union for action targets) is subpath
-// only — `SearchStrategy` and other names overlap with action-schema
-// internals in consumer repos and the type surface is large.
-//   import { TargetConfig } from "@qontinui/shared-types/targets";
-
-// RAG API types are subpath only — `SearchResultItem` and `JobStatus`
-// collide with other modules that model unrelated "search result" / "job"
-// concepts.
-//   import { JobStatus, RAGDashboardStats } from "@qontinui/shared-types/rag";
+/**
+ * @qontinui/shared-types
+ *
+ * Shared TypeScript types for the Qontinui ecosystem.
+ */
+
+// Render logging types
+export * from "./render-log";
+
+// Spec-check distinctness validation (Plan 04). Surfaced from the
+// auto-generated Rust mirror — see qontinui-schemas/rust/src/spec_check.rs.
+export type { SpecValidation } from "./generated/SpecValidation";
+export type { ProposalStatus } from "./generated/ProposalStatus";
+
+// State discovery types
+export * from "./discovery";
+
+// Workflow types — import from _api directly (not the ./workflow entry) so
+// rollup's dts bundler doesn't see the same types in two entry graphs and
+// suffix collisions with $1/$2/$3. See tsup.config.ts for the entry list.
+export * from "./workflow/_api";
+
+// Task run types
+export * from "./task-run/_api";
+
+// Execution types
+export * from "./execution/_api";
+
+// Scheduler types
+export * from "./scheduler/_api";
+
+// Runner types (canonical Runner entity)
+export * from "./runner/_api";
+
+// Library types
+export * from "./library/_api";
+
+// Chat types
+export * from "./chat/_api";
+
+// Canvas types
+export * from "./canvas";
+
+// Known Issues types
+export * from "./known-issues";
+
+// State Machine types
+export * from "./state-machine/_api";
+
+// Constraint Engine types
+export * from "./constraints/_api";
+
+// Geometry types (screen coordinates, regions, monitors) — see
+// `@qontinui/shared-types/geometry` subpath export.
+export * from "./geometry/_api";
+
+// Tree event types (execution logging) are NOT re-exported here because
+// `tree_events.ActionType` collides with `execution.ActionType` (different
+// enums, same name). Consumers should import from the subpath:
+//   import { TreeEvent, ActionType } from "@qontinui/shared-types/tree-events";
+
+// Accessibility tree types (CDP / UIA / AT-SPI / AX capture + selectors).
+export * from "./accessibility/_api";
+
+// Config types (AI context + workflow category) are NOT re-exported here
+// because `config.Context` (AI-task context) collides with `library.Context`
+// (library item with richer shape). Consumers use the subpath:
+//   import { Context, Category } from "@qontinui/shared-types/config";
+
+// Target configuration (discriminated union for action targets) is subpath
+// only — `SearchStrategy` and other names overlap with action-schema
+// internals in consumer repos and the type surface is large.
+//   import { TargetConfig } from "@qontinui/shared-types/targets";
+
+// RAG API types are subpath only — `SearchResultItem` and `JobStatus`
+// collide with other modules that model unrelated "search result" / "job"
+// concepts.
+//   import { JobStatus, RAGDashboardStats } from "@qontinui/shared-types/rag";

package/src/known-issues/index.ts

@@ -1,179 +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" },
-];
+/**
+ * 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" },
+];