@buildinternet/releases-api-types 0.16.0 → 0.18.0

package/src/api-types.ts

@@ -30,6 +30,28 @@ import type {
   CreateOrgBodySchema,
   UpdateOrgBodySchema,
   OrgDetailSchema,
+  OrgCatalogItemSchema,
+  OrgCatalogResponseSchema,
+  OrgCollectionsResponseSchema,
+  AddOrgAccountBodySchema,
+  IgnoredUrlItemSchema,
+  OrgIgnoredUrlsResponseSchema,
+  AddIgnoredUrlBodySchema,
+  AddIgnoredUrlResponseSchema,
+  DeleteIgnoredUrlResponseSchema,
+  OrgTagsBodySchema,
+  OrgTagsMutationResponseSchema,
+  CreateTagBodySchema,
+  TagRowSchema,
+  OrgActivityResponseSchema,
+  OrgHeatmapResponseSchema,
+  OrgSparklinesResponseSchema,
+  OrgReleaseItemSchema,
+  OrgFeedPaginationSchema,
+  OrgReleasesFeedResponseSchema,
+  OrgRecentReleaseItemSchema,
+  OrgRecentReleasesResponseSchema,
+  DeleteOrgAccountResponseSchema,
 } from "./schemas/orgs.js";
 import type {
   SourceListItemSchema,
@@ -43,6 +65,31 @@ import type {
   CreateSourceBodySchema,
   ChangelogFileSummarySchema,
   SourceChangelogResponseSchema,
+  SourceActivityResponseSchema,
+  SourceHeatmapResponseSchema,
+  SourceKnownReleaseItemSchema,
+  SourceKnownReleasesResponseSchema,
+  SourceRecentReleasesResponseSchema,
+  SourceSessionsResponseSchema,
+  SourceSummaryRowSchema,
+  SourceSummariesResponseSchema,
+  CreateSourceSummaryBodySchema,
+  CreateSourceSummaryResponseSchema,
+  SourceFetchResponseSchema,
+  SourceContentHashResponseSchema,
+  SourceContentHashBodySchema,
+  ChangelogTokensResponseSchema,
+  SourceMetadataResponseSchema,
+  ChangelogProbeResponseSchema,
+  DeleteSourceResponseSchema,
+  DeleteSourceReleasesResponseSchema,
+  InsertReleaseResponseSchema,
+  BatchReleasesResponseSchema,
+  OversizedChangelogFileRowSchema,
+  OversizedChangelogFilesResponseSchema,
+  FetchableSourcesResponseSchema,
+  FeedSourcesResponseSchema,
+  ChangedSourcesResponseSchema,
 } from "./schemas/sources.js";
 import type {
   ProductRowSchema,
@@ -57,7 +104,115 @@ import type {
   ProductAdoptDryRunSchema,
   ProductAdoptResponseSchema,
   ProductDeleteResponseSchema,
+  ProductTagsListResponseSchema,
+  ProductTagsBodySchema,
+  ProductTagsMutationResponseSchema,
 } from "./schemas/products.js";
+import type {
+  ReleaseLatestSourceSchema,
+  ReleaseLatestItemSchema,
+  ReleaseLatestResponseSchema,
+  ReleaseCoverageRowSchema,
+  ReleaseCoverageResponseSchema,
+  LinkReleaseCoverageBodySchema,
+  LinkReleaseCoverageResponseSchema,
+  UnlinkReleaseCoverageResponseSchema,
+  ReleaseWithMediaRowSchema,
+  ReleasesWithMediaResponseSchema,
+  ReleaseDetailOrgSchema,
+  ReleaseDetailResponseSchema,
+  UpdateReleaseBodySchema,
+  ReleasePatchResponseSchema,
+  ReleaseDeleteResponseSchema,
+  ReleaseSuppressResponseSchema,
+  ReleaseUnsuppressResponseSchema,
+  ReleaseSuppressBodySchema,
+  ReleaseStreamMessageSchema,
+} from "./schemas/releases.js";
+import type {
+  LookupStatusSchema,
+  LookupBodySchema,
+  LookupSourceSchema,
+  LookupReleaseSchema,
+  LookupRelatedOrgSchema,
+  LookupResponseSchema,
+  LookupSourceBySlugResponseSchema,
+  LookupProductBySlugResponseSchema,
+  DomainLookupOrgSchema,
+  DomainLookupProductSchema,
+  DomainLookupResponseSchema,
+} from "./schemas/lookups.js";
+import type {
+  SearchOrgHitSchema,
+  SearchCatalogHitSchema,
+  SearchSourceHitSchema,
+  SearchReleaseHitSchema,
+  SearchChunkHitSchema,
+  LookupResultPayloadSchema,
+  UnifiedSearchResponseSchema,
+} from "./schemas/search.js";
+import type {
+  TaxonomyOrgSchema,
+  TaxonomyProductSchema,
+  CategoryListItemSchema,
+  CategoryListResponseSchema,
+  CategoryDetailSchema,
+  UpdateCategoryRequestSchema,
+  UpdateCategoryResponseSchema,
+  CategoryFeedPaginationSchema,
+  CategoryReleasesResponseSchema,
+  TagDetailSchema,
+} from "./schemas/taxonomy.js";
+import type {
+  StatsSourceActivitySchema,
+  StatsRecentActivitySchema,
+  StatsResponseSchema,
+} from "./schemas/stats.js";
+import type { SitemapSourceSchema, SitemapPayloadSchema } from "./schemas/sitemap.js";
+import type {
+  RelatedScopeSchema,
+  RelatedReleaseThumbnailSchema,
+  RelatedReleaseSourceSchema,
+  RelatedReleaseItemSchema,
+  RelatedSourceItemSchema,
+  RelatedReleasesOkResponseSchema,
+  RelatedReleasesDegradedResponseSchema,
+  RelatedReleasesResponseSchema,
+  RelatedSourcesOkResponseSchema,
+  RelatedSourcesDegradedResponseSchema,
+  RelatedSourcesResponseSchema,
+} from "./schemas/related.js";
+import type {
+  CollectionMemberOrgSchema,
+  CollectionListItemSchema,
+  CollectionListResponseSchema,
+  CollectionDetailSchema,
+  CollectionReleaseItemSchema,
+  CollectionFeedPaginationSchema,
+  CollectionReleasesResponseSchema,
+  CollectionRowSchema,
+  CreateCollectionRequestSchema,
+  UpdateCollectionRequestSchema,
+  CollectionMemberInputSchema,
+  AddCollectionMemberRequestSchema,
+  ReplaceCollectionMembersRequestSchema,
+  ResolvedCollectionMemberSchema,
+  ReplaceCollectionMembersResponseSchema,
+  AddCollectionMemberResponseSchema,
+} from "./schemas/collections.js";
+import type {
+  OrgOverviewResponseSchema,
+  IncomingOverviewCitationSchema,
+  RegenerateOverviewBodySchema,
+  RegenerateOverviewResponseSchema,
+  ProductOverviewResponseSchema,
+  OverviewInputsCheckResponseSchema,
+  OverviewInputsFullResponseSchema,
+  OverviewInputsResponseSchema,
+  PlaybookResponseSchema,
+  UpdatePlaybookNotesBodySchema,
+  UpdatePlaybookNotesResponseSchema,
+} from "./schemas/overviews.js";
 
 export {
   MediaItemSchema,
@@ -81,6 +236,28 @@ export {
   CreateOrgBodySchema,
   UpdateOrgBodySchema,
   OrgDetailSchema,
+  OrgCatalogItemSchema,
+  OrgCatalogResponseSchema,
+  OrgCollectionsResponseSchema,
+  AddOrgAccountBodySchema,
+  IgnoredUrlItemSchema,
+  OrgIgnoredUrlsResponseSchema,
+  AddIgnoredUrlBodySchema,
+  AddIgnoredUrlResponseSchema,
+  DeleteIgnoredUrlResponseSchema,
+  OrgTagsBodySchema,
+  OrgTagsMutationResponseSchema,
+  CreateTagBodySchema,
+  TagRowSchema,
+  OrgActivityResponseSchema,
+  OrgHeatmapResponseSchema,
+  OrgSparklinesResponseSchema,
+  OrgReleaseItemSchema,
+  OrgFeedPaginationSchema,
+  OrgReleasesFeedResponseSchema,
+  OrgRecentReleaseItemSchema,
+  OrgRecentReleasesResponseSchema,
+  DeleteOrgAccountResponseSchema,
 } from "./schemas/orgs.js";
 export {
   SourceListItemSchema,
@@ -94,6 +271,31 @@ export {
   CreateSourceBodySchema,
   ChangelogFileSummarySchema,
   SourceChangelogResponseSchema,
+  SourceActivityResponseSchema,
+  SourceHeatmapResponseSchema,
+  SourceKnownReleaseItemSchema,
+  SourceKnownReleasesResponseSchema,
+  SourceRecentReleasesResponseSchema,
+  SourceSessionsResponseSchema,
+  SourceSummaryRowSchema,
+  SourceSummariesResponseSchema,
+  CreateSourceSummaryBodySchema,
+  CreateSourceSummaryResponseSchema,
+  SourceFetchResponseSchema,
+  SourceContentHashResponseSchema,
+  SourceContentHashBodySchema,
+  ChangelogTokensResponseSchema,
+  SourceMetadataResponseSchema,
+  ChangelogProbeResponseSchema,
+  DeleteSourceResponseSchema,
+  DeleteSourceReleasesResponseSchema,
+  InsertReleaseResponseSchema,
+  BatchReleasesResponseSchema,
+  OversizedChangelogFileRowSchema,
+  OversizedChangelogFilesResponseSchema,
+  FetchableSourcesResponseSchema,
+  FeedSourcesResponseSchema,
+  ChangedSourcesResponseSchema,
 } from "./schemas/sources.js";
 export {
   ProductRowSchema,
@@ -108,7 +310,116 @@ export {
   ProductAdoptDryRunSchema,
   ProductAdoptResponseSchema,
   ProductDeleteResponseSchema,
+  ProductTagsListResponseSchema,
+  ProductTagsBodySchema,
+  ProductTagsMutationResponseSchema,
 } from "./schemas/products.js";
+export {
+  LookupStatusSchema,
+  LookupBodySchema,
+  LookupSourceSchema,
+  LookupReleaseSchema,
+  LookupRelatedOrgSchema,
+  LookupResponseSchema,
+  LookupSourceBySlugResponseSchema,
+  LookupProductBySlugResponseSchema,
+  DomainLookupOrgSchema,
+  DomainLookupProductSchema,
+  DomainLookupResponseSchema,
+} from "./schemas/lookups.js";
+export {
+  TaxonomyOrgSchema,
+  TaxonomyProductSchema,
+  CategoryListItemSchema,
+  CategoryListResponseSchema,
+  CategoryDetailSchema,
+  UpdateCategoryRequestSchema,
+  UpdateCategoryResponseSchema,
+  CategoryReleaseItemSchema,
+  CategoryFeedPaginationSchema,
+  CategoryReleasesResponseSchema,
+  TagDetailSchema,
+} from "./schemas/taxonomy.js";
+export {
+  ReleaseLatestSourceSchema,
+  ReleaseLatestItemSchema,
+  ReleaseLatestResponseSchema,
+  ReleaseCoverageRowSchema,
+  ReleaseCoverageResponseSchema,
+  LinkReleaseCoverageBodySchema,
+  LinkReleaseCoverageResponseSchema,
+  UnlinkReleaseCoverageResponseSchema,
+  ReleaseWithMediaRowSchema,
+  ReleasesWithMediaResponseSchema,
+  ReleaseDetailOrgSchema,
+  ReleaseDetailResponseSchema,
+  UpdateReleaseBodySchema,
+  ReleasePatchResponseSchema,
+  ReleaseDeleteResponseSchema,
+  ReleaseSuppressResponseSchema,
+  ReleaseUnsuppressResponseSchema,
+  ReleaseSuppressBodySchema,
+  ReleaseStreamMessageSchema,
+} from "./schemas/releases.js";
+export {
+  SearchOrgHitSchema,
+  SearchCatalogHitSchema,
+  SearchSourceHitSchema,
+  SearchReleaseHitSchema,
+  SearchChunkHitSchema,
+  LookupResultPayloadSchema,
+  UnifiedSearchResponseSchema,
+} from "./schemas/search.js";
+export {
+  StatsSourceActivitySchema,
+  StatsRecentActivitySchema,
+  StatsResponseSchema,
+} from "./schemas/stats.js";
+export { SitemapSourceSchema, SitemapPayloadSchema } from "./schemas/sitemap.js";
+export {
+  RelatedScopeSchema,
+  RelatedReleaseThumbnailSchema,
+  RelatedReleaseSourceSchema,
+  RelatedReleaseItemSchema,
+  RelatedSourceItemSchema,
+  RelatedReleasesOkResponseSchema,
+  RelatedReleasesDegradedResponseSchema,
+  RelatedReleasesResponseSchema,
+  RelatedSourcesOkResponseSchema,
+  RelatedSourcesDegradedResponseSchema,
+  RelatedSourcesResponseSchema,
+} from "./schemas/related.js";
+export {
+  CollectionMemberOrgSchema,
+  CollectionListItemSchema,
+  CollectionListResponseSchema,
+  CollectionDetailSchema,
+  CollectionReleaseItemSchema,
+  CollectionFeedPaginationSchema,
+  CollectionReleasesResponseSchema,
+  CollectionRowSchema,
+  CreateCollectionRequestSchema,
+  UpdateCollectionRequestSchema,
+  CollectionMemberInputSchema,
+  AddCollectionMemberRequestSchema,
+  ReplaceCollectionMembersRequestSchema,
+  ResolvedCollectionMemberSchema,
+  ReplaceCollectionMembersResponseSchema,
+  AddCollectionMemberResponseSchema,
+} from "./schemas/collections.js";
+export {
+  OrgOverviewResponseSchema,
+  IncomingOverviewCitationSchema,
+  RegenerateOverviewBodySchema,
+  RegenerateOverviewResponseSchema,
+  ProductOverviewResponseSchema,
+  OverviewInputsCheckResponseSchema,
+  OverviewInputsFullResponseSchema,
+  OverviewInputsResponseSchema,
+  PlaybookResponseSchema,
+  UpdatePlaybookNotesBodySchema,
+  UpdatePlaybookNotesResponseSchema,
+} from "./schemas/overviews.js";
 
 // ── Media ──
 
@@ -131,28 +442,22 @@ export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
 
 // ── Sitemap (bulk URL emission) ──
 
-export interface SitemapPayload {
-  orgs: Array<{ slug: string; lastActivity: string | null }>;
-  sources: Array<{
-    orgSlug: string;
-    slug: string;
-    latestDate: string | null;
-    /**
-     * Whether this source has a stored GitHub CHANGELOG file. Used by the web
-     * sitemap to emit `/{org}/{src}/changelog` URLs only for sources where the
-     * route resolves (#875). Optional for backwards compatibility — older
-     * clients ignore it.
-     */
-    hasChangelog?: boolean;
-    /**
-     * Whether this source has any rolling or monthly highlight summaries.
-     * Drives `/{org}/{src}/highlights` sitemap emission (#875).
-     */
-    hasHighlights?: boolean;
-  }>;
-  products: Array<{ orgSlug: string; slug: string }>;
-  collections: Array<{ slug: string; updatedAt: string }>;
-}
+export type SitemapSource = z.infer<typeof SitemapSourceSchema>;
+export type SitemapPayload = z.infer<typeof SitemapPayloadSchema>;
+
+// ── Related (Vectorize neighbors) ──
+
+export type RelatedScope = z.infer<typeof RelatedScopeSchema>;
+export type RelatedReleaseThumbnail = z.infer<typeof RelatedReleaseThumbnailSchema>;
+export type RelatedReleaseSource = z.infer<typeof RelatedReleaseSourceSchema>;
+export type RelatedReleaseItem = z.infer<typeof RelatedReleaseItemSchema>;
+export type RelatedSourceItem = z.infer<typeof RelatedSourceItemSchema>;
+export type RelatedReleasesOkResponse = z.infer<typeof RelatedReleasesOkResponseSchema>;
+export type RelatedReleasesDegradedResponse = z.infer<typeof RelatedReleasesDegradedResponseSchema>;
+export type RelatedReleasesResponse = z.infer<typeof RelatedReleasesResponseSchema>;
+export type RelatedSourcesOkResponse = z.infer<typeof RelatedSourcesOkResponseSchema>;
+export type RelatedSourcesDegradedResponse = z.infer<typeof RelatedSourcesDegradedResponseSchema>;
+export type RelatedSourcesResponse = z.infer<typeof RelatedSourcesResponseSchema>;
 
 // ── Organizations ──
 
@@ -163,9 +468,31 @@ export type OrgAccountsResponse = z.infer<typeof OrgAccountsResponseSchema>;
 export type OrgTagsResponse = z.infer<typeof OrgTagsResponseSchema>;
 export type CreateOrgBody = z.infer<typeof CreateOrgBodySchema>;
 export type UpdateOrgBody = z.infer<typeof UpdateOrgBodySchema>;
-
 export type OrgDetail = z.infer<typeof OrgDetailSchema>;
 
+export type OrgCatalogItem = z.infer<typeof OrgCatalogItemSchema>;
+export type OrgCatalogResponse = z.infer<typeof OrgCatalogResponseSchema>;
+export type OrgCollectionsResponse = z.infer<typeof OrgCollectionsResponseSchema>;
+export type AddOrgAccountBody = z.infer<typeof AddOrgAccountBodySchema>;
+export type IgnoredUrlItem = z.infer<typeof IgnoredUrlItemSchema>;
+export type OrgIgnoredUrlsResponse = z.infer<typeof OrgIgnoredUrlsResponseSchema>;
+export type AddIgnoredUrlBody = z.infer<typeof AddIgnoredUrlBodySchema>;
+export type AddIgnoredUrlResponse = z.infer<typeof AddIgnoredUrlResponseSchema>;
+export type DeleteIgnoredUrlResponse = z.infer<typeof DeleteIgnoredUrlResponseSchema>;
+export type OrgTagsBody = z.infer<typeof OrgTagsBodySchema>;
+export type OrgTagsMutationResponse = z.infer<typeof OrgTagsMutationResponseSchema>;
+export type CreateTagBody = z.infer<typeof CreateTagBodySchema>;
+export type TagRow = z.infer<typeof TagRowSchema>;
+export type OrgActivityResponse = z.infer<typeof OrgActivityResponseSchema>;
+export type OrgHeatmapResponse = z.infer<typeof OrgHeatmapResponseSchema>;
+export type OrgSparklinesResponse = z.infer<typeof OrgSparklinesResponseSchema>;
+export type OrgReleaseItem = z.infer<typeof OrgReleaseItemSchema>;
+export type OrgFeedPagination = z.infer<typeof OrgFeedPaginationSchema>;
+export type OrgReleasesFeedResponse = z.infer<typeof OrgReleasesFeedResponseSchema>;
+export type OrgRecentReleaseItem = z.infer<typeof OrgRecentReleaseItemSchema>;
+export type OrgRecentReleasesResponse = z.infer<typeof OrgRecentReleasesResponseSchema>;
+export type DeleteOrgAccountResponse = z.infer<typeof DeleteOrgAccountResponseSchema>;
+
 // ── Sources ──
 
 export type SourceListItem = z.infer<typeof SourceListItemSchema>;
@@ -179,6 +506,31 @@ export type SourceChangelogResponse = z.infer<typeof SourceChangelogResponseSche
 export type SourceDetail = z.infer<typeof SourceDetailSchema>;
 export type SourceMutationResponse = z.infer<typeof SourceMutationResponseSchema>;
 export type SourceOrgRef = z.infer<typeof SourceOrgRefSchema>;
+export type SourceActivityResponse = z.infer<typeof SourceActivityResponseSchema>;
+export type SourceHeatmapResponse = z.infer<typeof SourceHeatmapResponseSchema>;
+export type SourceKnownReleaseItem = z.infer<typeof SourceKnownReleaseItemSchema>;
+export type SourceKnownReleasesResponse = z.infer<typeof SourceKnownReleasesResponseSchema>;
+export type SourceRecentReleasesResponse = z.infer<typeof SourceRecentReleasesResponseSchema>;
+export type SourceSessionsResponse = z.infer<typeof SourceSessionsResponseSchema>;
+export type SourceSummaryRow = z.infer<typeof SourceSummaryRowSchema>;
+export type SourceSummariesResponse = z.infer<typeof SourceSummariesResponseSchema>;
+export type CreateSourceSummaryBody = z.infer<typeof CreateSourceSummaryBodySchema>;
+export type CreateSourceSummaryResponse = z.infer<typeof CreateSourceSummaryResponseSchema>;
+export type SourceFetchResponse = z.infer<typeof SourceFetchResponseSchema>;
+export type SourceContentHashResponse = z.infer<typeof SourceContentHashResponseSchema>;
+export type SourceContentHashBody = z.infer<typeof SourceContentHashBodySchema>;
+export type ChangelogTokensResponse = z.infer<typeof ChangelogTokensResponseSchema>;
+export type SourceMetadataResponse = z.infer<typeof SourceMetadataResponseSchema>;
+export type ChangelogProbeResponse = z.infer<typeof ChangelogProbeResponseSchema>;
+export type DeleteSourceResponse = z.infer<typeof DeleteSourceResponseSchema>;
+export type DeleteSourceReleasesResponse = z.infer<typeof DeleteSourceReleasesResponseSchema>;
+export type InsertReleaseResponse = z.infer<typeof InsertReleaseResponseSchema>;
+export type BatchReleasesResponse = z.infer<typeof BatchReleasesResponseSchema>;
+export type OversizedChangelogFileRow = z.infer<typeof OversizedChangelogFileRowSchema>;
+export type OversizedChangelogFilesResponse = z.infer<typeof OversizedChangelogFilesResponseSchema>;
+export type FetchableSourcesResponse = z.infer<typeof FetchableSourcesResponseSchema>;
+export type FeedSourcesResponse = z.infer<typeof FeedSourcesResponseSchema>;
+export type ChangedSourcesResponse = z.infer<typeof ChangedSourcesResponseSchema>;
 
 // ── Admin telemetry: orgs rollup ──
 
@@ -247,60 +599,37 @@ export interface ReleaseDetail {
   type?: ReleaseType;
 }
 
-export interface ReleaseCoverageRow {
-  coverageId: string;
-  canonicalId: string;
-  reason: string | null;
-  decidedBy: string;
-  decidedAt: string;
-}
-
-export type ReleaseCoverageResponse =
-  | { role: "standalone"; canonical: null; covers: [] }
-  | { role: "coverage"; canonical: ReleaseCoverageRow; covers: [] }
-  | { role: "canonical"; canonical: null; covers: ReleaseCoverageRow[] };
+export type ReleaseCoverageRow = z.infer<typeof ReleaseCoverageRowSchema>;
+export type ReleaseCoverageResponse = z.infer<typeof ReleaseCoverageResponseSchema>;
+export type LinkReleaseCoverageBody = z.infer<typeof LinkReleaseCoverageBodySchema>;
+export type LinkReleaseCoverageResponse = z.infer<typeof LinkReleaseCoverageResponseSchema>;
+export type UnlinkReleaseCoverageResponse = z.infer<typeof UnlinkReleaseCoverageResponseSchema>;
+
+export type ReleaseLatestSource = z.infer<typeof ReleaseLatestSourceSchema>;
+export type ReleaseLatestItem = z.infer<typeof ReleaseLatestItemSchema>;
+export type ReleaseLatestResponse = z.infer<typeof ReleaseLatestResponseSchema>;
+
+export type ReleaseWithMediaRow = z.infer<typeof ReleaseWithMediaRowSchema>;
+export type ReleasesWithMediaResponse = z.infer<typeof ReleasesWithMediaResponseSchema>;
+
+export type ReleaseDetailOrg = z.infer<typeof ReleaseDetailOrgSchema>;
+export type ReleaseDetailResponse = z.infer<typeof ReleaseDetailResponseSchema>;
+export type UpdateReleaseBody = z.infer<typeof UpdateReleaseBodySchema>;
+export type ReleasePatchResponse = z.infer<typeof ReleasePatchResponseSchema>;
+export type ReleaseDeleteResponse = z.infer<typeof ReleaseDeleteResponseSchema>;
+export type ReleaseSuppressResponse = z.infer<typeof ReleaseSuppressResponseSchema>;
+export type ReleaseUnsuppressResponse = z.infer<typeof ReleaseUnsuppressResponseSchema>;
+export type ReleaseSuppressBody = z.infer<typeof ReleaseSuppressBodySchema>;
+export type ReleaseStreamMessage = z.infer<typeof ReleaseStreamMessageSchema>;
 
 export type ReleaseSummaryItem = z.infer<typeof ReleaseSummaryItemSchema>;
 
 // ── Search ──
 
-export interface SearchOrgHit {
-  slug: string;
-  name: string;
-  domain: string | null;
-  avatarUrl: string | null;
-  category: string | null;
-}
+export type SearchOrgHit = z.infer<typeof SearchOrgHitSchema>;
+export type SearchCatalogHit = z.infer<typeof SearchCatalogHitSchema>;
 
-/**
- * Unified catalog entry — either a product row or a standalone source
- * presented as product-shaped. `kind` routes clicks to the right URL but
- * the two forms are otherwise interchangeable for display. `kind` (not
- * `type`) because source rows already carry `type: github|scrape|feed|agent`
- * on the wire.
- */
-export interface SearchCatalogHit {
-  slug: string;
-  name: string;
-  orgSlug: string | null;
-  orgName: string | null;
-  category: string | null;
-  kind: "product" | "source";
-  sourceSlug?: string;
-  sourceType?: string;
-}
-
-/** @deprecated Use SearchCatalogHit. */
-export type SearchProductHit = SearchCatalogHit;
-
-export interface SearchSourceHit {
-  slug: string;
-  name: string;
-  type: string;
-  orgSlug: string | null;
-  orgName: string | null;
-  productSlug: string | null;
-}
+export type SearchSourceHit = z.infer<typeof SearchSourceHitSchema>;
 
 export interface RawSourceHit extends SearchSourceHit {
   productName?: string;
@@ -345,181 +674,28 @@ export function foldSourcesIntoCatalog(
   return result;
 }
 
-/** @deprecated Use foldSourcesIntoCatalog. */
-export const foldSourcesIntoProducts = foldSourcesIntoCatalog;
-
-export interface SearchReleaseHit {
-  id: string;
-  sourceSlug: string;
-  sourceName: string;
-  /** Source type (github, scrape, feed, agent) — drives the byline icon. */
-  sourceType?: string;
-  orgSlug: string | null;
-  /** Owning organization's display name — byline disambiguation. */
-  orgName?: string | null;
-  version: string | null;
-  title: string;
-  summary: string;
-  /** AI-generated headline (#852, renamed in #860). Optional + nullable: most rows are unpopulated. */
-  titleGenerated?: string | null;
-  /** AI-generated smart-brevity headline (#852, renamed in #860). Same caveat as titleGenerated. */
-  titleShort?: string | null;
-  /**
-   * Full release body, media URLs hydrated through the MEDIA_ORIGIN proxy.
-   * Present so the web can render the same markdown + thumbnail treatment
-   * as the org/source feeds instead of a plain summary snippet.
-   */
-  content?: string;
-  /** Release media with r2Url resolved. Undefined means "not hydrated". */
-  media?: MediaItem[];
-  publishedAt: string | null;
-  /**
-   * Hybrid fusion score. Present on hybrid/semantic responses (including
-   * degraded fallbacks); absent on the legacy lexical path. Clients can
-   * use this to interleave release and chunk hits into a single ranked list.
-   */
-  score?: number;
-  /** Release type. See {@link ReleaseType}. */
-  type?: ReleaseType;
-}
-
-/**
- * A heading-aware CHANGELOG.md slice returned by hybrid / semantic search.
- * Clients can deep-link to `/source/<sourceSlug>?tab=changelog&offset=<offset>`
- * to read the surrounding file content.
- */
-export interface SearchChunkHit {
-  sourceSlug: string;
-  sourceName: string;
-  orgSlug: string | null;
-  /** Owning organization's display name — byline disambiguation. */
-  orgName?: string | null;
-  filePath: string;
-  offset: number;
-  length: number;
-  heading: string | null;
-  snippet: string;
-  score: number;
-}
-
-// ── Lookup by domain (entity resolution) ──
-
-/**
- * Returned by GET /v1/lookups/by-domain. Pure resolution: the server
- * normalizes the input domain, exact-matches against
- * `organizations.domain` (primary) and `domain_aliases.domain` (alias for
- * either an org or a product), and returns whatever it finds. Unknown
- * domains 404 — there is no on-demand probing for domains, unlike the
- * GitHub coordinate path.
- */
-export interface DomainLookupResponse {
-  /** Normalized domain that was matched (lowercased, no scheme/path/www). */
-  domain: string;
-  /**
-   * Owning organization, if one exists. `matchedVia` distinguishes a hit
-   * on `organizations.domain` (`"primary"`) from an alias hit
-   * (`"alias"`) so the UI can render the difference.
-   */
-  org: {
-    id: string;
-    slug: string;
-    name: string;
-    domain: string | null;
-    description: string | null;
-    category: string | null;
-    avatarUrl: string | null;
-    matchedVia: "primary" | "alias";
-  } | null;
-  /**
-   * Products whose alias points at this domain. Multiple are possible
-   * when an org owns several products that all set the same alias —
-   * unusual, but allowed.
-   */
-  products: Array<{
-    id: string;
-    slug: string;
-    name: string;
-    orgId: string;
-    orgSlug: string;
-    orgName: string;
-    category: string | null;
-  }>;
-}
-
-// ── Lookup (on-demand GitHub index) ──
-
-export type LookupStatus = "indexed" | "existing" | "empty" | "not_found" | "deferred";
-
-/**
- * Slim wire payload embedded in a search response when the query is a GitHub
- * coordinate (org/repo) and no existing entity matched. The server performs an
- * on-demand lookup and includes the result here so the client can surface a
- * "just indexed" or "not found" rail without a second round trip.
- */
-export interface LookupResultPayload {
-  status: LookupStatus;
-  source?: {
-    id: string;
-    slug: string;
-    name: string;
-    url: string;
-    discovery: "curated" | "agent" | "on_demand";
-  };
-  releases?: Array<{
-    id: string;
-    version: string | null;
-    title: string;
-    publishedAt: string | null;
-  }>;
-  /**
-   * Unambiguous "did you mean" rail: the curated org that owns GitHub repos
-   * under the same org segment, plus its top sources. Null when the org
-   * segment matches multiple curated orgs or none.
-   */
-  relatedOrg: {
-    org: { id: string; slug: string; name: string };
-    sources: Array<{ id: string; slug: string; name: string; url: string }>;
-  } | null;
-}
-
-export interface UnifiedSearchResponse {
-  query: string;
-  /**
-   * Normalized form of `?domain=` when the caller passed it. The server
-   * does the normalization once and echoes the canonical form back so
-   * clients don't have to re-normalize for analytics or display. Absent
-   * when no domain filter was applied.
-   */
-  domain?: string;
-  /**
-   * Outcome of the `?domain=` resolution step. `"matched"` means the
-   * domain resolved to a known org and results below are scoped to it.
-   * `"not_found"` means the domain didn't match anything; in that case
-   * orgs/catalog/releases will all be empty arrays — the caller can
-   * distinguish "no hits in scope" from "scope didn't exist."
-   */
-  domainStatus?: "matched" | "not_found";
-  orgs: SearchOrgHit[];
-  /** Products and standalone sources folded into a single list. */
-  catalog: SearchCatalogHit[];
-  /** @deprecated Use `catalog`. Kept as an alias populated with the same array. */
-  products: SearchCatalogHit[];
-  sources: SearchSourceHit[];
-  releases: SearchReleaseHit[];
-  /** Present on hybrid/semantic responses; omitted on pure lexical. */
-  chunks?: SearchChunkHit[];
-  /** Mode actually used by the server. Present for semantic/hybrid responses. */
-  mode?: "lexical" | "semantic" | "hybrid";
-  /** True when a hybrid/semantic request fell back to lexical. */
-  degraded?: boolean;
-  /** Human-readable reason for degradation (e.g., missing Vectorize binding). */
-  degradedReason?: string;
-  /**
-   * On-demand lookup result. Present when the query parsed as a GitHub
-   * `org/repo` coordinate and no existing entities matched. Null otherwise.
-   */
-  lookup?: LookupResultPayload | null;
-}
+export type SearchReleaseHit = z.infer<typeof SearchReleaseHitSchema>;
+export type SearchChunkHit = z.infer<typeof SearchChunkHitSchema>;
+
+// ── Lookups ──
+
+export type LookupStatus = z.infer<typeof LookupStatusSchema>;
+export type LookupBody = z.infer<typeof LookupBodySchema>;
+export type LookupSourceRow = z.infer<typeof LookupSourceSchema>;
+export type LookupReleaseRow = z.infer<typeof LookupReleaseSchema>;
+export type LookupRelatedOrg = z.infer<typeof LookupRelatedOrgSchema>;
+export type LookupResponse = z.infer<typeof LookupResponseSchema>;
+export type LookupSourceBySlugResponse = z.infer<typeof LookupSourceBySlugResponseSchema>;
+export type LookupProductBySlugResponse = z.infer<typeof LookupProductBySlugResponseSchema>;
+export type DomainLookupOrg = z.infer<typeof DomainLookupOrgSchema>;
+export type DomainLookupProduct = z.infer<typeof DomainLookupProductSchema>;
+export type DomainLookupResponse = z.infer<typeof DomainLookupResponseSchema>;
+
+// Slim wire payload embedded in a search response when the query is a GitHub
+// coordinate. `LookupResultPayload` is the search-embedded slim variant;
+// `LookupResponse` (above) is the thicker payload returned by POST /v1/lookups.
+export type LookupResultPayload = z.infer<typeof LookupResultPayloadSchema>;
+export type UnifiedSearchResponse = z.infer<typeof UnifiedSearchResponseSchema>;
 
 // ── Overview Pages ──
 
@@ -529,6 +705,18 @@ export type OverviewCitation = z.infer<typeof OverviewCitationSchema>;
 /** @deprecated Use OverviewPageItem */
 export type KnowledgePageItem = OverviewPageItem;
 
+export type OrgOverviewResponse = z.infer<typeof OrgOverviewResponseSchema>;
+export type IncomingOverviewCitation = z.infer<typeof IncomingOverviewCitationSchema>;
+export type RegenerateOverviewBody = z.infer<typeof RegenerateOverviewBodySchema>;
+export type RegenerateOverviewResponse = z.infer<typeof RegenerateOverviewResponseSchema>;
+export type ProductOverviewResponse = z.infer<typeof ProductOverviewResponseSchema>;
+export type OverviewInputsCheckResponse = z.infer<typeof OverviewInputsCheckResponseSchema>;
+export type OverviewInputsFullResponse = z.infer<typeof OverviewInputsFullResponseSchema>;
+export type OverviewInputsResponse = z.infer<typeof OverviewInputsResponseSchema>;
+export type PlaybookResponse = z.infer<typeof PlaybookResponseSchema>;
+export type UpdatePlaybookNotesBody = z.infer<typeof UpdatePlaybookNotesBodySchema>;
+export type UpdatePlaybookNotesResponse = z.infer<typeof UpdatePlaybookNotesResponseSchema>;
+
 // ── Overview Manifest (admin planning) ──
 
 export type OverviewStaleness = "missing" | "behind" | "fresh";
@@ -591,68 +779,45 @@ export interface WeeklyBucket {
   latestVersion: string | null;
 }
 
-export interface SourceActivity {
-  source: { slug: string; name: string; orgSlug: string | null; orgName: string | null };
-  range: { from: string; to: string };
-  weeklyBuckets: WeeklyBucket[];
-}
+/**
+ * @deprecated Use SourceActivityResponse (Zod-derived).
+ * The hand-written interface is kept for callsite compatibility — shape is identical.
+ */
+export type SourceActivity = SourceActivityResponse;
 
-export interface OrgActivitySource {
-  slug: string;
-  name: string;
-  releaseCount: number;
-  avgReleasesPerWeek: number;
-  earliestVersion: string | null;
-  latestVersion: string | null;
-  latestDate: string | null;
-  weeklyBuckets: WeeklyBucket[];
-}
+// ── Org Activity (Zod-derived aliases) ──
+// The old hand-written OrgActivitySource / OrgActivity / OrgSparklines /
+// OrgHeatmap / OrgReleaseItem / OrgReleasesResponse interfaces have been
+// replaced by Zod-derived types in the Organizations section above. Keeping
+// the interface names as deprecated aliases so callsites don't need an
+// immediate churn.
 
-export interface OrgActivity {
-  org: { slug: string; name: string };
-  range: { from: string; to: string };
-  sources: OrgActivitySource[];
-  aggregateWeekly: Array<{ weekStart: string; count: number }>;
-}
+/** @deprecated Use OrgActivityResponse */
+export type OrgActivity = OrgActivityResponse;
 
-// ── Org Sparklines (per-source/product breakdown) ──
+/** @deprecated Use OrgSparklinesResponse */
+export type OrgSparklines = OrgSparklinesResponse;
 
-export interface OrgSparklines {
-  org: { slug: string; name: string };
-  range: { from: string; to: string };
-  aggregate: number[];
-  sources: Array<{ slug: string; name: string; sparkline: number[] }>;
-  products: Array<{ slug: string; name: string; sparkline: number[] }>;
-}
+/** @deprecated Use OrgHeatmapResponse */
+export type OrgHeatmap = OrgHeatmapResponse;
 
-// ── Org Heatmap ──
+/** @deprecated Use OrgReleasesFeedResponse */
+export type OrgReleasesResponse = OrgReleasesFeedResponse;
 
-export interface OrgHeatmap {
-  org: { slug: string; name: string };
-  range: { from: string; to: string };
-  dailyCounts: Array<{ date: string; count: number }>;
-  total: number;
-}
+// ── Org Sparklines (per-source/product breakdown) ──
+// (covered above)
 
 // ── Source Heatmap ──
+// (covered by SourceHeatmapResponse above)
 
-export interface SourceHeatmap {
-  source: { slug: string; name: string };
-  range: { from: string; to: string };
-  dailyCounts: Array<{ date: string; count: number }>;
-  total: number;
-}
+/**
+ * @deprecated Use SourceHeatmapResponse (Zod-derived).
+ * The hand-written interface is kept for callsite compatibility — shape is identical.
+ */
+export type SourceHeatmap = SourceHeatmapResponse;
 
 // ── Org Releases ──
-
-export interface OrgReleaseItem extends ReleaseItem {
-  source: { slug: string; name: string; type: string };
-}
-
-export interface OrgReleasesResponse {
-  releases: OrgReleaseItem[];
-  pagination: { nextCursor: string | null; limit: number };
-}
+// (covered by OrgReleaseItem / OrgReleasesFeedResponse above)
 
 // Source-scoped release feed — the source identity is encoded in the URL, so
 // items omit the redundant `source` block carried by the org feed.
@@ -677,195 +842,54 @@ export type ProductAdoptResult = z.infer<typeof ProductAdoptResultSchema>;
 export type ProductAdoptDryRun = z.infer<typeof ProductAdoptDryRunSchema>;
 export type ProductAdoptResponse = z.infer<typeof ProductAdoptResponseSchema>;
 export type ProductDeleteResponse = z.infer<typeof ProductDeleteResponseSchema>;
+export type ProductTagsListResponse = z.infer<typeof ProductTagsListResponseSchema>;
+export type ProductTagsBody = z.infer<typeof ProductTagsBodySchema>;
+export type ProductTagsMutationResponse = z.infer<typeof ProductTagsMutationResponseSchema>;
 
 // ── Taxonomy (categories + tags) ──
 
-export interface TaxonomyOrg {
-  slug: string;
-  name: string;
-  domain: string | null;
-  avatarUrl: string | null;
-}
-
-export interface TaxonomyProduct {
-  slug: string;
-  name: string;
-  description: string | null;
-  orgSlug: string;
-  orgName: string;
-}
-
-export interface CategoryDetail {
-  slug: string;
-  /**
-   * Display name — operator override from the `categories` table if present,
-   * otherwise `categoryDisplayName(slug)` from `@buildinternet/releases-core`.
-   */
-  name: string;
-  /**
-   * Operator-authored byline shown on the web category page. Null when no
-   * description has been set; clients render their own fallback copy.
-   */
-  description: string | null;
-  /**
-   * Alternative slugs that redirect to this canonical category. Empty when
-   * no aliases have been configured.
-   */
-  aliases: string[];
-  orgs: TaxonomyOrg[];
-  products: TaxonomyProduct[];
-}
-
-/**
- * Item shape on GET /v1/categories — the overview list. Categories are a
- * fixed taxonomy (`CATEGORIES` in `@buildinternet/releases-core/categories`),
- * so the API always returns every slug, including ones with zero members.
- * `orgCount` counts orgs whose `category` matches; `productCount` counts
- * products whose own `category` matches (overriding any parent-org category).
- * Both counts pass through `organizations_public`, so on_demand and
- * soft-deleted orgs are excluded. `description` comes from the optional
- * `categories` metadata overlay; null when no override has been set.
- */
-export interface CategoryListItem {
-  slug: string;
-  name: string;
-  description: string | null;
-  aliases: string[];
-  orgCount: number;
-  productCount: number;
-}
-
-/**
- * PATCH /v1/categories/:slug request body. All fields are optional. `name`
- * and `description` accept `null` to clear the override; `aliases` replaces
- * the full set when provided (pass `[]` to clear). The row is upserted —
- * a category that has never been customized has no row in the table.
- *
- * Each alias must be a kebab-case slug not already in `CATEGORIES` and not
- * claimed by another category row.
- */
-export interface UpdateCategoryRequest {
-  name?: string | null;
-  description?: string | null;
-  aliases?: string[];
-}
+export type TaxonomyOrg = z.infer<typeof TaxonomyOrgSchema>;
+export type TaxonomyProduct = z.infer<typeof TaxonomyProductSchema>;
+export type CategoryDetail = z.infer<typeof CategoryDetailSchema>;
+export type CategoryListItem = z.infer<typeof CategoryListItemSchema>;
+export type CategoryListResponse = z.infer<typeof CategoryListResponseSchema>;
+export type UpdateCategoryRequest = z.infer<typeof UpdateCategoryRequestSchema>;
+export type UpdateCategoryResponse = z.infer<typeof UpdateCategoryResponseSchema>;
+export type CategoryFeedPagination = z.infer<typeof CategoryFeedPaginationSchema>;
+export type CategoryReleasesResponse = z.infer<typeof CategoryReleasesResponseSchema>;
+export type TagDetail = z.infer<typeof TagDetailSchema>;
 
 /**
  * Aggregated release feed row for a category rollup — same wire shape as
- * `CollectionReleaseItem` (both surfaces aggregate releases across multiple
- * orgs). Aliased rather than duplicated so renderers can treat them as one.
+ * `CollectionReleaseItem` (both surfaces use `formatAggregateReleaseRow` in
+ * `workers/api/src/utils.ts`). Aliased rather than duplicated so renderers
+ * can treat them as one.
  */
 export type CategoryReleaseItem = CollectionReleaseItem;
 
-export interface CategoryReleasesResponse {
-  releases: CategoryReleaseItem[];
-  pagination: { nextCursor: string | null; limit: number };
-}
-
-export interface TagDetail {
-  slug: string;
-  name: string;
-  orgs: TaxonomyOrg[];
-  products: TaxonomyProduct[];
-}
-
 // ── Collections ──
 //
 // Curated, named groups of orgs that drive a public "playlist" page (e.g.
 // /collections/frontier-ai-labs). Independent of the fixed `category` taxonomy.
 
-export interface CollectionMemberOrg {
-  slug: string;
-  name: string;
-  domain: string | null;
-  avatarUrl: string | null;
-  /** GitHub handle from org_accounts; lets the avatar fall back to github.com/<handle>.png. */
-  githubHandle: string | null;
-  description: string | null;
-}
-
-/** Item shape on GET /v1/collections (list) and GET /v1/orgs/:slug/collections. */
-export interface CollectionListItem {
-  slug: string;
-  name: string;
-  description: string | null;
-  memberCount: number;
-  /** First few members for inline preview on the list page (capped at 3). */
-  previewMembers?: CollectionMemberOrg[];
-}
-
-/** Detail shape on GET /v1/collections/:slug. */
-export interface CollectionDetail {
-  slug: string;
-  name: string;
-  description: string | null;
-  orgs: CollectionMemberOrg[];
-}
-
-/**
- * Cross-org release feed row. Same shape as `OrgReleaseItem` plus the origin
- * `org` block, so the web's release card can render it identically — full
- * `content` lets "Show more" expand to the body instead of the truncated
- * `summary`.
- */
-export interface CollectionReleaseItem extends OrgReleaseItem {
-  org: { slug: string; name: string };
-  /**
-   * Product the release belongs to, if the source is bound to one. Powers
-   * the timeline's same-product rollup ("3 earlier Claude Code releases
-   * today") on the collections view. `null` for orgs without products or
-   * standalone sources. Optional on the wire so older workers mid-rollout
-   * (and hand-constructed test fixtures) don't trip the typecheck — clients
-   * should treat missing and `null` identically.
-   */
-  product?: { slug: string; name: string } | null;
-}
-
-export interface CollectionReleasesResponse {
-  releases: CollectionReleaseItem[];
-  pagination: { nextCursor: string | null; limit: number };
-}
-
-/** Body for POST /v1/collections. `slug` derives from `name` via toSlug() if omitted. */
-export interface CreateCollectionRequest {
-  slug?: string;
-  name: string;
-  description?: string | null;
-}
-
-/** Body for PATCH /v1/collections/:slug. All fields optional; slug rename is allowed. */
-export interface UpdateCollectionRequest {
-  slug?: string;
-  name?: string;
-  description?: string | null;
-}
-
-/** A single member entry accepted by the member-write endpoints. */
-export interface CollectionMemberInput {
-  /** Either `orgId` (org_…) or `orgSlug` is required; if both are given, `orgId` wins. */
-  orgId?: string;
-  orgSlug?: string;
-  /** Authoring position (default 0). For PUT, omit to use array index. */
-  position?: number;
-}
-
-/** Body for POST /v1/collections/:slug/members. */
-export type AddCollectionMemberRequest = CollectionMemberInput;
-
-/** Body for PUT /v1/collections/:slug/members. Replaces the full membership atomically. */
-export interface ReplaceCollectionMembersRequest {
-  orgs: CollectionMemberInput[];
-}
-
-/** Bare row returned by POST/PATCH on /v1/collections. */
-export interface CollectionRow {
-  id: string;
-  slug: string;
-  name: string;
-  description: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
+export type CollectionMemberOrg = z.infer<typeof CollectionMemberOrgSchema>;
+export type CollectionListItem = z.infer<typeof CollectionListItemSchema>;
+export type CollectionListResponse = z.infer<typeof CollectionListResponseSchema>;
+export type CollectionDetail = z.infer<typeof CollectionDetailSchema>;
+export type CollectionReleaseItem = z.infer<typeof CollectionReleaseItemSchema>;
+export type CollectionFeedPagination = z.infer<typeof CollectionFeedPaginationSchema>;
+export type CollectionReleasesResponse = z.infer<typeof CollectionReleasesResponseSchema>;
+export type CollectionRow = z.infer<typeof CollectionRowSchema>;
+export type CreateCollectionRequest = z.infer<typeof CreateCollectionRequestSchema>;
+export type UpdateCollectionRequest = z.infer<typeof UpdateCollectionRequestSchema>;
+export type CollectionMemberInput = z.infer<typeof CollectionMemberInputSchema>;
+export type AddCollectionMemberRequest = z.infer<typeof AddCollectionMemberRequestSchema>;
+export type ReplaceCollectionMembersRequest = z.infer<typeof ReplaceCollectionMembersRequestSchema>;
+export type ResolvedCollectionMember = z.infer<typeof ResolvedCollectionMemberSchema>;
+export type ReplaceCollectionMembersResponse = z.infer<
+  typeof ReplaceCollectionMembersResponseSchema
+>;
+export type AddCollectionMemberResponse = z.infer<typeof AddCollectionMemberResponseSchema>;
 
 // ── Releases (enriched) ──
 
@@ -910,42 +934,22 @@ export interface LatestRelease {
 }
 
 // ── Stats ──
-
-export interface StatsSummary {
-  period: { days: number; cutoff: string };
-  totals: {
-    organizations: number;
-    sources: number;
-    releases: number;
-    releasesInPeriod: number;
-  };
-  sourceHealth: {
-    upToDate: number;
-    stale: number;
-    neverFetched: number;
-  };
-  sourceActivity: Array<{
-    sourceName: string;
-    sourceSlug: string;
-    sourceType: string;
-    orgName: string | null;
-    lastFetchedAt: string | null;
-    totalReleases: number;
-    recentReleases: number;
-  }>;
-  recentActivity: Array<{
-    sourceName: string;
-    sourceSlug: string;
-    orgName: string | null;
-    releasesFound: number;
-    releasesInserted: number;
-    totalReleases: number;
-    status: string;
-    durationMs: number | null;
-    error: string | null;
-    createdAt: string;
-  }>;
-}
+//
+// `Stats` (flat counts) lives near the top of this file alongside the other
+// shared schema-derived aliases. The richer summary shape is the combined
+// hybrid response served at `GET /v1/stats` — flat counts plus per-source
+// rollups.
+
+export type StatsSourceActivity = z.infer<typeof StatsSourceActivitySchema>;
+export type StatsRecentActivity = z.infer<typeof StatsRecentActivitySchema>;
+export type StatsResponse = z.infer<typeof StatsResponseSchema>;
+/**
+ * The richer subset of the `GET /v1/stats` response — period + totals +
+ * sourceHealth + sourceActivity + recentActivity. The full wire shape
+ * (`StatsResponse`) merges these fields with the flat back-compat `Stats`
+ * counts.
+ */
+export type StatsSummary = Omit<StatsResponse, "orgs" | "sources" | "releases" | "products">;
 
 // ── Fetch log ──
 
@@ -1069,14 +1073,10 @@ export interface Session {
 export type SessionListResponse = ListResponse<Session>;
 
 // ── Admin URL Lists ──
-
-export interface IgnoredUrlItem {
-  id: string;
-  url: string;
-  orgId: string;
-  reason: string | null;
-  ignoredAt: string;
-}
+// `IgnoredUrlItem` is now the Zod-derived type exported in the Organizations
+// section. The hand-written interface below is removed to avoid a duplicate
+// identifier; callsites that imported it from here continue to work because
+// the Zod-derived alias has the same shape.
 
 export interface BlockedUrlItem {
   id: string;