@revturbine/cli 0.4.0 → 0.5.0

package/README.md

@@ -63,7 +63,7 @@ Commands that read a config name the version explicitly — there is no default:
 | `upload` | Stage a Config File as the open draft. |
 | `launch` | Take a config live: validate (launch gate) → submit → approve → deploy. `launch <file>` or `launch --draft`. |
 | `discard` | Archive the open draft (`--yes`). |
-| `rollback` | Revert a deployed playbook version (creates a reverting draft; becomes `restore` once server-side entry copying lands). |
+| `restore` | Stage a draft that restores a past release from its frozen snapshot; `--launch` takes it live. Halts if a draft is open. |
 | `status` | The live Release and the open draft, side by side. |
 | `history` | The Release Version Log, newest first. |
 | `preview` | The open draft's staged changes. |

package/dist/cli.js

@@ -5890,7 +5890,7 @@ Command groups:
   Auth & meta   login, logout, signup, whoami, schema, docs
   Download      download
   Check         validate, diff, show
-  Stage/launch  upload, launch, discard, rollback
+  Stage/launch  upload, launch, discard, restore
   Inspect       status, history, preview, evaluate
 
 Version selectors (no defaults \u2014 a command that reads a config requires one):
@@ -5916,7 +5916,7 @@ Common workflows:
   # Inspect and roll back
   revturbine status
   revturbine history
-  revturbine rollback <playbook-version-id>
+  revturbine restore <playbook-version-id> --launch
 
 Exit-code classes: 0 ok \xB7 1 unexpected \xB7 2 usage \xB7 3 auth \xB7 4 validation
 blocked \xB7 5 conflict/stale \xB7 6 network \xB7 7 server error.
@@ -5924,7 +5924,7 @@ blocked \xB7 5 conflict/stale \xB7 6 network \xB7 7 server error.
 Auth:
   Most commands need a token \u2014 run \`login\` first. Credentials live at
   ~/.revturbine/credentials.json (0600); the token's tenant is used by default,
-  override with -t/--tenant-id. Mutating commands (discard, rollback) prompt
+  override with -t/--tenant-id. Mutating commands (discard, restore) prompt
   for confirmation unless --yes.
 
 Full reference: ${DOCS_URL}
@@ -6172,7 +6172,7 @@ program.command("upload").description("Stage a Config File as the open draft (PO
   if (playbookVersionId) diagRaw(`  playbook_version_id: ${playbookVersionId}`);
   diag("Launch it with `revturbine launch --draft`, or from the UI (Drafts & Releases).");
 });
-program.command("launch").description("Take a config live as a new Release: validate (launch gate), then submit \u2192 approve \u2192 deploy. Synchronous.").argument("[file]", "Config File to upload and launch directly").option("--draft", "Launch the already-open draft").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option("--yes", "Accepted for parity with discard/rollback; launch has no confirmation prompt").action(async (file, opts) => {
+program.command("launch").description("Take a config live as a new Release: validate (launch gate), then submit \u2192 approve \u2192 deploy. Synchronous.").argument("[file]", "Config File to upload and launch directly").option("--draft", "Launch the already-open draft").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option("--yes", "Accepted for parity with discard/restore; launch has no confirmation prompt").action(async (file, opts) => {
   const [sel] = requireSelectors(opts, file ? [file] : [], { count: 1, allowed: ["file", "draft"], command: "launch" });
   const conn = connect(opts.url, opts.tenantId);
   let playbookVersionId;
@@ -6201,17 +6201,22 @@ program.command("discard").description("Discard (archive) the open draft so a fr
   if (!res.ok) httpFail(conn, "discard", res.status, json);
   diag(`\u2713 Discarded draft ${playbookVersionId}.`);
 });
-program.command("rollback").description("Roll back a deployed playbook version (creates a reverting draft). Becomes `restore <release>` once server-side entry copying lands (plan 131 TASK-6).").argument("<playbook-version-id>", "The deployed playbook_version_id to revert").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option("--yes", "Skip the confirmation prompt").action(async (playbookVersionId, opts) => {
+program.command("restore").description("Stage a draft that restores a past release (from its frozen snapshot); `--launch` takes it live. Halts if a draft is already open.").argument("<playbook-version-id>", "The deployed playbook version to restore (see `history`)").option("--launch", "Launch the restoring draft immediately (gate + submit \u2192 approve \u2192 deploy)").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option("--yes", "Skip the confirmation prompt").action(async (playbookVersionId, opts) => {
   const conn = connect(opts.url, opts.tenantId);
   await confirmOrExit(
-    `Roll back playbook version ${playbookVersionId} on ${conn.url}? This changes the LIVE configuration.`,
+    `Restore playbook version ${playbookVersionId} on ${conn.url}?${opts.launch ? " --launch will take it LIVE." : " (stages a draft; launch separately)"}`,
     !!opts.yes
   );
   const { res, json } = await postJson(conn, `/api/playbook-versions/${playbookVersionId}/rollback`, {});
-  if (!res.ok) httpFail(conn, "rollback", res.status, json);
-  diag(`\u2713 Rollback requested for playbook version ${playbookVersionId}.`);
+  if (!res.ok) httpFail(conn, "restore", res.status, json);
   const reverting = json?.item?.id ?? json?.playbook_version_id;
-  if (reverting) diagRaw(`  reverting draft: ${reverting}`);
+  diag(`\u2713 Staged a restoring draft from ${playbookVersionId}${reverting ? ` (${reverting})` : ""}.`);
+  if (!opts.launch) {
+    diag("Launch it with `revturbine launch --draft`, or discard it with `revturbine discard --yes`.");
+    return;
+  }
+  if (!reverting) fail(EXIT.SERVER, "No reverting draft id returned \u2014 cannot launch.");
+  await launchDraft(conn, reverting);
 });
 program.command("status").description("The current live Release and the open draft, side by side.").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option("--json", "Machine-readable output").action(async (opts) => {
   const conn = connect(opts.url, opts.tenantId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {