seo-intel 1.4.2 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.4.3 (2026-04-07)
+
+### Dashboard: Export & Download
+- Per-card download buttons (Markdown, JSON, CSV) on every dashboard card
+- "Download All Reports (ZIP)" in export sidebar
+- New `/api/export/download` endpoint with section filtering
+
+### Improvements
+- GSC data loader picks most recently modified folder (fixes stale folder selection)
+- Report filenames use `YYYY-MM-DD` dates instead of Unix timestamps
+- Setup wizard: multi-host Ollama support (`OLLAMA_HOSTS` env var)
+- Skill file and Agent Guide updated with `watch`, `blog-draft`, and export features
+
+### Cleanup
+- Removed deprecated agentic setup banner from wizard
+- Consolidated Agent Guide into `skill/` directory
+
 ## 1.4.2 (2026-04-05)
 
 ### New Feature: Site Watch

package/cli.js

@@ -742,9 +742,9 @@ program
     console.log(chalk.yellow('Sending to Gemini...\n'));
 
     // Save prompt for debugging (markdown for Obsidian/agent compatibility)
-    const promptTs = Date.now();
+    const promptTs = new Date().toISOString().slice(0, 10);
     const promptPath = join(__dirname, `reports/${project}-prompt-${promptTs}.md`);
-    const promptFrontmatter = `---\nproject: ${project}\ngenerated: ${new Date(promptTs).toISOString()}\ntype: analysis-prompt\nmodel: gemini\n---\n\n`;
+    const promptFrontmatter = `---\nproject: ${project}\ngenerated: ${new Date().toISOString()}\ntype: analysis-prompt\nmodel: gemini\n---\n\n`;
     writeFileSync(promptPath, promptFrontmatter + prompt, 'utf8');
     console.log(chalk.gray(`Prompt saved: ${promptPath}`));
 
@@ -764,13 +764,13 @@ program
       analysis = JSON.parse(jsonMatch[0]);
     } catch {
       console.error(chalk.red('Could not parse JSON from response. Saving raw output.'));
-      const rawPath = join(__dirname, `reports/${project}-raw-${Date.now()}.md`);
+      const rawPath = join(__dirname, `reports/${project}-raw-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(rawPath, result, 'utf8');
       process.exit(1);
     }
 
     // Save structured analysis to file
-    const outPath = join(__dirname, `reports/${project}-analysis-${Date.now()}.json`);
+    const outPath = join(__dirname, `reports/${project}-analysis-${new Date().toISOString().slice(0, 10)}.json`);
     writeFileSync(outPath, JSON.stringify(analysis, null, 2), 'utf8');
 
     // Save to DB (so HTML dashboard picks it up)
@@ -930,7 +930,7 @@ Respond ONLY with a single valid JSON object matching this exact schema. No expl
       data = JSON.parse(jsonMatch[0]);
     } catch {
       console.error(chalk.red('Could not parse JSON from Gemini response.'));
-      const rawPath = join(__dirname, `reports/${project}-keywords-raw-${Date.now()}.md`);
+      const rawPath = join(__dirname, `reports/${project}-keywords-raw-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(rawPath, result, 'utf8');
       console.error(chalk.gray(`Raw output saved: ${rawPath}`));
       process.exit(1);
@@ -991,7 +991,7 @@ Respond ONLY with a single valid JSON object matching this exact schema. No expl
     }
 
     if (opts.save) {
-      const outPath = join(__dirname, `reports/${project}-keywords-${Date.now()}.json`);
+      const outPath = join(__dirname, `reports/${project}-keywords-${new Date().toISOString().slice(0, 10)}.json`);
       writeFileSync(outPath, JSON.stringify(data, null, 2), 'utf8');
       console.log(chalk.bold.green(`✅ Report saved: ${outPath}\n`));
 
@@ -1759,7 +1759,7 @@ async function runAnalysis(project, db) {
   try {
     const jsonMatch = result.match(/\{[\s\S]*\}/);
     const analysis = JSON.parse(jsonMatch[0]);
-    const outPath = join(__dirname, `reports/${project}-analysis-${Date.now()}.json`);
+    const outPath = join(__dirname, `reports/${project}-analysis-${new Date().toISOString().slice(0, 10)}.json`);
     writeFileSync(outPath, JSON.stringify(analysis, null, 2), 'utf8');
 
     // Save to DB
@@ -2410,7 +2410,7 @@ program
       report += `> Analyze this heading structure from ${page.domain}. What H2/H3 sub-topics are logically missing? What would a user expect to find that isn't covered? Be specific.\n\n---\n\n`;
     }
 
-    const outPath = join(__dirname, `reports/${project}-headings-audit-${Date.now()}.md`);
+    const outPath = join(__dirname, `reports/${project}-headings-audit-${new Date().toISOString().slice(0, 10)}.md`);
     writeFileSync(outPath, report, 'utf8');
 
     console.log(chalk.bold.green(`\n✅ Full audit saved: ${outPath}`));
@@ -2672,7 +2672,7 @@ program
 
     // ── Save ──
     if (opts.save) {
-      const outPath = join(__dirname, `reports/${project}-entities-${Date.now()}.md`);
+      const outPath = join(__dirname, `reports/${project}-entities-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(outPath, mdOutput, 'utf8');
       console.log(chalk.bold.green(`  ✅ Entity map saved: ${outPath}\n`));
     }
@@ -3369,7 +3369,7 @@ program
 
     // ── Save ──
     if (opts.save) {
-      const outPath = join(__dirname, `reports/${project}-brief-${Date.now()}.md`);
+      const outPath = join(__dirname, `reports/${project}-brief-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(outPath, mdOutput, 'utf8');
       console.log(chalk.bold.green(`  ✅ Brief saved: ${outPath}\n`));
     }
@@ -3713,7 +3713,7 @@ program
     }
 
     if (opts.save) {
-      const outPath = join(__dirname, `reports/${project}-js-delta-${Date.now()}.md`);
+      const outPath = join(__dirname, `reports/${project}-js-delta-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(outPath, mdOutput, 'utf8');
       console.log(chalk.bold.green(`  ✅ Report saved: ${outPath}\n`));
     }
@@ -3859,7 +3859,7 @@ program
     }
 
     // Output
-    const timestamp = Date.now();
+    const timestamp = new Date().toISOString().slice(0, 10);
     const defaultPath = join(__dirname, `reports/${project}-export-${timestamp}.${format}`);
     const outPath = opts.output || defaultPath;
 
@@ -4237,7 +4237,7 @@ program
       for (const p of worst) {
         md += `- **${p.url}** — ${p.score}/100 (${p.tier})\n`;
       }
-      const outPath = join(__dirname, `reports/${project}-aeo-${Date.now()}.md`);
+      const outPath = join(__dirname, `reports/${project}-aeo-${new Date().toISOString().slice(0, 10)}.md`);
       writeFileSync(outPath, md, 'utf8');
       console.log(chalk.bold.green(`  ✅ Report saved: ${outPath}\n`));
     }
@@ -4521,7 +4521,7 @@ program
       const slug = opts.topic
         ? opts.topic.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50)
         : 'auto';
-      const filename = `${project}-blog-draft-${slug}-${Date.now()}.md`;
+      const filename = `${project}-blog-draft-${slug}-${new Date().toISOString().slice(0, 10)}.md`;
       const outPath = join(__dirname, 'reports', filename);
       writeFileSync(outPath, draft, 'utf8');
       console.log(chalk.bold.green(`  ✅ Draft saved: ${outPath}`));

package/lib/export-zip.js

@@ -0,0 +1,102 @@
+/**
+ * Minimal ZIP archive builder — zero dependencies.
+ * Creates valid ZIP files (uncompressed / STORE method) from an array of entries.
+ * Sufficient for text-based exports (MD, JSON, CSV) where deflate adds little value.
+ *
+ * Usage:
+ *   import { createZip } from './lib/export-zip.js';
+ *   const buf = createZip([{ name: 'report.md', content: '# Hello' }]);
+ *   res.end(buf);
+ */
+
+/**
+ * @param {{ name: string, content: string | Buffer }[]} entries
+ * @returns {Buffer} Valid ZIP archive
+ */
+export function createZip(entries) {
+  const localHeaders = [];
+  const centralHeaders = [];
+  let offset = 0;
+
+  for (const entry of entries) {
+    const nameBytes = Buffer.from(entry.name, 'utf8');
+    const data = typeof entry.content === 'string' ? Buffer.from(entry.content, 'utf8') : entry.content;
+    const crc = crc32(data);
+
+    // Local file header (30 + nameLen + dataLen)
+    const local = Buffer.alloc(30 + nameBytes.length);
+    local.writeUInt32LE(0x04034b50, 0);   // signature
+    local.writeUInt16LE(20, 4);            // version needed (2.0)
+    local.writeUInt16LE(0, 6);             // flags
+    local.writeUInt16LE(0, 8);             // compression: STORE
+    local.writeUInt16LE(0, 10);            // mod time
+    local.writeUInt16LE(0, 12);            // mod date
+    local.writeUInt32LE(crc, 14);          // crc-32
+    local.writeUInt32LE(data.length, 18);  // compressed size
+    local.writeUInt32LE(data.length, 22);  // uncompressed size
+    local.writeUInt16LE(nameBytes.length, 26); // filename length
+    local.writeUInt16LE(0, 28);            // extra field length
+    nameBytes.copy(local, 30);
+
+    localHeaders.push(Buffer.concat([local, data]));
+
+    // Central directory header (46 + nameLen)
+    const central = Buffer.alloc(46 + nameBytes.length);
+    central.writeUInt32LE(0x02014b50, 0);  // signature
+    central.writeUInt16LE(20, 4);          // version made by
+    central.writeUInt16LE(20, 6);          // version needed
+    central.writeUInt16LE(0, 8);           // flags
+    central.writeUInt16LE(0, 10);          // compression: STORE
+    central.writeUInt16LE(0, 12);          // mod time
+    central.writeUInt16LE(0, 14);          // mod date
+    central.writeUInt32LE(crc, 16);        // crc-32
+    central.writeUInt32LE(data.length, 20); // compressed size
+    central.writeUInt32LE(data.length, 24); // uncompressed size
+    central.writeUInt16LE(nameBytes.length, 28); // filename length
+    central.writeUInt16LE(0, 30);          // extra field length
+    central.writeUInt16LE(0, 32);          // comment length
+    central.writeUInt16LE(0, 34);          // disk number start
+    central.writeUInt16LE(0, 36);          // internal attrs
+    central.writeUInt32LE(0, 38);          // external attrs
+    central.writeUInt32LE(offset, 42);     // local header offset
+    nameBytes.copy(central, 46);
+
+    centralHeaders.push(central);
+    offset += local.length + data.length;
+  }
+
+  const centralDir = Buffer.concat(centralHeaders);
+  const centralDirOffset = offset;
+
+  // End of central directory record (22 bytes)
+  const eocd = Buffer.alloc(22);
+  eocd.writeUInt32LE(0x06054b50, 0);                // signature
+  eocd.writeUInt16LE(0, 4);                          // disk number
+  eocd.writeUInt16LE(0, 6);                          // disk with central dir
+  eocd.writeUInt16LE(entries.length, 8);              // entries on this disk
+  eocd.writeUInt16LE(entries.length, 10);             // total entries
+  eocd.writeUInt32LE(centralDir.length, 12);          // central dir size
+  eocd.writeUInt32LE(centralDirOffset, 16);           // central dir offset
+  eocd.writeUInt16LE(0, 20);                          // comment length
+
+  return Buffer.concat([...localHeaders, centralDir, eocd]);
+}
+
+// ─── CRC-32 (IEEE 802.3) ────────────────────────────────────────────────────
+
+const CRC_TABLE = new Uint32Array(256);
+for (let n = 0; n < 256; n++) {
+  let c = n;
+  for (let k = 0; k < 8; k++) {
+    c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
+  }
+  CRC_TABLE[n] = c;
+}
+
+function crc32(buf) {
+  let crc = 0xFFFFFFFF;
+  for (let i = 0; i < buf.length; i++) {
+    crc = CRC_TABLE[(crc ^ buf[i]) & 0xFF] ^ (crc >>> 8);
+  }
+  return (crc ^ 0xFFFFFFFF) >>> 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo-intel",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Local Ahrefs-style SEO competitor intelligence. Crawl → SQLite → cloud analysis.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",

package/reports/generate-html.js

@@ -24,13 +24,19 @@ import { getWatchData } from '../analyses/watch/index.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-/**
- * Generate HTML dashboard from database
- * @param {import('node:sqlite').DatabaseSync} db - SQLite database
- * @param {string} project - Project name (e.g., 'mysite')
- * @param {object} config - Project config
- * @returns {string} Path to generated HTML file
- */
+/** Build per-card export dropdown HTML */
+function cardExportHtml(section, project) {
+  return `<div class="card-export" data-project="${project}" data-section="${section}">
+    <button class="card-export-btn" title="Export"><i class="fa-solid fa-download"></i></button>
+    <div class="card-export-dropdown">
+      <button data-fmt="md"><i class="fa-solid fa-file-lines"></i> Markdown</button>
+      <button data-fmt="json"><i class="fa-solid fa-code"></i> JSON</button>
+      <button data-fmt="csv"><i class="fa-solid fa-table"></i> CSV</button>
+      <button data-fmt="zip"><i class="fa-solid fa-file-zipper"></i> ZIP (all)</button>
+    </div>
+  </div>`;
+}
+
 /**
  * Gather all dashboard data for a single project
  */
@@ -419,6 +425,32 @@ function buildHtmlTemplate(data, opts = {}) {
     .card.full-width {
       grid-column: 1 / -1;
     }
+    .card { position: relative; }
+    .card-export {
+      position: absolute; top: 10px; right: 10px; z-index: 5;
+    }
+    .card-export-btn {
+      background: var(--bg-elevated); border: 1px solid var(--border-subtle);
+      color: var(--text-muted); cursor: pointer; border-radius: var(--radius);
+      width: 28px; height: 28px; display: flex; align-items: center; justify-content: center;
+      font-size: 0.7rem; transition: all .15s;
+    }
+    .card-export-btn:hover { color: var(--accent-gold); border-color: var(--accent-gold); }
+    .card-export-dropdown {
+      display: none; position: absolute; right: 0; top: 32px;
+      background: var(--bg-card); border: 1px solid var(--border-card);
+      border-radius: var(--radius); min-width: 150px; padding: 4px 0;
+      box-shadow: 0 8px 24px rgba(0,0,0,.4);
+    }
+    .card-export.open .card-export-dropdown { display: block; }
+    .card-export-dropdown button {
+      display: flex; align-items: center; gap: 8px; width: 100%;
+      background: none; border: none; color: var(--text-secondary);
+      padding: 7px 14px; font-size: 0.72rem; cursor: pointer; text-align: left;
+      font-family: var(--font-body);
+    }
+    .card-export-dropdown button:hover { background: var(--bg-elevated); color: var(--text-primary); }
+    .card-export-dropdown button i { width: 14px; text-align: center; color: var(--text-muted); font-size: 0.65rem; }
 
     /* ─── Extraction Status Bar ─────────────────────────────────────────── */
     .extraction-status {
@@ -1798,7 +1830,7 @@ function buildHtmlTemplate(data, opts = {}) {
       </div>`}
 
       <!-- SITE WATCH -->
-      ${watchData?.current ? buildWatchCard(watchData, escapeHtml) : ''}
+      ${watchData?.current ? buildWatchCard(watchData, escapeHtml, project) : ''}
 
       <!-- PAGE INVENTORY -->
       <div class="card" style="margin-bottom:16px;">
@@ -2157,6 +2189,12 @@ function buildHtmlTemplate(data, opts = {}) {
         </div>
         <button class="export-btn" data-export-cmd="aeo" data-export-project="${project}"><i class="fa-solid fa-robot"></i> AI Citability Audit</button>
       </div>
+      <div class="export-sidebar-header" style="margin-top:12px;">
+        <i class="fa-solid fa-download"></i> Download
+      </div>
+      <div class="export-sidebar-btns">
+        <button class="export-btn download-all-btn" data-project="${project}"><i class="fa-solid fa-file-zipper"></i> Download All Reports (ZIP)</button>
+      </div>
       <div style="position:relative;">
         <div id="exportSaveStatus${suffix}" style="display:none;padding:4px 10px;font-size:.6rem;color:var(--color-success);background:rgba(80,200,120,0.06);border-bottom:1px solid rgba(80,200,120,0.15);font-family:'SF Mono',monospace;">
           <i class="fa-solid fa-check" style="margin-right:4px;"></i><span></span>
@@ -2516,6 +2554,49 @@ function buildHtmlTemplate(data, opts = {}) {
       });
     }
 
+    // ── Card export dropdowns (global — run once, capture phase) ──
+    if (!window._cardExportBound) {
+      window._cardExportBound = true;
+      document.addEventListener('click', function(e) {
+        var btn = e.target.closest('.card-export-btn');
+        var fmtBtn = e.target.closest('[data-fmt]');
+        if (btn) {
+          var wrap = btn.closest('.card-export');
+          if (wrap) {
+            e.stopImmediatePropagation();
+            var wasOpen = wrap.classList.contains('open');
+            document.querySelectorAll('.card-export.open').forEach(function(el) { el.classList.remove('open'); });
+            if (!wasOpen) wrap.classList.add('open');
+            return;
+          }
+        }
+        if (fmtBtn) {
+          var wrap2 = fmtBtn.closest('.card-export');
+          if (wrap2) {
+            e.stopImmediatePropagation();
+            wrap2.classList.remove('open');
+            var sec = wrap2.getAttribute('data-section');
+            var proj2 = wrap2.getAttribute('data-project');
+            var fmt = fmtBtn.getAttribute('data-fmt');
+            if (window.location.protocol.startsWith('http')) {
+              window.location = '/api/export/download?project=' + encodeURIComponent(proj2) + '&section=' + encodeURIComponent(sec) + '&format=' + encodeURIComponent(fmt);
+            }
+            return;
+          }
+        }
+        var dlBtn = e.target.closest('.download-all-btn');
+        if (dlBtn) {
+          var proj3 = dlBtn.getAttribute('data-project');
+          if (window.location.protocol.startsWith('http')) {
+            window.location = '/api/export/download?project=' + encodeURIComponent(proj3) + '&section=all&format=zip';
+          }
+          return;
+        }
+        // Outside click — close all open dropdowns
+        document.querySelectorAll('.card-export.open').forEach(function(el) { el.classList.remove('open'); });
+      }, true);
+    }
+
     // Input enter
     input.addEventListener('keydown', function(e) {
       if (e.key !== 'Enter') return;
@@ -2779,7 +2860,7 @@ function buildHtmlTemplate(data, opts = {}) {
     })() : ''}
 
     <!-- ═══ SITE WATCH ═══ -->
-    ${watchData?.current ? buildWatchCard(watchData, escapeHtml) : ''}
+    ${watchData?.current ? buildWatchCard(watchData, escapeHtml, project) : ''}
 
     <div class="section-divider">
       <div class="section-divider-line right"></div>
@@ -2835,6 +2916,7 @@ function buildHtmlTemplate(data, opts = {}) {
 
     <!-- ═══ HEADING DEPTH FLOW ═══ -->
     <div class="card full-width" id="heading-flow">
+      ${cardExportHtml('headings', project)}
       <h2><span class="icon"><i class="fa-solid fa-water"></i></span> Heading Depth Flow</h2>
       <canvas id="headingFlowCanvas${suffix}" width="1100" height="320"></canvas>
     </div>
@@ -2862,6 +2944,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ ENTITY TOPIC MAP ═══ -->
     ${pro && entityTopicMap.hasData ? `
     <div class="card full-width" id="entity-map">
+      ${cardExportHtml('insights', project)}
       <h2><span class="icon"><i class="fa-solid fa-map"></i></span> Entity Topic Map</h2>
       <div class="entity-map-grid">
         ${Object.entries(entityTopicMap.domainEntities).map(([domain, data]) => `
@@ -2886,6 +2969,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ KEYWORD BATTLEGROUND ═══ -->
     ${pro ? `
     <div class="card full-width" id="keyword-heatmap">
+      ${cardExportHtml('keywords', project)}
       <h2><span class="icon"><i class="fa-solid fa-shield-halved"></i></span> Keyword Battleground</h2>
       ${keywordHeatmap.keywords.length ? `
       <div class="table-wrapper">
@@ -2930,6 +3014,7 @@ function buildHtmlTemplate(data, opts = {}) {
 
     <!-- ═══ TECHNICAL SEO SCORECARD ═══ -->
     <div class="card full-width" id="technical-seo">
+      ${cardExportHtml('technical', project)}
       <h2><span class="icon"><i class="fa-solid fa-gear"></i></span> Technical SEO Scorecard</h2>
       <div class="scorecard-grid">
         ${technicalScores.map(ts => {
@@ -2998,6 +3083,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ TECHNICAL SEO GAPS ═══ -->
     ${pro && latestAnalysis?.technical_gaps?.length ? `
     <div class="card full-width" id="technical-gaps">
+      ${cardExportHtml('technical', project)}
       <h2><span class="icon"><i class="fa-solid fa-wrench"></i></span> Technical SEO Gaps</h2>
       <div class="analysis-table-wrap">
         <table class="analysis-table">
@@ -3026,6 +3112,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ QUICK WINS ═══ -->
     ${pro && latestAnalysis?.quick_wins?.length ? `
     <div class="card" id="quick-wins">
+      ${cardExportHtml('insights', project)}
       <h2><span class="icon"><i class="fa-solid fa-bolt"></i></span> Quick Wins</h2>
       <div class="analysis-table-wrap">
         <table class="analysis-table">
@@ -3048,6 +3135,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ NEW PAGES TO CREATE ═══ -->
     ${pro && latestAnalysis?.new_pages?.length ? `
     <div class="card" id="new-pages">
+      ${cardExportHtml('pages', project)}
       <h2><span class="icon"><i class="fa-solid fa-file-circle-plus"></i></span> New Pages to Create</h2>
       <div class="new-pages-grid" style="grid-template-columns: 1fr;">
         ${(latestAnalysis.new_pages).map(np => `
@@ -3100,6 +3188,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ CONTENT GAPS ═══ -->
     ${pro && latestAnalysis?.content_gaps?.length ? `
     <div class="card full-width" id="content-gaps">
+      ${cardExportHtml('insights', project)}
       <h2><span class="icon"><i class="fa-solid fa-magnifying-glass-minus"></i></span> Content Gaps</h2>
       <div class="insights-grid">
         ${(latestAnalysis.content_gaps).map(gap => `
@@ -3308,6 +3397,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ SCHEMA TYPE BREAKDOWN ═══ -->
     ${schemaBreakdown.hasData ? `
     <div class="card" id="schema-breakdown">
+      ${cardExportHtml('schemas', project)}
       <h2><span class="icon"><i class="fa-solid fa-code"></i></span> Schema Markup Breakdown</h2>
       <div class="table-wrapper">
         <table>
@@ -3334,6 +3424,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <!-- ═══ TOP KEYWORDS ═══ -->
     ${pro ? `
     <div class="card" id="top-keywords">
+      ${cardExportHtml('keywords', project)}
       <h2><span class="icon"><i class="fa-solid fa-key"></i></span> Top Keywords (${targetDomain})</h2>
       ${keywords.length ? `
       <div class="table-wrapper" style="max-height: 400px; overflow-y: auto;">
@@ -3369,6 +3460,7 @@ function buildHtmlTemplate(data, opts = {}) {
 
     <!-- ═══ INTERNAL LINK ANALYSIS ═══ -->
     <div class="card" id="internal-links">
+      ${cardExportHtml('links', project)}
       <h2><span class="icon"><i class="fa-solid fa-link"></i></span> Internal Link Analysis</h2>
       <div class="stat-row">
         <div class="stat-box">
@@ -3407,7 +3499,7 @@ function buildHtmlTemplate(data, opts = {}) {
     </div>` : ''}
 
     <!-- ═══ AEO / AI CITABILITY AUDIT ═══ -->
-    ${pro && citabilityData?.length ? buildAeoCard(citabilityData, escapeHtml) : ''}
+    ${pro && citabilityData?.length ? buildAeoCard(citabilityData, escapeHtml, project) : ''}
 
     <!-- ═══ LONG-TAIL OPPORTUNITIES ═══ -->
     ${pro && latestAnalysis?.long_tails?.length ? `
@@ -5232,7 +5324,7 @@ function buildMultiHtmlTemplate(allProjectData) {
 
 // ─── AEO Card Builder ────────────────────────────────────────────────────────
 
-function buildAeoCard(citabilityData, escapeHtml) {
+function buildAeoCard(citabilityData, escapeHtml, project) {
   const targetScores = citabilityData.filter(s => s.role === 'target' || s.role === 'owned');
   const compScores = citabilityData.filter(s => s.role === 'competitor');
   if (!targetScores.length) return '';
@@ -5296,6 +5388,7 @@ function buildAeoCard(citabilityData, escapeHtml) {
 
   return `
     <div class="card full-width" id="aeo-citability">
+      ${cardExportHtml('aeo', project)}
       <h2><span class="icon"><i class="fa-solid fa-robot"></i></span> AI Citability Audit</h2>
       <div class="ki-stat-bar">
         <div class="ki-stat"><span class="ki-stat-number" style="color:${scoreColor(avgTarget)}">${avgTarget}</span><span class="ki-stat-label">Target Avg</span></div>
@@ -6886,7 +6979,7 @@ function getGscInsights(gscData, db, project) {
 // SITE WATCH CARD
 // ═══════════════════════════════════════════════════════════════════════════
 
-function buildWatchCard(watchData, escapeHtml) {
+function buildWatchCard(watchData, escapeHtml, project) {
   const { current, previous, events, trend } = watchData;
   const score = current.health_score ?? 0;
   const scoreColor = score >= 80 ? 'var(--color-success)' : score >= 60 ? 'var(--color-warning)' : 'var(--color-danger)';
@@ -6942,6 +7035,7 @@ function buildWatchCard(watchData, escapeHtml) {
 
   return `
   <div class="card" style="margin-bottom:16px;">
+    ${cardExportHtml('watch', project)}
     <h2><span class="icon"><i class="fa-solid fa-eye"></i></span> Site Watch</h2>
 
     <!-- Health Score + Summary -->

package/server.js

@@ -96,6 +96,8 @@ const MIME = {
   '.png': 'image/png',
   '.svg': 'image/svg+xml',
   '.md': 'text/markdown; charset=utf-8',
+  '.csv': 'text/csv; charset=utf-8',
+  '.zip': 'application/zip',
 };
 
 // ── Read progress with PID liveness check (mirrors cli.js) ──
@@ -449,7 +451,7 @@ async function handleRequest(req, res) {
 
         try {
           const data = JSON.parse(rawJson);
-          const stamp = Date.now();
+          const stamp = new Date().toISOString().slice(0, 10);
           const baseName = `${project}-actions-${stamp}`;
           writeFileSync(join(REPORTS_DIR, `${baseName}.json`), JSON.stringify(data, null, 2), 'utf8');
           writeFileSync(join(REPORTS_DIR, `${baseName}.md`), buildActionsMarkdown(data), 'utf8');
@@ -586,6 +588,313 @@ async function handleRequest(req, res) {
     return;
   }
 
+  // ─── API: Universal Export Download ───
+  if (req.method === 'GET' && path === '/api/export/download') {
+    try {
+      const project = url.searchParams.get('project');
+      const section = url.searchParams.get('section') || 'all';
+      const format = url.searchParams.get('format') || 'json';
+
+      if (!project) { json(res, 400, { error: 'Missing project' }); return; }
+
+      const { getDb } = await import('./db/db.js');
+      const db = getDb(join(__dirname, 'seo-intel.db'));
+      const configPath = join(__dirname, 'config', `${project}.json`);
+      const config = existsSync(configPath) ? JSON.parse(readFileSync(configPath, 'utf8')) : null;
+
+      const dateStr = new Date().toISOString().slice(0, 10);
+      const { createZip } = await import('./lib/export-zip.js');
+
+      const SECTIONS = ['aeo', 'insights', 'technical', 'keywords', 'pages', 'watch', 'schemas', 'headings', 'links'];
+
+      function querySection(sec) {
+        switch (sec) {
+          case 'aeo': {
+            try {
+              return db.prepare(`
+                SELECT cs.score, cs.entity_authority, cs.structured_claims, cs.answer_density,
+                       cs.qa_proximity, cs.freshness, cs.schema_coverage, cs.tier, cs.ai_intents,
+                       p.url, p.title, p.word_count, d.domain, d.role
+                FROM citability_scores cs
+                JOIN pages p ON p.id = cs.page_id
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                ORDER BY d.role ASC, cs.score ASC
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'insights': {
+            try {
+              const rows = db.prepare(
+                `SELECT * FROM insights WHERE project = ? AND status = 'active' ORDER BY type, last_seen DESC`
+              ).all(project);
+              return rows.map(r => {
+                try { return { ...JSON.parse(r.data), _type: r.type, _id: r.id, _first_seen: r.first_seen, _last_seen: r.last_seen }; }
+                catch { return { _type: r.type, _id: r.id, raw: r.data }; }
+              });
+            } catch { return []; }
+          }
+          case 'technical': {
+            try {
+              return db.prepare(`
+                SELECT p.url, p.status_code, p.word_count, p.load_ms, p.is_indexable, p.click_depth,
+                       t.has_canonical, t.has_og_tags, t.has_schema, t.has_robots, t.is_mobile_ok,
+                       d.domain, d.role
+                FROM pages p
+                JOIN domains d ON d.id = p.domain_id
+                LEFT JOIN technical t ON t.page_id = p.id
+                WHERE d.project = ?
+                ORDER BY d.domain, p.url
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'keywords': {
+            try {
+              return db.prepare(`
+                SELECT k.keyword, d.domain, d.role, k.location, COUNT(*) as freq
+                FROM keywords k
+                JOIN pages p ON p.id = k.page_id
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                GROUP BY k.keyword, d.domain
+                ORDER BY freq DESC
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'pages': {
+            try {
+              return db.prepare(`
+                SELECT p.url, p.status_code, p.word_count, p.load_ms, p.is_indexable, p.click_depth,
+                       p.title, p.meta_desc, p.published_date, p.modified_date,
+                       p.crawled_at, p.first_seen_at, d.domain, d.role
+                FROM pages p
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                ORDER BY d.domain, p.url
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'watch': {
+            try {
+              const snap = db.prepare('SELECT * FROM watch_snapshots WHERE project = ? ORDER BY created_at DESC LIMIT 1').get(project);
+              if (!snap) return [];
+              const events = db.prepare('SELECT * FROM watch_events WHERE snapshot_id = ? ORDER BY severity, event_type').all(snap.id);
+              const pages = db.prepare('SELECT * FROM watch_page_states WHERE snapshot_id = ?').all(snap.id);
+              return { snapshot: snap, events, pages };
+            } catch { return []; }
+          }
+          case 'schemas': {
+            try {
+              return db.prepare(`
+                SELECT d.domain, d.role, p.url, ps.schema_type, ps.name, ps.description,
+                       ps.rating, ps.rating_count, ps.price, ps.currency, ps.author,
+                       ps.date_published, ps.date_modified
+                FROM page_schemas ps
+                JOIN pages p ON p.id = ps.page_id
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                ORDER BY d.domain, ps.schema_type
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'headings': {
+            try {
+              return db.prepare(`
+                SELECT d.domain, d.role, p.url, h.level, h.text
+                FROM headings h
+                JOIN pages p ON p.id = h.page_id
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                ORDER BY d.domain, p.url, h.level
+              `).all(project);
+            } catch { return []; }
+          }
+          case 'links': {
+            try {
+              return db.prepare(`
+                SELECT l.source_page_id, l.target_url, l.anchor_text, l.is_internal,
+                       p.url as source_url, d.domain, d.role
+                FROM links l
+                JOIN pages p ON p.id = l.source_page_id
+                JOIN domains d ON d.id = p.domain_id
+                WHERE d.project = ?
+                ORDER BY d.domain, p.url
+              `).all(project);
+            } catch { return []; }
+          }
+          default: return [];
+        }
+      }
+
+      function toCSV(rows) {
+        if (!rows || (Array.isArray(rows) && !rows.length)) return '';
+        const arr = Array.isArray(rows) ? rows : (rows.events || rows.pages || []);
+        if (!arr.length) return '';
+        const keys = Object.keys(arr[0]);
+        const escape = (v) => {
+          if (v == null) return '';
+          const s = String(v);
+          return s.includes(',') || s.includes('"') || s.includes('\n') ? `"${s.replace(/"/g, '""')}"` : s;
+        };
+        return [keys.join(','), ...arr.map(r => keys.map(k => escape(r[k])).join(','))].join('\n');
+      }
+
+      function toMarkdown(sec, data, proj) {
+        const date = new Date().toISOString().slice(0, 10);
+        const header = `# SEO Intel — ${sec.charAt(0).toUpperCase() + sec.slice(1)} Export\n\n- Project: ${proj}\n- Date: ${date}\n\n`;
+        if (!data || (Array.isArray(data) && !data.length)) return header + '_No data available._\n';
+
+        switch (sec) {
+          case 'aeo': {
+            const targetRows = data.filter(r => r.role === 'target' || r.role === 'owned');
+            const avg = targetRows.length ? Math.round(targetRows.reduce((a, r) => a + r.score, 0) / targetRows.length) : 0;
+            let md = header + `## Summary\n\n- Pages scored: ${data.length}\n- Target average: ${avg}/100\n\n`;
+            md += '## Page Scores\n\n| Score | Tier | URL | Title | Weakest Signals |\n|-------|------|-----|-------|-----------------|\n';
+            for (const r of data) {
+              const signals = ['entity_authority', 'structured_claims', 'answer_density', 'qa_proximity', 'freshness', 'schema_coverage'];
+              const weakest = signals.sort((a, b) => (r[a] || 0) - (r[b] || 0)).slice(0, 2).map(s => s.replace(/_/g, ' ')).join(', ');
+              md += `| ${r.score} | ${r.tier} | ${r.url} | ${(r.title || '').slice(0, 50)} | ${weakest} |\n`;
+            }
+            return md;
+          }
+          case 'insights': {
+            let md = header + `## Active Insights (${data.length})\n\n`;
+            const grouped = {};
+            for (const r of data) { (grouped[r._type] ||= []).push(r); }
+            for (const [type, items] of Object.entries(grouped)) {
+              md += `### ${type.replace(/_/g, ' ')} (${items.length})\n\n`;
+              for (const item of items) {
+                const desc = item.phrase || item.keyword || item.title || item.page || item.message || JSON.stringify(item).slice(0, 120);
+                md += `- ${desc}\n`;
+              }
+              md += '\n';
+            }
+            return md;
+          }
+          case 'technical': {
+            let md = header + '## Technical Audit\n\n| URL | Status | Words | Load ms | Canonical | OG | Schema | Robots | Mobile |\n|-----|--------|-------|---------|-----------|-----|--------|--------|--------|\n';
+            for (const r of data) {
+              md += `| ${r.url} | ${r.status_code} | ${r.word_count || 0} | ${r.load_ms || 0} | ${r.has_canonical ? 'Y' : 'N'} | ${r.has_og_tags ? 'Y' : 'N'} | ${r.has_schema ? 'Y' : 'N'} | ${r.has_robots ? 'Y' : 'N'} | ${r.is_mobile_ok ? 'Y' : 'N'} |\n`;
+            }
+            return md;
+          }
+          case 'keywords': {
+            let md = header + '## Keyword Matrix\n\n| Keyword | Domain | Role | Location | Frequency |\n|---------|--------|------|----------|-----------|\n';
+            for (const r of data.slice(0, 500)) {
+              md += `| ${r.keyword} | ${r.domain} | ${r.role} | ${r.location || ''} | ${r.freq} |\n`;
+            }
+            if (data.length > 500) md += `\n_...and ${data.length - 500} more rows._\n`;
+            return md;
+          }
+          case 'pages': {
+            let md = header + '## Crawled Pages\n\n| URL | Status | Words | Title | Domain | Role |\n|-----|--------|-------|-------|--------|------|\n';
+            for (const r of data) {
+              md += `| ${r.url} | ${r.status_code} | ${r.word_count || 0} | ${(r.title || '').slice(0, 50)} | ${r.domain} | ${r.role} |\n`;
+            }
+            return md;
+          }
+          case 'watch': {
+            const snap = data.snapshot || {};
+            const events = data.events || [];
+            let md = header + `## Site Watch Snapshot\n\n- Health score: ${snap.health_score ?? 'N/A'}\n- Pages: ${snap.total_pages || 0}\n- Errors: ${snap.errors_count || 0} | Warnings: ${snap.warnings_count || 0} | Notices: ${snap.notices_count || 0}\n\n`;
+            if (events.length) {
+              md += '## Events\n\n| Type | Severity | URL | Details |\n|------|----------|-----|---------|\n';
+              for (const e of events) {
+                md += `| ${e.event_type} | ${e.severity} | ${e.url} | ${(e.details || '').slice(0, 80)} |\n`;
+              }
+            }
+            return md;
+          }
+          case 'schemas': {
+            let md = header + '## Schema Markup\n\n| Domain | URL | Type | Name | Rating | Price |\n|--------|-----|------|------|--------|-------|\n';
+            for (const r of data) {
+              md += `| ${r.domain} | ${r.url} | ${r.schema_type} | ${(r.name || '').slice(0, 40)} | ${r.rating || ''} | ${r.price ? r.currency + r.price : ''} |\n`;
+            }
+            return md;
+          }
+          case 'headings': {
+            let md = header + '## Heading Structure\n\n| Domain | URL | Level | Text |\n|--------|-----|-------|------|\n';
+            for (const r of data.slice(0, 1000)) {
+              md += `| ${r.domain} | ${r.url} | H${r.level} | ${(r.text || '').slice(0, 80)} |\n`;
+            }
+            if (data.length > 1000) md += `\n_...and ${data.length - 1000} more rows._\n`;
+            return md;
+          }
+          case 'links': {
+            let md = header + '## Internal Links\n\n| Source | Target | Anchor |\n|--------|--------|--------|\n';
+            for (const r of data.filter(l => l.is_internal).slice(0, 1000)) {
+              md += `| ${r.source_url} | ${r.target_url} | ${(r.anchor_text || '').slice(0, 50)} |\n`;
+            }
+            if (data.length > 1000) md += `\n_...and more rows._\n`;
+            return md;
+          }
+          default: {
+            return header + '```json\n' + JSON.stringify(data, null, 2).slice(0, 10000) + '\n```\n';
+          }
+        }
+      }
+
+      // Build response based on section + format
+      const sections = section === 'all' ? SECTIONS : [section];
+      if (section !== 'all' && !SECTIONS.includes(section)) {
+        json(res, 400, { error: `Invalid section. Allowed: ${SECTIONS.join(', ')}, all` });
+        return;
+      }
+
+      if (format === 'zip') {
+        // ZIP: bundle all requested sections in all formats
+        const entries = [];
+        for (const sec of sections) {
+          const data = querySection(sec);
+          const baseName = `${project}-${sec}-${dateStr}`;
+          entries.push({ name: `${baseName}.json`, content: JSON.stringify(data, null, 2) });
+          entries.push({ name: `${baseName}.md`, content: toMarkdown(sec, data, project) });
+          const csv = toCSV(data);
+          if (csv) entries.push({ name: `${baseName}.csv`, content: csv });
+        }
+        const zipBuf = createZip(entries);
+        const zipName = section === 'all' ? `${project}-full-export-${dateStr}.zip` : `${project}-${section}-${dateStr}.zip`;
+        res.writeHead(200, {
+          'Content-Type': 'application/zip',
+          'Content-Disposition': `attachment; filename="${zipName}"`,
+          'Content-Length': zipBuf.length,
+        });
+        res.end(zipBuf);
+      } else if (format === 'json') {
+        const data = querySection(sections[0]);
+        const fileName = `${project}-${sections[0]}-${dateStr}.json`;
+        const content = JSON.stringify(data, null, 2);
+        res.writeHead(200, {
+          'Content-Type': 'application/json',
+          'Content-Disposition': `attachment; filename="${fileName}"`,
+        });
+        res.end(content);
+      } else if (format === 'csv') {
+        const data = querySection(sections[0]);
+        const fileName = `${project}-${sections[0]}-${dateStr}.csv`;
+        res.writeHead(200, {
+          'Content-Type': 'text/csv; charset=utf-8',
+          'Content-Disposition': `attachment; filename="${fileName}"`,
+        });
+        res.end(toCSV(data));
+      } else if (format === 'md') {
+        const data = querySection(sections[0]);
+        const fileName = `${project}-${sections[0]}-${dateStr}.md`;
+        res.writeHead(200, {
+          'Content-Type': 'text/markdown; charset=utf-8',
+          'Content-Disposition': `attachment; filename="${fileName}"`,
+        });
+        res.end(toMarkdown(sections[0], data, project));
+      } else {
+        json(res, 400, { error: 'Invalid format. Allowed: json, csv, md, zip' });
+      }
+    } catch (e) {
+      console.error('[export/download]', e);
+      json(res, 500, { error: e.message });
+    }
+    return;
+  }
+
   // ─── API: SSE Terminal — stream command output ───
   if (req.method === 'GET' && path === '/api/terminal') {
     const params = url.searchParams;

package/setup/web-routes.js

@@ -410,8 +410,17 @@ async function handleEnv(req, res) {
       return;
     }
 
-    const result = updateEnvForSetup(keys);
-    jsonResponse(res, { success: true, path: result.path });
+    // saveModelsModule sends raw env var names (OLLAMA_MODEL, ANALYSIS_PROVIDER, etc.)
+    // while updateEnvForSetup expects camelCase. Write raw env vars directly.
+    for (const [key, value] of Object.entries(keys)) {
+      if (/^[A-Z_]+$/.test(key) && value) {
+        writeEnvKey(key, String(value));
+        process.env[key] = String(value);
+      }
+    }
+
+    const envPath = join(ROOT, '.env');
+    jsonResponse(res, { success: true, path: envPath });
   } catch (err) {
     jsonResponse(res, { error: err.message }, 500);
   }

package/setup/wizard.html

@@ -3152,6 +3152,10 @@ input::placeholder {
     if (state.selectedAnalysisProvider && state.selectedAnalysisModel) {
       payload.ANALYSIS_PROVIDER = state.selectedAnalysisProvider;
       payload.ANALYSIS_MODEL = state.selectedAnalysisModel;
+    } else if (state.selectedAnalysis) {
+      // Local Ollama analysis model — provider/model not set separately
+      payload.ANALYSIS_PROVIDER = 'ollama';
+      payload.ANALYSIS_MODEL = state.selectedAnalysis;
     }
 
     const cloudInput = document.getElementById('cloudApiKeyInput');