fodda-mcp 1.3.2 → 1.30.0

package/dist/queryCache.js

@@ -0,0 +1,194 @@
+/**
+ * Query-Result Cache — LRU in-memory cache for Fodda API responses.
+ *
+ * Eliminates redundant API calls when the same query is repeated within
+ * the TTL window. Keyed by method + path + body hash so identical
+ * requests always hit the same cache entry.
+ *
+ * TTL tiers:
+ *   - search results:    5 minutes  (graph data updates infrequently)
+ *   - supplemental data: 15 minutes (institutional sources change rarely)
+ *   - evidence/neighbors: 30 minutes (static once ingested)
+ *   - brand-intelligence: 5 minutes  (aggregated, same as search)
+ */
+import crypto from 'crypto';
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const MAX_ENTRIES = 500;
+/** TTL in milliseconds by path pattern. First match wins. */
+const TTL_RULES = [
+    { pattern: /\/evidence$/, ttlMs: 30 * 60 * 1000, label: 'evidence' },
+    { pattern: /\/neighbors$/, ttlMs: 30 * 60 * 1000, label: 'neighbors' },
+    { pattern: /\/supplemental\//, ttlMs: 15 * 60 * 1000, label: 'supplemental' },
+    { pattern: /\/brand-intelligence\//, ttlMs: 5 * 60 * 1000, label: 'brand-intelligence' },
+    { pattern: /\/search$/, ttlMs: 5 * 60 * 1000, label: 'search' },
+    { pattern: /\/label-values$/, ttlMs: 30 * 60 * 1000, label: 'label-values' },
+    { pattern: /\/adjacent$/, ttlMs: 15 * 60 * 1000, label: 'adjacent' },
+    { pattern: /\/overview$/, ttlMs: 5 * 60 * 1000, label: 'overview' },
+    { pattern: /\/statistics\/search$/, ttlMs: 10 * 60 * 1000, label: 'statistics' },
+    { pattern: /\/insights\/search$/, ttlMs: 10 * 60 * 1000, label: 'insights' },
+];
+/** Paths that should NEVER be cached (dynamic, auth-dependent, or side-effectful). */
+const UNCACHEABLE_PATTERNS = [
+    /\/v1\/graphs$/, // list_graphs — already cached by catalogCache
+    /\/widget\//, // widget serving
+    /\/register$/, // OAuth
+];
+// ---------------------------------------------------------------------------
+// Cache store
+// ---------------------------------------------------------------------------
+const cache = new Map();
+// Stats for monitoring
+let stats = {
+    hits: 0,
+    misses: 0,
+    evictions: 0,
+    stores: 0,
+};
+// ---------------------------------------------------------------------------
+// Key generation
+// ---------------------------------------------------------------------------
+/**
+ * Build a deterministic cache key from the request signature.
+ * Uses raw string for small payloads (< 200 chars) to avoid crypto overhead.
+ * Falls back to SHA-256 for large POST bodies where the raw key would be unwieldy.
+ */
+function buildCacheKey(method, path, body) {
+    const bodyStr = body ? JSON.stringify(body) : '';
+    const raw = `${method}:${path}:${bodyStr}`;
+    // Skip SHA-256 for small keys — most GET requests and light POST bodies
+    if (raw.length < 200)
+        return raw;
+    return crypto.createHash('sha256').update(raw).digest('hex');
+}
+// ---------------------------------------------------------------------------
+// TTL resolution
+// ---------------------------------------------------------------------------
+function resolveTTL(path) {
+    for (const rule of TTL_RULES) {
+        if (rule.pattern.test(path)) {
+            return { ttlMs: rule.ttlMs, label: rule.label };
+        }
+    }
+    return null; // No matching rule — don't cache
+}
+function isCacheable(path) {
+    if (UNCACHEABLE_PATTERNS.some(p => p.test(path)))
+        return false;
+    return resolveTTL(path) !== null;
+}
+// ---------------------------------------------------------------------------
+// LRU eviction
+// ---------------------------------------------------------------------------
+/**
+ * Evict the least-recently-accessed entry when cache is full.
+ * Also prunes expired entries opportunistically.
+ */
+function evictIfNeeded() {
+    const now = Date.now();
+    // First pass: prune expired entries
+    for (const [key, entry] of cache) {
+        if (now - entry.createdAt > entry.ttlMs) {
+            cache.delete(key);
+            stats.evictions++;
+        }
+    }
+    // If still over limit, evict LRU
+    while (cache.size >= MAX_ENTRIES) {
+        let oldestKey = null;
+        let oldestAccess = Infinity;
+        for (const [key, entry] of cache) {
+            if (entry.lastAccessedAt < oldestAccess) {
+                oldestAccess = entry.lastAccessedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            cache.delete(oldestKey);
+            stats.evictions++;
+        }
+        else {
+            break;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Look up a cached response. Returns the cached data or null if miss/expired.
+ */
+export function cacheGet(method, path, body) {
+    if (!isCacheable(path))
+        return null;
+    const key = buildCacheKey(method, path, body);
+    const entry = cache.get(key);
+    if (!entry) {
+        stats.misses++;
+        return null;
+    }
+    // Check TTL
+    if (Date.now() - entry.createdAt > entry.ttlMs) {
+        cache.delete(key);
+        stats.misses++;
+        return null;
+    }
+    // Cache hit
+    entry.hitCount++;
+    entry.lastAccessedAt = Date.now();
+    stats.hits++;
+    console.error(`[queryCache] HIT (${entry.label}) ${method} ${path} — hit #${entry.hitCount}, age ${Math.round((Date.now() - entry.createdAt) / 1000)}s`);
+    return entry.data;
+}
+/**
+ * Store a response in the cache.
+ */
+export function cacheSet(method, path, body, data) {
+    if (!isCacheable(path))
+        return;
+    const ttlInfo = resolveTTL(path);
+    if (!ttlInfo)
+        return;
+    evictIfNeeded();
+    const key = buildCacheKey(method, path, body);
+    const now = Date.now();
+    cache.set(key, {
+        data,
+        createdAt: now,
+        ttlMs: ttlInfo.ttlMs,
+        label: ttlInfo.label,
+        hitCount: 0,
+        lastAccessedAt: now,
+    });
+    stats.stores++;
+    console.error(`[queryCache] STORE (${ttlInfo.label}) ${method} ${path} — TTL ${Math.round(ttlInfo.ttlMs / 1000)}s, cache size: ${cache.size}`);
+}
+/**
+ * Get cache statistics for monitoring/logging.
+ */
+export function getCacheStats() {
+    const entriesByType = {};
+    for (const entry of cache.values()) {
+        entriesByType[entry.label] = (entriesByType[entry.label] || 0) + 1;
+    }
+    const total = stats.hits + stats.misses;
+    return {
+        size: cache.size,
+        hits: stats.hits,
+        misses: stats.misses,
+        evictions: stats.evictions,
+        stores: stats.stores,
+        hitRate: total > 0 ? `${Math.round((stats.hits / total) * 100)}%` : '0%',
+        entriesByType,
+    };
+}
+/**
+ * Clear all cache entries. Useful for testing or manual reset.
+ */
+export function clearCache() {
+    cache.clear();
+    stats = { hits: 0, misses: 0, evictions: 0, stores: 0 };
+    console.error('[queryCache] Cache cleared');
+}
+//# sourceMappingURL=queryCache.js.map

package/dist/queryCache.js.map

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

package/dist/searchTemplate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Search Results Widget Template
+ *
+ * Server-side rendering for search_graph responses.
+ * Tabs: Trends, Companies, Market, Analysis
+ * Returns near-complete HTML with editorial slots for Claude.
+ */
+export declare function renderSearchWidget(data: any, query: string, graphName?: string, supplemental?: {
+    google_trends?: any;
+    census_retail?: any;
+}): Promise<{
+    widget_html: string;
+    editorial_instruction: string;
+    open_slots: string[];
+}>;
+//# sourceMappingURL=searchTemplate.d.ts.map

package/dist/searchTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchTemplate.d.ts","sourceRoot":"","sources":["../src/searchTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0NH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,GAAG,CAAC;IAAC,aAAa,CAAC,EAAE,GAAG,CAAA;CAAE,GAC5D,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiJvF"}

package/dist/searchTemplate.js

@@ -0,0 +1,318 @@
+/**
+ * Search Results Widget Template
+ *
+ * Server-side rendering for search_graph responses.
+ * Tabs: Trends, Companies, Market, Analysis
+ * Returns near-complete HTML with editorial slots for Claude.
+ */
+import { wrapWidget, esc } from './widgetShell.js';
+import { fillSearchInsight, fillAnalysis, replaceSlots } from './editorialFill.js';
+function computeStage(t) {
+    const now = Date.now();
+    const signal = t.signal_score || 0;
+    const evCount = t.evidence_count || t.evidenceCount || 0;
+    const firstMs = t.firstSeen ? new Date(t.firstSeen).getTime() : now;
+    const lastMs = t.lastSeen ? new Date(t.lastSeen).getTime() : now;
+    const daysSinceLast = (now - lastMs) / 864e5;
+    const ageDays = (now - firstMs) / 864e5;
+    if (signal >= 70 && evCount >= 12 && daysSinceLast < 90)
+        return 'established';
+    if (signal >= 70 && daysSinceLast >= 90)
+        return 'plateauing';
+    if (signal < 45 && ageDays > 120)
+        return 'plateauing';
+    if (signal >= 45 || evCount >= 8)
+        return 'building';
+    return 'emerging';
+}
+function normalizeBrands(raw) {
+    if (!raw)
+        return [];
+    if (Array.isArray(raw))
+        return raw.slice(0, 4);
+    return raw.split('|').map(b => b.trim()).filter(Boolean).slice(0, 4);
+}
+// ---------------------------------------------------------------------------
+// Build Google Trends section
+// ---------------------------------------------------------------------------
+function buildGoogleTrendsHtml(gt, query) {
+    if (!gt)
+        return '';
+    const snap = gt?.snapshot || gt;
+    const interest = snap?.interest_over_time;
+    if (!interest?.timeline_data?.length)
+        return '';
+    const points = interest.timeline_data;
+    const latest = points[points.length - 1];
+    const latestVal = latest?.values?.[0]?.extracted_value ?? latest?.value ?? 0;
+    const peak = Math.max(...points.map((p) => p?.values?.[0]?.extracted_value ?? p?.value ?? 0));
+    const peakPoint = points.find((p) => (p?.values?.[0]?.extracted_value ?? p?.value ?? 0) === peak);
+    const peakDate = peakPoint?.date || '';
+    const direction = latestVal > (points[Math.max(0, points.length - 4)]?.values?.[0]?.extracted_value ?? 0) ? '↑ rising' : '↓ declining';
+    // Build mini sparkline
+    const vals = points.map((p) => p?.values?.[0]?.extracted_value ?? p?.value ?? 0);
+    const max = Math.max(...vals, 1);
+    const svgW = 200;
+    const svgH = 32;
+    const pathPoints = vals.map((v, i) => `${(i / (vals.length - 1)) * svgW},${svgH - (v / max) * svgH}`).join(' ');
+    return `
+<div class="sl2">Search interest — "${esc(query)}"</div>
+<div style="display:flex;align-items:center;gap:16px;margin-bottom:8px;">
+  <svg viewBox="0 0 ${svgW} ${svgH}" width="${svgW}" height="${svgH}" style="flex-shrink:0;">
+    <polyline points="${pathPoints}" fill="none" stroke="var(--p)" stroke-width="1.5"/>
+  </svg>
+  <div style="font-size:11px;color:var(--color-text-secondary);line-height:1.5;">
+    <div>Now <strong>${latestVal}</strong> · Peak ${peak} (${esc(peakDate)})</div>
+    <div>${direction}</div>
+  </div>
+</div>
+<p class="fnote">Relative interest (0–100). Source: Google Trends.</p>`;
+}
+// ---------------------------------------------------------------------------
+// Build Census Retail section  
+// ---------------------------------------------------------------------------
+function buildCensusHtml(census) {
+    if (!census)
+        return '';
+    const snap = census?.snapshot || census;
+    const total = snap?.total_retail;
+    const subs = snap?.subcategories || [];
+    if (!total && !subs.length)
+        return '';
+    const fmtB = (v) => `$${(v / 1e9).toFixed(1)}B`;
+    const fmtPct = (v) => `${v >= 0 ? '+' : ''}${v.toFixed(1)}%`;
+    let html = `<div class="sl2">US retail sales — Census Bureau</div><div class="sg">`;
+    if (total) {
+        html += `<div class="sk"><div class="skl">Total US retail</div><div class="skv">${fmtB(total.value || 0)}</div><div class="sks">${fmtPct(total.mom_change || 0)} MoM</div></div>`;
+    }
+    // Show first subcategory
+    if (subs.length > 0) {
+        const sub = subs[0];
+        html += `<div class="sk"><div class="skl">${esc(sub.name || '')}</div><div class="skv">${fmtB(sub.value || 0)}</div><div class="sks">${fmtPct(sub.mom_change || 0)} MoM</div></div>`;
+    }
+    html += `</div>`;
+    return html;
+}
+// ---------------------------------------------------------------------------
+// Build Companies section (brand frequency bars)
+// ---------------------------------------------------------------------------
+function buildCompaniesHtml(rows) {
+    const brandCounts = {};
+    rows.forEach(r => {
+        const brands = normalizeBrands(r.brandNames || r.Brand);
+        brands.forEach(b => {
+            brandCounts[b] = (brandCounts[b] || 0) + 1;
+        });
+    });
+    const sorted = Object.entries(brandCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 20);
+    if (sorted.length === 0)
+        return '<p class="fnote">No brand data available for these trends.</p>';
+    return `<div class="co-grid">${sorted.map(([brand, count]) => {
+        const query = `Tell me about ${brand.replace(/'/g, "\\'")}'s innovation strategy across the knowledge graphs`;
+        return `<button class="co-pill" onclick="sendPrompt('${query}')">${esc(brand)}<span class="co-count">${count}</span></button>`;
+    }).join('\n')}</div>`;
+}
+// ---------------------------------------------------------------------------
+// CSS
+// ---------------------------------------------------------------------------
+const SEARCH_CSS = `
+/* Grid */
+.tgrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(210px,1fr));gap:10px;}
+.tc2{background:var(--color-background-primary);border:1px solid var(--color-border-tertiary);border-radius:4px;
+  padding:1rem 1.125rem;display:flex;flex-direction:column;gap:6px;transition:opacity .25s,transform .25s;}
+
+.tc2-top{display:flex;justify-content:space-between;align-items:flex-start;gap:6px;}
+.tc2-eyebrow{font-family:var(--font-mono);font-size:10px;font-weight:700;letter-spacing:0.18em;text-transform:uppercase;color:var(--color-text-secondary);margin-bottom:2px;}
+.tc2-eyebrow .sep{color:var(--color-border-tertiary);}
+.signal{display:inline-flex;align-items:baseline;gap:6px;flex-shrink:0;}
+.signal-num{font-family:var(--font-display);font-style:italic;font-size:18px;font-weight:400;color:var(--color-text-primary);}
+.signal-meta{font-family:var(--font-mono);font-size:9px;letter-spacing:0.16em;text-transform:uppercase;color:var(--color-text-secondary);}
+.signal.high .signal-num{color:var(--color-text-success);}
+.signal.mid .signal-num{color:var(--color-text-warning);}
+.signal.low .signal-num{color:var(--color-text-secondary);}
+.tc2-name{font-size:13px;font-weight:500;line-height:1.35;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;}
+.tc2-desc{font-size:11px;color:var(--color-text-secondary);line-height:1.5;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;}
+.bchips{display:flex;flex-wrap:wrap;gap:3px;}
+.bchip{font-size:11px;background:var(--color-background-secondary);color:var(--color-text-secondary);border-radius:4px;padding:1px 6px;}
+.tc2-foot{display:flex;justify-content:space-between;align-items:center;font-size:10px;color:var(--color-text-tertiary);margin-top:2px;gap:6px;}
+.tc2-graph{font-size:10px;padding:2px 8px;border-radius:20px;background:var(--pl);color:var(--pl-on);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:70%;}
+.tc2-exp{font-size:11px;border:1px solid var(--color-border-tertiary);border-radius:4px;padding:3px 10px;
+  cursor:pointer;background:transparent;color:var(--color-text-secondary);margin-top:auto;width:fit-content;
+  transition:all .15s;font-family:var(--font-mono);}
+.tc2-exp:hover{background:var(--pl);border-color:var(--pm);color:var(--pl-on);}
+.search-insight{font-size:14px;font-family:var(--font-display);font-style:italic;font-weight:400;line-height:1.65;padding:14px 16px;
+  background:var(--pl);border:1px solid var(--p);border-left-width:3px;border-radius:4px;margin-bottom:1.25rem;color:var(--color-text-primary);}
+
+/* Company pills */
+.co-grid{display:flex;flex-wrap:wrap;gap:6px;}
+.co-pill{display:inline-flex;align-items:center;gap:5px;font-size:12px;padding:5px 12px;border-radius:20px;
+  border:.5px solid var(--color-border-tertiary);background:none;color:var(--color-text-primary);
+  cursor:pointer;font-family:var(--font-mono);transition:all .15s;}
+.co-pill:hover{background:var(--pl);border-color:var(--pm);color:var(--pl-on);}
+.co-count{font-size:10px;background:var(--color-background-secondary);color:var(--color-text-tertiary);
+  border-radius:10px;padding:1px 5px;}
+
+/* Market stats */
+.sg{display:grid;grid-template-columns:repeat(2,1fr);gap:8px;margin-bottom:12px;}
+.sk{background:var(--color-background-secondary);border-radius:8px;padding:10px 12px;}
+.skl{font-size:10px;color:var(--color-text-secondary);margin-bottom:2px;}
+.skv{font-family:var(--font-display);font-style:italic;font-size:22px;font-weight:400;}
+.sks{font-size:10px;color:var(--color-text-secondary);}
+.sl2{font-size:13px;font-weight:500;margin:1rem 0 8px;}.sl2:first-child{margin-top:0;}
+
+/* Analysis */
+.analysis-content{font-size:13px;line-height:1.65;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;}
+.analysis-content p{margin-bottom:10px;}
+.analysis-content strong{font-weight:600;}
+
+/* Dark mode */
+@media(prefers-color-scheme:dark){
+  .bchip{background:rgba(255,255,255,0.08);}
+}
+`;
+// ---------------------------------------------------------------------------
+// Stage definitions
+// ---------------------------------------------------------------------------
+const STAGES = [
+    { id: 'all', label: 'All', color: '#444441', desc: 'Every signal in the result set' },
+    { id: 'emerging', label: 'Emerging', color: '#A07CD4', desc: 'New signals — thin evidence, high uncertainty' },
+    { id: 'building', label: 'Building', color: '#2E6BE5', desc: 'Gaining momentum — evidence accumulating' },
+    { id: 'established', label: 'Established', color: '#1D9E75', desc: 'Well-documented — high signal, broad coverage' },
+    { id: 'plateauing', label: 'Plateauing', color: '#888780', desc: 'Slowing — signal strong but evidence aging' },
+];
+// ---------------------------------------------------------------------------
+// Main render function
+// ---------------------------------------------------------------------------
+export async function renderSearchWidget(data, query, graphName, supplemental) {
+    const rows = data?.rows || data?.results || [];
+    // Only render widget for 3+ results; 1-2 results → Claude uses raw JSON
+    if (rows.length < 3) {
+        return {
+            widget_html: '',
+            editorial_instruction: '',
+            open_slots: [],
+        };
+    }
+    // Compute stages
+    const enriched = rows.map(r => ({
+        ...r,
+        _stage: r.trendLifecycle || computeStage(r),
+        _signal: r.signal_score || 0,
+        _name: r.trendName || r.name || r.label || '',
+        _desc: (r.trendDescription || r.description || '').slice(0, 140),
+        _brands: normalizeBrands(r.brandNames || r.Brand),
+        _graphName: r.graphName || graphName || '',
+        _evCount: r.evidence_count || r.evidenceCount || 0,
+        _firstSeen: r.firstSeen || '',
+        _lastSeen: r.lastSeen || '',
+    }));
+    enriched.sort((a, b) => b._signal - a._signal);
+    // Collect source names
+    const sourceSet = new Set();
+    enriched.forEach(t => { if (t._graphName)
+        sourceSet.add(t._graphName); });
+    if (supplemental?.google_trends)
+        sourceSet.add('Google Trends');
+    if (supplemental?.census_retail)
+        sourceSet.add('Census Bureau');
+    const sources = [...sourceSet];
+    // Build Market tab content
+    const censusHtml = buildCensusHtml(supplemental?.census_retail);
+    const gtHtml = buildGoogleTrendsHtml(supplemental?.google_trends, query);
+    const marketContent = (censusHtml || gtHtml)
+        ? `${censusHtml}${gtHtml}`
+        : '<p class="fnote">No market data available for this query.</p>';
+    // Build Companies tab content
+    const companiesHtml = buildCompaniesHtml(rows);
+    const signalCountHtml = `<p class="scr-count">${enriched.length} signals across ${sources.filter(s => s !== 'Google Trends' && s !== 'Census Bureau').join(', ')}</p>`;
+    // Build Trends grid server-side
+    const smap = Object.fromEntries(STAGES.map(s => [s.id, s]));
+    const trendsGridHtml = enriched.map(t => {
+        const stageObj = smap[t._stage] || smap['emerging'];
+        const sc = t._signal >= 80 ? 'high' : t._signal >= 50 ? 'mid' : 'low';
+        const queryStr = `Tell me about ${t._name} from the ${t._graphName}`.replace(/'/g, "\\'");
+        return `<div class="tc2">
+          <div class="tc2-eyebrow">${esc(t._graphName)} <span class="sep">·</span> ${(stageObj?.label || 'Emerging').toUpperCase()}</div>
+          <div class="tc2-top"><p class="tc2-name">${esc(t._name)}</p>
+          <div class="signal ${sc}"><span class="signal-num">${t._signal}</span><span class="signal-meta">signal</span></div></div>
+          <p class="tc2-desc">${esc(t._desc)}</p>
+          <div class="bchips">${t._brands.map((b) => `<span class="bchip">${esc(b)}</span>`).join('')}</div>
+          <div class="tc2-foot"><span class="tc2-graph">${esc(t._graphName)}</span><span>${t.relevance ? t.relevance + '% match' : t._evCount + ' ev.'}</span></div>
+          <button class="tc2-exp" onclick="sendPrompt('${queryStr}')">Explore ↗</button></div>`;
+    }).join('');
+    // Build content HTML linearly without tabs
+    const contentHtml = `
+<div class="search-insight">{{SEARCH_INSIGHT}}</div>
+
+<div class="sec">Trends</div>
+${signalCountHtml}
+<div class="tgrid" id="tgrid">${trendsGridHtml}</div>
+
+<div class="sec">Companies</div>
+<div class="sl2">Brands appearing across these trends</div>
+<p class="fnote">Frequency of brand mentions across ${enriched.length} trends. Higher count = wider strategic footprint.</p>
+${companiesHtml}
+
+<div class="sec">Market</div>
+${marketContent}
+
+<div class="sec">Analysis</div>
+<div class="analysis-content">{{ANALYSIS_HTML}}</div>
+`;
+    const subtitle = `Search: ${query}`;
+    let widget_html = wrapWidget(subtitle, contentHtml, sources, SEARCH_CSS);
+    // Count unique brands for editorial context
+    const uniqueBrands = new Set();
+    enriched.forEach(t => t._brands.forEach(b => uniqueBrands.add(b)));
+    // ── Tier 1 + Tier 2: Run both Gemini fills in parallel ──
+    const trendSummaries = enriched.map(t => ({
+        name: t._name, signal: t._signal, stage: t._stage,
+        graphName: t._graphName, brands: t._brands, desc: t._desc,
+    }));
+    const suppSummary = supplemental?.google_trends ? 'Google Trends data available for query.' : '';
+    const [insightResult, analysisResult] = await Promise.allSettled([
+        fillSearchInsight(trendSummaries, query),
+        fillAnalysis(query, trendSummaries, suppSummary),
+    ]);
+    const insightText = insightResult.status === 'fulfilled' ? insightResult.value : '';
+    const analysisHtml = analysisResult.status === 'fulfilled' ? analysisResult.value : '';
+    if (analysisResult.status === 'rejected') {
+        console.error(`[searchTemplate] fillAnalysis failed:`, analysisResult.reason);
+    }
+    // Replace slots
+    const fills = {};
+    if (insightText)
+        fills['SEARCH_INSIGHT'] = insightText;
+    if (analysisHtml)
+        fills['ANALYSIS_HTML'] = analysisHtml;
+    widget_html = replaceSlots(widget_html, fills);
+    const slotsRemaining = [];
+    if (!insightText)
+        slotsRemaining.push('SEARCH_INSIGHT');
+    if (!analysisHtml)
+        slotsRemaining.push('ANALYSIS_HTML');
+    const editorial_instruction = slotsRemaining.length === 0
+        ? `── SEARCH WIDGET: READY ──
+The widget is fully populated. Call show_widget with the widget_html as-is. Do NOT modify the HTML.`
+        : `── SEARCH WIDGET: EDITORIAL SLOTS ──
+The widget_html has ${slotsRemaining.length} unfilled slot(s): ${slotsRemaining.join(', ')}.
+Fill them and call show_widget.
+
+CONTEXT:
+- Query: "${query}"
+- ${enriched.length} trends across ${sources.join(', ')}
+- Top signal: "${enriched[0]?._name}" (score ${enriched[0]?._signal})
+- ${uniqueBrands.size} unique brands
+
+CRITICAL: ALL output must go INSIDE the widget slots. Do NOT redesign or restyle.`;
+    // Final cleanup: strip any remaining unfilled {{...}} placeholders
+    widget_html = widget_html.replace(/\{\{[A-Z_0-9]+\}\}/g, '');
+    return {
+        widget_html,
+        editorial_instruction,
+        open_slots: slotsRemaining,
+    };
+}
+//# sourceMappingURL=searchTemplate.js.map

package/dist/searchTemplate.js.map

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

package/dist/sessionTracker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Session Tracker — in-memory search history and frustration detection.
+ *
+ * Tracks tool call patterns within a single MCP session to detect
+ * structural frustration signals (repeated queries, NO_MATCH streaks,
+ * graph bouncing). Hints are injected into response text for Claude
+ * to act on — the user never sees them directly.
+ *
+ * When aggregate frustration is high (3+ patterns triggered in one session),
+ * an alert is posted to #fodda-sales on Slack for the sales bot to enrich.
+ *
+ * Resets per MCP connection (stateless across sessions).
+ */
+export interface SessionSearch {
+    query: string;
+    graphId: string;
+    resultCount: number;
+    timestamp: number;
+}
+export type FrustrationPattern = 'LOW_YIELD' | 'NO_MATCH' | 'GRAPH_BOUNCING';
+export interface FrustrationDetails {
+    pattern: FrustrationPattern;
+    graphsTried: string[];
+    recentQueries: string[];
+    score: number;
+}
+/**
+ * Post a message to #fodda-sales via the Slack Bot Token.
+ * Fire-and-forget — errors are logged but never thrown.
+ */
+export declare function postToSlack(text: string): Promise<void>;
+export declare function createSessionTracker(): {
+    trackSearch: (query: string, graphId: string, resultCount: number) => void;
+    detectFrustration: () => string | null;
+    getRecentSearches: (n?: number) => SessionSearch[];
+    getFrustrationDetails: () => FrustrationDetails | null;
+    postFrustrationToSlack: (userIdentifier: string) => void;
+};
+//# sourceMappingURL=sessionTracker.d.ts.map

package/dist/sessionTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTracker.d.ts","sourceRoot":"","sources":["../src/sessionTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACjB;AAQD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7D;AAMD,wBAAgB,oBAAoB;yBAOJ,MAAM,WAAW,MAAM,eAAe,MAAM,KAAG,IAAI;6BAsEjD,MAAM,GAAG,IAAI;4BA1Db,MAAM,KAAO,aAAa,EAAE;iCAQxB,kBAAkB,GAAG,IAAI;6CAuGX,MAAM,KAAG,IAAI;EAuBhE"}