@revturbine/cli 0.21.1 → 0.21.2

package/dist/cli.js

@@ -2284,10 +2284,20 @@ var DEFAULT_TEMPLATE_COMPONENT_TYPES = {
   agent_connector: "agent",
   custom_in_app: "custom"
 };
+var LEGACY_TEMPLATE_ALIASES = Object.freeze({
+  plans_pricing_ctas: "plans_page_ctas",
+  plans_pricing_full: "plans_page_full",
+  credit_balance_counter: "credit_counter",
+  banner_placement: "banner",
+  modal_overlay: "modal_optional",
+  toast_message: "toast",
+  push_notification: "push"
+});
 var BUILT_IN_TEMPLATE_COMPONENT_TYPES = Object.freeze({
   ...DEFAULT_TEMPLATE_COMPONENT_TYPES,
-  modal_overlay: "modal",
-  banner_placement: "banner",
+  ...Object.fromEntries(
+    Object.entries(LEGACY_TEMPLATE_ALIASES).map(([legacy, id11]) => [legacy, DEFAULT_TEMPLATE_COMPONENT_TYPES[id11]])
+  ),
   full_page: "full_page"
 });
 var ENTITLEMENT_STATUS_VALUES = ["allowed", "limited", "denied"];
@@ -21713,9 +21723,9 @@ var SimulationRunReceiptSchema = z68.strictObject({
 
 // src/schema/validators.snapshot.mjs
 import { z as z69 } from "zod";
-import { z as z92 } from "zod";
 import { z as z310 } from "zod";
 import { z as z210 } from "zod";
+import { z as z92 } from "zod";
 import { z as z410 } from "zod";
 import { z as z610 } from "zod";
 import { z as z510 } from "zod";
@@ -21897,6 +21907,15 @@ var CATALOG = {
     message: "This payload names a placement that does not exist.",
     specRef: "config-validation.md \xA75.9 (BL-0180, D-31)"
   },
+  // payload surface → template (BUG-1345): a template id that is neither
+  // built-in (incl. legacy aliases) nor authored in `surface_templates` has no
+  // rendering type, so every SDK skips that payload at load.
+  "VAL-PLC-11": {
+    id: "VAL-PLC-11",
+    severity: "error_launch",
+    message: "This payload uses a surface template that does not exist.",
+    specRef: "config-validation.md \xA75.2 (BUG-1345)"
+  },
   "VAL-PLN-08": {
     id: "VAL-PLN-08",
     severity: "error_launch",
@@ -21978,193 +21997,465 @@ function categoryBucket(category) {
   if (normalized.includes("retention") || normalized.includes("winback") || normalized.includes("churn")) return 4;
   return 99;
 }
-function hasCreditResetPeriod2(fields) {
-  return fields.reset_period !== void 0 && fields.reset_period !== null;
-}
-function allowancePeriod2(kind, fields, billingPeriod) {
-  if (kind === "seat") return "seat";
-  const raw = kind === "credits" ? fields.reset_period : fields.period_scope;
-  if (raw === "billing_period" || raw === "per_billing_period") {
-    if (billingPeriod === "monthly") return "month";
-    if (billingPeriod === "annual") return "year";
-    return void 0;
+var HANDLE_PATTERN2 = /^[a-z0-9._]{1,100}$/;
+var SchemaPersistence2 = {
+  Persisted: "persisted",
+  Transient: "transient"
+};
+var SchemaExposure2 = {
+  Internal: "internal",
+  External: "external"
+};
+var DataClassification2 = {
+  Pii: { "x-revturbine-data-classification": "pii" },
+  Financial: { "x-revturbine-data-classification": "financial" },
+  Unrestricted: { "x-revturbine-data-classification": "unrestricted" },
+  /**
+   * Machine-generated evaluation exhaust — supersession records, entitlement
+   * grants, placement decision traces. Carries no personal or financial data
+   * itself, but describes what the engine decided about a user, so it is not
+   * `Unrestricted` either. Applied at the MODEL level (plan 182 REQ-7); it was
+   * already in use as a raw string literal on four schemas before being
+   * declared here, which left `DataClassificationValue` unable to represent it.
+   */
+  Operational: { "x-revturbine-data-classification": "operational" }
+};
+var SCHEMA_EXPOSURE_META_KEY2 = "x-revturbine-schema-exposure";
+var READ_ONLY_META_KEY2 = "readOnly";
+var DECISION_ONLY_META_KEY2 = "x-revturbine-decision-only";
+var DecisionOnly2 = { [DECISION_ONLY_META_KEY2]: true };
+var ClientSafe2 = { [SCHEMA_EXPOSURE_META_KEY2]: SchemaExposure2.External };
+var ServerOnly2 = { [SCHEMA_EXPOSURE_META_KEY2]: SchemaExposure2.Internal };
+function toWritableSchema2(schema) {
+  const writableShape = {};
+  for (const [fieldName, fieldSchema] of Object.entries(schema.shape)) {
+    if (typeof fieldSchema !== "object" || fieldSchema === null) {
+      continue;
+    }
+    const isReadOnly = fieldSchema.meta()?.[READ_ONLY_META_KEY2] === true;
+    if (!isReadOnly) {
+      writableShape[fieldName] = fieldSchema;
+    }
   }
-  if (typeof raw !== "string" || raw === "") return void 0;
-  if (raw === "per_6_hours" || raw === "six_hours") return "six_hours";
-  return raw.startsWith("per_") ? raw.slice(4) : raw;
+  return z210.object(writableShape);
 }
-function assertCompatibleAllowances2(a, b, aBillingPeriod, bBillingPeriod) {
-  const aPeriod = allowancePeriod2(a.kind, a.fields, aBillingPeriod);
-  const bPeriod = allowancePeriod2(b.kind, b.fields, bBillingPeriod);
-  if (a.kind !== b.kind || aPeriod === void 0 || aPeriod !== bPeriod || (a.fields.allocation ?? "account") !== (b.fields.allocation ?? "account") || (a.fields.instance ?? "") !== (b.fields.instance ?? "") || (a.fields.seat_type_id ?? "") !== (b.fields.seat_type_id ?? "")) {
-    throw new Error(`Incompatible purchased allowances: ${a.ruleId} and ${b.ruleId} require matching periods and scopes`);
+function toCreateSchema2(schema) {
+  const writable = toWritableSchema2(schema);
+  const handleField = writable.shape["handle"];
+  if (handleField && typeof handleField.regex === "function") {
+    return writable.extend({ handle: handleField.regex(HANDLE_PATTERN2) });
   }
+  return writable;
 }
-var HANDLE_PATTERN2 = /^[a-z0-9._]{1,100}$/;
-var BUILTIN_SEGMENT_HANDLE_PREFIX2 = "rt.";
-var BUILTIN_TRAIT_KEY_PREFIX2 = "rt_";
-var MAX_HANDLE_LENGTH = 100;
-function dimension2(key4, name, legacyAbbr, values, opts = {}) {
-  const legacyPrefix = `seg:${legacyAbbr}:`;
-  return {
-    key: key4,
-    name,
-    traitKey: `${BUILTIN_TRAIT_KEY_PREFIX2}${key4}`,
-    dimensionId: `${BUILTIN_SEGMENT_HANDLE_PREFIX2}${key4}`,
-    vocabulary: opts.vocabulary ?? "closed",
-    values: values.map(([value, valueName, legacyValue]) => ({
-      value,
-      name: valueName,
-      legacyPickerId: `${legacyPrefix}${legacyValue ?? value}`
-    })),
-    ...opts.fallback !== void 0 ? { fallback: opts.fallback } : {},
-    legacyPrefix
-  };
-}
-var BUILTIN_DIMENSIONS2 = [
-  dimension2("registration_state", "Registration State", "reg", [
-    ["unregistered", "Unregistered"],
-    ["registered", "Registered"]
-  ]),
-  dimension2(
-    "activity_level",
-    "Activity State",
-    "act",
-    [
-      ["new", "New"],
-      ["high", "High Activity"],
-      ["medium", "Medium Activity"],
-      ["low", "Low Activity"],
-      ["inactive", "Inactive"]
-    ],
-    { fallback: "new" }
-  ),
-  dimension2(
-    "subscription_state",
-    "Subscription State",
-    "sub",
-    [
-      ["none", "None"],
-      ["trial", "Trial"],
-      ["paid", "Paid"],
-      ["cancelled", "Cancelled"]
-    ],
-    { fallback: "none" }
-  ),
-  dimension2(
-    "trial_type",
-    "Trial Type",
-    "trial",
-    [
-      ["none", "Not in trial"],
-      ["free_trial", "Free trial", "free"],
-      ["reverse_trial", "Reverse trial", "reverse"]
-    ],
-    { fallback: "none" }
-  ),
-  dimension2("seat_type", "Seat Type", "seat", [], { vocabulary: "seat_type" }),
-  dimension2("buyer_role", "Buyer Role", "role", [
-    ["buyer", "Buyer"],
-    ["non_buyer", "Non-buyer"]
-  ]),
-  dimension2(
-    "email_type",
-    "Email Type",
-    "email",
-    [
-      ["business", "Business email"],
-      ["personal", "Personal email"],
-      ["unknown", "Unknown"]
-    ],
-    { fallback: "unknown" }
-  ),
-  dimension2(
-    "billing_health",
-    "Billing Health",
-    "bill",
-    [
-      ["no_billing", "No billing", "none"],
-      ["good_standing", "Good standing", "good"],
-      ["trial_payment_method_attached", "Trial \u2014 payment method attached", "trial_pm"],
-      ["payment_method_missing", "Payment method missing", "pm_missing"],
-      ["payment_failed", "Payment failed", "failed"],
-      ["payment_overdue", "Payment overdue", "overdue"],
-      ["cancelled", "Cancelled"]
-    ],
-    { fallback: "no_billing" }
-  ),
-  dimension2("region", "Country / Region", "geo", [
-    ["us_canada", "US / Canada"],
-    ["europe", "Europe"],
-    ["rest_of_world", "Rest of World", "row"]
-  ]),
-  dimension2(
-    "device_type",
-    "Device Type",
-    "dev",
-    [
-      ["desktop", "Desktop"],
-      ["mobile", "Mobile"],
-      ["tablet", "Tablet"],
-      ["unknown", "Unknown"]
-    ],
-    { fallback: "unknown" }
-  )
-];
-var BY_KEY2 = new Map(
-  BUILTIN_DIMENSIONS2.map((d) => [d.key, d])
+var { Unrestricted: Unrestricted39 } = DataClassification2;
+var { Transient: Transient32, Persisted: Persisted24 } = SchemaPersistence2;
+var { Internal: Internal29, External: External15 } = SchemaExposure2;
+var PaginationParamsSchema2 = z310.object({
+  page: z310.coerce.number().int().min(1).default(1).meta(Unrestricted39),
+  per_page: z310.coerce.number().int().min(1).max(100).default(25).meta(Unrestricted39)
+}).meta(
+  {
+    id: "PaginationParams",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
 );
-function isBuiltinDimensionKey(key4) {
-  return BY_KEY2.has(key4);
-}
-function getBuiltinDimension(key4) {
-  const found = BY_KEY2.get(key4);
-  if (!found) throw new Error(`Unknown built-in dimension '${key4}'`);
-  return found;
-}
-function builtinSegmentHandle2(key4, value) {
-  return `${BUILTIN_SEGMENT_HANDLE_PREFIX2}${key4}.${value}`;
-}
-function isReservedSegmentHandle(handle) {
-  return handle.startsWith(BUILTIN_SEGMENT_HANDLE_PREFIX2);
-}
-function isBuiltinDimensionValue(key4, value) {
-  const dim = getBuiltinDimension(key4);
-  if (dim.vocabulary === "closed") return dim.values.some((v) => v.value === value);
-  return HANDLE_PATTERN2.test(value) && builtinSegmentHandle2(key4, value).length <= MAX_HANDLE_LENGTH;
-}
-function parseBuiltinSegmentHandle(handle) {
-  if (!isReservedSegmentHandle(handle)) return void 0;
-  const rest = handle.slice(BUILTIN_SEGMENT_HANDLE_PREFIX2.length);
-  const dot = rest.indexOf(".");
-  if (dot <= 0) return void 0;
-  const key4 = rest.slice(0, dot);
-  const value = rest.slice(dot + 1);
-  if (!isBuiltinDimensionKey(key4) || !isBuiltinDimensionValue(key4, value)) return void 0;
-  return { key: key4, value };
-}
-function isGeneratedBuiltinSegment(segment) {
-  if (typeof segment.handle !== "string") return false;
-  const parsed = parseBuiltinSegmentHandle(segment.handle);
-  if (!parsed) return false;
-  const dim = getBuiltinDimension(parsed.key);
-  if (segment.dimension_id !== dim.dimensionId) return false;
-  if (segment.experiment_handle !== void 0 && segment.experiment_handle !== null) return false;
-  const predicates = segment.predicates;
-  if (!Array.isArray(predicates) || predicates.length !== 1) return false;
-  const [p] = predicates;
-  if (!p || typeof p !== "object") return false;
-  const { field: field2, operator, value } = p;
-  return field2 === dim.traitKey && operator === "eq" && value === parsed.value;
-}
-var LEGACY_BY_ID2 = new Map(
-  BUILTIN_DIMENSIONS2.flatMap(
-    (d) => d.values.map((v) => [v.legacyPickerId, builtinSegmentHandle2(d.key, v.value)])
-  )
+var TimestampFields2 = z310.object({
+  created_at: z310.string().datetime().meta({ ...Unrestricted39, readOnly: true }),
+  updated_at: z310.string().datetime().meta({ ...Unrestricted39, readOnly: true })
+}).meta(
+  {
+    id: "null",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
 );
-function identity2(row) {
-  return String(row.unique_handle ?? row.handle ?? row.id ?? "");
-}
+var IdField2 = z310.object({
+  id: z310.string().min(1).meta({ ...Unrestricted39, readOnly: true })
+}).meta(
+  {
+    id: "null",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
+);
+var TenantIdField2 = z310.object({
+  tenant_id: z310.string().min(1, "tenant_id is required").meta({ ...Unrestricted39, readOnly: true })
+}).meta(
+  {
+    id: "null",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": Internal29
+  }
+);
+var BillingCadenceSchema2 = z310.enum([
+  "monthly",
+  "annual",
+  "quarterly",
+  "one_time",
+  "usage_based"
+]).meta(
+  {
+    id: "BillingCadence",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
+);
+var COMPONENT_TYPE_VALUES2 = [
+  "banner",
+  "modal",
+  "tooltip",
+  "sidebar",
+  "inline",
+  "toast",
+  "fullscreen",
+  "email",
+  "sms",
+  "push",
+  "in_page",
+  "button",
+  "full_page",
+  "agent",
+  "cli",
+  "custom"
+];
+var ComponentTypeSchema2 = z310.enum(COMPONENT_TYPE_VALUES2).meta({ id: "ComponentType", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 });
+var DEFAULT_TEMPLATE_IDS2 = [
+  "button",
+  "plans_page_ctas",
+  "plans_page_full",
+  "inline_gate_message",
+  "tooltip",
+  "in_page_card",
+  "usage_counter",
+  "credit_counter",
+  "trial_counter",
+  "banner",
+  "modal_optional",
+  "modal_blocking",
+  "toast",
+  "email",
+  "sms",
+  "push",
+  "cli",
+  "agent_connector",
+  "custom_in_app"
+];
+var DefaultTemplateIdsSchema2 = z310.enum(DEFAULT_TEMPLATE_IDS2).meta({ id: "DefaultTemplateIds", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
+var DEFAULT_TEMPLATE_COMPONENT_TYPES2 = {
+  button: "button",
+  plans_page_ctas: "in_page",
+  plans_page_full: "full_page",
+  inline_gate_message: "inline",
+  tooltip: "tooltip",
+  in_page_card: "in_page",
+  usage_counter: "in_page",
+  credit_counter: "in_page",
+  trial_counter: "in_page",
+  banner: "banner",
+  modal_optional: "modal",
+  modal_blocking: "modal",
+  toast: "toast",
+  email: "email",
+  sms: "sms",
+  push: "push",
+  cli: "cli",
+  agent_connector: "agent",
+  custom_in_app: "custom"
+};
+var LEGACY_TEMPLATE_ALIASES2 = Object.freeze({
+  plans_pricing_ctas: "plans_page_ctas",
+  plans_pricing_full: "plans_page_full",
+  credit_balance_counter: "credit_counter",
+  banner_placement: "banner",
+  modal_overlay: "modal_optional",
+  toast_message: "toast",
+  push_notification: "push"
+});
+var BUILT_IN_TEMPLATE_COMPONENT_TYPES2 = Object.freeze({
+  ...DEFAULT_TEMPLATE_COMPONENT_TYPES2,
+  ...Object.fromEntries(
+    Object.entries(LEGACY_TEMPLATE_ALIASES2).map(([legacy, id11]) => [legacy, DEFAULT_TEMPLATE_COMPONENT_TYPES2[id11]])
+  ),
+  full_page: "full_page"
+});
+var ENTITLEMENT_STATUS_VALUES2 = ["allowed", "limited", "denied"];
+var PresentationOutcomeSchema2 = z310.enum(["presented", "clicked", "converted", "dismissed", "reminded", "suppressed"]).meta(
+  { id: "PresentationOutcome", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 }
+);
+var EntitlementTypeSchema2 = z310.enum([
+  "feature",
+  "capability_tier",
+  "usage_limit",
+  "price_per_unit",
+  "rate_limit",
+  "credits",
+  "seat"
+]).meta(
+  {
+    id: "EntitlementType",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
+);
+var CurrencySchema2 = z310.string().regex(/^[a-z]{3}$/, "Currency must be a lowercase ISO 4217 code").default("usd").meta(
+  {
+    id: "Currency",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": External15
+  }
+);
+var FeatureFlagValueSchema2 = z310.union([
+  z310.boolean(),
+  z310.number(),
+  z310.string()
+]).meta(
+  {
+    id: "FeatureFlagValue",
+    "x-revturbine-schema-persistence": Transient32,
+    "x-revturbine-schema-exposure": Internal29
+  }
+);
+var NameField2 = z310.string().min(1).max(200);
+var HandleField2 = z310.string().min(1).max(100);
+var DescriptionField2 = z310.string().max(500).optional();
+var MetadataField2 = z310.record(z310.string(), z310.unknown()).default({});
+var ThresholdPercentField2 = z310.number().int().min(10).max(100).multipleOf(10);
+var NullableDatetimeField2 = z310.string().datetime().nullable().default(null);
+var AnchorFields2 = z310.object({
+  environment_id: z310.string().min(1).default("production").meta({ ...Unrestricted39, readOnly: true })
+}).meta({ id: "null", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
+var VersionFields2 = z310.object({
+  // Which playbook version (the review/deploy unit — was `change_set_id`) staged
+  // this ledger row; null once it is the deployed live row.
+  playbook_version_id: z310.string().nullable().default(null).meta(Unrestricted39),
+  is_current: z310.boolean().default(true).meta({ ...Unrestricted39, readOnly: true }),
+  is_deleted: z310.boolean().default(false).meta({ ...Unrestricted39, readOnly: true }),
+  delete_date: z310.string().datetime().nullable().default(null).meta({ ...Unrestricted39, readOnly: true }),
+  // Monotonic version number within a lineage (v1, v2, v3 …); `base_sequence` is
+  // the live sequence this version was forked from (null for the first version),
+  // so a stale draft is detected when live has moved past it.
+  sequence: z310.number().int().min(1).default(1).meta({ ...Unrestricted39, readOnly: true }),
+  base_sequence: z310.number().int().nullable().default(null).meta({ ...Unrestricted39, readOnly: true })
+}).meta({ id: "null", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
+var AnchorBaseSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField2).merge(AnchorFields2).extend({
+  handle: HandleField2.meta({ ...Unrestricted39, readOnly: true }),
+  active: z310.boolean().default(true).meta({ ...Unrestricted39, readOnly: true })
+});
+function makeAnchor2(id11) {
+  return AnchorBaseSchema2.meta({
+    id: id11,
+    "x-revturbine-schema-persistence": Persisted24,
+    "x-revturbine-schema-exposure": Internal29
+  });
+}
+var SeveritySchema22 = z310.enum(["info", "warning", "critical"]).meta({ id: "Severity", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
+var CtaActionTypeSchema2 = z310.enum([
+  "open_checkout",
+  "view_plans",
+  "book_demo",
+  "contact_sales",
+  "complete_onboarding",
+  "invite_teammate",
+  "refer_friend",
+  "verify_work_email",
+  "update_payment_method",
+  "enable_auto_renewal",
+  "manage_subscription",
+  "switch_billing_period",
+  "extend_trial",
+  "open_rt_placement",
+  "dismiss",
+  "snooze",
+  "custom"
+]).meta({ id: "CtaActionType", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 });
+var ObjectiveField2 = HandleField2.optional();
+function hasCreditResetPeriod2(fields) {
+  return fields.reset_period !== void 0 && fields.reset_period !== null;
+}
+function allowancePeriod2(kind, fields, billingPeriod) {
+  if (kind === "seat") return "seat";
+  const raw = kind === "credits" ? fields.reset_period : fields.period_scope;
+  if (raw === "billing_period" || raw === "per_billing_period") {
+    if (billingPeriod === "monthly") return "month";
+    if (billingPeriod === "annual") return "year";
+    return void 0;
+  }
+  if (typeof raw !== "string" || raw === "") return void 0;
+  if (raw === "per_6_hours" || raw === "six_hours") return "six_hours";
+  return raw.startsWith("per_") ? raw.slice(4) : raw;
+}
+function assertCompatibleAllowances2(a, b, aBillingPeriod, bBillingPeriod) {
+  const aPeriod = allowancePeriod2(a.kind, a.fields, aBillingPeriod);
+  const bPeriod = allowancePeriod2(b.kind, b.fields, bBillingPeriod);
+  if (a.kind !== b.kind || aPeriod === void 0 || aPeriod !== bPeriod || (a.fields.allocation ?? "account") !== (b.fields.allocation ?? "account") || (a.fields.instance ?? "") !== (b.fields.instance ?? "") || (a.fields.seat_type_id ?? "") !== (b.fields.seat_type_id ?? "")) {
+    throw new Error(`Incompatible purchased allowances: ${a.ruleId} and ${b.ruleId} require matching periods and scopes`);
+  }
+}
+var BUILTIN_SEGMENT_HANDLE_PREFIX2 = "rt.";
+var BUILTIN_TRAIT_KEY_PREFIX2 = "rt_";
+var MAX_HANDLE_LENGTH = 100;
+function dimension2(key4, name, legacyAbbr, values, opts = {}) {
+  const legacyPrefix = `seg:${legacyAbbr}:`;
+  return {
+    key: key4,
+    name,
+    traitKey: `${BUILTIN_TRAIT_KEY_PREFIX2}${key4}`,
+    dimensionId: `${BUILTIN_SEGMENT_HANDLE_PREFIX2}${key4}`,
+    vocabulary: opts.vocabulary ?? "closed",
+    values: values.map(([value, valueName, legacyValue]) => ({
+      value,
+      name: valueName,
+      legacyPickerId: `${legacyPrefix}${legacyValue ?? value}`
+    })),
+    ...opts.fallback !== void 0 ? { fallback: opts.fallback } : {},
+    legacyPrefix
+  };
+}
+var BUILTIN_DIMENSIONS2 = [
+  dimension2("registration_state", "Registration State", "reg", [
+    ["unregistered", "Unregistered"],
+    ["registered", "Registered"]
+  ]),
+  dimension2(
+    "activity_level",
+    "Activity State",
+    "act",
+    [
+      ["new", "New"],
+      ["high", "High Activity"],
+      ["medium", "Medium Activity"],
+      ["low", "Low Activity"],
+      ["inactive", "Inactive"]
+    ],
+    { fallback: "new" }
+  ),
+  dimension2(
+    "subscription_state",
+    "Subscription State",
+    "sub",
+    [
+      ["none", "None"],
+      ["trial", "Trial"],
+      ["paid", "Paid"],
+      ["cancelled", "Cancelled"]
+    ],
+    { fallback: "none" }
+  ),
+  dimension2(
+    "trial_type",
+    "Trial Type",
+    "trial",
+    [
+      ["none", "Not in trial"],
+      ["free_trial", "Free trial", "free"],
+      ["reverse_trial", "Reverse trial", "reverse"]
+    ],
+    { fallback: "none" }
+  ),
+  dimension2("seat_type", "Seat Type", "seat", [], { vocabulary: "seat_type" }),
+  dimension2("buyer_role", "Buyer Role", "role", [
+    ["buyer", "Buyer"],
+    ["non_buyer", "Non-buyer"]
+  ]),
+  dimension2(
+    "email_type",
+    "Email Type",
+    "email",
+    [
+      ["business", "Business email"],
+      ["personal", "Personal email"],
+      ["unknown", "Unknown"]
+    ],
+    { fallback: "unknown" }
+  ),
+  dimension2(
+    "billing_health",
+    "Billing Health",
+    "bill",
+    [
+      ["no_billing", "No billing", "none"],
+      ["good_standing", "Good standing", "good"],
+      ["trial_payment_method_attached", "Trial \u2014 payment method attached", "trial_pm"],
+      ["payment_method_missing", "Payment method missing", "pm_missing"],
+      ["payment_failed", "Payment failed", "failed"],
+      ["payment_overdue", "Payment overdue", "overdue"],
+      ["cancelled", "Cancelled"]
+    ],
+    { fallback: "no_billing" }
+  ),
+  dimension2("region", "Country / Region", "geo", [
+    ["us_canada", "US / Canada"],
+    ["europe", "Europe"],
+    ["rest_of_world", "Rest of World", "row"]
+  ]),
+  dimension2(
+    "device_type",
+    "Device Type",
+    "dev",
+    [
+      ["desktop", "Desktop"],
+      ["mobile", "Mobile"],
+      ["tablet", "Tablet"],
+      ["unknown", "Unknown"]
+    ],
+    { fallback: "unknown" }
+  )
+];
+var BY_KEY2 = new Map(
+  BUILTIN_DIMENSIONS2.map((d) => [d.key, d])
+);
+function isBuiltinDimensionKey(key4) {
+  return BY_KEY2.has(key4);
+}
+function getBuiltinDimension(key4) {
+  const found = BY_KEY2.get(key4);
+  if (!found) throw new Error(`Unknown built-in dimension '${key4}'`);
+  return found;
+}
+function builtinSegmentHandle2(key4, value) {
+  return `${BUILTIN_SEGMENT_HANDLE_PREFIX2}${key4}.${value}`;
+}
+function isReservedSegmentHandle(handle) {
+  return handle.startsWith(BUILTIN_SEGMENT_HANDLE_PREFIX2);
+}
+function isBuiltinDimensionValue(key4, value) {
+  const dim = getBuiltinDimension(key4);
+  if (dim.vocabulary === "closed") return dim.values.some((v) => v.value === value);
+  return HANDLE_PATTERN2.test(value) && builtinSegmentHandle2(key4, value).length <= MAX_HANDLE_LENGTH;
+}
+function parseBuiltinSegmentHandle(handle) {
+  if (!isReservedSegmentHandle(handle)) return void 0;
+  const rest = handle.slice(BUILTIN_SEGMENT_HANDLE_PREFIX2.length);
+  const dot = rest.indexOf(".");
+  if (dot <= 0) return void 0;
+  const key4 = rest.slice(0, dot);
+  const value = rest.slice(dot + 1);
+  if (!isBuiltinDimensionKey(key4) || !isBuiltinDimensionValue(key4, value)) return void 0;
+  return { key: key4, value };
+}
+function isGeneratedBuiltinSegment(segment) {
+  if (typeof segment.handle !== "string") return false;
+  const parsed = parseBuiltinSegmentHandle(segment.handle);
+  if (!parsed) return false;
+  const dim = getBuiltinDimension(parsed.key);
+  if (segment.dimension_id !== dim.dimensionId) return false;
+  if (segment.experiment_handle !== void 0 && segment.experiment_handle !== null) return false;
+  const predicates = segment.predicates;
+  if (!Array.isArray(predicates) || predicates.length !== 1) return false;
+  const [p] = predicates;
+  if (!p || typeof p !== "object") return false;
+  const { field: field2, operator, value } = p;
+  return field2 === dim.traitKey && operator === "eq" && value === parsed.value;
+}
+var LEGACY_BY_ID2 = new Map(
+  BUILTIN_DIMENSIONS2.flatMap(
+    (d) => d.values.map((v) => [v.legacyPickerId, builtinSegmentHandle2(d.key, v.value)])
+  )
+);
+function identity2(row) {
+  return String(row.unique_handle ?? row.handle ?? row.id ?? "");
+}
 function matchesIdentity2(row, key4) {
   return typeof key4 === "string" && [row.unique_handle, row.handle, row.id].includes(key4);
 }
@@ -22289,6 +22580,7 @@ function runSemanticRules(graph, opts = {}) {
     ...checkLimitRuleEnforcement(graph),
     ...checkPublicVariationCollisions(graph),
     ...checkPayloadCtaOverflow(graph),
+    ...checkPayloadTemplateRefs(graph),
     ...checkPlacementAuthoring(graph),
     ...checkTrialRuleWidestAudience(graph),
     ...checkSegmentExperimentRefs(graph),
@@ -22752,6 +23044,42 @@ function checkPayloadCtaOverflow(graph) {
   }
   return findings;
 }
+function checkPayloadTemplateRefs(graph) {
+  const known = new Set(Object.keys(BUILT_IN_TEMPLATE_COMPONENT_TYPES2));
+  for (const template of graph.surface_templates ?? []) {
+    if (typeof template.id !== "string" || !template.id) return [];
+    known.add(template.id);
+  }
+  const findings = [];
+  const check = (payloadId, surfaces, path3) => {
+    if (!Array.isArray(surfaces)) return;
+    surfaces.forEach((surface, index) => {
+      if (!isRecord3(surface) || typeof surface.template_id !== "string") return;
+      if (known.has(surface.template_id)) return;
+      findings.push(finding("VAL-PLC-11", {
+        object_type: "placement_payload",
+        object_id: payloadId,
+        field: "template_id",
+        path: [...path3, "surfaces", index, "template_id"],
+        studio: "placements"
+      }, {
+        message: `Payload '${payloadId}' uses surface template '${surface.template_id}', which is neither built in nor defined in surface_templates. SDKs skip this payload.`,
+        detail: "Use a built-in template id, or add a surface_templates entry with this id and a surface_type."
+      }));
+    });
+  };
+  (graph.placements ?? []).forEach((placement, placementIndex) => {
+    const payloads = Array.isArray(placement.payloads) ? placement.payloads : [];
+    payloads.forEach((payload, payloadIndex) => {
+      if (!isRecord3(payload)) return;
+      check(String(payload.id ?? placement.id ?? ""), payload.surfaces, ["placements", placementIndex, "payloads", payloadIndex]);
+    });
+  });
+  (graph.placement_payloads ?? []).forEach((payload, index) => {
+    check(String(payload.payload_id ?? payload.id ?? ""), payload.surfaces, ["placement_payloads", index]);
+  });
+  return findings;
+}
 function checkTrialRuleWidestAudience(graph) {
   const findings = [];
   for (const rule of graph.free_trial_rules ?? []) {
@@ -23022,374 +23350,112 @@ function checkPublicVariationCollisions(graph) {
     ...collectPublicCollisions(graph.addon_variations, "addon_variation", "addon_id")
   ];
 }
-function collectPublicCollisions(rows, objectType, parentField) {
-  if (!rows?.length) return [];
-  const parentHandleField = parentField === "plan_id" ? "plan_handle" : "addon_handle";
-  const publicByTuple = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    if (row.is_current === false) continue;
-    if (String(row.visibility ?? "public") !== "public") continue;
-    const parentRef = row[parentField] ?? row[parentHandleField];
-    if (parentRef == null || String(parentRef) === "") continue;
-    const segmentRef = row.segment_id ?? row.segment_handle;
-    const tenant = String(row.tenant_id ?? "");
-    const parent2 = String(parentRef);
-    const period = String(row.billing_period ?? "");
-    const segment = segmentRef == null ? "_default" : String(segmentRef);
-    const key4 = `${tenant} ${parent2} ${period} ${segment}`;
-    const id11 = String(row.handle ?? row.id ?? "");
-    const bucket = publicByTuple.get(key4);
-    if (bucket) bucket.ids.push(id11);
-    else publicByTuple.set(key4, { ids: [id11], parent: parent2, period, segment });
-  }
-  const findings = [];
-  for (const bucket of publicByTuple.values()) {
-    if (bucket.ids.length < 2) continue;
-    const allIds = [...bucket.ids].sort();
-    const segmentLabel = bucket.segment === "_default" ? "no segment" : `segment ${bucket.segment}`;
-    const parentLabel = parentField === "plan_id" ? "plan" : "add-on";
-    for (const id11 of bucket.ids) {
-      findings.push(
-        finding(
-          "VAL-PLN-06",
-          {
-            object_type: objectType,
-            object_id: id11,
-            field: "visibility",
-            studio: "plans-entitlements"
-          },
-          {
-            message: `Variation '${id11}' is one of ${bucket.ids.length} marked Public for the same ${parentLabel}, billing period '${bucket.period}', and ${segmentLabel} \u2014 only one may be Public.`,
-            detail: `Set all but one of [${allIds.join(", ")}] to Unlisted or Legacy before deploying.`
-          }
-        )
-      );
-    }
-  }
-  return findings;
-}
-function fieldLabel(path3) {
-  if (!path3 || path3.length === 0) return "This value";
-  return String(path3[path3.length - 1]);
-}
-function messageForZodIssue(issue) {
-  const field2 = fieldLabel(issue.path);
-  switch (issue.code) {
-    case "invalid_type":
-      return issue.input === void 0 ? `${field2} is required.` : `${field2} must be a ${issue.expected ?? "valid value"}.`;
-    case "invalid_value": {
-      const values = (issue.values ?? []).filter(
-        (v) => ["string", "number", "boolean"].includes(typeof v)
-      );
-      return values.length > 0 ? `${field2} must be one of: ${values.map((v) => `'${String(v)}'`).join(", ")}.` : `${field2} must be one of the allowed values.`;
-    }
-    case "invalid_format":
-      return `${field2} isn't in a valid format.`;
-    case "too_small":
-      return `${field2} is too small.`;
-    case "too_big":
-      return `${field2} is too large.`;
-    case "unrecognized_keys":
-      return `${field2} isn't a recognized setting.`;
-    default:
-      return issue.message ?? `${field2} is invalid.`;
-  }
-}
-function targetRefForIssue(issue, basePath) {
-  const path3 = [...basePath, ...issue.path ?? []].map(
-    (seg2) => typeof seg2 === "number" ? seg2 : String(seg2)
-  );
-  return { path: path3 };
-}
-function zodErrorToFindings(error2, opts = {}) {
-  const basePath = opts.basePath ?? [];
-  return error2.issues.map((issue) => ({
-    code: issue.code ?? "invalid",
-    severity: "error_draft",
-    targetRef: targetRefForIssue(issue, basePath),
-    message: messageForZodIssue(issue),
-    ...opts.specRef ? { specRef: opts.specRef } : {}
-  }));
-}
-function spotlights(finding2, focus) {
-  if (!focus) return false;
-  const { object_type, object_id } = finding2.targetRef;
-  if (focus.object_id != null && object_id !== focus.object_id) return false;
-  if (focus.object_type != null && object_type !== focus.object_type) return false;
-  return focus.object_id != null || focus.object_type != null;
-}
-function evaluate(graph, opts = {}) {
-  const findings = [];
-  if (opts.structuralErrors) {
-    const errors2 = Array.isArray(opts.structuralErrors) ? opts.structuralErrors : [opts.structuralErrors];
-    for (const error2 of errors2) findings.push(...zodErrorToFindings(error2));
-  }
-  findings.push(...runSemanticRules(graph, { knownMetricIds: opts.knownMetricIds }));
-  if (!opts.focus) return findings;
-  return findings.map((f) => spotlights(f, opts.focus) ? { ...f, spotlight: true } : f);
-}
-var SchemaPersistence2 = {
-  Persisted: "persisted",
-  Transient: "transient"
-};
-var SchemaExposure2 = {
-  Internal: "internal",
-  External: "external"
-};
-var DataClassification2 = {
-  Pii: { "x-revturbine-data-classification": "pii" },
-  Financial: { "x-revturbine-data-classification": "financial" },
-  Unrestricted: { "x-revturbine-data-classification": "unrestricted" },
-  /**
-   * Machine-generated evaluation exhaust — supersession records, entitlement
-   * grants, placement decision traces. Carries no personal or financial data
-   * itself, but describes what the engine decided about a user, so it is not
-   * `Unrestricted` either. Applied at the MODEL level (plan 182 REQ-7); it was
-   * already in use as a raw string literal on four schemas before being
-   * declared here, which left `DataClassificationValue` unable to represent it.
-   */
-  Operational: { "x-revturbine-data-classification": "operational" }
-};
-var SCHEMA_EXPOSURE_META_KEY2 = "x-revturbine-schema-exposure";
-var READ_ONLY_META_KEY2 = "readOnly";
-var DECISION_ONLY_META_KEY2 = "x-revturbine-decision-only";
-var DecisionOnly2 = { [DECISION_ONLY_META_KEY2]: true };
-var ClientSafe2 = { [SCHEMA_EXPOSURE_META_KEY2]: SchemaExposure2.External };
-var ServerOnly2 = { [SCHEMA_EXPOSURE_META_KEY2]: SchemaExposure2.Internal };
-function toWritableSchema2(schema) {
-  const writableShape = {};
-  for (const [fieldName, fieldSchema] of Object.entries(schema.shape)) {
-    if (typeof fieldSchema !== "object" || fieldSchema === null) {
-      continue;
-    }
-    const isReadOnly = fieldSchema.meta()?.[READ_ONLY_META_KEY2] === true;
-    if (!isReadOnly) {
-      writableShape[fieldName] = fieldSchema;
-    }
-  }
-  return z210.object(writableShape);
-}
-function toCreateSchema2(schema) {
-  const writable = toWritableSchema2(schema);
-  const handleField = writable.shape["handle"];
-  if (handleField && typeof handleField.regex === "function") {
-    return writable.extend({ handle: handleField.regex(HANDLE_PATTERN2) });
-  }
-  return writable;
-}
-var { Unrestricted: Unrestricted39 } = DataClassification2;
-var { Transient: Transient32, Persisted: Persisted24 } = SchemaPersistence2;
-var { Internal: Internal29, External: External15 } = SchemaExposure2;
-var PaginationParamsSchema2 = z310.object({
-  page: z310.coerce.number().int().min(1).default(1).meta(Unrestricted39),
-  per_page: z310.coerce.number().int().min(1).max(100).default(25).meta(Unrestricted39)
-}).meta(
-  {
-    id: "PaginationParams",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
-  }
-);
-var TimestampFields2 = z310.object({
-  created_at: z310.string().datetime().meta({ ...Unrestricted39, readOnly: true }),
-  updated_at: z310.string().datetime().meta({ ...Unrestricted39, readOnly: true })
-}).meta(
-  {
-    id: "null",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
-  }
-);
-var IdField2 = z310.object({
-  id: z310.string().min(1).meta({ ...Unrestricted39, readOnly: true })
-}).meta(
-  {
-    id: "null",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
-  }
-);
-var TenantIdField2 = z310.object({
-  tenant_id: z310.string().min(1, "tenant_id is required").meta({ ...Unrestricted39, readOnly: true })
-}).meta(
-  {
-    id: "null",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": Internal29
-  }
-);
-var BillingCadenceSchema2 = z310.enum([
-  "monthly",
-  "annual",
-  "quarterly",
-  "one_time",
-  "usage_based"
-]).meta(
-  {
-    id: "BillingCadence",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
+function collectPublicCollisions(rows, objectType, parentField) {
+  if (!rows?.length) return [];
+  const parentHandleField = parentField === "plan_id" ? "plan_handle" : "addon_handle";
+  const publicByTuple = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (row.is_current === false) continue;
+    if (String(row.visibility ?? "public") !== "public") continue;
+    const parentRef = row[parentField] ?? row[parentHandleField];
+    if (parentRef == null || String(parentRef) === "") continue;
+    const segmentRef = row.segment_id ?? row.segment_handle;
+    const tenant = String(row.tenant_id ?? "");
+    const parent2 = String(parentRef);
+    const period = String(row.billing_period ?? "");
+    const segment = segmentRef == null ? "_default" : String(segmentRef);
+    const key4 = `${tenant} ${parent2} ${period} ${segment}`;
+    const id11 = String(row.handle ?? row.id ?? "");
+    const bucket = publicByTuple.get(key4);
+    if (bucket) bucket.ids.push(id11);
+    else publicByTuple.set(key4, { ids: [id11], parent: parent2, period, segment });
   }
-);
-var COMPONENT_TYPE_VALUES2 = [
-  "banner",
-  "modal",
-  "tooltip",
-  "sidebar",
-  "inline",
-  "toast",
-  "fullscreen",
-  "email",
-  "sms",
-  "push",
-  "in_page",
-  "button",
-  "full_page",
-  "agent",
-  "cli",
-  "custom"
-];
-var ComponentTypeSchema2 = z310.enum(COMPONENT_TYPE_VALUES2).meta({ id: "ComponentType", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 });
-var DEFAULT_TEMPLATE_IDS2 = [
-  "button",
-  "plans_page_ctas",
-  "plans_page_full",
-  "inline_gate_message",
-  "tooltip",
-  "in_page_card",
-  "usage_counter",
-  "credit_counter",
-  "trial_counter",
-  "banner",
-  "modal_optional",
-  "modal_blocking",
-  "toast",
-  "email",
-  "sms",
-  "push",
-  "cli",
-  "agent_connector",
-  "custom_in_app"
-];
-var DefaultTemplateIdsSchema2 = z310.enum(DEFAULT_TEMPLATE_IDS2).meta({ id: "DefaultTemplateIds", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
-var DEFAULT_TEMPLATE_COMPONENT_TYPES2 = {
-  button: "button",
-  plans_page_ctas: "in_page",
-  plans_page_full: "full_page",
-  inline_gate_message: "inline",
-  tooltip: "tooltip",
-  in_page_card: "in_page",
-  usage_counter: "in_page",
-  credit_counter: "in_page",
-  trial_counter: "in_page",
-  banner: "banner",
-  modal_optional: "modal",
-  modal_blocking: "modal",
-  toast: "toast",
-  email: "email",
-  sms: "sms",
-  push: "push",
-  cli: "cli",
-  agent_connector: "agent",
-  custom_in_app: "custom"
-};
-var BUILT_IN_TEMPLATE_COMPONENT_TYPES2 = Object.freeze({
-  ...DEFAULT_TEMPLATE_COMPONENT_TYPES2,
-  modal_overlay: "modal",
-  banner_placement: "banner",
-  full_page: "full_page"
-});
-var ENTITLEMENT_STATUS_VALUES2 = ["allowed", "limited", "denied"];
-var PresentationOutcomeSchema2 = z310.enum(["presented", "clicked", "converted", "dismissed", "reminded", "suppressed"]).meta(
-  { id: "PresentationOutcome", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 }
-);
-var EntitlementTypeSchema2 = z310.enum([
-  "feature",
-  "capability_tier",
-  "usage_limit",
-  "price_per_unit",
-  "rate_limit",
-  "credits",
-  "seat"
-]).meta(
-  {
-    id: "EntitlementType",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
+  const findings = [];
+  for (const bucket of publicByTuple.values()) {
+    if (bucket.ids.length < 2) continue;
+    const allIds = [...bucket.ids].sort();
+    const segmentLabel = bucket.segment === "_default" ? "no segment" : `segment ${bucket.segment}`;
+    const parentLabel = parentField === "plan_id" ? "plan" : "add-on";
+    for (const id11 of bucket.ids) {
+      findings.push(
+        finding(
+          "VAL-PLN-06",
+          {
+            object_type: objectType,
+            object_id: id11,
+            field: "visibility",
+            studio: "plans-entitlements"
+          },
+          {
+            message: `Variation '${id11}' is one of ${bucket.ids.length} marked Public for the same ${parentLabel}, billing period '${bucket.period}', and ${segmentLabel} \u2014 only one may be Public.`,
+            detail: `Set all but one of [${allIds.join(", ")}] to Unlisted or Legacy before deploying.`
+          }
+        )
+      );
+    }
   }
-);
-var CurrencySchema2 = z310.string().regex(/^[a-z]{3}$/, "Currency must be a lowercase ISO 4217 code").default("usd").meta(
-  {
-    id: "Currency",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": External15
+  return findings;
+}
+function fieldLabel(path3) {
+  if (!path3 || path3.length === 0) return "This value";
+  return String(path3[path3.length - 1]);
+}
+function messageForZodIssue(issue) {
+  const field2 = fieldLabel(issue.path);
+  switch (issue.code) {
+    case "invalid_type":
+      return issue.input === void 0 ? `${field2} is required.` : `${field2} must be a ${issue.expected ?? "valid value"}.`;
+    case "invalid_value": {
+      const values = (issue.values ?? []).filter(
+        (v) => ["string", "number", "boolean"].includes(typeof v)
+      );
+      return values.length > 0 ? `${field2} must be one of: ${values.map((v) => `'${String(v)}'`).join(", ")}.` : `${field2} must be one of the allowed values.`;
+    }
+    case "invalid_format":
+      return `${field2} isn't in a valid format.`;
+    case "too_small":
+      return `${field2} is too small.`;
+    case "too_big":
+      return `${field2} is too large.`;
+    case "unrecognized_keys":
+      return `${field2} isn't a recognized setting.`;
+    default:
+      return issue.message ?? `${field2} is invalid.`;
   }
-);
-var FeatureFlagValueSchema2 = z310.union([
-  z310.boolean(),
-  z310.number(),
-  z310.string()
-]).meta(
-  {
-    id: "FeatureFlagValue",
-    "x-revturbine-schema-persistence": Transient32,
-    "x-revturbine-schema-exposure": Internal29
+}
+function targetRefForIssue(issue, basePath) {
+  const path3 = [...basePath, ...issue.path ?? []].map(
+    (seg2) => typeof seg2 === "number" ? seg2 : String(seg2)
+  );
+  return { path: path3 };
+}
+function zodErrorToFindings(error2, opts = {}) {
+  const basePath = opts.basePath ?? [];
+  return error2.issues.map((issue) => ({
+    code: issue.code ?? "invalid",
+    severity: "error_draft",
+    targetRef: targetRefForIssue(issue, basePath),
+    message: messageForZodIssue(issue),
+    ...opts.specRef ? { specRef: opts.specRef } : {}
+  }));
+}
+function spotlights(finding2, focus) {
+  if (!focus) return false;
+  const { object_type, object_id } = finding2.targetRef;
+  if (focus.object_id != null && object_id !== focus.object_id) return false;
+  if (focus.object_type != null && object_type !== focus.object_type) return false;
+  return focus.object_id != null || focus.object_type != null;
+}
+function evaluate(graph, opts = {}) {
+  const findings = [];
+  if (opts.structuralErrors) {
+    const errors2 = Array.isArray(opts.structuralErrors) ? opts.structuralErrors : [opts.structuralErrors];
+    for (const error2 of errors2) findings.push(...zodErrorToFindings(error2));
   }
-);
-var NameField2 = z310.string().min(1).max(200);
-var HandleField2 = z310.string().min(1).max(100);
-var DescriptionField2 = z310.string().max(500).optional();
-var MetadataField2 = z310.record(z310.string(), z310.unknown()).default({});
-var ThresholdPercentField2 = z310.number().int().min(10).max(100).multipleOf(10);
-var NullableDatetimeField2 = z310.string().datetime().nullable().default(null);
-var AnchorFields2 = z310.object({
-  environment_id: z310.string().min(1).default("production").meta({ ...Unrestricted39, readOnly: true })
-}).meta({ id: "null", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
-var VersionFields2 = z310.object({
-  // Which playbook version (the review/deploy unit — was `change_set_id`) staged
-  // this ledger row; null once it is the deployed live row.
-  playbook_version_id: z310.string().nullable().default(null).meta(Unrestricted39),
-  is_current: z310.boolean().default(true).meta({ ...Unrestricted39, readOnly: true }),
-  is_deleted: z310.boolean().default(false).meta({ ...Unrestricted39, readOnly: true }),
-  delete_date: z310.string().datetime().nullable().default(null).meta({ ...Unrestricted39, readOnly: true }),
-  // Monotonic version number within a lineage (v1, v2, v3 …); `base_sequence` is
-  // the live sequence this version was forked from (null for the first version),
-  // so a stale draft is detected when live has moved past it.
-  sequence: z310.number().int().min(1).default(1).meta({ ...Unrestricted39, readOnly: true }),
-  base_sequence: z310.number().int().nullable().default(null).meta({ ...Unrestricted39, readOnly: true })
-}).meta({ id: "null", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
-var AnchorBaseSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField2).merge(AnchorFields2).extend({
-  handle: HandleField2.meta({ ...Unrestricted39, readOnly: true }),
-  active: z310.boolean().default(true).meta({ ...Unrestricted39, readOnly: true })
-});
-function makeAnchor2(id11) {
-  return AnchorBaseSchema2.meta({
-    id: id11,
-    "x-revturbine-schema-persistence": Persisted24,
-    "x-revturbine-schema-exposure": Internal29
-  });
+  findings.push(...runSemanticRules(graph, { knownMetricIds: opts.knownMetricIds }));
+  if (!opts.focus) return findings;
+  return findings.map((f) => spotlights(f, opts.focus) ? { ...f, spotlight: true } : f);
 }
-var SeveritySchema22 = z310.enum(["info", "warning", "critical"]).meta({ id: "Severity", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": Internal29 });
-var CtaActionTypeSchema2 = z310.enum([
-  "open_checkout",
-  "view_plans",
-  "book_demo",
-  "contact_sales",
-  "complete_onboarding",
-  "invite_teammate",
-  "refer_friend",
-  "verify_work_email",
-  "update_payment_method",
-  "enable_auto_renewal",
-  "manage_subscription",
-  "switch_billing_period",
-  "extend_trial",
-  "open_rt_placement",
-  "dismiss",
-  "snooze",
-  "custom"
-]).meta({ id: "CtaActionType", "x-revturbine-schema-persistence": Transient32, "x-revturbine-schema-exposure": External15 });
-var ObjectiveField2 = HandleField2.optional();
 var IdentityKind2 = {
   /** Author-given, human-meaningful handle (plans, entitlements, segments, …). */
   Named: "named",
@@ -25970,7 +26036,7 @@ function repairDeprecatedFields(config, schema = PlaybookObjectSchema2) {
 }
 
 // src/schema/version.ts
-var SCHEMA_VERSION = "0.1.522";
+var SCHEMA_VERSION = "0.1.524";
 
 // src/lib/credentials.ts
 import { chmodSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/cli",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "description": "revturbine — validate RevTurbine Playbooks and ship them to a RevTurbine instance through the playbook-version lifecycle (draft → Release).",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,7 @@
     "verify": "npm run typecheck && npm run lint && npm run check:schema && npm run test"
   },
   "dependencies": {
-    "@revturbine/sdk": ">=0.10.9 <1",
+    "@revturbine/sdk": ">=0.12.5 <1",
     "commander": "^15.0.0",
     "semver": "^7.8.5",
     "zod": "4.4.3"