aeorank 1.0.0 → 1.2.0

package/dist/cli.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+// src/cli.ts
+import { writeFileSync } from "fs";
+
 // src/parked-domain.ts
 var PARKING_PATHS = ["/lander", "/parking", "/park", "/sedoparking"];
 var PARKING_SERVICE_DOMAINS = [
@@ -2495,18 +2498,343 @@ async function audit(domain, options) {
   };
 }
 
+// src/compare.ts
+async function compare(domainA, domainB, options) {
+  const [siteA, siteB] = await Promise.all([
+    audit(domainA, options),
+    audit(domainB, options)
+  ]);
+  const criteria = [];
+  const siteAAdvantages = [];
+  const siteBAdvantages = [];
+  const tied = [];
+  for (let i = 0; i < siteA.scorecard.length; i++) {
+    const a = siteA.scorecard[i];
+    const b = siteB.scorecard[i];
+    if (!a || !b) continue;
+    const delta = a.score - b.score;
+    criteria.push({
+      id: a.id,
+      criterion: a.criterion,
+      scoreA: a.score,
+      scoreB: b.score,
+      delta,
+      statusA: a.status,
+      statusB: b.status
+    });
+    if (delta > 0) siteAAdvantages.push(a.criterion);
+    else if (delta < 0) siteBAdvantages.push(a.criterion);
+    else tied.push(a.criterion);
+  }
+  return {
+    siteA,
+    siteB,
+    comparison: {
+      scoreDelta: siteA.overallScore - siteB.overallScore,
+      criteria,
+      siteAAdvantages,
+      siteBAdvantages,
+      tied
+    }
+  };
+}
+
+// src/html-report.ts
+function scoreColor(score) {
+  if (score <= 40) return "#F44336";
+  if (score <= 55) return "#FF9800";
+  if (score <= 70) return "#FFC107";
+  if (score <= 85) return "#4CAF50";
+  return "#2E7D32";
+}
+function criterionColor(score) {
+  return scoreColor(score * 10);
+}
+function escapeHtml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function scoreCircleSvg(score, size = 160) {
+  const radius = (size - 16) / 2;
+  const circumference = 2 * Math.PI * radius;
+  const progress = score / 100 * circumference;
+  const color = scoreColor(score);
+  return `<svg width="${size}" height="${size}" viewBox="0 0 ${size} ${size}">
+    <circle cx="${size / 2}" cy="${size / 2}" r="${radius}" fill="none" stroke="#e0e0e0" stroke-width="10"/>
+    <circle cx="${size / 2}" cy="${size / 2}" r="${radius}" fill="none" stroke="${color}" stroke-width="10"
+      stroke-dasharray="${circumference}" stroke-dashoffset="${circumference - progress}"
+      stroke-linecap="round" transform="rotate(-90 ${size / 2} ${size / 2})"/>
+    <text x="${size / 2}" y="${size / 2 + 2}" text-anchor="middle" dominant-baseline="middle"
+      font-size="42" font-weight="700" fill="${color}">${score}</text>
+    <text x="${size / 2}" y="${size / 2 + 24}" text-anchor="middle" dominant-baseline="middle"
+      font-size="13" fill="#666">/100</text>
+  </svg>`;
+}
+var CSS = `
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: #1a1a1a; background: #f8f9fa; line-height: 1.6; }
+  .container { max-width: 1100px; margin: 0 auto; padding: 32px 24px; }
+  .header { text-align: center; margin-bottom: 40px; }
+  .header h1 { font-size: 28px; font-weight: 700; margin-bottom: 4px; }
+  .header .date { color: #666; font-size: 14px; }
+  .score-section { display: flex; justify-content: center; margin: 24px 0 32px; }
+  .verdict { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 20px 24px; margin-bottom: 32px; font-size: 15px; color: #333; }
+  .section-title { font-size: 20px; font-weight: 700; margin-bottom: 16px; color: #1a1a1a; }
+  .scorecard-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 12px; margin-bottom: 32px; }
+  .criterion-card { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 14px 16px; display: flex; align-items: center; gap: 12px; }
+  .criterion-bar { width: 80px; height: 8px; background: #e0e0e0; border-radius: 4px; flex-shrink: 0; overflow: hidden; }
+  .criterion-bar-fill { height: 100%; border-radius: 4px; }
+  .criterion-score { font-size: 14px; font-weight: 700; min-width: 32px; text-align: center; }
+  .criterion-name { font-size: 13px; flex: 1; }
+  .criterion-status { font-size: 11px; color: #666; background: #f0f0f0; padding: 2px 8px; border-radius: 10px; white-space: nowrap; }
+  table { width: 100%; border-collapse: collapse; background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; overflow: hidden; margin-bottom: 32px; }
+  th { background: #f5f5f5; text-align: left; padding: 10px 14px; font-size: 13px; font-weight: 600; color: #555; border-bottom: 1px solid #e0e0e0; }
+  td { padding: 10px 14px; font-size: 13px; border-bottom: 1px solid #f0f0f0; }
+  .impact-badge { display: inline-block; padding: 2px 8px; border-radius: 10px; font-size: 11px; font-weight: 600; color: #fff; }
+  .impact-critical { background: #F44336; }
+  .impact-high { background: #FF5722; }
+  .impact-quick-win { background: #4CAF50; }
+  .impact-core-aeo { background: #2196F3; }
+  .impact-medium { background: #FF9800; }
+  .impact-low { background: #9E9E9E; }
+  .impact-big-opportunity { background: #9C27B0; }
+  .impact-measurement { background: #607D8B; }
+  .bottom-line { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 20px 24px; margin-bottom: 32px; font-size: 15px; }
+  .footer { text-align: center; color: #999; font-size: 12px; padding: 24px 0; border-top: 1px solid #e0e0e0; margin-top: 24px; }
+  .compare-header { display: flex; justify-content: center; align-items: center; gap: 48px; margin-bottom: 32px; }
+  .compare-site { text-align: center; }
+  .compare-site h2 { font-size: 20px; margin-bottom: 8px; }
+  .compare-vs { font-size: 24px; font-weight: 700; color: #999; }
+  .delta-positive { color: #4CAF50; font-weight: 600; }
+  .delta-negative { color: #F44336; font-weight: 600; }
+  .delta-zero { color: #999; }
+  .summary-box { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 16px 20px; margin-bottom: 24px; display: flex; gap: 24px; justify-content: center; flex-wrap: wrap; }
+  .summary-stat { text-align: center; }
+  .summary-stat .num { font-size: 28px; font-weight: 700; }
+  .summary-stat .label { font-size: 12px; color: #666; }
+  @media print {
+    body { background: #fff; }
+    .container { padding: 0; }
+    .criterion-card, .verdict, .bottom-line, table { break-inside: avoid; }
+  }
+  @media (max-width: 640px) {
+    .scorecard-grid { grid-template-columns: 1fr; }
+    .compare-header { flex-direction: column; gap: 16px; }
+  }
+`;
+function impactClass(impact) {
+  const key = impact.toLowerCase().replace(/\s+/g, "-");
+  return `impact-${key}`;
+}
+function generateHtmlReport(result) {
+  const domain = escapeHtml(result.site);
+  const date = escapeHtml(result.auditDate);
+  const scorecardCards = result.scorecard.map((item) => {
+    const color = criterionColor(item.score);
+    const width = item.score * 10;
+    return `<div class="criterion-card">
+        <div class="criterion-bar"><div class="criterion-bar-fill" style="width:${width}%;background:${color}"></div></div>
+        <span class="criterion-score" style="color:${color}">${item.score}/10</span>
+        <span class="criterion-name">${escapeHtml(item.criterion)}</span>
+        <span class="criterion-status">${escapeHtml(item.status)}</span>
+      </div>`;
+  }).join("\n");
+  const opportunityRows = result.opportunities.map((opp) => {
+    const cls = impactClass(opp.impact);
+    return `<tr>
+        <td>${opp.id}</td>
+        <td>${escapeHtml(opp.name)}</td>
+        <td><span class="impact-badge ${cls}">${escapeHtml(opp.impact)}</span></td>
+        <td>${escapeHtml(opp.effort)}</td>
+        <td>${escapeHtml(opp.description)}</td>
+      </tr>`;
+  }).join("\n");
+  const pagesRows = (result.pagesReviewed || []).map((page) => {
+    const issueCount = page.issues.length;
+    const strengthCount = page.strengths.length;
+    return `<tr>
+        <td>${escapeHtml(page.url)}</td>
+        <td>${escapeHtml(page.category)}</td>
+        <td>${page.wordCount}</td>
+        <td>${issueCount}</td>
+        <td>${strengthCount}</td>
+      </tr>`;
+  }).join("\n");
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AEORank Report - ${domain}</title>
+  <style>${CSS}</style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>${domain}</h1>
+      <div class="date">AEO Audit - ${date}</div>
+    </div>
+
+    <div class="score-section">
+      ${scoreCircleSvg(result.overallScore)}
+    </div>
+
+    <div class="verdict">${escapeHtml(result.verdict)}</div>
+
+    <h2 class="section-title">Scorecard (23 Criteria)</h2>
+    <div class="scorecard-grid">
+      ${scorecardCards}
+    </div>
+
+    ${result.opportunities.length > 0 ? `
+    <h2 class="section-title">Opportunities (${result.opportunities.length})</h2>
+    <table>
+      <thead><tr><th>#</th><th>Opportunity</th><th>Impact</th><th>Effort</th><th>Description</th></tr></thead>
+      <tbody>${opportunityRows}</tbody>
+    </table>
+    ` : ""}
+
+    ${(result.pagesReviewed || []).length > 0 ? `
+    <h2 class="section-title">Pages Reviewed (${(result.pagesReviewed || []).length})</h2>
+    <table>
+      <thead><tr><th>URL</th><th>Category</th><th>Words</th><th>Issues</th><th>Strengths</th></tr></thead>
+      <tbody>${pagesRows}</tbody>
+    </table>
+    ` : ""}
+
+    <div class="bottom-line"><strong>Bottom line:</strong> ${escapeHtml(result.bottomLine)}</div>
+
+    <div class="footer">Generated by AEORank - ${now}</div>
+  </div>
+</body>
+</html>`;
+}
+function generateComparisonHtmlReport(result) {
+  const domainA = escapeHtml(result.siteA.site);
+  const domainB = escapeHtml(result.siteB.site);
+  const scoreA = result.siteA.overallScore;
+  const scoreB = result.siteB.overallScore;
+  const criteriaRows = result.comparison.criteria.map((c) => {
+    const colorA = criterionColor(c.scoreA);
+    const colorB = criterionColor(c.scoreB);
+    const widthA = c.scoreA * 10;
+    const widthB = c.scoreB * 10;
+    let deltaHtml;
+    if (c.delta > 0) deltaHtml = `<span class="delta-positive">+${c.delta}</span>`;
+    else if (c.delta < 0) deltaHtml = `<span class="delta-negative">${c.delta}</span>`;
+    else deltaHtml = `<span class="delta-zero">0</span>`;
+    return `<tr>
+        <td>${c.id}</td>
+        <td>${escapeHtml(c.criterion)}</td>
+        <td>
+          <div style="display:flex;align-items:center;gap:8px">
+            <div class="criterion-bar"><div class="criterion-bar-fill" style="width:${widthA}%;background:${colorA}"></div></div>
+            <span style="color:${colorA};font-weight:600">${c.scoreA}</span>
+          </div>
+        </td>
+        <td>
+          <div style="display:flex;align-items:center;gap:8px">
+            <div class="criterion-bar"><div class="criterion-bar-fill" style="width:${widthB}%;background:${colorB}"></div></div>
+            <span style="color:${colorB};font-weight:600">${c.scoreB}</span>
+          </div>
+        </td>
+        <td style="text-align:center">${deltaHtml}</td>
+      </tr>`;
+  }).join("\n");
+  const advantagesA = result.comparison.siteAAdvantages.length;
+  const advantagesB = result.comparison.siteBAdvantages.length;
+  const tied = result.comparison.tied.length;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AEORank Comparison - ${domainA} vs ${domainB}</title>
+  <style>${CSS}</style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>AEO Comparison</h1>
+    </div>
+
+    <div class="compare-header">
+      <div class="compare-site">
+        <h2>${domainA}</h2>
+        ${scoreCircleSvg(scoreA, 120)}
+      </div>
+      <div class="compare-vs">vs</div>
+      <div class="compare-site">
+        <h2>${domainB}</h2>
+        ${scoreCircleSvg(scoreB, 120)}
+      </div>
+    </div>
+
+    <div class="summary-box">
+      <div class="summary-stat">
+        <div class="num" style="color:${scoreColor(scoreA)}">${advantagesA}</div>
+        <div class="label">${domainA} leads</div>
+      </div>
+      <div class="summary-stat">
+        <div class="num" style="color:${scoreColor(scoreB)}">${advantagesB}</div>
+        <div class="label">${domainB} leads</div>
+      </div>
+      <div class="summary-stat">
+        <div class="num" style="color:#999">${tied}</div>
+        <div class="label">Tied</div>
+      </div>
+    </div>
+
+    <h2 class="section-title">Per-Criterion Comparison</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Criterion</th>
+          <th>${domainA}</th>
+          <th>${domainB}</th>
+          <th>Delta</th>
+        </tr>
+      </thead>
+      <tbody>${criteriaRows}</tbody>
+    </table>
+
+    ${result.comparison.siteAAdvantages.length > 0 ? `
+    <h2 class="section-title">${domainA} Advantages</h2>
+    <div class="verdict">${result.comparison.siteAAdvantages.map((c) => escapeHtml(c)).join(", ")}</div>
+    ` : ""}
+
+    ${result.comparison.siteBAdvantages.length > 0 ? `
+    <h2 class="section-title">${domainB} Advantages</h2>
+    <div class="verdict">${result.comparison.siteBAdvantages.map((c) => escapeHtml(c)).join(", ")}</div>
+    ` : ""}
+
+    ${result.comparison.tied.length > 0 ? `
+    <h2 class="section-title">Tied Criteria</h2>
+    <div class="verdict">${result.comparison.tied.map((c) => escapeHtml(c)).join(", ")}</div>
+    ` : ""}
+
+    <div class="footer">Generated by AEORank - ${now}</div>
+  </div>
+</body>
+</html>`;
+}
+
 // src/cli.ts
-var VERSION = "1.0.0";
+var VERSION = "1.2.0";
 function printHelp() {
   console.log(`
   aeorank - AI Engine Optimization audit
 
   USAGE
     aeorank <domain> [options]
+    aeorank <domain-a> <domain-b> [options]   # comparison mode
 
   OPTIONS
     --json              Output raw JSON to stdout
     --summary           Print human-readable scorecard
+    --html              Generate standalone HTML report file
     --ci                CI mode: JSON + exit 1 if score < threshold
     --threshold <N>     Score threshold for --ci (default: 70)
     --no-headless       Skip Puppeteer SPA rendering
@@ -2517,18 +2845,33 @@ function printHelp() {
   EXAMPLES
     aeorank example.com
     aeorank example.com --json
+    aeorank example.com --html
     aeorank example.com --ci --threshold 80
-    aeorank example.com --summary --no-headless
+    aeorank site-a.com site-b.com
+    aeorank site-a.com site-b.com --html
+    aeorank site-a.com site-b.com --json
 `);
 }
 function parseArgs(argv) {
+  const defaults = { domain: "", domainB: null, json: false, summary: false, html: false, ci: false, threshold: 70, noHeadless: false, noMultiPage: false, version: false, help: false };
   if (argv.includes("--version") || argv.includes("-v")) {
-    return { domain: "", json: false, summary: false, ci: false, threshold: 70, noHeadless: false, noMultiPage: false, version: true, help: false };
+    return { ...defaults, version: true };
   }
   if (argv.includes("--help") || argv.includes("-h")) {
-    return { domain: "", json: false, summary: false, ci: false, threshold: 70, noHeadless: false, noMultiPage: false, version: false, help: true };
+    return { ...defaults, help: true };
   }
-  const domain = argv.find((a) => !a.startsWith("-")) || "";
+  const nonFlags = [];
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--threshold") {
+      i++;
+      continue;
+    }
+    if (!argv[i].startsWith("-")) {
+      nonFlags.push(argv[i]);
+    }
+  }
+  const domain = nonFlags[0] || "";
+  const domainB = nonFlags[1] || null;
   function getArg(name) {
     const idx = argv.indexOf(`--${name}`);
     if (idx === -1 || idx + 1 >= argv.length) return void 0;
@@ -2537,8 +2880,10 @@ function parseArgs(argv) {
   const threshold = parseInt(getArg("threshold") || "70", 10);
   return {
     domain,
+    domainB,
     json: argv.includes("--json"),
     summary: argv.includes("--summary"),
+    html: argv.includes("--html"),
     ci: argv.includes("--ci"),
     threshold: isNaN(threshold) ? 70 : threshold,
     noHeadless: argv.includes("--no-headless"),
@@ -2547,6 +2892,9 @@ function parseArgs(argv) {
     help: false
   };
 }
+function sanitizeFilename(domain) {
+  return domain.replace(/[^a-zA-Z0-9.-]/g, "-");
+}
 function printSummary(result) {
   const log = (msg) => process.stderr.write(msg + "\n");
   log("");
@@ -2582,6 +2930,28 @@ function printSummary(result) {
   log(`  Completed in ${result.elapsed}s`);
   log("");
 }
+function printComparisonSummary(result) {
+  const log = (msg) => process.stderr.write(msg + "\n");
+  const { siteA, siteB, comparison } = result;
+  log("");
+  log(`  ${siteA.site} (${siteA.overallScore}) vs ${siteB.site} (${siteB.overallScore})`);
+  log("  " + "\u2500".repeat(60));
+  log("");
+  const maxNameLen = Math.max(...comparison.criteria.map((c) => c.criterion.length), 20);
+  log(`  ${"#".padStart(3)}  ${"Criterion".padEnd(maxNameLen)}  ${siteA.site.padStart(10)}  ${siteB.site.padStart(10)}  ${"Delta".padStart(5)}`);
+  log("  " + "\u2500".repeat(3 + 2 + maxNameLen + 2 + 10 + 2 + 10 + 2 + 5));
+  for (const c of comparison.criteria) {
+    const barA = "\u2588".repeat(c.scoreA) + "\u2591".repeat(10 - c.scoreA);
+    const barB = "\u2588".repeat(c.scoreB) + "\u2591".repeat(10 - c.scoreB);
+    const delta = c.delta > 0 ? `+${c.delta}` : c.delta === 0 ? " 0" : `${c.delta}`;
+    log(`  ${c.id.toString().padStart(3)}  ${c.criterion.padEnd(maxNameLen)}  ${barA} ${c.scoreA.toString().padStart(2)}  ${barB} ${c.scoreB.toString().padStart(2)}  ${delta.padStart(5)}`);
+  }
+  log("");
+  log(`  ${siteA.site} leads in ${comparison.siteAAdvantages.length} criteria`);
+  log(`  ${siteB.site} leads in ${comparison.siteBAdvantages.length} criteria`);
+  log(`  Tied: ${comparison.tied.length} criteria`);
+  log("");
+}
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.version) {
@@ -2599,12 +2969,33 @@ async function main() {
   }
   const log = (msg) => process.stderr.write(`[aeorank] ${msg}
 `);
+  const auditOptions = { noHeadless: args.noHeadless, noMultiPage: args.noMultiPage };
   try {
+    if (args.domainB) {
+      log(`Comparing ${args.domain} vs ${args.domainB}...`);
+      const result2 = await compare(args.domain, args.domainB, auditOptions);
+      log(`${args.domain}: ${result2.siteA.overallScore}/100 (${result2.siteA.elapsed}s)`);
+      log(`${args.domainB}: ${result2.siteB.overallScore}/100 (${result2.siteB.elapsed}s)`);
+      if (args.json || args.ci) {
+        process.stdout.write(JSON.stringify(result2, null, 2) + "\n");
+      }
+      if (args.summary || !args.json && !args.ci) {
+        printComparisonSummary(result2);
+      }
+      if (args.html) {
+        const filename = `aeorank-${sanitizeFilename(args.domain)}-vs-${sanitizeFilename(args.domainB)}.html`;
+        const html = generateComparisonHtmlReport(result2);
+        writeFileSync(filename, html, "utf-8");
+        log(`HTML report: ${filename}`);
+      }
+      if (args.ci && result2.siteA.overallScore < args.threshold) {
+        log(`FAIL: ${args.domain} score ${result2.siteA.overallScore} is below threshold ${args.threshold}`);
+        process.exit(1);
+      }
+      return;
+    }
     log(`Auditing ${args.domain}...`);
-    const result = await audit(args.domain, {
-      noHeadless: args.noHeadless,
-      noMultiPage: args.noMultiPage
-    });
+    const result = await audit(args.domain, auditOptions);
     log(`Score: ${result.overallScore}/100 (${result.elapsed}s)`);
     if (args.json || args.ci) {
       process.stdout.write(JSON.stringify(result, null, 2) + "\n");
@@ -2612,6 +3003,12 @@ async function main() {
     if (args.summary || !args.json && !args.ci) {
       printSummary(result);
     }
+    if (args.html) {
+      const filename = `aeorank-${sanitizeFilename(args.domain)}.html`;
+      const html = generateHtmlReport(result);
+      writeFileSync(filename, html, "utf-8");
+      log(`HTML report: ${filename}`);
+    }
     if (args.ci && result.overallScore < args.threshold) {
       log(`FAIL: Score ${result.overallScore} is below threshold ${args.threshold}`);
       process.exit(1);