cbrowser 18.63.0 → 18.63.1

package/docs/Tool-Persona-Create.md

@@ -1,274 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[Creating Custom Personas](https://cbrowser.ai/docs/Tool-Persona-Create)**
-
----
-
-# Creating Custom Personas
-
-**Build personas that match your actual users, not generic archetypes.**
-
-CBrowser's persona creation tools let you build custom cognitive profiles from scratch — either by answering a research-backed questionnaire or by describing the person in natural language. Your custom personas behave consistently across all cognitive journey and testing tools.
-
----
-
-## Two Ways to Create Personas
-
-### 1. Description Mode (Fast)
-
-Describe the persona in natural language, AI infers the traits.
-
-```json
-// Step 1: Start creation
-{
-  "tool": "persona_create_start",
-  "params": {
-    "mode": "description",
-    "name": "enterprise-cto"
-  }
-}
-
-// Step 2: Provide description
-{
-  "tool": "persona_create_from_description",
-  "params": {
-    "sessionId": "create_abc123",
-    "description": "CTO at a Fortune 500 company. Extremely time-constrained, delegates evaluation to team. Only looks at executive summaries and security certifications. Skeptical of vendors, needs proof of enterprise customers. Won't read more than 2 paragraphs."
-  }
-}
-
-// Step 3: Review and submit
-{
-  "tool": "persona_create_submit_traits",
-  "params": {
-    "sessionId": "create_abc123",
-    "traits": { /* reviewed/adjusted traits */ },
-    "save": true
-  }
-}
-```
-
----
-
-### 2. Questionnaire Mode (Precise)
-
-Answer research-backed questions to set exact trait values.
-
-```json
-// Step 1: Start creation
-{
-  "tool": "persona_create_start",
-  "params": {
-    "mode": "questionnaire",
-    "name": "cautious-buyer"
-  }
-}
-
-// Step 2: Start questionnaire
-{
-  "tool": "persona_create_questionnaire_start",
-  "params": {
-    "sessionId": "create_abc123",
-    "comprehensive": false  // 8 core traits
-  }
-}
-
-// Step 3: Answer each question
-{
-  "tool": "persona_create_questionnaire_answer",
-  "params": {
-    "sessionId": "create_abc123",
-    "answer": 2  // e.g., "Somewhat patient"
-  }
-}
-// Repeat for each question...
-```
-
----
-
-## The 25 Cognitive Traits
-
-Custom personas are built from 25 research-validated traits:
-
-### Tier 1: Core (7 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Patience** | Abandons quickly on any delay | Waits indefinitely |
-| **Risk Tolerance** | Only clicks familiar things | Clicks anything |
-| **Comprehension** | Misreads icons, confused by layout | Gets it instantly |
-| **Persistence** | Gives up after first failure | Keeps trying forever |
-| **Curiosity** | Direct path only | Explores everything |
-| **Working Memory** | Forgets what they tried | Perfect recall |
-| **Reading Tendency** | Scans for buttons | Reads every word |
-
-### Tier 2: Emotional (4 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Resilience** | Derailed by any setback | Bounces back instantly |
-| **Self-Efficacy** | "I can't figure this out" | "I can do anything" |
-| **Trust Calibration** | Trusts nothing | Trusts everything |
-| **Interrupt Recovery** | Loses all context | Picks up seamlessly |
-
-### Tier 3: Decision-Making (5 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Satisficing** | First option works | Must find the best |
-| **Information Foraging** | Takes what's offered | Hunts for more |
-| **Anchoring Bias** | First price is the price | Compares extensively |
-| **Time Horizon** | Only immediate benefits | Plans for future |
-| **Attribution Style** | "It's my fault" | "It's their fault" |
-
-### Tier 4: Planning (3 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Metacognitive Planning** | Dives in without plan | Plans every step |
-| **Procedural Fluency** | Struggles with forms | Handles any workflow |
-| **Transfer Learning** | Every site is new | Applies past experience |
-
-### Tier 5: Perception (2 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Change Blindness** | Misses all changes | Notices everything |
-| **Mental Model Rigidity** | Expects exact patterns | Adapts to variations |
-
-### Tier 6: Social (4 traits)
-
-| Trait | Low Value | High Value |
-|-------|-----------|------------|
-| **Authority Sensitivity** | Ignores credentials | Persuaded by authority |
-| **Emotional Contagion** | Unaffected by tone | Mirrors page emotion |
-| **FOMO** | Immune to urgency | Panics at countdown |
-| **Social Proof Sensitivity** | Ignores reviews | Heavily influenced |
-
----
-
-## Example: Creating "Skeptical Enterprise Buyer"
-
-### Using Description Mode
-
-```json
-{
-  "description": "IT procurement manager at a healthcare company. Extremely risk-averse due to compliance requirements. Needs to see HIPAA certification, SOC 2 reports, and existing healthcare customers. Won't proceed without these. Takes notes on everything. Will read the fine print. Doesn't trust marketing language - wants technical docs."
-}
-```
-
-**Inferred traits:**
-- `riskTolerance`: 0.15 (very low)
-- `trustCalibration`: 0.25 (skeptical)
-- `readingTendency`: 0.85 (reads everything)
-- `authoritySensitivity`: 0.80 (needs credentials)
-- `socialProofSensitivity`: 0.70 (wants customer references)
-- `patience`: 0.70 (thorough but not slow)
-- `proceduralFluency`: 0.65 (handles enterprise forms)
-
----
-
-### Using Questionnaire Mode
-
-**Q1: When a website takes longer than expected to load, this person typically:**
-- (1) Leaves immediately
-- (2) Waits a few seconds then leaves
-- (3) Waits patiently for about 10 seconds
-- (4) Waits as long as it takes
-→ Answer: 3 (patience = 0.6)
-
-**Q2: When encountering an unfamiliar button or feature, this person:**
-- (1) Never clicks anything unfamiliar
-- (2) Rarely clicks unfamiliar elements
-- (3) Sometimes explores new features
-- (4) Clicks on everything to see what happens
-→ Answer: 2 (riskTolerance = 0.25)
-
-*Continue for all 8 core traits...*
-
----
-
-## Using Custom Personas
-
-Once created, use your persona anywhere:
-
-```json
-// In cognitive journeys
-{
-  "tool": "cognitive_journey_init",
-  "params": {
-    "persona": "skeptical-enterprise-buyer",
-    "startUrl": "https://example.com/enterprise",
-    "goal": "Request a demo"
-  }
-}
-
-// In persona comparisons
-{
-  "tool": "compare_personas",
-  "params": {
-    "personas": ["skeptical-enterprise-buyer", "startup-founder", "first-timer"],
-    "startUrl": "https://example.com/pricing",
-    "goal": "Understand pricing"
-  }
-}
-
-// In empathy audits
-{
-  "tool": "empathy_audit",
-  "params": {
-    "personas": ["skeptical-enterprise-buyer"],
-    "task": "Find security documentation"
-  }
-}
-```
-
----
-
-## Best Practices
-
-### Be Specific
-
-**Good**: "Financial advisor at a regional bank. 50s, uses technology but not an early adopter. Concerned about data security. Needs to justify purchases to compliance department."
-
-**Bad**: "Business professional"
-
-### Include Motivations
-
-What does this person *want*? What are they *afraid of*? These inform trait values.
-
-### Include Context
-
-Job title, industry, company size, tech comfort level all help inference.
-
-### Test and Iterate
-
-Run a few journeys, see if the behavior matches expectations, adjust traits if needed.
-
----
-
-## Trait Correlations
-
-CBrowser applies research-based trait correlations automatically:
-
-| If You Set... | These Also Adjust |
-|---------------|-------------------|
-| Low patience | ↓ Resilience, ↑ Satisficing |
-| Low risk tolerance | ↓ Curiosity, ↑ Social proof need |
-| Low comprehension | ↑ Reading tendency (compensating) |
-| High FOMO | ↓ Time horizon |
-
-This creates more realistic, internally consistent personas.
-
----
-
-## Related Documentation
-
-- [Persona Index](/docs/Persona-Index/) — Built-in personas
-- [Trait Index](/docs/Trait-Index/) — Deep dives on each trait
-- [Persona Questionnaire](/docs/Persona-Questionnaire/) — Full questionnaire reference
-- [Values Framework](/docs/Values-Framework/) — Schwartz values and motivations
-
----
-
-*Last updated: v17.6.0*

package/docs/Tools-Accessibility.md

@@ -1,208 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[Accessibility Tools](https://cbrowser.ai/docs/Tools-Accessibility)**
-
----
-
-# Accessibility Tools
-
-**Experience your site through the eyes of someone who can't use a mouse.**
-
-The `empathy_audit` tool simulates how people with disabilities actually experience your site — motor tremors that make clicking hard, low vision that requires zoom, ADHD that makes long forms impossible. This isn't a WCAG checklist. It's lived experience simulation.
-
----
-
-## When to Use This Tool
-
-- **You think your site is accessible** but you've only run automated checkers
-- **You need to prioritize fixes** and want to know what actually impacts real users
-- **You're building for an aging population** and need to understand their struggles
-- **Compliance audits are coming** and you need to find issues before auditors do
-
----
-
-## The Tool
-
-### `empathy_audit`
-
-**What it does**: Simulate disability personas navigating your site, detecting WCAG violations with the context of how they actually impact users.
-
-**Why you'd use it**: Automated accessibility checkers find violations. This tool shows you which violations actually matter and what the experience feels like.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `url` | string | Yes | URL to audit |
-| `personas` | array | No | Disability personas to simulate. Default: all |
-| `task` | string | No | Specific task to attempt (e.g., "complete checkout") |
-| `wcagLevel` | string | No | WCAG level: `A`, `AA`, `AAA`. Default: `AA` |
-
-**Example**:
-```json
-{
-  "url": "https://example.com/signup",
-  "personas": ["motor-tremor", "low-vision", "cognitive-adhd"],
-  "task": "Create an account"
-}
-```
-
----
-
-## Disability Personas
-
-### `motor-tremor`
-
-**Simulates**: Essential tremor, Parkinson's disease, or any condition affecting fine motor control.
-
-**Behavioral Impact**:
-- Struggles with small click targets (< 44px)
-- Can't hover reliably for dropdown menus
-- Needs keyboard navigation
-- Frustrated by time-limited interactions
-
-**WCAG Focus**: Target size (2.5.5), Keyboard accessible (2.1.1), No timing (2.2.3)
-
----
-
-### `low-vision`
-
-**Simulates**: Partial sight, macular degeneration, or conditions requiring magnification.
-
-**Behavioral Impact**:
-- Uses 200%+ zoom
-- Loses context when zoomed in
-- Needs high contrast
-- Can't see small text or icons without labels
-
-**WCAG Focus**: Reflow (1.4.10), Contrast (1.4.3), Text spacing (1.4.12)
-
----
-
-### `cognitive-adhd`
-
-**Simulates**: ADHD, attention difficulties, executive function challenges.
-
-**Behavioral Impact**:
-- Skims rapidly, misses key information
-- Abandons long forms
-- Distracted by animations/movement
-- Needs clear visual hierarchy
-
-**WCAG Focus**: Pause/stop (2.2.2), Error prevention (3.3.4), Consistent navigation (3.2.3)
-
----
-
-### `dyslexia`
-
-**Simulates**: Reading difficulties, letter/word recognition challenges.
-
-**Behavioral Impact**:
-- Struggles with dense text blocks
-- Needs clear typography and spacing
-- Misreads similar words
-- Benefits from icons alongside text
-
-**WCAG Focus**: Reading level (3.1.5), Line height (1.4.12), Clear fonts
-
----
-
-### `deaf`
-
-**Simulates**: Deaf or hard of hearing users.
-
-**Behavioral Impact**:
-- Can't access audio content without captions
-- Misses audio alerts/notifications
-- Relies entirely on visual information
-- Needs sign language or text alternatives
-
-**WCAG Focus**: Captions (1.2.2), Audio description (1.2.5), Visual alternatives (1.4.1)
-
----
-
-### `color-blind`
-
-**Simulates**: Color vision deficiency (protanopia, deuteranopia, tritanopia).
-
-**Behavioral Impact**:
-- Can't distinguish red/green, blue/yellow
-- Misses color-coded information
-- Needs patterns/labels in addition to color
-- Confused by red/green status indicators
-
-**WCAG Focus**: Use of color (1.4.1), Contrast (1.4.3)
-
----
-
-## What the Audit Returns
-
-```json
-{
-  "persona": "motor-tremor",
-  "taskSuccess": false,
-  "abandonmentPoint": "Payment form - credit card expiry dropdown",
-  "timeToAbandon": 142,
-  "barriers": [
-    {
-      "type": "small-target",
-      "element": "#expiry-month",
-      "wcag": "2.5.5",
-      "severity": "critical",
-      "userImpact": "Cannot reliably click the 32px dropdown with tremor",
-      "remediation": "Increase target size to 44px minimum or provide keyboard alternative"
-    },
-    {
-      "type": "hover-dependent",
-      "element": ".nav-dropdown",
-      "wcag": "2.1.1",
-      "severity": "serious",
-      "userImpact": "Dropdown closes before user can move cursor into it",
-      "remediation": "Add click-to-open or increase hover delay"
-    }
-  ],
-  "wcagViolations": 7,
-  "recommendations": [
-    "Add keyboard navigation to all dropdowns",
-    "Increase minimum touch target to 44px",
-    "Add skip-to-content link"
-  ]
-}
-```
-
----
-
-## Why This Is Different From WCAG Checkers
-
-| Traditional Checker | Empathy Audit |
-|--------------------|---------------|
-| "Image missing alt text" | "Blind user couldn't understand the product because the hero image has no description" |
-| "Target size 32px" | "User with tremor couldn't click the dropdown after 8 attempts" |
-| "Contrast ratio 3.8:1" | "Low vision user at 200% zoom couldn't read the error message" |
-| Reports violations | Reports **impact** |
-| Pass/fail metrics | Abandonment stories |
-
----
-
-## Running Empathy Audits in CI/CD
-
-```bash
-# Quick audit before deploy
-npx cbrowser empathy-audit https://staging.example.com --personas motor-tremor,low-vision
-
-# Full audit with task
-npx cbrowser empathy-audit https://staging.example.com \
-  --task "Complete checkout" \
-  --wcag AA \
-  --output report.html
-```
-
----
-
-## Related Documentation
-
-- [Persona Index](/docs/Persona-Index/) — All personas including accessibility
-- [UX Analysis Suite](/docs/UX-Analysis-Suite/) — Full UX analysis capabilities
-- [Constitutional Safety](/docs/Constitutional-Safety/) — How CBrowser handles sensitive operations
-
----
-
-*Last updated: v17.6.0*