refactor(api): declare catalog coverage response type

Signed-off-by: Jared Scott <jared.scott@datarecce.io>

Author: gcko

js/packages/ui/src/api/index.ts

@@ -62,6 +62,7 @@ export type { RecceServerFlags } from "./flag";
 export { getServerFlag, markRelaunchHintCompleted } from "./flag";
 // Server info API (lineage, environment, dbt metadata)
 export type {
+  CatalogCoverage,
   CatalogMetadata,
   GitInfo,
   LineageData,

js/packages/ui/src/api/info.test.ts

@@ -0,0 +1,28 @@
+import { describe, expectTypeOf, it } from "vitest";
+
+import type { CatalogCoverage, ServerInfoResult } from "./index";
+
+type CatalogStatus =
+  | "complete"
+  | "partial"
+  | "empty"
+  | "absent"
+  | "not_applicable"
+  | "unknown";
+
+describe("ServerInfoResult catalog coverage contract", () => {
+  it("exports the canonical optional and nullable cloud payload", () => {
+    expectTypeOf<CatalogCoverage>().toEqualTypeOf<{
+      status: CatalogStatus;
+      warn: boolean;
+      covered_count: number;
+      expected_count: number;
+      catalog_entry_count: number;
+      computed_at: string;
+    }>();
+
+    expectTypeOf<ServerInfoResult["catalog_coverage"]>().toEqualTypeOf<
+      CatalogCoverage | null | undefined
+    >();
+  });
+});

js/packages/ui/src/api/info.ts

@@ -158,6 +158,25 @@ export interface StateMetadata {
   generated_at: string;
 }
 
+/**
+ * Catalog coverage fields returned by the cloud backend after artifact
+ * classification.
+ */
+export interface CatalogCoverage {
+  status:
+    | "complete"
+    | "partial"
+    | "empty"
+    | "absent"
+    | "not_applicable"
+    | "unknown";
+  warn: boolean;
+  covered_count: number;
+  expected_count: number;
+  catalog_entry_count: number;
+  computed_at: string;
+}
+
 /**
  * Session staleness fields returned by the backend when the PR session's
  * frozen-snapshot base may have diverged from the project's current shared base.
@@ -227,6 +246,11 @@ export interface ServerInfoResult {
   support_tasks: Record<string, boolean>;
   /** Session staleness fields (cloud mode only, null for OSS / legacy sessions). */
   session_staleness?: SessionStaleness;
+  /**
+   * Catalog coverage fields in cloud mode. Omitted by OSS and legacy servers;
+   * null when the cloud session has not produced a conclusive classification.
+   */
+  catalog_coverage?: CatalogCoverage | null;
 }
 
 /**