@inquir/compute 0.4.4 → 0.4.5

package/dist/system-packages.d.ts

@@ -281,6 +281,379 @@ export declare const inquirYamlFunctionsSchema: z.ZodObject<{
 export declare function declaredSystemConfig(document: unknown, functionName: string): FunctionSystemConfig | null | undefined;
 /** The keys inquir.yaml may hold at the top level (apps: version, services; functions: build, functions). */
 export declare const INQUIR_YAML_TOP_LEVEL_KEYS: readonly ["version", "services", "build", "functions"];
+/**
+ * `services.web.scale` (docs/roadmap/STATEFUL_REPLICAS.md §7): the platform's
+ * validator is src/apps/app-scale-spec.ts; these constants and the schema
+ * below are its twin, kept equal by src/services/inquir-yaml-schema-parity.test.ts.
+ * Cross-field rules JSON Schema cannot express (an ordinal below `replicas`,
+ * a `fallback` or `public` that names an existing endpoint) are the platform's.
+ */
+export declare const SCALE_MAX_REPLICAS = 8;
+export declare const SCALE_MAX_ENDPOINTS = 8;
+export declare const SCALE_NAME_PATTERN = "^[a-z][a-z0-9-]{0,30}$";
+export declare const SCALE_ORDINAL_SELECTOR_PATTERN = "^[0-9]{1,2}(-([0-9]{1,2})?)?(,[0-9]{1,2}(-([0-9]{1,2})?)?)*$";
+export declare const SCALE_ORDINAL_KEY_PATTERN = "^(0|[1-9][0-9]?)$";
+export declare const SCALE_JSON_SCHEMA: {
+    readonly description: "Alpha: stateful replicas may still change and have limits; keep backups of the data they hold. Replica intent: stateless (identical replicas) or stateful (ordered replicas 0..N-1, each with its own volumes, private name and address). Where stateful replicas are not enabled for the workspace, a deploy that declares it is refused. Keys declared here are managed by this file: other surfaces change them only with an explicit override.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly mode: {
+            readonly enum: readonly ["stateless", "stateful"];
+        };
+        readonly replicas: {
+            readonly maximum?: number | undefined;
+            readonly type: "integer";
+            readonly minimum: number;
+        };
+        readonly podManagement: {
+            readonly enum: readonly ["ordered", "parallel"];
+        };
+        readonly update: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly order: {
+                    readonly enum: readonly ["reverse", "forward"];
+                };
+                readonly partition: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly maxUnavailable: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly minReadySeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly progressDeadlineSeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+            };
+        };
+        readonly placement: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly spread: {
+                    readonly enum: readonly ["host", "location"];
+                };
+                readonly allowSameHost: {
+                    readonly type: "boolean";
+                };
+            };
+        };
+        readonly hostLoss: {
+            readonly enum: readonly ["wait", "rebuild"];
+        };
+        readonly hostLossGraceSeconds: {
+            readonly maximum?: number | undefined;
+            readonly type: "integer";
+            readonly minimum: number;
+        };
+        readonly retention: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly whenScaledDown: {
+                    readonly enum: readonly ["retain", "delete"];
+                };
+                readonly whenDeleted: {
+                    readonly enum: readonly ["retain", "delete"];
+                };
+                readonly retentionDays: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+            };
+        };
+        readonly endpoints: {
+            readonly type: "object";
+            readonly maxProperties: 8;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                readonly not: {
+                    readonly const: "default";
+                };
+            };
+            readonly additionalProperties: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["role"];
+                }, {
+                    readonly required: readonly ["ordinals"];
+                }];
+                readonly if: {
+                    readonly required: readonly ["max"];
+                };
+                readonly then: {
+                    readonly not: {
+                        readonly required: readonly ["fallback"];
+                    };
+                };
+                readonly properties: {
+                    readonly role: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                    };
+                    readonly ordinals: {
+                        readonly type: "string";
+                        readonly pattern: "^[0-9]{1,2}(-([0-9]{1,2})?)?(,[0-9]{1,2}(-([0-9]{1,2})?)?)*$";
+                    };
+                    readonly max: {
+                        readonly const: 1;
+                    };
+                    readonly fallback: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                    };
+                };
+            };
+        };
+        readonly public: {
+            readonly type: "string";
+            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+        };
+        readonly backup: {
+            readonly oneOf: readonly [{
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["from"];
+                readonly properties: {
+                    readonly from: {
+                        readonly enum: readonly ["all", "none"];
+                    };
+                };
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["ordinals"];
+                readonly properties: {
+                    readonly ordinals: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 8;
+                        readonly items: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                    };
+                };
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["role"];
+                readonly properties: {
+                    readonly role: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                    };
+                    readonly fallback: {
+                        readonly type: "boolean";
+                    };
+                };
+            }];
+        };
+        readonly failover: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["enabled"];
+            readonly properties: {
+                readonly enabled: {
+                    readonly type: "boolean";
+                };
+                readonly leaderRole: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                };
+                readonly replicaRole: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                };
+                readonly leaseTtlSeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly detectAfterSeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly rank: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["command"];
+                    readonly properties: {
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3600;
+                        };
+                    };
+                };
+                readonly maxRankLag: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly promote: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["command"];
+                    readonly properties: {
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3600;
+                        };
+                    };
+                };
+                readonly rejoin: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["command"];
+                    readonly properties: {
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3600;
+                        };
+                    };
+                };
+                readonly isolation: {
+                    readonly enum: readonly ["failsafe", "fence"];
+                };
+                readonly switchoverOnUpdate: {
+                    readonly type: "boolean";
+                };
+            };
+            readonly if: {
+                readonly properties: {
+                    readonly enabled: {
+                        readonly const: true;
+                    };
+                };
+            };
+            readonly then: {
+                readonly required: readonly ["leaderRole", "rank", "promote"];
+            };
+        };
+        readonly ordinals: {
+            readonly type: "object";
+            readonly propertyNames: {
+                readonly pattern: "^(0|[1-9][0-9]?)$";
+            };
+            readonly additionalProperties: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly resources: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly cpuVCpus: {
+                                readonly type: "number";
+                                readonly minimum: 0.05;
+                                readonly maximum: 16;
+                            };
+                            readonly memoryMb: {
+                                readonly maximum?: number | undefined;
+                                readonly type: "integer";
+                                readonly minimum: number;
+                            };
+                        };
+                    };
+                    readonly env: {
+                        readonly type: "object";
+                        readonly maxProperties: 64;
+                        readonly propertyNames: {
+                            readonly pattern: "^[A-Za-z_][A-Za-z0-9_]*$";
+                            readonly maxLength: 256;
+                        };
+                        readonly additionalProperties: {
+                            readonly type: "string";
+                            readonly maxLength: 32768;
+                        };
+                    };
+                    readonly hostLoss: {
+                        readonly enum: readonly ["wait", "rebuild"];
+                    };
+                };
+            };
+        };
+    };
+    readonly if: {
+        readonly not: {
+            readonly required: readonly ["mode"];
+            readonly properties: {
+                readonly mode: {
+                    readonly const: "stateful";
+                };
+            };
+        };
+    };
+    readonly then: {
+        readonly propertyNames: {
+            readonly enum: readonly ["mode", "replicas"];
+        };
+    };
+};
+/**
+ * The application settings inquir.yaml `services.web` declares with the apps
+ * API's own shapes (docs/roadmap/INQUIR_COMPOSE.md §3.6.2). The platform's
+ * validators are src/apps/app-settings-schema.ts; these bounds are their twin,
+ * kept equal by src/services/inquir-yaml-schema-parity.test.ts.
+ */
+export declare const APP_SCALING_MAX_REPLICAS = 8;
+export declare const APP_SCALING_MAX_DELAY_SECONDS: number;
+export declare const APP_AUTOSCALING_MAX_STABILIZATION_SECONDS = 3600;
+export declare const APP_AUTOSCALING_CPU_PERCENT_RANGE: readonly [10, 100];
+export declare const APP_AUTOSCALING_MAX_CONCURRENCY = 10000;
+export declare const APP_ROLLOUT_MAX_FIGURE = 8;
+export declare const APP_ROLLOUT_PROGRESS_DEADLINE_RANGE: readonly [30, 3600];
+/** A registry image pinned by digest: the only kind a worker runner pulls. */
+export declare const PINNED_IMAGE_REF_PATTERN = "^[A-Za-z0-9][A-Za-z0-9._:/-]*@sha256:[a-f0-9]{64}$";
 /**
  * JSON Schema (draft-07) of inquir.yaml, for editor completion and
  * validation (`# yaml-language-server: $schema=…`). The repository keeps it
@@ -303,7 +676,12 @@ export declare const INQUIR_YAML_JSON_SCHEMA: {
         };
         readonly services: {
             readonly type: "object";
-            readonly description: "Application services (apps): services.web.build, runtime, env";
+            readonly description: "Application services (apps): services.web.build or imageRef, runtime, env, scale, networkPolicy, scaling, location";
+            readonly properties: {
+                readonly web: {
+                    readonly $ref: "#/definitions/service";
+                };
+            };
         };
         readonly build: {
             readonly $ref: "#/definitions/build";
@@ -324,6 +702,1779 @@ export declare const INQUIR_YAML_JSON_SCHEMA: {
         };
     };
     readonly definitions: {
+        readonly service: {
+            readonly description: "One service: services.web of inquir.yaml, and an inline service of inquir-compose.yaml (the same block).";
+            readonly type: "object";
+            readonly properties: {
+                readonly build: {
+                    readonly type: "object";
+                    readonly description: "The Dockerfile build: context (a folder inside the source), dockerfile (relative to the context), target, args";
+                    readonly properties: {
+                        readonly context: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1024;
+                        };
+                        readonly dockerfile: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1024;
+                        };
+                        readonly target: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 128;
+                        };
+                        readonly args: {
+                            readonly type: "object";
+                            readonly maxProperties: 32;
+                            readonly additionalProperties: {
+                                readonly type: "string";
+                                readonly maxLength: 4096;
+                            };
+                        };
+                    };
+                };
+                readonly env: {
+                    readonly type: "object";
+                    readonly description: "Non-secret defaults, frozen with the build; application variables win. Never secrets: inquir.yaml is committed.";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly maxLength: 32768;
+                    };
+                };
+                readonly runtime: {
+                    readonly type: "object";
+                    readonly description: "The pod template, frozen with each release (port, ports, volumes, healthcheck, hooks, roles, ...)";
+                    readonly properties: {
+                        readonly roles: {
+                            readonly $ref: "#/definitions/roles";
+                        };
+                        readonly hooks: {
+                            readonly $ref: "#/definitions/hooks";
+                        };
+                    };
+                };
+                readonly scale: {
+                    readonly $ref: "#/definitions/scale";
+                };
+                readonly imageRef: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:/-]*@sha256:[a-f0-9]{64}$";
+                    readonly description: string;
+                };
+                readonly networkPolicy: {
+                    readonly $ref: "#/definitions/networkPolicy";
+                };
+                readonly scaling: {
+                    readonly $ref: "#/definitions/scaling";
+                };
+                readonly location: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 32;
+                    readonly description: string;
+                };
+            };
+            readonly not: {
+                readonly required: readonly ["imageRef", "build"];
+            };
+        };
+        readonly scale: {
+            readonly description: "Alpha: stateful replicas may still change and have limits; keep backups of the data they hold. Replica intent: stateless (identical replicas) or stateful (ordered replicas 0..N-1, each with its own volumes, private name and address). Where stateful replicas are not enabled for the workspace, a deploy that declares it is refused. Keys declared here are managed by this file: other surfaces change them only with an explicit override.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly mode: {
+                    readonly enum: readonly ["stateless", "stateful"];
+                };
+                readonly replicas: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly podManagement: {
+                    readonly enum: readonly ["ordered", "parallel"];
+                };
+                readonly update: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly order: {
+                            readonly enum: readonly ["reverse", "forward"];
+                        };
+                        readonly partition: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly maxUnavailable: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly minReadySeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly progressDeadlineSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                    };
+                };
+                readonly placement: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly spread: {
+                            readonly enum: readonly ["host", "location"];
+                        };
+                        readonly allowSameHost: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+                readonly hostLoss: {
+                    readonly enum: readonly ["wait", "rebuild"];
+                };
+                readonly hostLossGraceSeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly retention: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly whenScaledDown: {
+                            readonly enum: readonly ["retain", "delete"];
+                        };
+                        readonly whenDeleted: {
+                            readonly enum: readonly ["retain", "delete"];
+                        };
+                        readonly retentionDays: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                    };
+                };
+                readonly endpoints: {
+                    readonly type: "object";
+                    readonly maxProperties: 8;
+                    readonly propertyNames: {
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        readonly not: {
+                            readonly const: "default";
+                        };
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly oneOf: readonly [{
+                            readonly required: readonly ["role"];
+                        }, {
+                            readonly required: readonly ["ordinals"];
+                        }];
+                        readonly if: {
+                            readonly required: readonly ["max"];
+                        };
+                        readonly then: {
+                            readonly not: {
+                                readonly required: readonly ["fallback"];
+                            };
+                        };
+                        readonly properties: {
+                            readonly role: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                            readonly ordinals: {
+                                readonly type: "string";
+                                readonly pattern: "^[0-9]{1,2}(-([0-9]{1,2})?)?(,[0-9]{1,2}(-([0-9]{1,2})?)?)*$";
+                            };
+                            readonly max: {
+                                readonly const: 1;
+                            };
+                            readonly fallback: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                        };
+                    };
+                };
+                readonly public: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                };
+                readonly backup: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["from"];
+                        readonly properties: {
+                            readonly from: {
+                                readonly enum: readonly ["all", "none"];
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["ordinals"];
+                        readonly properties: {
+                            readonly ordinals: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly maxItems: 8;
+                                readonly items: {
+                                    readonly maximum?: number | undefined;
+                                    readonly type: "integer";
+                                    readonly minimum: number;
+                                };
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["role"];
+                        readonly properties: {
+                            readonly role: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                            readonly fallback: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    }];
+                };
+                readonly failover: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["enabled"];
+                    readonly properties: {
+                        readonly enabled: {
+                            readonly type: "boolean";
+                        };
+                        readonly leaderRole: {
+                            readonly type: "string";
+                            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        };
+                        readonly replicaRole: {
+                            readonly type: "string";
+                            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        };
+                        readonly leaseTtlSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly detectAfterSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly rank: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly maxRankLag: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly promote: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly rejoin: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly isolation: {
+                            readonly enum: readonly ["failsafe", "fence"];
+                        };
+                        readonly switchoverOnUpdate: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly if: {
+                        readonly properties: {
+                            readonly enabled: {
+                                readonly const: true;
+                            };
+                        };
+                    };
+                    readonly then: {
+                        readonly required: readonly ["leaderRole", "rank", "promote"];
+                    };
+                };
+                readonly ordinals: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly pattern: "^(0|[1-9][0-9]?)$";
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly resources: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly properties: {
+                                    readonly cpuVCpus: {
+                                        readonly type: "number";
+                                        readonly minimum: 0.05;
+                                        readonly maximum: 16;
+                                    };
+                                    readonly memoryMb: {
+                                        readonly maximum?: number | undefined;
+                                        readonly type: "integer";
+                                        readonly minimum: number;
+                                    };
+                                };
+                            };
+                            readonly env: {
+                                readonly type: "object";
+                                readonly maxProperties: 64;
+                                readonly propertyNames: {
+                                    readonly pattern: "^[A-Za-z_][A-Za-z0-9_]*$";
+                                    readonly maxLength: 256;
+                                };
+                                readonly additionalProperties: {
+                                    readonly type: "string";
+                                    readonly maxLength: 32768;
+                                };
+                            };
+                            readonly hostLoss: {
+                                readonly enum: readonly ["wait", "rebuild"];
+                            };
+                        };
+                    };
+                };
+            };
+            readonly if: {
+                readonly not: {
+                    readonly required: readonly ["mode"];
+                    readonly properties: {
+                        readonly mode: {
+                            readonly const: "stateful";
+                        };
+                    };
+                };
+            };
+            readonly then: {
+                readonly propertyNames: {
+                    readonly enum: readonly ["mode", "replicas"];
+                };
+            };
+        };
+        readonly networkPolicy: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly ingress: {
+                    readonly enum: readonly ["private", "public"];
+                };
+                readonly egress: {
+                    readonly enum: readonly ["none", "full"];
+                };
+                readonly allow: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 253;
+                    };
+                };
+            };
+        };
+        readonly scaling: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly activation: {
+                    readonly enum: readonly ["always", "http", "manual"];
+                };
+                readonly minReplicas: {
+                    readonly enum: readonly [0, 1];
+                };
+                readonly maxReplicas: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 8;
+                };
+                readonly idleTimeoutSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 300;
+                    readonly maximum: number;
+                };
+                readonly activationTimeoutSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 5;
+                    readonly maximum: 300;
+                };
+                readonly scaleDownStabilizationSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: number;
+                };
+                readonly autoscaling: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly minReplicas: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 8;
+                        };
+                        readonly cpuUtilizationPercent: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly concurrencyPerReplica: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly scaleUpStabilizationSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly maximum: 3600;
+                        };
+                        readonly scaleDownStabilizationSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly maximum: 3600;
+                        };
+                    };
+                };
+                readonly rollout: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly maxSurge: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly maxUnavailable: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly progressDeadlineSeconds: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                    };
+                };
+            };
+        };
+        readonly roles: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly probe: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly oneOf: readonly [{
+                        readonly required: readonly ["http"];
+                    }, {
+                        readonly required: readonly ["command"];
+                    }];
+                    readonly properties: {
+                        readonly http: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["path"];
+                            readonly properties: {
+                                readonly path: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 512;
+                                    readonly pattern: "^/";
+                                };
+                                readonly port: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 32;
+                                    readonly description: "A runtime.ports name; the primary port by default";
+                                };
+                            };
+                        };
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly intervalSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 60;
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 30;
+                        };
+                        readonly successThreshold: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 10;
+                        };
+                    };
+                };
+                readonly byOrdinal: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly pattern: "^(0|[1-9][0-9]?)$";
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        readonly not: {
+                            readonly const: "unknown";
+                        };
+                    };
+                };
+                readonly default: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                    readonly not: {
+                        readonly const: "unknown";
+                    };
+                };
+            };
+            readonly oneOf: readonly [{
+                readonly required: readonly ["probe"];
+                readonly not: {
+                    readonly anyOf: readonly [{
+                        readonly required: readonly ["byOrdinal"];
+                    }, {
+                        readonly required: readonly ["default"];
+                    }];
+                };
+            }, {
+                readonly not: {
+                    readonly required: readonly ["probe"];
+                };
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["byOrdinal"];
+                }, {
+                    readonly required: readonly ["default"];
+                }];
+            }];
+        };
+        readonly hooks: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly init: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["command"];
+                    readonly properties: {
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly when: {
+                            readonly enum: readonly ["always", "emptyVolume"];
+                            readonly description: "always (default), or emptyVolume";
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3600;
+                            readonly description: "Default 600; the start fails past it";
+                        };
+                    };
+                };
+            };
+        };
+        readonly build: {
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly system: {
+                    readonly $ref: "#/definitions/system";
+                };
+                readonly dependencies: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 200;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                    };
+                    readonly description: "Language packages, the same list for every runtime: node name@version (npm), python a pip requirement such as name==version, go module@version. Merged into package.json / requirements.txt / go.mod for the build; the same package declared there with another version is an error. Where the platform does not enable it yet, a deploy ignores it with a warning.";
+                };
+            };
+        };
+        readonly system: {
+            readonly description: "OS packages installed into the function image (Debian bookworm; Node.js and Python today, Go coming soon). Removing the block removes them on the next deploy.";
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly presets: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 8;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly anyOf: readonly [{
+                            readonly enum: readonly ["ffmpeg", "fonts", "ghostscript", "imagemagick", "libvips", "poppler", "tesseract"];
+                            readonly description: "A platform preset (Debian bookworm packages plus env)";
+                        }, {
+                            readonly type: "object";
+                            readonly required: readonly ["name"];
+                            readonly additionalProperties: false;
+                            readonly description: "A preset with options (tesseract only)";
+                            readonly properties: {
+                                readonly name: {
+                                    readonly enum: readonly ["tesseract"];
+                                };
+                                readonly langs: {
+                                    readonly type: readonly ["array", "null"];
+                                    readonly maxItems: 8;
+                                    readonly uniqueItems: true;
+                                    readonly items: {
+                                        readonly enum: readonly ["ara", "bul", "ces", "chi-sim", "chi-tra", "dan", "deu", "ell", "eng", "est", "fin", "fra", "heb", "hin", "hrv", "hun", "ind", "ita", "jpn", "kat", "kaz", "kor", "lav", "lit", "nld", "nor", "pol", "por", "ron", "rus", "slk", "slv", "spa", "srp", "swe", "tha", "tur", "ukr", "vie"];
+                                    };
+                                    readonly description: "Extra OCR languages";
+                                };
+                            };
+                        }];
+                    };
+                };
+                readonly packages: {
+                    readonly type: readonly ["array", "null"];
+                    readonly maxItems: 10;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^(?!.*\\.\\.)[a-z0-9](?:[a-z0-9+.-]{0,61}[a-z0-9])?(=[A-Za-z0-9.+~:_-]{1,64})?$";
+                        readonly not: {
+                            readonly pattern: "^(systemd.*|init|sudo|sudo-ldap|doas|openssh-server|docker.*|containerd.*|podman.*|runc|crun|linux-image-.*|linux-headers-.*|.*-dkms|apt-transport-.*|apt|dpkg|cron|anacron|rsyslog|udev|dbus)(=.*)?$";
+                        };
+                        readonly description: "Debian package, optionally name=version (daemons, privilege tools, kernels and package tooling are refused)";
+                    };
+                };
+            };
+        };
+    };
+};
+/** The keys of one service block (inquir.yaml services.web; the platform's INQUIR_SERVICE_KEYS). */
+export declare const INQUIR_SERVICE_KEYS: readonly ["build", "imageRef", "runtime", "env", "scale", "networkPolicy", "scaling", "location"];
+/** The stack keys an inquir-compose service entry adds (the platform's STACK_KEYS). */
+export declare const COMPOSE_STACK_KEYS: readonly ["path", "title", "dependsOn", "variables", "buildArgs"];
+/**
+ * JSON Schema (draft-07) of inquir-compose.yaml, for editors
+ * (docs/roadmap/INQUIR_COMPOSE.md §3). An inline service is inquir.yaml's
+ * definitions.service plus the stack keys; references ({{...}}) and the
+ * cross-field rules are the platform validator's (POST /v1/compose/validate).
+ */
+export declare const INQUIR_COMPOSE_YAML_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://inquir.org/schemas/inquir-compose.yaml.json";
+    readonly title: "inquir-compose.yaml";
+    readonly description: "A stack of Inquir services: each a folder with its own inquir.yaml (path) or an inline inquir.yaml services.web block.";
+    readonly type: "object";
+    readonly required: readonly ["version", "services"];
+    readonly additionalProperties: false;
+    readonly patternProperties: {
+        readonly '^x-': {
+            readonly description: "Ignored by the platform: a place for YAML anchors";
+        };
+    };
+    readonly properties: {
+        readonly version: {
+            readonly const: 1;
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["title"];
+            readonly properties: {
+                readonly title: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 8192;
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["en", "ru"];
+                        readonly properties: {
+                            readonly en: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 8192;
+                            };
+                            readonly ru: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 8192;
+                            };
+                        };
+                    }];
+                };
+                readonly description: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 8192;
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["en", "ru"];
+                        readonly properties: {
+                            readonly en: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 8192;
+                            };
+                            readonly ru: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 8192;
+                            };
+                        };
+                    }];
+                };
+                readonly icon: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,31}$";
+                };
+                readonly category: {
+                    readonly enum: readonly ["database", "cache", "web", "agent", "bot", "other"];
+                };
+                readonly docsUrl: {
+                    readonly type: "string";
+                    readonly pattern: "^https://";
+                    readonly maxLength: 2048;
+                };
+                readonly notes: {
+                    readonly type: "array";
+                    readonly maxItems: 30;
+                    readonly items: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 8192;
+                        }, {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["en", "ru"];
+                            readonly properties: {
+                                readonly en: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                                readonly ru: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                            };
+                        }];
+                    };
+                };
+                readonly minPlan: {
+                    readonly enum: readonly ["free", "simple", "pro", "enterprise"];
+                    readonly description: "A display hint; the deploy judges the real plan";
+                };
+            };
+        };
+        readonly inputs: {
+            readonly type: "object";
+            readonly maxProperties: 64;
+            readonly description: "Values asked at deploy time";
+            readonly propertyNames: {
+                readonly pattern: "^[A-Za-z_][A-Za-z0-9_]*$";
+            };
+            readonly additionalProperties: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["label"];
+                readonly properties: {
+                    readonly label: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 8192;
+                        }, {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["en", "ru"];
+                            readonly properties: {
+                                readonly en: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                                readonly ru: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                            };
+                        }];
+                    };
+                    readonly hint: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 8192;
+                        }, {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["en", "ru"];
+                            readonly properties: {
+                                readonly en: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                                readonly ru: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 8192;
+                                };
+                            };
+                        }];
+                    };
+                    readonly secret: {
+                        readonly type: "boolean";
+                        readonly description: "Typed at deploy time, stored encrypted, never echoed; no default";
+                    };
+                    readonly required: {
+                        readonly type: "boolean";
+                    };
+                    readonly default: {
+                        readonly type: "string";
+                        readonly maxLength: 4096;
+                    };
+                    readonly minLength: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 4096;
+                    };
+                    readonly maxLength: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 4096;
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 32;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 256;
+                        };
+                    };
+                    readonly pattern: {
+                        readonly enum: readonly ["username", "hostname", "email", "https-url", "integer", "csv-integers"];
+                    };
+                };
+                readonly if: {
+                    readonly required: readonly ["secret"];
+                    readonly properties: {
+                        readonly secret: {
+                            readonly const: true;
+                        };
+                    };
+                };
+                readonly then: {
+                    readonly not: {
+                        readonly required: readonly ["default"];
+                    };
+                };
+            };
+        };
+        readonly generate: {
+            readonly type: "object";
+            readonly maxProperties: 32;
+            readonly description: "Credentials the platform generates once per stack: {{generated.<key>}}";
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]{0,63}$";
+            };
+            readonly additionalProperties: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["bytes", "encoding"];
+                readonly properties: {
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 16;
+                        readonly maximum: 64;
+                    };
+                    readonly encoding: {
+                        readonly enum: readonly ["hex", "base64", "base64url"];
+                    };
+                };
+            };
+        };
+        readonly project: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly placement: {
+                    readonly enum: readonly ["new", "existing"];
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                };
+            };
+        };
+        readonly defaults: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Merged under every inline service: location, networkPolicy, scaling and runtime.resources only";
+            readonly properties: {
+                readonly location: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 32;
+                };
+                readonly networkPolicy: {
+                    readonly $ref: "#/definitions/networkPolicy";
+                };
+                readonly scaling: {
+                    readonly $ref: "#/definitions/scaling";
+                };
+                readonly runtime: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly resources: {
+                            readonly type: "object";
+                        };
+                    };
+                };
+            };
+        };
+        readonly services: {
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly maxProperties: 32;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+            };
+            readonly additionalProperties: {
+                readonly allOf: readonly [{
+                    readonly $ref: "#/definitions/service";
+                }];
+                readonly type: "object";
+                readonly propertyNames: {
+                    readonly enum: readonly ["build", "imageRef", "runtime", "env", "scale", "networkPolicy", "scaling", "location", "path", "title", "dependsOn", "variables", "buildArgs"];
+                };
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "A folder with its own inquir.yaml (then only stack keys sit next to it)";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 80;
+                    };
+                    readonly dependsOn: {
+                        readonly type: "array";
+                        readonly maxItems: 32;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        };
+                    };
+                    readonly variables: {
+                        readonly type: "object";
+                        readonly maxProperties: 128;
+                        readonly description: "The application variables; references {{inputs.X}}, {{generated.x}}, {{services.s.privateHost}}, ... resolve here";
+                        readonly propertyNames: {
+                            readonly pattern: "^[A-Za-z_][A-Za-z0-9_]*$";
+                        };
+                        readonly additionalProperties: {
+                            readonly type: "string";
+                            readonly maxLength: 32768;
+                        };
+                    };
+                    readonly buildArgs: {
+                        readonly type: "object";
+                        readonly maxProperties: 32;
+                        readonly description: "Build arguments for this deploy: no secrets";
+                        readonly additionalProperties: {
+                            readonly type: "string";
+                            readonly maxLength: 4096;
+                        };
+                    };
+                };
+            };
+        };
+        readonly entrypoint: {
+            readonly type: "string";
+            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+            readonly description: "The public service opened after deploy";
+        };
+        readonly files: {
+            readonly type: "object";
+            readonly description: "Bundle form: the embedded build tree, path -> content";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly definitions: {
+        readonly service: {
+            readonly description: "One service: services.web of inquir.yaml, and an inline service of inquir-compose.yaml (the same block).";
+            readonly type: "object";
+            readonly properties: {
+                readonly build: {
+                    readonly type: "object";
+                    readonly description: "The Dockerfile build: context (a folder inside the source), dockerfile (relative to the context), target, args";
+                    readonly properties: {
+                        readonly context: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1024;
+                        };
+                        readonly dockerfile: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1024;
+                        };
+                        readonly target: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 128;
+                        };
+                        readonly args: {
+                            readonly type: "object";
+                            readonly maxProperties: 32;
+                            readonly additionalProperties: {
+                                readonly type: "string";
+                                readonly maxLength: 4096;
+                            };
+                        };
+                    };
+                };
+                readonly env: {
+                    readonly type: "object";
+                    readonly description: "Non-secret defaults, frozen with the build; application variables win. Never secrets: inquir.yaml is committed.";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly maxLength: 32768;
+                    };
+                };
+                readonly runtime: {
+                    readonly type: "object";
+                    readonly description: "The pod template, frozen with each release (port, ports, volumes, healthcheck, hooks, roles, ...)";
+                    readonly properties: {
+                        readonly roles: {
+                            readonly $ref: "#/definitions/roles";
+                        };
+                        readonly hooks: {
+                            readonly $ref: "#/definitions/hooks";
+                        };
+                    };
+                };
+                readonly scale: {
+                    readonly $ref: "#/definitions/scale";
+                };
+                readonly imageRef: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:/-]*@sha256:[a-f0-9]{64}$";
+                    readonly description: string;
+                };
+                readonly networkPolicy: {
+                    readonly $ref: "#/definitions/networkPolicy";
+                };
+                readonly scaling: {
+                    readonly $ref: "#/definitions/scaling";
+                };
+                readonly location: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 32;
+                    readonly description: string;
+                };
+            };
+            readonly not: {
+                readonly required: readonly ["imageRef", "build"];
+            };
+        };
+        readonly scale: {
+            readonly description: "Alpha: stateful replicas may still change and have limits; keep backups of the data they hold. Replica intent: stateless (identical replicas) or stateful (ordered replicas 0..N-1, each with its own volumes, private name and address). Where stateful replicas are not enabled for the workspace, a deploy that declares it is refused. Keys declared here are managed by this file: other surfaces change them only with an explicit override.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly mode: {
+                    readonly enum: readonly ["stateless", "stateful"];
+                };
+                readonly replicas: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly podManagement: {
+                    readonly enum: readonly ["ordered", "parallel"];
+                };
+                readonly update: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly order: {
+                            readonly enum: readonly ["reverse", "forward"];
+                        };
+                        readonly partition: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly maxUnavailable: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly minReadySeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly progressDeadlineSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                    };
+                };
+                readonly placement: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly spread: {
+                            readonly enum: readonly ["host", "location"];
+                        };
+                        readonly allowSameHost: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+                readonly hostLoss: {
+                    readonly enum: readonly ["wait", "rebuild"];
+                };
+                readonly hostLossGraceSeconds: {
+                    readonly maximum?: number | undefined;
+                    readonly type: "integer";
+                    readonly minimum: number;
+                };
+                readonly retention: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly whenScaledDown: {
+                            readonly enum: readonly ["retain", "delete"];
+                        };
+                        readonly whenDeleted: {
+                            readonly enum: readonly ["retain", "delete"];
+                        };
+                        readonly retentionDays: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                    };
+                };
+                readonly endpoints: {
+                    readonly type: "object";
+                    readonly maxProperties: 8;
+                    readonly propertyNames: {
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        readonly not: {
+                            readonly const: "default";
+                        };
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly oneOf: readonly [{
+                            readonly required: readonly ["role"];
+                        }, {
+                            readonly required: readonly ["ordinals"];
+                        }];
+                        readonly if: {
+                            readonly required: readonly ["max"];
+                        };
+                        readonly then: {
+                            readonly not: {
+                                readonly required: readonly ["fallback"];
+                            };
+                        };
+                        readonly properties: {
+                            readonly role: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                            readonly ordinals: {
+                                readonly type: "string";
+                                readonly pattern: "^[0-9]{1,2}(-([0-9]{1,2})?)?(,[0-9]{1,2}(-([0-9]{1,2})?)?)*$";
+                            };
+                            readonly max: {
+                                readonly const: 1;
+                            };
+                            readonly fallback: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                        };
+                    };
+                };
+                readonly public: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                };
+                readonly backup: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["from"];
+                        readonly properties: {
+                            readonly from: {
+                                readonly enum: readonly ["all", "none"];
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["ordinals"];
+                        readonly properties: {
+                            readonly ordinals: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly maxItems: 8;
+                                readonly items: {
+                                    readonly maximum?: number | undefined;
+                                    readonly type: "integer";
+                                    readonly minimum: number;
+                                };
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["role"];
+                        readonly properties: {
+                            readonly role: {
+                                readonly type: "string";
+                                readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                            };
+                            readonly fallback: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    }];
+                };
+                readonly failover: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["enabled"];
+                    readonly properties: {
+                        readonly enabled: {
+                            readonly type: "boolean";
+                        };
+                        readonly leaderRole: {
+                            readonly type: "string";
+                            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        };
+                        readonly replicaRole: {
+                            readonly type: "string";
+                            readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        };
+                        readonly leaseTtlSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly detectAfterSeconds: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly rank: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly maxRankLag: {
+                            readonly maximum?: number | undefined;
+                            readonly type: "integer";
+                            readonly minimum: number;
+                        };
+                        readonly promote: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly rejoin: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["command"];
+                            readonly properties: {
+                                readonly command: {
+                                    readonly type: "array";
+                                    readonly minItems: 1;
+                                    readonly maxItems: 32;
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                        readonly maxLength: 2048;
+                                    };
+                                };
+                                readonly timeoutSeconds: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly maximum: 3600;
+                                };
+                            };
+                        };
+                        readonly isolation: {
+                            readonly enum: readonly ["failsafe", "fence"];
+                        };
+                        readonly switchoverOnUpdate: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly if: {
+                        readonly properties: {
+                            readonly enabled: {
+                                readonly const: true;
+                            };
+                        };
+                    };
+                    readonly then: {
+                        readonly required: readonly ["leaderRole", "rank", "promote"];
+                    };
+                };
+                readonly ordinals: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly pattern: "^(0|[1-9][0-9]?)$";
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly resources: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly properties: {
+                                    readonly cpuVCpus: {
+                                        readonly type: "number";
+                                        readonly minimum: 0.05;
+                                        readonly maximum: 16;
+                                    };
+                                    readonly memoryMb: {
+                                        readonly maximum?: number | undefined;
+                                        readonly type: "integer";
+                                        readonly minimum: number;
+                                    };
+                                };
+                            };
+                            readonly env: {
+                                readonly type: "object";
+                                readonly maxProperties: 64;
+                                readonly propertyNames: {
+                                    readonly pattern: "^[A-Za-z_][A-Za-z0-9_]*$";
+                                    readonly maxLength: 256;
+                                };
+                                readonly additionalProperties: {
+                                    readonly type: "string";
+                                    readonly maxLength: 32768;
+                                };
+                            };
+                            readonly hostLoss: {
+                                readonly enum: readonly ["wait", "rebuild"];
+                            };
+                        };
+                    };
+                };
+            };
+            readonly if: {
+                readonly not: {
+                    readonly required: readonly ["mode"];
+                    readonly properties: {
+                        readonly mode: {
+                            readonly const: "stateful";
+                        };
+                    };
+                };
+            };
+            readonly then: {
+                readonly propertyNames: {
+                    readonly enum: readonly ["mode", "replicas"];
+                };
+            };
+        };
+        readonly networkPolicy: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly ingress: {
+                    readonly enum: readonly ["private", "public"];
+                };
+                readonly egress: {
+                    readonly enum: readonly ["none", "full"];
+                };
+                readonly allow: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 253;
+                    };
+                };
+            };
+        };
+        readonly scaling: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly activation: {
+                    readonly enum: readonly ["always", "http", "manual"];
+                };
+                readonly minReplicas: {
+                    readonly enum: readonly [0, 1];
+                };
+                readonly maxReplicas: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 8;
+                };
+                readonly idleTimeoutSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 300;
+                    readonly maximum: number;
+                };
+                readonly activationTimeoutSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 5;
+                    readonly maximum: 300;
+                };
+                readonly scaleDownStabilizationSeconds: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: number;
+                };
+                readonly autoscaling: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly minReplicas: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 8;
+                        };
+                        readonly cpuUtilizationPercent: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly concurrencyPerReplica: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly scaleUpStabilizationSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly maximum: 3600;
+                        };
+                        readonly scaleDownStabilizationSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly maximum: 3600;
+                        };
+                    };
+                };
+                readonly rollout: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly maxSurge: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly maxUnavailable: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                        readonly progressDeadlineSeconds: {
+                            readonly type: readonly ["integer", "null"];
+                            readonly minimum: number;
+                            readonly maximum: number;
+                        };
+                    };
+                };
+            };
+        };
+        readonly roles: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly probe: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly oneOf: readonly [{
+                        readonly required: readonly ["http"];
+                    }, {
+                        readonly required: readonly ["command"];
+                    }];
+                    readonly properties: {
+                        readonly http: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["path"];
+                            readonly properties: {
+                                readonly path: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 512;
+                                    readonly pattern: "^/";
+                                };
+                                readonly port: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 32;
+                                    readonly description: "A runtime.ports name; the primary port by default";
+                                };
+                            };
+                        };
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly intervalSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 60;
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 30;
+                        };
+                        readonly successThreshold: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 10;
+                        };
+                    };
+                };
+                readonly byOrdinal: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly pattern: "^(0|[1-9][0-9]?)$";
+                    };
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                        readonly not: {
+                            readonly const: "unknown";
+                        };
+                    };
+                };
+                readonly default: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9-]{0,30}$";
+                    readonly not: {
+                        readonly const: "unknown";
+                    };
+                };
+            };
+            readonly oneOf: readonly [{
+                readonly required: readonly ["probe"];
+                readonly not: {
+                    readonly anyOf: readonly [{
+                        readonly required: readonly ["byOrdinal"];
+                    }, {
+                        readonly required: readonly ["default"];
+                    }];
+                };
+            }, {
+                readonly not: {
+                    readonly required: readonly ["probe"];
+                };
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["byOrdinal"];
+                }, {
+                    readonly required: readonly ["default"];
+                }];
+            }];
+        };
+        readonly hooks: {
+            readonly description: string;
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly init: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["command"];
+                    readonly properties: {
+                        readonly command: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly maxItems: 32;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2048;
+                            };
+                        };
+                        readonly when: {
+                            readonly enum: readonly ["always", "emptyVolume"];
+                            readonly description: "always (default), or emptyVolume";
+                        };
+                        readonly timeoutSeconds: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3600;
+                            readonly description: "Default 600; the start fails past it";
+                        };
+                    };
+                };
+            };
+        };
         readonly build: {
             readonly type: readonly ["object", "null"];
             readonly additionalProperties: false;