@rankcli/agent-runtime 0.0.15 → 0.0.17

package/src/audit/checks/local-seo.ts

@@ -1,296 +0,0 @@
-// Local SEO Checks
-// Checks for LocalBusiness schema, NAP consistency, address/phone detection
-
-import * as cheerio from 'cheerio';
-import type { AuditIssue } from '../types.js';
-import { ISSUE_DEFINITIONS } from '../types.js';
-
-// Phone number patterns
-const PHONE_PATTERNS = [
-  /\+?1?[-.\s]?\(?[0-9]{3}\)?[-.\s]?[0-9]{3}[-.\s]?[0-9]{4}/g, // US/Canada
-  /\+?[0-9]{1,3}[-.\s]?[0-9]{2,4}[-.\s]?[0-9]{3,4}[-.\s]?[0-9]{3,4}/g, // International
-  /\b[0-9]{3}[-.\s][0-9]{3}[-.\s][0-9]{4}\b/g, // Simple US format
-];
-
-// Address patterns (simplified)
-const ADDRESS_PATTERNS = [
-  /\d+\s+[\w\s]+(?:street|st|avenue|ave|road|rd|boulevard|blvd|drive|dr|lane|ln|way|court|ct|circle|cir|place|pl)[\s,]+[\w\s]+,?\s*(?:AL|AK|AZ|AR|CA|CO|CT|DE|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY)\s*\d{5}/gi,
-  /\d+\s+[\w\s]+,\s*[\w\s]+,\s*[A-Z]{2}\s*\d{5}/gi, // Generic US address
-];
-
-export interface LocalSEOData {
-  hasLocalBusinessSchema: boolean;
-  hasOrganizationSchema: boolean;
-  detectedPhones: string[];
-  detectedAddresses: string[];
-  schemaData: {
-    name?: string;
-    address?: string;
-    phone?: string;
-    hours?: string[];
-    geo?: { lat: number; lng: number };
-  } | null;
-  socialProfiles: string[];
-}
-
-/**
- * Extract and validate LocalBusiness/Organization schema
- */
-function extractSchema(html: string): {
-  hasLocalBusiness: boolean;
-  hasOrganization: boolean;
-  schemaData: LocalSEOData['schemaData'];
-} {
-  const $ = cheerio.load(html);
-  let hasLocalBusiness = false;
-  let hasOrganization = false;
-  let schemaData: LocalSEOData['schemaData'] = null;
-
-  // Find JSON-LD scripts
-  $('script[type="application/ld+json"]').each((_, el) => {
-    try {
-      const content = $(el).html();
-      if (!content) return;
-
-      const jsonData = JSON.parse(content);
-      const schemas = Array.isArray(jsonData) ? jsonData : [jsonData];
-
-      for (const schema of schemas) {
-        // Handle @graph structure
-        const items = schema['@graph'] || [schema];
-
-        for (const item of items) {
-          const type = item['@type'];
-
-          // Check for LocalBusiness and its subtypes
-          const localBusinessTypes = [
-            'LocalBusiness',
-            'Restaurant',
-            'Store',
-            'MedicalBusiness',
-            'FinancialService',
-            'FoodEstablishment',
-            'HealthAndBeautyBusiness',
-            'HomeAndConstructionBusiness',
-            'LegalService',
-            'RealEstateAgent',
-            'SportsActivityLocation',
-          ];
-
-          if (localBusinessTypes.some((t) => type === t || (Array.isArray(type) && type.includes(t)))) {
-            hasLocalBusiness = true;
-            schemaData = {
-              name: item.name,
-              address: formatAddress(item.address),
-              phone: item.telephone,
-              hours: item.openingHours,
-              geo: item.geo ? { lat: item.geo.latitude, lng: item.geo.longitude } : undefined,
-            };
-          }
-
-          if (type === 'Organization' || type === 'Corporation' || type === 'Person') {
-            hasOrganization = true;
-            if (!schemaData) {
-              schemaData = {
-                name: item.name,
-                address: formatAddress(item.address),
-                phone: item.telephone,
-              };
-            }
-          }
-        }
-      }
-    } catch {
-      // Invalid JSON-LD, skip
-    }
-  });
-
-  return { hasLocalBusiness, hasOrganization, schemaData };
-}
-
-/**
- * Format address from schema
- */
-function formatAddress(address: unknown): string | undefined {
-  if (!address) return undefined;
-  if (typeof address === 'string') return address;
-  if (typeof address === 'object' && address !== null) {
-    const a = address as Record<string, string>;
-    return [a.streetAddress, a.addressLocality, a.addressRegion, a.postalCode, a.addressCountry].filter(Boolean).join(', ');
-  }
-  return undefined;
-}
-
-/**
- * Detect phone numbers in page content
- */
-function detectPhones(html: string): string[] {
-  const $ = cheerio.load(html);
-  const text = $('body').text();
-  const phones = new Set<string>();
-
-  // Find tel: links
-  $('a[href^="tel:"]').each((_, el) => {
-    const href = $(el).attr('href');
-    if (href) {
-      phones.add(href.replace('tel:', '').trim());
-    }
-  });
-
-  // Find phone patterns in text
-  for (const pattern of PHONE_PATTERNS) {
-    const matches = text.match(pattern);
-    if (matches) {
-      matches.forEach((m) => phones.add(m.trim()));
-    }
-  }
-
-  // Filter out obviously invalid numbers
-  return Array.from(phones).filter((phone) => {
-    const digits = phone.replace(/\D/g, '');
-    return digits.length >= 10 && digits.length <= 15;
-  });
-}
-
-/**
- * Detect addresses in page content
- */
-function detectAddresses(html: string): string[] {
-  const $ = cheerio.load(html);
-  const text = $('body').text();
-  const addresses = new Set<string>();
-
-  // Find address patterns
-  for (const pattern of ADDRESS_PATTERNS) {
-    const matches = text.match(pattern);
-    if (matches) {
-      matches.forEach((m) => addresses.add(m.trim()));
-    }
-  }
-
-  // Check for schema addresses
-  $('[itemprop="address"]').each((_, el) => {
-    const addr = $(el).text().trim();
-    if (addr) addresses.add(addr);
-  });
-
-  return Array.from(addresses);
-}
-
-/**
- * Detect linked social profiles
- */
-function detectSocialProfiles(html: string): string[] {
-  const $ = cheerio.load(html);
-  const profiles: string[] = [];
-
-  const socialDomains = [
-    'facebook.com',
-    'twitter.com',
-    'x.com',
-    'linkedin.com',
-    'instagram.com',
-    'youtube.com',
-    'tiktok.com',
-    'pinterest.com',
-    'github.com',
-  ];
-
-  $('a[href]').each((_, el) => {
-    const href = $(el).attr('href');
-    if (!href) return;
-
-    for (const domain of socialDomains) {
-      if (href.includes(domain)) {
-        // Normalize the URL
-        try {
-          const url = new URL(href);
-          if (!profiles.includes(url.href)) {
-            profiles.push(url.href);
-          }
-        } catch {
-          // Invalid URL, skip
-        }
-        break;
-      }
-    }
-  });
-
-  return profiles;
-}
-
-/**
- * Analyze local SEO elements
- */
-export function analyzeLocalSEO(html: string, url: string): { issues: AuditIssue[]; data: LocalSEOData } {
-  const issues: AuditIssue[] = [];
-
-  // Extract schema
-  const { hasLocalBusiness, hasOrganization, schemaData } = extractSchema(html);
-
-  // Detect phones and addresses
-  const detectedPhones = detectPhones(html);
-  const detectedAddresses = detectAddresses(html);
-
-  // Detect social profiles
-  const socialProfiles = detectSocialProfiles(html);
-
-  // Generate issues
-  if (!hasLocalBusiness) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.LOCAL_BUSINESS_SCHEMA_MISSING,
-      affectedUrls: [url],
-    });
-  }
-
-  if (!hasOrganization && !hasLocalBusiness) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.ORGANIZATION_SCHEMA_MISSING,
-      affectedUrls: [url],
-    });
-  }
-
-  // Only flag missing address/phone for pages that appear to be business pages
-  const $ = cheerio.load(html);
-  const isBusinessPage =
-    $('a[href^="tel:"]').length > 0 ||
-    $('a[href^="mailto:"]').length > 0 ||
-    html.toLowerCase().includes('contact') ||
-    html.toLowerCase().includes('about us');
-
-  if (isBusinessPage) {
-    if (detectedAddresses.length === 0 && !schemaData?.address) {
-      issues.push({
-        ...ISSUE_DEFINITIONS.ADDRESS_NOT_DETECTED,
-        affectedUrls: [url],
-      });
-    }
-
-    if (detectedPhones.length === 0 && !schemaData?.phone) {
-      issues.push({
-        ...ISSUE_DEFINITIONS.PHONE_NOT_DETECTED,
-        affectedUrls: [url],
-      });
-    }
-  }
-
-  // Check for social profiles
-  if (socialProfiles.length === 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.SOCIAL_PROFILES_NOT_LINKED,
-      affectedUrls: [url],
-    });
-  }
-
-  return {
-    issues,
-    data: {
-      hasLocalBusinessSchema: hasLocalBusiness,
-      hasOrganizationSchema: hasOrganization,
-      detectedPhones,
-      detectedAddresses,
-      schemaData,
-      socialProfiles,
-    },
-  };
-}

package/src/audit/checks/mobile.ts

@@ -1,167 +0,0 @@
-import * as cheerio from 'cheerio';
-import type { AuditIssue } from '../types.js';
-import { ISSUE_DEFINITIONS } from '../types.js';
-
-export interface MobileData {
-  hasViewport: boolean;
-  viewportContent?: string;
-  isResponsive: boolean;
-  tapTargetIssues: number;
-  fontSizeIssues: number;
-}
-
-export function analyzeMobile(html: string, url: string): { issues: AuditIssue[]; data: MobileData } {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-
-  // Check viewport meta tag
-  const viewportMeta = $('meta[name="viewport"]');
-  const hasViewport = viewportMeta.length > 0;
-  const viewportContent = viewportMeta.attr('content');
-
-  if (!hasViewport) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.VIEWPORT_MISSING,
-      affectedUrls: [url],
-    });
-  } else if (viewportContent) {
-    // Check if viewport is responsive
-    const isResponsive = viewportContent.includes('width=device-width');
-
-    if (!isResponsive) {
-      // Check for fixed width
-      const widthMatch = viewportContent.match(/width=(\d+)/);
-      if (widthMatch) {
-        issues.push({
-          ...ISSUE_DEFINITIONS.VIEWPORT_NOT_RESPONSIVE,
-          affectedUrls: [url],
-          details: {
-            viewport: viewportContent,
-            fixedWidth: widthMatch[1],
-          },
-        });
-      }
-    }
-
-    // Check for user-scalable=no (bad for accessibility)
-    if (viewportContent.includes('user-scalable=no') || viewportContent.includes('user-scalable=0')) {
-      issues.push({
-        code: 'VIEWPORT_NO_ZOOM',
-        severity: 'warning',
-        category: 'mobile',
-        title: 'Viewport prevents zooming',
-        description: 'The viewport meta tag disables user scaling.',
-        impact: 'Users with visual impairments cannot zoom the page.',
-        howToFix: 'Remove user-scalable=no from the viewport meta tag.',
-        affectedUrls: [url],
-      });
-    }
-  }
-
-  // Check for tap target issues (basic heuristic)
-  // In a real implementation, this would analyze CSS computed styles
-  let tapTargetIssues = 0;
-  $('a, button, input, select, textarea').each((_, el) => {
-    const style = $(el).attr('style') || '';
-    // Basic check for very small explicit sizes
-    const heightMatch = style.match(/height:\s*(\d+)px/);
-    const widthMatch = style.match(/width:\s*(\d+)px/);
-
-    if (heightMatch && parseInt(heightMatch[1], 10) < 44) {
-      tapTargetIssues++;
-    }
-    if (widthMatch && parseInt(widthMatch[1], 10) < 44) {
-      tapTargetIssues++;
-    }
-  });
-
-  if (tapTargetIssues > 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.TAP_TARGETS_TOO_SMALL,
-      affectedUrls: [url],
-      details: { count: tapTargetIssues },
-    });
-  }
-
-  // Check for font size issues (basic heuristic)
-  let fontSizeIssues = 0;
-  $('body *').each((_, el) => {
-    const style = $(el).attr('style') || '';
-    const fontSizeMatch = style.match(/font-size:\s*(\d+)px/);
-    if (fontSizeMatch && parseInt(fontSizeMatch[1], 10) < 12) {
-      fontSizeIssues++;
-    }
-  });
-
-  return {
-    issues,
-    data: {
-      hasViewport,
-      viewportContent,
-      isResponsive: hasViewport && (viewportContent?.includes('width=device-width') || false),
-      tapTargetIssues,
-      fontSizeIssues,
-    }
-  };
-}
-
-// Additional mobile-specific checks
-export function checkMobileResources(html: string, url: string): AuditIssue[] {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-
-  // Check for Flash content (obsolete)
-  if ($('object[type*="flash"], embed[type*="flash"]').length > 0) {
-    issues.push({
-      code: 'FLASH_CONTENT',
-      severity: 'error',
-      category: 'mobile',
-      title: 'Flash content detected',
-      description: 'Page contains Flash content which is not supported on mobile devices.',
-      impact: 'Content is inaccessible on mobile devices and most modern browsers.',
-      howToFix: 'Replace Flash content with HTML5 alternatives.',
-      affectedUrls: [url],
-    });
-  }
-
-  // Check for plugins
-  if ($('object, embed, applet').length > 0) {
-    issues.push({
-      code: 'PLUGINS_DETECTED',
-      severity: 'notice',
-      category: 'mobile',
-      title: 'Plugins detected',
-      description: 'Page uses plugins which may not work on mobile devices.',
-      impact: 'Some content may not be accessible on mobile.',
-      howToFix: 'Consider replacing plugins with standard web technologies.',
-      affectedUrls: [url],
-    });
-  }
-
-  // Check for horizontal scroll (indication of non-responsive design)
-  // This is a heuristic based on fixed-width elements
-  let fixedWidthElements = 0;
-  $('*').each((_, el) => {
-    const style = $(el).attr('style') || '';
-    const widthMatch = style.match(/width:\s*(\d+)px/);
-    if (widthMatch && parseInt(widthMatch[1], 10) > 320) {
-      fixedWidthElements++;
-    }
-  });
-
-  if (fixedWidthElements > 5) {
-    issues.push({
-      code: 'POSSIBLE_HORIZONTAL_SCROLL',
-      severity: 'notice',
-      category: 'mobile',
-      title: 'Possible horizontal scrolling',
-      description: 'Multiple elements have fixed widths that may cause horizontal scrolling on mobile.',
-      impact: 'Poor mobile user experience.',
-      howToFix: 'Use responsive widths (percentages, max-width) instead of fixed pixel widths.',
-      affectedUrls: [url],
-      details: { count: fixedWidthElements },
-    });
-  }
-
-  return issues;
-}

package/src/audit/checks/modern-images.ts

@@ -1,226 +0,0 @@
-// Modern Image Format Checks
-// Checks for WebP/AVIF usage and image optimization
-
-import * as cheerio from 'cheerio';
-import type { AuditIssue } from '../types.js';
-import { ISSUE_DEFINITIONS } from '../types.js';
-
-// File extensions for modern formats
-const MODERN_FORMATS = ['.webp', '.avif'];
-const LEGACY_FORMATS = ['.jpg', '.jpeg', '.png', '.gif', '.bmp'];
-
-export interface ImageInfo {
-  src: string;
-  alt: string | null;
-  width: number | null;
-  height: number | null;
-  loading: string | null;
-  format: string;
-  isModernFormat: boolean;
-  hasDimensions: boolean;
-  isLazyLoaded: boolean;
-}
-
-export interface ModernImagesData {
-  totalImages: number;
-  modernFormatCount: number;
-  legacyFormatCount: number;
-  modernFormatPercentage: number;
-  images: ImageInfo[];
-  hasSourceSet: boolean;
-  hasPictureElements: boolean;
-}
-
-/**
- * Extract format from URL
- */
-function getImageFormat(url: string): string {
-  try {
-    const pathname = new URL(url, 'https://example.com').pathname.toLowerCase();
-
-    // Check for format in query string (common with CDNs)
-    const formatMatch = url.match(/[?&](?:format|f)=(\w+)/i);
-    if (formatMatch) {
-      return '.' + formatMatch[1].toLowerCase();
-    }
-
-    // Check file extension
-    const extMatch = pathname.match(/\.([a-z0-9]+)$/i);
-    if (extMatch) {
-      return '.' + extMatch[1].toLowerCase();
-    }
-
-    return 'unknown';
-  } catch {
-    return 'unknown';
-  }
-}
-
-/**
- * Check if format is modern
- */
-function isModernFormat(format: string): boolean {
-  return MODERN_FORMATS.includes(format.toLowerCase());
-}
-
-/**
- * Extract image information from HTML
- */
-function extractImages($: cheerio.CheerioAPI, baseUrl: string): ImageInfo[] {
-  const images: ImageInfo[] = [];
-
-  // Process img tags
-  $('img').each((_, el) => {
-    const src = $(el).attr('src') || $(el).attr('data-src') || '';
-    const srcset = $(el).attr('srcset') || '';
-    const alt = $(el).attr('alt') || null;
-    const width = $(el).attr('width') ? parseInt($(el).attr('width')!, 10) : null;
-    const height = $(el).attr('height') ? parseInt($(el).attr('height')!, 10) : null;
-    const loading = $(el).attr('loading') || null;
-
-    // Skip data URIs and empty sources
-    if (!src || src.startsWith('data:')) return;
-
-    // Resolve relative URLs
-    let fullSrc = src;
-    try {
-      fullSrc = new URL(src, baseUrl).href;
-    } catch {
-      // Keep original if URL parsing fails
-    }
-
-    const format = getImageFormat(fullSrc);
-
-    images.push({
-      src: fullSrc,
-      alt,
-      width,
-      height,
-      loading,
-      format,
-      isModernFormat: isModernFormat(format),
-      hasDimensions: width !== null && height !== null,
-      isLazyLoaded: loading === 'lazy' || $(el).attr('data-src') !== undefined,
-    });
-
-    // Check srcset for modern formats
-    if (srcset) {
-      const srcsetUrls = srcset.split(',').map((s) => s.trim().split(' ')[0]);
-      for (const srcsetUrl of srcsetUrls) {
-        const srcsetFormat = getImageFormat(srcsetUrl);
-        if (isModernFormat(srcsetFormat) && !images.some((img) => img.src === srcsetUrl)) {
-          images.push({
-            src: srcsetUrl,
-            alt,
-            width: null,
-            height: null,
-            loading,
-            format: srcsetFormat,
-            isModernFormat: true,
-            hasDimensions: false,
-            isLazyLoaded: loading === 'lazy',
-          });
-        }
-      }
-    }
-  });
-
-  // Check picture elements for modern format sources
-  $('picture source').each((_, el) => {
-    const srcset = $(el).attr('srcset') || '';
-    const type = $(el).attr('type') || '';
-
-    if (type.includes('webp') || type.includes('avif')) {
-      const srcsetUrls = srcset.split(',').map((s) => s.trim().split(' ')[0]);
-      for (const srcsetUrl of srcsetUrls) {
-        if (!images.some((img) => img.src === srcsetUrl)) {
-          images.push({
-            src: srcsetUrl,
-            alt: null,
-            width: null,
-            height: null,
-            loading: null,
-            format: type.includes('webp') ? '.webp' : '.avif',
-            isModernFormat: true,
-            hasDimensions: false,
-            isLazyLoaded: false,
-          });
-        }
-      }
-    }
-  });
-
-  return images;
-}
-
-/**
- * Analyze image formats and optimization
- */
-export function analyzeModernImages(html: string, url: string): { issues: AuditIssue[]; data: ModernImagesData } {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-
-  // Extract images
-  const images = extractImages($, url);
-
-  // Filter to unique images by src
-  const uniqueImages = images.filter((img, idx, arr) => arr.findIndex((i) => i.src === img.src) === idx);
-
-  // Count formats
-  const modernFormatCount = uniqueImages.filter((img) => img.isModernFormat).length;
-  const legacyFormatCount = uniqueImages.filter(
-    (img) => !img.isModernFormat && LEGACY_FORMATS.includes(img.format)
-  ).length;
-
-  // Check for picture elements and srcset
-  const hasPictureElements = $('picture').length > 0;
-  const hasSourceSet = $('img[srcset]').length > 0 || $('picture source[srcset]').length > 0;
-
-  // Calculate percentage
-  const totalRelevantImages = modernFormatCount + legacyFormatCount;
-  const modernFormatPercentage = totalRelevantImages > 0 ? Math.round((modernFormatCount / totalRelevantImages) * 100) : 100;
-
-  // Generate issues
-  if (legacyFormatCount > 0 && !hasPictureElements && !hasSourceSet) {
-    const legacyImages = uniqueImages.filter((img) => !img.isModernFormat && LEGACY_FORMATS.includes(img.format));
-
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMAGE_NOT_WEBP_AVIF,
-      affectedUrls: legacyImages.slice(0, 10).map((img) => img.src),
-      details: {
-        legacyImageCount: legacyFormatCount,
-        modernImageCount: modernFormatCount,
-        modernFormatPercentage,
-        recommendation: 'Convert images to WebP or AVIF format for 25-50% smaller file sizes',
-      },
-    });
-  }
-
-  // Check for images without dimensions (causes CLS)
-  const imagesWithoutDimensions = uniqueImages.filter(
-    (img) => !img.hasDimensions && !img.isLazyLoaded && LEGACY_FORMATS.includes(img.format)
-  );
-
-  if (imagesWithoutDimensions.length > 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_NO_DIMENSIONS,
-      affectedUrls: imagesWithoutDimensions.slice(0, 10).map((img) => img.src),
-      details: {
-        count: imagesWithoutDimensions.length,
-      },
-    });
-  }
-
-  return {
-    issues,
-    data: {
-      totalImages: uniqueImages.length,
-      modernFormatCount,
-      legacyFormatCount,
-      modernFormatPercentage,
-      images: uniqueImages,
-      hasSourceSet,
-      hasPictureElements,
-    },
-  };
-}