@revturbine/cli 0.6.0 → 0.7.0

package/dist/cli.js

@@ -6678,19 +6678,35 @@ program.command("preview").description("The open draft's staged changes (runtime
   if (!res.ok) httpFail(conn, "preview", res.status, json);
   emit(json, true);
 });
-program.command("evaluate").description("Run the live config's placement/entitlement decisions for a user context (from a JSON file). Draft/Release-targeted evaluation lands with plan 131 TASK-7.").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).requiredOption("--user <file>", "JSON file: { user_id, customer_id?, plan_handle?, placement_ids?, entitlement_handles?, traits?, now_iso? }").option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (opts) => {
-  const conn = connect(opts.url, opts.tenantId);
-  if (!existsSync2(opts.user)) fail(EXIT.USAGE, `user file not found: ${opts.user}`);
-  let body;
-  try {
-    body = JSON.parse(readFileSync2(opts.user, "utf8"));
-  } catch (err) {
-    fail(EXIT.VALIDATION, `invalid JSON in ${opts.user}: ${err.message}`);
+program.command("evaluate").description("Run placement/entitlement decisions for a user context against a config version. Requires --live, --draft, or --release <id>.").option("--live", "Evaluate the live configuration").option("--draft", "Evaluate the tenant's open draft (clean-room: no suppression/cap history)").option("--release <id>", "Evaluate a past release (from its frozen snapshot)").option("--entitlement <handle>", "Check one entitlement (the checkEntitlement result)").option("--slot <id>", "Evaluate one placement/slot (the getPlacement decision)").option("--plan-handle <handle>", "Evaluate as if the user were on this plan (overrides the ctx file)").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).requiredOption("--user <file>", "JSON file: { user_id, customer_id?, plan_handle?, traits?, now_iso? }").option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(
+  async (opts) => {
+    const [sel] = requireSelectors(opts, [], { count: 1, allowed: ["draft", "live", "release"], command: "evaluate" });
+    const conn = connect(opts.url, opts.tenantId);
+    if (!existsSync2(opts.user)) fail(EXIT.USAGE, `user file not found: ${opts.user}`);
+    let ctx;
+    try {
+      ctx = JSON.parse(readFileSync2(opts.user, "utf8"));
+    } catch (err) {
+      fail(EXIT.VALIDATION, `invalid JSON in ${opts.user}: ${err.message}`);
+    }
+    const body = { ...ctx };
+    if (opts.planHandle) body.plan_handle = opts.planHandle;
+    if (opts.entitlement && opts.slot) fail(EXIT.USAGE, "pass exactly one of --entitlement or --slot (or neither for the ctx file lists).");
+    if (opts.entitlement) {
+      body.entitlement_handles = [opts.entitlement];
+      body.placement_ids = [];
+    }
+    if (opts.slot) {
+      body.placement_ids = [opts.slot];
+      body.entitlement_handles = [];
+    }
+    if (sel.kind === "release") body.playbook_version_id = sel.id;
+    if (sel.kind === "draft") body.playbook_version_id = await requireOpenDraft(conn);
+    const { res, json } = await postJson(conn, "/api/sdk/evaluate", body);
+    if (!res.ok) httpFail(conn, "evaluate", res.status, json);
+    emit(json, true);
   }
-  const { res, json } = await postJson(conn, "/api/sdk/evaluate", body);
-  if (!res.ok) httpFail(conn, "evaluate", res.status, json);
-  emit(json, true);
-});
+);
 var COMMAND_EXAMPLES = {
   download: [
     "",
@@ -6722,7 +6738,8 @@ var COMMAND_EXAMPLES = {
   evaluate: [
     "",
     "Example:",
-    "  revturbine evaluate --url <url> --user ./ctx.json",
+    "  revturbine evaluate --live --user ./ctx.json --entitlement seats",
+    "  revturbine evaluate --draft --user ./ctx.json --slot upgrade_banner --plan-handle pro",
     '    ctx.json: { "user_id": "u1", "plan_handle": "pro", "entitlement_handles": ["seats"] }'
   ].join("\n")
 };

package/package.json

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