@qontinui/shared-types 0.8.1 → 0.12.0

package/src/generated/SavedProject.d.ts

@@ -0,0 +1,102 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A project the user has told the runner about (typically via the setup
+ * wizard's project picker, the new-project flow, or the Projects
+ * dashboard's "find on disk" discovery).
+ *
+ * Persisted to `settings.json` under the `saved_projects` key.
+ *
+ * `id` is the stable key: a project's `path` can move on disk (renamed
+ * folder, relocated workspace) but its identity must not. Entries persisted
+ * before `id` existed are backfilled with a freshly-minted UUID on first
+ * load — `#[serde(default)]` exists only so that load succeeds, never as a
+ * legitimate steady-state value.
+ *
+ * `project_type` is deliberately a free-form `String` so a new framework
+ * never requires a schema change.
+ * `Default` exists so a producer that only knows a few fields can write
+ * `SavedProject { path, name, ..Default::default() }` — the new-project flow
+ * and the setup wizard both do. A defaulted `id` is the empty string, which
+ * the registry treats as "mint me one" (see the field docs), never as a key.
+ */
+export interface SavedProject {
+  /**
+   * Accent colour for the card, as a CSS colour string.
+   */
+  color?: string | null;
+  /**
+   * One-line plain-English description ("Website for the pizzeria, with
+   * menu + ordering"). Shown on the project card under the name.
+   */
+  description?: string | null;
+  /**
+   * Emoji used as the card's visual identity (e.g. "🍕").
+   */
+  emoji?: string | null;
+  /**
+   * The project's front page ("http://localhost:3000"). Seeded from the
+   * setup wizard's dev-server port detection; user-correctable.
+   */
+  frontPageUrl?: string | null;
+  /**
+   * Stable identifier (UUID). Survives a path move; the registry key.
+   */
+  id: string;
+  /**
+   * Unix epoch milliseconds of the last time the project was activated.
+   */
+  lastOpenedMs?: number | null;
+  /**
+   * Manifest file that identified the project (e.g. "package.json").
+   */
+  manifest: string;
+  /**
+   * Human-friendly display name (usually the directory basename).
+   */
+  name: string;
+  /**
+   * The user's own free-form notes about the project.
+   */
+  notes?: string | null;
+  /**
+   * Absolute path to the project root.
+   */
+  path: string;
+  /**
+   * Pinned projects sort first and render as sidebar entries.
+   */
+  pinned: boolean;
+  /**
+   * Ids of the `ProcessConfig` entries this project owns.
+   */
+  processIds: string[];
+  /**
+   * Framework/language tag, e.g. "react", "python", "rust", "node".
+   */
+  projectType: string;
+  /**
+   * `owner/name` GitHub slug, from `repo_detection::detect_repo_slug`.
+   */
+  repoSlug?: string | null;
+  /**
+   * Bound Terminal page id.
+   *
+   * **A hint, not a handle.** Terminal pages persist to the frontend's
+   * `instanceStorage` (localStorage, port-namespaced), which Rust cannot
+   * read, so this id can name a page that does not exist in the current
+   * window. Activation must treat an unknown id as "not created yet" —
+   * create a page named after the project and rewrite the id — and must
+   * never fail on a dangling value.
+   */
+  terminalPageId?: string | null;
+  /**
+   * Terminal zone profile to restore when the project is activated.
+   */
+  zoneProfile?: string | null;
+}

package/src/generated/SessionLite.d.ts

@@ -0,0 +1,44 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { SessionSource } from "./SessionSource";
+
+/**
+ * One session attributed to a project — either a live terminal or an AI
+ * session reconstructed from its touched files.
+ */
+export interface SessionLite {
+  /**
+   * Number of distinct files this session touched **under this project
+   * root**. Zero for terminal-sourced rows.
+   */
+  filesTouched: number;
+  /**
+   * `task_runs.id` for AI sessions, the terminal id for live terminals.
+   */
+  id: string;
+  /**
+   * Unix epoch milliseconds of the most recent observed activity —
+   * `max(recorded_at)` over the session's touched files, or the
+   * terminal's creation time.
+   */
+  lastActivityMs?: number | null;
+  /**
+   * Session name — `task_runs.task_name` or the terminal's title.
+   */
+  name?: string | null;
+  source: SessionSource;
+  /**
+   * `task_runs.status` ("running", "completed", …) for AI sessions;
+   * `None` for terminals (liveness is `is_alive` in the terminal list).
+   */
+  status?: string | null;
+  /**
+   * Working directory, when known (terminal sessions always carry one).
+   */
+  workingDir?: string | null;
+}

package/src/generated/SessionSource.d.ts

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Where a [`SessionLite`] was observed.
+ */
+export type SessionSource = "terminal" | "touched_files";

package/src/generated/SpecCheckResult.d.ts

@@ -30,6 +30,12 @@ import type { StateMatchResult } from "./StateMatchResult";
  */
 export interface SpecCheckResult {
   bridgeFingerprint: BridgeFingerprint;
+  /**
+   * Red/Yellow/Green classification of the overall match rate.
+   * Derived from `summary.overall_match_rate` and the app's configured
+   * thresholds at evaluation time (see `thresholds_used`).
+   */
+  classification: "red" | "yellow" | "green";
   /**
    * ISO-8601 UTC. When the spec was hashed and the snapshot indexed.
    */
@@ -72,6 +78,7 @@ export interface SpecCheckResult {
    */
   stateResults: StateMatchResult[];
   summary: SpecCheckSummary;
+  thresholdsUsed: ThresholdConfig;
   /**
    * Soft signals — currently used for `Stale` from `SnapshotFetchError`.
    */

package/src/generated/StateMatchResult.d.ts

@@ -21,6 +21,11 @@ export interface StateMatchResult {
    * One entry per IR assertion in the state.
    */
   assertions: AssertionResult[];
+  /**
+   * Red/Yellow/Green classification of this state's match rate.
+   * Derived from `match_rate` and the app's configured thresholds.
+   */
+  classification: "red" | "yellow" | "green";
   /**
    * Fraction of assertions that passed (0.0..=1.0).
    */

package/src/generated/UIBridgeComponent.d.ts

@@ -14,6 +14,16 @@ import type { ComponentActionInfo } from "./ComponentActionInfo";
  * (e.g. "submit form", "reset filters").
  */
 export interface UIBridgeComponent {
+  /**
+   * Invocation-path template for this component's actions, emitted with a
+   * literal `{actionId}` placeholder:
+   * `/control/component/<componentId>/action/{actionId}`.
+   *
+   * **Server-annotated, not author-declared**: emitted by the SDK's
+   * `annotateComponentWithInvocationPaths` alongside the per-action
+   * [`ComponentActionInfo::path`].
+   */
+  actionInvocationPath?: string | null;
   /**
    * Actions exposed by this component.
    */

package/src/generated/UpdateAppRequest.d.ts

@@ -6,7 +6,31 @@
  */
 
 export interface UpdateAppRequest {
+  /**
+   * Whether this app requires authentication before spec checks.
+   */
+  authRequired?: boolean | null;
+  /**
+   * Build command for "pull_build" strategy.
+   */
+  buildCommand?: string | null;
   displayName?: string | null;
+  /**
+   * Red threshold for spec match rates (0.0–1.0). Must be < yellow_threshold.
+   */
+  redThreshold?: number | null;
+  /**
+   * Start command to restart after build.
+   */
+  startCommand?: string | null;
   uiBridgeUrl?: string | null;
+  /**
+   * Auto-fresh update strategy: "pull_only" or "pull_build".
+   */
+  updateStrategy?: string | null;
+  /**
+   * Yellow threshold for spec match rates (0.0–1.0). Must be > red_threshold.
+   */
+  yellowThreshold?: number | null;
   [k: string]: unknown;
 }

package/src/generated/index.ts

@@ -18,6 +18,9 @@ export type { ActionResponse } from './ActionResponse';
 export type { ActionStatus } from './ActionStatus';
 export type { ActionType } from './ActionType';
 export type { ActiveStatesResult } from './ActiveStatesResult';
+export type { AgentCommand } from './AgentCommand';
+export type { AgentCommandError } from './AgentCommandError';
+export type { AgentCommandVersion } from './AgentCommandVersion';
 export type { AgenticPhaseOutput } from './AgenticPhaseOutput';
 export type { AgenticStatus } from './AgenticStatus';
 export type { AiWorkflow } from './AiWorkflow';
@@ -184,9 +187,21 @@ export type { FunctionalSpec } from './FunctionalSpec';
 export type { GUIElementChunk } from './GUIElementChunk';
 export type { GapReason } from './GapReason';
 export type { GateEvaluationResult } from './GateEvaluationResult';
+export type { GitCommitLite } from './GitCommitLite';
+export type { GitLite } from './GitLite';
 export type { GitOpListResponse } from './GitOpListResponse';
 export type { GitOpRecord } from './GitOpRecord';
 export type { HealthCheckUrl } from './HealthCheckUrl';
+export type { HealthLevel } from './HealthLevel';
+export type { HealthLite } from './HealthLite';
+export type { HelperAnswer } from './HelperAnswer';
+export type { HelperAnswerSchema } from './HelperAnswerSchema';
+export type { HelperTask } from './HelperTask';
+export type { HelperTaskKind } from './HelperTaskKind';
+export type { HelperTaskPayload } from './HelperTaskPayload';
+export type { HelperTaskSource } from './HelperTaskSource';
+export type { HelperTaskStatus } from './HelperTaskStatus';
+export type { HelperVerdict } from './HelperVerdict';
 export type { HistoricalActionQuery } from './HistoricalActionQuery';
 export type { HistoricalActionResult } from './HistoricalActionResult';
 export type { HttpConfig } from './HttpConfig';
@@ -288,6 +303,7 @@ export type { PathfindingRequest } from './PathfindingRequest';
 export type { PathfindingResult } from './PathfindingResult';
 export type { PathfindingStep } from './PathfindingStep';
 export type { PatternOptions } from './PatternOptions';
+export type { PendingQuestion } from './PendingQuestion';
 export type { PipelineConfig } from './PipelineConfig';
 export type { PlaybackFrameRequest } from './PlaybackFrameRequest';
 export type { PlaywrightExecutionMode } from './PlaywrightExecutionMode';
@@ -299,7 +315,9 @@ export type { PollingConfig } from './PollingConfig';
 export type { ProcessConfig } from './ProcessConfig';
 export type { ProcessState } from './ProcessState';
 export type { ProcessStatus } from './ProcessStatus';
+export type { ProcessStatusLite } from './ProcessStatusLite';
 export type { Profile } from './Profile';
+export type { ProjectSnapshot } from './ProjectSnapshot';
 export type { PromptStep } from './PromptStep';
 export type { PromptStepPhase } from './PromptStepPhase';
 export type { ProposalStatus } from './ProposalStatus';
@@ -345,6 +363,7 @@ export type { RunnerStatusEvent } from './RunnerStatusEvent';
 export type { RunnerUiError } from './RunnerUiError';
 export type { RuntimeData } from './RuntimeData';
 export type { SaveWorkflowArtifactStep } from './SaveWorkflowArtifactStep';
+export type { SavedProject } from './SavedProject';
 export type { ScheduleConditions } from './ScheduleConditions';
 export type { ScheduleExpression } from './ScheduleExpression';
 export type { ScheduledTask } from './ScheduledTask';
@@ -362,6 +381,8 @@ export type { SearchStrategy } from './SearchStrategy';
 export type { SectionVerdict } from './SectionVerdict';
 export type { SemanticSearchRequest } from './SemanticSearchRequest';
 export type { SemanticSearchResponse } from './SemanticSearchResponse';
+export type { SessionLite } from './SessionLite';
+export type { SessionSource } from './SessionSource';
 export type { SpecApiEvent } from './SpecApiEvent';
 export type { SpecCheckConfidence } from './SpecCheckConfidence';
 export type { SpecCheckPolicy } from './SpecCheckPolicy';

package/src/index.ts

@@ -12,6 +12,20 @@ export * from "./render-log";
 export type { SpecValidation } from "./generated/SpecValidation";
 export type { ProposalStatus } from "./generated/ProposalStatus";
 
+// Projects dashboard — the saved-project registry and its joined snapshot
+// view. Generated from `rust/src/projects.rs`; `SavedProject` replaces the
+// hand-written interface the runner carried in `hooks/useSavedProjects.ts`.
+export type { SavedProject } from "./generated/SavedProject";
+export type { ProjectSnapshot } from "./generated/ProjectSnapshot";
+export type { ProcessStatusLite } from "./generated/ProcessStatusLite";
+export type { SessionLite } from "./generated/SessionLite";
+export type { SessionSource } from "./generated/SessionSource";
+export type { GitLite } from "./generated/GitLite";
+export type { GitCommitLite } from "./generated/GitCommitLite";
+export type { PendingQuestion } from "./generated/PendingQuestion";
+export type { HealthLite } from "./generated/HealthLite";
+export type { HealthLevel } from "./generated/HealthLevel";
+
 // State discovery types
 export * from "./discovery";