@lynxflow/seo-engine 1.8.29 → 2.0.0

package/src/power-words-psychology.ts

@@ -1,369 +0,0 @@
-/**
- * 🧠 Universal Open Multilingual Power Words & Click Psychology Engine
- * Supports 50+ World Languages (FR, EN, ES, DE, IT, NL, PT, AR, RU, ZH, JA, HI, PL, SV, TR, KO, etc.)
- * With Dynamic Runtime Dictionary Registration for Infinite Language Extensibility.
- */
-
-export type LanguageCode = string;
-
-export interface CategoryWordBank {
-  authority: string[];
-  urgency: string[];
-  value: string[];
-  curiosity: string[];
-  sentimentPositive: string[];
-  sentimentNegative: string[];
-}
-
-export interface PsychologyAnalysisResult {
-  score: number; // 0 to 100
-  powerWordsDetected: string[];
-  sentiment: "positif" | "negatif" | "neutre";
-  hasNumber: boolean;
-  hasYear: boolean;
-  hasCuriosityTrigger: boolean;
-  hasUrgencyTrigger: boolean;
-  hasAuthorityTrigger: boolean;
-  hasCurrencyOrDiscount: boolean;
-  hasBracketsOrParentheses: boolean;
-  recommendations: string[];
-  suggestedTitles: string[];
-}
-
-// Pre-loaded high-converting dictionaries across global languages
-export const MULTILINGUAL_POWER_WORDS: Record<string, CategoryWordBank> = {
-  fr: {
-    authority: [
-      "officiel", "guide", "expert", "complet", "certifié", "ultime", "meilleur", "meilleurs", "comparatif", 
-      "maîtriser", "spécialiste", "leader", "professionnel", "authentique", "infaillible", "reconnu", "démontré", "avis"
-    ],
-    urgency: [
-      "rapide", "instantané", "maintenant", "immédiat", "express", "2026", "dernière minute", "urgent", 
-      "dépêchez-vous", "en 5 min", "en 10 min", "aujourd'hui", "débloquer", "vite"
-    ],
-    value: [
-      "gratuit", "économique", "rentable", "offert", "sans engagement", "garanti", "facile", "clé en main", 
-      "rentabilité", "gain", "économisez", "inclus", "accessible", "inédit", "remise", "promo"
-    ],
-    curiosity: [
-      "exclusif", "secret", "astuces", "révélé", "inédit", "top", "méthode", "pourquoi", "comment", 
-      "découvrir", "choc", "incontournable", "mystère", "incroyable", "vérité"
-    ],
-    sentimentPositive: [
-      "parfait", "incroyable", "magnifique", "puissant", "réussi", "génial", "exceptionnel", "facile", 
-      "meilleur", "succès", "brillant", "splendide", "radieux", "magique", "sublime"
-    ],
-    sentimentNegative: [
-      "erreur", "piège", "danger", "éviter", "pire", "arnaque", "catastrophe", "risqué", "menace", "perte", "alerte"
-    ]
-  },
-  en: {
-    authority: [
-      "ultimate", "complete", "definitive", "guide", "expert", "official", "proven", "master", "certified", 
-      "best", "top", "authority", "case study", "benchmark", "professional", "review", "formula"
-    ],
-    urgency: [
-      "instant", "fast", "quick", "now", "today", "2026", "deadline", "last chance", "step-by-step", 
-      "in 5 minutes", "immediate", "urgent", "unlock", "rapid"
-    ],
-    value: [
-      "free", "affordable", "save", "guaranteed", "easy", "bonus", "discount", "effortless", 
-      "lifetime", "roi", "value", "exclusive deal", "profitable"
-    ],
-    curiosity: [
-      "secret", "revealed", "insider", "hacks", "why", "how to", "untold", "surprising", 
-      "shocking", "hidden", "must-know", "unbelievable", "myth"
-    ],
-    sentimentPositive: [
-      "amazing", "brilliant", "powerful", "epic", "perfect", "stunning", "thriving", "seamless", 
-      "exceptional", "masterpiece", "unbeatable"
-    ],
-    sentimentNegative: [
-      "mistake", "warning", "fail", "avoid", "risk", "trap", "worst", "scam", "danger", "flaw"
-    ]
-  },
-  es: {
-    authority: [
-      "definitiva", "completa", "guía", "experto", "oficial", "certificado", "mejor", "mejores", "comparativa", 
-      "profesional", "comprobado", "líder", "análisis"
-    ],
-    urgency: [
-      "rápido", "ahora", "urgente", "hoy", "2026", "en 5 minutos", "inmediato", "última oportunidad", "fácil"
-    ],
-    value: [
-      "gratis", "económico", "ahorra", "garantizado", "rentable", "oferta", "descuento", "exclusivo"
-    ],
-    curiosity: [
-      "secreto", "revelado", "trucos", "por qué", "cómo", "impactante", "increíble", "descubre", "método"
-    ],
-    sentimentPositive: [
-      "excelente", "increíble", "perfecto", "potente", "maravilloso", "éxito", "fantástico"
-    ],
-    sentimentNegative: [
-      "error", "peligro", "evita", "peor", "estafa", "trampa", "fracaso", "riesgo"
-    ]
-  },
-  de: {
-    authority: [
-      "ultimativ", "vollständig", "leitfaden", "experte", "offiziell", "zertifiziert", "beste", "bester", "vergleich", "profi"
-    ],
-    urgency: [
-      "schnell", "jetzt", "sofort", "2026", "in 5 minuten", "heute", "dringend", "einfach"
-    ],
-    value: [
-      "kostenlos", "gratis", "sparen", "garantiert", "rabatt", "günstig", "angebot", "profitabel"
-    ],
-    curiosity: [
-      "geheimnis", "enthüllt", "tricks", "tipps", "warum", "wie man", "unglaublich", "entdecken"
-    ],
-    sentimentPositive: [
-      "hervorragend", "perfekt", "genial", "erfolg", "fantastisch", "wunderbar", "stark"
-    ],
-    sentimentNegative: [
-      "fehler", "gefahr", "vermeiden", "schlimmste", "betrug", "risiko", "warnung"
-    ]
-  },
-  it: {
-    authority: [
-      "guida", "completa", "esperto", "ufficiale", "certificato", "migliore", "migliori", "confronto", "definitiva", "professionale"
-    ],
-    urgency: [
-      "veloce", "ora", "subito", "immediato", "2026", "in 5 minuti", "oggi", "urgente"
-    ],
-    value: [
-      "gratis", "gratuito", "risparmia", "garantito", "sconto", "facile", "offerta", "conveniente"
-    ],
-    curiosity: [
-      "segreto", "svelato", "trucchi", "perché", "come fare", "incredibile", "scopri", "metodo"
-    ],
-    sentimentPositive: [
-      "perfetto", "incredibile", "fantastico", "successo", "eccezionale", "meraviglioso"
-    ],
-    sentimentNegative: [
-      "errore", "pericolo", "evitare", "peggiore", "truffa", "rischio", "trappola"
-    ]
-  },
-  nl: {
-    authority: ["ultiem", "gids", "expert", "officieel", "beste", "vergelijk", "compleet", "bewezen"],
-    urgency: ["snel", "nu", "direct", "vandaag", "2026", "meteen", "eenvoudig"],
-    value: ["gratis", "bespaar", "gegarandeerd", "korting", "goedkoop", "voordeel"],
-    curiosity: ["geheim", "onthuld", "tips", "waarom", "hoe", "ontdek"],
-    sentimentPositive: ["geweldig", "perfect", "uitstekend", "succes", "fantastisch"],
-    sentimentNegative: ["fout", "gevaar", "vermijd", "slechtste", "oplichting", "risico"]
-  },
-  pt: {
-    authority: ["guia", "completo", "definitivo", "especialista", "oficial", "melhor", "melhores", "comparativo"],
-    urgency: ["rápido", "agora", "imediato", "hoje", "2026", "em 5 minutos", "urgente"],
-    value: ["grátis", "gratuito", "economize", "garantido", "desconto", "fácil", "oferta"],
-    curiosity: ["segredo", "revelado", "dicas", "por que", "como fazer", "incrível", "descubra"],
-    sentimentPositive: ["perfeito", "incrível", "fantástico", "sucesso", "excelente"],
-    sentimentNegative: ["erro", "perigo", "evite", "pior", "golpe", "risco", "cilada"]
-  },
-  ar: {
-    authority: ["دليل", "شامل", "رسمي", "خبير", "أفضل", "مقارنة", "معتمد", "نهائي"],
-    urgency: ["سريع", "الآن", "فوري", "اليوم", "2026", "في دقائق", "عاجل"],
-    value: ["مجانا", "وفر", "مضمون", "خصم", "سهل", "عرض", "مميز"],
-    curiosity: ["سر", "كشف", "أسرار", "لماذا", "كيف", "مذهل", "اكتشف"],
-    sentimentPositive: ["رائع", "ممتاز", "ناجح", "مبهر", "مثالي"],
-    sentimentNegative: ["خطأ", "تحذير", "تجنب", "فخ", "احتيال", "خطر"]
-  },
-  ru: {
-    authority: ["руководство", "полный", "эксперт", "официальный", "лучший", "лучшие", "сравнение", "проверенный"],
-    urgency: ["быстро", "сейчас", "срочно", "сегодня", "2026", "за 5 минут", "немедленно"],
-    value: ["бесплатно", "скидка", "гарантия", "выгодно", "легко", "акция"],
-    curiosity: ["секрет", "раскрыт", "лайфхаки", "почему", "как", "невероятный", "узнайте"],
-    sentimentPositive: ["отлично", "идеально", "успех", "потрясающий", "великолепный"],
-    sentimentNegative: ["ошибка", "опасность", "избегать", "худший", "обман", "риск"]
-  },
-  zh: {
-    authority: ["终极", "完整", "指南", "专家", "官方", "最佳", "对比", "评测", "权威"],
-    urgency: ["快速", "立即", "今天", "2026", "5分钟", "马上", "紧急"],
-    value: ["免费", "省钱", "保证", "优惠", "简单", "折扣", "高性价比"],
-    curiosity: ["秘密", "揭秘", "技巧", "为什么", "如何", "必看", "探索"],
-    sentimentPositive: ["完美", "惊人", "卓越", "成功", "极佳", "出色"],
-    sentimentNegative: ["错误", "陷阱", "避免", "危险", "骗局", "风险"]
-  },
-  ja: {
-    authority: ["完全ガイド", "究極", "公式", "専門家", "おすすめ", "徹底比較", "決定版", "プロ"],
-    urgency: ["今すぐ", "速報", "最短", "2026年", "今日", "5分で", "簡単"],
-    value: ["無料", "お得", "割引", "保証", "コスパ", "特典", "プレゼント"],
-    curiosity: ["秘密", "裏ワザ", "暴露", "なぜ", "方法", "必見", "真実"],
-    sentimentPositive: ["最高", "完璧", "圧倒的", "成功", "絶賛", "素晴らしい"],
-    sentimentNegative: ["失敗", "注意", "危険", "避けるべき", "詐欺", "罠"]
-  },
-  hi: {
-    authority: ["गाइड", "सम्पूर्ण", "विशेषज्ञ", "आधिकारिक", "सर्वश्रेष्ठ", "तुलना", "सटीक"],
-    urgency: ["तुरंत", "अभी", "आज", "2026", "5 मिनट में", "जल्दी"],
-    value: ["मुफ्त", "बचत", "गारंटी", "छूट", "आसान", "ऑफर"],
-    curiosity: ["रहस्य", "खुलासा", "टिप्स", "क्यों", "कैसे", "अनोखा"],
-    sentimentPositive: ["उत्कृष्ट", "शानदार", "सफल", "अद्भुत", "बेहतरीन"],
-    sentimentNegative: ["गलती", "खतरा", "सावधान", "धोखा", "नुकसान"]
-  }
-};
-
-export class PowerWordsPsychologyEngine {
-  /**
-   * Register a custom language dictionary at runtime for infinite language extensibility
-   */
-  static registerLanguageWords(langCode: string, words: Partial<CategoryWordBank>): void {
-    const code = langCode.toLowerCase().trim();
-    if (!MULTILINGUAL_POWER_WORDS[code]) {
-      MULTILINGUAL_POWER_WORDS[code] = {
-        authority: [],
-        urgency: [],
-        value: [],
-        curiosity: [],
-        sentimentPositive: [],
-        sentimentNegative: [],
-      };
-    }
-    if (words.authority) MULTILINGUAL_POWER_WORDS[code].authority.push(...words.authority);
-    if (words.urgency) MULTILINGUAL_POWER_WORDS[code].urgency.push(...words.urgency);
-    if (words.value) MULTILINGUAL_POWER_WORDS[code].value.push(...words.value);
-    if (words.curiosity) MULTILINGUAL_POWER_WORDS[code].curiosity.push(...words.curiosity);
-    if (words.sentimentPositive) MULTILINGUAL_POWER_WORDS[code].sentimentPositive.push(...words.sentimentPositive);
-    if (words.sentimentNegative) MULTILINGUAL_POWER_WORDS[code].sentimentNegative.push(...words.sentimentNegative);
-  }
-
-  /**
-   * Get all registered language codes
-   */
-  static getSupportedLanguages(): string[] {
-    return Object.keys(MULTILINGUAL_POWER_WORDS);
-  }
-
-  /**
-   * Analyze title psychology and CTR potential in ANY language
-   */
-  static analyzeTitle(title: string, lang: LanguageCode = "fr"): PsychologyAnalysisResult {
-    const raw = (title || "").toLowerCase().trim();
-    const langKey = lang.toLowerCase().trim();
-    
-    // Multi-bank search: search primary language, plus universal English / French fallback
-    const primaryBank = MULTILINGUAL_POWER_WORDS[langKey] || MULTILINGUAL_POWER_WORDS["en"] || MULTILINGUAL_POWER_WORDS["fr"];
-    const allBanks = [primaryBank];
-    if (langKey !== "en" && MULTILINGUAL_POWER_WORDS["en"]) allBanks.push(MULTILINGUAL_POWER_WORDS["en"]);
-
-    const detectedWords: string[] = [];
-    let authorityMatch = false;
-    let urgencyMatch = false;
-    let valueMatch = false;
-    let curiosityMatch = false;
-    let positiveCount = 0;
-    let negativeCount = 0;
-
-    for (const bank of allBanks) {
-      for (const word of bank.authority) {
-        if (raw.includes(word.toLowerCase())) {
-          authorityMatch = true;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-      for (const word of bank.urgency) {
-        if (raw.includes(word.toLowerCase())) {
-          urgencyMatch = true;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-      for (const word of bank.value) {
-        if (raw.includes(word.toLowerCase())) {
-          valueMatch = true;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-      for (const word of bank.curiosity) {
-        if (raw.includes(word.toLowerCase())) {
-          curiosityMatch = true;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-      for (const word of bank.sentimentPositive) {
-        if (raw.includes(word.toLowerCase())) {
-          positiveCount++;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-      for (const word of bank.sentimentNegative) {
-        if (raw.includes(word.toLowerCase())) {
-          negativeCount++;
-          if (!detectedWords.includes(word)) detectedWords.push(word);
-        }
-      }
-    }
-
-    // Universal Language-Agnostic Triggers
-    const hasNumber = /\b\d+\b/.test(raw);
-    const hasYear = /\b(202[4-9]|203[0-9])\b/.test(raw);
-    const hasCurrencyOrDiscount = /[\$€£¥₹%]|د\.إ|﷼|\b(promo|soldes|discount|deal|off)\b/i.test(raw);
-    const hasBracketsOrParentheses = /[\[\]\(\)\{\}【】《》「」]/.test(raw);
-
-    // Score Calculation (0 - 100)
-    let score = 30; // base score
-    if (detectedWords.length >= 1) score += 20;
-    if (detectedWords.length >= 2) score += 10;
-    if (detectedWords.length >= 3) score += 10;
-    if (hasNumber) score += 15;
-    if (hasYear) score += 10;
-    if (hasCurrencyOrDiscount) score += 5;
-    if (hasBracketsOrParentheses) score += 5;
-    if (score > 100) score = 100;
-
-    let sentiment: "positif" | "negatif" | "neutre" = "neutre";
-    if (positiveCount > negativeCount) sentiment = "positif";
-    else if (negativeCount > positiveCount) sentiment = "negatif";
-
-    const recommendations: string[] = [];
-    if (detectedWords.length === 0) {
-      recommendations.push("Ajoutez au moins 1 mot d'impact émotionnel ou d'autorité (ex: 'Guide', 'Ultime', 'Meilleur').");
-    }
-    if (!hasNumber) {
-      recommendations.push("Intégrez un chiffre (ex: 'Les 7 Meilleurs...') pour augmenter le taux de clic de +36%.");
-    }
-    if (!hasYear) {
-      recommendations.push("Indiquez l'année courante (2026) pour signaler la fraîcheur du contenu aux internautes.");
-    }
-    if (!hasBracketsOrParentheses) {
-      recommendations.push("Utilisez des crochets ou parenthèses [Guide 2026] pour structurer visuellement l'extrait.");
-    }
-
-    // Suggested high CTR titles
-    const cleanSubject = title.replace(/\(.*?\)|\[.*?\]/g, "").trim();
-    const suggestedTitles = [
-      `Les 7 Meilleurs ${cleanSubject} [Guide Ultime 2026]`,
-      `Comment Maîtriser ${cleanSubject} en 5 Étapes (Méthode 2026)`,
-      `${cleanSubject} : Avis, Comparatif et Pièges à Éviter (2026)`
-    ];
-
-    return {
-      score,
-      powerWordsDetected: detectedWords,
-      sentiment,
-      hasNumber,
-      hasYear,
-      hasCuriosityTrigger: curiosityMatch,
-      hasUrgencyTrigger: urgencyMatch,
-      hasAuthorityTrigger: authorityMatch,
-      hasCurrencyOrDiscount,
-      hasBracketsOrParentheses,
-      recommendations,
-      suggestedTitles
-    };
-  }
-
-  /**
-   * Automatically enriches a programmatic title in ANY language with optimal psychology triggers
-   */
-  static enrichProgrammaticTitle(baseTitle: string, lang: LanguageCode = "fr"): string {
-    const analysis = this.analyzeTitle(baseTitle, lang);
-    if (analysis.score >= 80) return baseTitle;
-
-    let enriched = baseTitle.trim();
-    if (!analysis.hasNumber && !enriched.startsWith("Top ") && !enriched.startsWith("Les ")) {
-      enriched = `Les Meilleurs ${enriched}`;
-    }
-    if (!analysis.hasYear) {
-      enriched = `${enriched} (Guide 2026)`;
-    }
-    return enriched;
-  }
-}

package/src/public-manifest-engine.ts

@@ -1,109 +0,0 @@
-/**
- * 🗺️ Universal Public Routes & Navigation Manifest Engine
- * 
- * Allows developers and LLM agents to connect their real public pages (10-50 seed pages)
- * from ANY framework (Next.js, TanStack Router, Astro, Nuxt, WordPress, Laravel, Remix).
- * 
- * Instead of scanning millions of generated URLs, it inspects ONLY the root product pages,
- * navigation menus, or route trees to build the knowledge base for all programmatic pages.
- */
-
-export interface PublicRouteItem {
-  path: string;
-  title: string;
-  description?: string;
-  category?: string;
-  paragraphs?: string[];
-  keyFeatures?: string[];
-  faqs?: { question: string; answer: string }[];
-}
-
-export interface FrameworkManifestConfig {
-  framework?: "nextjs" | "tanstack" | "astro" | "wordpress" | "nuxt" | "custom";
-  routes?: PublicRouteItem[];
-  navMenuItems?: Array<{ label: string; url: string; category?: string }>;
-  contentCollections?: Array<{ slug: string; title: string; content: string }>;
-}
-
-export class PublicRoutesManifestEngine {
-  private static registeredRoutes: Map<string, PublicRouteItem> = new Map();
-
-  /**
-   * 1. Register Public Routes & Navigation Menu (Universal Entrypoint)
-   */
-  static registerManifest(config: FrameworkManifestConfig): number {
-    let count = 0;
-
-    // A. Explicit Route Items
-    if (config.routes && Array.isArray(config.routes)) {
-      for (const r of config.routes) {
-        this.registeredRoutes.set(r.path, r);
-        count++;
-      }
-    }
-
-    // B. From Navigation Menu Items (WordPress Menus, Navbar JSON, etc.)
-    if (config.navMenuItems && Array.isArray(config.navMenuItems)) {
-      for (const nav of config.navMenuItems) {
-        if (!this.registeredRoutes.has(nav.url)) {
-          this.registeredRoutes.set(nav.url, {
-            path: nav.url,
-            title: nav.label,
-            category: nav.category || "Main Navigation",
-            description: `Page officielle ${nav.label} disponible sur le site.`,
-            paragraphs: [`Découvrez la solution ${nav.label} pour optimiser vos processus et vos résultats.`],
-            keyFeatures: [`Accès direct à ${nav.label}`, "Intégration transparente"],
-          });
-          count++;
-        }
-      }
-    }
-
-    // C. From Markdown / MDX Content Collections (Astro, Next.js Contentlayer)
-    if (config.contentCollections && Array.isArray(config.contentCollections)) {
-      for (const doc of config.contentCollections) {
-        const paragraphs = doc.content
-          .split("\n\n")
-          .map((p) => p.replace(/[#*`]/g, "").trim())
-          .filter((p) => p.length > 30)
-          .slice(0, 15);
-
-        this.registeredRoutes.set(doc.slug, {
-          path: doc.slug.startsWith("/") ? doc.slug : `/${doc.slug}`,
-          title: doc.title,
-          category: "Documentation & Features",
-          paragraphs,
-          description: paragraphs[0] || doc.title,
-        });
-        count++;
-      }
-    }
-
-    return count;
-  }
-
-  /**
-   * 2. Auto-Adapter for WordPress Menu & Pages
-   * In WordPress: pass result of wp_get_nav_menu_items() or get_pages()
-   */
-  static registerWordPressMenu(menuItems: Array<{ title: string; url: string }>): number {
-    return this.registerManifest({
-      framework: "wordpress",
-      navMenuItems: menuItems.map((m) => ({ label: m.title, url: m.url })),
-    });
-  }
-
-  /**
-   * 3. Get all discovered seed public pages
-   */
-  static getSeedRoutes(): PublicRouteItem[] {
-    return Array.from(this.registeredRoutes.values());
-  }
-
-  /**
-   * 4. Retrieve single route details
-   */
-  static getRoute(pathOrSlug: string): PublicRouteItem | undefined {
-    return this.registeredRoutes.get(pathOrSlug);
-  }
-}

package/src/rag-knowledge-engine.ts

@@ -1,163 +0,0 @@
-/**
- * 🧠 LynxRAG Hybrid Knowledge Engine (Enterprise pgvector & Local In-Memory Semantic Index)
- * 
- * Provides unified RAG (Retrieval-Augmented Generation) capabilities:
- * 1. Ingests Company PDFs, Pitch Decks, Product Catalogs, and Brand Kits
- * 2. Chunks & stores semantic embeddings (pgvector compatible / in-memory cosine fallback)
- * 3. Enriches AI Copilot Audit Reports with genuine company facts & certifications
- * 4. Enriches Programmatic Pages with authentic proprietary statistics & guarantees
- */
-
-export interface KnowledgeChunk {
-  id: string;
-  documentName: string;
-  category: "pricing" | "technical" | "case_study" | "certification" | "general";
-  content: string;
-  embedding?: number[];
-  keywords: string[];
-  tokenCount: number;
-  createdAt: string;
-}
-
-export interface RagRetrievalResult {
-  chunk: KnowledgeChunk;
-  similarityScore: number;
-}
-
-export class LynxRagKnowledgeEngine {
-  private static chunkStore: Map<string, KnowledgeChunk[]> = new Map(); // Keyed by siteId / domain
-
-  /**
-   * 1. Ingest Raw Document Text (from PDF, Word doc, or manual upload)
-   */
-  static ingestDocument(
-    siteId: string,
-    documentName: string,
-    rawText: string,
-    category: KnowledgeChunk["category"] = "general"
-  ): KnowledgeChunk[] {
-    const cleanText = rawText.replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
-    const rawParagraphs = cleanText.split("\n\n").filter((p) => p.trim().length > 30);
-
-    const siteChunks = this.chunkStore.get(siteId) || [];
-    const newChunks: KnowledgeChunk[] = [];
-
-    rawParagraphs.forEach((para, index) => {
-      const words = para.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, "").split(/\s+/).filter(Boolean);
-      const uniqueKeywords = Array.from(new Set(words)).slice(0, 15);
-
-      const chunk: KnowledgeChunk = {
-        id: `chk_${siteId}_${Date.now()}_${index}`,
-        documentName,
-        category,
-        content: para.trim(),
-        keywords: uniqueKeywords,
-        tokenCount: Math.round(para.length / 4),
-        createdAt: new Date().toISOString(),
-      };
-
-      siteChunks.push(chunk);
-      newChunks.push(chunk);
-    });
-
-    this.chunkStore.set(siteId, siteChunks);
-    return newChunks;
-  }
-
-  /**
-   * 2. Semantic Search & Top-K Chunks Retrieval (Fast In-Memory Cosine / Keyword Scoring)
-   */
-  static retrieveRelevantContext(
-    siteId: string,
-    query: string,
-    topK: number = 3
-  ): RagRetrievalResult[] {
-    const chunks = this.chunkStore.get(siteId) || [];
-    if (chunks.length === 0) return [];
-
-    const queryTerms = query.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, "").split(/\s+/).filter(Boolean);
-
-    const scored = chunks.map((chunk) => {
-      let score = 0;
-      const lowerContent = chunk.content.toLowerCase();
-
-      for (const term of queryTerms) {
-        if (lowerContent.includes(term)) {
-          score += 2.0;
-        }
-        if (chunk.keywords.includes(term)) {
-          score += 1.5;
-        }
-      }
-
-      // Bonus for rich numerical / factual data
-      if (/\d+[\s%€$]/.test(chunk.content)) {
-        score += 1.0;
-      }
-
-      return {
-        chunk,
-        similarityScore: score / (queryTerms.length || 1),
-      };
-    });
-
-    return scored
-      .filter((s) => s.similarityScore > 0.3)
-      .sort((a, b) => b.similarityScore - a.similarityScore)
-      .slice(0, topK);
-  }
-
-  /**
-   * 3. AI Audit Report Enhancer (Injects Company Facts into AI Reports)
-   */
-  static enrichAiReportPrompt(
-    siteId: string,
-    reportTopic: string,
-    baseAuditMetrics: Record<string, unknown>
-  ): { enrichedSystemPrompt: string; retrievedFacts: string[] } {
-    const relevantChunks = this.retrieveRelevantContext(siteId, reportTopic, 4);
-    const retrievedFacts = relevantChunks.map((r) => r.chunk.content);
-
-    const factsFormatted = retrievedFacts.length > 0
-      ? `\n\n### 🏢 DONNÉES ET FAITS PROPRIÉTAIRES DE L'ENTREPRISE (RAG):\n${retrievedFacts.map((f, i) => `${i + 1}. ${f}`).join("\n")}`
-      : "";
-
-    const enrichedSystemPrompt = `
-Vous êtes l'Auditeur SEO & IA Copilot de LynxSEO Studio.
-Vous analysez les métriques techniques suivantes : ${JSON.stringify(baseAuditMetrics)}.${factsFormatted}
-
-Directives d'analyse :
-- Personnalisez vos recommandations en tenant compte des faits propriétaires et certifications réelles de l'entreprise.
-- Ne proposez que des plans d'action immédiatement applicables et mesurables.
-`.trim();
-
-    return {
-      enrichedSystemPrompt,
-      retrievedFacts,
-    };
-  }
-
-  /**
-   * 4. Programmatic Page Generator Enhancer (Injects Company Facts into Programmatic Pages)
-   */
-  static getFactsForPageGeneration(
-    siteId: string,
-    service: string,
-    location: string
-  ): string[] {
-    const query = `${service} ${location} tarifs garantie certification delai`;
-    const results = this.retrieveRelevantContext(siteId, query, 3);
-    return results.map((r) => r.chunk.content);
-  }
-
-  /**
-   * 5. Clear or Get All Ingested Chunks for Site
-   */
-  static getSiteChunks(siteId: string): KnowledgeChunk[] {
-    return this.chunkStore.get(siteId) || [];
-  }
-
-  static clearSiteChunks(siteId: string): void {
-    this.chunkStore.delete(siteId);
-  }
-}