cbrowser 20.2.2 → 21.0.1

package/dist/personas.js

@@ -17,10 +17,25 @@ import { AGENT_PERSONAS, isAgentPersona, getAgentPersona, listAgentPersonas, isA
 import { scopedDataDir, scopedAccountId } from "./persona-scope.js";
 import { currentRequestIdentity } from "./request-context.js";
 import { TRAIT_DEFINITIONS, canonicalizeTraits } from "./trait-reference.js";
+import { customReadingRateId, customReadingRule, displayReadingWpm } from "./visual/provenance/persona-rates.js";
+import { readPersonaAge, isOlderAdult } from "./persona-age.js";
+import { ageValue } from "./visual/provenance/age.js";
 // ============================================================================
 // Custom Personas Storage
 // ============================================================================
-const DATA_DIR = process.env.CBROWSER_DATA_DIR || join(homedir(), ".cbrowser");
+/**
+ * The unscoped data dir, read per call like the scoped one below.
+ *
+ * It was a constant read once at import. A process that never changes
+ * CBROWSER_DATA_DIR (the CLI, a server) sees no difference, but one that
+ * does kept the first value: in a `bun test` run, which shares one module
+ * registry across files, whichever file imported this first fixed the
+ * directory, and later files' temp CBROWSER_DATA_DIR were ignored, so their
+ * personas landed in ~/.cbrowser/personas (tests/real-personas-dir.test.ts).
+ */
+function dataDir() {
+    return process.env.CBROWSER_DATA_DIR || join(homedir(), ".cbrowser");
+}
 /**
  * Resolved per call, not once at module load.
  *
@@ -35,7 +50,7 @@ const DATA_DIR = process.env.CBROWSER_DATA_DIR || join(homedir(), ".cbrowser");
  * is the shape this codebase already removed from the billing path. (2026-08-01)
  */
 function personasDirFor() {
-    return join(scopedDataDir() ?? DATA_DIR, "personas");
+    return join(scopedDataDir() ?? dataDir(), "personas");
 }
 // ============================================================================
 // Runtime Persona Registry (for Enterprise extensions)
@@ -76,8 +91,9 @@ function scopedAccountPersonas() {
     return id === undefined ? {} : ACCOUNT_PERSONAS.get(id) ?? {};
 }
 function ensurePersonasDir() {
-    if (!existsSync(DATA_DIR)) {
-        mkdirSync(DATA_DIR, { recursive: true });
+    const base = dataDir();
+    if (!existsSync(base)) {
+        mkdirSync(base, { recursive: true });
     }
     if (!existsSync(personasDirFor())) {
         mkdirSync(personasDirFor(), { recursive: true });
@@ -331,7 +347,9 @@ export function listInvalidPersonas() {
  * Generate a persona from a natural language description using AI.
  * This creates realistic behavioral parameters based on the description.
  */
-export function generatePersonaFromDescription(name, description) {
+export function generatePersonaFromDescription(name, description, 
+/** An age range the author set (e.g. "65-74", "30"); wins over the description. */
+statedAgeRange) {
     // Analyze description for key traits
     const descLower = description.toLowerCase();
     // Determine tech level
@@ -339,7 +357,7 @@ export function generatePersonaFromDescription(name, description) {
     if (descLower.match(/expert|developer|engineer|tech.?savvy|power user|advanced/)) {
         techLevel = "expert";
     }
-    else if (descLower.match(/beginner|new|first.?time|elderly|senior|novice|learning/)) {
+    else if (descLower.match(/beginner|new|first.?time|novice|learning/)) {
         techLevel = "beginner";
     }
     // Determine device
@@ -350,20 +368,13 @@ export function generatePersonaFromDescription(name, description) {
     else if (descLower.match(/tablet|ipad/)) {
         device = "tablet";
     }
-    // Determine age range
-    let ageRange = "25-45";
-    if (descLower.match(/elderly|senior|older|65\+|retired/)) {
-        ageRange = "65+";
-    }
-    else if (descLower.match(/teen|young|student|gen.?z|18-24/)) {
-        ageRange = "18-24";
-    }
-    else if (descLower.match(/middle.?age|40s|50s/)) {
-        ageRange = "45-65";
-    }
+    // Age: only what the author stated (src/persona-age.ts). "Senior",
+    // "older" and "retired" alone state no age.
+    const ageRange = readPersonaAge({ name, description, ageRange: statedAgeRange }).label;
+    const olderAdult = isOlderAdult({ name, description, ageRange: statedAgeRange });
     // Determine speed/patience traits
     const isImpatient = descLower.match(/impatient|rush|fast|quick|busy|frustrated|annoyed/);
-    const isSlow = descLower.match(/slow|careful|cautious|elderly|senior|deliberate|thorough/);
+    const isSlow = descLower.match(/slow|careful|cautious|deliberate|thorough/);
     const isDistracted = descLower.match(/distract|adhd|multitask|busy|interrupt/);
     // Determine disability/accessibility needs
     const hasVisionIssues = descLower.match(/vision|blind|visually.?impaired|screen.?reader|low.?vision/);
@@ -372,7 +383,11 @@ export function generatePersonaFromDescription(name, description) {
     let reactionMin = 200, reactionMax = 500;
     let clickDelayMin = 100, clickDelayMax = 300;
     let typeSpeedMin = 50, typeSpeedMax = 120;
-    let readingSpeed = 250;
+    // 238 wpm (Brysbaert 2019) x the custom-persona reading rule's share: the
+    // reference unless the description names dyslexia, low vision or old age
+    // (provenance/persona-rates.ts). Replaced keyword guesses of 400 / 250 / 150 /
+    // 100 wpm that no source gave.
+    const readingSpeed = displayReadingWpm(customReadingRateId(customReadingRule({ name, description })));
     let scrollPauseMin = 200, scrollPauseMax = 500;
     if (techLevel === "expert" || isImpatient) {
         reactionMin = 100;
@@ -381,7 +396,6 @@ export function generatePersonaFromDescription(name, description) {
         clickDelayMax = 150;
         typeSpeedMin = 30;
         typeSpeedMax = 80;
-        readingSpeed = 400;
         scrollPauseMin = 100;
         scrollPauseMax = 300;
     }
@@ -392,18 +406,16 @@ export function generatePersonaFromDescription(name, description) {
         clickDelayMax = 800;
         typeSpeedMin = 100;
         typeSpeedMax = 200;
-        readingSpeed = 150;
         scrollPauseMin = 500;
         scrollPauseMax = 1500;
     }
-    if (hasMotorIssues || ageRange === "65+") {
+    if (hasMotorIssues || olderAdult) {
         reactionMin = Math.max(reactionMin, 800);
         reactionMax = Math.max(reactionMax, 2000);
         clickDelayMin = Math.max(clickDelayMin, 500);
         clickDelayMax = Math.max(clickDelayMax, 1200);
         typeSpeedMin = Math.max(typeSpeedMin, 150);
         typeSpeedMax = Math.max(typeSpeedMax, 300);
-        readingSpeed = Math.min(readingSpeed, 100);
     }
     // Calculate error parameters
     let misClickRate = 0.05;
@@ -521,7 +533,7 @@ export function generatePersonaFromDescription(name, description) {
         behaviors.short_sessions = true;
     }
     // Generate cognitive traits based on analysis
-    const cognitiveTraits = generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatient, isSlow, hasVisionIssues, ageRange);
+    const cognitiveTraits = generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatient, isSlow, hasVisionIssues, olderAdult);
     return {
         name,
         description,
@@ -570,7 +582,7 @@ export function generatePersonaFromDescription(name, description) {
 /**
  * Generate cognitive traits from a description analysis.
  */
-function generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatient, isSlow, hasVisionIssues, ageRange) {
+function generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatient, isSlow, hasVisionIssues, olderAdult) {
     // Base traits by tech level
     let patience = 0.5;
     let riskTolerance = 0.5;
@@ -616,14 +628,12 @@ function generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatien
         readingTendency = Math.max(readingTendency, 0.9);
         // Careful users often have moderate resilience - methodical recovery
     }
-    // Adjust for elderly
-    if (ageRange === "65+") {
-        patience = Math.max(patience, 0.9);
-        riskTolerance = Math.min(riskTolerance, 0.15);
-        comprehension = Math.min(comprehension, 0.25);
-        workingMemory = Math.min(workingMemory, 0.35);
-        readingTendency = Math.max(readingTendency, 0.85);
-        resilience = Math.min(resilience, 0.3); // Low - frustration lingers with age
+    // Older age: working memory only, the one trait with a published age
+    // direction (provenance/age.ts). Pointing and reading slow through the
+    // elderly rate profiles instead. The 13 other caps this block and the one
+    // below set for anyone guessed 65+ had no source and are gone (21.0.1).
+    if (olderAdult) {
+        workingMemory = Math.min(workingMemory, ageValue("age.olderAdult.workingMemory"));
     }
     // Adjust for vision issues (screen reader users)
     if (hasVisionIssues) {
@@ -709,17 +719,6 @@ function generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatien
         metacognitivePlanning = Math.max(metacognitivePlanning, 0.8); // Plan carefully
         fearOfMissingOut = Math.min(fearOfMissingOut, 0.2); // Not swayed by urgency
     }
-    // Adjust for elderly
-    if (ageRange === "65+") {
-        informationForaging = Math.min(informationForaging, 0.3); // Exhaustive search
-        changeBlindness = Math.max(changeBlindness, 0.7); // Miss changes
-        anchoringBias = Math.max(anchoringBias, 0.7); // Anchored to first info
-        attributionStyle = Math.max(attributionStyle, 0.8); // Blame self
-        proceduralFluency = Math.min(proceduralFluency, 0.35); // Struggle with sequences
-        transferLearning = Math.min(transferLearning, 0.25); // Each UI novel
-        authoritySensitivity = Math.max(authoritySensitivity, 0.7); // Trust authority
-        mentalModelFlexibility = Math.min(mentalModelFlexibility, 0.2); // Rigid mental models
-    }
     // Adjust for vision issues (screen reader users)
     if (hasVisionIssues) {
         informationForaging = Math.max(informationForaging, 0.7); // Sequential but efficient
@@ -759,7 +758,7 @@ function generateCognitiveTraitsFromDescription(descLower, techLevel, isImpatien
  */
 export function createCognitivePersona(name, description, traits, options = {}) {
     // Start with a base persona from description
-    const basePersona = generatePersonaFromDescription(name, description);
+    const basePersona = generatePersonaFromDescription(name, description, options.ageRange);
     // Merge provided traits with defaults
     const cognitiveTraits = {
         patience: traits.patience ?? basePersona.cognitiveTraits?.patience ?? 0.5,
@@ -1159,7 +1158,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 100, max: 300 },
                 clickDelay: { min: 50, max: 150 },
                 typeSpeed: { min: 30, max: 80 },
-                readingSpeed: 400,
+                readingSpeed: displayReadingWpm("personaRate.power-user.reading"),
                 scrollPauseTime: { min: 100, max: 300 },
             },
             errors: {
@@ -1238,7 +1237,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 500, max: 1500 },
                 clickDelay: { min: 300, max: 800 },
                 typeSpeed: { min: 100, max: 200 },
-                readingSpeed: 150,
+                readingSpeed: displayReadingWpm("personaRate.first-timer.reading"),
                 scrollPauseTime: { min: 500, max: 1500 },
             },
             errors: {
@@ -1261,7 +1260,7 @@ export const BUILTIN_PERSONAS = {
             },
         },
         cognitiveTraits: {
-            patience: 0.7, // Medium - willing to learn
+            patience: 0.7, // High - willing to invest time learning; expects some initial friction
             riskTolerance: 0.3, // Low - hesitates before clicking
             comprehension: 0.3, // Low - doesn't know conventions
             persistence: 0.5, // Medium - tries a few times
@@ -1311,7 +1310,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 200, max: 600 },
                 clickDelay: { min: 150, max: 400 },
                 typeSpeed: { min: 80, max: 150 },
-                readingSpeed: 200,
+                readingSpeed: displayReadingWpm("personaRate.mobile-user.reading"),
                 scrollPauseTime: { min: 200, max: 500 },
             },
             errors: {
@@ -1384,7 +1383,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 300, max: 800 },
                 clickDelay: { min: 200, max: 500 },
                 typeSpeed: { min: 50, max: 120 },
-                readingSpeed: 250,
+                readingSpeed: displayReadingWpm("personaRate.screen-reader-user.reading"),
                 scrollPauseTime: { min: 300, max: 700 },
             },
             errors: {
@@ -1417,14 +1416,14 @@ export const BUILTIN_PERSONAS = {
             // Sources: Information Wayfinding of Screen Reader Users, ASSETS 2024
             // (dl.acm.org/doi/fullHtml/10.1145/3663548.3688539); Context-Aware
             // Guidance for Screen Reader Users, CHI 2026 (10.1145/3772318.3790661).
-            riskTolerance: 0.2, // Medium - careful but experienced
+            riskTolerance: 0.2, // Low - unexpected behaviour disorients without visual context
             comprehension: 0.8, // High - expert at a11y patterns
             persistence: 0.9, // High - determination required
             curiosity: 0.2, // Low - structured navigation
             workingMemory: 0.7, // High - mental model essential
             readingTendency: 0.9, // Full - ALL content is read aloud
             resilience: 0.8, // High - experienced with setbacks (CD-RISC)
-            selfEfficacy: 0.7, // Medium - high in accessible sites, low otherwise (Bandura)
+            selfEfficacy: 0.7, // High - confident despite environmental barriers; lower on inaccessible sites (Bandura)
             satisficing: 0.6, // Medium - relies on structured review content (Simon)
             trustCalibration: 0.6, // Medium - cautious from past a11y failures (Fogg)
             interruptRecovery: 0.6, // High - strong mental model aids recovery (Mark)
@@ -1434,7 +1433,7 @@ export const BUILTIN_PERSONAS = {
             anchoringBias: 0.4, // Medium - sequential exposure to info
             timeHorizon: 0.3, // Long-term - patient, thorough
             attributionStyle: 0.4, // Medium - blames inaccessible design
-            metacognitivePlanning: 0.7, // Very high - plans navigation carefully
+            metacognitivePlanning: 0.7, // High - plans navigation carefully
             proceduralFluency: 0.8, // High - follows heading structure
             transferLearning: 0.7, // High - knows a11y patterns across sites
             authoritySensitivity: 0.5, // Medium - verifies with screen reader
@@ -1466,7 +1465,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 800, max: 2000 },
                 clickDelay: { min: 500, max: 1200 },
                 typeSpeed: { min: 150, max: 300 },
-                readingSpeed: 100,
+                readingSpeed: displayReadingWpm("personaRate.elderly-user.reading"),
                 scrollPauseTime: { min: 800, max: 2000 },
             },
             errors: {
@@ -1493,7 +1492,7 @@ export const BUILTIN_PERSONAS = {
             riskTolerance: 0.2, // Very low - afraid of mistakes
             comprehension: 0.2, // Low - unfamiliar with modern UI
             persistence: 0.6, // High - determined but confused
-            curiosity: 0.4, // Very low - just wants to finish
+            curiosity: 0.4, // Low-medium - goal-focused, prefers familiar patterns
             workingMemory: 0.4, // Low - may forget steps
             readingTendency: 0.8, // High - reads everything carefully
             resilience: 0.3, // Low - frustration lingers longer (BRS age-related)
@@ -1537,7 +1536,7 @@ export const BUILTIN_PERSONAS = {
             // procedural schema at all.
             proceduralFluency: 0.5,
             transferLearning: 0.2, // Low - each new site is confusing
-            authoritySensitivity: 0.7, // Very high - trusts official-looking things
+            authoritySensitivity: 0.7, // High - trusts official-looking things
             emotionalContagion: 0.6, // Medium-high - affected by stern warnings
             fearOfMissingOut: 0.3, // Low - not driven by urgency, confused by it
             socialProofSensitivity: 0.7, // High - relies on grandchildren's recommendations
@@ -1572,7 +1571,7 @@ export const BUILTIN_PERSONAS = {
                 reactionTime: { min: 100, max: 400 },
                 clickDelay: { min: 80, max: 200 },
                 typeSpeed: { min: 40, max: 100 },
-                readingSpeed: 350,
+                readingSpeed: displayReadingWpm("personaRate.impatient-user.reading"),
                 scrollPauseTime: { min: 100, max: 300 },
             },
             errors: {
@@ -1599,21 +1598,21 @@ export const BUILTIN_PERSONAS = {
             riskTolerance: 0.6, // High - clicks first thing
             comprehension: 0.6, // Medium
             persistence: 0.2, // Very low - one strike and out
-            curiosity: 0.3, // Very low - no time to explore
+            curiosity: 0.3, // Low - no time to explore
             workingMemory: 0.6, // Medium
             readingTendency: 0.1, // Almost none - scanning only
-            resilience: 0.3, // Very low - no recovery, abandons (BRS)
+            resilience: 0.3, // Low - frustration escalates quickly, abandons (BRS)
             selfEfficacy: 0.6, // Medium - impatient doesn't mean incapable (Bandura)
             satisficing: 0.9, // Very high - definition of satisficing (Simon)
             trustCalibration: 0.7, // High - clicks through without reading (Fogg)
             interruptRecovery: 0.2, // Very low - abandons rather than resumes (Mark)
             // New traits (v15.0.0)
             informationForaging: 0.9, // Very high - follows first scent, moves on
-            changeBlindness: 0.7, // Medium - focused on task
+            changeBlindness: 0.7, // High - misses changes while hunting for the CTA
             anchoringBias: 0.6, // Medium-high - goes with first option
             timeHorizon: 0.95, // Maximum short-term - no time for later
             attributionStyle: 0.3, // Low - blames slow site
-            metacognitivePlanning: 0.3, // Very low - no planning, just clicking
+            metacognitivePlanning: 0.3, // Low - minimal planning, just clicking
             proceduralFluency: 0.6, // Medium - can follow if fast
             transferLearning: 0.7, // High - recognizes patterns quickly
             authoritySensitivity: 0.4, // Medium - only if it speeds things up
@@ -1643,7 +1642,7 @@ export const BUILTIN_PERSONAS = {
         humanBehavior: {
             timing: {
                 reactionTime: { min: 250, max: 1400 }, clickDelay: { min: 120, max: 500 },
-                typeSpeed: { min: 25, max: 70 }, readingSpeed: 200,
+                typeSpeed: { min: 25, max: 70 }, readingSpeed: displayReadingWpm("personaRate.distracted-user.reading"),
                 scrollPauseTime: { min: 200, max: 1500 },
             },
             errors: { misClickRate: 0.09, doubleClickAccidental: 0.04, typoRate: 0.08, backtrackRate: 0.35 },
@@ -1671,7 +1670,7 @@ export const BUILTIN_PERSONAS = {
         humanBehavior: {
             timing: {
                 reactionTime: { min: 600, max: 2500 }, clickDelay: { min: 300, max: 900 },
-                typeSpeed: { min: 30, max: 80 }, readingSpeed: 130,
+                typeSpeed: { min: 30, max: 80 }, readingSpeed: displayReadingWpm("personaRate.careful-reader.reading"),
                 scrollPauseTime: { min: 800, max: 3000 },
             },
             errors: { misClickRate: 0.02, doubleClickAccidental: 0.01, typoRate: 0.02, backtrackRate: 0.08 },
@@ -1698,7 +1697,7 @@ export const BUILTIN_PERSONAS = {
         humanBehavior: {
             timing: {
                 reactionTime: { min: 200, max: 900 }, clickDelay: { min: 100, max: 350 },
-                typeSpeed: { min: 45, max: 110 }, readingSpeed: 250,
+                typeSpeed: { min: 45, max: 110 }, readingSpeed: displayReadingWpm("personaRate.explorer.reading"),
                 scrollPauseTime: { min: 200, max: 1200 },
             },
             errors: { misClickRate: 0.05, doubleClickAccidental: 0.02, typoRate: 0.04, backtrackRate: 0.25 },
@@ -1725,7 +1724,7 @@ export const BUILTIN_PERSONAS = {
         humanBehavior: {
             timing: {
                 reactionTime: { min: 200, max: 800 }, clickDelay: { min: 100, max: 300 },
-                typeSpeed: { min: 40, max: 100 }, readingSpeed: 260,
+                typeSpeed: { min: 40, max: 100 }, readingSpeed: displayReadingWpm("personaRate.task-focused.reading"),
                 scrollPauseTime: { min: 150, max: 600 },
             },
             errors: { misClickRate: 0.04, doubleClickAccidental: 0.02, typoRate: 0.04, backtrackRate: 0.12 },
@@ -1819,7 +1818,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 600, max: 1500 },
                 clickDelay: { min: 400, max: 1000 },
                 typeSpeed: { min: 150, max: 300 },
-                readingSpeed: 200,
+                readingSpeed: displayReadingWpm("personaRate.motor-impairment-tremor.reading"),
                 scrollPauseTime: { min: 500, max: 1200 },
             },
             errors: {
@@ -1865,7 +1864,10 @@ export const ACCESSIBILITY_PERSONAS = {
             // Research: Motor issues make resumption harder but adaptation helps (Mark)
             // Re-acquiring a small target after an interruption repeats the hardest
             // part of the interaction.
-            interruptRecovery: 0.6,
+            // (21.0: restored to the 0.4 this citation was written beside. The doc
+            // reconciliation of 2026-08-02 had set 0.6, above neutral, which
+            // contradicts the direction cited here.)
+            interruptRecovery: 0.4,
             // Every pointing action costs time and repeat attempts, so tolerance for
             // slow interaction is built in -- the persona's own research note records
             // 1-15Hz tremor and misclicks as the primary barrier.
@@ -1924,7 +1926,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 400, max: 1000 },
                 clickDelay: { min: 300, max: 700 },
                 typeSpeed: { min: 100, max: 180 },
-                readingSpeed: 100, // Slower due to magnification
+                readingSpeed: displayReadingWpm("personaRate.low-vision-magnified.reading"),
                 scrollPauseTime: { min: 600, max: 1500 },
             },
             errors: {
@@ -1970,10 +1972,16 @@ export const ACCESSIBILITY_PERSONAS = {
         cognitiveTraits: {
             // Research: Visual impairment + self-efficacy (Brody et al., 2002 - AMD and depression)
             // Reduced vision correlates with lower confidence in task completion
-            selfEfficacy: 0.6,
+            // (21.0: restored to the 0.45 this citation was written beside. The doc
+            // reconciliation of 2026-08-02 had set 0.6, above neutral, which
+            // contradicts the direction cited here.)
+            selfEfficacy: 0.45,
             // Research: Limited information access increases satisficing (Pachur & Hertwig, 2006)
             // Seeing only 1/9th of screen at a time → accept accessible options
-            satisficing: 0.4,
+            // (21.0: restored to the 0.65 this citation was written beside. The doc
+            // reconciliation of 2026-08-02 had set 0.4, the maximiser side, which
+            // contradicts the direction cited here.)
+            satisficing: 0.65,
             // Research: Vision impairment increases caution (Brody 2002)
             trustCalibration: 0.4,
             // Research: Limited visible area makes context recovery harder (Mark)
@@ -1993,7 +2001,7 @@ export const ACCESSIBILITY_PERSONAS = {
             timeHorizon: 0.4, // Patient, knows it takes time
             attributionStyle: 0.5, // Balanced - knows about limitations
             metacognitivePlanning: 0.7, // Plans navigation with zoom
-            proceduralFluency: 0.6, // Harder with limited view
+            proceduralFluency: 0.6, // Medium-high - builds routines for familiar sites; new layouts are harder with a limited view
             transferLearning: 0.6, // Standard
             authoritySensitivity: 0.5,
             emotionalContagion: 0.4,
@@ -2004,7 +2012,8 @@ export const ACCESSIBILITY_PERSONAS = {
     },
     "cognitive-adhd": {
         name: "cognitive-adhd",
-        // Research: 75-81% of ADHD cases show central executive WM impairment (PMC7483636)
+        // Research: 75-81% of ADHD cases show central executive WM impairment
+        // (Kofler et al. 2020, PMC7483636)
         // Impulsivity affects persistence and patience significantly
         description: "User with ADHD affecting focus and working memory",
         disabilityType: "Cognitive (ADHD/Attention)",
@@ -2025,7 +2034,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 150, max: 600 }, // Can be fast when hyperfocused
                 clickDelay: { min: 100, max: 400 },
                 typeSpeed: { min: 50, max: 120 },
-                readingSpeed: 250,
+                readingSpeed: displayReadingWpm("personaRate.cognitive-adhd.reading"),
                 scrollPauseTime: { min: 100, max: 400 },
             },
             errors: {
@@ -2088,7 +2097,17 @@ export const ACCESSIBILITY_PERSONAS = {
         // and "may blame self" beside 0.3 on a scale whose 1.0 end is "Blames
         // self". The prose was right every time; the digit was inverted.
         cognitiveTraits: {
-            workingMemory: 0.3, // Research: large magnitude impairment (d=1.63-2.03)
+            // Norm-anchored (paper section 3.1.1): the percentile of the adult
+            // population's mean on a normed instrument. Adults with ADHD average
+            // 95.2 on the WAIS-IV Working Memory Index, 95% CI 92.5-98.0, against
+            // the norm of 100 (SD 15) (Wilson 2024, Arch Clin Neuropsychol
+            // 39(4):498-515, Table 5). Phi((95.2 - 100) / 15) = 0.37, interval
+            // 0.31-0.45. Was 0.3, cited to Kofler et al. 2020 (Neuropsychology
+            // 34(6):686-698, PMC7483636; d = 1.63-2.03), whose sample is 172
+            // children aged 8-13; that study now gives the direction only.
+            // Still a hypothesis: that the WMI measures this trait is our mapping.
+            // research/persona-norms/applied.md.
+            workingMemory: 0.37,
             patience: 0.2, // Impulsivity: low tolerance for waiting
             persistence: 0.3, // Low for unengaging tasks; can hyperfocus on interesting ones
             curiosity: 0.9, // High novelty-seeking
@@ -2102,7 +2121,7 @@ export const ACCESSIBILITY_PERSONAS = {
             // claims at face value" -- which is what impulsive clicking without
             // reading looks like.
             trustCalibration: 0.65,
-            interruptRecovery: 0.3, // Very low - WM deficits make recovery difficult (Mark)
+            interruptRecovery: 0.3, // Low - WM deficits make recovery difficult (Mark)
             // New traits (v15.0.0)
             comprehension: 0.6, // Capable when engaged; this is UI-convention grasp, not reading
             informationForaging: 0.4, // Distractible; goes down tangential paths (doc; code had 0.6)
@@ -2116,7 +2135,7 @@ export const ACCESSIBILITY_PERSONAS = {
             // KEPT over the doc's 0.3. 1.0 is "Blames self (internal attribution)",
             // and the doc's own rationale for 0.3 was "may blame self".
             attributionStyle: 0.6,
-            metacognitivePlanning: 0.3, // Very low - impulsive, no planning
+            metacognitivePlanning: 0.3, // Low - impulsive, little planning
             proceduralFluency: 0.4, // Inconsistent; routines help but are hard to establish
             transferLearning: 0.5, // Variable; depends on engagement level
             authoritySensitivity: 0.4, // Low - impulsive, ignores authority
@@ -2132,7 +2151,9 @@ export const ACCESSIBILITY_PERSONAS = {
     },
     "dyslexic-user": {
         name: "dyslexic-user",
-        // Research: Dyslexic adults read ~178 WPM vs 248 WPM controls (Scientific Reports 2021)
+        // Research: students with dyslexia read 184.63 vs 243.64 wpm silently (Callens, Tops & Brysbaert 2012,
+        // the registered rate); adults with dyslexia 178.09 vs 248.18 wpm, medians (Franzen, Stark & Johnson 2021,
+        // Scientific Reports 11:6449).
         // About 72% of typical speed, with more fixations and regressions
         description: "User with dyslexia affecting reading and text processing",
         disabilityType: "Cognitive (Dyslexia/Reading)",
@@ -2153,7 +2174,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 400, max: 1000 },
                 clickDelay: { min: 200, max: 500 },
                 typeSpeed: { min: 80, max: 160 },
-                readingSpeed: 120, // Research: ~70% of normal (178/248 WPM)
+                readingSpeed: displayReadingWpm("personaRate.dyslexic-user.reading"),
                 scrollPauseTime: { min: 800, max: 2000 },
             },
             errors: {
@@ -2214,7 +2235,10 @@ export const ACCESSIBILITY_PERSONAS = {
             // Pulled down from 0.6 for documented secondary anxiety (Kapur & Agrawal
             // 2026), but not lower: the compensation literature describes adults
             // achieving academic success, so learned helplessness would overstate it.
-            resilience: 0.6,
+            // (21.0: restored to the 0.5 this comment was written for. The doc
+            // reconciliation of 2026-08-02 had moved it back to 0.6 by treating 0.5
+            // as an unclaimed neutral, against this citation's direction.)
+            resilience: 0.5,
             // Dyslexia is a strong predictor of lower academic self-efficacy in higher
             // education (PMC11488781; Nigerian undergraduate cohort).
             selfEfficacy: 0.3,
@@ -2277,7 +2301,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 200, max: 500 },
                 clickDelay: { min: 100, max: 300 },
                 typeSpeed: { min: 50, max: 100 },
-                readingSpeed: 250,
+                readingSpeed: displayReadingWpm("personaRate.deaf-user.reading"),
                 scrollPauseTime: { min: 300, max: 800 },
             },
             errors: {
@@ -2322,7 +2346,7 @@ export const ACCESSIBILITY_PERSONAS = {
             curiosity: 0.6,
             workingMemory: 0.6,
             informationForaging: 0.6, // Good visual navigation
-            changeBlindness: 0.3, // Very low - visually attentive
+            changeBlindness: 0.3, // Low - visually attentive
             anchoringBias: 0.5,
             timeHorizon: 0.5,
             attributionStyle: 0.4, // Blames lack of captions
@@ -2330,7 +2354,7 @@ export const ACCESSIBILITY_PERSONAS = {
             proceduralFluency: 0.7, // Good with visual instructions
             transferLearning: 0.7, // Recognizes visual patterns
             authoritySensitivity: 0.5,
-            emotionalContagion: 0.6, // Less affected by audio tone
+            emotionalContagion: 0.6, // Medium-high - reads visual emotional cues closely (facial expression)
             fearOfMissingOut: 0.4,
             socialProofSensitivity: 0.6, // Visual reviews/ratings
             mentalModelFlexibility: 0.65, // Good visual adaptation
@@ -2360,7 +2384,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 1000, max: 2500 },
                 clickDelay: { min: 600, max: 1500 },
                 typeSpeed: { min: 200, max: 400 },
-                readingSpeed: 80,
+                readingSpeed: displayReadingWpm("personaRate.elderly-low-vision.reading"),
                 scrollPauseTime: { min: 1000, max: 2500 },
             },
             errors: {
@@ -2417,22 +2441,22 @@ export const ACCESSIBILITY_PERSONAS = {
             curiosity: 0.3, // Low: prefers familiar patterns
             riskTolerance: 0.1, // Very cautious with unfamiliar interfaces
             comprehension: 0.3, // Unfamiliar with modern UI conventions
-            resilience: 0.6, // Low - frustration compounds with physical challenges (BRS)
-            selfEfficacy: 0.3, // Very low - often blame selves for tech issues (Bandura)
+            resilience: 0.6, // Medium-high - adapted over time; repeated barriers still discourage (BRS)
+            selfEfficacy: 0.3, // Low - often blame selves for tech issues (Bandura)
             satisficing: 0.7, // High - avoids complex decision trees (Simon)
-            trustCalibration: 0.4, // Very low - very skeptical of online requests (Fogg)
-            interruptRecovery: 0.3, // Very low - WM + vision decline makes recovery hard (Mark)
+            trustCalibration: 0.4, // Low-medium - wary of online requests, though official-looking content can win trust (Fogg)
+            interruptRecovery: 0.3, // Low - WM + vision decline makes recovery hard (Mark)
             // New traits (v15.0.0)
             readingTendency: 0.9,
-            informationForaging: 0.4, // Very low - exhaustive, uncertain
+            informationForaging: 0.4, // Low-medium - systematic, exhaustive search
             changeBlindness: 0.7, // High - vision issues
             anchoringBias: 0.8, // High - sticks to first info
             timeHorizon: 0.4, // Medium - patient but unsure
             attributionStyle: 0.9, // Very high - blames self
             metacognitivePlanning: 0.2, // Low - doesn't know what to plan
             proceduralFluency: 0.4, // Low - struggles with sequences
-            transferLearning: 0.4, // Very low - each UI is confusing
-            authoritySensitivity: 0.7, // Very high - trusts official things
+            transferLearning: 0.4, // Low-medium - each site needs new spatial and procedural learning
+            authoritySensitivity: 0.7, // High - trusts official things
             emotionalContagion: 0.6, // Medium-high
             fearOfMissingOut: 0.2, // Low - not driven by urgency
             socialProofSensitivity: 0.7, // High - relies on family advice
@@ -2462,7 +2486,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 200, max: 600 }, // Slight delay on color-coded UI
                 clickDelay: { min: 100, max: 400 },
                 typeSpeed: { min: 50, max: 100 },
-                readingSpeed: 250,
+                readingSpeed: displayReadingWpm("personaRate.color-blind-deuteranopia.reading"),
                 scrollPauseTime: { min: 200, max: 500 },
             },
             errors: {
@@ -2571,7 +2595,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 400, max: 1200 },
                 clickDelay: { min: 300, max: 900 },
                 typeSpeed: { min: 80, max: 180 },
-                readingSpeed: 180,
+                readingSpeed: displayReadingWpm("personaRate.autism-spectrum.reading"),
                 scrollPauseTime: { min: 400, max: 1200 },
             },
             errors: {
@@ -2602,7 +2626,18 @@ export const ACCESSIBILITY_PERSONAS = {
             fatigueSusceptibility: 0.5, // Moderate - sensory overload increases fatigue
         },
         cognitiveTraits: {
-            workingMemory: 0.6, // Often good - detail-oriented (Happé & Frith 2006)
+            // Norm-anchored (paper section 3.1.1): autistic adults without
+            // intellectual disability score below typical controls on working
+            // memory. Visuospatial WM accuracy, adult subgroup, d = -0.47, 95% CI
+            // -0.91 to -0.03, 4 studies, controls matched on age and IQ, every
+            // participant at IQ 70 or above (Habib et al. 2019, PLoS One
+            // 14(4):e0216198, Table 6). Phi(-0.47) = 0.32, interval
+            // 0.18-0.49. The adult phonological estimate is lower (d = -0.79,
+            // Phi = 0.21); the smaller deficit is used. Was 0.6, "often good -
+            // detail-oriented (Happe & Frith 2006)", which both adult estimates
+            // exclude. Still a hypothesis: that these tasks measure this trait is
+            // our mapping. research/persona-norms/applied.md.
+            workingMemory: 0.32,
             patience: 0.65, // Moderate-high - persistent on structured tasks
             persistence: 0.7, // High on predictable tasks, drops on chaotic ones
             curiosity: 0.4, // Lower - prefers known patterns over exploration
@@ -2659,7 +2694,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 800, max: 2500 },
                 clickDelay: { min: 500, max: 1500 },
                 typeSpeed: { min: 200, max: 500 },
-                readingSpeed: 80, // Significantly slower
+                readingSpeed: displayReadingWpm("personaRate.intellectual-disability.reading"),
                 scrollPauseTime: { min: 800, max: 2000 },
             },
             errors: {
@@ -2696,7 +2731,7 @@ export const ACCESSIBILITY_PERSONAS = {
             curiosity: 0.3, // Low - prefers familiar paths
             riskTolerance: 0.2, // Very low - sticks to obvious elements
             readingTendency: 0.3, // Low - relies on images and icons
-            comprehension: 0.2, // Low - needs plain language
+            comprehension: 0.2, // Low - needs explicit labels (UI conventions, not reading)
             resilience: 0.35, // Low - errors are discouraging (BRS)
             selfEfficacy: 0.3, // Low - often blames self for failures
             satisficing: 0.8, // High - takes first option that seems right
@@ -2746,7 +2781,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 600, max: 2000 },
                 clickDelay: { min: 400, max: 1200 },
                 typeSpeed: { min: 300, max: 800 }, // Text input very difficult
-                readingSpeed: 60, // Severely impaired language processing
+                readingSpeed: displayReadingWpm("personaRate.aphasia-receptive.reading"),
                 scrollPauseTime: { min: 600, max: 1500 },
             },
             errors: {
@@ -2783,7 +2818,7 @@ export const ACCESSIBILITY_PERSONAS = {
             curiosity: 0.3, // Low - new text-heavy pages are daunting
             riskTolerance: 0.25, // Low - unsure what labels mean
             readingTendency: 0.15, // Very low - avoids reading, seeks visual cues
-            comprehension: 0.25, // Low for text, normal for visual/spatial layouts
+            comprehension: 0.25, // Low - UI conventions, not reading; the language deficit is in the reading rate
             resilience: 0.45, // Medium - accustomed to communication barriers
             selfEfficacy: 0.4, // Low-medium - knows they can think, frustrated by language
             satisficing: 0.7, // High - takes first visual match
@@ -2834,7 +2869,7 @@ export const ACCESSIBILITY_PERSONAS = {
                 reactionTime: { min: 350, max: 900 },
                 clickDelay: { min: 200, max: 500 },
                 typeSpeed: { min: 80, max: 160 },
-                readingSpeed: 220, // Normal text reading speed
+                readingSpeed: displayReadingWpm("personaRate.dyscalculia.reading"),
                 scrollPauseTime: { min: 300, max: 800 },
             },
             errors: {
@@ -2874,7 +2909,7 @@ export const ACCESSIBILITY_PERSONAS = {
             curiosity: 0.6, // Normal - explores freely until numbers appear
             riskTolerance: 0.4, // Low-medium - cautious with purchases/quantities
             readingTendency: 0.65, // Medium-high - reads text normally, skips number-heavy sections
-            comprehension: 0.65, // Normal for text, low for numerical content
+            comprehension: 0.65, // Medium-high - UI conventions (not reading, not numeracy)
             // Math anxiety is documented as intense and self-reinforcing: errors raise
             // anxiety, which lowers WM, which produces more errors.
             resilience: 0.35,
@@ -3018,7 +3053,7 @@ export const EMOTIONAL_PERSONAS = {
                 reactionTime: { min: 400, max: 1200 }, // Slower due to deliberation
                 clickDelay: { min: 300, max: 800 }, // Hesitates before clicking
                 typeSpeed: { min: 80, max: 150 },
-                readingSpeed: 150, // Reads carefully
+                readingSpeed: displayReadingWpm("personaRate.anxious-user.reading"),
                 scrollPauseTime: { min: 400, max: 1000 },
             },
             errors: {
@@ -3041,15 +3076,15 @@ export const EMOTIONAL_PERSONAS = {
             },
         },
         cognitiveTraits: {
-            patience: 0.8, // Low - anxiety makes waiting feel worse
+            patience: 0.8, // High - spends time making sure it is safe; thoroughness over speed
             riskTolerance: 0.2, // Very low - avoids uncertain outcomes
             comprehension: 0.6, // Medium - understands but worries
-            persistence: 0.6, // Low-medium - gives up when anxious
+            persistence: 0.6, // Medium-high - persists while feeling safe; abandons when anxiety escalates
             curiosity: 0.3, // Low - prefers safe known paths
             workingMemory: 0.5, // Medium - anxiety can impair WM
             readingTendency: 0.9, // High - reads everything for reassurance
-            resilience: 0.3, // Very low - slow emotional recovery
-            selfEfficacy: 0.3, // Very low - doubts own abilities
+            resilience: 0.3, // Low - slow emotional recovery
+            selfEfficacy: 0.3, // Low - doubts own abilities
             satisficing: 0.3, // Low-medium - wants certainty
             trustCalibration: 0.2, // Low - skeptical and worried
             interruptRecovery: 0.4, // Low - anxiety compounds on interruption
@@ -3058,12 +3093,12 @@ export const EMOTIONAL_PERSONAS = {
             changeBlindness: 0.3, // Low - hypervigilant, notices changes
             anchoringBias: 0.7, // High - sticks to first safe option
             timeHorizon: 0.3, // Long-term - worries about consequences
-            attributionStyle: 0.7, // Very high - blames self for everything
+            attributionStyle: 0.7, // High - blames self, fears being at fault
             metacognitivePlanning: 0.6, // Medium-high - plans to avoid anxiety
             proceduralFluency: 0.5, // Medium - follows carefully
             transferLearning: 0.4, // Medium
             authoritySensitivity: 0.7, // High - seeks reassurance from authority
-            emotionalContagion: 0.7, // Very high - absorbs UI emotional tone
+            emotionalContagion: 0.7, // High - absorbs UI emotional tone
             fearOfMissingOut: 0.6, // Medium-high - anxiety about missing out
             socialProofSensitivity: 0.8, // High - seeks validation from others
             mentalModelFlexibility: 0.4, // Low-medium - struggles with unexpected
@@ -3095,7 +3130,7 @@ export const EMOTIONAL_PERSONAS = {
                 reactionTime: { min: 150, max: 400 },
                 clickDelay: { min: 80, max: 200 },
                 typeSpeed: { min: 40, max: 100 },
-                readingSpeed: 300,
+                readingSpeed: displayReadingWpm("personaRate.confident-user.reading"),
                 scrollPauseTime: { min: 150, max: 400 },
             },
             errors: {
@@ -3118,7 +3153,7 @@ export const EMOTIONAL_PERSONAS = {
             },
         },
         cognitiveTraits: {
-            patience: 0.3, // Medium - not impatient but efficient
+            patience: 0.3, // Low - expects quick outcomes; little tolerance for delays
             riskTolerance: 0.8, // High - willing to try things
             comprehension: 0.7, // High - understands quickly
             persistence: 0.7, // High - doesn't give up easily
@@ -3127,16 +3162,16 @@ export const EMOTIONAL_PERSONAS = {
             readingTendency: 0.2, // Low - scans efficiently
             resilience: 0.8, // Very high - bounces back immediately
             selfEfficacy: 0.9, // Very high - trusts own abilities
-            satisficing: 0.7, // Medium - balances speed and quality
+            satisficing: 0.7, // High - accepts good-enough quickly, trusts first judgment
             trustCalibration: 0.7, // High - appropriate trust
             interruptRecovery: 0.7, // High - resumes easily
             // New traits (v15.0.0)
             informationForaging: 0.8, // High - efficient scent-following
-            changeBlindness: 0.6, // Low - notices changes
+            changeBlindness: 0.6, // Medium-high - may miss changes while moving quickly
             anchoringBias: 0.3, // Low - evaluates options freely
             timeHorizon: 0.4, // Medium-long - thinks ahead
             attributionStyle: 0.2, // Low - blames system issues
-            metacognitivePlanning: 0.4, // High - plans efficiently
+            metacognitivePlanning: 0.4, // Low-medium - minimal planning; trusts ability to adapt
             proceduralFluency: 0.7, // High - follows procedures well
             transferLearning: 0.8, // High - applies knowledge
             authoritySensitivity: 0.3, // Low-medium - independent judgment
@@ -3172,7 +3207,7 @@ export const EMOTIONAL_PERSONAS = {
                 reactionTime: { min: 150, max: 600 }, // Variable based on mood
                 clickDelay: { min: 100, max: 400 },
                 typeSpeed: { min: 50, max: 130 },
-                readingSpeed: 220,
+                readingSpeed: displayReadingWpm("personaRate.emotional-user.reading"),
                 scrollPauseTime: { min: 200, max: 600 },
             },
             errors: {
@@ -3202,7 +3237,7 @@ export const EMOTIONAL_PERSONAS = {
             curiosity: 0.6, // Medium-high - excitement drives exploration
             workingMemory: 0.5, // Medium - emotions can interfere
             readingTendency: 0.6, // Medium
-            resilience: 0.4, // Very low - emotions linger long
+            resilience: 0.4, // Low-medium - negative experiences linger
             selfEfficacy: 0.5, // Medium - mood dependent
             satisficing: 0.6, // Medium-high - wants quick resolution
             trustCalibration: 0.5, // Medium - emotional judgment
@@ -3249,7 +3284,7 @@ export const EMOTIONAL_PERSONAS = {
                 reactionTime: { min: 250, max: 600 },
                 clickDelay: { min: 150, max: 350 },
                 typeSpeed: { min: 60, max: 120 },
-                readingSpeed: 220,
+                readingSpeed: displayReadingWpm("personaRate.stoic-user.reading"),
                 scrollPauseTime: { min: 250, max: 600 },
             },
             errors: {
@@ -3272,14 +3307,14 @@ export const EMOTIONAL_PERSONAS = {
             },
         },
         cognitiveTraits: {
-            patience: 0.7, // Very high - doesn't rush
+            patience: 0.7, // High - doesn't rush
             riskTolerance: 0.5, // Medium - balanced judgment
             comprehension: 0.7, // High - clear thinking
-            persistence: 0.7, // Very high - never gives up
+            persistence: 0.7, // High - persistent, not emotionally deterred
             curiosity: 0.4, // Medium - methodical exploration
             workingMemory: 0.7, // High - unaffected by emotion
             readingTendency: 0.7, // Medium-high - thorough
-            resilience: 0.8, // Maximum - emotions barely register
+            resilience: 0.8, // Very high - errors are data points, not emotional events
             selfEfficacy: 0.6, // High - quiet confidence
             satisficing: 0.4, // Low - willing to be thorough
             trustCalibration: 0.7, // Medium-high - rational evaluation
@@ -3294,8 +3329,8 @@ export const EMOTIONAL_PERSONAS = {
             proceduralFluency: 0.6, // High - follows procedures precisely
             transferLearning: 0.7, // High - applies experience
             authoritySensitivity: 0.4, // Low-medium - independent judgment
-            emotionalContagion: 0.2, // Minimum - emotionally unaffected
-            fearOfMissingOut: 0.2, // Minimum - not driven by urgency
+            emotionalContagion: 0.2, // Very low - emotionally unaffected
+            fearOfMissingOut: 0.2, // Very low - not driven by urgency
             socialProofSensitivity: 0.4, // Low - evaluates independently
             mentalModelFlexibility: 0.7, // High - adapts methodically
         },