@revturbine/cli 0.11.0 → 0.13.0

package/dist/cli.js

@@ -9041,13 +9041,21 @@ function formatDiff(diff) {
   return lines.join("\n");
 }
 
+// src/lib/prune.ts
+function pruneQuery(prune) {
+  if (prune === false) return "?prune=false";
+  if (prune === true) return "?prune=force";
+  return "";
+}
+
 // src/lib/config-validate.ts
 var BLOCKING_SEVERITIES = /* @__PURE__ */ new Set(["error_draft", "error_launch"]);
-function isBlockingFinding(finding2) {
+function isBlockingFinding(finding2, force = false) {
+  if (force && finding2.severity === "error_launch") return false;
   return BLOCKING_SEVERITIES.has(finding2.severity);
 }
-function hasBlockingFindings(findings) {
-  return findings.some(isBlockingFinding);
+function hasBlockingFindings(findings, force = false) {
+  return findings.some((f) => isBlockingFinding(f, force));
 }
 function formatFindings(findings) {
   if (findings.length === 0) return "No validation findings.";
@@ -9387,25 +9395,30 @@ var STARTER_PLAYBOOK = {
   tenant_id: "local",
   environment_id: "local",
   plans: [
-    { id: "plan_free", unique_handle: "free", name: "Free", tier_position: 0, sort_order: 0 },
-    { id: "plan_pro", unique_handle: "pro", name: "Pro", tier_position: 1, sort_order: 1 }
+    { unique_handle: "free", name: "Free", tier_position: 0, sort_order: 0 },
+    { unique_handle: "pro", name: "Pro", tier_position: 1, sort_order: 1 }
   ],
   entitlements: [
-    { id: "ent_advanced_export", unique_handle: "advanced_export", name: "Advanced Export", type: "feature" }
+    { unique_handle: "advanced_export", name: "Advanced Export", type: "feature" }
   ],
+  // Rules reference entities by their HANDLE, never a synthetic id: the import
+  // stores these references verbatim and the runtime resolves them by handle
+  // (entitlement-check.ts matches rule.entitlement_id / plan targets against
+  // unique_handle). Authoring `ent_*` / `plan_*` ids here would produce rules
+  // that never link — the exact bug the plan-154 dogfood surfaced.
   entitlement_rules: [
     {
       id: "er_advanced_export_free",
-      entitlement_id: "ent_advanced_export",
-      targets: [{ kind: "plan", id: "plan_free" }],
+      entitlement_id: "advanced_export",
+      targets: [{ kind: "plan", id: "free" }],
       segment_ids: [],
       enabled: false,
       current_usage: 0
     },
     {
       id: "er_advanced_export_pro",
-      entitlement_id: "ent_advanced_export",
-      targets: [{ kind: "plan", id: "plan_pro" }],
+      entitlement_id: "advanced_export",
+      targets: [{ kind: "plan", id: "pro" }],
       segment_ids: [],
       enabled: true,
       current_usage: 0
@@ -9733,17 +9746,22 @@ async function loadVersion(conn, sel) {
       return downloadConfig(conn, await requireOpenDraft(conn));
   }
 }
-async function launchDraft(conn, playbookVersionId) {
+async function launchDraft(conn, playbookVersionId, force = false) {
   diag(`Launch gate: validating draft ${playbookVersionId} \u2026`);
   const validation = await fetchValidation(conn.url, playbookVersionId, conn.headers);
   if (!validation.ok) httpFail(conn, "validate", validation.status, validation.error);
   if (validation.findings.length > 0) diagRaw(formatFindings(validation.findings));
-  if (hasBlockingFindings(validation.findings)) {
+  if (hasBlockingFindings(validation.findings, force)) {
     fail(EXIT.VALIDATION, "blocking findings \u2014 this draft cannot launch.");
   }
+  const overridden = force ? validation.findings.filter((f) => f.severity === "error_launch") : [];
+  if (overridden.length > 0) {
+    diag(`--force: overriding ${overridden.length} launch-gate finding(s) (error_launch).`);
+  }
   diag(`Launching playbook version ${playbookVersionId} (submit \u2192 approve \u2192 deploy) \u2026`);
   for (const step of ["submit", "approve", "deploy"]) {
-    const { res, json } = await postJson(conn, `/api/playbook-versions/${playbookVersionId}/${step}`, {});
+    const body = step === "deploy" ? { force } : {};
+    const { res, json } = await postJson(conn, `/api/playbook-versions/${playbookVersionId}/${step}`, body);
     if (!res.ok) {
       diag(`\u2717 ${step} failed (${res.status}). The draft is staged but NOT live.`);
       diagRaw(`  ${JSON.stringify(json)}`);
@@ -10266,12 +10284,14 @@ program.command("show").description(`Render a summary view of a config version.
     emit(data, Boolean(opts.json), text);
   }
 );
-program.command("upload").description("Stage a Config File as the open draft (POST /api/config/import).").argument("<config>", "Path to a Config File").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (configFile2, opts) => {
+var PRUNE_OPTION = ["--prune", "Confirm a convergent delete past the mass-deletion guard (removes entities absent from the file)"];
+var NO_PRUNE_OPTION = ["--no-prune", "Additive import \u2014 keep entities that are absent from the file (disables convergent delete)"];
+program.command("upload").description("Stage a Config File as the open draft (POST /api/config/import).").argument("<config>", "Path to a Config File").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option(...PRUNE_OPTION).option(...NO_PRUNE_OPTION).action(async (configFile2, opts) => {
   const config = verifyConfig(configFile2);
   if (config === null) fail(EXIT.VALIDATION, `Fix the issues above in ${configFile2}, then re-run.`);
   const conn = connect(opts.url, uploadTenantFor(opts.url, config, opts.tenantId));
   diag(`Staging ${configFile2} as the open draft (${conn.url}/api/config/import) \u2026`);
-  const { res, json } = await postJson(conn, "/api/config/import", config);
+  const { res, json } = await postJson(conn, `/api/config/import${pruneQuery(opts.prune)}`, config);
   if (!res.ok) {
     if (json && typeof json === "object" && json.stage) {
       diagRaw(`  stage:  ${json.stage}`);
@@ -10287,7 +10307,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/restore; 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("--force", "Launch past incomplete-but-valid findings (error_launch); structural errors (error_draft) still block").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").option(...PRUNE_OPTION).option(...NO_PRUNE_OPTION).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" });
   let conn;
   let playbookVersionId;
@@ -10296,7 +10316,7 @@ program.command("launch").description("Take a config live as a new Release: vali
     if (config === null) fail(EXIT.VALIDATION, `Fix the issues above in ${sel.path}, then re-run.`);
     conn = connect(opts.url, uploadTenantFor(opts.url, config, opts.tenantId));
     diag(`Staging ${sel.path} as the open draft \u2026`);
-    const { res, json } = await postJson(conn, "/api/config/import", config);
+    const { res, json } = await postJson(conn, `/api/config/import${pruneQuery(opts.prune)}`, config);
     if (!res.ok) {
       diagRaw(`  ${JSON.stringify(json)}`);
       httpFail(conn, "upload", res.status);
@@ -10308,7 +10328,7 @@ program.command("launch").description("Take a config live as a new Release: vali
     conn = connect(opts.url, opts.tenantId);
     playbookVersionId = await requireOpenDraft(conn);
   }
-  await launchDraft(conn, playbookVersionId);
+  await launchDraft(conn, playbookVersionId, !!opts.force);
 });
 program.command("discard").description("Discard (archive) the open draft so a fresh one can start.").argument("[playbook-version-id]", "A specific draft id (default: the open draft)").option("--draft", "The open draft (explicit form of the default)").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 (id, opts) => {
   const conn = connect(opts.url, opts.tenantId);
@@ -10318,7 +10338,7 @@ 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("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) => {
+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("--force", "With --launch, launch past incomplete-but-valid findings (error_launch); error_draft still blocks").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(
     `Restore playbook version ${playbookVersionId} on ${conn.url}?${opts.launch ? " --launch will take it LIVE." : " (stages a draft; launch separately)"}`,
@@ -10333,7 +10353,7 @@ program.command("restore").description("Stage a draft that restores a past relea
     return;
   }
   if (!reverting) fail(EXIT.SERVER, "No reverting draft id returned \u2014 cannot launch.");
-  await launchDraft(conn, reverting);
+  await launchDraft(conn, reverting, !!opts.force);
 });
 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.11.0",
+  "version": "0.13.0",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {