cbrowser 16.15.3 → 16.15.5

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 (2) hide show
  1. package/README.md +22 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -100,18 +100,26 @@ An AI agent can freely browse and gather data, but cannot accidentally submit a
100
100
 
101
101
  ## Cognitive User Simulation
102
102
 
103
- CBrowser models 25 research-backed cognitive traits to simulate how real users think and behave:
103
+ CBrowser models **25 research-backed cognitive traits** across 6 tiers to simulate how real users think and behave:
104
104
 
105
105
  | Trait | Research Basis | What It Models |
106
106
  |-------|---------------|----------------|
107
- | **Patience** | | How quickly users abandon on friction |
108
- | **Frustration** | | Accumulates with errors, decays with success |
109
- | **Decision Fatigue** | Baumeister's ego depletion | Users start choosing defaults after too many decisions |
110
- | **Dual-Process Thinking** | Kahneman (Nobel Prize) | System 1 (fast/automatic) vs System 2 (slow/deliberate) |
107
+ | **Patience** | Nah (2004); Nielsen (1993) | Tolerance for delays; abandonment at 8+ seconds |
108
+ | **Working Memory** | Miller (1956) | 7±2 item capacity; affects form complexity tolerance |
109
+ | **Comprehension** | Card, Moran & Newell (1983) | UI convention understanding; GOMS model timing |
110
+ | **Risk Tolerance** | Kahneman & Tversky (1979) | Prospect theory; loss aversion affects CTA clicks |
111
111
  | **Self-Efficacy** | Bandura (1977) | Belief in ability to solve problems; low = faster abandonment |
112
- | **Satisficing** | Simon (1956) | Accept "good enough" vs. optimize; satisficers decide 50% faster |
113
- | **Trust Calibration** | Fogg (2003) | Baseline trust affects click-through by 40% |
114
- | **Interrupt Recovery** | Mark et al. (2005) | Average recovery time 23min; models context preservation |
112
+ | **Satisficing** | Simon (1956) | Accept "good enough" vs. optimize; 50% faster decisions |
113
+ | **Trust Calibration** | Fogg (2003) | 8 trust signals; affects click-through by 40% |
114
+ | **Information Foraging** | Pirolli & Card (1999) | "Scent" following behavior; predicts navigation patterns |
115
+ | **Social Proof** | Cialdini (2001) | Influence of reviews, ratings, popularity indicators |
116
+ | **FOMO** | Przybylski et al. (2013) | Fear of missing out; urgency and scarcity responses |
117
+
118
+ *See [Trait Index](https://github.com/alexandriashai/cbrowser/wiki/Trait-Index) for all 25 traits including: Persistence, Resilience, Curiosity, Change Blindness, Anchoring Bias, Time Horizon, Attribution Style, Metacognitive Planning, Procedural Fluency, Transfer Learning, Authority Sensitivity, Emotional Contagion, Mental Model Rigidity, Interrupt Recovery, and Reading Tendency.*
119
+
120
+ > **Note:** Trait correlation values are [educated estimates](https://github.com/alexandriashai/cbrowser/wiki/Research-Methodology#validation-status) derived from related research. Empirical calibration planned per [GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95).
121
+
122
+ **Full documentation:** [Research Methodology](https://github.com/alexandriashai/cbrowser/wiki/Research-Methodology) · [Trait Index](https://github.com/alexandriashai/cbrowser/wiki/Trait-Index) · [Bibliography](https://github.com/alexandriashai/cbrowser/wiki/Bibliography)
115
123
 
116
124
  ### Abandonment Detection
117
125
 
@@ -454,3 +462,9 @@ For commercial licensing: [alexandria.shai.eden@gmail.com](mailto:alexandria.sha
454
462
  - [A+ Assessment Report](https://claude.ai/public/artifacts/0cee560d-60b8-44d6-8eec-e674fbfac9c4)
455
463
  - [Remote MCP Server Guide](docs/REMOTE-MCP-SERVER.md)
456
464
  - [Roadmap](ROADMAP.md)
465
+
466
+ ### Research Documentation
467
+
468
+ - [Research Methodology](https://github.com/alexandriashai/cbrowser/wiki/Research-Methodology) — How 25 traits were selected and validated
469
+ - [Trait Index](https://github.com/alexandriashai/cbrowser/wiki/Trait-Index) — All cognitive traits with citations
470
+ - [Bibliography](https://github.com/alexandriashai/cbrowser/wiki/Bibliography) — Complete academic references
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cbrowser",
3
- "version": "16.15.3",
3
+ "version": "16.15.5",
4
4
  "type": "module",
5
5
  "description": "Cognitive browser automation that thinks like your users—and helps AI agents navigate too. Simulate real user cognition with abandonment detection, constitutional safety, chaos engineering, and UX friction discovery. Sites that pass CBrowser's cognitive tests are easier for both humans and AI agents to navigate.",
6
6
  "main": "dist/index.js",