@buildinternet/releases-api-types 0.35.0 → 0.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",

package/src/api-types.ts

@@ -818,6 +818,11 @@ export interface ReleaseDetail {
   /** Explicit upgrade/migration steps lifted from the body (#1696); null when the body gives none. */
   migrationNotes?: string | null;
   url: string | null;
+  /**
+   * Canonical releases.sh detail-page URL (friendly form: ID + current
+   * title slug). Additive — older servers omit it.
+   */
+  webUrl?: string;
   media: MediaItem[];
   publishedAt: string | null;
   fetchedAt: string;
@@ -1235,7 +1240,7 @@ export type UpdatePlaybookNotesResponse = z.infer<typeof UpdatePlaybookNotesResp
 
 export type OverviewStaleness = "missing" | "behind" | "fresh";
 /**
- * `opted_out` — the org has `autoGenerateContent=false`, so the batch-overview
+ * `opted_out` — the org has `autoGenerateContent=false`, so the overview-regen
  * eligibility filter skips it regardless of staleness. Surfaced so an
  * orchestrator planning a sweep doesn't queue a regen that will never run
  * (#1795).
@@ -1261,7 +1266,7 @@ export interface OverviewManifestRow {
   staleness: OverviewStaleness;
   /**
    * Whether the org is opted into automatic AI content. When `false`, the
-   * batch-overview cron/manual regen skips it — the staleness signal alone is
+   * overview-regen cron skips it — the staleness signal alone is
    * misleading without this (#1795). Older workers may omit it mid-deploy.
    */
   autoGenerateContent?: boolean;

package/src/schemas/orgs.ts

@@ -120,6 +120,13 @@ export const UpdateOrgBodySchema = z.object({
   isHidden: z.boolean().optional(),
   /** Admin-only: opt the org into automatic AI content — org overviews AND per-release summaries (single backend flag `auto_generate_content`). */
   autoGenerateContent: z.boolean().optional(),
+  /**
+   * Admin-only: manual override for the automated overview-regen cadence in
+   * days (#1895). `null` clears back to automatic (velocity-tiered: 7d
+   * default, 2d at high release velocity). A set value pins the cadence in
+   * either direction — faster for a hot org, slower for a bursty one.
+   */
+  overviewCadenceDays: z.number().int().min(1).max(90).nullable().optional(),
   /** Admin-only: promote this org on the home-page featured rail. */
   featured: z.boolean().optional(),
   /** Admin-only: promote or demote the org's discovery status (curated/agent/on_demand). */
@@ -465,6 +472,8 @@ export const OrgDetailSchema = z.object({
   isHidden: z.boolean().optional(),
   /** Admin display flag: org is opted into automatic overviews + per-release summaries. Optional on the wire for older workers mid-deploy. */
   autoGenerateContent: z.boolean().optional(),
+  /** Manual overview-regen cadence override in days (#1895); null = automatic velocity tier. Optional on the wire for older workers mid-deploy. */
+  overviewCadenceDays: z.number().int().nullable().optional(),
   /** Admin display flag: org is promoted on the home-page featured rail. Optional on the wire for older workers mid-deploy. */
   featured: z.boolean().optional(),
   /** Admin display flag: all ingest paused for this org. */

package/src/schemas/releases.ts

@@ -62,6 +62,11 @@ export const ReleaseLatestItemSchema = z.object({
   breaking: z.enum(BREAKING_LEVELS).optional(),
   publishedAt: z.string().nullable(),
   url: z.string().nullable(),
+  /**
+   * Canonical releases.sh detail-page URL (friendly form: ID + current
+   * title slug). Additive — older servers and the digest-cron path omit it.
+   */
+  webUrl: z.string().optional(),
   media: z.array(MediaItemSchema),
   source: ReleaseLatestSourceSchema,
   /**
@@ -237,6 +242,13 @@ export const ReleaseDetailResponseSchema = z.object({
    */
   migrationNotes: z.string().nullable().optional(),
   url: z.string().nullable(),
+  /**
+   * Canonical releases.sh detail-page URL, `https://releases.sh/release/
+   * rel_<id>-<slug>` (Zendesk-style: immutable ID + current title slug;
+   * the slug follows title regeneration, the ID keeps old links alive).
+   * Additive — older servers omit it.
+   */
+  webUrl: z.string().optional(),
   contentHash: z.string().nullable(),
   media: z.array(MediaItemSchema),
   publishedAt: z.string().nullable(),