cbrowser 18.63.0 → 18.63.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/package.json +1 -1
  2. package/docs/ASSESSMENT.md +0 -132
  3. package/docs/AUTH0-SETUP.md +0 -207
  4. package/docs/COGNITIVE-OPTIMAL-TRANSPORT-RESEARCH.md +0 -238
  5. package/docs/DEMO-DEPLOYMENT.md +0 -177
  6. package/docs/ENTERPRISE-INTEGRATION.md +0 -250
  7. package/docs/GETTING-STARTED.md +0 -232
  8. package/docs/INSTALL.md +0 -274
  9. package/docs/MCP-INTEGRATION.md +0 -301
  10. package/docs/METHODOLOGY.md +0 -276
  11. package/docs/PERSONA-QUESTIONNAIRE.md +0 -328
  12. package/docs/README.md +0 -45
  13. package/docs/REMOTE-MCP-SERVER.md +0 -569
  14. package/docs/SECURITY_WHITEPAPER.md +0 -475
  15. package/docs/STRESS-TEST-v16.14.4.md +0 -241
  16. package/docs/Tool-Cognitive-Journey-Autonomous.md +0 -270
  17. package/docs/Tool-Competitive-Benchmark.md +0 -293
  18. package/docs/Tool-Empathy-Audit.md +0 -331
  19. package/docs/Tool-Hunt-Bugs.md +0 -305
  20. package/docs/Tool-Marketing-Campaign.md +0 -298
  21. package/docs/Tool-Persona-Create.md +0 -274
  22. package/docs/Tools-Accessibility.md +0 -208
  23. package/docs/Tools-Browser-Automation.md +0 -311
  24. package/docs/Tools-Cognitive-Journeys.md +0 -233
  25. package/docs/Tools-Marketing-Intelligence.md +0 -271
  26. package/docs/Tools-Overview.md +0 -162
  27. package/docs/Tools-Persona-System.md +0 -300
  28. package/docs/Tools-Session-State.md +0 -278
  29. package/docs/Tools-Testing-Quality.md +0 -257
  30. package/docs/Tools-Utilities.md +0 -182
  31. package/docs/Tools-Visual-Performance.md +0 -278
  32. package/docs/hunt-bugs-coverage.md +0 -103
  33. package/docs/personas/Persona-ADHD.md +0 -141
  34. package/docs/personas/Persona-ElderlyUser.md +0 -137
  35. package/docs/personas/Persona-FirstTimer.md +0 -137
  36. package/docs/personas/Persona-ImpatientUser.md +0 -138
  37. package/docs/personas/Persona-Index.md +0 -302
  38. package/docs/personas/Persona-LowVision.md +0 -139
  39. package/docs/personas/Persona-MobileUser.md +0 -139
  40. package/docs/personas/Persona-MotorTremor.md +0 -139
  41. package/docs/personas/Persona-PowerUser.md +0 -135
  42. package/docs/personas/Persona-ScreenReaderUser.md +0 -139
  43. package/docs/research/Bibliography.md +0 -275
  44. package/docs/research/Research-Methodology.md +0 -244
  45. package/docs/research/Values-Research.md +0 -432
  46. package/docs/traits/Trait-AnchoringBias.md +0 -227
  47. package/docs/traits/Trait-AttributionStyle.md +0 -280
  48. package/docs/traits/Trait-AuthoritySensitivity.md +0 -141
  49. package/docs/traits/Trait-ChangeBlindness.md +0 -171
  50. package/docs/traits/Trait-Comprehension.md +0 -180
  51. package/docs/traits/Trait-Curiosity.md +0 -189
  52. package/docs/traits/Trait-EmotionalContagion.md +0 -144
  53. package/docs/traits/Trait-FOMO.md +0 -150
  54. package/docs/traits/Trait-Index.md +0 -166
  55. package/docs/traits/Trait-InformationForaging.md +0 -217
  56. package/docs/traits/Trait-InterruptRecovery.md +0 -249
  57. package/docs/traits/Trait-MentalModelRigidity.md +0 -228
  58. package/docs/traits/Trait-MetacognitivePlanning.md +0 -164
  59. package/docs/traits/Trait-Patience.md +0 -137
  60. package/docs/traits/Trait-Persistence.md +0 -165
  61. package/docs/traits/Trait-ProceduralFluency.md +0 -205
  62. package/docs/traits/Trait-ReadingTendency.md +0 -216
  63. package/docs/traits/Trait-Resilience.md +0 -162
  64. package/docs/traits/Trait-RiskTolerance.md +0 -162
  65. package/docs/traits/Trait-Satisficing.md +0 -181
  66. package/docs/traits/Trait-SelfEfficacy.md +0 -199
  67. package/docs/traits/Trait-SocialProofSensitivity.md +0 -155
  68. package/docs/traits/Trait-TimeHorizon.md +0 -267
  69. package/docs/traits/Trait-TransferLearning.md +0 -249
  70. package/docs/traits/Trait-TrustCalibration.md +0 -227
  71. package/docs/traits/Trait-WorkingMemory.md +0 -192
@@ -1,432 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Values Research](https://cbrowser.ai/docs/Values-Research)**
4
-
5
- ---
6
-
7
- # Values Research
8
-
9
- > **Copyright**: (c) 2026 Alexandria Eden. All rights reserved.
10
- >
11
- > **License**: [MIT License](https://github.com/alexandriashai/cbrowser/blob/main/LICENSE) - Converts to Apache 2.0 on February 5, 2030.
12
- >
13
- > **Note**: All research citations reference publicly available academic sources. Contact: alexandria.shai.eden@gmail.com
14
-
15
- ---
16
-
17
- ## Introduction
18
-
19
- CBrowser's values system enhances cognitive personas with research-backed psychological depth by integrating three foundational frameworks from motivational psychology:
20
-
21
- 1. **Schwartz's Theory of Basic Human Values** - The core framework defining 10 universal human values
22
- 2. **Self-Determination Theory (SDT)** - Psychological needs for autonomy, competence, and relatedness
23
- 3. **Maslow's Hierarchy of Needs** - Motivational priority based on need fulfillment level
24
-
25
- While **cognitive traits** describe HOW a persona behaves (patience, risk tolerance, working memory), **values** describe WHO the persona is at a motivational level (what drives their decisions, what they find meaningful, what influences persuade them).
26
-
27
- Values and traits are **parallel dimensions** that correlate but do not determine each other. A high-security persona tends toward lower risk tolerance, but the relationship is probabilistic, not deterministic.
28
-
29
- ---
30
-
31
- ## Academic Foundations
32
-
33
- The values system is built on peer-reviewed psychological research with established validity across cultures and contexts.
34
-
35
- | Framework | Author(s) | Year | Publication | DOI |
36
- |-----------|-----------|------|-------------|-----|
37
- | **Theory of Basic Human Values** | Schwartz, S.H. | 1992 | *Advances in Experimental Social Psychology*, 25, 1-65 | [10.1016/S0065-2601(08)60281-6](https://doi.org/10.1016/S0065-2601(08)60281-6) |
38
- | **Refined Theory of Basic Values** | Schwartz, S.H. | 2012 | *Online Readings in Psychology and Culture*, 2(1) | [10.9707/2307-0919.1116](https://doi.org/10.9707/2307-0919.1116) |
39
- | **Self-Determination Theory** | Deci, E.L. & Ryan, R.M. | 1985 | *Intrinsic Motivation and Self-Determination in Human Behavior*. Plenum Press | ISBN: 978-0306420221 |
40
- | **SDT and Well-Being** | Ryan, R.M. & Deci, E.L. | 2000 | *American Psychologist*, 55(1), 68-78 | [10.1037/0003-066X.55.1.68](https://doi.org/10.1037/0003-066X.55.1.68) |
41
- | **Hierarchy of Needs** | Maslow, A.H. | 1943 | *Psychological Review*, 50(4), 370-396 | [10.1037/h0054346](https://doi.org/10.1037/h0054346) |
42
-
43
- ### Additional Supporting Research
44
-
45
- | Topic | Citation | DOI |
46
- |-------|----------|-----|
47
- | Value hierarchies across cultures | Schwartz, S.H. & Bardi, A. (2001). *Journal of Cross-Cultural Psychology*, 32(3), 268-290 | [10.1177/0022022101032003002](https://doi.org/10.1177/0022022101032003002) |
48
- | Values and personality | Roccas, S., Sagiv, L., Schwartz, S.H. & Knafo, A. (2002). *Personality and Social Psychology Bulletin*, 28(6), 789-801 | [10.1177/0146167202289008](https://doi.org/10.1177/0146167202289008) |
49
- | Influence principles | Cialdini, R.B. (2001). *Influence: Science and Practice* (4th ed.). Allyn & Bacon | ISBN: 978-0321011473 |
50
- | Judgment heuristics | Tversky, A. & Kahneman, D. (1974). *Science*, 185(4157), 1124-1131 | [10.1126/science.185.4157.1124](https://doi.org/10.1126/science.185.4157.1124) |
51
-
52
- ---
53
-
54
- ## Schwartz's 10 Universal Values
55
-
56
- Schwartz's research identifies 10 values found across all cultures, representing fundamental motivational goals that guide human behavior. Each value is scored 0-1 in CBrowser.
57
-
58
- | Value | Definition | Behavioral Indicators in UX |
59
- |-------|------------|----------------------------|
60
- | **Self-Direction** | Independent thought and action - choosing, creating, exploring | Explores options before deciding, resists defaults, customizes settings extensively, questions recommended paths |
61
- | **Stimulation** | Excitement, novelty, and challenge in life | Clicks "What's New" immediately, tries beta features, explores unfamiliar sections, gets bored with routine |
62
- | **Hedonism** | Pleasure and sensuous gratification | Responds strongly to visual appeal, prefers delightful micro-interactions, values aesthetic alongside function |
63
- | **Achievement** | Personal success through demonstrating competence | Seeks efficiency metrics, wants ROI proof, focuses on outcomes, compares performance |
64
- | **Power** | Social status, prestige, control over resources | Attracted to premium tiers, seeks exclusive access, values status signals, responds to authority positioning |
65
- | **Security** | Safety, harmony, stability of society and self | Reads fine print, seeks guarantees, researches extensively, avoids perceived risks, needs trust signals |
66
- | **Conformity** | Restraint of actions likely to upset or harm others | Reads reviews extensively, follows recommendations, seeks social validation, influenced by majority behavior |
67
- | **Tradition** | Respect for customs and ideas from culture or religion | Prefers established brands, skeptical of new, values heritage, resistant to change |
68
- | **Benevolence** | Preserving and enhancing welfare of close others | Responds to helping messaging, values community, influenced by impact on others, seeks to contribute |
69
- | **Universalism** | Understanding, tolerance, protection of all people and nature | Checks for ethical practices, values sustainability, concerned with social impact, environmental awareness |
70
-
71
- ### Value Structure (Circumplex Model)
72
-
73
- Schwartz's values form a circular structure where adjacent values are compatible and opposing values are in conflict:
74
-
75
- ```
76
- OPENNESS TO CHANGE
77
- |
78
- Self-Direction | Stimulation
79
- \ | /
80
- \ | /
81
- Universalism \ | / Hedonism
82
- \ \ | / /
83
- \ \ | / /
84
- \ \ | / /
85
- SELF- ========= X ========= SELF-
86
- TRANSCENDENCE | ENHANCEMENT
87
- / / | \ \
88
- / / | \ \
89
- / / | \ \
90
- Benevolence / | \ Achievement
91
- / | \
92
- / | \
93
- Tradition | Power
94
- \ | /
95
- Security
96
- |
97
- CONSERVATION
98
- ```
99
-
100
- ---
101
-
102
- ## Higher-Order Value Dimensions
103
-
104
- The 10 basic values organize into 4 higher-order dimensions based on compatibility and conflict relationships (Schwartz, 2012). CBrowser calculates these automatically.
105
-
106
- | Higher-Order Dimension | Formula | Description |
107
- |------------------------|---------|-------------|
108
- | **Openness to Change** | `(selfDirection + stimulation) / 2` | Emphasizes independent thought, action, and readiness for new experience. Opposite of Conservation. |
109
- | **Self-Enhancement** | `(achievement + power) / 2` | Emphasizes pursuit of self-interest, success, and dominance. Opposite of Self-Transcendence. |
110
- | **Conservation** | `(security + conformity + tradition) / 3` | Emphasizes self-restriction, order, and resistance to change. Opposite of Openness to Change. |
111
- | **Self-Transcendence** | `(benevolence + universalism) / 2` | Emphasizes concern for welfare of others and nature. Opposite of Self-Enhancement. |
112
-
113
- ### Dimensional Conflicts
114
-
115
- The higher-order dimensions reveal fundamental motivational conflicts:
116
-
117
- - **Openness vs. Conservation**: Innovation-seeking vs. stability-seeking
118
- - **Self-Enhancement vs. Self-Transcendence**: Self-interest vs. collective welfare
119
-
120
- A persona high in openness will naturally be lower in conservation, and vice versa. These tensions are inherent to human motivation.
121
-
122
- ---
123
-
124
- ## Self-Determination Theory Integration
125
-
126
- Self-Determination Theory (Deci & Ryan, 1985, 2000) identifies three basic psychological needs that, when satisfied, lead to intrinsic motivation and well-being.
127
-
128
- | SDT Need | Definition | UX Implications |
129
- |----------|------------|-----------------|
130
- | **Autonomy Need** | Need for choice and control over one's actions | Responds positively to customization options, flexible workflows, and opt-in experiences. Negatively to forced paths and prescriptive guidance. |
131
- | **Competence Need** | Need to feel capable and effective | Responds positively to progressive disclosure, clear feedback, achievable challenges. Negatively to overwhelming complexity or trivially easy tasks. |
132
- | **Relatedness Need** | Need for connection with others | Responds positively to community features, social presence, collaborative elements. Negatively to isolation and purely transactional experiences. |
133
-
134
- ### Relationship to Schwartz Values
135
-
136
- SDT needs correlate with specific Schwartz values:
137
-
138
- | SDT Need | Primary Value Correlation |
139
- |----------|---------------------------|
140
- | Autonomy | Self-Direction |
141
- | Competence | Achievement |
142
- | Relatedness | Benevolence, Universalism |
143
-
144
- ---
145
-
146
- ## Maslow's Hierarchy Levels
147
-
148
- Maslow's Hierarchy of Needs (1943) describes motivational priority based on which needs are currently unmet. CBrowser uses this to understand the dominant motivational context.
149
-
150
- | Level | Name | Description | UX Relevance |
151
- |-------|------|-------------|--------------|
152
- | 1 | **Physiological** | Basic survival needs (food, water, shelter) | Rarely relevant to digital UX; represents extreme stress/crisis contexts |
153
- | 2 | **Safety** | Security, stability, freedom from fear | Trust signals, guarantees, security badges, privacy assurances are critical |
154
- | 3 | **Belonging** | Love, friendship, intimacy, community | Social features, community elements, connection opportunities valued |
155
- | 4 | **Esteem** | Achievement, status, recognition, confidence | Success metrics, badges, recognition, exclusive access motivating |
156
- | 5 | **Self-Actualization** | Reaching full potential, creativity, purpose | Learning opportunities, creative tools, personal growth features appeal |
157
-
158
- ### Maslow Level Assignments
159
-
160
- Different personas operate at different Maslow levels based on their circumstances:
161
-
162
- | Persona Category | Typical Maslow Level | Rationale |
163
- |------------------|---------------------|-----------|
164
- | First-time users | Safety | Need reassurance and trust building |
165
- | Anxious users | Safety | Elevated threat sensitivity |
166
- | Power users | Esteem | Seeking mastery and recognition |
167
- | Explorers | Self-Actualization | Driven by curiosity and growth |
168
- | Task-focused users | Esteem | Achievement and competence focus |
169
-
170
- ---
171
-
172
- ## Category-Aware Value Assignments
173
-
174
- CBrowser assigns values based on persona category, recognizing that different types of conditions affect motivation differently.
175
-
176
- ### Cognitive Conditions
177
-
178
- Conditions affecting cognition (like ADHD) have research-backed effects on motivational values.
179
-
180
- **ADHD Example:**
181
- - **High stimulation (0.9)**: Dopamine dysregulation drives novelty-seeking
182
- - **Low security (0.25)**: Routine feels aversive
183
- - **Low conformity (0.25)**: Difficulty following prescribed processes
184
- - **High self-direction (0.65)**: Resist constraints, prefer flexibility
185
-
186
- **Research basis:**
187
- - Barkley, R.A. (2015). *ADHD Handbook for Diagnosis and Treatment*
188
- - Volkow, N.D., et al. (2011). Motivation deficit in ADHD associated with dopamine reward pathway dysfunction. *Molecular Psychiatry*, 16. DOI: 10.1038/mp.2010.97
189
-
190
- ### Physical Conditions
191
-
192
- Motor and vision impairments affect security and autonomy needs but not core personality values.
193
-
194
- **Motor Tremor Example:**
195
- - **Higher security (0.75)**: Needs stable, forgiving interfaces
196
- - **Higher autonomy need (0.75)**: Need control over interaction pace
197
- - **Lower stimulation (0.3)**: Prefers predictable interfaces
198
-
199
- **Research basis:**
200
- - Trewin, S. (2000). Configuration agents, control and privacy. *ACM ASSETS*. DOI: 10.1145/354324.354328
201
- - Wobbrock, J.O., et al. (2011). Ability-Based Design. *CACM* 54(6). DOI: 10.1145/1924421.1924442
202
-
203
- ### Sensory-Only Conditions
204
-
205
- Conditions affecting only perception (like color blindness) receive neutral values because they do not change motivational psychology.
206
-
207
- **Color Blindness Example:**
208
- - All Schwartz values: **0.5** (neutral)
209
- - All SDT needs: **0.5** (neutral)
210
- - Maslow level: **Esteem** (typical)
211
-
212
- **Rationale:** Color vision deficiency affects perception, not personality. The person's motivations, goals, and values are independent of their color perception.
213
-
214
- ### Emotional Conditions
215
-
216
- Trait anxiety and confidence affect values through the behavioral inhibition/activation systems.
217
-
218
- **Anxious User Example:**
219
- - **Very high security (0.95)**: Core anxiety response
220
- - **Very low stimulation (0.2)**: Novelty triggers threat
221
- - **High conformity (0.8)**: Safety in following norms
222
- - **Low self-direction (0.3)**: Prefers guidance over independence
223
-
224
- **Research basis:**
225
- - Carver, C.S. & White, T.L. (1994). Behavioral inhibition, behavioral activation. *JPSP* 67(2). DOI: 10.1037/0022-3514.67.2.319
226
- - Gray, J.A. & McNaughton, N. (2000). *The Neuropsychology of Anxiety*. Oxford University Press.
227
-
228
- ---
229
-
230
- ## Value-to-Trait Correlations
231
-
232
- Values and traits correlate (r = 0.35-0.55) based on Schwartz & Bardi (2001) and Roccas et al. (2002). Values predict tendencies, not absolutes.
233
-
234
- | Value | Trait | Direction | Strength | Research Basis |
235
- |-------|-------|-----------|----------|----------------|
236
- | Security | Risk Tolerance | Inverse | Strong | r = -0.52 (Schwartz & Bardi, 2001) |
237
- | Security | Trust Calibration | Inverse | Moderate | r = -0.38 |
238
- | Stimulation | Curiosity | Direct | Strong | r = 0.55 (Roccas et al., 2002) |
239
- | Achievement | Patience | Inverse | Moderate | r = -0.40 |
240
- | Conformity | Social Proof Sensitivity | Direct | Strong | r = 0.48 |
241
- | Self-Direction | Authority Sensitivity | Inverse | Moderate | r = -0.42 |
242
- | Tradition | Mental Model Rigidity | Direct | Moderate | r = 0.38 |
243
-
244
- ---
245
-
246
- ## Trait-to-Value Derivation (v16.14.0)
247
-
248
- For **general-category** personas (no specific disability), values are derived FROM cognitive traits rather than defaulting to neutral (0.5). This produces more differentiated personas that reflect their behavioral profile.
249
-
250
- ### How It Works
251
-
252
- The `deriveValuesFromTraits()` function applies weighted correlations:
253
-
254
- ```
255
- derivedValue = baseline(0.5) + Σ(traitDeviation × weight × direction)
256
- ```
257
-
258
- Where:
259
- - **traitDeviation** = trait value - 0.5 (positive if above neutral, negative if below)
260
- - **weight** = correlation strength (0.3-0.7)
261
- - **direction** = +1 for positive correlation, -1 for inverse
262
-
263
- ### TRAIT_VALUE_CORRELATIONS
264
-
265
- | Trait | Affects | Direction | Weight | Research Basis |
266
- |-------|---------|-----------|--------|----------------|
267
- | curiosity | stimulation, selfDirection | + | 0.6, 0.5 | Kashdan (2018) |
268
- | riskTolerance | security, stimulation | -, + | 0.7, 0.4 | Schwartz (2012) |
269
- | patience | stimulation, tradition | -, + | 0.4, 0.3 | Baumeister (1998) |
270
- | persistence | achievement, competenceNeed | + | 0.6, 0.4 | Duckworth (2016) |
271
- | socialProofSensitivity | conformity, selfDirection | +, - | 0.7, 0.4 | Cialdini (2001) |
272
- | trustCalibration | security, benevolence | -, + | 0.5, 0.3 | Rotter (1971) |
273
- | authoritySensitivity | conformity, tradition, selfDirection | +, +, - | 0.5, 0.4, 0.3 | Schwartz (2012) |
274
- | fearOfMissingOut | stimulation, security | +, - | 0.6, 0.4 | Przybylski (2013) |
275
- | selfEfficacy | achievement, autonomyNeed, competenceNeed | + | 0.5, 0.6, 0.5 | Bandura (1997) |
276
- | resilience | competenceNeed, security | +, - | 0.5, 0.3 | Masten (2001) |
277
- | comprehension | selfDirection, competenceNeed | + | 0.4, 0.3 | Cognitive load research |
278
- | satisficing | achievement, stimulation | - | 0.4, 0.3 | Simon (1956) |
279
-
280
- ### Example: High-Curiosity, Low-Patience Persona
281
-
282
- **Input Traits:**
283
- - curiosity: 0.9 (deviation: +0.4)
284
- - patience: 0.2 (deviation: -0.3)
285
- - riskTolerance: 0.8 (deviation: +0.3)
286
-
287
- **Derived Values:**
288
- - stimulation: 0.98 (curiosity +0.24, patience +0.12, risk +0.12)
289
- - selfDirection: 0.78 (curiosity +0.2, risk +0.08)
290
- - security: 0.29 (riskTolerance -0.21)
291
- - tradition: 0.41 (patience -0.09)
292
-
293
- The `valueDerivations` field in persona output shows exactly which traits influenced which values.
294
-
295
- ---
296
-
297
- ## API Usage
298
-
299
- ### Accessing Persona Values
300
-
301
- ```typescript
302
- import {
303
- getPersonaValues,
304
- hasPersonaValues,
305
- type PersonaValues
306
- } from 'cbrowser/values';
307
-
308
- // Check if persona has values defined
309
- if (hasPersonaValues('adhd')) {
310
- const values = getPersonaValues('adhd');
311
- console.log(values?.stimulation); // 0.9
312
- console.log(values?.security); // 0.25
313
- console.log(values?.maslowLevel); // 'esteem'
314
- }
315
- ```
316
-
317
- ### Creating Custom Value Profiles
318
-
319
- ```typescript
320
- import {
321
- createPersonaValues,
322
- type SchwartzValues,
323
- type SDTNeeds,
324
- type MaslowLevel
325
- } from 'cbrowser/values';
326
-
327
- const schwartzValues: SchwartzValues = {
328
- selfDirection: 0.8,
329
- stimulation: 0.7,
330
- hedonism: 0.5,
331
- achievement: 0.6,
332
- power: 0.4,
333
- security: 0.3,
334
- conformity: 0.3,
335
- tradition: 0.2,
336
- benevolence: 0.6,
337
- universalism: 0.7,
338
- };
339
-
340
- const sdtNeeds: SDTNeeds = {
341
- autonomyNeed: 0.8,
342
- competenceNeed: 0.6,
343
- relatednessNeed: 0.5,
344
- };
345
-
346
- const maslowLevel: MaslowLevel = 'self-actualization';
347
-
348
- const customValues = createPersonaValues(
349
- schwartzValues,
350
- sdtNeeds,
351
- maslowLevel
352
- );
353
-
354
- // Higher-order values are calculated automatically
355
- console.log(customValues.openness); // 0.75 = (0.8 + 0.7) / 2
356
- console.log(customValues.selfEnhancement); // 0.5 = (0.6 + 0.4) / 2
357
- console.log(customValues.conservation); // 0.27 = (0.3 + 0.3 + 0.2) / 3
358
- console.log(customValues.selfTranscendence); // 0.65 = (0.6 + 0.7) / 2
359
- ```
360
-
361
- ### Using Influence Pattern Analysis
362
-
363
- ```typescript
364
- import {
365
- rankInfluencePatternsForProfile,
366
- calculatePatternSusceptibility,
367
- INFLUENCE_PATTERNS,
368
- type SchwartzValues
369
- } from 'cbrowser/values';
370
-
371
- const anxiousUserValues: Partial<SchwartzValues> = {
372
- security: 0.95,
373
- conformity: 0.8,
374
- stimulation: 0.2,
375
- selfDirection: 0.3,
376
- };
377
-
378
- // Rank all influence patterns by effectiveness
379
- const ranked = rankInfluencePatternsForProfile(anxiousUserValues);
380
-
381
- console.log('Most effective patterns for anxious user:');
382
- ranked.slice(0, 3).forEach(({ pattern, susceptibility }) => {
383
- console.log(` ${pattern.name}: ${(susceptibility * 100).toFixed(0)}%`);
384
- });
385
- // Output:
386
- // social_proof: 88%
387
- // authority: 82%
388
- // default_bias: 82%
389
-
390
- // Calculate susceptibility for specific pattern
391
- const scarcityPattern = INFLUENCE_PATTERNS.find(p => p.name === 'scarcity');
392
- const scarcitySusceptibility = calculatePatternSusceptibility(
393
- anxiousUserValues,
394
- scarcityPattern!
395
- );
396
- console.log(`Scarcity susceptibility: ${(scarcitySusceptibility * 100).toFixed(0)}%`);
397
- // Output: Scarcity susceptibility: 33% (low - anxious users resist urgency pressure)
398
- ```
399
-
400
- ### Accessing Value Behaviors
401
-
402
- ```typescript
403
- import { VALUE_BEHAVIORS } from 'cbrowser/values';
404
-
405
- const securityBehaviors = VALUE_BEHAVIORS.security;
406
-
407
- console.log('High security users:');
408
- securityBehaviors.highBehaviors.forEach(b => console.log(` - ${b}`));
409
- // - Reads all fine print
410
- // - Seeks guarantees
411
- // - Researches extensively
412
- // - Avoids perceived risks
413
- // - Needs trust signals
414
-
415
- console.log('Respond positively to:');
416
- securityBehaviors.positiveResponses.forEach(r => console.log(` - ${r}`));
417
- // - Money-back guarantees
418
- // - Security badges
419
- // - Trust seals
420
- // - Detailed policies
421
- // - Longevity claims
422
- // - Insurance options
423
- ```
424
-
425
- ---
426
-
427
- ## See Also
428
-
429
- - [Bibliography](./Bibliography.md) - Complete citation list for all CBrowser research
430
- - [Research Methodology](./Research-Methodology.md) - How traits and values are selected
431
- - [Trait Index](../traits/Trait-Index.md) - All 25 cognitive traits
432
- - [Persona Index](../personas/Persona-Index.md) - Pre-configured persona profiles
@@ -1,227 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Anchoring Bias](https://cbrowser.ai/docs/Trait-AnchoringBias)**
4
-
5
- ---
6
-
7
- # Anchoring Bias
8
-
9
- **Category**: Tier 3 - Decision-Making Traits
10
- **Scale**: 0.0 (low susceptibility) to 1.0 (high susceptibility)
11
-
12
- ## Definition
13
-
14
- Anchoring Bias describes the cognitive tendency to rely heavily on the first piece of information encountered (the "anchor") when making subsequent judgments, even when that anchor is arbitrary or irrelevant. In web contexts, this trait affects how users perceive prices (relative to initial prices shown), estimate quantities (based on default values), evaluate quality (influenced by first reviews seen), and process numerical information generally. High-anchoring users' judgments drift strongly toward initial values; low-anchoring users adjust more completely from anchors toward rational estimates.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
-
20
- > "In many situations, people make estimates by starting from an initial value that is adjusted to yield the final answer... adjustments are typically insufficient. That is, different starting points yield different estimates, which are biased toward the initial values."
21
- > — Tversky & Kahneman, 1974, p. 1128
22
-
23
- **Full Citation (APA 7):**
24
- Tversky, A., & Kahneman, D. (1974). Judgment under uncertainty: Heuristics and biases. *Science, 185*(4157), 1124-1131.
25
-
26
- **DOI**: https://doi.org/10.1126/science.185.4157.1124
27
-
28
- ### The Wheel Experiment
29
-
30
- The landmark demonstration of anchoring:
31
-
32
- > "Subjects were asked to estimate various quantities, stated in percentages (for example, the percentage of African countries in the United Nations). A wheel of fortune with numbers 1-100 was spun in subjects' presence. Subjects were first asked whether the quantity was higher or lower than the number on the wheel, and then asked for their estimate. The arbitrary number had a marked effect on estimates."
33
- > — Tversky & Kahneman, 1974, p. 1128
34
-
35
- **Key Finding:**
36
- - When the wheel stopped at **10**: Median estimate of African UN countries = **25%**
37
- - When the wheel stopped at **65**: Median estimate of African UN countries = **45%**
38
- - The anchor shifted estimates by **20 percentage points** despite being completely random
39
-
40
- ### Key Numerical Values
41
-
42
- | Metric | Value | Source |
43
- |--------|-------|--------|
44
- | Low anchor (10) -> estimate | 25% | Tversky & Kahneman (1974) |
45
- | High anchor (65) -> estimate | 45% | Tversky & Kahneman (1974) |
46
- | Anchor effect size | 20 percentage points | Tversky & Kahneman (1974) |
47
- | Real estate listing anchor effect | $11,000-14,000 | Northcraft & Neale (1987) |
48
- | Price anchor persistence | 48+ hours | Ariely et al. (2003) |
49
- | Anchor effect on WTP (willingness to pay) | 60-120% | Ariely et al. (2003) |
50
- | Expert susceptibility (real estate agents) | Nearly equal to amateurs | Northcraft & Neale (1987) |
51
-
52
- ## Behavioral Levels
53
-
54
- | Value | Label | Behaviors |
55
- |-------|-------|-----------|
56
- | 0.0-0.2 | Anchor Resistant | Largely ignores suggested values; makes independent estimates; skeptical of "was/now" pricing; compares across sources before forming judgments; resets expectations when context changes |
57
- | 0.2-0.4 | Low Susceptibility | Acknowledges anchors but adjusts significantly; cross-references prices and ratings; somewhat influenced by defaults but overrides when motivated; moderate adjustment from starting points |
58
- | 0.4-0.6 | Moderate Susceptibility | Noticeable anchor influence; accepts default form values frequently; price perception shaped by strikethrough prices; rating expectations set by first reviews; partial adjustment from anchors |
59
- | 0.6-0.8 | High Susceptibility | Strong anchor influence on judgments; "was $99, now $49" highly persuasive; first review strongly shapes opinion; default values rarely changed; limited adjustment from starting points |
60
- | 0.8-1.0 | Extreme Susceptibility | Anchors dominate judgment; original prices define value perception; first information encountered becomes truth; almost never changes default values; minimal adjustment regardless of evidence |
61
-
62
- ## Web Behavior Patterns
63
-
64
- ### Price Perception
65
-
66
- **Anchor-Resistant (0.0-0.3):**
67
- - Ignores "was/now" strikethrough pricing
68
- - Compares prices across multiple sites
69
- - Uses price history tools
70
- - Skeptical of "limited time" claims
71
- - Values absolute price over relative discount
72
-
73
- **Highly Anchored (0.7-1.0):**
74
- - "Was $200, now $99" feels like genuine 50% savings
75
- - First price seen sets value expectation
76
- - MSRP anchors all discount evaluations
77
- - Higher anchor makes actual price seem reasonable
78
- - "Compare at $150" influences perception
79
-
80
- ### Form Default Values
81
-
82
- **Anchor-Resistant:**
83
- - Reviews and changes default selections
84
- - Calculates appropriate values independently
85
- - Questions why defaults are set as they are
86
- - Changes tip percentages from suggested amounts
87
-
88
- **Highly Anchored:**
89
- - Accepts pre-filled values as appropriate
90
- - Uses suggested donation amounts
91
- - Leaves tip percentage at first option
92
- - Rarely modifies quantity defaults (qty: 1)
93
-
94
- ### Rating and Review Perception
95
-
96
- **Anchor-Resistant:**
97
- - Reads multiple reviews before forming opinion
98
- - Weights recent reviews appropriately
99
- - Discounts extreme first impressions
100
- - Considers review distribution not just average
101
-
102
- **Highly Anchored:**
103
- - First review shapes product perception
104
- - Initial star rating becomes expected quality
105
- - Early negative review creates lasting negative impression
106
- - "Featured review" disproportionately influential
107
-
108
- ### Numerical Estimation
109
-
110
- **Anchor-Resistant:**
111
- - Makes independent estimates before seeing suggestions
112
- - Recognizes irrelevant numbers as manipulation
113
- - Adjusts fully when given new information
114
-
115
- **Highly Anchored:**
116
- - "Enter amount: $100" influences donation amount
117
- - Suggested search refinements affect query
118
- - Countdown timers affect urgency perception
119
- - "X people are viewing this" shapes demand perception
120
-
121
- ## Estimated Trait Correlations
122
-
123
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
124
-
125
- | Related Trait | Correlation | Mechanism |
126
- |--------------|-------------|-----------|
127
- | [Comprehension](./Trait-Comprehension.md) | r = -0.22 | Understanding enables anchor recognition |
128
- | [Risk Tolerance](./Trait-RiskTolerance.md) | r = 0.18 | Risk-takers may use anchors as shortcuts |
129
- | [Satisficing](./Trait-Satisficing.md) | r = 0.35 | Satisficers accept anchored "good enough" values |
130
- | [Self-Efficacy](./Trait-SelfEfficacy.md) | r = -0.24 | Confidence enables independent judgment |
131
- | [Trust Calibration](./Trait-TrustCalibration.md) | r = -0.31 | Skeptics question anchor validity |
132
- | [Authority Sensitivity](./Trait-AuthoritySensitivity.md) | r = 0.38 | Authority-sensitive users accept suggested values |
133
-
134
- ## Persona Values
135
-
136
- | Persona | Anchoring Bias Value | Rationale |
137
- |---------|---------------------|-----------|
138
- | **Elderly Novice** | 0.80 | Trusts displayed values as authoritative |
139
- | **Distracted Teen** | 0.70 | Quick processing relies on anchors |
140
- | **First-Time User** | 0.65 | Lacks context for independent judgment |
141
- | **Overwhelmed Parent** | 0.60 | Cognitive load increases heuristic use |
142
- | **Anxious User** | 0.55 | Uncertainty increases anchor reliance |
143
- | **Careful Senior** | 0.45 | Methodical but still susceptible |
144
- | **Rushed Professional** | 0.50 | Time pressure increases anchoring |
145
- | **Power User** | 0.30 | Experience provides comparison context |
146
- | **Tech Enthusiast** | 0.25 | Research habits reduce anchor influence |
147
-
148
- ## Design Implications
149
-
150
- ### Ethical Anchoring
151
-
152
- 1. **Reasonable defaults** - Pre-fill values that genuinely help users
153
- 2. **Accurate original prices** - Show real previous prices, not inflated MSRPs
154
- 3. **Balanced review display** - Don't always show extreme reviews first
155
- 4. **Transparent suggestions** - Explain why values are suggested
156
-
157
- ### Dark Pattern Awareness
158
-
159
- Sites exploit anchoring through:
160
- - Inflated "original" prices
161
- - Extreme high-anchor subscription tiers ("Enterprise: $999/mo")
162
- - Pre-selected quantities or options
163
- - Artificially high "compare at" prices
164
- - Suggested tip amounts that anchor high
165
-
166
- ### Testing Considerations
167
-
168
- CBrowser tests should verify:
169
- - Users aren't manipulated by arbitrary anchors
170
- - Default values are genuinely helpful
171
- - Price presentations are honest
172
- - Review ordering is fair
173
-
174
- ## Measurement in CBrowser
175
-
176
- ```typescript
177
- // Anchoring affects value perception and defaults
178
- function perceiveValue(
179
- displayedPrice: number,
180
- originalPrice: number | null,
181
- traits: Traits
182
- ): PerceivedValue {
183
- if (originalPrice === null) {
184
- return { value: displayedPrice, confidence: 'neutral' };
185
- }
186
-
187
- const discount = (originalPrice - displayedPrice) / originalPrice;
188
- const anchorInfluence = discount * traits.anchoringBias;
189
-
190
- // Highly anchored users perceive more value from discount framing
191
- const perceivedValue = displayedPrice * (1 - anchorInfluence * 0.5);
192
-
193
- return {
194
- value: perceivedValue,
195
- confidence: anchorInfluence > 0.3 ? 'good-deal' : 'neutral',
196
- likelyToPurchase: anchorInfluence > 0.4
197
- };
198
- }
199
-
200
- // Default value acceptance
201
- function modifyDefault(defaultValue: number, optimalValue: number, traits: Traits): number {
202
- // High anchoring = accept default; low = adjust to optimal
203
- const adjustment = (optimalValue - defaultValue) * (1 - traits.anchoringBias);
204
- return defaultValue + adjustment;
205
- }
206
- ```
207
-
208
- ## See Also
209
-
210
- - [Satisficing](./Trait-Satisficing.md) - Anchors provide quick "good enough" answers
211
- - [Trust Calibration](./Trait-TrustCalibration.md) - Skepticism of anchor validity
212
- - [Authority Sensitivity](./Trait-AuthoritySensitivity.md) - Suggested values as authority
213
- - [Self-Efficacy](./Trait-SelfEfficacy.md) - Confidence to form independent judgments
214
- - [Time Horizon](./Trait-TimeHorizon.md) - Time pressure increases anchoring
215
- - [Persona Index](../personas/Persona-Index.md) - Trait combinations in personas
216
-
217
- ## Bibliography
218
-
219
- Ariely, D., Loewenstein, G., & Prelec, D. (2003). "Coherent arbitrariness": Stable demand curves without stable preferences. *The Quarterly Journal of Economics, 118*(1), 73-106. https://doi.org/10.1162/00335530360535153
220
-
221
- Furnham, A., & Boo, H. C. (2011). A literature review of the anchoring effect. *The Journal of Socio-Economics, 40*(1), 35-42. https://doi.org/10.1016/j.socec.2010.10.008
222
-
223
- Kahneman, D. (2011). *Thinking, fast and slow*. Farrar, Straus and Giroux.
224
-
225
- Northcraft, G. B., & Neale, M. A. (1987). Experts, amateurs, and real estate: An anchoring-and-adjustment perspective on property pricing decisions. *Organizational Behavior and Human Decision Processes, 39*(1), 84-97. https://doi.org/10.1016/0749-5978(87)90046-X
226
-
227
- Tversky, A., & Kahneman, D. (1974). Judgment under uncertainty: Heuristics and biases. *Science, 185*(4157), 1124-1131. https://doi.org/10.1126/science.185.4157.1124