@serve.zone/interfaces 32.15.0 → 32.16.0

package/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-09-20 - 32.16.0
+
+### Features
+
+- Add bounded Docker census derivation helpers for full open-schema service-spec digests, exact
+  duplicate-preserving constraint identity, desired-task counts, established ownership labels and
+  exact mount classification. Preserve physical volume source identity while adding optional,
+  complete value-free correlation evidence from a local volume name to its service-spec mount.
+
 ## 2026-09-20 - 32.15.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '32.15.0',
+    version: '32.16.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFNBQVM7SUFDbEIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/data/fleetcutover.d.ts

@@ -35,6 +35,33 @@ export interface IFleetCutoverMountTargetIdentityInput {
     /** Docker Engine Mount.Destination exact UTF-8 bytes; never normalize. */
     target: string;
 }
+export interface IFleetCutoverDockerMountInput {
+    /** Raw Docker mount type. Unsupported values produce an explicit unknown descriptor. */
+    type: string;
+    /** Exact source bytes from the Docker object being described; never substitute another field. */
+    source: string;
+    /** Exact container target bytes from the Docker object being described. */
+    target: string;
+    readOnly: boolean;
+}
+/**
+ * Value-free correlation between one local physical mount and its service-spec mount identity.
+ * The two identities stay distinct: a Docker volume's local Source is a host path while its
+ * service Source and local Name are the logical volume name.
+ */
+export interface IFleetCutoverPhysicalMountCorrelation {
+    physicalMountIdentityDigest: TSha256Digest;
+    serviceMountIdentityDigest: TSha256Digest;
+    correlationIdentityDigest: TSha256Digest;
+}
+export interface IFleetCutoverPhysicalMountEvidence {
+    mount: IFleetCutoverMountDescriptor;
+    correlation: IFleetCutoverPhysicalMountCorrelation;
+}
+export interface IFleetCutoverDockerConstraintSetIdentity {
+    constraintCount: number;
+    constraintSetDigest: TSha256Digest;
+}
 export type TFleetCutoverDockerTaskState = 'new' | 'allocated' | 'pending' | 'assigned' | 'accepted' | 'preparing' | 'ready' | 'starting' | 'running' | 'complete' | 'shutdown' | 'failed' | 'rejected' | 'remove' | 'orphaned';
 export type TFleetCutoverDockerDesiredState = TFleetCutoverDockerTaskState;
 export type TFleetCutoverDockerServiceMode = {
@@ -83,6 +110,11 @@ export interface IFleetCutoverPhysicalContainer {
     imageId: TSha256Digest;
     serviceIdLabel: string | null;
     mounts: IFleetCutoverMountDescriptor[];
+    /**
+     * Optional only for compatibility with observations predating correlation evidence. When
+     * present it is a complete one-to-one mapping of mounts. Absence establishes no mount join.
+     */
+    mountCorrelations?: IFleetCutoverPhysicalMountCorrelation[];
 }
 export interface IFleetCutoverContainerSetIdentity {
     containerCount: number;
@@ -554,6 +586,9 @@ export declare const fleetCutoverContract: Readonly<{
     readonly maximumNodes: 1024;
     readonly maximumContainersPerNode: 512;
     readonly maximumMountsPerOwner: 32;
+    readonly maximumConstraintsPerService: 256;
+    readonly maximumDockerTextBytes: 4096;
+    readonly maximumDockerServiceSpecCanonicalBytes: 1048576;
     readonly maximumPreparedVolumeHandoffMutationEntries: 32;
     /** Every admitted task has one node placement and at most 32 mounts: 4096 * 32. */
     readonly maximumPreparedVolumeHandoffs: number;
@@ -564,6 +599,9 @@ export declare const fleetCutoverContract: Readonly<{
     readonly mountSourceIdentityDigestDomain: "serve.zone/fleet-cutover-mount-source-identity";
     readonly mountTargetIdentityDigestDomain: "serve.zone/fleet-cutover-mount-target-identity";
     readonly mountIdentityDigestDomain: "serve.zone/fleet-cutover-mount-identity";
+    readonly mountCorrelationIdentityDigestDomain: "serve.zone/fleet-cutover-mount-correlation-identity";
+    readonly dockerServiceSpecDigestDomain: "serve.zone/fleet-cutover-docker-service-spec";
+    readonly dockerConstraintSetDigestDomain: "serve.zone/fleet-cutover-docker-constraint-set";
     readonly containerSetIdentityDigestDomain: "serve.zone/fleet-cutover-container-set-identity";
     readonly localNodeSnapshotDigestDomain: "serve.zone/fleet-cutover-local-node-snapshot";
     readonly managerSnapshotDigestDomain: "serve.zone/fleet-cutover-manager-snapshot";
@@ -588,9 +626,36 @@ export declare const fleetCutoverContract: Readonly<{
         pallet: null;
     }>;
 }>;
+/** Docker labels with established historical producer semantics. */
+export declare const fleetCutoverDockerLabelNames: Readonly<{
+    readonly serviceId: "serve.zone.serviceId";
+}>;
+/**
+ * Hash the complete open-schema Docker Service.Spec object. Unknown response properties are
+ * intentionally included: this helper returns only the digest and never a retained projection.
+ */
+export declare const computeFleetCutoverDockerServiceSpecDigest: (valueArg: unknown) => Promise<TSha256Digest>;
+/** Sort exact constraint strings while preserving duplicate entries, then return value-free identity. */
+export declare const computeFleetCutoverDockerConstraintSetIdentity: (valueArg: unknown) => Promise<IFleetCutoverDockerConstraintSetIdentity>;
+export declare const snapshotFleetCutoverDockerDesiredTaskCount: (valueArg: unknown) => number;
+export declare const validateFleetCutoverDockerDesiredTaskCount: (valueArg: unknown) => string[];
+/** Apply only the documented exact cutover mount classifications; no path normalization occurs. */
+export declare const classifyFleetCutoverDockerMount: (valueArg: IFleetCutoverDockerMountInput) => Pick<IFleetCutoverMountDescriptor, "type" | "classification">;
+export declare const createFleetCutoverMountDescriptor: (valueArg: IFleetCutoverDockerMountInput) => Promise<IFleetCutoverMountDescriptor>;
+/** Read only consumed Service.Spec Mount fields; future Docker response properties are ignored. */
+export declare const createFleetCutoverDockerServiceMountDescriptor: (valueArg: unknown) => Promise<IFleetCutoverMountDescriptor>;
+/** Read only consumed local MountPoint fields and retain the exact physical Source identity. */
+export declare const createFleetCutoverDockerLocalMountDescriptor: (valueArg: unknown) => Promise<IFleetCutoverMountDescriptor>;
 export declare const computeFleetCutoverMountSourceIdentityDigest: (valueArg: IFleetCutoverMountSourceIdentityInput) => Promise<TSha256Digest>;
 export declare const computeFleetCutoverMountTargetIdentityDigest: (valueArg: IFleetCutoverMountTargetIdentityInput) => Promise<TSha256Digest>;
 export declare const computeFleetCutoverMountIdentityDigest: (valueArg: Omit<IFleetCutoverMountDescriptor, "mountIdentityDigest">) => Promise<TSha256Digest>;
+export declare const computeFleetCutoverMountCorrelationIdentityDigest: (valueArg: Omit<IFleetCutoverPhysicalMountCorrelation, "correlationIdentityDigest">) => Promise<TSha256Digest>;
+/**
+ * Produce both the exact local physical descriptor and its logical service-mount correlation.
+ * For a volume only MountPoint.Name supplies the logical source. Unknown types and a missing or
+ * empty volume Name are refused because they cannot establish a truthful service join.
+ */
+export declare const createFleetCutoverDockerPhysicalMountEvidence: (valueArg: unknown) => Promise<IFleetCutoverPhysicalMountEvidence>;
 export declare const computeFleetCutoverContainerSetIdentityDigest: (containerIdsArg: string[]) => Promise<TSha256Digest>;
 export declare const snapshotFleetCutoverLocalNodeSnapshot: (valueArg: unknown) => IFleetCutoverLocalNodeSnapshot;
 export declare const computeFleetCutoverLocalNodeSnapshotDigest: (valueArg: unknown) => Promise<TSha256Digest>;