legends-mcp 1.0.0

package/README.md

@@ -0,0 +1,173 @@
+# 🎭 Vibey Legends MCP
+
+> **Chat with legendary founders & investors in Claude Code. FREE models included.**
+
+Ever wanted to ask Elon Musk about first principles? Get Warren Buffett's take on your investment thesis? Have Steve Jobs roast your product design?
+
+Now you can. Kinda.
+
+## 🚀 Quick Start
+
+```bash
+# Get a FREE API key from OpenRouter
+# https://openrouter.ai/keys
+
+# Add to your Claude Code config
+```
+
+**Claude Code config** (`~/.claude/config.json`):
+```json
+{
+  "mcpServers": {
+    "legends": {
+      "command": "npx",
+      "args": ["@vibey/legends-mcp"],
+      "env": {
+        "OPENROUTER_API_KEY": "sk-or-..."
+      }
+    }
+  }
+}
+```
+
+**That's it.** Restart Claude Code and start chatting.
+
+---
+
+## 🎭 The Council of Legends
+
+### Tech Titans
+| Legend | Vibe |
+|--------|------|
+| **Elon Musk** | 🚀 First principles. Physics. Delete requirements. Sleep at factory. |
+| **Steve Jobs** | 🎨 Design is how it works. Reality distortion field. One more thing... |
+| **Jeff Bezos** | 📦 Day 1 forever. Regret minimization. Customer obsession. |
+| **Jensen Huang** | 🧠 Leather jacket CEO. CUDA everything. AI is eating the world. |
+
+### Investors
+| Legend | Vibe |
+|--------|------|
+| **Warren Buffett** | 🍔 Cherry Coke. Compound interest. Be fearful when others are greedy. |
+| **Charlie Munger** | 📚 Mental models. Brutal honesty. Invert, always invert. |
+| **Peter Thiel** | ♟️ Zero to one. Contrarian bets. Competition is for losers. |
+| **Marc Andreessen** | 💻 Software eating world. Techno-optimist. It's time to build. |
+
+### Startup Sages
+| Legend | Vibe |
+|--------|------|
+| **Paul Graham** | ✍️ Essays. Make something people want. Do things that don't scale. |
+| **Sam Altman** | 🤖 AGI believer. YC to OpenAI. Move fast on AI. |
+| **Naval Ravikant** | 🧘 Seek wealth, not money. Specific knowledge. Leverage. |
+| **Reid Hoffman** | 🔗 LinkedIn mafia. Blitzscaling. Networks. |
+
+### Crypto Builders
+| Legend | Vibe |
+|--------|------|
+| **CZ** | 🌏 BUIDL. 4. Funds are SAFU. Global from day one. |
+| **Anatoly Yakovenko** | ⚡ Proof of History. TPS maximalist. Hardware trends. |
+| **Mert Mumtaz** | 🔧 RPC is life. Developer experience. Docs are product. |
+| **Michael Heinrich** | 🎯 YC alum. Web exit. Decentralized AI infrastructure. |
+
+---
+
+## 💬 Usage
+
+Once configured, use these tools in Claude Code:
+
+### List all legends
+```
+Use list_legends to see who's available
+```
+
+### Chat with a legend
+```
+Use chat_with_legend with legend_id="elon-musk" to ask about first principles thinking
+```
+
+### Get deep context
+```
+Use get_legend_context to see their frameworks, principles, and examples
+```
+
+### 💡 Get quick insight (NEW!)
+```
+Use get_legend_insight with legend_id="elon-musk" for a quick wisdom snippet
+```
+
+Returns formatted insights like:
+```
+╭─── 💡 Elon Musk's Insight ──────────────────────────╮
+
+"The first step is to establish that something is possible;
+then probability will occur."
+
+**First Principles**: Break down to fundamental truths, rebuild from there.
+
+╰────────────────────────────────────────────────────────╯
+```
+
+---
+
+## 🆓 FREE Models
+
+This MCP uses **free models** from OpenRouter by default:
+
+| Tier | Model | Cost |
+|------|-------|------|
+| Fast | Llama 3.2 3B | FREE |
+| Balanced | Gemini 2.0 Flash | FREE |
+| Premium | Llama 3.1 70B | FREE |
+
+**To use paid models** (higher quality):
+```bash
+LEGENDS_USE_FREE_MODELS=false
+```
+
+---
+
+## ⚙️ Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OPENROUTER_API_KEY` | required | Your OpenRouter API key |
+| `LEGENDS_USE_FREE_MODELS` | `true` | Use free models |
+| `LEGENDS_MCP_DEBUG` | `false` | Enable debug logging |
+| `LEGENDS_MCP_TEMPERATURE` | `0.7` | Response creativity |
+
+---
+
+## ⚠️ Important Disclaimers
+
+```
+⚠️ NOT affiliated with, endorsed by, or representative of any real individual
+⚠️ NOT financial, legal, or professional advice
+⚠️ AI personas for EDUCATIONAL and ENTERTAINMENT purposes only
+⚠️ Based on publicly available information, speeches, and writings
+⚠️ Always do your own research (DYOR)
+```
+
+The views expressed by these AI personas are generated interpretations, not actual statements from the real people.
+
+---
+
+## 🤝 Contributing
+
+Want to add a legend? PRs welcome!
+
+Each legend needs:
+- `skill.yaml` with identity, voice, principles, patterns
+- Authentic voice based on public knowledge
+- Clear guardrails (things they'd never say)
+
+---
+
+## 📜 License
+
+MIT - Do what you want, but include the disclaimers.
+
+---
+
+<p align="center">
+  <b>Built by <a href="https://vibey.dev">Vibey</a></b><br>
+  <i>"The best time to get advice from a legend was 20 years ago. The second best time is now."</i>
+</p>

package/dist/agents/guardrails.d.ts

@@ -0,0 +1,44 @@
+import type { LegendSkill } from '../types.js';
+export interface GuardrailResult {
+    passed: boolean;
+    violations: string[];
+    sanitizedResponse?: string;
+}
+export declare function buildLegendGuardrails(legend: LegendSkill): RegExp[];
+/**
+ * Check if a response violates any guardrails
+ * Returns violations if any, or empty array if passed
+ */
+export declare function checkGuardrails(response: string, legend: LegendSkill, context?: {
+    topic?: string;
+}): GuardrailResult;
+/**
+ * Add required disclaimers to response if missing
+ */
+export declare function addRequiredDisclaimers(response: string, legend: LegendSkill, context?: {
+    topic?: string;
+}): string;
+/**
+ * Validate response before returning to user
+ * This is the main guardrail enforcement function
+ */
+export declare function enforceGuardrails(response: string, legend: LegendSkill, context?: {
+    topic?: string;
+}): {
+    response: string;
+    warnings: string[];
+};
+/**
+ * Pre-check user input for topics that require extra care
+ */
+export declare function detectSensitiveTopics(userMessage: string): {
+    isFinancial: boolean;
+    isInvestmentAdvice: boolean;
+    requiresNFA: boolean;
+};
+/**
+ * Generate pre-prompt injection for sensitive topics
+ * This adds extra instructions before the user's message
+ */
+export declare function generateSensitivityPreamble(userMessage: string, legend: LegendSkill): string | null;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/agents/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/agents/guardrails.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAenE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,eAAe,CAgCjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB1C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB,CASA;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,MAAM,GAAG,IAAI,CAqBf"}

package/dist/agents/guardrails.js

@@ -0,0 +1,144 @@
+// Agent Guardrails - Enforce character consistency with code, not just prompts
+// This prevents legends from saying things they would NEVER say
+// Universal guardrails for ALL crypto legends
+const UNIVERSAL_CRYPTO_GUARDRAILS = [
+    {
+        pattern: /\b(buy|sell|invest in|purchase)\s+(this\s+)?token/i,
+        message: 'Financial advice detected - legends never give investment advice',
+    },
+    {
+        pattern: /\b(guaranteed|certain|definitely|100%)\s+(returns?|profit|gains?)/i,
+        message: 'Guaranteed returns claim detected - never promise financial outcomes',
+    },
+    {
+        pattern: /\b(price|token)\s+will\s+(go|reach|hit)\s+\$?\d+/i,
+        message: 'Price prediction detected - legends never predict prices',
+    },
+    {
+        pattern: /\bnot financial advice\b/i,
+        invert: true, // This should be PRESENT when discussing finance
+        context: 'finance',
+    },
+];
+// Legend-specific guardrails loaded from YAML
+export function buildLegendGuardrails(legend) {
+    const patterns = [];
+    // Convert never_say to regex patterns
+    if (legend.never_say) {
+        for (const item of legend.never_say) {
+            // Extract the quoted phrase if present
+            const match = item.match(/"([^"]+)"/);
+            if (match) {
+                patterns.push(new RegExp(match[1], 'i'));
+            }
+        }
+    }
+    return patterns;
+}
+/**
+ * Check if a response violates any guardrails
+ * Returns violations if any, or empty array if passed
+ */
+export function checkGuardrails(response, legend, context) {
+    const violations = [];
+    // Check universal crypto guardrails for crypto legends
+    const isCryptoLegend = legend.tags?.includes('crypto');
+    if (isCryptoLegend) {
+        for (const guardrail of UNIVERSAL_CRYPTO_GUARDRAILS) {
+            if (guardrail.invert) {
+                // This pattern SHOULD be present in certain contexts
+                if (context?.topic === guardrail.context && !guardrail.pattern.test(response)) {
+                    violations.push(`Missing required disclaimer for ${guardrail.context} topic`);
+                }
+            }
+            else {
+                if (guardrail.pattern.test(response) && guardrail.message) {
+                    violations.push(guardrail.message);
+                }
+            }
+        }
+    }
+    // Check legend-specific guardrails
+    const legendPatterns = buildLegendGuardrails(legend);
+    for (const pattern of legendPatterns) {
+        if (pattern.test(response)) {
+            violations.push(`Response contains forbidden phrase: ${pattern.source}`);
+        }
+    }
+    return {
+        passed: violations.length === 0,
+        violations,
+    };
+}
+/**
+ * Add required disclaimers to response if missing
+ */
+export function addRequiredDisclaimers(response, legend, context) {
+    const isCryptoLegend = legend.tags?.includes('crypto');
+    // Add NFA disclaimer for crypto legends discussing anything financial
+    if (isCryptoLegend) {
+        const financialKeywords = /\b(token|invest|price|trading|portfolio|returns?|profits?)\b/i;
+        const hasNFA = /not financial advice|nfa|dyor/i.test(response);
+        if (financialKeywords.test(response) && !hasNFA) {
+            response += '\n\n---\n*Not financial advice. Always DYOR.*';
+        }
+    }
+    return response;
+}
+/**
+ * Validate response before returning to user
+ * This is the main guardrail enforcement function
+ */
+export function enforceGuardrails(response, legend, context) {
+    const warnings = [];
+    // Check for violations
+    const result = checkGuardrails(response, legend, context);
+    if (!result.passed) {
+        // Log violations (don't block, but warn)
+        warnings.push(...result.violations);
+        // For severe violations, we could block or sanitize
+        // For now, we add disclaimers and warn
+    }
+    // Add required disclaimers
+    const enhancedResponse = addRequiredDisclaimers(response, legend, context);
+    return {
+        response: enhancedResponse,
+        warnings,
+    };
+}
+/**
+ * Pre-check user input for topics that require extra care
+ */
+export function detectSensitiveTopics(userMessage) {
+    const isFinancial = /\b(token|price|invest|trading|portfolio|buy|sell)\b/i.test(userMessage);
+    const isInvestmentAdvice = /\b(should i (buy|sell|invest)|is .+ a good investment|price prediction)\b/i.test(userMessage);
+    return {
+        isFinancial,
+        isInvestmentAdvice,
+        requiresNFA: isFinancial || isInvestmentAdvice,
+    };
+}
+/**
+ * Generate pre-prompt injection for sensitive topics
+ * This adds extra instructions before the user's message
+ */
+export function generateSensitivityPreamble(userMessage, legend) {
+    const sensitivity = detectSensitiveTopics(userMessage);
+    if (sensitivity.isInvestmentAdvice) {
+        return `[SYSTEM: The user is asking for investment advice. Remember:
+1. You NEVER give financial advice
+2. Always include "Not financial advice" disclaimer
+3. Redirect to technology and fundamentals
+4. Remind them to do their own research (DYOR)
+5. Never predict prices or promise returns]
+
+`;
+    }
+    if (sensitivity.isFinancial) {
+        return `[SYSTEM: Financial topic detected. Include NFA disclaimer in your response.]
+
+`;
+    }
+    return null;
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/agents/guardrails.js.map

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

package/dist/agents/misbehavior-prevention.d.ts

@@ -0,0 +1,33 @@
+import type { LegendSkill } from '../types.js';
+export interface MisbehaviorCheck {
+    passed: boolean;
+    issues: MisbehaviorIssue[];
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    suggestions: string[];
+}
+export interface MisbehaviorIssue {
+    type: 'character_break' | 'generic' | 'harmful' | 'quality' | 'annoying';
+    message: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    matched?: string;
+}
+/**
+ * Check response for misbehavior
+ */
+export declare function checkMisbehavior(response: string, legend: LegendSkill): MisbehaviorCheck;
+/**
+ * Pre-check user input for potential issues
+ */
+export declare function preCheckUserInput(message: string, legend: LegendSkill): {
+    needsWarning: boolean;
+    warnings: string[];
+};
+/**
+ * Sanitize response to remove problematic content
+ */
+export declare function sanitizeResponse(response: string, legend: LegendSkill): string;
+/**
+ * Generate quality improvement suggestions
+ */
+export declare function getSuggestions(response: string, legend: LegendSkill): string[];
+//# sourceMappingURL=misbehavior-prevention.d.ts.map

package/dist/agents/misbehavior-prevention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misbehavior-prevention.d.ts","sourceRoot":"","sources":["../../src/agents/misbehavior-prevention.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAwF/C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAuHlB;AAoCD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA4B/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,MAAM,EAAE,CAGV"}

package/dist/agents/misbehavior-prevention.js

@@ -0,0 +1,278 @@
+// Misbehavior Prevention System
+// Ensures legends stay in character and don't go rogue
+/**
+ * MISBEHAVIOR CATEGORIES:
+ *
+ * 1. BREAKING CHARACTER
+ *    - Saying "As an AI" or "I'm an AI"
+ *    - Generic chatbot responses
+ *    - Inconsistent personality
+ *
+ * 2. HARMFUL CONTENT
+ *    - Financial advice (especially crypto)
+ *    - Medical/legal advice
+ *    - Harmful instructions
+ *
+ * 3. QUALITY ISSUES
+ *    - Too long/rambling responses
+ *    - Off-topic tangents
+ *    - Repetitive content
+ *    - Hallucinated quotes/facts
+ *
+ * 4. ANNOYING BEHAVIORS
+ *    - Being preachy/condescending
+ *    - Excessive disclaimers
+ *    - Over-explaining
+ *    - Unsolicited opinions
+ */
+// Character breaking patterns
+const CHARACTER_BREAK_PATTERNS = [
+    /\bas an ai\b/i,
+    /\bi('m| am) an? (ai|artificial|language model|llm|chatbot)/i,
+    /\bi cannot (actually|really|truly)/i,
+    /\bi don't have (personal|real|actual) (opinions|feelings|experiences)/i,
+    /\bbased on my training/i,
+    /\bmy knowledge (cutoff|was trained)/i,
+    /\bi was (created|trained|developed) by/i,
+    /\bi'm (just|only) a (program|model|ai)/i,
+    /\baccording to my programming/i,
+    /\bi lack the ability to/i,
+];
+// Generic chatbot responses (avoid these)
+const GENERIC_PATTERNS = [
+    /\bi'd be happy to help/i,
+    /\bthat's a great question/i,
+    /\bcertainly! (here|let me)/i,
+    /\babsolutely! (i|let)/i,
+    /\bi understand (you're|your)/i,
+    /\bthank you for (sharing|asking)/i,
+    /\bi appreciate (you|your)/i,
+    /\blet me think about that/i,
+    /\bthat's an interesting (question|point)/i,
+];
+// Harmful advice patterns
+const HARMFUL_PATTERNS = [
+    // Financial advice
+    /\byou should (buy|sell|invest in)/i,
+    /\bi (recommend|suggest) (buying|selling|investing)/i,
+    /\bguaranteed (returns|profit|gains)/i,
+    /\bthis (will|is going to) (moon|10x|100x)/i,
+    /\bprice (will|is going to) (hit|reach) \$?\d/i,
+    /\bnot financial advice.{0,50}but (you should|i recommend)/i, // Fake NFA
+    // Medical/legal
+    /\byou should (take|stop taking) (medication|medicine)/i,
+    /\bi (diagnose|recommend) (treatment|therapy)/i,
+    /\bthis (is|isn't) legal advice but/i,
+];
+// Quality issue patterns
+const QUALITY_PATTERNS = {
+    tooLong: 2000, // Max characters before warning
+    tooShort: 20, // Min characters
+    repetitionThreshold: 0.3, // Max ratio of repeated phrases
+};
+// Annoying behavior patterns
+const ANNOYING_PATTERNS = [
+    /\blet me (explain|tell you) (something|a few things)/i,
+    /\byou need to understand/i,
+    /\bfirst (of all|off), let me/i,
+    /\bbefore (i|we) (get|go) into/i,
+    /\bi want to make (sure|certain)/i,
+    /\b(to be|being) (clear|honest|frank)/i, // Only bad in excess
+];
+/**
+ * Check response for misbehavior
+ */
+export function checkMisbehavior(response, legend) {
+    const issues = [];
+    const suggestions = [];
+    // Check character breaking
+    for (const pattern of CHARACTER_BREAK_PATTERNS) {
+        const match = response.match(pattern);
+        if (match) {
+            issues.push({
+                type: 'character_break',
+                message: `Legend broke character with: "${match[0]}"`,
+                severity: 'high',
+                matched: match[0],
+            });
+            suggestions.push(`Remove "${match[0]}" - legends never acknowledge being AI`);
+        }
+    }
+    // Check generic responses
+    let genericCount = 0;
+    for (const pattern of GENERIC_PATTERNS) {
+        if (pattern.test(response)) {
+            genericCount++;
+        }
+    }
+    if (genericCount >= 2) {
+        issues.push({
+            type: 'generic',
+            message: `Response uses ${genericCount} generic chatbot phrases`,
+            severity: 'medium',
+        });
+        suggestions.push('Use more characteristic vocabulary from the legend');
+    }
+    // Check harmful content
+    for (const pattern of HARMFUL_PATTERNS) {
+        const match = response.match(pattern);
+        if (match) {
+            issues.push({
+                type: 'harmful',
+                message: `Potentially harmful content detected: "${match[0]}"`,
+                severity: 'critical',
+                matched: match[0],
+            });
+            suggestions.push('Rewrite to avoid financial/medical/legal advice');
+        }
+    }
+    // Check quality issues
+    if (response.length > QUALITY_PATTERNS.tooLong) {
+        issues.push({
+            type: 'quality',
+            message: `Response too long (${response.length} chars)`,
+            severity: 'low',
+        });
+        suggestions.push('Consider a more concise response');
+    }
+    if (response.length < QUALITY_PATTERNS.tooShort) {
+        issues.push({
+            type: 'quality',
+            message: `Response too short (${response.length} chars)`,
+            severity: 'low',
+        });
+        suggestions.push('Provide more substantive content');
+    }
+    // Check for repetition
+    const repetitionScore = calculateRepetition(response);
+    if (repetitionScore > QUALITY_PATTERNS.repetitionThreshold) {
+        issues.push({
+            type: 'quality',
+            message: `High repetition detected (${(repetitionScore * 100).toFixed(0)}%)`,
+            severity: 'medium',
+        });
+        suggestions.push('Vary the language and structure');
+    }
+    // Check annoying patterns (only flag if multiple)
+    let annoyingCount = 0;
+    for (const pattern of ANNOYING_PATTERNS) {
+        if (pattern.test(response)) {
+            annoyingCount++;
+        }
+    }
+    if (annoyingCount >= 3) {
+        issues.push({
+            type: 'annoying',
+            message: `Response may come across as preachy (${annoyingCount} warning phrases)`,
+            severity: 'low',
+        });
+        suggestions.push('Be more direct, less preamble');
+    }
+    // Check legend-specific never_say
+    if (legend.never_say) {
+        for (const phrase of legend.never_say) {
+            const cleanPhrase = phrase.replace(/['"]/g, '').toLowerCase();
+            if (response.toLowerCase().includes(cleanPhrase)) {
+                issues.push({
+                    type: 'character_break',
+                    message: `Legend said forbidden phrase: "${phrase}"`,
+                    severity: 'high',
+                    matched: phrase,
+                });
+                suggestions.push(`Remove: "${phrase}" - this legend would never say this`);
+            }
+        }
+    }
+    // Calculate overall severity
+    const severity = calculateOverallSeverity(issues);
+    return {
+        passed: issues.length === 0 || severity === 'low',
+        issues,
+        severity,
+        suggestions,
+    };
+}
+/**
+ * Calculate repetition score (0-1)
+ */
+function calculateRepetition(text) {
+    const sentences = text.split(/[.!?]+/).filter(s => s.trim().length > 10);
+    if (sentences.length < 2)
+        return 0;
+    let repetitions = 0;
+    const seen = new Set();
+    for (const sentence of sentences) {
+        const normalized = sentence.toLowerCase().trim().slice(0, 50);
+        if (seen.has(normalized)) {
+            repetitions++;
+        }
+        seen.add(normalized);
+    }
+    return repetitions / sentences.length;
+}
+/**
+ * Calculate overall severity from issues
+ */
+function calculateOverallSeverity(issues) {
+    if (issues.some(i => i.severity === 'critical'))
+        return 'critical';
+    if (issues.some(i => i.severity === 'high'))
+        return 'high';
+    if (issues.filter(i => i.severity === 'medium').length >= 2)
+        return 'high';
+    if (issues.some(i => i.severity === 'medium'))
+        return 'medium';
+    return 'low';
+}
+/**
+ * Pre-check user input for potential issues
+ */
+export function preCheckUserInput(message, legend) {
+    const warnings = [];
+    // Check for financial advice requests
+    const financialPatterns = [
+        /should i (buy|sell|invest)/i,
+        /is .+ a good investment/i,
+        /price prediction/i,
+        /will .+ (moon|pump|dump)/i,
+        /what (token|coin|stock) should/i,
+    ];
+    for (const pattern of financialPatterns) {
+        if (pattern.test(message)) {
+            warnings.push('⚠️ This legend cannot provide financial advice. Response will focus on principles and frameworks instead.');
+            break;
+        }
+    }
+    // Check for medical/legal
+    if (/\b(diagnose|prescribe|legal advice)\b/i.test(message)) {
+        warnings.push('⚠️ This legend cannot provide medical or legal advice.');
+    }
+    return {
+        needsWarning: warnings.length > 0,
+        warnings,
+    };
+}
+/**
+ * Sanitize response to remove problematic content
+ */
+export function sanitizeResponse(response, legend) {
+    let sanitized = response;
+    // Remove character-breaking phrases
+    for (const pattern of CHARACTER_BREAK_PATTERNS) {
+        sanitized = sanitized.replace(pattern, '');
+    }
+    // Clean up any resulting awkward spacing
+    sanitized = sanitized
+        .replace(/\s+/g, ' ')
+        .replace(/\s+([.,!?])/g, '$1')
+        .trim();
+    return sanitized;
+}
+/**
+ * Generate quality improvement suggestions
+ */
+export function getSuggestions(response, legend) {
+    const check = checkMisbehavior(response, legend);
+    return check.suggestions;
+}
+//# sourceMappingURL=misbehavior-prevention.js.map