feat(export): add country evidence bundles (#4283)

* feat(export): add country evidence bundles

* fix(export): harden evidence bundle markdown

* fix(export): strengthen evidence bundle redaction

* fix(export): redact source URL secrets

* fix(export): avoid redacting ordinary colon prose

---------

Co-authored-by: e <e@e.co>

Author: koala73

docs/ai-intelligence.mdx

@@ -69,7 +69,7 @@ Clicking any country on the map opens a full-page intelligence dossier — a sin
 
 **Headline relevance filtering**: each country has an alias map (e.g., `US → ["united states", "american", "washington", "pentagon", "biden", "trump"]`). Headlines are filtered using a negative-match algorithm — if another country's alias appears earlier in the headline title than the target country's alias, the headline is excluded. This prevents cross-contamination (e.g., a headline about Venezuela mentioning "Washington sanctions" appearing in the US brief).
 
-**Export options**: briefs are exportable as JSON (structured data with all scores, signals, and headlines), CSV (flattened tabular format), or PNG image. A print button triggers the browser's native print dialog for PDF export.
+**Export options**: briefs are exportable as JSON (structured data with all scores, signals, and headlines), CSV (flattened tabular format), PNG image, or a portable evidence Markdown bundle with selected signals, cited source links when available, freshness notes, and provenance disclaimers. A print button triggers the browser's native print dialog for PDF export.
 
 ### Local-First Country Detection
 

docs/features.mdx

@@ -274,6 +274,7 @@ The full panel inventory lives in the app itself — Cmd+K surfaces what's avail
 ## Data Export
 
 - CSV and JSON export of current dashboard state
+- Country dossier evidence bundles as portable Markdown with source links and freshness notes where available
 - Historical playback from snapshots
 
 ---

src/components/CountryBriefPage.ts

@@ -11,8 +11,8 @@ import type { CountryBriefPanel, CountryIntelData, StockIndexData } from '@/comp
 import { getNearbyInfrastructure, haversineDistanceKm } from '@/services/related-assets';
 import { PORTS } from '@/config/ports';
 import type { Port } from '@/types';
-import { exportCountryBriefJSON, exportCountryBriefCSV } from '@/utils/export';
-import type { CountryBriefExport } from '@/utils/export';
+import { exportCountryBriefJSON, exportCountryBriefCSV, exportCountryEvidenceMarkdown } from '@/utils/export';
+import type { CountryBriefExport, CountryEvidenceBundleInput } from '@/utils/export';
 import { ME_STRIKE_BOUNDS } from '@/services/country-geometry';
 import { toFlagEmoji } from '@/utils/country-flag';
 import { setTrustedHtml, trustedHtml } from '@/utils/dom-utils';
@@ -60,6 +60,8 @@ export class CountryBriefPage implements CountryBriefPanel {
   private currentScore: CountryScore | null = null;
   private currentSignals: CountryBriefSignals | null = null;
   private currentBrief: string | null = null;
+  private currentBriefGeneratedAt: string | null = null;
+  private currentBriefCached: boolean | null = null;
   private currentHeadlines: NewsItem[] = [];
   private onCloseCallback?: () => void;
   private onShareStory?: (code: string, name: string) => void;
@@ -133,7 +135,7 @@ export class CountryBriefPage implements CountryBriefPanel {
           }
         } else if (format === 'pdf') {
           this.exportPdf();
-        } else if (format === 'json' || format === 'csv') {
+        } else if (format === 'json' || format === 'csv' || format === 'evidence-md') {
           this.exportBrief(format);
         }
         const exportMenu = this.overlay.querySelector('.cb-export-menu');
@@ -375,6 +377,8 @@ export class CountryBriefPage implements CountryBriefPanel {
     this.currentScore = score;
     this.currentSignals = signals;
     this.currentBrief = null;
+    this.currentBriefGeneratedAt = null;
+    this.currentBriefCached = null;
     this.currentHeadlines = [];
     this.currentHeadlineCount = 0;
     const flag = this.countryFlag(code);
@@ -412,6 +416,7 @@ export class CountryBriefPage implements CountryBriefPanel {
                 <button class="cb-export-option" data-format="pdf">${t('common.exportPdf')}</button>
                 <button class="cb-export-option" data-format="json">${t('common.exportJson')}</button>
                 <button class="cb-export-option" data-format="csv">${t('common.exportCsv')}</button>
+                <button class="cb-export-option" data-format="evidence-md">Evidence Markdown</button>
               </div>
             </div>
             <button class="cb-close" aria-label="${t('components.newsPanel.close')}">×</button>
@@ -505,6 +510,8 @@ export class CountryBriefPage implements CountryBriefPanel {
     }
 
     this.currentBrief = data.brief;
+    this.currentBriefGeneratedAt = data.generatedAt ?? null;
+    this.currentBriefCached = data.cached === true;
     const formatted = this.formatBrief(data.brief, this.currentHeadlineCount);
     setTrustedHtml(section, trustedHtml(`
       <div class="cb-brief-text">${formatted}</div>
@@ -664,12 +671,15 @@ export class CountryBriefPage implements CountryBriefPanel {
     return formatIntelBrief(text, headlineCount > 0 ? { count: headlineCount, hrefPrefix: '#cb-news-' } : undefined);
   }
 
-  private exportBrief(format: 'json' | 'csv'): void {
+  private exportBrief(format: 'json' | 'csv' | 'evidence-md'): void {
     if (!this.currentCode || !this.currentName) return;
-    const data: CountryBriefExport = {
+    const exportedAt = new Date().toISOString();
+    const data: CountryBriefExport & CountryEvidenceBundleInput = {
       country: this.currentName,
       code: this.currentCode,
-      generatedAt: new Date().toISOString(),
+      context: 'Country dossier',
+      generatedAt: exportedAt,
+      exportedAt,
     };
     if (this.currentScore) {
       data.score = this.currentScore.score;
@@ -703,6 +713,8 @@ export class CountryBriefPage implements CountryBriefPanel {
       };
     }
     if (this.currentBrief) data.brief = this.currentBrief;
+    if (this.currentBriefGeneratedAt) data.briefGeneratedAt = this.currentBriefGeneratedAt;
+    if (this.currentBriefCached != null) data.briefCached = this.currentBriefCached;
     if (this.currentHeadlines.length > 0) {
       data.headlines = this.currentHeadlines.map(h => ({
         title: h.title,
@@ -711,7 +723,8 @@ export class CountryBriefPage implements CountryBriefPanel {
         pubDate: h.pubDate ? new Date(h.pubDate).toISOString() : undefined,
       }));
     }
-    if (format === 'json') exportCountryBriefJSON(data);
+    if (format === 'evidence-md') exportCountryEvidenceMarkdown(data);
+    else if (format === 'json') exportCountryBriefJSON(data);
     else exportCountryBriefCSV(data);
   }
 

src/components/CountryDeepDivePanel.ts

@@ -44,6 +44,8 @@ import type { MapContainer } from './MapContainer';
 import { dedupeHeadlines } from './CountryDeepDivePanel-news-utils';
 import { renderFollowButton } from '@/utils/follow-button';
 import { renderNotifyCountryLink } from '@/utils/notify-country-link';
+import { exportCountryEvidenceMarkdown } from '@/utils/export';
+import type { CountryEvidenceBundleInput } from '@/utils/export';
 
 const DEPENDENCY_FLAG_LABELS: Record<string, { text: string; cls: string }> = {
   DEPENDENCY_FLAG_SINGLE_SOURCE_CRITICAL:   { text: 'Single Source',   cls: 'cdp-dep-critical' },
@@ -96,6 +98,12 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
   private closeButton: HTMLButtonElement;
   private currentCode: string | null = null;
   private currentName: string | null = null;
+  private currentScore: CountryScore | null = null;
+  private currentSignals: CountryBriefSignals | null = null;
+  private currentBrief: string | null = null;
+  private currentBriefGeneratedAt: string | null = null;
+  private currentBriefCached: boolean | null = null;
+  private currentHeadlines: NewsItem[] = [];
   private isMaximizedState = false;
   private onCloseCallback?: () => void;
   private onStateChangeCallback?: (state: { visible: boolean; maximized: boolean }) => void;
@@ -261,6 +269,13 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
     this.abortController = new AbortController();
     this.currentCode = code;
     this.currentName = country;
+    this.currentScore = score;
+    this.currentSignals = signals;
+    this.currentBrief = null;
+    this.currentBriefGeneratedAt = null;
+    this.currentBriefCached = null;
+    this.currentHeadlines = [];
+    this.currentHeadlineCount = 0;
     this.economicIndicators = [];
     this.infrastructureByType.clear();
     this.renderSkeleton(country, code, score, signals);
@@ -280,6 +295,12 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
     this.close();
     this.currentCode = null;
     this.currentName = null;
+    this.currentScore = null;
+    this.currentSignals = null;
+    this.currentBrief = null;
+    this.currentBriefGeneratedAt = null;
+    this.currentBriefCached = null;
+    this.currentHeadlines = [];
     this.onCloseCallback?.();
     this.onStateChangeCallback?.({ visible: false, maximized: false });
   }
@@ -337,6 +358,7 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
   public updateNews(headlines: NewsItem[]): void {
     if (!this.newsBody) return;
     this.newsBody.replaceChildren();
+    this.currentHeadlines = [];
 
     const compare = (a: NewsItem, b: NewsItem) => {
       const sa = SEVERITY_ORDER[this.toThreatLevel(a.threat?.level)];
@@ -352,6 +374,7 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
       .slice(0, 10);
 
     this.currentHeadlineCount = deduped.length;
+    this.currentHeadlines = deduped.map(({ item }) => item);
 
     if (deduped.length === 0) {
       this.newsBody.append(this.makeEmpty(t('countryBrief.noNews')));
@@ -2309,10 +2332,17 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
     this.briefBody.replaceChildren();
 
     if (data.error || data.skipped || !data.brief) {
+      this.currentBrief = null;
+      this.currentBriefGeneratedAt = null;
+      this.currentBriefCached = null;
       this.briefBody.append(this.makeEmpty(data.error || data.reason || t('countryBrief.assessmentUnavailable')));
       return;
     }
 
+    this.currentBrief = data.brief;
+    this.currentBriefGeneratedAt = data.generatedAt ?? null;
+    this.currentBriefCached = data.cached === true;
+
     const summaryHtml = this.formatBrief(this.summarizeBrief(data.brief), 0);
     const text = this.el('div', 'cdp-assessment-text cdp-summary-only');
     setTrustedHtml(text, trustedHtml(summaryHtml, "legacy direct innerHTML migration"));
@@ -2424,7 +2454,13 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
         this.onExportImage(this.currentCode, this.currentName);
       }
     });
-    right.append(shareBtn, maxBtn, storyButton, exportButton);
+    const evidenceButton = this.el('button', 'cdp-action-btn cdp-evidence-export-btn', 'Evidence') as HTMLButtonElement;
+    evidenceButton.setAttribute('type', 'button');
+    evidenceButton.setAttribute('title', 'Export evidence bundle as Markdown');
+    evidenceButton.addEventListener('click', () => {
+      this.exportEvidenceBundle();
+    });
+    right.append(shareBtn, maxBtn, storyButton, exportButton, evidenceButton);
     header.append(left, right);
 
     const scoreCard = this.el('section', 'cdp-card cdp-score-card');
@@ -2918,6 +2954,67 @@ export class CountryDeepDivePanel implements CountryBriefPanel {
     return formatIntelBrief(text, headlineCount > 0 ? { count: headlineCount, hrefPrefix: '#cdp-news-' } : undefined);
   }
 
+  private exportEvidenceBundle(): void {
+    if (!this.currentCode || !this.currentName) return;
+    const exportedAt = new Date().toISOString();
+    const data: CountryEvidenceBundleInput = {
+      country: this.currentName,
+      code: this.currentCode,
+      context: 'Country dossier',
+      generatedAt: exportedAt,
+      exportedAt,
+    };
+
+    if (this.currentScore) {
+      data.score = this.currentScore.score;
+      data.level = this.currentScore.level;
+      data.trend = this.currentScore.trend;
+      data.components = this.currentScore.components;
+    }
+    if (this.currentSignals) {
+      data.signals = {
+        criticalNews: this.currentSignals.criticalNews,
+        protests: this.currentSignals.protests,
+        militaryFlights: this.currentSignals.militaryFlights,
+        militaryVessels: this.currentSignals.militaryVessels,
+        militaryFlightsInCountry: this.currentSignals.militaryFlightsInCountry,
+        militaryVesselsInCountry: this.currentSignals.militaryVesselsInCountry,
+        outages: this.currentSignals.outages,
+        aisDisruptions: this.currentSignals.aisDisruptions,
+        satelliteFires: this.currentSignals.satelliteFires,
+        radiationAnomalies: this.currentSignals.radiationAnomalies,
+        temporalAnomalies: this.currentSignals.temporalAnomalies,
+        cyberThreats: this.currentSignals.cyberThreats,
+        earthquakes: this.currentSignals.earthquakes,
+        displacementOutflow: this.currentSignals.displacementOutflow,
+        climateStress: this.currentSignals.climateStress,
+        conflictEvents: this.currentSignals.conflictEvents,
+        activeStrikes: this.currentSignals.activeStrikes,
+        orefSirens: this.currentSignals.orefSirens,
+        orefHistory24h: this.currentSignals.orefHistory24h,
+        aviationDisruptions: this.currentSignals.aviationDisruptions,
+        travelAdvisories: this.currentSignals.travelAdvisories,
+        travelAdvisoryMaxLevel: this.currentSignals.travelAdvisoryMaxLevel,
+        gpsJammingHexes: this.currentSignals.gpsJammingHexes,
+        thermalEscalations: this.currentSignals.thermalEscalations,
+        sanctionsDesignations: this.currentSignals.sanctionsDesignations,
+        sanctionsNewDesignations: this.currentSignals.sanctionsNewDesignations,
+      };
+    }
+    if (this.currentBrief) data.brief = this.currentBrief;
+    if (this.currentBriefGeneratedAt) data.briefGeneratedAt = this.currentBriefGeneratedAt;
+    if (this.currentBriefCached != null) data.briefCached = this.currentBriefCached;
+    if (this.currentHeadlines.length > 0) {
+      data.headlines = this.currentHeadlines.map((headline) => ({
+        title: headline.title,
+        source: headline.source,
+        link: headline.link,
+        pubDate: headline.pubDate ? new Date(headline.pubDate).toISOString() : undefined,
+      }));
+    }
+    exportCountryEvidenceMarkdown(data);
+  }
+
   private summarizeBrief(brief: string): string {
     const stripped = brief.replace(/\*\*(.*?)\*\*/g, '$1');
     const lines = stripped.split('\n').map((l) => l.trim()).filter((l) => l.length > 0);