@nuxtseo/cli 0.1.3 → 0.2.0

package/dist/render.js

@@ -129,7 +129,7 @@ export function renderSearchStatus(data) {
     return `${fields([['Site', data.site], ['Search Console', 'disconnected']])}\nConnect Search Console in Site settings.`;
 }
 export function renderSearchAnalytics(data) {
-    if (data.type === 'pages') {
+    if (data.view === 'pages') {
         if (data.rows.length === 0)
             return 'No Search Console Page rows match these filters.';
         return [
@@ -137,7 +137,7 @@ export function renderSearchAnalytics(data) {
             ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.url}`),
         ].join('\n');
     }
-    if (data.type === 'keywords') {
+    if (data.view === 'keywords') {
         if (data.rows.length === 0)
             return 'No Search Console query rows match these filters.';
         return [
@@ -145,12 +145,275 @@ export function renderSearchAnalytics(data) {
             ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.keyword}`),
         ].join('\n');
     }
+    if (data.view === 'countries') {
+        if (data.rows.length === 0)
+            return 'No Search Console country rows match these filters.';
+        return [
+            `Search Console countries (${data.rows.length} of ${data.total})`,
+            ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.country}`),
+        ].join('\n');
+    }
+    if (data.view === 'devices') {
+        if (data.rows.length === 0)
+            return 'No Search Console device rows match these filters.';
+        return [
+            `Search Console devices (${data.rows.length} of ${data.total})`,
+            ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.device}`),
+        ].join('\n');
+    }
+    if (data.view === 'timeseries') {
+        if (data.daily.length === 0)
+            return 'No Search Console days match this period.';
+        return [
+            `Search Console daily totals (${data.daily.length} days, ${data.period})`,
+            ...data.daily.map(row => `${row.date}  ${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}`),
+        ].join('\n');
+    }
+    if (data.view === 'page-detail') {
+        if (data.rows.length === 0)
+            return `No Search Console queries match ${data.pageUrl}.`;
+        return [
+            `Search Console queries for ${data.pageUrl} (${data.rows.length})`,
+            ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.keyword}`),
+        ].join('\n');
+    }
+    if (data.view === 'keyword-detail') {
+        if (data.rows.length === 0)
+            return `No Search Console Pages match ${data.keyword}.`;
+        return [
+            `Search Console Pages for ${data.keyword} (${data.rows.length})`,
+            ...data.rows.map(row => `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}\n  ${row.page}`),
+        ].join('\n');
+    }
+    if (data.rows.length === 0)
+        return `No rows match the ${data.preset} analysis.`;
+    return [
+        `${data.preset} (${data.rows.length} of ${data.total})  ${data.description}`,
+        ...data.rows.map(row => [
+            `${row.clicks} clicks  ${row.impressions} impressions  position ${row.pos.toFixed(1)}`,
+            `  ${row.keyword}`,
+            row.page ? `  ${row.page}` : '',
+        ].filter(Boolean).join('\n')),
+    ].join('\n');
+}
+export function renderIndexingHistory(data) {
+    const scope = data.scope._tag === 'url' ? data.scope.url : `site, ${data.scope.field}`;
+    const header = fields([
+        ['Scope', scope],
+        ['Window', `${data.startDate} to ${data.endDate}`],
+        ['Complete', data.complete],
+        ['Resolved URL', data.resolvedUrl],
+    ]);
+    if (data.changes.length === 0) {
+        const observed = data.unchanged
+            ? `No indexing changes. ${data.unchanged.observations ?? 'unknown'} observations from ${data.unchanged.firstObservedDay ?? 'unknown'} to ${data.unchanged.lastObservedDay ?? 'unknown'}.`
+            : 'No indexing changes were retained for this window.';
+        return `${header}\n${observed}`;
+    }
+    return [
+        header,
+        `Changes (${data.changes.length})`,
+        ...data.changes.map((change) => {
+            const cause = change.cause._tag === 'sole-candidate'
+                ? `${change.cause.marker.day} ${change.cause.marker.label}`
+                : change.cause._tag === 'ambiguous'
+                    ? `${change.cause.markers.length} candidate changes`
+                    : 'no known change';
+            return [
+                `${change.field}: ${change.fromValue ?? 'none'} to ${change.toValue ?? 'none'}`,
+                `  ${change.url}`,
+                `  observed between ${change.afterDay} and ${change.beforeDay} (${change.observedOverDays} days)`,
+                `  cause: ${cause}`,
+            ].join('\n');
+        }),
+    ].join('\n');
+}
+export function renderUrlInspection(data) {
+    if (data._tag === 'no-inspection-data')
+        return `No retained URL Inspection for ${data.requestedUrl}.`;
+    if (data._tag === 'retained-evidence') {
+        return [
+            `Retained evidence for ${data.requestedUrl}. Google has not inspected this URL.`,
+            fields([
+                ['Evidence URL', data.evidenceUrl],
+                ['Issue', data.issueType],
+                ['Label', data.label],
+                ['Coverage', data.coverageState],
+                ['User canonical', data.userCanonical],
+                ['Google canonical', data.googleCanonical],
+                ['Canonicalised away', data.canonicalisedAway],
+                ['Observed', data.observedAt],
+                ['Last seen', data.lastSeenAt],
+            ]),
+        ].join('\n');
+    }
+    return [
+        fields([
+            ['Requested URL', data.requestedUrl],
+            ['Inspected URL', data.inspectedUrl],
+            ['Verdict', data.verdict],
+            ['Coverage', data.coverageState],
+            ['Indexing', data.indexingState],
+            ['robots.txt', data.robotsTxtState],
+            ['Page fetch', data.pageFetchState],
+            ['Crawled as', data.crawledAs],
+            ['Last crawl', data.lastCrawlTime],
+            ['User canonical', data.userCanonical],
+            ['Google canonical', data.googleCanonical],
+            ['Canonicalised away', data.canonicalisedAway],
+            ['Canonical mismatch', data.canonicalMismatchKind],
+            ['Last checked', data.lastCheckedAt],
+        ]),
+        `Sitemaps: ${data.sitemaps.length === 0 ? 'none' : data.sitemaps.join(', ')}`,
+        `Referring URLs: ${data.referringUrls.length}`,
+    ].join('\n');
+}
+export function renderAuditChanges(data) {
+    if (data.state === 'no-crawl')
+        return 'No crawl has finished for this Site.';
+    if (data.state === 'no-baseline')
+        return 'Only one crawl exists. Run another crawl to compare.';
+    const header = fields([
+        ['State', data.state],
+        ['Verdict', data.verdict],
+        ['Observed', data.window.observedAt],
+        ['Compared to', data.window.comparedTo],
+        ['Sampled', data.sampled],
+        ['Clicks at risk', data.clicksAtRisk],
+    ]);
+    const facet = (label, groups) => {
+        if (groups.groups.length === 0)
+            return [`${label}: none`];
+        return [
+            `${label} (${groups.groupTotal} groups, ${groups.pages} Pages)`,
+            ...groups.groups.map(group => [
+                `${group.pages} Pages  ${group.severity}  ${group.label}${group.spike ? '  spike' : ''}`,
+                ...group.examples.slice(0, 3).map(example => `  ${example.url}`),
+            ].join('\n')),
+        ];
+    };
+    return [
+        header,
+        ...facet('Regressions', data.regressions),
+        ...facet('Resolved', data.resolved),
+    ].join('\n');
+}
+export function renderLinkStructure(data) {
+    const header = fields([
+        ['Search Console', data.gscConnected],
+        ['Internal links', data.internalLinks],
+        ['Template links', `${data.templateLinks} to ${data.templateTargets} targets`],
+        ['Editorial links', `${data.editorialLinks} to ${data.editorialTargets} targets`],
+    ]);
+    const slots = data.templateSlots.length === 0
+        ? ['Template slots: none']
+        : [
+            `Template slots (${data.templateSlots.length} of ${data.templateSlotTotal})`,
+            ...data.templateSlots.map(slot => `${slot.templateLinks} links from ${slot.sourcePages} Pages  ${(slot.share * 100).toFixed(1)}%\n  ${slot.url}`),
+        ];
+    const deadEnds = data.deadEnds.length === 0
+        ? ['Dead ends: none']
+        : [
+            `Dead ends (${data.deadEnds.length} of ${data.deadEndGroupTotal} groups, ${data.deadEndPageTotal} Pages)${data.deadEndScanTruncated ? '  truncated' : ''}`,
+            ...data.deadEnds.map(group => `${group.pages} Pages  ${group.label}`),
+        ];
+    const anchors = data.genericAnchors.length === 0
+        ? ['Generic anchors: none']
+        : [
+            `Generic anchors (${data.genericAnchors.length} of ${data.genericAnchorTotal}, ${data.genericAnchorLinks} links)`,
+            ...data.genericAnchors.map(anchor => `${anchor.links} links to ${anchor.targets} targets  ${anchor.anchor}`),
+        ];
+    return [header, ...slots, ...deadEnds, ...anchors].join('\n');
+}
+export function renderSitemaps(data) {
+    if (data.sitemaps.length === 0)
+        return `No sitemaps are known for ${data.meta.siteUrl}.`;
+    return [
+        `Sitemaps for ${data.meta.siteUrl} (${data.sitemaps.length}), sync ${data.meta.syncStatus}`,
+        ...data.sitemaps.map(sitemap => [
+            `${sitemap.urlCount ?? 'unknown'} URLs  ${sitemap.errors} errors  ${sitemap.warnings} warnings${sitemap.isIndex ? '  index' : ''}${sitemap.isPending ? '  pending' : ''}`,
+            `  ${sitemap.path}`,
+            `  last downloaded ${sitemap.lastDownloaded ?? 'never'}`,
+        ].join('\n')),
+    ].join('\n');
+}
+export function renderSitemapUrls(data) {
+    if (data.items.length === 0)
+        return 'No sitemap URLs match these filters.';
+    return [
+        `Sitemap URLs (${data.items.length}), generation ${data.generation.id}`,
+        ...data.items.map(item => `${item.feedpath}\n  ${item.url}`),
+        data.page.nextCursor ? `More URLs available after cursor ${data.page.nextCursor}.` : '',
+    ].filter(Boolean).join('\n');
+}
+export function renderSitemapAction(data) {
     return fields([
-        ['View', data.type],
-        ['Period', data.period],
-        ['Rows', 'rows' in data ? data.rows.length : data.type === 'timeseries' ? data.daily.length : 0],
+        ['Action', data.action],
+        ['Sitemap', data.sitemapUrl],
+        ['Sitemaps now', data.sitemapCount],
     ]);
 }
+/**
+ * Web Analytics rows differ per view and share no discriminant field, so the
+ * requested view selects the projection instead of the payload.
+ */
+export function renderAnalytics(view, data) {
+    const delta = (label, value) => [
+        label,
+        `${value.current} (was ${value.prior}, ${(value.relative * 100).toFixed(1)}%)`,
+    ];
+    const record = data;
+    if (view === 'performance') {
+        return fields([
+            ['Provider', record.provider],
+            ['Phase', record.phase],
+            delta('Sessions', record.sessions),
+            delta('Users', record.users),
+            delta('Pageviews', record.pageviews),
+            delta('Engagement rate', record.engagementRate),
+            delta('Bounce rate', record.bounceRate),
+            delta('Key events', record.keyEvents),
+            ['Days', record.daily.length],
+            ['Data from', record.dataFrom],
+        ]);
+    }
+    if (view === 'key-events') {
+        return fields([
+            ['Provider', record.provider],
+            delta('Key events', record.total),
+            ['Days', record.daily?.length ?? 0],
+        ]);
+    }
+    const rows = (record.rows ?? []);
+    if (rows.length === 0)
+        return `No Web Analytics rows for ${view}.`;
+    const label = (row) => {
+        for (const key of ['page', 'source', 'country', 'device', 'label']) {
+            if (typeof row[key] === 'string')
+                return row[key];
+        }
+        return 'unknown';
+    };
+    return [
+        `Web Analytics ${view} (${rows.length}), provider ${record.provider}${view === 'dimension' ? `, dimension ${record.dimension}` : ''}`,
+        ...rows.map(row => `${row.sessions ?? 0} sessions  ${row.users ?? 0} users  ${row.pageviews ?? 0} pageviews\n  ${label(row)}`),
+    ].join('\n');
+}
+export function renderAccountToken(data) {
+    return [
+        fields([
+            ['Credential', data.credential],
+            ['Team', `${data.team.name ?? 'unnamed'} (${data.team.id})`],
+            ['Plan', data.team.plan],
+            ['Role', data.role],
+            ['User', data.user.email ?? data.user.id],
+            ['Token', data.token ? `${data.token.label ?? 'unlabelled'} (${data.token.id})` : 'none, browser session'],
+            ['Expires', data.token?.expiresAt ?? 'never'],
+            ['Last used', data.token?.lastUsedAt ?? 'never'],
+        ]),
+        `Scopes: ${data.scopes.join(', ')}`,
+    ].join('\n');
+}
 export function renderIndexingDiagnostics(data) {
     if (data.view === 'summary') {
         const indexedPercent = data.totalUrls > 0
@@ -270,6 +533,18 @@ export function renderLinkOpportunities(data) {
         ...data.rows.map(row => `${row.phrase}\n  From: ${row.sourceUrl}\n  To: ${row.targetUrl}`),
     ].join('\n');
 }
+export function renderTimeline(data) {
+    if (data.entries.length === 0)
+        return 'No Timeline Entries match these filters.';
+    return [
+        `Timeline (${data.entries.length})`,
+        ...data.entries.map((entry) => {
+            const label = typeof entry.rendered?.label === 'string' ? entry.rendered.label : entry.kind;
+            return `${entry.occurredAt}  ${entry.severity ?? 'unrated'}  ${entry.kind}\n  ${label}`;
+        }),
+        data.nextCursor ? `More Timeline Entries available — pass --cursor ${JSON.stringify(data.nextCursor)}.` : '',
+    ].filter(Boolean).join('\n');
+}
 export function renderRecoverableBacklinks(data) {
     if (data.items.length === 0)
         return 'No recoverable Backlinks. Every stored inbound link resolves.';
@@ -307,3 +582,371 @@ export function renderMentions(data) {
         ].join('\n')),
     ].join('\n');
 }
+const VITAL_UNIT = { lcp: 'ms', inp: 'ms', cls: '' };
+function vitalValue(metric, p75) {
+    if (p75 === null)
+        return 'none';
+    return `${p75}${VITAL_UNIT[metric]}`;
+}
+export function renderFieldVitals(data) {
+    const header = fields([
+        ['Target', data.target],
+        ['Form factor', data.formFactor],
+    ]);
+    if (!data.available)
+        return `${header}\n${data.message ?? 'No CrUX data for this target.'}`;
+    if (data.trend) {
+        const lines = ['lcp', 'inp', 'cls'].flatMap((metric) => {
+            const points = data.trend[metric];
+            if (points.length === 0)
+                return [`${metric.toUpperCase()}  no samples`];
+            return [
+                `${metric.toUpperCase()} (${points.length} weeks)`,
+                ...points.map(point => `  ${point.date}  ${vitalValue(metric, point.p75)}`),
+            ];
+        });
+        return [header, ...lines].join('\n');
+    }
+    const summary = data.summary;
+    if (!summary)
+        return header;
+    return [
+        header,
+        fields([
+            ['Overall', summary.overall],
+            ['As of', summary.asOf],
+            ...['lcp', 'inp', 'cls'].map(metric => [
+                metric.toUpperCase(),
+                `${vitalValue(metric, summary[metric].p75)}  ${summary[metric].status ?? 'unrated'}  delta ${summary[metric].deltaOverPeriod ?? 'none'}`,
+            ]),
+        ]),
+    ].join('\n');
+}
+export function renderFieldVitalFindings(data) {
+    if (data.findings.length === 0)
+        return data.message ?? 'No failing field vitals attributed to an element.';
+    const shown = `${data.offset + 1}-${data.offset + data.findings.length} of ${data.total}`;
+    return [
+        `Field vital findings (${shown}, source ${data.source ?? 'unknown'})`,
+        ...data.findings.map(finding => [
+            `${finding.metric.toUpperCase()}  ${finding.severity}  ${vitalValue(finding.metric, finding.p75)}  ${finding.route}`,
+            `  selector ${finding.selector}`,
+            `  est. views ${finding.estimatedViews}`,
+            `  ${finding.fixPrompt.split('\n').join('\n  ')}`,
+        ].join('\n')),
+    ].join('\n');
+}
+function spendLine(evidence) {
+    return ['Source', `${evidence._tag} (${evidence.spend.units} unit)`];
+}
+export function renderBacklinksSummary(data) {
+    return fields([
+        ['Target', data.target],
+        ['Domain rank', data.rank],
+        ['Backlinks', data.backlinks],
+        ['Referring domains', data.referringDomains],
+        ['Referring main domains', data.referringMainDomains],
+        ['Referring pages', data.referringPages],
+        ['Broken backlinks', data.brokenBacklinks],
+        ['Broken pages', data.brokenPages],
+        ['Spam score', data.spamScore],
+        spendLine(data.evidence),
+    ]);
+}
+export function renderReferringDomains(data) {
+    if (data.items.length === 0)
+        return `No referring domains for ${data.target}.`;
+    return [
+        `Referring domains for ${data.target} (${data.items.length} of ${data.total})`,
+        ...data.items.map(item => [
+            `${item.domain}`,
+            `  ${fields([
+                ['rank', item.rank],
+                ['backlinks', item.backlinks],
+                ['referring pages', item.referringPages],
+                ['broken backlinks', item.brokenBacklinks],
+                ['spam score', item.spamScore],
+                ['sessions (90d)', item.sessions],
+                ['first seen', item.firstSeen],
+            ]).split('\n').join('\n  ')}`,
+        ].join('\n')),
+        fields([spendLine(data.evidence)]),
+    ].join('\n');
+}
+export function renderBacklinkAnchors(data) {
+    if (data.items.length === 0)
+        return `No anchors for ${data.target}.`;
+    return [
+        `Backlink anchors for ${data.target} (${data.items.length} of ${data.total})`,
+        ...data.items.map(item => [
+            `${item.anchor || '(empty anchor)'}`,
+            `  ${fields([
+                ['backlinks', item.backlinks],
+                ['referring domains', item.referringDomains],
+                ['referring pages', item.referringPages],
+                ['spam score', item.spamScore],
+                ['first seen', item.firstSeen],
+            ]).split('\n').join('\n  ')}`,
+        ].join('\n')),
+        fields([spendLine(data.evidence)]),
+    ].join('\n');
+}
+export function renderBacklinksHistory(data) {
+    if (data.items.length === 0)
+        return `No Backlinks history for ${data.target}.`;
+    return [
+        `Backlinks history for ${data.target} (${data.items.length} months)`,
+        ...data.items.map(item => `${item.date}  backlinks ${item.backlinks ?? 'none'}  domains ${item.referringDomains ?? 'none'}  gained ${item.newReferringDomains ?? 'none'}  lost ${item.lostReferringDomains ?? 'none'}`),
+        fields([spendLine(data.evidence)]),
+    ].join('\n');
+}
+export function renderSiteStatus(data) {
+    if (!data.available)
+        return data.message ?? `No assessment for ${data.site} yet.`;
+    const blocks = [];
+    if (data.assessment) {
+        blocks.push([
+            data.assessment.summary,
+            `  ${data.assessment.recommendation}`,
+        ].join('\n'));
+    }
+    blocks.push(fields([
+        ['Site', data.site],
+        ['Reach', data.assessment?.reachStage],
+        ['Health', data.assessment?.healthStage],
+        ['Assessed', data.assessment?.assessedAt],
+        ['Data quality', data.dataQuality.status === 'complete'
+                ? 'complete'
+                : `${data.dataQuality.status}${data.dataQuality.reason ? ` (${data.dataQuality.reason})` : ''}`],
+        ['Open', data.openCount],
+        ['Verified', data.verifiedCount],
+    ]));
+    if (data.dataQuality.unavailableProofs.length)
+        blocks.push(`Unavailable proofs: ${data.dataQuality.unavailableProofs.join(', ')}`);
+    if (data.degradedSteps.length)
+        blocks.push(`Degraded pipeline steps: ${data.degradedSteps.join(', ')}`);
+    if (data.nextAction) {
+        blocks.push([
+            `Next action  ${data.nextAction.label}${data.nextAction.urgent ? '  (urgent)' : ''}`,
+            `  ${fields([
+                ['detail', data.nextAction.detail],
+                ['dimension', data.nextAction.dimension],
+                ['impact', data.nextAction.impact],
+                ['action id', data.nextAction.actionId],
+            ]).split('\n').join('\n  ')}`,
+        ].join('\n'));
+    }
+    if (data.changes.length) {
+        blocks.push([
+            `What changed (${data.changes.length})`,
+            ...data.changes.map(change => `  ${DIRECTION_MARK[change.direction]} ${change.label}${change.value ? `  ${change.value}` : ''}${change.window ? `  ${change.window}` : ''}`),
+        ].join('\n'));
+    }
+    if (data.receipts.length) {
+        blocks.push([
+            `Receipts (${data.receipts.length})`,
+            ...data.receipts.map(receipt => `  ${receipt.observedAt}  ${receipt.title}`),
+        ].join('\n'));
+    }
+    return blocks.join('\n\n');
+}
+const DIRECTION_MARK = { up: 'up', down: 'down', flat: 'flat' };
+export function renderActionDismissal(data) {
+    return fields([
+        ['Action', data.actionId],
+        ['Status', data.status],
+        ['Result', data.message],
+    ]);
+}
+export function renderPageIssues(data) {
+    if (data.issues.length === 0) {
+        const keys = data.availableKeys?.length
+            ? `\nAvailable source and issue pairs:\n${data.availableKeys.map(key => `  ${key.source}  ${key.issue}  ${key.openCount} open`).join('\n')}`
+            : '';
+        return `${data.message ?? 'No open Page Issues matched.'}${keys}`;
+    }
+    const shown = `${data.offset + 1}-${data.offset + data.issues.length} of ${data.total}`;
+    const truncated = data.coverage.possiblyTruncated
+        ? `\nStorage caps this source at ${data.coverage.perSourceCap} rows, so the total is a floor.`
+        : '';
+    return [
+        `Page Issues (${shown})`,
+        ...data.issues.map(issue => [
+            `${issue.severity}  ${issue.source}/${issue.issueType}  ${issue.url}`,
+            `  ${fields([
+                ['label', issue.detail.label ?? issue.detail.title],
+                ['status', issue.detail.statusCode],
+                ['redirects to', issue.detail.redirectTarget],
+                ['observed', issue.detail.observedAt ?? issue.lastSeenAt],
+                ['linked from', issue.linkedFromTotal],
+                ['resolution', issue.resolution],
+            ]).split('\n').join('\n  ')}`,
+            ...issue.detail.elements.slice(0, 3).map(element => `    ${element.selector ?? element.message ?? ''}`.trimEnd()),
+        ].filter(Boolean).join('\n')),
+    ].join('\n') + truncated;
+}
+export function renderScans(data) {
+    if (data.scans.length === 0)
+        return 'No Lighthouse Scans retained for this Site.';
+    return [
+        `Scans (${data.scans.length})`,
+        ...data.scans.map(scan => [
+            `${scan.completedAt ?? 'pending'}  ${scan.strategy}  ${scan.status}  ${scan.url}`,
+            `  ${fields([
+                ['id', scan.id],
+                ['performance', scan.scores.perf],
+                ['accessibility', scan.scores.a11y],
+                ['best practices', scan.scores.bestPractices],
+                ['seo', scan.scores.seo],
+                ['lcp', scan.lcp],
+                ['tbt', scan.tbt],
+                ['cls', scan.cls],
+                ['error', scan.error],
+            ]).split('\n').join('\n  ')}`,
+        ].join('\n')),
+    ].join('\n');
+}
+export function renderMonitoredPages(data) {
+    if (data.pages.length === 0)
+        return 'No monitored Pages. Start one with `nuxtseo page scan <url>`.';
+    return [
+        `Monitored Pages (${data.pages.length})`,
+        ...data.pages.map(page => `  ${page.enabled ? 'on ' : 'off'}  ${page.path}  last scan ${page.lastScanAt ?? 'never'}`),
+    ].join('\n');
+}
+export function renderScanDetail(data) {
+    const blocks = [
+        fields([
+            ['Scan', data.id],
+            ['URL', data.url],
+            ['Strategy', data.strategy],
+            ['Status', data.status],
+            ['Completed', data.completedAt],
+            ['Performance', data.scores.perf],
+            ['Accessibility', data.scores.a11y],
+            ['Best practices', data.scores.bestPractices],
+            ['SEO', data.scores.seo],
+            ['LCP', data.lcp],
+            ['TBT', data.tbt],
+            ['CLS', data.cls],
+            ['FCP', data.fcp],
+            ['Speed Index', data.speedIndex],
+            ['TTFB', data.ttfb],
+        ]),
+    ];
+    if (data.lcpElement)
+        blocks.push(`LCP element  ${data.lcpElement.selector ?? data.lcpElement.nodeLabel ?? 'unknown'}`);
+    if (data.performanceIssues.length) {
+        blocks.push([
+            `Wasteful assets (${data.performanceIssues.length})`,
+            ...data.performanceIssues.map(issue => `  ${issue.wastedMs ?? 0}ms  ${issue.wastedBytes ?? 0}b  ${issue.subtype ?? issue.type}  ${issue.url ?? ''}`.trimEnd()),
+        ].join('\n'));
+    }
+    if (data.thirdParties.length) {
+        blocks.push([
+            `Third parties (${data.thirdParties.length})`,
+            ...data.thirdParties.map(script => `  ${script.blockingTime ?? 0}ms blocking  ${script.entity ?? 'unknown'}`),
+        ].join('\n'));
+    }
+    for (const [label, checks] of [['Accessibility failures', data.accessibility], ['Best-practices failures', data.bestPractices]]) {
+        if (!checks.length)
+            continue;
+        blocks.push([
+            `${label} (${checks.length})`,
+            ...checks.map(check => [
+                `  ${check.severity}  ${check.title}  ${check.elementsTotal ?? check.instanceCount} element(s)`,
+                ...check.elements.slice(0, 3).map(element => `      ${element.selector ?? element.message ?? ''}`.trimEnd()),
+            ].join('\n')),
+        ].join('\n'));
+    }
+    if (data.coverage.possiblyTruncated)
+        blocks.push(`Capped at ${data.coverage.perScanCheckCap} checks and ${data.coverage.perCheckElementCap} elements per check; totals are ${data.coverage.accessibilityChecksTotal} accessibility and ${data.coverage.bestPracticesChecksTotal} best-practices checks.`);
+    return blocks.join('\n\n');
+}
+export function renderAnnotations(data) {
+    if (data.annotations.length === 0)
+        return 'No annotations on this Site.';
+    return [
+        `Annotations (${data.annotations.length} of ${data.limit} max)`,
+        ...data.annotations.map(annotation => `  ${annotation.date}  ${annotation.title}${annotation.url ? `  ${annotation.url}` : ''}  [${annotation.id}]`),
+    ].join('\n');
+}
+export function renderAnnotation(data) {
+    return fields([
+        ['Annotation', data.annotation.id],
+        ['Date', data.annotation.date],
+        ['Title', data.annotation.title],
+        ['Note', data.annotation.note],
+        ['Link', data.annotation.url],
+    ]);
+}
+export function renderAnnotationDeleted(data) {
+    return `Deleted annotation ${data.annotationId}.`;
+}
+export function renderIndexCohorts(data) {
+    if (!data.analysed)
+        return data.message ?? 'Route-family indexing analysis is unavailable.';
+    const blocks = [
+        fields([
+            ['As of', data.asOf],
+            ['Pages analysed', data.baseline?.pages],
+            ['Not indexed', data.baseline?.notIndexed],
+            ['Not indexed %', data.baseline?.notIndexedPercent],
+            ['Families tested', data.familiesTested],
+        ]),
+    ];
+    if (data.established.length) {
+        blocks.push([
+            `Established worse than the rest of the Site (${data.established.length})`,
+            ...data.established.map(cell => `  ${cell.family}  ${cell.notIndexedPercent}% of ${cell.pages} pages  rest of Site ${cell.restOfSitePercent}%  CI ${cell.confidenceIntervalLower}-${cell.confidenceIntervalUpper}%`),
+        ].join('\n'));
+    }
+    else if (data.establishedNote) {
+        blocks.push(data.establishedNote);
+    }
+    if (data.ranked.length) {
+        blocks.push([
+            `Ranked by raw rate, not tested (${data.ranked.length} of ${data.rankedTotal})`,
+            'A row marked "lead" has NOT been shown to differ from the rest of the Site. Report it as a lead to check, never as a cause.',
+            ...data.ranked.map(section => `  ${section.notIndexedPercent}%  ${section.notIndexed}/${section.pages}  ${section.family}  ${section.statisticallyEstablished ? 'established' : 'lead'}`),
+        ].join('\n'));
+    }
+    return blocks.join('\n\n');
+}
+export function renderDomainTraffic(data) {
+    const blocks = [
+        fields([
+            ['Domain', data.domain],
+            ['Monthly traffic', data.monthlyTraffic],
+            ['Trend', data.trend],
+            ['Change %', data.changePercent],
+            ['Traffic value', data.trafficValue],
+            ['Keyword footprint', data.keywordFootprint],
+            ['Source', `${data.evidence._tag} (${data.evidence.spend.units} unit)`],
+        ]),
+    ];
+    if (data.topPages.length) {
+        blocks.push([
+            `Top pages (${data.topPages.length})`,
+            ...data.topPages.map(page => `  ${page.traffic}  ${page.keywords} keywords  ${page.path}`),
+        ].join('\n'));
+    }
+    if (data.topCountries.length) {
+        blocks.push([
+            `Top countries (${data.topCountries.length})`,
+            ...data.topCountries.map(row => `  ${row.percent}%  ${row.country}`),
+        ].join('\n'));
+    }
+    if (data.message)
+        blocks.push(data.message);
+    return blocks.join('\n\n');
+}
+export function renderDomainAvailability(data) {
+    if (data.results.length === 0)
+        return data.message ?? 'No domains checked.';
+    return [
+        `Domains (${data.results.length})`,
+        ...data.results.map(row => `  ${row.available ? 'available' : 'taken    '}  ${row.domain}${row.registrar ? `  ${row.registrar}` : ''}${row.expiration ? `  expires ${row.expiration}` : ''}`),
+        fields([['Source', `${data.evidence._tag} (${data.evidence.spend.units} unit)`]]),
+    ].join('\n');
+}