cbrowser 10.0.1 → 10.0.3

package/README.md

@@ -638,9 +638,9 @@ mobile-user      | pass    | 28.1s   | 1        | Scroll issue
 
 This helps identify which user groups struggle with your interface and where the friction points are, so you can prioritize UX improvements based on data rather than assumptions.
 
-### Cognitive User Simulation (v8.3.1)
+### Cognitive User Simulation (v10.0.0)
 
-Go beyond timing and click patterns—simulate how users actually **think**. Cognitive journeys model realistic decision-making with abandonment detection, frustration tracking, and genuine cognitive traits.
+Go beyond timing and click patterns—simulate how users actually **think**. Cognitive journeys model realistic decision-making with abandonment detection, frustration tracking, and genuine cognitive traits—now grounded in **peer-reviewed cognitive science research**.
 
 **Why it matters:** Traditional persona testing simulates motor behavior (slow clicks, typos). Cognitive simulation models mental behavior: "Would a confused first-timer give up here? Would they even notice that button?"
 
@@ -711,6 +711,27 @@ The simulation automatically stops when a realistic user would give up:
 | Too frustrated | `> 0.85` | "This is so frustrating..." |
 | No progress | 10+ steps, `< 0.1` progress | "I'm not getting anywhere..." |
 | Stuck in loop | Same pages 3x | "I keep ending up here..." |
+| Decision fatigue (v9.9.0) | Fatigue > threshold | "I'll just pick the first option..." |
+
+**Cognitive Science Foundations (v9.9.0-v10.0.0):**
+
+CBrowser's simulation is grounded in established cognitive science research:
+
+| Feature | Research Basis | What It Models |
+|---------|---------------|----------------|
+| **Decision Fatigue** (v9.9.0) | Baumeister's ego depletion | Fatigue accumulates logarithmically per decision; users start choosing defaults |
+| **Fitts' Law** (v9.9.0) | Motor control research | Mouse timing: `MT = a + b × log₂(D/W + 1)` with age/tremor modifiers |
+| **Dual-Process Theory** (v10.0.0) | Kahneman (Nobel Prize) | System 1 (automatic/fast) vs System 2 (deliberate/slow) switching |
+| **GOMS/KLM Timing** (v10.0.0) | Card, Moran & Newell | Keystroke timing: 120ms (expert) to 500ms (novice) per key |
+
+```bash
+# v9.9.0+ output now includes cognitive science metrics:
+#   Decisions made: 12
+#   Decision fatigue: 67%
+#   ⚠️ Was choosing defaults (high fatigue)
+#   Time in System 1: 45.2s (automatic)
+#   Time in System 2: 12.8s (deliberate)
+```
 
 **Output includes:**
 - Goal achievement status

package/examples/cognitive-journey.ts

@@ -91,7 +91,78 @@ async function journeyWithCallbacks() {
   console.log('\nJourney finished');
 }
 
-// Example 4: Compare cognitive traits across personas
+// Example 4: Decision Fatigue Metrics (v9.9.0)
+async function decisionFatigueExample() {
+  console.log('\n=== Decision Fatigue Metrics (v9.9.0) ===\n');
+
+  const result = await runCognitiveJourney({
+    persona: 'first-timer',
+    startUrl: 'https://example.com/signup',
+    goal: 'complete registration with all options',
+    verbose: true,
+  });
+
+  // v9.9.0 decision fatigue metrics
+  console.log('Decision Fatigue Analysis:');
+  console.log(`  Decisions made: ${result.summary.decisionsMade}`);
+  console.log(`  Final fatigue: ${(result.summary.finalDecisionFatigue * 100).toFixed(0)}%`);
+
+  if (result.summary.wasChoosingDefaults) {
+    console.log('  ⚠️ User started choosing defaults due to fatigue');
+    console.log('  Recommendation: Reduce number of choices or use smart defaults');
+  }
+}
+
+// Example 5: Dual-Process Theory (v10.0.0)
+async function dualProcessExample() {
+  console.log('\n=== Dual-Process Theory (v10.0.0) ===\n');
+
+  // Power users start in System 1 (automatic, fast)
+  // They switch to System 2 (deliberate) when confused
+  const result = await runCognitiveJourney({
+    persona: 'power-user',
+    startUrl: 'https://example.com/settings',
+    goal: 'configure advanced notification preferences',
+    verbose: true,
+  });
+
+  if (result.cognitiveMode) {
+    console.log('Cognitive Mode Analysis:');
+    console.log(`  Started in: System ${result.cognitiveMode.system === 1 ? '1 (Automatic)' : '2 (Deliberate)'}`);
+    console.log(`  Time in System 1: ${result.cognitiveMode.timeInSystem1}ms`);
+    console.log(`  Time in System 2: ${result.cognitiveMode.timeInSystem2}ms`);
+    console.log(`  System 1 errors: ${result.cognitiveMode.system1Errors}`);
+
+    const pctSystem1 = (result.cognitiveMode.timeInSystem1 /
+      (result.cognitiveMode.timeInSystem1 + result.cognitiveMode.timeInSystem2) * 100).toFixed(0);
+    console.log(`  Efficiency: ${pctSystem1}% automatic thinking`);
+  }
+}
+
+// Example 6: Fitts' Law Motor Timing (v9.9.0)
+async function fittsLawExample() {
+  console.log('\n=== Fitts\' Law Motor Timing (v9.9.0) ===\n');
+
+  // Elderly users have age modifier affecting mouse movement
+  const result = await runCognitiveJourney({
+    persona: 'elderly-user',
+    startUrl: 'https://example.com',
+    goal: 'click the small help icon in the corner',
+    verbose: true,
+  });
+
+  // Find steps with click actions to see Fitts' Law in action
+  const clickSteps = result.steps.filter(s => s.action?.startsWith('click'));
+  for (const step of clickSteps) {
+    console.log(`Step ${step.stepNumber}: ${step.action}`);
+    if (step.mouseMovementTime) {
+      console.log(`  Mouse movement time: ${step.mouseMovementTime}ms`);
+      console.log(`  (Includes age modifier for elderly persona)`);
+    }
+  }
+}
+
+// Example 7: Compare cognitive traits across personas
 async function comparePersonas() {
   console.log('\n=== Comparing Personas ===\n');
 
@@ -136,6 +207,9 @@ async function main() {
     await basicJourney();
     // await customTraitsJourney();
     // await journeyWithCallbacks();
+    // await decisionFatigueExample();  // v9.9.0
+    // await dualProcessExample();       // v10.0.0
+    // await fittsLawExample();          // v9.9.0
     // await comparePersonas();
   } catch (error) {
     console.error('Error:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbrowser",
-  "version": "10.0.1",
+  "version": "10.0.3",
   "type": "module",
   "description": "Cognitive browser automation that thinks like your users. Simulate real user cognition with abandonment detection, constitutional safety, chaos engineering, and UX friction discovery.",
   "main": "dist/index.js",