@buildinternet/releases-api-types 0.44.0 → 0.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@buildinternet/releases-core": "^0.25.0",
+    "@buildinternet/releases-core": "^0.26.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -888,6 +888,12 @@ export interface ReleaseDetail {
   breaking?: BreakingLevel;
   /** Explicit upgrade/migration steps lifted from the body (#1696); null when the body gives none. */
   migrationNotes?: string | null;
+  /**
+   * AI-scored release importance, 1 (housekeeping) to 5 (landmark). Scored at
+   * ingest by the release-content pass; fail-open — null/absent means not
+   * scored. Additive — older servers omit it.
+   */
+  importance?: number | null;
   url: string | null;
   /**
    * Canonical releases.sh detail-page URL (friendly form: ID + current
@@ -1537,6 +1543,8 @@ export interface ReleaseWithSource {
   titleGenerated?: string | null;
   /** AI-generated smart-brevity headline (#852, renamed in #860). */
   titleShort?: string | null;
+  /** AI-scored importance 1–5. See {@link ReleaseDetail.importance}. */
+  importance?: number | null;
   url: string | null;
   contentHash: string | null;
   metadata: string | null;
@@ -1580,6 +1588,8 @@ export interface LatestRelease {
   titleGenerated?: string | null;
   /** AI-generated smart-brevity headline (#852, renamed in #860). */
   titleShort?: string | null;
+  /** AI-scored importance 1–5. See {@link ReleaseDetail.importance}. */
+  importance?: number | null;
   media: MediaItem[];
   /**
    * Cached release-body size — `LENGTH(content)` and `countTokensSafe(content)`

package/src/schemas/orgs.ts

@@ -4,6 +4,7 @@ import { BREAKING_LEVELS } from "@buildinternet/releases-core/breaking";
 import {
   AppStoreSourceInfoSchema,
   CategorySchema,
+  ImportanceScoreSchema,
   ListResponseSchema,
   NoticeSchema,
   OrgStatusSchema,
@@ -459,6 +460,7 @@ export const OrgRecentReleaseItemSchema = z.object({
    * means not classified. List paths carry `breaking` only.
    */
   breaking: z.enum(BREAKING_LEVELS).optional(),
+  importance: ImportanceScoreSchema,
   url: z.string().nullable(),
   contentHash: z.string().nullable(),
   metadata: z.string().nullable(),

package/src/schemas/releases.ts

@@ -4,6 +4,7 @@ import { BREAKING_LEVELS } from "@buildinternet/releases-core/breaking";
 import { KIND_VALUES } from "@buildinternet/releases-core/kinds";
 import {
   AppStoreSourceInfoSchema,
+  ImportanceScoreSchema,
   MediaItemSchema,
   ReleaseCompositionSchema,
   ReleaseThumbnailSchema,
@@ -71,6 +72,7 @@ export const ReleaseLatestItemSchema = z.object({
    * `migrationNotes` stays detail-route-only to keep list payloads slim.
    */
   breaking: z.enum(BREAKING_LEVELS).optional(),
+  importance: ImportanceScoreSchema,
   publishedAt: z.string().nullable(),
   url: z.string().nullable(),
   /**
@@ -260,6 +262,7 @@ export const ReleaseDetailResponseSchema = z.object({
    * `ReleaseDetail.breaking` in api-types.ts.
    */
   breaking: z.enum(BREAKING_LEVELS).optional(),
+  importance: ImportanceScoreSchema,
   /**
    * Explicit upgrade/migration steps lifted from the body (#1696); omitted
    * when the body gives none. Detail-route-only — list paths never carry it.

package/src/schemas/shared.ts

@@ -3,9 +3,23 @@ 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(),
@@ -147,6 +161,7 @@ export const ReleaseItemSchema = z.object({
   // 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