aeoptimize 0.6.2 → 0.7.0

package/dist/core/audit.js

@@ -0,0 +1,301 @@
+import { readFile, stat } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { fetchUrlResource, parseHtml, parseMarkdown } from './scanner.js';
+const AUDIT_CONTRACT_VERSION = '1.0';
+const MAX_FILE_SIZE = 5 * 1024 * 1024;
+function evidence(source, observed) {
+    return { source, observed };
+}
+function sourceFor(context) {
+    return context.rendering === 'markdown' ? 'markdown' : 'html';
+}
+function makeCheck(id, label, status, checkEvidence, explanation, remediation, validation) {
+    return {
+        id,
+        label,
+        status,
+        evidence: checkEvidence,
+        explanation,
+        remediation,
+        validation,
+    };
+}
+function checkHttp(context) {
+    if (!context.http) {
+        return makeCheck('http-status', 'HTTP status and redirects', 'N/A', [evidence('derived', { reason: 'Local files have no HTTP response.' })], 'No network request was made for this local document.', null, 'Serve the built page over HTTP and audit its public or staging URL.');
+    }
+    const { status, statusText, redirects, contentType } = context.http;
+    const statusResult = status >= 200 && status < 300 ? 'PASS' : 'FAIL';
+    const redirectChain = redirects.map((hop) => `${hop.status} ${hop.from} -> ${hop.to}`);
+    return makeCheck('http-status', 'HTTP status and redirects', statusResult, [evidence('http', {
+            status,
+            statusText,
+            finalUrl: context.target.finalUrl ?? context.target.input,
+            redirectCount: redirects.length,
+            redirectChain,
+            contentType,
+        })], statusResult === 'PASS'
+        ? `The final response returned HTTP ${status}. Redirects are reported as observed facts and are not scored.`
+        : `The final response returned HTTP ${status}, so the page was not retrieved as a successful document.`, statusResult === 'PASS'
+        ? null
+        : 'Restore a successful final response or intentionally return the correct removal status, then update links and sitemaps that still reference this URL.', 'Request the URL again with redirects disabled and confirm every hop plus the final status.');
+}
+function checkTitle(doc, context) {
+    const observedTitle = context.rendering === 'markdown' ? doc.title : (doc.documentTitle ?? '');
+    const status = observedTitle.trim() ? 'PASS' : 'FAIL';
+    return makeCheck('document-title', 'Document title', status, [evidence(sourceFor(context), { title: observedTitle || null })], status === 'PASS'
+        ? 'A document title was found. This check does not impose a fixed character count.'
+        : 'No document title was found in the HTML title element or Markdown title source.', status === 'PASS'
+        ? null
+        : 'Add a concise, page-specific title that accurately describes the visible content.', 'Inspect the rendered document title and verify that it remains page-specific after the build.');
+}
+function checkDescription(doc, context) {
+    const frontmatterDescription = typeof doc.frontmatter?.description === 'string'
+        ? doc.frontmatter.description
+        : '';
+    const description = doc.metaTags.description || frontmatterDescription;
+    if (!description && context.rendering === 'markdown') {
+        return makeCheck('meta-description', 'Meta description', 'N/A', [evidence('markdown', { description: null })], 'The source Markdown has no description field. Its final HTML template was not inspected.', null, 'Audit the rendered HTML and inspect its meta description.');
+    }
+    const status = description ? 'PASS' : 'WARNING';
+    return makeCheck('meta-description', 'Meta description', status, [evidence(sourceFor(context), { description: description || null })], status === 'PASS'
+        ? 'A page-specific description candidate is present. Search engines may still choose another snippet.'
+        : 'No meta description was found. This is a review item, not proof of a search-performance problem.', status === 'PASS'
+        ? null
+        : 'Add an accurate page-specific description when the template should provide one. Do not pad it to a fixed length.', 'Inspect the built HTML and compare the description with the visible page purpose.');
+}
+function checkHeadings(doc, context) {
+    const h1Count = doc.headings.filter((heading) => heading.level === 1).length;
+    const skippedLevels = [];
+    for (let index = 1; index < doc.headings.length; index += 1) {
+        const previous = doc.headings[index - 1].level;
+        const current = doc.headings[index].level;
+        if (current > previous + 1)
+            skippedLevels.push(`H${previous} -> H${current}`);
+    }
+    let status = 'PASS';
+    let explanation = 'The document exposes a main heading and no skipped heading levels were detected.';
+    let remediation = null;
+    if (doc.headings.length === 0) {
+        status = 'FAIL';
+        explanation = 'No headings were found in the inspected document.';
+        remediation = 'Add descriptive headings that reflect the document hierarchy and visible content.';
+    }
+    else if (h1Count === 0 || skippedLevels.length > 0) {
+        status = 'WARNING';
+        explanation = 'The heading outline needs review. Multiple H1 elements are reported as evidence but are not an automatic failure.';
+        remediation = 'Review the primary heading and skipped levels, then adjust only where the visual and semantic hierarchy is unclear.';
+    }
+    return makeCheck('heading-structure', 'Heading structure', status, [evidence(sourceFor(context), {
+            headingCount: doc.headings.length,
+            h1Count,
+            skippedLevels,
+            outline: doc.headings.slice(0, 20).map((heading) => `H${heading.level}: ${heading.text}`),
+        })], explanation, remediation, 'Inspect the rendered outline and verify that headings match the visible section hierarchy.');
+}
+function checkLanguage(doc, context) {
+    if (!doc.language && context.rendering === 'markdown') {
+        return makeCheck('document-language', 'Document language', 'N/A', [evidence('markdown', { language: null })], 'No language field was found in Markdown frontmatter, and the rendered HTML was not inspected.', null, 'Audit the rendered HTML and compare its html lang value with the visible language.');
+    }
+    const status = doc.language ? 'PASS' : 'WARNING';
+    return makeCheck('document-language', 'Document language', status, [evidence(sourceFor(context), { language: doc.language ?? null })], status === 'PASS'
+        ? 'An html lang or Markdown language value was found. Language-content agreement still needs human review.'
+        : 'The HTML document does not declare a language.', status === 'PASS' ? null : 'Add the appropriate html lang value to the document template.', 'Compare the declared language with the primary visible language and test representative localized pages.');
+}
+function resolveCanonical(value, baseUrl) {
+    try {
+        const url = baseUrl ? new URL(value, baseUrl) : new URL(value);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            return null;
+        return url.toString();
+    }
+    catch {
+        return null;
+    }
+}
+function withoutHash(value) {
+    const url = new URL(value);
+    url.hash = '';
+    return url.toString();
+}
+function checkCanonical(doc, context) {
+    const canonicals = doc.canonicalLinks ?? [];
+    if (canonicals.length === 0) {
+        const isMarkdown = context.rendering === 'markdown';
+        return makeCheck('canonical-link', 'Canonical link', isMarkdown ? 'N/A' : 'WARNING', [evidence(sourceFor(context), { canonicals: [] })], isMarkdown
+            ? 'No canonical field was found in Markdown frontmatter, and the rendered template was not inspected.'
+            : 'No canonical link was found. Canonical markup is context-dependent, so absence is a review item.', isMarkdown ? null : 'Add one canonical link when the page participates in a duplicate or URL-normalization strategy.', 'Inspect the final HTML, resolve the canonical URL, and confirm that it matches the intended indexable URL.');
+    }
+    const baseUrl = context.target.finalUrl;
+    if (canonicals.length > 1) {
+        return makeCheck('canonical-link', 'Canonical link', 'FAIL', [evidence(sourceFor(context), {
+                canonicals,
+                resolved: canonicals.map((value) => resolveCanonical(value, baseUrl) ?? 'INVALID'),
+            })], 'Multiple canonical links were found, so the canonical signal is ambiguous.', 'Emit exactly one valid canonical link that represents the intended indexable URL.', 'Fetch the built page and verify one canonical element plus its resolved destination.');
+    }
+    const declared = canonicals[0];
+    const canonical = resolveCanonical(declared, baseUrl);
+    if (!baseUrl && declared.trim() !== '' && canonical === null && !/^[a-z][a-z\d+.-]*:/i.test(declared)) {
+        return makeCheck('canonical-link', 'Canonical link', 'N/A', [evidence(sourceFor(context), { declared, resolved: null, finalUrl: null })], 'A relative canonical was found, but a local-file audit has no deployed base URL for resolution.', null, 'Audit the deployed URL and verify the resolved canonical destination.');
+    }
+    if (canonical === null) {
+        return makeCheck('canonical-link', 'Canonical link', 'FAIL', [evidence(sourceFor(context), { declared, resolved: 'INVALID' })], 'The canonical value could not be resolved to an HTTP or HTTPS URL.', 'Emit exactly one valid canonical link that represents the intended indexable URL.', 'Fetch the built page and verify one canonical element plus its resolved destination.');
+    }
+    if (!baseUrl) {
+        return makeCheck('canonical-link', 'Canonical link', 'WARNING', [evidence(sourceFor(context), { declared: canonicals[0], resolved: canonical, finalUrl: null })], 'One valid canonical link was found, but a local-file audit cannot compare it with the deployed final URL.', 'Confirm that the deployed page resolves to the intended canonical URL.', 'Audit the deployed URL and compare its final response URL with the rendered canonical element.');
+    }
+    const differsFromFinal = baseUrl ? withoutHash(canonical) !== withoutHash(baseUrl) : false;
+    return makeCheck('canonical-link', 'Canonical link', differsFromFinal ? 'WARNING' : 'PASS', [evidence(sourceFor(context), { declared: canonicals[0], resolved: canonical, finalUrl: baseUrl ?? null })], differsFromFinal
+        ? 'The canonical resolves to a different URL than the final response. This can be intentional and needs review.'
+        : 'One valid canonical link was found and it resolves to the inspected final URL.', differsFromFinal ? 'Confirm the intended primary URL and update the canonical or serving URL if they conflict.' : null, 'Request both URLs, confirm their final status, and inspect the rendered canonical element.');
+}
+function checkRobots(doc, context) {
+    const valuesFor = (name) => doc.metaTagValues?.[name]
+        ?? (doc.metaTags[name] ? [doc.metaTags[name]] : []);
+    const metaRobots = [...valuesFor('robots'), ...valuesFor('googlebot')].join(', ');
+    const xRobotsTag = context.http?.xRobotsTag ?? '';
+    const combined = `${metaRobots}, ${xRobotsTag}`;
+    const blocksIndexing = /(?:^|[,\s])(?:noindex|none)(?:$|[,\s])/i.test(combined);
+    const blocksFollowing = /(?:^|[,\s])nofollow(?:$|[,\s])/i.test(combined);
+    const status = blocksIndexing || blocksFollowing ? 'WARNING' : 'PASS';
+    return makeCheck('robots-directives', 'Page-level robots directives', status, [
+        evidence(sourceFor(context), { metaRobots: metaRobots || null }),
+        context.http
+            ? evidence('http', { xRobotsTag: xRobotsTag || null })
+            : evidence('derived', { xRobotsTag: null, reason: 'Local files have no HTTP response headers.' }),
+    ], status === 'PASS'
+        ? 'No page-level noindex or nofollow directive was detected. robots.txt, authentication, CDN policy, and actual index state were not checked.'
+        : 'A page-level indexing or following restriction was detected. Its intent cannot be inferred automatically.', status === 'PASS'
+        ? null
+        : 'Confirm whether the directive is intentional. Remove or narrow it only when the page should be indexable or its links should be followed.', 'Inspect both the response headers and rendered meta robots tags, then verify the intended policy with the responsible owner.');
+}
+function checkLinks(doc, context) {
+    const links = doc.links;
+    const emptyText = links.filter((link) => !link.text.trim()).length;
+    const scriptLinks = links.filter((link) => /^javascript:/i.test(link.href)).length;
+    const status = links.length === 0 || emptyText > 0 || scriptLinks > 0 ? 'WARNING' : 'PASS';
+    return makeCheck('link-discovery', 'Link discovery', status, [evidence(sourceFor(context), {
+            linkCount: links.length,
+            emptyTextCount: emptyText,
+            javascriptLinkCount: scriptLinks,
+            sample: links.slice(0, 20).map((link) => `${link.text || '[empty]'} -> ${link.href}`),
+        })], links.length === 0
+        ? 'No links were discovered in the inspected document.'
+        : 'Links were extracted from the document. Their destination status and site-graph role were not fetched in this single-page audit.', status === 'PASS'
+        ? null
+        : 'Review missing link text and script-only navigation. Add crawlable links when they match the intended navigation and content relationships.', 'Fetch link destinations separately and compare the rendered navigation with the extracted link sample.');
+}
+function checkImages(doc, context) {
+    const images = doc.images ?? [];
+    if (images.length === 0) {
+        return makeCheck('image-alternatives', 'Image alternative text', 'N/A', [evidence(sourceFor(context), { imageCount: 0 })], 'No images were found in the inspected document.', null, 'Inspect representative rendered templates if images are inserted after build or hydration.');
+    }
+    const missingAlt = images.filter((image) => image.alt === undefined).length;
+    const emptyAlt = images.filter((image) => image.alt === '').length;
+    const status = missingAlt > 0 ? 'WARNING' : 'PASS';
+    return makeCheck('image-alternatives', 'Image alternative text', status, [evidence(sourceFor(context), {
+            imageCount: images.length,
+            missingAltAttributeCount: missingAlt,
+            emptyAltCount: emptyAlt,
+            sample: images.slice(0, 20).map((image) => `${image.src || '[missing src]'} | alt=${image.alt ?? '[missing]'}`),
+        })], status === 'PASS'
+        ? 'Every discovered image has an alt attribute. Empty alt values can be correct for decorative images and need contextual review.'
+        : 'One or more images lack an alt attribute. The audit does not infer the correct description from pixels.', status === 'PASS'
+        ? null
+        : 'Add accurate alt text for informative images and an explicit empty alt value for images that are purely decorative.', 'Inspect each image in context with assistive-technology semantics and verify the built HTML attributes.');
+}
+function checkJsonLd(doc, context) {
+    const errors = doc.jsonLdErrors ?? [];
+    const parsedObjects = doc.jsonLd.filter((value) => value !== null && typeof value === 'object' && !Array.isArray(value));
+    const invalidValueCount = doc.jsonLd.length - parsedObjects.length;
+    if (errors.length > 0 || invalidValueCount > 0) {
+        return makeCheck('json-ld-structure', 'JSON-LD structure', 'FAIL', [evidence(sourceFor(context), {
+                blockCount: doc.jsonLdBlockCount ?? doc.jsonLd.length,
+                parsedObjectCount: parsedObjects.length,
+                invalidValueCount,
+                parseErrors: errors,
+            })], 'Malformed JSON-LD or a non-object top-level value was detected. Feature-specific eligibility and visible-content agreement remain outside this structural check.', 'Correct the JSON syntax and top-level structure, then validate the specific schema type against the applicable primary documentation and visible content.', 'Parse every JSON-LD block again and run the relevant structured-data validator for the page type.');
+    }
+    if (doc.jsonLd.length === 0) {
+        return makeCheck('json-ld-structure', 'JSON-LD structure', 'N/A', [evidence(sourceFor(context), { blockCount: 0, schemaTypes: [] })], 'No JSON-LD was found. Structured data is optional and absence is not treated as an error.', null, 'Add structured data only for a defined feature or entity need, then validate it against visible content.');
+    }
+    return makeCheck('json-ld-structure', 'JSON-LD structure', 'PASS', [evidence(sourceFor(context), {
+            blockCount: doc.jsonLdBlockCount ?? doc.jsonLd.length,
+            schemaTypes: parsedObjects.map((value) => value['@type'] || '[unknown]'),
+        })], 'Every JSON-LD value parsed to an object. Context, type, feature eligibility, and visible-content agreement require schema-specific validation.', null, 'Compare each structured-data field with visible content and the current documentation for its intended feature.');
+}
+export function auditDocument(doc, context) {
+    const checks = [
+        checkHttp(context),
+        checkTitle(doc, context),
+        checkDescription(doc, context),
+        checkHeadings(doc, context),
+        checkLanguage(doc, context),
+        checkCanonical(doc, context),
+        checkRobots(doc, context),
+        checkLinks(doc, context),
+        checkImages(doc, context),
+        checkJsonLd(doc, context),
+    ];
+    const summary = { PASS: 0, WARNING: 0, FAIL: 0, 'N/A': 0 };
+    for (const check of checks)
+        summary[check.status] += 1;
+    return {
+        contractVersion: AUDIT_CONTRACT_VERSION,
+        target: context.target,
+        rendering: context.rendering,
+        checks,
+        summary,
+        limitations: [
+            'This command reports deterministic observations from one document. It does not claim ranking, indexing, rich-result display, traffic, conversion, or citation outcomes.',
+            'Destination status, robots.txt, sitemap membership, hreflang reciprocity, site-wide duplication, orphan pages, Core Web Vitals, and analytics require separate evidence.',
+            'PASS means the bounded check found no issue in the inspected evidence. It is not a guarantee of search-engine behavior.',
+        ],
+        timestamp: new Date().toISOString(),
+    };
+}
+async function auditFile(filePath) {
+    const fileStats = await stat(filePath);
+    if (!fileStats.isFile())
+        throw new Error('Audit target must be an HTML, HTM, Markdown, or MDX file.');
+    if (fileStats.size > MAX_FILE_SIZE) {
+        throw new Error(`File too large (${(fileStats.size / 1024 / 1024).toFixed(1)}MB). Maximum is 5MB.`);
+    }
+    const content = await readFile(filePath, 'utf8');
+    const extension = extname(filePath).toLowerCase();
+    if (extension === '.html' || extension === '.htm') {
+        return auditDocument(parseHtml(content, filePath), {
+            target: { type: 'file', input: filePath },
+            rendering: 'local-html',
+        });
+    }
+    if (extension === '.md' || extension === '.mdx') {
+        return auditDocument(parseMarkdown(content, filePath), {
+            target: { type: 'file', input: filePath },
+            rendering: 'markdown',
+        });
+    }
+    throw new Error(`Unsupported file type: ${extension}`);
+}
+async function auditUrl(url) {
+    const resource = await fetchUrlResource(url);
+    const doc = parseHtml(resource.html, resource.finalUrl);
+    return auditDocument(doc, {
+        target: { type: 'url', input: resource.requestedUrl, finalUrl: resource.finalUrl },
+        rendering: resource.renderedWithBrowser ? 'browser' : 'response-html',
+        http: {
+            status: resource.status,
+            statusText: resource.statusText,
+            redirects: resource.redirects,
+            contentType: resource.contentType,
+            xRobotsTag: resource.xRobotsTag,
+        },
+    });
+}
+export async function audit(target) {
+    if (target.type === 'directory') {
+        throw new Error('Evidence-backed audit currently supports one URL or one HTML/Markdown file.');
+    }
+    return target.type === 'url' ? auditUrl(target.path) : auditFile(target.path);
+}
+//# sourceMappingURL=audit.js.map

package/dist/core/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -1,7 +1,10 @@
 export * from './types.js';
 export * from './scanner.js';
+export * from './audit.js';
+export * from './site-audit.js';
 export * from './rules.js';
 export * from './generator.js';
 export * from './ai-prompt.js';
 export * from './external-scorers.js';
 export * from './merger.js';
+export * from './static-audit.js';

package/dist/core/index.js

@@ -1,8 +1,11 @@
 export * from './types.js';
 export * from './scanner.js';
+export * from './audit.js';
+export * from './site-audit.js';
 export * from './rules.js';
 export * from './generator.js';
 export * from './ai-prompt.js';
 export * from './external-scorers.js';
 export * from './merger.js';
+export * from './static-audit.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/dist/core/scanner.d.ts

@@ -4,5 +4,27 @@ export declare function parseMarkdown(md: string, url: string): ParsedDocument;
 export declare function scanDocument(doc: ParsedDocument): PageAnalysis;
 export declare function scanFile(filePath: string): Promise<PageAnalysis>;
 export declare function scanDirectory(dirPath: string): Promise<ScanReport>;
+export interface RedirectHop {
+    from: string;
+    to: string;
+    status: number;
+}
+export interface UrlResource {
+    requestedUrl: string;
+    finalUrl: string;
+    status: number;
+    statusText: string;
+    redirects: RedirectHop[];
+    contentType: string | null;
+    xRobotsTag: string | null;
+    html: string;
+    renderedWithBrowser: boolean;
+}
+export interface UrlFetchOptions {
+    render?: boolean;
+    init?: RequestInit;
+    allowedOrigin?: string;
+}
+export declare function fetchUrlResource(url: string, options?: UrlFetchOptions): Promise<UrlResource>;
 export declare function scanUrl(url: string): Promise<ScanReport>;
 export declare function scan(target: ScanTarget): Promise<ScanReport>;

package/dist/core/scanner.js

@@ -9,7 +9,8 @@ import { allRules } from './rules.js';
 export function parseHtml(html, url) {
     const $ = cheerio.load(html);
     // Extract title
-    const title = $('title').first().text().trim() || $('h1').first().text().trim() || url;
+    const documentTitle = $('title').first().text().trim();
+    const title = documentTitle || $('h1').first().text().trim() || url;
     // Extract headings
     const headings = [];
     $('h1, h2, h3, h4, h5, h6').each((_, el) => {
@@ -28,27 +29,47 @@ export function parseHtml(html, url) {
     });
     // Extract JSON-LD
     const jsonLd = [];
-    $('script[type="application/ld+json"]').each((_, el) => {
+    const jsonLdErrors = [];
+    const jsonLdScripts = $('script[type="application/ld+json"]');
+    jsonLdScripts.each((index, el) => {
         try {
             const parsed = JSON.parse($(el).html() || '');
-            if (Array.isArray(parsed)) {
-                jsonLd.push(...parsed);
-            }
-            else {
-                jsonLd.push(parsed);
+            const candidates = Array.isArray(parsed) ? parsed : [parsed];
+            for (const [candidateIndex, candidate] of candidates.entries()) {
+                if (candidate !== null) {
+                    // Keep the v0.6 scoring input compatible. The audit contract records
+                    // non-object values separately, but the score historically counted them.
+                    jsonLd.push(candidate);
+                }
+                if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+                    continue;
+                }
+                else {
+                    const location = Array.isArray(parsed) ? ` item ${candidateIndex + 1}` : '';
+                    jsonLdErrors.push(`JSON-LD block ${index + 1}${location}: expected an object`);
+                }
             }
         }
-        catch {
-            // Ignore malformed JSON-LD
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown JSON parse error';
+            jsonLdErrors.push(`JSON-LD block ${index + 1}: ${message}`);
         }
     });
     // Extract meta tags
     const metaTags = {};
+    const metaTagValues = {};
     $('meta').each((_, el) => {
-        const name = $(el).attr('name') || $(el).attr('property') || '';
+        const declaredName = $(el).attr('name') || '';
+        const name = declaredName || $(el).attr('property') || '';
         const content = $(el).attr('content') || '';
         if (name && content)
             metaTags[name] = content;
+        if (declaredName && content) {
+            const normalizedName = declaredName.trim().toLowerCase();
+            const values = metaTagValues[normalizedName] ?? [];
+            values.push(content);
+            metaTagValues[normalizedName] = values;
+        }
     });
     // Extract links
     const links = [];
@@ -59,18 +80,34 @@ export function parseHtml(html, url) {
         if (href)
             links.push({ href, text, rel });
     });
+    const images = $('img').map((_, el) => ({
+        src: $(el).attr('src') || '',
+        alt: $(el).attr('alt'),
+        width: $(el).attr('width'),
+        height: $(el).attr('height'),
+        loading: $(el).attr('loading'),
+    })).get();
+    const language = $('html').attr('lang')?.trim() || undefined;
+    const canonicalLinks = $('link[rel~="canonical"]').map((_, el) => $(el).attr('href') || '').get();
     // Extract raw text (content area preferred)
     const contentArea = $('main, article, [role="main"]').first();
     const rawText = (contentArea.length > 0 ? contentArea.text() : $('body').text()).replace(/\s+/g, ' ').trim();
     return {
         url,
         title,
+        documentTitle,
         html,
         headings,
         paragraphs,
         jsonLd,
+        jsonLdBlockCount: jsonLdScripts.length,
+        jsonLdErrors,
         metaTags,
+        metaTagValues,
         links,
+        images,
+        language,
+        canonicalLinks,
         rawText,
     };
 }
@@ -124,16 +161,36 @@ export function parseMarkdown(md, url) {
         .replace(/[#*_~`>]/g, '')
         .replace(/\s+/g, ' ')
         .trim();
+    const links = [];
+    const images = [];
+    for (const match of content.matchAll(/(!?)\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g)) {
+        const [, imageMarker, text, href] = match;
+        if (imageMarker) {
+            images.push({ src: href, alt: text });
+        }
+        else {
+            links.push({ href, text });
+        }
+    }
+    const canonicalValue = frontmatter.canonical;
+    const canonicalLinks = typeof canonicalValue === 'string' ? [canonicalValue] : [];
+    const languageValue = frontmatter.lang ?? frontmatter.language;
+    const language = typeof languageValue === 'string' ? languageValue : undefined;
     return {
         url,
         title: finalTitle,
+        documentTitle: typeof frontmatter.title === 'string' ? frontmatter.title : undefined,
         markdown: md,
         frontmatter: frontmatter,
         headings,
         paragraphs,
         jsonLd: [],
         metaTags: {},
-        links: [],
+        metaTagValues: {},
+        links,
+        images,
+        language,
+        canonicalLinks,
         rawText,
     };
 }
@@ -235,12 +292,13 @@ function isBlockedHostname(hostname) {
     const blocked = /^(127\.|10\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|169\.254\.|::1$|localhost$)/i;
     return blocked.test(hostname);
 }
-async function fetchWithSafeRedirects(input, init, maxRedirects = 10) {
+async function fetchWithSafeRedirects(input, init, maxRedirects = 10, allowedOrigin) {
     let currentUrl = typeof input === 'string' ? validateUrl(input) : validateUrl(input.toString());
+    const redirects = [];
     for (let redirectCount = 0; redirectCount <= maxRedirects; redirectCount += 1) {
         const response = await fetch(currentUrl, { ...init, redirect: 'manual' });
         if (response.status < 300 || response.status >= 400) {
-            return response;
+            return { response, finalUrl: currentUrl.toString(), redirects };
         }
         if (redirectCount === maxRedirects) {
             throw new Error(`Too many redirects while fetching ${currentUrl.toString()}`);
@@ -249,7 +307,16 @@ async function fetchWithSafeRedirects(input, init, maxRedirects = 10) {
         if (!location) {
             throw new Error(`Redirect response from ${currentUrl.toString()} missing Location header`);
         }
-        currentUrl = validateUrl(new URL(location, currentUrl).toString());
+        const nextUrl = validateUrl(new URL(location, currentUrl).toString());
+        if (allowedOrigin && nextUrl.origin !== allowedOrigin) {
+            throw new Error(`Redirect left the allowed origin: ${nextUrl.origin}`);
+        }
+        redirects.push({
+            from: currentUrl.toString(),
+            to: nextUrl.toString(),
+            status: response.status,
+        });
+        currentUrl = nextUrl;
     }
     throw new Error(`Too many redirects while fetching ${currentUrl.toString()}`);
 }
@@ -305,28 +372,41 @@ function isSpaLikely(html) {
     const scripts = (html.match(/<script/gi) || []).length;
     return contentTags < 10 && scripts > 3;
 }
-export async function scanUrl(url) {
+export async function fetchUrlResource(url, options = {}) {
     validateUrl(url);
-    const response = await fetchWithSafeRedirects(url);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
-    }
+    const { response, finalUrl, redirects } = await fetchWithSafeRedirects(url, options.init, 10, options.allowedOrigin);
     let html = await response.text();
     let renderedWithBrowser = false;
-    // If page looks like an SPA, try puppeteer for full rendering
-    if (isSpaLikely(html)) {
-        const result = await fetchWithPuppeteer(url);
+    if (options.render !== false && response.ok && isSpaLikely(html)) {
+        const result = await fetchWithPuppeteer(finalUrl);
         if (result.rendered) {
             html = result.html;
             renderedWithBrowser = true;
         }
-        else {
-            console.warn('[aeoptimize] This page appears to be a JavaScript-rendered SPA.');
-            console.warn('[aeoptimize] Install Chrome/Chromium for accurate scoring of JS-rendered sites.');
-            console.warn('[aeoptimize] Without a browser, scores may be lower than actual content quality.\n');
-        }
     }
-    const doc = parseHtml(html, url);
+    return {
+        requestedUrl: url,
+        finalUrl,
+        status: response.status,
+        statusText: response.statusText,
+        redirects,
+        contentType: response.headers.get('content-type'),
+        xRobotsTag: response.headers.get('x-robots-tag'),
+        html,
+        renderedWithBrowser,
+    };
+}
+export async function scanUrl(url) {
+    const resource = await fetchUrlResource(url);
+    if (resource.status < 200 || resource.status >= 300) {
+        throw new Error(`Failed to fetch ${url}: ${resource.status} ${resource.statusText}`);
+    }
+    if (isSpaLikely(resource.html) && !resource.renderedWithBrowser) {
+        console.warn('[aeoptimize] This page appears to be a JavaScript-rendered SPA.');
+        console.warn('[aeoptimize] Install Chrome/Chromium for accurate scoring of JS-rendered sites.');
+        console.warn('[aeoptimize] Without a browser, scores may be lower than actual content quality.\n');
+    }
+    const doc = parseHtml(resource.html, url);
     const analysis = scanDocument(doc);
     return {
         pages: [analysis],