headhunt 1.0.0

package/src/reporter.js

@@ -0,0 +1,287 @@
+const { C, fmt } = require('./colors');
+const { SCORE_WEIGHTS } = require('./constants');
+
+function printBanner() {
+    console.log();
+    console.log(fmt.cyan(fmt.bold(
+        '  ██╗  ██╗███████╗ █████╗ ██████╗ ██╗  ██╗██╗   ██╗███╗   ██╗████████╗    ██████╗██╗     ██╗'
+    )));
+    console.log(fmt.cyan(
+        '  ██║  ██║██╔════╝██╔══██╗██╔══██╗██║  ██║██║   ██║████╗  ██║╚══██╔══╝   ██╔════╝██║     ██║'
+    ));
+    console.log(fmt.cyan(
+        '  ███████║█████╗  ███████║██║  ██║███████║██║   ██║██╔██╗ ██║   ██║█████╗██║     ██║     ██║'
+    ));
+    console.log(fmt.cyan(
+        '  ██╔══██║██╔══╝  ██╔══██║██║  ██║██╔══██║██║   ██║██║╚██╗██║   ██║╚════╝██║     ██║     ██║'
+    ));
+    console.log(fmt.cyan(
+        '  ██║  ██║███████╗██║  ██║██████╔╝██║  ██║╚██████╔╝██║ ╚████║   ██║      ╚██████╗███████╗██║'
+    ));
+    console.log(fmt.cyan(
+        '  ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝   ╚═╝       ╚═════╝╚══════╝╚═╝'
+    ));
+    console.log(fmt.dim('  Developed by @imharris24'));
+    console.log();
+}
+
+function line(char = '\u2500', len = 60) {
+    return fmt.dim(char.repeat(len));
+}
+
+function scoreBar(score, max, width = 20) {
+    const pct = score / max;
+    const filled = Math.round(pct * width);
+    const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(width - filled);
+    if (pct >= 0.8) return fmt.brightGreen(bar);
+    if (pct >= 0.6) return fmt.yellow(bar);
+    if (pct >= 0.4) return fmt.brightYellow(bar);
+    return fmt.red(bar);
+}
+
+function gradeColor(grade) {
+    if (grade.startsWith('A')) return fmt.brightGreen(grade);
+    if (grade.startsWith('B')) return fmt.green(grade);
+    if (grade.startsWith('C')) return fmt.yellow(grade);
+    if (grade.startsWith('D')) return fmt.brightYellow(grade);
+    return fmt.red(grade);
+}
+
+function scoreColor(score) {
+    if (score >= 85) return fmt.brightGreen(score + '/100');
+    if (score >= 70) return fmt.green(score + '/100');
+    if (score >= 55) return fmt.yellow(score + '/100');
+    if (score >= 40) return fmt.brightYellow(score + '/100');
+    return fmt.red(score + '/100');
+}
+
+function priorityLabel(p) {
+    const map = {
+        CRITICAL: fmt.brightRed('\u25CF CRITICAL'),
+        HIGH: fmt.yellow('\u25CF HIGH    '),
+        MEDIUM: fmt.brightYellow('\u25CF MEDIUM  '),
+        LOW: fmt.cyan('\u25CF LOW     '),
+    };
+    return map[p] || p;
+}
+
+function impactBadge(impact) {
+    if (impact === 'Very High') return `${C.bgRed}${C.bold} VERY HIGH ${C.reset}`;
+    if (impact === 'High') return `${C.bgYellow}${C.black}${C.bold} HIGH      ${C.reset}`;
+    if (impact === 'Medium') return `${C.bgCyan}${C.black}${C.bold} MEDIUM    ${C.reset}`;
+    return `${C.dim} LOW       ${C.reset}`;
+}
+
+function effortBadge(effort) {
+    if (effort === 'Low') return fmt.brightGreen('Quick fix');
+    if (effort === 'Medium') return fmt.yellow('Moderate');
+    return fmt.red('Complex');
+}
+
+function printReport(meta, options = {}) {
+    const s = meta.seo;
+    const W = 68;
+
+    console.log(line('\u2550', W));
+    console.log();
+    console.log(`  ${fmt.bold(fmt.brightCyan('TARGET'))}  ${meta.finalUrl}`);
+    console.log(`  ${fmt.bold(fmt.dim('SCANNED'))} ${new Date(meta.timestamp).toLocaleString()}`);
+    if (meta.seo.basic?.cms) console.log(`  ${fmt.bold(fmt.dim('PLATFORM'))} ${meta.seo.basic.cms}`);
+    console.log();
+
+    const grade = meta.grade;
+    const score = meta.overallScore;
+    console.log(line('\u2500', W));
+    console.log();
+    console.log(`  ${fmt.bold('OVERALL SEO SCORE')}`);
+    console.log();
+    console.log(`    ${scoreBar(score, 100, 30)}  ${scoreColor(score)}  Grade: ${gradeColor(grade)}`);
+    console.log();
+    console.log(`  ${fmt.dim(meta.summary)}`);
+    console.log();
+    console.log(line('\u2500', W));
+
+    console.log();
+    console.log(`  ${fmt.bold('CATEGORY BREAKDOWN')}`);
+    console.log();
+
+    for (const [key, val] of Object.entries(meta.scores)) {
+        const label = SCORE_WEIGHTS[key]?.label || key;
+        const pct = val.score / val.max;
+        const status = pct >= 0.8 ? fmt.brightGreen('\u2713') : pct >= 0.5 ? fmt.yellow('~') : fmt.red('\u2717');
+        const padded = label.padEnd(22);
+        console.log(`  ${status} ${fmt.dim(padded)} ${scoreBar(val.score, val.max, 12)}  ${String(val.score).padStart(2)}/${val.max}`);
+    }
+    console.log();
+    console.log(line('\u2500', W));
+
+    console.log();
+    console.log(`  ${fmt.bold('QUICK STATS')}`);
+    console.log();
+
+    const basic = s.basic || {};
+    const tech = s.technical || {};
+    const perf = s.performance || {};
+    const cont = s.content || {};
+    const img = s.images || {};
+    const lnk = s.links || {};
+
+    const stat = (label, value, highlight = false) => {
+        const l = fmt.dim(label.padEnd(26));
+        const v = highlight ? fmt.brightCyan(String(value)) : String(value);
+        return `  ${l} ${v}`;
+    };
+
+    console.log(stat('Title', basic.title ? `"${(basic.title || '').substring(0, 40)}\u2026" (${basic.titleLength}c)` : fmt.red('MISSING')));
+    console.log(stat('Meta Description', basic.metaDescription ? `${basic.descriptionLength} chars` : fmt.red('MISSING')));
+    console.log(stat('Canonical', basic.canonical ? fmt.green('Present') : fmt.yellow('Missing')));
+    console.log(stat('Language', basic.language || fmt.yellow('Not set')));
+    console.log(stat('H1 Tags', s.headings?.counts?.h1 === 1 ? fmt.green('1 (ideal)') : fmt.yellow(String(s.headings?.counts?.h1 || 0))));
+    console.log(stat('Word Count', cont.wordCount ? `~${cont.wordCount} words (${cont.estimatedReadingMinutes} min read)` : 'n/a'));
+    console.log(stat('Images', img.counts ? `${img.counts.total} total, ${img.counts.altCoverage}% have alt` : 'n/a'));
+    console.log(stat('Internal Links', lnk.counts ? String(lnk.counts.internal) : 'n/a'));
+    console.log(stat('External Links', lnk.counts ? String(lnk.counts.external) : 'n/a'));
+    console.log(stat('Schema Types', s.schema?.schemaTypes?.length ? s.schema.schemaTypes.join(', ').substring(0, 40) : fmt.yellow('None found')));
+    console.log(stat('Open Graph Tags', Object.keys(s.openGraph || {}).length ? `${Object.keys(s.openGraph).length} tags` : fmt.yellow('None')));
+    console.log(stat('Twitter Card', s.twitter?.card || fmt.yellow('Not set')));
+    console.log(stat('HTTPS', tech.https ? fmt.green('Yes') : fmt.red('No')));
+    console.log(stat('HTML Size', `${perf.htmlSizeKB || '?'} KB`));
+    console.log(stat('Response Time', `${meta.fetchTimeMs}ms`));
+    console.log(stat('Server', tech.serverInfo || fmt.dim('hidden')));
+
+    console.log();
+    console.log(line('\u2500', W));
+
+    const recs = meta.recommendations;
+    if (recs.length === 0) {
+        console.log();
+        console.log(`  ${fmt.brightGreen('\uD83C\uDFC6 No major issues found. This page has excellent SEO hygiene.')}`);
+        console.log();
+    } else {
+        console.log();
+        console.log(`  ${fmt.bold('RECOMMENDATIONS')}  ${fmt.dim(`(${recs.length} items)`)}`);
+        console.log();
+
+        const shown = options.audit ? recs : recs.slice(0, 10);
+
+        for (let i = 0; i < shown.length; i++) {
+            const r = shown[i];
+            console.log(`  ${String(i + 1).padStart(2)}. ${priorityLabel(r.priority)}  ${fmt.bold(r.category)}`);
+            console.log(`      ${fmt.yellow('Issue:')} ${r.issue}`);
+            if (options.audit) {
+                console.log(`      ${fmt.cyan('Fix:  ')} ${r.recommendation}`);
+                console.log(`      ${fmt.dim('Impact:')} ${impactBadge(r.impact)}   ${fmt.dim('Effort:')} ${effortBadge(r.effort)}`);
+            } else {
+                console.log(`      ${fmt.cyan('Fix:  ')} ${r.recommendation.substring(0, 120)}${r.recommendation.length > 120 ? '\u2026' : ''}`);
+            }
+            console.log();
+        }
+
+        if (!options.audit && recs.length > 10) {
+            console.log(`  ${fmt.dim(`  \u2026 and ${recs.length - 10} more. Run with --audit for full recommendations.`)}`);
+            console.log();
+        }
+    }
+
+    console.log(line('\u2500', W));
+
+    console.log();
+    console.log(`  ${fmt.bold('TECHNICAL & SECURITY SIGNALS')}`);
+    console.log();
+
+    const check = (label, pass, note = '') => {
+        const icon = pass ? fmt.brightGreen('\u2713') : fmt.red('\u2717');
+        const l = fmt.dim(label.padEnd(30));
+        const n = note ? fmt.dim(` ${note}`) : '';
+        console.log(`  ${icon} ${l}${n}`);
+    };
+
+    check('HTTPS', tech.https);
+    check('HSTS Header', tech.hsts);
+    check('X-Frame-Options', tech.xFrameOptions);
+    check('X-Content-Type-Options', tech.xContentTypeOptions);
+    check('Content Security Policy', tech.csp);
+    check('Referrer Policy', tech.referrerPolicy);
+    check('Viewport Meta', tech.hasViewport);
+    check('Charset Declared', tech.hasCharset);
+    check('Favicon', tech.hasFavicon);
+    check('Web Manifest', tech.hasManifest);
+    check('Sitemap Link', tech.hasSitemap, tech.sitemapUrl ? tech.sitemapUrl.substring(0, 40) : '');
+    check('RSS Feed', tech.hasRSS);
+    check('AMP Version', tech.hasAMP);
+    check('hreflang Tags', (s.basic?.hreflang?.length || 0) > 0, s.basic?.hreflang?.length ? `${s.basic.hreflang.length} locales` : '');
+
+    if (perf.headScripts > 0) {
+        check('Render-blocking Scripts', false, `${perf.headScripts} in <head>`);
+    } else {
+        check('No Render-blocking Scripts', true);
+    }
+    check('Deferred/Async Scripts', perf.deferScripts + perf.asyncScripts > 0, `${perf.deferScripts}d + ${perf.asyncScripts}a`);
+
+    console.log();
+    console.log(line('\u2550', W));
+    console.log();
+    console.log(fmt.dim(`  Run with --json-file to save full report  |  --audit for deep recommendations`));
+    console.log();
+}
+
+function printComparison(metaA, metaB) {
+    const W = 80;
+    console.log(line('\u2550', W));
+    console.log();
+    console.log(`  ${fmt.bold('SEO COMPARISON')}`);
+    console.log();
+    console.log(`  A: ${fmt.cyan(metaA.url)}`);
+    console.log(`  B: ${fmt.cyan(metaB.url)}`);
+    console.log();
+    console.log(line('\u2500', W));
+    console.log();
+
+    const colA = fmt.bold('  A'.padEnd(10));
+    const colB = fmt.bold('B'.padEnd(10));
+    console.log(`  ${'METRIC'.padEnd(28)} ${colA} ${colB}`);
+    console.log(line('\u2500', W));
+
+    const row = (label, a, b, higherIsBetter = true) => {
+        const la = String(a).padEnd(16);
+        const lb = String(b);
+        let fa = la, fb = lb;
+        if (typeof a === 'number' && typeof b === 'number') {
+            const aWins = higherIsBetter ? a > b : a < b;
+            const bWins = higherIsBetter ? b > a : b < a;
+            fa = (aWins ? fmt.brightGreen(la) : (aWins === false && bWins ? fmt.red(la) : la));
+            fb = (bWins ? fmt.brightGreen(lb) : (bWins === false && aWins ? fmt.red(lb) : lb));
+        }
+        console.log(`  ${fmt.dim(label.padEnd(28))} ${fa} ${fb}`);
+    };
+
+    row('Overall Score', metaA.overallScore, metaB.overallScore);
+    row('Grade', metaA.grade, metaB.grade);
+    row('Response Time (ms)', metaA.fetchTimeMs, metaB.fetchTimeMs, false);
+    row('HTML Size (KB)', metaA.seo.performance?.htmlSizeKB, metaB.seo.performance?.htmlSizeKB, false);
+    row('Word Count', metaA.seo.content?.wordCount, metaB.seo.content?.wordCount);
+    row('H1 Count', metaA.seo.headings?.counts?.h1, metaB.seo.headings?.counts?.h1);
+    row('Images Total', metaA.seo.images?.counts?.total, metaB.seo.images?.counts?.total);
+    row('Alt Coverage %', metaA.seo.images?.counts?.altCoverage, metaB.seo.images?.counts?.altCoverage);
+    row('Internal Links', metaA.seo.links?.counts?.internal, metaB.seo.links?.counts?.internal);
+    row('Schema Types', metaA.seo.schema?.jsonLd?.length, metaB.seo.schema?.jsonLd?.length);
+    row('OG Tags', Object.keys(metaA.seo.openGraph || {}).length, Object.keys(metaB.seo.openGraph || {}).length);
+    row('Recommendations', metaA.recommendations.length, metaB.recommendations.length, false);
+    row('HTTPS', metaA.seo.technical?.https ? 1 : 0, metaB.seo.technical?.https ? 1 : 0);
+
+    const winner = metaA.overallScore > metaB.overallScore ? 'A' : metaB.overallScore > metaA.overallScore ? 'B' : 'TIE';
+    console.log();
+    console.log(line('\u2500', W));
+    console.log();
+    if (winner === 'TIE') {
+        console.log(`  ${fmt.yellow('\u2696  RESULT: Both pages are evenly matched.')}`);
+    } else {
+        console.log(`  ${fmt.brightGreen(`\uD83C\uDFC6 WINNER: URL ${winner}`)} \u2014 ${winner === 'A' ? metaA.url : metaB.url}`);
+        const diff = Math.abs(metaA.overallScore - metaB.overallScore);
+        console.log(`  ${fmt.dim(`   Margin: ${diff} points (${diff < 5 ? 'very close' : diff < 15 ? 'moderate gap' : 'significant gap'})`)}`);
+    }
+    console.log();
+    console.log(line('\u2550', W));
+}
+
+module.exports = { printBanner, line, scoreBar, gradeColor, scoreColor, priorityLabel, impactBadge, effortBadge, printReport, printComparison };