@qontinui/shared-types 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -966,6 +966,192 @@ declare function toDiscoveredState(data: unknown): DiscoveredState;
 declare function toDiscoveredTransition(data: unknown): DiscoveredTransition;
 declare function toStateDiscoveryResultSummary(data: Record<string, unknown>): StateDiscoveryResultSummary;
 
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/upsert` body. `name` + `content` are the only
+ * required fields; the rest is optional metadata.
+ *
+ * UUID fields (`written_by_agent`, `written_by_device`) are `String` on
+ * the wire; coord parses them with `Uuid::parse_str` and returns 400
+ * on parse failure.
+ */
+interface MemoryUpsertRequest {
+  content: string;
+  description?: string | null;
+  name: string;
+  type?: string | null;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/upsert` response.
+ */
+interface MemoryUpsertResponse {
+  memory_id: string;
+  name: string;
+  version: number;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/:name/restore` body.
+ */
+interface MemoryRestoreRequest {
+  version: number;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+/**
+ * `GET /coord/memory/list` query string.
+ */
+interface MemoryListQuery {
+  limit?: number | null;
+  name_prefix?: string | null;
+  type?: string | null;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+/**
+ * One row in `coord.memories`. Returned by `GET /coord/memory/:name`
+ * (as the `latest` field of `MemoryWithHistory` + each `history` entry)
+ * and by `GET /coord/memory/:name/version/:version`.
+ */
+interface MemoryRow {
+  content: string;
+  description?: string | null;
+  is_tombstone: boolean;
+  memory_id: string;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+/**
+ * Lighter-weight projection for `/coord/memory/list` — strips the
+ * (potentially-large) `content` blob so a list-all-memories scan stays
+ * cheap. Fetch full payload via `GET /coord/memory/:name`.
+ */
+interface MemorySummary {
+  description?: string | null;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+
+
+/**
+ * `GET /coord/memory/:name` response — latest row + the 10
+ * most-recent versions (DESC). The first entry of `history` is the
+ * same row as `latest`; subsequent entries are prior versions
+ * (including tombstones, so the dashboard can render "deleted at v3
+ * then restored at v4").
+ *
+ * `latest` is flattened on the wire — the response object's top-level
+ * fields are the `MemoryRow` columns plus a `history` array.
+ */
+interface MemoryWithHistory {
+  content: string;
+  description?: string | null;
+  history: MemoryRow[];
+  is_tombstone: boolean;
+  memory_id: string;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}
+
+/* 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`.
+ */
+
+
+
+/**
+ * `GET /coord/memory/list` response envelope. Wrapped in a struct
+ * (rather than a bare `Vec<MemorySummary>`) so the generated TS / Python
+ * schemas get a named exported interface rather than an anonymous array
+ * alias.
+ */
+interface MemoryListResponse {
+  items: MemorySummary[];
+  [k: string]: unknown;
+}
+
 /**
  * Canvas Types
  *
@@ -1365,4 +1551,4 @@ declare const DETECTION_METHODS: {
     label: string;
 }[];
 
-export { type AcceptanceCriteriaData, type AlertData, type CanvasComponentType, type CanvasPanel, type CanvasUpdateEvent, type ChecklistData, type CodeDiffData, type ComponentRenderLogEntry, type CostBreakdownData, type CreateKnownIssueRequest, type CreatePatternTemplateRequest, type CreateRenderLogRequest, DETECTION_METHODS, type DependencyGraphData, type DetectionMethod, type DiscoveredState, type DiscoveredStateImage, type DiscoveredTransition, type DiscoveryBoundingBox, type DiscoverySourceType, type DiscoveryTransitionTrigger, type DomElementSnapshot, type DomMutationType, type DomSnapshot, type DomSnapshotRenderLogEntry, type ElementRect, type FileTreeData, type FindingListData, type FormSnapshot, ISSUE_CATEGORIES, ISSUE_SEVERITIES, type ImageSnapshot, type IssueCategory, type IssuePatternTemplate, type IssueProvenance, type IssueStatus, type IterationComparisonData, type KeyValueData, type KnownIssue, type KnownIssueSeverity, type LinkSnapshot, type ListKnownIssuesQuery, type MarkdownData, type MissionBriefData, type PhaseDistributionData, type PhaseTimelineData, type ProgressChartData, type ProposalStatus, type RenderLogEntry, type RenderLogEntryBase, type RenderLogList, type RenderLogResponse, type RenderLogStats, type RenderLogSummary, type RenderLogTrigger, SOURCE_TYPE_COLORS, SOURCE_TYPE_LABELS, type ScopeType, type SparklineData, type SpecValidation, type StateDiscoveryResult, type StateDiscoveryResultCreate, type StateDiscoveryResultListResponse, type StateDiscoveryResultSummary, type StateDiscoveryResultUpdate, type StateMachineExport, type StateMachineImport, type StateTimelineData, type StepDurationChartData, type SummaryStatsData, type TableData, type TemplateParameter, type TerminalData, type TimelineData, type TransitionTriggerType, type UpdateKnownIssueRequest, type WaffleChartData, type WaterfallData, isComponentRenderLog, isDomSnapshotRenderLog, toDiscoveredState, toDiscoveredStateImage, toDiscoveredTransition, toStateDiscoveryResult, toStateDiscoveryResultSummary };
+export { type AcceptanceCriteriaData, type AlertData, type CanvasComponentType, type CanvasPanel, type CanvasUpdateEvent, type ChecklistData, type CodeDiffData, type ComponentRenderLogEntry, type CostBreakdownData, type CreateKnownIssueRequest, type CreatePatternTemplateRequest, type CreateRenderLogRequest, DETECTION_METHODS, type DependencyGraphData, type DetectionMethod, type DiscoveredState, type DiscoveredStateImage, type DiscoveredTransition, type DiscoveryBoundingBox, type DiscoverySourceType, type DiscoveryTransitionTrigger, type DomElementSnapshot, type DomMutationType, type DomSnapshot, type DomSnapshotRenderLogEntry, type ElementRect, type FileTreeData, type FindingListData, type FormSnapshot, ISSUE_CATEGORIES, ISSUE_SEVERITIES, type ImageSnapshot, type IssueCategory, type IssuePatternTemplate, type IssueProvenance, type IssueStatus, type IterationComparisonData, type KeyValueData, type KnownIssue, type KnownIssueSeverity, type LinkSnapshot, type ListKnownIssuesQuery, type MarkdownData, type MemoryListQuery, type MemoryListResponse, type MemoryRestoreRequest, type MemoryRow, type MemorySummary, type MemoryUpsertRequest, type MemoryUpsertResponse, type MemoryWithHistory, type MissionBriefData, type PhaseDistributionData, type PhaseTimelineData, type ProgressChartData, type ProposalStatus, type RenderLogEntry, type RenderLogEntryBase, type RenderLogList, type RenderLogResponse, type RenderLogStats, type RenderLogSummary, type RenderLogTrigger, SOURCE_TYPE_COLORS, SOURCE_TYPE_LABELS, type ScopeType, type SparklineData, type SpecValidation, type StateDiscoveryResult, type StateDiscoveryResultCreate, type StateDiscoveryResultListResponse, type StateDiscoveryResultSummary, type StateDiscoveryResultUpdate, type StateMachineExport, type StateMachineImport, type StateTimelineData, type StepDurationChartData, type SummaryStatsData, type TableData, type TemplateParameter, type TerminalData, type TimelineData, type TransitionTriggerType, type UpdateKnownIssueRequest, type WaffleChartData, type WaterfallData, isComponentRenderLog, isDomSnapshotRenderLog, toDiscoveredState, toDiscoveredStateImage, toDiscoveredTransition, toStateDiscoveryResult, toStateDiscoveryResultSummary };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/App.d.ts

@@ -0,0 +1,16 @@
+/* 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`.
+ */
+
+export interface App {
+  appId: string;
+  createdAtMs: number;
+  displayName: string;
+  lastSeenAtMs: number;
+  repoRoot: string;
+  uiBridgeUrl: string;
+  [k: string]: unknown;
+}

package/src/generated/AppError.d.ts

@@ -0,0 +1,33 @@
+/* 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`.
+ */
+
+/**
+ * Failure modes for app-registry operations. Mirrors the
+ * `responses::SpecError` tagged-enum pattern in
+ * `qontinui-runner/src-tauri/src/spec_api/responses.rs`.
+ */
+export type AppError =
+  | {
+      app_id: string;
+      reason: "not-registered";
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      reason: "invalid-app-id";
+      [k: string]: unknown;
+    }
+  | {
+      reason: "invalid-repo-root";
+      repo_root: string;
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      reason: "already-registered";
+      [k: string]: unknown;
+    };

package/src/generated/AppListResponse.d.ts

@@ -0,0 +1,14 @@
+/* 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 { App } from './App';
+
+export interface AppListResponse {
+  apps: App[];
+  ok: boolean;
+  [k: string]: unknown;
+}

package/src/generated/IrProvenance.d.ts

@@ -8,6 +8,23 @@
 import type { ProposalStatus } from './ProposalStatus';
 
 export interface IrProvenance {
+  /**
+   * Owning app id (slug). Multi-tenant Spec API contract: every IR
+   * document is self-describing about which registered app it belongs
+   * to. `#[serde(default)]` allows pre-multi-app on-disk IRs (no
+   * `app_id` field) to deserialize as empty string; handlers and the
+   * `POST /apps/<id>/spec/author` adapter validate non-empty and fill
+   * from the URL path on read (Stream C safety-net). Stream F's bulk
+   * backfill rewrites every on-disk IR so empty values don't persist.
+   * TS / Python codegen promote serde defaults to required per the
+   * `qontinui-schemas` project convention.
+   *
+   * `skip_serializing_if = "String::is_empty"` preserves byte-identical
+   * round-trip for pre-multi-app on-disk IRs that lack the field.
+   * Post-Stream-F backfill, every IR has a non-empty `app_id` so the
+   * skip never fires.
+   */
+  appId?: string;
   column?: number | null;
   file?: string | null;
   line?: number | null;

package/src/generated/MemoryListQuery.d.ts

@@ -0,0 +1,16 @@
+/* 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`.
+ */
+
+/**
+ * `GET /coord/memory/list` query string.
+ */
+export interface MemoryListQuery {
+  limit?: number | null;
+  name_prefix?: string | null;
+  type?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/MemoryListResponse.d.ts

@@ -0,0 +1,19 @@
+/* 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 { MemorySummary } from './MemorySummary';
+
+/**
+ * `GET /coord/memory/list` response envelope. Wrapped in a struct
+ * (rather than a bare `Vec<MemorySummary>`) so the generated TS / Python
+ * schemas get a named exported interface rather than an anonymous array
+ * alias.
+ */
+export interface MemoryListResponse {
+  items: MemorySummary[];
+  [k: string]: unknown;
+}

package/src/generated/MemoryRestoreRequest.d.ts

@@ -0,0 +1,16 @@
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/:name/restore` body.
+ */
+export interface MemoryRestoreRequest {
+  version: number;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/MemoryRow.d.ts

@@ -0,0 +1,28 @@
+/* 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`.
+ */
+
+/**
+ * One row in `coord.memories`. Returned by `GET /coord/memory/:name`
+ * (as the `latest` field of `MemoryWithHistory` + each `history` entry)
+ * and by `GET /coord/memory/:name/version/:version`.
+ */
+export interface MemoryRow {
+  content: string;
+  description?: string | null;
+  is_tombstone: boolean;
+  memory_id: string;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/MemorySummary.d.ts

@@ -0,0 +1,23 @@
+/* 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`.
+ */
+
+/**
+ * Lighter-weight projection for `/coord/memory/list` — strips the
+ * (potentially-large) `content` blob so a list-all-memories scan stays
+ * cheap. Fetch full payload via `GET /coord/memory/:name`.
+ */
+export interface MemorySummary {
+  description?: string | null;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  [k: string]: unknown;
+}

package/src/generated/MemoryUpsertRequest.d.ts

@@ -0,0 +1,24 @@
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/upsert` body. `name` + `content` are the only
+ * required fields; the rest is optional metadata.
+ *
+ * UUID fields (`written_by_agent`, `written_by_device`) are `String` on
+ * the wire; coord parses them with `Uuid::parse_str` and returns 400
+ * on parse failure.
+ */
+export interface MemoryUpsertRequest {
+  content: string;
+  description?: string | null;
+  name: string;
+  type?: string | null;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/MemoryUpsertResponse.d.ts

@@ -0,0 +1,16 @@
+/* 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`.
+ */
+
+/**
+ * `POST /coord/memory/upsert` response.
+ */
+export interface MemoryUpsertResponse {
+  memory_id: string;
+  name: string;
+  version: number;
+  [k: string]: unknown;
+}

package/src/generated/MemoryWithHistory.d.ts

@@ -0,0 +1,36 @@
+/* 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 { MemoryRow } from './MemoryRow';
+
+/**
+ * `GET /coord/memory/:name` response — latest row + the 10
+ * most-recent versions (DESC). The first entry of `history` is the
+ * same row as `latest`; subsequent entries are prior versions
+ * (including tombstones, so the dashboard can render "deleted at v3
+ * then restored at v4").
+ *
+ * `latest` is flattened on the wire — the response object's top-level
+ * fields are the `MemoryRow` columns plus a `history` array.
+ */
+export interface MemoryWithHistory {
+  content: string;
+  description?: string | null;
+  history: MemoryRow[];
+  is_tombstone: boolean;
+  memory_id: string;
+  name: string;
+  type?: string | null;
+  version: number;
+  /**
+   * ISO 8601 timestamp (RFC 3339).
+   */
+  written_at: string;
+  written_by_agent?: string | null;
+  written_by_device?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/RecommendedState.d.ts

@@ -5,13 +5,13 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { Confidence } from './Confidence';
+import type { SpecCheckConfidence } from './SpecCheckConfidence';
 
 /**
  * The single state the matcher recommends the caller treat as "current".
  */
 export interface RecommendedState {
-  confidence: Confidence;
+  confidence: SpecCheckConfidence;
   /**
    * Free-form explanation (e.g. "highest match rate among all states").
    */

package/src/generated/RegisterAppRequest.d.ts

@@ -0,0 +1,14 @@
+/* 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`.
+ */
+
+export interface RegisterAppRequest {
+  appId: string;
+  displayName: string;
+  repoRoot: string;
+  uiBridgeUrl: string;
+  [k: string]: unknown;
+}

package/src/generated/SpecApiEvent.d.ts

@@ -0,0 +1,90 @@
+/* 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`.
+ */
+
+/**
+ * Tagged sum-type for every event broadcast on the Spec API channel.
+ *
+ * Serialization uses `serde(tag = "type", rename_all = "kebab-case")` so
+ * the wire discriminator is exactly the SSE event name (e.g.
+ * `"spec-changed"`, `"spec-check-invoked"`).
+ */
+export type SpecApiEvent =
+  | (SpecChanged & {
+      type: "spec-changed";
+    })
+  | {
+      app_id: string;
+      at_ms: number;
+      /**
+       * "http" | "mcp" | "workflow-step"
+       */
+      invoked_via: string;
+      page_ids: string[];
+      snapshot_id: string;
+      type: "spec-check-invoked";
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      at_ms: number;
+      eval_error_count: number;
+      no_match_count: number;
+      overall_match_rate: number;
+      page_count: number;
+      partial_match_count: number;
+      perfect_match_count: number;
+      snapshot_id: string;
+      total_duration_ms: number;
+      type: "spec-check-completed";
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      at_ms: number;
+      conjunct_name: string;
+      /**
+       * Small scalar/struct — NOT the full result.
+       */
+      observed: {
+        [k: string]: unknown;
+      };
+      page_id: string;
+      /**
+       * serde-tagged variant name of `ConjunctRule`
+       */
+      rule_kind: string;
+      snapshot_id: string;
+      type: "spec-check-policy-violation";
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      at_ms: number;
+      /**
+       * Expected 2 per design §6.4.
+       */
+      consecutive_greens: number;
+      page_id: string;
+      proposal_id: string;
+      /**
+       * The snapshot that produced the second green.
+       */
+      snapshot_id: string;
+      type: "flywheel-proposal-promoted";
+      [k: string]: unknown;
+    }
+  | {
+      app_id: string;
+      at_ms: number;
+      failing_assertion_id: string;
+      failing_state_id: string;
+      page_id: string;
+      proposal_id: string;
+      snapshot_id: string;
+      type: "flywheel-proposal-demoted";
+      [k: string]: unknown;
+    };

package/src/generated/SpecCheckConfidence.d.ts

@@ -12,4 +12,4 @@
  * cross-repo schema registry; registered as `SpecCheckConfidence` in
  * `schema_export.rs`. See module docs.
  */
-export type Confidence = "high" | "medium" | "low";
+export type SpecCheckConfidence = "high" | "medium" | "low";

package/src/generated/SpecCheckResult.d.ts

@@ -11,12 +11,12 @@ import type { AssertionResult } from './AssertionResult';
 import type { AssertionSeverityCounts } from './AssertionSeverityCounts';
 import type { BridgeFingerprint } from './BridgeFingerprint';
 import type { CandidateMiss } from './CandidateMiss';
-import type { Confidence } from './Confidence';
 import type { FieldDiff } from './FieldDiff';
 import type { MatchOutcome } from './MatchOutcome';
 import type { MatchedElement } from './MatchedElement';
 import type { MissReason } from './MissReason';
 import type { RecommendedState } from './RecommendedState';
+import type { SpecCheckConfidence } from './SpecCheckConfidence';
 import type { SpecCheckSummary } from './SpecCheckSummary';
 import type { StateMatchResult } from './StateMatchResult';
 

package/src/generated/SpecCheckSummary.d.ts

@@ -6,9 +6,9 @@
  */
 
 import type { AssertionSeverityCounts } from './AssertionSeverityCounts';
-import type { Confidence } from './Confidence';
 import type { MatchOutcome } from './MatchOutcome';
 import type { RecommendedState } from './RecommendedState';
+import type { SpecCheckConfidence } from './SpecCheckConfidence';
 
 /**
  * Aggregate summary across all evaluated states.
@@ -19,6 +19,15 @@ export interface SpecCheckSummary {
    * Mean of per-state match rates, weighted equally.
    */
   overallMatchRate: number;
+  /**
+   * Diagnostic explaining why `recommended_state` is `None`. Set when
+   * the matcher *deliberately* withholds a recommendation (e.g. the
+   * spec failed distinctness validation per §5.12); absent otherwise
+   * (e.g. when every state simply scored below the confidence floor).
+   * Free-form for forward-compat; current values:
+   * `"spec_validation_failed"`.
+   */
+  recommendationReason?: string | null;
   /**
    * The single state (if any) the matcher recommends the caller treat
    * as "current". `None` when the matcher has no preference.

package/src/generated/UpdateAppRequest.d.ts

@@ -0,0 +1,12 @@
+/* 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`.
+ */
+
+export interface UpdateAppRequest {
+  displayName?: string | null;
+  uiBridgeUrl?: string | null;
+  [k: string]: unknown;
+}