@revturbine/cli 0.6.0 → 0.7.1

package/dist/cli.js

@@ -6671,26 +6671,53 @@ program.command("history").description("The Release Version Log: recent Releases
     )
   );
 });
-program.command("preview").description("The open draft's staged changes (runtime-impact summary once plan 78 lands).").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 (default shape is already JSON)").action(async (opts) => {
+program.command("preview").description("The open draft's Runtime Impact summary (objects affected, billing impact) + field-level changes.").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);
   const playbookVersionId = await requireOpenDraft(conn);
-  const { res, json } = await getJson(conn, `/api/playbook-versions/${playbookVersionId}/preview`);
+  const { res, json } = await getJson(conn, `/api/optimization/drafts/${playbookVersionId}/changes`);
   if (!res.ok) httpFail(conn, "preview", res.status, json);
-  emit(json, true);
+  const impact = json?.impact ?? {};
+  const changes = Array.isArray(json?.changes) ? json.changes : [];
+  const data = { playbook_version_id: playbookVersionId, impact, changes };
+  const billingObjects = impact.billing?.objects ?? [];
+  const text = [
+    `Runtime impact (draft ${playbookVersionId}):`,
+    table((impact.byCategory ?? []).map((c) => [c.label, `${c.count}`])),
+    `Billing impact: ${billingObjects.length === 0 ? "(none)" : billingObjects.join(", ")}`,
+    `Changes (${changes.length}):`,
+    table(changes.map((c) => [String(c.action ?? ""), String(c.objectType ?? ""), String(c.objectName ?? ""), String(c.summary ?? "")]))
+  ].join("\n");
+  emit(data, Boolean(opts.json), text);
 });
-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 +6749,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.1",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {