userflow-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARISTONE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+# UserFlow MCP
+
+**Simulates real users navigating your app and delivers qualitative UX feedback.** Built as an MCP server for Claude Code.
+
+UserFlow doesn't run Lighthouse scores or check WCAG compliance — it puts itself in your user's shoes. It clicks through your app as different personas (a first-time user, a busy executive, a senior citizen, an accessibility-dependent user) and tells you where they'd get confused, frustrated, or give up.
+
+> **Free for Claude Pro users.** No API keys, no external services. Just install and go.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g userflow-mcp
+
+# Or use directly with npx
+npx -y userflow-mcp
+```
+
+### Add to Claude Code
+
+In your Claude Code MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "userflow": {
+      "command": "npx",
+      "args": ["-y", "userflow-mcp"]
+    }
+  }
+}
+```
+
+Then in Claude Code:
+
+```
+→ simulate_user url:"https://myapp.com" persona:"Alex"
+→ quick_impression url:"https://myapp.com"
+→ compare_personas url:"https://myapp.com" personas:["Alex", "Morgan", "Patricia"]
+```
+
+## What You Get
+
+Instead of scores and violations, you get feedback like this:
+
+```
+Step 1: Landing Page (3.2s)
+  🔍 curious
+  > "Hmm, 'Supercharge your workflow' — but what does this product actually do?"
+  ⚠️ MEDIUM: Value prop unclear — heading doesn't explain the product
+     → Rewrite heading to describe what the product does, not how it makes you feel
+
+Step 2: Signup (12.1s)
+  😐 neutral
+  > "Alright, let me sign up and see..."
+  🛑 HIGH: Form asks for company size during signup — feels invasive
+     → Remove non-essential fields from signup, ask later during onboarding
+
+Step 3: Dashboard (8.4s)
+  😤 frustrated
+  > "Okay I'm in... now what? There's nothing here."
+  🚨 CRITICAL: Empty state with no guidance
+     → Add a getting-started checklist or demo project
+```
+
+## 11 Tools
+
+| Tool | Description |
+|------|-------------|
+| **simulate_user** | Full persona simulation — walks the entire flow, records every step |
+| **quick_impression** | 30-second first impression — would this user stay or bounce? |
+| **test_onboarding** | Test signup/onboarding as a first-time user |
+| **test_checkout** | Test purchase/conversion flow |
+| **compare_personas** | Run 2-5 personas on the same flow, compare experiences |
+| **find_dead_ends** | Discover pages with no exit, empty states, broken flows |
+| **rate_clarity** | Evaluate value prop, CTAs, cognitive load — with scores |
+| **session_transcript** | Detailed step-by-step journey log with thoughts |
+| **custom_persona** | Define your own persona with specific traits and goals |
+| **export_report** | Generate standalone HTML report |
+| **list_personas** | See all built-in personas with descriptions |
+
+## 8 Built-in Personas
+
+| Name | Description | Tech | Patience | Device |
+|------|-------------|------|----------|--------|
+| **Alex** | The First-Timer — never used SaaS before | Novice | Moderate | Mobile |
+| **Morgan** | The Power User — developer, expects excellence | Expert | Low | Desktop |
+| **Patricia** | The Senior Explorer — 68, low vision | Basic | High | Desktop |
+| **Jordan** | The Busy Executive — 10 seconds to impress | Intermediate | Very Low | Mobile |
+| **Sam** | The Accessibility Tester — screen reader user | Advanced | Moderate | Desktop |
+| **Riley** | The Skeptical Evaluator — looking for red flags | Intermediate | Moderate | Desktop |
+| **Casey** | The International User — potential language barriers | Basic | High | Mobile |
+| **Taylor** | The Return Visitor — knows the app, wants efficiency | Advanced | Moderate | Desktop |
+
+## How It Works
+
+1. **Puppeteer** opens your URL in a real browser
+2. The **persona engine** creates a user with specific traits (tech literacy, patience, goals, device)
+3. The **flow walker** autonomously navigates — clicking buttons, filling forms, scrolling — based on what the persona would actually do
+4. At each step, the **analysis engine** checks for:
+   - **Friction points** — confusing CTAs, too many form fields, empty states, slow loads
+   - **Cognitive load** — how overwhelming the page is
+   - **Clarity** — is the value prop clear? Can the user find the CTA?
+   - **Emotional state** — curious → confident → confused → frustrated
+5. The **feedback generator** compiles everything into a structured report
+
+No LLM calls during simulation — all analysis uses deterministic heuristics. This means it's **fast**, **free**, and **consistent**.
+
+## Custom Personas
+
+```
+→ custom_persona url:"https://myapp.com"
+    name:"Startup Founder"
+    description:"Technical founder evaluating tools for their team"
+    goals:["understand pricing", "evaluate team features", "check integrations"]
+    tech_literacy:"advanced"
+    patience:"low"
+    device:"desktop"
+```
+
+## Multi-Persona Comparison
+
+The `compare_personas` tool reveals how different users experience the same flow:
+
+```
+→ compare_personas url:"https://myapp.com" personas:["Alex", "Jordan", "Patricia"]
+```
+
+Output includes:
+- **Shared friction** — issues ALL users hit (fix these first)
+- **Divergence points** — moments where different users interpret the UI differently
+- **Per-persona summaries** — friction scores, emotional trends, goal achievement
+
+## Architecture
+
+```
+src/
+├── server.ts              # MCP tool registrations (11 tools)
+├── personas/
+│   ├── presets.ts         # 8 built-in personas
+│   └── engine.ts          # Persona creation + utilities
+├── walker/
+│   ├── flow-walker.ts     # Autonomous page traversal
+│   ├─�� action-planner.ts  # Decides what a persona would do
+│   └── session-recorder.ts # Journey tracking
+├── analysis/
+│   ├── friction.ts        # Friction detection + scoring
+│   ├── cognitive-load.ts  # Page complexity assessment
+│   ��── clarity.ts         # CTA + value prop evaluation
+│   └── emotional-arc.ts   # Sentiment tracking
+├── feedback/
+│   ├── generator.ts       # Markdown report generation
+│   ├── comparison.ts      # Multi-persona comparison
+│   └── report.ts          # HTML report generation
+└── utils/
+    └── browser.ts         # Puppeteer browser management
+```
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **Google Chrome** or Chromium installed
+- **Claude Code** with MCP support
+
+## Development
+
+```bash
+git clone https://github.com/prembobby39-gif/userflow-mcp.git
+cd userflow-mcp
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT — ARISTONE

package/dist/analysis/clarity.d.ts

@@ -0,0 +1,7 @@
+import type { PageSnapshot, ClarityAssessment } from "../types.js";
+/**
+ * Assess how clear a page's purpose, CTAs, and navigation are.
+ * Returns a score from 0 (completely unclear) to 10 (crystal clear).
+ */
+export declare function assessClarity(page: PageSnapshot): ClarityAssessment;
+//# sourceMappingURL=clarity.d.ts.map

package/dist/analysis/clarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity.d.ts","sourceRoot":"","sources":["../../src/analysis/clarity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAsGnE"}

package/dist/analysis/clarity.js

@@ -0,0 +1,114 @@
+/**
+ * Assess how clear a page's purpose, CTAs, and navigation are.
+ * Returns a score from 0 (completely unclear) to 10 (crystal clear).
+ */
+export function assessClarity(page) {
+    let score = 10; // Start perfect, deduct for issues
+    const issues = [];
+    // Value proposition (from headings)
+    let valueProposition;
+    if (page.headings.length > 0) {
+        const h1 = page.headings[0];
+        const hasAction = /\b(get|start|build|create|manage|track|discover|learn|grow|save|boost)\b/i.test(h1);
+        const isVague = /\b(welcome|hello|home|dashboard)\b/i.test(h1) && h1.split(" ").length < 5;
+        if (isVague) {
+            valueProposition = `Vague heading: "${h1}" — doesn't explain what the product does`;
+            score -= 2;
+        }
+        else if (hasAction) {
+            valueProposition = `Clear action-oriented heading: "${h1}"`;
+        }
+        else if (h1.length > 10) {
+            valueProposition = `Descriptive heading: "${h1}"`;
+            score -= 0.5;
+        }
+        else {
+            valueProposition = `Short heading: "${h1}" — may not communicate enough`;
+            score -= 1;
+        }
+    }
+    else {
+        valueProposition = "No heading found — users won't know what this page is about";
+        score -= 3;
+    }
+    // CTA clarity
+    let ctaClarity;
+    const visibleButtons = page.buttons.filter((b) => b.isVisible);
+    if (visibleButtons.length === 0) {
+        ctaClarity = "No visible buttons — unclear what action to take";
+        score -= 2;
+    }
+    else if (visibleButtons.length === 1) {
+        ctaClarity = `Single clear CTA: "${visibleButtons[0].text}"`;
+        score += 0.5;
+    }
+    else if (visibleButtons.length <= 3) {
+        ctaClarity = `${visibleButtons.length} buttons — clear hierarchy if primary CTA is visually distinct`;
+    }
+    else {
+        ctaClarity = `${visibleButtons.length} buttons — too many competing CTAs, consider reducing`;
+        score -= 1;
+    }
+    // Navigation logic
+    let navigationLogic;
+    const navLinks = page.links.filter((l) => l.isVisible);
+    if (navLinks.length === 0 && page.buttons.length === 0) {
+        navigationLogic = "No navigation options — user is stuck";
+        score -= 3;
+    }
+    else if (navLinks.length > 20) {
+        navigationLogic = `${navLinks.length} links — navigation is cluttered and overwhelming`;
+        score -= 1.5;
+    }
+    else if (navLinks.length > 0) {
+        navigationLogic = `${navLinks.length} links available — reasonable navigation density`;
+    }
+    else {
+        navigationLogic = "Navigation relies only on buttons, no standard links";
+        score -= 0.5;
+    }
+    // Heading structure
+    let headingStructure;
+    if (page.headings.length >= 3) {
+        headingStructure = `Good structure: ${page.headings.length} headings organize the content`;
+    }
+    else if (page.headings.length > 0) {
+        headingStructure = `Minimal structure: only ${page.headings.length} heading(s)`;
+        score -= 0.5;
+    }
+    else {
+        headingStructure = "No heading structure — content is unorganized";
+        score -= 1;
+    }
+    // Error state
+    if (page.errorMessages.length > 0) {
+        score -= 2;
+        issues.push(`${page.errorMessages.length} error messages visible`);
+    }
+    // Empty page
+    if (page.mainText.trim().length < 30) {
+        score -= 2;
+        issues.push("Extremely sparse content — page appears empty or broken");
+    }
+    const clampedScore = Math.max(0, Math.min(10, Math.round(score * 10) / 10));
+    const assessmentParts = [];
+    if (clampedScore >= 8)
+        assessmentParts.push("Page purpose and next steps are clear.");
+    else if (clampedScore >= 6)
+        assessmentParts.push("Page is mostly clear but has some ambiguity.");
+    else if (clampedScore >= 4)
+        assessmentParts.push("Page clarity needs improvement — users may be confused.");
+    else
+        assessmentParts.push("Page is unclear — users won't know what to do.");
+    if (issues.length > 0)
+        assessmentParts.push(`Issues: ${issues.join("; ")}.`);
+    return {
+        score: clampedScore,
+        valueProposition,
+        ctaClarity,
+        navigationLogic,
+        headingStructure,
+        assessment: assessmentParts.join(" "),
+    };
+}
+//# sourceMappingURL=clarity.js.map

package/dist/analysis/clarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity.js","sourceRoot":"","sources":["../../src/analysis/clarity.ts"],"names":[],"mappings":"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"}

package/dist/analysis/cognitive-load.d.ts

@@ -0,0 +1,7 @@
+import type { PageSnapshot, CognitiveLoadAssessment } from "../types.js";
+/**
+ * Assess the cognitive load of a page snapshot.
+ * Returns a score from 0 (minimal) to 10 (overwhelming).
+ */
+export declare function assessCognitiveLoad(page: PageSnapshot): CognitiveLoadAssessment;
+//# sourceMappingURL=cognitive-load.d.ts.map

package/dist/analysis/cognitive-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-load.d.ts","sourceRoot":"","sources":["../../src/analysis/cognitive-load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,uBAAuB,CAsC/E"}

package/dist/analysis/cognitive-load.js

@@ -0,0 +1,45 @@
+/**
+ * Assess the cognitive load of a page snapshot.
+ * Returns a score from 0 (minimal) to 10 (overwhelming).
+ */
+export function assessCognitiveLoad(page) {
+    const elementCount = page.interactiveElements.length + page.headings.length;
+    const interactiveCount = page.interactiveElements.length;
+    const textLength = page.mainText.length;
+    const textDensity = textLength / Math.max(1, page.headings.length + 1); // chars per section
+    const decisionPoints = page.buttons.length + page.links.filter((l) => l.isVisible).length;
+    // Score components (each 0-2, sum to 0-10)
+    const elementScore = elementCount > 50 ? 2 : elementCount > 30 ? 1.5 : elementCount > 15 ? 1 : 0.5;
+    const interactiveScore = interactiveCount > 20 ? 2 : interactiveCount > 12 ? 1.5 : interactiveCount > 6 ? 1 : 0.5;
+    const textScore = textDensity > 500 ? 2 : textDensity > 300 ? 1.5 : textDensity > 150 ? 1 : 0.5;
+    const decisionScore = decisionPoints > 15 ? 2 : decisionPoints > 8 ? 1.5 : decisionPoints > 4 ? 1 : 0.5;
+    const formScore = page.formFields.length > 6 ? 2 : page.formFields.length > 3 ? 1.5 : page.formFields.length > 0 ? 1 : 0;
+    const rawScore = elementScore + interactiveScore + textScore + decisionScore + formScore;
+    const score = Math.min(10, Math.round(rawScore * 10) / 10);
+    const visualComplexity = score > 7 ? "Very High" : score > 5 ? "High" : score > 3 ? "Moderate" : "Low";
+    const assessmentParts = [];
+    if (score > 7)
+        assessmentParts.push("This page is overwhelming — too many elements competing for attention.");
+    else if (score > 5)
+        assessmentParts.push("This page has high cognitive load — users may feel decision fatigue.");
+    else if (score > 3)
+        assessmentParts.push("This page has moderate cognitive load — manageable for most users.");
+    else
+        assessmentParts.push("This page has low cognitive load — clean and focused.");
+    if (decisionPoints > 10)
+        assessmentParts.push(`${decisionPoints} clickable elements create decision paralysis.`);
+    if (page.formFields.length > 5)
+        assessmentParts.push(`Form with ${page.formFields.length} fields adds significant friction.`);
+    if (page.headings.length === 0)
+        assessmentParts.push("No headings to organize content — users lack visual anchors.");
+    return {
+        score,
+        elementCount,
+        interactiveCount,
+        textDensity: Math.round(textDensity),
+        decisionPoints,
+        visualComplexity,
+        assessment: assessmentParts.join(" "),
+    };
+}
+//# sourceMappingURL=cognitive-load.js.map

package/dist/analysis/cognitive-load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-load.js","sourceRoot":"","sources":["../../src/analysis/cognitive-load.ts"],"names":[],"mappings":"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"}

package/dist/analysis/emotional-arc.d.ts

@@ -0,0 +1,10 @@
+import type { EmotionalArc, SessionStep } from "../types.js";
+/**
+ * Analyze the emotional arc across a session's steps.
+ */
+export declare function analyzeEmotionalArc(steps: readonly SessionStep[]): EmotionalArc;
+/**
+ * Get a human-readable summary of the emotional journey.
+ */
+export declare function summarizeEmotionalArc(arc: EmotionalArc): string;
+//# sourceMappingURL=emotional-arc.d.ts.map

package/dist/analysis/emotional-arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotional-arc.d.ts","sourceRoot":"","sources":["../../src/analysis/emotional-arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa7E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,YAAY,CAuC/E;AA+BD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAsB/D"}

package/dist/analysis/emotional-arc.js

@@ -0,0 +1,95 @@
+const EMOTION_VALENCE = {
+    delighted: 5,
+    confident: 4,
+    curious: 3,
+    neutral: 2,
+    anxious: 1,
+    confused: 0,
+    bored: -1,
+    frustrated: -2,
+};
+/**
+ * Analyze the emotional arc across a session's steps.
+ */
+export function analyzeEmotionalArc(steps) {
+    if (steps.length === 0) {
+        return {
+            states: [],
+            trend: "stable",
+            lowestPoint: { step: 0, state: "neutral" },
+            highestPoint: { step: 0, state: "neutral" },
+        };
+    }
+    const states = steps.map((s) => s.emotionalState);
+    // Find highest and lowest points
+    let lowestStep = 0;
+    let lowestValence = Infinity;
+    let highestStep = 0;
+    let highestValence = -Infinity;
+    for (let i = 0; i < states.length; i++) {
+        const valence = EMOTION_VALENCE[states[i]] ?? 2;
+        if (valence < lowestValence) {
+            lowestValence = valence;
+            lowestStep = i;
+        }
+        if (valence > highestValence) {
+            highestValence = valence;
+            highestStep = i;
+        }
+    }
+    // Determine trend
+    const trend = determineTrend(states);
+    return {
+        states,
+        trend,
+        lowestPoint: { step: lowestStep, state: states[lowestStep] },
+        highestPoint: { step: highestStep, state: states[highestStep] },
+    };
+}
+/**
+ * Determine the overall emotional trend of the session.
+ */
+function determineTrend(states) {
+    if (states.length < 2)
+        return "stable";
+    const valences = states.map((s) => EMOTION_VALENCE[s] ?? 2);
+    // Calculate changes between consecutive steps
+    const changes = [];
+    for (let i = 1; i < valences.length; i++) {
+        changes.push(valences[i] - valences[i - 1]);
+    }
+    const avgChange = changes.reduce((sum, c) => sum + c, 0) / changes.length;
+    const volatility = changes.reduce((sum, c) => sum + Math.abs(c), 0) / changes.length;
+    // High volatility = volatile
+    if (volatility > 2)
+        return "volatile";
+    // Consistent direction
+    if (avgChange > 0.3)
+        return "improving";
+    if (avgChange < -0.3)
+        return "declining";
+    return "stable";
+}
+/**
+ * Get a human-readable summary of the emotional journey.
+ */
+export function summarizeEmotionalArc(arc) {
+    if (arc.states.length === 0)
+        return "No emotional data recorded.";
+    const trendDescriptions = {
+        improving: "The user's experience improved over the session",
+        stable: "The user's emotional state remained relatively consistent",
+        declining: "The user became increasingly frustrated or disengaged",
+        volatile: "The user's experience was inconsistent — swinging between positive and negative",
+    };
+    const parts = [trendDescriptions[arc.trend] ?? "Unknown trend"];
+    parts.push(`Lowest point: step ${arc.lowestPoint.step} (${arc.lowestPoint.state})`);
+    parts.push(`Highest point: step ${arc.highestPoint.step} (${arc.highestPoint.state})`);
+    const startEmotion = arc.states[0];
+    const endEmotion = arc.states[arc.states.length - 1];
+    if (startEmotion !== endEmotion) {
+        parts.push(`Journey: ${startEmotion} → ${endEmotion}`);
+    }
+    return parts.join(". ") + ".";
+}
+//# sourceMappingURL=emotional-arc.js.map

package/dist/analysis/emotional-arc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotional-arc.js","sourceRoot":"","sources":["../../src/analysis/emotional-arc.ts"],"names":[],"mappings":"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"}

package/dist/analysis/friction.d.ts

@@ -0,0 +1,23 @@
+import type { FrictionPoint, SessionStep, FrictionSeverity } from "../types.js";
+/**
+ * Calculate an overall friction score for a set of steps.
+ * Returns 0-10 where 10 is maximum friction.
+ */
+export declare function calculateFrictionScore(steps: readonly SessionStep[]): number;
+/**
+ * Get all friction points sorted by severity (critical first).
+ */
+export declare function getSortedFriction(steps: readonly SessionStep[]): readonly FrictionPoint[];
+/**
+ * Identify which steps have the highest friction concentration.
+ */
+export declare function getHighFrictionSteps(steps: readonly SessionStep[]): readonly SessionStep[];
+/**
+ * Group friction points by their location (URL).
+ */
+export declare function groupFrictionByLocation(steps: readonly SessionStep[]): ReadonlyMap<string, readonly FrictionPoint[]>;
+/**
+ * Get a count summary of friction by severity level.
+ */
+export declare function countBySeverity(steps: readonly SessionStep[]): Readonly<Record<FrictionSeverity, number>>;
+//# sourceMappingURL=friction.d.ts.map

package/dist/analysis/friction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction.d.ts","sourceRoot":"","sources":["../../src/analysis/friction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAShF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAY5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,aAAa,EAAE,CAKzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,CAI1F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,CAU/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAQ5C"}

package/dist/analysis/friction.js

@@ -0,0 +1,61 @@
+const SEVERITY_WEIGHTS = {
+    low: 1,
+    medium: 2,
+    high: 4,
+    critical: 7,
+};
+/**
+ * Calculate an overall friction score for a set of steps.
+ * Returns 0-10 where 10 is maximum friction.
+ */
+export function calculateFrictionScore(steps) {
+    const allFriction = steps.flatMap((s) => s.frictionPoints);
+    if (allFriction.length === 0)
+        return 0;
+    const totalWeight = allFriction.reduce((sum, f) => sum + (SEVERITY_WEIGHTS[f.severity] ?? 1), 0);
+    // Normalize: scale by step count, cap at 10
+    const normalized = (totalWeight / Math.max(1, steps.length)) * 2;
+    return Math.min(10, Math.round(normalized * 10) / 10);
+}
+/**
+ * Get all friction points sorted by severity (critical first).
+ */
+export function getSortedFriction(steps) {
+    const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+    return steps
+        .flatMap((s) => s.frictionPoints)
+        .sort((a, b) => (severityOrder[a.severity] ?? 3) - (severityOrder[b.severity] ?? 3));
+}
+/**
+ * Identify which steps have the highest friction concentration.
+ */
+export function getHighFrictionSteps(steps) {
+    return steps.filter((s) => s.frictionPoints.some((f) => f.severity === "high" || f.severity === "critical"));
+}
+/**
+ * Group friction points by their location (URL).
+ */
+export function groupFrictionByLocation(steps) {
+    const map = new Map();
+    for (const step of steps) {
+        for (const friction of step.frictionPoints) {
+            const existing = map.get(friction.location) ?? [];
+            existing.push(friction);
+            map.set(friction.location, existing);
+        }
+    }
+    return map;
+}
+/**
+ * Get a count summary of friction by severity level.
+ */
+export function countBySeverity(steps) {
+    const counts = { low: 0, medium: 0, high: 0, critical: 0 };
+    for (const step of steps) {
+        for (const friction of step.frictionPoints) {
+            counts[friction.severity]++;
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=friction.js.map

package/dist/analysis/friction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction.js","sourceRoot":"","sources":["../../src/analysis/friction.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAA+C;IACnE,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA6B;IAClE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CACpC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EACrD,CAAC,CACF,CAAC;IAEF,4CAA4C;IAC5C,MAAM,UAAU,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,aAAa,GAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC1F,OAAO,KAAK;SACT,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA6B;IAChE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxB,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CACjF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA6B;IAE7B,MAAM,MAAM,GAAqC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/feedback/comparison.d.ts

@@ -0,0 +1,11 @@
+import type { UserSession, PersonaComparison } from "../types.js";
+/**
+ * Compare sessions from multiple personas on the same flow.
+ * Identifies shared friction points and divergence points.
+ */
+export declare function comparePersonaSessions(sessions: readonly UserSession[]): PersonaComparison;
+/**
+ * Generate a markdown comparison report.
+ */
+export declare function generateComparisonReport(comparison: PersonaComparison): string;
+//# sourceMappingURL=comparison.d.ts.map

package/dist/feedback/comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.d.ts","sourceRoot":"","sources":["../../src/feedback/comparison.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,iBAAiB,CAuHnB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CA0D9E"}