@supacloud/cli 0.78.0 → 0.79.0

package/dist/index.js

@@ -179093,11 +179093,12 @@ function resolveSupaCloudContext(env = process.env, cwd = process.cwd(), selecti
 var ACTION_POLICY = {
   deploy: { write: ["deploy"] },
   applications: {
-    read: ["list_releases", "get_release", "get_runtime", "get_deployment_evidence", "get_configuration", "logs", "get_preview_plan"],
+    read: ["list_releases", "get_release", "get_runtime", "get_deployment_evidence", "get_configuration", "get_rollback_snapshot", "logs", "get_preview_plan"],
     write: [
       "upload_release",
       "put_configuration",
       "activate_release",
+      "rollback_release",
       "reconcile_activation",
       "retire_activation",
       "create_preview",
@@ -179199,7 +179200,7 @@ var ACTION_POLICY = {
   ai: { local: ["show_skill", "install_skill"] },
   app: {
     local: ["init", "generate", "dev", "watch", "verify-plan", "compile", "check", "graph", "explain", "export-tools", "context", "doctor", "fix", "plan", "build"],
-    read: ["status", "logs", "preview-plan"],
+    read: ["status", "logs", "rollback-plan", "preview-plan"],
     write: ["upload", "configure", "deploy", "rollback", "reconcile", "retire", "preview", "previews", "preview-status", "preview-cleanup"]
   },
   db: {
@@ -180280,6 +180281,19 @@ var ApplicationActivationRetirementResultSchema = _Object_({
   activation_id: ApplicationActivationIdSchema,
   retired_at: String2()
 }, { additionalProperties: false });
+var RollbackActivationSchema = _Object_({
+  release_id: ApplicationReleaseIdSchema,
+  configuration_id: ApplicationConfigurationIdSchema,
+  activation_id: ApplicationActivationIdSchema
+}, { additionalProperties: false });
+var ApplicationRollbackSnapshotSchema = _Object_({
+  schema: Literal("supacloud.application-rollback-snapshot.v1"),
+  project_ref: String2({ pattern: "^[a-z0-9-]{1,20}$" }),
+  application_id: ApplicationIdSchema,
+  environment_id: ApplicationIdSchema,
+  active: Union([RollbackActivationSchema, Null()]),
+  previous: Union([RollbackActivationSchema, Null()])
+}, { additionalProperties: false });
 // node_modules/@supacloud/delivery/src/deployment-evidence.ts
 var closed3 = { additionalProperties: false };
 var sha256 = String2({ pattern: "^[a-f0-9]{64}$" });
@@ -187252,6 +187266,7 @@ var ApplicationActivationIdSchema2 = ApplicationActivationIdSchema;
 var ApplicationActivationWriteSchema2 = ApplicationActivationWriteSchema;
 var ApplicationActivationResultSchema2 = ApplicationActivationResultSchema;
 var ApplicationActivationRetirementResultSchema2 = ApplicationActivationRetirementResultSchema;
+var ApplicationRollbackSnapshotSchema2 = ApplicationRollbackSnapshotSchema;
 
 // src/shared/tools/application-preview-tools.ts
 var APPLICATION_PREVIEW_ACTIONS = [
@@ -187590,6 +187605,8 @@ var APPLICATION_TOOL_SCHEMA = {
     "get_configuration",
     "put_configuration",
     "activate_release",
+    "rollback_release",
+    "get_rollback_snapshot",
     "reconcile_activation",
     "retire_activation",
     ...APPLICATION_PREVIEW_ACTIONS,
@@ -187597,13 +187614,13 @@ var APPLICATION_TOOL_SCHEMA = {
   ]), "Action"),
   ref: withDescription(String2(), "Project ref"),
   id: withDescription(ApplicationIdSchema2, "Application ID"),
-  environment_id: optional(withDescription(ApplicationIdSchema2, "[get_runtime/get_configuration/put_configuration] Environment ID")),
-  configuration_id: optional(ApplicationConfigurationIdSchema2, "[get_configuration/activate_release] Immutable revision; required for activation"),
-  activation_id: optional(ApplicationActivationIdSchema2, "[activate_release/reconcile_activation/retire_activation] Explicit stable activation ID"),
-  expected_activation_id: optional(Union([ApplicationActivationIdSchema2, Null(), Literal("absent")]), "[activate_release] Current activation ID, or absent for first activation"),
+  environment_id: optional(withDescription(ApplicationIdSchema2, "[get_runtime/get_configuration/put_configuration/get_rollback_snapshot/rollback_release] Environment ID")),
+  configuration_id: optional(ApplicationConfigurationIdSchema2, "[get_configuration/activate_release/rollback_release] Immutable revision; required for explicit activation"),
+  activation_id: optional(ApplicationActivationIdSchema2, "[activate_release/reconcile_activation/retire_activation/rollback_release] Explicit stable activation ID; generated for rollback if omitted"),
+  expected_activation_id: optional(Union([ApplicationActivationIdSchema2, Null(), Literal("absent")]), "[activate_release/rollback_release] Current activation ID, or absent for first activation; selected by platform for default rollback"),
   configuration_path: optional(String2(), "[put_configuration] Local configuration write JSON including revision and expected revision"),
   manifest_path: optional(String2(), "[upload_release] Local delivery.manifest.json"),
-  release_id: optional(ApplicationReleaseIdSchema2, "[get_release/activate_release/reconcile_activation] Immutable application release ID"),
+  release_id: optional(ApplicationReleaseIdSchema2, "[get_release/activate_release/reconcile_activation/rollback_release] Immutable application release ID; platform selects previous for default rollback"),
   cursor: optional(ApplicationReleaseIdSchema2, "[list_releases] Last release ID"),
   limit: optional(Integer({ minimum: 1, maximum: 100 }), "[list_releases] Page size, default 50"),
   offset: optional(Integer({ minimum: 0, maximum: 1e6 }), "[logs] Result offset"),
@@ -187682,7 +187699,7 @@ async function configurationAction(http, args, project) {
     return releaseControlFailure(operation, action === "put_configuration" ? "OUTCOME_UNKNOWN" : "INVALID_RESPONSE", result.status, identity);
   }
 }
-async function activationAction(http, args, project) {
+async function activationAction(http, args, project, rollback) {
   const action = text(args, "action"), ref = text(args, "ref"), id = text(args, "id");
   const environmentId = text(args, "environment_id"), activationId = text(args, "activation_id");
   const releaseId = args["release_id"] === undefined ? undefined : text(args, "release_id");
@@ -187692,7 +187709,7 @@ async function activationAction(http, args, project) {
   if (!Check2(ApplicationIdSchema2, environmentId) || !Check2(ApplicationActivationIdSchema2, activationId) || action !== "retire_activation" && !Check2(ApplicationReleaseIdSchema2, releaseId)) {
     throw new Error("Invalid application activation identity");
   }
-  const operation = `applications.${action}`;
+  const operation = rollback ? "applications.rollback_release" : `applications.${action}`;
   const path = `/v1/projects/${project}/applications/${encodeURIComponent(id)}/environments/${encodeURIComponent(environmentId)}/activations`;
   const identity = {
     project_ref: ref,
@@ -187701,6 +187718,7 @@ async function activationAction(http, args, project) {
     activation_id: activationId,
     ...releaseId ? { release_id: releaseId } : {}
   };
+  const safeState = { ...identity, ...rollback ?? {} };
   let body = {};
   if (action === "activate_release") {
     body = {
@@ -187715,7 +187733,9 @@ async function activationAction(http, args, project) {
   const endpoint = action === "activate_release" ? path : `${path}/${activationId}/${action === "retire_activation" ? "retire" : "reconcile"}`;
   const result = await http.post(endpoint, body, { timeoutMs: 120000, maxJsonBytes: 65536, responseTimeoutMs: 30000 });
   if (!result.ok)
-    return releaseControlMutationFailure(operation, result, identity);
+    return releaseControlMutationFailure(operation, result, safeState);
+  if (result.status !== 200)
+    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", result.status, safeState);
   if (action === "retire_activation") {
     if (!Check2(ApplicationActivationRetirementResultSchema2, result.data) || Object.entries(identity).some(([key, value]) => Reflect.get(result.data, key) !== value)) {
       return releaseControlFailure(operation, "OUTCOME_UNKNOWN", result.status, identity);
@@ -187723,9 +187743,60 @@ async function activationAction(http, args, project) {
     return releaseControlSuccess(operation, result.data);
   }
   if (!Check2(ApplicationActivationResultSchema2, result.data) || Object.entries(identity).some(([key, value]) => Reflect.get(result.data, key) !== value) || action === "reconcile_activation" && !result.data.replayed) {
-    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", result.status, identity);
+    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", result.status, safeState);
+  }
+  return releaseControlSuccess(operation, { ...result.data, ...rollback ?? {} });
+}
+async function rollbackAction(http, args, project) {
+  const ref = text(args, "ref"), id = text(args, "id"), environmentId = text(args, "environment_id");
+  if (!Check2(ApplicationIdSchema2, environmentId))
+    throw new Error("Invalid environment ID");
+  const operation = `applications.${text(args, "action")}`;
+  const identity = { project_ref: ref, application_id: id, environment_id: environmentId };
+  let activationId = args["activation_id"];
+  if (activationId !== undefined && !Check2(ApplicationActivationIdSchema2, activationId)) {
+    throw new Error("Invalid application activation ID");
+  }
+  let releaseId = args["release_id"], configurationId = args["configuration_id"];
+  let expectedActivationId = args["expected_activation_id"];
+  if (releaseId === undefined || args["action"] === "get_rollback_snapshot") {
+    if (releaseId !== undefined || configurationId !== undefined || expectedActivationId !== undefined) {
+      throw new Error("Default rollback selection cannot mix explicit release/configuration/CAS flags");
+    }
+    const response = await http.get(`/v1/projects/${project}/applications/${encodeURIComponent(id)}/environments/${encodeURIComponent(environmentId)}/rollback-snapshot`, { maxJsonBytes: 65536, responseTimeoutMs: 30000 });
+    if (!response.ok)
+      return releaseControlFailure(operation, "HTTP_ERROR", response.transportError ? null : response.status, identity);
+    const snapshot = response.data;
+    if (response.status !== 200 || !Check2(ApplicationRollbackSnapshotSchema2, snapshot) || snapshot.project_ref !== ref || snapshot.application_id !== id || snapshot.environment_id !== environmentId || snapshot.previous !== null && (snapshot.active === null || snapshot.previous.activation_id === snapshot.active.activation_id)) {
+      return releaseControlFailure(operation, "INVALID_RESPONSE", response.status, identity);
+    }
+    if (args["action"] === "get_rollback_snapshot")
+      return releaseControlSuccess(operation, { ...identity, snapshot });
+    if (!snapshot.active || !snapshot.previous) {
+      return releaseControlFailure(operation, "MUTATION_NOT_SUCCEEDED", response.status, {
+        ...identity,
+        reason: "NO_PREVIOUS_ACTIVATION"
+      });
+    }
+    if (activationId === snapshot.active.activation_id || activationId === snapshot.previous.activation_id) {
+      throw new Error("Rollback requires a new activation ID");
+    }
+    releaseId = snapshot.previous.release_id;
+    configurationId = snapshot.previous.configuration_id;
+    expectedActivationId = snapshot.active.activation_id;
   }
-  return releaseControlSuccess(operation, result.data);
+  activationId ??= crypto.randomUUID();
+  return activationAction(http, {
+    ...args,
+    action: "activate_release",
+    activation_id: activationId,
+    release_id: releaseId,
+    configuration_id: configurationId,
+    expected_activation_id: expectedActivationId
+  }, project, {
+    configuration_id: configurationId,
+    expected_activation_id: expectedActivationId === "absent" ? null : expectedActivationId
+  });
 }
 function registerApplicationTools(server2, http) {
   registerTool(server2, "applications", "Store, inspect and explicitly activate immutable HTTP/Worker application releases. Upload does not activate a release.", APPLICATION_TOOL_SCHEMA, async (args) => {
@@ -187735,6 +187806,9 @@ function registerApplicationTools(server2, http) {
       throw new Error("Invalid application ID");
     const path = `/v1/projects/${project}/applications/${encodeURIComponent(id)}/releases`;
     const operation = `applications.${action}`;
+    if (action === "rollback_release" || action === "get_rollback_snapshot") {
+      return rollbackAction(http, args, project);
+    }
     if (APPLICATION_PREVIEW_ACTIONS.some((value) => value === action)) {
       return applicationPreviewAction(http, args, project);
     }
@@ -193981,7 +194055,8 @@ var REMOTE_APP_ACTIONS = {
   configure: "put_configuration",
   deploy: "activate_release",
   status: "get_runtime",
-  rollback: "activate_release",
+  rollback: "rollback_release",
+  "rollback-plan": "get_rollback_snapshot",
   reconcile: "reconcile_activation",
   retire: "retire_activation",
   logs: "logs",
@@ -193992,15 +194067,15 @@ var REMOTE_APP_ACTIONS = {
   "preview-cleanup": "cleanup_preview"
 };
 var REMOTE_APP_DESCRIPTIONS = {
-  ref: "[upload/configure/deploy/status/rollback/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Project ref (defaults to context)",
-  id: "[upload/configure/deploy/status/rollback/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Application ID",
-  environment_id: "[configure/deploy/status/rollback/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Environment ID",
-  configuration_id: "[deploy/rollback/preview] Required immutable configuration revision",
-  activation_id: "[deploy/rollback/reconcile/retire] Required explicit activation ID",
-  expected_activation_id: "[deploy/rollback] Required current activation ID, or absent for first activation",
+  ref: "[upload/configure/deploy/status/rollback/rollback-plan/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Project ref (defaults to context)",
+  id: "[upload/configure/deploy/status/rollback/rollback-plan/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Application ID",
+  environment_id: "[configure/deploy/status/rollback/rollback-plan/reconcile/retire/preview-plan/preview/previews/preview-status/preview-cleanup] Environment ID",
+  configuration_id: "[deploy/rollback/preview] Required for deploy/preview/explicit rollback; platform selects for default rollback",
+  activation_id: "[deploy/rollback/reconcile/retire] Required explicit activation ID; generated for rollback if omitted",
+  expected_activation_id: "[deploy/rollback] Required for deploy/explicit rollback; platform selects current CAS for default rollback",
   configuration_path: "[configure] Configuration write JSON including revision and expected revision",
   manifest_path: "[upload] Local delivery.manifest.json",
-  release_id: "[deploy/rollback/reconcile/preview-plan/preview] Required immutable application release ID",
+  release_id: "[deploy/rollback/reconcile/preview-plan/preview] Required for deploy/reconcile/preview; defaults to journal-selected previous for rollback",
   preview_id: "[preview-status/preview-cleanup] Preview receipt ID",
   branch_ref: "[preview-plan] Proposed branch ref; preview assigns its own",
   branch_name: "[preview] Branch display name",
@@ -195010,6 +195085,7 @@ function registerAppTools(server2, options = {}) {
       "deploy",
       "status",
       "rollback",
+      "rollback-plan",
       "reconcile",
       "retire",
       "logs",
@@ -195018,7 +195094,7 @@ function registerAppTools(server2, options = {}) {
       "previews",
       "preview-status",
       "preview-cleanup"
-    ]), "App action; upload/configure only prepare, rollback activates an explicit old release without schema downgrade"),
+    ]), "App action; upload/configure only prepare, rollback activates the journal-selected previous release without schema downgrade"),
     kind: optional(stringEnum(["module", "command", "query", "controller", "job", "contract", "resource"]), "[generate] Scaffold kind"),
     template: optional(stringEnum(["minimal", "http", "command", "edge"]), "[init] Minimal application by default; explicit http/command/edge recipes"),
     name: optional(String2(), "[init/generate] Project or object name"),
@@ -198585,7 +198661,7 @@ function registerRemoteDevTools(server2, options = {}) {
 // package.json
 var package_default = {
   name: "@supacloud/cli",
-  version: "0.78.0",
+  version: "0.79.0",
   description: "Project-scoped CLI for SupaCloud users",
   type: "module",
   main: "./dist/index.js",
@@ -198637,14 +198713,14 @@ var package_default = {
   },
   dependencies: {
     "@supacloud/compiler": "^0.43.0",
-    "@supacloud/delivery": "0.8.0",
+    "@supacloud/delivery": "0.9.0",
     "@supacloud/db": "0.16.0",
     fflate: "^0.8.3",
     typebox: "1.3.34"
   },
   overrides: {
     "@supacloud/contracts": "0.8.0",
-    "@supacloud/delivery": "0.8.0",
+    "@supacloud/delivery": "0.9.0",
     "@graphql-tools/utils": "^12.0.3"
   },
   devDependencies: {

package/dist/shared/tools/app-tools.d.ts

@@ -5,7 +5,8 @@ declare const REMOTE_APP_ACTIONS: {
     readonly configure: "put_configuration";
     readonly deploy: "activate_release";
     readonly status: "get_runtime";
-    readonly rollback: "activate_release";
+    readonly rollback: "rollback_release";
+    readonly "rollback-plan": "get_rollback_snapshot";
     readonly reconcile: "reconcile_activation";
     readonly retire: "retire_activation";
     readonly logs: "logs";

package/dist/shared/tools/application-activation-http-status.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/tools/application-schemas.d.ts

@@ -73,3 +73,19 @@ export declare const ApplicationActivationRetirementResultSchema: import("typebo
     activation_id: import("typebox").TString;
     retired_at: import("typebox").TString;
 }>;
+export declare const ApplicationRollbackSnapshotSchema: import("typebox").TObject<{
+    schema: import("typebox").TLiteral<"supacloud.application-rollback-snapshot.v1">;
+    project_ref: import("typebox").TString;
+    application_id: import("typebox").TString;
+    environment_id: import("typebox").TString;
+    active: import("typebox").TUnion<[import("typebox").TObject<{
+        release_id: import("typebox").TString;
+        configuration_id: import("typebox").TString;
+        activation_id: import("typebox").TString;
+    }>, import("typebox").TNull]>;
+    previous: import("typebox").TUnion<[import("typebox").TObject<{
+        release_id: import("typebox").TString;
+        configuration_id: import("typebox").TString;
+        activation_id: import("typebox").TString;
+    }>, import("typebox").TNull]>;
+}>;

package/dist/shared/tools/application-tools.d.ts

@@ -9,7 +9,7 @@ export declare const APPLICATION_TOOL_SCHEMA: {
     ttl_seconds: Type.TOptional<Type.TInteger>;
     wait: Type.TOptional<Type.TBoolean>;
     timeout_seconds: Type.TOptional<Type.TInteger>;
-    action: Type.TEnum<("list_releases" | "get_release" | "upload_release" | "activate_release" | "logs" | "get_runtime" | "get_deployment_evidence" | "get_configuration" | "get_preview_plan" | "put_configuration" | "reconcile_activation" | "retire_activation" | "create_preview" | "list_previews" | "get_preview" | "cleanup_preview")[]>;
+    action: Type.TEnum<("list_releases" | "get_release" | "upload_release" | "activate_release" | "logs" | "get_runtime" | "get_deployment_evidence" | "get_configuration" | "get_rollback_snapshot" | "get_preview_plan" | "put_configuration" | "rollback_release" | "reconcile_activation" | "retire_activation" | "create_preview" | "list_previews" | "get_preview" | "cleanup_preview")[]>;
     ref: Type.TString;
     id: Type.TString;
     environment_id: Type.TOptional<Type.TString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,14 +52,14 @@
   },
   "dependencies": {
     "@supacloud/compiler": "^0.43.0",
-    "@supacloud/delivery": "0.8.0",
+    "@supacloud/delivery": "0.9.0",
     "@supacloud/db": "0.16.0",
     "fflate": "^0.8.3",
     "typebox": "1.3.34"
   },
   "overrides": {
     "@supacloud/contracts": "0.8.0",
-    "@supacloud/delivery": "0.8.0",
+    "@supacloud/delivery": "0.9.0",
     "@graphql-tools/utils": "^12.0.3"
   },
   "devDependencies": {