@revturbine/cli 0.12.0 → 0.13.1

package/dist/cli.js

@@ -9032,7 +9032,7 @@ function formatDiff(diff) {
     const parts = [];
     if (d.added.length) parts.push(`+${d.added.length} added`);
     if (d.changed.length) parts.push(`~${d.changed.length} changed`);
-    if (d.removed.length) parts.push(`-${d.removed.length} only in tenant (import never deletes)`);
+    if (d.removed.length) parts.push(`-${d.removed.length} only in tenant (pruned on launch unless --no-prune)`);
     lines.push(`  ${coll}: ${parts.join(", ")}`);
     for (const k of d.added) lines.push(`    + ${k}`);
     for (const k of d.changed) lines.push(`    ~ ${k}`);
@@ -9395,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
@@ -10409,7 +10414,7 @@ program.command("preview").description("The open draft's Runtime Impact summary
   ].join("\n");
   emit(data, Boolean(opts.json), text);
 });
-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(
+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 surface slot (the getPlacement decision for that slot)").option("--surface-type <type>", "Disambiguate a slot that can render more than one surface (with --slot), or resolve by surface type alone").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);
@@ -10422,13 +10427,18 @@ program.command("evaluate").description("Run placement/entitlement decisions for
     }
     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).");
+    const wantsSlot = Boolean(opts.slot || opts.surfaceType);
+    if (opts.entitlement && wantsSlot) {
+      fail(EXIT.USAGE, "pass exactly one of --entitlement or --slot/--surface-type (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];
+    if (wantsSlot) {
+      if (opts.slot) body.slot_id = opts.slot;
+      if (opts.surfaceType) body.surface_type = opts.surfaceType;
+      body.placement_ids = [];
       body.entitlement_handles = [];
     }
     if (sel.kind === "release") body.playbook_version_id = sel.id;

package/package.json

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