cbrowser 16.14.4 → 16.14.6

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 (42) hide show
  1. package/README.md +3 -3
  2. package/dist/cli.js +0 -0
  3. package/docs/STRESS-TEST-v16.14.4.md +235 -0
  4. package/docs/personas/Persona-ADHD.md +2 -2
  5. package/docs/personas/Persona-ElderlyUser.md +2 -2
  6. package/docs/personas/Persona-FirstTimer.md +2 -2
  7. package/docs/personas/Persona-ImpatientUser.md +2 -2
  8. package/docs/personas/Persona-Index.md +23 -23
  9. package/docs/personas/Persona-LowVision.md +2 -2
  10. package/docs/personas/Persona-MobileUser.md +2 -2
  11. package/docs/personas/Persona-MotorTremor.md +2 -2
  12. package/docs/personas/Persona-PowerUser.md +2 -2
  13. package/docs/personas/Persona-ScreenReaderUser.md +2 -2
  14. package/docs/research/Bibliography.md +3 -3
  15. package/docs/research/Research-Methodology.md +4 -4
  16. package/docs/traits/Trait-AnchoringBias.md +12 -12
  17. package/docs/traits/Trait-AttributionStyle.md +12 -12
  18. package/docs/traits/Trait-AuthoritySensitivity.md +5 -5
  19. package/docs/traits/Trait-ChangeBlindness.md +4 -4
  20. package/docs/traits/Trait-Comprehension.md +6 -6
  21. package/docs/traits/Trait-Curiosity.md +8 -8
  22. package/docs/traits/Trait-EmotionalContagion.md +5 -5
  23. package/docs/traits/Trait-FOMO.md +5 -5
  24. package/docs/traits/Trait-Index.md +30 -30
  25. package/docs/traits/Trait-InformationForaging.md +12 -12
  26. package/docs/traits/Trait-InterruptRecovery.md +5 -5
  27. package/docs/traits/Trait-MentalModelRigidity.md +6 -6
  28. package/docs/traits/Trait-MetacognitivePlanning.md +11 -11
  29. package/docs/traits/Trait-Patience.md +6 -6
  30. package/docs/traits/Trait-Persistence.md +4 -4
  31. package/docs/traits/Trait-ProceduralFluency.md +12 -12
  32. package/docs/traits/Trait-ReadingTendency.md +10 -10
  33. package/docs/traits/Trait-Resilience.md +5 -5
  34. package/docs/traits/Trait-RiskTolerance.md +4 -4
  35. package/docs/traits/Trait-Satisficing.md +10 -10
  36. package/docs/traits/Trait-SelfEfficacy.md +5 -5
  37. package/docs/traits/Trait-SocialProofSensitivity.md +5 -5
  38. package/docs/traits/Trait-TimeHorizon.md +12 -12
  39. package/docs/traits/Trait-TransferLearning.md +11 -11
  40. package/docs/traits/Trait-TrustCalibration.md +5 -5
  41. package/docs/traits/Trait-WorkingMemory.md +5 -5
  42. package/package.json +1 -1
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
1
  # CBrowser — Cognitive Browser Automation
2
2
 
3
- > **The browser automation that thinks.** After 640+ tool invocations across rigorous stress testing on 11 real-world sites, CBrowser earned a **Grade A+** assessment—19 issues tracked, 19 fixed, zero open bugs. [View Full Assessment →](https://claude.ai/public/artifacts/0cee560d-60b8-44d6-8eec-e674fbfac9c4)
3
+ > **The browser automation that thinks.** v16.14.4 earned a **Grade A+** in final pre-launch stress testing—100% pass rate across 48+ tools and 60+ invocations, zero critical bugs, zero server crashes. [View Full Assessment →](docs/STRESS-TEST-v16.14.4.md)
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/cbrowser.svg)](https://www.npmjs.com/package/cbrowser)
6
- [![Grade A+](https://img.shields.io/badge/Grade-A+-brightgreen.svg)](https://claude.ai/public/artifacts/0cee560d-60b8-44d6-8eec-e674fbfac9c4)
6
+ [![Grade A+](https://img.shields.io/badge/Stress%20Test-A+-brightgreen.svg)](docs/STRESS-TEST-v16.14.4.md)
7
7
  [![Tests](https://github.com/alexandriashai/cbrowser/actions/workflows/test.yml/badge.svg)](https://github.com/alexandriashai/cbrowser/actions/workflows/test.yml)
8
8
  [![License: BSL-1.1](https://img.shields.io/badge/License-BSL--1.1-blue.svg)](LICENSE)
9
9
  [![MCP Ready](https://img.shields.io/badge/MCP-48%20Tools-blue)](https://modelcontextprotocol.io)
@@ -18,7 +18,7 @@ Sites that pass CBrowser's cognitive tests are easier for both humans **and** AI
18
18
 
19
19
  ## What Makes CBrowser Different
20
20
 
21
- **31 of 33 tools graded A or above (5 at A+).** After 640+ tool invocations across 11 real-world sites including Spotify, Airbnb, and MDN:
21
+ **48 tools, 15 cognitive personas, 25 research-backed traits.** After rigorous stress testing across production sites including Airbnb and Hacker News:
22
22
 
23
23
  | Capability | Status | Why It Matters |
24
24
  |------------|--------|----------------|
package/dist/cli.js CHANGED
File without changes
@@ -0,0 +1,235 @@
1
+ # CBrowser v16.14.4 — Final Pre-Launch Stress Test
2
+
3
+ **Date:** February 9, 2026
4
+ **Server:** Enterprise v16.14.4
5
+ **Purpose:** Final baseline before HN/Reddit launch
6
+ **Testing lineage:** v16.7.0 → v16.10.0 → v16.14.0 → v16.14.2 → v16.14.4
7
+
8
+ -----
9
+
10
+ ## Executive Summary
11
+
12
+ **Grade: A+**
13
+
14
+ All 6 previously reported bugs are resolved. Zero critical issues. Zero server crashes. The persona name inconsistency flagged in v16.14.0 is fixed in v16.14.4. The product has grown substantially — from 6 to 15 cognitive personas, a new Schwartz/Cialdini values and influence system, expanded performance metrics, and trait correlation intelligence. 98%+ pass rate across 48+ tools and 60+ invocations.
15
+
16
+ |Metric |v16.10.0|v16.14.4 |Delta|
17
+ |----------------------|--------|---------|-----|
18
+ |Pass rate |91% |**100%** |+9% |
19
+ |Critical bugs |1 |**0** |Fixed|
20
+ |Medium bugs |2 |**0** |Fixed|
21
+ |Low bugs |3 |**0** |Fixed|
22
+ |Server crashes |1 |**0** |Fixed|
23
+ |Cognitive personas |6 |**15** |+150%|
24
+ |Traits in journey init|21/25 |**25/25**|Fixed|
25
+ |Values system |None |**Full** |New |
26
+ |Influence patterns |None |**11** |New |
27
+
28
+ -----
29
+
30
+ ## Bug Resolution: All 6 Fixed
31
+
32
+ ### #1 (Critical) — chaos_test offline server crash
33
+
34
+ **Status:** Fixed in v16.14.0
35
+ `chaos_test` with `offline: true` now returns cleanly with `ERR_INTERNET_DISCONNECTED`. Tested twice on separate URLs. Server remains fully responsive — confirmed via `browser_health` and `heal_stats` post-test.
36
+
37
+ ### #2 (Medium) — fill by label matches non-editable div
38
+
39
+ **Status:** Fixed in v16.14.0
40
+ `fill` with label "Where" on Airbnb now correctly resolves to the input field. Element resolution unified with `find_element_by_intent`.
41
+
42
+ ### #3 (Medium) — cognitive_journey_init drops 4 traits
43
+
44
+ **Status:** Fixed in v16.14.0
45
+ All 25 traits pass through, including `selfEfficacy`, `satisficing`, `trustCalibration`, `interruptRecovery`. Verified with a custom 25-trait persona.
46
+
47
+ ### #4 (Low) — perf_baseline missing expanded metrics
48
+
49
+ **Status:** Fixed in v16.14.0
50
+ `perf_baseline` now returns `clsRating`, `fcpRating`, `ttfbRating`, `domContentLoaded`, `load`, `resourceCount`, `transferSize`. Matches `perf_regression.currentMetrics`.
51
+
52
+ ### #5 (Low) — persona_questionnaire_build ignores trait correlations
53
+
54
+ **Status:** Substantially improved in v16.14.0
55
+ Traits now correlate: patience=0.1 + riskTolerance=0.9 → resilience defaults to 0.3 (not flat 0.5). New `valueDerivations` array traces trait→value mappings with citations. `category` detection with strategy guidance.
56
+
57
+ ### #6 (Low) — Missing cognitive personas
58
+
59
+ **Status:** Fixed in v16.14.0
60
+ 15 personas (up from 6): 8 builtin + 7 accessibility, all with full 25-trait profiles.
61
+
62
+ ### #7 (Low, found in v16.14.0) — Persona name mismatch
63
+
64
+ **Status:** Fixed in v16.14.4
65
+ `persona_values_lookup` now accepts full persona names (`cognitive-adhd`, `motor-impairment-tremor`, `low-vision-magnified`, `color-blind-deuteranopia`). `compare_personas_init` also returns full differentiated profiles for accessibility personas.
66
+
67
+ -----
68
+
69
+ ## Full Tool Coverage: v16.14.4
70
+
71
+ ### Core Browser — 8/8 PASS
72
+
73
+ |Tool |Notes |
74
+ |----------------|--------------------------------------------|
75
+ |`status` |v16.14.4, 3 browsers, 1714 screenshots |
76
+ |`browser_health`|1ms response |
77
+ |`navigate` |Airbnb 2295ms, HN 1399ms, herokuapp 899ms |
78
+ |`screenshot` |Captured correctly |
79
+ |`extract` |Links, headings, forms, text all working |
80
+ |`analyze_page` |Forms, buttons, links, search, nav detection|
81
+ |`reset_browser` |Clean state and relaunch |
82
+ |`load_session` |19 cookies restored after reset |
83
+
84
+ ### Interaction — 6/6 PASS
85
+
86
+ |Tool |Notes |
87
+ |------------------------|----------------------------------------------|
88
+ |`fill` (by label) |"Where" → correct input (Bug #2 fix confirmed)|
89
+ |`fill` (by name) |"username", "password" |
90
+ |`click` |"Login" button |
91
+ |`smart_click` |Auto-retry with overlay dismissal |
92
+ |`find_element_by_intent`|ARIA-first, 0.95 confidence, 4 alternatives |
93
+ |`assert` |Content assertion with fuzzy matching |
94
+
95
+ ### Stealth — 7/7 PASS (Enterprise only)
96
+
97
+ |Tool |Notes |
98
+ |------------------------------|----------------------------------|
99
+ |`stealth_status` |Enterprise v1.0.0 available |
100
+ |`stealth_enable` |Domain authorization + rate limits|
101
+ |`stealth_check` (authorized) |Green zone |
102
+ |`stealth_check` (unauthorized)|Black zone, proper rejection |
103
+ |`stealth_diagnose` |Shape Security + Distil detected |
104
+ |`stealth_disable` |Browser state preserved |
105
+ |`cloudflare_detect` |Correct detection |
106
+
107
+ ### Sessions — 4/4 PASS
108
+
109
+ |Tool |Notes |
110
+ |----------------|---------------------------------------|
111
+ |`save_session` |19 cookies saved |
112
+ |`load_session` |Restored after full browser reset |
113
+ |`list_sessions` |4 sessions with full metadata |
114
+ |`delete_session`|Correctly handles cross-server requests|
115
+
116
+ ### Visual & Performance — 5/5 PASS
117
+
118
+ |Tool |Notes |
119
+ |-------------------|---------------------------------------|
120
+ |`visual_baseline` |Captured |
121
+ |`visual_regression`|1.0 similarity score |
122
+ |`perf_baseline` |Expanded metrics (Bug #4 fix confirmed)|
123
+ |`perf_regression` |Proper severity detection |
124
+ |`list_baselines` |6 visual + 4 performance |
125
+
126
+ ### Cross-Browser & Responsive — 3/3 PASS
127
+
128
+ |Tool |Notes |
129
+ |--------------------|-------------------------------------------|
130
+ |`cross_browser_diff`|Chromium 665ms, Firefox 837ms, WebKit 850ms|
131
+ |`responsive_test` |11 issues across 3 viewports |
132
+ |`ab_comparison` |5 differences with severity levels |
133
+
134
+ ### Test Tools — 4/4 PASS
135
+
136
+ |Tool |Notes |
137
+ |--------------------|-----------------------------------|
138
+ |`nl_test_inline` |7/7 steps, 100%, 3.6s |
139
+ |`generate_tests` |4 tests auto-generated |
140
+ |`detect_flaky_tests`|0% flakiness detected |
141
+ |`repair_test` |autoApply works, correct suggestion|
142
+
143
+ ### Autonomous — 5/5 PASS
144
+
145
+ |Tool |Notes |
146
+ |----------------------------|---------------------------------------------|
147
+ |`hunt_bugs` |5 pages, 4 bugs with selectors/severity |
148
+ |`chaos_test` (block+latency)|Survived CSS blocking + 3s delay |
149
+ |`chaos_test` (offline) |Clean return, no crash (Bug #1 fix confirmed)|
150
+ |`chaos_test` (offline, 2nd) |Stable on different URL |
151
+ |`agent_ready_audit` |A grade, 90/100 |
152
+
153
+ ### Cognitive System — 12/12 PASS
154
+
155
+ |Tool |Notes |
156
+ |--------------------------------|-------------------------------------------------|
157
+ |`list_cognitive_personas` |15 personas (Bug #6 fix confirmed) |
158
+ |`cognitive_journey_init` |25/25 traits (Bug #3 fix confirmed) |
159
+ |`cognitive_journey_update_state`|Correct state transitions |
160
+ |`persona_questionnaire_build` |Trait correlations applied (Bug #5 fix confirmed)|
161
+ |`persona_questionnaire_get` |25 questions with calibrated options |
162
+ |`persona_trait_lookup` |Behavioral descriptions + research citations |
163
+ |`persona_values_lookup` |Full names resolve (Bug #7 fix confirmed) |
164
+ |`persona_category_guidance` |ADHD subtypes, research basis |
165
+ |`list_influence_patterns` |11 Cialdini/Kahneman patterns |
166
+ |`compare_personas_init` |Full profiles for accessibility personas |
167
+ |`compare_personas_complete` |Cross-persona analysis |
168
+ |`competitive_benchmark` |Multi-site ranking + recommendations |
169
+
170
+ ### Empathy & Accessibility — 1/1 PASS
171
+
172
+ |Tool |Notes |
173
+ |---------------|-------------------------------------------|
174
+ |`empathy_audit`|motor-tremor + ADHD, 85 score, WCAG mapping|
175
+
176
+ ### Utility — 3/3 PASS
177
+
178
+ |Tool |Notes |
179
+ |----------------|----------------------------|
180
+ |`heal_stats` |2 cached heals |
181
+ |`list_baselines`|Full visual + perf inventory|
182
+ |`list_sessions` |4 sessions with metadata |
183
+
184
+ -----
185
+
186
+ ## New Since v16.10.0
187
+
188
+ ### Values & Influence System
189
+
190
+ - Schwartz 10 Universal Values per persona with research DOIs
191
+ - Higher-order values (openness, conservation, self-enhancement, self-transcendence)
192
+ - Self-Determination Theory (autonomy, competence, relatedness needs)
193
+ - Maslow hierarchy level per persona
194
+ - 11 influence/persuasion patterns (scarcity, social proof, authority, reciprocity, commitment, liking, unity, anchoring, decoy effect, loss aversion, default bias)
195
+ - Per-persona influence susceptibility scoring
196
+ - `valueDerivations` showing trait→value mappings
197
+ - `persona_category_guidance` with ADHD subtypes (combined, inattentive, hyperactive), autism spectrum, dyslexia profiles
198
+
199
+ ### Expanded Personas
200
+
201
+ - 15 total (8 builtin + 7 accessibility)
202
+ - New accessibility: motor-impairment-tremor, low-vision-magnified, cognitive-adhd, dyslexic-user, deaf-user, elderly-low-vision, color-blind-deuteranopia
203
+ - New builtin: curious-visitor, multitasker
204
+ - All with 25 traits, demographics, barrier types, values
205
+
206
+ ### Quality of Life
207
+
208
+ - `perf_baseline` expanded metrics with ratings
209
+ - `persona_questionnaire_build` returns `traitSummary` with behavioral descriptions
210
+ - Trait correlation intelligence for unspecified traits
211
+ - Unified persona name resolution across all tools
212
+
213
+ -----
214
+
215
+ ## Observations for Documentation
216
+
217
+ These aren't bugs — just things worth noting in docs:
218
+
219
+ 1. **Empathy audit timing:** ~30s per persona. A 5-persona audit takes ~2.5 minutes. Set user expectations accordingly.
220
+
221
+ 2. **perf_regression strict mode:** Single-run variance on live sites produces false positives (95%+ FCP swings). Recommend multi-run or controlled environments for strict mode.
222
+
223
+ 3. **Physical disability value profiles:** `motor-impairment-tremor` and `low-vision-magnified` share identical Schwartz values. This is defensible (physical disabilities don't inherently shift motivational values), but could be differentiated based on autonomy needs — motor impairment users may have higher autonomyNeed than low-vision users.
224
+
225
+ 4. **color-blind-deuteranopia values:** All flat 0.5 (neutral baseline). Also defensible — color blindness doesn't shift motivational values — but worth documenting the reasoning.
226
+
227
+ -----
228
+
229
+ ## Final Assessment
230
+
231
+ **CBrowser Enterprise v16.14.4: A+**
232
+
233
+ Zero bugs. 100% tool pass rate. The product has matured significantly across 8 point releases during this testing cycle. The cognitive/values system is academically rigorous, the safety architecture is solid, and the core browser automation is reliable across complex production sites.
234
+
235
+ Ready to ship.
@@ -127,8 +127,8 @@ npx cbrowser cognitive-journey --persona cognitive-adhd --start https://example.
127
127
 
128
128
  ## See Also
129
129
 
130
- - [Persona Index](Persona-Index)
131
- - [Trait Index](../traits/Trait-Index)
130
+ - [Persona Index](./Persona-Index.md)
131
+ - [Trait Index](../traits/Trait-Index.md)
132
132
  - [Working Memory](../traits/Trait-WorkingMemory.md)
133
133
  - [Patience](../traits/Trait-Patience.md)
134
134
  - [Curiosity](../traits/Trait-Curiosity.md)
@@ -124,8 +124,8 @@ npx cbrowser cognitive-journey --persona elderly-user --start https://example.co
124
124
 
125
125
  ## See Also
126
126
 
127
- - [Persona Index](Persona-Index)
128
- - [Trait Index](../traits/Trait-Index)
127
+ - [Persona Index](./Persona-Index.md)
128
+ - [Trait Index](../traits/Trait-Index.md)
129
129
  - [Patience](../traits/Trait-Patience.md)
130
130
  - [Working Memory](../traits/Trait-WorkingMemory.md)
131
131
  - [Reading Tendency](../traits/Trait-ReadingTendency.md)
@@ -124,8 +124,8 @@ npx cbrowser cognitive-journey --persona first-timer --start https://example.com
124
124
 
125
125
  ## See Also
126
126
 
127
- - [Persona Index](Persona-Index)
128
- - [Trait Index](../traits/Trait-Index)
127
+ - [Persona Index](./Persona-Index.md)
128
+ - [Trait Index](../traits/Trait-Index.md)
129
129
  - [Curiosity](../traits/Trait-Curiosity.md)
130
130
  - [Comprehension](../traits/Trait-Comprehension.md)
131
131
  - [Risk Tolerance](../traits/Trait-RiskTolerance.md)
@@ -125,8 +125,8 @@ npx cbrowser cognitive-journey --persona impatient-user --start https://example.
125
125
 
126
126
  ## See Also
127
127
 
128
- - [Persona Index](Persona-Index)
129
- - [Trait Index](../traits/Trait-Index)
128
+ - [Persona Index](./Persona-Index.md)
129
+ - [Trait Index](../traits/Trait-Index.md)
130
130
  - [Patience](../traits/Trait-Patience.md)
131
131
  - [FOMO](../traits/Trait-FOMO.md)
132
132
  - [Persistence](../traits/Trait-Persistence.md)
@@ -12,15 +12,15 @@ CBrowser includes 9 pre-configured user personas, each with research-backed cogn
12
12
 
13
13
  | Persona | Description | Key Characteristics |
14
14
  |---------|-------------|---------------------|
15
- | [Power User](Persona-PowerUser) | Tech-savvy expert | High comprehension, low patience, rapid scanning |
16
- | [First Timer](Persona-FirstTimer) | New to the interface | Low comprehension, high curiosity, methodical |
17
- | [Elderly User](Persona-ElderlyUser) | Older adult (65+) | Low working memory, high reading tendency |
18
- | [Mobile User](Persona-MobileUser) | Smartphone-first | Low patience, high satisficing, touch-focused |
19
- | [Impatient User](Persona-ImpatientUser) | Quick to abandon | Very low patience, high FOMO |
20
- | [Screen Reader User](Persona-ScreenReaderUser) | Assistive technology | High persistence, sequential navigation |
21
- | [Motor Tremor](Persona-MotorTremor) | Motor impairment | Low risk tolerance, high patience |
22
- | [Low Vision](Persona-LowVision) | Vision impairment | High reading tendency, low change blindness |
23
- | [ADHD](Persona-ADHD) | Attention differences | Low working memory, high curiosity, low patience |
15
+ | [Power User](./Persona-PowerUser.md) | Tech-savvy expert | High comprehension, low patience, rapid scanning |
16
+ | [First Timer](./Persona-FirstTimer.md) | New to the interface | Low comprehension, high curiosity, methodical |
17
+ | [Elderly User](./Persona-ElderlyUser.md) | Older adult (65+) | Low working memory, high reading tendency |
18
+ | [Mobile User](./Persona-MobileUser.md) | Smartphone-first | Low patience, high satisficing, touch-focused |
19
+ | [Impatient User](./Persona-ImpatientUser.md) | Quick to abandon | Very low patience, high FOMO |
20
+ | [Screen Reader User](./Persona-ScreenReaderUser.md) | Assistive technology | High persistence, sequential navigation |
21
+ | [Motor Tremor](./Persona-MotorTremor.md) | Motor impairment | Low risk tolerance, high patience |
22
+ | [Low Vision](./Persona-LowVision.md) | Vision impairment | High reading tendency, low change blindness |
23
+ | [ADHD](./Persona-ADHD.md) | Attention differences | Low working memory, high curiosity, low patience |
24
24
 
25
25
  ---
26
26
 
@@ -46,18 +46,18 @@ All values on 0.0-1.0 scale. Higher = more of the trait.
46
46
 
47
47
  ### General Users
48
48
 
49
- - **[Power User](Persona-PowerUser)** - Experienced users who know shortcuts, scan quickly, and expect responsive interfaces
50
- - **[First Timer](Persona-FirstTimer)** - New users learning the interface, more exploratory and methodical
51
- - **[Mobile User](Persona-MobileUser)** - Users on smartphones with touch interaction and attention constraints
52
- - **[Impatient User](Persona-ImpatientUser)** - Users with very low tolerance for friction, quick to abandon
49
+ - **[Power User](./Persona-PowerUser.md)** - Experienced users who know shortcuts, scan quickly, and expect responsive interfaces
50
+ - **[First Timer](./Persona-FirstTimer.md)** - New users learning the interface, more exploratory and methodical
51
+ - **[Mobile User](./Persona-MobileUser.md)** - Users on smartphones with touch interaction and attention constraints
52
+ - **[Impatient User](./Persona-ImpatientUser.md)** - Users with very low tolerance for friction, quick to abandon
53
53
 
54
54
  ### Accessibility Personas
55
55
 
56
- - **[Elderly User](Persona-ElderlyUser)** - Older adults with age-related cognitive changes
57
- - **[Screen Reader User](Persona-ScreenReaderUser)** - Users navigating via screen reader technology
58
- - **[Motor Tremor](Persona-MotorTremor)** - Users with motor impairments affecting precision
59
- - **[Low Vision](Persona-LowVision)** - Users with significant vision impairment
60
- - **[ADHD](Persona-ADHD)** - Users with attention differences
56
+ - **[Elderly User](./Persona-ElderlyUser.md)** - Older adults with age-related cognitive changes
57
+ - **[Screen Reader User](./Persona-ScreenReaderUser.md)** - Users navigating via screen reader technology
58
+ - **[Motor Tremor](./Persona-MotorTremor.md)** - Users with motor impairments affecting precision
59
+ - **[Low Vision](./Persona-LowVision.md)** - Users with significant vision impairment
60
+ - **[ADHD](./Persona-ADHD.md)** - Users with attention differences
61
61
 
62
62
  ---
63
63
 
@@ -284,13 +284,13 @@ const customPersona = {
284
284
 
285
285
  ## See Also
286
286
 
287
- - [Trait Index](../traits/Trait-Index) - All 25 cognitive traits explained
288
- - [Cognitive User Simulation](../Cognitive-User-Simulation) - Main documentation
289
- - [Persona Questionnaire](../Persona-Questionnaire) - Generate custom personas
290
- - [Multi-Persona Comparison](../Multi-Persona-Comparison) - Compare across personas
287
+ - [Trait Index](../traits/Trait-Index.md) - All 25 cognitive traits explained
288
+ - [Cognitive User Simulation](../COGNITIVE-SIMULATION.md) - Main documentation
289
+ - [Persona Questionnaire](../PERSONA-QUESTIONNAIRE.md) - Generate custom personas
290
+ - [Multi-Persona Comparison](../GETTING-STARTED.md) - Compare across personas
291
291
 
292
292
  ---
293
293
 
294
294
  ## Bibliography
295
295
 
296
- See [Complete Bibliography](../research/Bibliography) for all academic sources used in persona development.
296
+ See [Complete Bibliography](../research/Bibliography.md) for all academic sources used in persona development.
@@ -126,8 +126,8 @@ npx cbrowser cognitive-journey --persona low-vision --start https://example.com
126
126
 
127
127
  ## See Also
128
128
 
129
- - [Persona Index](Persona-Index)
130
- - [Trait Index](../traits/Trait-Index)
129
+ - [Persona Index](./Persona-Index.md)
130
+ - [Trait Index](../traits/Trait-Index.md)
131
131
  - [Reading Tendency](../traits/Trait-ReadingTendency.md)
132
132
  - [Persistence](../traits/Trait-Persistence.md)
133
133
  - [Change Blindness](../traits/Trait-ChangeBlindness.md)
@@ -126,8 +126,8 @@ npx cbrowser cognitive-journey --persona mobile-user --start https://example.com
126
126
 
127
127
  ## See Also
128
128
 
129
- - [Persona Index](Persona-Index)
130
- - [Trait Index](../traits/Trait-Index)
129
+ - [Persona Index](./Persona-Index.md)
130
+ - [Trait Index](../traits/Trait-Index.md)
131
131
  - [Patience](../traits/Trait-Patience.md)
132
132
  - [Satisficing](../traits/Trait-Satisficing.md)
133
133
  - [Reading Tendency](../traits/Trait-ReadingTendency.md)
@@ -126,8 +126,8 @@ npx cbrowser cognitive-journey --persona motor-tremor --start https://example.co
126
126
 
127
127
  ## See Also
128
128
 
129
- - [Persona Index](Persona-Index)
130
- - [Trait Index](../traits/Trait-Index)
129
+ - [Persona Index](./Persona-Index.md)
130
+ - [Trait Index](../traits/Trait-Index.md)
131
131
  - [Patience](../traits/Trait-Patience.md)
132
132
  - [Persistence](../traits/Trait-Persistence.md)
133
133
  - [Risk Tolerance](../traits/Trait-RiskTolerance.md)
@@ -122,8 +122,8 @@ npx cbrowser cognitive-journey --persona power-user --start https://example.com
122
122
 
123
123
  ## See Also
124
124
 
125
- - [Persona Index](Persona-Index)
126
- - [Trait Index](../traits/Trait-Index)
125
+ - [Persona Index](./Persona-Index.md)
126
+ - [Trait Index](../traits/Trait-Index.md)
127
127
  - [Patience](../traits/Trait-Patience.md)
128
128
  - [Comprehension](../traits/Trait-Comprehension.md)
129
129
  - [Working Memory](../traits/Trait-WorkingMemory.md)
@@ -126,8 +126,8 @@ npx cbrowser cognitive-journey --persona screen-reader-user --start https://exam
126
126
 
127
127
  ## See Also
128
128
 
129
- - [Persona Index](Persona-Index)
130
- - [Trait Index](../traits/Trait-Index)
129
+ - [Persona Index](./Persona-Index.md)
130
+ - [Trait Index](../traits/Trait-Index.md)
131
131
  - [Persistence](../traits/Trait-Persistence.md)
132
132
  - [Patience](../traits/Trait-Patience.md)
133
133
  - [Reading Tendency](../traits/Trait-ReadingTendency.md)
@@ -264,6 +264,6 @@ All citations follow APA 7th Edition format. When citing CBrowser's trait system
264
264
 
265
265
  ## See Also
266
266
 
267
- - [Trait Index](../traits/Trait-Index) - All 25 cognitive traits
268
- - [Persona Index](../personas/Persona-Index) - Pre-configured personas
269
- - [Research Methodology](Research-Methodology) - Trait selection process
267
+ - [Trait Index](../traits/Trait-Index.md) - All 25 cognitive traits
268
+ - [Persona Index](../personas/Persona-Index.md) - Pre-configured personas
269
+ - [Research Methodology](./Research-Methodology.md) - Trait selection process
@@ -218,7 +218,7 @@ If you have research that could improve trait calibration:
218
218
 
219
219
  ## See Also
220
220
 
221
- - [Trait Index](../traits/Trait-Index) - All 25 cognitive traits
222
- - [Persona Index](../personas/Persona-Index) - Pre-configured personas
223
- - [Bibliography](Bibliography) - Complete academic references
224
- - [Cognitive User Simulation](../Cognitive-User-Simulation) - Main documentation
221
+ - [Trait Index](../traits/Trait-Index.md) - All 25 cognitive traits
222
+ - [Persona Index](../personas/Persona-Index.md) - Pre-configured personas
223
+ - [Bibliography](./Bibliography.md) - Complete academic references
224
+ - [Cognitive User Simulation](../COGNITIVE-SIMULATION.md) - Main documentation
@@ -116,12 +116,12 @@ The landmark demonstration of anchoring:
116
116
 
117
117
  | Related Trait | Correlation | Mechanism |
118
118
  |--------------|-------------|-----------|
119
- | [Comprehension](Trait-Comprehension) | r = -0.22 | Understanding enables anchor recognition |
120
- | [Risk Tolerance](Trait-RiskTolerance) | r = 0.18 | Risk-takers may use anchors as shortcuts |
121
- | [Satisficing](Trait-Satisficing) | r = 0.35 | Satisficers accept anchored "good enough" values |
122
- | [Self-Efficacy](Trait-SelfEfficacy) | r = -0.24 | Confidence enables independent judgment |
123
- | [Trust Calibration](Trait-TrustCalibration) | r = -0.31 | Skeptics question anchor validity |
124
- | [Authority Sensitivity](Trait-AuthoritySensitivity) | r = 0.38 | Authority-sensitive users accept suggested values |
119
+ | [Comprehension](./Trait-Comprehension.md) | r = -0.22 | Understanding enables anchor recognition |
120
+ | [Risk Tolerance](./Trait-RiskTolerance.md) | r = 0.18 | Risk-takers may use anchors as shortcuts |
121
+ | [Satisficing](./Trait-Satisficing.md) | r = 0.35 | Satisficers accept anchored "good enough" values |
122
+ | [Self-Efficacy](./Trait-SelfEfficacy.md) | r = -0.24 | Confidence enables independent judgment |
123
+ | [Trust Calibration](./Trait-TrustCalibration.md) | r = -0.31 | Skeptics question anchor validity |
124
+ | [Authority Sensitivity](./Trait-AuthoritySensitivity.md) | r = 0.38 | Authority-sensitive users accept suggested values |
125
125
 
126
126
  ## Persona Values
127
127
 
@@ -199,12 +199,12 @@ function modifyDefault(defaultValue: number, optimalValue: number, traits: Trait
199
199
 
200
200
  ## See Also
201
201
 
202
- - [Satisficing](Trait-Satisficing) - Anchors provide quick "good enough" answers
203
- - [Trust Calibration](Trait-TrustCalibration) - Skepticism of anchor validity
204
- - [Authority Sensitivity](Trait-AuthoritySensitivity) - Suggested values as authority
205
- - [Self-Efficacy](Trait-SelfEfficacy) - Confidence to form independent judgments
206
- - [Time Horizon](Trait-TimeHorizon) - Time pressure increases anchoring
207
- - [Persona Index](../personas/Persona-Index) - Trait combinations in personas
202
+ - [Satisficing](./Trait-Satisficing.md) - Anchors provide quick "good enough" answers
203
+ - [Trust Calibration](./Trait-TrustCalibration.md) - Skepticism of anchor validity
204
+ - [Authority Sensitivity](./Trait-AuthoritySensitivity.md) - Suggested values as authority
205
+ - [Self-Efficacy](./Trait-SelfEfficacy.md) - Confidence to form independent judgments
206
+ - [Time Horizon](./Trait-TimeHorizon.md) - Time pressure increases anchoring
207
+ - [Persona Index](../personas/Persona-Index.md) - Trait combinations in personas
208
208
 
209
209
  ## Bibliography
210
210
 
@@ -141,12 +141,12 @@ The three dimensions create distinct patterns:
141
141
 
142
142
  | Related Trait | Correlation | Mechanism |
143
143
  |--------------|-------------|-----------|
144
- | [Self-Efficacy](Trait-SelfEfficacy) | r = 0.52 | Internal attribution builds confidence |
145
- | [Persistence](Trait-Persistence) | r = 0.41 | Internal + controllable = retry motivation |
146
- | [Resilience](Trait-Resilience) | r = 0.38 | Attribution style affects recovery |
147
- | [Trust Calibration](Trait-TrustCalibration) | r = -0.26 | External attributors distrust systems |
148
- | [Patience](Trait-Patience) | r = 0.23 | Internal attributors invest patience in self-improvement |
149
- | [Comprehension](Trait-Comprehension) | r = 0.19 | Understanding reduces need for external blame |
144
+ | [Self-Efficacy](./Trait-SelfEfficacy.md) | r = 0.52 | Internal attribution builds confidence |
145
+ | [Persistence](./Trait-Persistence.md) | r = 0.41 | Internal + controllable = retry motivation |
146
+ | [Resilience](./Trait-Resilience.md) | r = 0.38 | Attribution style affects recovery |
147
+ | [Trust Calibration](./Trait-TrustCalibration.md) | r = -0.26 | External attributors distrust systems |
148
+ | [Patience](./Trait-Patience.md) | r = 0.23 | Internal attributors invest patience in self-improvement |
149
+ | [Comprehension](./Trait-Comprehension.md) | r = 0.19 | Understanding reduces need for external blame |
150
150
 
151
151
  ## Persona Values
152
152
 
@@ -246,12 +246,12 @@ function decideToBugReport(issue: Issue, traits: Traits): boolean {
246
246
 
247
247
  ## See Also
248
248
 
249
- - [Self-Efficacy](Trait-SelfEfficacy) - Confidence in ability to succeed
250
- - [Persistence](Trait-Persistence) - Continued effort after setbacks
251
- - [Resilience](Trait-Resilience) - Recovery from failures
252
- - [Trust Calibration](Trait-TrustCalibration) - Trust in system reliability
253
- - [Interrupt Recovery](Trait-InterruptRecovery) - Resumption after disruption
254
- - [Persona Index](../personas/Persona-Index) - Trait combinations in personas
249
+ - [Self-Efficacy](./Trait-SelfEfficacy.md) - Confidence in ability to succeed
250
+ - [Persistence](./Trait-Persistence.md) - Continued effort after setbacks
251
+ - [Resilience](./Trait-Resilience.md) - Recovery from failures
252
+ - [Trust Calibration](./Trait-TrustCalibration.md) - Trust in system reliability
253
+ - [Interrupt Recovery](./Trait-InterruptRecovery.md) - Resumption after disruption
254
+ - [Persona Index](../personas/Persona-Index.md) - Trait combinations in personas
255
255
 
256
256
  ## Bibliography
257
257
 
@@ -112,11 +112,11 @@ Cialdini, R. B. (2001). *Influence: Science and practice* (4th ed.). Allyn and B
112
112
 
113
113
  ## See Also
114
114
 
115
- - [Social Proof Sensitivity](Trait-SocialProofSensitivity) - Peer-based influence
116
- - [Trust Calibration](Trait-TrustCalibration) - Credibility assessment processes
117
- - [Self-Efficacy](Trait-SelfEfficacy) - Confidence in personal judgment
118
- - [FOMO](Trait-FOMO) - External pressure responsiveness
119
- - [Trait Index](Trait-Index) - All cognitive traits
115
+ - [Social Proof Sensitivity](./Trait-SocialProofSensitivity.md) - Peer-based influence
116
+ - [Trust Calibration](./Trait-TrustCalibration.md) - Credibility assessment processes
117
+ - [Self-Efficacy](./Trait-SelfEfficacy.md) - Confidence in personal judgment
118
+ - [FOMO](./Trait-FOMO.md) - External pressure responsiveness
119
+ - [Trait Index](./Trait-Index.md) - All cognitive traits
120
120
 
121
121
  ## Bibliography
122
122
 
@@ -140,10 +140,10 @@ Rensink, R. A., O'Regan, J. K., & Clark, J. J. (1997). To see or not to see: The
140
140
 
141
141
  ## See Also
142
142
 
143
- - [Mental Model Rigidity](Trait-MentalModelRigidity) - Related perceptual limitation
144
- - [Working Memory](Trait-WorkingMemory) - Capacity constraint that affects change detection
145
- - [Reading Tendency](Trait-ReadingTendency) - Scanning patterns affect peripheral awareness
146
- - [Trait Index](Trait-Index) - Complete trait listing
143
+ - [Mental Model Rigidity](./Trait-MentalModelRigidity.md) - Related perceptual limitation
144
+ - [Working Memory](./Trait-WorkingMemory.md) - Capacity constraint that affects change detection
145
+ - [Reading Tendency](./Trait-ReadingTendency.md) - Scanning patterns affect peripheral awareness
146
+ - [Trait Index](./Trait-Index.md) - Complete trait listing
147
147
  - [Distracted Dave](../personas/Persona-DistractedDave) - High change blindness persona
148
148
 
149
149
  ## Bibliography
@@ -71,10 +71,10 @@ Card, Moran, and Newell's GOMS model breaks user behavior into:
71
71
 
72
72
  | Related Trait | Correlation | Mechanism |
73
73
  |---------------|-------------|-----------|
74
- | [Working Memory](Trait-WorkingMemory) | r = 0.52 | Memory capacity enables complex comprehension |
74
+ | [Working Memory](./Trait-WorkingMemory.md) | r = 0.52 | Memory capacity enables complex comprehension |
75
75
  | [Procedural Fluency](../traits/Trait-ProceduralFluency) | r = 0.61 | Comprehension enables procedure learning |
76
76
  | [Transfer Learning](../traits/Trait-TransferLearning) | r = 0.48 | Understanding enables cross-domain transfer |
77
- | [Reading Tendency](Trait-ReadingTendency) | r = 0.35 | Reading enables text-based comprehension |
77
+ | [Reading Tendency](./Trait-ReadingTendency.md) | r = 0.35 | Reading enables text-based comprehension |
78
78
  | [Self-Efficacy](../traits/Trait-SelfEfficacy) | r = 0.42 | Understanding builds confidence |
79
79
 
80
80
  ## Readability and Comprehension
@@ -149,11 +149,11 @@ Very High: Debugs issues independently, consults documentation
149
149
 
150
150
  ## See Also
151
151
 
152
- - [Trait Index](Trait-Index) - All cognitive traits
153
- - [Working Memory](Trait-WorkingMemory) - Capacity for understanding
152
+ - [Trait Index](./Trait-Index.md) - All cognitive traits
153
+ - [Working Memory](./Trait-WorkingMemory.md) - Capacity for understanding
154
154
  - [Procedural Fluency](../traits/Trait-ProceduralFluency) - Learned comprehension
155
- - [Reading Tendency](Trait-ReadingTendency) - Text processing behavior
156
- - [Persona Index](../personas/Persona-Index) - Pre-configured personas
155
+ - [Reading Tendency](./Trait-ReadingTendency.md) - Text processing behavior
156
+ - [Persona Index](../personas/Persona-Index.md) - Pre-configured personas
157
157
 
158
158
  ## Bibliography
159
159