userflow-mcp 0.2.0

package/dist/feedback/comparison.js

@@ -0,0 +1,156 @@
+/**
+ * Compare sessions from multiple personas on the same flow.
+ * Identifies shared friction points and divergence points.
+ */
+export function comparePersonaSessions(sessions) {
+    if (sessions.length === 0) {
+        return {
+            personas: [],
+            sessions: [],
+            sharedFriction: [],
+            divergencePoints: [],
+            overallRecommendations: [],
+        };
+    }
+    const personas = sessions.map((s) => s.persona);
+    // Find friction points that appear across multiple personas
+    const frictionByUrl = new Map();
+    for (const session of sessions) {
+        for (const step of session.steps) {
+            for (const friction of step.frictionPoints) {
+                const urlFriction = frictionByUrl.get(friction.location) ?? [];
+                // Check if similar friction already recorded
+                const existing = urlFriction.find((f) => f.friction.description === friction.description);
+                if (existing) {
+                    existing.personas.add(session.persona.name);
+                }
+                else {
+                    urlFriction.push({
+                        friction,
+                        personas: new Set([session.persona.name]),
+                    });
+                }
+                frictionByUrl.set(friction.location, urlFriction);
+            }
+        }
+    }
+    // Shared friction = friction experienced by 2+ personas
+    const sharedFriction = [];
+    for (const [, frictionList] of frictionByUrl) {
+        for (const item of frictionList) {
+            if (item.personas.size >= 2) {
+                sharedFriction.push(item.friction);
+            }
+        }
+    }
+    // Divergence points: steps where personas took different actions on the same URL
+    const divergencePoints = [];
+    // Build URL → persona action map per step index
+    const maxSteps = Math.max(...sessions.map((s) => s.steps.length));
+    for (let step = 0; step < Math.min(maxSteps, 20); step++) {
+        const actionsAtStep = [];
+        for (const session of sessions) {
+            const sessionStep = session.steps[step];
+            if (sessionStep) {
+                actionsAtStep.push({
+                    persona: session.persona.name,
+                    action: `${sessionStep.action.type}${sessionStep.action.target ? ` → ${sessionStep.action.target}` : ""}`,
+                    thought: sessionStep.thought,
+                    url: sessionStep.page.url,
+                });
+            }
+        }
+        // Check if actions diverge
+        const uniqueActions = new Set(actionsAtStep.map((a) => a.action));
+        if (uniqueActions.size > 1 && actionsAtStep.length > 1) {
+            divergencePoints.push({
+                step,
+                url: actionsAtStep[0].url,
+                personaActions: actionsAtStep.map((a) => ({
+                    persona: a.persona,
+                    action: a.action,
+                    thought: a.thought,
+                })),
+            });
+        }
+    }
+    // Generate overall recommendations
+    const overallRecommendations = [];
+    if (sharedFriction.length > 0) {
+        overallRecommendations.push(`Fix ${sharedFriction.length} shared friction point(s) first — these affect ALL user types`);
+    }
+    const failedSessions = sessions.filter((s) => !s.summary.goalAchieved);
+    if (failedSessions.length > 0) {
+        const failedPersonas = failedSessions.map((s) => s.persona.name).join(", ");
+        overallRecommendations.push(`${failedSessions.length}/${sessions.length} personas could not achieve their goal (${failedPersonas})`);
+    }
+    const avgFriction = sessions.reduce((sum, s) => sum + s.summary.frictionScore, 0) / sessions.length;
+    if (avgFriction > 5) {
+        overallRecommendations.push(`Average friction score is ${avgFriction.toFixed(1)}/10 — the flow needs significant UX improvement`);
+    }
+    if (divergencePoints.length > 3) {
+        overallRecommendations.push(`${divergencePoints.length} divergence points found — the UI is interpreted differently by different user types`);
+    }
+    return {
+        personas,
+        sessions: [...sessions],
+        sharedFriction,
+        divergencePoints,
+        overallRecommendations,
+    };
+}
+/**
+ * Generate a markdown comparison report.
+ */
+export function generateComparisonReport(comparison) {
+    const lines = [];
+    lines.push(`# Multi-Persona Comparison Report`);
+    lines.push(``);
+    lines.push(`**Personas tested:** ${comparison.personas.map((p) => p.name).join(", ")}`);
+    lines.push(``);
+    // Summary table
+    lines.push(`## Session Summary`);
+    lines.push(``);
+    lines.push(`| Persona | Steps | Friction | Goal | Emotional Trend |`);
+    lines.push(`|---------|-------|----------|------|-----------------|`);
+    for (const session of comparison.sessions) {
+        lines.push(`| ${session.persona.name} | ${session.summary.totalSteps} | ${session.summary.frictionScore}/10 | ${session.summary.goalAchieved ? "✅" : "❌"} | ${session.summary.emotionalJourney[session.summary.emotionalJourney.length - 1] ?? "n/a"} |`);
+    }
+    lines.push(``);
+    // Shared friction
+    if (comparison.sharedFriction.length > 0) {
+        lines.push(`## Shared Friction Points (affect all users)`);
+        lines.push(``);
+        for (const friction of comparison.sharedFriction) {
+            lines.push(`- **[${friction.severity.toUpperCase()}]** ${friction.description}`);
+            lines.push(`  → ${friction.suggestion}`);
+        }
+        lines.push(``);
+    }
+    // Divergence points
+    if (comparison.divergencePoints.length > 0) {
+        lines.push(`## Divergence Points`);
+        lines.push(``);
+        lines.push(`These are moments where different personas interpreted the UI differently:`);
+        lines.push(``);
+        for (const dp of comparison.divergencePoints.slice(0, 10)) {
+            lines.push(`### Step ${dp.step} — ${dp.url}`);
+            for (const pa of dp.personaActions) {
+                lines.push(`- **${pa.persona}:** ${pa.action}`);
+                lines.push(`  > ${pa.thought}`);
+            }
+            lines.push(``);
+        }
+    }
+    // Overall recommendations
+    if (comparison.overallRecommendations.length > 0) {
+        lines.push(`## Overall Recommendations`);
+        lines.push(``);
+        for (let i = 0; i < comparison.overallRecommendations.length; i++) {
+            lines.push(`${i + 1}. ${comparison.overallRecommendations[i]}`);
+        }
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=comparison.js.map

package/dist/feedback/comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.js","sourceRoot":"","sources":["../../src/feedback/comparison.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgC;IAEhC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,cAAc,EAAE,EAAE;YAClB,gBAAgB,EAAE,EAAE;YACpB,sBAAsB,EAAE,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEhD,4DAA4D;IAC5D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAgE,CAAC;IAE9F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC3C,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC/D,6CAA6C;gBAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC,CAAC,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,CAChD,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC9C,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,IAAI,CAAC;wBACf,QAAQ;wBACR,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;qBAC1C,CAAC,CAAC;gBACL,CAAC;gBACD,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,cAAc,GAAoB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,EAAE,YAAY,CAAC,IAAI,aAAa,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC5B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,MAAM,gBAAgB,GAAuF,EAAE,CAAC;IAEhH,gDAAgD;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,aAAa,GAAwE,EAAE,CAAC;QAE9F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,WAAW,EAAE,CAAC;gBAChB,aAAa,CAAC,IAAI,CAAC;oBACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;oBAC7B,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;oBACzG,OAAO,EAAE,WAAW,CAAC,OAAO;oBAC5B,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,gBAAgB,CAAC,IAAI,CAAC;gBACpB,IAAI;gBACJ,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG;gBACzB,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxC,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,sBAAsB,GAAa,EAAE,CAAC;IAE5C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,sBAAsB,CAAC,IAAI,CACzB,OAAO,cAAc,CAAC,MAAM,+DAA+D,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,sBAAsB,CAAC,IAAI,CACzB,GAAG,cAAc,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,2CAA2C,cAAc,GAAG,CACxG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IACpG,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,sBAAsB,CAAC,IAAI,CACzB,6BAA6B,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iDAAiD,CACrG,CAAC;IACJ,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,sBAAsB,CAAC,IAAI,CACzB,GAAG,gBAAgB,CAAC,MAAM,sFAAsF,CACjH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,cAAc;QACd,gBAAgB;QAChB,sBAAsB;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAA6B;IACpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CACR,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,SAAS,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAC9O,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kBAAkB;IAClB,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YACjF,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,oBAAoB;IACpB,IAAI,UAAU,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9C,KAAK,MAAM,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,UAAU,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,sBAAsB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/feedback/generator.d.ts

@@ -0,0 +1,19 @@
+import type { UserSession, EmotionalState } from "../types.js";
+/**
+ * Generate a complete markdown feedback report from a user session.
+ */
+export declare function generateSessionReport(session: UserSession): string;
+/**
+ * Generate a brief first-impression report.
+ */
+export declare function generateQuickImpressionReport(params: {
+    readonly url: string;
+    readonly personaName: string;
+    readonly firstImpression: string;
+    readonly whatItDoes: string;
+    readonly clarityScore: number;
+    readonly emotionalReaction: EmotionalState;
+    readonly wouldContinue: boolean;
+    readonly reasoning: string;
+}): string;
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/feedback/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA8B,cAAc,EAAE,MAAM,aAAa,CAAC;AAuB3F;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA4FlE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAoBT"}

package/dist/feedback/generator.js

@@ -0,0 +1,139 @@
+import { analyzeEmotionalArc, summarizeEmotionalArc } from "../analysis/emotional-arc.js";
+import { assessCognitiveLoad } from "../analysis/cognitive-load.js";
+import { assessClarity } from "../analysis/clarity.js";
+const EMOTION_ICONS = {
+    curious: "🔍",
+    confident: "✅",
+    neutral: "😐",
+    confused: "❓",
+    frustrated: "😤",
+    delighted: "😊",
+    anxious: "😰",
+    bored: "😴",
+};
+const SEVERITY_ICONS = {
+    low: "💡",
+    medium: "⚠️",
+    high: "🛑",
+    critical: "🚨",
+};
+/**
+ * Generate a complete markdown feedback report from a user session.
+ */
+export function generateSessionReport(session) {
+    const { persona, steps, summary } = session;
+    const arc = analyzeEmotionalArc(steps);
+    const arcSummary = summarizeEmotionalArc(arc);
+    const lines = [];
+    // Header
+    lines.push(`# UserFlow Session Report`);
+    lines.push(``);
+    lines.push(`**URL:** ${session.startUrl}`);
+    lines.push(`**Persona:** ${persona.name} — ${persona.description}`);
+    lines.push(`**Background:** ${persona.background}`);
+    lines.push(`**Goals:** ${persona.goals.join(", ")}`);
+    lines.push(`**Tech Literacy:** ${persona.traits.techLiteracy} | **Patience:** ${persona.traits.patience} | **Device:** ${persona.traits.devicePreference}`);
+    lines.push(`**Started:** ${session.startedAt} | **Completed:** ${session.completedAt}`);
+    lines.push(``);
+    // Summary card
+    lines.push(`## Summary`);
+    lines.push(``);
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Steps taken | ${summary.totalSteps} |`);
+    lines.push(`| Friction score | **${summary.frictionScore}/10** ${frictionLabel(summary.frictionScore)} |`);
+    lines.push(`| Goal achieved | ${summary.goalAchieved ? "✅ Yes" : "❌ No"} |`);
+    lines.push(`| Drop-off risk | ${summary.dropOffRisk} |`);
+    lines.push(`| Emotional trend | ${arc.trend} |`);
+    lines.push(``);
+    // Emotional journey
+    lines.push(`## Emotional Journey`);
+    lines.push(``);
+    lines.push(summary.emotionalJourney.map((e, i) => `Step ${i}: ${EMOTION_ICONS[e]} ${e}`).join(" → "));
+    lines.push(``);
+    lines.push(arcSummary);
+    lines.push(``);
+    // Step-by-step walkthrough
+    lines.push(`## Step-by-Step Walkthrough`);
+    lines.push(``);
+    for (const step of steps) {
+        lines.push(`### Step ${step.index}: ${step.page.title || step.page.url}`);
+        lines.push(``);
+        lines.push(`${EMOTION_ICONS[step.emotionalState]} **${step.emotionalState}** | ${step.action.type}${step.action.target ? ` → \`${step.action.target}\`` : ""}`);
+        lines.push(``);
+        lines.push(`> ${step.thought}`);
+        lines.push(``);
+        // Page analysis (for first and key steps)
+        if (step.index === 0 || step.frictionPoints.length > 0) {
+            const cogLoad = assessCognitiveLoad(step.page);
+            const clarity = assessClarity(step.page);
+            lines.push(`📊 Cognitive Load: ${cogLoad.score}/10 (${cogLoad.visualComplexity}) | Clarity: ${clarity.score}/10`);
+            lines.push(``);
+        }
+        // Friction points
+        if (step.frictionPoints.length > 0) {
+            for (const friction of step.frictionPoints) {
+                lines.push(`${SEVERITY_ICONS[friction.severity]} **${friction.severity.toUpperCase()}:** ${friction.description}`);
+                lines.push(`   → ${friction.suggestion}`);
+            }
+            lines.push(``);
+        }
+    }
+    // Top friction points
+    if (summary.topFrictionPoints.length > 0) {
+        lines.push(`## Top Friction Points`);
+        lines.push(``);
+        lines.push(`| # | Severity | Issue | Suggestion |`);
+        lines.push(`|---|----------|-------|------------|`);
+        for (let i = 0; i < summary.topFrictionPoints.length; i++) {
+            const f = summary.topFrictionPoints[i];
+            lines.push(`| ${i + 1} | ${SEVERITY_ICONS[f.severity]} ${f.severity} | ${f.description} | ${f.suggestion} |`);
+        }
+        lines.push(``);
+    }
+    // Recommendations
+    if (summary.recommendations.length > 0) {
+        lines.push(`## Recommendations`);
+        lines.push(``);
+        for (let i = 0; i < summary.recommendations.length; i++) {
+            lines.push(`${i + 1}. ${summary.recommendations[i]}`);
+        }
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+/**
+ * Generate a brief first-impression report.
+ */
+export function generateQuickImpressionReport(params) {
+    const lines = [];
+    lines.push(`# Quick Impression Report`);
+    lines.push(``);
+    lines.push(`**URL:** ${params.url}`);
+    lines.push(`**Persona:** ${params.personaName}`);
+    lines.push(``);
+    lines.push(`## First Impression`);
+    lines.push(``);
+    lines.push(`> ${params.firstImpression}`);
+    lines.push(``);
+    lines.push(`**What the user thinks it does:** ${params.whatItDoes}`);
+    lines.push(`**Clarity score:** ${params.clarityScore}/10`);
+    lines.push(`**Emotional reaction:** ${EMOTION_ICONS[params.emotionalReaction]} ${params.emotionalReaction}`);
+    lines.push(`**Would continue:** ${params.wouldContinue ? "✅ Yes" : "❌ No"}`);
+    lines.push(``);
+    lines.push(`**Reasoning:** ${params.reasoning}`);
+    lines.push(``);
+    return lines.join("\n");
+}
+function frictionLabel(score) {
+    if (score <= 2)
+        return "(Low — smooth experience)";
+    if (score <= 4)
+        return "(Moderate — some bumps)";
+    if (score <= 6)
+        return "(High — significant friction)";
+    if (score <= 8)
+        return "(Very High — likely abandonment)";
+    return "(Critical — broken experience)";
+}
+//# sourceMappingURL=generator.js.map

package/dist/feedback/generator.js.map

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

package/dist/feedback/report.d.ts

@@ -0,0 +1,10 @@
+import type { UserSession, PersonaComparison } from "../types.js";
+/**
+ * Generate a standalone HTML report from a user session.
+ */
+export declare function generateHtmlReport(session: UserSession): string;
+/**
+ * Generate an HTML comparison report for multiple personas.
+ */
+export declare function generateHtmlComparisonReport(comparison: PersonaComparison): string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/feedback/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIlE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAwF/D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAqBlF"}

package/dist/feedback/report.js

@@ -0,0 +1,123 @@
+import { generateSessionReport } from "./generator.js";
+import { generateComparisonReport } from "./comparison.js";
+/**
+ * Generate a standalone HTML report from a user session.
+ */
+export function generateHtmlReport(session) {
+    const markdown = generateSessionReport(session);
+    const { persona, summary } = session;
+    const frictionColor = summary.frictionScore <= 3 ? "#22c55e"
+        : summary.frictionScore <= 6 ? "#eab308"
+            : "#ef4444";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>UserFlow Report — ${persona.name} on ${session.startUrl}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #1a1a2e; background: #f8f9fa; padding: 2rem; max-width: 900px; margin: 0 auto; }
+    h1 { font-size: 1.8rem; margin-bottom: 0.5rem; color: #1a1a2e; }
+    h2 { font-size: 1.3rem; margin: 2rem 0 1rem; color: #16213e; border-bottom: 2px solid #e2e8f0; padding-bottom: 0.5rem; }
+    h3 { font-size: 1.1rem; margin: 1.5rem 0 0.5rem; color: #0f3460; }
+    .card { background: white; border-radius: 12px; padding: 1.5rem; margin-bottom: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+    .metric { display: inline-block; padding: 0.5rem 1rem; border-radius: 8px; margin: 0.25rem; font-weight: 600; }
+    .friction-score { background: ${frictionColor}20; color: ${frictionColor}; font-size: 1.5rem; padding: 0.75rem 1.5rem; }
+    .goal-yes { background: #22c55e20; color: #22c55e; }
+    .goal-no { background: #ef444420; color: #ef4444; }
+    table { width: 100%; border-collapse: collapse; margin: 1rem 0; }
+    th, td { padding: 0.75rem; text-align: left; border-bottom: 1px solid #e2e8f0; }
+    th { background: #f1f5f9; font-weight: 600; }
+    blockquote { border-left: 3px solid #6366f1; padding-left: 1rem; margin: 1rem 0; color: #4a5568; font-style: italic; }
+    .step { border-left: 3px solid #e2e8f0; padding-left: 1rem; margin: 1rem 0; }
+    .step.has-friction { border-left-color: #ef4444; }
+    .friction-tag { display: inline-block; padding: 0.2rem 0.5rem; border-radius: 4px; font-size: 0.8rem; font-weight: 600; margin-right: 0.5rem; }
+    .friction-low { background: #dbeafe; color: #1d4ed8; }
+    .friction-medium { background: #fef3c7; color: #92400e; }
+    .friction-high { background: #fee2e2; color: #991b1b; }
+    .friction-critical { background: #991b1b; color: white; }
+    .emotion-bar { display: flex; gap: 0.25rem; margin: 1rem 0; flex-wrap: wrap; }
+    .emotion-step { padding: 0.3rem 0.6rem; border-radius: 6px; font-size: 0.8rem; background: #f1f5f9; }
+    .persona-info { color: #64748b; font-size: 0.9rem; }
+    footer { margin-top: 3rem; text-align: center; color: #94a3b8; font-size: 0.85rem; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>UserFlow Session Report</h1>
+    <p class="persona-info"><strong>${persona.name}</strong> — ${persona.description}</p>
+    <p class="persona-info">Goals: ${persona.goals.join(", ")}</p>
+    <p class="persona-info">URL: <a href="${session.startUrl}">${session.startUrl}</a></p>
+  </div>
+
+  <div class="card">
+    <h2>Summary</h2>
+    <span class="metric friction-score">Friction: ${summary.frictionScore}/10</span>
+    <span class="metric ${summary.goalAchieved ? "goal-yes" : "goal-no"}">${summary.goalAchieved ? "Goal Achieved ✅" : "Goal Not Achieved ❌"}</span>
+    <span class="metric" style="background: #f1f5f9;">${summary.totalSteps} steps</span>
+
+    <h3>Emotional Journey</h3>
+    <div class="emotion-bar">
+      ${summary.emotionalJourney.map((e, i) => `<span class="emotion-step">Step ${i}: ${e}</span>`).join("\n      ")}
+    </div>
+    <p>${summary.dropOffRisk}</p>
+  </div>
+
+  ${session.steps.length > 0 ? `
+  <div class="card">
+    <h2>Step-by-Step Walkthrough</h2>
+    ${session.steps.map((step) => `
+    <div class="step ${step.frictionPoints.length > 0 ? "has-friction" : ""}">
+      <h3>Step ${step.index}: ${step.page.title || step.page.url}</h3>
+      <p><strong>${step.emotionalState}</strong> | ${step.action.type}${step.action.target ? ` → <code>${step.action.target}</code>` : ""}</p>
+      <blockquote>${step.thought}</blockquote>
+      ${step.frictionPoints.map((f) => `<p><span class="friction-tag friction-${f.severity}">${f.severity.toUpperCase()}</span> ${f.description}<br><em>→ ${f.suggestion}</em></p>`).join("\n      ")}
+    </div>`).join("\n")}
+  </div>` : ""}
+
+  ${summary.recommendations.length > 0 ? `
+  <div class="card">
+    <h2>Recommendations</h2>
+    <ol>
+      ${summary.recommendations.map((r) => `<li>${r}</li>`).join("\n      ")}
+    </ol>
+  </div>` : ""}
+
+  <footer>
+    Generated by <strong>UserFlow MCP</strong> — Persona-based UX feedback for developers
+  </footer>
+</body>
+</html>`;
+}
+/**
+ * Generate an HTML comparison report for multiple personas.
+ */
+export function generateHtmlComparisonReport(comparison) {
+    const markdown = generateComparisonReport(comparison);
+    // For comparison reports, use markdown-based output wrapped in basic HTML
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>UserFlow Multi-Persona Comparison</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #1a1a2e; background: #f8f9fa; padding: 2rem; max-width: 900px; margin: 0 auto; }
+    pre { background: #f1f5f9; padding: 1rem; border-radius: 8px; overflow-x: auto; white-space: pre-wrap; }
+    footer { margin-top: 3rem; text-align: center; color: #94a3b8; font-size: 0.85rem; }
+  </style>
+</head>
+<body>
+  <pre>${escapeHtml(markdown)}</pre>
+  <footer>Generated by <strong>UserFlow MCP</strong></footer>
+</body>
+</html>`;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=report.js.map

package/dist/feedback/report.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error starting UserFlow MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/personas/engine.d.ts

@@ -0,0 +1,39 @@
+import type { Persona, PersonaTraits } from "../types.js";
+import { PERSONA_PRESETS, getPresetByName, getPresetById } from "./presets.js";
+export { PERSONA_PRESETS, getPresetByName, getPresetById };
+/**
+ * Create a custom persona from user-provided parameters.
+ * Merges provided traits with sensible defaults.
+ */
+export declare function createCustomPersona(params: {
+    readonly name: string;
+    readonly description: string;
+    readonly background?: string;
+    readonly goals: readonly string[];
+    readonly traits?: Partial<PersonaTraits>;
+    readonly behaviorNotes?: readonly string[];
+}): Persona;
+/**
+ * Resolve a persona from a name/id string. Checks presets first, returns undefined if not found.
+ */
+export declare function resolvePersona(nameOrId: string): Persona | undefined;
+/**
+ * Get the maximum steps this persona will take before giving up.
+ */
+export declare function getMaxSteps(persona: Persona): number;
+/**
+ * Get the probability (0-1) this persona discovers a non-obvious UI element.
+ */
+export declare function getDiscoveryProbability(persona: Persona): number;
+/**
+ * Get viewport dimensions for this persona's device preference.
+ */
+export declare function getViewport(persona: Persona): {
+    readonly width: number;
+    readonly height: number;
+};
+/**
+ * List all available preset persona names.
+ */
+export declare function listPresetNames(): readonly string[];
+//# sourceMappingURL=engine.d.ts.map

package/dist/personas/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/personas/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,GAAG,OAAO,CAoBV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAEjG;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,MAAM,EAAE,CAEnD"}

package/dist/personas/engine.js

@@ -0,0 +1,58 @@
+import { PERSONA_PRESETS, getPresetByName, getPresetById } from "./presets.js";
+import { PATIENCE_STEP_LIMITS, DISCOVERY_PROBABILITY, DEVICE_VIEWPORTS } from "./types.js";
+export { PERSONA_PRESETS, getPresetByName, getPresetById };
+/**
+ * Create a custom persona from user-provided parameters.
+ * Merges provided traits with sensible defaults.
+ */
+export function createCustomPersona(params) {
+    const defaultTraits = {
+        techLiteracy: "intermediate",
+        patience: "moderate",
+        ageGroup: "adult",
+        devicePreference: "desktop",
+        accessibilityNeeds: ["none"],
+        domainKnowledge: 5,
+        attentionToDetail: 5,
+    };
+    return {
+        id: `custom-${params.name.toLowerCase().replace(/\s+/g, "-")}-${Date.now()}`,
+        name: params.name,
+        description: params.description,
+        background: params.background ?? `Custom persona: ${params.description}`,
+        goals: params.goals,
+        traits: { ...defaultTraits, ...params.traits },
+        behaviorNotes: params.behaviorNotes ?? [],
+    };
+}
+/**
+ * Resolve a persona from a name/id string. Checks presets first, returns undefined if not found.
+ */
+export function resolvePersona(nameOrId) {
+    return getPresetByName(nameOrId) ?? getPresetById(nameOrId);
+}
+/**
+ * Get the maximum steps this persona will take before giving up.
+ */
+export function getMaxSteps(persona) {
+    return PATIENCE_STEP_LIMITS[persona.traits.patience] ?? 12;
+}
+/**
+ * Get the probability (0-1) this persona discovers a non-obvious UI element.
+ */
+export function getDiscoveryProbability(persona) {
+    return DISCOVERY_PROBABILITY[persona.traits.techLiteracy] ?? 0.5;
+}
+/**
+ * Get viewport dimensions for this persona's device preference.
+ */
+export function getViewport(persona) {
+    return DEVICE_VIEWPORTS[persona.traits.devicePreference] ?? DEVICE_VIEWPORTS.desktop;
+}
+/**
+ * List all available preset persona names.
+ */
+export function listPresetNames() {
+    return PERSONA_PRESETS.map((p) => p.name);
+}
+//# sourceMappingURL=engine.js.map

package/dist/personas/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/personas/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAOnC;IACC,MAAM,aAAa,GAAkB;QACnC,YAAY,EAAE,cAAc;QAC5B,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,OAAO;QACjB,gBAAgB,EAAE,SAAS;QAC3B,kBAAkB,EAAE,CAAC,MAAM,CAAC;QAC5B,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;KACrB,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC5E,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB,MAAM,CAAC,WAAW,EAAE;QACxE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;QAC9C,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/personas/presets.d.ts

@@ -0,0 +1,11 @@
+import type { Persona } from "../types.js";
+export declare const PERSONA_PRESETS: readonly Persona[];
+/**
+ * Find a preset persona by display name (case-insensitive).
+ */
+export declare function getPresetByName(name: string): Persona | undefined;
+/**
+ * Find a preset persona by its unique id.
+ */
+export declare function getPresetById(id: string): Persona | undefined;
+//# sourceMappingURL=presets.d.ts.map

package/dist/personas/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/personas/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EAoP7C,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE7D"}