cbrowser 16.7.1 → 16.8.0

package/dist/values/value-mappings.js

@@ -0,0 +1,520 @@
+/**
+ * Value → Behavior → Influence Pattern Mappings
+ *
+ * Maps Schwartz values to behavioral tendencies and effective influence patterns.
+ * Used to predict which persuasion techniques will be effective for a given persona.
+ *
+ * @copyright 2026 WF Media (Alexandria Eden) alexandria.shai.eden@gmail.com
+ * @license BSL-1.1 (Business Source License 1.1) - See LICENSE file
+ *
+ * @references
+ * - Cialdini, R.B. (2001). Influence: Science and practice (4th ed.).
+ *   Boston: Allyn & Bacon.
+ *
+ * - Goldstein, N.J., Cialdini, R.B., & Griskevicius, V. (2008). A room with a
+ *   viewpoint: Using social norms to motivate environmental conservation.
+ *   Journal of Consumer Research, 35(3), 472-482.
+ *
+ * - Tversky, A., & Kahneman, D. (1974). Judgment under uncertainty: Heuristics
+ *   and biases. Science, 185(4157), 1124-1131.
+ *
+ * - Baumeister, R.F., Bratslavsky, E., Muraven, M., & Tice, D.M. (1998).
+ *   Ego depletion: Is the active self a limited resource?
+ *   Journal of Personality and Social Psychology, 74(5), 1252-1265.
+ */
+/**
+ * Behavioral mappings for each Schwartz value.
+ */
+export const VALUE_BEHAVIORS = {
+    selfDirection: {
+        highBehaviors: [
+            "Explores all options before deciding",
+            "Resists default selections",
+            "Customizes settings extensively",
+            "Questions recommended paths",
+            "Seeks control over experience",
+        ],
+        lowBehaviors: [
+            "Accepts defaults readily",
+            "Follows recommended paths",
+            "Minimal customization",
+            "Prefers guided experiences",
+        ],
+        positiveResponses: [
+            "Customization options",
+            "Advanced settings",
+            "Multiple pathways",
+            "DIY options",
+        ],
+        negativeResponses: [
+            "Forced paths",
+            "No customization",
+            "One-size-fits-all",
+            "Prescriptive guidance",
+        ],
+    },
+    stimulation: {
+        highBehaviors: [
+            "Clicks 'What's new' immediately",
+            "Tries beta features",
+            "Explores unfamiliar sections",
+            "Gets bored with routine",
+            "Seeks novel experiences",
+        ],
+        lowBehaviors: [
+            "Sticks to known paths",
+            "Avoids beta/experimental",
+            "Prefers familiar interfaces",
+            "Values consistency over novelty",
+        ],
+        positiveResponses: [
+            "New feature badges",
+            "Beta access",
+            "Exclusive early access",
+            "Gamification elements",
+        ],
+        negativeResponses: [
+            "Stale content",
+            "No updates visible",
+            "Boring/static design",
+            "Routine messaging",
+        ],
+    },
+    hedonism: {
+        highBehaviors: [
+            "Responds strongly to visual appeal",
+            "Prefers delightful micro-interactions",
+            "Values aesthetic over function",
+            "Seeks enjoyable experiences",
+        ],
+        lowBehaviors: [
+            "Ignores visual polish",
+            "Function over form",
+            "Minimal aesthetic concern",
+            "Task-focused only",
+        ],
+        positiveResponses: [
+            "Beautiful design",
+            "Smooth animations",
+            "Delightful interactions",
+            "Pleasure-focused copy",
+        ],
+        negativeResponses: [
+            "Utilitarian design",
+            "Clunky interactions",
+            "No visual appeal",
+            "Cold/clinical aesthetic",
+        ],
+    },
+    achievement: {
+        highBehaviors: [
+            "Seeks efficiency metrics",
+            "Wants ROI proof",
+            "Focuses on outcomes",
+            "Compares performance",
+            "Values competence signals",
+        ],
+        lowBehaviors: [
+            "Less concerned with metrics",
+            "Doesn't need ROI proof",
+            "Process over outcomes",
+            "Avoids comparisons",
+        ],
+        positiveResponses: [
+            "ROI calculators",
+            "Success metrics",
+            "Performance comparisons",
+            "Achievement badges",
+            "Efficiency claims",
+        ],
+        negativeResponses: [
+            "No proof of value",
+            "Vague benefits",
+            "No metrics",
+            "Unclear outcomes",
+        ],
+    },
+    power: {
+        highBehaviors: [
+            "Attracted to premium tiers",
+            "Seeks exclusive access",
+            "Values status signals",
+            "Wants differentiation",
+            "Responds to authority positioning",
+        ],
+        lowBehaviors: [
+            "Ignores premium positioning",
+            "Doesn't need exclusivity",
+            "Status-neutral",
+            "Prefers equality",
+        ],
+        positiveResponses: [
+            "Premium branding",
+            "Exclusive access",
+            "'VIP' or 'Elite' tiers",
+            "Status differentiation",
+            "Authority endorsements",
+        ],
+        negativeResponses: [
+            "Budget positioning",
+            "One-tier-for-all",
+            "Egalitarian messaging",
+            "No status differentiation",
+        ],
+    },
+    security: {
+        highBehaviors: [
+            "Reads all fine print",
+            "Seeks guarantees",
+            "Researches extensively",
+            "Avoids perceived risks",
+            "Needs trust signals",
+        ],
+        lowBehaviors: [
+            "Skips fine print",
+            "Comfortable with uncertainty",
+            "Quick decisions",
+            "Risk-tolerant",
+        ],
+        positiveResponses: [
+            "Money-back guarantees",
+            "Security badges",
+            "Trust seals",
+            "Detailed policies",
+            "Longevity claims",
+            "Insurance options",
+        ],
+        negativeResponses: [
+            "No guarantees visible",
+            "Missing trust signals",
+            "Unclear policies",
+            "New/unproven",
+            "Risk messaging",
+        ],
+    },
+    conformity: {
+        highBehaviors: [
+            "Reads reviews extensively",
+            "Follows recommendations",
+            "Seeks social validation",
+            "Influenced by majority behavior",
+            "Avoids being different",
+        ],
+        lowBehaviors: [
+            "Ignores reviews",
+            "Independent decisions",
+            "Doesn't need validation",
+            "Comfortable being different",
+        ],
+        positiveResponses: [
+            "Customer reviews",
+            "Testimonials",
+            "Social proof numbers",
+            "'Most popular' badges",
+            "User counts",
+        ],
+        negativeResponses: [
+            "No social proof",
+            "No reviews",
+            "Unique/different positioning",
+            "Minority messaging",
+        ],
+    },
+    tradition: {
+        highBehaviors: [
+            "Prefers established brands",
+            "Skeptical of new",
+            "Values heritage",
+            "Follows customs",
+            "Resistant to change",
+        ],
+        lowBehaviors: [
+            "Open to new brands",
+            "Embraces change",
+            "Questions traditions",
+            "Progressive outlook",
+        ],
+        positiveResponses: [
+            "Heritage messaging",
+            "'Since [year]' claims",
+            "Traditional values",
+            "Established brand signals",
+            "Conservative design",
+        ],
+        negativeResponses: [
+            "New/startup positioning",
+            "Disruptive messaging",
+            "Change-focused copy",
+            "Modern/trendy design",
+        ],
+    },
+    benevolence: {
+        highBehaviors: [
+            "Responds to helping messaging",
+            "Values community",
+            "Influenced by impact on others",
+            "Seeks to contribute",
+            "Empathetic responses",
+        ],
+        lowBehaviors: [
+            "Self-focused",
+            "Less community-oriented",
+            "Individual outcomes priority",
+            "Less empathetic",
+        ],
+        positiveResponses: [
+            "Community features",
+            "Helping others messaging",
+            "Team/family benefits",
+            "Charitable giving",
+            "Impact stories",
+        ],
+        negativeResponses: [
+            "Self-only benefits",
+            "No community aspect",
+            "Purely individual focus",
+            "No giving back",
+        ],
+    },
+    universalism: {
+        highBehaviors: [
+            "Checks for ethical practices",
+            "Values sustainability",
+            "Concerned with social impact",
+            "Broad concern for welfare",
+            "Environmental awareness",
+        ],
+        lowBehaviors: [
+            "Ignores ethical concerns",
+            "Sustainability not priority",
+            "Limited social concern",
+            "Individual focus",
+        ],
+        positiveResponses: [
+            "B-Corp certification",
+            "Sustainability claims",
+            "Social impact",
+            "Ethical sourcing",
+            "Environmental badges",
+            "Diversity messaging",
+        ],
+        negativeResponses: [
+            "No ethical signals",
+            "No sustainability",
+            "Pure profit focus",
+            "No social awareness",
+        ],
+    },
+};
+/**
+ * Research-backed influence patterns.
+ */
+export const INFLUENCE_PATTERNS = [
+    {
+        name: "scarcity",
+        description: "Limited availability or time creates urgency",
+        researchBasis: "Cialdini (2001): Scarcity increases perceived value",
+        targetValues: ["stimulation", "achievement", "power"],
+        mechanism: "FOMO activation, loss aversion trigger",
+        examples: ["Only 3 left in stock", "Offer ends in 2 hours", "Limited edition"],
+        effectivenessData: {
+            metric: "Conversion lift",
+            value: 0.178,
+            source: "CXL Institute (stock scarcity)",
+        },
+    },
+    {
+        name: "social_proof",
+        description: "Evidence of others' behavior guides decisions",
+        researchBasis: "Goldstein et al. (2008): Social norms drive behavior",
+        targetValues: ["conformity", "security"],
+        mechanism: "Uncertainty reduction through social validation",
+        examples: ["Trusted by 1M users", "4.8 stars from 10K reviews", "Most popular choice"],
+        effectivenessData: {
+            metric: "Purchase likelihood increase",
+            value: 0.77,
+            source: "Spiegel Research Center (1+ reviews)",
+        },
+    },
+    {
+        name: "authority",
+        description: "Expert endorsement increases credibility",
+        researchBasis: "Milgram (1963): Authority figures drive compliance",
+        targetValues: ["security", "conformity", "tradition"],
+        mechanism: "Trust transfer from authority to product",
+        examples: ["Recommended by doctors", "Used by Fortune 500", "Expert endorsed"],
+    },
+    {
+        name: "reciprocity",
+        description: "Giving something creates obligation to return",
+        researchBasis: "Cialdini (2001): Reciprocity norm is universal",
+        targetValues: ["benevolence", "conformity"],
+        mechanism: "Obligation creation through value provision",
+        examples: ["Free ebook download", "No-obligation trial", "Free assessment"],
+    },
+    {
+        name: "commitment",
+        description: "Small commitments lead to larger ones",
+        researchBasis: "Cialdini (2001): Consistency principle",
+        targetValues: ["achievement", "selfDirection"],
+        mechanism: "Self-consistency motivation after initial commitment",
+        examples: ["Save progress", "Quiz completion", "Profile building"],
+    },
+    {
+        name: "liking",
+        description: "Attractiveness and similarity increase persuasion",
+        researchBasis: "Cialdini (2001): We comply with those we like",
+        targetValues: ["hedonism", "benevolence"],
+        mechanism: "Positive affect transfer to product",
+        examples: ["Friendly tone", "Similar user stories", "Attractive design"],
+    },
+    {
+        name: "unity",
+        description: "Shared identity creates belonging",
+        researchBasis: "Cialdini (2016): The 7th principle of persuasion",
+        targetValues: ["benevolence", "tradition", "conformity"],
+        mechanism: "In-group identification and loyalty",
+        examples: ["Join our community", "Fellow founders", "Part of the family"],
+    },
+    {
+        name: "anchoring",
+        description: "First number sets reference point for comparison",
+        researchBasis: "Tversky & Kahneman (1974): Anchoring heuristic",
+        targetValues: ["achievement", "security"],
+        mechanism: "Reference point manipulation for value perception",
+        examples: ["Was $99, now $49", "Compare at $199", "Save 50%"],
+        effectivenessData: {
+            metric: "Sales increase (charm pricing)",
+            value: 0.24,
+            source: "Academic meta-analysis",
+        },
+    },
+    {
+        name: "decoy_effect",
+        description: "Inferior option makes target look better",
+        researchBasis: "Heath & Chatterjee (1995): Asymmetric dominance",
+        targetValues: ["achievement", "selfDirection"],
+        mechanism: "Comparative evaluation bias toward target",
+        examples: ["Basic/Pro/Enterprise tiers", "Odd pricing structures"],
+        effectivenessData: {
+            metric: "Target option boost",
+            value: 0.113,
+            source: "Heath & Chatterjee meta-analysis",
+        },
+    },
+    {
+        name: "loss_aversion",
+        description: "Framing as loss is more motivating than gain",
+        researchBasis: "Kahneman & Tversky (1979): Losses felt 2-2.5x more than gains",
+        targetValues: ["security", "achievement"],
+        mechanism: "Fear of loss activation",
+        examples: ["Don't miss out", "Stop losing leads", "Avoid costly mistakes"],
+    },
+    {
+        name: "default_bias",
+        description: "Pre-selected options are more likely to be chosen",
+        researchBasis: "Thaler & Sunstein (2008): Nudge theory",
+        targetValues: ["conformity", "security"],
+        mechanism: "Status quo bias, effort minimization",
+        examples: ["Pre-checked boxes", "Recommended tier highlighted", "Auto-enrolled"],
+        effectivenessData: {
+            metric: "Opt-out vs opt-in participation",
+            value: 0.75,
+            source: "Organ donation studies (90% vs 15%)",
+        },
+    },
+];
+/**
+ * Common value profile patterns and their persuasion susceptibilities.
+ */
+export const VALUE_PROFILE_PATTERNS = [
+    {
+        name: "security_focused",
+        description: "High security + conformity, low stimulation",
+        valueSignature: {
+            security: 0.8,
+            conformity: 0.7,
+            stimulation: 0.2,
+        },
+        effectivePatterns: ["social_proof", "authority", "default_bias"],
+        ineffectivePatterns: ["scarcity", "reciprocity"],
+    },
+    {
+        name: "achievement_driven",
+        description: "High achievement + power, moderate security",
+        valueSignature: {
+            achievement: 0.8,
+            power: 0.7,
+            security: 0.5,
+        },
+        effectivePatterns: ["anchoring", "decoy_effect", "commitment"],
+        ineffectivePatterns: ["unity", "reciprocity"],
+    },
+    {
+        name: "novelty_seeker",
+        description: "High stimulation + selfDirection, low tradition",
+        valueSignature: {
+            stimulation: 0.8,
+            selfDirection: 0.8,
+            tradition: 0.2,
+        },
+        effectivePatterns: ["scarcity", "commitment"],
+        ineffectivePatterns: ["authority", "social_proof", "default_bias"],
+    },
+    {
+        name: "community_oriented",
+        description: "High benevolence + universalism, moderate conformity",
+        valueSignature: {
+            benevolence: 0.8,
+            universalism: 0.7,
+            conformity: 0.5,
+        },
+        effectivePatterns: ["unity", "reciprocity", "liking"],
+        ineffectivePatterns: ["power", "scarcity"],
+    },
+    {
+        name: "tradition_keeper",
+        description: "High tradition + conformity + security",
+        valueSignature: {
+            tradition: 0.8,
+            conformity: 0.8,
+            security: 0.7,
+        },
+        effectivePatterns: ["authority", "social_proof", "default_bias"],
+        ineffectivePatterns: ["scarcity", "commitment"],
+    },
+];
+/**
+ * Calculate susceptibility score for an influence pattern given a value profile.
+ * @param values The persona's value profile
+ * @param pattern The influence pattern to evaluate
+ * @returns Susceptibility score 0-1 (higher = more susceptible)
+ */
+export function calculatePatternSusceptibility(values, pattern) {
+    const targetValues = pattern.targetValues;
+    if (targetValues.length === 0)
+        return 0.5;
+    let sum = 0;
+    let count = 0;
+    for (const value of targetValues) {
+        if (values[value] !== undefined) {
+            sum += values[value];
+            count++;
+        }
+    }
+    return count > 0 ? sum / count : 0.5;
+}
+/**
+ * Rank influence patterns by effectiveness for a given value profile.
+ * @param values The persona's value profile
+ * @returns Influence patterns sorted by susceptibility (most effective first)
+ */
+export function rankInfluencePatternsForProfile(values) {
+    return INFLUENCE_PATTERNS
+        .map((pattern) => ({
+        pattern,
+        susceptibility: calculatePatternSusceptibility(values, pattern),
+    }))
+        .sort((a, b) => b.susceptibility - a.susceptibility);
+}
+//# sourceMappingURL=value-mappings.js.map

package/dist/values/value-mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-mappings.js","sourceRoot":"","sources":["../../src/values/value-mappings.ts"],"names":[],"mappings":"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"}

package/docs/personas/Persona-ADHD.md

@@ -0,0 +1,135 @@
+# Cognitive ADHD User
+
+**Category**: Accessibility Personas
+**Description**: Users with Attention Deficit Hyperactivity Disorder experiencing challenges with sustained attention, working memory, and impulse control
+
+## Overview
+
+ADHD (Attention Deficit Hyperactivity Disorder) is a neurodevelopmental condition affecting executive function, attention regulation, and impulse control. Users with ADHD experience the digital world differently - they may hyperfocus on engaging content while struggling to complete routine tasks, get distracted by notifications and visual clutter, and have difficulty with multi-step processes that tax working memory.
+
+ADHD users often possess significant strengths alongside their challenges. High curiosity and creativity can lead to innovative problem-solving. The ability to hyperfocus on interesting tasks can result in deep engagement. However, interfaces that don't account for ADHD patterns can create significant barriers through distraction, cognitive overload, and friction in task completion.
+
+Designing for ADHD benefits many users by reducing cognitive load, minimizing distractions, and creating clearer paths to task completion. The strategies that help ADHD users - clear structure, reduced clutter, engaging feedback, and forgiveness for errors - improve the experience for everyone.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.2 | Difficulty sustaining attention during delays; fidgeting and frustration with waiting |
+| riskTolerance | 0.7 | Impulsivity leads to action before full consideration of consequences |
+| comprehension | 0.6 | Capable when engaged; inconsistent when attention wanders |
+| persistence | 0.3 | Low for unengaging tasks; can hyperfocus on interesting challenges |
+| curiosity | 0.9 | High novelty-seeking; drawn to new and interesting content |
+| workingMemory | 0.3 | Significant challenge; difficulty holding multiple items in mind |
+| readingTendency | 0.2 | Skim or skip text; prefer visual and interactive content |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.4 | Emotional dysregulation common; frustration and discouragement |
+| selfEfficacy | 0.4 | May have experienced repeated failures; internalized self-doubt |
+| trustCalibration | 0.5 | Moderate; may act impulsively before evaluating trustworthiness |
+| interruptRecovery | 0.3 | Extremely difficult to resume after distraction; may abandon |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.7 | Accept good-enough options to reduce decision fatigue |
+| informationForaging | 0.4 | Distractible; may go down tangential paths |
+| anchoringBias | 0.6 | First option favored due to decision fatigue avoidance |
+| timeHorizon | 0.3 | Strong preference for immediate rewards; difficulty with delayed gratification |
+| attributionStyle | 0.3 | May blame self; history of perceived failures |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.3 | Difficulty with planning and organization; reactive approach |
+| proceduralFluency | 0.4 | Inconsistent; routines help but are difficult to establish |
+| transferLearning | 0.5 | Variable; depends on engagement level |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.6 | May miss changes when attention elsewhere; hyperfocus can cause tunnel vision |
+| mentalModelRigidity | 0.4 | Flexible thinking; sometimes too flexible (difficulty maintaining mental model) |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.4 | May question or ignore authority recommendations impulsively |
+| emotionalContagion | 0.6 | Heightened emotional sensitivity |
+| fomo | 0.7 | Fear of missing out drives engagement with notifications, new features |
+| socialProofSensitivity | 0.5 | Moderate influence; depends on current focus |
+
+## Behavioral Patterns
+
+### Navigation
+ADHD users navigate impulsively, clicking interesting links before completing current tasks. They benefit from clear visual hierarchy that guides attention. They may open multiple tabs and lose track of original goal. Progress indicators and clear next steps help maintain task focus.
+
+### Decision Making
+Decisions are often quick and impulsive. Choice overload causes decision paralysis or random selection. Reducing options and highlighting recommended choices helps. Immediate feedback on decisions maintains engagement.
+
+### Error Recovery
+Errors are particularly frustrating and may cause abandonment. Clear, non-judgmental error messages are essential. Easy undo capabilities reduce consequences of impulsive actions. Autosave prevents loss of work during distraction.
+
+### Abandonment Triggers
+- Lengthy forms without progress saving
+- Walls of text
+- Visual clutter and competing attention demands
+- Slow loading without engaging feedback
+- Multi-step processes requiring memory of previous steps
+- Punitive error handling
+- Boring or unstimulating interfaces
+- Too many choices
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Low working memory | Progress indicators; save state frequently; reduce memory requirements |
+| Distractibility | Minimize visual clutter; clear focal points; hide non-essential elements |
+| Impulsivity | Gentle confirmation for important actions; easy undo; forgiving design |
+| Low persistence | Quick wins early; gamification elements; break tasks into small steps |
+| Reading difficulty | Scannable content; bullet points; visual communication |
+| Time blindness | Clear time estimates; progress indicators; gentle reminders |
+| Decision fatigue | Reduce choices; smart defaults; recommended options |
+
+## Research Basis
+
+- Barkley, R.A. (2015). Attention-Deficit Hyperactivity Disorder: A Handbook - Executive function deficits
+- Hallowell, E.M. & Ratey, J.J. (2011). Driven to Distraction - ADHD experience and coping
+- Ramsay, J.R. (2017). Cognitive Behavioral Therapy for Adult ADHD - Working memory and attention
+- Understood.org research on ADHD and technology use
+- Brown, T.E. (2013). A New Understanding of ADHD - Executive function model
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "cognitive-adhd",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona cognitive-adhd --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Working Memory](../traits/Trait-WorkingMemory.md)
+- [Patience](../traits/Trait-Patience.md)
+- [Curiosity](../traits/Trait-Curiosity.md)
+- [FOMO](../traits/Trait-FOMO.md)