@qontinui/shared-types 0.3.0 → 0.4.0

package/package.json

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

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/SpecApiEvent.d.ts

@@ -0,0 +1,85 @@
+/* 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";
+    })
+  | {
+      at_ms: number;
+      /**
+       * "http" | "mcp" | "workflow-step"
+       */
+      invoked_via: string;
+      page_ids: string[];
+      snapshot_id: string;
+      type: "spec-check-invoked";
+      [k: string]: unknown;
+    }
+  | {
+      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;
+    }
+  | {
+      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;
+    }
+  | {
+      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;
+    }
+  | {
+      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/index.ts

@@ -326,6 +326,7 @@ export type { SearchResultItem } from './SearchResultItem';
 export type { SearchStrategy } from './SearchStrategy';
 export type { SemanticSearchRequest } from './SemanticSearchRequest';
 export type { SemanticSearchResponse } from './SemanticSearchResponse';
+export type { SpecApiEvent } from './SpecApiEvent';
 export type { SpecCheckConfidence } from './SpecCheckConfidence';
 export type { SpecCheckPolicy } from './SpecCheckPolicy';
 export type { SpecCheckResult } from './SpecCheckResult';