@qontinui/shared-types 0.2.1

package/src/task-run/_api.ts

@@ -0,0 +1,108 @@
+/**
+ * Task Run Types
+ *
+ * Merged type definitions from both runner (taskRun.ts) and web (task-runs.ts).
+ * Runner types are used for local execution, web types for backend API communication.
+ *
+ * Types generated from Rust (source of truth: qontinui-schemas/rust/src/task_run.rs).
+ * Do not edit by hand — regenerate via `just generate-types` (or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`).
+ */
+
+// =============================================================================
+// Status Types
+// =============================================================================
+
+export type { TaskRunStatus } from "../generated/TaskRunStatus";
+export type { TaskType } from "../generated/TaskType";
+
+// =============================================================================
+// Runner Task Run (local execution)
+// =============================================================================
+
+export type { TaskRun } from "../generated/TaskRun";
+
+// =============================================================================
+// Web Backend Task Run (API responses)
+// =============================================================================
+
+export type { TaskRunBackend } from "../generated/TaskRunBackend";
+
+// =============================================================================
+// Session Types
+// =============================================================================
+
+export type { TaskRunSession } from "../generated/TaskRunSession";
+
+// =============================================================================
+// Finding Types
+// =============================================================================
+
+export type { TaskRunFindingCategory } from "../generated/TaskRunFindingCategory";
+export type { TaskRunFindingSeverity } from "../generated/TaskRunFindingSeverity";
+export type { TaskRunFindingStatus } from "../generated/TaskRunFindingStatus";
+export type { TaskRunFindingActionType } from "../generated/TaskRunFindingActionType";
+export type { TaskRunFinding } from "../generated/TaskRunFinding";
+
+// Local alias: `TaskRunFindingResponse` is a TS-only convenience synonym for
+// `TaskRunFinding` (the Rust side uses `TaskRunFinding` directly).
+import type { TaskRunFinding as _TaskRunFinding } from "../generated/TaskRunFinding";
+export type TaskRunFindingResponse = _TaskRunFinding;
+
+// =============================================================================
+// Detail Types
+// =============================================================================
+
+export type { TaskRunFindingSummary } from "../generated/TaskRunFindingSummary";
+export type { TaskRunBackendDetail } from "../generated/TaskRunBackendDetail";
+
+// =============================================================================
+// Request/Update Types
+// =============================================================================
+
+export type { TaskRunCreate } from "../generated/TaskRunCreate";
+export type { TaskRunUpdate } from "../generated/TaskRunUpdate";
+export type { TaskRunFindingCreate } from "../generated/TaskRunFindingCreate";
+export type { TaskRunFindingUpdate } from "../generated/TaskRunFindingUpdate";
+
+// =============================================================================
+// Runner-Specific Request Types
+// =============================================================================
+
+// `RunPromptResponse.data` was an inline object in the old hand-authored TS;
+// the Rust side lifted it to a named `RunPromptResponseData` struct, so we
+// re-export both.
+export type { RunPromptResponseData } from "../generated/RunPromptResponseData";
+export type { RunPromptResponse } from "../generated/RunPromptResponse";
+export type { RunPromptRequest } from "../generated/RunPromptRequest";
+export type { CreateTaskRunRequest } from "../generated/CreateTaskRunRequest";
+
+// =============================================================================
+// Filter Types
+// =============================================================================
+
+export type { TaskRunFilters } from "../generated/TaskRunFilters";
+export type { TaskRunFindingFilters } from "../generated/TaskRunFindingFilters";
+
+// =============================================================================
+// Response Types
+// =============================================================================
+
+export type { Pagination } from "../generated/Pagination";
+export type { TaskRunListResponse } from "../generated/TaskRunListResponse";
+export type { TaskRunFindingsListResponse } from "../generated/TaskRunFindingsListResponse";
+export type { FindingsSummary } from "../generated/FindingsSummary";
+
+// =============================================================================
+// Verification Result Types
+// =============================================================================
+
+export type { CheckIssueDetail } from "../generated/CheckIssueDetail";
+export type { IndividualCheckResult } from "../generated/IndividualCheckResult";
+export type { VerificationStepDetails } from "../generated/VerificationStepDetails";
+export type { StepExecutionConfig } from "../generated/StepExecutionConfig";
+export type { VerificationStepResult } from "../generated/VerificationStepResult";
+export type { GateEvaluationResult } from "../generated/GateEvaluationResult";
+export type { VerificationPhaseResult } from "../generated/VerificationPhaseResult";
+export type { VerificationResultResponse } from "../generated/VerificationResultResponse";
+export type { VerificationResultsListResponse } from "../generated/VerificationResultsListResponse";

package/src/task-run/index.ts

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

package/src/tree-events/_api.ts

@@ -0,0 +1,42 @@
+/**
+ * Tree Event Types
+ *
+ * Execution logging events emitted by qontinui during automation runs.
+ * Source of truth: `qontinui-schemas/rust/src/tree_events.rs`.
+ *
+ * Used by:
+ * - qontinui (Python library) — emits events during execution
+ * - qontinui-runner (Tauri app) — receives and displays events
+ * - qontinui-web (backend + frontend) — stores, forwards, and displays events
+ *
+ * Schema shape: workflows contain actions; actions can nest (`GO_TO_STATE`,
+ * `RUN_WORKFLOW`); each event captures a node state change with rich
+ * metadata.
+ */
+
+// Enums
+export type { NodeType } from "../generated/NodeType";
+export type { NodeStatus } from "../generated/NodeStatus";
+export type { TreeEventType } from "../generated/TreeEventType";
+export type { ActionType } from "../generated/ActionType";
+
+// Nested metadata
+export type { MatchLocation } from "../generated/MatchLocation";
+export type { TopMatch } from "../generated/TopMatch";
+export type { RuntimeData } from "../generated/RuntimeData";
+export type { StateContext } from "../generated/StateContext";
+export type { TimingInfo } from "../generated/TimingInfo";
+export type { Outcome } from "../generated/Outcome";
+
+// Main models
+export type { NodeMetadata } from "../generated/NodeMetadata";
+export type { TreeNode } from "../generated/TreeNode";
+export type { PathElement } from "../generated/PathElement";
+export type { TreeEvent } from "../generated/TreeEvent";
+
+// Display + API response
+export type { DisplayNode } from "../generated/DisplayNode";
+export type { TreeEventCreate } from "../generated/TreeEventCreate";
+export type { TreeEventResponse } from "../generated/TreeEventResponse";
+export type { TreeEventListResponse } from "../generated/TreeEventListResponse";
+export type { ExecutionTreeResponse } from "../generated/ExecutionTreeResponse";

package/src/tree-events/index.ts

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

package/src/ui-bridge-ir/__tests__/legacy-roster.test.ts

@@ -0,0 +1,182 @@
+/**
+ * Legacy spec roster test (Phase A2 fixture gate).
+ *
+ * Walks the entire `qontinui_parent` monorepo, collects every shipping
+ * `*.spec.uibridge.json`, and round-trips each through:
+ *
+ *     legacy --projectLegacyToIR-->  IR  --projectIRToBundledPage-->  legacy'
+ *
+ * For each fixture we assert (semantically — not byte-strict):
+ *   - same number of groups
+ *   - same group ids in input order
+ *   - same total assertion count across all groups
+ *
+ * This is coarse but effective: it catches any data loss in the inverse
+ * projection without forcing the inverse to preserve hand-edited assertion
+ * ids / severity / category / etc. (which the forward direction regenerates
+ * from defaults). Phase A4 will tighten the contract for hand-authored
+ * fields.
+ *
+ * The walker fails fast if it finds < 100 fixtures (canary against a
+ * misconfigured directory walk) — current expected count is 121 (96 runner +
+ * 19 web + 5 mobile + 2 supervisor) as of 2026-04. The number is allowed to
+ * grow; the lower bound just guards against accidentally testing nothing.
+ */
+
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+
+import { describe, expect, it } from "vitest";
+
+import {
+  projectIRToBundledPage,
+  projectLegacyToIR,
+  type LegacySpec,
+} from "../projection";
+
+// ---------------------------------------------------------------------------
+// Discovery
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve the monorepo root from the test file's location. The test file
+ * lives at `qontinui-schemas/ts/src/ui-bridge-ir/__tests__/`, so five
+ * `..` segments take us to `qontinui_parent/`.
+ *
+ * Use `process.cwd()` as a fallback only when the test runs from outside the
+ * usual layout (e.g. CI checkout with renamed parent) — vitest sets cwd to
+ * the package root by default.
+ */
+const MONOREPO_ROOT = path.resolve(
+  __dirname,
+  "..",
+  "..",
+  "..",
+  "..",
+  "..",
+);
+
+// Directories to skip. Note: do NOT include "build" — Next.js apps have route
+// folders named `build/` (e.g., qontinui-web/frontend/src/app/(app)/build/)
+// that legitimately contain spec fixtures.
+const SKIP_DIRS = new Set([
+  "node_modules",
+  "target",
+  "target-agent",
+  "dist",
+  ".git",
+  ".next",
+  ".venv",
+  "__pycache__",
+  "out",
+]);
+
+/**
+ * Recursively walk `root`, collecting every `*.spec.uibridge.json` file.
+ * Skips the directory names in `SKIP_DIRS`. Synchronous; the fixture set is
+ * small (low hundreds) so we don't bother with worker threads.
+ */
+function collectSpecs(root: string): string[] {
+  const out: string[] = [];
+  const stack: string[] = [root];
+  while (stack.length > 0) {
+    const current = stack.pop()!;
+    let entries: import("node:fs").Dirent[];
+    try {
+      entries = readdirSync(current, { withFileTypes: true });
+    } catch {
+      // Permission errors / vanished dirs — skip silently.
+      continue;
+    }
+    for (const entry of entries) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      const full = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(full);
+      } else if (entry.isFile() && entry.name.endsWith(".spec.uibridge.json")) {
+        out.push(full);
+      } else if (entry.isSymbolicLink()) {
+        // Resolve symlinks defensively — some plugin checkouts use them.
+        try {
+          const stat = statSync(full);
+          if (stat.isDirectory()) {
+            stack.push(full);
+          } else if (stat.isFile() && entry.name.endsWith(".spec.uibridge.json")) {
+            out.push(full);
+          }
+        } catch {
+          // ignore
+        }
+      }
+    }
+  }
+  // Sort for deterministic test ordering.
+  out.sort();
+  return out;
+}
+
+const SPECS = collectSpecs(MONOREPO_ROOT);
+
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+
+describe("legacy spec roster — discovery sanity", () => {
+  it("finds at least 100 *.spec.uibridge.json files in the monorepo", () => {
+    expect(SPECS.length).toBeGreaterThanOrEqual(100);
+  });
+
+  it("does not include node_modules / dist / target paths", () => {
+    for (const f of SPECS) {
+      expect(f).not.toMatch(/[\\/](?:node_modules|dist|target|\.git)[\\/]/);
+    }
+  });
+});
+
+describe("legacy spec roster — round-trip via IR", () => {
+  // Use it.each so every fixture gets its own test name and failures pinpoint
+  // the exact file. Pre-load each fixture as a tuple for the iterator.
+  const cases: ReadonlyArray<readonly [string, string]> = SPECS.map((p) => [
+    path.relative(MONOREPO_ROOT, p),
+    p,
+  ] as const);
+
+  it.each(cases)("%s round-trips through IR without data loss", (_relpath, full) => {
+    let raw = readFileSync(full, "utf-8");
+    // Strip UTF-8 BOM if present — at least one shipping spec
+    // (settings-security.spec.uibridge.json) was saved with a BOM.
+    if (raw.charCodeAt(0) === 0xfeff) raw = raw.slice(1);
+    const legacy = JSON.parse(raw) as LegacySpec;
+
+    const ir = projectLegacyToIR(legacy);
+    const projected = projectIRToBundledPage(ir);
+
+    // 1. Same number of groups.
+    expect(projected.groups.length).toBe(legacy.groups.length);
+
+    // 2. Same group ids in input order.
+    expect(projected.groups.map((g) => g.id)).toEqual(legacy.groups.map((g) => g.id));
+
+    // 3. Same total assertion count across all groups (coarse data-loss check).
+    const projectedAssertionCount = projected.groups.reduce(
+      (sum, g) => sum + g.assertions.length,
+      0,
+    );
+    const legacyAssertionCount = legacy.groups.reduce(
+      (sum, g) => sum + (Array.isArray(g.assertions) ? g.assertions.length : 0),
+      0,
+    );
+    // The forward projection emits a placeholder assertion for any state with
+    // zero requiredElements. Real legacy fixtures never have zero-assertion
+    // groups, but be defensive: allow projected >= legacy when legacy had
+    // groups with zero assertions.
+    const legacyHasEmptyGroup = legacy.groups.some(
+      (g) => !Array.isArray(g.assertions) || g.assertions.length === 0,
+    );
+    if (legacyHasEmptyGroup) {
+      expect(projectedAssertionCount).toBeGreaterThanOrEqual(legacyAssertionCount);
+    } else {
+      expect(projectedAssertionCount).toBe(legacyAssertionCount);
+    }
+  });
+});