seo-intel 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.3.1 (2026-04-02)
+
+### Fixes
+- **AI Citability Audit** now renders output in dashboard export viewer (was showing "No output")
+- AEO command accepts `--format markdown|json|brief` for structured output
+- Dashboard export viewer captures stderr — command errors are now visible instead of silent
+
+### CI
+- Added job-level timeout (15 min) — prevents 6-hour runaway jobs
+- Cross-platform path handling — Windows CI no longer fails on backslash paths
+- Playwright auto-installed for mock crawl test
+- Step-level timeouts on crawl, setup wizard, and server tests
+
 ## 1.3.0 (2026-04-01)
 
 ### New Feature: AEO Blog Draft Generator

package/cli.js

@@ -3869,24 +3869,30 @@ program
   .alias('citability')
   .description('AI Citability Audit — score every page for how well AI assistants can cite it')
   .option('--target-only', 'Only score target domain (skip competitors)')
+  .option('--format <type>', 'Output format: brief or json', 'brief')
   .option('--save', 'Save report to reports/')
   .action(async (project, opts) => {
     if (!requirePro('aeo')) return;
     const db = getDb();
     const config = loadConfig(project);
+    const isBrief = opts.format !== 'json';
 
-    printAttackHeader('🤖 AEO — AI Citability Audit', project);
+    if (!isBrief) {
+      // JSON mode — skip header
+    } else {
+      printAttackHeader('🤖 AEO — AI Citability Audit', project);
+    }
 
     const { runAeoAnalysis, persistAeoScores, upsertCitabilityInsights } = await import('./analyses/aeo/index.js');
 
     const results = runAeoAnalysis(db, project, {
       includeCompetitors: !opts.targetOnly,
-      log: (msg) => console.log(chalk.gray(msg)),
+      log: (msg) => isBrief ? console.log(chalk.gray(msg)) : null,
     });
 
     if (!results.target.length && !results.competitors.size) {
-      console.log(chalk.yellow('\n  ⚠️  No pages with body_text found.'));
-      console.log(chalk.gray('   Run: seo-intel crawl ' + project + '  (crawl stores body text since v1.1.6)\n'));
+      console.log(isBrief ? chalk.yellow('\n  ⚠️  No pages with body_text found.') : 'No pages with body_text found.');
+      console.log(isBrief ? chalk.gray('   Run: seo-intel crawl ' + project + '  (crawl stores body text since v1.1.6)\n') : 'Run: seo-intel crawl ' + project);
       return;
     }
 
@@ -3895,88 +3901,149 @@ program
     upsertCitabilityInsights(db, project, results.target);
 
     const { summary } = results;
+    const { tierCounts } = summary;
+    const worst = results.target.filter(r => r.score < 55).slice(0, 10);
+    const best = results.target.filter(r => r.score >= 55).slice(-5).reverse();
 
-    // ── Summary ──
-    console.log('');
-    console.log(chalk.bold('  📊 Citability Summary'));
-    console.log('');
+    // ── Markdown output (used by dashboard export viewer) ──
+    if (opts.format === 'markdown') {
 
-    const scoreFmt = (s) => {
-      if (s >= 75) return chalk.bold.green(s + '/100');
-      if (s >= 55) return chalk.bold.yellow(s + '/100');
-      if (s >= 35) return chalk.hex('#ff8c00')(s + '/100');
-      return chalk.bold.red(s + '/100');
-    };
+      console.log('# AEO — AI Citability Audit\n');
+      console.log(`## Summary\n`);
+      console.log(`- **Target average:** ${summary.avgTargetScore}/100`);
+      if (summary.competitorPages > 0) {
+        console.log(`- **Competitor average:** ${summary.avgCompetitorScore}/100`);
+        const delta = summary.scoreDelta;
+        console.log(`- **Delta:** ${delta > 0 ? '+' : ''}${delta}`);
+      }
+      console.log(`- **Pages scored:** ${results.target.length}\n`);
+
+      console.log(`## Tier Breakdown\n`);
+      console.log(`- Excellent (75+): ${tierCounts.excellent}`);
+      console.log(`- Good (55-74): ${tierCounts.good}`);
+      console.log(`- Needs work (35-54): ${tierCounts.needs_work}`);
+      console.log(`- Poor (<35): ${tierCounts.poor}\n`);
+
+      if (summary.weakestSignals.length) {
+        console.log(`## Weakest Signals\n`);
+        for (const s of summary.weakestSignals) {
+          const pct = Math.round(s.avg);
+          const bar = '█'.repeat(Math.round(pct / 5)) + '░'.repeat(20 - Math.round(pct / 5));
+          console.log(`- **${s.signal}** ${bar} ${pct}/100`);
+        }
+        console.log('');
+      }
 
-    console.log(`    Target average:     ${scoreFmt(summary.avgTargetScore)}`);
-    if (summary.competitorPages > 0) {
-      console.log(`    Competitor average:  ${scoreFmt(summary.avgCompetitorScore)}`);
-      const delta = summary.scoreDelta;
-      const deltaStr = delta > 0 ? chalk.green(`+${delta}`) : delta < 0 ? chalk.red(`${delta}`) : chalk.gray('0');
-      console.log(`    Delta:              ${deltaStr}`);
-    }
-    console.log('');
+      if (worst.length) {
+        console.log(`## Pages Needing Work\n`);
+        for (const p of worst) {
+          const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
+          const weakest = Object.entries(p.breakdown)
+            .sort(([, a], [, b]) => a - b)
+            .slice(0, 2)
+            .map(([k]) => k.replace(/_/g, ' '));
+          console.log(`- **${path.slice(0, 60)}** — ${p.score}/100 (weak: ${weakest.join(', ')})`);
+        }
+        console.log('');
+      }
 
-    // ── Tier breakdown ──
-    const { tierCounts } = summary;
-    console.log(`    ${chalk.green('●')} Excellent (75+):  ${tierCounts.excellent}`);
-    console.log(`    ${chalk.yellow('●')} Good (55-74):     ${tierCounts.good}`);
-    console.log(`    ${chalk.hex('#ff8c00')('●')} Needs work (35-54): ${tierCounts.needs_work}`);
-    console.log(`    ${chalk.red('●')} Poor (<35):        ${tierCounts.poor}`);
-    console.log('');
+      if (best.length) {
+        console.log(`## Top Citable Pages\n`);
+        for (const p of best) {
+          const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
+          console.log(`- **${path.slice(0, 60)}** — ${p.score}/100 (${p.aiIntents.join(', ')})`);
+        }
+        console.log('');
+      }
 
-    // ── Weakest signals ──
-    if (summary.weakestSignals.length) {
-      console.log(chalk.bold('  🔍 Weakest Signals (target average)'));
-      console.log('');
-      for (const s of summary.weakestSignals) {
-        const bar = '█'.repeat(Math.round(s.avg / 5)) + chalk.gray('░'.repeat(20 - Math.round(s.avg / 5)));
-        console.log(`    ${s.signal.padEnd(20)} ${bar} ${s.avg}/100`);
+      console.log(`## Actions\n`);
+      if (tierCounts.poor > 0) {
+        console.log(`1. Fix ${tierCounts.poor} poor-scoring pages — add structured headings, Q&A format, entity depth`);
+      }
+      if (summary.weakestSignals.length && summary.weakestSignals[0].avg < 40) {
+        console.log(`2. Site-wide weakness: "${summary.weakestSignals[0].signal}" — systematically improve across all pages`);
+      }
+      if (summary.scoreDelta < 0) {
+        console.log(`3. Competitors are ${Math.abs(summary.scoreDelta)} points ahead — prioritise top-traffic pages first`);
       }
       console.log('');
-    }
+    } else if (opts.format === 'json') {
+      // ── JSON output ──
+      console.log(JSON.stringify({ summary, target: results.target, competitors: [...results.competitors.entries()] }, null, 2));
+    } else {
+      // ── Rich CLI output (default brief format) ──
+      const scoreFmt = (s) => {
+        if (s >= 75) return chalk.bold.green(s + '/100');
+        if (s >= 55) return chalk.bold.yellow(s + '/100');
+        if (s >= 35) return chalk.hex('#ff8c00')(s + '/100');
+        return chalk.bold.red(s + '/100');
+      };
 
-    // ── Worst pages (actionable) ──
-    const worst = results.target.filter(r => r.score < 55).slice(0, 10);
-    if (worst.length) {
-      console.log(chalk.bold.red('  ⚡ Pages Needing Work'));
       console.log('');
-      for (const p of worst) {
-        const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
-        const weakest = Object.entries(p.breakdown)
-          .sort(([, a], [, b]) => a - b)
-          .slice(0, 2)
-          .map(([k]) => k.replace(/_/g, ' '));
-        console.log(`    ${scoreFmt(p.score)}  ${chalk.bold(path.slice(0, 50))}`);
-        console.log(chalk.gray(`           Weak: ${weakest.join(', ')}`));
+      console.log(chalk.bold('  📊 Citability Summary'));
+      console.log('');
+      console.log(`    Target average:     ${scoreFmt(summary.avgTargetScore)}`);
+      if (summary.competitorPages > 0) {
+        console.log(`    Competitor average:  ${scoreFmt(summary.avgCompetitorScore)}`);
+        const delta = summary.scoreDelta;
+        const deltaStr = delta > 0 ? chalk.green(`+${delta}`) : delta < 0 ? chalk.red(`${delta}`) : chalk.gray('0');
+        console.log(`    Delta:              ${deltaStr}`);
       }
       console.log('');
-    }
 
-    // ── Best pages ──
-    const best = results.target.filter(r => r.score >= 55).slice(-5).reverse();
-    if (best.length) {
-      console.log(chalk.bold.green('  ✨ Top Citable Pages'));
+      console.log(`    ${chalk.green('●')} Excellent (75+):  ${tierCounts.excellent}`);
+      console.log(`    ${chalk.yellow('●')} Good (55-74):     ${tierCounts.good}`);
+      console.log(`    ${chalk.hex('#ff8c00')('●')} Needs work (35-54): ${tierCounts.needs_work}`);
+      console.log(`    ${chalk.red('●')} Poor (<35):        ${tierCounts.poor}`);
       console.log('');
-      for (const p of best) {
-        const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
-        console.log(`    ${scoreFmt(p.score)}  ${chalk.bold(path.slice(0, 50))}  ${chalk.gray(p.aiIntents.join(', '))}`);
+
+      if (summary.weakestSignals.length) {
+        console.log(chalk.bold('  🔍 Weakest Signals (target average)'));
+        console.log('');
+        for (const s of summary.weakestSignals) {
+          const bar = '█'.repeat(Math.round(s.avg / 5)) + chalk.gray('░'.repeat(20 - Math.round(s.avg / 5)));
+          console.log(`    ${s.signal.padEnd(20)} ${bar} ${s.avg}/100`);
+        }
+        console.log('');
       }
-      console.log('');
-    }
 
-    // ── Actions ──
-    console.log(chalk.bold.green('  💡 Actions:'));
-    if (tierCounts.poor > 0) {
-      console.log(chalk.green(`     1. Fix ${tierCounts.poor} poor-scoring pages — add structured headings, Q&A format, entity depth`));
-    }
-    if (summary.weakestSignals.length && summary.weakestSignals[0].avg < 40) {
-      console.log(chalk.green(`     2. Site-wide weakness: "${summary.weakestSignals[0].signal}" — systematically improve across all pages`));
-    }
-    if (summary.scoreDelta < 0) {
-      console.log(chalk.green(`     3. Competitors are ${Math.abs(summary.scoreDelta)} points ahead — prioritise top-traffic pages first`));
+      if (worst.length) {
+        console.log(chalk.bold.red('  ⚡ Pages Needing Work'));
+        console.log('');
+        for (const p of worst) {
+          const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
+          const weakest = Object.entries(p.breakdown)
+            .sort(([, a], [, b]) => a - b)
+            .slice(0, 2)
+            .map(([k]) => k.replace(/_/g, ' '));
+          console.log(`    ${scoreFmt(p.score)}  ${chalk.bold(path.slice(0, 50))}`);
+          console.log(chalk.gray(`           Weak: ${weakest.join(', ')}`));
+        }
+        console.log('');
+      }
+
+      if (best.length) {
+        console.log(chalk.bold.green('  ✨ Top Citable Pages'));
+        console.log('');
+        for (const p of best) {
+          const path = p.url.replace(/https?:\/\/[^/]+/, '') || '/';
+          console.log(`    ${scoreFmt(p.score)}  ${chalk.bold(path.slice(0, 50))}  ${chalk.gray(p.aiIntents.join(', '))}`);
+        }
+        console.log('');
+      }
+
+      console.log(chalk.bold.green('  💡 Actions:'));
+      if (tierCounts.poor > 0) {
+        console.log(chalk.green(`     1. Fix ${tierCounts.poor} poor-scoring pages — add structured headings, Q&A format, entity depth`));
+      }
+      if (summary.weakestSignals.length && summary.weakestSignals[0].avg < 40) {
+        console.log(chalk.green(`     2. Site-wide weakness: "${summary.weakestSignals[0].signal}" — systematically improve across all pages`));
+      }
+      if (summary.scoreDelta < 0) {
+        console.log(chalk.green(`     3. Competitors are ${Math.abs(summary.scoreDelta)} points ahead — prioritise top-traffic pages first`));
+      }
+      console.log('');
     }
-    console.log('');
 
     // ── Regenerate dashboard ──
     try {

package/package.json

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

package/reports/generate-html.js

@@ -1553,6 +1553,43 @@ function buildHtmlTemplate(data, opts = {}) {
       transition: opacity 0.15s;
     }
     .draft-generate-btn:hover { opacity: 0.9; }
+    .export-expand-btn {
+      position: absolute;
+      top: 6px;
+      right: 6px;
+      z-index: 10;
+      background: rgba(255,255,255,0.06);
+      border: 1px solid var(--border-subtle);
+      color: var(--text-muted);
+      width: 24px; height: 24px;
+      border-radius: 4px;
+      cursor: pointer;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 0.55rem;
+      transition: all 0.15s;
+    }
+    .export-expand-btn:hover { border-color: var(--accent-gold); color: var(--accent-gold); }
+    .export-viewer-expanded {
+      position: fixed !important;
+      top: 5vh; left: 5vw; right: 5vw; bottom: 5vh;
+      max-height: none !important;
+      z-index: 9999;
+      background: #111;
+      border: 1px solid var(--accent-gold);
+      border-radius: var(--radius);
+      padding: 24px;
+      overflow-y: auto;
+      box-shadow: 0 0 80px rgba(0,0,0,0.8);
+    }
+    .export-viewer-backdrop {
+      position: fixed;
+      inset: 0;
+      background: rgba(0,0,0,0.7);
+      z-index: 9998;
+      cursor: pointer;
+    }
     .export-viewer {
       flex: 1;
       padding: 12px;
@@ -2082,6 +2119,7 @@ function buildHtmlTemplate(data, opts = {}) {
     <div class="export-sidebar">
       <div class="export-sidebar-header">
         <i class="fa-solid fa-file-export"></i> Exports
+        <span style="margin-left:auto;font-size:.55rem;color:var(--text-muted);font-weight:400;letter-spacing:0;">→ reports/</span>
       </div>
       ${pro ? `
       <div class="export-sidebar-btns">
@@ -2111,10 +2149,16 @@ 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 id="exportViewer${suffix}" class="export-viewer">
-        <div style="color:#444;padding:20px 0;text-align:center;">
-          <i class="fa-solid fa-file-export" style="font-size:1.2rem;margin-bottom:8px;display:block;"></i>
-          Click an export to generate an<br/>implementation-ready action brief.
+      <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>
+        </div>
+        <button id="exportExpand${suffix}" class="export-expand-btn" title="Expand viewer"><i class="fa-solid fa-expand"></i></button>
+        <div id="exportViewer${suffix}" class="export-viewer">
+          <div style="color:#444;padding:20px 0;text-align:center;">
+            <i class="fa-solid fa-file-export" style="font-size:1.2rem;margin-bottom:8px;display:block;"></i>
+            Click an export to generate an<br/>implementation-ready action brief.
+          </div>
         </div>
       </div>
       ` : `
@@ -2298,6 +2342,7 @@ function buildHtmlTemplate(data, opts = {}) {
           try {
             const msg = JSON.parse(e.data);
             if (msg.type === 'stdout') mdContent += msg.data + '\\n';
+            else if (msg.type === 'stderr') mdContent += msg.data + '\\n';
             else if (msg.type === 'exit') {
               running = false;
               status.textContent = 'done';
@@ -2319,6 +2364,14 @@ function buildHtmlTemplate(data, opts = {}) {
                 exportViewer.innerHTML = html || '<div style="color:var(--text-muted);">No output.</div>';
                 exportViewer.scrollTop = 0;
               }
+              // Show save status
+              var saveEl = document.getElementById('exportSaveStatus' + suffix);
+              if (saveEl && code === 0) {
+                var slugName = cmd === 'suggest-usecases' ? 'suggestions' : (scope || 'all');
+                var dateStr = new Date().toISOString().slice(0, 10);
+                saveEl.style.display = 'block';
+                saveEl.querySelector('span').textContent = 'Saved → reports/' + proj + '-' + slugName + '-' + dateStr + '.md';
+              }
             }
           } catch (_) {}
         };
@@ -2428,6 +2481,33 @@ function buildHtmlTemplate(data, opts = {}) {
       });
     }
 
+    // Expand viewer button
+    var expandBtn = document.getElementById('exportExpand' + suffix);
+    if (expandBtn && exportViewer) {
+      expandBtn.addEventListener('click', function() {
+        if (exportViewer.classList.contains('export-viewer-expanded')) {
+          // Collapse
+          exportViewer.classList.remove('export-viewer-expanded');
+          expandBtn.innerHTML = '<i class="fa-solid fa-expand"></i>';
+          var bd = document.getElementById('exportBackdrop' + suffix);
+          if (bd) bd.remove();
+        } else {
+          // Expand
+          exportViewer.classList.add('export-viewer-expanded');
+          expandBtn.innerHTML = '<i class="fa-solid fa-compress"></i>';
+          var bd = document.createElement('div');
+          bd.id = 'exportBackdrop' + suffix;
+          bd.className = 'export-viewer-backdrop';
+          document.body.appendChild(bd);
+          bd.addEventListener('click', function() {
+            exportViewer.classList.remove('export-viewer-expanded');
+            expandBtn.innerHTML = '<i class="fa-solid fa-expand"></i>';
+            bd.remove();
+          });
+        }
+      });
+    }
+
     // Input enter
     input.addEventListener('keydown', function(e) {
       if (e.key !== 'Enter') return;

package/server.js

@@ -614,6 +614,17 @@ async function handleRequest(req, res) {
     if (params.get('model')) args.push('--model', params.get('model'));
     if (params.has('save')) args.push('--save');
 
+    // Auto-save exports from dashboard to reports/
+    const EXPORT_CMDS = ['export-actions', 'suggest-usecases', 'competitive-actions'];
+    if (EXPORT_CMDS.includes(command) && project) {
+      const scope = params.get('scope') || 'all';
+      const ts = new Date().toISOString().slice(0, 10);
+      const slug = command === 'suggest-usecases' ? 'suggestions' : scope;
+      const outFile = join(__dirname, 'reports', `${project}-${slug}-${ts}.md`);
+      args.push('--output', outFile);
+      args.push('--format', 'brief');
+    }
+
     // SSE headers
     res.writeHead(200, {
       'Content-Type': 'text/event-stream',