@vendure/cloud 0.3.1 → 0.4.0

package/dist/cli/lib/contract/deployments.d.ts

@@ -58,6 +58,18 @@ export interface TeardownStatusDetails {
 export interface DeploymentIdPrefixMatchesResponse {
     matches: string[];
 }
+export declare const DEPLOYMENT_FAILURE_STAGES: readonly ["BUILD_PREPARATION", "BUILD", "BUILD_HANDOFF", "DEPLOYMENT_PREPARATION", "INFRASTRUCTURE", "DATABASE_PROVISIONING", "MIGRATION", "RUNTIME_START"];
+export type DeploymentFailureStage = (typeof DEPLOYMENT_FAILURE_STAGES)[number];
+export declare const DEPLOYMENT_RECOVERY_ACTIONS: readonly ["DEPLOY_AGAIN", "FIX_SOURCE_AND_DEPLOY", "FIX_MIGRATION_AND_DEPLOY", "ROLLBACK", "CONTACT_SUPPORT", "INSPECT_ENVIRONMENT"];
+export type DeploymentRecoveryAction = (typeof DEPLOYMENT_RECOVERY_ACTIONS)[number];
+export type DeploymentRecovery = {
+    stage: DeploymentFailureStage | null;
+    stageLabel: string | null;
+    stageUnavailableReason: string | null;
+    nextAction: DeploymentRecoveryAction;
+    summary: string;
+    nextActionMessage: string;
+};
 export declare const ENVIRONMENT_STATUS_RESOURCE_CATEGORIES: readonly ["DATASTORE", "SERVICE"];
 export type EnvironmentStatusResourceCategory = (typeof ENVIRONMENT_STATUS_RESOURCE_CATEGORIES)[number];
 export type EnvironmentStatusResource = {
@@ -70,6 +82,7 @@ export declare const EnvironmentActiveWorkKind: {
     readonly RUNTIME_OPERATION: "RUNTIME_OPERATION";
     readonly SEED_APPLY: "SEED_APPLY";
     readonly DATABASE_RESTORE: "DATABASE_RESTORE";
+    readonly RELOCATION: "RELOCATION";
 };
 export type EnvironmentActiveWorkKind = (typeof EnvironmentActiveWorkKind)[keyof typeof EnvironmentActiveWorkKind];
 export type EnvironmentActiveWork = {

package/dist/cli/lib/contract/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/deployments.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,0BAA0B,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/F,eAAO,MAAM,2BAA2B,sDAAuD,CAAC;AAEhG,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF,eAAO,MAAM,uBAAuB,iDAAkD,CAAC;AAEvF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAeF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC,CAAC;AAIF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAWF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,GAAG,OAAO,CAEV;AAED,eAAO,MAAM,cAAc,yCAA0C,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,iBAAiB,oEAAqE,CAAC;AACpG,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,sCAAsC,mCAAoC,CAAC;AACxF,MAAM,MAAM,iCAAiC,GAC3C,CAAC,OAAO,sCAAsC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iCAAiC,CAAC;CAC7C,CAAC;AAKF,eAAO,MAAM,yBAAyB;;;;;;CAY5B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,yBAAyB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;QACpC,YAAY,EAAE,YAAY,CAAC;QAI3B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;QACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,KAAK,CACb,yBAAyB,GAAG;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;QACzC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CACF,CAAC;IAMF,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IAE3E,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/deployments.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/contract/deployments.js

@@ -26,6 +26,38 @@ export function isPlanPreviewUnavailable(plan) {
 }
 export const TEARDOWN_MODES = ["TEARDOWN", "FORCE_TEARDOWN"];
 export const TEARDOWN_STATUSES = ["QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "TIMED_OUT"];
+// Mirrors the deployment-recovery contract from `@vendure-cloud/api-types`, which carries all of
+// its reasoning. These declarations must stay character-identical to it; `cli-contract-drift.test.ts`
+// enforces that, and deliberately strips comments — so a copy of the reasoning here would be
+// unenforced and would drift.
+export const DEPLOYMENT_FAILURE_STAGES = [
+    "BUILD_PREPARATION",
+    "BUILD",
+    "BUILD_HANDOFF",
+    "DEPLOYMENT_PREPARATION",
+    "INFRASTRUCTURE",
+    "DATABASE_PROVISIONING",
+    "MIGRATION",
+    "RUNTIME_START",
+];
+// The one thing to do next about a failed VC Deployment. One action rather than a list, because a
+// customer reading two suggestions has to choose between them with less information than the
+// platform already has.
+//
+// The action is not a pure function of the stage. A rollback needs an earlier release to roll back
+// to, so a first deploy that fails at its rollout is answered differently from a later one.
+//
+// `INSPECT_ENVIRONMENT` is the answer when the stage is not known, and it is deliberately the
+// weakest. Every other action asserts something about what is running, and asserting that wrongly
+// sends a customer to roll back an environment that never changed.
+export const DEPLOYMENT_RECOVERY_ACTIONS = [
+    "DEPLOY_AGAIN",
+    "FIX_SOURCE_AND_DEPLOY",
+    "FIX_MIGRATION_AND_DEPLOY",
+    "ROLLBACK",
+    "CONTACT_SUPPORT",
+    "INSPECT_ENVIRONMENT",
+];
 export const ENVIRONMENT_STATUS_RESOURCE_CATEGORIES = ["DATASTORE", "SERVICE"];
 // Environment-scoped work that serializes against everything else touching the
 // same VC Environment. Deploys, teardowns and runtime operations all take the
@@ -42,5 +74,11 @@ export const EnvironmentActiveWorkKind = {
     // everything above for the same reason a seed apply does — and with itself, which is the case
     // that made the guard durable rather than a same-request check (CLO-499).
     DATABASE_RESTORE: "DATABASE_RESTORE",
+    // A VC Relocation moves the environment's authoritative placement, so it holds the slot against
+    // everything above — and for days rather than minutes, because preparation, the wait for the
+    // maintenance window, the cutover and the seven-day retirement are one lease (CLO-719, ADR-0031).
+    // A customer told their deploy is queued behind a runtime operation when it is really queued
+    // behind scheduled maintenance has been told the wrong thing about how long to wait.
+    RELOCATION: "RELOCATION",
 };
 //# sourceMappingURL=deployments.js.map

package/dist/cli/lib/contract/deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/deployments.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oGAAoG;AACpG,+DAA+D;AAC/D,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,2CAA2C;AAC3C,EAAE;AACF,2FAA2F;AAC3F,yFAAyF;AACzF,oGAAoG;AACpG,oEAAoE;AAMpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAIhG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AA6CvF,gGAAgG;AAChG,8FAA8F;AAC9F,EAAE;AACF,8FAA8F;AAC9F,gGAAgG;AAChG,mGAAmG;AACnG,oGAAoG;AACpG,kGAAkG;AAClG,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,IAExC;IACC,OAAO,OAAO,IAAI,CAAC,wBAAwB,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAU,CAAC;AAGtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AA2BpG,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAU,CAAC;AASxF,+EAA+E;AAC/E,8EAA8E;AAC9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,iBAAiB,EAAE,mBAAmB;IACtC,gGAAgG;IAChG,iGAAiG;IACjG,sCAAsC;IACtC,UAAU,EAAE,YAAY;IACxB,6FAA6F;IAC7F,8FAA8F;IAC9F,0EAA0E;IAC1E,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC"}
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/deployments.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oGAAoG;AACpG,+DAA+D;AAC/D,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,2CAA2C;AAC3C,EAAE;AACF,2FAA2F;AAC3F,yFAAyF;AACzF,oGAAoG;AACpG,oEAAoE;AAMpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAIhG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AA6CvF,gGAAgG;AAChG,8FAA8F;AAC9F,EAAE;AACF,8FAA8F;AAC9F,gGAAgG;AAChG,mGAAmG;AACnG,oGAAoG;AACpG,kGAAkG;AAClG,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,IAExC;IACC,OAAO,OAAO,IAAI,CAAC,wBAAwB,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAU,CAAC;AAGtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AA2BpG,iGAAiG;AACjG,sGAAsG;AACtG,6FAA6F;AAC7F,8BAA8B;AAC9B,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,mBAAmB;IACnB,OAAO;IACP,eAAe;IACf,wBAAwB;IACxB,gBAAgB;IAChB,uBAAuB;IACvB,WAAW;IACX,eAAe;CACP,CAAC;AAIX,kGAAkG;AAClG,6FAA6F;AAC7F,wBAAwB;AACxB,EAAE;AACF,mGAAmG;AACnG,4FAA4F;AAC5F,EAAE;AACF,8FAA8F;AAC9F,kGAAkG;AAClG,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,cAAc;IACd,uBAAuB;IACvB,0BAA0B;IAC1B,UAAU;IACV,iBAAiB;IACjB,qBAAqB;CACb,CAAC;AAsBX,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAU,CAAC;AASxF,+EAA+E;AAC/E,8EAA8E;AAC9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,iBAAiB,EAAE,mBAAmB;IACtC,gGAAgG;IAChG,iGAAiG;IACjG,sCAAsC;IACtC,UAAU,EAAE,YAAY;IACxB,6FAA6F;IAC7F,8FAA8F;IAC9F,0EAA0E;IAC1E,gBAAgB,EAAE,kBAAkB;IACpC,gGAAgG;IAChG,6FAA6F;IAC7F,kGAAkG;IAClG,6FAA6F;IAC7F,qFAAqF;IACrF,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/dist/cli/lib/contract/desired-state.d.ts

@@ -41,7 +41,9 @@ export declare const ASSETS_NOT_CONFIGURABLE_MESSAGE = "Asset storage is not con
 export declare const CACHE_NOT_CONFIGURABLE_MESSAGE = "The cache is not configurable. Remove the cache section: Vendure Cloud gives every VC Environment its own cache and configures Vendure to use it.";
 export declare const DATABASE_NOT_CONFIGURABLE_MESSAGE = "The database is not configurable. Remove the database section: Vendure Cloud gives every VC Environment its own PostgreSQL database and scales it.";
 export declare const JOB_QUEUE_NOT_CONFIGURABLE_MESSAGE = "The job queue is not configurable. Remove the jobQueue section: Vendure Cloud gives every VC Environment its own job queue and configures Vendure to use it.";
-export declare const RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE = "Runtime service sizing is not configurable. Remove the plan field: Vendure Cloud sizes the server and the worker. Replicas are still yours to set, and support can raise the size if you need more.";
+export declare const RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE = "Runtime service sizing is not configurable. Remove the plan field: Vendure Cloud sizes the server and the worker, and support can raise the size if you need more.";
+export declare const RUNTIME_REPLICAS_NOT_CONFIGURABLE_MESSAGE = "Replica counts are not configurable. Remove the replicas field: Vendure Cloud scales the server and the worker automatically within platform limits, and support can raise those limits if you need more.";
+export declare const RUNTIME_WORKER_NOT_CONFIGURABLE_MESSAGE = "The worker is not configurable. Remove the worker section: Vendure Cloud sizes and scales the worker, and the port and health check path belong to the server alone.";
 export declare const environmentDesiredStateSchema: z.ZodPipe<z.ZodUnknown, z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
     environment: z.ZodObject<{
@@ -57,13 +59,9 @@ export declare const environmentDesiredStateSchema: z.ZodPipe<z.ZodUnknown, z.Zo
     }, z.core.$strict>;
     runtime: z.ZodObject<{
         server: z.ZodObject<{
-            replicas: z.ZodNumber;
             port: z.ZodDefault<z.ZodNumber>;
             healthCheckPath: z.ZodDefault<z.ZodString>;
         }, z.core.$strict>;
-        worker: z.ZodObject<{
-            replicas: z.ZodNumber;
-        }, z.core.$strict>;
     }, z.core.$strict>;
     search: z.ZodDiscriminatedUnion<[z.ZodObject<{
         managedService: z.ZodLiteral<"none">;

package/dist/cli/lib/contract/desired-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"desired-state.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/desired-state.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,UAAU,wBAAyB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,eAAO,MAAM,cAAc;;GAA6C,CAAC;AAEzE,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AACrF,eAAO,MAAM,uBAAuB;;;;;EAA+B,CAAC;AAKpE,eAAO,MAAM,cAAc,yYAoBjB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;EAAyB,CAAC;AA8BxD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,gCAAgC,YAAY,CAAC;AAmB1D,eAAO,MAAM,+BAA+B,gJACmG,CAAC;AAIhJ,eAAO,MAAM,8BAA8B,sJAC0G,CAAC;AAKtJ,eAAO,MAAM,iCAAiC,uJACwG,CAAC;AAIvJ,eAAO,MAAM,kCAAkC,iKACiH,CAAC;AAKjK,eAAO,MAAM,qCAAqC,wMACqJ,CAAC;AA+DxM,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}
+{"version":3,"file":"desired-state.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/desired-state.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,UAAU,wBAAyB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,eAAO,MAAM,cAAc;;GAA6C,CAAC;AAEzE,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AACrF,eAAO,MAAM,uBAAuB;;;;;EAA+B,CAAC;AAKpE,eAAO,MAAM,cAAc,yYAoBjB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;EAAyB,CAAC;AAgBxD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,gCAAgC,YAAY,CAAC;AAmB1D,eAAO,MAAM,+BAA+B,gJACmG,CAAC;AAIhJ,eAAO,MAAM,8BAA8B,sJAC0G,CAAC;AAKtJ,eAAO,MAAM,iCAAiC,uJACwG,CAAC;AAIvJ,eAAO,MAAM,kCAAkC,iKACiH,CAAC;AAKjK,eAAO,MAAM,qCAAqC,uKACoH,CAAC;AAOvK,eAAO,MAAM,yCAAyC,8MACuJ,CAAC;AAG9M,eAAO,MAAM,uCAAuC,yKACoH,CAAC;AAmFzK,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/cli/lib/contract/desired-state.js

@@ -47,22 +47,9 @@ export const VC_ADDON_PLANS = [
     "vc-compute-2000-40",
 ];
 export const vcAddonPlanSchema = z.enum(VC_ADDON_PLANS);
-const runtimeReplicasSchema = z.number().int().min(1).max(20);
 const addonReplicasSchema = z.number().int().min(1).max(10);
 const storageGbSchema = z.number().int().min(1).max(1000);
 const typesenseStorageGbSchema = storageGbSchema.min(6);
-// How many tasks a runtime service runs, and nothing about how large each one is. The task shape is
-// the platform's, resolved from the VC Environment's type and its platform-managed capacity class
-// (CLO-569), and no longer named in this document.
-//
-// `replicas` is the temporary half of that split. It stays customer-configurable because the
-// platform has no autoscaling yet and because stop and start restore a service to the count
-// recorded here (CLO-495). CLO-572 replaces it with platform-owned bounds and removes the field.
-const serviceSchema = z
-    .object({
-    replicas: runtimeReplicasSchema,
-})
-    .strict();
 // Where the server listens and how the load balancer decides it is alive.
 //
 // On the server alone, because the worker has no listener and nothing routes to it. Both carry a
@@ -70,13 +57,13 @@ const serviceSchema = z
 // never sets them gets what the managed build produces.
 //
 // They are here rather than fixed in the control plane because a VC Environment may run an image
-// the platform did not build — `deploy --server-image` is a supported path — and that image
-// listens where it listens. A platform-wide constant would mean a target group that never turns
-// healthy, reported as a failed deploy with nothing naming the port as the cause.
+// the platform did not build: a VC Deployment recorded before the managed build owned every image,
+// and the rollback that replays one. A platform-wide constant would mean a target group that never
+// turns healthy, reported as a failed deploy with nothing naming the port as the cause.
 export const DEFAULT_SERVER_PORT = 3000;
 export const DEFAULT_SERVER_HEALTH_CHECK_PATH = "/health";
-const serverServiceSchema = serviceSchema
-    .extend({
+const serverServiceSchema = z
+    .object({
     port: z.number().int().min(1).max(65535).default(DEFAULT_SERVER_PORT),
     // Rooted, because the load balancer sends it as a path and a relative one is refused at apply
     // time by AWS rather than here.
@@ -103,18 +90,32 @@ export const DATABASE_NOT_CONFIGURABLE_MESSAGE = "The database is not configurab
 export const JOB_QUEUE_NOT_CONFIGURABLE_MESSAGE = "The job queue is not configurable. Remove the jobQueue section: Vendure Cloud gives every VC Environment its own job queue and configures Vendure to use it.";
 // Per-service compute plans left with ADR-0036 and CLO-569: Vendure Cloud sizes a VC Environment's
 // server and worker from its type and its platform-managed capacity class, so there is no compute
-// size to pick. Replicas are unaffected and stay in the document.
-export const RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE = "Runtime service sizing is not configurable. Remove the plan field: Vendure Cloud sizes the server and the worker. Replicas are still yours to set, and support can raise the size if you need more.";
+// size to pick.
+export const RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE = "Runtime service sizing is not configurable. Remove the plan field: Vendure Cloud sizes the server and the worker, and support can raise the size if you need more.";
+// Replica counts left with CLO-572: Vendure Cloud scales a VC Environment's server and its worker
+// between platform-owned bounds, so a fixed count is neither used nor honoured.
+//
+// The sentence names autoscaling rather than only refusing the field, because a customer who set a
+// count did so to handle load and needs to know that the thing they wanted still happens.
+export const RUNTIME_REPLICAS_NOT_CONFIGURABLE_MESSAGE = "Replica counts are not configurable. Remove the replicas field: Vendure Cloud scales the server and the worker automatically within platform limits, and support can raise those limits if you need more.";
+// The whole worker section went with it, because the count was all it held.
+export const RUNTIME_WORKER_NOT_CONFIGURABLE_MESSAGE = "The worker is not configurable. Remove the worker section: Vendure Cloud sizes and scales the worker, and the port and health check path belong to the server alone.";
 const REMOVED_FIELD_MESSAGES = {
     assets: ASSETS_NOT_CONFIGURABLE_MESSAGE,
     cache: CACHE_NOT_CONFIGURABLE_MESSAGE,
     database: DATABASE_NOT_CONFIGURABLE_MESSAGE,
     jobQueue: JOB_QUEUE_NOT_CONFIGURABLE_MESSAGE,
 };
-// The runtime services whose `plan` is gone. Checked one level down rather than through the strict
-// object above, for the same reason the four top-level sections are: a strict object reports an
-// unrecognized key, which reads as a misspelling rather than as a field the platform took over.
+// The runtime services whose `plan` and `replicas` are gone. Checked one level down rather than
+// through the strict object above, for the same reason the four top-level sections are: a strict
+// object reports an unrecognized key, which reads as a misspelling rather than as a field the
+// platform took over.
 const REMOVED_RUNTIME_SERVICES = ["server", "worker"];
+// The fields those services no longer carry, each with the sentence that says where it went.
+const REMOVED_RUNTIME_SERVICE_FIELDS = {
+    plan: RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE,
+    replicas: RUNTIME_REPLICAS_NOT_CONFIGURABLE_MESSAGE,
+};
 const removedFieldsSchema = z.unknown().superRefine((value, ctx) => {
     if (typeof value !== "object" || value === null)
         return;
@@ -130,12 +131,19 @@ const removedFieldsSchema = z.unknown().superRefine((value, ctx) => {
         const service = runtime[key];
         if (typeof service !== "object" || service === null)
             continue;
-        if (!("plan" in service))
-            continue;
+        for (const [field, message] of Object.entries(REMOVED_RUNTIME_SERVICE_FIELDS)) {
+            if (!(field in service))
+                continue;
+            ctx.addIssue({ code: "custom", path: ["runtime", key, field], message });
+        }
+    }
+    // The section itself, reported after its fields so that a document written against the previous
+    // shape is told about the count it set before it is told the section holding it has gone.
+    if ("worker" in runtime) {
         ctx.addIssue({
             code: "custom",
-            path: ["runtime", key, "plan"],
-            message: RUNTIME_PLAN_NOT_CONFIGURABLE_MESSAGE,
+            path: ["runtime", "worker"],
+            message: RUNTIME_WORKER_NOT_CONFIGURABLE_MESSAGE,
         });
     }
 });
@@ -148,10 +156,16 @@ const environmentDesiredStateObjectSchema = z
         region: vcRegionSchema,
     })
         .strict(),
+    // The server alone. Both of its fields describe where an application listens, which is the
+    // only thing about a runtime service left for a customer to say: how large each task is and how
+    // many of them run are both the platform's (CLO-569, CLO-572).
+    //
+    // There is no `worker` key, because everything that was ever in one has gone. A section holding
+    // nothing would still have to be written into every document and would mean nothing when it
+    // was.
     runtime: z
         .object({
         server: serverServiceSchema,
-        worker: serviceSchema,
     })
         .strict(),
     search: z.discriminatedUnion("managedService", [

package/dist/cli/lib/contract/desired-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"desired-state.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/desired-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"desired-state.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/desired-state.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/contract/foreign-credentials.d.ts

@@ -22,10 +22,12 @@
  * halves of the user-scoped Console CLI Session in
  * `~/.vendure/console-credentials.json`.
  *
- * Refusing `vcli_` is not the final answer for it — CLO-641 makes the Console
- * session usable through a server-side exchange with Console. Until that
- * exists, a Console session presented here is a credential Cloud cannot check,
- * and the boundary says so rather than forwarding it.
+ * `vcli_` is refused as an API key only. A Console session presented as
+ * `Authorization: Bearer` is resolved by the control plane against Console's
+ * introspection route (CLO-641), which is the one place that can check it, and
+ * only on a deployment configured to reach a Console. Presenting it through
+ * `--token`, `VENDURE_CLOUD_TOKEN` or `x-api-key` is still a mistake, because
+ * none of those paths reaches that check.
  */
 export declare const ENVIRONMENT_CREDENTIAL_PREFIX = "vce_";
 export declare const CONSOLE_SESSION_TOKEN_PREFIX = "vcli_";

package/dist/cli/lib/contract/foreign-credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-credentials.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/foreign-credentials.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,eAAO,MAAM,6BAA6B,SAAS,CAAC;AACpD,eAAO,MAAM,4BAA4B,UAAU,CAAC;AACpD,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAEpD,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAiB3F;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAOjF;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAExE"}
+{"version":3,"file":"foreign-credentials.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/foreign-credentials.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,eAAO,MAAM,6BAA6B,SAAS,CAAC;AACpD,eAAO,MAAM,4BAA4B,UAAU,CAAC;AACpD,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAEpD,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAiB3F;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAOjF;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAExE"}

package/dist/cli/lib/contract/foreign-credentials.js

@@ -26,10 +26,12 @@
  * halves of the user-scoped Console CLI Session in
  * `~/.vendure/console-credentials.json`.
  *
- * Refusing `vcli_` is not the final answer for it — CLO-641 makes the Console
- * session usable through a server-side exchange with Console. Until that
- * exists, a Console session presented here is a credential Cloud cannot check,
- * and the boundary says so rather than forwarding it.
+ * `vcli_` is refused as an API key only. A Console session presented as
+ * `Authorization: Bearer` is resolved by the control plane against Console's
+ * introspection route (CLO-641), which is the one place that can check it, and
+ * only on a deployment configured to reach a Console. Presenting it through
+ * `--token`, `VENDURE_CLOUD_TOKEN` or `x-api-key` is still a mistake, because
+ * none of those paths reaches that check.
  */
 export const ENVIRONMENT_CREDENTIAL_PREFIX = "vce_";
 export const CONSOLE_SESSION_TOKEN_PREFIX = "vcli_";
@@ -46,7 +48,7 @@ const PREFIXES = [
 ];
 const REFUSALS = {
     [ForeignCredential.ENVIRONMENT]: "A Vendure project environment credential cannot manage Vendure Cloud. It authenticates one environment of one project. Use a Vendure Cloud API key, or run `vcloud login`.",
-    [ForeignCredential.CONSOLE_SESSION]: "A Vendure Console session cannot manage Vendure Cloud. Use a Vendure Cloud API key, or run `vcloud login`.",
+    [ForeignCredential.CONSOLE_SESSION]: "A Vendure Console session is not a Vendure Cloud API key. Vendure Cloud reads your Console session from `~/.vendure/console-credentials.json` on its own. Use a Vendure Cloud API key here, or run `vcloud login`.",
     [ForeignCredential.CONSOLE_REFRESH]: "A Vendure Console refresh token is not a credential Vendure Cloud accepts. Use a Vendure Cloud API key, or run `vcloud login`.",
 };
 /**

package/dist/cli/lib/contract/foreign-credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-credentials.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/foreign-credentials.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0FAA0F;AAC1F,gGAAgG;AAChG,8DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;CACzB,CAAC;AAGX,MAAM,QAAQ,GAAwD;IACpE,CAAC,6BAA6B,EAAE,iBAAiB,CAAC,WAAW,CAAC;IAC9D,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,eAAe,CAAC;IACjE,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,eAAe,CAAC;CAClE,CAAC;AAEF,MAAM,QAAQ,GAAsC;IAClD,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAC7B,4KAA4K;IAC9K,CAAC,iBAAiB,CAAC,eAAe,CAAC,EACjC,4GAA4G;IAC9G,CAAC,iBAAiB,CAAC,eAAe,CAAC,EACjC,gIAAgI;CACnI,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CAAC,IAAuB;IAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"foreign-credentials.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/foreign-credentials.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0FAA0F;AAC1F,gGAAgG;AAChG,8DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;CACzB,CAAC;AAGX,MAAM,QAAQ,GAAwD;IACpE,CAAC,6BAA6B,EAAE,iBAAiB,CAAC,WAAW,CAAC;IAC9D,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,eAAe,CAAC;IACjE,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,eAAe,CAAC;CAClE,CAAC;AAEF,MAAM,QAAQ,GAAsC;IAClD,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAC7B,4KAA4K;IAC9K,CAAC,iBAAiB,CAAC,eAAe,CAAC,EACjC,oNAAoN;IACtN,CAAC,iBAAiB,CAAC,eAAe,CAAC,EACjC,gIAAgI;CACnI,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CAAC,IAAuB;IAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/cli/lib/contract/logs.d.ts

@@ -41,4 +41,124 @@ export declare function isLogEntry(value: unknown): value is {
 export declare function isLogStreamErrorFrame(value: unknown): value is LogStreamErrorFrame;
 export declare function isLogStreamReconnectFrame(value: unknown): value is LogStreamReconnectFrame;
 export declare function isLogStreamTerminalFrame(value: unknown): value is LogStreamTerminalFrame;
+export declare const LOG_SOURCES: readonly ["migration", "server", "worker"];
+export type LogSource = (typeof LOG_SOURCES)[number];
+export declare function isLogSource(value: string): value is LogSource;
+export declare const LOG_SEVERITIES: readonly ["debug", "verbose", "info", "warn", "error"];
+export type LogSeverity = (typeof LOG_SEVERITIES)[number];
+export declare function isLogSeverity(value: string): value is LogSeverity;
+export declare function classifyLogSeverity(value: string | null | undefined): LogSeverity | null;
+export declare function structuredLogLevel(message: string): string | null;
+export declare function logSeverityRank(severity: LogSeverity): number;
+export declare function passesMinimumSeverity(severity: LogSeverity | null, minimum: LogSeverity | null): boolean;
+export declare const LOG_QUERY_RESULT_STATES: readonly ["AVAILABLE", "RUNNING", "NO_LOGS", "NO_MATCHES", "PARTIAL", "WINDOW_TOO_WIDE", "OUTSIDE_SEARCHABLE_WINDOW", "RETENTION_EXCEEDED", "INVALID_QUERY", "RATE_LIMITED", "UNAVAILABLE"];
+export type LogQueryResultState = (typeof LOG_QUERY_RESULT_STATES)[number];
+export declare const LOG_QUERY_TRUNCATION_REASONS: readonly ["SCAN_INCOMPLETE", "PAGE_LIMIT", "EXPORT_LIMIT"];
+export type LogQueryTruncationReason = (typeof LOG_QUERY_TRUNCATION_REASONS)[number];
+export declare const LOG_QUERY_DEPLOYMENT_CORRELATIONS: readonly ["TIME_WINDOW", "TASK_IDENTITY"];
+export type LogQueryDeploymentCorrelation = (typeof LOG_QUERY_DEPLOYMENT_CORRELATIONS)[number];
+export declare const LOG_QUERY_FILTERS: readonly ["TIME", "SOURCE", "DEPLOYMENT", "INCLUDE_TEXT", "EXCLUDE_TEXT", "MINIMUM_SEVERITY"];
+export type LogQueryFilter = (typeof LOG_QUERY_FILTERS)[number];
+export interface LogQueryEvent {
+    id: string;
+    timestamp: string;
+    receivedAt: string;
+    source: LogSource;
+    stream: string;
+    message: string;
+    severity: LogSeverity | null;
+    messageTruncated: boolean;
+}
+export interface LogRetention {
+    retentionDays: number;
+    searchableFrom: string;
+    oldestEventObserved: string | null;
+}
+export interface CreateLogQueryRequest {
+    environmentIds: string[];
+    sources: LogSource[];
+    from?: string;
+    to?: string;
+    deploymentId?: string;
+    include?: string;
+    exclude?: string;
+    minimumSeverity?: LogSeverity;
+    pageSize?: number;
+}
+export interface NormalizedLogQuery {
+    environmentIds: string[];
+    sources: LogSource[];
+    from: string;
+    to: string;
+    windowClamped: boolean;
+    deploymentId: string | null;
+    deploymentCorrelation: LogQueryDeploymentCorrelation | null;
+    include: string | null;
+    exclude: string | null;
+    minimumSeverity: LogSeverity | null;
+    pageSize: number;
+}
+export interface LogQueryResults {
+    state: LogQueryResultState;
+    truncationReason: LogQueryTruncationReason | null;
+    events: LogQueryEvent[];
+    nextCursor: string | null;
+    retention: LogRetention;
+    retryAfterSeconds: number | null;
+    errorDetails: string | null;
+}
+export interface LogQuery {
+    id: string;
+    projectId: string;
+    createdAt: string;
+    capabilityVersion: string;
+    query: NormalizedLogQuery;
+    results: LogQueryResults;
+}
+export declare const LOG_EXPORT_FORMATS: readonly ["JSONL", "TEXT"];
+export type LogExportFormat = (typeof LOG_EXPORT_FORMATS)[number];
+export declare const LOG_EXPORT_STATES: readonly ["PENDING", "READY", "EXPIRED", "FAILED"];
+export type LogExportState = (typeof LOG_EXPORT_STATES)[number];
+export interface CreateLogExportRequest {
+    format?: LogExportFormat;
+}
+export interface LogExportDownload {
+    url: string;
+    expiresAt: string;
+}
+export interface LogExport {
+    id: string;
+    queryId: string;
+    projectId: string;
+    format: LogExportFormat;
+    state: LogExportState;
+    createdAt: string;
+    expiresAt: string;
+    recordCount: number | null;
+    sizeBytes: number | null;
+    truncationReason: LogQueryTruncationReason | null;
+    download: LogExportDownload | null;
+    errorDetails: string | null;
+}
+export interface LogSourceCapability {
+    source: LogSource;
+    maxQueryWindowSeconds: number;
+    searchableWindowSeconds: number;
+    retentionDays: number;
+    filters: LogQueryFilter[];
+    minPageSizeLines: number;
+    maxPageSizeLines: number;
+    maxPageSizeBytes: number;
+    maxMessageBytes: number;
+    maxExportBytes: number;
+    exportFormats: LogExportFormat[];
+    exportExpirySeconds: number;
+    asynchronousQueries: boolean;
+}
+export interface LogCapabilities {
+    capabilityVersion: string;
+    maxEnvironmentsPerQuery: number;
+    maxSourcesPerQuery: number;
+    sources: LogSourceCapability[];
+}
 //# sourceMappingURL=logs.d.ts.map

package/dist/cli/lib/contract/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/logs.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,+BAAgC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE;QACf,MAAM,EAAE,kBAAkB,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE;QACd,MAAM,EAAE,qBAAqB,CAAC;KAC/B,CAAC;CACH;AAOD,eAAO,MAAM,sBAAsB,gFAMzB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAOD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAgBA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAQ1F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAQxF"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/logs.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/contract/logs.js

@@ -1,7 +1,9 @@
 // Mirrors the environment log and build log wire contract from `@vendure-cloud/api-types`'s
 // `index.ts`. See ./README.md for why this package cannot import it, including as types.
 //
-// `GET /environments/{id}/logs` returns `LogEntry[]`. `GET /environments/{id}/logs/stream`
+// `GET /environments/{id}/logs` returns `LogEntry[]`. Nothing in this package calls it since
+// CLO-891: `logs` reads the Project-scoped query below, and only the stream route is still read
+// from here. `GET /environments/{id}/logs/stream`
 // (`?service=<LogService>&lines=<history replay count>`) is SSE: it replays recent history, then
 // tails; each frame's data is a JSON `LogEntry`. Handler-level failures cannot use an HTTP status,
 // because SSE commits the 200 before the handler runs, so they arrive as a single
@@ -63,4 +65,107 @@ export function isLogStreamTerminalFrame(value) {
         candidate !== null &&
         candidate.reason === "BUILD_STEP_FINISHED");
 }
+// Project-scoped log query and export (CLO-733). The routes are
+// `POST /projects/{projectId}/log-queries`, `GET .../log-queries/{queryId}`,
+// `GET .../log-queries/{queryId}/results?cursor=`, `POST .../log-queries/{queryId}/export`,
+// `GET /projects/{projectId}/log-exports/{exportId}`,
+// `GET /projects/{projectId}/log-exports/{exportId}/download` and
+// `GET /projects/{projectId}/log-capabilities`.
+//
+// An export is created and then re-read until it reports `READY`; the download route is what
+// `LogExportDownload.url` names, so redeeming one carries the caller's own credential.
+//
+// A cursor is opaque and composed by the server: this package neither reads one nor builds one. An
+// event's identity is the provider's own event id, carried as `LogQueryEvent.id`, and is what a
+// resumed read de-duplicates on.
+//
+// `CLOSED_BETA_LOG_CAPABILITIES` is deliberately not mirrored. The bounds a caller is held to are
+// read from the capability resource over the wire, so the CLI has no copy of them to go stale.
+export const LOG_SOURCES = ["migration", ...LOG_SERVICES];
+export function isLogSource(value) {
+    return LOG_SOURCES.includes(value);
+}
+export const LOG_SEVERITIES = ["debug", "verbose", "info", "warn", "error"];
+const LOG_SEVERITY_ALIASES = new Map([
+    ["warning", "warn"],
+    ["fatal", "error"],
+]);
+export function isLogSeverity(value) {
+    return LOG_SEVERITIES.includes(value);
+}
+export function classifyLogSeverity(value) {
+    if (value === null || value === undefined)
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (isLogSeverity(normalized))
+        return normalized;
+    return LOG_SEVERITY_ALIASES.get(normalized) ?? null;
+}
+// The level a structured line declares, or null for a line this contract does not read one from.
+// The eligibility rule is the schema observed on the wire: a JSON object with a non-blank string
+// `message`. Returns the word the producer wrote rather than a severity, because a renderer wants
+// the first and a threshold wants `classifyLogSeverity` over it.
+export function structuredLogLevel(message) {
+    const trimmed = message.trim();
+    if (!trimmed.startsWith("{") || !trimmed.endsWith("}"))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        return null;
+    const fields = { ...parsed };
+    if (typeof fields.message !== "string" || fields.message.trim() === "")
+        return null;
+    if (typeof fields.level !== "string" || fields.level.trim() === "")
+        return null;
+    return fields.level;
+}
+export function logSeverityRank(severity) {
+    return LOG_SEVERITIES.indexOf(severity);
+}
+// An unclassified line passes every threshold, including the most severe one. The server applies
+// this function to compose a page and a client applies it to render one, so both sides answer the
+// same way about a line whose level nothing could parse.
+export function passesMinimumSeverity(severity, minimum) {
+    if (minimum === null || severity === null)
+        return true;
+    return logSeverityRank(severity) >= logSeverityRank(minimum);
+}
+export const LOG_QUERY_RESULT_STATES = [
+    "AVAILABLE",
+    "RUNNING",
+    "NO_LOGS",
+    "NO_MATCHES",
+    "PARTIAL",
+    "WINDOW_TOO_WIDE",
+    "OUTSIDE_SEARCHABLE_WINDOW",
+    "RETENTION_EXCEEDED",
+    "INVALID_QUERY",
+    "RATE_LIMITED",
+    "UNAVAILABLE",
+];
+export const LOG_QUERY_TRUNCATION_REASONS = [
+    "SCAN_INCOMPLETE",
+    "PAGE_LIMIT",
+    "EXPORT_LIMIT",
+];
+export const LOG_QUERY_DEPLOYMENT_CORRELATIONS = ["TIME_WINDOW", "TASK_IDENTITY"];
+// Include and exclude are one term each, matched as a case-sensitive literal substring of the line,
+// with the exclusion winning where both match. Minimum severity keeps every classified line at or
+// above the named severity and every line the contract cannot classify.
+export const LOG_QUERY_FILTERS = [
+    "TIME",
+    "SOURCE",
+    "DEPLOYMENT",
+    "INCLUDE_TEXT",
+    "EXCLUDE_TEXT",
+    "MINIMUM_SEVERITY",
+];
+export const LOG_EXPORT_FORMATS = ["JSONL", "TEXT"];
+export const LOG_EXPORT_STATES = ["PENDING", "READY", "EXPIRED", "FAILED"];
 //# sourceMappingURL=logs.js.map