cbrowser 18.81.3 → 18.81.4

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 +16 -10
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -71,16 +71,22 @@ npx cbrowser config set-api-key <your-anthropic-key>
71
71
 
72
72
  ## Cognitive Transport Chain
73
73
 
74
- The 6-layer Sequential Transport Chain computes exactly how hard your page is for any persona — and predicts whether they'll abandon:
75
-
76
- | Layer | What It Measures | Research Basis |
77
- |-------|-----------------|----------------|
78
- | **Saliency** | Visual attention capture | CIE-Lab W₂ perceptual model |
79
- | **Cognitive Load** | Information processing demand | Sweller (1988) CLT |
80
- | **Decision** | Choice complexity and fatigue | Hick-Hyman Law |
81
- | **Motor** | Physical interaction difficulty | Grossman & Balakrishnan (2005) |
82
- | **Frustration** | Emotional cost accumulation | Ceaparu et al. (2004) |
83
- | **Readability** | Text comprehension effort | Perry & Zorzi (2013) reading model |
74
+ The eight-layer Sequential Transport Chain computes exactly how hard your page is for any persona - and predicts whether they'll abandon. Each layer answers one question about the visitor:
75
+
76
+ | Layer | The Question It Answers | Research Basis |
77
+ |-------|------------------------|----------------|
78
+ | **Saliency** | Can they find the thing they came for? | CIE-Lab W₂ perceptual model |
79
+ | **Cognitive Load** | Is there more on this page than they can hold at once? | Sweller (1988) CLT |
80
+ | **Decision** | Are there too many choices to pick between? | Hick-Hyman Law |
81
+ | **Motor** | Can they physically hit the target? | Grossman & Balakrishnan (2005) |
82
+ | **Motor Procedure** | Can they get through the whole sequence, not just one click? | Procedural fluency (split from Motor) |
83
+ | **Frustration** | How close are they to giving up? | Ceaparu et al. (2004) |
84
+ | **Readability** | Can they decode the words on the page? | Perry & Zorzi (2013) reading model |
85
+ | **Reading Attention** | Can they hold the line long enough to finish? | Sustained attention (split from Readability) |
86
+
87
+ The chain is *sequential* because attention is a budget, not a checklist. Each layer's cost is paid from whatever the layers before it left behind: a visitor who burned working memory just finding the button has less left for the form, and a persona who arrives at your pricing table already frustrated reads it differently than one who got there clean. That's why a page that exhausts people early scores differently from one that is uniformly hard, and why the bottleneck layer matters more than the average.
88
+
89
+ Two layers were split out of their neighbors because they fail for different reasons. **Motor Procedure** is separate from **Motor** because hitting a target and completing a sequence are different failures - you can land every click and still lose your place halfway through a form. **Reading Attention** is separate from **Readability** because decoding text and holding your place in it are different abilities - an ADHD reader typically decodes fine and loses the thread, and a single "reading" score can't say that.
84
90
 
85
91
  ```bash
86
92
  npx cbrowser cognitive-effort --url "https://your-site.com" --persona first-timer
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cbrowser",
3
- "version": "18.81.3",
3
+ "version": "18.81.4",
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",