@sentientui/policy 0.10.0 → 0.12.0

package/README.md

@@ -34,12 +34,12 @@ replayable decisions.
 - `LAYOUT_ARCHETYPES` / `orderByArchetype(sections, sectionTypes, archetype, sectionRoles?)` — a catalogue of orderings (`conversion_led`, `evidence_led`, `price_led`, `discovery_led`). Not a persona taxonomy.
 - `previewOrderForPersona(sections, sectionTypes, persona, sectionRoles?)` — **keyless local mode only.** Maps any persona key onto an archetype so `?sentient_persona=<anything>` visibly rearranges a page with no server. Never use it for serving.
 - `chooseLayout(sections, sectionTypes, persona, learned, rand?)` — Thompson-samples the learned layout posteriors over the candidates. The authored order is always among them, so "leave the page alone" can win.
-- *Deprecated:* `CLUSTER_PRIORITY` (use `LAYOUT_ARCHETYPES`), `applyClusterHeuristic` (use `orderByArchetype` on the server, `previewOrderForPersona` locally).
+- *Deprecated:* `applyClusterHeuristic` (use `orderByArchetype` on the server, `previewOrderForPersona` locally).
 - `hashLayout(order)` — stable hash of a section order (the `layoutHash` key).
 
 **Personas** (`personas.ts`)
-- `PERSONAS`, `PersonaKey`, `UNKNOWN_PERSONA`, `PERSONA_DISPLAY` — the canonical persona set and display names.
-- `canonicalPersona(label)` — normalize an arbitrary/legacy label to a `PersonaKey`.
+- `UNKNOWN_PERSONA`, `UNKNOWN_PERSONA_DISPLAY` — the only persona key the package defines. There is no built-in persona list: every persona comes from the project's own vocabulary (declared by the app, or promoted by discovery).
+- `canonicalPersona(label)` — normalize any label to a persona key (trimmed, lowercased, key-shaped), or `'unknown'`. Says nothing about vocabulary membership.
 
 **Deterministic helpers** (`deterministic.ts`)
 - `fnv1a(input)` — FNV-1a hash.
@@ -67,7 +67,7 @@ const chosenSeeded = sampleArm(arms, mySeededRng);
 import { chooseLayout, hashLayout, type LearnedLayout } from '@sentientui/policy';
 
 const learned = new Map<string, LearnedLayout>(); // from your layout_weights store
-const order = chooseLayout(sections, sectionTypes, 'buyer', learned);
+const order = chooseLayout(sections, sectionTypes, 'evaluator', learned); // a key from the project's own vocabulary
 const key = hashLayout(order);
 ```
 

package/dist/index.d.cts

@@ -1,50 +1,33 @@
 import { SectionRole } from './taxonomy.cjs';
 
 /**
- * The four labels this product used to ship as a default vocabulary.
+ * The one persona key the product itself defines: "we don't know".
  *
- * RETAINED FOR HISTORY ONLY, and deliberately no longer a default: see
- * `DEFAULT_PERSONA_VOCABULARY`, which is now empty. `slot_weights`,
- * `variant_weights` and `slot_decisions` rows written before 2026-09-13 are
- * keyed on these strings, and `LEGACY_PERSONA_MAP` still has to canonicalize
- * the pre-069 plural spellings, so deleting them would orphan real posteriors
- * and break the read path for anything already stored.
- *
- * A project may still END UP with one of these keys — by declaring it, or by
- * discovery promoting a segment someone chose to name `buyer`. What can no
- * longer happen is the product asserting them on a customer's behalf.
+ * There is deliberately no persona LIST here. Until 2026-09-13 this module
+ * exported a hardcoded four-persona vocabulary (with display names and a
+ * plural-label alias map) that every project inherited, and the product
+ * presented those names as if it knew the customer's audience. Every persona
+ * now comes from the project's own vocabulary — declared by the app or
+ * promoted by discovery (see `vocabulary.ts`) — and anything else is
+ * `unknown`, which is where the pooled bandit does the actual work.
  */
-declare const PERSONAS: readonly ["buyer", "researcher", "deal_seeker", "browser"];
-type Persona = (typeof PERSONAS)[number];
 declare const UNKNOWN_PERSONA: "unknown";
-type PersonaKey = Persona | typeof UNKNOWN_PERSONA;
-/** Human-facing names — dashboard/devtools copy must use these, never raw keys. */
-declare const PERSONA_DISPLAY: Record<PersonaKey, string>;
-/**
- * Every label ever written for a persona, mapped to its canonical form. The
- * plural/hyphen labels are the pre-069 cluster seed labels
- * ('buyers'/'deal-seekers'/…); identity mappings make canonical input a no-op.
- */
-declare const LEGACY_PERSONA_MAP: Record<string, Persona>;
-/**
- * Canonicalizes any persona/cluster label to the pinned vocabulary.
- * Null, undefined, empty, and unrecognized labels all become 'unknown' —
- * "we don't know" is always a safe answer; a guessed persona is not.
- */
-declare function canonicalPersona(label: string | null | undefined): PersonaKey;
+/** Human-facing name of `UNKNOWN_PERSONA`. Every other persona's display name
+ *  comes from its vocabulary member, never from a table in this package. */
+declare const UNKNOWN_PERSONA_DISPLAY = "Unknown";
 
 /**
  * A catalogue of plausible page orderings — NOT a persona taxonomy.
  *
- * These four orderings were keyed by the seeded personas (`buyer`,
- * `researcher`, `deal_seeker`, `browser`) until 2026-09-13. Those personas were
- * removed, but the deeper problem was that keying orderings by persona NAME was
+ * These four orderings were keyed by the four seeded persona names until
+ * 2026-09-13 (the table was exported as `CLUSTER_PRIORITY`, now removed).
+ * Those personas were removed, but the deeper problem was that keying orderings by persona NAME was
  * wrong even while they existed, in two ways that were invisible until a
  * customer declared a persona of their own:
  *
  *  1. THE ARM SPACE DEPENDED ON WHAT THE CUSTOMER NAMED THEIR PERSONA. A
  *     project that declared `admin` got five candidate orders including the
- *     page exactly as authored; a project that declared `buyer` got four, and
+ *     page exactly as authored; a project that declared one of the seeded names got four, and
  *     the authored order was NOT among them — so its own page order could never
  *     be served to that persona, and there was no control arm to lose to.
  *     Renaming a persona silently changed which layouts were reachable.
@@ -52,7 +35,7 @@ declare function canonicalPersona(label: string | null | undefined): PersonaKey;
  *  2. THE FEASIBILITY GATE SERVED THE COLLIDING ARCHETYPE DETERMINISTICALLY.
  *     `routes/decide.ts` serves a heuristic order (never explored, never
  *     learned) when layout feasibility is `infeasible` — the state every new
- *     project is in. A customer who declared `buyer` had pricing hoisted above
+ *     project is in. A customer who declared the seeded conversion persona had pricing hoisted above
  *     everything on every visit, permanently, because of a table written in
  *     May; a customer who declared `admin` correctly kept their own page.
  *
@@ -68,11 +51,6 @@ declare const LAYOUT_ARCHETYPES: Record<string, readonly string[]>;
  *  insertion order, so it must not depend on object-key enumeration luck. */
 declare const LAYOUT_ARCHETYPE_NAMES: readonly ["conversion_led", "evidence_led", "price_led", "discovery_led"];
 type LayoutArchetype = (typeof LAYOUT_ARCHETYPE_NAMES)[number];
-/**
- * @deprecated Use `LAYOUT_ARCHETYPES`. Retained so the published surface does
- * not break; the keys are the four retired personas and mean nothing now.
- */
-declare const CLUSTER_PRIORITY: Record<Persona, string[]>;
 /**
  * Reorders section IDs by one archetype's semantic priority.
  * Sections with no graph entry are treated as 'generic'.
@@ -92,7 +70,7 @@ declare function orderByArchetype(sections: string[], sectionTypes: Map<string,
  * Maps an arbitrary persona string to one archetype so that
  * `?sentient_persona=<anything>` visibly rearranges a page with no API key and
  * no server. It used to look the key up in the four-persona table, so only
- * those four literal strings did anything and every other key silently no-oped;
+ * the four seeded names did anything and every other key silently no-oped;
  * now any key previews an arrangement, which is what the docs promise.
  *
  * DO NOT USE THIS ON THE SERVER. The mapping is a hash, not a belief: it
@@ -121,7 +99,7 @@ declare const applyClusterHeuristic: typeof previewOrderForPersona;
  * something, and there is nothing for a holdout comparison to mean. Before
  * 2026-09-13 the authored order was included only by accident, when the
  * requesting persona's name happened to miss the archetype table; a persona
- * named `buyer` had it excluded entirely.
+ * whose name matched the table had it excluded entirely.
  *
  * It no longer takes a persona. The set of orderings a page COULD be shown in
  * is a property of the page, not of who is looking at it — what the persona
@@ -142,6 +120,32 @@ declare function candidateLayouts(sections: string[], sectionTypes: Map<string,
  */
 declare function hashLayout(order: string[]): string;
 
+/** Learned Beta(alpha, beta) posterior for one arm. */
+type ArmPosterior = {
+    arm: string;
+    alpha: number;
+    beta: number;
+};
+/**
+ * One draw from Beta(alpha, beta). Moved verbatim from apps/api/src/domain/bandit.ts.
+ *
+ * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
+ *   NON-DETERMINISTIC. Pass a seeded PRNG when you need reproducible output
+ *   (tests, replayable decisions, snapshotting) — otherwise results vary per call.
+ */
+declare function sampleBeta(alpha: number, beta: number, rand?: () => number): number;
+/**
+ * Thompson Sampling selection: samples Beta(alpha, beta) per arm and returns
+ * the argmax arm id, or null when no arms are given. Uncertain arms get
+ * explored; confident winners get exploited — same semantics as the legacy
+ * chooseVariant, generalized to arbitrary arm strings.
+ *
+ * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
+ *   NON-DETERMINISTIC. Pass a seeded PRNG for reproducible selection (tests,
+ *   replayable assignments) — otherwise the chosen arm varies per call.
+ */
+declare function sampleArm(arms: ArmPosterior[], rand?: () => number): string | null;
+
 /** Learned Beta(alpha,beta) posterior for one candidate layout, keyed by hash. */
 type LearnedLayout = {
     layoutHash: string;
@@ -171,6 +175,28 @@ type LearnedLayout = {
  *   pinned in place across every candidate; see `orderByArchetype`.
  */
 declare function chooseLayout(sections: string[], sectionTypes: Map<string, string>, _persona: string, learned: Map<string, LearnedLayout>, rand?: () => number, sectionRoles?: Map<string, SectionRole>): string[];
+/** What `chooseLayoutDetailed` drew, and what it drew it from. */
+type LayoutChoice = {
+    /** The served ordering (the authored order when nothing could be chosen). */
+    order: string[];
+    /** Hash of `order` — the arm id in `layout_weights` / `candidate_layouts`. */
+    chosenHash: string;
+    /** Every candidate hash the draw ran over, in candidate order. */
+    candidates: string[];
+    /** The posteriors the draw ran over, parallel to `candidates`. Provenance
+     *  (migration 157) is computed from THESE, in the same call, because they
+     *  move on every close-out pass and cannot be recovered afterwards. */
+    arms: ArmPosterior[];
+};
+/**
+ * `chooseLayout` plus the draw's provenance. Byte-identical selection — this
+ * is the same function with its inputs returned alongside the output, so the
+ * propensity a caller computes from `arms` describes the draw that produced
+ * `order` and nothing else. The propensity itself is not computed here: the
+ * deterministic quadrature lives in the API (`lib/beta.ts`
+ * `armSelectionProbabilities`), where the slot path already uses it.
+ */
+declare function chooseLayoutDetailed(sections: string[], sectionTypes: Map<string, string>, _persona: string, learned: Map<string, LearnedLayout>, rand?: () => number, sectionRoles?: Map<string, SectionRole>): LayoutChoice;
 
 /**
  * Factored layout value model (spec 2026-09-04 §3a).
@@ -350,32 +376,6 @@ declare function factorCellsForTrial(arm: string, ctx: SlotFactorContext, person
  *  parameters on a tail that prod does not currently have. */
 declare function visitLevel(visitCount: number | null | undefined): string | null;
 
-/** Learned Beta(alpha, beta) posterior for one arm. */
-type ArmPosterior = {
-    arm: string;
-    alpha: number;
-    beta: number;
-};
-/**
- * One draw from Beta(alpha, beta). Moved verbatim from apps/api/src/domain/bandit.ts.
- *
- * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
- *   NON-DETERMINISTIC. Pass a seeded PRNG when you need reproducible output
- *   (tests, replayable decisions, snapshotting) — otherwise results vary per call.
- */
-declare function sampleBeta(alpha: number, beta: number, rand?: () => number): number;
-/**
- * Thompson Sampling selection: samples Beta(alpha, beta) per arm and returns
- * the argmax arm id, or null when no arms are given. Uncertain arms get
- * explored; confident winners get exploited — same semantics as the legacy
- * chooseVariant, generalized to arbitrary arm strings.
- *
- * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
- *   NON-DETERMINISTIC. Pass a seeded PRNG for reproducible selection (tests,
- *   replayable assignments) — otherwise the chosen arm varies per call.
- */
-declare function sampleArm(arms: ArmPosterior[], rand?: () => number): string | null;
-
 /** A slot declaration as sent on /v1/decide — exactly one of arms|dims. */
 type SlotDecl = {
     id: string;
@@ -625,8 +625,7 @@ declare function sampleArmEv(arms: EvArm[], reference: number, rand?: () => numb
 /**
  * Per-project persona vocabularies (spec: 2026-08-27-declared-personas-design.md).
  *
- * The persona axis stops being the closed global union in `personas.ts` and
- * becomes a per-project member list (persona_sets / persona_set_members,
+ * The persona axis is a per-project member list (persona_sets / persona_set_members,
  * migration 113). This module owns resolution: which persona a decision is
  * keyed on, given what the customer's app declared and what clustering
  * inferred. The weight tables and pooling are already string-generic —
@@ -657,12 +656,30 @@ declare const PERSONA_KEY_RE: RegExp;
  */
 declare function normalizeDeclaredPersona(raw: string | null | undefined): string | null;
 /**
- * Keys no vocabulary member may claim. 'unknown' and '__all__' are structural
- * in weightCellsFor / CONTRACTS §4; the plural forms are pre-069 legacy labels
- * that canonicalPersona still remaps, so a member claiming one would be
- * silently rewritten at resolve time. MUST stay in sync with migration 113.
+ * Keys no vocabulary member may claim: 'unknown' and '__all__' are structural
+ * in weightCellsFor / CONTRACTS §4. MUST stay in sync with the CHECK constraint
+ * on persona_set_members.key (migration 113, relaxed by 153).
+ *
+ * This also reserved four plural labels until 2026-09-13, because the
+ * name-specific alias map that remapped them at resolve time would have
+ * silently rewritten a member claiming one. That map went with the seeded
+ * personas, so those strings are ordinary keys now.
  */
 declare const RESERVED_PERSONA_KEYS: readonly string[];
+/**
+ * Canonicalizes any persona/cluster label to a persona KEY: trimmed,
+ * lowercased, and shaped like one (`PERSONA_KEY_RE`). Null, empty, and
+ * anything that could never be a key become 'unknown' — "we don't know" is
+ * always a safe answer.
+ *
+ * Generic on purpose. This used to be a lookup in a table of four seeded
+ * persona names, so every OTHER label — including every key a customer
+ * declared — folded to 'unknown': a registry pin scoped to `admin` was stored
+ * under 'unknown' and then applied to every unidentified visitor. It says
+ * nothing about membership; callers that serve must still check the project's
+ * vocabulary (resolvePersona does).
+ */
+declare function canonicalPersona(label: string | null | undefined): string;
 type PersonaVocabularyMember = {
     key: string;
     displayName: string;
@@ -671,16 +688,11 @@ type PersonaVocabularyMember = {
     /** Retired members stop resolving but their weight rows keep pooling. */
     status?: 'active' | 'retired';
 };
-/**
- * The pinned four as a vocabulary — what every project's version-1 default set
- * contains, and the fallback when a project has no active set (a missed
- * app-code insert degrades to today's behaviour, never an error).
- */
 /**
  * The vocabulary a project has when it has declared nothing: EMPTY.
  *
- * This shipped as a hardcoded four — buyer / researcher / deal_seeker / browser
- * — which the product then presented as if it knew the customer's audience.
+ * This shipped as a hardcoded four seeded personas, which the product then
+ * presented as if it knew the customer's audience.
  * Earned rows (2026-09-12) demoted them to a `starter` state; this removes them.
  *
  * The measurement that settled it, across all of production history:
@@ -724,8 +736,7 @@ type PersonaResolution = {
  * Resolves the persona a decision is keyed on.
  *
  * Precedence, in order:
- * 1. Declared value matching an active member (directly, via alias, or via a
- *    legacy plural label whose canonical form is a member) → that key,
+ * 1. Declared value matching an active member (directly or via alias) → that key,
  *    confidence 1. Declared skips reliability gating: it is ground truth from
  *    the customer's app, the same trust level as everything else the pk_ key
  *    sends.
@@ -745,11 +756,14 @@ declare function resolvePersona(input: {
  * Normalizes a DECISION-TIME persona (slot_decisions / layout_decisions rows)
  * for training. Unlike `canonicalPersona`, this trusts the stored value
  * verbatim: it was validated against the project vocabulary when the decision
- * was written, and re-squashing it through the closed global union at close-out
+ * was written, and re-squashing it through a closed global union at close-out
  * silently rerouted every declared-persona trial onto the 'unknown' marginals
- * (the double-squash bug, spec §4.3). Only the legacy plural labels are still
- * remapped — pre-069 rows carry them.
+ * (the double-squash bug, spec §4.3).
+ *
+ * It also remapped four pre-069 plural labels until 2026-09-13; migration 069
+ * had already rewritten those rows, and the remap was keyed on the retired
+ * seeded names, so it went with them.
  */
 declare function decisionPersona(label: string | null | undefined): string;
 
-export { type ArmPosterior, CLUSTER_PRIORITY, DEFAULT_PERSONA_VOCABULARY, EV_SHRINK_K, type EvArm, type FactoredSlotChoice, GLOBAL_FACTOR_LEVEL, GLOBAL_FACTOR_PERSONA, LAYOUT_ARCHETYPES, LAYOUT_ARCHETYPE_NAMES, LAYOUT_FACTOR_BUCKETS, LEGACY_PERSONA_MAP, type LayoutArchetype, type LayoutFactorCell, type LearnedLayout, PERSONAS, PERSONA_DISPLAY, PERSONA_KEY_RE, POOL_ALL, type Persona, type PersonaKey, type PersonaResolution, type PersonaVocabularyMember, type PoolCells, type PoolCounts, RESERVED_PERSONA_KEYS, SHRINKAGE_M, SLOT_FACTORS, type SlotDecl, type SlotFactor, type SlotFactorCell, type SlotFactorContext, type SlotResult, UNKNOWN_PERSONA, type ValueCell, type ValueCellRow, WEIGHTS_FALLBACK_PRIOR_PULLS, type WeightsFallbackArm, applyClusterHeuristic, broadestValueCell, candidateLayouts, canonicalArm, canonicalPersona, chooseLayout, chooseLayoutFactored, chooseSlotArmFactored, confidenceBand, decisionPersona, factorCellsForOrder, factorCellsForTrial, factorLevelsFor, fnv1a, hashLayout, layoutBucketOf, marginalArmKey, normalizeDeclaredPersona, orderByArchetype, parseArm, pickDeterministicArm, pickFromWeights, pooledPosterior, posteriorOfCounts, previewOrderForPersona, resolvePersona, sampleArm, sampleArmEv, sampleBeta, shrunkAvgValue, shrunkPosterior, slotBaselineArm, slotResultFor, validateSlotDecl, visitLevel, weightCellsFor };
+export { type ArmPosterior, DEFAULT_PERSONA_VOCABULARY, EV_SHRINK_K, type EvArm, type FactoredSlotChoice, GLOBAL_FACTOR_LEVEL, GLOBAL_FACTOR_PERSONA, LAYOUT_ARCHETYPES, LAYOUT_ARCHETYPE_NAMES, LAYOUT_FACTOR_BUCKETS, type LayoutArchetype, type LayoutChoice, type LayoutFactorCell, type LearnedLayout, PERSONA_KEY_RE, POOL_ALL, type PersonaResolution, type PersonaVocabularyMember, type PoolCells, type PoolCounts, RESERVED_PERSONA_KEYS, SHRINKAGE_M, SLOT_FACTORS, type SlotDecl, type SlotFactor, type SlotFactorCell, type SlotFactorContext, type SlotResult, UNKNOWN_PERSONA, UNKNOWN_PERSONA_DISPLAY, type ValueCell, type ValueCellRow, WEIGHTS_FALLBACK_PRIOR_PULLS, type WeightsFallbackArm, applyClusterHeuristic, broadestValueCell, candidateLayouts, canonicalArm, canonicalPersona, chooseLayout, chooseLayoutDetailed, chooseLayoutFactored, chooseSlotArmFactored, confidenceBand, decisionPersona, factorCellsForOrder, factorCellsForTrial, factorLevelsFor, fnv1a, hashLayout, layoutBucketOf, marginalArmKey, normalizeDeclaredPersona, orderByArchetype, parseArm, pickDeterministicArm, pickFromWeights, pooledPosterior, posteriorOfCounts, previewOrderForPersona, resolvePersona, sampleArm, sampleArmEv, sampleBeta, shrunkAvgValue, shrunkPosterior, slotBaselineArm, slotResultFor, validateSlotDecl, visitLevel, weightCellsFor };

package/dist/index.d.ts

@@ -1,50 +1,33 @@
 import { SectionRole } from './taxonomy.js';
 
 /**
- * The four labels this product used to ship as a default vocabulary.
+ * The one persona key the product itself defines: "we don't know".
  *
- * RETAINED FOR HISTORY ONLY, and deliberately no longer a default: see
- * `DEFAULT_PERSONA_VOCABULARY`, which is now empty. `slot_weights`,
- * `variant_weights` and `slot_decisions` rows written before 2026-09-13 are
- * keyed on these strings, and `LEGACY_PERSONA_MAP` still has to canonicalize
- * the pre-069 plural spellings, so deleting them would orphan real posteriors
- * and break the read path for anything already stored.
- *
- * A project may still END UP with one of these keys — by declaring it, or by
- * discovery promoting a segment someone chose to name `buyer`. What can no
- * longer happen is the product asserting them on a customer's behalf.
+ * There is deliberately no persona LIST here. Until 2026-09-13 this module
+ * exported a hardcoded four-persona vocabulary (with display names and a
+ * plural-label alias map) that every project inherited, and the product
+ * presented those names as if it knew the customer's audience. Every persona
+ * now comes from the project's own vocabulary — declared by the app or
+ * promoted by discovery (see `vocabulary.ts`) — and anything else is
+ * `unknown`, which is where the pooled bandit does the actual work.
  */
-declare const PERSONAS: readonly ["buyer", "researcher", "deal_seeker", "browser"];
-type Persona = (typeof PERSONAS)[number];
 declare const UNKNOWN_PERSONA: "unknown";
-type PersonaKey = Persona | typeof UNKNOWN_PERSONA;
-/** Human-facing names — dashboard/devtools copy must use these, never raw keys. */
-declare const PERSONA_DISPLAY: Record<PersonaKey, string>;
-/**
- * Every label ever written for a persona, mapped to its canonical form. The
- * plural/hyphen labels are the pre-069 cluster seed labels
- * ('buyers'/'deal-seekers'/…); identity mappings make canonical input a no-op.
- */
-declare const LEGACY_PERSONA_MAP: Record<string, Persona>;
-/**
- * Canonicalizes any persona/cluster label to the pinned vocabulary.
- * Null, undefined, empty, and unrecognized labels all become 'unknown' —
- * "we don't know" is always a safe answer; a guessed persona is not.
- */
-declare function canonicalPersona(label: string | null | undefined): PersonaKey;
+/** Human-facing name of `UNKNOWN_PERSONA`. Every other persona's display name
+ *  comes from its vocabulary member, never from a table in this package. */
+declare const UNKNOWN_PERSONA_DISPLAY = "Unknown";
 
 /**
  * A catalogue of plausible page orderings — NOT a persona taxonomy.
  *
- * These four orderings were keyed by the seeded personas (`buyer`,
- * `researcher`, `deal_seeker`, `browser`) until 2026-09-13. Those personas were
- * removed, but the deeper problem was that keying orderings by persona NAME was
+ * These four orderings were keyed by the four seeded persona names until
+ * 2026-09-13 (the table was exported as `CLUSTER_PRIORITY`, now removed).
+ * Those personas were removed, but the deeper problem was that keying orderings by persona NAME was
  * wrong even while they existed, in two ways that were invisible until a
  * customer declared a persona of their own:
  *
  *  1. THE ARM SPACE DEPENDED ON WHAT THE CUSTOMER NAMED THEIR PERSONA. A
  *     project that declared `admin` got five candidate orders including the
- *     page exactly as authored; a project that declared `buyer` got four, and
+ *     page exactly as authored; a project that declared one of the seeded names got four, and
  *     the authored order was NOT among them — so its own page order could never
  *     be served to that persona, and there was no control arm to lose to.
  *     Renaming a persona silently changed which layouts were reachable.
@@ -52,7 +35,7 @@ declare function canonicalPersona(label: string | null | undefined): PersonaKey;
  *  2. THE FEASIBILITY GATE SERVED THE COLLIDING ARCHETYPE DETERMINISTICALLY.
  *     `routes/decide.ts` serves a heuristic order (never explored, never
  *     learned) when layout feasibility is `infeasible` — the state every new
- *     project is in. A customer who declared `buyer` had pricing hoisted above
+ *     project is in. A customer who declared the seeded conversion persona had pricing hoisted above
  *     everything on every visit, permanently, because of a table written in
  *     May; a customer who declared `admin` correctly kept their own page.
  *
@@ -68,11 +51,6 @@ declare const LAYOUT_ARCHETYPES: Record<string, readonly string[]>;
  *  insertion order, so it must not depend on object-key enumeration luck. */
 declare const LAYOUT_ARCHETYPE_NAMES: readonly ["conversion_led", "evidence_led", "price_led", "discovery_led"];
 type LayoutArchetype = (typeof LAYOUT_ARCHETYPE_NAMES)[number];
-/**
- * @deprecated Use `LAYOUT_ARCHETYPES`. Retained so the published surface does
- * not break; the keys are the four retired personas and mean nothing now.
- */
-declare const CLUSTER_PRIORITY: Record<Persona, string[]>;
 /**
  * Reorders section IDs by one archetype's semantic priority.
  * Sections with no graph entry are treated as 'generic'.
@@ -92,7 +70,7 @@ declare function orderByArchetype(sections: string[], sectionTypes: Map<string,
  * Maps an arbitrary persona string to one archetype so that
  * `?sentient_persona=<anything>` visibly rearranges a page with no API key and
  * no server. It used to look the key up in the four-persona table, so only
- * those four literal strings did anything and every other key silently no-oped;
+ * the four seeded names did anything and every other key silently no-oped;
  * now any key previews an arrangement, which is what the docs promise.
  *
  * DO NOT USE THIS ON THE SERVER. The mapping is a hash, not a belief: it
@@ -121,7 +99,7 @@ declare const applyClusterHeuristic: typeof previewOrderForPersona;
  * something, and there is nothing for a holdout comparison to mean. Before
  * 2026-09-13 the authored order was included only by accident, when the
  * requesting persona's name happened to miss the archetype table; a persona
- * named `buyer` had it excluded entirely.
+ * whose name matched the table had it excluded entirely.
  *
  * It no longer takes a persona. The set of orderings a page COULD be shown in
  * is a property of the page, not of who is looking at it — what the persona
@@ -142,6 +120,32 @@ declare function candidateLayouts(sections: string[], sectionTypes: Map<string,
  */
 declare function hashLayout(order: string[]): string;
 
+/** Learned Beta(alpha, beta) posterior for one arm. */
+type ArmPosterior = {
+    arm: string;
+    alpha: number;
+    beta: number;
+};
+/**
+ * One draw from Beta(alpha, beta). Moved verbatim from apps/api/src/domain/bandit.ts.
+ *
+ * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
+ *   NON-DETERMINISTIC. Pass a seeded PRNG when you need reproducible output
+ *   (tests, replayable decisions, snapshotting) — otherwise results vary per call.
+ */
+declare function sampleBeta(alpha: number, beta: number, rand?: () => number): number;
+/**
+ * Thompson Sampling selection: samples Beta(alpha, beta) per arm and returns
+ * the argmax arm id, or null when no arms are given. Uncertain arms get
+ * explored; confident winners get exploited — same semantics as the legacy
+ * chooseVariant, generalized to arbitrary arm strings.
+ *
+ * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
+ *   NON-DETERMINISTIC. Pass a seeded PRNG for reproducible selection (tests,
+ *   replayable assignments) — otherwise the chosen arm varies per call.
+ */
+declare function sampleArm(arms: ArmPosterior[], rand?: () => number): string | null;
+
 /** Learned Beta(alpha,beta) posterior for one candidate layout, keyed by hash. */
 type LearnedLayout = {
     layoutHash: string;
@@ -171,6 +175,28 @@ type LearnedLayout = {
  *   pinned in place across every candidate; see `orderByArchetype`.
  */
 declare function chooseLayout(sections: string[], sectionTypes: Map<string, string>, _persona: string, learned: Map<string, LearnedLayout>, rand?: () => number, sectionRoles?: Map<string, SectionRole>): string[];
+/** What `chooseLayoutDetailed` drew, and what it drew it from. */
+type LayoutChoice = {
+    /** The served ordering (the authored order when nothing could be chosen). */
+    order: string[];
+    /** Hash of `order` — the arm id in `layout_weights` / `candidate_layouts`. */
+    chosenHash: string;
+    /** Every candidate hash the draw ran over, in candidate order. */
+    candidates: string[];
+    /** The posteriors the draw ran over, parallel to `candidates`. Provenance
+     *  (migration 157) is computed from THESE, in the same call, because they
+     *  move on every close-out pass and cannot be recovered afterwards. */
+    arms: ArmPosterior[];
+};
+/**
+ * `chooseLayout` plus the draw's provenance. Byte-identical selection — this
+ * is the same function with its inputs returned alongside the output, so the
+ * propensity a caller computes from `arms` describes the draw that produced
+ * `order` and nothing else. The propensity itself is not computed here: the
+ * deterministic quadrature lives in the API (`lib/beta.ts`
+ * `armSelectionProbabilities`), where the slot path already uses it.
+ */
+declare function chooseLayoutDetailed(sections: string[], sectionTypes: Map<string, string>, _persona: string, learned: Map<string, LearnedLayout>, rand?: () => number, sectionRoles?: Map<string, SectionRole>): LayoutChoice;
 
 /**
  * Factored layout value model (spec 2026-09-04 §3a).
@@ -350,32 +376,6 @@ declare function factorCellsForTrial(arm: string, ctx: SlotFactorContext, person
  *  parameters on a tail that prod does not currently have. */
 declare function visitLevel(visitCount: number | null | undefined): string | null;
 
-/** Learned Beta(alpha, beta) posterior for one arm. */
-type ArmPosterior = {
-    arm: string;
-    alpha: number;
-    beta: number;
-};
-/**
- * One draw from Beta(alpha, beta). Moved verbatim from apps/api/src/domain/bandit.ts.
- *
- * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
- *   NON-DETERMINISTIC. Pass a seeded PRNG when you need reproducible output
- *   (tests, replayable decisions, snapshotting) — otherwise results vary per call.
- */
-declare function sampleBeta(alpha: number, beta: number, rand?: () => number): number;
-/**
- * Thompson Sampling selection: samples Beta(alpha, beta) per arm and returns
- * the argmax arm id, or null when no arms are given. Uncertain arms get
- * explored; confident winners get exploited — same semantics as the legacy
- * chooseVariant, generalized to arbitrary arm strings.
- *
- * @param rand Uniform [0,1) source. Defaults to `Math.random`, which is
- *   NON-DETERMINISTIC. Pass a seeded PRNG for reproducible selection (tests,
- *   replayable assignments) — otherwise the chosen arm varies per call.
- */
-declare function sampleArm(arms: ArmPosterior[], rand?: () => number): string | null;
-
 /** A slot declaration as sent on /v1/decide — exactly one of arms|dims. */
 type SlotDecl = {
     id: string;
@@ -625,8 +625,7 @@ declare function sampleArmEv(arms: EvArm[], reference: number, rand?: () => numb
 /**
  * Per-project persona vocabularies (spec: 2026-08-27-declared-personas-design.md).
  *
- * The persona axis stops being the closed global union in `personas.ts` and
- * becomes a per-project member list (persona_sets / persona_set_members,
+ * The persona axis is a per-project member list (persona_sets / persona_set_members,
  * migration 113). This module owns resolution: which persona a decision is
  * keyed on, given what the customer's app declared and what clustering
  * inferred. The weight tables and pooling are already string-generic —
@@ -657,12 +656,30 @@ declare const PERSONA_KEY_RE: RegExp;
  */
 declare function normalizeDeclaredPersona(raw: string | null | undefined): string | null;
 /**
- * Keys no vocabulary member may claim. 'unknown' and '__all__' are structural
- * in weightCellsFor / CONTRACTS §4; the plural forms are pre-069 legacy labels
- * that canonicalPersona still remaps, so a member claiming one would be
- * silently rewritten at resolve time. MUST stay in sync with migration 113.
+ * Keys no vocabulary member may claim: 'unknown' and '__all__' are structural
+ * in weightCellsFor / CONTRACTS §4. MUST stay in sync with the CHECK constraint
+ * on persona_set_members.key (migration 113, relaxed by 153).
+ *
+ * This also reserved four plural labels until 2026-09-13, because the
+ * name-specific alias map that remapped them at resolve time would have
+ * silently rewritten a member claiming one. That map went with the seeded
+ * personas, so those strings are ordinary keys now.
  */
 declare const RESERVED_PERSONA_KEYS: readonly string[];
+/**
+ * Canonicalizes any persona/cluster label to a persona KEY: trimmed,
+ * lowercased, and shaped like one (`PERSONA_KEY_RE`). Null, empty, and
+ * anything that could never be a key become 'unknown' — "we don't know" is
+ * always a safe answer.
+ *
+ * Generic on purpose. This used to be a lookup in a table of four seeded
+ * persona names, so every OTHER label — including every key a customer
+ * declared — folded to 'unknown': a registry pin scoped to `admin` was stored
+ * under 'unknown' and then applied to every unidentified visitor. It says
+ * nothing about membership; callers that serve must still check the project's
+ * vocabulary (resolvePersona does).
+ */
+declare function canonicalPersona(label: string | null | undefined): string;
 type PersonaVocabularyMember = {
     key: string;
     displayName: string;
@@ -671,16 +688,11 @@ type PersonaVocabularyMember = {
     /** Retired members stop resolving but their weight rows keep pooling. */
     status?: 'active' | 'retired';
 };
-/**
- * The pinned four as a vocabulary — what every project's version-1 default set
- * contains, and the fallback when a project has no active set (a missed
- * app-code insert degrades to today's behaviour, never an error).
- */
 /**
  * The vocabulary a project has when it has declared nothing: EMPTY.
  *
- * This shipped as a hardcoded four — buyer / researcher / deal_seeker / browser
- * — which the product then presented as if it knew the customer's audience.
+ * This shipped as a hardcoded four seeded personas, which the product then
+ * presented as if it knew the customer's audience.
  * Earned rows (2026-09-12) demoted them to a `starter` state; this removes them.
  *
  * The measurement that settled it, across all of production history:
@@ -724,8 +736,7 @@ type PersonaResolution = {
  * Resolves the persona a decision is keyed on.
  *
  * Precedence, in order:
- * 1. Declared value matching an active member (directly, via alias, or via a
- *    legacy plural label whose canonical form is a member) → that key,
+ * 1. Declared value matching an active member (directly or via alias) → that key,
  *    confidence 1. Declared skips reliability gating: it is ground truth from
  *    the customer's app, the same trust level as everything else the pk_ key
  *    sends.
@@ -745,11 +756,14 @@ declare function resolvePersona(input: {
  * Normalizes a DECISION-TIME persona (slot_decisions / layout_decisions rows)
  * for training. Unlike `canonicalPersona`, this trusts the stored value
  * verbatim: it was validated against the project vocabulary when the decision
- * was written, and re-squashing it through the closed global union at close-out
+ * was written, and re-squashing it through a closed global union at close-out
  * silently rerouted every declared-persona trial onto the 'unknown' marginals
- * (the double-squash bug, spec §4.3). Only the legacy plural labels are still
- * remapped — pre-069 rows carry them.
+ * (the double-squash bug, spec §4.3).
+ *
+ * It also remapped four pre-069 plural labels until 2026-09-13; migration 069
+ * had already rewritten those rows, and the remap was keyed on the retired
+ * seeded names, so it went with them.
  */
 declare function decisionPersona(label: string | null | undefined): string;
 
-export { type ArmPosterior, CLUSTER_PRIORITY, DEFAULT_PERSONA_VOCABULARY, EV_SHRINK_K, type EvArm, type FactoredSlotChoice, GLOBAL_FACTOR_LEVEL, GLOBAL_FACTOR_PERSONA, LAYOUT_ARCHETYPES, LAYOUT_ARCHETYPE_NAMES, LAYOUT_FACTOR_BUCKETS, LEGACY_PERSONA_MAP, type LayoutArchetype, type LayoutFactorCell, type LearnedLayout, PERSONAS, PERSONA_DISPLAY, PERSONA_KEY_RE, POOL_ALL, type Persona, type PersonaKey, type PersonaResolution, type PersonaVocabularyMember, type PoolCells, type PoolCounts, RESERVED_PERSONA_KEYS, SHRINKAGE_M, SLOT_FACTORS, type SlotDecl, type SlotFactor, type SlotFactorCell, type SlotFactorContext, type SlotResult, UNKNOWN_PERSONA, type ValueCell, type ValueCellRow, WEIGHTS_FALLBACK_PRIOR_PULLS, type WeightsFallbackArm, applyClusterHeuristic, broadestValueCell, candidateLayouts, canonicalArm, canonicalPersona, chooseLayout, chooseLayoutFactored, chooseSlotArmFactored, confidenceBand, decisionPersona, factorCellsForOrder, factorCellsForTrial, factorLevelsFor, fnv1a, hashLayout, layoutBucketOf, marginalArmKey, normalizeDeclaredPersona, orderByArchetype, parseArm, pickDeterministicArm, pickFromWeights, pooledPosterior, posteriorOfCounts, previewOrderForPersona, resolvePersona, sampleArm, sampleArmEv, sampleBeta, shrunkAvgValue, shrunkPosterior, slotBaselineArm, slotResultFor, validateSlotDecl, visitLevel, weightCellsFor };
+export { type ArmPosterior, DEFAULT_PERSONA_VOCABULARY, EV_SHRINK_K, type EvArm, type FactoredSlotChoice, GLOBAL_FACTOR_LEVEL, GLOBAL_FACTOR_PERSONA, LAYOUT_ARCHETYPES, LAYOUT_ARCHETYPE_NAMES, LAYOUT_FACTOR_BUCKETS, type LayoutArchetype, type LayoutChoice, type LayoutFactorCell, type LearnedLayout, PERSONA_KEY_RE, POOL_ALL, type PersonaResolution, type PersonaVocabularyMember, type PoolCells, type PoolCounts, RESERVED_PERSONA_KEYS, SHRINKAGE_M, SLOT_FACTORS, type SlotDecl, type SlotFactor, type SlotFactorCell, type SlotFactorContext, type SlotResult, UNKNOWN_PERSONA, UNKNOWN_PERSONA_DISPLAY, type ValueCell, type ValueCellRow, WEIGHTS_FALLBACK_PRIOR_PULLS, type WeightsFallbackArm, applyClusterHeuristic, broadestValueCell, candidateLayouts, canonicalArm, canonicalPersona, chooseLayout, chooseLayoutDetailed, chooseLayoutFactored, chooseSlotArmFactored, confidenceBand, decisionPersona, factorCellsForOrder, factorCellsForTrial, factorLevelsFor, fnv1a, hashLayout, layoutBucketOf, marginalArmKey, normalizeDeclaredPersona, orderByArchetype, parseArm, pickDeterministicArm, pickFromWeights, pooledPosterior, posteriorOfCounts, previewOrderForPersona, resolvePersona, sampleArm, sampleArmEv, sampleBeta, shrunkAvgValue, shrunkPosterior, slotBaselineArm, slotResultFor, validateSlotDecl, visitLevel, weightCellsFor };

package/dist/index.js

@@ -1 +1 @@
-"use strict";var I=Object.defineProperty;var ye=Object.getOwnPropertyDescriptor;var ve=Object.getOwnPropertyNames,re=Object.getOwnPropertySymbols;var ne=Object.prototype.hasOwnProperty,Ae=Object.prototype.propertyIsEnumerable;var te=(e,r,t)=>r in e?I(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,Y=(e,r)=>{for(var t in r||(r={}))ne.call(r,t)&&te(e,t,r[t]);if(re)for(var t of re(r))Ae.call(r,t)&&te(e,t,r[t]);return e};var _e=(e,r)=>{for(var t in r)I(e,t,{get:r[t],enumerable:!0})},Se=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of ve(r))!ne.call(e,o)&&o!==t&&I(e,o,{get:()=>r[o],enumerable:!(n=ye(r,o))||n.enumerable});return e};var Pe=e=>Se(I({},"__esModule",{value:!0}),e);var er={};_e(er,{CLUSTER_PRIORITY:()=>we,DEFAULT_PERSONA_VOCABULARY:()=>de,EV_SHRINK_K:()=>fe,GLOBAL_FACTOR_LEVEL:()=>U,GLOBAL_FACTOR_PERSONA:()=>le,LAYOUT_ARCHETYPES:()=>N,LAYOUT_ARCHETYPE_NAMES:()=>$,LAYOUT_FACTOR_BUCKETS:()=>z,LEGACY_PERSONA_MAP:()=>T,PERSONAS:()=>ke,PERSONA_DISPLAY:()=>Ce,PERSONA_KEY_RE:()=>me,POOL_ALL:()=>P,RESERVED_PERSONA_KEYS:()=>ge,SHRINKAGE_M:()=>ae,SLOT_FACTORS:()=>De,UNKNOWN_PERSONA:()=>R,WEIGHTS_FALLBACK_PRIOR_PULLS:()=>ie,applyClusterHeuristic:()=>Ee,broadestValueCell:()=>Ke,candidateLayouts:()=>K,canonicalArm:()=>J,canonicalPersona:()=>D,chooseLayout:()=>Oe,chooseLayoutFactored:()=>Te,chooseSlotArmFactored:()=>Ve,confidenceBand:()=>Ge,decisionPersona:()=>Qe,factorCellsForOrder:()=>Ie,factorCellsForTrial:()=>$e,factorLevelsFor:()=>X,fnv1a:()=>ce,hashLayout:()=>V,layoutBucketOf:()=>W,marginalArmKey:()=>Ye,normalizeDeclaredPersona:()=>We,orderByArchetype:()=>H,parseArm:()=>Q,pickDeterministicArm:()=>je,pickFromWeights:()=>Fe,pooledPosterior:()=>Ne,posteriorOfCounts:()=>_,previewOrderForPersona:()=>se,resolvePersona:()=>Je,sampleArm:()=>j,sampleArmEv:()=>ze,sampleBeta:()=>w,shrunkAvgValue:()=>pe,shrunkPosterior:()=>S,slotBaselineArm:()=>ue,slotResultFor:()=>qe,validateSlotDecl:()=>He,visitLevel:()=>Be,weightCellsFor:()=>Ue});module.exports=Pe(er);var ke=["buyer","researcher","deal_seeker","browser"],R="unknown",Ce={buyer:"Buyer",researcher:"Researcher",deal_seeker:"Deal seeker",browser:"Browser",unknown:"Unknown"},T={buyers:"buyer",researchers:"researcher","deal-seekers":"deal_seeker",browsers:"browser",buyer:"buyer",researcher:"researcher",deal_seeker:"deal_seeker",browser:"browser"};function D(e){var t;if(e==null)return R;let r=e.trim().toLowerCase();return(t=T[r])!=null?t:R}var Re=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];function L(e,r){return e>>>r|e<<32-r}function oe(e){return(e>>>0).toString(16).padStart(8,"0")}function Le(e){let r=new TextEncoder().encode(e),t=r.length,n=t*8,o=(t+8>>6)+1<<6,s=new Uint8Array(o);s.set(r),s[t]=128;let a=new DataView(s.buffer);a.setUint32(o-8,Math.floor(n/4294967296),!1),a.setUint32(o-4,n>>>0,!1);let l=1779033703,u=3144134277,f=1013904242,m=2773480762,y=1359893119,d=2600822924,b=528734635,c=1541459225,p=new Uint32Array(64);for(let A=0;A<o;A+=64){for(let g=0;g<16;g++)p[g]=a.getUint32(A+g*4,!1);for(let g=16;g<64;g++){let O=L(p[g-15],7)^L(p[g-15],18)^p[g-15]>>>3,F=L(p[g-2],17)^L(p[g-2],19)^p[g-2]>>>10;p[g]=p[g-16]+O+p[g-7]+F>>>0}let i=l,v=u,x=f,k=m,h=y,C=d,M=b,E=c;for(let g=0;g<64;g++){let O=L(h,6)^L(h,11)^L(h,25),F=h&C^~h&M,ee=E+O+F+Re[g]+p[g]>>>0,be=L(i,2)^L(i,13)^L(i,22),xe=i&v^i&x^v&x,he=be+xe>>>0;E=M,M=C,C=h,h=k+ee>>>0,k=x,x=v,v=i,i=ee+he>>>0}l=l+i>>>0,u=u+v>>>0,f=f+x>>>0,m=m+k>>>0,y=y+h>>>0,d=d+C>>>0,b=b+M>>>0,c=c+E>>>0}return oe(l)+oe(u)}function V(e){return Le(e.join("|"))}var N={conversion_led:["pricing","cta","hero","comparison","social_proof","trust","features","faq","navigation","generic"],evidence_led:["features","comparison","faq","hero","trust","social_proof","pricing","cta","navigation","generic"],price_led:["pricing","comparison","social_proof","trust","cta","hero","features","faq","navigation","generic"],discovery_led:["hero","features","social_proof","pricing","cta","trust","faq","comparison","navigation","generic"]},$=["conversion_led","evidence_led","price_led","discovery_led"],we={buyer:[...N.conversion_led],researcher:[...N.evidence_led],deal_seeker:[...N.price_led],browser:[...N.discovery_led]};function H(e,r,t,n){let o=N[t];if(!o)return e;let s=o.indexOf("generic"),a=f=>{let m=o.indexOf(f);return m===-1?s:m},l=n?e.filter(f=>n.get(f)!=="structural"):[...e];if(l.sort((f,m)=>{var b,c;let y=(b=r.get(f))!=null?b:"generic",d=(c=r.get(m))!=null?c:"generic";return a(y)-a(d)}),!n)return l;let u=0;return e.map(f=>n.get(f)==="structural"?f:l[u++])}function Me(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=Math.imul(r,16777619)>>>0;return r>>>0}function se(e,r,t,n){if(!t||t==="unknown")return e;let o=$[Me(t)%$.length];return H(e,r,o,n)}var Ee=se;function K(e,r,t){let n=new Map;n.set(V(e),[...e]);for(let o of $){let s=H(e,r,o,t),a=V(s);n.has(a)||n.set(a,s)}return n}function q(e,r){if(e<1)return q(1+e,r)*Math.pow(Math.max(1e-15,r()),1/e);let t=e-1/3,n=1/Math.sqrt(9*t);for(;;){let o,s;do{let l=Math.max(1e-15,r()),u=r();o=Math.sqrt(-2*Math.log(l))*Math.cos(2*Math.PI*u),s=1+n*o}while(s<=0);s=s*s*s;let a=r();if(a<1-.0331*o*o*o*o||Math.log(a)<.5*o*o+t*(1-s+Math.log(s)))return t*s}}function w(e,r,t=Math.random){let n=q(e,t),o=q(r,t),s=n+o;return s<=0?e/(e+r):n/s}function j(e,r=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let t=e[0],n=w(t.alpha,t.beta,r);for(let o=1;o<e.length;o++){let s=e[o],a=w(s.alpha,s.beta,r);a>n&&(t=s,n=a)}return t.arm}function Oe(e,r,t,n,o=Math.random,s){var m,y;let a=K(e,r,s),l=[];for(let d of a.keys()){let b=n.get(d);l.push({arm:d,alpha:(m=b==null?void 0:b.alpha)!=null?m:1,beta:(y=b==null?void 0:b.beta)!=null?y:1})}let u=j(l,o),f=u?a.get(u):void 0;return f!=null?f:e}var ae=20;function S(e,r,t=20){let n=r.alpha+r.beta;if(n<=0||t<=0)return{alpha:e.alpha,beta:e.beta};let o=r.alpha/n,s=t*n/(n+t);return{alpha:e.alpha+s*o,beta:e.beta+s*(1-o)}}var ie=5;function Fe(e,r){var n,o;let t=null;for(let s of e){if(!r.includes(s.variantId))continue;let a=(n=s.pulls)!=null?n:0,l=a>0?a*s.avgReward/(a+ie):0;(!t||l>t.score)&&(t={variantId:s.variantId,score:l})}return(o=t==null?void 0:t.variantId)!=null?o:null}var P="__all__",B={exposures:0,conversions:0};function _(e){return{alpha:e.conversions+1,beta:Math.max(0,e.exposures-e.conversions)+1}}function Ne(e,r,t=20){var d,b,c,p;let n=(d=e.segment)!=null?d:B,o=(b=e.global)!=null?b:B,s=_(o),a=S(_(n),s,t);if(!r)return a;let l=(c=e.persona)!=null?c:B,u=(p=e.child)!=null?p:B,f=S(_(l),s,t),m=(n.exposures+1)/(n.exposures+l.exposures+2),y={alpha:m*a.alpha+(1-m)*f.alpha,beta:m*a.beta+(1-m)*f.beta};return S(_(u),y,t)}function Ke(e){var n,o;let r=null,t=-1;for(let s of e){let a=s.segment===P,l=s.persona===P,u=a&&l?3:a||l?2:1;u>t&&(t=u,r=s)}return{valueSum:(n=r==null?void 0:r.valueSum)!=null?n:0,valueCount:(o=r==null?void 0:r.valueCount)!=null?o:0}}function Ue(e,r){return r==="unknown"||r===P||r===""?[{segment:e,persona:P},{segment:P,persona:P}]:[{segment:e,persona:r},{segment:e,persona:P},{segment:P,persona:r},{segment:P,persona:P}]}var z=4,le="__global__";function W(e,r){return r<=0?0:Math.min(z-1,Math.floor(e*z/r))}function Ie(e,r){return e.map((t,n)=>{var o;return{parent:(o=r.get(t))!=null?o:"generic",bucket:W(n,e.length)}})}var G=(e,r)=>`${e}#${r}`;function Te(e,r,t,n,o=Math.random,s){var A;let a=K(e,r,s),l=new Map,u=new Map,f=0,m=0;for(let i of n)i.persona===le?(l.set(G(i.parent,i.bucket),i),f+=i.exposures,m+=i.conversions):i.persona===t&&u.set(G(i.parent,i.bucket),i);let y=_({exposures:f,conversions:m}),d=new Map,b=(i,v)=>{var O,F;let x=G(i,v),k=d.get(x);if(k!==void 0)return k;let h=l.get(x),C=S(_({exposures:(O=h==null?void 0:h.exposures)!=null?O:0,conversions:(F=h==null?void 0:h.conversions)!=null?F:0}),y),M=u.get(x),E=M?S(_({exposures:M.exposures,conversions:M.conversions}),C):C,g=w(E.alpha,E.beta,o);return d.set(x,g),g},c=null,p=-1/0;for(let i of a.values()){let v=0;for(let x=0;x<i.length;x++)v+=b((A=r.get(i[x]))!=null?A:"generic",W(x,i.length));v>p&&(p=v,c=i)}return c!=null?c:e}var U="__global__",De=["device","source","persona","visit"];function X(e){let r=[];return e.device&&r.push({factor:"device",level:e.device}),e.source&&r.push({factor:"source",level:e.source}),e.persona&&e.persona!==R&&r.push({factor:"persona",level:e.persona}),e.visit&&r.push({factor:"visit",level:e.visit}),r}var Z=(e,r,t)=>`${e}\0${r}\0${t}`;function Ve(e,r,t,n=Math.random){if(e.length===0)return null;if(e.length===1)return{arm:e[0],factorsUsed:0};let o=new Map,s=0,a=0;for(let c of t)o.set(Z(c.arm,c.factor,c.level),c),c.level===U&&(s+=c.exposures,a+=c.conversions);let l=_({exposures:s,conversions:a}),u=X(r),f=new Map,m=c=>{var A,i;let p=o.get(Z(c,"global",U));return S(_({exposures:(A=p==null?void 0:p.exposures)!=null?A:0,conversions:(i=p==null?void 0:p.conversions)!=null?i:0}),l)},y=(c,p,A)=>{let i=Z(c,p,A),v=f.get(i);if(v!==void 0)return v;let x=m(c),k=o.get(i),h=k?S(_({exposures:k.exposures,conversions:k.conversions}),x):x,C=w(h.alpha,h.beta,n);return f.set(i,C),C},d=null,b=-1/0;for(let c of e){let p=u.length===0?y(c,"global",U):0;for(let{factor:A,level:i}of u)p+=y(c,A,i);p>b&&(b=p,d=c)}return d===null?null:{arm:d,factorsUsed:u.length}}function $e(e,r,t){let n=Number.isFinite(t)?Math.max(0,Math.min(1,t)):0,o=[{arm:e,factor:"global",level:U,weight:1}];for(let{factor:s,level:a}of X(r))o.push({arm:e,factor:s,level:a,weight:s==="persona"?n:1});return o}function Be(e){return e==null||!Number.isFinite(e)||e<1?null:e>1?"returning":"new"}function J(e){return Object.keys(e).sort().map(r=>`${r}=${e[r]}`).join("|")}function Q(e){if(e.length===0)return null;let r={};for(let t of e.split("|")){let n=t.indexOf("=");if(n<=0||n!==t.lastIndexOf("=")||n===t.length-1)return null;let o=t.slice(0,n);if(o in r)return null;r[o]=t.slice(n+1)}return r}function Ye(e,r){return`${e}=${r}`}function ue(e){var t,n,o;if(e.arms)return typeof e.baseline=="string"?e.baseline:(t=e.arms[0])!=null?t:"";if(e.baseline!==void 0&&typeof e.baseline=="object")return J(e.baseline);if(typeof e.baseline=="string")return e.baseline;let r={};for(let[s,a]of Object.entries((n=e.dims)!=null?n:{}))r[s]=(o=a[0])!=null?o:"";return J(r)}function He(e){let r=Array.isArray(e.arms),t=e.dims!=null;if(r&&t)return{ok:!1,reason:"declare exactly one of arms or dims (got both)"};if(!r&&!t)return{ok:!1,reason:"declare exactly one of arms or dims (got neither)"};if(r){let s=e.arms;if(s.length<2)return{ok:!1,reason:"arms requires at least 2 entries"};if(s.length>12)return{ok:!1,reason:"arms allows at most 12 entries"};if(new Set(s).size!==s.length)return{ok:!1,reason:"arms must be unique"};if(s.some(a=>a.includes("=")))return{ok:!1,reason:"enumerated arm ids may not contain '=' (reserved for dims encoding)"};if(e.baseline!==void 0){if(typeof e.baseline!="string")return{ok:!1,reason:"baseline for an arms slot must be a string"};if(!s.includes(e.baseline))return{ok:!1,reason:"baseline must be one of the declared arms"}}return{ok:!0}}let n=Object.entries(e.dims);if(n.length<1)return{ok:!1,reason:"dims requires at least 1 dimension"};if(n.length>4)return{ok:!1,reason:"dims allows at most 4 dimensions"};let o=1;for(let[s,a]of n){if(a.length<2)return{ok:!1,reason:`dim "${s}" requires at least 2 values`};if(a.length>6)return{ok:!1,reason:`dim "${s}" allows at most 6 values`};if(new Set(a).size!==a.length)return{ok:!1,reason:`dim "${s}" has duplicate values`};o*=a.length}if(o>64)return{ok:!1,reason:`declared space of ${o} combinations exceeds the 64 maximum`};if(e.baseline!==void 0){if(typeof e.baseline=="string")return{ok:!1,reason:"baseline for a dims slot must be a per-dim record"};let s=e.baseline,a=n.map(([u])=>u).sort(),l=Object.keys(s).sort();if(a.join(" ")!==l.join(" "))return{ok:!1,reason:"baseline must set every declared dim exactly once"};for(let[u,f]of n)if(!f.includes(s[u]))return{ok:!1,reason:`baseline value for dim "${u}" is not declared`}}return{ok:!0}}function qe(e,r){var t,n;return e.dims!=null?(n=(t=Q(r))!=null?t:Q(ue(e)))!=null?n:{}:r}function ce(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=r+((r<<1)+(r<<4)+(r<<7)+(r<<8)+(r<<24))>>>0;return r}function je(e,r,t){if(t.length===0)throw new Error("pickDeterministicArm requires at least one arm");let n=[...t].sort();return n[ce(`${e}:${r}`)%n.length]}function Ge(e){return e>=.3?e<.7?"medium":"high":"low"}var fe=20;function pe(e,r,t=fe){let n=e.valueCount>0?e.valueSum/e.valueCount:0;if(r<=0)return n;if(e.valueCount<=0)return r;let o=e.valueCount/(e.valueCount+t);return o*n+(1-o)*r}function ze(e,r,t=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let n=null,o=-1/0;for(let s of e){let a=w(s.alpha,s.beta,t)*pe(s,r);a>o&&(n=s,o=a)}return n.arm}var me=/^[a-z0-9][a-z0-9_-]{0,31}$/;function We(e){if(typeof e!="string")return null;let r=e.trim().toLowerCase();return r&&me.test(r)?r:null}var ge=["unknown","__all__","buyers","researchers","deal-seekers","browsers"],de=[],Ze=64;function Xe(e){var t;let r=new Map;for(let n of e)if(n.status!=="retired"){r.set(n.key,n.key);for(let o of(t=n.aliases)!=null?t:[])ge.includes(o)||r.set(o,n.key)}return r}function Je(e,r=de){var l,u,f;let t=Xe(r),n=(l=e.inferredConfidence)!=null?l:0,o,s=(f=(u=e.declared)==null?void 0:u.trim().toLowerCase())!=null?f:"";if(s!==""){let m=t.get(s),y=m===void 0?t.get(D(s)):void 0,d=m!=null?m:y;if(d!==void 0)return{persona:d,source:"declared",confidence:1};o=s.slice(0,Ze)}let a=D(e.clusterLabel);return a!==R&&t.has(a)?Y({persona:t.get(a),source:"inferred",confidence:n},o!==void 0&&{unrecognizedDeclared:o}):Y({persona:R,source:"none",confidence:n},o!==void 0&&{unrecognizedDeclared:o})}function Qe(e){var t;if(e==null)return R;let r=e.trim().toLowerCase();return r===""?R:(t=T[r])!=null?t:r}0&&(module.exports={CLUSTER_PRIORITY,DEFAULT_PERSONA_VOCABULARY,EV_SHRINK_K,GLOBAL_FACTOR_LEVEL,GLOBAL_FACTOR_PERSONA,LAYOUT_ARCHETYPES,LAYOUT_ARCHETYPE_NAMES,LAYOUT_FACTOR_BUCKETS,LEGACY_PERSONA_MAP,PERSONAS,PERSONA_DISPLAY,PERSONA_KEY_RE,POOL_ALL,RESERVED_PERSONA_KEYS,SHRINKAGE_M,SLOT_FACTORS,UNKNOWN_PERSONA,WEIGHTS_FALLBACK_PRIOR_PULLS,applyClusterHeuristic,broadestValueCell,candidateLayouts,canonicalArm,canonicalPersona,chooseLayout,chooseLayoutFactored,chooseSlotArmFactored,confidenceBand,decisionPersona,factorCellsForOrder,factorCellsForTrial,factorLevelsFor,fnv1a,hashLayout,layoutBucketOf,marginalArmKey,normalizeDeclaredPersona,orderByArchetype,parseArm,pickDeterministicArm,pickFromWeights,pooledPosterior,posteriorOfCounts,previewOrderForPersona,resolvePersona,sampleArm,sampleArmEv,sampleBeta,shrunkAvgValue,shrunkPosterior,slotBaselineArm,slotResultFor,validateSlotDecl,visitLevel,weightCellsFor});
+"use strict";var I=Object.defineProperty;var ve=Object.getOwnPropertyDescriptor;var Ae=Object.getOwnPropertyNames,J=Object.getOwnPropertySymbols;var ee=Object.prototype.hasOwnProperty,Se=Object.prototype.propertyIsEnumerable;var Q=(e,r,t)=>r in e?I(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,V=(e,r)=>{for(var t in r||(r={}))ee.call(r,t)&&Q(e,t,r[t]);if(J)for(var t of J(r))Se.call(r,t)&&Q(e,t,r[t]);return e};var Ce=(e,r)=>{for(var t in r)I(e,t,{get:r[t],enumerable:!0})},_e=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of Ae(r))!ee.call(e,o)&&o!==t&&I(e,o,{get:()=>r[o],enumerable:!(n=ve(r,o))||n.enumerable});return e};var ke=e=>_e(I({},"__esModule",{value:!0}),e);var Je={};Ce(Je,{DEFAULT_PERSONA_VOCABULARY:()=>be,EV_SHRINK_K:()=>ce,GLOBAL_FACTOR_LEVEL:()=>K,GLOBAL_FACTOR_PERSONA:()=>ie,LAYOUT_ARCHETYPES:()=>te,LAYOUT_ARCHETYPE_NAMES:()=>D,LAYOUT_FACTOR_BUCKETS:()=>Y,PERSONA_KEY_RE:()=>pe,POOL_ALL:()=>_,RESERVED_PERSONA_KEYS:()=>ge,SHRINKAGE_M:()=>se,SLOT_FACTORS:()=>De,UNKNOWN_PERSONA:()=>P,UNKNOWN_PERSONA_DISPLAY:()=>Le,WEIGHTS_FALLBACK_PRIOR_PULLS:()=>ae,applyClusterHeuristic:()=>we,broadestValueCell:()=>Ne,candidateLayouts:()=>U,canonicalArm:()=>W,canonicalPersona:()=>de,chooseLayout:()=>Oe,chooseLayoutDetailed:()=>oe,chooseLayoutFactored:()=>Ie,chooseSlotArmFactored:()=>Te,confidenceBand:()=>je,decisionPersona:()=>Xe,factorCellsForOrder:()=>Ke,factorCellsForTrial:()=>Ve,factorLevelsFor:()=>G,fnv1a:()=>ue,hashLayout:()=>N,layoutBucketOf:()=>j,marginalArmKey:()=>He,normalizeDeclaredPersona:()=>me,orderByArchetype:()=>$,parseArm:()=>Z,pickDeterministicArm:()=>Ye,pickFromWeights:()=>Ee,pooledPosterior:()=>Fe,posteriorOfCounts:()=>S,previewOrderForPersona:()=>ne,resolvePersona:()=>Ze,sampleArm:()=>B,sampleArmEv:()=>ze,sampleBeta:()=>R,shrunkAvgValue:()=>fe,shrunkPosterior:()=>C,slotBaselineArm:()=>le,slotResultFor:()=>qe,validateSlotDecl:()=>Be,visitLevel:()=>$e,weightCellsFor:()=>Ue});module.exports=ke(Je);var P="unknown",Le="Unknown";var Me=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];function M(e,r){return e>>>r|e<<32-r}function re(e){return(e>>>0).toString(16).padStart(8,"0")}function Pe(e){let r=new TextEncoder().encode(e),t=r.length,n=t*8,o=(t+8>>6)+1<<6,s=new Uint8Array(o);s.set(r),s[t]=128;let a=new DataView(s.buffer);a.setUint32(o-8,Math.floor(n/4294967296),!1),a.setUint32(o-4,n>>>0,!1);let i=1779033703,u=3144134277,p=1013904242,m=2773480762,y=1359893119,d=2600822924,b=528734635,c=1541459225,f=new Uint32Array(64);for(let A=0;A<o;A+=64){for(let g=0;g<16;g++)f[g]=a.getUint32(A+g*4,!1);for(let g=16;g<64;g++){let E=M(f[g-15],7)^M(f[g-15],18)^f[g-15]>>>3,F=M(f[g-2],17)^M(f[g-2],19)^f[g-2]>>>10;f[g]=f[g-16]+E+f[g-7]+F>>>0}let l=i,v=u,x=p,k=m,h=y,L=d,w=b,O=c;for(let g=0;g<64;g++){let E=M(h,6)^M(h,11)^M(h,25),F=h&L^~h&w,X=O+E+F+Me[g]+f[g]>>>0,xe=M(l,2)^M(l,13)^M(l,22),he=l&v^l&x^v&x,ye=xe+he>>>0;O=w,w=L,L=h,h=k+X>>>0,k=x,x=v,v=l,l=X+ye>>>0}i=i+l>>>0,u=u+v>>>0,p=p+x>>>0,m=m+k>>>0,y=y+h>>>0,d=d+L>>>0,b=b+w>>>0,c=c+O>>>0}return re(i)+re(u)}function N(e){return Pe(e.join("|"))}var te={conversion_led:["pricing","cta","hero","comparison","social_proof","trust","features","faq","navigation","generic"],evidence_led:["features","comparison","faq","hero","trust","social_proof","pricing","cta","navigation","generic"],price_led:["pricing","comparison","social_proof","trust","cta","hero","features","faq","navigation","generic"],discovery_led:["hero","features","social_proof","pricing","cta","trust","faq","comparison","navigation","generic"]},D=["conversion_led","evidence_led","price_led","discovery_led"];function $(e,r,t,n){let o=te[t];if(!o)return e;let s=o.indexOf("generic"),a=p=>{let m=o.indexOf(p);return m===-1?s:m},i=n?e.filter(p=>n.get(p)!=="structural"):[...e];if(i.sort((p,m)=>{var b,c;let y=(b=r.get(p))!=null?b:"generic",d=(c=r.get(m))!=null?c:"generic";return a(y)-a(d)}),!n)return i;let u=0;return e.map(p=>n.get(p)==="structural"?p:i[u++])}function Re(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=Math.imul(r,16777619)>>>0;return r>>>0}function ne(e,r,t,n){if(!t||t==="unknown")return e;let o=D[Re(t)%D.length];return $(e,r,o,n)}var we=ne;function U(e,r,t){let n=new Map;n.set(N(e),[...e]);for(let o of D){let s=$(e,r,o,t),a=N(s);n.has(a)||n.set(a,s)}return n}function H(e,r){if(e<1)return H(1+e,r)*Math.pow(Math.max(1e-15,r()),1/e);let t=e-1/3,n=1/Math.sqrt(9*t);for(;;){let o,s;do{let i=Math.max(1e-15,r()),u=r();o=Math.sqrt(-2*Math.log(i))*Math.cos(2*Math.PI*u),s=1+n*o}while(s<=0);s=s*s*s;let a=r();if(a<1-.0331*o*o*o*o||Math.log(a)<.5*o*o+t*(1-s+Math.log(s)))return t*s}}function R(e,r,t=Math.random){let n=H(e,t),o=H(r,t),s=n+o;return s<=0?e/(e+r):n/s}function B(e,r=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let t=e[0],n=R(t.alpha,t.beta,r);for(let o=1;o<e.length;o++){let s=e[o],a=R(s.alpha,s.beta,r);a>n&&(t=s,n=a)}return t.arm}function Oe(e,r,t,n,o=Math.random,s){return oe(e,r,t,n,o,s).order}function oe(e,r,t,n,o=Math.random,s){var m,y;let a=U(e,r,s),i=[];for(let d of a.keys()){let b=n.get(d);i.push({arm:d,alpha:(m=b==null?void 0:b.alpha)!=null?m:1,beta:(y=b==null?void 0:b.beta)!=null?y:1})}let u=B(i,o),p=u?a.get(u):void 0;return u&&p?{order:p,chosenHash:u,candidates:i.map(d=>d.arm),arms:i}:{order:e,chosenHash:N(e),candidates:i.map(d=>d.arm),arms:i}}var se=20;function C(e,r,t=20){let n=r.alpha+r.beta;if(n<=0||t<=0)return{alpha:e.alpha,beta:e.beta};let o=r.alpha/n,s=t*n/(n+t);return{alpha:e.alpha+s*o,beta:e.beta+s*(1-o)}}var ae=5;function Ee(e,r){var n,o;let t=null;for(let s of e){if(!r.includes(s.variantId))continue;let a=(n=s.pulls)!=null?n:0,i=a>0?a*s.avgReward/(a+ae):0;(!t||i>t.score)&&(t={variantId:s.variantId,score:i})}return(o=t==null?void 0:t.variantId)!=null?o:null}var _="__all__",T={exposures:0,conversions:0};function S(e){return{alpha:e.conversions+1,beta:Math.max(0,e.exposures-e.conversions)+1}}function Fe(e,r,t=20){var d,b,c,f;let n=(d=e.segment)!=null?d:T,o=(b=e.global)!=null?b:T,s=S(o),a=C(S(n),s,t);if(!r)return a;let i=(c=e.persona)!=null?c:T,u=(f=e.child)!=null?f:T,p=C(S(i),s,t),m=(n.exposures+1)/(n.exposures+i.exposures+2),y={alpha:m*a.alpha+(1-m)*p.alpha,beta:m*a.beta+(1-m)*p.beta};return C(S(u),y,t)}function Ne(e){var n,o;let r=null,t=-1;for(let s of e){let a=s.segment===_,i=s.persona===_,u=a&&i?3:a||i?2:1;u>t&&(t=u,r=s)}return{valueSum:(n=r==null?void 0:r.valueSum)!=null?n:0,valueCount:(o=r==null?void 0:r.valueCount)!=null?o:0}}function Ue(e,r){return r==="unknown"||r===_||r===""?[{segment:e,persona:_},{segment:_,persona:_}]:[{segment:e,persona:r},{segment:e,persona:_},{segment:_,persona:r},{segment:_,persona:_}]}var Y=4,ie="__global__";function j(e,r){return r<=0?0:Math.min(Y-1,Math.floor(e*Y/r))}function Ke(e,r){return e.map((t,n)=>{var o;return{parent:(o=r.get(t))!=null?o:"generic",bucket:j(n,e.length)}})}var q=(e,r)=>`${e}#${r}`;function Ie(e,r,t,n,o=Math.random,s){var A;let a=U(e,r,s),i=new Map,u=new Map,p=0,m=0;for(let l of n)l.persona===ie?(i.set(q(l.parent,l.bucket),l),p+=l.exposures,m+=l.conversions):l.persona===t&&u.set(q(l.parent,l.bucket),l);let y=S({exposures:p,conversions:m}),d=new Map,b=(l,v)=>{var E,F;let x=q(l,v),k=d.get(x);if(k!==void 0)return k;let h=i.get(x),L=C(S({exposures:(E=h==null?void 0:h.exposures)!=null?E:0,conversions:(F=h==null?void 0:h.conversions)!=null?F:0}),y),w=u.get(x),O=w?C(S({exposures:w.exposures,conversions:w.conversions}),L):L,g=R(O.alpha,O.beta,o);return d.set(x,g),g},c=null,f=-1/0;for(let l of a.values()){let v=0;for(let x=0;x<l.length;x++)v+=b((A=r.get(l[x]))!=null?A:"generic",j(x,l.length));v>f&&(f=v,c=l)}return c!=null?c:e}var K="__global__",De=["device","source","persona","visit"];function G(e){let r=[];return e.device&&r.push({factor:"device",level:e.device}),e.source&&r.push({factor:"source",level:e.source}),e.persona&&e.persona!==P&&r.push({factor:"persona",level:e.persona}),e.visit&&r.push({factor:"visit",level:e.visit}),r}var z=(e,r,t)=>`${e}\0${r}\0${t}`;function Te(e,r,t,n=Math.random){if(e.length===0)return null;if(e.length===1)return{arm:e[0],factorsUsed:0};let o=new Map,s=0,a=0;for(let c of t)o.set(z(c.arm,c.factor,c.level),c),c.level===K&&(s+=c.exposures,a+=c.conversions);let i=S({exposures:s,conversions:a}),u=G(r),p=new Map,m=c=>{var A,l;let f=o.get(z(c,"global",K));return C(S({exposures:(A=f==null?void 0:f.exposures)!=null?A:0,conversions:(l=f==null?void 0:f.conversions)!=null?l:0}),i)},y=(c,f,A)=>{let l=z(c,f,A),v=p.get(l);if(v!==void 0)return v;let x=m(c),k=o.get(l),h=k?C(S({exposures:k.exposures,conversions:k.conversions}),x):x,L=R(h.alpha,h.beta,n);return p.set(l,L),L},d=null,b=-1/0;for(let c of e){let f=u.length===0?y(c,"global",K):0;for(let{factor:A,level:l}of u)f+=y(c,A,l);f>b&&(b=f,d=c)}return d===null?null:{arm:d,factorsUsed:u.length}}function Ve(e,r,t){let n=Number.isFinite(t)?Math.max(0,Math.min(1,t)):0,o=[{arm:e,factor:"global",level:K,weight:1}];for(let{factor:s,level:a}of G(r)){let i=s==="persona"?n:1;i!==0&&o.push({arm:e,factor:s,level:a,weight:i})}return o}function $e(e){return e==null||!Number.isFinite(e)||e<1?null:e>1?"returning":"new"}function W(e){return Object.keys(e).sort().map(r=>`${r}=${e[r]}`).join("|")}function Z(e){if(e.length===0)return null;let r={};for(let t of e.split("|")){let n=t.indexOf("=");if(n<=0||n!==t.lastIndexOf("=")||n===t.length-1)return null;let o=t.slice(0,n);if(o in r)return null;r[o]=t.slice(n+1)}return r}function He(e,r){return`${e}=${r}`}function le(e){var t,n,o;if(e.arms)return typeof e.baseline=="string"?e.baseline:(t=e.arms[0])!=null?t:"";if(e.baseline!==void 0&&typeof e.baseline=="object")return W(e.baseline);if(typeof e.baseline=="string")return e.baseline;let r={};for(let[s,a]of Object.entries((n=e.dims)!=null?n:{}))r[s]=(o=a[0])!=null?o:"";return W(r)}function Be(e){let r=Array.isArray(e.arms),t=e.dims!=null;if(r&&t)return{ok:!1,reason:"declare exactly one of arms or dims (got both)"};if(!r&&!t)return{ok:!1,reason:"declare exactly one of arms or dims (got neither)"};if(r){let s=e.arms;if(s.length<2)return{ok:!1,reason:"arms requires at least 2 entries"};if(s.length>12)return{ok:!1,reason:"arms allows at most 12 entries"};if(new Set(s).size!==s.length)return{ok:!1,reason:"arms must be unique"};if(s.some(a=>a.includes("=")))return{ok:!1,reason:"enumerated arm ids may not contain '=' (reserved for dims encoding)"};if(e.baseline!==void 0){if(typeof e.baseline!="string")return{ok:!1,reason:"baseline for an arms slot must be a string"};if(!s.includes(e.baseline))return{ok:!1,reason:"baseline must be one of the declared arms"}}return{ok:!0}}let n=Object.entries(e.dims);if(n.length<1)return{ok:!1,reason:"dims requires at least 1 dimension"};if(n.length>4)return{ok:!1,reason:"dims allows at most 4 dimensions"};let o=1;for(let[s,a]of n){if(a.length<2)return{ok:!1,reason:`dim "${s}" requires at least 2 values`};if(a.length>6)return{ok:!1,reason:`dim "${s}" allows at most 6 values`};if(new Set(a).size!==a.length)return{ok:!1,reason:`dim "${s}" has duplicate values`};o*=a.length}if(o>64)return{ok:!1,reason:`declared space of ${o} combinations exceeds the 64 maximum`};if(e.baseline!==void 0){if(typeof e.baseline=="string")return{ok:!1,reason:"baseline for a dims slot must be a per-dim record"};let s=e.baseline,a=n.map(([u])=>u).sort(),i=Object.keys(s).sort();if(a.join(" ")!==i.join(" "))return{ok:!1,reason:"baseline must set every declared dim exactly once"};for(let[u,p]of n)if(!p.includes(s[u]))return{ok:!1,reason:`baseline value for dim "${u}" is not declared`}}return{ok:!0}}function qe(e,r){var t,n;return e.dims!=null?(n=(t=Z(r))!=null?t:Z(le(e)))!=null?n:{}:r}function ue(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=r+((r<<1)+(r<<4)+(r<<7)+(r<<8)+(r<<24))>>>0;return r}function Ye(e,r,t){if(t.length===0)throw new Error("pickDeterministicArm requires at least one arm");let n=[...t].sort();return n[ue(`${e}:${r}`)%n.length]}function je(e){return e>=.3?e<.7?"medium":"high":"low"}var ce=20;function fe(e,r,t=ce){let n=e.valueCount>0?e.valueSum/e.valueCount:0;if(r<=0)return n;if(e.valueCount<=0)return r;let o=e.valueCount/(e.valueCount+t);return o*n+(1-o)*r}function ze(e,r,t=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let n=null,o=-1/0;for(let s of e){let a=R(s.alpha,s.beta,t)*fe(s,r);a>o&&(n=s,o=a)}return n.arm}var pe=/^[a-z0-9][a-z0-9_-]{0,31}$/;function me(e){if(typeof e!="string")return null;let r=e.trim().toLowerCase();return r&&pe.test(r)?r:null}var ge=["unknown","__all__"];function de(e){var r;return(r=me(e))!=null?r:P}var be=[],Ge=64;function We(e){var t;let r=new Map;for(let n of e)if(n.status!=="retired"){r.set(n.key,n.key);for(let o of(t=n.aliases)!=null?t:[])ge.includes(o)||r.set(o,n.key)}return r}function Ze(e,r=be){var i,u,p;let t=We(r),n=(i=e.inferredConfidence)!=null?i:0,o,s=(p=(u=e.declared)==null?void 0:u.trim().toLowerCase())!=null?p:"";if(s!==""){let m=t.get(s);if(m!==void 0)return{persona:m,source:"declared",confidence:1};o=s.slice(0,Ge)}let a=de(e.clusterLabel);return a!==P&&t.has(a)?V({persona:t.get(a),source:"inferred",confidence:n},o!==void 0&&{unrecognizedDeclared:o}):V({persona:P,source:"none",confidence:n},o!==void 0&&{unrecognizedDeclared:o})}function Xe(e){if(e==null)return P;let r=e.trim().toLowerCase();return r===""?P:r}0&&(module.exports={DEFAULT_PERSONA_VOCABULARY,EV_SHRINK_K,GLOBAL_FACTOR_LEVEL,GLOBAL_FACTOR_PERSONA,LAYOUT_ARCHETYPES,LAYOUT_ARCHETYPE_NAMES,LAYOUT_FACTOR_BUCKETS,PERSONA_KEY_RE,POOL_ALL,RESERVED_PERSONA_KEYS,SHRINKAGE_M,SLOT_FACTORS,UNKNOWN_PERSONA,UNKNOWN_PERSONA_DISPLAY,WEIGHTS_FALLBACK_PRIOR_PULLS,applyClusterHeuristic,broadestValueCell,candidateLayouts,canonicalArm,canonicalPersona,chooseLayout,chooseLayoutDetailed,chooseLayoutFactored,chooseSlotArmFactored,confidenceBand,decisionPersona,factorCellsForOrder,factorCellsForTrial,factorLevelsFor,fnv1a,hashLayout,layoutBucketOf,marginalArmKey,normalizeDeclaredPersona,orderByArchetype,parseArm,pickDeterministicArm,pickFromWeights,pooledPosterior,posteriorOfCounts,previewOrderForPersona,resolvePersona,sampleArm,sampleArmEv,sampleBeta,shrunkAvgValue,shrunkPosterior,slotBaselineArm,slotResultFor,validateSlotDecl,visitLevel,weightCellsFor});

package/dist/index.mjs

@@ -1 +1 @@
-import{a as T}from"./chunk-HBG7RQ56.mjs";var ve=["buyer","researcher","deal_seeker","browser"],L="unknown",Ae={buyer:"Buyer",researcher:"Researcher",deal_seeker:"Deal seeker",browser:"Browser",unknown:"Unknown"},D={buyers:"buyer",researchers:"researcher","deal-seekers":"deal_seeker",browsers:"browser",buyer:"buyer",researcher:"researcher",deal_seeker:"deal_seeker",browser:"browser"};function V(e){var t;if(e==null)return L;let r=e.trim().toLowerCase();return(t=D[r])!=null?t:L}var se=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];function k(e,r){return e>>>r|e<<32-r}function G(e){return(e>>>0).toString(16).padStart(8,"0")}function ae(e){let r=new TextEncoder().encode(e),t=r.length,n=t*8,o=(t+8>>6)+1<<6,s=new Uint8Array(o);s.set(r),s[t]=128;let a=new DataView(s.buffer);a.setUint32(o-8,Math.floor(n/4294967296),!1),a.setUint32(o-4,n>>>0,!1);let l=1779033703,u=3144134277,f=1013904242,m=2773480762,y=1359893119,d=2600822924,b=528734635,c=1541459225,p=new Uint32Array(64);for(let A=0;A<o;A+=64){for(let g=0;g<16;g++)p[g]=a.getUint32(A+g*4,!1);for(let g=16;g<64;g++){let O=k(p[g-15],7)^k(p[g-15],18)^p[g-15]>>>3,F=k(p[g-2],17)^k(p[g-2],19)^p[g-2]>>>10;p[g]=p[g-16]+O+p[g-7]+F>>>0}let i=l,v=u,x=f,S=m,h=y,P=d,w=b,E=c;for(let g=0;g<64;g++){let O=k(h,6)^k(h,11)^k(h,25),F=h&P^~h&w,j=E+O+F+se[g]+p[g]>>>0,te=k(i,2)^k(i,13)^k(i,22),ne=i&v^i&x^v&x,oe=te+ne>>>0;E=w,w=P,P=h,h=S+j>>>0,S=x,x=v,v=i,i=j+oe>>>0}l=l+i>>>0,u=u+v>>>0,f=f+x>>>0,m=m+S>>>0,y=y+h>>>0,d=d+P>>>0,b=b+w>>>0,c=c+E>>>0}return G(l)+G(u)}function $(e){return ae(e.join("|"))}var N={conversion_led:["pricing","cta","hero","comparison","social_proof","trust","features","faq","navigation","generic"],evidence_led:["features","comparison","faq","hero","trust","social_proof","pricing","cta","navigation","generic"],price_led:["pricing","comparison","social_proof","trust","cta","hero","features","faq","navigation","generic"],discovery_led:["hero","features","social_proof","pricing","cta","trust","faq","comparison","navigation","generic"]},B=["conversion_led","evidence_led","price_led","discovery_led"],ke={buyer:[...N.conversion_led],researcher:[...N.evidence_led],deal_seeker:[...N.price_led],browser:[...N.discovery_led]};function z(e,r,t,n){let o=N[t];if(!o)return e;let s=o.indexOf("generic"),a=f=>{let m=o.indexOf(f);return m===-1?s:m},l=n?e.filter(f=>n.get(f)!=="structural"):[...e];if(l.sort((f,m)=>{var b,c;let y=(b=r.get(f))!=null?b:"generic",d=(c=r.get(m))!=null?c:"generic";return a(y)-a(d)}),!n)return l;let u=0;return e.map(f=>n.get(f)==="structural"?f:l[u++])}function ie(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=Math.imul(r,16777619)>>>0;return r>>>0}function le(e,r,t,n){if(!t||t==="unknown")return e;let o=B[ie(t)%B.length];return z(e,r,o,n)}var Ce=le;function K(e,r,t){let n=new Map;n.set($(e),[...e]);for(let o of B){let s=z(e,r,o,t),a=$(s);n.has(a)||n.set(a,s)}return n}function Y(e,r){if(e<1)return Y(1+e,r)*Math.pow(Math.max(1e-15,r()),1/e);let t=e-1/3,n=1/Math.sqrt(9*t);for(;;){let o,s;do{let l=Math.max(1e-15,r()),u=r();o=Math.sqrt(-2*Math.log(l))*Math.cos(2*Math.PI*u),s=1+n*o}while(s<=0);s=s*s*s;let a=r();if(a<1-.0331*o*o*o*o||Math.log(a)<.5*o*o+t*(1-s+Math.log(s)))return t*s}}function M(e,r,t=Math.random){let n=Y(e,t),o=Y(r,t),s=n+o;return s<=0?e/(e+r):n/s}function W(e,r=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let t=e[0],n=M(t.alpha,t.beta,r);for(let o=1;o<e.length;o++){let s=e[o],a=M(s.alpha,s.beta,r);a>n&&(t=s,n=a)}return t.arm}function Ee(e,r,t,n,o=Math.random,s){var m,y;let a=K(e,r,s),l=[];for(let d of a.keys()){let b=n.get(d);l.push({arm:d,alpha:(m=b==null?void 0:b.alpha)!=null?m:1,beta:(y=b==null?void 0:b.beta)!=null?y:1})}let u=W(l,o),f=u?a.get(u):void 0;return f!=null?f:e}var Z=20;function C(e,r,t=20){let n=r.alpha+r.beta;if(n<=0||t<=0)return{alpha:e.alpha,beta:e.beta};let o=r.alpha/n,s=t*n/(n+t);return{alpha:e.alpha+s*o,beta:e.beta+s*(1-o)}}var ue=5;function Fe(e,r){var n,o;let t=null;for(let s of e){if(!r.includes(s.variantId))continue;let a=(n=s.pulls)!=null?n:0,l=a>0?a*s.avgReward/(a+ue):0;(!t||l>t.score)&&(t={variantId:s.variantId,score:l})}return(o=t==null?void 0:t.variantId)!=null?o:null}var R="__all__",U={exposures:0,conversions:0};function _(e){return{alpha:e.conversions+1,beta:Math.max(0,e.exposures-e.conversions)+1}}function Ue(e,r,t=20){var d,b,c,p;let n=(d=e.segment)!=null?d:U,o=(b=e.global)!=null?b:U,s=_(o),a=C(_(n),s,t);if(!r)return a;let l=(c=e.persona)!=null?c:U,u=(p=e.child)!=null?p:U,f=C(_(l),s,t),m=(n.exposures+1)/(n.exposures+l.exposures+2),y={alpha:m*a.alpha+(1-m)*f.alpha,beta:m*a.beta+(1-m)*f.beta};return C(_(u),y,t)}function Ie(e){var n,o;let r=null,t=-1;for(let s of e){let a=s.segment===R,l=s.persona===R,u=a&&l?3:a||l?2:1;u>t&&(t=u,r=s)}return{valueSum:(n=r==null?void 0:r.valueSum)!=null?n:0,valueCount:(o=r==null?void 0:r.valueCount)!=null?o:0}}function Te(e,r){return r==="unknown"||r===R||r===""?[{segment:e,persona:R},{segment:R,persona:R}]:[{segment:e,persona:r},{segment:e,persona:R},{segment:R,persona:r},{segment:R,persona:R}]}var X=4,ce="__global__";function J(e,r){return r<=0?0:Math.min(X-1,Math.floor(e*X/r))}function He(e,r){return e.map((t,n)=>{var o;return{parent:(o=r.get(t))!=null?o:"generic",bucket:J(n,e.length)}})}var H=(e,r)=>`${e}#${r}`;function qe(e,r,t,n,o=Math.random,s){var A;let a=K(e,r,s),l=new Map,u=new Map,f=0,m=0;for(let i of n)i.persona===ce?(l.set(H(i.parent,i.bucket),i),f+=i.exposures,m+=i.conversions):i.persona===t&&u.set(H(i.parent,i.bucket),i);let y=_({exposures:f,conversions:m}),d=new Map,b=(i,v)=>{var O,F;let x=H(i,v),S=d.get(x);if(S!==void 0)return S;let h=l.get(x),P=C(_({exposures:(O=h==null?void 0:h.exposures)!=null?O:0,conversions:(F=h==null?void 0:h.conversions)!=null?F:0}),y),w=u.get(x),E=w?C(_({exposures:w.exposures,conversions:w.conversions}),P):P,g=M(E.alpha,E.beta,o);return d.set(x,g),g},c=null,p=-1/0;for(let i of a.values()){let v=0;for(let x=0;x<i.length;x++)v+=b((A=r.get(i[x]))!=null?A:"generic",J(x,i.length));v>p&&(p=v,c=i)}return c!=null?c:e}var I="__global__",Xe=["device","source","persona","visit"];function Q(e){let r=[];return e.device&&r.push({factor:"device",level:e.device}),e.source&&r.push({factor:"source",level:e.source}),e.persona&&e.persona!==L&&r.push({factor:"persona",level:e.persona}),e.visit&&r.push({factor:"visit",level:e.visit}),r}var q=(e,r,t)=>`${e}\0${r}\0${t}`;function Je(e,r,t,n=Math.random){if(e.length===0)return null;if(e.length===1)return{arm:e[0],factorsUsed:0};let o=new Map,s=0,a=0;for(let c of t)o.set(q(c.arm,c.factor,c.level),c),c.level===I&&(s+=c.exposures,a+=c.conversions);let l=_({exposures:s,conversions:a}),u=Q(r),f=new Map,m=c=>{var A,i;let p=o.get(q(c,"global",I));return C(_({exposures:(A=p==null?void 0:p.exposures)!=null?A:0,conversions:(i=p==null?void 0:p.conversions)!=null?i:0}),l)},y=(c,p,A)=>{let i=q(c,p,A),v=f.get(i);if(v!==void 0)return v;let x=m(c),S=o.get(i),h=S?C(_({exposures:S.exposures,conversions:S.conversions}),x):x,P=M(h.alpha,h.beta,n);return f.set(i,P),P},d=null,b=-1/0;for(let c of e){let p=u.length===0?y(c,"global",I):0;for(let{factor:A,level:i}of u)p+=y(c,A,i);p>b&&(b=p,d=c)}return d===null?null:{arm:d,factorsUsed:u.length}}function Qe(e,r,t){let n=Number.isFinite(t)?Math.max(0,Math.min(1,t)):0,o=[{arm:e,factor:"global",level:I,weight:1}];for(let{factor:s,level:a}of Q(r))o.push({arm:e,factor:s,level:a,weight:s==="persona"?n:1});return o}function er(e){return e==null||!Number.isFinite(e)||e<1?null:e>1?"returning":"new"}function ee(e){return Object.keys(e).sort().map(r=>`${r}=${e[r]}`).join("|")}function re(e){if(e.length===0)return null;let r={};for(let t of e.split("|")){let n=t.indexOf("=");if(n<=0||n!==t.lastIndexOf("=")||n===t.length-1)return null;let o=t.slice(0,n);if(o in r)return null;r[o]=t.slice(n+1)}return r}function tr(e,r){return`${e}=${r}`}function fe(e){var t,n,o;if(e.arms)return typeof e.baseline=="string"?e.baseline:(t=e.arms[0])!=null?t:"";if(e.baseline!==void 0&&typeof e.baseline=="object")return ee(e.baseline);if(typeof e.baseline=="string")return e.baseline;let r={};for(let[s,a]of Object.entries((n=e.dims)!=null?n:{}))r[s]=(o=a[0])!=null?o:"";return ee(r)}function nr(e){let r=Array.isArray(e.arms),t=e.dims!=null;if(r&&t)return{ok:!1,reason:"declare exactly one of arms or dims (got both)"};if(!r&&!t)return{ok:!1,reason:"declare exactly one of arms or dims (got neither)"};if(r){let s=e.arms;if(s.length<2)return{ok:!1,reason:"arms requires at least 2 entries"};if(s.length>12)return{ok:!1,reason:"arms allows at most 12 entries"};if(new Set(s).size!==s.length)return{ok:!1,reason:"arms must be unique"};if(s.some(a=>a.includes("=")))return{ok:!1,reason:"enumerated arm ids may not contain '=' (reserved for dims encoding)"};if(e.baseline!==void 0){if(typeof e.baseline!="string")return{ok:!1,reason:"baseline for an arms slot must be a string"};if(!s.includes(e.baseline))return{ok:!1,reason:"baseline must be one of the declared arms"}}return{ok:!0}}let n=Object.entries(e.dims);if(n.length<1)return{ok:!1,reason:"dims requires at least 1 dimension"};if(n.length>4)return{ok:!1,reason:"dims allows at most 4 dimensions"};let o=1;for(let[s,a]of n){if(a.length<2)return{ok:!1,reason:`dim "${s}" requires at least 2 values`};if(a.length>6)return{ok:!1,reason:`dim "${s}" allows at most 6 values`};if(new Set(a).size!==a.length)return{ok:!1,reason:`dim "${s}" has duplicate values`};o*=a.length}if(o>64)return{ok:!1,reason:`declared space of ${o} combinations exceeds the 64 maximum`};if(e.baseline!==void 0){if(typeof e.baseline=="string")return{ok:!1,reason:"baseline for a dims slot must be a per-dim record"};let s=e.baseline,a=n.map(([u])=>u).sort(),l=Object.keys(s).sort();if(a.join(" ")!==l.join(" "))return{ok:!1,reason:"baseline must set every declared dim exactly once"};for(let[u,f]of n)if(!f.includes(s[u]))return{ok:!1,reason:`baseline value for dim "${u}" is not declared`}}return{ok:!0}}function or(e,r){var t,n;return e.dims!=null?(n=(t=re(r))!=null?t:re(fe(e)))!=null?n:{}:r}function pe(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=r+((r<<1)+(r<<4)+(r<<7)+(r<<8)+(r<<24))>>>0;return r}function ar(e,r,t){if(t.length===0)throw new Error("pickDeterministicArm requires at least one arm");let n=[...t].sort();return n[pe(`${e}:${r}`)%n.length]}function ir(e){return e>=.3?e<.7?"medium":"high":"low"}var me=20;function ge(e,r,t=me){let n=e.valueCount>0?e.valueSum/e.valueCount:0;if(r<=0)return n;if(e.valueCount<=0)return r;let o=e.valueCount/(e.valueCount+t);return o*n+(1-o)*r}function cr(e,r,t=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let n=null,o=-1/0;for(let s of e){let a=M(s.alpha,s.beta,t)*ge(s,r);a>o&&(n=s,o=a)}return n.arm}var de=/^[a-z0-9][a-z0-9_-]{0,31}$/;function mr(e){if(typeof e!="string")return null;let r=e.trim().toLowerCase();return r&&de.test(r)?r:null}var be=["unknown","__all__","buyers","researchers","deal-seekers","browsers"],xe=[],he=64;function ye(e){var t;let r=new Map;for(let n of e)if(n.status!=="retired"){r.set(n.key,n.key);for(let o of(t=n.aliases)!=null?t:[])be.includes(o)||r.set(o,n.key)}return r}function gr(e,r=xe){var l,u,f;let t=ye(r),n=(l=e.inferredConfidence)!=null?l:0,o,s=(f=(u=e.declared)==null?void 0:u.trim().toLowerCase())!=null?f:"";if(s!==""){let m=t.get(s),y=m===void 0?t.get(V(s)):void 0,d=m!=null?m:y;if(d!==void 0)return{persona:d,source:"declared",confidence:1};o=s.slice(0,he)}let a=V(e.clusterLabel);return a!==L&&t.has(a)?T({persona:t.get(a),source:"inferred",confidence:n},o!==void 0&&{unrecognizedDeclared:o}):T({persona:L,source:"none",confidence:n},o!==void 0&&{unrecognizedDeclared:o})}function dr(e){var t;if(e==null)return L;let r=e.trim().toLowerCase();return r===""?L:(t=D[r])!=null?t:r}export{ke as CLUSTER_PRIORITY,xe as DEFAULT_PERSONA_VOCABULARY,me as EV_SHRINK_K,I as GLOBAL_FACTOR_LEVEL,ce as GLOBAL_FACTOR_PERSONA,N as LAYOUT_ARCHETYPES,B as LAYOUT_ARCHETYPE_NAMES,X as LAYOUT_FACTOR_BUCKETS,D as LEGACY_PERSONA_MAP,ve as PERSONAS,Ae as PERSONA_DISPLAY,de as PERSONA_KEY_RE,R as POOL_ALL,be as RESERVED_PERSONA_KEYS,Z as SHRINKAGE_M,Xe as SLOT_FACTORS,L as UNKNOWN_PERSONA,ue as WEIGHTS_FALLBACK_PRIOR_PULLS,Ce as applyClusterHeuristic,Ie as broadestValueCell,K as candidateLayouts,ee as canonicalArm,V as canonicalPersona,Ee as chooseLayout,qe as chooseLayoutFactored,Je as chooseSlotArmFactored,ir as confidenceBand,dr as decisionPersona,He as factorCellsForOrder,Qe as factorCellsForTrial,Q as factorLevelsFor,pe as fnv1a,$ as hashLayout,J as layoutBucketOf,tr as marginalArmKey,mr as normalizeDeclaredPersona,z as orderByArchetype,re as parseArm,ar as pickDeterministicArm,Fe as pickFromWeights,Ue as pooledPosterior,_ as posteriorOfCounts,le as previewOrderForPersona,gr as resolvePersona,W as sampleArm,cr as sampleArmEv,M as sampleBeta,ge as shrunkAvgValue,C as shrunkPosterior,fe as slotBaselineArm,or as slotResultFor,nr as validateSlotDecl,er as visitLevel,Te as weightCellsFor};
+import{a as D}from"./chunk-HBG7RQ56.mjs";var R="unknown",Ae="Unknown";var te=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298];function k(e,r){return e>>>r|e<<32-r}function q(e){return(e>>>0).toString(16).padStart(8,"0")}function ne(e){let r=new TextEncoder().encode(e),t=r.length,n=t*8,o=(t+8>>6)+1<<6,s=new Uint8Array(o);s.set(r),s[t]=128;let a=new DataView(s.buffer);a.setUint32(o-8,Math.floor(n/4294967296),!1),a.setUint32(o-4,n>>>0,!1);let i=1779033703,u=3144134277,p=1013904242,m=2773480762,y=1359893119,d=2600822924,b=528734635,c=1541459225,f=new Uint32Array(64);for(let A=0;A<o;A+=64){for(let g=0;g<16;g++)f[g]=a.getUint32(A+g*4,!1);for(let g=16;g<64;g++){let E=k(f[g-15],7)^k(f[g-15],18)^f[g-15]>>>3,F=k(f[g-2],17)^k(f[g-2],19)^f[g-2]>>>10;f[g]=f[g-16]+E+f[g-7]+F>>>0}let l=i,v=u,x=p,C=m,h=y,_=d,P=b,O=c;for(let g=0;g<64;g++){let E=k(h,6)^k(h,11)^k(h,25),F=h&_^~h&P,B=O+E+F+te[g]+f[g]>>>0,Q=k(l,2)^k(l,13)^k(l,22),ee=l&v^l&x^v&x,re=Q+ee>>>0;O=P,P=_,_=h,h=C+B>>>0,C=x,x=v,v=l,l=B+re>>>0}i=i+l>>>0,u=u+v>>>0,p=p+x>>>0,m=m+C>>>0,y=y+h>>>0,d=d+_>>>0,b=b+P>>>0,c=c+O>>>0}return q(i)+q(u)}function N(e){return ne(e.join("|"))}var oe={conversion_led:["pricing","cta","hero","comparison","social_proof","trust","features","faq","navigation","generic"],evidence_led:["features","comparison","faq","hero","trust","social_proof","pricing","cta","navigation","generic"],price_led:["pricing","comparison","social_proof","trust","cta","hero","features","faq","navigation","generic"],discovery_led:["hero","features","social_proof","pricing","cta","trust","faq","comparison","navigation","generic"]},T=["conversion_led","evidence_led","price_led","discovery_led"];function Y(e,r,t,n){let o=oe[t];if(!o)return e;let s=o.indexOf("generic"),a=p=>{let m=o.indexOf(p);return m===-1?s:m},i=n?e.filter(p=>n.get(p)!=="structural"):[...e];if(i.sort((p,m)=>{var b,c;let y=(b=r.get(p))!=null?b:"generic",d=(c=r.get(m))!=null?c:"generic";return a(y)-a(d)}),!n)return i;let u=0;return e.map(p=>n.get(p)==="structural"?p:i[u++])}function se(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=Math.imul(r,16777619)>>>0;return r>>>0}function ae(e,r,t,n){if(!t||t==="unknown")return e;let o=T[se(t)%T.length];return Y(e,r,o,n)}var ke=ae;function U(e,r,t){let n=new Map;n.set(N(e),[...e]);for(let o of T){let s=Y(e,r,o,t),a=N(s);n.has(a)||n.set(a,s)}return n}function V(e,r){if(e<1)return V(1+e,r)*Math.pow(Math.max(1e-15,r()),1/e);let t=e-1/3,n=1/Math.sqrt(9*t);for(;;){let o,s;do{let i=Math.max(1e-15,r()),u=r();o=Math.sqrt(-2*Math.log(i))*Math.cos(2*Math.PI*u),s=1+n*o}while(s<=0);s=s*s*s;let a=r();if(a<1-.0331*o*o*o*o||Math.log(a)<.5*o*o+t*(1-s+Math.log(s)))return t*s}}function w(e,r,t=Math.random){let n=V(e,t),o=V(r,t),s=n+o;return s<=0?e/(e+r):n/s}function j(e,r=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let t=e[0],n=w(t.alpha,t.beta,r);for(let o=1;o<e.length;o++){let s=e[o],a=w(s.alpha,s.beta,r);a>n&&(t=s,n=a)}return t.arm}function Oe(e,r,t,n,o=Math.random,s){return ie(e,r,t,n,o,s).order}function ie(e,r,t,n,o=Math.random,s){var m,y;let a=U(e,r,s),i=[];for(let d of a.keys()){let b=n.get(d);i.push({arm:d,alpha:(m=b==null?void 0:b.alpha)!=null?m:1,beta:(y=b==null?void 0:b.beta)!=null?y:1})}let u=j(i,o),p=u?a.get(u):void 0;return u&&p?{order:p,chosenHash:u,candidates:i.map(d=>d.arm),arms:i}:{order:e,chosenHash:N(e),candidates:i.map(d=>d.arm),arms:i}}var z=20;function L(e,r,t=20){let n=r.alpha+r.beta;if(n<=0||t<=0)return{alpha:e.alpha,beta:e.beta};let o=r.alpha/n,s=t*n/(n+t);return{alpha:e.alpha+s*o,beta:e.beta+s*(1-o)}}var le=5;function Fe(e,r){var n,o;let t=null;for(let s of e){if(!r.includes(s.variantId))continue;let a=(n=s.pulls)!=null?n:0,i=a>0?a*s.avgReward/(a+le):0;(!t||i>t.score)&&(t={variantId:s.variantId,score:i})}return(o=t==null?void 0:t.variantId)!=null?o:null}var M="__all__",K={exposures:0,conversions:0};function S(e){return{alpha:e.conversions+1,beta:Math.max(0,e.exposures-e.conversions)+1}}function Ke(e,r,t=20){var d,b,c,f;let n=(d=e.segment)!=null?d:K,o=(b=e.global)!=null?b:K,s=S(o),a=L(S(n),s,t);if(!r)return a;let i=(c=e.persona)!=null?c:K,u=(f=e.child)!=null?f:K,p=L(S(i),s,t),m=(n.exposures+1)/(n.exposures+i.exposures+2),y={alpha:m*a.alpha+(1-m)*p.alpha,beta:m*a.beta+(1-m)*p.beta};return L(S(u),y,t)}function Ie(e){var n,o;let r=null,t=-1;for(let s of e){let a=s.segment===M,i=s.persona===M,u=a&&i?3:a||i?2:1;u>t&&(t=u,r=s)}return{valueSum:(n=r==null?void 0:r.valueSum)!=null?n:0,valueCount:(o=r==null?void 0:r.valueCount)!=null?o:0}}function De(e,r){return r==="unknown"||r===M||r===""?[{segment:e,persona:M},{segment:M,persona:M}]:[{segment:e,persona:r},{segment:e,persona:M},{segment:M,persona:r},{segment:M,persona:M}]}var G=4,ue="__global__";function W(e,r){return r<=0?0:Math.min(G-1,Math.floor(e*G/r))}function qe(e,r){return e.map((t,n)=>{var o;return{parent:(o=r.get(t))!=null?o:"generic",bucket:W(n,e.length)}})}var $=(e,r)=>`${e}#${r}`;function Ye(e,r,t,n,o=Math.random,s){var A;let a=U(e,r,s),i=new Map,u=new Map,p=0,m=0;for(let l of n)l.persona===ue?(i.set($(l.parent,l.bucket),l),p+=l.exposures,m+=l.conversions):l.persona===t&&u.set($(l.parent,l.bucket),l);let y=S({exposures:p,conversions:m}),d=new Map,b=(l,v)=>{var E,F;let x=$(l,v),C=d.get(x);if(C!==void 0)return C;let h=i.get(x),_=L(S({exposures:(E=h==null?void 0:h.exposures)!=null?E:0,conversions:(F=h==null?void 0:h.conversions)!=null?F:0}),y),P=u.get(x),O=P?L(S({exposures:P.exposures,conversions:P.conversions}),_):_,g=w(O.alpha,O.beta,o);return d.set(x,g),g},c=null,f=-1/0;for(let l of a.values()){let v=0;for(let x=0;x<l.length;x++)v+=b((A=r.get(l[x]))!=null?A:"generic",W(x,l.length));v>f&&(f=v,c=l)}return c!=null?c:e}var I="__global__",Xe=["device","source","persona","visit"];function Z(e){let r=[];return e.device&&r.push({factor:"device",level:e.device}),e.source&&r.push({factor:"source",level:e.source}),e.persona&&e.persona!==R&&r.push({factor:"persona",level:e.persona}),e.visit&&r.push({factor:"visit",level:e.visit}),r}var H=(e,r,t)=>`${e}\0${r}\0${t}`;function Je(e,r,t,n=Math.random){if(e.length===0)return null;if(e.length===1)return{arm:e[0],factorsUsed:0};let o=new Map,s=0,a=0;for(let c of t)o.set(H(c.arm,c.factor,c.level),c),c.level===I&&(s+=c.exposures,a+=c.conversions);let i=S({exposures:s,conversions:a}),u=Z(r),p=new Map,m=c=>{var A,l;let f=o.get(H(c,"global",I));return L(S({exposures:(A=f==null?void 0:f.exposures)!=null?A:0,conversions:(l=f==null?void 0:f.conversions)!=null?l:0}),i)},y=(c,f,A)=>{let l=H(c,f,A),v=p.get(l);if(v!==void 0)return v;let x=m(c),C=o.get(l),h=C?L(S({exposures:C.exposures,conversions:C.conversions}),x):x,_=w(h.alpha,h.beta,n);return p.set(l,_),_},d=null,b=-1/0;for(let c of e){let f=u.length===0?y(c,"global",I):0;for(let{factor:A,level:l}of u)f+=y(c,A,l);f>b&&(b=f,d=c)}return d===null?null:{arm:d,factorsUsed:u.length}}function Qe(e,r,t){let n=Number.isFinite(t)?Math.max(0,Math.min(1,t)):0,o=[{arm:e,factor:"global",level:I,weight:1}];for(let{factor:s,level:a}of Z(r)){let i=s==="persona"?n:1;i!==0&&o.push({arm:e,factor:s,level:a,weight:i})}return o}function er(e){return e==null||!Number.isFinite(e)||e<1?null:e>1?"returning":"new"}function X(e){return Object.keys(e).sort().map(r=>`${r}=${e[r]}`).join("|")}function J(e){if(e.length===0)return null;let r={};for(let t of e.split("|")){let n=t.indexOf("=");if(n<=0||n!==t.lastIndexOf("=")||n===t.length-1)return null;let o=t.slice(0,n);if(o in r)return null;r[o]=t.slice(n+1)}return r}function tr(e,r){return`${e}=${r}`}function ce(e){var t,n,o;if(e.arms)return typeof e.baseline=="string"?e.baseline:(t=e.arms[0])!=null?t:"";if(e.baseline!==void 0&&typeof e.baseline=="object")return X(e.baseline);if(typeof e.baseline=="string")return e.baseline;let r={};for(let[s,a]of Object.entries((n=e.dims)!=null?n:{}))r[s]=(o=a[0])!=null?o:"";return X(r)}function nr(e){let r=Array.isArray(e.arms),t=e.dims!=null;if(r&&t)return{ok:!1,reason:"declare exactly one of arms or dims (got both)"};if(!r&&!t)return{ok:!1,reason:"declare exactly one of arms or dims (got neither)"};if(r){let s=e.arms;if(s.length<2)return{ok:!1,reason:"arms requires at least 2 entries"};if(s.length>12)return{ok:!1,reason:"arms allows at most 12 entries"};if(new Set(s).size!==s.length)return{ok:!1,reason:"arms must be unique"};if(s.some(a=>a.includes("=")))return{ok:!1,reason:"enumerated arm ids may not contain '=' (reserved for dims encoding)"};if(e.baseline!==void 0){if(typeof e.baseline!="string")return{ok:!1,reason:"baseline for an arms slot must be a string"};if(!s.includes(e.baseline))return{ok:!1,reason:"baseline must be one of the declared arms"}}return{ok:!0}}let n=Object.entries(e.dims);if(n.length<1)return{ok:!1,reason:"dims requires at least 1 dimension"};if(n.length>4)return{ok:!1,reason:"dims allows at most 4 dimensions"};let o=1;for(let[s,a]of n){if(a.length<2)return{ok:!1,reason:`dim "${s}" requires at least 2 values`};if(a.length>6)return{ok:!1,reason:`dim "${s}" allows at most 6 values`};if(new Set(a).size!==a.length)return{ok:!1,reason:`dim "${s}" has duplicate values`};o*=a.length}if(o>64)return{ok:!1,reason:`declared space of ${o} combinations exceeds the 64 maximum`};if(e.baseline!==void 0){if(typeof e.baseline=="string")return{ok:!1,reason:"baseline for a dims slot must be a per-dim record"};let s=e.baseline,a=n.map(([u])=>u).sort(),i=Object.keys(s).sort();if(a.join(" ")!==i.join(" "))return{ok:!1,reason:"baseline must set every declared dim exactly once"};for(let[u,p]of n)if(!p.includes(s[u]))return{ok:!1,reason:`baseline value for dim "${u}" is not declared`}}return{ok:!0}}function or(e,r){var t,n;return e.dims!=null?(n=(t=J(r))!=null?t:J(ce(e)))!=null?n:{}:r}function fe(e){let r=2166136261;for(let t=0;t<e.length;t++)r^=e.charCodeAt(t),r=r+((r<<1)+(r<<4)+(r<<7)+(r<<8)+(r<<24))>>>0;return r}function ar(e,r,t){if(t.length===0)throw new Error("pickDeterministicArm requires at least one arm");let n=[...t].sort();return n[fe(`${e}:${r}`)%n.length]}function ir(e){return e>=.3?e<.7?"medium":"high":"low"}var pe=20;function me(e,r,t=pe){let n=e.valueCount>0?e.valueSum/e.valueCount:0;if(r<=0)return n;if(e.valueCount<=0)return r;let o=e.valueCount/(e.valueCount+t);return o*n+(1-o)*r}function cr(e,r,t=Math.random){if(e.length===0)return null;if(e.length===1)return e[0].arm;let n=null,o=-1/0;for(let s of e){let a=w(s.alpha,s.beta,t)*me(s,r);a>o&&(n=s,o=a)}return n.arm}var ge=/^[a-z0-9][a-z0-9_-]{0,31}$/;function de(e){if(typeof e!="string")return null;let r=e.trim().toLowerCase();return r&&ge.test(r)?r:null}var be=["unknown","__all__"];function xe(e){var r;return(r=de(e))!=null?r:R}var he=[],ye=64;function ve(e){var t;let r=new Map;for(let n of e)if(n.status!=="retired"){r.set(n.key,n.key);for(let o of(t=n.aliases)!=null?t:[])be.includes(o)||r.set(o,n.key)}return r}function mr(e,r=he){var i,u,p;let t=ve(r),n=(i=e.inferredConfidence)!=null?i:0,o,s=(p=(u=e.declared)==null?void 0:u.trim().toLowerCase())!=null?p:"";if(s!==""){let m=t.get(s);if(m!==void 0)return{persona:m,source:"declared",confidence:1};o=s.slice(0,ye)}let a=xe(e.clusterLabel);return a!==R&&t.has(a)?D({persona:t.get(a),source:"inferred",confidence:n},o!==void 0&&{unrecognizedDeclared:o}):D({persona:R,source:"none",confidence:n},o!==void 0&&{unrecognizedDeclared:o})}function gr(e){if(e==null)return R;let r=e.trim().toLowerCase();return r===""?R:r}export{he as DEFAULT_PERSONA_VOCABULARY,pe as EV_SHRINK_K,I as GLOBAL_FACTOR_LEVEL,ue as GLOBAL_FACTOR_PERSONA,oe as LAYOUT_ARCHETYPES,T as LAYOUT_ARCHETYPE_NAMES,G as LAYOUT_FACTOR_BUCKETS,ge as PERSONA_KEY_RE,M as POOL_ALL,be as RESERVED_PERSONA_KEYS,z as SHRINKAGE_M,Xe as SLOT_FACTORS,R as UNKNOWN_PERSONA,Ae as UNKNOWN_PERSONA_DISPLAY,le as WEIGHTS_FALLBACK_PRIOR_PULLS,ke as applyClusterHeuristic,Ie as broadestValueCell,U as candidateLayouts,X as canonicalArm,xe as canonicalPersona,Oe as chooseLayout,ie as chooseLayoutDetailed,Ye as chooseLayoutFactored,Je as chooseSlotArmFactored,ir as confidenceBand,gr as decisionPersona,qe as factorCellsForOrder,Qe as factorCellsForTrial,Z as factorLevelsFor,fe as fnv1a,N as hashLayout,W as layoutBucketOf,tr as marginalArmKey,de as normalizeDeclaredPersona,Y as orderByArchetype,J as parseArm,ar as pickDeterministicArm,Fe as pickFromWeights,Ke as pooledPosterior,S as posteriorOfCounts,ae as previewOrderForPersona,mr as resolvePersona,j as sampleArm,cr as sampleArmEv,w as sampleBeta,me as shrunkAvgValue,L as shrunkPosterior,ce as slotBaselineArm,or as slotResultFor,nr as validateSlotDecl,er as visitLevel,De as weightCellsFor};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentientui/policy",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "private": false,
   "description": "Pure decision-policy functions shared by the SentientUI API and the keyless local engine",
   "license": "MIT",