@rizom/ops 0.2.0-alpha.483 → 0.2.0-alpha.484

package/dist/images.d.ts

@@ -3,11 +3,16 @@ export type { RequiredImage } from "./image-types";
 import { type ResolvedSiteOverride } from "./load-registry";
 import { type RunCommand } from "@brains/deploy-support/run-subprocess";
 /**
- * Resolve the immutable runtime image shared by every fleet instance on one
- * Brain version. Build and Deploy both import this function so their tags can
- * never disagree.
+ * Name the immutable runtime image for a Brain version and the exact site
+ * packages installed into it: `brain-<version>` for an instance without site
+ * pins, else that followed by each pin, sorted, in registry-safe spelling
+ * (`@rizom/site-x@1.2.3` → `rizom-site-x-1.2.3`). A pin set too long to spell
+ * out is named by a digest of it instead. Every instance with the same Brain
+ * version and pins shares one image; a change of pins is a new image, so a
+ * site can move on its own. Build and Deploy both import this function so
+ * their tags can never disagree.
  */
-export declare function runtimeImageTag(brainVersion: string): string;
+export declare function runtimeImageTag(brainVersion: string, sitePackages?: readonly string[]): string;
 /**
  * The npm packages a site override contributes to every new fleet image.
  * A @rizom-scoped theme is independently published and installs at its own
@@ -21,18 +26,19 @@ export interface ImageRequirementSource {
     siteOverride?: ResolvedSiteOverride | undefined;
 }
 /**
- * Derive one immutable image per effective Brain version. Each image contains
- * the union of exact site/theme package pins across the entire fleet, including
- * instances still on older Brain versions. Promotion must not change an image.
+ * Derive one immutable image per effective Brain version and site pin set:
+ * every instance runs the image named by its own version and pins, so a
+ * site's pin change builds that site's image and no other, and promoting an
+ * instance to a version keeps whatever image already carries its pins there.
  */
 export declare function requiredImages(users: ImageRequirementSource[]): RequiredImage[];
 export interface ResolveImageBuildsOptions {
     users: ImageRequirementSource[];
     /**
      * Explicit dispatch override — the manual/backfill path. When set, exactly
-     * this one version is built with the fleet union plus explicit extra pins. Published
-     * tags stay immutable: a same-tag rebuild from a newer Dockerfile can
-     * strand the tag boot-broken, so rebuilding needs allowTagOverwrite.
+     * one image is built: this version with exactly the dispatched pins.
+     * Published tags stay immutable: a same-tag rebuild from a newer Dockerfile
+     * can strand the tag boot-broken, so rebuilding needs allowTagOverwrite.
      */
     brainVersionInput?: string | undefined;
     sitePackagesInput?: string | undefined;