cbrowser 18.62.0 → 18.63.1

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 (90) hide show
  1. package/README.md +32 -7
  2. package/dist/analysis/accessibility-empathy.d.ts.map +1 -1
  3. package/dist/analysis/accessibility-empathy.js +85 -22
  4. package/dist/analysis/accessibility-empathy.js.map +1 -1
  5. package/dist/mcp-server-remote.d.ts.map +1 -1
  6. package/dist/mcp-server-remote.js +89 -1
  7. package/dist/mcp-server-remote.js.map +1 -1
  8. package/dist/mcp-tools/base/audit-tools.d.ts.map +1 -1
  9. package/dist/mcp-tools/base/audit-tools.js +40 -2
  10. package/dist/mcp-tools/base/audit-tools.js.map +1 -1
  11. package/dist/mcp-tools/base/persona-comparison-tools.d.ts.map +1 -1
  12. package/dist/mcp-tools/base/persona-comparison-tools.js +33 -4
  13. package/dist/mcp-tools/base/persona-comparison-tools.js.map +1 -1
  14. package/dist/mcp-tools/base/site-knowledge-tools.js +1 -1
  15. package/dist/mcp-tools/base/site-knowledge-tools.js.map +1 -1
  16. package/dist/mcp-tools/index.d.ts +1 -1
  17. package/dist/mcp-tools/index.d.ts.map +1 -1
  18. package/dist/mcp-tools/index.js +1 -1
  19. package/dist/mcp-tools/index.js.map +1 -1
  20. package/package.json +1 -1
  21. package/docs/ASSESSMENT.md +0 -132
  22. package/docs/AUTH0-SETUP.md +0 -207
  23. package/docs/COGNITIVE-OPTIMAL-TRANSPORT-RESEARCH.md +0 -238
  24. package/docs/DEMO-DEPLOYMENT.md +0 -177
  25. package/docs/ENTERPRISE-INTEGRATION.md +0 -250
  26. package/docs/GETTING-STARTED.md +0 -232
  27. package/docs/INSTALL.md +0 -274
  28. package/docs/MCP-INTEGRATION.md +0 -301
  29. package/docs/METHODOLOGY.md +0 -276
  30. package/docs/PERSONA-QUESTIONNAIRE.md +0 -328
  31. package/docs/README.md +0 -45
  32. package/docs/REMOTE-MCP-SERVER.md +0 -569
  33. package/docs/SECURITY_WHITEPAPER.md +0 -475
  34. package/docs/STRESS-TEST-v16.14.4.md +0 -241
  35. package/docs/Tool-Cognitive-Journey-Autonomous.md +0 -270
  36. package/docs/Tool-Competitive-Benchmark.md +0 -293
  37. package/docs/Tool-Empathy-Audit.md +0 -331
  38. package/docs/Tool-Hunt-Bugs.md +0 -305
  39. package/docs/Tool-Marketing-Campaign.md +0 -298
  40. package/docs/Tool-Persona-Create.md +0 -274
  41. package/docs/Tools-Accessibility.md +0 -208
  42. package/docs/Tools-Browser-Automation.md +0 -311
  43. package/docs/Tools-Cognitive-Journeys.md +0 -233
  44. package/docs/Tools-Marketing-Intelligence.md +0 -271
  45. package/docs/Tools-Overview.md +0 -162
  46. package/docs/Tools-Persona-System.md +0 -300
  47. package/docs/Tools-Session-State.md +0 -278
  48. package/docs/Tools-Testing-Quality.md +0 -257
  49. package/docs/Tools-Utilities.md +0 -182
  50. package/docs/Tools-Visual-Performance.md +0 -278
  51. package/docs/hunt-bugs-coverage.md +0 -103
  52. package/docs/personas/Persona-ADHD.md +0 -141
  53. package/docs/personas/Persona-ElderlyUser.md +0 -137
  54. package/docs/personas/Persona-FirstTimer.md +0 -137
  55. package/docs/personas/Persona-ImpatientUser.md +0 -138
  56. package/docs/personas/Persona-Index.md +0 -302
  57. package/docs/personas/Persona-LowVision.md +0 -139
  58. package/docs/personas/Persona-MobileUser.md +0 -139
  59. package/docs/personas/Persona-MotorTremor.md +0 -139
  60. package/docs/personas/Persona-PowerUser.md +0 -135
  61. package/docs/personas/Persona-ScreenReaderUser.md +0 -139
  62. package/docs/research/Bibliography.md +0 -275
  63. package/docs/research/Research-Methodology.md +0 -244
  64. package/docs/research/Values-Research.md +0 -432
  65. package/docs/traits/Trait-AnchoringBias.md +0 -227
  66. package/docs/traits/Trait-AttributionStyle.md +0 -280
  67. package/docs/traits/Trait-AuthoritySensitivity.md +0 -141
  68. package/docs/traits/Trait-ChangeBlindness.md +0 -171
  69. package/docs/traits/Trait-Comprehension.md +0 -180
  70. package/docs/traits/Trait-Curiosity.md +0 -189
  71. package/docs/traits/Trait-EmotionalContagion.md +0 -144
  72. package/docs/traits/Trait-FOMO.md +0 -150
  73. package/docs/traits/Trait-Index.md +0 -166
  74. package/docs/traits/Trait-InformationForaging.md +0 -217
  75. package/docs/traits/Trait-InterruptRecovery.md +0 -249
  76. package/docs/traits/Trait-MentalModelRigidity.md +0 -228
  77. package/docs/traits/Trait-MetacognitivePlanning.md +0 -164
  78. package/docs/traits/Trait-Patience.md +0 -137
  79. package/docs/traits/Trait-Persistence.md +0 -165
  80. package/docs/traits/Trait-ProceduralFluency.md +0 -205
  81. package/docs/traits/Trait-ReadingTendency.md +0 -216
  82. package/docs/traits/Trait-Resilience.md +0 -162
  83. package/docs/traits/Trait-RiskTolerance.md +0 -162
  84. package/docs/traits/Trait-Satisficing.md +0 -181
  85. package/docs/traits/Trait-SelfEfficacy.md +0 -199
  86. package/docs/traits/Trait-SocialProofSensitivity.md +0 -155
  87. package/docs/traits/Trait-TimeHorizon.md +0 -267
  88. package/docs/traits/Trait-TransferLearning.md +0 -249
  89. package/docs/traits/Trait-TrustCalibration.md +0 -227
  90. package/docs/traits/Trait-WorkingMemory.md +0 -192
@@ -1,276 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[CBrowser Scoring Methodology & Research Sources](https://cbrowser.ai/docs/METHODOLOGY)**
4
-
5
- ---
6
-
7
- # CBrowser Scoring Methodology & Research Sources
8
-
9
- CBrowser's analysis features use **heuristic estimates** calibrated against published UX and accessibility research. This document explains our methodology, sources, and limitations.
10
-
11
- ---
12
-
13
- ## Important Disclaimers
14
-
15
- > **Letter grades, not percentages.** We use letter grades (A-F) instead of percentage scores to avoid implying false precision. These are directional indicators, not measurements.
16
-
17
- > **Heuristic estimates, not predictions.** Scores indicate relative comparison value, not actual user behavior predictions.
18
-
19
- > **Not a substitute for real testing.** For accessibility, combine with automated WCAG checkers and user testing with people who have disabilities.
20
-
21
- ---
22
-
23
- ## Research Sources & Bibliography
24
-
25
- ### Page Load & Abandonment
26
-
27
- | Metric | Threshold | Source |
28
- |--------|-----------|--------|
29
- | Mobile abandonment at 3s load | 53% | Google/SOASTA "The State of Online Retail Performance" (2017)¹ |
30
- | Abandonment increase per second | +7% | Akamai "State of Online Retail Performance" (2017)² |
31
-
32
- ¹ *Google/SOASTA. "The State of Online Retail Performance." 2017. https://www.thinkwithgoogle.com/marketing-resources/data-measurement/mobile-page-speed-new-industry-benchmarks/*
33
-
34
- ² *Akamai. "Akamai Online Retail Performance Report: Milliseconds Are Critical." 2017.*
35
-
36
- ### Form Complexity & Cognitive Load
37
-
38
- | Metric | Threshold | Source |
39
- |--------|-----------|--------|
40
- | Optimal form field count | 7-8 fields | Baymard Institute "Checkout Usability" (2024)³ |
41
- | Average e-commerce checkout fields | 23 fields | Baymard Institute (2024)³ |
42
- | Abandonment with too many steps | 67% | Baymard Institute Cart Abandonment Research⁴ |
43
-
44
- ³ *Baymard Institute. "The Current State of Checkout UX." 2024. https://baymard.com/checkout-usability*
45
-
46
- ⁴ *Baymard Institute. "49 Cart Abandonment Rate Statistics." https://baymard.com/lists/cart-abandonment-rate*
47
-
48
- ### Frustration Detection
49
-
50
- | Metric | Definition | Source |
51
- |--------|------------|--------|
52
- | Rage click | 3+ clicks in 1-2 seconds | FullStory Rage Click definition⁵ |
53
- | Average rage gesture rate | 6.5% of sessions | FullStory research (2023)⁵ |
54
- | Dead click rate average | 8.1% of sessions | FullStory Digital Experience Benchmark (2023)⁵ |
55
-
56
- ⁵ *FullStory. "The Complete Guide to Rage Clicks." 2023. https://www.fullstory.com/blog/rage-clicks/*
57
-
58
- ### Usability Severity Scale
59
-
60
- We calibrate severity levels to Nielsen's usability severity scale:
61
-
62
- | Level | Nielsen Definition | CBrowser Mapping |
63
- |-------|-------------------|------------------|
64
- | 0 | Not a usability problem | (not flagged) |
65
- | 1 | Cosmetic problem | Low severity |
66
- | 2 | Minor usability problem | Medium severity |
67
- | 3 | Major usability problem | High severity |
68
- | 4 | Usability catastrophe | Critical severity |
69
-
70
- ⁶ *Nielsen, Jakob. "Severity Ratings for Usability Problems." Nielsen Norman Group. https://www.nngroup.com/articles/how-to-rate-the-severity-of-usability-problems/*
71
-
72
- ### Accessibility (WCAG)
73
-
74
- | Metric | Threshold | Source |
75
- |--------|-----------|--------|
76
- | Sites with WCAG failures | 94.8% | WebAIM Million (2024)⁷ |
77
- | Screen reader task completion | 55.6% | WebAIM Screen Reader User Survey (2024)⁸ |
78
- | Touch target minimum | 44x44px | WCAG 2.5.5 (AAA) / 2.5.8 (AA)⁹ |
79
- | Contrast ratio (normal text) | 4.5:1 | WCAG 1.4.3 (AA)⁹ |
80
- | Contrast ratio (large text) | 3:1 | WCAG 1.4.3 (AA)⁹ |
81
-
82
- ⁷ *WebAIM. "The WebAIM Million." 2024. https://webaim.org/projects/million/*
83
-
84
- ⁸ *WebAIM. "Screen Reader User Survey #10." 2024. https://webaim.org/projects/screenreadersurvey10/*
85
-
86
- ⁹ *W3C. "Web Content Accessibility Guidelines (WCAG) 2.1." https://www.w3.org/TR/WCAG21/*
87
-
88
- ### Focus Hierarchies & Attention Patterns (v9.0.0)
89
-
90
- | Pattern | Description | Source |
91
- |---------|-------------|--------|
92
- | F-pattern scanning | Users scan top horizontally, then left side vertically | Nielsen Norman Group¹⁰ |
93
- | Banner blindness | Users ignore banner-like elements (~90% ignore rate) | Nielsen Norman Group¹¹ |
94
- | Search usage | ~30% of users prefer search as first action | Nielsen Norman Group¹² |
95
- | Miller's Law | Users can hold 7±2 items in working memory | Miller (1956)¹³ |
96
-
97
- **Distraction Ignore Rates (Heuristic Estimates)**
98
-
99
- | Element Type | Ignore Rate | Rationale |
100
- |--------------|-------------|-----------|
101
- | Cookie banners | 85% | Cookie consent fatigue |
102
- | Newsletter popups | 90% | Subscription blindness |
103
- | Chat widgets | 80% | Help widget blindness (unless stuck) |
104
- | Social share buttons | 80% | Social widget blindness |
105
- | Promotional banners | 85% | Ad blindness generalization |
106
-
107
- *These ignore rates are heuristic estimates based on banner blindness research patterns, not precise measurements.*
108
-
109
- **Focus Area Priorities (by Task Type)**
110
-
111
- | Task Type | Primary Focus Areas | Secondary Focus Areas |
112
- |-----------|---------------------|----------------------|
113
- | find_information | Headings (95%), Navigation (85%), Search (75%) | Content (70%), CTAs (50%) |
114
- | complete_action | CTAs (95%), Forms (90%), Navigation (80%) | Headings (60%), Content (50%) |
115
- | explore | Hero (85%), Headings (80%), Navigation (75%) | Content (70%), Images (60%) |
116
- | compare | Content (90%), Headings (85%), Navigation (70%) | CTAs (60%), Images (50%) |
117
- | troubleshoot | Search (90%), Navigation (85%), Content (80%) | Headings (75%), Forms (60%) |
118
-
119
- *Priority percentages are heuristic weights for simulation, derived from eye-tracking research patterns.*
120
-
121
- ¹⁰ *Nielsen, Jakob. "F-Shaped Pattern For Reading Web Content." Nielsen Norman Group. 2006. https://www.nngroup.com/articles/f-shaped-pattern-reading-web-content/*
122
-
123
- ¹¹ *Nielsen, Jakob. "Banner Blindness: Old and New Findings." Nielsen Norman Group. 2007. https://www.nngroup.com/articles/banner-blindness-old-and-new-findings/*
124
-
125
- ¹² *Nielsen, Jakob. "Search: Visible and Simple." Nielsen Norman Group. 2001. https://www.nngroup.com/articles/search-visible-and-simple/*
126
-
127
- ¹³ *Miller, George A. "The Magical Number Seven, Plus or Minus Two." Psychological Review. 1956.*
128
-
129
- ---
130
-
131
- ## Scoring Algorithms
132
-
133
- ### Competitive UX Benchmark
134
-
135
- **Abandonment Risk Grade**
136
-
137
- Grades based on accumulated friction, mapped to research thresholds:
138
-
139
- | Grade | Risk Level | Interpretation |
140
- |-------|------------|----------------|
141
- | A | ≤15% | Very low abandonment risk |
142
- | B | ≤30% | Low risk |
143
- | C | ≤50% | Moderate risk (typical) |
144
- | D | ≤70% | High risk |
145
- | F | >70% | Very high risk |
146
-
147
- *Formula:*
148
- ```
149
- Risk = (100 - patience) × 0.4 + frustration × 0.3 + confusion × 0.3
150
- ```
151
-
152
- Weights are heuristic, not derived from specific studies. The formula is designed to weight patience depletion most heavily, as research shows patience exhaustion correlates strongly with abandonment.
153
-
154
- ### Agent-Ready Audit
155
-
156
- **Severity Penalties**
157
-
158
- | Severity | Points Deducted | Rationale |
159
- |----------|-----------------|-----------|
160
- | Critical | 25 | ~Nielsen Level 4: blocks task completion |
161
- | High | 15 | ~Nielsen Level 3: major obstacle |
162
- | Medium | 8 | ~Nielsen Level 2: minor problem |
163
- | Low | 3 | ~Nielsen Level 1: cosmetic issue |
164
-
165
- **Category Weights**
166
-
167
- | Category | Weight | Rationale |
168
- |----------|--------|-----------|
169
- | Findability | 35% | Most critical for AI agents |
170
- | Stability | 30% | Selector reliability |
171
- | Accessibility | 20% | ARIA provides semantic context |
172
- | Semantics | 15% | HTML structure aids parsing |
173
-
174
- *These weights are heuristic estimates based on typical AI agent interaction patterns, not derived from specific studies.*
175
-
176
- ### Accessibility Empathy Audit
177
-
178
- **Barrier Severity Deductions**
179
-
180
- | Severity | Points | Rationale |
181
- |----------|--------|-----------|
182
- | Critical | 20 | Blocks task for affected users |
183
- | Major | 10 | Significant difficulty |
184
- | Minor | 3 | Noticeable but manageable |
185
-
186
- **Empathy Grade Thresholds**
187
-
188
- | Grade | Score Range |
189
- |-------|-------------|
190
- | A | ≥80 |
191
- | B | ≥65 |
192
- | C | ≥50 |
193
- | D | ≥35 |
194
- | F | <35 |
195
-
196
- ---
197
-
198
- ## Limitations
199
-
200
- ### What These Scores Are
201
-
202
- - **Directional indicators** for comparing options
203
- - **Heuristic flags** for potential issues
204
- - **Starting points** for investigation
205
-
206
- ### What These Scores Are NOT
207
-
208
- - **Predictions** of actual user behavior
209
- - **Guarantees** of accessibility compliance
210
- - **Substitutes** for real user testing
211
- - **Precise measurements** (hence letter grades)
212
-
213
- ### Recommended Complementary Testing
214
-
215
- For comprehensive validation, combine CBrowser analysis with:
216
-
217
- 1. **Automated WCAG testing:** axe-core, WAVE, Lighthouse
218
- 2. **Manual accessibility review:** Keyboard navigation, screen reader testing
219
- 3. **User testing:** With actual users who have disabilities
220
- 4. **Analytics:** Real user monitoring, session replay analysis
221
- 5. **A/B testing:** For conversion-critical flows
222
-
223
- ---
224
-
225
- ## Cognitive Trait Research (v11.5.0)
226
-
227
- Four research-backed cognitive traits for realistic user simulation:
228
-
229
- | Trait | Research Basis | Key Finding |
230
- |-------|---------------|-------------|
231
- | **selfEfficacy** | Bandura (1977) | Low efficacy users abandon 40% faster on first error |
232
- | **satisficing** | Simon (1956) | Satisficers decide 50% faster with similar outcomes |
233
- | **trustCalibration** | Fogg (2003) | Trust affects CTA click-through by up to 40% |
234
- | **interruptRecovery** | Mark et al. (2005) | Average recovery time is 23 minutes |
235
-
236
- ### Research Citations
237
-
238
- ¹⁴ *Bandura, A. "Self-efficacy: Toward a unifying theory of behavioral change." Psychological Review, 84(2), 191-215. 1977.*
239
-
240
- ¹⁵ *Simon, H. A. "Rational Choice and the Structure of the Environment." Psychological Review, 63(2), 129-138. 1956.*
241
-
242
- ¹⁶ *Fogg, B. J. "Persuasive Technology: Using Computers to Change What We Think and Do." Morgan Kaufmann Publishers. 2003.*
243
-
244
- ¹⁷ *Mark, G., Gonzalez, V. M., & Harris, J. "No Task Left Behind? Examining the Nature of Fragmented Work." CHI 2005.*
245
-
246
- ---
247
-
248
- ## Changelog
249
-
250
- | Version | Date | Changes |
251
- |---------|------|---------|
252
- | 11.5.0 | 2026-02-07 | Added 4 cognitive trait research citations |
253
- | | | Added selfEfficacy, satisficing, trustCalibration, interruptRecovery |
254
- | 9.0.0 | 2026-02-06 | Added Focus Hierarchies research section |
255
- | | | Added distraction ignore rate heuristics |
256
- | | | Added focus area priorities by task type |
257
- | | | Added Miller's Law and attention pattern citations |
258
- | 8.0.0 | 2026-02-06 | Initial methodology documentation |
259
- | | | Added letter grades to avoid false precision |
260
- | | | Added research bibliography with citations |
261
- | | | Added disclaimers to all report outputs |
262
-
263
- ---
264
-
265
- ## Contributing
266
-
267
- If you find additional research that could improve our calibration, please open an issue or PR with:
268
-
269
- 1. The metric being updated
270
- 2. The new threshold/value
271
- 3. Citation to peer-reviewed or industry-recognized research
272
- 4. Explanation of methodology
273
-
274
- ---
275
-
276
- *Generated by CBrowser v9.0.0*
@@ -1,328 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Persona Questionnaire System](https://cbrowser.ai/docs/PERSONA-QUESTIONNAIRE)**
4
-
5
- ---
6
-
7
- # Persona Questionnaire System
8
-
9
- **Introduced in v16.6.0**
10
-
11
- The Persona Questionnaire system provides research-backed trait mapping for creating custom cognitive personas. Instead of defaulting traits to 0.5 (neutral baseline), this system uses behavioral questions to derive differentiated trait profiles.
12
-
13
- ## The Problem
14
-
15
- When creating custom personas, AI-generated profiles often defaulted many traits to 0.5. This creates "average" personas that don't accurately represent real user diversity.
16
-
17
- ## The Solution
18
-
19
- The questionnaire system:
20
- 1. Maps behavioral answers to trait values (0-1 scale)
21
- 2. Uses 5 distinct behavioral levels per trait (0, 0.25, 0.5, 0.75, 1.0)
22
- 3. Applies research-backed correlations between traits
23
- 4. Provides behavioral descriptions based on academic research
24
-
25
- ## Quick Start
26
-
27
- ### CLI Usage
28
-
29
- ```bash
30
- # Interactive 8-question questionnaire
31
- npx cbrowser persona-questionnaire start
32
-
33
- # Comprehensive 25-trait questionnaire
34
- npx cbrowser persona-questionnaire start --comprehensive --name "my-persona"
35
-
36
- # Look up trait behavior at specific value
37
- npx cbrowser persona-questionnaire lookup --trait patience --value 0.25
38
-
39
- # List all available traits
40
- npx cbrowser persona-questionnaire list-traits
41
- ```
42
-
43
- ### Programmatic Usage
44
-
45
- ```typescript
46
- import {
47
- generatePersonaQuestionnaire,
48
- buildTraitsFromAnswers,
49
- getTraitBehaviors,
50
- getTraitLabel,
51
- } from 'cbrowser';
52
-
53
- // Generate questionnaire
54
- const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
55
-
56
- // Build traits from answers
57
- const traits = buildTraitsFromAnswers({
58
- patience: 0.25,
59
- riskTolerance: 0.75,
60
- curiosity: 1.0,
61
- });
62
-
63
- // Look up specific trait behavior
64
- const behaviors = getTraitBehaviors('patience', 0.25);
65
- console.log(behaviors.label); // "Low"
66
- console.log(behaviors.behaviors); // ["Gets frustrated quickly", ...]
67
- ```
68
-
69
- ### MCP Tools
70
-
71
- Three MCP tools are available:
72
-
73
- | Tool | Description |
74
- |------|-------------|
75
- | `persona_questionnaire_get` | Generate questionnaire questions |
76
- | `persona_questionnaire_build` | Build trait profile from answers |
77
- | `persona_trait_lookup` | Look up behaviors for trait value |
78
-
79
- ## The 25 Cognitive Traits
80
-
81
- | Trait | Research Basis | What It Models |
82
- |-------|---------------|----------------|
83
- | **patience** | UX research | Time before abandoning on friction |
84
- | **riskTolerance** | Prospect theory | Willingness to try unfamiliar actions |
85
- | **comprehension** | Cognitive load theory | UI pattern understanding |
86
- | **persistence** | Motivation research | Retry behavior after failures |
87
- | **curiosity** | Exploration theory | Feature discovery tendency |
88
- | **workingMemory** | Cognitive psychology | Multi-step task handling |
89
- | **readingTendency** | Eye-tracking studies | Text consumption behavior |
90
- | **resilience** | Positive psychology | Bounce-back from errors |
91
- | **selfEfficacy** | Bandura (1977) | Belief in problem-solving ability |
92
- | **satisficing** | Simon (1956) | Accept "good enough" vs optimize |
93
- | **trustCalibration** | Fogg (2003) | Trust in unfamiliar interfaces |
94
- | **interruptRecovery** | Mark et al. (2005) | Resume after distractions |
95
- | **decisionFatigue** | Baumeister | Decision quality over time |
96
- | **internalAttribution** | Attribution theory | Self-blame for failures |
97
- | **externalAttribution** | Attribution theory | System-blame for failures |
98
- | **techSavviness** | Digital literacy | Familiarity with UI patterns |
99
- | **attentionSpan** | Attention research | Focus duration |
100
- | **impulsivity** | Behavioral psychology | Quick vs deliberate actions |
101
- | **errorRecovery** | Human factors | Speed of correcting mistakes |
102
- | **visualProcessing** | Cognitive science | Image vs text preference |
103
- | **spatialMemory** | Navigation research | UI layout recall |
104
- | **patternRecognition** | Expertise research | UI element identification |
105
- | **riskPerception** | Risk psychology | Danger assessment |
106
- | **socialProof** | Cialdini (1984) | Influence of others' actions |
107
- | **authorityTrust** | Trust research | Trust in official sources |
108
-
109
- ## Trait Reference Matrix
110
-
111
- Each trait has 5 behavioral levels with specific descriptions:
112
-
113
- ### Example: Patience Trait
114
-
115
- | Value | Label | Behaviors |
116
- |-------|-------|-----------|
117
- | 0 | Very Low | Abandons at first sign of friction, expects instant results |
118
- | 0.25 | Low | Gets frustrated quickly, skips slow-loading content |
119
- | 0.5 | Moderate | Waits reasonable time, tolerates some friction |
120
- | 0.75 | High | Patient with delays, reads loading messages |
121
- | 1.0 | Very High | Extremely patient, waits through any delay |
122
-
123
- ### Example: Self-Efficacy Trait
124
-
125
- | Value | Label | Behaviors |
126
- |-------|-------|-----------|
127
- | 0 | Very Low | "I can't do this", gives up immediately on challenge |
128
- | 0.25 | Low | Doubts ability, abandons 40% faster than average |
129
- | 0.5 | Moderate | Normal confidence, persists through minor challenges |
130
- | 0.75 | High | Confident problem-solver, sees obstacles as puzzles |
131
- | 1.0 | Very High | "I'll figure this out", never attributes failure to self |
132
-
133
- ## Trait Correlations
134
-
135
- The system automatically applies research-backed correlations:
136
-
137
- | Primary Trait | Correlated Trait | Relationship |
138
- |---------------|------------------|--------------|
139
- | Low selfEfficacy | High internalAttribution | Self-blame for failures |
140
- | Low selfEfficacy | Low resilience | Slower bounce-back |
141
- | Low patience | Low resilience | Less tolerance for errors |
142
- | High curiosity | Higher exploration | More feature discovery |
143
- | Low trustCalibration | Longer evaluation time | Scrutinizes CTAs |
144
-
145
- ## Questionnaire Formats
146
-
147
- ### Quick Questionnaire (8 traits)
148
-
149
- Core traits for basic persona differentiation:
150
- - patience, riskTolerance, comprehension, persistence
151
- - curiosity, workingMemory, readingTendency, resilience
152
-
153
- ### Comprehensive Questionnaire (25 traits)
154
-
155
- All cognitive traits for detailed behavioral modeling.
156
-
157
- ### Custom Selection
158
-
159
- Request specific traits:
160
-
161
- ```typescript
162
- const questionnaire = generatePersonaQuestionnaire({
163
- traits: ['patience', 'selfEfficacy', 'trustCalibration'],
164
- });
165
- ```
166
-
167
- ## AskUserQuestion Integration
168
-
169
- For Claude sessions, use the `formatForAskUserQuestion` function:
170
-
171
- ```typescript
172
- import { formatForAskUserQuestion, generatePersonaQuestionnaire } from 'cbrowser';
173
-
174
- const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
175
- const askUserFormat = formatForAskUserQuestion(questionnaire.questions);
176
-
177
- // Returns format compatible with Claude's AskUserQuestion tool:
178
- // {
179
- // questions: [
180
- // {
181
- // question: "How does this user handle waiting?",
182
- // header: "patience",
183
- // options: [
184
- // { label: "Very impatient", description: "Abandons at first delay" },
185
- // ...
186
- // ],
187
- // multiSelect: false
188
- // },
189
- // ...
190
- // ]
191
- // }
192
- ```
193
-
194
- ## CLI Interactive Mode
195
-
196
- The CLI provides an interactive questionnaire experience:
197
-
198
- ```bash
199
- $ npx cbrowser persona-questionnaire start --name "anxious-newbie"
200
-
201
- === CBrowser Persona Questionnaire ===
202
- Creating persona: anxious-newbie (8 core traits)
203
-
204
- [1/8] Patience
205
- How does this user handle waiting for pages or actions?
206
- 1. Very impatient - abandons at first delay
207
- 2. Somewhat impatient - frustrated by normal load times
208
- 3. Average - tolerates reasonable waits
209
- 4. Patient - waits through delays calmly
210
- 5. Very patient - unlimited patience
211
- > 2
212
-
213
- [2/8] Risk Tolerance
214
- How willing is this user to try unfamiliar features?
215
- ...
216
-
217
- === Persona Created ===
218
- Saved to: ~/.cbrowser/personas/anxious-newbie.json
219
- ```
220
-
221
- ## Using Custom Personas
222
-
223
- After creating a persona via questionnaire:
224
-
225
- ```typescript
226
- import { runCognitiveJourney } from 'cbrowser';
227
-
228
- const result = await runCognitiveJourney({
229
- persona: 'anxious-newbie', // Uses saved persona
230
- startUrl: 'https://example.com',
231
- goal: 'complete signup',
232
- });
233
- ```
234
-
235
- Or with inline traits:
236
-
237
- ```typescript
238
- const customTraits = buildTraitsFromAnswers({
239
- patience: 0.25,
240
- selfEfficacy: 0.25,
241
- trustCalibration: 0.25,
242
- });
243
-
244
- const result = await runCognitiveJourney({
245
- persona: 'custom',
246
- customTraits,
247
- startUrl: 'https://example.com',
248
- goal: 'complete signup',
249
- });
250
- ```
251
-
252
- ## Research Citations
253
-
254
- The trait system is grounded in academic research:
255
-
256
- - **Bandura, A. (1977)** - Self-Efficacy: Toward a Unifying Theory of Behavioral Change
257
- - **Kahneman, D. & Tversky, A.** - Prospect Theory and Decision Making
258
- - **Simon, H. (1956)** - Satisficing and Administrative Behavior
259
- - **Fogg, B.J. (2003)** - Persuasive Technology and Trust
260
- - **Mark, G. et al. (2005)** - No Task Left Behind: Interrupt Recovery
261
- - **Baumeister, R.** - Ego Depletion and Decision Fatigue
262
- - **Nielsen, J.** - Usability Engineering and User Behavior
263
- - **Cialdini, R. (1984)** - Influence: The Psychology of Persuasion
264
-
265
- ## API Reference
266
-
267
- ### generatePersonaQuestionnaire(options)
268
-
269
- Generate questionnaire questions.
270
-
271
- ```typescript
272
- interface QuestionnaireOptions {
273
- comprehensive?: boolean; // All 25 traits (default: false = 8 traits)
274
- traits?: string[]; // Specific traits to include
275
- includeResearch?: boolean; // Include research citations
276
- }
277
-
278
- const questionnaire = generatePersonaQuestionnaire(options);
279
- // Returns: { questions: Question[], estimatedMinutes: number }
280
- ```
281
-
282
- ### buildTraitsFromAnswers(answers)
283
-
284
- Build complete trait profile from questionnaire answers.
285
-
286
- ```typescript
287
- const traits = buildTraitsFromAnswers({
288
- patience: 0.25,
289
- curiosity: 0.75,
290
- });
291
- // Returns: CognitiveTraits with correlations applied
292
- ```
293
-
294
- ### getTraitBehaviors(trait, value)
295
-
296
- Get behavioral description for a trait value.
297
-
298
- ```typescript
299
- const behaviors = getTraitBehaviors('patience', 0.25);
300
- // Returns: { label: string, description: string, behaviors: string[] }
301
- ```
302
-
303
- ### getTraitLabel(trait, value)
304
-
305
- Get short label for trait value.
306
-
307
- ```typescript
308
- const label = getTraitLabel('patience', 0.25);
309
- // Returns: "Low"
310
- ```
311
-
312
- ### getTraitReference(trait)
313
-
314
- Get full research reference for a trait.
315
-
316
- ```typescript
317
- const ref = getTraitReference('selfEfficacy');
318
- // Returns: { researchBasis: string, citations: string[], levels: Level[] }
319
- ```
320
-
321
- ### formatForAskUserQuestion(questions)
322
-
323
- Format questions for Claude's AskUserQuestion tool.
324
-
325
- ```typescript
326
- const formatted = formatForAskUserQuestion(questions);
327
- // Returns: { questions: AskUserQuestion[] }
328
- ```
package/docs/README.md DELETED
@@ -1,45 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[CBrowser Documentation](https://cbrowser.ai/docs/README)**
4
-
5
- ---
6
-
7
- # CBrowser Documentation
8
-
9
- **Full documentation has moved to: [https://cbrowser.ai/docs](https://cbrowser.ai/docs)**
10
-
11
- ---
12
-
13
- ## Quick Links
14
-
15
- | Resource | URL |
16
- |----------|-----|
17
- | **Documentation Home** | [cbrowser.ai/docs](https://cbrowser.ai/docs) |
18
- | **Getting Started** | [cbrowser.ai/docs/Getting-Started](https://cbrowser.ai/docs/Getting-Started) |
19
- | **CLI Reference** | [cbrowser.ai/docs/CLI-Reference](https://cbrowser.ai/docs/CLI-Reference) |
20
- | **API Reference** | [cbrowser.ai/docs/API-Reference](https://cbrowser.ai/docs/API-Reference) |
21
- | **MCP Server Setup** | [cbrowser.ai/docs/MCP-Server](https://cbrowser.ai/docs/MCP-Server) |
22
- | **Persona Index** | [cbrowser.ai/docs/Persona-Index](https://cbrowser.ai/docs/Persona-Index) |
23
- | **Trait Index** | [cbrowser.ai/docs/Trait-Index](https://cbrowser.ai/docs/Trait-Index) |
24
-
25
- ## Why the Move?
26
-
27
- The documentation is now hosted on [cbrowser.ai](https://cbrowser.ai) for:
28
-
29
- - **Better search** — Full-text search across all docs
30
- - **Always current** — Auto-updated with each release
31
- - **Better navigation** — Sidebar, breadcrumbs, related pages
32
- - **Mobile-friendly** — Responsive design for reading on any device
33
-
34
- ## Local Files
35
-
36
- This directory contains a few files for reference:
37
-
38
- - `STRESS-TEST-v16.14.4.md` — Grade A+ stress test results
39
- - `AUTH0-SETUP.md` — Auth0 OAuth configuration for remote MCP
40
-
41
- For all other documentation, please visit **[cbrowser.ai/docs](https://cbrowser.ai/docs)**.
42
-
43
- ---
44
-
45
- © 2026 Alexandria Eden | [cbrowser.ai](https://cbrowser.ai)