afterburn-cli 1.0.0

package/dist/screenshots/dual-format.d.ts

@@ -0,0 +1,14 @@
+import type { Page } from 'playwright-core';
+import type { ScreenshotRef } from '../types/artifacts.js';
+/**
+ * Converts a PNG buffer to WebP format with optimal compression settings
+ */
+export declare function convertToWebP(pngBuffer: Buffer): Promise<Buffer>;
+/**
+ * Captures a full-page screenshot in both PNG and WebP formats with content-hash naming
+ * @param page - Playwright page instance
+ * @param name - Human-readable screenshot name
+ * @param outputDir - Directory to save screenshots
+ * @returns ScreenshotRef with paths and metadata
+ */
+export declare function captureDualFormat(page: Page, name: string, outputDir: string, existingPngBuffer?: Buffer, existingHash?: string): Promise<ScreenshotRef>;

package/dist/screenshots/dual-format.js

@@ -0,0 +1,59 @@
+// Dual-format screenshot capture: PNG for LLM analysis, WebP for display
+import sharp from 'sharp';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import fs from 'fs-extra';
+/**
+ * Converts a PNG buffer to WebP format with optimal compression settings
+ */
+export async function convertToWebP(pngBuffer) {
+    return sharp(pngBuffer)
+        .webp({ quality: 80, effort: 4, smartSubsample: true })
+        .toBuffer();
+}
+/**
+ * Captures a full-page screenshot in both PNG and WebP formats with content-hash naming
+ * @param page - Playwright page instance
+ * @param name - Human-readable screenshot name
+ * @param outputDir - Directory to save screenshots
+ * @returns ScreenshotRef with paths and metadata
+ */
+export async function captureDualFormat(page, name, outputDir, existingPngBuffer, existingHash) {
+    // Ensure output directory exists
+    fs.ensureDirSync(outputDir);
+    // Reuse provided PNG buffer or capture a new one
+    const pngBuffer = existingPngBuffer || await page.screenshot({ type: 'png', fullPage: true });
+    // Reuse provided hash or compute from buffer
+    const hash = existingHash || createHash('sha256').update(pngBuffer).digest('hex').substring(0, 12);
+    // Convert to WebP
+    const webpBuffer = await convertToWebP(pngBuffer);
+    // Build cross-platform file paths
+    const pngPath = join(outputDir, `${name}-${hash}.png`);
+    const webpPath = join(outputDir, `${name}-${hash}.webp`);
+    // Write both formats to disk
+    await fs.outputFile(pngPath, pngBuffer);
+    await fs.outputFile(webpPath, webpBuffer);
+    // Get image dimensions
+    const metadata = await sharp(pngBuffer).metadata();
+    const width = metadata.width ?? 0;
+    const height = metadata.height ?? 0;
+    // Calculate size reduction
+    const pngSize = pngBuffer.length;
+    const webpSize = webpBuffer.length;
+    const reduction = Math.round(((pngSize - webpSize) / pngSize) * 100);
+    return {
+        id: hash,
+        name,
+        pngPath,
+        webpPath,
+        width,
+        height,
+        sizes: {
+            png: pngSize,
+            webp: webpSize,
+            reduction: `${reduction}%`,
+        },
+        capturedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=dual-format.js.map

package/dist/screenshots/dual-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-format.js","sourceRoot":"","sources":["../../src/screenshots/dual-format.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,UAAU,CAAC;AAI1B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,OAAO,KAAK,CAAC,SAAS,CAAC;SACpB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;SACtD,QAAQ,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAU,EACV,IAAY,EACZ,SAAiB,EACjB,iBAA0B,EAC1B,YAAqB;IAErB,iCAAiC;IACjC,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAE5B,iDAAiD;IACjD,MAAM,SAAS,GAAG,iBAAiB,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9F,6CAA6C;IAC7C,MAAM,IAAI,GAAG,YAAY,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnG,kBAAkB;IAClB,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAElD,kCAAkC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;IAEzD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE1C,uBAAuB;IACvB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC;IACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAErE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,KAAK;QACL,MAAM;QACN,KAAK,EAAE;YACL,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,GAAG,SAAS,GAAG;SAC3B;QACD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/screenshots/index.d.ts

@@ -0,0 +1,2 @@
+export { convertToWebP, captureDualFormat } from './dual-format.js';
+export { ScreenshotManager } from './screenshot-manager.js';

package/dist/screenshots/index.js

@@ -0,0 +1,4 @@
+// Barrel export for screenshots module
+export { convertToWebP, captureDualFormat } from './dual-format.js';
+export { ScreenshotManager } from './screenshot-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/screenshots/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenshots/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/screenshots/screenshot-manager.d.ts

@@ -0,0 +1,33 @@
+import type { Page } from 'playwright-core';
+import type { ScreenshotRef } from '../types/artifacts.js';
+/**
+ * Manages screenshot capture with automatic deduplication by content hash
+ */
+export declare class ScreenshotManager {
+    private readonly outputDir;
+    private readonly dedupMap;
+    private readonly currentSessionFiles;
+    constructor(outputDir?: string);
+    /**
+     * Captures a screenshot in dual format (PNG + WebP) with deduplication
+     * @param page - Playwright page instance
+     * @param name - Human-readable screenshot name
+     * @returns ScreenshotRef (existing ref if duplicate detected)
+     */
+    capture(page: Page, name: string): Promise<ScreenshotRef>;
+    /**
+     * Returns all captured screenshots
+     */
+    getAll(): ScreenshotRef[];
+    /**
+     * Finds a screenshot by name
+     */
+    getByName(name: string): ScreenshotRef | undefined;
+    /**
+     * Removes screenshots older than specified days based on file modification time.
+     * Excludes screenshots from the current session.
+     * @param olderThanDays - Age threshold in days (default: 7). Set to 0 to clean all old screenshots.
+     * @returns Count of deleted files
+     */
+    cleanup(olderThanDays?: number): Promise<number>;
+}

package/dist/screenshots/screenshot-manager.js

@@ -0,0 +1,86 @@
+// Screenshot capture coordination with content-hash deduplication
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import fs from 'fs-extra';
+import { captureDualFormat } from './dual-format.js';
+/**
+ * Manages screenshot capture with automatic deduplication by content hash
+ */
+export class ScreenshotManager {
+    outputDir;
+    dedupMap;
+    currentSessionFiles;
+    constructor(outputDir = '.afterburn/screenshots') {
+        this.outputDir = outputDir;
+        this.dedupMap = new Map();
+        this.currentSessionFiles = new Set();
+        fs.ensureDirSync(this.outputDir);
+    }
+    /**
+     * Captures a screenshot in dual format (PNG + WebP) with deduplication
+     * @param page - Playwright page instance
+     * @param name - Human-readable screenshot name
+     * @returns ScreenshotRef (existing ref if duplicate detected)
+     */
+    async capture(page, name) {
+        // Capture PNG buffer to compute hash
+        const pngBuffer = await page.screenshot({ type: 'png', fullPage: true });
+        const hash = createHash('sha256').update(pngBuffer).digest('hex').substring(0, 12);
+        // Check if this content hash already exists (deduplication)
+        const existing = this.dedupMap.get(hash);
+        if (existing) {
+            return existing;
+        }
+        // New screenshot - capture dual format, reuse buffer and hash from above
+        const ref = await captureDualFormat(page, name, this.outputDir, pngBuffer, hash);
+        this.dedupMap.set(hash, ref);
+        // Track current session files
+        this.currentSessionFiles.add(ref.pngPath);
+        this.currentSessionFiles.add(ref.webpPath);
+        return ref;
+    }
+    /**
+     * Returns all captured screenshots
+     */
+    getAll() {
+        return Array.from(this.dedupMap.values());
+    }
+    /**
+     * Finds a screenshot by name
+     */
+    getByName(name) {
+        return this.getAll().find((ref) => ref.name === name);
+    }
+    /**
+     * Removes screenshots older than specified days based on file modification time.
+     * Excludes screenshots from the current session.
+     * @param olderThanDays - Age threshold in days (default: 7). Set to 0 to clean all old screenshots.
+     * @returns Count of deleted files
+     */
+    async cleanup(olderThanDays = 7) {
+        const files = await fs.readdir(this.outputDir);
+        const now = Date.now();
+        const threshold = olderThanDays * 24 * 60 * 60 * 1000; // Convert days to milliseconds
+        let deletedCount = 0;
+        for (const file of files) {
+            const filepath = join(this.outputDir, file);
+            // Skip files from current session
+            if (this.currentSessionFiles.has(filepath)) {
+                continue;
+            }
+            try {
+                const stats = await fs.stat(filepath);
+                const age = now - stats.mtimeMs;
+                if (age > threshold) {
+                    await fs.unlink(filepath);
+                    deletedCount++;
+                }
+            }
+            catch {
+                // File might have been deleted already, continue
+            }
+        }
+        return deletedCount;
+    }
+}
+//# sourceMappingURL=screenshot-manager.js.map

package/dist/screenshots/screenshot-manager.js.map

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

package/dist/testing/accessibility-auditor.d.ts

@@ -0,0 +1,23 @@
+import type { Page } from 'playwright';
+interface AccessibilityViolation {
+    id: string;
+    impact: 'critical' | 'serious' | 'moderate' | 'minor';
+    description: string;
+    nodes: number;
+    helpUrl: string;
+}
+interface AccessibilityReport {
+    url: string;
+    violationCount: number;
+    violations: AccessibilityViolation[];
+    passes: number;
+    incomplete: number;
+}
+/**
+ * Run WCAG 2.0/2.1 A/AA accessibility audit on a Playwright page
+ *
+ * @param page - Playwright page to audit
+ * @returns Accessibility report with violations, passes, and incomplete checks
+ */
+export declare function auditAccessibility(page: Page): Promise<AccessibilityReport>;
+export {};

package/dist/testing/accessibility-auditor.js

@@ -0,0 +1,44 @@
+// WCAG accessibility audit via axe-core for Playwright pages
+import { AxeBuilder } from '@axe-core/playwright';
+/**
+ * Run WCAG 2.0/2.1 A/AA accessibility audit on a Playwright page
+ *
+ * @param page - Playwright page to audit
+ * @returns Accessibility report with violations, passes, and incomplete checks
+ */
+export async function auditAccessibility(page) {
+    try {
+        const url = page.url();
+        // Run axe-core analysis with WCAG 2.0/2.1 A/AA tags
+        const results = await new AxeBuilder({ page })
+            .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'])
+            .analyze();
+        // Map violations to AccessibilityViolation type
+        const violations = results.violations.map(violation => ({
+            id: violation.id,
+            impact: violation.impact,
+            description: violation.description,
+            nodes: violation.nodes.length,
+            helpUrl: violation.helpUrl,
+        }));
+        return {
+            url,
+            violationCount: violations.length,
+            violations,
+            passes: results.passes.length,
+            incomplete: results.incomplete.length,
+        };
+    }
+    catch (error) {
+        console.error('Accessibility audit failed:', error);
+        // Return safe defaults on error
+        return {
+            url: page.url(),
+            violationCount: 0,
+            violations: [],
+            passes: 0,
+            incomplete: 0,
+        };
+    }
+}
+//# sourceMappingURL=accessibility-auditor.js.map

package/dist/testing/accessibility-auditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-auditor.js","sourceRoot":"","sources":["../../src/testing/accessibility-auditor.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAoBlD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,oDAAoD;QACpD,MAAM,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;aAC3C,QAAQ,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;aACtD,OAAO,EAAE,CAAC;QAEb,gDAAgD;QAChD,MAAM,UAAU,GAA6B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAChF,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,MAAM,EAAE,SAAS,CAAC,MAAuD;YACzE,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;YAC7B,OAAO,EAAE,SAAS,CAAC,OAAO;SAC3B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,GAAG;YACH,cAAc,EAAE,UAAU,CAAC,MAAM;YACjC,UAAU;YACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YAC7B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;SACtC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QAEpD,gCAAgC;QAChC,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;YACf,cAAc,EAAE,CAAC;YACjB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { auditAccessibility } from './accessibility-auditor.js';
+export { capturePerformanceMetrics } from './performance-monitor.js';
+export { auditMeta } from './meta-auditor.js';
+export type { MetaAuditResult, MetaIssue } from './meta-auditor.js';

package/dist/testing/index.js

@@ -0,0 +1,5 @@
+// Testing module barrel exports
+export { auditAccessibility } from './accessibility-auditor.js';
+export { capturePerformanceMetrics } from './performance-monitor.js';
+export { auditMeta } from './meta-auditor.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/testing/meta-auditor.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from 'playwright';
+export interface MetaIssue {
+    id: string;
+    severity: 'high' | 'medium' | 'low';
+    description: string;
+    suggestion: string;
+}
+export interface MetaAuditResult {
+    url: string;
+    issues: MetaIssue[];
+}
+/**
+ * Audit a page for common meta tag and structural SEO issues.
+ * These are heuristic checks that don't require AI — just DOM inspection.
+ */
+export declare function auditMeta(page: Page): Promise<MetaAuditResult>;

package/dist/testing/meta-auditor.js

@@ -0,0 +1,268 @@
+// Lightweight heuristic checks for common meta tag and SEO issues (no AI needed)
+/**
+ * Audit a page for common meta tag and structural SEO issues.
+ * These are heuristic checks that don't require AI — just DOM inspection.
+ */
+export async function auditMeta(page) {
+    const url = page.url();
+    const issues = [];
+    try {
+        const checks = await page.evaluate(() => {
+            const html = document.documentElement;
+            const head = document.head;
+            // Check lang attribute
+            const hasLang = !!html.getAttribute('lang');
+            // Check viewport meta tag
+            const hasViewport = !!head.querySelector('meta[name="viewport"]');
+            // Check meta description
+            const hasDescription = !!head.querySelector('meta[name="description"]');
+            // Check title
+            const title = document.title?.trim();
+            const hasTitle = !!title && title.length > 0;
+            const titleLength = title?.length || 0;
+            // Check H1 count (multiple H1s is a common SEO mistake)
+            const h1Count = document.querySelectorAll('h1').length;
+            // Check for heading hierarchy gaps (e.g., h1 → h3, skipping h2)
+            const headings = Array.from(document.querySelectorAll('h1, h2, h3, h4, h5, h6'));
+            let hasSkippedHeading = false;
+            for (let i = 1; i < headings.length; i++) {
+                const prevLevel = parseInt(headings[i - 1].tagName[1]);
+                const currLevel = parseInt(headings[i].tagName[1]);
+                if (currLevel > prevLevel + 1) {
+                    hasSkippedHeading = true;
+                    break;
+                }
+            }
+            // Check for images without alt text (supplements axe-core)
+            const imagesWithoutAlt = document.querySelectorAll('img:not([alt])').length;
+            // Check for links with empty href
+            const emptyHrefLinks = document.querySelectorAll('a[href=""], a[href="#"]').length;
+            // Check for external links without rel="noopener"
+            const unsafeExternalLinks = Array.from(document.querySelectorAll('a[target="_blank"]'))
+                .filter(a => {
+                const rel = a.getAttribute('rel') || '';
+                return !rel.includes('noopener') && !rel.includes('noreferrer');
+            }).length;
+            // Check for render-blocking scripts in <head> (no defer or async)
+            const renderBlockingScripts = Array.from(head.querySelectorAll('script[src]'))
+                .filter(s => !s.hasAttribute('defer') && !s.hasAttribute('async') && !s.getAttribute('type')?.includes('module'))
+                .length;
+            // Check for potential exposed secrets in inline scripts
+            const inlineScripts = Array.from(document.querySelectorAll('script:not([src])'))
+                .map(s => s.textContent || '');
+            const secretPatterns = [
+                /['"]sk-[a-zA-Z0-9]{10,}['"]/, // OpenAI-style keys
+                /['"](api[_-]?key|apiKey)['"]?\s*[:=]\s*['"][^'"]{8,}['"]/i, // api_key, api-key, apiKey = "..."
+                /['"](secret|secretKey|secret_key)['"]?\s*[:=]\s*['"][^'"]{8,}['"]/i, // secret = "..."
+                /['"](password|passwd)['"]?\s*[:=]\s*['"][^'"]{4,}['"]/i, // password = "..."
+                /['"](token|accessToken|access_token|auth_token)['"]?\s*[:=]\s*['"][^'"]{10,}['"]/i, // token = "..."
+                /['"]AKIA[A-Z0-9]{12,}['"]/, // AWS access keys
+                /['"]ghp_[a-zA-Z0-9]{30,}['"]/, // GitHub PATs
+            ];
+            let exposedSecretsCount = 0;
+            for (const script of inlineScripts) {
+                for (const pattern of secretPatterns) {
+                    if (pattern.test(script)) {
+                        exposedSecretsCount++;
+                        break; // one secret per script is enough
+                    }
+                }
+            }
+            // Check for javascript:void(0) links (dead links)
+            const jsVoidLinks = document.querySelectorAll('a[href^="javascript:"]').length;
+            // Check for favicon
+            const hasFavicon = !!head.querySelector('link[rel="icon"], link[rel="shortcut icon"]');
+            // Check for canonical URL
+            const hasCanonical = !!head.querySelector('link[rel="canonical"]');
+            // Check for Open Graph tags (social sharing previews)
+            const hasOgTitle = !!head.querySelector('meta[property="og:title"]');
+            const hasOgDescription = !!head.querySelector('meta[property="og:description"]');
+            const hasOgImage = !!head.querySelector('meta[property="og:image"]');
+            // Check for mixed content (HTTP resources on HTTPS pages)
+            let mixedContentCount = 0;
+            if (window.location.protocol === 'https:') {
+                const httpResources = document.querySelectorAll('img[src^="http:"], script[src^="http:"], link[href^="http:"], iframe[src^="http:"], video[src^="http:"], audio[src^="http:"]');
+                mixedContentCount = httpResources.length;
+            }
+            return {
+                hasLang,
+                hasViewport,
+                hasDescription,
+                hasTitle,
+                titleLength,
+                h1Count,
+                hasSkippedHeading,
+                imagesWithoutAlt,
+                emptyHrefLinks,
+                unsafeExternalLinks,
+                renderBlockingScripts,
+                exposedSecretsCount,
+                jsVoidLinks,
+                hasFavicon,
+                hasCanonical,
+                hasOgTitle,
+                hasOgDescription,
+                hasOgImage,
+                mixedContentCount,
+            };
+        });
+        // Evaluate results
+        if (!checks.hasViewport) {
+            issues.push({
+                id: 'missing-viewport',
+                severity: 'high',
+                description: 'Missing viewport meta tag — page won\'t display correctly on mobile devices',
+                suggestion: 'Add <meta name="viewport" content="width=device-width, initial-scale=1"> to the <head>',
+            });
+        }
+        if (!checks.hasDescription) {
+            issues.push({
+                id: 'missing-meta-description',
+                severity: 'medium',
+                description: 'Missing meta description — search engines won\'t have a summary to show',
+                suggestion: 'Add <meta name="description" content="Your page description here"> to the <head>',
+            });
+        }
+        if (!checks.hasTitle) {
+            issues.push({
+                id: 'missing-title',
+                severity: 'high',
+                description: 'Missing or empty page title',
+                suggestion: 'Add a descriptive <title> tag in the <head>',
+            });
+        }
+        else if (checks.titleLength > 60) {
+            issues.push({
+                id: 'title-too-long',
+                severity: 'low',
+                description: 'Page title is longer than 60 characters — it may get truncated in search results',
+                suggestion: 'Shorten the title to 60 characters or fewer',
+            });
+        }
+        if (checks.h1Count === 0) {
+            issues.push({
+                id: 'missing-h1',
+                severity: 'medium',
+                description: 'No H1 heading found — every page should have exactly one H1',
+                suggestion: 'Add a single H1 heading that describes the page content',
+            });
+        }
+        else if (checks.h1Count > 1) {
+            issues.push({
+                id: 'multiple-h1',
+                severity: 'medium',
+                description: `Found ${checks.h1Count} H1 headings — there should be exactly one per page`,
+                suggestion: 'Keep one H1 and change the others to H2 or lower',
+            });
+        }
+        if (checks.hasSkippedHeading) {
+            issues.push({
+                id: 'skipped-heading-level',
+                severity: 'low',
+                description: 'Heading levels are skipped (e.g., H1 followed by H3, missing H2)',
+                suggestion: 'Use headings in order: H1, then H2, then H3, etc.',
+            });
+        }
+        if (checks.emptyHrefLinks > 0) {
+            issues.push({
+                id: 'empty-href',
+                severity: 'medium',
+                description: `Found ${checks.emptyHrefLinks} link(s) with empty or "#" href — they go nowhere`,
+                suggestion: 'Add a real URL to each link\'s href attribute, or remove the link',
+            });
+        }
+        if (checks.unsafeExternalLinks > 0) {
+            issues.push({
+                id: 'unsafe-external-link',
+                severity: 'low',
+                description: `Found ${checks.unsafeExternalLinks} external link(s) opening in new tab without rel="noopener"`,
+                suggestion: 'Add rel="noopener noreferrer" to all links with target="_blank"',
+            });
+        }
+        if (checks.renderBlockingScripts > 0) {
+            issues.push({
+                id: 'render-blocking-script',
+                severity: 'medium',
+                description: `Found ${checks.renderBlockingScripts} render-blocking script(s) in <head> — they slow down page load`,
+                suggestion: 'Add "defer" or "async" to <script> tags, or move them to the end of <body>',
+            });
+        }
+        if (checks.exposedSecretsCount > 0) {
+            issues.push({
+                id: 'exposed-secret',
+                severity: 'high',
+                description: `Found ${checks.exposedSecretsCount} potential API key(s) or secret(s) exposed in inline scripts`,
+                suggestion: 'Never put API keys in client-side code — move them to environment variables on the server',
+            });
+        }
+        if (checks.jsVoidLinks > 0) {
+            issues.push({
+                id: 'javascript-void-link',
+                severity: 'medium',
+                description: `Found ${checks.jsVoidLinks} link(s) using javascript:void(0) — they don't navigate anywhere`,
+                suggestion: 'Replace javascript: links with real URLs or use <button> elements for actions',
+            });
+        }
+        if (!checks.hasLang) {
+            issues.push({
+                id: 'missing-lang',
+                severity: 'medium',
+                description: 'Missing lang attribute on <html> — screen readers won\'t know what language to use',
+                suggestion: 'Add lang="en" (or your language) to the <html> tag',
+            });
+        }
+        if (checks.imagesWithoutAlt > 0) {
+            issues.push({
+                id: 'images-missing-alt',
+                severity: 'medium',
+                description: `Found ${checks.imagesWithoutAlt} image(s) without alt text — screen readers can't describe them`,
+                suggestion: 'Add descriptive alt="" attributes to all <img> tags (use alt="" for decorative images)',
+            });
+        }
+        if (!checks.hasFavicon) {
+            issues.push({
+                id: 'missing-favicon',
+                severity: 'low',
+                description: 'No favicon found — browsers show a generic icon in the tab',
+                suggestion: 'Add <link rel="icon" href="/favicon.ico"> to the <head>',
+            });
+        }
+        if (!checks.hasCanonical) {
+            issues.push({
+                id: 'missing-canonical',
+                severity: 'low',
+                description: 'No canonical URL set — search engines may index duplicate versions of this page',
+                suggestion: 'Add <link rel="canonical" href="https://yoursite.com/page"> to the <head>',
+            });
+        }
+        if (!checks.hasOgTitle || !checks.hasOgDescription || !checks.hasOgImage) {
+            const missing = [];
+            if (!checks.hasOgTitle)
+                missing.push('og:title');
+            if (!checks.hasOgDescription)
+                missing.push('og:description');
+            if (!checks.hasOgImage)
+                missing.push('og:image');
+            issues.push({
+                id: 'missing-open-graph',
+                severity: 'low',
+                description: `Missing Open Graph tag(s): ${missing.join(', ')} — social media shares won't have a rich preview`,
+                suggestion: 'Add Open Graph meta tags for better social sharing previews',
+            });
+        }
+        if (checks.mixedContentCount > 0) {
+            issues.push({
+                id: 'mixed-content',
+                severity: 'high',
+                description: `Found ${checks.mixedContentCount} HTTP resource(s) loaded on an HTTPS page — browsers may block them`,
+                suggestion: 'Change all resource URLs from http:// to https:// to avoid mixed content warnings',
+            });
+        }
+    }
+    catch (error) {
+        // Graceful degradation — meta audit failure doesn't break the pipeline
+        console.warn('Meta audit failed:', error);
+    }
+    return { url, issues };
+}
+//# sourceMappingURL=meta-auditor.js.map

package/dist/testing/meta-auditor.js.map

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

package/dist/testing/performance-monitor.d.ts

@@ -0,0 +1,15 @@
+import type { Page } from 'playwright';
+interface PerformanceMetrics {
+    lcp: number;
+    domContentLoaded: number;
+    totalLoadTime: number;
+    url: string;
+}
+/**
+ * Capture browser performance metrics from a Playwright page
+ *
+ * @param page - Playwright page to measure
+ * @returns Performance metrics including LCP, DOM load time, and total load time
+ */
+export declare function capturePerformanceMetrics(page: Page): Promise<PerformanceMetrics>;
+export {};