fodda-mcp 1.32.1 → 1.46.31

package/dist/catalogCache.d.ts

@@ -48,12 +48,23 @@ export interface CatalogAnalyst {
     analyst_id: string;
     name: string;
     description: string;
+    type?: string;
+    agent_type?: string;
+    kind?: string;
+    is_digital_twin?: boolean;
+    is_human_agent?: boolean;
+    consult_tool?: string;
+    price?: string;
+    offerings?: any[];
+    status?: string;
+    Status?: string;
 }
 /**
  * Initialize the catalog cache. Call once at server startup.
  * Fetches immediately, then sets up hourly refresh.
  */
 export declare function initCatalogCache(): Promise<void>;
+export declare function setCachedCatalogForTesting(catalog: CatalogResponse, analysts?: CatalogAnalyst[]): void;
 /**
  * Get the cached catalog. Returns null if not yet fetched.
  */
@@ -66,9 +77,7 @@ export declare function getAnalysts(): CatalogAnalyst[];
  * Get all graphs from the cached catalog.
  */
 export declare function getGraphs(): CatalogGraph[];
-/**
- * Get only graphs with status === 'live'.
- */
+export declare function getGraphDetails(graphId: string): CatalogGraph | undefined;
 export declare function getLiveGraphs(): CatalogGraph[];
 /**
  * Get domain/curated graphs (graph_type === 'domain').
@@ -138,16 +147,6 @@ export declare function buildCuratedOnlyToolsBlock(): string;
  * to inject into the system prompt, replacing the hardcoded blocks.
  */
 export declare function buildDynamicPromptSections(): string | null;
-/**
- * Score how relevant a graph is to a query.
- * Returns a 0-1 score based on keyword overlap between query terms and graph metadata.
- *
- * Scoring strategy:
- *  - Each query term that appears in the graph's searchable text adds to the score
- *  - Matches in topics/routing_keywords are weighted higher (2x) than description matches
- *  - Living graphs get a modest freshness boost (+0.05)
- *  - Brand-name queries (single capitalized word) always include domain graphs
- */
 export declare function scoreGraphRelevance(query: string, g: CatalogGraph): number;
 /**
  * Classify a graph into its operational tier based on type + update cadence.
@@ -159,6 +158,7 @@ export interface GraphRelevanceResult {
     graph: CatalogGraph;
     score: number;
     graphTier: 'living' | 'static_expert' | 'report' | 'supplemental' | 'skill';
+    isDirectMatch: boolean;
 }
 /**
  * Get the graphs most relevant to a query, using 2-step routing:
@@ -194,6 +194,7 @@ export type SourceCandidate = {
     score: number;
     reason: string;
 };
+export declare function flushSourcePlanCache(): void;
 /**
  * Unified source selector: graph candidates from getRelevantGraphs()
  * (UNCHANGED — same scoring, tier diversity, freshness bonus, same order),

package/dist/catalogCache.d.ts.map

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

package/dist/catalogCache.js

@@ -6,6 +6,7 @@
  * and is the same endpoint the website and app use.
  */
 import axios from 'axios';
+import { cacheClear } from './queryCache.js';
 // ---------------------------------------------------------------------------
 // Cache
 // ---------------------------------------------------------------------------
@@ -51,6 +52,7 @@ async function fetchAnalysts() {
  */
 export async function initCatalogCache() {
     try {
+        cacheClear();
         cachedCatalog = await fetchCatalog();
         cachedAnalysts = await fetchAnalysts();
         lastFetchedAt = Date.now();
@@ -77,6 +79,13 @@ export async function initCatalogCache() {
         }
     }, CATALOG_REFRESH_MS);
 }
+export function setCachedCatalogForTesting(catalog, analysts) {
+    cachedCatalog = catalog;
+    if (analysts)
+        cachedAnalysts = analysts;
+    lastFetchedAt = Date.now();
+    rebuildSearchIndex();
+}
 /**
  * Get the cached catalog. Returns null if not yet fetched.
  */
@@ -93,11 +102,11 @@ export function getAnalysts() {
  * Get all graphs from the cached catalog.
  */
 export function getGraphs() {
-    return cachedCatalog?.graphs ?? [];
+    return cachedCatalog?.graphs || [];
+}
+export function getGraphDetails(graphId) {
+    return getGraphs().find(g => g.graph_id === graphId);
 }
-/**
- * Get only graphs with status === 'live'.
- */
 export function getLiveGraphs() {
     return getGraphs().filter(g => g.status === 'live');
 }
@@ -152,20 +161,7 @@ export function getDomainGraphIds() {
  * Generates: - graphId "retail" → "PSFK's Retail Graph"
  */
 export function buildGraphNamingBlock() {
-    const graphs = getLiveGraphs();
-    if (graphs.length === 0)
-        return ''; // fallback — will use hardcoded
-    const lines = [];
-    lines.push('GRAPH NAMING: Never call results "the Fodda graph." Fodda is the platform — the knowledge graphs are created by named experts. Always attribute to the expert:');
-    for (const g of graphs) {
-        const displayName = buildDisplayName(g);
-        const domainHint = g.domain ? ` (${g.domain})` : '';
-        lines.push(`- graphId "${g.graph_id}" → "${displayName}"${domainHint}`);
-    }
-    lines.push('Example: "PSFK\'s Retail Graph identifies Retailer-Operated Value-Recovery Programs as a top signal (score: 100)" — NOT "the Fodda graph shows..."');
-    lines.push('Fodda is the delivery mechanism. The experts are the authority.');
-    lines.push('When presenting results from community Pattern Graphs, use the creator\'s name in attribution (e.g., "According to [creator]\'s [Graph Name] Pattern Graph on Fodda...").');
-    return lines.join('\n');
+    return 'GRAPH NAMING: Never call results "the Fodda graph." Fodda is the platform — knowledge graphs are created by named experts. Always attribute each graph to its named expert; call `list_graphs` for graph names, curators, and domain details. Example: "PSFK\'s Retail Graph identifies Retailer-Operated Value-Recovery Programs as a top signal (score: 100)" — NOT "the Fodda graph shows..."';
 }
 /**
  * Build a human-friendly display name for a graph.
@@ -517,6 +513,7 @@ let graphSearchTexts = new Map();
  */
 function rebuildSearchIndex() {
     graphSearchTexts.clear();
+    flushSourcePlanCache();
     for (const g of getGraphs()) {
         graphSearchTexts.set(g.graph_id, buildSearchableText(g));
     }
@@ -531,47 +528,187 @@ function rebuildSearchIndex() {
  *  - Living graphs get a modest freshness boost (+0.05)
  *  - Brand-name queries (single capitalized word) always include domain graphs
  */
-export function scoreGraphRelevance(query, g) {
-    const queryLower = query.toLowerCase();
-    // Stopwords that shouldn't contribute to routing relevance
+const QUERY_EXPANSION_MAP = {
+    // Wine & Beverages
+    wine: ['beverage', 'drink', 'food', 'hospitality', 'dining', 'nightlife', 'leisure', 'entertainment', 'luxury', 'home', 'appliances', 'kitchen', 'dining', 'cpg', 'retail'],
+    beverage: ['beverage', 'food', 'drink', 'cpg', 'retail', 'hospitality', 'dining', 'nightlife'],
+    beverages: ['beverage', 'food', 'drink', 'cpg', 'retail', 'hospitality', 'dining', 'nightlife'],
+    drinks: ['beverage', 'drink', 'food', 'cpg', 'retail', 'nightlife', 'hospitality'],
+    drink: ['beverage', 'drink', 'food', 'cpg', 'retail', 'nightlife', 'hospitality'],
+    mocktail: ['beverage', 'drink', 'food', 'hospitality', 'dining', 'nightlife', 'wellness'],
+    mocktails: ['beverage', 'drink', 'food', 'hospitality', 'dining', 'nightlife', 'wellness'],
+    vin: ['beverage', 'food', 'hospitality', 'dining'],
+    sommelier: ['beverage', 'food', 'hospitality', 'dining', 'nightlife'],
+    beer: ['beverage', 'drink', 'food', 'hospitality', 'nightlife', 'cpg'],
+    spirits: ['beverage', 'drink', 'food', 'hospitality', 'nightlife', 'luxury', 'cpg'],
+    cocktail: ['beverage', 'drink', 'food', 'hospitality', 'dining', 'nightlife'],
+    barware: ['beverage', 'home', 'appliances', 'dining', 'nightlife', 'tableware', 'retail'],
+    glassware: ['home', 'dining', 'beverage', 'design', 'nightlife', 'tableware', 'barware', 'retail'],
+    stemware: ['home', 'dining', 'beverage', 'design', 'luxury', 'tableware', 'barware', 'retail'],
+    decanter: ['home', 'dining', 'beverage', 'luxury', 'design', 'barware', 'tableware'],
+    fridge: ['appliances', 'home', 'kitchen', 'electronics', 'consumer-electronics', 'retail'],
+    fridges: ['appliances', 'home', 'kitchen', 'electronics', 'consumer-electronics', 'retail'],
+    refrigerator: ['appliances', 'home', 'kitchen', 'electronics', 'consumer-electronics', 'retail'],
+    cooler: ['appliances', 'home', 'kitchen', 'electronics', 'beverage', 'cooling', 'retail'],
+    coolers: ['appliances', 'home', 'kitchen', 'electronics', 'beverage', 'cooling', 'retail'],
+    cellar: ['home', 'luxury', 'architecture', 'design', 'interior', 'wine'],
+    cabinet: ['furniture', 'home', 'interior', 'design', 'decor', 'storage'],
+    furniture: ['home', 'design', 'living', 'decor', 'interior', 'retail'],
+    racking: ['home', 'design', 'storage'],
+    accessories: ['consumer-goods', 'home', 'retail', 'products', 'design'],
+    // Food & Dining
+    restaurant: ['food', 'beverage', 'dining', 'hospitality', 'nightlife'],
+    dining: ['food', 'beverage', 'hospitality', 'restaurant', 'dining-trends', 'nightlife', 'home'],
+    kitchen: ['home', 'appliances', 'food', 'design'],
+    // Home & Living
+    lighting: ['home', 'design', 'decor'],
+    decor: ['home', 'design', 'living'],
+    appliance: ['appliances', 'home', 'kitchen', 'consumer-electronics', 'retail'],
+    appliances: ['appliances', 'home', 'kitchen', 'consumer-electronics', 'retail'],
+    // Fashion & Apparel
+    sneakers: ['fashion', 'apparel', 'footwear', 'streetwear', 'retail'],
+    footwear: ['fashion', 'apparel', 'retail'],
+    clothing: ['fashion', 'apparel', 'retail'],
+    apparel: ['fashion', 'retail'],
+    // Beauty & Skincare
+    skincare: ['beauty', 'wellness', 'cpg', 'retail'],
+    cosmetics: ['beauty', 'cpg', 'retail'],
+    fragrance: ['beauty', 'luxury', 'cpg', 'retail'],
+    // Tech & Electronics
+    smartphone: ['technology', 'electronics', 'consumer-electronics', 'retail'],
+    gadget: ['technology', 'electronics', 'consumer-electronics'],
+    // Luxury & Travel
+    watch: ['luxury', 'fashion', 'retail'],
+    watches: ['luxury', 'fashion', 'retail'],
+    jewelry: ['luxury', 'fashion', 'retail'],
+    // Automotive & Mobility
+    ev: ['automotive', 'mobility', 'transportation', 'energy', 'sustainability', 'technology'],
+    electric: ['automotive', 'mobility', 'energy', 'sustainability', 'technology'],
+    automotive: ['automotive', 'mobility', 'transportation', 'manufacturing'],
+    car: ['automotive', 'mobility', 'transportation'],
+    cars: ['automotive', 'mobility', 'transportation'],
+    vehicle: ['automotive', 'mobility', 'transportation'],
+    vehicles: ['automotive', 'mobility', 'transportation'],
+    // Pet & Animal Care
+    pet: ['pet', 'cpg', 'food', 'wellness', 'retail'],
+    pets: ['pet', 'cpg', 'food', 'wellness', 'retail'],
+    dog: ['pet', 'cpg', 'food', 'wellness'],
+    cat: ['pet', 'cpg', 'food', 'wellness'],
+    // Tech, AI & SaaS
+    ai: ['technology', 'ai', 'software', 'enterprise', 'innovation'],
+    saas: ['technology', 'software', 'enterprise', 'b2b'],
+    software: ['technology', 'software', 'enterprise', 'b2b'],
+    cloud: ['technology', 'enterprise', 'software'],
+    cybersecurity: ['technology', 'enterprise', 'security'],
+};
+function scoreClauseRelevance(clause, g) {
+    const clauseLower = clause.toLowerCase().trim();
+    if (!clauseLower)
+        return 0;
     const stopWords = new Set([
         'trend', 'trends', 'consumer', 'consumers', 'report', 'reports',
         'industry', 'data', 'future', 'insight', 'insights', 'analysis',
-        'what', 'how', 'why', 'who', 'when', 'where', 'are', 'the', 'and', 'for', 'with'
+        'what', 'how', 'why', 'who', 'when', 'where', 'are', 'the', 'and', 'for', 'with',
+        'run', 'fodda', 'deep', 'research', 'project', 'about', 'session', 'briefing',
+        'brief', 'study', 'overview', 'summary', 'deck', 'slides', 'presentation', 'topic',
+        '2024', '2025', '2026', '2027', '2030', 'year', 'years', 'strategic', 'breakdown',
+        'give', 'provide', 'show', 'tell', 'key'
     ]);
-    const queryTerms = queryLower
+    const terms = clauseLower
         .split(/\s+/)
-        .filter(t => t.length > 2) // Skip very short words (a, in, of, etc.)
-        .map(t => t.replace(/[^a-z0-9]/g, '')) // Strip punctuation
+        .map(t => t.replace(/[^a-z0-9]/g, ''))
         .filter(t => t.length > 2 && !stopWords.has(t));
-    if (queryTerms.length === 0)
+    if (terms.length === 0)
         return 0;
     const searchText = graphSearchTexts.get(g.graph_id) || buildSearchableText(g);
-    const topicsText = [...(g.topics || []), ...(g.routing_keywords || [])].join(' ').toLowerCase();
+    const topicsText = [...(g.topics || []), ...(g.routing_keywords || []), g.name || '', g.graph_id || ''].join(' ').toLowerCase();
     const domainText = (g.domain || '').toLowerCase();
     let matchedTerms = 0;
     let highValueMatches = 0;
-    for (const term of queryTerms) {
+    for (const term of terms) {
         if (searchText.includes(term)) {
             matchedTerms++;
-            // High-value match: the term appears in topics, routing_keywords, or domain
             if (topicsText.includes(term) || domainText.includes(term)) {
                 highValueMatches++;
             }
         }
     }
-    if (matchedTerms === 0)
-        return 0;
-    // Base score: fraction of query terms that match
-    let score = matchedTerms / queryTerms.length;
-    // Boost for high-value matches (topics/domain/routing)
-    score += (highValueMatches / queryTerms.length) * 0.3;
-    // Living graphs (any type with recurring updates) get a modest freshness boost
-    const isLiving = g.update_frequency && !['One-Off', 'Coming Soon'].includes(g.update_frequency);
-    if (isLiving) {
-        score += 0.05; // Freshness tiebreaker, not an inclusion floor
+    let directScore = 0;
+    if (matchedTerms > 0) {
+        directScore = (matchedTerms / terms.length) * 0.6 + (highValueMatches / terms.length) * 0.5;
+    }
+    // Category Expansion Score
+    let expansionScore = 0;
+    const expandedSet = new Set();
+    for (const t of terms) {
+        if (QUERY_EXPANSION_MAP[t]) {
+            QUERY_EXPANSION_MAP[t].forEach(e => expandedSet.add(e));
+        }
+    }
+    if (expandedSet.size > 0) {
+        let expMatches = 0;
+        let expHighValueMatches = 0;
+        for (const exp of expandedSet) {
+            if (searchText.includes(exp)) {
+                expMatches++;
+                if (topicsText.includes(exp) || domainText.includes(exp)) {
+                    expHighValueMatches++;
+                }
+            }
+        }
+        if (expMatches > 0) {
+            expansionScore = 0.20 + 0.20 * Math.min(expMatches / 3, 1.0) + 0.15 * Math.min(expHighValueMatches / 2, 1.0);
+        }
+    }
+    let finalScore = Math.max(directScore, expansionScore);
+    // Flagship retail graph anchor boost
+    if (g.graph_id === 'retail') {
+        finalScore += 0.30;
     }
-    return Math.min(score, 1.0);
+    // Topic Specialist Boost: if graph's explicit topics, name or routing keywords match query terms directly
+    if (highValueMatches > 0) {
+        finalScore += 0.10;
+    }
+    // Specialist Category Boost & Generic Agency Cap
+    const specialistProductTerms = new Set([
+        'fridge', 'fridges', 'refrigerator', 'cooler', 'coolers', 'cellar', 'cabinet',
+        'furniture', 'glassware', 'stemware', 'decanter', 'appliance', 'appliances',
+        'barware', 'tableware', 'racking', 'kitchen', 'lighting', 'decor'
+    ]);
+    const queryHasSpecialistProduct = terms.some(t => specialistProductTerms.has(t));
+    if (queryHasSpecialistProduct) {
+        const isGenericAgency = /bcg|dentsu|ecdb|kpmg|postpals|greenhouse|michaels|agency|consulting/i.test(g.graph_id + ' ' + (g.domain || ''));
+        const isSpecialistGraph = !isGenericAgency && /home|living|interior|decor|appliances?|kitchen|dining|beverage|food|hospitality|leisure/i.test(g.graph_id + ' ' + (g.domain || '') + ' ' + (g.topics || []).join(' ') + ' ' + (g.routing_keywords || []).join(' '));
+        if (isSpecialistGraph || g.graph_id === 'retail') {
+            finalScore += 0.20; // Specialist Category Boost
+        }
+        else if (isGenericAgency && directScore === 0) {
+            finalScore = Math.min(finalScore, 0.40); // Cap generic agency floor
+        }
+    }
+    // Generalized Narrow-Domain Mismatch Penalty
+    const narrowDomains = ['beauty', 'gaming', 'automotive', 'fashion'];
+    for (const dom of narrowDomains) {
+        const isNarrowGraph = (g.graph_id + (g.domain || '')).toLowerCase().includes(dom);
+        const queryHasDom = terms.some(t => t.includes(dom) || (QUERY_EXPANSION_MAP[t] && QUERY_EXPANSION_MAP[t].includes(dom)));
+        if (isNarrowGraph && !queryHasDom) {
+            finalScore -= 0.30;
+            break;
+        }
+    }
+    return Math.max(0, Math.min(finalScore, 1.0));
+}
+export function scoreGraphRelevance(query, g) {
+    const clauses = query
+        .split(/[,;\.\n]| and | with | for | about /i)
+        .map(c => c.trim())
+        .filter(c => c.length > 2);
+    if (clauses.length === 0)
+        return scoreClauseRelevance(query, g);
+    const scores = clauses.map(c => scoreClauseRelevance(c, g));
+    const maxScore = Math.max(...scores);
+    const avgScore = scores.reduce((a, b) => a + b, 0) / scores.length;
+    return Math.min((maxScore * 0.7) + (avgScore * 0.3), 1.0);
 }
 /**
  * Classify a graph into its operational tier based on type + update cadence.
@@ -586,10 +723,11 @@ export function classifyGraphTier(g) {
     const isRecurring = g.update_frequency &&
         !['One-Off', 'Coming Soon'].includes(g.update_frequency);
     // Domain graphs with recurring updates + experts with recurring updates = Living
-    if ((g.graph_type === 'domain' || g.graph_type === 'expert') && isRecurring) {
+    // ('analyst' = expert graphs typed 'analyst' in the registry, e.g. Digital Twins)
+    if ((g.graph_type === 'domain' || g.graph_type === 'expert' || g.graph_type === 'analyst') && isRecurring) {
         return 'living';
     }
-    if (g.graph_type === 'expert')
+    if (g.graph_type === 'expert' || g.graph_type === 'analyst')
         return 'static_expert';
     if (g.graph_type === 'industry report')
         return 'report';
@@ -610,8 +748,18 @@ export function classifyGraphTier(g) {
  */
 export function getRelevantGraphs(query, minGraphs = 4, maxGraphs = 15, threshold = 0.10) {
     const DEPRECATED_GRAPH_IDS = new Set(['waldo', 'psfk']);
-    const allGraphs = getLiveGraphs().filter(g => (g.graph_type === 'domain' || g.graph_type === 'expert' || g.graph_type === 'industry report')
-        && !DEPRECATED_GRAPH_IDS.has(g.graph_id));
+    // 'analyst' graphs (e.g. Digital Twin expert graphs typed 'analyst' in the
+    // registry) are searchable expert content — excluding them made registry-live
+    // graphs like jeff-longevity invisible to routing (QA 2026-08-20).
+    const ROUTABLE_TYPES = new Set(['domain', 'expert', 'industry report', 'analyst']);
+    const allLive = getLiveGraphs();
+    const allGraphs = allLive.filter(g => ROUTABLE_TYPES.has(g.graph_type) && !DEPRECATED_GRAPH_IDS.has(g.graph_id));
+    // Registry-status visibility: surface live graphs excluded from routing by
+    // type, so an unroutable analyst/expert graph is detectable in logs.
+    const typeExcluded = allLive.filter(g => !ROUTABLE_TYPES.has(g.graph_type) && g.graph_type !== 'supplemental' && g.graph_type !== 'skill');
+    if (typeExcluded.length > 0) {
+        console.error(`[graphRouter] ${typeExcluded.length} live graph(s) excluded by graph_type: ${typeExcluded.map(g => `${g.graph_id}(${g.graph_type})`).join(', ')}`);
+    }
     if (allGraphs.length === 0)
         return [];
     // Runtime check: skip graphs that have no synced content in Neo4j.
@@ -620,45 +768,62 @@ export function getRelevantGraphs(query, minGraphs = 4, maxGraphs = 15, threshol
     // Once the CE pipeline syncs them, they'll automatically start routing.
     const hasContent = (g) => (g.trend_count > 0) || (g.last_synced !== null && g.last_synced !== undefined);
     const syncedGraphs = allGraphs.filter(hasContent);
-    const skippedShells = allGraphs.length - syncedGraphs.length;
+    const shellGraphs = allGraphs.filter(g => !hasContent(g));
+    const skippedShells = shellGraphs.length;
     if (skippedShells > 0) {
-        console.error(`[graphRouter] Skipped ${skippedShells} unsynced graph shell(s) (trend_count=0, last_synced=null)`);
+        console.error(`[graphRouter] Skipped ${skippedShells} unsynced graph shell(s) (trend_count=0, last_synced=null): ${shellGraphs.map(g => g.graph_id).join(', ')}`);
     }
     // ── Phase 0: Direct name matching ──
-    // When users explicitly name a graph, curator, or company (e.g. "Pull from
-    // TBWA/Alyson Stevens Macro, SIC (Ben Dietz), Marieke Neleman..."), keyword
-    // scoring dilutes these names across 100+ query terms, dropping them below
-    // the threshold. Direct matches get automatic inclusion at score 1.0.
     const queryLower = query.toLowerCase();
     const directMatchIds = new Set();
+    const matchesWordBoundary = (text, term) => {
+        if (!term || term.length < 3)
+            return false;
+        // Ignore generic topic/format words from forcing Phase 0 direct inclusion
+        const genericNames = new Set([
+            'trends', 'report', 'graph', 'data', '2026', 'state', 'outlook',
+            'beauty', 'food', 'home', 'retail', 'fashion', 'travel', 'design'
+        ]);
+        if (genericNames.has(term.toLowerCase()))
+            return false;
+        const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const rx = new RegExp(`\\b${escaped}\\b`, 'i');
+        return rx.test(text);
+    };
     for (const g of syncedGraphs) {
         // Check graph_id (e.g., "alyson-stevens-macro", "sic")
-        if (queryLower.includes(g.graph_id)) {
+        if (g.graph_id.length > 3 && matchesWordBoundary(queryLower, g.graph_id)) {
             directMatchIds.add(g.graph_id);
             continue;
         }
         // Check curator full name (e.g., "Alyson Stevens", "Ben Dietz")
-        const curatorLower = (g.curator || '').toLowerCase();
-        if (curatorLower && curatorLower.length > 3 && queryLower.includes(curatorLower)) {
+        const curatorLower = (g.curator || '').trim().toLowerCase();
+        if (curatorLower && curatorLower.length > 4 && matchesWordBoundary(queryLower, curatorLower)) {
             directMatchIds.add(g.graph_id);
             continue;
         }
         // Check curator last name (>3 chars to avoid false positives like "AI", "NIQ")
         const curatorParts = curatorLower.split(/\s+/);
         const curatorLastName = curatorParts[curatorParts.length - 1];
-        if (curatorLastName && curatorLastName.length > 3 && queryLower.includes(curatorLastName)) {
+        if (curatorLastName && curatorLastName.length > 3 && matchesWordBoundary(queryLower, curatorLastName)) {
             directMatchIds.add(g.graph_id);
             continue;
         }
         // Check company name (e.g., "TBWA", "Delta", "Havas", "Kantar")
-        const companyLower = (g.company || '').toLowerCase();
-        if (companyLower && companyLower.length > 2 && queryLower.includes(companyLower)) {
+        // Skip generic publisher/consultancy names so mentioning a firm doesn't force all its graphs
+        const companyLower = (g.company || '').trim().toLowerCase();
+        const genericPublishers = new Set([
+            'mckinsey', 'bcg', 'deloitte', 'kpmg', 'forrester', 'gartner',
+            'pwc', 'ey', 'capgemini', 'bain', 'niq', 'mintel', 'dentsu',
+            'accenture', 'youtube', 'google', 'microsoft'
+        ]);
+        if (companyLower && companyLower.length > 3 && !genericPublishers.has(companyLower) && matchesWordBoundary(queryLower, companyLower)) {
             directMatchIds.add(g.graph_id);
             continue;
         }
         // Check graph name (e.g., "SIC", "Connection Index")
-        const nameLower = (g.name || '').toLowerCase();
-        if (nameLower && nameLower.length > 3 && queryLower.includes(nameLower)) {
+        const nameLower = (g.name || '').trim().toLowerCase();
+        if (nameLower && nameLower.length > 3 && matchesWordBoundary(queryLower, nameLower)) {
             directMatchIds.add(g.graph_id);
             continue;
         }
@@ -667,11 +832,15 @@ export function getRelevantGraphs(query, minGraphs = 4, maxGraphs = 15, threshol
         console.error(`[graphRouter] Phase 0 direct name matches: ${[...directMatchIds].join(', ')}`);
     }
     // Score ALL graph types together — domain, expert, industry report compete on merit
-    const scored = syncedGraphs.map(g => ({
-        graph: g,
-        score: directMatchIds.has(g.graph_id) ? 1.0 : scoreGraphRelevance(query, g),
-        graphTier: classifyGraphTier(g),
-    }));
+    const scored = syncedGraphs.map(g => {
+        const isDirect = directMatchIds.has(g.graph_id);
+        return {
+            graph: g,
+            score: isDirect ? 1.0 : scoreGraphRelevance(query, g),
+            graphTier: classifyGraphTier(g),
+            isDirectMatch: isDirect,
+        };
+    });
     // Sort by score descending
     scored.sort((a, b) => b.score - a.score);
     // Take all above threshold, respecting min/max bounds
@@ -700,8 +869,22 @@ export function getRelevantGraphs(query, minGraphs = 4, maxGraphs = 15, threshol
             results.push(best);
         }
     };
+    ensureTierPresent('living');
     ensureTierPresent('report');
     ensureTierPresent('static_expert');
+    const stopWords = new Set([
+        'trend', 'trends', 'consumer', 'consumers', 'report', 'reports',
+        'industry', 'data', 'future', 'insight', 'insights', 'analysis',
+        'what', 'how', 'why', 'who', 'when', 'where', 'are', 'the', 'and', 'for', 'with',
+        'run', 'fodda', 'deep', 'research', 'project', 'about', 'session', 'briefing',
+        'brief', 'study', 'overview', 'summary', 'deck', 'slides', 'presentation', 'topic',
+        '2024', '2025', '2026', '2027', '2030', 'year', 'years', 'strategic', 'breakdown',
+        'give', 'provide', 'show', 'tell', 'key'
+    ]);
+    const debugTokens = query.toLowerCase().split(/\s+/).map(t => t.replace(/[^a-z0-9]/g, '')).filter(t => t.length > 2 && !stopWords.has(t));
+    const debugExpansions = new Set();
+    debugTokens.forEach(t => (QUERY_EXPANSION_MAP[t] || []).forEach(e => debugExpansions.add(e)));
+    console.error(`[graphRouter] Extracted tokens: [${debugTokens.join(', ')}] | Fired expansions: [${Array.from(debugExpansions).join(', ')}]`);
     console.error(`[graphRouter] Query: "${query.substring(0, 60)}..." → ${results.length}/${syncedGraphs.length} synced graphs selected (${skippedShells} shells skipped): ${results.map(r => `${r.graph.graph_id}(${r.score.toFixed(2)},${r.graphTier})`).join(', ')}`);
     return results;
 }
@@ -743,11 +926,12 @@ const EARNINGS_SECTORS = ['retail', 'technology', 'travel', 'hospitality', 'luxu
 // (economic indicators/FRED, demographic surveys/Census, trade data, food
 // economics + agricultural production, commodity pricing).
 const SUPPLEMENTAL_CATEGORY_KEYWORDS = {
-    macro: ['macro', 'economy', 'economic', 'inflation', 'gdp', 'interest rate', 'consumer confidence', 'consumer spending', 'recession', 'fred', 'cost of living', 'purchasing power', 'unemployment'],
-    demographics: ['demographic', 'demographics', 'population', 'census', 'household income', 'age distribution', 'migration'],
+    macro: ['macro', 'economy', 'economic', 'inflation', 'gdp', 'interest rate', 'consumer confidence', 'consumer sentiment', 'michigan sentiment', 'umcsent', 'consumer spending', 'recession', 'fred', 'cost of living', 'purchasing power', 'unemployment'],
+    demographics: ['demographic', 'demographics', 'population', 'census', 'household income', 'age distribution', 'migration', 'republican', 'democrat', 'bipartisan', 'party affiliation', 'pew', 'npors'],
     trade: ['imports', 'exports', 'trade data', 'trade flows', 'tariff', 'tariffs', 'supply chain'],
     food_economics: ['food prices', 'food costs', 'crop', 'agriculture', 'agricultural', 'nutrition', 'nutritional'],
     commodities: ['commodity', 'commodities', 'raw materials', 'wholesale prices'],
+    science: ['science', 'scientific', 'clinical', 'pubmed', 'openalex', 'clinical trials', 'dermatology', 'peer-reviewed', 'academic', 'study', 'studies', 'journal', 'biomedical'],
 };
 /**
  * Detect an earnings candidate for a query. Deterministic and conservative:
@@ -810,19 +994,33 @@ function detectSupplementalCandidates(query) {
     }
     return candidates;
 }
+const sourcePlanCache = new Map();
+const SOURCE_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+export function flushSourcePlanCache() {
+    sourcePlanCache.clear();
+    console.error('[catalogCache] Source plan cache flushed');
+}
 /**
  * Unified source selector: graph candidates from getRelevantGraphs()
  * (UNCHANGED — same scoring, tier diversity, freshness bonus, same order),
  * plus additive earnings/supplemental candidates appended after.
  */
 export function getRelevantSources(query, opts) {
-    const graphResults = getRelevantGraphs(query, opts?.minGraphs, opts?.maxGraphs, opts?.threshold);
+    const minGraphs = opts?.minGraphs ?? 2;
+    const maxGraphs = opts?.maxGraphs ?? 15;
+    const threshold = opts?.threshold ?? 0.10;
+    const cacheKey = `v1.35.2:${query.trim().toLowerCase()}:${minGraphs}:${maxGraphs}:${threshold}`;
+    const cached = sourcePlanCache.get(cacheKey);
+    if (cached && (Date.now() - cached.timestamp < SOURCE_CACHE_TTL_MS)) {
+        return cached.result;
+    }
+    const graphResults = getRelevantGraphs(query, minGraphs, maxGraphs, threshold);
     const candidates = graphResults.map(r => ({
         kind: 'graph',
         graphId: r.graph.graph_id,
         score: r.score,
         graphTier: r.graphTier,
-        reason: r.score >= 1.0 ? 'named directly in query' : `topic match (score ${r.score.toFixed(2)}, ${r.graphTier})`,
+        reason: r.isDirectMatch ? 'named directly in query' : `topic match (score ${r.score.toFixed(2)}, ${r.graphTier})`,
     }));
     const earnings = detectEarningsCandidate(query);
     if (earnings)
@@ -832,6 +1030,7 @@ export function getRelevantSources(query, opts) {
     if (extras.length > 0) {
         console.error(`[sourceRouter] Extra candidates appended: ${extras.map(c => c.kind === 'earnings' ? `earnings(${c.ticker || c.brand || c.sector || 'search'})` : `supplemental(${c.category})`).join(', ')}`);
     }
+    sourcePlanCache.set(cacheKey, { result: candidates, timestamp: Date.now() });
     return candidates;
 }
 //# sourceMappingURL=catalogCache.js.map