fodda-mcp 1.46.97 → 1.46.132

package/dist/brandTemplate.js

@@ -12,38 +12,52 @@ import { fillBrandOneLiner, fillTrendFootprintIntro, fillMarketDataIntro, replac
 import { esc, FODDA_LOGO_URL } from './widgetShell.js';
 import { getDomainGraphIds } from './catalogCache.js';
 const PRESSURE_COLORS = {
-    'Direct competitor': { bg: '#FFF0E0', color: '#D97B2B', label: 'Direct competitor' },
+    'Shared category': { bg: '#E6F1FB', color: '#2E6BE5', label: 'Shared category' },
+    'Appears alongside': { bg: '#F5F0FF', color: '#663399', label: 'Appears alongside' },
     'Adjacent signal': { bg: '#E6F1FB', color: '#2E6BE5', label: 'Adjacent signal' },
     'Crossover mention': { bg: '#EEEDFE', color: '#7C6AB5', label: 'Crossover mention' },
     'Related brand': { bg: '#F5F0FF', color: '#663399', label: 'Related brand' },
-    // Legacy labels (backward compat)
-    'Heritage challenger': { bg: '#FFF0E0', color: '#D97B2B', label: 'Heritage challenger' },
-    'Sibling challenger': { bg: '#FFF0E0', color: '#D97B2B', label: 'Sibling challenger' },
-    'Premium challenger': { bg: '#E6F1FB', color: '#2E6BE5', label: 'Premium challenger' },
+    // Backward compat aliases mapped to neutral wording
+    'Direct competitor': { bg: '#E6F1FB', color: '#2E6BE5', label: 'Shared category' },
+    'Heritage challenger': { bg: '#F5F0FF', color: '#663399', label: 'Appears alongside' },
+    'Sibling challenger': { bg: '#F5F0FF', color: '#663399', label: 'Appears alongside' },
+    'Premium challenger': { bg: '#E6F1FB', color: '#2E6BE5', label: 'Shared category' },
     'Co-creation partner': { bg: '#EAF3DE', color: '#3A8F5C', label: 'Co-creation partner' },
     'Tech partner': { bg: '#EAF3DE', color: '#3A8F5C', label: 'Tech partner' },
     'Culture collaborator': { bg: '#FBEAF0', color: '#C94F7A', label: 'Culture collaborator' },
-    'Crossover threat': { bg: '#EEEDFE', color: '#7C6AB5', label: 'Crossover threat' },
-    'Category shadow': { bg: '#EEEDFE', color: '#7C6AB5', label: 'Category shadow' },
+    'Crossover threat': { bg: '#EEEDFE', color: '#7C6AB5', label: 'Crossover mention' },
+    'Category shadow': { bg: '#EEEDFE', color: '#7C6AB5', label: 'Crossover mention' },
 };
-const DEFAULT_PRESSURE = { bg: '#FFF0E0', color: '#D97B2B', label: 'Competitor' };
-// Sector-aware pressure type assignment based on graph overlap
+const DEFAULT_PRESSURE = { bg: '#F5F0FF', color: '#663399', label: 'Appears alongside' };
+// Sector-aware pressure type assignment based on graph overlap or explicit API relationship_type
 function guessPressureType(_index, competitor, brandGraphIds, domainGraphIds) {
+    if (competitor?.relationship_type) {
+        const rel = String(competitor.relationship_type).toLowerCase();
+        if (rel === 'competitor' || rel === 'peer')
+            return 'Shared category';
+        if (rel === 'adjacent')
+            return 'Adjacent signal';
+        if (rel === 'partner')
+            return 'Co-creation partner';
+        if (rel === 'crossover')
+            return 'Crossover mention';
+        return 'Appears alongside';
+    }
     const compGraphArr = competitor?.graphIds || [];
     if (compGraphArr.length > 0 && brandGraphIds && brandGraphIds.size > 0) {
         const compGraphs = new Set(compGraphArr);
         const sharedGraphs = [...compGraphs].filter(g => brandGraphIds.has(g));
         if (sharedGraphs.length === 0)
             return 'Crossover mention';
-        // Any shared DOMAIN graph = direct competitor (both in retail, both in beauty, etc.)
+        // Any shared DOMAIN graph = shared category (both in retail, both in beauty, etc.)
         const sharedDomain = domainGraphIds ? sharedGraphs.filter(g => domainGraphIds.has(g)) : [];
         if (sharedDomain.length > 0)
-            return 'Direct competitor';
+            return 'Shared category';
         // Shared expert graph only = adjacent signal (co-mentioned in research, not same market)
         return 'Adjacent signal';
     }
-    // Fallback: no graph data — conservative label
-    return 'Related brand';
+    // Fallback: no graph data — conservative neutral label
+    return 'Appears alongside';
 }
 // ---------------------------------------------------------------------------
 // Network node orbit positions (fixed, up to 5 competitors)
@@ -165,6 +179,7 @@ function velocityClass(trend) {
         case 'accelerating': return { cls: 'vc-up', label: 'rising ↑' };
         case 'stable': return { cls: 'vc-steady', label: 'steady →' };
         case 'decelerating': return { cls: 'vc-slow', label: 'slowing ↓' };
+        case 'untracked': return { cls: 'vc-untracked', label: 'UNTRACKED' };
         default: return { cls: 'vc-build', label: 'building ↗' };
     }
 }
@@ -299,13 +314,16 @@ function formatStockPrice(priceWindow) {
 export async function renderBrandWidget(profile) {
     const brand = profile.brand || 'Brand';
     const trends = profile.trend_footprint || [];
-    const evidence = profile.evidence_items || [];
-    const competitors = profile.competitive_context?.co_occurring_brands || [];
+    const evidence = profile.evidence_items || profile.direct_evidence || [];
+    const competitors = (profile.competitive_context?.peers && profile.competitive_context.peers.length > 0)
+        ? profile.competitive_context.peers
+        : (profile.competitive_context?.co_occurring_brands || profile.competitive_context?.co_occurring || []);
     const crossGraph = profile.cross_graph_presence || [];
     const supplemental = profile.supplemental_signals || {};
     const lcDist = profile.summary?.lifecycle_distribution || {};
     const buildingCount = (lcDist.building || 0) + (lcDist.emerging || 0);
     const fadingCount = (lcDist.fading || 0) + (lcDist.mature || 0);
+    const isEmptyCoverage = profile.coverage?.status === 'empty' || (trends.length === 0 && evidence.length === 0);
     // Enrich trends with lifecycle if missing
     trends.forEach((t) => {
         if (!t.lifecycle || t.lifecycle === 'unknown') {
@@ -340,24 +358,29 @@ export async function renderBrandWidget(profile) {
         }
     });
     let rawVelocityTrend = 'stable';
-    const totalWithMomentum = accCount + bldCount + stdCount + slowCount;
-    if (totalWithMomentum > 0) {
-        if ((accCount + bldCount) > slowCount && accCount >= bldCount && accCount > 0) {
-            rawVelocityTrend = 'accelerating';
-        }
-        else if ((accCount + bldCount) > slowCount && bldCount > 0) {
-            rawVelocityTrend = 'building';
-        }
-        else if (slowCount > (accCount + bldCount) && slowCount > stdCount) {
-            rawVelocityTrend = 'decelerating';
+    if (isEmptyCoverage || trends.length === 0 || (profile.summary?.total_evidence_items || 0) === 0) {
+        rawVelocityTrend = 'untracked';
+    }
+    else {
+        const totalWithMomentum = accCount + bldCount + stdCount + slowCount;
+        if (totalWithMomentum > 0) {
+            if ((accCount + bldCount) > slowCount && accCount >= bldCount && accCount > 0) {
+                rawVelocityTrend = 'accelerating';
+            }
+            else if ((accCount + bldCount) > slowCount && bldCount > 0) {
+                rawVelocityTrend = 'building';
+            }
+            else if (slowCount > (accCount + bldCount) && slowCount > stdCount) {
+                rawVelocityTrend = 'decelerating';
+            }
+            else {
+                rawVelocityTrend = 'stable';
+            }
         }
         else {
-            rawVelocityTrend = 'stable';
+            rawVelocityTrend = profile.summary?.evidence_velocity?.trend || 'stable';
         }
     }
-    else {
-        rawVelocityTrend = profile.summary?.evidence_velocity?.trend || 'stable';
-    }
     const velocity = velocityClass(rawVelocityTrend);
     const timeline = profile.activity_timeline || [];
     // Build set of graphIds the target brand is present in (for sector-aware competitor labels)
@@ -586,19 +609,27 @@ export async function renderBrandWidget(profile) {
     const competitorListHtml = competitors.slice(0, 8).map((c, i) => {
         const pType = guessPressureType(i, c, brandGraphIds, domainGIds);
         const colors = PRESSURE_COLORS[pType] || DEFAULT_PRESSURE;
+        const bName = c.brand || c.name || '';
+        const count = c.co_occurrences ?? c.count ?? 1;
+        const countText = c.relationship_type === 'partner'
+            ? `Partner in ${count} initiative${count !== 1 ? 's' : ''}`
+            : `Appears alongside in ${count} evidence item${count !== 1 ? 's' : ''}`;
         return `<div class="cc">
   <div>
-    <div class="cn">${esc(c.brand)}</div>
-    <div class="cd">Co-occurs in ${c.co_occurrences} evidence item${c.co_occurrences !== 1 ? 's' : ''}</div>
+    <div class="cn">${esc(bName)}</div>
+    <div class="cd">${countText}</div>
   </div>
   <div class="ca">
     <span class="pb" style="background:${colors.bg};color:${colors.color};">${colors.label}</span>
-    <button class="cv" onclick="sendPrompt('brand intelligence: ${esc(c.brand)}')">View ↗</button>
+    <button class="cv" onclick="sendPrompt('brand intelligence: ${esc(bName)}')">Explore ↗</button>
   </div>
 </div>`;
     }).join('\n');
     // ── Compare buttons ──
-    const compareButtonsHtml = competitors.slice(0, 4).map((c) => `<button class="cp" onclick="sendPrompt('brand intelligence: ${esc(c.brand)}')">${esc(c.brand)} ↗</button>`).join('\n    ');
+    const compareButtonsHtml = competitors.slice(0, 4).map((c) => {
+        const bName = c.brand || c.name || '';
+        return `<button class="cp" onclick="sendPrompt('brand intelligence: ${esc(bName)}')">${esc(bName)} ↗</button>`;
+    }).join('\n    ');
     // ── Google Trends ──
     const gt = buildGoogleTrendsSVG(supplemental?.google_trends);
     const hasGoogleTrendsData = gt.polyline !== '0,88 300,88'; // false when API returned empty time-series
@@ -620,6 +651,18 @@ export async function renderBrandWidget(profile) {
         return true;
     }).sort((a, b) => (b.reviews || 0) - (a.reviews || 0));
     const amazonProductsHtml = products.slice(0, 4).map((p) => `<div class="ap"><div><div class="an2">${esc(p.name || p.title)}</div><div class="am2">${esc(p.price || '')}</div></div><div><div class="astar">${'★'.repeat(Math.round(p.rating || 0))}${'☆'.repeat(5 - Math.round(p.rating || 0))}</div><div class="am2">${(p.reviews || 0).toLocaleString()} reviews</div></div></div>`).join('\n');
+    const totalListings = amazon.product_count || 0;
+    const analyzed = amazon.products_analyzed || products.length || 0;
+    let amazonBasisSub = 'across listings';
+    if (analyzed > 0 && totalListings > analyzed) {
+        amazonBasisSub = `based on sample of ${analyzed} of ${totalListings.toLocaleString()} listings`;
+    }
+    else if (analyzed > 0) {
+        amazonBasisSub = `based on ${analyzed} listings`;
+    }
+    else if (totalListings > 0) {
+        amazonBasisSub = `based on ${totalListings.toLocaleString()} listings`;
+    }
     // ── Geographic bars ──
     const geoDist = profile.geographic_distribution || [];
     const geoMax = Math.max(...geoDist.map((g) => g.count || 0), 1);
@@ -646,29 +689,136 @@ export async function renderBrandWidget(profile) {
     if (!matchedSector) {
         matchedSector = censusSubs.find((c) => (c.name || '').toLowerCase().includes('non-store') || (c.name || '').toLowerCase().includes('e-commerce'));
     }
-    const totalRetail = censusSnap?.total_retail_sales_millions;
-    const totalMom = censusSnap?.month_over_month_change_pct;
+    const totalRetail = censusSnap?.headline_retail_and_food_services?.sales_millions || censusSnap?.total_retail_sales_millions || censusSnap?.latest_sales_m;
+    const totalMom = censusSnap?.headline_retail_and_food_services?.mom_change_pct ?? censusSnap?.month_over_month_change_pct ?? censusSnap?.mom_change_pct;
     const beaLabel = matchedSector ? esc(matchedSector.name).replace(/ Stores$/, '') : 'Retail sector';
     const beaValue = matchedSector?.sales_millions ? `$${(matchedSector.sales_millions / 1000).toFixed(1)}B` : '—';
     const beaSub = matchedSector?.mom_change_pct != null ? `${matchedSector.mom_change_pct > 0 ? '+' : ''}${matchedSector.mom_change_pct.toFixed(1)}% MoM` : '';
-    const beaChangeLabel = 'Total US retail';
+    const beaChangeLabel = 'US retail & food';
     const beaChangeValue = totalRetail ? `$${(totalRetail / 1000).toFixed(0)}B` : '—';
     const beaChangeSub = totalMom != null ? `${totalMom > 0 ? '+' : ''}${totalMom.toFixed(1)}% MoM` : '';
+    // ── Conditional section HTML builders (Honour coverage status & data boundaries) ──
+    const emptyStateCalloutHtml = isEmptyCoverage
+        ? `<div class="ec" style="margin-top:1rem;padding:1.25rem;">
+  <div class="et" style="font-size:13px;font-weight:600;">Broaden your search</div>
+  <div class="ex" style="margin-top:6px;line-height:1.6;">Fodda does not currently track curated trend evidence specifically mentioning <strong>${esc(brand)}</strong>. Try exploring broader category trends in our domain graphs or consult a specialist practitioner for strategic perspective.</div>
+</div>`
+        : '';
+    const caseStudiesSectionHtml = (!isEmptyCoverage && evidenceHtml)
+        ? `<div class="sec">Case Studies</div>\n${evidenceHtml}`
+        : '';
+    const trendsSectionHtml = (!isEmptyCoverage && (trendsHtml || weakSignalsHtml))
+        ? `<div class="sec">Relevant trends</div>
+{{TREND_FOOTPRINT_INTRO}}
+<div class="lcb">{{LIFECYCLE_BAR}}</div>
+<div class="lcl">{{LIFECYCLE_LEGEND}}</div>
+${trendsHtml}
+${weakSignalsHtml}`
+        : '';
+    const competitiveSectionHtml = (!isEmptyCoverage && competitors.length > 0)
+        ? `<div class="sec">Co-occurring brands</div>\n${competitorListHtml}`
+        : '';
+    const earningsSectionHtml = (!isEmptyCoverage && earningsHtml)
+        ? `<div class="sl2">Quarterly Earnings & Wall Street Intelligence</div>
+${earningsHtml}
+<p class="note">Source: Fodda Institutional Earnings Intelligence (SEC Filings & Executive Earnings Call Transcripts).</p>`
+        : '';
+    const financialSnapshotSectionHtml = (!isEmptyCoverage && financialSnapshotHtml)
+        ? `<div class="sl2">Institutional Financial Snapshot</div>
+${financialSnapshotHtml}
+<p class="note">Source: Institutional SEC & Market Financial Filings.</p>`
+        : '';
+    // Supplemental section gating: never render no_signal / no_brand_match or untracked brands
+    const censusHasSignal = censusRaw?.data_status !== 'no_signal' && censusRaw?.data_status !== 'no_brand_match' && (totalRetail != null || matchedSector?.sales_millions != null);
+    const censusSectionHtml = (!isEmptyCoverage && censusHasSignal)
+        ? `<div class="sl2">US retail sales — Census Bureau (National market context)</div>
+<div class="sg">
+  <div class="sk"><div class="skl">{{BEA_STAT_1_LABEL}}</div><div class="skv">{{BEA_STAT_1_VALUE}}</div><div class="sks">{{BEA_STAT_1_SUB}}</div></div>
+  <div class="sk"><div class="skl">{{BEA_STAT_2_LABEL}}</div><div class="skv">{{BEA_STAT_2_VALUE}}</div><div class="sks">{{BEA_STAT_2_SUB}}</div></div>
+</div>
+<p class="note">Macroeconomic context from the US Census Bureau. National retail volume, not brand-specific sales.</p>`
+        : '';
+    const gtHasSignal = supplemental?.google_trends?.data_status !== 'no_signal' && supplemental?.google_trends?.data_status !== 'no_brand_match' && hasGoogleTrendsData;
+    const gtSectionHtml = (!isEmptyCoverage && gtHasSignal) ? `<div class="sl2">${gt.description}</div>
+<svg viewBox="0 0 300 96" xmlns="http://www.w3.org/2000/svg" style="width:100%;height:96px;margin-bottom:4px;">
+  <defs>
+    <linearGradient id="gtg" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="var(--fodda-accent, #663399)" stop-opacity=".18"/>
+      <stop offset="100%" stop-color="var(--fodda-accent, #663399)" stop-opacity="0"/>
+    </linearGradient>
+  </defs>
+  <polygon points="${gt.polygon}" fill="url(#gtg)"/>
+  <polyline points="${gt.polyline}" fill="none" stroke="var(--fodda-accent, #663399)" stroke-width="1.5" stroke-linejoin="round"/>
+  <line x1="0" y1="88" x2="300" y2="88" stroke="var(--color-border-tertiary)" stroke-width=".5"/>
+  <text x="2" y="93" font-size="7" fill="var(--color-text-secondary)" font-family="monospace">${gt.startDateLabel}</text>
+  <text x="150" y="93" font-size="7" fill="var(--color-text-secondary)" text-anchor="middle" font-family="monospace">${gt.peakLabel}</text>
+  <text x="298" y="93" font-size="7" fill="var(--color-text-secondary)" text-anchor="end" font-family="monospace">${gt.nowLabel}</text>
+  <circle cx="${gt.peakX}" cy="${gt.peakY}" r="2" fill="var(--fodda-accent, #663399)"/>
+  <circle cx="300" cy="${gt.annY}" r="2.5" fill="var(--fodda-accent, #663399)"/>
+  <text x="${gt.annX}" y="${gt.annY}" font-size="7" fill="var(--fodda-accent, #663399)" text-anchor="end" font-family="monospace">${gt.annText}</text>
+</svg>
+<p class="note">{{GT_CAPTION}}</p>` : '';
+    const gtComparisonSectionHtml = (!isEmptyCoverage && gtHasSignal && gt.comparisonBarsHtml) ? `<div class="sl2">Search interest — brand vs co-occurring brands</div>
+${gt.comparisonBarsHtml}` : '';
+    const relatedQueriesSectionHtml = (!isEmptyCoverage && gtHasSignal && gt.relatedQueriesHtml) ? `<div class="sl2">Top related queries</div>
+<div class="rq">${gt.relatedQueriesHtml}</div>
+<p class="note">{{RELATED_QUERIES_NOTE}}</p>` : '';
+    const wikiHasSignal = rawWiki?.data_status !== 'no_signal' && rawWiki?.data_status !== 'no_brand_match' && wikiData.length > 0;
+    const wikiSectionHtml = (!isEmptyCoverage && wikiHasSignal)
+        ? `<div class="sl2">Wikipedia — avg daily pageviews</div>
+${wikiBarsHtml}
+<p class="note">{{WIKI_NOTE}}</p>`
+        : '';
+    const amazonHasSignal = amazonRaw?.data_status !== 'no_signal' && amazonRaw?.data_status !== 'no_brand_match' && (totalListings > 0 || products.length > 0);
+    const amazonSectionHtml = (!isEmptyCoverage && amazonHasSignal)
+        ? `<div class="sl2">Amazon footprint</div>
+<div class="sg">
+  <div class="sk"><div class="skl">{{AMAZON_STAT_1_LABEL}}</div><div class="skv">{{AMAZON_STAT_1_VALUE}}</div><div class="sks">{{AMAZON_STAT_1_SUB}}</div></div>
+  <div class="sk"><div class="skl">{{AMAZON_STAT_2_LABEL}}</div><div class="skv">{{AMAZON_STAT_2_VALUE}}</div><div class="sks">{{AMAZON_STAT_2_SUB}}</div></div>
+  <div class="sk"><div class="skl">{{AMAZON_STAT_3_LABEL}}</div><div class="skv">{{AMAZON_STAT_3_VALUE}}</div><div class="sks">{{AMAZON_STAT_3_SUB}}</div></div>
+  <div class="sk"><div class="skl">{{AMAZON_STAT_4_LABEL}}</div><div class="skv">{{AMAZON_STAT_4_VALUE}}</div><div class="sks">{{AMAZON_STAT_4_SUB}}</div></div>
+</div>
+${amazonProductsHtml}
+<p class="note">{{AMAZON_CAPTION}}</p>`
+        : '';
+    const geoSectionHtml = (!isEmptyCoverage && geoBarsHtml)
+        ? `<div class="sl2">Geographic spread</div>
+${geoBarsHtml}`
+        : '';
+    const marketDataItems = [
+        censusSectionHtml,
+        gtSectionHtml,
+        gtComparisonSectionHtml,
+        relatedQueriesSectionHtml,
+        wikiSectionHtml,
+        amazonSectionHtml,
+        geoSectionHtml,
+    ].filter(Boolean);
+    const marketDataSectionHtml = (!isEmptyCoverage && marketDataItems.length > 0)
+        ? `<div class="sec">Market data</div>
+{{MARKET_DATA_INTRO}}
+${marketDataItems.join('\n')}`
+        : '';
     // ── Source pills ──
     const graphNames = crossGraph.map((g) => g.graphName).filter(Boolean);
     const sourcePills = [
         ...graphNames.map((n) => `<span class="gp">${esc(n)}</span>`),
-        (earningsSource === 'truth_layer' || earnings.length > 0) ? '<span class="gp">Earnings Intelligence</span>' : '',
-        (marketData && marketData.data_status !== 'no_signal') ? '<span class="gp">Financial Snapshot</span>' : '',
-        hasGoogleTrendsData ? '<span class="gp">Google Trends</span>' : '',
-        supplemental?.wikipedia ? '<span class="gp">Wikipedia</span>' : '',
-        supplemental?.amazon ? '<span class="gp">Amazon</span>' : '',
-        supplemental?.census_retail ? '<span class="gp">US Census</span>' : '',
+        (!isEmptyCoverage && (earningsSource === 'truth_layer' || earnings.length > 0)) ? '<span class="gp">Earnings Intelligence</span>' : '',
+        (!isEmptyCoverage && marketData && marketData.data_status !== 'no_signal') ? '<span class="gp">Financial Snapshot</span>' : '',
+        (!isEmptyCoverage && gtHasSignal) ? '<span class="gp">Google Trends</span>' : '',
+        (!isEmptyCoverage && wikiHasSignal) ? '<span class="gp">Wikipedia</span>' : '',
+        (!isEmptyCoverage && amazonHasSignal) ? '<span class="gp">Amazon</span>' : '',
+        (!isEmptyCoverage && censusHasSignal) ? '<span class="gp">US Census</span>' : '',
     ].filter(Boolean).join('\n    ');
     // ── Export slots (data-driven labels) ──
-    const exportLabels = [
+    const exportLabels = isEmptyCoverage ? [
+        { label: 'Category brief', desc: `Explore market dynamics in ${brand}'s category`, prompt: `Write category brief for ${brand}'s market` },
+        { label: 'Find specialist', desc: `Consult experts covering this space`, prompt: `Find specialists who cover ${brand}'s category` },
+        { label: 'Category signals', desc: `Emerging opportunities in this sector`, prompt: `Emerging signals for ${brand}'s category` },
+        { label: 'Market research', desc: `Broad research across retail & consumer graphs`, prompt: `Research trends in ${brand}'s industry` },
+    ] : [
         { label: 'Editorial brief', desc: `Strategic analysis of ${brand}'s innovation position`, prompt: `Write editorial brief for ${brand}` },
-        { label: 'Competitor comparison', desc: `Head-to-head with ${competitors[0]?.brand || 'top rival'}`, prompt: `Compare ${brand} vs ${competitors[0]?.brand || 'competitor'}` },
+        { label: 'Co-occurring landscape', desc: `Analysis of brands appearing alongside ${brand}`, prompt: `Compare brands appearing alongside ${brand}` },
         { label: 'Weak signal forecast', desc: `Emerging opportunities on ${brand}'s horizon`, prompt: `Weak signal forecast for ${brand}` },
         { label: 'Steal this idea', desc: `Actionable concepts from ${brand}'s playbook`, prompt: `Steal this idea from ${brand}` },
     ];
@@ -686,38 +836,19 @@ export async function renderBrandWidget(profile) {
         'TRENDS_HTML': trendsHtml,
         'WEAK_SIGNALS_HTML': weakSignalsHtml,
         'EVIDENCE_HTML': evidenceHtml,
-        'COMPETITIVE_SECTION_HTML': competitors.length > 0 ? `<div class="sec">Competitive</div>\n${competitorListHtml}` : '',
-        'GT_SECTION_HTML': hasGoogleTrendsData ? `<div class="sl2">${gt.description}</div>
-    <svg viewBox="0 0 300 96" xmlns="http://www.w3.org/2000/svg" style="width:100%;height:96px;margin-bottom:4px;">
-      <defs>
-        <linearGradient id="gtg" x1="0" y1="0" x2="0" y2="1">
-          <stop offset="0%" stop-color="var(--fodda-accent, #663399)" stop-opacity=".18"/>
-          <stop offset="100%" stop-color="var(--fodda-accent, #663399)" stop-opacity="0"/>
-        </linearGradient>
-      </defs>
-      <polygon points="${gt.polygon}" fill="url(#gtg)"/>
-      <polyline points="${gt.polyline}" fill="none" stroke="var(--fodda-accent, #663399)" stroke-width="1.5" stroke-linejoin="round"/>
-      <line x1="0" y1="88" x2="300" y2="88" stroke="var(--color-border-tertiary)" stroke-width=".5"/>
-      <text x="2" y="93" font-size="7" fill="var(--color-text-secondary)" font-family="monospace">${gt.startDateLabel}</text>
-      <text x="150" y="93" font-size="7" fill="var(--color-text-secondary)" text-anchor="middle" font-family="monospace">${gt.peakLabel}</text>
-      <text x="298" y="93" font-size="7" fill="var(--color-text-secondary)" text-anchor="end" font-family="monospace">${gt.nowLabel}</text>
-      <circle cx="${gt.peakX}" cy="${gt.peakY}" r="2" fill="var(--fodda-accent, #663399)"/>
-      <circle cx="300" cy="${gt.annY}" r="2.5" fill="var(--fodda-accent, #663399)"/>
-      <text x="${gt.annX}" y="${gt.annY}" font-size="7" fill="var(--fodda-accent, #663399)" text-anchor="end" font-family="monospace">${gt.annText}</text>
-    </svg>
-    <p class="note">{{GT_CAPTION}}</p>` : '',
-        'GT_COMPARISON_SECTION_HTML': gt.comparisonBarsHtml ? `<div class="sl2">Search interest — brand vs competitors</div>
-    ${gt.comparisonBarsHtml}` : '',
-        'RELATED_QUERIES_SECTION_HTML': gt.relatedQueriesHtml ? `<div class="sl2">Top related queries</div>
-    <div class="rq">${gt.relatedQueriesHtml}</div>
-    <p class="note">{{RELATED_QUERIES_NOTE}}</p>` : '',
-        'WIKI_BARS_HTML': wikiBarsHtml,
+        'EMPTY_STATE_CALLOUT_HTML': emptyStateCalloutHtml,
+        'CASE_STUDIES_SECTION_HTML': caseStudiesSectionHtml,
+        'TRENDS_SECTION_HTML': trendsSectionHtml,
+        'COMPETITIVE_SECTION_HTML': competitiveSectionHtml,
+        'MARKET_DATA_SECTION_HTML': marketDataSectionHtml,
+        'EARNINGS_SECTION_HTML': earningsSectionHtml,
+        'FINANCIAL_SNAPSHOT_SECTION_HTML': financialSnapshotSectionHtml,
         'AMAZON_STAT_1_LABEL': 'Listings',
         'AMAZON_STAT_1_VALUE': (amazon.product_count || 0).toLocaleString(),
         'AMAZON_STAT_1_SUB': 'total listings',
         'AMAZON_STAT_2_LABEL': 'Median price',
         'AMAZON_STAT_2_VALUE': amazon?.price_range?.median || amazon?.median_price || '—',
-        'AMAZON_STAT_2_SUB': 'across all listings',
+        'AMAZON_STAT_2_SUB': amazonBasisSub,
         'AMAZON_STAT_3_LABEL': 'Avg rating',
         'AMAZON_STAT_3_VALUE': String(amazon?.average_rating || '—'),
         'AMAZON_STAT_3_SUB': 'product average',
@@ -725,7 +856,7 @@ export async function renderBrandWidget(profile) {
         'AMAZON_STAT_4_VALUE': products[0] ? (products[0].reviews || 0).toLocaleString() : '—',
         'AMAZON_STAT_4_SUB': products[0] ? esc(products[0].name || products[0].title || '') : '',
         'AMAZON_PRODUCTS_HTML': amazonProductsHtml,
-        'AMAZON_CAPTION': 'Snapshot only. Source: Amazon.',
+        'AMAZON_CAPTION': 'Snapshot sample only. Not a full catalogue census. Source: Amazon.',
         'BEA_STAT_1_LABEL': beaLabel,
         'BEA_STAT_1_VALUE': beaValue,
         'BEA_STAT_1_SUB': beaSub,
@@ -734,12 +865,6 @@ export async function renderBrandWidget(profile) {
         'BEA_STAT_2_SUB': beaChangeSub,
         'GEO_SECTION_HTML': geoBarsHtml ? `<div class="sl2">Geographic spread</div>
     ${geoBarsHtml}` : '',
-        'EARNINGS_SECTION_HTML': earningsHtml ? `<div class="sl2">Quarterly Earnings & Wall Street Intelligence</div>
-    ${earningsHtml}
-    <p class="note">Source: Fodda Institutional Earnings Intelligence (SEC Filings & Executive Earnings Call Transcripts).</p>` : '',
-        'FINANCIAL_SNAPSHOT_SECTION_HTML': financialSnapshotHtml ? `<div class="sl2">Institutional Financial Snapshot</div>
-    ${financialSnapshotHtml}
-    <p class="note">Source: Institutional SEC & Market Financial Filings.</p>` : '',
         'SOURCE_PILLS_HTML': sourcePills,
         'EXPORT_1_LABEL': exportLabels[0].label,
         'EXPORT_1_DESC': exportLabels[0].desc,
@@ -758,11 +883,16 @@ export async function renderBrandWidget(profile) {
     const fills = { ...slotFills };
     // ── Parallel Gemini fills: one-liner + section intros ──
     const [oneLiner, trendIntro, marketIntro] = await Promise.allSettled([
-        fillBrandOneLiner(brand, trends, velocity.label, competitors.slice(0, 3).map((c) => c.brand)),
+        fillBrandOneLiner(brand, trends, velocity.label, competitors.slice(0, 3).map((c) => c.brand || c.name || '')),
         fillTrendFootprintIntro(brand, trends, profile.summary?.lifecycle_distribution || {}),
         fillMarketDataIntro(brand, supplemental),
     ]);
-    fills['ONE_LINER'] = oneLiner.status === 'fulfilled' ? oneLiner.value : `${brand} is ${velocity.label} across ${trends.length} trend${trends.length !== 1 ? 's' : ''}.`;
+    if (isEmptyCoverage || trends.length === 0 || evidence.length === 0) {
+        fills['ONE_LINER'] = `Fodda has no curated trend evidence mentioning ${brand} yet.`;
+    }
+    else {
+        fills['ONE_LINER'] = oneLiner.status === 'fulfilled' ? oneLiner.value : `${brand} is ${velocity.label} across ${trends.length} trend${trends.length !== 1 ? 's' : ''}.`;
+    }
     const trendIntroText = trendIntro.status === 'fulfilled' ? trendIntro.value : '';
     fills['TREND_FOOTPRINT_INTRO'] = trendIntroText ? `<p class="si">${esc(trendIntroText)}</p>` : '';
     const marketIntroText = marketIntro.status === 'fulfilled' ? marketIntro.value : '';
@@ -775,9 +905,16 @@ export async function renderBrandWidget(profile) {
     fills['RELATED_QUERIES_NOTE'] = supplemental?.google_trends?.related_queries?.length ? `Top related searches when people look for ${brand}.` : '';
     fills['WIKI_NOTE'] = wikiData.length > 0 ? `Daily Wikipedia pageviews for ${brand}-related articles. Higher = more cultural attention.` : '';
     const safeBrandName = esc(brand).replace(/'/g, "\\'");
-    const safeCompName = competitors[0]?.brand ? esc(competitors[0].brand).replace(/'/g, "\\'") : 'top rival';
-    fills['SUGGESTED_NEXT_HTML'] = `<div style="display:flex;flex-wrap:wrap;gap:6px;">
-        <button class="btn-out" onclick="sendPrompt('What are competitors of ${safeBrandName} doing differently?')">Competitive landscape</button>
+    const comp0 = competitors[0]?.brand || competitors[0]?.name;
+    const safeCompName = comp0 ? esc(comp0).replace(/'/g, "\\'") : 'top rival';
+    fills['SUGGESTED_NEXT_HTML'] = isEmptyCoverage
+        ? `<div style="display:flex;flex-wrap:wrap;gap:6px;">
+        <button class="btn-out" onclick="sendPrompt('Explore broader trends in ${safeBrandName}\\'s category')">Category trends</button>
+        <button class="btn-out" onclick="sendPrompt('Find domain specialists who cover ${safeBrandName}\\'s space')">Find expert</button>
+        <button class="btn-out" onclick="sendPrompt('Search market research on ${safeBrandName}')">Market research</button>
+    </div>`
+        : `<div style="display:flex;flex-wrap:wrap;gap:6px;">
+        <button class="btn-out" onclick="sendPrompt('What are other brands alongside ${safeBrandName} doing differently?')">Category landscape</button>
         <button class="btn-out" onclick="sendPrompt('Show me the evidence behind the strongest trend for ${safeBrandName}')">Deep dive</button>
         <button class="btn-out" onclick="sendPrompt('Compare ${safeBrandName} vs ${safeCompName}')">Head-to-head</button>
     </div>`;
@@ -846,6 +983,7 @@ export const TEMPLATE = `
 .vc-build{color:var(--color-text-info);}
 .vc-steady{color:var(--color-text-secondary);}
 .vc-slow{color:var(--color-text-warning);}
+.vc-untracked{color:var(--color-text-secondary);opacity:0.7;}
 .pv{font-size:14px;font-family:Georgia,serif;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);}
 .lcb{display:flex;height:8px;border-radius:4px;overflow:hidden;margin-bottom:.75rem;gap:2px;}
 .lcl{display:flex;gap:12px;margin-bottom:1.25rem;flex-wrap:wrap;}
@@ -940,48 +1078,18 @@ export const TEMPLATE = `
 
   <div class="pv">{{ONE_LINER}}</div>
 
-  <div class="sec">Case Studies</div>
-  {{EVIDENCE_HTML}}
+  {{EMPTY_STATE_CALLOUT_HTML}}
+
+  {{CASE_STUDIES_SECTION_HTML}}
 
   {{EARNINGS_SECTION_HTML}}
   {{FINANCIAL_SNAPSHOT_SECTION_HTML}}
 
-  <div class="sec">Relevant trends</div>
-  {{TREND_FOOTPRINT_INTRO}}
-  <div class="lcb">{{LIFECYCLE_BAR}}</div>
-  <div class="lcl">{{LIFECYCLE_LEGEND}}</div>
-  {{TRENDS_HTML}}
-  {{WEAK_SIGNALS_HTML}}
+  {{TRENDS_SECTION_HTML}}
 
   {{COMPETITIVE_SECTION_HTML}}
 
-  <div class="sec">Market data</div>
-  {{MARKET_DATA_INTRO}}
-  <div class="sl2">US retail sales — Census Bureau</div>
-  <div class="sg">
-    <div class="sk"><div class="skl">{{BEA_STAT_1_LABEL}}</div><div class="skv">{{BEA_STAT_1_VALUE}}</div><div class="sks">{{BEA_STAT_1_SUB}}</div></div>
-    <div class="sk"><div class="skl">{{BEA_STAT_2_LABEL}}</div><div class="skv">{{BEA_STAT_2_VALUE}}</div><div class="sks">{{BEA_STAT_2_SUB}}</div></div>
-  </div>
-
-  {{GT_SECTION_HTML}}
-  {{GT_COMPARISON_SECTION_HTML}}
-  {{RELATED_QUERIES_SECTION_HTML}}
-
-  <div class="sl2">Wikipedia — avg daily pageviews</div>
-  {{WIKI_BARS_HTML}}
-  <p class="note">{{WIKI_NOTE}}</p>
-
-  <div class="sl2">Amazon footprint</div>
-  <div class="sg">
-    <div class="sk"><div class="skl">{{AMAZON_STAT_1_LABEL}}</div><div class="skv">{{AMAZON_STAT_1_VALUE}}</div><div class="sks">{{AMAZON_STAT_1_SUB}}</div></div>
-    <div class="sk"><div class="skl">{{AMAZON_STAT_2_LABEL}}</div><div class="skv">{{AMAZON_STAT_2_VALUE}}</div><div class="sks">{{AMAZON_STAT_2_SUB}}</div></div>
-    <div class="sk"><div class="skl">{{AMAZON_STAT_3_LABEL}}</div><div class="skv">{{AMAZON_STAT_3_VALUE}}</div><div class="sks">{{AMAZON_STAT_3_SUB}}</div></div>
-    <div class="sk"><div class="skl">{{AMAZON_STAT_4_LABEL}}</div><div class="skv">{{AMAZON_STAT_4_VALUE}}</div><div class="sks">{{AMAZON_STAT_4_SUB}}</div></div>
-  </div>
-  {{AMAZON_PRODUCTS_HTML}}
-  <p class="note">{{AMAZON_CAPTION}}</p>
-
-  {{GEO_SECTION_HTML}}
+  {{MARKET_DATA_SECTION_HTML}}
 
   <div class="sec">Explore further</div>
   {{SUGGESTED_NEXT_HTML}}