@buildinternet/releases-api-types 0.59.0 → 0.60.0

package/src/schemas/search.ts

@@ -1,274 +0,0 @@
-import { z } from "zod";
-import { KIND_VALUES } from "@buildinternet/releases-core/kinds";
-import {
-  AppStoreSourceInfoSchema,
-  ImportanceScoreSchema,
-  MediaItemSchema,
-  OrgStatusSchema,
-  ReleaseThumbnailSchema,
-  ReleaseTypeSchema,
-  VideoSourceInfoSchema,
-} from "./shared.js";
-import { SourceTypeSchema } from "./sources.js";
-import { LookupStatusSchema } from "./lookups.js";
-import { CollectionMemberSchema } from "./collections.js";
-
-/**
- * Org hit on the unified `/v1/search` response. The list is built either
- * from `searchOrgs` LIKE matches or, when `?domain=` resolves, from a
- * single-row "scoped org" projection — both produce the same wire shape.
- *
- * `category` is loose (`z.string().nullable()`) rather than the canonical
- * `CategorySchema` enum because the scoped-org projection passes the raw
- * DB column through without going through `resolveCategoryInput`; legacy
- * rows may carry deprecated slugs that haven't been migrated yet. Tighten
- * once #689 (category overlay backfill) lands across the prod data set.
- */
-export const SearchOrgHitSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  avatarUrl: z.string().nullable(),
-  category: z.string().nullable(),
-  /**
-   * Org tier (#1947/#2034). Optional for mid-deploy tolerance; absent ⇒
-   * `"tracked"`. Lets search render the icon-only stub marker (#2031 parity).
-   */
-  status: OrgStatusSchema.optional(),
-  /**
-   * Org-level alternate domains (product-scoped aliases excluded, sorted),
-   * for the `+N` hover on the origin domain — the anti-impersonation anchor
-   * mirrored from the catalog row (#2031/#2034). Optional; absent ⇒ none.
-   */
-  aliasDomains: z.array(z.string()).optional(),
-});
-
-/**
- * Unified catalog entry — either a product row or a standalone source
- * presented as product-shaped. `entryType` discriminates between the two
- * row shapes (`"product"` vs `"source"`). `kind` carries the entity
- * taxonomy (platform/sdk/mobile/…). `entryType` (not `type`) because
- * source rows already carry `type: github|scrape|feed|agent` on the wire.
- */
-export const SearchCatalogHitSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable(),
-  /** Owning org's avatar URL, for a small inline byline avatar. Products have
-   *  no avatar of their own, so the web row anchors on the org's instead. */
-  orgAvatarUrl: z.string().nullable().optional(),
-  // Loose `z.string().nullable()` rather than the canonical `CategorySchema`
-  // enum because `foldSourcesIntoCatalog` and the catalog-search handlers
-  // pass `s.productCategory` / `o.category` through without validating
-  // against `resolveCategoryInput`. Legacy rows may carry deprecated slugs
-  // that haven't been migrated yet. Tighten once #689 (category overlay
-  // backfill) lands across the prod data set.
-  category: z.string().nullable(),
-  entryType: z.enum(["product", "source"]),
-  kind: z.enum(KIND_VALUES).nullable().optional(),
-  sourceSlug: z.string().optional(),
-  sourceType: SourceTypeSchema.optional(),
-});
-
-export const SearchSourceHitSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  type: SourceTypeSchema,
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable(),
-  productSlug: z.string().nullable(),
-  stars: z.number().int().min(0).nullable().optional(),
-});
-
-export const SearchReleaseHitSchema = z.object({
-  id: z.string(),
-  sourceSlug: z.string(),
-  sourceName: z.string(),
-  // Loose `z.string()` rather than `SourceTypeSchema` because the
-  // release-hit hydration path reads `sources.type` straight from the DB
-  // without re-validating; legacy rows occasionally drift from the
-  // canonical four-value set. Used by the web byline icon.
-  sourceType: z.string().optional(),
-  /**
-   * App Store platform + icon for `type: "appstore"` sources, null/absent
-   * otherwise. Powers the compact app-update treatment on the search card. #1206
-   */
-  appStore: AppStoreSourceInfoSchema.nullable().optional(),
-  /**
-   * Video provider tag for `type: "video"` sources, absent otherwise. Powers
-   * the thumbnail-forward video row on search cards. #video
-   */
-  video: VideoSourceInfoSchema.nullable().optional(),
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable().optional(),
-  /** Owning product slug — present when the source belongs to a product. Lets
-   *  the web byline link to the product page instead of the source. */
-  productSlug: z.string().nullable().optional(),
-  version: z.string().nullable(),
-  title: z.string(),
-  summary: z.string(),
-  titleGenerated: z.string().nullable().optional(),
-  titleShort: z.string().nullable().optional(),
-  /**
-   * The release's upstream source URL, when it has one. Lets the web link
-   * search/lookup hits straight to the original page instead of the
-   * noindexed `/release/<id>` stub — see `releaseLinkProps()` in
-   * `apps/web/src/lib/release-link.ts`. Optional for older servers / mid-deploy
-   * pin tolerance.
-   */
-  url: z.string().nullable().optional(),
-  /**
-   * AI-scored importance 1–5 (5=landmark, 1=housekeeping). Null when
-   * unscored; optional for older servers / mid-deploy pin tolerance.
-   */
-  importance: ImportanceScoreSchema,
-  /**
-   * Full markdown body. Omitted on list hits by default (summary + media
-   * cover the card/snippet surfaces). Opt in with `?include_content=true`
-   * on `/v1/search`. Fetch full body via `GET /v1/releases/:id` otherwise.
-   */
-  content: z.string().optional(),
-  media: z.array(MediaItemSchema).optional(),
-  publishedAt: z.string().nullable(),
-  // Hybrid fusion score; absent on pure-lexical results.
-  score: z.number().optional(),
-  type: ReleaseTypeSchema.optional(),
-  coverageCount: z.number().int().min(0).optional(),
-});
-
-/**
- * Collection hit on the unified `/v1/search` response. Two origins are folded
- * into the same wire shape via the `via` discriminator:
- *
- * - `direct`  — the collection itself matched (name/description via LIKE in
- *               every mode, plus vector match in hybrid/semantic mode).
- * - `member`  — the collection was surfaced because one of the orgs that
- *               *did* match the query is a member of it; `matchedOrgSlugs`
- *               carries the subset of result-set org slugs that triggered
- *               the rollup so the UI can render an "includes X, Y" hint.
- *
- * `direct` rows always sort ahead of `member` rows; ties break on
- * `score` then `memberCount`. Slugs are unique across the array — a
- * direct hit that's also a member rollup keeps only the `direct` row
- * with `matchedOrgSlugs` carried over.
- */
-export const SearchCollectionHitSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  description: z.string().nullable(),
-  memberCount: z.number().int().min(0),
-  via: z.enum(["direct", "member"]),
-  /** Hybrid/semantic fusion score; absent on pure-lexical hits. */
-  score: z.number().optional(),
-  /** Result-set org slugs that triggered this rollup. Always present on `via=member`. */
-  matchedOrgSlugs: z.array(z.string()).optional(),
-  /**
-   * A small org preview (capped at 3) for an inline avatar facepile on the
-   * search card, mirroring the collections list page. Org-kind only — search's
-   * `memberCount` counts orgs, so the facepile and its "+N more" stay
-   * consistent. Attached after hit merge; optional on the wire so older workers
-   * mid-rollout don't trip the schema.
-   */
-  previewMembers: z.array(CollectionMemberSchema).optional(),
-});
-
-/**
- * Heading-aware CHANGELOG.md slice returned by hybrid / semantic search.
- * Clients can deep-link to
- * `/<orgSlug>/<sourceSlug>/changelog?offset=<offset>#chunk` to read the
- * surrounding file content (the web `chunkDeepLink` builder; falls back to
- * the `/source/<sourceSlug>` redirect shim when `orgSlug` is null).
- */
-export const SearchChunkHitSchema = z.object({
-  sourceSlug: z.string(),
-  sourceName: z.string(),
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable().optional(),
-  filePath: z.string(),
-  offset: z.number().int().min(0),
-  length: z.number().int().min(0),
-  heading: z.string().nullable(),
-  snippet: z.string(),
-  score: z.number(),
-});
-
-/**
- * Slim wire payload embedded in a search response when the query is a
- * GitHub `org/repo` coordinate and no existing entity matched. Reuses
- * `LookupStatusSchema` from `./lookups.js` rather than redefining — the
- * thick `POST /v1/lookups` response and the slim search-embedded payload
- * share the same status set.
- */
-export const LookupResultPayloadSchema = z.object({
-  status: LookupStatusSchema,
-  source: z
-    .object({
-      id: z.string(),
-      slug: z.string(),
-      name: z.string(),
-      url: z.string(),
-      discovery: z.enum(["curated", "agent", "on_demand"]),
-      stars: z.number().int().min(0).nullable().optional(),
-    })
-    .optional(),
-  releases: z
-    .array(
-      z.object({
-        id: z.string(),
-        version: z.string().nullable(),
-        title: z.string(),
-        publishedAt: z.string().nullable(),
-        /** First image/gif thumbnail; null when the release has none. */
-        thumbnail: ReleaseThumbnailSchema.nullable().optional(),
-        /** The release's upstream source URL, when it has one. See
-         *  `SearchReleaseHitSchema.url`. */
-        url: z.string().nullable().optional(),
-      }),
-    )
-    .optional(),
-  // Unambiguous "did you mean" rail; null when the org segment matches
-  // multiple curated orgs or none.
-  relatedOrg: z
-    .object({
-      org: z.object({ id: z.string(), slug: z.string(), name: z.string() }),
-      sources: z.array(
-        z.object({ id: z.string(), slug: z.string(), name: z.string(), url: z.string() }),
-      ),
-    })
-    .nullable(),
-});
-
-export const UnifiedSearchResponseSchema = z.object({
-  query: z.string(),
-  // Normalized `?domain=` echo + resolution outcome. Both absent when no
-  // domain filter was applied.
-  domain: z.string().optional(),
-  domainStatus: z.enum(["matched", "not_found"]).optional(),
-  // Normalized `?category=` echo. Present only when a category filter was
-  // applied; the resolved canonical slug (aliases are folded to canonical).
-  // `categoryStatus` is always `matched` because an unknown category is a 400,
-  // not an empty envelope — categories are a fixed enum, unlike collections.
-  category: z.string().optional(),
-  categoryStatus: z.enum(["matched"]).optional(),
-  // Normalized `?collection=` echo + resolution outcome. `not_found` when the
-  // slug matched no collection (empty envelope, mirroring `domainStatus`).
-  collection: z.string().optional(),
-  collectionStatus: z.enum(["matched", "not_found"]).optional(),
-  orgs: z.array(SearchOrgHitSchema),
-  catalog: z.array(SearchCatalogHitSchema),
-  sources: z.array(SearchSourceHitSchema),
-  releases: z.array(SearchReleaseHitSchema),
-  /**
-   * Curated collections matching the query, either directly (name/description
-   * match or vector hit) or via member rollup (one of the result orgs is in
-   * the collection). Optional on the wire so older workers mid-rollout don't
-   * trip the schema check; clients should treat missing and `[]` identically.
-   */
-  collections: z.array(SearchCollectionHitSchema).optional(),
-  chunks: z.array(SearchChunkHitSchema).optional(),
-  mode: z.enum(["lexical", "semantic", "hybrid"]).optional(),
-  degraded: z.boolean().optional(),
-  degradedReason: z.string().optional(),
-  lookup: LookupResultPayloadSchema.nullable().optional(),
-});

package/src/schemas/semantic-alert-summary.ts

@@ -1,65 +0,0 @@
-import { z } from "zod";
-
-/**
- * Admin interest-alert quality (`GET /v1/admin/semantic-alerts/summary`).
- * Decisions live in the classifications Analytics Engine dataset with
- * `blob4 = semantic-alert`. This is the hydrated read model. Alert query
- * text is not a field — it is not stored on the points.
- */
-
-const ProbabilityBinSchema = z.object({
-  /** Inclusive. Width is 0.1. `0.8` is the start of the default-threshold bin. */
-  start: z.number(),
-  /** Exclusive, except the last bin (`0.9`–`1`) which includes `1`. */
-  end: z.number(),
-  count: z.number(),
-});
-
-const SemanticAlertDispositionCountsSchema = z.object({
-  matched: z.number(),
-  belowThreshold: z.number(),
-  failed: z.number(),
-});
-
-/**
- * `GET /v1/admin/semantic-alerts/summary`.
- *
- * `scored` is matched + below threshold (a probability came back).
- * `matchRate` is matched / scored, or null when nothing was scored.
- * `failed` is fail-closed and stays out of the rate.
- * Cost is not on these points; `meta.costLane` names the `ai_usage` lane.
- */
-export const SemanticAlertSummarySchema = z.object({
-  after: z.string(),
-  before: z.string(),
-  bucket: z.enum(["hour", "day"]),
-  totals: SemanticAlertDispositionCountsSchema.extend({
-    scored: z.number(),
-    matchRate: z.number().nullable(),
-  }),
-  series: z.array(
-    SemanticAlertDispositionCountsSchema.extend({
-      t: z.string(),
-    }),
-  ),
-  failures: z.array(
-    z.object({
-      category: z.enum(["provider_error", "invalid_probability", "unknown"]),
-      count: z.number(),
-    }),
-  ),
-  probability: z.object({
-    /** Default alert threshold. Each point stores its own threshold separately. */
-    defaultThreshold: z.literal(0.8),
-    bins: z.array(ProbabilityBinSchema),
-    /** Sampled rows whose probability double is `< 0` (the absent sentinel). */
-    missing: z.number(),
-  }),
-  meta: z.object({
-    dataset: z.string(),
-    retentionDays: z.literal(90),
-    sampled: z.literal(true),
-    /** `ai_usage` lane that carries JEV cost. Not summed from these points. */
-    costLane: z.literal("semantic-alert-match"),
-  }),
-});

package/src/schemas/shared.notice.test.ts

@@ -1,36 +0,0 @@
-import { describe, it, expect } from "bun:test";
-import { NoticeSchema } from "./shared";
-
-describe("NoticeSchema", () => {
-  it("accepts a message-only notice", () => {
-    expect(NoticeSchema.safeParse({ message: "Heads up" }).success).toBe(true);
-  });
-  it("accepts a message + internal coordinate", () => {
-    expect(
-      NoticeSchema.safeParse({
-        message: "Moved",
-        coordinate: "cognition/devin",
-        linkText: "View Devin",
-      }).success,
-    ).toBe(true);
-  });
-  it("accepts a message + external href", () => {
-    expect(NoticeSchema.safeParse({ message: "Moved", href: "https://devin.ai" }).success).toBe(
-      true,
-    );
-  });
-  it("rejects both coordinate and href", () => {
-    expect(
-      NoticeSchema.safeParse({ message: "x", coordinate: "a/b", href: "https://x.com" }).success,
-    ).toBe(false);
-  });
-  it("rejects an empty message and an over-long message", () => {
-    expect(NoticeSchema.safeParse({ message: "" }).success).toBe(false);
-    expect(NoticeSchema.safeParse({ message: "x".repeat(281) }).success).toBe(false);
-  });
-  it("rejects a malformed coordinate", () => {
-    expect(NoticeSchema.safeParse({ message: "x", coordinate: "/leading" }).success).toBe(false);
-    expect(NoticeSchema.safeParse({ message: "x", coordinate: "a/b/c" }).success).toBe(false);
-    expect(NoticeSchema.safeParse({ message: "x", coordinate: "" }).success).toBe(false);
-  });
-});

package/src/schemas/shared.ts

@@ -1,267 +0,0 @@
-import { z } from "zod";
-import { RELEASE_TYPES } from "@buildinternet/releases-core/schema";
-import { BREAKING_LEVELS } from "@buildinternet/releases-core/breaking";
-import { CATEGORIES } from "@buildinternet/releases-core/categories";
-import { isValidNoticeCoordinate } from "@buildinternet/releases-core/notice";
-import { IMPORTANCE_MAX, IMPORTANCE_MIN } from "@buildinternet/releases-core/importance";
-
-export const CategorySchema = z.enum(CATEGORIES);
-
-/**
- * AI-scored release importance, 1 (housekeeping) to 5 (landmark). Scored at
- * ingest; `.nullable().optional()` — null when unscored, absent on older
- * servers/pinned workers.
- */
-export const ImportanceScoreSchema = z
-  .number()
-  .int()
-  .min(IMPORTANCE_MIN)
-  .max(IMPORTANCE_MAX)
-  .nullable()
-  .optional();
-
-export const MediaItemSchema = z.object({
-  type: z.enum(["image", "video", "gif"]),
-  url: z.string(),
-  alt: z.string().optional(),
-  // R2 object key (`releases/<hash>.<ext>`) for media mirrored into the
-  // `released-media` bucket; read paths resolve it to a same-origin `r2Url`
-  // (`resolveR2Url`). Stamped by `processMediaForR2` at ingest / manual edit and
-  // part of the stored `media[]` JSON — surfaced on the wire so a curator round-
-  // tripping `media` through `PATCH /v1/releases/:id` can preserve an already-
-  // mirrored item without forcing a re-fetch.
-  r2Key: z.string().optional(),
-  r2Url: z.string().optional(),
-  // For `type: "video"` items promoted from a hosted-video link found inline in
-  // a release body (Wistia/Loom/Vimeo/YouTube), `url` holds the poster/thumbnail
-  // (mirrored to R2 like any image) and `linkUrl` holds the human watch URL the
-  // play-card links out to. Absent for ordinary image/gif media. See
-  // `detectInlineVideos` in `@releases/rendering/video-embed` and web's
-  // release-content video card.
-  linkUrl: z.string().optional(),
-});
-
-/**
- * App Store platform + icon for a `type: "appstore"` source. Threaded onto
- * read surfaces so the UI can render the compact app-update row (app icon +
- * "Available for iOS/macOS") instead of the standard version/notes/thumbnail
- * layout. Sourced from `source.metadata.appStore` server-side. #mobile-appstore-feed-row
- */
-export const AppStoreSourceInfoSchema = z.object({
-  platform: z.enum(["ios", "macos"]),
-  iconUrl: z.string().nullable(),
-});
-
-/** Video provider tag, present only when `sourceType === "video"`. Thumbnail
- * and watch URL reuse the release's existing `media[]` / `url`. */
-export const VideoSourceInfoSchema = z.object({
-  provider: z.enum(["youtube", "vimeo", "wistia"]),
-});
-
-/**
- * Org tier surfaced on read paths (#1947). `stub` = known only by declared
- * release locations (no processed sources yet); `tracked` = a normal org whose
- * sources fetch. The column is `organizations.tier`; the wire name is `status`.
- * Optional on the wire so a pinned client mid-deploy tolerates its absence —
- * treat a missing value as `"tracked"`.
- */
-export const OrgStatusSchema = z.enum(["stub", "tracked"]);
-
-/**
- * A declared release location (#1947) — one `release_locations` row on the
- * wire, the same shape a releases.json `releases[]` entry carries plus its
- * provenance `basis` and, once promoted, the `sourceId` it materialized into.
- * Surfaced on stub orgs so an agent gets "release info is published at these
- * locations" instead of an empty sources list.
- */
-export const ReleaseLocationItemSchema = z.object({
-  url: z.string().optional(),
-  feed: z.string().optional(),
-  github: z.string().optional(),
-  appstore: z.string().optional(),
-  file: z.string().optional(),
-  title: z.string().nullable().optional(),
-  canonical: z.boolean(),
-  basis: z.enum(["curator", "declared", "detected", "generated"]),
-  /** Owning product id when the locator is product-scoped, else null. */
-  productId: z.string().nullable(),
-  /** Set once the locator has been promoted into a source, else null. */
-  sourceId: z.string().nullable(),
-  /** `"push"` when the owner publishes this changelog instead of us polling it. */
-  publish: z.literal("push").optional(),
-  /** Changelog file or glob. Present with `publish: "push"`. */
-  path: z.string().optional(),
-});
-
-export const PaginationSchema = z.object({
-  page: z.number().int().min(1),
-  pageSize: z.number().int().min(1),
-  returned: z.number().int().min(0),
-  totalItems: z.number().int().min(0).optional(),
-  totalPages: z.number().int().min(0).optional(),
-  hasMore: z.boolean(),
-});
-
-export const ListResponseSchema = <T extends z.ZodTypeAny>(item: T) =>
-  z.object({
-    items: z.array(item),
-    pagination: PaginationSchema,
-  });
-
-export const StatsSchema = z.object({
-  orgs: z.number().int().min(0),
-  sources: z.number().int().min(0),
-  releases: z.number().int().min(0),
-  products: z.number().int().min(0),
-});
-
-export const ReleaseTypeSchema = z.enum(RELEASE_TYPES);
-
-/**
- * Per-category item counts produced by the AI release-content pass and
- * persisted on `releases.metadata.composition`. Surfaces as a chip on the
- * release detail UI ("12 fixes · 3 features"); `null` when the row hasn't
- * been through the AI pass yet, the body was empty/boilerplate, or all
- * three counts came back zero (we filter that case out on the parse side).
- */
-export const ReleaseCompositionSchema = z.object({
-  bugs: z.number().int().min(0),
-  features: z.number().int().min(0),
-  enhancements: z.number().int().min(0),
-});
-
-export const ReleaseItemSchema = z.object({
-  id: z.string().optional(),
-  version: z.string().nullable(),
-  title: z.string(),
-  summary: z.string(),
-  content: z.string().optional(),
-  publishedAt: z.string().nullable(),
-  // ISO timestamp of when the row was fetched/inserted — used by the feed
-  // cursor's tie-break (publishedAt|fetchedAt|id) so that same-`publishedAt`
-  // rows stay stably ordered across paginated requests. `.optional()` because
-  // not every endpoint that returns a ReleaseItem populates it (notably
-  // single-release reads).
-  fetchedAt: z.string().optional(),
-  url: z.string().nullable(),
-  media: z.array(MediaItemSchema).optional(),
-  // `.optional()` — older API responses (mid-deploy or pinned old workers)
-  // may omit `type`; consumers should treat `undefined` as `"feature"`.
-  type: ReleaseTypeSchema.optional(),
-  // Pre-release flag (alpha/beta/rc/preview/nightly). Computed at ingest —
-  // GitHub uses the API's authoritative `prerelease` field; other adapters
-  // fall back to a SemVer-prerelease regex. `.optional()` for the same
-  // older-response degrade-gracefully reason as `type`.
-  prerelease: z.boolean().optional(),
-  // AI-generated headline forms paired with `summary` (#852, renamed in #860).
-  // Both nullable — most rows in the DB have neither populated, and we don't
-  // plan to backfill, so consumers must fall back to `title` for display.
-  // `.optional()` for the same mid-deploy / pinned-worker reason as `type`.
-  titleGenerated: z.string().nullable().optional(),
-  titleShort: z.string().nullable().optional(),
-  // Machine-readable breaking-change level (#1696, surfaced on read paths in
-  // #1710). `.optional()` for mid-deploy / pinned-worker tolerance and because
-  // rows predating the column omit it; absent or `"unknown"` means not
-  // classified (the fail-open default). List paths carry `breaking` only —
-  // `migrationNotes` stays detail-route-only to keep list payloads slim.
-  breaking: z.enum(BREAKING_LEVELS).optional(),
-  importance: ImportanceScoreSchema,
-  // Count of demoted siblings rolling up into this row via `release_coverage`
-  // (0 when standalone). Lets list views show a cluster indicator without a
-  // detail-page round trip. `.optional()` — older API responses and pinned
-  // workers omit the field; treat undefined as 0.
-  coverageCount: z.number().int().min(0).optional(),
-  // Cached `LENGTH(content)` and `countTokensSafe(content)` for the release
-  // body — lets feed surfaces ("releases get <org>", `/v1/releases/latest`,
-  // MCP `get_latest_releases`) advertise "this release is ~1.5K tokens" so
-  // agents can decide whether to pull the full body. `.optional()` and
-  // nullable because pre-existing rows landed without the columns; the
-  // backfill script populates them and renderers degrade to "size unknown"
-  // when null. See #958.
-  contentChars: z.number().int().min(0).nullable().optional(),
-  contentTokens: z.number().int().min(0).nullable().optional(),
-  // Per-category item counts produced by the AI release-content pass and
-  // stored on `releases.metadata.composition`. `null`/`undefined` when the
-  // row hasn't been through the AI pass yet or the body was boilerplate.
-  composition: ReleaseCompositionSchema.nullable().optional(),
-});
-
-export const ReleaseSummaryItemSchema = z.object({
-  year: z.number().int().nullable().optional(),
-  month: z.number().int().nullable().optional(),
-  windowDays: z.number().int().nullable().optional(),
-  summary: z.string(),
-  releaseCount: z.number().int().min(0),
-  generatedAt: z.string(),
-});
-
-/**
- * A source attached to an overview page (#846, reshaped #1934). Each row names
- * a source the overview drew on — `sourceUrl` plus, when it resolved to an
- * on-registry release, `releaseId` + a canonical `releaseWebUrl`. This is a
- * source *list*, not span-anchored provenance: the old body char offsets +
- * verbatim quote are removed. Optional everywhere it appears — consumers should
- * degrade gracefully.
- */
-export const OverviewCitationSchema = z.object({
-  sourceUrl: z.string(),
-  title: z.string().nullable().optional(),
-  /** Best-effort link to the on-registry release this source maps to (resolved server-side). */
-  releaseId: z.string().nullable().optional(),
-  /**
-   * Canonical web URL of the on-registry release page for this source, when
-   * `releaseId` resolved (#1934). Kept for machine consumers; the web Sources
-   * footer links `sourceUrl` (the #2218 link policy — `/release/*` pages are
-   * noindexed).
-   */
-  releaseWebUrl: z.string().nullable().optional(),
-  /**
-   * @deprecated Body char offsets / verbatim quote — removed with span-anchored
-   * citations (#1934). Kept optional for wire back-compat; no producer emits
-   * them and no consumer should read them.
-   */
-  startIndex: z.number().int().min(0).optional(),
-  endIndex: z.number().int().min(0).optional(),
-  citedText: z.string().optional(),
-});
-
-/**
- * Entity notice — a small curator-set note on an org / product / source. Stored
- * under the `notice` key of the entity's metadata JSON; mirrors the `Notice`
- * type in @buildinternet/releases-core/notice. `coordinate` is an internal
- * registry path ("org" / "org/slug"); `href` is an external URL; at most one.
- */
-export const NoticeSchema = z
-  .object({
-    message: z.string().min(1).max(280),
-    linkText: z.string().min(1).max(60).optional(),
-    coordinate: z.string().min(1).max(200).optional(),
-    href: z.url().max(500).optional(),
-  })
-  .refine((n) => !(n.coordinate && n.href), {
-    message: "notice may set coordinate or href, not both",
-  })
-  .refine((n) => !n.coordinate || isValidNoticeCoordinate(n.coordinate), {
-    message: "notice.coordinate must be 'org' or 'org/slug'",
-  });
-
-/**
- * Display thumbnail derived server-side from a release's first image/gif media
- * entry. Shared by the coverage, lookup, and related-release payloads.
- */
-export const ReleaseThumbnailSchema = z.object({
-  url: z.string(),
-  alt: z.string().optional(),
-});
-
-export const OverviewPageItemSchema = z.object({
-  scope: z.enum(["org", "product"]),
-  orgSlug: z.string().nullable().optional(),
-  productSlug: z.string().nullable().optional(),
-  content: z.string(),
-  releaseCount: z.number().int().min(0),
-  lastContributingReleaseAt: z.string().nullable(),
-  generatedAt: z.string(),
-  updatedAt: z.string(),
-  citations: z.array(OverviewCitationSchema).optional(),
-});