cbrowser 18.63.0 → 18.63.1

package/docs/STRESS-TEST-v16.14.4.md

@@ -1,241 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[CBrowser v16.14.4 - Final Pre-Launch Stress Test](https://cbrowser.ai/docs/STRESS-TEST-v16.14.4)**
-
----
-
-# CBrowser v16.14.4 — Final Pre-Launch Stress Test
-
-**Date:** February 9, 2026
-**Server:** Enterprise v16.14.4
-**Purpose:** Final baseline before HN/Reddit launch
-**Testing lineage:** v16.7.0 → v16.10.0 → v16.14.0 → v16.14.2 → v16.14.4
-
------
-
-## Executive Summary
-
-**Grade: A+**
-
-All 6 previously reported bugs are resolved. Zero critical issues. Zero server crashes. The persona name inconsistency flagged in v16.14.0 is fixed in v16.14.4. The product has grown substantially — from 6 to 15 cognitive personas, a new Schwartz/Cialdini values and influence system, expanded performance metrics, and trait correlation intelligence. 98%+ pass rate across 48+ tools and 60+ invocations.
-
-|Metric                |v16.10.0|v16.14.4 |Delta|
-|----------------------|--------|---------|-----|
-|Pass rate             |91%     |**100%** |+9%  |
-|Critical bugs         |1       |**0**    |Fixed|
-|Medium bugs           |2       |**0**    |Fixed|
-|Low bugs              |3       |**0**    |Fixed|
-|Server crashes        |1       |**0**    |Fixed|
-|Cognitive personas    |6       |**15**   |+150%|
-|Traits in journey init|21/25   |**25/25**|Fixed|
-|Values system         |None    |**Full** |New  |
-|Influence patterns    |None    |**11**   |New  |
-
------
-
-## Bug Resolution: All 6 Fixed
-
-### #1 (Critical) — chaos_test offline server crash
-
-**Status:** Fixed in v16.14.0
-`chaos_test` with `offline: true` now returns cleanly with `ERR_INTERNET_DISCONNECTED`. Tested twice on separate URLs. Server remains fully responsive — confirmed via `browser_health` and `heal_stats` post-test.
-
-### #2 (Medium) — fill by label matches non-editable div
-
-**Status:** Fixed in v16.14.0
-`fill` with label "Where" on Airbnb now correctly resolves to the input field. Element resolution unified with `find_element_by_intent`.
-
-### #3 (Medium) — cognitive_journey_init drops 4 traits
-
-**Status:** Fixed in v16.14.0
-All 25 traits pass through, including `selfEfficacy`, `satisficing`, `trustCalibration`, `interruptRecovery`. Verified with a custom 25-trait persona.
-
-### #4 (Low) — perf_baseline missing expanded metrics
-
-**Status:** Fixed in v16.14.0
-`perf_baseline` now returns `clsRating`, `fcpRating`, `ttfbRating`, `domContentLoaded`, `load`, `resourceCount`, `transferSize`. Matches `perf_regression.currentMetrics`.
-
-### #5 (Low) — persona_questionnaire_build ignores trait correlations
-
-**Status:** Substantially improved in v16.14.0
-Traits now correlate: patience=0.1 + riskTolerance=0.9 → resilience defaults to 0.3 (not flat 0.5). New `valueDerivations` array traces trait→value mappings with citations. `category` detection with strategy guidance.
-
-### #6 (Low) — Missing cognitive personas
-
-**Status:** Fixed in v16.14.0
-15 personas (up from 6): 8 builtin + 7 accessibility, all with full 25-trait profiles.
-
-### #7 (Low, found in v16.14.0) — Persona name mismatch
-
-**Status:** Fixed in v16.14.4
-`persona_values_lookup` now accepts full persona names (`cognitive-adhd`, `motor-impairment-tremor`, `low-vision-magnified`, `color-blind-deuteranopia`). `compare_personas_init` also returns full differentiated profiles for accessibility personas.
-
------
-
-## Full Tool Coverage: v16.14.4
-
-### Core Browser — 8/8 PASS
-
-|Tool            |Notes                                       |
-|----------------|--------------------------------------------|
-|`status`        |v16.14.4, 3 browsers, 1714 screenshots      |
-|`browser_health`|1ms response                                |
-|`navigate`      |Airbnb 2295ms, HN 1399ms, herokuapp 899ms   |
-|`screenshot`    |Captured correctly                          |
-|`extract`       |Links, headings, forms, text all working    |
-|`analyze_page`  |Forms, buttons, links, search, nav detection|
-|`reset_browser` |Clean state and relaunch                    |
-|`load_session`  |19 cookies restored after reset             |
-
-### Interaction — 6/6 PASS
-
-|Tool                    |Notes                                         |
-|------------------------|----------------------------------------------|
-|`fill` (by label)       |"Where" → correct input (Bug #2 fix confirmed)|
-|`fill` (by name)        |"username", "password"                        |
-|`click`                 |"Login" button                                |
-|`smart_click`           |Auto-retry with overlay dismissal             |
-|`find_element_by_intent`|ARIA-first, 0.95 confidence, 4 alternatives   |
-|`assert`                |Content assertion with fuzzy matching         |
-
-### Stealth — 7/7 PASS (Enterprise only)
-
-|Tool                          |Notes                             |
-|------------------------------|----------------------------------|
-|`stealth_status`              |Enterprise v1.0.0 available       |
-|`stealth_enable`              |Domain authorization + rate limits|
-|`stealth_check` (authorized)  |Green zone                        |
-|`stealth_check` (unauthorized)|Black zone, proper rejection      |
-|`stealth_diagnose`            |Shape Security + Distil detected  |
-|`stealth_disable`             |Browser state preserved           |
-|`cloudflare_detect`           |Correct detection                 |
-
-### Sessions — 4/4 PASS
-
-|Tool            |Notes                                  |
-|----------------|---------------------------------------|
-|`save_session`  |19 cookies saved                       |
-|`load_session`  |Restored after full browser reset      |
-|`list_sessions` |4 sessions with full metadata          |
-|`delete_session`|Correctly handles cross-server requests|
-
-### Visual & Performance — 5/5 PASS
-
-|Tool               |Notes                                  |
-|-------------------|---------------------------------------|
-|`visual_baseline`  |Captured                               |
-|`visual_regression`|1.0 similarity score                   |
-|`perf_baseline`    |Expanded metrics (Bug #4 fix confirmed)|
-|`perf_regression`  |Proper severity detection              |
-|`list_baselines`   |6 visual + 4 performance               |
-
-### Cross-Browser & Responsive — 3/3 PASS
-
-|Tool                |Notes                                      |
-|--------------------|-------------------------------------------|
-|`cross_browser_diff`|Chromium 665ms, Firefox 837ms, WebKit 850ms|
-|`responsive_test`   |11 issues across 3 viewports               |
-|`ab_comparison`     |5 differences with severity levels         |
-
-### Test Tools — 4/4 PASS
-
-|Tool                |Notes                              |
-|--------------------|-----------------------------------|
-|`nl_test_inline`    |7/7 steps, 100%, 3.6s              |
-|`generate_tests`    |4 tests auto-generated             |
-|`detect_flaky_tests`|0% flakiness detected              |
-|`repair_test`       |autoApply works, correct suggestion|
-
-### Autonomous — 5/5 PASS
-
-|Tool                        |Notes                                        |
-|----------------------------|---------------------------------------------|
-|`hunt_bugs`                 |5 pages, 4 bugs with selectors/severity      |
-|`chaos_test` (block+latency)|Survived CSS blocking + 3s delay             |
-|`chaos_test` (offline)      |Clean return, no crash (Bug #1 fix confirmed)|
-|`chaos_test` (offline, 2nd) |Stable on different URL                      |
-|`agent_ready_audit`         |A grade, 90/100                              |
-
-### Cognitive System — 12/12 PASS
-
-|Tool                            |Notes                                            |
-|--------------------------------|-------------------------------------------------|
-|`list_cognitive_personas`       |15 personas (Bug #6 fix confirmed)               |
-|`cognitive_journey_init`        |25/25 traits (Bug #3 fix confirmed)              |
-|`cognitive_journey_update_state`|Correct state transitions                        |
-|`persona_questionnaire_build`   |Trait correlations applied (Bug #5 fix confirmed)|
-|`persona_questionnaire_get`     |25 questions with calibrated options             |
-|`persona_trait_lookup`          |Behavioral descriptions + research citations     |
-|`persona_values_lookup`         |Full names resolve (Bug #7 fix confirmed)        |
-|`persona_category_guidance`     |ADHD subtypes, research basis                    |
-|`list_influence_patterns`       |11 Cialdini/Kahneman patterns                    |
-|`compare_personas_init`         |Full profiles for accessibility personas         |
-|`compare_personas_complete`     |Cross-persona analysis                           |
-|`competitive_benchmark`         |Multi-site ranking + recommendations             |
-
-### Empathy & Accessibility — 1/1 PASS
-
-|Tool           |Notes                                      |
-|---------------|-------------------------------------------|
-|`empathy_audit`|motor-tremor + ADHD, 85 score, WCAG mapping|
-
-### Utility — 3/3 PASS
-
-|Tool            |Notes                       |
-|----------------|----------------------------|
-|`heal_stats`    |2 cached heals              |
-|`list_baselines`|Full visual + perf inventory|
-|`list_sessions` |4 sessions with metadata    |
-
------
-
-## New Since v16.10.0
-
-### Values & Influence System
-
-- Schwartz 10 Universal Values per persona with research DOIs
-- Higher-order values (openness, conservation, self-enhancement, self-transcendence)
-- Self-Determination Theory (autonomy, competence, relatedness needs)
-- Maslow hierarchy level per persona
-- 11 influence/persuasion patterns (scarcity, social proof, authority, reciprocity, commitment, liking, unity, anchoring, decoy effect, loss aversion, default bias)
-- Per-persona influence susceptibility scoring
-- `valueDerivations` showing trait→value mappings
-- `persona_category_guidance` with ADHD subtypes (combined, inattentive, hyperactive), autism spectrum, dyslexia profiles
-
-### Expanded Personas
-
-- 15 total (8 builtin + 7 accessibility)
-- New accessibility: motor-impairment-tremor, low-vision-magnified, cognitive-adhd, dyslexic-user, deaf-user, elderly-low-vision, color-blind-deuteranopia
-- New builtin: curious-visitor, multitasker
-- All with 25 traits, demographics, barrier types, values
-
-### Quality of Life
-
-- `perf_baseline` expanded metrics with ratings
-- `persona_questionnaire_build` returns `traitSummary` with behavioral descriptions
-- Trait correlation intelligence for unspecified traits
-- Unified persona name resolution across all tools
-
------
-
-## Observations for Documentation
-
-These aren't bugs — just things worth noting in docs:
-
-1. **Empathy audit timing:** ~30s per persona. A 5-persona audit takes ~2.5 minutes. Set user expectations accordingly.
-
-2. **perf_regression strict mode:** Single-run variance on live sites produces false positives (95%+ FCP swings). Recommend multi-run or controlled environments for strict mode.
-
-3. **Physical disability value profiles:** `motor-impairment-tremor` and `low-vision-magnified` share identical Schwartz values. This is defensible (physical disabilities don't inherently shift motivational values), but could be differentiated based on autonomy needs — motor impairment users may have higher autonomyNeed than low-vision users.
-
-4. **color-blind-deuteranopia values:** All flat 0.5 (neutral baseline). Also defensible — color blindness doesn't shift motivational values — but worth documenting the reasoning.
-
------
-
-## Final Assessment
-
-**CBrowser Enterprise v16.14.4: A+**
-
-Zero bugs. 100% tool pass rate. The product has matured significantly across 8 point releases during this testing cycle. The cognitive/values system is academically rigorous, the safety architecture is solid, and the core browser automation is reliable across complex production sites.
-
-Ready to ship.

package/docs/Tool-Cognitive-Journey-Autonomous.md

@@ -1,270 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[Cognitive Journey Autonomous](https://cbrowser.ai/docs/Tool-Cognitive-Journey-Autonomous)**
-
----
-
-# Cognitive Journey Autonomous
-
-**🔒 Enterprise Feature**
-
-**Set a goal. Watch a simulated user try to achieve it. Learn where they give up.**
-
-`cognitive_journey_autonomous` runs a complete user journey with AI making all navigation decisions. No orchestration needed — just specify a persona, goal, and starting URL. The AI experiences your site the way a real user would, complete with frustration, confusion, and the moment they decide to leave.
-
----
-
-## Quick Start
-
-```json
-{
-  "persona": "first-timer",
-  "startUrl": "https://example.com",
-  "goal": "Sign up for a free trial",
-  "maxSteps": 30,
-  "vision": true
-}
-```
-
-**What happens**:
-1. AI loads the persona's cognitive profile (25 traits)
-2. AI perceives the page as that persona would
-3. AI decides what action to take based on persona's characteristics
-4. After each action, cognitive state updates (patience, confusion, frustration)
-5. If any metric crosses abandonment threshold, journey ends
-6. Final report shows exactly where and why they gave up
-
----
-
-## Parameters
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `persona` | string | Yes | — | Persona ID (e.g., `first-timer`, `elderly-user`, `cognitive-adhd`) |
-| `startUrl` | string | Yes | — | URL where the journey begins |
-| `goal` | string | Yes | — | What the persona is trying to accomplish |
-| `maxSteps` | number | No | 50 | Maximum actions before stopping |
-| `maxTime` | number | No | 300 | Maximum time in seconds |
-| `vision` | boolean | No | false | Send screenshots to AI for visual analysis |
-| `headless` | boolean | No | false | Run without visible browser window |
-
----
-
-## Vision Mode
-
-When `vision: true`, the AI receives screenshots at each step, enabling:
-
-- **Understanding visual layouts** that aren't captured in DOM text
-- **Navigating dropdown menus** that require hover states
-- **Reading non-semantic content** (images with text, icons without labels)
-- **Perceiving visual hierarchy** the way humans do
-
-Vision mode consumes more API credits but dramatically improves accuracy on complex sites.
-
----
-
-## Use Cases
-
-### 1. Onboarding Flow Validation
-
-**Goal**: Verify that new users can complete signup without confusion.
-
-```json
-{
-  "persona": "first-timer",
-  "startUrl": "https://app.example.com",
-  "goal": "Create an account and reach the dashboard",
-  "vision": true
-}
-```
-
-**What you learn**: Where first-timers get lost, which steps deplete patience, what causes confusion.
-
----
-
-### 2. Accessibility Impact Testing
-
-**Goal**: Understand how accessibility issues affect real task completion.
-
-```json
-{
-  "persona": "motor-tremor",
-  "startUrl": "https://example.com/checkout",
-  "goal": "Complete a purchase",
-  "vision": true,
-  "maxSteps": 40
-}
-```
-
-**What you learn**: Which interactions are impossible with motor impairment, where the user gives up.
-
----
-
-### 3. Mobile UX Validation
-
-**Goal**: Test if the mobile experience works for impatient users.
-
-```json
-{
-  "persona": "impatient-user",
-  "startUrl": "https://m.example.com",
-  "goal": "Find pricing information"
-}
-```
-
-**What you learn**: Whether navigation is fast enough for users with low patience tolerance.
-
----
-
-### 4. Competitive Research
-
-**Goal**: See how different user types experience a competitor's site.
-
-```json
-{
-  "persona": "enterprise-buyer",
-  "startUrl": "https://competitor.com",
-  "goal": "Request a demo",
-  "vision": true
-}
-```
-
-**What you learn**: Friction points in their conversion funnel that you can avoid.
-
----
-
-## How It Works
-
-### Decision-Making Process
-
-At each step, the AI:
-
-1. **Perceives the page** — What elements are visible? What can be interacted with?
-2. **Applies persona traits** — A curious user explores sidebars. An impatient user seeks the fastest path.
-3. **Evaluates options** — Rank possible actions by likelihood of achieving goal
-4. **Makes a decision** — Choose action based on persona's risk tolerance, comprehension, etc.
-5. **Updates state** — Adjust patience, confusion, frustration based on what happened
-
-### Abandonment Logic
-
-The persona abandons when:
-
-| Trigger | Threshold | Inner Monologue |
-|---------|-----------|-----------------|
-| Patience depleted | < 0.1 | "This is taking forever, I'm done." |
-| Too confused | > 0.8 for 30s | "I have no idea what to do here." |
-| Too frustrated | > 0.85 | "This is ridiculous." |
-| No progress | 10+ steps, < 0.1 progress | "I'm not getting anywhere." |
-| Stuck in loop | Same page 3+ times | "I keep ending up back here." |
-
----
-
-## Output
-
-```json
-{
-  "journeyId": "journey_abc123",
-  "persona": "first-timer",
-  "goal": "Sign up for a free trial",
-  "outcome": "abandoned",
-  "goalAchieved": false,
-  "totalSteps": 18,
-  "totalTime": 142,
-  "abandonmentPoint": {
-    "url": "https://example.com/signup/step-2",
-    "action": "Attempted to fill 'Company Size' dropdown",
-    "reason": "confusion_threshold_exceeded",
-    "innerMonologue": "I don't know what to pick here. The options don't match my situation."
-  },
-  "finalState": {
-    "patience": 0.23,
-    "confusion": 0.82,
-    "frustration": 0.67
-  },
-  "frictionPoints": [
-    {
-      "step": 5,
-      "url": "https://example.com/signup",
-      "issue": "Password requirements unclear until submission",
-      "patienceImpact": -0.12
-    },
-    {
-      "step": 12,
-      "url": "https://example.com/signup/step-2",
-      "issue": "Dropdown options don't include 'Individual/Freelancer'",
-      "confusionImpact": 0.25
-    }
-  ],
-  "decisionTrace": [
-    {
-      "step": 1,
-      "thought": "I need to find where to sign up",
-      "action": "click",
-      "target": "Get Started button",
-      "confidence": 0.9
-    }
-    // ... full trace of every decision
-  ],
-  "screenshots": [
-    {
-      "step": 12,
-      "label": "abandonment_point",
-      "base64": "..."
-    }
-  ]
-}
-```
-
----
-
-## Tips & Best Practices
-
-### Choose the Right Persona
-
-| If you want to test... | Use this persona |
-|------------------------|------------------|
-| General usability | `first-timer` |
-| Speed and efficiency | `power-user` or `impatient-user` |
-| Mobile experience | `mobile-user` |
-| Accessibility | `motor-tremor`, `low-vision`, `cognitive-adhd` |
-| Enterprise sales funnel | `enterprise-buyer` |
-| Consumer checkout | `impulse-shopper` or `price-researcher` |
-
-### Set Appropriate Limits
-
-- **Simple flows**: `maxSteps: 20`, `maxTime: 120`
-- **Complex flows**: `maxSteps: 50`, `maxTime: 300`
-- **Exploratory**: `maxSteps: 100`, `maxTime: 600`
-
-### Interpret Results
-
-- **Goal achieved quickly** → Good UX for this persona
-- **Goal achieved with high frustration** → Success but poor experience
-- **Abandoned early** → Critical friction point
-- **Abandoned late** → Death by a thousand cuts
-
----
-
-## Why This Requires Enterprise
-
-`cognitive_journey_autonomous` runs AI decision-making at every step, which:
-
-1. **Consumes Anthropic API credits** — Each step requires AI inference
-2. **Requires secure API key storage** — Keys must be managed properly
-3. **Uses significant compute** — Vision mode processes screenshots
-
-Demo users can still run cognitive journeys using the bridge workflow (`cognitive_journey_init` + `cognitive_journey_update_state`), where Claude orchestrates each step manually.
-
-[Contact for Enterprise →](mailto:alexandria.shai.eden@gmail.com)
-
----
-
-## Related Tools
-
-- [`cognitive_journey_init`](/docs/Tools-Cognitive-Journeys/) — Start orchestrated journeys
-- [`compare_personas`](/docs/Tools-Cognitive-Journeys/) — Compare multiple personas
-- [`empathy_audit`](/docs/Tool-Empathy-Audit/) — Accessibility-focused simulation
-
----
-
-*Last updated: v17.6.0*