@revturbine/cli 0.16.1 → 0.16.3

package/dist/cli.js

@@ -18,8 +18,8 @@ import { z as z5 } from "zod";
 import { z as z4 } from "zod";
 import { z as z6 } from "zod";
 import { z as z7 } from "zod";
-import { z as z8 } from "zod";
 import { z as z9 } from "zod";
+import { z as z8 } from "zod";
 import { z as z10 } from "zod";
 import { z as z11 } from "zod";
 import { z as z12 } from "zod";
@@ -51,7 +51,12 @@ var DataClassification = {
   Financial: { "x-revturbine-data-classification": "financial" },
   Unrestricted: { "x-revturbine-data-classification": "unrestricted" }
 };
+var SCHEMA_EXPOSURE_META_KEY = "x-revturbine-schema-exposure";
 var READ_ONLY_META_KEY = "readOnly";
+var DECISION_ONLY_META_KEY = "x-revturbine-decision-only";
+var DecisionOnly = { [DECISION_ONLY_META_KEY]: true };
+var ClientSafe = { [SCHEMA_EXPOSURE_META_KEY]: SchemaExposure.External };
+var ServerOnly = { [SCHEMA_EXPOSURE_META_KEY]: SchemaExposure.Internal };
 function toWritableSchema(schema) {
   const writableShape = {};
   for (const [fieldName, fieldSchema] of Object.entries(schema.shape)) {
@@ -1334,6 +1339,9 @@ var PlacementPayloadSchema = IdField.merge(TimestampFields).merge(TenantIdField)
   max_per_period: z7.number().int().min(0).nullable().default(null).meta(Unrestricted4),
   max_period_unit: CapPeriodSchema.default("session").meta(Unrestricted4),
   cooldown_after_dismiss_days: z7.number().int().min(0).default(7).meta(Unrestricted4),
+  // Per-payload remind-me-later (defer) window override, in minutes. Null =
+  // inherit the tenant default (`remindLaterMinutes`, 60). Plan 167 REQ-6 / Q-3.
+  remind_later_minutes: z7.number().int().min(0).nullable().default(null).meta(Unrestricted4),
   recommendation_strategy: z7.enum(["next_tier_up", "best_value", "custom"]).optional().default("next_tier_up").meta(Unrestricted4),
   recommendation_plan_override: z7.string().optional().meta(Unrestricted4)
 }).meta(
@@ -1532,256 +1540,72 @@ var placementPaths = {
 };
 var { Unrestricted: Unrestricted5, Pii } = DataClassification;
 var { Persisted: Persisted5, Transient: Transient5 } = SchemaPersistence;
-var { External: External5 } = SchemaExposure;
-var UserTrialStatusSchema = z8.object({
-  in_trial: z8.boolean().meta(Unrestricted5),
-  trial_type: z8.string().optional().meta(Unrestricted5),
-  plan_handle: z8.string().optional().meta(Unrestricted5),
-  // 'converted' reflects a server-side analytic-event transition
-  // (typically a Stripe webhook like `customer.subscription.created`
-  // or `invoice.payment_succeeded` against a trialing subscription)
-  // that the control plane processes to flip TrialInstance.status.
-  // The SDK reads this state from the decision-API response — it does
-  // NOT derive 'converted' client-side. trial_lifecycle.v1 rules
-  // matching on 'trial_converted' fire while the user's status carries
-  // this value, enabling conversion-celebration / receipt placements.
-  state: z8.enum(["active", "running_out", "expired", "converted", "none"]).optional().meta(Unrestricted5),
-  /**
-   * Trial limit model — mirrors the rule's `trial_limit_type`. The
-   * SDK uses this to decide which numeric fields below to surface;
-   * the placement-resolver gates `trial_ending(days_before_end)`
-   * only when `trial_limit_type === 'time'`.
-   */
-  trial_limit_type: z8.enum(["time", "usage"]).optional().meta(Unrestricted5),
-  /**
-   * Universal progress metric, 0..100. Computed by
-   * `deriveLocalTrialStatusFromInstance` from elapsed days
-   * (time-based) or consumed/limit (usage-based). Trial rule
-   * modules + placement-resolver supersession consume this field
-   * so they don't have to branch on the limit type.
-   */
-  progress_percent: z8.number().min(0).max(100).optional().meta(Unrestricted5),
-  // Time-based numeric fields. Populated when trial_limit_type='time'.
-  day_number: z8.number().int().min(0).optional().meta(Unrestricted5),
-  days_remaining: z8.number().int().min(0).optional().meta(Unrestricted5),
-  // Usage-based numeric fields. Populated when trial_limit_type='usage'.
-  usage_entitlement_handle: z8.string().optional().meta(Unrestricted5),
-  usage_consumed: z8.number().int().min(0).optional().meta(Unrestricted5),
-  usage_remaining: z8.number().int().min(0).optional().meta(Unrestricted5),
-  usage_limit: z8.number().int().min(0).optional().meta(Unrestricted5)
-}).meta(
-  { id: "UserTrialStatus", "x-revturbine-schema-persistence": Transient5, "x-revturbine-schema-exposure": External5 }
-);
-var UserUsageEntrySchema = z8.object({
-  entitlement_handle: z8.string().min(1).meta(Unrestricted5),
-  unit: z8.string().min(1).meta(Unrestricted5),
-  amount: z8.number().min(0).meta(Unrestricted5),
-  limit: z8.number().min(0).optional().meta(Unrestricted5),
-  reset_date: z8.string().optional().meta(Unrestricted5)
-}).meta(
-  { id: "UserUsageEntry", "x-revturbine-schema-persistence": Transient5, "x-revturbine-schema-exposure": External5 }
-);
-var UserPlanContextSchema = z8.object({
-  id: z8.string().min(1).meta(Unrestricted5),
-  name: z8.string().min(1).meta(Unrestricted5),
-  price: z8.string().optional().meta(Unrestricted5),
-  billing_period: z8.enum(["monthly", "annual", "none"]).optional().meta(Unrestricted5)
-}).meta(
-  { id: "UserPlanContext", "x-revturbine-schema-persistence": Transient5, "x-revturbine-schema-exposure": External5 }
-);
-var UserInstanceContextSchema = z8.object({
-  product_instance_id: z8.string().min(1).meta(Unrestricted5),
-  user_id: z8.string().min(1).meta(Pii),
-  plan: UserPlanContextSchema.optional().meta(Unrestricted5),
-  /** Usage entries for this instance, keyed by entitlement handle. */
-  usage: z8.record(z8.string(), UserUsageEntrySchema).default({}).meta(Unrestricted5),
-  trial: UserTrialStatusSchema.optional().meta(Unrestricted5),
-  /** Entitlements resolved at this instance level, keyed by handle. */
-  entitlements: z8.record(z8.string(), z8.union([z8.boolean(), EntitlementGrantSchema])).default({}).meta(Unrestricted5)
-}).meta(
-  {
-    id: "UserInstanceContext",
-    "x-revturbine-schema-persistence": Persisted5,
-    "x-revturbine-schema-exposure": External5
-  }
-);
-var UserContextSchema = IdField.merge(TenantIdField).merge(TimestampFields).extend({
-  user_id: z8.string().min(1).meta(Pii),
-  account_id: z8.string().min(1).nullable().optional().meta(Pii),
-  email: z8.string().email().nullable().optional().meta(Pii),
-  /** Optional email classification (e.g. `business`, `personal`). */
-  email_type: z8.string().optional().meta(Unrestricted5),
-  plan: UserPlanContextSchema.optional().meta(Unrestricted5),
-  /** Aggregate usage entries across all instances, keyed by handle. */
-  usage: z8.record(z8.string(), UserUsageEntrySchema).default({}).meta(Unrestricted5),
-  trial: UserTrialStatusSchema.optional().meta(Unrestricted5),
-  /**
-   * Billing-recovery signals (account-level). `payment_failed` reflects a
-   * hard payment failure (e.g. Stripe `invoice.payment_failed`);
-   * `payment_at_risk` an expiring / missing-backup payment method. They
-   * drive the Retention `qualifier` placement triggers
-   * (placement-studio-ui.md §3.7) — the SDK surfaces them onto the
-   * PlanProvider state the placement resolver reads. Omitted for users in
-   * good standing; a qualifier gate reads `=== true`, so an absent signal
-   * never fires the recovery placement.
-   */
-  payment_failed: z8.boolean().optional().meta(Unrestricted5),
-  payment_at_risk: z8.boolean().optional().meta(Unrestricted5),
-  /**
-   * The user's current tier per `capability_tier` entitlement, keyed by
-   * entitlement handle → tier handle (plan 138 TASK-4). Drives the
-   * `entitlement_gate.tier_threshold` placement trigger: the SDK surfaces
-   * this onto the EntitlementProvider state, and the resolver ranks the
-   * current tier against the entitlement's ordered ladder. Omitted for a
-   * user holding no tier (ranks below every threshold).
-   */
-  tiers: z8.record(z8.string(), z8.string()).optional().meta(Unrestricted5),
-  /** Account-level entitlements, keyed by handle. */
-  entitlements: z8.record(z8.string(), z8.union([z8.boolean(), EntitlementGrantSchema])).default({}).meta(Unrestricted5),
-  /** Per-instance breakdowns when the account has multiple product instances. */
-  instances: z8.array(UserInstanceContextSchema).optional().meta(Unrestricted5),
-  /** Customer-defined fields: role, app-level permissions, display prefs. */
-  custom: z8.record(z8.string(), z8.union([z8.string(), z8.number(), z8.boolean(), z8.null()])).default({}).meta(Pii),
-  /**
-   * Transient personalization token map.
-   *
-   * Holds SDK-derived tokens (plan_name, usage_current, etc.) merged with
-   * app-provided tokens.  Not persisted to the backend — rebuilt on each
-   * SDK session from context + exported config.
-   */
-  personalization: z8.record(z8.string(), z8.union([z8.string(), z8.number()])).default({}).meta({ ...Unrestricted5, "x-revturbine-schema-persistence": Transient5 }),
-  // ── Derived-entitlement cache (plan 74 REQ-12/REQ-13) ──────────────
-  // `entitlements` above is the rule-evaluated projection — a CACHE, not
-  // source of truth. These stamps record what it was computed against so a
-  // read can detect staleness: recompute when the active config version
-  // moved on OR the context hash changed.
-  /** Active config version (activated change-set id / compiled-bundle stamp) the cache was computed against. */
-  derived_config_version: z8.string().nullable().optional().meta(Unrestricted5),
-  /** Deterministic `computeUserContextHash` of the inputs the cache was computed from (REQ-13 ETag value). */
-  context_hash: z8.string().nullable().optional().meta(Unrestricted5),
-  /** When the cached entitlements were last (re)computed. */
-  derived_computed_at: NullableDatetimeField.meta(Unrestricted5)
-}).meta(
-  { id: "UserContext", "x-revturbine-schema-persistence": Persisted5, "x-revturbine-schema-exposure": External5 }
-);
-var userContextPaths = {
-  "/api/user-contexts": {
-    get: operation({
-      operationId: "listUserContexts",
-      requestParams: { query: ListQueryParamsSchema },
-      summary: "List user contexts",
-      tags: ["users"],
-      responses: { "200": { description: "User context list", content: { "application/json": { schema: ListEnvelope(UserContextSchema) } } } },
-      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "list" } }
-    }),
-    // Upsert by (tenant_id, user_id): the SDK identify/setUserContext path
-    // writes the persisted context. The collection POST is the create-or-update
-    // entry point — the route resolves the existing row by (tenant_id, user_id)
-    // and applies an idempotent upsert (server-side, plan 74 TASK-4).
-    post: operation({
-      operationId: "createUserContext",
-      summary: "Create or upsert a user context",
-      tags: ["users"],
-      requestBody: { required: true, content: { "application/json": { schema: UserContextSchema } } },
-      responses: { "201": { description: "Created", content: { "application/json": { schema: UserContextSchema } } } },
-      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "create" } }
-    })
-  },
-  "/api/user-contexts/{userContextId}": {
-    get: operation({
-      operationId: "getUserContext",
-      requestParams: { path: z8.object({ userContextId: z8.string() }) },
-      summary: "Get user context",
-      tags: ["users"],
-      responses: { "200": { description: "User context", content: { "application/json": { schema: UserContextSchema } } } },
-      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "get" } }
-    }),
-    patch: operation({
-      operationId: "updateUserContext",
-      requestParams: { path: z8.object({ userContextId: z8.string() }) },
-      summary: "Update a user context",
-      tags: ["users"],
-      requestBody: { required: true, content: { "application/json": { schema: UserContextSchema.partial() } } },
-      responses: { "200": { description: "Updated", content: { "application/json": { schema: UserContextSchema } } } },
-      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "update" } }
-    }),
-    // Delete path ships in v1 (plan 74 Q-1): a user context can be removed on
-    // request now; full by-email DSR tooling remains deferred (sdk.md §8).
-    delete: operation({
-      operationId: "deleteUserContext",
-      requestParams: { path: z8.object({ userContextId: z8.string() }) },
-      summary: "Delete a user context",
-      tags: ["users"],
-      responses: { "204": { description: "Deleted" } },
-      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "delete" } }
-    })
-  }
-};
-var { Unrestricted: Unrestricted6, Pii: Pii2 } = DataClassification;
-var { Persisted: Persisted6, Transient: Transient6 } = SchemaPersistence;
 var { Internal: Internal4 } = SchemaExposure;
 var CUSTOMER_OPERATIONS_FACETS = schemaFacets(SchemaContext.CustomerOperations, {
   sdkInput: false
 });
-var IdentitySchema = z9.object({
-  external_id: z9.string().min(1).meta(Pii2),
-  traits: z9.record(z9.string(), z9.unknown()).default({}).meta(Pii2),
-  plan_id: z9.string().optional().meta(Unrestricted6)
+var IdentitySchema = z8.object({
+  external_id: z8.string().min(1).meta(Pii),
+  traits: z8.record(z8.string(), z8.unknown()).default({}).meta(Pii),
+  plan_id: z8.string().optional().meta(Unrestricted5)
 }).meta(
   {
     id: "Identity",
-    "x-revturbine-schema-persistence": Persisted6,
+    "x-revturbine-schema-persistence": Persisted5,
     "x-revturbine-schema-exposure": Internal4
   }
 );
+var BillingHealthStatusSchema = z8.enum(["payment_failed", "payment_method_missing"]);
 var CustomerSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
-  external_id: z9.string().min(1).meta(Pii2),
-  identity: IdentitySchema.meta(Pii2),
-  stripe_customer_id: z9.string().optional().meta(Unrestricted6),
-  current_plan_id: z9.string().optional().meta(Unrestricted6),
-  subscription_status: z9.enum(["active", "past_due", "canceled", "trialing", "unpaid", "none"]).default("none").meta(Unrestricted6),
-  status: z9.enum(["active", "churned", "trial", "suspended"]).default("active").meta(Unrestricted6),
-  metadata: MetadataField.meta(Unrestricted6)
+  external_id: z8.string().min(1).meta(Pii),
+  identity: IdentitySchema.meta(Pii),
+  stripe_customer_id: z8.string().optional().meta(Unrestricted5),
+  current_plan_id: z8.string().optional().meta(Unrestricted5),
+  subscription_status: z8.enum(["active", "past_due", "canceled", "trialing", "unpaid", "none"]).default("none").meta(Unrestricted5),
+  status: z8.enum(["active", "churned", "trial", "suspended"]).default("active").meta(Unrestricted5),
+  /** Active billing-health problems (plan 156); empty array = healthy. */
+  billing_health_issues: z8.array(BillingHealthStatusSchema).default([]).meta(Unrestricted5),
+  metadata: MetadataField.meta(Unrestricted5)
 }).meta(
   {
     id: "Customer",
-    "x-revturbine-schema-persistence": Persisted6,
+    "x-revturbine-schema-persistence": Persisted5,
     "x-revturbine-schema-exposure": Internal4
   }
 );
-var CustomerOverrideDurationSchema = z9.enum([
+var CustomerOverrideDurationSchema = z8.enum([
   "permanent",
   "for_duration"
 ]).meta(
   {
     id: "CustomerOverrideDuration",
-    "x-revturbine-schema-persistence": Transient6,
+    "x-revturbine-schema-persistence": Transient5,
     "x-revturbine-schema-exposure": Internal4
   }
 );
-var CustomerOverrideTypeSchema = z9.enum(["grant_plan", "grant_addon", "grant_entitlement"]).meta(
-  { id: "CustomerOverrideType", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal4 }
+var CustomerOverrideTypeSchema = z8.enum(["grant_plan", "grant_addon", "grant_entitlement"]).meta(
+  { id: "CustomerOverrideType", "x-revturbine-schema-persistence": Transient5, "x-revturbine-schema-exposure": Internal4 }
 );
-var CustomerOverrideStatusSchema = z9.enum(["active", "expired", "revoked"]).meta(
-  { id: "CustomerOverrideStatus", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal4 }
+var CustomerOverrideStatusSchema = z8.enum(["active", "expired", "revoked"]).meta(
+  { id: "CustomerOverrideStatus", "x-revturbine-schema-persistence": Transient5, "x-revturbine-schema-exposure": Internal4 }
 );
 var CustomerOverrideSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
-  handle: HandleField.meta({ ...Unrestricted6, readOnly: true }),
-  customer_id: z9.string().min(1).meta(Pii2),
-  customer_id_list: z9.array(z9.string()).optional().meta(Pii2),
-  override_type: CustomerOverrideTypeSchema.meta(Unrestricted6),
-  target_id: z9.string().min(1).meta(Unrestricted6),
-  value: z9.record(z9.string(), z9.unknown()).default({}).meta(Unrestricted6),
-  duration_type: CustomerOverrideDurationSchema.default("permanent").meta(Unrestricted6),
-  duration_value: z9.string().optional().meta(Unrestricted6),
-  expiry_date: NullableDatetimeField.meta(Unrestricted6),
-  status: CustomerOverrideStatusSchema.default("active").meta(Unrestricted6),
-  reason: z9.string().max(500).optional().meta(Unrestricted6),
-  created_by: z9.string().optional().meta(Unrestricted6)
+  handle: HandleField.meta({ ...Unrestricted5, readOnly: true }),
+  customer_id: z8.string().min(1).meta(Pii),
+  customer_id_list: z8.array(z8.string()).optional().meta(Pii),
+  override_type: CustomerOverrideTypeSchema.meta(Unrestricted5),
+  target_id: z8.string().min(1).meta(Unrestricted5),
+  value: z8.record(z8.string(), z8.unknown()).default({}).meta(Unrestricted5),
+  duration_type: CustomerOverrideDurationSchema.default("permanent").meta(Unrestricted5),
+  duration_value: z8.string().optional().meta(Unrestricted5),
+  expiry_date: NullableDatetimeField.meta(Unrestricted5),
+  status: CustomerOverrideStatusSchema.default("active").meta(Unrestricted5),
+  reason: z8.string().max(500).optional().meta(Unrestricted5),
+  created_by: z8.string().optional().meta(Unrestricted5)
 }).meta(
   {
     id: "CustomerOverride",
-    "x-revturbine-schema-persistence": Persisted6,
+    "x-revturbine-schema-persistence": Persisted5,
     "x-revturbine-schema-exposure": Internal4,
     ...CUSTOMER_OPERATIONS_FACETS,
     // KENT-REVIEW (plan 121): defaulted to Bucket 2 on (customer_id, override_type,
@@ -1805,7 +1629,7 @@ var customerPaths = {
   "/api/customers/{customerId}": {
     get: operation({
       operationId: "getCustomer",
-      requestParams: { path: z9.object({ customerId: z9.string() }) },
+      requestParams: { path: z8.object({ customerId: z8.string() }) },
       summary: "Get customer by ID",
       tags: ["customers"],
       responses: { "200": { description: "Customer", content: { "application/json": { schema: CustomerSchema } } } },
@@ -1833,7 +1657,7 @@ var customerPaths = {
   "/api/customer-overrides/{overrideId}": {
     get: operation({
       operationId: "getCustomerOverride",
-      requestParams: { path: z9.object({ overrideId: z9.string() }) },
+      requestParams: { path: z8.object({ overrideId: z8.string() }) },
       summary: "Get customer override",
       tags: ["customers"],
       responses: { "200": { description: "Override", content: { "application/json": { schema: CustomerOverrideSchema } } } },
@@ -1841,7 +1665,7 @@ var customerPaths = {
     }),
     patch: operation({
       operationId: "updateCustomerOverride",
-      requestParams: { path: z9.object({ overrideId: z9.string() }) },
+      requestParams: { path: z8.object({ overrideId: z8.string() }) },
       summary: "Update customer override",
       tags: ["customers"],
       requestBody: { required: true, content: { "application/json": { schema: CustomerOverrideSchema.partial() } } },
@@ -1850,7 +1674,7 @@ var customerPaths = {
     }),
     delete: operation({
       operationId: "deleteCustomerOverride",
-      requestParams: { path: z9.object({ overrideId: z9.string() }) },
+      requestParams: { path: z8.object({ overrideId: z8.string() }) },
       summary: "Delete customer override",
       tags: ["customers"],
       responses: { "204": { description: "Deleted" } },
@@ -1860,7 +1684,7 @@ var customerPaths = {
   "/api/customer-overrides/{overrideId}/revoke": {
     post: operation({
       operationId: "revokeCustomerOverride",
-      requestParams: { path: z9.object({ overrideId: z9.string() }) },
+      requestParams: { path: z8.object({ overrideId: z8.string() }) },
       summary: "Revoke an active customer override",
       tags: ["customers"],
       responses: { "200": { description: "Revoked", content: { "application/json": { schema: CustomerOverrideSchema } } } },
@@ -1870,28 +1694,263 @@ var customerPaths = {
   "/api/customer-overrides/{overrideId}/duplicate": {
     post: operation({
       operationId: "duplicateCustomerOverride",
-      requestParams: { path: z9.object({ overrideId: z9.string() }) },
+      requestParams: { path: z8.object({ overrideId: z8.string() }) },
       summary: "Duplicate customer override for another customer",
       tags: ["customers"],
-      requestBody: { required: true, content: { "application/json": { schema: z9.object({ customer_id: z9.string() }) } } },
+      requestBody: { required: true, content: { "application/json": { schema: z8.object({ customer_id: z8.string() }) } } },
       responses: { "201": { description: "Duplicated", content: { "application/json": { schema: CustomerOverrideSchema } } } },
       "x-revturbine-operation": { exposure: "internal", resource: "customer-overrides", persistence: { table: "customerOverrides", mode: "create" } }
     })
   }
 };
+var { Unrestricted: Unrestricted6, Pii: Pii2, Financial: Financial2 } = DataClassification;
+var { Persisted: Persisted6, Transient: Transient6 } = SchemaPersistence;
+var { External: External5, Internal: Internal5 } = SchemaExposure;
+var UserTrialStatusSchema = z9.object({
+  in_trial: z9.boolean().meta(Unrestricted6),
+  trial_type: z9.string().optional().meta(Unrestricted6),
+  plan_handle: z9.string().optional().meta(Unrestricted6),
+  // 'converted' reflects a server-side analytic-event transition
+  // (typically a Stripe webhook like `customer.subscription.created`
+  // or `invoice.payment_succeeded` against a trialing subscription)
+  // that the control plane processes to flip TrialInstance.status.
+  // The SDK reads this state from the decision-API response — it does
+  // NOT derive 'converted' client-side. trial_lifecycle.v1 rules
+  // matching on 'trial_converted' fire while the user's status carries
+  // this value, enabling conversion-celebration / receipt placements.
+  state: z9.enum(["active", "running_out", "expired", "converted", "none"]).optional().meta(Unrestricted6),
+  /**
+   * Trial limit model — mirrors the rule's `trial_limit_type`. The
+   * SDK uses this to decide which numeric fields below to surface;
+   * the placement-resolver gates `trial_ending(days_before_end)`
+   * only when `trial_limit_type === 'time'`.
+   */
+  trial_limit_type: z9.enum(["time", "usage"]).optional().meta(Unrestricted6),
+  /**
+   * Universal progress metric, 0..100. Computed by
+   * `deriveLocalTrialStatusFromInstance` from elapsed days
+   * (time-based) or consumed/limit (usage-based). Trial rule
+   * modules + placement-resolver supersession consume this field
+   * so they don't have to branch on the limit type.
+   */
+  progress_percent: z9.number().min(0).max(100).optional().meta(Unrestricted6),
+  // Time-based numeric fields. Populated when trial_limit_type='time'.
+  day_number: z9.number().int().min(0).optional().meta(Unrestricted6),
+  days_remaining: z9.number().int().min(0).optional().meta(Unrestricted6),
+  // Usage-based numeric fields. Populated when trial_limit_type='usage'.
+  usage_entitlement_handle: z9.string().optional().meta(Unrestricted6),
+  usage_consumed: z9.number().int().min(0).optional().meta(Unrestricted6),
+  usage_remaining: z9.number().int().min(0).optional().meta(Unrestricted6),
+  usage_limit: z9.number().int().min(0).optional().meta(Unrestricted6)
+}).meta(
+  { id: "UserTrialStatus", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": External5 }
+);
+var UserUsageEntrySchema = z9.object({
+  entitlement_handle: z9.string().min(1).meta(Unrestricted6),
+  unit: z9.string().min(1).meta(Unrestricted6),
+  amount: z9.number().min(0).meta(Unrestricted6),
+  limit: z9.number().min(0).optional().meta(Unrestricted6),
+  reset_date: z9.string().optional().meta(Unrestricted6)
+}).meta(
+  { id: "UserUsageEntry", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": External5 }
+);
+var UserPlanContextSchema = z9.object({
+  id: z9.string().min(1).meta(Unrestricted6),
+  name: z9.string().min(1).meta(Unrestricted6),
+  price: z9.string().optional().meta(Unrestricted6),
+  billing_period: z9.enum(["monthly", "annual", "none"]).optional().meta(Unrestricted6)
+}).meta(
+  { id: "UserPlanContext", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": External5 }
+);
+var UserInstanceContextSchema = z9.object({
+  product_instance_id: z9.string().min(1).meta(Unrestricted6),
+  user_id: z9.string().min(1).meta(Pii2),
+  plan: UserPlanContextSchema.optional().meta(Unrestricted6),
+  /** Usage entries for this instance, keyed by entitlement handle. */
+  usage: z9.record(z9.string(), UserUsageEntrySchema).default({}).meta(Unrestricted6),
+  trial: UserTrialStatusSchema.optional().meta(Unrestricted6),
+  /** Entitlements resolved at this instance level, keyed by handle. */
+  entitlements: z9.record(z9.string(), z9.union([z9.boolean(), EntitlementGrantSchema])).default({}).meta(Unrestricted6)
+}).meta(
+  {
+    id: "UserInstanceContext",
+    "x-revturbine-schema-persistence": Persisted6,
+    "x-revturbine-schema-exposure": External5
+  }
+);
+var UserContextSchema = IdField.merge(TenantIdField).merge(TimestampFields).extend({
+  user_id: z9.string().min(1).meta(Pii2),
+  account_id: z9.string().min(1).nullable().optional().meta(Pii2),
+  email: z9.string().email().nullable().optional().meta(Pii2),
+  /** Optional email classification (e.g. `business`, `personal`). */
+  email_type: z9.string().optional().meta(Unrestricted6),
+  plan: UserPlanContextSchema.optional().meta(Unrestricted6),
+  /** Aggregate usage entries across all instances, keyed by handle. */
+  usage: z9.record(z9.string(), UserUsageEntrySchema).default({}).meta(Unrestricted6),
+  trial: UserTrialStatusSchema.optional().meta(Unrestricted6),
+  /**
+   * Billing-recovery signals (account-level). `payment_failed` reflects a
+   * hard payment failure (e.g. Stripe `invoice.payment_failed`);
+   * `payment_at_risk` an expiring / missing-backup payment method. They
+   * drive the Retention `qualifier` placement triggers
+   * (placement-studio-ui.md §3.7) — the SDK surfaces them onto the
+   * PlanProvider state the placement resolver reads. Omitted for users in
+   * good standing; a qualifier gate reads `=== true`, so an absent signal
+   * never fires the recovery placement.
+   */
+  payment_failed: z9.boolean().optional().meta(Unrestricted6),
+  payment_at_risk: z9.boolean().optional().meta(Unrestricted6),
+  /**
+   * The user's current tier per `capability_tier` entitlement, keyed by
+   * entitlement handle → tier handle (plan 138 TASK-4). Drives the
+   * `entitlement_gate.tier_threshold` placement trigger: the SDK surfaces
+   * this onto the EntitlementProvider state, and the resolver ranks the
+   * current tier against the entitlement's ordered ladder. Omitted for a
+   * user holding no tier (ranks below every threshold).
+   */
+  tiers: z9.record(z9.string(), z9.string()).optional().meta(Unrestricted6),
+  /** Account-level entitlements, keyed by handle. */
+  entitlements: z9.record(z9.string(), z9.union([z9.boolean(), EntitlementGrantSchema])).default({}).meta(Unrestricted6),
+  /** Per-instance breakdowns when the account has multiple product instances. */
+  instances: z9.array(UserInstanceContextSchema).optional().meta(Unrestricted6),
+  /** Customer-defined fields: role, app-level permissions, display prefs. */
+  custom: z9.record(z9.string(), z9.union([z9.string(), z9.number(), z9.boolean(), z9.null()])).default({}).meta(Pii2),
+  /**
+   * Transient personalization token map.
+   *
+   * Holds SDK-derived tokens (plan_name, usage_current, etc.) merged with
+   * app-provided tokens.  Not persisted to the backend — rebuilt on each
+   * SDK session from context + exported config.
+   */
+  personalization: z9.record(z9.string(), z9.union([z9.string(), z9.number()])).default({}).meta({ ...Unrestricted6, "x-revturbine-schema-persistence": Transient6 }),
+  // ── Derived-entitlement cache (plan 74 REQ-12/REQ-13) ──────────────
+  // `entitlements` above is the rule-evaluated projection — a CACHE, not
+  // source of truth. These stamps record what it was computed against so a
+  // read can detect staleness: recompute when the active config version
+  // moved on OR the context hash changed.
+  /** Active config version (activated change-set id / compiled-bundle stamp) the cache was computed against. */
+  derived_config_version: z9.string().nullable().optional().meta(Unrestricted6),
+  /** Deterministic `computeUserContextHash` of the inputs the cache was computed from (REQ-13 ETag value). */
+  context_hash: z9.string().nullable().optional().meta(Unrestricted6),
+  /** When the cached entitlements were last (re)computed. */
+  derived_computed_at: NullableDatetimeField.meta(Unrestricted6)
+}).meta(
+  { id: "UserContext", "x-revturbine-schema-persistence": Persisted6, "x-revturbine-schema-exposure": External5 }
+);
+var ClientContextTrialSchema = z9.object({
+  status: z9.enum(["active", "running_out", "expired", "converted", "none"]).meta({ ...Unrestricted6, ...ClientSafe }),
+  days_remaining: z9.number().int().min(0).optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  ends_at: z9.string().optional().meta({ ...Unrestricted6, ...ClientSafe })
+}).meta(
+  { id: "ClientContextTrial", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal5 }
+);
+var ClientContextBillingSchema = z9.object({
+  /** Coarse, browser-safe billing-health signal (the only billing field exposed). */
+  health: z9.enum(["ok", "attention_required"]).optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  /** decision_only — drives retention placements server-side; never returned to the browser. */
+  failed_payment_reason: z9.string().optional().meta({ ...Financial2, ...DecisionOnly }),
+  /**
+   * decision_only — the raw billing-health issue codes (plan 156). The coarse
+   * `health` above is derived from whether this is non-empty; these raw codes
+   * may drive server-side Playbook decisions but are stripped by the exposure
+   * filter and never returned to the browser.
+   */
+  issues: z9.array(BillingHealthStatusSchema).optional().meta({ ...Financial2, ...DecisionOnly }),
+  /** server_only — raw provider identifier; never exposed. */
+  provider_subscription_id: z9.string().optional().meta({ ...Financial2, ...ServerOnly })
+}).meta(
+  { id: "ClientContextBilling", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal5 }
+);
+var ClientContextCapabilitiesSchema = z9.object({
+  can_upgrade: z9.boolean().optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  can_manage_billing: z9.boolean().optional().meta({ ...Unrestricted6, ...ClientSafe })
+}).meta(
+  { id: "ClientContextCapabilities", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal5 }
+);
+var ClientContextPlanSchema = z9.object({
+  /** The customer's current plan handle (`plans.unique_handle`). */
+  handle: z9.string().min(1).optional().meta({ ...Unrestricted6, ...ClientSafe })
+}).meta(
+  { id: "ClientContextPlan", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal5 }
+);
+var ClientContextSchema = z9.object({
+  /** The end-user subject the client token was minted for (carried by the token, not the request). */
+  subject: z9.string().min(1).meta({ ...Unrestricted6, ...ClientSafe }),
+  /** Opaque version stamp of the underlying context snapshot. */
+  context_version: z9.string().optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  trial: ClientContextTrialSchema.optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  billing: ClientContextBillingSchema.optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  plan: ClientContextPlanSchema.optional().meta({ ...Unrestricted6, ...ClientSafe }),
+  capabilities: ClientContextCapabilitiesSchema.optional().meta({ ...Unrestricted6, ...ClientSafe })
+}).meta(
+  { id: "ClientContext", "x-revturbine-schema-persistence": Transient6, "x-revturbine-schema-exposure": Internal5 }
+);
+var userContextPaths = {
+  "/api/user-contexts": {
+    get: operation({
+      operationId: "listUserContexts",
+      requestParams: { query: ListQueryParamsSchema },
+      summary: "List user contexts",
+      tags: ["users"],
+      responses: { "200": { description: "User context list", content: { "application/json": { schema: ListEnvelope(UserContextSchema) } } } },
+      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "list" } }
+    }),
+    // Upsert by (tenant_id, user_id): the SDK identify/setUserContext path
+    // writes the persisted context. The collection POST is the create-or-update
+    // entry point — the route resolves the existing row by (tenant_id, user_id)
+    // and applies an idempotent upsert (server-side, plan 74 TASK-4).
+    post: operation({
+      operationId: "createUserContext",
+      summary: "Create or upsert a user context",
+      tags: ["users"],
+      requestBody: { required: true, content: { "application/json": { schema: UserContextSchema } } },
+      responses: { "201": { description: "Created", content: { "application/json": { schema: UserContextSchema } } } },
+      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "create", uniqueBy: ["tenant_id", "user_id"] } }
+    })
+  },
+  "/api/user-contexts/{userContextId}": {
+    get: operation({
+      operationId: "getUserContext",
+      requestParams: { path: z9.object({ userContextId: z9.string() }) },
+      summary: "Get user context",
+      tags: ["users"],
+      responses: { "200": { description: "User context", content: { "application/json": { schema: UserContextSchema } } } },
+      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "get" } }
+    }),
+    patch: operation({
+      operationId: "updateUserContext",
+      requestParams: { path: z9.object({ userContextId: z9.string() }) },
+      summary: "Update a user context",
+      tags: ["users"],
+      requestBody: { required: true, content: { "application/json": { schema: UserContextSchema.partial() } } },
+      responses: { "200": { description: "Updated", content: { "application/json": { schema: UserContextSchema } } } },
+      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "update" } }
+    }),
+    // Delete path ships in v1 (plan 74 Q-1): a user context can be removed on
+    // request now; full by-email DSR tooling remains deferred (sdk.md §8).
+    delete: operation({
+      operationId: "deleteUserContext",
+      requestParams: { path: z9.object({ userContextId: z9.string() }) },
+      summary: "Delete a user context",
+      tags: ["users"],
+      responses: { "204": { description: "Deleted" } },
+      "x-revturbine-operation": { exposure: "internal", resource: "user-contexts", persistence: { table: "userContexts", mode: "delete" } }
+    })
+  }
+};
 var { Unrestricted: Unrestricted7 } = DataClassification;
 var { Persisted: Persisted7, Transient: Transient7 } = SchemaPersistence;
-var { Internal: Internal5 } = SchemaExposure;
+var { Internal: Internal6 } = SchemaExposure;
 var PLAYBOOK_SDK_FACETS4 = schemaFacets(SchemaContext.Playbook, { sdkInput: true });
 var PENDING_PLAYBOOK_SDK_FACETS = schemaFacets(SchemaContext.Playbook, {
   inConfig: false,
   sdkInput: true
 });
 var DimensionCategorySchema = z10.enum(["default", "custom"]).meta(
-  { id: "DimensionCategory", "x-revturbine-schema-persistence": Transient7, "x-revturbine-schema-exposure": Internal5 }
+  { id: "DimensionCategory", "x-revturbine-schema-persistence": Transient7, "x-revturbine-schema-exposure": Internal6 }
 );
 var DimensionSourceTypeSchema = z10.enum(["system", "sdk_trait", "sdk_trait_enum", "cdp_property", "manual_list"]).meta(
-  { id: "DimensionSourceType", "x-revturbine-schema-persistence": Transient7, "x-revturbine-schema-exposure": Internal5 }
+  { id: "DimensionSourceType", "x-revturbine-schema-persistence": Transient7, "x-revturbine-schema-exposure": Internal6 }
 );
 var SegmentDimensionSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z10.string().min(1).meta({ ...Unrestricted7, readOnly: true }),
@@ -1909,7 +1968,7 @@ var SegmentDimensionSchema = IdField.merge(TimestampFields).merge(TenantIdField)
   {
     id: "SegmentDimension",
     "x-revturbine-schema-persistence": Persisted7,
-    "x-revturbine-schema-exposure": Internal5,
+    "x-revturbine-schema-exposure": Internal6,
     ...PENDING_PLAYBOOK_SDK_FACETS,
     ...namedIdentity()
   }
@@ -1927,7 +1986,7 @@ var SegmentValueSchema = IdField.merge(TimestampFields).merge(TenantIdField).mer
   {
     id: "SegmentValue",
     "x-revturbine-schema-persistence": Persisted7,
-    "x-revturbine-schema-exposure": Internal5,
+    "x-revturbine-schema-exposure": Internal6,
     ...PENDING_PLAYBOOK_SDK_FACETS,
     ...namedIdentity()
   }
@@ -1946,7 +2005,7 @@ var SegmentSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(An
   {
     id: "Segment",
     "x-revturbine-schema-persistence": Persisted7,
-    "x-revturbine-schema-exposure": Internal5,
+    "x-revturbine-schema-exposure": Internal6,
     ...PLAYBOOK_SDK_FACETS4,
     ...namedIdentity()
   }
@@ -2280,7 +2339,7 @@ var contentPaths = {
 };
 var { Unrestricted: Unrestricted9, Pii: Pii3 } = DataClassification;
 var { Persisted: Persisted9, Transient: Transient9 } = SchemaPersistence;
-var { Internal: Internal6, External: External7 } = SchemaExposure;
+var { Internal: Internal7, External: External7 } = SchemaExposure;
 var BRANDING_FACETS = schemaFacets(SchemaContext.Branding, { sdkInput: false });
 var ThemeSchema = z12.object({
   id: z12.string().min(1).meta({ ...Unrestricted9, readOnly: true }),
@@ -2303,7 +2362,7 @@ var UiPreferenceSchema = IdField.merge(TimestampFields).extend({
   {
     id: "UiPreference",
     "x-revturbine-schema-persistence": Persisted9,
-    "x-revturbine-schema-exposure": Internal6
+    "x-revturbine-schema-exposure": Internal7
   }
 );
 var uiPreferencePaths = {
@@ -2347,15 +2406,15 @@ var uiPreferencePaths = {
     })
   }
 };
-var { Unrestricted: Unrestricted10, Financial: Financial2 } = DataClassification;
+var { Unrestricted: Unrestricted10, Financial: Financial3 } = DataClassification;
 var { Persisted: Persisted10, Transient: Transient10 } = SchemaPersistence;
-var { External: External8, Internal: Internal7 } = SchemaExposure;
+var { External: External8, Internal: Internal8 } = SchemaExposure;
 var CohortMonthSchema = z13.object({
   month: z13.string().meta(Unrestricted10),
   cohort_size: z13.number().int().min(0).meta(Unrestricted10),
   retained: z13.number().int().min(0).meta(Unrestricted10),
   retention_rate: z13.number().min(0).max(1).meta(Unrestricted10),
-  revenue_cents: z13.number().int().min(0).meta(Financial2)
+  revenue_cents: z13.number().int().min(0).meta(Financial3)
 }).meta(
   { id: "CohortMonth", "x-revturbine-schema-persistence": Transient10, "x-revturbine-schema-exposure": External8 }
 );
@@ -2376,26 +2435,26 @@ var PlacementPerformanceRowSchema = z13.object({
   conversions: z13.number().int().min(0).meta(Unrestricted10),
   ctr: z13.number().min(0).meta(Unrestricted10),
   conversion_rate: z13.number().min(0).meta(Unrestricted10),
-  revenue_cents: z13.number().int().min(0).meta(Financial2)
+  revenue_cents: z13.number().int().min(0).meta(Financial3)
 }).meta(
   { id: "PlacementPerformanceRow", "x-revturbine-schema-persistence": Transient10, "x-revturbine-schema-exposure": External8 }
 );
 var RevenueMetricSchema = z13.object({
   date: z13.string().meta(Unrestricted10),
-  mrr_cents: z13.number().int().min(0).meta(Financial2),
-  arr_cents: z13.number().int().min(0).meta(Financial2),
-  new_mrr_cents: z13.number().int().min(0).meta(Financial2),
-  churned_mrr_cents: z13.number().int().min(0).meta(Financial2),
-  expansion_mrr_cents: z13.number().int().min(0).meta(Financial2),
-  net_new_mrr_cents: z13.number().int().meta(Financial2)
+  mrr_cents: z13.number().int().min(0).meta(Financial3),
+  arr_cents: z13.number().int().min(0).meta(Financial3),
+  new_mrr_cents: z13.number().int().min(0).meta(Financial3),
+  churned_mrr_cents: z13.number().int().min(0).meta(Financial3),
+  expansion_mrr_cents: z13.number().int().min(0).meta(Financial3),
+  net_new_mrr_cents: z13.number().int().meta(Financial3)
 }).meta(
   { id: "RevenueMetric", "x-revturbine-schema-persistence": Transient10, "x-revturbine-schema-exposure": External8 }
 );
 var KpiAggregateSchema = z13.object({
   metric_key: z13.string().min(1).meta(Unrestricted10),
   label: z13.string().meta(Unrestricted10),
-  current_value: z13.number().meta(Financial2),
-  previous_value: z13.number().nullable().default(null).meta(Financial2),
+  current_value: z13.number().meta(Financial3),
+  previous_value: z13.number().nullable().default(null).meta(Financial3),
   change_percent: z13.number().nullable().default(null).meta(Unrestricted10),
   period: z13.string().meta(Unrestricted10),
   unit: z13.enum(["count", "cents", "percent", "ratio", "seconds"]).default("count").meta(Unrestricted10)
@@ -2415,7 +2474,7 @@ var DriftReportSchema = IdField.merge(TimestampFields).merge(TenantIdField).exte
   resolved_at: NullableDatetimeField.meta(Unrestricted10),
   metadata: MetadataField.meta(Unrestricted10)
 }).meta(
-  { id: "DriftReport", "x-revturbine-schema-persistence": Persisted10, "x-revturbine-schema-exposure": Internal7 }
+  { id: "DriftReport", "x-revturbine-schema-persistence": Persisted10, "x-revturbine-schema-exposure": Internal8 }
 );
 var AlertSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   alert_type: z13.enum(["usage_threshold", "revenue_drop", "conversion_drop", "experiment_significance", "drift_detected", "custom"]).meta(Unrestricted10),
@@ -2429,7 +2488,7 @@ var AlertSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   acknowledged_by: z13.string().nullable().default(null).meta(Unrestricted10),
   metadata: MetadataField.meta(Unrestricted10)
 }).meta(
-  { id: "Alert", "x-revturbine-schema-persistence": Persisted10, "x-revturbine-schema-exposure": Internal7 }
+  { id: "Alert", "x-revturbine-schema-persistence": Persisted10, "x-revturbine-schema-exposure": Internal8 }
 );
 var analyticsPaths = {
   "/api/analytics/kpis": {
@@ -2525,7 +2584,7 @@ var analyticsPaths = {
 };
 var { Unrestricted: Unrestricted11, Pii: Pii4 } = DataClassification;
 var { Persisted: Persisted11, Transient: Transient11 } = SchemaPersistence;
-var { Internal: Internal8, External: External9 } = SchemaExposure;
+var { Internal: Internal9, External: External9 } = SchemaExposure;
 var EventSourceSchema = z14.enum(["clickstream", "telemetry", "sdk", "workflow", "system"]).meta(
   {
     id: "EventSource",
@@ -2547,7 +2606,7 @@ var EventEnvelopeSchema = IdField.extend({
   {
     id: "EventEnvelope",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var IngestedEventSchema = EventEnvelopeSchema.extend({
@@ -2556,7 +2615,7 @@ var IngestedEventSchema = EventEnvelopeSchema.extend({
   {
     id: "IngestedEvent",
     "x-revturbine-schema-persistence": Persisted11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var EventIngestBatchSchema = z14.array(
@@ -2577,7 +2636,7 @@ var EventIngestBatchSchema = z14.array(
   {
     id: "EventIngestBatch",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var TreatmentInteractionTypeSchema = z14.enum([
@@ -2606,6 +2665,12 @@ var TreatmentInteractionInputSchema = z14.object({
   payload_id: z14.string().min(1).optional().meta(Unrestricted11),
   interaction_type: TreatmentInteractionTypeSchema.meta(Unrestricted11),
   interaction_at: z14.string().datetime().optional().meta(Unrestricted11),
+  /**
+   * Caller-declared test traffic (plan 164) — mirrors `TrackEvent.test` so
+   * the presentation/interaction feed (the dashboard denominators) carries
+   * the same default-excluded, `include_test`-toggleable dimension.
+   */
+  test: z14.boolean().optional().meta(Unrestricted11),
   metadata: z14.record(z14.string(), z14.unknown()).optional().meta(Unrestricted11)
 }).meta(
   {
@@ -2754,21 +2819,21 @@ var EventSearchParamsSchema = z14.object({
   {
     id: "EventSearchParams",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var WebhookEventSourceSchema = z14.enum(["stripe", "apple", "google"]).meta(
   {
     id: "WebhookEventSource",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var WebhookEventStatusSchema = z14.enum(["processed", "failed", "skipped"]).meta(
   {
     id: "WebhookEventStatus",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var WebhookEventLogSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
@@ -2783,7 +2848,7 @@ var WebhookEventLogSchema = IdField.merge(TimestampFields).merge(TenantIdField).
   {
     id: "WebhookEventLog",
     "x-revturbine-schema-persistence": Persisted11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var EventIngestResponseSchema = z14.object({
@@ -2792,7 +2857,7 @@ var EventIngestResponseSchema = z14.object({
   {
     id: "null",
     "x-revturbine-schema-persistence": Transient11,
-    "x-revturbine-schema-exposure": Internal8
+    "x-revturbine-schema-exposure": Internal9
   }
 );
 var MAX_TRACK_EVENTS_PER_BATCH = 500;
@@ -2837,7 +2902,16 @@ var TrackEventSchema = z14.object({
   /** Immutable Playbook version that produced the experience. The field that makes a past decision reproducible. */
   playbook_version: z14.string().nullable().optional().meta(Unrestricted11),
   /** Correlates every event caused by one decision — a join key, not a group-by. */
-  decision_id: z14.string().nullable().optional().meta(Unrestricted11)
+  decision_id: z14.string().nullable().optional().meta(Unrestricted11),
+  /**
+   * Caller-declared test traffic (plan 164): set from the SDK's `test` init
+   * option, stamped on every emitted event. Analytics pipes exclude
+   * `test = true` rows from denominators/rollups by default, with an
+   * `include_test` pipe parameter as the opt-in toggle. Distinct from the
+   * placement "Test Mode" (plan 08c), which is a server-decided per-user
+   * flag on DECISIONING responses — this one marks EMITTED events.
+   */
+  test: z14.boolean().optional().meta(Unrestricted11)
 }).meta(
   {
     id: "TrackEvent",
@@ -2855,7 +2929,7 @@ var TrackIngestBatchSchema = z14.object({
   }
 );
 var MAX_SDK_META_EVENTS_PER_BATCH = 10;
-var SdkMetaEventTypeSchema = z14.enum(["sdk_init", "sdk_error", "sdk_validation_warning"]).meta(
+var SdkMetaEventTypeSchema = z14.enum(["sdk_init", "sdk_error", "sdk_validation_warning", "resolution_failure"]).meta(
   {
     id: "SdkMetaEventType",
     "x-revturbine-schema-persistence": Transient11,
@@ -2893,7 +2967,19 @@ var SdkMetaEventSchema = z14.object({
   // Present for sdk_init; config-shape counts only, no user context (REQ-6).
   config_shape: SdkConfigShapeSchema.optional().meta(Unrestricted11),
   // Short non-PII diagnostic for sdk_error / sdk_validation_warning.
-  message: z14.string().max(500).optional().meta(Unrestricted11)
+  message: z14.string().max(500).optional().meta(Unrestricted11),
+  // Diagnostic fields for `resolution_failure` (plan 144 TASK-20; absorbed
+  // plan 124 REQ-5/AC-6 — its Q-1 allow-list, append-only). Every value is
+  // an AUTHOR-DEFINED handle or a closed reason code — never user-supplied
+  // free text; `message` above remains the only prose field and stays
+  // length-capped. Emitted from the SDK's fallback/deny sites so a
+  // placement that silently resolves to nothing becomes observable.
+  reason: z14.string().min(1).max(64).optional().meta(Unrestricted11),
+  placement_handle: z14.string().min(1).max(64).optional().meta(Unrestricted11),
+  slot_handle: z14.string().min(1).max(64).optional().meta(Unrestricted11),
+  surface: z14.string().min(1).max(64).optional().meta(Unrestricted11),
+  plan_handle: z14.string().min(1).max(64).optional().meta(Unrestricted11),
+  entitlement_handle: z14.string().min(1).max(64).optional().meta(Unrestricted11)
 }).meta(
   {
     id: "SdkMetaEvent",
@@ -2985,17 +3071,17 @@ var eventPaths = {
 };
 var { Unrestricted: Unrestricted12 } = DataClassification;
 var { Persisted: Persisted12, Transient: Transient12 } = SchemaPersistence;
-var { Internal: Internal9 } = SchemaExposure;
+var { Internal: Internal10 } = SchemaExposure;
 var PLAYBOOK_SDK_FACETS6 = schemaFacets(SchemaContext.Playbook, { sdkInput: true });
 var PENDING_PLAYBOOK_SDK_FACETS2 = schemaFacets(SchemaContext.Playbook, {
   inConfig: false,
   sdkInput: true
 });
 var TrialStatusSchema = z15.enum(["not_started", "active", "expired", "converted", "cancelled"]).meta(
-  { id: "TrialStatus", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "TrialStatus", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal10 }
 );
 var TrialLimitTypeSchema = z15.enum(["time", "usage"]).meta(
-  { id: "TrialLimitType", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "TrialLimitType", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal10 }
 );
 var FreeTrialRuleCoreFieldsSchema = z15.object({
   name: NameField.meta(Unrestricted12),
@@ -3043,11 +3129,11 @@ var FreeTrialRuleCoreFieldsSchema = z15.object({
 var FreeTrialRuleSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z15.string().min(1).meta({ ...Unrestricted12, readOnly: true })
 }).merge(FreeTrialRuleCoreFieldsSchema).meta(
-  { id: "FreeTrialRule", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal9, ...PLAYBOOK_SDK_FACETS6, ...namedIdentity() }
+  { id: "FreeTrialRule", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal10, ...PLAYBOOK_SDK_FACETS6, ...namedIdentity() }
 );
 var FreeTrialRuleAnchorSchema = makeAnchor("FreeTrialRuleAnchor");
 var ReverseTrialStartPolicySchema = z15.enum(["signup", "first_premium_access", "manual"]).meta(
-  { id: "ReverseTrialStartPolicy", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "ReverseTrialStartPolicy", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal10 }
 );
 var ReverseTrialRuleCoreFieldsSchema = z15.object({
   name: NameField.meta(Unrestricted12),
@@ -3068,26 +3154,26 @@ var ReverseTrialRuleCoreFieldsSchema = z15.object({
 var ReverseTrialRuleSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z15.string().min(1).meta({ ...Unrestricted12, readOnly: true })
 }).merge(ReverseTrialRuleCoreFieldsSchema).meta(
-  { id: "ReverseTrialRule", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal9, ...PLAYBOOK_SDK_FACETS6, ...namedIdentity() }
+  { id: "ReverseTrialRule", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal10, ...PLAYBOOK_SDK_FACETS6, ...namedIdentity() }
 );
 var ReverseTrialRuleAnchorSchema = makeAnchor("ReverseTrialRuleAnchor");
 var TrialLimitPolicySchema = z15.enum(["1_per_lifetime", "1_per_plan", "1_per_year", "unlimited"]).meta(
-  { id: "TrialLimitPolicy", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "TrialLimitPolicy", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal10 }
 );
 var TrialEligibilityScopeSchema = z15.enum(["per_customer", "per_email_domain"]).meta(
-  { id: "TrialEligibilityScope", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "TrialEligibilityScope", "x-revturbine-schema-persistence": Transient12, "x-revturbine-schema-exposure": Internal10 }
 );
 var FreeTrialSettingsSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   trial_limit_policy: TrialLimitPolicySchema.default("1_per_lifetime").meta(Unrestricted12),
   eligibility_scope: TrialEligibilityScopeSchema.default("per_customer").meta(Unrestricted12)
 }).meta(
-  { id: "FreeTrialSettings", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal9, ...PENDING_PLAYBOOK_SDK_FACETS2 }
+  { id: "FreeTrialSettings", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal10, ...PENDING_PLAYBOOK_SDK_FACETS2 }
 );
 var ReverseTrialSettingsSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   trial_limit_policy: TrialLimitPolicySchema.default("1_per_lifetime").meta(Unrestricted12),
   eligibility_scope: TrialEligibilityScopeSchema.default("per_customer").meta(Unrestricted12)
 }).meta(
-  { id: "ReverseTrialSettings", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal9, ...PENDING_PLAYBOOK_SDK_FACETS2 }
+  { id: "ReverseTrialSettings", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal10, ...PENDING_PLAYBOOK_SDK_FACETS2 }
 );
 var TrialInstanceSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   customer_id: z15.string().min(1).meta(Unrestricted12),
@@ -3127,7 +3213,7 @@ var TrialInstanceSchema = IdField.merge(TimestampFields).merge(TenantIdField).ex
   cancelled_at: NullableDatetimeField.meta(Unrestricted12),
   metadata: MetadataField.meta(Unrestricted12)
 }).meta(
-  { id: "TrialInstance", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal9 }
+  { id: "TrialInstance", "x-revturbine-schema-persistence": Persisted12, "x-revturbine-schema-exposure": Internal10 }
 );
 var trialPaths = {
   "/api/free-trial-rule-anchors": {
@@ -3364,16 +3450,16 @@ var trialPaths = {
 };
 var { Unrestricted: Unrestricted13 } = DataClassification;
 var { Persisted: Persisted13, Transient: Transient13 } = SchemaPersistence;
-var { Internal: Internal10 } = SchemaExposure;
+var { Internal: Internal11 } = SchemaExposure;
 var PENDING_PLAYBOOK_SDK_FACETS3 = schemaFacets(SchemaContext.Playbook, {
   inConfig: false,
   sdkInput: true
 });
 var ExperimentStatusSchema = z16.enum(["draft", "ramping", "winning", "neutral", "needs_attention", "paused", "complete"]).meta(
-  { id: "ExperimentStatus", "x-revturbine-schema-persistence": Transient13, "x-revturbine-schema-exposure": Internal10 }
+  { id: "ExperimentStatus", "x-revturbine-schema-persistence": Transient13, "x-revturbine-schema-exposure": Internal11 }
 );
 var ExperimentTypeSchema = z16.enum(["placement_ab", "entitlement_ab", "plan_ab", "pricing_ab", "custom"]).meta(
-  { id: "ExperimentType", "x-revturbine-schema-persistence": Transient13, "x-revturbine-schema-exposure": Internal10 }
+  { id: "ExperimentType", "x-revturbine-schema-persistence": Transient13, "x-revturbine-schema-exposure": Internal11 }
 );
 var ExperimentVariantSchema = z16.object({
   variant_id: z16.string().min(1),
@@ -3382,7 +3468,7 @@ var ExperimentVariantSchema = z16.object({
   is_control: z16.boolean().default(false),
   config: z16.record(z16.string(), z16.unknown()).default({})
 }).meta(
-  { id: "ExperimentVariant", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal10, ...PENDING_PLAYBOOK_SDK_FACETS3 }
+  { id: "ExperimentVariant", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal11, ...PENDING_PLAYBOOK_SDK_FACETS3 }
 );
 var ExperimentSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z16.string().min(1).meta({ ...Unrestricted13, readOnly: true }),
@@ -3406,7 +3492,7 @@ var ExperimentSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge
   winning_variant_id: z16.string().nullable().default(null).meta(Unrestricted13),
   metadata: MetadataField.meta(Unrestricted13)
 }).meta(
-  { id: "Experiment", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal10, ...PENDING_PLAYBOOK_SDK_FACETS3, ...namedIdentity() }
+  { id: "Experiment", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal11, ...PENDING_PLAYBOOK_SDK_FACETS3, ...namedIdentity() }
 );
 var ExperimentAnchorSchema = makeAnchor("ExperimentAnchor");
 var SuggestionSeveritySchema = SeveritySchema;
@@ -3422,7 +3508,7 @@ var OptimizationSuggestionSchema = IdField.merge(TimestampFields).merge(TenantId
   is_dismissed: z16.boolean().default(false).meta(Unrestricted13),
   metadata: MetadataField.meta(Unrestricted13)
 }).meta(
-  { id: "OptimizationSuggestion", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal10 }
+  { id: "OptimizationSuggestion", "x-revturbine-schema-persistence": Persisted13, "x-revturbine-schema-exposure": Internal11 }
 );
 var experimentPaths = {
   "/api/experiment-anchors": {
@@ -3535,15 +3621,15 @@ var experimentPaths = {
     })
   }
 };
-var { Unrestricted: Unrestricted14, Financial: Financial3 } = DataClassification;
+var { Unrestricted: Unrestricted14, Financial: Financial4 } = DataClassification;
 var { Persisted: Persisted14, Transient: Transient14 } = SchemaPersistence;
-var { Internal: Internal11 } = SchemaExposure;
+var { Internal: Internal12 } = SchemaExposure;
 var PLAYBOOK_SDK_FACETS7 = schemaFacets(SchemaContext.Playbook, { sdkInput: true });
 var PromotionStatusSchema = z17.enum(["draft", "scheduled", "live", "expired", "archived"]).meta(
-  { id: "PromotionStatus", "x-revturbine-schema-persistence": Transient14, "x-revturbine-schema-exposure": Internal11 }
+  { id: "PromotionStatus", "x-revturbine-schema-persistence": Transient14, "x-revturbine-schema-exposure": Internal12 }
 );
 var DiscountTypeSchema = z17.enum(["percentage", "fixed_amount", "free_months"]).meta(
-  { id: "DiscountType", "x-revturbine-schema-persistence": Transient14, "x-revturbine-schema-exposure": Internal11 }
+  { id: "DiscountType", "x-revturbine-schema-persistence": Transient14, "x-revturbine-schema-exposure": Internal12 }
 );
 var PromotionSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z17.string().min(1).meta({ ...Unrestricted14, readOnly: true }),
@@ -3552,8 +3638,8 @@ var PromotionSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(
   description: z17.string().max(1e3).optional().meta(Unrestricted14),
   rt_status: PromotionStatusSchema.default("draft").meta(Unrestricted14),
   discount_type: DiscountTypeSchema.meta(Unrestricted14),
-  discount_value: z17.number().min(0).meta(Financial3),
-  currency: z17.string().length(3).default("USD").meta(Financial3),
+  discount_value: z17.number().min(0).meta(Financial4),
+  currency: z17.string().length(3).default("USD").meta(Financial4),
   applicable_plan_ids: z17.array(z17.string()).default([]).meta(Unrestricted14),
   applicable_addon_ids: z17.array(z17.string()).default([]).meta(Unrestricted14),
   target_segment_ids: z17.array(z17.string()).default([]).meta(Unrestricted14),
@@ -3568,7 +3654,7 @@ var PromotionSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(
   auto_sync_stripe: z17.boolean().default(false).meta(Unrestricted14),
   metadata: MetadataField.meta(Unrestricted14)
 }).meta(
-  { id: "Promotion", "x-revturbine-schema-persistence": Persisted14, "x-revturbine-schema-exposure": Internal11, ...PLAYBOOK_SDK_FACETS7, ...namedIdentity() }
+  { id: "Promotion", "x-revturbine-schema-persistence": Persisted14, "x-revturbine-schema-exposure": Internal12, ...PLAYBOOK_SDK_FACETS7, ...namedIdentity() }
 );
 var PromotionAnchorSchema = makeAnchor("PromotionAnchor");
 var promotionPaths = {
@@ -3653,7 +3739,7 @@ var promotionPaths = {
 };
 var { Unrestricted: Unrestricted15, Pii: Pii5 } = DataClassification;
 var { Persisted: Persisted15, Transient: Transient15 } = SchemaPersistence;
-var { Internal: Internal12, External: External10 } = SchemaExposure;
+var { Internal: Internal13, External: External10 } = SchemaExposure;
 var PresentationRecordSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   customer_id: z18.string().min(1).meta(Pii5),
   placement_id: z18.string().min(1).meta(Unrestricted15),
@@ -3668,7 +3754,7 @@ var PresentationRecordSchema = IdField.merge(TimestampFields).merge(TenantIdFiel
   session_id: z18.string().optional().meta(Unrestricted15),
   metadata: MetadataField.meta(Unrestricted15)
 }).meta(
-  { id: "PresentationRecord", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal12 }
+  { id: "PresentationRecord", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal13 }
 );
 var DecisionLogSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   customer_id: z18.string().min(1).meta(Pii5),
@@ -3684,7 +3770,7 @@ var DecisionLogSchema = IdField.merge(TimestampFields).merge(TenantIdField).exte
   variant_id: z18.string().nullable().default(null).meta(Unrestricted15),
   latency_ms: z18.number().min(0).optional().meta(Unrestricted15)
 }).meta(
-  { id: "DecisionLog", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal12 }
+  { id: "DecisionLog", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal13 }
 );
 var EntitlementEvalLogSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   customer_id: z18.string().min(1).meta(Pii5),
@@ -3697,7 +3783,7 @@ var EntitlementEvalLogSchema = IdField.merge(TimestampFields).merge(TenantIdFiel
   source_id: z18.string().min(1).meta(Unrestricted15),
   latency_ms: z18.number().min(0).optional().meta(Unrestricted15)
 }).meta(
-  { id: "EntitlementEvalLog", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal12 }
+  { id: "EntitlementEvalLog", "x-revturbine-schema-persistence": Persisted15, "x-revturbine-schema-exposure": Internal13 }
 );
 var runtimePaths = {
   "/api/presentation-records": {
@@ -3733,7 +3819,7 @@ var runtimePaths = {
 };
 var { Unrestricted: Unrestricted16 } = DataClassification;
 var { Persisted: Persisted16, Transient: Transient16 } = SchemaPersistence;
-var { Internal: Internal13, External: External11 } = SchemaExposure;
+var { Internal: Internal14, External: External11 } = SchemaExposure;
 var PLAYBOOK_SDK_FACETS8 = schemaFacets(SchemaContext.Playbook, { sdkInput: true });
 var PLAYBOOK_AUTHORING_FACETS2 = schemaFacets(SchemaContext.Playbook, { sdkInput: false });
 var PENDING_PLAYBOOK_FACETS4 = schemaFacets(SchemaContext.Playbook, {
@@ -3776,7 +3862,7 @@ var SeatTypeSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(A
   entitlement_ids: z19.array(z19.string()).default([]).meta(Unrestricted16),
   metadata: MetadataField.meta(Unrestricted16)
 }).meta(
-  { id: "SeatType", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...PENDING_PLAYBOOK_FACETS4, ...namedIdentity() }
+  { id: "SeatType", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...PENDING_PLAYBOOK_FACETS4, ...namedIdentity() }
 );
 var SeatTypeAnchorSchema = makeAnchor("SeatTypeAnchor");
 var PersonalizationTokenSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
@@ -3791,10 +3877,10 @@ var PersonalizationTokenSchema = IdField.merge(TimestampFields).merge(TenantIdFi
   format: z19.enum(["string", "number", "currency", "percentage", "date"]).nullable().default(null).meta(Unrestricted16),
   metadata: MetadataField.meta(Unrestricted16)
 }).meta(
-  { id: "PersonalizationToken", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...PENDING_PLAYBOOK_FACETS4, ...namedIdentity() }
+  { id: "PersonalizationToken", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...PENDING_PLAYBOOK_FACETS4, ...namedIdentity() }
 );
 var PersonalizationTokenAnchorSchema = makeAnchor("PersonalizationTokenAnchor");
-var OnboardingStateSchema = z19.enum(["not_started", "started", "details_submitted", "charges_enabled", "activated", "deauthorized"]).meta({ id: "OnboardingState", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 });
+var OnboardingStateSchema = z19.enum(["not_started", "started", "details_submitted", "charges_enabled", "activated", "deauthorized"]).meta({ id: "OnboardingState", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 });
 var StripeIntegrationConfigSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   handle: HandleField.meta({ ...Unrestricted16, readOnly: true }),
   stripe_account_id: z19.string().min(1).meta(Unrestricted16),
@@ -3820,7 +3906,7 @@ var StripeIntegrationConfigSchema = IdField.merge(TimestampFields).merge(TenantI
   last_sync_at: z19.string().optional().meta({ ...Unrestricted16, readOnly: true }),
   metadata: MetadataField.meta(Unrestricted16)
 }).meta(
-  { id: "StripeIntegrationConfig", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...BILLING_FACETS2, ...mintedIdentity() }
+  { id: "StripeIntegrationConfig", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...BILLING_FACETS2, ...mintedIdentity() }
 );
 var BrandingConfigSchema = z19.object({
   theme: z19.record(z19.string(), z19.unknown()).optional().meta(Unrestricted16),
@@ -3845,10 +3931,10 @@ var MeteringConfigSchema = IdField.merge(TimestampFields).merge(TenantIdField).m
   is_active: z19.boolean().default(true).meta(Unrestricted16),
   metadata: MetadataField.meta(Unrestricted16)
 }).meta(
-  { id: "MeteringConfig", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...METERING_FACETS, ...mintedIdentity() }
+  { id: "MeteringConfig", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...METERING_FACETS, ...mintedIdentity() }
 );
 var EnforcementActionSchema = z19.enum(["block", "warn", "downgrade", "throttle", "notify_admin", "custom"]).meta(
-  { id: "EnforcementAction", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 }
+  { id: "EnforcementAction", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 }
 );
 var UsageEnforcementSettingsSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z19.string().min(1).meta({ ...Unrestricted16, readOnly: true }),
@@ -3862,7 +3948,7 @@ var UsageEnforcementSettingsSchema = IdField.merge(TimestampFields).merge(Tenant
   notification_channels: z19.array(z19.enum(["email", "in_app", "webhook"])).default(["in_app"]).meta(Unrestricted16),
   is_active: z19.boolean().default(true).meta(Unrestricted16)
 }).meta(
-  { id: "UsageEnforcementSettings", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...PENDING_PLAYBOOK_SDK_FACETS4, ...mintedIdentity() }
+  { id: "UsageEnforcementSettings", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...PENDING_PLAYBOOK_SDK_FACETS4, ...mintedIdentity() }
 );
 var UsageEnforcementSettingsAnchorSchema = makeAnchor("UsageEnforcementSettingsAnchor");
 var PlacementSettingsCapRuleGroupItemSchema = z19.object({
@@ -3870,7 +3956,7 @@ var PlacementSettingsCapRuleGroupItemSchema = z19.object({
   id: z19.string().min(1).meta(Unrestricted16),
   label: z19.string().min(1).optional().meta(Unrestricted16)
 }).meta(
-  { id: "PlacementSettingsCapRuleGroupItem", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 }
+  { id: "PlacementSettingsCapRuleGroupItem", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 }
 );
 var PlacementSettingsCapRuleSchema = z19.object({
   id: z19.string().min(1).meta(Unrestricted16),
@@ -3880,17 +3966,21 @@ var PlacementSettingsCapRuleSchema = z19.object({
     period: z19.enum(["session", "day", "week", "month"]).meta(Unrestricted16)
   }).meta(Unrestricted16)
 }).meta(
-  { id: "PlacementSettingsCapRule", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 }
+  { id: "PlacementSettingsCapRule", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 }
 );
 var PlacementTestModeSchema = z19.enum(["off", "test_users", "all_traffic"]).meta(
-  { id: "PlacementTestMode", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 }
+  { id: "PlacementTestMode", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 }
 );
 var PlacementSettingsCapStateSchema = z19.object({
   capRules: z19.array(PlacementSettingsCapRuleSchema).default([]).meta(Unrestricted16),
   sessionCooldownMinutes: z19.number().int().min(0).default(30).meta(Unrestricted16),
+  // Tenant-level default remind-me-later (defer) window, in minutes. A
+  // per-payload `remind_later_minutes` overrides it when set (plan 167 REQ-6,
+  // Q-3). Rides in this global_frequency_cap jsonb wrapper — no column/`.fbs`.
+  remindLaterMinutes: z19.number().int().min(0).default(60).meta(Unrestricted16),
   testMode: PlacementTestModeSchema.default("off").meta(Unrestricted16)
 }).meta(
-  { id: "PlacementSettingsCapState", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal13 }
+  { id: "PlacementSettingsCapState", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": Internal14 }
 );
 var PlacementSettingsSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   anchor_id: z19.string().min(1).meta({ ...Unrestricted16, readOnly: true }),
@@ -3902,11 +3992,12 @@ var PlacementSettingsSchema = IdField.merge(TimestampFields).merge(TenantIdField
   global_frequency_cap_period: z19.enum(["hour", "day", "week", "month", "session"]).nullable().default(null).meta(Unrestricted16),
   suppress_for_paid: z19.boolean().default(false).meta(Unrestricted16),
   suppress_for_trial: z19.boolean().default(false).meta(Unrestricted16),
-  default_dismiss_cooldown_hours: z19.number().int().min(0).default(24).meta(Unrestricted16),
+  // `default_dismiss_cooldown_hours` removed (plan 167 Q-2): the dismiss
+  // cooldown is defined per-payload in days (`cooldown_after_dismiss_days`).
   allow_stacking: z19.boolean().default(false).meta(Unrestricted16),
   priority_collision_strategy: z19.enum(["highest_priority", "most_recent", "random"]).default("highest_priority").meta(Unrestricted16)
 }).meta(
-  { id: "PlacementSettings", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal13, ...PENDING_PLAYBOOK_SDK_FACETS4, ...mintedIdentity() }
+  { id: "PlacementSettings", "x-revturbine-schema-persistence": Persisted16, "x-revturbine-schema-exposure": Internal14, ...PENDING_PLAYBOOK_SDK_FACETS4, ...mintedIdentity() }
 );
 var PlacementSettingsAnchorSchema = makeAnchor("PlacementSettingsAnchor");
 var RevTurbineConfigSegmentsItemPredicatesItemSchema = z19.object({
@@ -4014,7 +4105,7 @@ var RevTurbineConfigPlacementSettingsItemSchema = z19.object({
   global_frequency_cap_period: z19.enum(["hour", "day", "week", "month", "session"]).nullable().default(null).meta(Unrestricted16),
   suppress_for_paid: z19.boolean().default(false).meta(Unrestricted16),
   suppress_for_trial: z19.boolean().default(false).meta(Unrestricted16),
-  default_dismiss_cooldown_hours: z19.number().int().min(0).nullable().default(null).meta(Unrestricted16),
+  // `default_dismiss_cooldown_hours` removed (plan 167 Q-2).
   allow_stacking: z19.boolean().default(false).meta(Unrestricted16),
   priority_collision_strategy: z19.string().nullable().default(null).meta(Unrestricted16)
 }).meta(
@@ -4156,7 +4247,11 @@ var RevTurbineConfigUiPathActionTypeSchema = z19.enum([
   "verify_work_email",
   "update_payment_method",
   "enable_auto_renewal",
-  "manage_subscription"
+  "manage_subscription",
+  // Authored `snooze` resolves through to the SDK's remind-later path
+  // (plan 167 windows); previously it fell through as an invalid type
+  // (plan 174 TASK-6 / Q-5, spec-check F-65a).
+  "snooze"
 ]).meta(
   { id: "RevTurbineConfigUiPathActionType", "x-revturbine-schema-persistence": Transient16, "x-revturbine-schema-exposure": External11 }
 );
@@ -4265,6 +4360,8 @@ var RevTurbineConfigStudioPayloadSchema = z19.object({
   caps: RevTurbineConfigStudioPayloadCapsSchema.optional().meta(Unrestricted16),
   // Optional slot targeting (spec §3.1.1): empty/absent = any compatible slot.
   surface_slot_ids: z19.array(z19.string()).optional().meta(Unrestricted16),
+  // Per-payload remind-me-later override (minutes); absent = inherit tenant default (plan 167 Q-3).
+  remind_later_minutes: z19.number().int().min(0).nullable().optional().meta(Unrestricted16),
   created_at: z19.string().optional().meta({ ...Unrestricted16, readOnly: true }),
   recommendation_strategy: z19.enum(["next_tier_up", "best_value", "custom"]).optional().default("next_tier_up").meta(Unrestricted16),
   recommendation_plan_override: z19.string().optional().meta(Unrestricted16)
@@ -4304,6 +4401,8 @@ var RevTurbineConfigPlacementPayloadItemSchema = z19.object({
   placement_id: z19.string().min(1).meta(Unrestricted16),
   target: RevTurbineConfigStudioPayloadTargetSchema.meta(Unrestricted16),
   caps: RevTurbineConfigStudioPayloadCapsSchema.optional().meta(Unrestricted16),
+  // Per-payload remind-me-later override (minutes); absent = inherit tenant default (plan 167 Q-3).
+  remind_later_minutes: z19.number().int().min(0).nullable().optional().meta(Unrestricted16),
   created_at: z19.string().meta({ ...Unrestricted16, readOnly: true }),
   updated_at: z19.string().datetime().optional().meta({ ...Unrestricted16, readOnly: true }),
   source_mode: z19.enum(["inline", "content_linked"]).meta(Unrestricted16),
@@ -4534,6 +4633,12 @@ var PlaybookSchema = z19.preprocess(normalizeConfigHeaderInput, PlaybookObjectSc
   "x-revturbine-schema-exposure": External11,
   ...PLAYBOOK_SDK_FACETS8
 });
+var PlaybookStrictSchema = z19.preprocess(normalizeConfigHeaderInput, PlaybookObjectSchema.strict()).meta({
+  id: "PlaybookStrict",
+  "x-revturbine-schema-persistence": Transient16,
+  "x-revturbine-schema-exposure": External11,
+  ...PLAYBOOK_SDK_FACETS8
+});
 var RevTurbineConfigSchema = PlaybookSchema;
 var configPaths = {
   "/api/seat-type-anchors": {
@@ -4773,9 +4878,9 @@ var configPaths = {
 };
 var { Unrestricted: Unrestricted17 } = DataClassification;
 var { Persisted: Persisted17 } = SchemaPersistence;
-var { Internal: Internal14 } = SchemaExposure;
+var { Internal: Internal15 } = SchemaExposure;
 var ChangeLogActionSchema = z20.enum(["create", "update", "delete", "archive", "restore", "reorder", "duplicate", "sync", "publish"]).meta(
-  { id: "ChangeLogAction", "x-revturbine-schema-persistence": Persisted17, "x-revturbine-schema-exposure": Internal14 }
+  { id: "ChangeLogAction", "x-revturbine-schema-persistence": Persisted17, "x-revturbine-schema-exposure": Internal15 }
 );
 var ChangeLogEntrySchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   action: ChangeLogActionSchema.meta(Unrestricted17),
@@ -4791,7 +4896,7 @@ var ChangeLogEntrySchema = IdField.merge(TimestampFields).merge(TenantIdField).e
   summary: z20.string().max(1e3).optional().meta(Unrestricted17),
   metadata: MetadataField.meta(Unrestricted17)
 }).meta(
-  { id: "ChangeLogEntry", "x-revturbine-schema-persistence": Persisted17, "x-revturbine-schema-exposure": Internal14 }
+  { id: "ChangeLogEntry", "x-revturbine-schema-persistence": Persisted17, "x-revturbine-schema-exposure": Internal15 }
 );
 var changelogPaths = {
   "/api/changelog": {
@@ -4817,9 +4922,9 @@ var changelogPaths = {
 };
 var { Unrestricted: Unrestricted18 } = DataClassification;
 var { Persisted: Persisted18, Transient: Transient17 } = SchemaPersistence;
-var { Internal: Internal15 } = SchemaExposure;
+var { Internal: Internal16 } = SchemaExposure;
 var TenantStatusSchema = z21.enum(["active", "suspended", "archived"]).meta(
-  { id: "TenantStatus", "x-revturbine-schema-persistence": Transient17, "x-revturbine-schema-exposure": Internal15 }
+  { id: "TenantStatus", "x-revturbine-schema-persistence": Transient17, "x-revturbine-schema-exposure": Internal16 }
 );
 var TenantSchema = IdField.merge(TimestampFields).extend({
   name: NameField.meta(Unrestricted18),
@@ -4827,7 +4932,7 @@ var TenantSchema = IdField.merge(TimestampFields).extend({
   status: TenantStatusSchema.default("active").meta(Unrestricted18),
   metadata: MetadataField.meta(Unrestricted18)
 }).meta(
-  { id: "Tenant", "x-revturbine-schema-persistence": Persisted18, "x-revturbine-schema-exposure": Internal15 }
+  { id: "Tenant", "x-revturbine-schema-persistence": Persisted18, "x-revturbine-schema-exposure": Internal16 }
 );
 var tenantPaths = {
   "/api/tenants": {
@@ -4893,9 +4998,9 @@ var tenantPaths = {
 };
 var { Unrestricted: Unrestricted19 } = DataClassification;
 var { Persisted: Persisted19, Transient: Transient18 } = SchemaPersistence;
-var { Internal: Internal16 } = SchemaExposure;
+var { Internal: Internal17 } = SchemaExposure;
 var EnvironmentStatusSchema = z22.enum(["active", "archived", "locked"]).meta(
-  { id: "EnvironmentStatus", "x-revturbine-schema-persistence": Transient18, "x-revturbine-schema-exposure": Internal16 }
+  { id: "EnvironmentStatus", "x-revturbine-schema-persistence": Transient18, "x-revturbine-schema-exposure": Internal17 }
 );
 var EnvironmentSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   name: NameField.meta(Unrestricted19),
@@ -4914,7 +5019,7 @@ var EnvironmentSchema = IdField.merge(TimestampFields).merge(TenantIdField).exte
   created_by: z22.string().optional().meta(Unrestricted19),
   metadata: MetadataField.meta(Unrestricted19)
 }).meta(
-  { id: "Environment", "x-revturbine-schema-persistence": Persisted19, "x-revturbine-schema-exposure": Internal16 }
+  { id: "Environment", "x-revturbine-schema-persistence": Persisted19, "x-revturbine-schema-exposure": Internal17 }
 );
 var EnvironmentPromotionRequestSchema = z22.object({
   source_environment_id: z22.string().min(1),
@@ -4922,7 +5027,7 @@ var EnvironmentPromotionRequestSchema = z22.object({
   playbook_version_ids: z22.array(z22.string()).optional(),
   strategy: z22.enum(["all_current", "selected_playbook_versions"]).default("all_current")
 }).meta(
-  { id: "EnvironmentPromotionRequest", "x-revturbine-schema-persistence": Transient18, "x-revturbine-schema-exposure": Internal16 }
+  { id: "EnvironmentPromotionRequest", "x-revturbine-schema-persistence": Transient18, "x-revturbine-schema-exposure": Internal17 }
 );
 var environmentPaths = {
   "/api/environments": {
@@ -5101,7 +5206,7 @@ var ServerEvaluationPayloadSchema = z23.object({
 }).meta({ id: "ServerEvaluationPayload", "x-revturbine-schema-persistence": Transient19, "x-revturbine-schema-exposure": External12 });
 var { Unrestricted: Unrestricted21 } = DataClassification;
 var { Persisted: Persisted21, Transient: Transient20 } = SchemaPersistence;
-var { Internal: Internal17 } = SchemaExposure;
+var { Internal: Internal18 } = SchemaExposure;
 var PlaybookVersionStatusSchema = z24.enum([
   "draft",
   "awaiting_approval",
@@ -5111,7 +5216,7 @@ var PlaybookVersionStatusSchema = z24.enum([
   "rejected",
   "archived"
 ]).meta(
-  { id: "PlaybookVersionStatus", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal17 }
+  { id: "PlaybookVersionStatus", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal18 }
 );
 var PlaybookVersionSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   environment_id: z24.string().min(1).meta(Unrestricted21),
@@ -5148,7 +5253,7 @@ var PlaybookVersionSchema = IdField.merge(TimestampFields).merge(TenantIdField).
   bundle: z24.string().nullable().default(null).meta({ ...Unrestricted21, readOnly: true }),
   metadata: MetadataField.meta(Unrestricted21)
 }).meta(
-  { id: "PlaybookVersion", "x-revturbine-schema-persistence": Persisted21, "x-revturbine-schema-exposure": Internal17 }
+  { id: "PlaybookVersion", "x-revturbine-schema-persistence": Persisted21, "x-revturbine-schema-exposure": Internal18 }
 );
 var PlaybookVersionEntrySummarySchema = z24.object({
   handle: z24.string().meta(Unrestricted21),
@@ -5157,7 +5262,7 @@ var PlaybookVersionEntrySummarySchema = z24.object({
   action: z24.enum(["create", "update", "delete"]).meta(Unrestricted21),
   has_conflict: z24.boolean().meta(Unrestricted21)
 }).meta(
-  { id: "PlaybookVersionEntrySummary", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal17 }
+  { id: "PlaybookVersionEntrySummary", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal18 }
 );
 var PlaybookVersionDiffSchema = z24.object({
   playbook_version_id: z24.string().meta(Unrestricted21),
@@ -5166,7 +5271,7 @@ var PlaybookVersionDiffSchema = z24.object({
   total_conflicts: z24.number().int().min(0).meta(Unrestricted21),
   deployable: z24.boolean().meta(Unrestricted21)
 }).meta(
-  { id: "PlaybookVersionDiff", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal17 }
+  { id: "PlaybookVersionDiff", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal18 }
 );
 var PlaybookVersionDeployResultSchema = z24.object({
   playbook_version_id: z24.string().meta(Unrestricted21),
@@ -5175,7 +5280,7 @@ var PlaybookVersionDeployResultSchema = z24.object({
   skipped_conflicts: z24.number().int().min(0).meta(Unrestricted21),
   deployed_at: z24.string().datetime().meta(Unrestricted21)
 }).meta(
-  { id: "PlaybookVersionDeployResult", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal17 }
+  { id: "PlaybookVersionDeployResult", "x-revturbine-schema-persistence": Transient20, "x-revturbine-schema-exposure": Internal18 }
 );
 var playbookVersionPaths = {
   // ── Lifecycle transitions ────────────────────────────────────────────────
@@ -5302,8 +5407,8 @@ var playbookVersionPaths = {
 };
 var { Unrestricted: Unrestricted22, Pii: Pii7 } = DataClassification;
 var { Persisted: Persisted22 } = SchemaPersistence;
-var { Internal: Internal18 } = SchemaExposure;
-var ApiKeyStatusSchema = z25.enum(["active", "revoked", "rotating"]).meta({ id: "ApiKeyStatus", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+var { Internal: Internal19 } = SchemaExposure;
+var ApiKeyStatusSchema = z25.enum(["active", "revoked", "rotating"]).meta({ id: "ApiKeyStatus", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var ApiKeySchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   name: NameField.meta(Unrestricted22),
   key_hash: z25.string().min(1).meta({ ...Pii7, readOnly: true }),
@@ -5312,22 +5417,22 @@ var ApiKeySchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   status: ApiKeyStatusSchema.default("active").meta(Unrestricted22),
   last_used_at: NullableDatetimeField.meta({ ...Unrestricted22, readOnly: true }),
   expires_at: NullableDatetimeField.meta(Unrestricted22)
-}).meta({ id: "ApiKey", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
-var FlagValueTypeSchema = z25.enum(["boolean", "string", "number", "json"]).meta({ id: "FlagValueType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "ApiKey", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
+var FlagValueTypeSchema = z25.enum(["boolean", "string", "number", "json"]).meta({ id: "FlagValueType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var FeatureFlagSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   key: z25.string().min(1).max(100).meta(Unrestricted22),
   value_type: FlagValueTypeSchema.default("boolean").meta(Unrestricted22),
   value: z25.string().max(4e3).default("false").meta(Unrestricted22),
   description: DescriptionField.meta(Unrestricted22),
   enabled: z25.boolean().default(true).meta(Unrestricted22)
-}).meta({ id: "FeatureFlag", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "FeatureFlag", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var TenantConfigSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   workspace_name: z25.string().min(1).max(200).meta(Unrestricted22),
   support_email: z25.string().email().nullable().default(null).meta(Unrestricted22),
   timezone: z25.string().max(50).default("UTC").meta(Unrestricted22),
   default_currency: z25.string().length(3).default("USD").meta(Unrestricted22),
   logo_url: z25.string().url().nullable().default(null).meta(Unrestricted22)
-}).meta({ id: "TenantConfig", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "TenantConfig", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var McpConfigSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   /** @deprecated Plan 28 ships a hosted MCP server at `/api/mcp/streamable-http`; no outbound server URL is needed. Column remains for backward compatibility. */
   server_url: z25.string().url().max(500).meta(Unrestricted22),
@@ -5336,14 +5441,14 @@ var McpConfigSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend
   allow_write_actions: z25.boolean().default(false).meta(Unrestricted22),
   enabled_tools: z25.array(z25.string().max(100)).default([]).meta(Unrestricted22),
   enabled: z25.boolean().default(false).meta(Unrestricted22)
-}).meta({ id: "McpConfig", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "McpConfig", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var OnboardingChecklistSchema = IdField.merge(TimestampFields).merge(TenantIdField).extend({
   step_key: z25.string().min(1).max(100).meta(Unrestricted22),
   label: z25.string().min(1).max(200).meta(Unrestricted22),
   done: z25.boolean().default(false).meta(Unrestricted22),
   completed_at: NullableDatetimeField.meta({ ...Unrestricted22, readOnly: true })
-}).meta({ id: "OnboardingChecklist", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
-var AuditActorTypeSchema = z25.enum(["user", "agent", "system", "webhook"]).meta({ id: "AuditActorType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "OnboardingChecklist", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
+var AuditActorTypeSchema = z25.enum(["user", "agent", "system", "webhook"]).meta({ id: "AuditActorType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var AuditEventSchema = IdField.merge(TenantIdField).extend({
   environment_id: z25.string().min(1).default("production").meta(Unrestricted22),
   actor_type: AuditActorTypeSchema.meta(Unrestricted22),
@@ -5353,15 +5458,15 @@ var AuditEventSchema = IdField.merge(TenantIdField).extend({
   object_id: z25.string().max(200).nullable().default(null).meta(Unrestricted22),
   payload: z25.record(z25.string(), z25.unknown()).nullable().default(null).meta(Unrestricted22),
   occurred_at: z25.string().datetime().meta({ ...Unrestricted22, readOnly: true })
-}).meta({ id: "AuditEvent", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
-var PlacementTestUserIdentifierTypeSchema = z25.enum(["user_id", "account_id", "email"]).meta({ id: "PlacementTestUserIdentifierType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18 });
+}).meta({ id: "AuditEvent", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
+var PlacementTestUserIdentifierTypeSchema = z25.enum(["user_id", "account_id", "email"]).meta({ id: "PlacementTestUserIdentifierType", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19 });
 var PlacementTestUserSchema = IdField.merge(TimestampFields).merge(TenantIdField).merge(AnchorFields).merge(VersionFields).extend({
   handle: HandleField.meta({ ...Unrestricted22, readOnly: true }),
   identifier: z25.string().min(1).max(200).meta(Unrestricted22),
   identifier_type: PlacementTestUserIdentifierTypeSchema.default("user_id").meta(Unrestricted22),
   note: z25.string().max(500).nullable().default(null).meta(Unrestricted22),
   added_by: z25.string().meta(Unrestricted22)
-}).meta({ id: "PlacementTestUser", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal18, ...mintedIdentity() });
+}).meta({ id: "PlacementTestUser", "x-revturbine-schema-persistence": Persisted22, "x-revturbine-schema-exposure": Internal19, ...mintedIdentity() });
 var settingsPaths = {
   // ── API Keys ─────────────────────────────────────────────────────────────
   "/api/settings/api-keys": {
@@ -5547,8 +5652,8 @@ var settingsPaths = {
 };
 var { Unrestricted: Unrestricted23, Pii: Pii8 } = DataClassification;
 var { Persisted: Persisted23, Transient: Transient21 } = SchemaPersistence;
-var { Internal: Internal19 } = SchemaExposure;
-var UserRoleSchema = z26.enum(["user", "admin"]).meta({ id: "UserRole", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+var { Internal: Internal20 } = SchemaExposure;
+var UserRoleSchema = z26.enum(["user", "admin"]).meta({ id: "UserRole", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthUserSchema = IdField.merge(TimestampFields).extend({
   name: NameField.meta(Unrestricted23),
   email: z26.string().email().meta(Pii8),
@@ -5559,7 +5664,7 @@ var AuthUserSchema = IdField.merge(TimestampFields).extend({
   ban_reason: z26.string().nullable().default(null).meta({ ...Unrestricted23, readOnly: true }),
   ban_expires: NullableDatetimeField.meta({ ...Unrestricted23, readOnly: true }),
   two_factor_enabled: z26.boolean().default(false).meta({ ...Unrestricted23, readOnly: true })
-}).meta({ id: "AuthUser", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthUser", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthSessionSchema = IdField.merge(TimestampFields).extend({
   expires_at: z26.string().datetime().meta(Unrestricted23),
   token: z26.string().min(1).meta({ ...Pii8, readOnly: true }),
@@ -5568,7 +5673,7 @@ var AuthSessionSchema = IdField.merge(TimestampFields).extend({
   user_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true }),
   active_organization_id: z26.string().nullable().default(null).meta(Unrestricted23),
   impersonated_by: z26.string().nullable().default(null).meta({ ...Unrestricted23, readOnly: true })
-}).meta({ id: "AuthSession", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthSession", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthAccountSchema = IdField.merge(TimestampFields).extend({
   account_id: z26.string().min(1).meta(Unrestricted23),
   provider_id: z26.string().min(1).meta(Unrestricted23),
@@ -5580,26 +5685,26 @@ var AuthAccountSchema = IdField.merge(TimestampFields).extend({
   refresh_token_expires_at: NullableDatetimeField.meta({ ...Unrestricted23, readOnly: true }),
   scope: z26.string().nullable().default(null).meta(Unrestricted23),
   password: z26.string().nullable().default(null).meta({ ...Pii8, readOnly: true })
-}).meta({ id: "AuthAccount", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthAccount", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthVerificationSchema = IdField.merge(TimestampFields).extend({
   identifier: z26.string().min(1).meta(Pii8),
   value: z26.string().min(1).meta({ ...Pii8, readOnly: true }),
   expires_at: z26.string().datetime().meta(Unrestricted23)
-}).meta({ id: "AuthVerification", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthVerification", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthTwoFactorSchema = IdField.extend({
   secret: z26.string().min(1).meta({ ...Pii8, readOnly: true }),
   backup_codes: z26.string().min(1).meta({ ...Pii8, readOnly: true }),
   user_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true }),
   verified: z26.boolean().default(false).meta({ ...Unrestricted23, readOnly: true })
-}).meta({ id: "AuthTwoFactor", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthTwoFactor", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthOrganizationSchema = IdField.extend({
   name: NameField.meta(Unrestricted23),
   slug: z26.string().min(1).max(100).nullable().default(null).meta(Unrestricted23),
   logo: z26.string().url().nullable().default(null).meta(Unrestricted23),
   created_at: z26.string().datetime().meta({ ...Unrestricted23, readOnly: true }),
   metadata: z26.string().nullable().default(null).meta(Unrestricted23)
-}).meta({ id: "AuthOrganization", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
-var RoleSchema = z26.enum(["viewer", "collaborator", "approver", "admin"]).meta({ id: "Role", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthOrganization", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
+var RoleSchema = z26.enum(["viewer", "collaborator", "approver", "admin"]).meta({ id: "Role", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var PermissionResourceSchema = z26.enum([
   "tenant",
   "users",
@@ -5614,7 +5719,7 @@ var PermissionResourceSchema = z26.enum([
   "mcp",
   "api_tokens",
   "settings"
-]).meta({ id: "PermissionResource", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal19 });
+]).meta({ id: "PermissionResource", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal20 });
 var PermissionActionSchema = z26.enum([
   "read",
   "create",
@@ -5624,11 +5729,11 @@ var PermissionActionSchema = z26.enum([
   "approve",
   "invite",
   "manage_roles"
-]).meta({ id: "PermissionAction", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal19 });
+]).meta({ id: "PermissionAction", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal20 });
 var PermissionSchema = z26.object({
   resource: PermissionResourceSchema,
   action: PermissionActionSchema
-}).meta({ id: "Permission", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "Permission", "x-revturbine-schema-persistence": Transient21, "x-revturbine-schema-exposure": Internal20 });
 var VIEWER_RESOURCES = [
   "tenant",
   "plans",
@@ -5697,14 +5802,14 @@ var ADMIN_PERMS = expand(ADMIN_FULL, ADMIN_ACTIONS);
 var SCOPE_VALUES = PermissionResourceSchema.options.flatMap(
   (resource) => PermissionActionSchema.options.map((action) => `${resource}:${action}`)
 );
-var McpTokenScopeSchema = z26.enum(SCOPE_VALUES).meta({ id: "McpTokenScope", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+var McpTokenScopeSchema = z26.enum(SCOPE_VALUES).meta({ id: "McpTokenScope", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthMemberSchema = IdField.extend({
   organization_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true }),
   user_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true }),
   role: RoleSchema.default("viewer").meta(Unrestricted23),
   created_at: z26.string().datetime().meta({ ...Unrestricted23, readOnly: true })
-}).meta({ id: "AuthMember", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
-var InvitationStatusSchema = z26.enum(["pending", "accepted", "rejected", "canceled", "expired"]).meta({ id: "InvitationStatus", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthMember", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
+var InvitationStatusSchema = z26.enum(["pending", "accepted", "rejected", "canceled", "expired"]).meta({ id: "InvitationStatus", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthInvitationSchema = IdField.extend({
   organization_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true }),
   email: z26.string().email().meta(Pii8),
@@ -5713,7 +5818,7 @@ var AuthInvitationSchema = IdField.extend({
   expires_at: z26.string().datetime().meta(Unrestricted23),
   created_at: z26.string().datetime().meta({ ...Unrestricted23, readOnly: true }),
   inviter_id: z26.string().min(1).meta({ ...Unrestricted23, readOnly: true })
-}).meta({ id: "AuthInvitation", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthInvitation", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthPasskeySchema = IdField.extend({
   name: z26.string().max(200).nullable().default(null).meta(Unrestricted23),
   public_key: z26.string().min(1).meta({ ...Pii8, readOnly: true }),
@@ -5725,7 +5830,7 @@ var AuthPasskeySchema = IdField.extend({
   transports: z26.string().nullable().default(null).meta(Unrestricted23),
   created_at: z26.string().datetime().meta({ ...Unrestricted23, readOnly: true }),
   aaguid: z26.string().nullable().default(null).meta(Unrestricted23)
-}).meta({ id: "AuthPasskey", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthPasskey", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthApiKeySchema = IdField.merge(TimestampFields).extend({
   config_id: z26.string().min(1).meta(Unrestricted23),
   name: z26.string().max(200).nullable().default(null).meta(Unrestricted23),
@@ -5746,7 +5851,7 @@ var AuthApiKeySchema = IdField.merge(TimestampFields).extend({
   expires_at: NullableDatetimeField.meta(Unrestricted23),
   permissions: z26.string().nullable().default(null).meta(Unrestricted23),
   metadata: z26.string().nullable().default(null).meta(Unrestricted23)
-}).meta({ id: "AuthApiKey", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthApiKey", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 var AuthSsoProviderSchema = IdField.extend({
   issuer: z26.string().min(1).meta(Unrestricted23),
   oidc_config: z26.string().nullable().default(null).meta(Unrestricted23),
@@ -5755,7 +5860,7 @@ var AuthSsoProviderSchema = IdField.extend({
   provider_id: z26.string().min(1).meta(Unrestricted23),
   organization_id: z26.string().nullable().default(null).meta(Unrestricted23),
   domain: z26.string().min(1).meta(Unrestricted23)
-}).meta({ id: "AuthSsoProvider", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal19 });
+}).meta({ id: "AuthSsoProvider", "x-revturbine-schema-persistence": Persisted23, "x-revturbine-schema-exposure": Internal20 });
 
 // src/schema/validators.snapshot.mjs
 import { z as z27 } from "zod";
@@ -5827,11 +5932,12 @@ var CATALOG = {
     message: "Plan '{plan}' has no Stripe price linked.",
     specRef: "optimization-studio-ui.md \xA73.1; plans-entitlements-studio-ui.md \xA72.2"
   },
-  // entitlement-rule overlap. Origin: the `rule.overlap` check (plan 40).
+  // entitlement-rule overlap. Origin: the `rule.overlap` check (plan 40);
+  // scoped to same-entitlement pairs per §5.8 (plan 179 / devkit #597).
   "VAL-PLN-05": {
     id: "VAL-PLN-05",
     severity: "warning",
-    message: "These entitlement rules target the same plan and segment \u2014 only one will apply.",
+    message: "These rules for the same entitlement target the same plan and segment \u2014 only one will apply.",
     specRef: "config-validation.md \xA75.3 (provisional \u2014 plan 73 Q-1)"
   },
   // multiple public variations. Origin: `*_variation.multiple_public`.
@@ -5840,6 +5946,27 @@ var CATALOG = {
     severity: "error_draft",
     message: "Only one public variation is allowed per billing period and segment.",
     specRef: "config-validation.md \xA75.3 (provisional \u2014 plan 73 Q-1)"
+  },
+  // more-than-two CTAs on a payload surface. Promoted from §5.8 (plan 174
+  // TASK-7 / devkit #584): the decision output carries ONE cta_path (from
+  // ctas[0]); ctas[1] contributes secondary_cta_label only; ctas[2..] are
+  // dropped at resolution with no finding.
+  "VAL-PLC-05": {
+    id: "VAL-PLC-05",
+    severity: "warning",
+    message: "Payload '{payload}' authors {count} CTAs, but the decision output carries one primary path and one secondary label \u2014 the third and later CTAs are dropped at resolution.",
+    specRef: "config-validation.md \xA75.8 (promoted \u2014 plan 174 TASK-7)"
+  },
+  // widest-possible-audience trial rule. Promoted from §5.8 (plan 174 TASK-7 /
+  // devkit #584): plan and segment on a free trial rule NARROW, so null on
+  // both means every user on every plan — legal and occasionally intended,
+  // but indistinguishable from an unfinished rule after authoring. Reverse
+  // trial rules can't hit this (premium_plan_id is required).
+  "VAL-TRL-04": {
+    id: "VAL-TRL-04",
+    severity: "warning",
+    message: "Trial rule '{rule}' targets every user on every plan (no plan, no segment). Confirm the widest possible audience is intended.",
+    specRef: "config-validation.md \xA75.8 (promoted \u2014 plan 174 TASK-7)"
   }
 };
 function getCatalogEntry(id) {
@@ -5849,9 +5976,63 @@ function runSemanticRules(graph) {
   return [
     ...checkPlansHaveStripePrice(graph),
     ...checkRuleOverlaps(graph),
-    ...checkPublicVariationCollisions(graph)
+    ...checkPublicVariationCollisions(graph),
+    ...checkPayloadCtaOverflow(graph),
+    ...checkTrialRuleWidestAudience(graph)
   ];
 }
+function surfaceCtas(surface) {
+  if (!surface || typeof surface !== "object") return 0;
+  const ctas = surface.ctas;
+  return Array.isArray(ctas) ? ctas.length : 0;
+}
+function checkPayloadCtaOverflow(graph) {
+  const findings = [];
+  const flag = (payloadId, count, objectType) => {
+    findings.push(
+      finding("VAL-PLC-05", { object_type: objectType, object_id: payloadId, field: "ctas", studio: "placements" }, {
+        message: `Payload '${payloadId}' authors ${count} CTAs, but the decision output carries one primary path and one secondary label \u2014 the third and later CTAs are dropped at resolution.`
+      })
+    );
+  };
+  for (const placement of graph.placements ?? []) {
+    const payloads = Array.isArray(placement.payloads) ? placement.payloads : [];
+    for (const payload of payloads) {
+      const payloadId = String(payload.id ?? placement.id ?? "");
+      const surfaces = Array.isArray(payload.surfaces) ? payload.surfaces : [];
+      for (const surface of surfaces) {
+        const count = surfaceCtas(surface);
+        if (count > 2) flag(payloadId, count, "placement_payload");
+      }
+    }
+  }
+  for (const payload of graph.placement_payloads ?? []) {
+    const payloadId = String(payload.payload_id ?? payload.id ?? "");
+    const surfaces = Array.isArray(payload.surfaces) ? payload.surfaces : [];
+    for (const surface of surfaces) {
+      const count = surfaceCtas(surface);
+      if (count > 2) flag(payloadId, count, "placement_payload");
+    }
+  }
+  return findings;
+}
+function checkTrialRuleWidestAudience(graph) {
+  const findings = [];
+  for (const rule of graph.free_trial_rules ?? []) {
+    const planId = rule.plan_id;
+    const segmentId = rule.segment_id;
+    const planUnset = planId === null || planId === void 0 || planId === "";
+    const segmentUnset = segmentId === null || segmentId === void 0 || segmentId === "";
+    if (!planUnset || !segmentUnset) continue;
+    const ruleId = String(rule.handle ?? rule.id ?? "");
+    findings.push(
+      finding("VAL-TRL-04", { object_type: "free_trial_rule", object_id: ruleId, studio: "trials" }, {
+        message: `Trial rule '${ruleId || "unnamed"}' targets every user on every plan (no plan, no segment). Confirm the widest possible audience is intended.`
+      })
+    );
+  }
+  return findings;
+}
 function finding(catalogId, target, opts = {}) {
   const entry = getCatalogEntry(catalogId);
   const severity = entry?.severity ?? "warning";
@@ -5915,6 +6096,7 @@ function checkRuleOverlaps(graph) {
   const sigs = [];
   for (const rule of rules) {
     const id = String(rule.handle ?? rule.id ?? "");
+    const entitlementId = typeof rule.entitlement_id === "string" ? rule.entitlement_id : "";
     const targetIds = /* @__PURE__ */ new Set();
     if (Array.isArray(rule.targets)) {
       for (const t of rule.targets) {
@@ -5942,6 +6124,7 @@ function checkRuleOverlaps(graph) {
     sigs.push({
       rule,
       id,
+      entitlementId,
       targetIds,
       segmentPairs,
       matchesAllSegments: segmentIds.length === 0
@@ -5952,6 +6135,7 @@ function checkRuleOverlaps(graph) {
     for (let j = i + 1; j < sigs.length; j++) {
       const a = sigs[i];
       const b = sigs[j];
+      if (!a.entitlementId || a.entitlementId !== b.entitlementId) continue;
       let sharedTarget = false;
       for (const t of a.targetIds) {
         if (b.targetIds.has(t)) {
@@ -5990,7 +6174,7 @@ function checkRuleOverlaps(graph) {
           studio: "plans-entitlements"
         },
         {
-          message: `Entitlement rule '${name}' overlaps another rule on a shared target and segment \u2014 only one will apply.`,
+          message: `Entitlement rule '${name}' overlaps another rule for the same entitlement on a shared target and segment \u2014 only one will apply.`,
           detail: "Where rules overlap, the most permissive value applies (plans-entitlements-studio-ui.md \xA72.3.2). Adjust the segment selection if this is unintended."
         }
       )
@@ -6055,8 +6239,12 @@ function messageForZodIssue(issue) {
   switch (issue.code) {
     case "invalid_type":
       return issue.input === void 0 ? `${field} is required.` : `${field} must be a ${issue.expected ?? "valid value"}.`;
-    case "invalid_value":
-      return `${field} must be one of the allowed values.`;
+    case "invalid_value": {
+      const values = (issue.values ?? []).filter(
+        (v) => ["string", "number", "boolean"].includes(typeof v)
+      );
+      return values.length > 0 ? `${field} must be one of: ${values.map((v) => `'${String(v)}'`).join(", ")}.` : `${field} must be one of the allowed values.`;
+    }
     case "invalid_format":
       return `${field} isn't in a valid format.`;
     case "too_small":
@@ -6116,7 +6304,12 @@ var DataClassification2 = {
   Financial: { "x-revturbine-data-classification": "financial" },
   Unrestricted: { "x-revturbine-data-classification": "unrestricted" }
 };
+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)) {
@@ -6140,7 +6333,7 @@ function toCreateSchema2(schema) {
 }
 var { Unrestricted: Unrestricted24 } = DataClassification2;
 var { Transient: Transient22, Persisted: Persisted24 } = SchemaPersistence2;
-var { Internal: Internal20, External: External13 } = SchemaExposure2;
+var { Internal: Internal21, External: External13 } = SchemaExposure2;
 var PaginationParamsSchema2 = z32.object({
   page: z32.coerce.number().int().min(1).default(1).meta(Unrestricted24),
   per_page: z32.coerce.number().int().min(1).max(100).default(25).meta(Unrestricted24)
@@ -6176,7 +6369,7 @@ var TenantIdField2 = z32.object({
   {
     id: "null",
     "x-revturbine-schema-persistence": Transient22,
-    "x-revturbine-schema-exposure": Internal20
+    "x-revturbine-schema-exposure": Internal21
   }
 );
 var BillingCadenceSchema2 = z32.enum([
@@ -6242,7 +6435,7 @@ var FeatureFlagValueSchema2 = z32.union([
   {
     id: "FeatureFlagValue",
     "x-revturbine-schema-persistence": Transient22,
-    "x-revturbine-schema-exposure": Internal20
+    "x-revturbine-schema-exposure": Internal21
   }
 );
 var NameField2 = z32.string().min(1).max(200);
@@ -6253,7 +6446,7 @@ var ThresholdPercentField2 = z32.number().int().min(10).max(100).multipleOf(10);
 var NullableDatetimeField2 = z32.string().datetime().nullable().default(null);
 var AnchorFields2 = z32.object({
   environment_id: z32.string().min(1).default("production").meta({ ...Unrestricted24, readOnly: true })
-}).meta({ id: "null", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal20 });
+}).meta({ id: "null", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal21 });
 var VersionFields2 = z32.object({
   // Which playbook version (the review/deploy unit — was `change_set_id`) staged
   // this ledger row; null once it is the deployed live row.
@@ -6266,7 +6459,7 @@ var VersionFields2 = z32.object({
   // so a stale draft is detected when live has moved past it.
   sequence: z32.number().int().min(1).default(1).meta({ ...Unrestricted24, readOnly: true }),
   base_sequence: z32.number().int().nullable().default(null).meta({ ...Unrestricted24, readOnly: true })
-}).meta({ id: "null", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal20 });
+}).meta({ id: "null", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal21 });
 var AnchorBaseSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField2).merge(AnchorFields2).extend({
   handle: HandleField2.meta({ ...Unrestricted24, readOnly: true }),
   active: z32.boolean().default(true).meta({ ...Unrestricted24, readOnly: true })
@@ -6275,10 +6468,10 @@ function makeAnchor2(id) {
   return AnchorBaseSchema2.meta({
     id,
     "x-revturbine-schema-persistence": Persisted24,
-    "x-revturbine-schema-exposure": Internal20
+    "x-revturbine-schema-exposure": Internal21
   });
 }
-var SeveritySchema22 = z32.enum(["info", "warning", "critical"]).meta({ id: "Severity", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal20 });
+var SeveritySchema22 = z32.enum(["info", "warning", "critical"]).meta({ id: "Severity", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal21 });
 var StudioSurfaceTypeSchema2 = z32.enum([
   "button",
   "plans_page_ctas",
@@ -6299,7 +6492,7 @@ var StudioSurfaceTypeSchema2 = z32.enum([
   "cli",
   "agent_connector",
   "custom_in_app"
-]).meta({ id: "StudioSurfaceType", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal20 });
+]).meta({ id: "StudioSurfaceType", "x-revturbine-schema-persistence": Transient22, "x-revturbine-schema-exposure": Internal21 });
 var CtaActionTypeSchema2 = z32.enum([
   "open_checkout",
   "view_plans",
@@ -7179,7 +7372,7 @@ var trialPaths2 = {
     })
   }
 };
-var { Unrestricted: Unrestricted42, Financial: Financial4 } = DataClassification2;
+var { Unrestricted: Unrestricted42, Financial: Financial5 } = DataClassification2;
 var { Persisted: Persisted42, Transient: Transient42 } = SchemaPersistence2;
 var { External: External32 } = SchemaExposure2;
 var PLAYBOOK_SDK_FACETS32 = schemaFacets2(SchemaContext2.Playbook, { sdkInput: true });
@@ -7234,7 +7427,7 @@ var PlanVariationSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField2
   plan_id: z82.string().min(1).meta(Unrestricted42),
   billing_period: z82.enum(["monthly", "annual", "one_time", "custom"]).meta(Unrestricted42),
   segment_id: z82.string().nullable().default(null).meta(Unrestricted42),
-  price_amount: z82.number().min(0).meta(Financial4),
+  price_amount: z82.number().min(0).meta(Financial5),
   pricing_model: PricingModelSchema2.meta(Unrestricted42),
   visibility: PlanVisibilitySchema2.default("public").meta(Unrestricted42),
   // Soft reference → StripePrice.stripe_price_id (the backend Stripe-price mirror).
@@ -7279,7 +7472,7 @@ var AddOnVariationSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField
   // expansion packages) bind here without coercion to 'custom'.
   billing_period: z82.enum(["monthly", "annual", "one_time", "custom"]).meta(Unrestricted42),
   segment_id: z82.string().nullable().default(null).meta(Unrestricted42),
-  price_amount: z82.number().min(0).meta(Financial4),
+  price_amount: z82.number().min(0).meta(Financial5),
   pricing_model: PricingModelSchema2.meta(Unrestricted42),
   visibility: PlanVisibilitySchema2.default("public").meta(Unrestricted42),
   // Soft reference → StripePrice.stripe_price_id (the backend Stripe-price mirror).
@@ -7306,8 +7499,8 @@ var StripePriceSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdField2).
   stripe_price_id: z82.string().min(1).meta(Unrestricted42),
   stripe_product_id: z82.string().min(1).meta(Unrestricted42),
   billing_period: StripePriceBillingPeriodSchema2.meta(Unrestricted42),
-  unit_amount_cents: z82.number().int().min(0).nullable().default(null).meta(Financial4),
-  currency: CurrencySchema2.meta(Financial4),
+  unit_amount_cents: z82.number().int().min(0).nullable().default(null).meta(Financial5),
+  currency: CurrencySchema2.meta(Financial5),
   pricing_model: PricingModelSchema2.meta(Unrestricted42),
   nickname: z82.string().nullable().default(null).meta(Unrestricted42),
   // Placeholder/seed price (demo or pre-integration tenants) vs a real
@@ -7790,6 +7983,10 @@ var PlacementTestModeSchema2 = z92.enum(["off", "test_users", "all_traffic"]).me
 var PlacementSettingsCapStateSchema2 = z92.object({
   capRules: z92.array(PlacementSettingsCapRuleSchema2).default([]).meta(Unrestricted52),
   sessionCooldownMinutes: z92.number().int().min(0).default(30).meta(Unrestricted52),
+  // Tenant-level default remind-me-later (defer) window, in minutes. A
+  // per-payload `remind_later_minutes` overrides it when set (plan 167 REQ-6,
+  // Q-3). Rides in this global_frequency_cap jsonb wrapper — no column/`.fbs`.
+  remindLaterMinutes: z92.number().int().min(0).default(60).meta(Unrestricted52),
   testMode: PlacementTestModeSchema2.default("off").meta(Unrestricted52)
 }).meta(
   { id: "PlacementSettingsCapState", "x-revturbine-schema-persistence": Transient52, "x-revturbine-schema-exposure": Internal42 }
@@ -7804,7 +8001,8 @@ var PlacementSettingsSchema2 = IdField2.merge(TimestampFields2).merge(TenantIdFi
   global_frequency_cap_period: z92.enum(["hour", "day", "week", "month", "session"]).nullable().default(null).meta(Unrestricted52),
   suppress_for_paid: z92.boolean().default(false).meta(Unrestricted52),
   suppress_for_trial: z92.boolean().default(false).meta(Unrestricted52),
-  default_dismiss_cooldown_hours: z92.number().int().min(0).default(24).meta(Unrestricted52),
+  // `default_dismiss_cooldown_hours` removed (plan 167 Q-2): the dismiss
+  // cooldown is defined per-payload in days (`cooldown_after_dismiss_days`).
   allow_stacking: z92.boolean().default(false).meta(Unrestricted52),
   priority_collision_strategy: z92.enum(["highest_priority", "most_recent", "random"]).default("highest_priority").meta(Unrestricted52)
 }).meta(
@@ -7916,7 +8114,7 @@ var RevTurbineConfigPlacementSettingsItemSchema2 = z92.object({
   global_frequency_cap_period: z92.enum(["hour", "day", "week", "month", "session"]).nullable().default(null).meta(Unrestricted52),
   suppress_for_paid: z92.boolean().default(false).meta(Unrestricted52),
   suppress_for_trial: z92.boolean().default(false).meta(Unrestricted52),
-  default_dismiss_cooldown_hours: z92.number().int().min(0).nullable().default(null).meta(Unrestricted52),
+  // `default_dismiss_cooldown_hours` removed (plan 167 Q-2).
   allow_stacking: z92.boolean().default(false).meta(Unrestricted52),
   priority_collision_strategy: z92.string().nullable().default(null).meta(Unrestricted52)
 }).meta(
@@ -8058,7 +8256,11 @@ var RevTurbineConfigUiPathActionTypeSchema2 = z92.enum([
   "verify_work_email",
   "update_payment_method",
   "enable_auto_renewal",
-  "manage_subscription"
+  "manage_subscription",
+  // Authored `snooze` resolves through to the SDK's remind-later path
+  // (plan 167 windows); previously it fell through as an invalid type
+  // (plan 174 TASK-6 / Q-5, spec-check F-65a).
+  "snooze"
 ]).meta(
   { id: "RevTurbineConfigUiPathActionType", "x-revturbine-schema-persistence": Transient52, "x-revturbine-schema-exposure": External42 }
 );
@@ -8167,6 +8369,8 @@ var RevTurbineConfigStudioPayloadSchema2 = z92.object({
   caps: RevTurbineConfigStudioPayloadCapsSchema2.optional().meta(Unrestricted52),
   // Optional slot targeting (spec §3.1.1): empty/absent = any compatible slot.
   surface_slot_ids: z92.array(z92.string()).optional().meta(Unrestricted52),
+  // Per-payload remind-me-later override (minutes); absent = inherit tenant default (plan 167 Q-3).
+  remind_later_minutes: z92.number().int().min(0).nullable().optional().meta(Unrestricted52),
   created_at: z92.string().optional().meta({ ...Unrestricted52, readOnly: true }),
   recommendation_strategy: z92.enum(["next_tier_up", "best_value", "custom"]).optional().default("next_tier_up").meta(Unrestricted52),
   recommendation_plan_override: z92.string().optional().meta(Unrestricted52)
@@ -8206,6 +8410,8 @@ var RevTurbineConfigPlacementPayloadItemSchema2 = z92.object({
   placement_id: z92.string().min(1).meta(Unrestricted52),
   target: RevTurbineConfigStudioPayloadTargetSchema2.meta(Unrestricted52),
   caps: RevTurbineConfigStudioPayloadCapsSchema2.optional().meta(Unrestricted52),
+  // Per-payload remind-me-later override (minutes); absent = inherit tenant default (plan 167 Q-3).
+  remind_later_minutes: z92.number().int().min(0).nullable().optional().meta(Unrestricted52),
   created_at: z92.string().meta({ ...Unrestricted52, readOnly: true }),
   updated_at: z92.string().datetime().optional().meta({ ...Unrestricted52, readOnly: true }),
   source_mode: z92.enum(["inline", "content_linked"]).meta(Unrestricted52),
@@ -8436,6 +8642,12 @@ var PlaybookSchema2 = z92.preprocess(normalizeConfigHeaderInput2, PlaybookObject
   "x-revturbine-schema-exposure": External42,
   ...PLAYBOOK_SDK_FACETS42
 });
+var PlaybookStrictSchema2 = z92.preprocess(normalizeConfigHeaderInput2, PlaybookObjectSchema2.strict()).meta({
+  id: "PlaybookStrict",
+  "x-revturbine-schema-persistence": Transient52,
+  "x-revturbine-schema-exposure": External42,
+  ...PLAYBOOK_SDK_FACETS42
+});
 var configPaths2 = {
   "/api/seat-type-anchors": {
     get: operation2({
@@ -8711,7 +8923,7 @@ function repairDeprecatedFields(config, schema = PlaybookObjectSchema2) {
 }
 
 // src/schema/version.ts
-var SCHEMA_VERSION = "0.1.145";
+var SCHEMA_VERSION = "0.1.167";
 
 // src/lib/credentials.ts
 import { chmodSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
@@ -8967,7 +9179,7 @@ Account created. Enter the verification code emailed to ${opts.email}.`);
 }
 
 // src/lib/track.ts
-var CLI_UNTRACKED_COMMANDS = /* @__PURE__ */ new Set(["login", "signup", "logout", "verify"]);
+var CLI_UNTRACKED_COMMANDS = /* @__PURE__ */ new Set(["login", "signup", "logout"]);
 function shouldTrackCommandExecution(name, hasUrl) {
   return hasUrl && !CLI_UNTRACKED_COMMANDS.has(name);
 }
@@ -10086,7 +10298,7 @@ Command groups:
   Keys          ingest-keys create|list|revoke
 
 Version selectors (no defaults \u2014 a command that reads a config requires one):
-  <file>            a local Config File (positional, or --file <path>)
+  <file>            a local Playbook file (positional, or --file <path>)
   --draft           the tenant's single open draft (resolved automatically)
   --live            the current live Release
   --release <id>    a specific playbook version / Release
@@ -10097,13 +10309,13 @@ Common workflows:
 
   # Author, validate, and ship against the default instance (revturbine.com/app)
   revturbine login
-  revturbine download --live --save ./config.json
-  revturbine validate ./config.json
-  revturbine diff ./config.json --live
-  revturbine launch ./config.json
+  revturbine download --live --save ./revturbine.playbook.json
+  revturbine validate ./revturbine.playbook.json
+  revturbine diff ./revturbine.playbook.json --live
+  revturbine launch ./revturbine.playbook.json
 
   # Manual review flow (stage \u2192 inspect \u2192 launch)
-  revturbine upload ./config.json          # stage as the open draft
+  revturbine upload ./revturbine.playbook.json          # stage as the open draft
   revturbine preview                       # inspect the open draft
   revturbine validate --draft              # full server catalog
   revturbine launch --draft
@@ -10133,7 +10345,7 @@ program.hook("postAction", async (_thisCommand, actionCommand) => {
     command: actionCommand.name()
   });
 });
-program.name("revturbine").description("Validate RevTurbine Config Files and ship them through the playbook-version lifecycle (draft \u2192 Release).").version(`${pkgVersion} (schema ${SCHEMA_VERSION})`, "-V, --version", "Print the revturbine and bundled schema versions").option(NO_LOCAL_FLAG, "Ignore the repo-pinned CLI and run this installation").showHelpAfterError().addHelpText("after", HELP_AFTER);
+program.name("revturbine").description("Validate RevTurbine Playbooks and ship them through the playbook-version lifecycle (draft \u2192 Release).").version(`${pkgVersion} (schema ${SCHEMA_VERSION})`, "-V, --version", "Print the revturbine and bundled schema versions").option(NO_LOCAL_FLAG, "Ignore the repo-pinned CLI and run this installation").showHelpAfterError().addHelpText("after", HELP_AFTER);
 function runInstall(manager, args, cwd) {
   return new Promise((resolve, reject) => {
     const child = spawn2(manager, args, { cwd, stdio: "inherit", shell: true });
@@ -10434,7 +10646,7 @@ program.command("download").description("Fetch a config version from the server.
     }
   }
 );
-program.command("validate").description("Validate a Config File offline (schema), or the open draft against the full server catalog (--draft).").argument("[file...]", "Path(s) to a Config File (offline mode)").option("--draft", "Validate the open draft server-side (full catalog)").option("-u, --url <url>", "RevTurbine instance URL (used with --draft)", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (files, opts) => {
+program.command("validate").description("Validate a Playbook file offline (schema), or the open draft against the full server catalog (--draft).").argument("[file...]", "Path(s) to a Playbook file (offline mode)").option("--draft", "Validate the open draft server-side (full catalog)").option("-u, --url <url>", "RevTurbine instance URL (used with --draft)", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (files, opts) => {
   if (opts.draft && files.length > 0) fail(EXIT.USAGE, "validate takes either <file> or --draft, not both.");
   if (!opts.draft && files.length === 0) {
     throw new SelectorError("STATE_REQUIRED \u2014 validate needs a version: <file> (offline) or --draft (server catalog).");
@@ -10476,7 +10688,7 @@ program.command("validate").description("Validate a Config File offline (schema)
   }
   diag("\u2713 No blocking findings.");
 });
-program.command("diff").description("Compare two config versions (first \u2192 second; a file vs --draft/--live/--release previews the launch \u2014 the server side is the base). Dry-run, no writes.").argument("[file...]", "Local Config File path(s)").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").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 (files, opts) => {
+program.command("diff").description("Compare two config versions (first \u2192 second; a file vs --draft/--live/--release previews the launch \u2014 the server side is the base). Dry-run, no writes.").argument("[file...]", "Local Playbook file path(s)").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").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 (files, opts) => {
   const sels = requireSelectors(opts, files, { count: 2, allowed: ["file", "draft", "live", "release"], command: "diff" });
   const ordered = orderDiffSelectors(sels);
   const needsServer = ordered.some((s) => s.kind !== "file");
@@ -10486,7 +10698,7 @@ program.command("diff").description("Compare two config versions (first \u2192 s
   process.stdout.write(`${formatDiff(diffExportedConfig(a, b))}
 `);
 });
-program.command("show").description(`Render a summary view of a config version. <kind> \u2208 ${SHOW_KINDS.join(" | ")}.`).argument("<kind>", `One of: ${SHOW_KINDS.join(", ")}`).option("--file <path>", "A local Config File").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").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(
+program.command("show").description(`Render a summary view of a config version. <kind> \u2208 ${SHOW_KINDS.join(" | ")}.`).argument("<kind>", `One of: ${SHOW_KINDS.join(", ")}`).option("--file <path>", "A local Playbook file").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").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 (kind, opts) => {
     if (!SHOW_KINDS.includes(kind)) {
       fail(EXIT.USAGE, `unknown kind '${kind}' \u2014 use one of: ${SHOW_KINDS.join(", ")}.`);
@@ -10501,7 +10713,7 @@ program.command("show").description(`Render a summary view of a config version.
 );
 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) => {
+program.command("upload").description("Stage a Playbook file as the open draft (POST /api/config/import).").argument("<config>", "Path to a Playbook 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));
@@ -10522,7 +10734,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("--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) => {
+program.command("launch").description("Take a config live as a new Release: validate (launch gate), then submit \u2192 approve \u2192 deploy. Synchronous.").argument("[file]", "Playbook 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;
@@ -10666,7 +10878,7 @@ program.command("evaluate").description("Run placement/entitlement decisions for
 var generateCmd = program.command("generate").description("Code generation from a config version (see: generate types).");
 generateCmd.command("types").description(
   "Generate a TypeScript module of Playbook handles \u2014 entitlements (namespaced by type), plans, segments, surface-template ids, and ui-path action types \u2014 for type-safe call sites."
-).argument("[file...]", "Path to a Config File").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-o, --out <path>", "Write the generated module to this path (parent dirs created); default stdout").option("--json", "Emit the handle map as JSON instead of TypeScript").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(
+).argument("[file...]", "Path to a Playbook file").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-o, --out <path>", "Write the generated module to this path (parent dirs created); default stdout").option("--json", "Emit the handle map as JSON instead of TypeScript").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 (files, opts) => {
     const [sel] = requireSelectors(opts, files, {
       count: 1,
@@ -10736,23 +10948,23 @@ var COMMAND_EXAMPLES = {
   download: [
     "",
     "Examples:",
-    "  revturbine download --live --save ./config.json     The live config \u2192 file",
+    "  revturbine download --live --save ./revturbine.playbook.json     The live config \u2192 file",
     "  revturbine download --draft                         The open draft (rendered on demand) \u2192 stdout",
     "  revturbine download --release cs_1a2b3c --format flatbuffer --save ./bundle.fb"
   ].join("\n"),
   validate: [
     "",
     "Examples:",
-    "  revturbine validate ./config.json      Offline schema validation (no network)",
+    "  revturbine validate ./revturbine.playbook.json      Offline schema validation (no network)",
     "  revturbine validate --draft            Full server catalog against the open draft"
   ].join("\n"),
   diff: [
     "",
     "Examples:",
-    "  revturbine diff ./config.json --live   Local edits vs the live config",
+    "  revturbine diff ./revturbine.playbook.json --live   Local edits vs the live config",
     "  revturbine diff --live --draft         What the open draft would change"
   ].join("\n"),
-  show: ["", "Examples:", "  revturbine show plans --live", "  revturbine show segments --file ./config.json"].join("\n"),
+  show: ["", "Examples:", "  revturbine show plans --live", "  revturbine show segments --file ./revturbine.playbook.json"].join("\n"),
   generate: [
     "",
     "Examples:",
@@ -10764,11 +10976,11 @@ var COMMAND_EXAMPLES = {
     "entitlement type) and the `EntitlementHandle` union for can()/gate()",
     "call sites. Its header records the exact command to regenerate it."
   ].join("\n"),
-  upload: ["", "Example:", "  revturbine upload ./config.json        Stage as the open draft"].join("\n"),
+  upload: ["", "Example:", "  revturbine upload ./revturbine.playbook.json        Stage as the open draft"].join("\n"),
   launch: [
     "",
     "Examples:",
-    "  revturbine launch ./config.json        Upload, gate, and go live",
+    "  revturbine launch ./revturbine.playbook.json        Upload, gate, and go live",
     "  revturbine launch --draft              Launch the already-open draft"
   ].join("\n"),
   evaluate: [