seo-intel 1.2.6 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # 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
+- `seo-intel blog-draft <project>` — generate AEO-optimised blog post drafts from Intelligence Ledger data
+- Gathers keyword gaps, long-tails, citability insights, entities, and top citable pages
+- Builds structured prompt with 10 AEO signal rules for maximum AI citability
+- Pre-scores generated draft against AEO signals before publishing
+- Options: `--topic`, `--lang en|fi`, `--model gemini|claude|gpt|deepseek`, `--save`
+- Pro feature gated via Lemon Squeezy license
+
+### Dashboard
+- New "Create" section in export sidebar with interactive draft generator
+- "Create a Draft" dropdown: select type (Blog Post / Documentation), topic, language, then generate
+- "AI Citability Audit" button added to export sidebar — run AEO from dashboard
+- Both `aeo` and `blog-draft` commands now available via dashboard terminal
+
+### Server
+- Added `aeo` and `blog-draft` to terminal command whitelist
+- Forward `--topic`, `--lang`, `--model`, `--save` params from dashboard to CLI
+
 ## 1.2.6 (2026-03-31)
 
 ### Critical Fix

package/analyses/blog-draft/index.js

@@ -0,0 +1,227 @@
+/**
+ * AEO Blog Draft Generator — Data Gathering & Prompt Builder
+ *
+ * Pulls intelligence from the Ledger (keyword gaps, long-tails, citability gaps,
+ * entities, positioning) and builds a prompt that produces a publish-ready,
+ * AEO-optimised blog post in .md format with YAML frontmatter.
+ */
+
+import { getActiveInsights } from '../../db/db.js';
+
+// ── Data Gathering ──────────────────────────────────────────────────────────
+
+export function gatherBlogDraftContext(db, project, topic = null) {
+  const insights = getActiveInsights(db, project);
+
+  // citability_gap insights — not in getActiveInsights grouped return
+  let citabilityGaps = [];
+  try {
+    citabilityGaps = db.prepare(
+      `SELECT data FROM insights WHERE project = ? AND type = 'citability_gap' AND status = 'active' ORDER BY last_seen DESC LIMIT 15`
+    ).all(project).map(r => JSON.parse(r.data));
+  } catch { /* table may not exist yet */ }
+
+  // Top entities across target pages
+  let entityRows = [];
+  try {
+    entityRows = db.prepare(`
+      SELECT e.primary_entities, p.title, p.url
+      FROM extractions e
+      JOIN pages p ON p.id = e.page_id
+      JOIN domains d ON d.id = p.domain_id
+      WHERE d.project = ? AND (d.role = 'target' OR d.role = 'owned')
+        AND e.primary_entities IS NOT NULL AND e.primary_entities != '[]'
+      ORDER BY p.word_count DESC LIMIT 20
+    `).all(project);
+  } catch { /* extraction may not have run */ }
+
+  // Best AEO-scoring pages (content to emulate)
+  let topCitablePages = [];
+  try {
+    topCitablePages = db.prepare(`
+      SELECT p.url, p.title, cs.total_score as score, cs.ai_intents, cs.tier
+      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 = ? AND (d.role = 'target' OR d.role = 'owned') AND cs.total_score >= 55
+      ORDER BY cs.total_score DESC LIMIT 5
+    `).all(project);
+  } catch { /* AEO may not have run */ }
+
+  // Filter by topic if given
+  const matchesTopic = (text) => {
+    if (!topic || !text) return true;
+    return text.toLowerCase().includes(topic.toLowerCase());
+  };
+
+  const kwInventor = insights.keyword_inventor
+    .filter(k => matchesTopic(k.phrase) || matchesTopic(k.cluster))
+    .slice(0, 30);
+
+  const longTails = topic
+    ? [
+        ...insights.long_tails.filter(lt => matchesTopic(lt.phrase)).slice(0, 20),
+        ...insights.long_tails.filter(lt => !matchesTopic(lt.phrase)).slice(0, 10),
+      ]
+    : insights.long_tails.slice(0, 30);
+
+  const keywordGaps = topic
+    ? [
+        ...insights.keyword_gaps.filter(kg => matchesTopic(kg.keyword)).slice(0, 15),
+        ...insights.keyword_gaps.filter(kg => !matchesTopic(kg.keyword)).slice(0, 10),
+      ]
+    : insights.keyword_gaps.filter(kg => kg.priority === 'high').slice(0, 25);
+
+  const contentGaps = (insights.content_gaps || []).slice(0, 8);
+
+  return {
+    insights,
+    citabilityGaps,
+    entityRows,
+    topCitablePages,
+    kwInventor,
+    longTails,
+    keywordGaps,
+    contentGaps,
+    topic,
+  };
+}
+
+// ── Prompt Builder ──────────────────────────────────────────────────────────
+
+export function buildBlogDraftPrompt(context, { config, lang = 'en', topic = null }) {
+  const { longTails, keywordGaps, citabilityGaps, entityRows, topCitablePages, kwInventor, contentGaps, insights } = context;
+  const isFi = lang === 'fi';
+
+  // Extract unique entities from extraction data
+  const allEntities = new Set();
+  for (const row of entityRows) {
+    try {
+      const ents = JSON.parse(row.primary_entities);
+      if (Array.isArray(ents)) ents.forEach(e => allEntities.add(typeof e === 'string' ? e : e.name || e));
+    } catch { /* skip */ }
+  }
+  const topEntities = [...allEntities].slice(0, 15);
+
+  // ── Section 1: Role ──
+  let prompt = `You are an expert content strategist and copywriter specialising in AEO (Answer Engine Optimisation).
+
+Your task: write a complete, publish-ready blog post draft in ${isFi ? 'Finnish' : 'English'}.
+The post must score 70+ on the AEO citability scale (entity authority, structured claims, answer density, Q&A proximity, freshness signals, schema coverage).
+
+`;
+
+  // ── Section 2: Site intelligence ──
+  prompt += `## Site Context
+
+- **Site:** ${config.context?.siteName || config.target?.domain} (${config.target?.url})
+- **Industry:** ${config.context?.industry || 'N/A'}
+- **Audience:** ${config.context?.audience || 'N/A'}
+- **Goal:** ${config.context?.goal || 'N/A'}
+`;
+
+  if (insights.positioning) {
+    prompt += `- **Positioning:** ${typeof insights.positioning === 'string' ? insights.positioning : JSON.stringify(insights.positioning)}\n`;
+  }
+
+  if (topEntities.length) {
+    prompt += `- **Core entities:** ${topEntities.join(', ')}\n`;
+  }
+
+  if (topCitablePages.length) {
+    prompt += `\n### Highest-scoring pages on the site (emulate their structure)\n`;
+    for (const p of topCitablePages) {
+      prompt += `- ${p.url} — AEO score: ${p.score}/100 (${p.tier})\n`;
+    }
+  }
+
+  // ── Section 3: Topic focus ──
+  prompt += `\n## Topic\n\n`;
+  if (topic) {
+    prompt += `Primary focus: **${topic}**. All keyword and gap data below has been filtered to this topic. Build the entire post around this subject.\n`;
+  } else {
+    prompt += `Select the highest-opportunity topic from the gaps below. Choose the gap that: (a) has the most keyword_gap entries or (b) is flagged as a high priority long-tail. Explain your topic choice in the frontmatter \`topic_selection_rationale\` field.\n`;
+  }
+
+  // ── Section 4: Intelligence data ──
+  if (keywordGaps.length) {
+    prompt += `\n## Keyword Gaps to Target (include these as primary/secondary keywords)\n\n`;
+    prompt += `| Keyword | Priority | Notes |\n|---|---|---|\n`;
+    for (const kg of keywordGaps) {
+      prompt += `| ${kg.keyword || kg.phrase || '—'} | ${kg.priority || 'medium'} | ${(kg.notes || '').slice(0, 80)} |\n`;
+    }
+  }
+
+  if (longTails.length) {
+    prompt += `\n## Long-tail Phrases to Answer (each should have a direct answer in the post)\n\n`;
+    prompt += `| Phrase | Intent | Priority |\n|---|---|---|\n`;
+    for (const lt of longTails) {
+      prompt += `| ${lt.phrase || '—'} | ${lt.intent || '—'} | ${lt.priority || 'medium'} |\n`;
+    }
+  }
+
+  if (kwInventor.length) {
+    prompt += `\n## Keyword Inventor Phrases (weave these naturally into headings/body)\n\n`;
+    for (const kw of kwInventor.slice(0, 20)) {
+      prompt += `- "${kw.phrase}" (${kw.type || 'traditional'}, ${kw.intent || '—'})\n`;
+    }
+  }
+
+  if (citabilityGaps.length) {
+    prompt += `\n## Citability Gaps (pages scoring <60 on AEO — model the fix in this post)\n\n`;
+    prompt += `| URL | Score | Weakest Signals |\n|---|---|---|\n`;
+    for (const cg of citabilityGaps) {
+      prompt += `| ${cg.url || '—'} | ${cg.score || '—'} | ${cg.weakest || cg.weakest_signal || '—'} |\n`;
+    }
+  }
+
+  if (contentGaps.length) {
+    prompt += `\n## Content Gaps (topics competitors cover that you don't)\n\n`;
+    for (const cg of contentGaps) {
+      const desc = typeof cg === 'string' ? cg : (cg.topic || cg.description || cg.gap || JSON.stringify(cg));
+      prompt += `- ${desc}\n`;
+    }
+  }
+
+  // ── Section 5: AEO structural requirements ──
+  prompt += `
+## AEO Structural Requirements
+
+The draft MUST include:
+1. YAML frontmatter with: title, slug, description (155 chars max), primary_keyword, secondary_keywords[], date (${new Date().toISOString().slice(0, 10)}), updated (same), lang (${lang}), tags[]${!topic ? ', topic_selection_rationale' : ''}
+2. An H1 that contains the primary keyword
+3. A 2-3 sentence summary immediately after the H1 (answer-first structure — inverted pyramid). This paragraph will be cited by AI assistants.
+4. Minimum 6 H2 subheadings
+5. At least 3 H2s phrased as direct questions (What is / How to / Why / When)
+6. At least one numbered or bulleted list with 4+ items
+7. At least one "X is Y because Z" definitional sentence per major concept
+8. A FAQ section at the end with minimum 4 Q&A pairs (### H3 questions, 2-4 sentence answers)
+9. A closing CTA paragraph referencing ${config.context?.siteName || config.target?.domain}
+10. Word count: 1,200-2,000 words
+11. Internal link suggestions: include 2-3 \`[anchor text](URL)\` links back to the site where natural
+`;
+
+  // ── Section 6: Language ──
+  if (isFi) {
+    prompt += `
+## Language: Finnish
+
+Write in Finnish. Use informal, direct register (sinuttelu where natural). Avoid marketing clichés common in Finnish B2B copy. Prefer short sentences. Finnish SEO keywords must appear in their exact searched base form in headings — Finnish inflection reduces exact-match keyword presence.
+`;
+  } else {
+    prompt += `
+## Language: English
+
+Write in clear, direct international English. No filler phrases. No "in today's digital landscape" or "it's no secret that" openers. Every sentence should contain a fact, insight, or actionable point.
+`;
+  }
+
+  // ── Section 7: Output format ──
+  prompt += `
+## Output Format
+
+Respond with ONLY the complete markdown document. Start with --- (YAML frontmatter open fence). End with the FAQ section and CTA. No explanation before or after. No triple backticks wrapping the response.
+`;
+
+  return prompt;
+}

package/analyses/blog-draft/prescorer.js

@@ -0,0 +1,60 @@
+/**
+ * AEO Pre-Scorer — scores a generated markdown draft against citability signals
+ *
+ * Uses the same scorePage() function as the full AEO audit, but constructs
+ * synthetic inputs from the markdown text instead of reading from the DB.
+ *
+ * Freshness always scores 0 (no publish date yet) — the reported score
+ * accounts for this by adding +10 for "what it will score once published."
+ */
+
+import { scorePage } from '../aeo/scorer.js';
+
+export function prescore(markdownText) {
+  // Strip YAML frontmatter
+  const bodyMatch = markdownText.match(/^---[\s\S]*?---\n([\s\S]*)$/);
+  const body = bodyMatch ? bodyMatch[1] : markdownText;
+
+  // Extract headings
+  const headings = [];
+  for (const line of body.split('\n')) {
+    const m = line.match(/^(#{1,6})\s+(.+)$/);
+    if (m) headings.push({ level: m[1].length, text: m[2].trim() });
+  }
+
+  // Word count
+  const wordCount = body.split(/\s+/).filter(Boolean).length;
+
+  // Extract frontmatter fields
+  let fmSchemaType = null;
+  const fmMatch = markdownText.match(/^---([\s\S]*?)---/);
+  if (fmMatch) {
+    const schemaLine = fmMatch[1].match(/schema_type:\s*(.+)/);
+    if (schemaLine) fmSchemaType = schemaLine[1].trim();
+  }
+
+  // Build synthetic page object
+  const syntheticPage = {
+    body_text: body,
+    word_count: wordCount,
+    published_date: null,   // not published yet — freshness = 0
+    modified_date: null,
+  };
+
+  // Extract entity candidates from headings (capitalised noun phrases)
+  const entityCandidates = headings
+    .filter(h => h.level <= 3)
+    .flatMap(h => h.text.match(/\b[A-ZÄÖÅ][a-zäöå]+(?:\s+[A-ZÄÖÅ][a-zäöå]+)*/g) || []);
+  const entities = [...new Set(entityCandidates)].slice(0, 8);
+
+  const schemaTypes = fmSchemaType ? [fmSchemaType] : [];
+  const schemas = [];
+
+  const result = scorePage(syntheticPage, headings, entities, schemaTypes, schemas, 'Informational');
+
+  return {
+    ...result,
+    wordCount,
+    headingCount: headings.length,
+  };
+}

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 {
@@ -4002,6 +4069,130 @@ program
     }
   });
 
+// ── AEO BLOG DRAFT GENERATOR ─────────────────────────────────────────────
+
+let _blogDraftModule;
+async function getBlogDraftModule() {
+  if (!_blogDraftModule) _blogDraftModule = await import('./analyses/blog-draft/index.js');
+  return _blogDraftModule;
+}
+let _prescorerModule;
+async function getPrescorerModule() {
+  if (!_prescorerModule) _prescorerModule = await import('./analyses/blog-draft/prescorer.js');
+  return _prescorerModule;
+}
+
+program
+  .command('blog-draft <project>')
+  .description('Generate an AEO-optimised blog post draft from Intelligence Ledger data')
+  .option('--topic <keyword>', 'Focus the post on a specific topic')
+  .option('--lang <code>', 'Language: en or fi', 'en')
+  .option('--model <name>', 'Model to use for generation (gemini, claude, gpt, deepseek)', 'gemini')
+  .option('--save', 'Save the generated draft to reports/')
+  .action(async (project, opts) => {
+    if (!requirePro('blog-draft')) return;
+    const db = getDb();
+    const config = loadConfig(project);
+
+    printAttackHeader('✍️  AEO Blog Draft Generator', project);
+
+    const { gatherBlogDraftContext, buildBlogDraftPrompt } = await getBlogDraftModule();
+    const { prescore } = await getPrescorerModule();
+
+    // ── Gather intelligence ──
+    console.log(chalk.gray('  Gathering intelligence from Ledger...'));
+    const context = gatherBlogDraftContext(db, project, opts.topic || null);
+
+    const stats = {
+      keywordGaps: context.keywordGaps.length,
+      longTails: context.longTails.length,
+      citabilityGaps: context.citabilityGaps.length,
+      kwInventor: context.kwInventor.length,
+      contentGaps: context.contentGaps.length,
+      entities: context.entityRows.length,
+      topCitable: context.topCitablePages.length,
+    };
+
+    console.log(chalk.gray(`    Keyword gaps: ${stats.keywordGaps}  Long-tails: ${stats.longTails}  Citability gaps: ${stats.citabilityGaps}`));
+    console.log(chalk.gray(`    Keyword inventor: ${stats.kwInventor}  Content gaps: ${stats.contentGaps}  Entities: ${stats.entities}`));
+
+    if (stats.keywordGaps + stats.longTails + stats.kwInventor === 0) {
+      console.log(chalk.yellow('\n  ⚠️  No intelligence data found in the Ledger.'));
+      console.log(chalk.gray('   Run: seo-intel analyze ' + project + '  and  seo-intel keywords ' + project + '\n'));
+      return;
+    }
+
+    // ── Build prompt ──
+    console.log(chalk.gray('\n  Building AEO-optimised prompt...'));
+    const prompt = buildBlogDraftPrompt(context, {
+      config,
+      lang: opts.lang,
+      topic: opts.topic || null,
+    });
+    console.log(chalk.gray(`    Prompt size: ${(prompt.length / 1024).toFixed(1)}KB`));
+
+    // ── Generate ──
+    console.log(chalk.cyan(`\n  🚀 Generating draft via ${opts.model}...\n`));
+    const draft = await callAnalysisModel(prompt, opts.model);
+
+    if (!draft) {
+      console.log(chalk.red('\n  ✗ Generation failed — no output from model.\n'));
+      return;
+    }
+
+    // ── Pre-score ──
+    console.log(chalk.gray('  Pre-scoring draft against AEO signals...'));
+    const scoreResult = prescore(draft);
+    const adjustedScore = Math.min(100, scoreResult.score + 10); // +10 for freshness on publish
+
+    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('');
+    console.log(chalk.bold('  📊 Pre-Score Results'));
+    console.log('');
+    console.log(`    AEO Score (raw):       ${scoreFmt(scoreResult.score)}`);
+    console.log(`    AEO Score (published):  ${scoreFmt(adjustedScore)}  ${chalk.gray('(+10 freshness on publish)')}`);
+    console.log(`    Word count:            ${scoreResult.wordCount}`);
+    console.log(`    Headings:              ${scoreResult.headingCount}`);
+    console.log(`    Tier:                  ${scoreResult.tier}`);
+    console.log('');
+
+    if (scoreResult.breakdown) {
+      console.log(chalk.bold('  🔍 Signal Breakdown'));
+      console.log('');
+      for (const [signal, value] of Object.entries(scoreResult.breakdown)) {
+        const bar = '█'.repeat(Math.round(value / 5)) + chalk.gray('░'.repeat(20 - Math.round(value / 5)));
+        console.log(`    ${signal.replace(/_/g, ' ').padEnd(22)} ${bar} ${value}/100`);
+      }
+      console.log('');
+    }
+
+    // ── Output ──
+    if (opts.save) {
+      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 outPath = join(__dirname, 'reports', filename);
+      writeFileSync(outPath, draft, 'utf8');
+      console.log(chalk.bold.green(`  ✅ Draft saved: ${outPath}`));
+      console.log('');
+    } else {
+      console.log(chalk.bold('  📝 Generated Draft'));
+      console.log(chalk.dim('─'.repeat(62)));
+      console.log(draft);
+      console.log(chalk.dim('─'.repeat(62)));
+      console.log('');
+      console.log(chalk.gray('  Tip: add --save to write the draft to reports/'));
+      console.log('');
+    }
+  });
+
 // ── GUIDE (Coach-style chapter map) ──────────────────────────────────────
 program
   .command('guide')

package/lib/gate.js

@@ -59,6 +59,7 @@ const FEATURE_NAMES = {
   'competitive':      'Competitive Landscape Sections',
   'unlimited-pages':  'Unlimited Crawl Pages',
   'unlimited-projects': 'Unlimited Projects',
+  'blog-draft':        'AEO Blog Draft Generator',
 };
 
 // ── CLI Gate — blocks command and shows upgrade message ──────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo-intel",
-  "version": "1.2.6",
+  "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

@@ -1488,6 +1488,108 @@ function buildHtmlTemplate(data, opts = {}) {
     .export-btn:hover { border-color: var(--accent-gold); color: var(--accent-gold); }
     .export-btn i { margin-right: 5px; font-size: 0.6rem; }
     .export-btn.active { border-color: var(--accent-gold); color: var(--accent-gold); background: rgba(232,213,163,0.06); }
+    .draft-dropdown { position: relative; }
+    .draft-trigger { display: flex; align-items: center; width: 100%; }
+    .draft-menu {
+      display: none;
+      position: absolute;
+      top: calc(100% + 4px);
+      left: 0; right: 0;
+      background: #1a1a1a;
+      border: 1px solid var(--accent-gold);
+      border-radius: var(--radius);
+      padding: 10px;
+      z-index: 50;
+      box-shadow: 0 8px 24px rgba(0,0,0,0.5);
+    }
+    .draft-menu.open { display: block; }
+    .draft-menu-section {
+      font-size: 0.58rem;
+      color: var(--text-muted);
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+      margin-bottom: 5px;
+      font-family: var(--font-body);
+    }
+    .draft-option {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      padding: 5px 8px;
+      font-size: 0.65rem;
+      color: var(--text-secondary);
+      cursor: pointer;
+      border-radius: 4px;
+      font-family: var(--font-body);
+    }
+    .draft-option:hover { background: rgba(232,213,163,0.06); color: var(--text-primary); }
+    .draft-option input[type="radio"] { accent-color: var(--accent-gold); width: 12px; height: 12px; }
+    .draft-option i { font-size: 0.6rem; width: 14px; text-align: center; }
+    .draft-topic-input {
+      width: 100%;
+      background: #111;
+      border: 1px solid var(--border-subtle);
+      border-radius: 4px;
+      padding: 6px 8px;
+      color: var(--text-primary);
+      font-size: 0.65rem;
+      font-family: 'SF Mono', monospace;
+      outline: none;
+      box-sizing: border-box;
+    }
+    .draft-topic-input:focus { border-color: var(--accent-gold); }
+    .draft-generate-btn {
+      width: 100%;
+      margin-top: 10px;
+      padding: 8px;
+      background: var(--accent-gold);
+      color: var(--text-dark);
+      border: none;
+      border-radius: var(--radius);
+      font-size: 0.68rem;
+      font-weight: 600;
+      cursor: pointer;
+      font-family: var(--font-body);
+      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;
@@ -2017,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">
@@ -2024,10 +2127,38 @@ function buildHtmlTemplate(data, opts = {}) {
         <button class="export-btn" data-export-cmd="export-actions" data-export-project="${project}" data-export-scope="competitive"><i class="fa-solid fa-users"></i> Competitive Gaps</button>
         <button class="export-btn" data-export-cmd="suggest-usecases" data-export-project="${project}"><i class="fa-solid fa-lightbulb"></i> Suggest What to Build</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 class="export-sidebar-header" style="margin-top:12px;">
+        <i class="fa-solid fa-pen-fancy"></i> Create
+      </div>
+      <div class="export-sidebar-btns">
+        <div class="draft-dropdown" id="draftDropdown${suffix}">
+          <button class="export-btn draft-trigger" id="draftTrigger${suffix}"><i class="fa-solid fa-file-pen"></i> Create a Draft <i class="fa-solid fa-chevron-down" style="font-size:0.55rem;margin-left:auto;opacity:0.5;"></i></button>
+          <div class="draft-menu" id="draftMenu${suffix}">
+            <div class="draft-menu-section">Type</div>
+            <label class="draft-option"><input type="radio" name="draftType${suffix}" value="blog" checked /> <i class="fa-solid fa-blog"></i> Blog Post</label>
+            <label class="draft-option"><input type="radio" name="draftType${suffix}" value="docs" disabled /> <i class="fa-solid fa-book"></i> Documentation <span style="font-size:0.55rem;opacity:0.4;margin-left:4px;">soon</span></label>
+            <div class="draft-menu-section" style="margin-top:8px;">Topic <span style="font-size:0.55rem;opacity:0.4;">(optional)</span></div>
+            <input type="text" id="draftTopic${suffix}" class="draft-topic-input" placeholder="e.g. solana rpc, site speed..." />
+            <div class="draft-menu-section" style="margin-top:8px;">Language</div>
+            <div style="display:flex;gap:6px;">
+              <label class="draft-option" style="flex:1;"><input type="radio" name="draftLang${suffix}" value="en" checked /> EN</label>
+              <label class="draft-option" style="flex:1;"><input type="radio" name="draftLang${suffix}" value="fi" /> FI</label>
+            </div>
+            <button class="draft-generate-btn" id="draftGenerate${suffix}" data-project="${project}"><i class="fa-solid fa-wand-magic-sparkles"></i> Generate Draft</button>
+          </div>
+        </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 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>
       ` : `
@@ -2211,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';
@@ -2232,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 (_) {}
         };
@@ -2245,6 +2385,129 @@ function buildHtmlTemplate(data, opts = {}) {
       });
     });
 
+    // Draft dropdown
+    var draftTrigger = document.getElementById('draftTrigger' + suffix);
+    var draftMenu = document.getElementById('draftMenu' + suffix);
+    var draftGenerate = document.getElementById('draftGenerate' + suffix);
+    if (draftTrigger && draftMenu) {
+      draftTrigger.addEventListener('click', function(e) {
+        e.stopPropagation();
+        draftMenu.classList.toggle('open');
+      });
+      document.addEventListener('click', function(e) {
+        if (!draftMenu.contains(e.target) && e.target !== draftTrigger) {
+          draftMenu.classList.remove('open');
+        }
+      });
+    }
+    if (draftGenerate) {
+      draftGenerate.addEventListener('click', function() {
+        if (running) return;
+        var proj = draftGenerate.getAttribute('data-project');
+        var typeEl = document.querySelector('input[name="draftType' + suffix + '"]:checked');
+        var langEl = document.querySelector('input[name="draftLang' + suffix + '"]:checked');
+        var topicEl = document.getElementById('draftTopic' + suffix);
+        var draftType = typeEl ? typeEl.value : 'blog';
+        var lang = langEl ? langEl.value : 'en';
+        var topic = topicEl ? topicEl.value.trim() : '';
+
+        if (draftType !== 'blog') return; // docs not yet supported
+
+        draftMenu.classList.remove('open');
+
+        // Run blog-draft via terminal SSE
+        var extra = { lang: lang };
+        if (topic) extra.topic = topic;
+
+        var params = new URLSearchParams({ command: 'blog-draft' });
+        params.set('project', proj);
+        params.set('lang', lang);
+        params.set('save', '1');
+        if (topic) params.set('topic', topic);
+
+        if (!isServed) {
+          var cmd = 'seo-intel blog-draft ' + proj + (topic ? ' --topic "' + topic + '"' : '') + ' --lang ' + lang + ' --save';
+          if (exportViewer) {
+            exportViewer.innerHTML = '<div style="color:var(--color-danger);padding:12px;">Not connected. Run in terminal:<br/><code style="color:var(--accent-gold);">' + cmd + '</code></div>';
+          }
+          return;
+        }
+
+        if (exportViewer) exportViewer.innerHTML = '<div style="color:var(--text-muted);padding:20px;text-align:center;"><i class="fa-solid fa-wand-magic-sparkles fa-spin" style="margin-right:6px;color:var(--accent-gold);"></i>Generating AEO draft...</div>';
+
+        var mdContent = '';
+        var es = new EventSource('/api/terminal?' + params.toString());
+        running = true;
+        status.textContent = 'generating draft...';
+        status.style.color = 'var(--color-warning)';
+
+        es.onmessage = function(e) {
+          try {
+            var msg = JSON.parse(e.data);
+            if (msg.type === 'stdout') mdContent += msg.data + '\\n';
+            else if (msg.type === 'stderr') appendLine(msg.data, 'stderr');
+            else if (msg.type === 'exit') {
+              running = false;
+              var code = msg.data?.code ?? msg.data;
+              status.textContent = code === 0 ? 'draft saved' : 'failed';
+              status.style.color = code === 0 ? 'var(--color-success)' : 'var(--color-danger)';
+              es.close();
+              if (exportViewer && mdContent.trim()) {
+                var bt = String.fromCharCode(96);
+                var codeRe = new RegExp(bt + '([^' + bt + ']+)' + bt, 'g');
+                var html = mdContent
+                  .replace(/^### (.*$)/gm, '<h3>$1</h3>')
+                  .replace(/^## (.*$)/gm, '<h2>$1</h2>')
+                  .replace(/^# (.*$)/gm, '<h1>$1</h1>')
+                  .replace(/\\*\\*(.*?)\\*\\*/g, '<strong>$1</strong>')
+                  .replace(/^- (.*$)/gm, '<li>$1</li>')
+                  .replace(codeRe, '<code>$1</code>')
+                  .replace(/\\n/g, '<br/>');
+                exportViewer.innerHTML = html;
+                exportViewer.scrollTop = 0;
+              } else if (exportViewer) {
+                exportViewer.innerHTML = '<div style="color:var(--text-muted);">Draft generated — check reports/ folder.</div>';
+              }
+            }
+          } catch (_) {}
+        };
+        es.onerror = function() {
+          running = false;
+          status.textContent = 'error';
+          status.style.color = 'var(--color-danger)';
+          es.close();
+          if (exportViewer) exportViewer.innerHTML = '<div style="color:var(--color-danger);">Connection failed.</div>';
+        };
+      });
+    }
+
+    // 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

@@ -595,7 +595,8 @@ async function handleRequest(req, res) {
     // Whitelist allowed commands
     const ALLOWED = ['crawl', 'extract', 'analyze', 'export-actions', 'competitive-actions',
       'suggest-usecases', 'html', 'status', 'brief', 'keywords', 'report', 'guide',
-      'schemas', 'headings-audit', 'orphans', 'entities', 'friction', 'shallow', 'decay', 'export', 'templates'];
+      'schemas', 'headings-audit', 'orphans', 'entities', 'friction', 'shallow', 'decay', 'export', 'templates',
+      'aeo', 'blog-draft'];
 
     if (!command || !ALLOWED.includes(command)) {
       json(res, 400, { error: `Invalid command. Allowed: ${ALLOWED.join(', ')}` });
@@ -608,6 +609,21 @@ async function handleRequest(req, res) {
     if (params.get('stealth') === 'true') args.push('--stealth');
     if (params.get('scope')) args.push('--scope', params.get('scope'));
     if (params.get('format')) args.push('--format', params.get('format'));
+    if (params.get('topic')) args.push('--topic', params.get('topic'));
+    if (params.get('lang')) args.push('--lang', params.get('lang'));
+    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, {