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,166 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Cognitive Traits Index](https://cbrowser.ai/docs/Trait-Index)**
4
-
5
- ---
6
-
7
- # Cognitive Traits Index
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
- > **Contact**: alexandria.shai.eden@gmail.com
14
-
15
- CBrowser's cognitive simulation system is built on 25 research-backed psychological traits organized into 6 tiers. Each trait represents a measurable dimension of human cognition that affects how users interact with web interfaces.
16
-
17
- ## Trait Tiers Overview
18
-
19
- | Tier | Category | Traits | Description |
20
- |------|----------|--------|-------------|
21
- | 1 | [Core Traits](#tier-1-core-traits) | 7 | Fundamental cognitive capacities |
22
- | 2 | [Emotional Traits](#tier-2-emotional-traits) | 4 | Affective and motivational factors |
23
- | 3 | [Decision-Making Traits](#tier-3-decision-making-traits) | 5 | Choice and judgment processes |
24
- | 4 | [Planning Traits](#tier-4-planning-traits) | 3 | Strategic and procedural cognition |
25
- | 5 | [Perception Traits](#tier-5-perception-traits) | 2 | Attention and awareness limitations |
26
- | 6 | [Social Traits](#tier-6-social-traits) | 4 | Social influence and comparison |
27
-
28
- ---
29
-
30
- ## Tier 1: Core Traits
31
-
32
- Fundamental cognitive capacities that form the foundation of user behavior.
33
-
34
- | Trait | Scale | Primary Research |
35
- |-------|-------|------------------|
36
- | [Patience](./Trait-Patience.md) | 0.0-1.0 | Nah (2004) - 8-10 second tolerance threshold |
37
- | [Risk Tolerance](./Trait-RiskTolerance.md) | 0.0-1.0 | Kahneman & Tversky (1979) - Prospect Theory |
38
- | [Comprehension](./Trait-Comprehension.md) | 0.0-1.0 | Card, Moran & Newell (1983) - GOMS Model |
39
- | [Persistence](./Trait-Persistence.md) | 0.0-1.0 | Duckworth et al. (2007) - Grit Scale |
40
- | [Curiosity](./Trait-Curiosity.md) | 0.0-1.0 | Berlyne (1960) - Epistemic Curiosity |
41
- | [Working Memory](./Trait-WorkingMemory.md) | 0.0-1.0 | Miller (1956) - 7±2 Chunks |
42
- | [Reading Tendency](./Trait-ReadingTendency.md) | 0.0-1.0 | Nielsen (2006) - F-Pattern |
43
-
44
- ---
45
-
46
- ## Tier 2: Emotional Traits
47
-
48
- Affective factors that influence persistence, confidence, and recovery from setbacks.
49
-
50
- | Trait | Scale | Primary Research |
51
- |-------|-------|------------------|
52
- | [Resilience](./Trait-Resilience.md) | 0.0-1.0 | Smith et al. (2008) - Brief Resilience Scale |
53
- | [Self-Efficacy](./Trait-SelfEfficacy.md) | 0.0-1.0 | Bandura (1977) - Self-Efficacy Theory |
54
- | [Trust Calibration](./Trait-TrustCalibration.md) | 0.0-1.0 | Fogg (2003) - Stanford Credibility |
55
- | [Interrupt Recovery](./Trait-InterruptRecovery.md) | 0.0-1.0 | Mark et al. (2005) - Cost of Interruption |
56
-
57
- ---
58
-
59
- ## Tier 3: Decision-Making Traits
60
-
61
- How users evaluate options, make choices, and allocate cognitive resources.
62
-
63
- | Trait | Scale | Primary Research |
64
- |-------|-------|------------------|
65
- | [Satisficing](./Trait-Satisficing.md) | 0.0-1.0 | Simon (1956) - Bounded Rationality |
66
- | [Information Foraging](./Trait-InformationForaging.md) | 0.0-1.0 | Pirolli & Card (1999) - Info Foraging |
67
- | [Anchoring Bias](./Trait-AnchoringBias.md) | 0.0-1.0 | Tversky & Kahneman (1974) - Anchoring |
68
- | [Time Horizon](./Trait-TimeHorizon.md) | 0.0-1.0 | Laibson (1997) - Hyperbolic Discounting |
69
- | [Attribution Style](./Trait-AttributionStyle.md) | 0.0-1.0 | Weiner (1985) - Attribution Theory |
70
-
71
- ---
72
-
73
- ## Tier 4: Planning Traits
74
-
75
- Strategic thinking, procedural knowledge, and learning transfer capabilities.
76
-
77
- | Trait | Scale | Primary Research |
78
- |-------|-------|------------------|
79
- | [Metacognitive Planning](./Trait-MetacognitivePlanning.md) | 0.0-1.0 | Flavell (1979) - Metacognition |
80
- | [Procedural Fluency](./Trait-ProceduralFluency.md) | 0.0-1.0 | Sweller (1988) - Cognitive Load |
81
- | [Transfer Learning](./Trait-TransferLearning.md) | 0.0-1.0 | Thorndike (1901) - Transfer of Practice |
82
-
83
- ---
84
-
85
- ## Tier 5: Perception Traits
86
-
87
- Limitations in visual attention and mental model updating.
88
-
89
- | Trait | Scale | Primary Research |
90
- |-------|-------|------------------|
91
- | [Change Blindness](./Trait-ChangeBlindness.md) | 0.0-1.0 | Simons & Chabris (1999) - Gorilla Study |
92
- | [Mental Model Rigidity](./Trait-MentalModelRigidity.md) | 0.0-1.0 | Johnson-Laird (1983) - Mental Models |
93
-
94
- ---
95
-
96
- ## Tier 6: Social Traits
97
-
98
- How social context and comparison affect user behavior.
99
-
100
- | Trait | Scale | Primary Research |
101
- |-------|-------|------------------|
102
- | [Authority Sensitivity](./Trait-AuthoritySensitivity.md) | 0.0-1.0 | Milgram (1963) - Obedience |
103
- | [Emotional Contagion](./Trait-EmotionalContagion.md) | 0.0-1.0 | Hatfield et al. (1993) - Contagion |
104
- | [FOMO](./Trait-FOMO.md) | 0.0-1.0 | Przybylski et al. (2013) - FoMO Scale |
105
- | [Social Proof Sensitivity](./Trait-SocialProofSensitivity.md) | 0.0-1.0 | Goldstein, Cialdini et al. (2008) |
106
-
107
- ---
108
-
109
- ## Estimated Trait Correlations
110
-
111
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
112
-
113
- Traits don't exist in isolation. Research-backed correlations:
114
-
115
- | Trait Pair | Correlation | Research Basis |
116
- |------------|-------------|----------------|
117
- | Patience ↔ Persistence | r = 0.45 | Both load on conscientiousness |
118
- | Working Memory ↔ Comprehension | r = 0.52 | Cognitive capacity overlap |
119
- | Self-Efficacy ↔ Persistence | r = 0.48 | Bandura (1977) |
120
- | FOMO ↔ Impatience | r = -0.41 | Przybylski et al. (2013) |
121
- | Resilience ↔ Self-Efficacy | r = 0.56 | Protective factors research |
122
-
123
- ---
124
-
125
- ## Using Traits in CBrowser
126
-
127
- ### Via MCP Tool
128
-
129
- ```typescript
130
- await cognitive_journey_init({
131
- persona: "custom",
132
- goal: "complete checkout",
133
- startUrl: "https://example.com",
134
- customTraits: {
135
- patience: 0.3,
136
- workingMemory: 0.5,
137
- riskTolerance: 0.2
138
- }
139
- });
140
- ```
141
-
142
- ### Via CLI
143
-
144
- ```bash
145
- npx cbrowser cognitive-journey \
146
- --persona custom \
147
- --trait patience=0.3 \
148
- --trait workingMemory=0.5 \
149
- --start https://example.com \
150
- --goal "complete checkout"
151
- ```
152
-
153
- ---
154
-
155
- ## See Also
156
-
157
- - [Persona Index](../personas/Persona-Index.md) - Pre-configured trait combinations
158
- - [Bibliography](../research/Bibliography.md) - Complete academic references
159
- - [Research Methodology](../research/Research-Methodology.md) - How traits were selected
160
- - [Cognitive User Simulation](../COGNITIVE-SIMULATION.md) - Main documentation
161
-
162
- ---
163
-
164
- ## Bibliography
165
-
166
- See [Complete Bibliography](../research/Bibliography.md) for all academic sources.
@@ -1,217 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Information Foraging](https://cbrowser.ai/docs/Trait-InformationForaging)**
4
-
5
- ---
6
-
7
- # Information Foraging
8
-
9
- **Category**: Tier 3 - Decision-Making Traits
10
- **Scale**: 0.0 (weak scent-following) to 1.0 (strong scent-following)
11
-
12
- ## Definition
13
-
14
- Information Foraging describes how users navigate information environments by following "information scent" - cues that indicate the likelihood of finding desired content along a particular path. Adapted from optimal foraging theory in behavioral ecology, this trait models how users decide which links to click, when to stay on a page versus navigate away, and how they allocate attention across competing information sources. High foragers follow strong scent trails efficiently and abandon low-scent paths quickly; low foragers may persist on weak trails or fail to recognize strong scent cues, leading to inefficient navigation patterns.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
-
20
- > "Information foraging theory is an approach to understanding how strategies and technologies for information seeking, gathering, and consumption are adapted to the flux of information in the environment... The notion of information scent is used to explain how people assess the utility or relevance of information sources, and how they select navigation paths."
21
- > — Pirolli & Card, 1999, p. 643
22
-
23
- **Full Citation (APA 7):**
24
- Pirolli, P., & Card, S. K. (1999). Information foraging. *Psychological Review, 106*(4), 643-675.
25
-
26
- **DOI**: https://doi.org/10.1037/0033-295x.106.4.643
27
-
28
- ### Supporting Research
29
-
30
- > "Users follow information scent to navigate the web. When scent is strong, users are more efficient. When scent is weak or misleading, they become lost and frustrated."
31
- > — Chi et al., 2001, p. 498
32
-
33
- **Full Citation (APA 7):**
34
- Chi, E. H., Pirolli, P., Chen, K., & Pitkow, J. (2001). Using information scent to model user information needs and actions on the web. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 490-497.
35
-
36
- **DOI**: https://doi.org/10.1145/365024.365325
37
-
38
- ### Key Numerical Values
39
-
40
- | Metric | Value | Source |
41
- |--------|-------|--------|
42
- | Average page dwell time before abandonment | 10-20 seconds | Nielsen (2011) |
43
- | Probability of following highest-scent link | 0.62 | Chi et al. (2001) |
44
- | Back button usage with weak scent | 39% higher | Cockburn & McKenzie (2001) |
45
- | Scent strength predicts task success | r = 0.71 | Pirolli & Card (1999) |
46
- | Users scan 20% of page for scent cues | mean fixation | Nielsen (2006) |
47
- | Optimal patch-leaving threshold | 2-3 failed predictions | ACT-IF model (Pirolli, 2007) |
48
-
49
- ## Behavioral Levels
50
-
51
- | Value | Label | Behaviors |
52
- |-------|-------|-----------|
53
- | 0.0-0.2 | Poor Forager | Fails to recognize relevant link text; persists on irrelevant pages too long; clicks randomly when uncertain; ignores navigation breadcrumbs; exhaustive rather than selective reading; high back-button usage; frequently "lost" in sites |
54
- | 0.2-0.4 | Weak Forager | Sometimes follows weak scent trails; slow to recognize dead-ends; occasional relevant selections; may be misled by ambiguous labels; moderate exploration efficiency; needs redundant cues |
55
- | 0.4-0.6 | Moderate Forager | Adequate scent detection in clear environments; recognizes strong cues but may miss subtle ones; reasonable patch-leaving decisions; some unnecessary exploration; effective with well-designed navigation |
56
- | 0.6-0.8 | Strong Forager | Quickly identifies high-scent options; efficient navigation path selection; abandons low-value pages promptly; uses multiple scent cues (text, images, position); rarely backtracks unnecessarily |
57
- | 0.8-1.0 | Expert Forager | Near-optimal information seeking; immediately recognizes scent patterns; predicts content accurately from cues; minimal wasted navigation; instinctively uses site architecture; very low back-button usage |
58
-
59
- ## Web Behavior Patterns
60
-
61
- ### Link Selection
62
-
63
- **Strong Foragers (0.7-1.0):**
64
- - Select links matching query terms
65
- - Use link position as additional cue
66
- - Notice snippet/preview text
67
- - Prefer specific over generic labels
68
- - Rapid confident selections
69
-
70
- **Weak Foragers (0.0-0.3):**
71
- - Random or sequential link selection
72
- - Ignore descriptive text
73
- - Click "Contact" when seeking products
74
- - Miss clearly-labeled navigation
75
- - Hesitant, exploratory clicking
76
-
77
- ### Patch-Leaving Behavior
78
-
79
- The "patch" in foraging theory is analogous to a web page or site section:
80
-
81
- **Strong Foragers:**
82
- - Leave pages with weak scent within 5-10 seconds
83
- - Recognize when information gain has diminished
84
- - Move to higher-yield areas quickly
85
- - Efficient depth vs breadth decisions
86
-
87
- **Weak Foragers:**
88
- - Stay on low-yield pages 30+ seconds
89
- - Re-read content hoping for relevance
90
- - Deep navigation into wrong branches
91
- - Reluctant to "give up" on dead ends
92
-
93
- ### Search Result Processing
94
-
95
- **Strong Foragers:**
96
- - Rapid snippet scanning
97
- - Click based on content prediction
98
- - Skip irrelevant domains immediately
99
- - Use search refinement efficiently
100
-
101
- **Weak Foragers:**
102
- - Sequential top-to-bottom clicking
103
- - Poor prediction from snippets
104
- - Click all results regardless of relevance
105
- - Rarely refine search queries
106
-
107
- ## Information Scent Components
108
-
109
- | Scent Source | Description | Weight |
110
- |--------------|-------------|--------|
111
- | Link Text | Words in clickable anchor | High |
112
- | Surrounding Context | Text near the link | Medium |
113
- | Visual Design | Icons, colors, prominence | Medium |
114
- | Position | Navigation location, F-pattern | Medium |
115
- | Preview/Tooltip | Hover information | Low-Medium |
116
- | Domain/URL | Site credibility signals | Low |
117
-
118
- ## Estimated Trait Correlations
119
-
120
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
121
-
122
- | Related Trait | Correlation | Mechanism |
123
- |--------------|-------------|-----------|
124
- | [Comprehension](./Trait-Comprehension.md) | r = 0.48 | Understanding text enables scent detection |
125
- | [Reading Tendency](./Trait-ReadingTendency.md) | r = 0.39 | Scanners may miss scent cues |
126
- | [Working Memory](./Trait-WorkingMemory.md) | r = 0.31 | Holding goal enables scent evaluation |
127
- | [Patience](./Trait-Patience.md) | r = 0.28 | Patient users may persist despite weak scent |
128
- | [Satisficing](./Trait-Satisficing.md) | r = -0.44 | Strong foragers optimize paths |
129
- | [Curiosity](./Trait-Curiosity.md) | r = 0.24 | Curious users explore adjacent scent |
130
-
131
- ## Persona Values
132
-
133
- | Persona | Information Foraging Value | Rationale |
134
- |---------|---------------------------|-----------|
135
- | **Power User** | 0.90 | Expert at recognizing interface patterns |
136
- | **Tech Enthusiast** | 0.85 | Familiar with web conventions |
137
- | **Rushed Professional** | 0.75 | Efficient by necessity |
138
- | **First-Time User** | 0.35 | Lacks pattern recognition experience |
139
- | **Elderly Novice** | 0.30 | Unfamiliar with web conventions |
140
- | **Distracted Teen** | 0.50 | Knows patterns but attention divided |
141
- | **Careful Senior** | 0.45 | Methodical but may miss cues |
142
- | **Anxious User** | 0.40 | Anxiety impairs efficient processing |
143
- | **Overwhelmed Parent** | 0.55 | Experience exists but cognitive load interferes |
144
-
145
- ## Design Implications
146
-
147
- ### Strengthening Information Scent
148
-
149
- 1. **Descriptive link text** - "View pricing plans" not "Click here"
150
- 2. **Consistent labeling** - Same terms in navigation and content
151
- 3. **Progressive disclosure** - Preview information on hover
152
- 4. **Visual hierarchy** - Important links visually prominent
153
- 5. **Breadcrumbs** - Show current location in hierarchy
154
- 6. **Search suggestions** - Guide toward high-scent paths
155
-
156
- ### Accommodating Weak Foragers
157
-
158
- 1. **Redundant cues** - Multiple ways to find content
159
- 2. **Clear error recovery** - Easy backtracking
160
- 3. **Search prominence** - Alternative to navigation
161
- 4. **Related links** - Suggest adjacent content
162
- 5. **Wizard patterns** - Guided linear paths
163
-
164
- ## Measurement in CBrowser
165
-
166
- ```typescript
167
- // Information foraging affects navigation decisions
168
- function selectLink(availableLinks: Link[], goal: string, traits: Traits): Link {
169
- const scentScores = availableLinks.map(link =>
170
- calculateScent(link, goal)
171
- );
172
-
173
- if (traits.informationForaging > 0.7) {
174
- // Strong forager: select highest scent
175
- return availableLinks[argmax(scentScores)];
176
- } else if (traits.informationForaging > 0.4) {
177
- // Moderate: probabilistic selection weighted by scent
178
- return weightedRandom(availableLinks, scentScores);
179
- } else {
180
- // Weak forager: may select randomly or sequentially
181
- return random() > 0.5 ? availableLinks[0] : randomChoice(availableLinks);
182
- }
183
- }
184
-
185
- // Patch-leaving decision
186
- function shouldLeavePage(timeOnPage: number, contentRelevance: number, traits: Traits): boolean {
187
- const threshold = 10 + (1 - traits.informationForaging) * 20; // 10-30 seconds
188
- const relevanceThreshold = 0.3 + traits.informationForaging * 0.4; // 0.3-0.7
189
-
190
- return timeOnPage > threshold && contentRelevance < relevanceThreshold;
191
- }
192
- ```
193
-
194
- ## See Also
195
-
196
- - [Satisficing](./Trait-Satisficing.md) - When "good enough" information suffices
197
- - [Reading Tendency](./Trait-ReadingTendency.md) - Scanning vs reading affects scent detection
198
- - [Comprehension](./Trait-Comprehension.md) - Understanding content enables evaluation
199
- - [Working Memory](./Trait-WorkingMemory.md) - Holding goals while navigating
200
- - [Patience](./Trait-Patience.md) - Persistence on weak-scent paths
201
- - [Persona Index](../personas/Persona-Index.md) - Trait combinations in personas
202
-
203
- ## Bibliography
204
-
205
- Chi, E. H., Pirolli, P., Chen, K., & Pitkow, J. (2001). Using information scent to model user information needs and actions on the web. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 490-497. https://doi.org/10.1145/365024.365325
206
-
207
- Cockburn, A., & McKenzie, B. (2001). What do web users do? An empirical analysis of web use. *International Journal of Human-Computer Studies, 54*(6), 903-922. https://doi.org/10.1006/ijhc.2001.0459
208
-
209
- Nielsen, J. (2006). F-shaped pattern for reading web content. *Nielsen Norman Group*. https://www.nngroup.com/articles/f-shaped-pattern-reading-web-content/
210
-
211
- Nielsen, J. (2011). How long do users stay on web pages? *Nielsen Norman Group*. https://www.nngroup.com/articles/how-long-do-users-stay-on-web-pages/
212
-
213
- Pirolli, P. (2007). *Information foraging theory: Adaptive interaction with information*. Oxford University Press.
214
-
215
- Pirolli, P., & Card, S. K. (1999). Information foraging. *Psychological Review, 106*(4), 643-675. https://doi.org/10.1037/0033-295x.106.4.643
216
-
217
- Spool, J. M., Perfetti, C., & Brittan, D. (2004). *Designing for the scent of information*. User Interface Engineering.
@@ -1,249 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Interrupt Recovery](https://cbrowser.ai/docs/Trait-InterruptRecovery)**
4
-
5
- ---
6
-
7
- # Interrupt Recovery
8
-
9
- **Category**: Tier 2 - Emotional Traits
10
- **Scale**: 0.0 (poor recovery) to 1.0 (excellent recovery)
11
-
12
- ## Definition
13
-
14
- Interrupt recovery measures a user's ability to resume tasks after interruptions, distractions, or context switches. This trait determines whether users can pick up where they left off after phone calls, notifications, browser tab switches, or system timeouts. Users with low interrupt recovery lose their mental context and must restart tasks from the beginning, often with degraded performance. Users with high interrupt recovery leverage environmental cues (breadcrumbs, form progress indicators, browser history) to seamlessly continue their work with minimal lost progress.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
- > "We found that the average time to return to a disrupted task was 23 minutes 15 seconds. Furthermore, people did not simply resume the interrupted task; rather, they engaged in an average of 2.26 intervening activities before returning to the original task."
20
- > -- Mark, G., Gonzalez, V.M., & Harris, J., 2005, p. 112
21
-
22
- **Full Citation (APA 7):**
23
- Mark, G., Gonzalez, V. M., & Harris, J. (2005). No task left behind? Examining the nature of fragmented work. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 321-330.
24
-
25
- **DOI**: https://doi.org/10.1145/1054972.1055017
26
-
27
- ### Supporting Research
28
-
29
- > "Resumption lag - the time to resume a task after an interruption - is significantly affected by the complexity of the primary task and the length of the interruption. Longer interruptions result in greater context loss and longer resumption times."
30
- > -- Altmann, E.M., & Trafton, J.G., 2002, p. 41
31
-
32
- **Full Citation (APA 7):**
33
- Altmann, E. M., & Trafton, J. G. (2002). Memory for goals: An activation-based model. *Cognitive Science*, 26(1), 39-83.
34
-
35
- **DOI**: https://doi.org/10.1207/s15516709cog2601_2
36
-
37
- ### Key Numerical Values
38
-
39
- | Metric | Value | Source |
40
- |--------|-------|--------|
41
- | Average task resumption time | 23 min 15 sec | Mark et al. (2005) |
42
- | Intervening activities before resumption | 2.26 average | Mark et al. (2005) |
43
- | Resumption lag (controlled lab) | 2-30 seconds | Altmann & Trafton (2002) |
44
- | Error rate increase post-interruption | 2x baseline | Monk et al. (2008) |
45
- | Context decay half-life | 15-60 seconds | Altmann & Trafton (2002) |
46
- | Visual cue resumption benefit | 40-60% faster recovery | Trafton et al. (2011) |
47
-
48
- ### Interruption Types
49
-
50
- | Type | Description | Typical Duration |
51
- |------|-------------|------------------|
52
- | `external` | Phone call, person, notification | Seconds to hours |
53
- | `system` | Timeout, crash, page refresh | Instant to minutes |
54
- | `self_initiated` | Tab switch, new thought, distraction | Seconds to minutes |
55
- | `timeout` | Session expiration, idle disconnect | Instant |
56
-
57
- ## Behavioral Levels
58
-
59
- | Value | Label | Behaviors |
60
- |-------|-------|-----------|
61
- | 0.0-0.2 | Very Poor | Loses all context after any interruption; must restart forms from beginning; forgets goal of task after distraction; cannot recall previous steps; re-reads entire page after tab switch; session timeout causes complete task abandonment; no use of environmental cues for recovery; takes full 23+ minutes to resume complex tasks |
62
- | 0.2-0.4 | Poor | Loses 40-60% of progress after interruption; struggles to remember where they were; re-enters data they previously completed; skips steps when resuming; high error rate post-interruption; may recognize environmental cues but doesn't effectively use them; resumes in wrong section of multi-step process |
63
- | 0.4-0.6 | Moderate | Loses 10-30% of progress after interruption; can use breadcrumbs and progress indicators to orient; may need to review recent steps; moderate resumption lag (5-15 seconds); error rate slightly elevated after interruption; benefits from "you were here" indicators |
64
- | 0.6-0.8 | Good | Minimal progress loss (< 10%) after interruption; quickly orients using page state, URL, form values; short resumption lag (2-5 seconds); actively seeks environmental cues; maintains mental context through moderate interruptions; can context-switch between tabs effectively |
65
- | 0.8-1.0 | Excellent | Near-seamless recovery from interruptions; leverages all environmental cues (breadcrumbs, history, form state); < 2 second resumption lag; mental context persists through long interruptions; can resume days later using browser history; proactively creates own resumption cues (bookmarks, notes) |
66
-
67
- ## Trait Implementation in CBrowser
68
-
69
- ### Context Loss Model
70
-
71
- CBrowser models context decay using exponential decay modified by trait:
72
-
73
- ```typescript
74
- interface InterruptRecoveryState {
75
- currentTaskContext: TaskContext;
76
- environmentalCues: string[]; // Page elements aiding recovery
77
- interruptionLog: Interruption[]; // History of interruptions
78
- contextStrength: number; // 0-1 memory of task context
79
- }
80
-
81
- interface Interruption {
82
- type: 'external' | 'system' | 'self_initiated' | 'timeout';
83
- duration: number; // milliseconds
84
- timestamp: Date;
85
- }
86
-
87
- // Context decay during interruption
88
- function calculateContextLoss(
89
- interruptRecovery: number,
90
- interruptionDuration: number,
91
- cuesAvailable: number
92
- ): number {
93
- const halfLife = 15000 + (interruptRecovery * 45000); // 15-60 sec half-life
94
- const decayRate = Math.LN2 / halfLife;
95
- const baseLoss = 1 - Math.exp(-decayRate * interruptionDuration);
96
-
97
- // Environmental cues reduce loss
98
- const cueRecovery = Math.min(0.6, cuesAvailable * 0.1);
99
-
100
- return Math.max(0, baseLoss - cueRecovery);
101
- }
102
- ```
103
-
104
- ### Resumption Lag
105
-
106
- ```typescript
107
- // Time to resume after interruption
108
- function getResumptionLag(
109
- interruptRecovery: number,
110
- contextLoss: number,
111
- taskComplexity: number
112
- ): number {
113
- const baseLag = 2000; // 2 seconds minimum
114
- const complexityMultiplier = 1 + (taskComplexity * 2); // 1x to 3x
115
- const recoveryFactor = 1 + ((1 - interruptRecovery) * 10); // 1x to 11x
116
- const contextFactor = 1 + (contextLoss * 5); // 1x to 6x
117
-
118
- return baseLag * complexityMultiplier * recoveryFactor * contextFactor;
119
- // Range: 2 seconds to several minutes
120
- }
121
- ```
122
-
123
- ### Environmental Cue Detection
124
-
125
- ```typescript
126
- // Cues that help users recover context
127
- const environmentalCues = {
128
- breadcrumbs: 0.15, // "Home > Products > Category"
129
- progressIndicator: 0.20, // "Step 2 of 4"
130
- formValues: 0.15, // Previously entered data visible
131
- pageTitle: 0.10, // Descriptive title
132
- recentHistory: 0.15, // Browser back button history
133
- urlPath: 0.10, // Meaningful URL structure
134
- visualPosition: 0.08, // Scroll position preserved
135
- notifications: 0.07 // "You have unsaved changes"
136
- };
137
-
138
- function calculateCueStrength(page: Page): number {
139
- return Object.entries(environmentalCues)
140
- .filter(([cue]) => page.hasCue(cue))
141
- .reduce((sum, [, value]) => sum + value, 0);
142
- }
143
- ```
144
-
145
- ### Behavior Post-Interruption
146
-
147
- ```typescript
148
- // How user behaves when resuming
149
- function getResumptionBehavior(
150
- interruptRecovery: number,
151
- contextLoss: number
152
- ): 'continue' | 'review' | 'restart' {
153
- const effectiveRecovery = interruptRecovery * (1 - contextLoss);
154
-
155
- if (effectiveRecovery > 0.6) return 'continue'; // Pick up where left off
156
- if (effectiveRecovery > 0.3) return 'review'; // Review recent steps, then continue
157
- return 'restart'; // Begin task from start
158
- }
159
- ```
160
-
161
- ## Estimated Trait Correlations
162
-
163
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
164
-
165
- Research and theoretical models indicate the following correlations:
166
-
167
- | Related Trait | Correlation | Research Basis |
168
- |--------------|-------------|----------------|
169
- | Working Memory | r = 0.55 | Context maintenance is memory-dependent |
170
- | Comprehension | r = 0.38 | Understanding structure aids reorientation |
171
- | Persistence | r = 0.32 | Persistent users try harder to resume |
172
- | Patience | r = 0.28 | Recovery takes time; patient users invest it |
173
- | Reading Tendency | r = 0.25 | Readers use text cues for recovery |
174
-
175
- ### Interaction Effects
176
-
177
- - **Interrupt Recovery x Working Memory**: Combined high values create maximally context-resilient users
178
- - **Interrupt Recovery x Low Patience**: Users may have recovery ability but not time patience to use it
179
- - **Interrupt Recovery x Comprehension**: High recovery + low comprehension = can find their place but may not understand current step
180
-
181
- ## Persona Values
182
-
183
- | Persona | Interrupt Recovery Value | Rationale |
184
- |---------|--------------------------|-----------|
185
- | power-user | 0.75 | Skilled at context-switching; uses environmental cues effectively |
186
- | first-timer | 0.35 | Lacks schema for interpreting recovery cues |
187
- | elderly-user | 0.40 | Working memory challenges impede context retention |
188
- | impatient-user | 0.45 | May have ability but doesn't invest effort to recover |
189
- | mobile-user | 0.50 | Moderate; mobile users frequently interrupted |
190
- | screen-reader-user | 0.55 | Developed coping strategies for non-visual navigation |
191
- | anxious-user | 0.35 | Anxiety impairs working memory and recovery |
192
- | multi-tasker | 0.70 | Practiced at context-switching |
193
-
194
- ## UX Design Implications
195
-
196
- ### For Low Interrupt Recovery Users (< 0.4)
197
-
198
- 1. **Auto-save everything**: Persist form data frequently and automatically
199
- 2. **Session persistence**: Don't timeout sessions aggressively
200
- 3. **"Welcome back" states**: Detect returning users and restore context
201
- 4. **Prominent progress indicators**: Make "where you are" unmissable
202
- 5. **Breadcrumb navigation**: Clear path back to current location
203
- 6. **Unsaved changes warnings**: Prevent accidental navigation away
204
- 7. **Email/save progress links**: Allow explicit progress saving
205
-
206
- ### For High Interrupt Recovery Users (> 0.7)
207
-
208
- 1. **Minimal recovery friction**: Don't force re-authentication unnecessarily
209
- 2. **Smart defaults**: Pre-fill likely values based on previous session
210
- 3. **Quick resume options**: "Continue where you left off" buttons
211
- 4. **Tab state preservation**: Maintain state across browser sessions
212
- 5. **History navigation**: Support effective use of back button
213
-
214
- ### Environmental Cue Best Practices
215
-
216
- | Cue Type | Implementation | Recovery Benefit |
217
- |----------|----------------|------------------|
218
- | Progress indicators | Step X of Y, progress bars | 20% faster recovery |
219
- | Breadcrumbs | Clickable path hierarchy | 15% faster recovery |
220
- | Form persistence | Save partial form data | 40-60% less re-entry |
221
- | Descriptive titles | Page-specific, goal-oriented | 10% faster orientation |
222
- | Scroll restoration | Return to scroll position | Immediate context recovery |
223
- | Visual state | Expand/collapse states preserved | Reduces re-navigation |
224
-
225
- ## See Also
226
-
227
- - [Trait-WorkingMemory](./Trait-WorkingMemory.md) - Memory capacity (strongly related)
228
- - [Trait-Resilience](./Trait-Resilience.md) - Emotional recovery from setbacks (different type of recovery)
229
- - [Trait-Patience](./Trait-Patience.md) - Time tolerance for recovery process
230
- - [Trait-Persistence](./Trait-Persistence.md) - Motivation to resume rather than abandon
231
- - [Trait-Index](./Trait-Index.md) - Complete trait listing
232
-
233
- ## Bibliography
234
-
235
- Adamczyk, P. D., & Bailey, B. P. (2004). If not now, when? The effects of interruption at different moments within task execution. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 271-278. https://doi.org/10.1145/985692.985727
236
-
237
- Altmann, E. M., & Trafton, J. G. (2002). Memory for goals: An activation-based model. *Cognitive Science*, 26(1), 39-83. https://doi.org/10.1207/s15516709cog2601_2
238
-
239
- Czerwinski, M., Horvitz, E., & Wilhite, S. (2004). A diary study of task switching and interruptions. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 175-182. https://doi.org/10.1145/985692.985715
240
-
241
- Iqbal, S. T., & Horvitz, E. (2007). Disruption and recovery of computing tasks: Field study, analysis, and directions. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 677-686. https://doi.org/10.1145/1240624.1240730
242
-
243
- Mark, G., Gonzalez, V. M., & Harris, J. (2005). No task left behind? Examining the nature of fragmented work. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 321-330. https://doi.org/10.1145/1054972.1055017
244
-
245
- Mark, G., Gudith, D., & Klocke, U. (2008). The cost of interrupted work: More speed and stress. *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems*, 107-110. https://doi.org/10.1145/1357054.1357072
246
-
247
- Monk, C. A., Trafton, J. G., & Boehm-Davis, D. A. (2008). The effect of interruption duration and demand on resuming suspended goals. *Journal of Experimental Psychology: Applied*, 14(4), 299-313. https://doi.org/10.1037/a0014402
248
-
249
- Trafton, J. G., Altmann, E. M., & Ratwani, R. M. (2011). A memory for goals model of sequence errors. *Cognitive Systems Research*, 12(2), 134-143. https://doi.org/10.1016/j.cogsys.2010.07.010