@rizom/ops 0.2.0-alpha.167 → 0.2.0-alpha.169

package/dist/images.d.ts

@@ -0,0 +1,40 @@
+import type { ResolvedSiteOverride } from "./load-registry";
+/**
+ * Resolve a fleet image tag as a pure function of a single instance's own
+ * config. This is the shared contract between the build (which tags the image
+ * it pushes) and the deploy (which waits for and runs that tag), so both must
+ * import this — never recompute it independently.
+ *
+ * The default path is deliberately untouched: an instance with no site packages
+ * resolves to the plain `brain-{version}` tag every other fleet instance uses.
+ * A site override is a per-instance opt-in that hashes only *that instance's*
+ * package set into a distinct `brain-{version}-sites-{hash}` image, so it can
+ * never collide with — or leak into — the shared default image.
+ */
+export declare function siteImageTag(brainVersion: string, sitePackages: string[]): string;
+/**
+ * The npm packages a site override installs into its per-instance image.
+ * A @rizom-scoped theme is an independently published package and rides along
+ * at the same lockstep version; @brains/* themes are bundled inside
+ * @rizom/brain and must not be npm-installed.
+ */
+export declare function sitePackagesFor(siteOverride: ResolvedSiteOverride | undefined): string[];
+/** The per-user slice of the registry that determines which image it runs. */
+export interface ImageRequirementSource {
+    brainVersion: string;
+    siteOverride?: ResolvedSiteOverride | undefined;
+}
+export interface RequiredImage {
+    tag: string;
+    brainVersion: string;
+    /** Sorted, deduped — build args for the image, empty for the default. */
+    sitePackages: string[];
+}
+/**
+ * The image set the declared fleet state requires: one default
+ * `brain-{version}` per distinct brain version in use, plus one
+ * `brain-{version}-sites-{hash}` per distinct site-override package set.
+ * Derived purely from resolved users (pass `registry.users`), so CI can build
+ * exactly what a config push declares — nothing reactive, nothing manual.
+ */
+export declare function requiredImages(users: ImageRequirementSource[]): RequiredImage[];

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { initPilotRepo } from "./init";
 export { loadPilotRegistry, type LoadPilotRegistryOptions, } from "./load-registry";
+export { siteImageTag, sitePackagesFor, requiredImages, type ImageRequirementSource, type RequiredImage, } from "./images";
 export { writeUsersTable } from "./render-users-table";
 export { onboardUser } from "./onboard-user";
 export { addPilotUser } from "./user-add";