@rankcli/agent-runtime 0.0.9 → 0.0.11

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import {
-  __export,
-  __require,
+  analyzeMobileSEO
+} from "./chunk-M27NQCWW.mjs";
+import {
   analyzeHeadings,
   analyzeUrl,
   checkRobots,
@@ -13,7 +14,41 @@ import {
   httpGet,
   httpHead,
   httpPost
-} from "./chunk-YNZYHEYM.mjs";
+} from "./chunk-PJLNXOLN.mjs";
+import {
+  AI_CRAWLERS_INFO,
+  analyzeCitationReadiness,
+  analyzeContentStructure,
+  analyzeEntityExtraction,
+  analyzeGEO,
+  analyzeRobotsTxtForAI,
+  calculateLLMSignals,
+  detectRenderingMode,
+  generateAIFriendlyRobotsTxt
+} from "./chunk-3ZSCLNTW.mjs";
+import {
+  analyzeCoreWebVitals
+} from "./chunk-4E4MQOSP.mjs";
+import {
+  analyzeSecurityHeaders,
+  generateSecurityHeaders
+} from "./chunk-AK2IC22C.mjs";
+import {
+  analyzeStructuredData,
+  generateSchemaTemplate
+} from "./chunk-VSQD74I7.mjs";
+import {
+  analyzeImages,
+  generateResponsiveImage
+} from "./chunk-2JADKV3Z.mjs";
+import {
+  analyzeInternalLinking,
+  suggestInternalLinks
+} from "./chunk-K6VSXDD6.mjs";
+import {
+  __export,
+  __require
+} from "./chunk-6BWS3CLP.mjs";
 
 // src/audit/types.ts
 var ISSUE_DEFINITIONS = {
@@ -2356,7 +2391,7 @@ async function analyzeLinks(html, baseUrl, checkBroken = false) {
 
 // src/audit/checks/images.ts
 import * as cheerio3 from "cheerio";
-async function analyzeImages(html, baseUrl, checkBroken = false) {
+async function analyzeImages2(html, baseUrl, checkBroken = false) {
   const issues = [];
   const $ = cheerio3.load(html);
   const missingAlt = [];
@@ -2714,7 +2749,7 @@ var SCHEMA_RECOMMENDED_PROPERTIES = {
   "SoftwareApplication": ["applicationCategory", "offers", "aggregateRating"],
   "VideoObject": ["duration", "embedUrl"]
 };
-function analyzeStructuredData(html, url) {
+function analyzeStructuredData2(html, url) {
   const issues = [];
   const $ = cheerio5.load(html);
   const schemas = [];
@@ -4508,7 +4543,7 @@ function parseHSTS(header) {
   result.preload = /preload/i.test(header);
   return result;
 }
-async function analyzeSecurityHeaders(url) {
+async function analyzeSecurityHeaders2(url) {
   const issues = [];
   try {
     const response = await httpGet(url, {
@@ -16645,7 +16680,7 @@ async function runFullAudit(options) {
   const headers = fetchResult.headers;
   console.log(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
   const onPageResult = analyzeOnPage(html, url);
-  const structuredDataResult = analyzeStructuredData(html, url);
+  const structuredDataResult = analyzeStructuredData2(html, url);
   const mobileResult = analyzeMobile(html, url);
   const mobileResourceIssues = checkMobileResources(html, url);
   const socialResult = analyzeSocialMeta(html, url);
@@ -16780,7 +16815,7 @@ async function runFullAudit(options) {
   });
   const asyncChecks = [];
   asyncChecks.push(safeAsync("Links", () => analyzeLinks(html, url, checkBrokenLinks)));
-  asyncChecks.push(safeAsync("Images", () => analyzeImages(html, url, checkBrokenLinks)));
+  asyncChecks.push(safeAsync("Images", () => analyzeImages2(html, url, checkBrokenLinks)));
   asyncChecks.push(performancePromise);
   asyncChecks.push(safeAsync("Security", () => analyzeSecurity(html, url, headers)));
   asyncChecks.push(safeAsyncIssues("Certificate", async () => (await checkCertificate(url)).issues));
@@ -16790,7 +16825,7 @@ async function runFullAudit(options) {
   if (runExtendedChecks) {
     asyncChecks.push(safeAsync("Hreflang", () => analyzeHreflang(html, url, { validateUrls: checkHreflangUrls })));
     asyncChecks.push(safeAsync("Canonical Advanced", () => analyzeCanonicalAdvanced(html, url, { checkChain: checkCanonicalChain })));
-    asyncChecks.push(safeAsync("Security Headers", () => analyzeSecurityHeaders(url)));
+    asyncChecks.push(safeAsync("Security Headers", () => analyzeSecurityHeaders2(url)));
     asyncChecks.push(safeAsync("Caching Headers", () => analyzeCachingHeaders(url, headers)));
     asyncChecks.push(safeAsync("HTML Compliance", () => analyzeHtmlCompliance(html, url, headers)));
     asyncChecks.push(safeAsync("Redirect Chain", () => analyzeRedirectChain(url)));
@@ -16890,7 +16925,7 @@ function createReport(url, domain, issues, pages) {
   };
 }
 function calculateHealthScore(issues) {
-  const weights = { error: 10, warning: 3, notice: 1 };
+  const weights = { critical: 15, error: 10, warning: 3, info: 1, notice: 1 };
   const categoryDeductions = {
     crawlability: 0,
     indexability: 0,
@@ -17010,8 +17045,8 @@ function groupIssuesByCategory(issues) {
   }
   for (const category of Object.keys(grouped)) {
     grouped[category].sort((a, b) => {
-      const order = { error: 0, warning: 1, notice: 2 };
-      return order[a.severity] - order[b.severity];
+      const order = { critical: 0, error: 1, warning: 2, info: 3, notice: 4 };
+      return (order[a.severity] ?? 5) - (order[b.severity] ?? 5);
     });
   }
   return grouped;
@@ -25639,7 +25674,7 @@ async function executeAgent(agent, options = {}) {
   }
 }
 async function runDirectAnalysis(url) {
-  const { analyzeUrl: analyzeUrl2 } = await import("./analyzer-2CSWIQGD.mjs");
+  const { analyzeUrl: analyzeUrl2 } = await import("./analyzer-GMURJADU.mjs");
   const result = await analyzeUrl2({ url });
   if (!result.success || !result.data) {
     throw new Error(result.error || "Analysis failed");
@@ -27425,213 +27460,3539 @@ export function SEOHead({
 Usage: <SEOHead title="Page" description="..." />`
   };
 }
+function generateRailsSEOHelper(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "app/helpers/seo_helper.rb",
+    code: `# frozen_string_literal: true
+
+# Comprehensive SEO Helper for Rails
+#
+# Features:
+# - Full Open Graph support
+# - Twitter Cards
+# - JSON-LD structured data
+# - Canonical URLs
+# - Dynamic meta tags
+#
+# Installation: gem 'meta-tags'
+# Include in ApplicationHelper or use directly
+module SeoHelper
+  SITE_NAME = '${siteName}'.freeze
+  SITE_URL = '${siteUrl}'.freeze
+  DEFAULT_IMAGE = '${image || `${siteUrl}/og-image.png`}'.freeze
+  DEFAULT_DESCRIPTION = '${description || `${siteName} - A compelling description.`}'.freeze
+  TWITTER_HANDLE = '${twitterHandle || ""}'.freeze
+
+  # Set comprehensive page SEO
+  #
+  # @param title [String] Page title
+  # @param description [String] Meta description
+  # @param image [String] OG/Twitter image URL
+  # @param type [Symbol] :website, :article, :product
+  # @param options [Hash] Additional options
+  #
+  # @example
+  #   set_page_seo(
+  #     title: 'Product Name',
+  #     description: 'Product description',
+  #     type: :product,
+  #     schema: product_schema(@product)
+  #   )
+  def set_page_seo(title: nil, description: nil, image: nil, type: :website, **options)
+    page_title = title || SITE_NAME
+    page_description = description || DEFAULT_DESCRIPTION
+    page_image = image || DEFAULT_IMAGE
+    page_url = request.original_url
+
+    set_meta_tags(
+      title: page_title,
+      site: SITE_NAME,
+      description: page_description,
+      canonical: page_url,
+      robots: options[:noindex] ? 'noindex, nofollow' : 'index, follow',
+
+      # Open Graph
+      og: {
+        title: page_title,
+        description: page_description,
+        type: type.to_s,
+        url: page_url,
+        image: {
+          _: page_image,
+          width: 1200,
+          height: 630,
+          alt: page_title
+        },
+        site_name: SITE_NAME,
+        locale: options[:locale] || 'en_US'
+      },
 
-// src/fixer.ts
-async function generateFixes(issues, options) {
-  const { cwd, url } = options;
-  let framework = options.framework;
-  if (!framework) {
-    const result = await detectFramework3({ cwd });
-    framework = result.success ? result.data : { name: "Unknown", metaPattern: "html-head" };
-  }
-  const fixes = [];
-  const htmlEntry = await findHtmlEntry({ cwd });
-  const htmlPath = htmlEntry.success ? htmlEntry.data.path : "index.html";
-  const htmlContent = htmlEntry.success ? htmlEntry.data.content : "";
-  for (const issue of issues) {
-    const fix = await generateFixForIssue(issue, {
-      cwd,
-      url,
-      framework,
-      htmlPath,
-      htmlContent
-    });
-    if (fix) {
-      fixes.push(fix);
+      # Twitter Cards
+      twitter: {
+        card: 'summary_large_image',
+        title: page_title,
+        description: page_description,
+        image: page_image,
+        site: TWITTER_HANDLE.presence,
+        creator: TWITTER_HANDLE.presence
+      }.compact,
+
+      # Article-specific
+      article: if type == :article
+        {
+          published_time: options[:published_at]&.iso8601,
+          modified_time: options[:updated_at]&.iso8601,
+          author: options[:author],
+          section: options[:section],
+          tag: options[:tags]
+        }.compact
+      end
+    )
+
+    # Store schema for JSON-LD rendering
+    @json_ld_schemas = [default_website_schema]
+    @json_ld_schemas << options[:schema] if options[:schema]
+  end
+
+  # Render JSON-LD structured data
+  def json_ld_tags
+    return unless @json_ld_schemas&.any?
+
+    safe_join(@json_ld_schemas.map do |schema|
+      content_tag(:script, schema.to_json.html_safe, type: 'application/ld+json')
+    end)
+  end
+
+  # Schema generators
+  def default_website_schema
+    {
+      '@context': 'https://schema.org',
+      '@type': 'WebSite',
+      name: SITE_NAME,
+      url: SITE_URL
     }
-  }
-  return fixes;
-}
-async function generateFixForIssue(issue, context) {
-  const { cwd, url, framework, htmlPath, htmlContent } = context;
-  const fullUrl = url || "https://example.com";
-  const siteName = new URL(fullUrl).hostname.replace("www.", "");
-  switch (issue.code) {
-    // Title issues
-    case "MISSING_TITLE":
-    case "TITLE_MISSING":
-    // Full audit code
-    case "TITLE_KEYWORD_MISMATCH":
-    case "TITLE_H1_KEYWORD_MISMATCH":
-    case "OUTDATED_YEAR_IN_TITLE":
-      return generateTitleFix(context, siteName);
-    // Meta description issues
-    case "MISSING_META_DESC":
-    case "META_DESC_MISSING":
-      return generateMetaDescFix(context, siteName);
-    // Canonical issues
-    case "MISSING_CANONICAL":
-    case "CANONICAL_MISSING":
-    // Full audit code
-    case "CANONICAL_NO_HTTPS_REDIRECT":
-      return generateCanonicalFix(context, fullUrl);
-    // Viewport issues
-    case "MISSING_VIEWPORT":
-    case "HTML_NO_VIEWPORT":
-    case "RESPONSIVE_NO_VIEWPORT":
-    case "VIEWPORT_MISSING":
-      return generateViewportFix(context);
-    // Open Graph issues
-    case "MISSING_OG_TAGS":
-    case "OG_TITLE_MISSING":
-    case "OG_DESC_MISSING":
-    case "OG_DESCRIPTION_MISSING":
-    // Full audit code
-    case "OG_IMAGE_MISSING":
-    case "OG_URL_MISSING":
-    case "OG_TYPE_MISSING":
-      return generateOGFix(context, siteName, fullUrl);
-    // Twitter Card issues
-    case "MISSING_TWITTER_CARD":
-    case "TWITTER_CARD_MISSING":
-    case "TWITTER_TITLE_MISSING":
-    case "TWITTER_DESC_MISSING":
-    case "TWITTER_DESCRIPTION_MISSING":
-    // Full audit code
-    case "TWITTER_IMAGE_MISSING":
-      return generateTwitterFix(context, siteName);
-    // Schema/structured data issues
-    case "MISSING_SCHEMA":
-    case "SCHEMA_MISSING":
-    // Full audit code
-    case "SCHEMA_ORG_MISSING":
-    case "NO_ORGANIZATION_SCHEMA":
-    case "NO_ENTITY_SCHEMA":
-    case "FAQ_SCHEMA_MISSING":
-      return generateSchemaFix(context, siteName, fullUrl);
-    // Robots.txt issues
-    case "MISSING_ROBOTS":
-    case "ROBOTS_TXT_MISSING":
-    // Full audit code
-    case "ROBOTS_TXT_WARNINGS":
-    case "ROBOTS_TXT_INVALID_SYNTAX":
-      return generateRobotsFix(context, fullUrl);
-    // Sitemap issues
-    case "MISSING_SITEMAP":
-    case "SITEMAP_MISSING":
-    // Full audit code
-    case "BING_SITEMAP_MISSING":
-      return generateSitemapFix(context, fullUrl);
-    // H1 issues
-    case "MISSING_H1":
-    case "H1_MISSING":
-    // Full audit code
-    case "NO_VISIBLE_HEADLINE":
-    case "H1_MISSING_KEYWORD":
-      return await generateH1Fix({ cwd });
-    // SPA-specific: add meta management library recommendation
-    case "SPA_NO_META_MANAGEMENT":
-    case "SPA_WITHOUT_SSR":
-    case "CLIENT_SIDE_RENDERING":
-      return generateSPAMetaFix(context, framework);
-    // Internal links - suggest adding links
-    case "NO_INTERNAL_LINKS":
-    case "LINKS_NO_INTERNAL":
-    case "NO_CONTENT_INTERNAL_LINKS":
-      return {
-        issue: { code: issue.code, message: "No internal links found", severity: "warning" },
-        file: "src/components/Footer.tsx",
-        before: null,
-        after: `// Add internal navigation links to your footer or content
-// Example: <Link to="/about">About</Link>`,
-        explanation: "Add internal links to help search engines discover your content",
-        skipped: true,
-        skipReason: "Requires manual content updates - add links to your navigation and content"
-      };
-    // Preconnect issues
-    case "GOOGLE_FONTS_NO_PRECONNECT":
-    case "MISSING_PRECONNECT":
-      return generatePreconnectFix(context);
-    // Favicon/icons
-    case "HTML_NO_FAVICON":
-    case "HTML_NO_APPLE_TOUCH_ICON":
-    case "FAVICON_MISSING":
-      return generateFaviconFix(context);
-    // Charset/lang
-    case "HTML_NO_CHARSET":
-    case "HTML_NOT_UTF8":
-      return generateCharsetFix(context);
-    case "HTML_NO_LANG":
-    case "LANG_ATTR_MISSING":
-      return generateLangFix(context);
-    // AI/LLMs.txt
-    case "AI_NO_LLMS_TXT":
-      return generateLlmsTxtFix(context, siteName, fullUrl);
-    default:
-      return null;
-  }
-}
-function generateTitleFix(context, siteName) {
-  const { htmlPath, htmlContent, framework } = context;
-  if (framework.metaPattern === "html-head") {
-    const titleTag = `<title>${siteName} - Your Product Tagline</title>`;
-    if (htmlContent.includes("<title>")) {
-      const before = htmlContent.match(/<title>.*?<\/title>/)?.[0] || "";
-      return {
-        issue: { code: "MISSING_TITLE", message: "Missing or empty title tag", severity: "critical" },
-        file: htmlPath,
-        before,
-        after: titleTag,
-        explanation: "Updated the title tag with a descriptive title"
-      };
-    } else {
-      return {
-        issue: { code: "MISSING_TITLE", message: "Missing title tag", severity: "critical" },
-        file: htmlPath,
-        before: "<head>",
-        after: `<head>
-    ${titleTag}`,
-        explanation: "Added a title tag to the document head"
-      };
+  end
+
+  def organization_schema(name: SITE_NAME, url: SITE_URL, logo: nil, social: [])
+    {
+      '@context': 'https://schema.org',
+      '@type': 'Organization',
+      name: name,
+      url: url,
+      logo: logo,
+      sameAs: social
+    }.compact
+  end
+
+  def article_schema(article)
+    {
+      '@context': 'https://schema.org',
+      '@type': 'Article',
+      headline: article.title,
+      description: article.excerpt || truncate(strip_tags(article.content), length: 160),
+      image: article.image_url || DEFAULT_IMAGE,
+      datePublished: article.published_at&.iso8601,
+      dateModified: article.updated_at&.iso8601,
+      author: {
+        '@type': 'Person',
+        name: article.author_name
+      },
+      publisher: {
+        '@type': 'Organization',
+        name: SITE_NAME,
+        logo: { '@type': 'ImageObject', url: "#{SITE_URL}/logo.png" }
+      }
     }
-  }
-  return {
-    issue: { code: "MISSING_TITLE", message: "Missing title tag", severity: "critical" },
-    file: htmlPath,
-    before: null,
-    after: `<title>${siteName} - Your Product Tagline</title>`,
-    explanation: `Add title using ${framework.name} patterns`
-  };
-}
-function generateMetaDescFix(context, siteName) {
-  const { htmlPath, htmlContent, framework } = context;
-  const description = `${siteName} - A brief, compelling description of your product or service. Include key features and benefits.`;
-  if (framework.metaPattern === "html-head") {
-    const metaTag = `<meta name="description" content="${description}" />`;
-    if (htmlContent.includes("<title>")) {
-      return {
-        issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
-        file: htmlPath,
-        before: "</title>",
-        after: `</title>
-    ${metaTag}`,
-        explanation: "Added meta description after the title tag"
-      };
-    } else {
-      return {
-        issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
-        file: htmlPath,
-        before: "<head>",
-        after: `<head>
-    ${metaTag}`,
-        explanation: "Added meta description to the document head"
-      };
+  end
+
+  def product_schema(product)
+    {
+      '@context': 'https://schema.org',
+      '@type': 'Product',
+      name: product.name,
+      description: product.description,
+      image: product.image_url,
+      brand: product.brand.present? ? { '@type': 'Brand', name: product.brand } : nil,
+      sku: product.sku,
+      offers: {
+        '@type': 'Offer',
+        price: product.price.to_s,
+        priceCurrency: product.currency || 'USD',
+        availability: "https://schema.org/#{product.in_stock? ? 'InStock' : 'OutOfStock'}"
+      },
+      aggregateRating: product.reviews_count.positive? ? {
+        '@type': 'AggregateRating',
+        ratingValue: product.average_rating,
+        reviewCount: product.reviews_count
+      } : nil
+    }.compact
+  end
+
+  def faq_schema(items)
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: items.map do |item|
+        {
+          '@type': 'Question',
+          name: item[:question],
+          acceptedAnswer: { '@type': 'Answer', text: item[:answer] }
+        }
+      end
     }
-  }
-  return {
-    issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
-    file: htmlPath,
-    before: null,
+  end
+
+  def breadcrumb_schema(items)
+    {
+      '@context': 'https://schema.org',
+      '@type': 'BreadcrumbList',
+      itemListElement: items.each_with_index.map do |item, index|
+        {
+          '@type': 'ListItem',
+          position: index + 1,
+          name: item[:name],
+          item: item[:url]
+        }
+      end
+    }
+  end
+
+  def local_business_schema(business)
+    {
+      '@context': 'https://schema.org',
+      '@type': 'LocalBusiness',
+      name: business[:name],
+      description: business[:description],
+      url: business[:url],
+      telephone: business[:phone],
+      address: {
+        '@type': 'PostalAddress',
+        streetAddress: business.dig(:address, :street),
+        addressLocality: business.dig(:address, :city),
+        addressRegion: business.dig(:address, :state),
+        postalCode: business.dig(:address, :zip),
+        addressCountry: business.dig(:address, :country)
+      },
+      geo: business[:coordinates].present? ? {
+        '@type': 'GeoCoordinates',
+        latitude: business.dig(:coordinates, :lat),
+        longitude: business.dig(:coordinates, :lng)
+      } : nil,
+      openingHours: business[:hours],
+      priceRange: business[:price_range]
+    }.compact
+  end
+end`,
+    explanation: `Ruby on Rails comprehensive SEO helper with:
+\u2022 meta-tags gem integration
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schema generators for all common types
+\u2022 Canonical URLs and robots directives
+
+Setup:
+1. Add to Gemfile: gem 'meta-tags'
+2. Include helper in ApplicationHelper
+3. Call set_page_seo in controllers
+4. Add <%= display_meta_tags %> and <%= json_ld_tags %> to layout`,
+    installCommands: ["bundle add meta-tags"],
+    additionalFiles: [
+      {
+        file: "app/views/layouts/application.html.erb",
+        code: `<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    <%= display_meta_tags %>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    
+    <%= stylesheet_link_tag "application", "data-turbo-track": "reload" %>
+    <%= javascript_importmap_tags %>
+    
+    <!-- Favicon -->
+    <%= favicon_link_tag 'favicon.ico' %>
+    <%= favicon_link_tag 'apple-touch-icon.png', rel: 'apple-touch-icon', type: 'image/png', sizes: '180x180' %>
+    
+    <!-- JSON-LD Structured Data -->
+    <%= json_ld_tags %>
+  </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>`,
+        explanation: "Application layout with SEO meta tags and JSON-LD."
+      },
+      {
+        file: "config/initializers/meta_tags.rb",
+        code: `# frozen_string_literal: true
+
+MetaTags.configure do |config|
+  # Use title template
+  config.title_limit = 70
+  config.description_limit = 160
+  config.keywords_limit = 255
+  
+  # Truncate long strings
+  config.truncate_on_bytesize = true
+  
+  # Separate site name with |
+  config.title_separator = ' | '
+end`,
+        explanation: "meta-tags gem configuration."
+      },
+      {
+        file: "public/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateDjangoSEOHelper(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "core/seo.py",
+    code: `"""
+Comprehensive SEO utilities for Django
+
+Features:
+- Full Open Graph support
+- Twitter Cards  
+- JSON-LD structured data
+- Canonical URLs
+- Template tags and context processors
+
+Installation: pip install django-meta
+"""
+
+from django.conf import settings
+from django.utils.safestring import mark_safe
+import json
+from typing import Any, Optional
+from dataclasses import dataclass, field
+
+
+# Configuration
+SITE_NAME = '${siteName}'
+SITE_URL = '${siteUrl}'
+DEFAULT_IMAGE = '${image || `${siteUrl}/og-image.png`}'
+DEFAULT_DESCRIPTION = '${description || `${siteName} - A compelling description.`}'
+TWITTER_HANDLE = '${twitterHandle || ""}'
+
+
+@dataclass
+class SEOMeta:
+    """SEO metadata container"""
+    title: Optional[str] = None
+    description: str = DEFAULT_DESCRIPTION
+    image: str = DEFAULT_IMAGE
+    url: Optional[str] = None
+    type: str = 'website'
+    
+    # Article specific
+    published_time: Optional[str] = None
+    modified_time: Optional[str] = None
+    author: Optional[str] = None
+    tags: list = field(default_factory=list)
+    
+    # Robots
+    noindex: bool = False
+    nofollow: bool = False
+    
+    # Structured data
+    schema: Optional[dict] = None
+    
+    def get_full_title(self) -> str:
+        if not self.title:
+            return SITE_NAME
+        if SITE_NAME in self.title:
+            return self.title
+        return f"{self.title} | {SITE_NAME}"
+    
+    def get_image_url(self) -> str:
+        if self.image.startswith('http'):
+            return self.image
+        return f"{SITE_URL}{self.image}"
+    
+    def get_robots(self) -> str:
+        index = 'noindex' if self.noindex else 'index'
+        follow = 'nofollow' if self.nofollow else 'follow'
+        return f"{index}, {follow}"
+
+
+class SEOContextMixin:
+    """
+    Mixin for class-based views to add SEO context
+    
+    Usage:
+        class ArticleDetailView(SEOContextMixin, DetailView):
+            model = Article
+            
+            def get_seo_meta(self):
+                return SEOMeta(
+                    title=self.object.title,
+                    description=self.object.excerpt,
+                    image=self.object.image.url if self.object.image else None,
+                    type='article',
+                    published_time=self.object.published_at.isoformat(),
+                    schema=article_schema(self.object)
+                )
+    """
+    
+    def get_seo_meta(self) -> SEOMeta:
+        return SEOMeta()
+    
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        context['seo'] = self.get_seo_meta()
+        return context
+
+
+def seo_context_processor(request):
+    """
+    Context processor to add default SEO values
+    
+    Add to settings.TEMPLATES[0]['OPTIONS']['context_processors']
+    """
+    return {
+        'site_name': SITE_NAME,
+        'site_url': SITE_URL,
+        'default_og_image': DEFAULT_IMAGE,
+    }
+
+
+# JSON-LD Schema Generators
+
+def website_schema() -> dict:
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'WebSite',
+        'name': SITE_NAME,
+        'url': SITE_URL,
+    }
+
+
+def organization_schema(
+    name: str = SITE_NAME,
+    url: str = SITE_URL,
+    logo: Optional[str] = None,
+    social_profiles: list = None
+) -> dict:
+    schema = {
+        '@context': 'https://schema.org',
+        '@type': 'Organization',
+        'name': name,
+        'url': url,
+    }
+    if logo:
+        schema['logo'] = logo
+    if social_profiles:
+        schema['sameAs'] = social_profiles
+    return schema
+
+
+def article_schema(article) -> dict:
+    """Generate Article schema from model instance"""
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'Article',
+        'headline': article.title,
+        'description': getattr(article, 'excerpt', '') or article.content[:160],
+        'image': article.image.url if hasattr(article, 'image') and article.image else DEFAULT_IMAGE,
+        'datePublished': article.published_at.isoformat() if hasattr(article, 'published_at') else None,
+        'dateModified': article.updated_at.isoformat() if hasattr(article, 'updated_at') else None,
+        'author': {
+            '@type': 'Person',
+            'name': str(article.author) if hasattr(article, 'author') else 'Unknown',
+        },
+        'publisher': {
+            '@type': 'Organization',
+            'name': SITE_NAME,
+            'logo': {'@type': 'ImageObject', 'url': f'{SITE_URL}/static/logo.png'},
+        },
+    }
+
+
+def product_schema(product) -> dict:
+    """Generate Product schema from model instance"""
+    schema = {
+        '@context': 'https://schema.org',
+        '@type': 'Product',
+        'name': product.name,
+        'description': product.description,
+        'image': product.image.url if hasattr(product, 'image') and product.image else DEFAULT_IMAGE,
+        'offers': {
+            '@type': 'Offer',
+            'price': str(product.price),
+            'priceCurrency': getattr(product, 'currency', 'USD'),
+            'availability': f"https://schema.org/{'InStock' if product.in_stock else 'OutOfStock'}",
+        },
+    }
+    
+    if hasattr(product, 'brand') and product.brand:
+        schema['brand'] = {'@type': 'Brand', 'name': product.brand}
+    
+    if hasattr(product, 'sku') and product.sku:
+        schema['sku'] = product.sku
+    
+    if hasattr(product, 'average_rating') and hasattr(product, 'review_count'):
+        if product.review_count > 0:
+            schema['aggregateRating'] = {
+                '@type': 'AggregateRating',
+                'ratingValue': product.average_rating,
+                'reviewCount': product.review_count,
+            }
+    
+    return schema
+
+
+def faq_schema(items: list[dict]) -> dict:
+    """Generate FAQ schema from list of {question, answer} dicts"""
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'FAQPage',
+        'mainEntity': [
+            {
+                '@type': 'Question',
+                'name': item['question'],
+                'acceptedAnswer': {'@type': 'Answer', 'text': item['answer']},
+            }
+            for item in items
+        ],
+    }
+
+
+def breadcrumb_schema(items: list[dict]) -> dict:
+    """Generate Breadcrumb schema from list of {name, url} dicts"""
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'BreadcrumbList',
+        'itemListElement': [
+            {
+                '@type': 'ListItem',
+                'position': i + 1,
+                'name': item['name'],
+                'item': item['url'],
+            }
+            for i, item in enumerate(items)
+        ],
+    }
+
+
+def local_business_schema(business: dict) -> dict:
+    """Generate LocalBusiness schema"""
+    schema = {
+        '@context': 'https://schema.org',
+        '@type': 'LocalBusiness',
+        'name': business['name'],
+        'description': business.get('description', ''),
+        'url': business.get('url', SITE_URL),
+        'telephone': business.get('phone'),
+        'address': {
+            '@type': 'PostalAddress',
+            'streetAddress': business.get('address', {}).get('street'),
+            'addressLocality': business.get('address', {}).get('city'),
+            'addressRegion': business.get('address', {}).get('state'),
+            'postalCode': business.get('address', {}).get('zip'),
+            'addressCountry': business.get('address', {}).get('country'),
+        },
+    }
+    
+    if business.get('coordinates'):
+        schema['geo'] = {
+            '@type': 'GeoCoordinates',
+            'latitude': business['coordinates']['lat'],
+            'longitude': business['coordinates']['lng'],
+        }
+    
+    if business.get('hours'):
+        schema['openingHours'] = business['hours']
+    
+    if business.get('price_range'):
+        schema['priceRange'] = business['price_range']
+    
+    return schema
+
+
+def render_json_ld(*schemas) -> str:
+    """Render JSON-LD script tags for templates"""
+    all_schemas = [website_schema()] + list(schemas)
+    scripts = '\\n'.join(
+        f'<script type="application/ld+json">{json.dumps(s)}</script>'
+        for s in all_schemas if s
+    )
+    return mark_safe(scripts)`,
+    explanation: `Django comprehensive SEO module with:
+\u2022 SEOMeta dataclass for structured metadata
+\u2022 SEOContextMixin for class-based views
+\u2022 Context processor for global SEO values
+\u2022 JSON-LD schema generators
+\u2022 Template-ready helpers
+
+Setup:
+1. pip install django-meta
+2. Add context processor to settings
+3. Use SEOContextMixin in views
+4. Include seo template tags in base.html`,
+    installCommands: ["pip install django-meta"],
+    additionalFiles: [
+      {
+        file: "templates/base.html",
+        code: `<!DOCTYPE html>
+<html lang="{{ LANGUAGE_CODE }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {% if seo %}
+    <!-- Primary Meta Tags -->
+    <title>{{ seo.get_full_title }}</title>
+    <meta name="title" content="{{ seo.get_full_title }}">
+    <meta name="description" content="{{ seo.description }}">
+    <meta name="robots" content="{{ seo.get_robots }}">
+    <link rel="canonical" href="{{ seo.url|default:request.build_absolute_uri }}">
+    
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" content="{{ seo.type }}">
+    <meta property="og:url" content="{{ seo.url|default:request.build_absolute_uri }}">
+    <meta property="og:title" content="{{ seo.get_full_title }}">
+    <meta property="og:description" content="{{ seo.description }}">
+    <meta property="og:image" content="{{ seo.get_image_url }}">
+    <meta property="og:image:width" content="1200">
+    <meta property="og:image:height" content="630">
+    <meta property="og:site_name" content="{{ site_name }}">
+    
+    {% if seo.type == 'article' %}
+    {% if seo.published_time %}<meta property="article:published_time" content="{{ seo.published_time }}">{% endif %}
+    {% if seo.modified_time %}<meta property="article:modified_time" content="{{ seo.modified_time }}">{% endif %}
+    {% if seo.author %}<meta property="article:author" content="{{ seo.author }}">{% endif %}
+    {% for tag in seo.tags %}<meta property="article:tag" content="{{ tag }}">{% endfor %}
+    {% endif %}
+    
+    <!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:title" content="{{ seo.get_full_title }}">
+    <meta name="twitter:description" content="{{ seo.description }}">
+    <meta name="twitter:image" content="{{ seo.get_image_url }}">
+    {% else %}
+    <title>{{ site_name }}</title>
+    {% endif %}
+    
+    {% load static %}
+    <link rel="stylesheet" href="{% static 'css/styles.css' %}">
+    
+    <!-- JSON-LD Structured Data -->
+    {% block json_ld %}{% endblock %}
+</head>
+<body>
+    {% block content %}{% endblock %}
+</body>
+</html>`,
+        explanation: "Django base template with comprehensive SEO meta tags."
+      },
+      {
+        file: "robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateLaravelSEOHelper(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "app/Services/SEOService.php",
+    code: `<?php
+
+namespace App\\Services;
+
+use Illuminate\\Support\\Facades\\View;
+use Illuminate\\Support\\HtmlString;
+
+/**
+ * Comprehensive SEO Service for Laravel
+ *
+ * Features:
+ * - Full Open Graph support
+ * - Twitter Cards
+ * - JSON-LD structured data
+ * - Canonical URLs
+ * - Blade integration
+ */
+class SEOService
+{
+    public const SITE_NAME = '${siteName}';
+    public const SITE_URL = '${siteUrl}';
+    public const DEFAULT_IMAGE = '${image || `${siteUrl}/og-image.png`}';
+    public const DEFAULT_DESCRIPTION = '${description || `${siteName} - A compelling description.`}';
+    public const TWITTER_HANDLE = '${twitterHandle || ""}';
+
+    protected array $meta = [];
+    protected array $schemas = [];
+
+    /**
+     * Set page SEO metadata
+     */
+    public function setMeta(array $options): self
+    {
+        $this->meta = array_merge([
+            'title' => null,
+            'description' => self::DEFAULT_DESCRIPTION,
+            'image' => self::DEFAULT_IMAGE,
+            'url' => request()->url(),
+            'type' => 'website',
+            'published_time' => null,
+            'modified_time' => null,
+            'author' => null,
+            'tags' => [],
+            'noindex' => false,
+            'nofollow' => false,
+        ], $options);
+
+        return $this;
+    }
+
+    /**
+     * Add JSON-LD schema
+     */
+    public function addSchema(array $schema): self
+    {
+        $this->schemas[] = $schema;
+        return $this;
+    }
+
+    /**
+     * Get full page title
+     */
+    public function getFullTitle(): string
+    {
+        $title = $this->meta['title'] ?? null;
+
+        if (!$title) {
+            return self::SITE_NAME;
+        }
+
+        if (str_contains($title, self::SITE_NAME)) {
+            return $title;
+        }
+
+        return "{$title} | " . self::SITE_NAME;
+    }
+
+    /**
+     * Get absolute image URL
+     */
+    public function getImageUrl(): string
+    {
+        $image = $this->meta['image'] ?? self::DEFAULT_IMAGE;
+
+        if (str_starts_with($image, 'http')) {
+            return $image;
+        }
+
+        return self::SITE_URL . $image;
+    }
+
+    /**
+     * Get robots directive
+     */
+    public function getRobots(): string
+    {
+        $index = ($this->meta['noindex'] ?? false) ? 'noindex' : 'index';
+        $follow = ($this->meta['nofollow'] ?? false) ? 'nofollow' : 'follow';
+        return "{$index}, {$follow}";
+    }
+
+    /**
+     * Render all meta tags
+     */
+    public function render(): HtmlString
+    {
+        $html = view('components.seo-meta', [
+            'seo' => $this,
+            'meta' => $this->meta,
+        ])->render();
+
+        return new HtmlString($html);
+    }
+
+    /**
+     * Render JSON-LD scripts
+     */
+    public function renderJsonLd(): HtmlString
+    {
+        $allSchemas = array_merge(
+            [$this->websiteSchema()],
+            $this->schemas
+        );
+
+        $scripts = collect($allSchemas)
+            ->filter()
+            ->map(fn($schema) => '<script type="application/ld+json">' . json_encode($schema) . '</script>')
+            ->implode("\\n");
+
+        return new HtmlString($scripts);
+    }
+
+    // Schema Generators
+
+    public function websiteSchema(): array
+    {
+        return [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebSite',
+            'name' => self::SITE_NAME,
+            'url' => self::SITE_URL,
+        ];
+    }
+
+    public function organizationSchema(
+        ?string $name = null,
+        ?string $url = null,
+        ?string $logo = null,
+        array $socialProfiles = []
+    ): array {
+        return array_filter([
+            '@context' => 'https://schema.org',
+            '@type' => 'Organization',
+            'name' => $name ?? self::SITE_NAME,
+            'url' => $url ?? self::SITE_URL,
+            'logo' => $logo,
+            'sameAs' => $socialProfiles ?: null,
+        ]);
+    }
+
+    public function articleSchema($article): array
+    {
+        return [
+            '@context' => 'https://schema.org',
+            '@type' => 'Article',
+            'headline' => $article->title,
+            'description' => $article->excerpt ?? substr(strip_tags($article->content), 0, 160),
+            'image' => $article->image_url ?? self::DEFAULT_IMAGE,
+            'datePublished' => optional($article->published_at)->toIso8601String(),
+            'dateModified' => optional($article->updated_at)->toIso8601String(),
+            'author' => [
+                '@type' => 'Person',
+                'name' => $article->author?->name ?? 'Unknown',
+            ],
+            'publisher' => [
+                '@type' => 'Organization',
+                'name' => self::SITE_NAME,
+                'logo' => [
+                    '@type' => 'ImageObject',
+                    'url' => self::SITE_URL . '/logo.png',
+                ],
+            ],
+        ];
+    }
+
+    public function productSchema($product): array
+    {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'Product',
+            'name' => $product->name,
+            'description' => $product->description,
+            'image' => $product->image_url ?? self::DEFAULT_IMAGE,
+            'offers' => [
+                '@type' => 'Offer',
+                'price' => (string) $product->price,
+                'priceCurrency' => $product->currency ?? 'USD',
+                'availability' => 'https://schema.org/' . ($product->in_stock ? 'InStock' : 'OutOfStock'),
+            ],
+        ];
+
+        if ($product->brand) {
+            $schema['brand'] = ['@type' => 'Brand', 'name' => $product->brand];
+        }
+
+        if ($product->sku) {
+            $schema['sku'] = $product->sku;
+        }
+
+        if ($product->reviews_count > 0) {
+            $schema['aggregateRating'] = [
+                '@type' => 'AggregateRating',
+                'ratingValue' => $product->average_rating,
+                'reviewCount' => $product->reviews_count,
+            ];
+        }
+
+        return $schema;
+    }
+
+    public function faqSchema(array $items): array
+    {
+        return [
+            '@context' => 'https://schema.org',
+            '@type' => 'FAQPage',
+            'mainEntity' => collect($items)->map(fn($item) => [
+                '@type' => 'Question',
+                'name' => $item['question'],
+                'acceptedAnswer' => ['@type' => 'Answer', 'text' => $item['answer']],
+            ])->all(),
+        ];
+    }
+
+    public function breadcrumbSchema(array $items): array
+    {
+        return [
+            '@context' => 'https://schema.org',
+            '@type' => 'BreadcrumbList',
+            'itemListElement' => collect($items)->map(fn($item, $index) => [
+                '@type' => 'ListItem',
+                'position' => $index + 1,
+                'name' => $item['name'],
+                'item' => $item['url'],
+            ])->all(),
+        ];
+    }
+
+    public function localBusinessSchema(array $business): array
+    {
+        return array_filter([
+            '@context' => 'https://schema.org',
+            '@type' => 'LocalBusiness',
+            'name' => $business['name'],
+            'description' => $business['description'] ?? null,
+            'url' => $business['url'] ?? self::SITE_URL,
+            'telephone' => $business['phone'] ?? null,
+            'address' => [
+                '@type' => 'PostalAddress',
+                'streetAddress' => $business['address']['street'] ?? null,
+                'addressLocality' => $business['address']['city'] ?? null,
+                'addressRegion' => $business['address']['state'] ?? null,
+                'postalCode' => $business['address']['zip'] ?? null,
+                'addressCountry' => $business['address']['country'] ?? null,
+            ],
+            'geo' => isset($business['coordinates']) ? [
+                '@type' => 'GeoCoordinates',
+                'latitude' => $business['coordinates']['lat'],
+                'longitude' => $business['coordinates']['lng'],
+            ] : null,
+            'openingHours' => $business['hours'] ?? null,
+            'priceRange' => $business['price_range'] ?? null,
+        ]);
+    }
+}`,
+    explanation: `Laravel comprehensive SEO service with:
+\u2022 Fluent API for setting metadata
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schema generators
+\u2022 Blade component integration
+
+Setup:
+1. Register SEOService in AppServiceProvider
+2. Use @seo directive in Blade templates
+3. Call SEO()->setMeta() in controllers`,
+    additionalFiles: [
+      {
+        file: "resources/views/components/seo-meta.blade.php",
+        code: `{{-- Primary Meta Tags --}}
+<title>{{ $seo->getFullTitle() }}</title>
+<meta name="title" content="{{ $seo->getFullTitle() }}">
+<meta name="description" content="{{ $meta['description'] }}">
+<meta name="robots" content="{{ $seo->getRobots() }}">
+<link rel="canonical" href="{{ $meta['url'] }}">
+
+{{-- Open Graph / Facebook --}}
+<meta property="og:type" content="{{ $meta['type'] }}">
+<meta property="og:url" content="{{ $meta['url'] }}">
+<meta property="og:title" content="{{ $seo->getFullTitle() }}">
+<meta property="og:description" content="{{ $meta['description'] }}">
+<meta property="og:image" content="{{ $seo->getImageUrl() }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="{{ $seo::SITE_NAME }}">
+
+@if($meta['type'] === 'article')
+    @if($meta['published_time'])
+    <meta property="article:published_time" content="{{ $meta['published_time'] }}">
+    @endif
+    @if($meta['modified_time'])
+    <meta property="article:modified_time" content="{{ $meta['modified_time'] }}">
+    @endif
+    @if($meta['author'])
+    <meta property="article:author" content="{{ $meta['author'] }}">
+    @endif
+    @foreach($meta['tags'] as $tag)
+    <meta property="article:tag" content="{{ $tag }}">
+    @endforeach
+@endif
+
+{{-- Twitter --}}
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ $seo->getFullTitle() }}">
+<meta name="twitter:description" content="{{ $meta['description'] }}">
+<meta name="twitter:image" content="{{ $seo->getImageUrl() }}">
+@if($seo::TWITTER_HANDLE)
+<meta name="twitter:site" content="{{ $seo::TWITTER_HANDLE }}">
+<meta name="twitter:creator" content="{{ $seo::TWITTER_HANDLE }}">
+@endif`,
+        explanation: "Blade component for rendering SEO meta tags."
+      },
+      {
+        file: "resources/views/layouts/app.blade.php",
+        code: `<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    
+    {{-- SEO Meta Tags --}}
+    {!! SEO()->render() !!}
+    
+    {{-- Favicon --}}
+    <link rel="icon" href="/favicon.ico">
+    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+    
+    {{-- Styles --}}
+    @vite(['resources/css/app.css', 'resources/js/app.js'])
+    
+    {{-- JSON-LD --}}
+    {!! SEO()->renderJsonLd() !!}
+</head>
+<body>
+    @yield('content')
+</body>
+</html>`,
+        explanation: "Laravel layout with SEO integration."
+      },
+      {
+        file: "app/Providers/AppServiceProvider.php",
+        code: `<?php
+
+namespace App\\Providers;
+
+use App\\Services\\SEOService;
+use Illuminate\\Support\\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->singleton(SEOService::class);
+    }
+
+    public function boot(): void
+    {
+        // Global SEO helper
+        if (!function_exists('SEO')) {
+            function SEO(): SEOService {
+                return app(SEOService::class);
+            }
+        }
+    }
+}`,
+        explanation: "Service provider registration."
+      },
+      {
+        file: "public/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateSpringBootSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "src/main/java/com/example/seo/SEOService.java",
+    code: `package com.example.seo;
+
+import org.springframework.stereotype.Service;
+import java.util.*;
+
+/**
+ * Comprehensive SEO Service for Spring Boot
+ *
+ * Features:
+ * - Full Open Graph support
+ * - Twitter Cards
+ * - JSON-LD structured data
+ * - Thymeleaf integration
+ */
+@Service
+public class SEOService {
+
+    public static final String SITE_NAME = "${siteName}";
+    public static final String SITE_URL = "${siteUrl}";
+    public static final String DEFAULT_IMAGE = "${image || `${siteUrl}/og-image.png`}";
+    public static final String DEFAULT_DESCRIPTION = "${description || `${siteName} - A compelling description.`}";
+    public static final String TWITTER_HANDLE = "${twitterHandle || ""}";
+
+    /**
+     * Build SEO metadata for a page
+     */
+    public SEOMeta buildMeta(String title, String description, String image, String type) {
+        return SEOMeta.builder()
+                .title(title)
+                .description(description != null ? description : DEFAULT_DESCRIPTION)
+                .image(image != null ? image : DEFAULT_IMAGE)
+                .type(type != null ? type : "website")
+                .build();
+    }
+
+    /**
+     * Get full page title with site name
+     */
+    public String getFullTitle(String title) {
+        if (title == null || title.isEmpty()) {
+            return SITE_NAME;
+        }
+        if (title.contains(SITE_NAME)) {
+            return title;
+        }
+        return title + " | " + SITE_NAME;
+    }
+
+    /**
+     * Get absolute image URL
+     */
+    public String getAbsoluteImageUrl(String image) {
+        if (image == null) {
+            return DEFAULT_IMAGE;
+        }
+        if (image.startsWith("http")) {
+            return image;
+        }
+        return SITE_URL + image;
+    }
+
+    // JSON-LD Schema Generators
+
+    public Map<String, Object> websiteSchema() {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "WebSite");
+        schema.put("name", SITE_NAME);
+        schema.put("url", SITE_URL);
+        return schema;
+    }
+
+    public Map<String, Object> organizationSchema(String name, String url, String logo, List<String> socialProfiles) {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "Organization");
+        schema.put("name", name != null ? name : SITE_NAME);
+        schema.put("url", url != null ? url : SITE_URL);
+        if (logo != null) schema.put("logo", logo);
+        if (socialProfiles != null && !socialProfiles.isEmpty()) {
+            schema.put("sameAs", socialProfiles);
+        }
+        return schema;
+    }
+
+    public Map<String, Object> articleSchema(
+            String headline,
+            String description,
+            String image,
+            String datePublished,
+            String dateModified,
+            String authorName
+    ) {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "Article");
+        schema.put("headline", headline);
+        schema.put("description", description);
+        schema.put("image", image != null ? image : DEFAULT_IMAGE);
+        schema.put("datePublished", datePublished);
+        schema.put("dateModified", dateModified != null ? dateModified : datePublished);
+
+        Map<String, Object> author = new LinkedHashMap<>();
+        author.put("@type", "Person");
+        author.put("name", authorName);
+        schema.put("author", author);
+
+        Map<String, Object> publisher = new LinkedHashMap<>();
+        publisher.put("@type", "Organization");
+        publisher.put("name", SITE_NAME);
+        Map<String, Object> logo = new LinkedHashMap<>();
+        logo.put("@type", "ImageObject");
+        logo.put("url", SITE_URL + "/logo.png");
+        publisher.put("logo", logo);
+        schema.put("publisher", publisher);
+
+        return schema;
+    }
+
+    public Map<String, Object> productSchema(
+            String name,
+            String description,
+            String image,
+            String price,
+            String currency,
+            boolean inStock
+    ) {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "Product");
+        schema.put("name", name);
+        schema.put("description", description);
+        schema.put("image", image);
+
+        Map<String, Object> offers = new LinkedHashMap<>();
+        offers.put("@type", "Offer");
+        offers.put("price", price);
+        offers.put("priceCurrency", currency != null ? currency : "USD");
+        offers.put("availability", "https://schema.org/" + (inStock ? "InStock" : "OutOfStock"));
+        schema.put("offers", offers);
+
+        return schema;
+    }
+
+    public Map<String, Object> faqSchema(List<Map<String, String>> items) {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "FAQPage");
+
+        List<Map<String, Object>> mainEntity = new ArrayList<>();
+        for (Map<String, String> item : items) {
+            Map<String, Object> question = new LinkedHashMap<>();
+            question.put("@type", "Question");
+            question.put("name", item.get("question"));
+
+            Map<String, Object> answer = new LinkedHashMap<>();
+            answer.put("@type", "Answer");
+            answer.put("text", item.get("answer"));
+            question.put("acceptedAnswer", answer);
+
+            mainEntity.add(question);
+        }
+        schema.put("mainEntity", mainEntity);
+
+        return schema;
+    }
+
+    public Map<String, Object> breadcrumbSchema(List<Map<String, String>> items) {
+        Map<String, Object> schema = new LinkedHashMap<>();
+        schema.put("@context", "https://schema.org");
+        schema.put("@type", "BreadcrumbList");
+
+        List<Map<String, Object>> itemList = new ArrayList<>();
+        for (int i = 0; i < items.size(); i++) {
+            Map<String, String> item = items.get(i);
+            Map<String, Object> listItem = new LinkedHashMap<>();
+            listItem.put("@type", "ListItem");
+            listItem.put("position", i + 1);
+            listItem.put("name", item.get("name"));
+            listItem.put("item", item.get("url"));
+            itemList.add(listItem);
+        }
+        schema.put("itemListElement", itemList);
+
+        return schema;
+    }
+}`,
+    explanation: `Spring Boot comprehensive SEO service with:
+\u2022 Full Open Graph support
+\u2022 Twitter Cards
+\u2022 JSON-LD schema generators
+\u2022 Thymeleaf integration
+
+Setup:
+1. Add SEOService to your controllers
+2. Pass SEOMeta to model
+3. Use Thymeleaf fragments in templates`,
+    additionalFiles: [
+      {
+        file: "src/main/java/com/example/seo/SEOMeta.java",
+        code: `package com.example.seo;
+
+import lombok.Builder;
+import lombok.Data;
+import java.util.List;
+
+@Data
+@Builder
+public class SEOMeta {
+    private String title;
+    private String description;
+    private String image;
+    private String url;
+    private String type;
+    
+    // Article specific
+    private String publishedTime;
+    private String modifiedTime;
+    private String author;
+    private List<String> tags;
+    
+    // Robots
+    @Builder.Default
+    private boolean noindex = false;
+    @Builder.Default
+    private boolean nofollow = false;
+    
+    public String getFullTitle() {
+        if (title == null || title.isEmpty()) {
+            return SEOService.SITE_NAME;
+        }
+        if (title.contains(SEOService.SITE_NAME)) {
+            return title;
+        }
+        return title + " | " + SEOService.SITE_NAME;
+    }
+    
+    public String getImageUrl() {
+        if (image == null) {
+            return SEOService.DEFAULT_IMAGE;
+        }
+        if (image.startsWith("http")) {
+            return image;
+        }
+        return SEOService.SITE_URL + image;
+    }
+    
+    public String getRobots() {
+        String index = noindex ? "noindex" : "index";
+        String follow = nofollow ? "nofollow" : "follow";
+        return index + ", " + follow;
+    }
+}`,
+        explanation: "SEO metadata DTO with Lombok."
+      },
+      {
+        file: "src/main/resources/templates/fragments/seo.html",
+        code: `<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org">
+<head th:fragment="meta(seo)">
+    <!-- Primary Meta Tags -->
+    <title th:text="\${seo.getFullTitle()}">Page Title</title>
+    <meta name="title" th:content="\${seo.getFullTitle()}">
+    <meta name="description" th:content="\${seo.description}">
+    <meta name="robots" th:content="\${seo.getRobots()}">
+    <link rel="canonical" th:href="\${seo.url}">
+    
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" th:content="\${seo.type}">
+    <meta property="og:url" th:content="\${seo.url}">
+    <meta property="og:title" th:content="\${seo.getFullTitle()}">
+    <meta property="og:description" th:content="\${seo.description}">
+    <meta property="og:image" th:content="\${seo.getImageUrl()}">
+    <meta property="og:image:width" content="1200">
+    <meta property="og:image:height" content="630">
+    <meta property="og:site_name" th:content="@{${siteName}}">
+    
+    <th:block th:if="\${seo.type == 'article'}">
+        <meta th:if="\${seo.publishedTime}" property="article:published_time" th:content="\${seo.publishedTime}">
+        <meta th:if="\${seo.modifiedTime}" property="article:modified_time" th:content="\${seo.modifiedTime}">
+        <meta th:if="\${seo.author}" property="article:author" th:content="\${seo.author}">
+        <meta th:each="tag : \${seo.tags}" property="article:tag" th:content="\${tag}">
+    </th:block>
+    
+    <!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:title" th:content="\${seo.getFullTitle()}">
+    <meta name="twitter:description" th:content="\${seo.description}">
+    <meta name="twitter:image" th:content="\${seo.getImageUrl()}">
+    <meta th:if="${twitterHandle}" name="twitter:site" content="${twitterHandle}">
+</head>
+</html>`,
+        explanation: "Thymeleaf fragment for SEO meta tags."
+      },
+      {
+        file: "src/main/resources/templates/layout/base.html",
+        code: `<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org" th:lang="\${#locale.language}">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    
+    <!-- SEO Meta Tags -->
+    <th:block th:replace="~{fragments/seo :: meta(seo=\${seo})}"></th:block>
+    
+    <!-- Favicon -->
+    <link rel="icon" type="image/x-icon" href="/favicon.ico">
+    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+    
+    <!-- Styles -->
+    <link rel="stylesheet" th:href="@{/css/styles.css}">
+    
+    <!-- JSON-LD -->
+    <script th:if="\${jsonLd}" type="application/ld+json" th:utext="\${jsonLd}"></script>
+</head>
+<body>
+    <div th:replace="~{:: content}"></div>
+</body>
+</html>`,
+        explanation: "Base layout with SEO integration."
+      },
+      {
+        file: "src/main/resources/static/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generatePhoenixSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "lib/my_app_web/components/seo.ex",
+    code: `defmodule MyAppWeb.Components.SEO do
+  @moduledoc """
+  Comprehensive SEO components for Phoenix
+
+  Features:
+  - Full Open Graph support
+  - Twitter Cards
+  - JSON-LD structured data
+  - HEEx integration
+  """
+
+  use Phoenix.Component
+
+  @site_name "${siteName}"
+  @site_url "${siteUrl}"
+  @default_image "${image || `${siteUrl}/og-image.png`}"
+  @default_description "${description || `${siteName} - A compelling description.`}"
+  @twitter_handle "${twitterHandle || ""}"
+
+  def site_name, do: @site_name
+  def site_url, do: @site_url
+
+  @doc """
+  SEO meta tags component
+
+  ## Examples
+
+      <.seo_meta
+        title="Page Title"
+        description="Page description"
+        type="article"
+        published_time={@article.published_at}
+      />
+  """
+  attr :title, :string, default: nil
+  attr :description, :string, default: @default_description
+  attr :image, :string, default: @default_image
+  attr :url, :string, default: nil
+  attr :type, :string, default: "website"
+  attr :published_time, :any, default: nil
+  attr :modified_time, :any, default: nil
+  attr :author, :string, default: nil
+  attr :tags, :list, default: []
+  attr :noindex, :boolean, default: false
+  attr :nofollow, :boolean, default: false
+
+  def seo_meta(assigns) do
+    assigns =
+      assigns
+      |> assign(:full_title, get_full_title(assigns.title))
+      |> assign(:image_url, get_absolute_url(assigns.image))
+      |> assign(:canonical_url, assigns.url || @site_url)
+      |> assign(:robots, get_robots(assigns.noindex, assigns.nofollow))
+
+    ~H"""
+    <!-- Primary Meta Tags -->
+    <title><%= @full_title %></title>
+    <meta name="title" content={@full_title}>
+    <meta name="description" content={@description}>
+    <meta name="robots" content={@robots}>
+    <link rel="canonical" href={@canonical_url}>
+
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" content={@type}>
+    <meta property="og:url" content={@canonical_url}>
+    <meta property="og:title" content={@full_title}>
+    <meta property="og:description" content={@description}>
+    <meta property="og:image" content={@image_url}>
+    <meta property="og:image:width" content="1200">
+    <meta property="og:image:height" content="630">
+    <meta property="og:site_name" content={@site_name}>
+
+    <%= if @type == "article" do %>
+      <%= if @published_time do %>
+        <meta property="article:published_time" content={format_datetime(@published_time)}>
+      <% end %>
+      <%= if @modified_time do %>
+        <meta property="article:modified_time" content={format_datetime(@modified_time)}>
+      <% end %>
+      <%= if @author do %>
+        <meta property="article:author" content={@author}>
+      <% end %>
+      <%= for tag <- @tags do %>
+        <meta property="article:tag" content={tag}>
+      <% end %>
+    <% end %>
+
+    <!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:title" content={@full_title}>
+    <meta name="twitter:description" content={@description}>
+    <meta name="twitter:image" content={@image_url}>
+    <%= if @twitter_handle != "" do %>
+      <meta name="twitter:site" content={@twitter_handle}>
+      <meta name="twitter:creator" content={@twitter_handle}>
+    <% end %>
+    """
+  end
+
+  @doc """
+  JSON-LD structured data component
+  """
+  attr :schemas, :list, required: true
+
+  def json_ld(assigns) do
+    all_schemas = [website_schema() | assigns.schemas]
+
+    ~H"""
+    <%= for schema <- @all_schemas do %>
+      <script type="application/ld+json">
+        <%= raw(Jason.encode!(schema)) %>
+      </script>
+    <% end %>
+    """
+  end
+
+  # Schema generators
+
+  def website_schema do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "WebSite",
+      "name" => @site_name,
+      "url" => @site_url
+    }
+  end
+
+  def organization_schema(opts \\\\ []) do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "Organization",
+      "name" => opts[:name] || @site_name,
+      "url" => opts[:url] || @site_url
+    }
+    |> maybe_put("logo", opts[:logo])
+    |> maybe_put("sameAs", opts[:social_profiles])
+  end
+
+  def article_schema(article) do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "Article",
+      "headline" => article.title,
+      "description" => article.excerpt || String.slice(article.content, 0, 160),
+      "image" => article.image_url || @default_image,
+      "datePublished" => format_datetime(article.published_at),
+      "dateModified" => format_datetime(article.updated_at || article.published_at),
+      "author" => %{
+        "@type" => "Person",
+        "name" => article.author_name || "Unknown"
+      },
+      "publisher" => %{
+        "@type" => "Organization",
+        "name" => @site_name,
+        "logo" => %{"@type" => "ImageObject", "url" => "#{@site_url}/logo.png"}
+      }
+    }
+  end
+
+  def product_schema(product) do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "Product",
+      "name" => product.name,
+      "description" => product.description,
+      "image" => product.image_url || @default_image,
+      "offers" => %{
+        "@type" => "Offer",
+        "price" => to_string(product.price),
+        "priceCurrency" => product.currency || "USD",
+        "availability" => "https://schema.org/#{if product.in_stock, do: "InStock", else: "OutOfStock"}"
+      }
+    }
+    |> maybe_put("brand", product.brand && %{"@type" => "Brand", "name" => product.brand})
+    |> maybe_put("sku", product.sku)
+  end
+
+  def faq_schema(items) do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "FAQPage",
+      "mainEntity" =>
+        Enum.map(items, fn item ->
+          %{
+            "@type" => "Question",
+            "name" => item.question,
+            "acceptedAnswer" => %{"@type" => "Answer", "text" => item.answer}
+          }
+        end)
+    }
+  end
+
+  def breadcrumb_schema(items) do
+    %{
+      "@context" => "https://schema.org",
+      "@type" => "BreadcrumbList",
+      "itemListElement" =>
+        items
+        |> Enum.with_index(1)
+        |> Enum.map(fn {item, position} ->
+          %{
+            "@type" => "ListItem",
+            "position" => position,
+            "name" => item.name,
+            "item" => item.url
+          }
+        end)
+    }
+  end
+
+  # Helpers
+
+  defp get_full_title(nil), do: @site_name
+  defp get_full_title(title) when is_binary(title) do
+    if String.contains?(title, @site_name), do: title, else: "#{title} | #{@site_name}"
+  end
+
+  defp get_absolute_url(nil), do: @default_image
+  defp get_absolute_url(url) when is_binary(url) do
+    if String.starts_with?(url, "http"), do: url, else: @site_url <> url
+  end
+
+  defp get_robots(noindex, nofollow) do
+    index = if noindex, do: "noindex", else: "index"
+    follow = if nofollow, do: "nofollow", else: "follow"
+    "#{index}, #{follow}"
+  end
+
+  defp format_datetime(nil), do: nil
+  defp format_datetime(%DateTime{} = dt), do: DateTime.to_iso8601(dt)
+  defp format_datetime(%NaiveDateTime{} = dt), do: NaiveDateTime.to_iso8601(dt)
+  defp format_datetime(dt) when is_binary(dt), do: dt
+
+  defp maybe_put(map, _key, nil), do: map
+  defp maybe_put(map, _key, []), do: map
+  defp maybe_put(map, key, value), do: Map.put(map, key, value)
+end`,
+    explanation: `Phoenix/Elixir comprehensive SEO module with:
+\u2022 HEEx function components
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schema generators
+\u2022 Elixir-idiomatic API
+
+Setup:
+1. Import in your components module
+2. Use <.seo_meta> in layouts
+3. Add <.json_ld schemas={[@article_schema]} />`,
+    additionalFiles: [
+      {
+        file: "lib/my_app_web/components/layouts/root.html.heex",
+        code: `<!DOCTYPE html>
+<html lang={@locale || "en"}>
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="csrf-token" content={get_csrf_token()}>
+    
+    <.seo_meta
+      title={assigns[:page_title]}
+      description={assigns[:page_description]}
+      image={assigns[:page_image]}
+      type={assigns[:page_type] || "website"}
+    />
+    
+    <link rel="icon" href="/favicon.ico">
+    <link phx-track-static rel="stylesheet" href={~p"/assets/app.css"}>
+    <script defer phx-track-static src={~p"/assets/app.js"}></script>
+    
+    <%= if assigns[:json_ld_schemas] do %>
+      <.json_ld schemas={@json_ld_schemas} />
+    <% end %>
+  </head>
+  <body>
+    <%= @inner_content %>
+  </body>
+</html>`,
+        explanation: "Phoenix root layout with SEO components."
+      },
+      {
+        file: "priv/static/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateGoSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "internal/seo/seo.go",
+    code: `package seo
+
+import (
+	"encoding/json"
+	"html/template"
+	"strings"
+	"time"
+)
+
+// Configuration
+const (
+	SiteName           = "${siteName}"
+	SiteURL            = "${siteUrl}"
+	DefaultImage       = "${image || `${siteUrl}/og-image.png`}"
+	DefaultDescription = "${description || `${siteName} - A compelling description.`}"
+	TwitterHandle      = "${twitterHandle || ""}"
+)
+
+// Meta contains SEO metadata for a page
+type Meta struct {
+	Title         string
+	Description   string
+	Image         string
+	URL           string
+	Type          string // website, article, product
+	PublishedTime *time.Time
+	ModifiedTime  *time.Time
+	Author        string
+	Tags          []string
+	NoIndex       bool
+	NoFollow      bool
+}
+
+// NewMeta creates a Meta with defaults
+func NewMeta() *Meta {
+	return &Meta{
+		Description: DefaultDescription,
+		Image:       DefaultImage,
+		Type:        "website",
+	}
+}
+
+// FullTitle returns the title with site name
+func (m *Meta) FullTitle() string {
+	if m.Title == "" {
+		return SiteName
+	}
+	if strings.Contains(m.Title, SiteName) {
+		return m.Title
+	}
+	return m.Title + " | " + SiteName
+}
+
+// AbsoluteImageURL returns the absolute image URL
+func (m *Meta) AbsoluteImageURL() string {
+	if m.Image == "" {
+		return DefaultImage
+	}
+	if strings.HasPrefix(m.Image, "http") {
+		return m.Image
+	}
+	return SiteURL + m.Image
+}
+
+// Robots returns the robots meta content
+func (m *Meta) Robots() string {
+	index := "index"
+	if m.NoIndex {
+		index = "noindex"
+	}
+	follow := "follow"
+	if m.NoFollow {
+		follow = "nofollow"
+	}
+	return index + ", " + follow
+}
+
+// Schema types for JSON-LD
+
+type Schema map[string]interface{}
+
+// WebsiteSchema returns the default website schema
+func WebsiteSchema() Schema {
+	return Schema{
+		"@context": "https://schema.org",
+		"@type":    "WebSite",
+		"name":     SiteName,
+		"url":      SiteURL,
+	}
+}
+
+// OrganizationSchema creates an organization schema
+func OrganizationSchema(name, url, logo string, socialProfiles []string) Schema {
+	schema := Schema{
+		"@context": "https://schema.org",
+		"@type":    "Organization",
+		"name":     name,
+		"url":      url,
+	}
+	if logo != "" {
+		schema["logo"] = logo
+	}
+	if len(socialProfiles) > 0 {
+		schema["sameAs"] = socialProfiles
+	}
+	return schema
+}
+
+// ArticleSchema creates an article schema
+func ArticleSchema(headline, description, image string, datePublished, dateModified time.Time, authorName string) Schema {
+	return Schema{
+		"@context":      "https://schema.org",
+		"@type":         "Article",
+		"headline":      headline,
+		"description":   description,
+		"image":         image,
+		"datePublished": datePublished.Format(time.RFC3339),
+		"dateModified":  dateModified.Format(time.RFC3339),
+		"author": Schema{
+			"@type": "Person",
+			"name":  authorName,
+		},
+		"publisher": Schema{
+			"@type": "Organization",
+			"name":  SiteName,
+			"logo": Schema{
+				"@type": "ImageObject",
+				"url":   SiteURL + "/logo.png",
+			},
+		},
+	}
+}
+
+// ProductSchema creates a product schema
+func ProductSchema(name, description, image, price, currency string, inStock bool) Schema {
+	availability := "https://schema.org/InStock"
+	if !inStock {
+		availability = "https://schema.org/OutOfStock"
+	}
+
+	return Schema{
+		"@context":    "https://schema.org",
+		"@type":       "Product",
+		"name":        name,
+		"description": description,
+		"image":       image,
+		"offers": Schema{
+			"@type":         "Offer",
+			"price":         price,
+			"priceCurrency": currency,
+			"availability":  availability,
+		},
+	}
+}
+
+// FAQItem represents a single FAQ entry
+type FAQItem struct {
+	Question string
+	Answer   string
+}
+
+// FAQSchema creates a FAQ schema
+func FAQSchema(items []FAQItem) Schema {
+	mainEntity := make([]Schema, len(items))
+	for i, item := range items {
+		mainEntity[i] = Schema{
+			"@type": "Question",
+			"name":  item.Question,
+			"acceptedAnswer": Schema{
+				"@type": "Answer",
+				"text":  item.Answer,
+			},
+		}
+	}
+	return Schema{
+		"@context":   "https://schema.org",
+		"@type":      "FAQPage",
+		"mainEntity": mainEntity,
+	}
+}
+
+// BreadcrumbItem represents a breadcrumb entry
+type BreadcrumbItem struct {
+	Name string
+	URL  string
+}
+
+// BreadcrumbSchema creates a breadcrumb schema
+func BreadcrumbSchema(items []BreadcrumbItem) Schema {
+	itemList := make([]Schema, len(items))
+	for i, item := range items {
+		itemList[i] = Schema{
+			"@type":    "ListItem",
+			"position": i + 1,
+			"name":     item.Name,
+			"item":     item.URL,
+		}
+	}
+	return Schema{
+		"@context":        "https://schema.org",
+		"@type":           "BreadcrumbList",
+		"itemListElement": itemList,
+	}
+}
+
+// ToJSON converts a schema to JSON string
+func (s Schema) ToJSON() template.JS {
+	b, err := json.Marshal(s)
+	if err != nil {
+		return ""
+	}
+	return template.JS(b)
+}
+
+// RenderJSONLD renders multiple schemas as script tags
+func RenderJSONLD(schemas ...Schema) template.HTML {
+	all := append([]Schema{WebsiteSchema()}, schemas...)
+	var sb strings.Builder
+	for _, schema := range all {
+		b, err := json.Marshal(schema)
+		if err != nil {
+			continue
+		}
+		sb.WriteString(\`<script type="application/ld+json">\`)
+		sb.Write(b)
+		sb.WriteString(\`</script>\\n\`)
+	}
+	return template.HTML(sb.String())
+}`,
+    explanation: `Go comprehensive SEO package with:
+\u2022 Meta struct for page metadata
+\u2022 JSON-LD schema generators
+\u2022 Template-friendly helpers
+\u2022 Works with Gin, Echo, Fiber, or stdlib
+
+Setup:
+1. Import in your handlers
+2. Pass Meta to templates
+3. Use schema helpers for JSON-LD`,
+    additionalFiles: [
+      {
+        file: "templates/partials/seo.html",
+        code: `{{define "seo"}}
+<!-- Primary Meta Tags -->
+<title>{{.SEO.FullTitle}}</title>
+<meta name="title" content="{{.SEO.FullTitle}}">
+<meta name="description" content="{{.SEO.Description}}">
+<meta name="robots" content="{{.SEO.Robots}}">
+<link rel="canonical" href="{{.SEO.URL}}">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="{{.SEO.Type}}">
+<meta property="og:url" content="{{.SEO.URL}}">
+<meta property="og:title" content="{{.SEO.FullTitle}}">
+<meta property="og:description" content="{{.SEO.Description}}">
+<meta property="og:image" content="{{.SEO.AbsoluteImageURL}}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="${siteName}">
+
+{{if eq .SEO.Type "article"}}
+    {{if .SEO.PublishedTime}}
+    <meta property="article:published_time" content="{{.SEO.PublishedTime.Format "2006-01-02T15:04:05Z07:00"}}">
+    {{end}}
+    {{if .SEO.ModifiedTime}}
+    <meta property="article:modified_time" content="{{.SEO.ModifiedTime.Format "2006-01-02T15:04:05Z07:00"}}">
+    {{end}}
+    {{if .SEO.Author}}
+    <meta property="article:author" content="{{.SEO.Author}}">
+    {{end}}
+    {{range .SEO.Tags}}
+    <meta property="article:tag" content="{{.}}">
+    {{end}}
+{{end}}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{.SEO.FullTitle}}">
+<meta name="twitter:description" content="{{.SEO.Description}}">
+<meta name="twitter:image" content="{{.SEO.AbsoluteImageURL}}">
+{{if ne "${twitterHandle}" ""}}
+<meta name="twitter:site" content="${twitterHandle}">
+<meta name="twitter:creator" content="${twitterHandle}">
+{{end}}
+{{end}}`,
+        explanation: "Go html/template partial for SEO meta tags."
+      },
+      {
+        file: "templates/layouts/base.html",
+        code: `<!DOCTYPE html>
+<html lang="{{.Lang}}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {{template "seo" .}}
+    
+    <link rel="icon" href="/static/favicon.ico">
+    <link rel="stylesheet" href="/static/css/styles.css">
+    
+    {{if .JSONLDSchemas}}
+    {{.JSONLDSchemas}}
+    {{end}}
+</head>
+<body>
+    {{template "content" .}}
+</body>
+</html>`,
+        explanation: "Go base template layout."
+      },
+      {
+        file: "static/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateAspNetCoreSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "Services/SEOService.cs",
+    code: `using System.Text.Json;
+
+namespace MyApp.Services;
+
+/// <summary>
+/// Comprehensive SEO Service for ASP.NET Core
+/// 
+/// Features:
+/// - Full Open Graph support
+/// - Twitter Cards
+/// - JSON-LD structured data
+/// - Razor integration
+/// </summary>
+public class SEOService
+{
+    public const string SiteName = "${siteName}";
+    public const string SiteUrl = "${siteUrl}";
+    public const string DefaultImage = "${image || `${siteUrl}/og-image.png`}";
+    public const string DefaultDescription = "${description || `${siteName} - A compelling description.`}";
+    public const string TwitterHandle = "${twitterHandle || ""}";
+
+    /// <summary>
+    /// Create SEO metadata for a page
+    /// </summary>
+    public SEOMeta CreateMeta(
+        string? title = null,
+        string? description = null,
+        string? image = null,
+        string? type = "website")
+    {
+        return new SEOMeta
+        {
+            Title = title,
+            Description = description ?? DefaultDescription,
+            Image = image ?? DefaultImage,
+            Type = type ?? "website"
+        };
+    }
+
+    // JSON-LD Schema Generators
+
+    public object WebsiteSchema() => new
+    {
+        @context = "https://schema.org",
+        @type = "WebSite",
+        name = SiteName,
+        url = SiteUrl
+    };
+
+    public object OrganizationSchema(
+        string? name = null,
+        string? url = null,
+        string? logo = null,
+        string[]? socialProfiles = null) => new
+    {
+        @context = "https://schema.org",
+        @type = "Organization",
+        name = name ?? SiteName,
+        url = url ?? SiteUrl,
+        logo,
+        sameAs = socialProfiles
+    };
+
+    public object ArticleSchema(
+        string headline,
+        string description,
+        string? image,
+        DateTime datePublished,
+        DateTime? dateModified,
+        string authorName) => new
+    {
+        @context = "https://schema.org",
+        @type = "Article",
+        headline,
+        description,
+        image = image ?? DefaultImage,
+        datePublished = datePublished.ToString("O"),
+        dateModified = (dateModified ?? datePublished).ToString("O"),
+        author = new { @type = "Person", name = authorName },
+        publisher = new
+        {
+            @type = "Organization",
+            name = SiteName,
+            logo = new { @type = "ImageObject", url = SiteUrl + "/logo.png" }
+        }
+    };
+
+    public object ProductSchema(
+        string name,
+        string description,
+        string? image,
+        decimal price,
+        string currency = "USD",
+        bool inStock = true) => new
+    {
+        @context = "https://schema.org",
+        @type = "Product",
+        name,
+        description,
+        image = image ?? DefaultImage,
+        offers = new
+        {
+            @type = "Offer",
+            price = price.ToString("F2"),
+            priceCurrency = currency,
+            availability = $"https://schema.org/{(inStock ? "InStock" : "OutOfStock")}"
+        }
+    };
+
+    public object FAQSchema(IEnumerable<(string Question, string Answer)> items) => new
+    {
+        @context = "https://schema.org",
+        @type = "FAQPage",
+        mainEntity = items.Select(item => new
+        {
+            @type = "Question",
+            name = item.Question,
+            acceptedAnswer = new { @type = "Answer", text = item.Answer }
+        })
+    };
+
+    public object BreadcrumbSchema(IEnumerable<(string Name, string Url)> items) => new
+    {
+        @context = "https://schema.org",
+        @type = "BreadcrumbList",
+        itemListElement = items.Select((item, index) => new
+        {
+            @type = "ListItem",
+            position = index + 1,
+            name = item.Name,
+            item = item.Url
+        })
+    };
+
+    /// <summary>
+    /// Serialize schema to JSON for embedding in HTML
+    /// </summary>
+    public string ToJson(object schema)
+    {
+        return JsonSerializer.Serialize(schema, new JsonSerializerOptions
+        {
+            WriteIndented = false,
+            PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+        });
+    }
+}
+
+public class SEOMeta
+{
+    public string? Title { get; set; }
+    public string Description { get; set; } = SEOService.DefaultDescription;
+    public string Image { get; set; } = SEOService.DefaultImage;
+    public string? Url { get; set; }
+    public string Type { get; set; } = "website";
+    public DateTime? PublishedTime { get; set; }
+    public DateTime? ModifiedTime { get; set; }
+    public string? Author { get; set; }
+    public List<string> Tags { get; set; } = new();
+    public bool NoIndex { get; set; }
+    public bool NoFollow { get; set; }
+
+    public string FullTitle => string.IsNullOrEmpty(Title)
+        ? SEOService.SiteName
+        : Title.Contains(SEOService.SiteName)
+            ? Title
+            : $"{Title} | {SEOService.SiteName}";
+
+    public string AbsoluteImageUrl => Image.StartsWith("http")
+        ? Image
+        : SEOService.SiteUrl + Image;
+
+    public string Robots
+    {
+        get
+        {
+            var index = NoIndex ? "noindex" : "index";
+            var follow = NoFollow ? "nofollow" : "follow";
+            return $"{index}, {follow}";
+        }
+    }
+}`,
+    explanation: `ASP.NET Core comprehensive SEO service with:
+\u2022 SEOMeta class for page metadata
+\u2022 JSON-LD schema generators
+\u2022 Razor integration
+\u2022 Fluent API
+
+Setup:
+1. Register SEOService as singleton
+2. Inject in controllers/pages
+3. Use in Razor views`,
+    additionalFiles: [
+      {
+        file: "Pages/Shared/_SEOMeta.cshtml",
+        code: `@model SEOMeta
+
+<!-- Primary Meta Tags -->
+<title>@Model.FullTitle</title>
+<meta name="title" content="@Model.FullTitle">
+<meta name="description" content="@Model.Description">
+<meta name="robots" content="@Model.Robots">
+<link rel="canonical" href="@Model.Url">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="@Model.Type">
+<meta property="og:url" content="@Model.Url">
+<meta property="og:title" content="@Model.FullTitle">
+<meta property="og:description" content="@Model.Description">
+<meta property="og:image" content="@Model.AbsoluteImageUrl">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="${siteName}">
+
+@if (Model.Type == "article")
+{
+    if (Model.PublishedTime.HasValue)
+    {
+        <meta property="article:published_time" content="@Model.PublishedTime.Value.ToString("O")">
+    }
+    if (Model.ModifiedTime.HasValue)
+    {
+        <meta property="article:modified_time" content="@Model.ModifiedTime.Value.ToString("O")">
+    }
+    if (!string.IsNullOrEmpty(Model.Author))
+    {
+        <meta property="article:author" content="@Model.Author">
+    }
+    foreach (var tag in Model.Tags)
+    {
+        <meta property="article:tag" content="@tag">
+    }
+}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="@Model.FullTitle">
+<meta name="twitter:description" content="@Model.Description">
+<meta name="twitter:image" content="@Model.AbsoluteImageUrl">
+@if (!string.IsNullOrEmpty("${twitterHandle}"))
+{
+    <meta name="twitter:site" content="${twitterHandle}">
+    <meta name="twitter:creator" content="${twitterHandle}">
+}`,
+        explanation: "Razor partial view for SEO meta tags."
+      },
+      {
+        file: "Pages/Shared/_Layout.cshtml",
+        code: `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    
+    @if (ViewData["SEO"] is SEOMeta seo)
+    {
+        <partial name="_SEOMeta" model="seo" />
+    }
+    else
+    {
+        <title>${siteName}</title>
+    }
+    
+    <link rel="icon" type="image/x-icon" href="~/favicon.ico">
+    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true">
+    
+    @if (ViewData["JsonLd"] is string jsonLd)
+    {
+        <script type="application/ld+json">@Html.Raw(jsonLd)</script>
+    }
+</head>
+<body>
+    @RenderBody()
+    
+    <script src="~/js/site.js" asp-append-version="true"></script>
+    @await RenderSectionAsync("Scripts", required: false)
+</body>
+</html>`,
+        explanation: "Razor layout with SEO integration."
+      },
+      {
+        file: "wwwroot/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateHTMXSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "templates/seo_head.html",
+    code: `<!--
+HTMX SEO Template
+
+This template provides comprehensive SEO for HTMX applications.
+HTMX apps are server-rendered, so SEO is straightforward - just
+include proper meta tags in your initial HTML response.
+
+Features:
+- Full Open Graph support
+- Twitter Cards
+- JSON-LD structured data
+- Works with any backend (Python, Ruby, Go, PHP, etc.)
+
+Usage:
+Include this template in your base layout, passing the required variables.
+-->
+
+<!-- Primary Meta Tags -->
+<title>{{ full_title or '${siteName}' }}</title>
+<meta name="title" content="{{ full_title or '${siteName}' }}">
+<meta name="description" content="{{ description or '${description || `${siteName} - A compelling description.`}' }}">
+<meta name="robots" content="{{ 'noindex, nofollow' if noindex else 'index, follow' }}">
+<link rel="canonical" href="{{ canonical_url }}">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="{{ og_type or 'website' }}">
+<meta property="og:url" content="{{ canonical_url }}">
+<meta property="og:title" content="{{ full_title or '${siteName}' }}">
+<meta property="og:description" content="{{ description or '${description || `${siteName} - A compelling description.`}' }}">
+<meta property="og:image" content="{{ image_url or '${image || `${siteUrl}/og-image.png`}' }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="${siteName}">
+<meta property="og:locale" content="{{ locale or 'en_US' }}">
+
+{% if og_type == 'article' %}
+{% if published_time %}
+<meta property="article:published_time" content="{{ published_time }}">
+{% endif %}
+{% if modified_time %}
+<meta property="article:modified_time" content="{{ modified_time }}">
+{% endif %}
+{% if author %}
+<meta property="article:author" content="{{ author }}">
+{% endif %}
+{% for tag in tags or [] %}
+<meta property="article:tag" content="{{ tag }}">
+{% endfor %}
+{% endif %}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ full_title or '${siteName}' }}">
+<meta name="twitter:description" content="{{ description or '${description || `${siteName} - A compelling description.`}' }}">
+<meta name="twitter:image" content="{{ image_url or '${image || `${siteUrl}/og-image.png`}' }}">
+{% if '${twitterHandle}' %}
+<meta name="twitter:site" content="${twitterHandle}">
+<meta name="twitter:creator" content="${twitterHandle}">
+{% endif %}
+
+<!-- JSON-LD Structured Data -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "${siteName}",
+  "url": "${siteUrl}"
+}
+</script>
+{% if schema_json %}
+<script type="application/ld+json">
+{{ schema_json | safe }}
+</script>
+{% endif %}`,
+    explanation: `HTMX SEO template (framework-agnostic) with:
+\u2022 Full Open Graph support
+\u2022 Twitter Cards
+\u2022 JSON-LD structured data
+\u2022 Works with any template engine (Jinja2, Liquid, Go templates, etc.)
+
+HTMX apps are server-rendered, so SEO is built-in!
+Just include proper meta tags in your initial HTML response.
+
+Usage:
+1. Include in your base layout
+2. Pass SEO variables from your backend
+3. JSON-LD schemas can be generated server-side`,
+    additionalFiles: [
+      {
+        file: "templates/base.html",
+        code: `<!DOCTYPE html>
+<html lang="{{ lang or 'en' }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {% include 'seo_head.html' %}
+    
+    <!-- HTMX -->
+    <script src="https://unpkg.com/htmx.org@1.9.10"></script>
+    
+    <!-- Styles -->
+    <link rel="stylesheet" href="/static/css/styles.css">
+    
+    <!-- Favicon -->
+    <link rel="icon" href="/static/favicon.ico">
+</head>
+<body hx-boost="true">
+    <main id="content">
+        {% block content %}{% endblock %}
+    </main>
+</body>
+</html>`,
+        explanation: "Base HTMX layout with SEO integration."
+      },
+      {
+        file: "static/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function generateHugoSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "layouts/partials/seo.html",
+    code: `{{- /* Comprehensive SEO partial for Hugo */ -}}
+{{- $title := .Title | default site.Title -}}
+{{- $description := .Description | default .Summary | default site.Params.description | default "${description || `${siteName} - A compelling description.`}" -}}
+{{- $image := .Params.image | default site.Params.defaultImage | default "${image || "/og-image.png"}" -}}
+{{- $imageURL := $image | absURL -}}
+{{- $canonical := .Permalink -}}
+{{- $type := cond (eq .Kind "page") "article" "website" -}}
+
+{{- /* Full title with site name */ -}}
+{{- $fullTitle := $title -}}
+{{- if and (ne $title site.Title) (not (in $title site.Title)) -}}
+  {{- $fullTitle = printf "%s | %s" $title site.Title -}}
+{{- end -}}
+
+<!-- Primary Meta Tags -->
+<title>{{ $fullTitle }}</title>
+<meta name="title" content="{{ $fullTitle }}">
+<meta name="description" content="{{ $description | truncate 160 }}">
+<meta name="robots" content="{{ if .Params.noindex }}noindex, nofollow{{ else }}index, follow{{ end }}">
+<link rel="canonical" href="{{ $canonical }}">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="{{ $type }}">
+<meta property="og:url" content="{{ $canonical }}">
+<meta property="og:title" content="{{ $fullTitle }}">
+<meta property="og:description" content="{{ $description | truncate 160 }}">
+<meta property="og:image" content="{{ $imageURL }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="{{ site.Title }}">
+<meta property="og:locale" content="{{ site.Language.Lang | default "en" }}_{{ site.Language.Lang | default "US" | upper }}">
+
+{{- if eq $type "article" }}
+{{- with .PublishDate }}
+<meta property="article:published_time" content="{{ .Format "2006-01-02T15:04:05Z07:00" }}">
+{{- end }}
+{{- with .Lastmod }}
+<meta property="article:modified_time" content="{{ .Format "2006-01-02T15:04:05Z07:00" }}">
+{{- end }}
+{{- with .Params.author }}
+<meta property="article:author" content="{{ . }}">
+{{- end }}
+{{- range .Params.tags }}
+<meta property="article:tag" content="{{ . }}">
+{{- end }}
+{{- end }}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ $fullTitle }}">
+<meta name="twitter:description" content="{{ $description | truncate 160 }}">
+<meta name="twitter:image" content="{{ $imageURL }}">
+{{- with site.Params.twitterHandle }}
+<meta name="twitter:site" content="{{ . }}">
+<meta name="twitter:creator" content="{{ . }}">
+{{- end }}
+
+<!-- JSON-LD: WebSite -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "{{ site.Title }}",
+  "url": "{{ site.BaseURL }}"
+}
+</script>
+
+{{- /* Article Schema */ -}}
+{{- if eq $type "article" }}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "{{ $title }}",
+  "description": "{{ $description | truncate 160 }}",
+  "image": "{{ $imageURL }}",
+  "datePublished": "{{ .PublishDate.Format "2006-01-02T15:04:05Z07:00" }}",
+  "dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05Z07:00" }}",
+  "author": {
+    "@type": "Person",
+    "name": "{{ .Params.author | default site.Params.author | default "Author" }}"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "{{ site.Title }}",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ "logo.png" | absURL }}"
+    }
+  }
+}
+</script>
+{{- end }}
+
+{{- /* Breadcrumbs */ -}}
+{{- if .Parent }}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {{- $breadcrumbs := slice -}}
+    {{- range .Ancestors.Reverse }}
+    {{- $breadcrumbs = $breadcrumbs | append (dict "name" .Title "url" .Permalink) -}}
+    {{- end }}
+    {{- $breadcrumbs = $breadcrumbs | append (dict "name" .Title "url" .Permalink) -}}
+    {{- range $i, $item := $breadcrumbs }}
+    {{- if $i }},{{ end }}
+    {
+      "@type": "ListItem",
+      "position": {{ add $i 1 }},
+      "name": "{{ $item.name }}",
+      "item": "{{ $item.url }}"
+    }
+    {{- end }}
+  ]
+}
+</script>
+{{- end }}`,
+    explanation: `Hugo comprehensive SEO partial with:
+\u2022 Automatic title handling
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schemas (WebSite, Article, Breadcrumbs)
+\u2022 Content summaries for descriptions
+
+Usage: {{ partial "seo.html" . }}`,
+    additionalFiles: [
+      {
+        file: "layouts/_default/baseof.html",
+        code: `<!DOCTYPE html>
+<html lang="{{ site.Language.Lang | default "en" }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {{ partial "seo.html" . }}
+    
+    <!-- Favicon -->
+    <link rel="icon" href="{{ "favicon.ico" | relURL }}">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ "apple-touch-icon.png" | relURL }}">
+    
+    <!-- Styles -->
+    {{ $styles := resources.Get "css/styles.css" | minify | fingerprint }}
+    <link rel="stylesheet" href="{{ $styles.Permalink }}">
+</head>
+<body>
+    {{ block "main" . }}{{ end }}
+</body>
+</html>`,
+        explanation: "Hugo base template with SEO partial."
+      },
+      {
+        file: "config.toml",
+        code: `baseURL = '${siteUrl}/'
+languageCode = 'en-us'
+title = '${siteName}'
+
+[params]
+  description = '${description || `${siteName} - A compelling description.`}'
+  defaultImage = '${image || "/og-image.png"}'
+  twitterHandle = '${twitterHandle || ""}'
+  author = 'Your Name'
+
+[sitemap]
+  changefreq = 'weekly'
+  filename = 'sitemap.xml'
+  priority = 0.5
+
+[outputs]
+  home = ['HTML', 'RSS', 'JSON']
+
+# Robots.txt
+enableRobotsTXT = true`,
+        explanation: "Hugo configuration with SEO settings."
+      },
+      {
+        file: "layouts/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: {{ .Site.BaseURL }}sitemap.xml`,
+        explanation: "Hugo robots.txt template."
+      }
+    ]
+  };
+}
+function generateJekyllSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "_includes/seo.html",
+    code: `{% comment %}
+Comprehensive SEO include for Jekyll
+
+Features:
+- Full Open Graph support
+- Twitter Cards
+- JSON-LD structured data
+- jekyll-seo-tag compatible
+
+Usage: {% include seo.html %}
+{% endcomment %}
+
+{%- assign seo_title = page.title | default: site.title -%}
+{%- if page.title and site.title and page.title != site.title -%}
+  {%- assign seo_title = page.title | append: " | " | append: site.title -%}
+{%- endif -%}
+
+{%- assign seo_description = page.description | default: page.excerpt | default: site.description | default: "${description || `${siteName} - A compelling description.`}" | strip_html | truncate: 160 -%}
+
+{%- assign seo_image = page.image | default: site.og_image | default: "${image || "/og-image.png"}" -%}
+{%- unless seo_image contains "://" -%}
+  {%- assign seo_image = seo_image | absolute_url -%}
+{%- endunless -%}
+
+{%- assign seo_type = "website" -%}
+{%- if page.layout == "post" -%}
+  {%- assign seo_type = "article" -%}
+{%- endif -%}
+
+<!-- Primary Meta Tags -->
+<title>{{ seo_title }}</title>
+<meta name="title" content="{{ seo_title }}">
+<meta name="description" content="{{ seo_description }}">
+<meta name="robots" content="{% if page.noindex %}noindex, nofollow{% else %}index, follow{% endif %}">
+<link rel="canonical" href="{{ page.url | absolute_url }}">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="{{ seo_type }}">
+<meta property="og:url" content="{{ page.url | absolute_url }}">
+<meta property="og:title" content="{{ seo_title }}">
+<meta property="og:description" content="{{ seo_description }}">
+<meta property="og:image" content="{{ seo_image }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="{{ site.title }}">
+<meta property="og:locale" content="{{ site.locale | default: "en_US" }}">
+
+{% if seo_type == "article" %}
+{% if page.date %}
+<meta property="article:published_time" content="{{ page.date | date_to_xmlschema }}">
+{% endif %}
+{% if page.last_modified_at %}
+<meta property="article:modified_time" content="{{ page.last_modified_at | date_to_xmlschema }}">
+{% endif %}
+{% if page.author %}
+<meta property="article:author" content="{{ page.author }}">
+{% endif %}
+{% for tag in page.tags %}
+<meta property="article:tag" content="{{ tag }}">
+{% endfor %}
+{% endif %}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ seo_title }}">
+<meta name="twitter:description" content="{{ seo_description }}">
+<meta name="twitter:image" content="{{ seo_image }}">
+{% if site.twitter_handle %}
+<meta name="twitter:site" content="{{ site.twitter_handle }}">
+<meta name="twitter:creator" content="{{ site.twitter_handle }}">
+{% endif %}
+
+<!-- JSON-LD: WebSite -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "{{ site.title }}",
+  "url": "{{ site.url }}"
+}
+</script>
+
+{% if seo_type == "article" %}
+<!-- JSON-LD: Article -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "{{ page.title | escape }}",
+  "description": "{{ seo_description | escape }}",
+  "image": "{{ seo_image }}",
+  "datePublished": "{{ page.date | date_to_xmlschema }}",
+  "dateModified": "{{ page.last_modified_at | default: page.date | date_to_xmlschema }}",
+  "author": {
+    "@type": "Person",
+    "name": "{{ page.author | default: site.author | default: "Author" }}"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "{{ site.title }}",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ '/logo.png' | absolute_url }}"
+    }
+  }
+}
+</script>
+{% endif %}`,
+    explanation: `Jekyll comprehensive SEO include with:
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schemas
+\u2022 Liquid template integration
+
+Usage: {% include seo.html %}`,
+    additionalFiles: [
+      {
+        file: "_layouts/default.html",
+        code: `<!DOCTYPE html>
+<html lang="{{ site.locale | default: "en" | slice: 0, 2 }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {% include seo.html %}
+    
+    <link rel="icon" href="{{ '/favicon.ico' | relative_url }}">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ '/apple-touch-icon.png' | relative_url }}">
+    
+    <link rel="stylesheet" href="{{ '/assets/css/styles.css' | relative_url }}">
+</head>
+<body>
+    {{ content }}
+</body>
+</html>`,
+        explanation: "Jekyll default layout with SEO include."
+      },
+      {
+        file: "_config.yml",
+        code: `title: ${siteName}
+description: "${description || `${siteName} - A compelling description.`}"
+url: "${siteUrl}"
+baseurl: ""
+
+# SEO
+og_image: "${image || "/og-image.png"}"
+twitter_handle: "${twitterHandle || ""}"
+locale: "en_US"
+author: "Your Name"
+
+# Plugins
+plugins:
+  - jekyll-sitemap
+  - jekyll-feed
+
+# Defaults
+defaults:
+  - scope:
+      path: ""
+      type: "posts"
+    values:
+      layout: "post"
+  - scope:
+      path: ""
+    values:
+      layout: "default"`,
+        explanation: "Jekyll configuration with SEO settings."
+      },
+      {
+        file: "robots.txt",
+        code: `---
+---
+User-agent: *
+Allow: /
+Disallow: /admin/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: {{ site.url }}/sitemap.xml`,
+        explanation: "Jekyll robots.txt with front matter."
+      }
+    ]
+  };
+}
+function generateEleventySEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "src/_includes/seo.njk",
+    code: `{#
+  Comprehensive SEO partial for Eleventy (11ty)
+
+  Features:
+  - Full Open Graph support
+  - Twitter Cards
+  - JSON-LD structured data
+  - Nunjucks template
+
+  Usage: {% include "seo.njk" %}
+#}
+
+{%- set seoTitle = title or metadata.title -%}
+{%- set fullTitle = seoTitle -%}
+{%- if seoTitle and metadata.title and seoTitle != metadata.title -%}
+  {%- set fullTitle = seoTitle + " | " + metadata.title -%}
+{%- endif -%}
+
+{%- set seoDescription = description or excerpt or metadata.description or "${description || `${siteName} - A compelling description.`}" -%}
+{%- set seoImage = image or metadata.defaultImage or "${image || "/og-image.png"}" -%}
+{%- if not seoImage.startsWith("http") -%}
+  {%- set seoImage = metadata.url + seoImage -%}
+{%- endif -%}
+
+{%- set pageUrl = page.url | url | absoluteUrl(metadata.url) -%}
+{%- set seoType = "article" if layout == "post" else "website" -%}
+
+<!-- Primary Meta Tags -->
+<title>{{ fullTitle }}</title>
+<meta name="title" content="{{ fullTitle }}">
+<meta name="description" content="{{ seoDescription | truncate(160) }}">
+<meta name="robots" content="{{ 'noindex, nofollow' if noindex else 'index, follow' }}">
+<link rel="canonical" href="{{ pageUrl }}">
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content="{{ seoType }}">
+<meta property="og:url" content="{{ pageUrl }}">
+<meta property="og:title" content="{{ fullTitle }}">
+<meta property="og:description" content="{{ seoDescription | truncate(160) }}">
+<meta property="og:image" content="{{ seoImage }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:site_name" content="{{ metadata.title }}">
+<meta property="og:locale" content="{{ metadata.locale or 'en_US' }}">
+
+{% if seoType == "article" %}
+{% if date %}
+<meta property="article:published_time" content="{{ date | dateToISO }}">
+{% endif %}
+{% if lastModified %}
+<meta property="article:modified_time" content="{{ lastModified | dateToISO }}">
+{% endif %}
+{% if author %}
+<meta property="article:author" content="{{ author }}">
+{% endif %}
+{% for tag in tags %}
+{% if tag != "posts" and tag != "all" %}
+<meta property="article:tag" content="{{ tag }}">
+{% endif %}
+{% endfor %}
+{% endif %}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ fullTitle }}">
+<meta name="twitter:description" content="{{ seoDescription | truncate(160) }}">
+<meta name="twitter:image" content="{{ seoImage }}">
+{% if metadata.twitterHandle %}
+<meta name="twitter:site" content="{{ metadata.twitterHandle }}">
+<meta name="twitter:creator" content="{{ metadata.twitterHandle }}">
+{% endif %}
+
+<!-- JSON-LD: WebSite -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "{{ metadata.title }}",
+  "url": "{{ metadata.url }}"
+}
+</script>
+
+{% if seoType == "article" %}
+<!-- JSON-LD: Article -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "{{ title }}",
+  "description": "{{ seoDescription | truncate(160) | escape }}",
+  "image": "{{ seoImage }}",
+  "datePublished": "{{ date | dateToISO }}",
+  "dateModified": "{{ (lastModified or date) | dateToISO }}",
+  "author": {
+    "@type": "Person",
+    "name": "{{ author or metadata.author or 'Author' }}"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "{{ metadata.title }}",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ metadata.url }}/logo.png"
+    }
+  }
+}
+</script>
+{% endif %}`,
+    explanation: `Eleventy comprehensive SEO partial with:
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schemas
+\u2022 Nunjucks templating
+
+Usage: {% include "seo.njk" %}`,
+    additionalFiles: [
+      {
+        file: "src/_includes/base.njk",
+        code: `<!DOCTYPE html>
+<html lang="{{ metadata.locale | default('en') | truncate(2, true, '') }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    
+    {% include "seo.njk" %}
+    
+    <link rel="icon" href="/favicon.ico">
+    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+    
+    <link rel="stylesheet" href="/css/styles.css">
+</head>
+<body>
+    {{ content | safe }}
+</body>
+</html>`,
+        explanation: "Eleventy base layout with SEO include."
+      },
+      {
+        file: "src/_data/metadata.json",
+        code: `{
+  "title": "${siteName}",
+  "url": "${siteUrl}",
+  "description": "${description || `${siteName} - A compelling description.`}",
+  "defaultImage": "${image || "/og-image.png"}",
+  "twitterHandle": "${twitterHandle || ""}",
+  "locale": "en_US",
+  "author": "Your Name"
+}`,
+        explanation: "Eleventy global data file with SEO metadata."
+      },
+      {
+        file: "src/robots.njk",
+        code: `---
+permalink: /robots.txt
+eleventyExcludeFromCollections: true
+---
+User-agent: *
+Allow: /
+Disallow: /admin/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: {{ metadata.url }}/sitemap.xml`,
+        explanation: "Eleventy robots.txt template."
+      }
+    ]
+  };
+}
+function generateRemixSEO(options) {
+  const { siteName, siteUrl, description, image, twitterHandle } = options;
+  return {
+    file: "app/utils/seo.ts",
+    code: `import type { V2_MetaFunction, V2_MetaDescriptor } from '@remix-run/node';
+
+/**
+ * Comprehensive SEO utilities for Remix
+ *
+ * Features:
+ * - Full Open Graph support
+ * - Twitter Cards
+ * - JSON-LD structured data
+ * - Type-safe meta function helpers
+ */
+
+const SITE_NAME = '${siteName}';
+const SITE_URL = '${siteUrl}';
+const DEFAULT_IMAGE = '${image || `${siteUrl}/og-image.png`}';
+const DEFAULT_DESCRIPTION = '${description || `${siteName} - A compelling description.`}';
+const TWITTER_HANDLE = '${twitterHandle || ""}';
+
+interface SEOConfig {
+  title?: string;
+  description?: string;
+  image?: string;
+  url?: string;
+  type?: 'website' | 'article';
+  publishedTime?: string;
+  modifiedTime?: string;
+  author?: string;
+  tags?: string[];
+  noIndex?: boolean;
+}
+
+/**
+ * Generate meta tags for a page
+ */
+export function generateMeta(config: SEOConfig = {}): V2_MetaDescriptor[] {
+  const {
+    title,
+    description = DEFAULT_DESCRIPTION,
+    image = DEFAULT_IMAGE,
+    url = SITE_URL,
+    type = 'website',
+    publishedTime,
+    modifiedTime,
+    author,
+    tags = [],
+    noIndex = false,
+  } = config;
+
+  const fullTitle = title
+    ? title.includes(SITE_NAME)
+      ? title
+      : \`\${title} | \${SITE_NAME}\`
+    : SITE_NAME;
+
+  const imageUrl = image.startsWith('http') ? image : \`\${SITE_URL}\${image}\`;
+  const robotsContent = noIndex ? 'noindex, nofollow' : 'index, follow';
+
+  const meta: V2_MetaDescriptor[] = [
+    { title: fullTitle },
+    { name: 'description', content: description },
+    { name: 'robots', content: robotsContent },
+
+    // Open Graph
+    { property: 'og:type', content: type },
+    { property: 'og:url', content: url },
+    { property: 'og:title', content: fullTitle },
+    { property: 'og:description', content: description },
+    { property: 'og:image', content: imageUrl },
+    { property: 'og:image:width', content: '1200' },
+    { property: 'og:image:height', content: '630' },
+    { property: 'og:site_name', content: SITE_NAME },
+
+    // Twitter
+    { name: 'twitter:card', content: 'summary_large_image' },
+    { name: 'twitter:title', content: fullTitle },
+    { name: 'twitter:description', content: description },
+    { name: 'twitter:image', content: imageUrl },
+  ];
+
+  if (TWITTER_HANDLE) {
+    meta.push(
+      { name: 'twitter:site', content: TWITTER_HANDLE },
+      { name: 'twitter:creator', content: TWITTER_HANDLE }
+    );
+  }
+
+  // Article-specific meta
+  if (type === 'article') {
+    if (publishedTime) {
+      meta.push({ property: 'article:published_time', content: publishedTime });
+    }
+    if (modifiedTime) {
+      meta.push({ property: 'article:modified_time', content: modifiedTime });
+    }
+    if (author) {
+      meta.push({ property: 'article:author', content: author });
+    }
+    tags.forEach((tag) => {
+      meta.push({ property: 'article:tag', content: tag });
+    });
+  }
+
+  return meta;
+}
+
+/**
+ * Generate canonical link
+ */
+export function generateLinks(url: string) {
+  return [{ rel: 'canonical', href: url }];
+}
+
+// JSON-LD Schema Generators
+
+export function websiteSchema() {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'WebSite',
+    name: SITE_NAME,
+    url: SITE_URL,
+  };
+}
+
+export function articleSchema(data: {
+  headline: string;
+  description: string;
+  image?: string;
+  datePublished: string;
+  dateModified?: string;
+  author: { name: string; url?: string };
+}) {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'Article',
+    headline: data.headline,
+    description: data.description,
+    image: data.image || DEFAULT_IMAGE,
+    datePublished: data.datePublished,
+    dateModified: data.dateModified || data.datePublished,
+    author: { '@type': 'Person', ...data.author },
+    publisher: {
+      '@type': 'Organization',
+      name: SITE_NAME,
+      logo: { '@type': 'ImageObject', url: \`\${SITE_URL}/logo.png\` },
+    },
+  };
+}
+
+export function productSchema(data: {
+  name: string;
+  description: string;
+  image?: string;
+  price: number;
+  currency?: string;
+  inStock?: boolean;
+}) {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'Product',
+    name: data.name,
+    description: data.description,
+    image: data.image || DEFAULT_IMAGE,
+    offers: {
+      '@type': 'Offer',
+      price: data.price.toString(),
+      priceCurrency: data.currency || 'USD',
+      availability: \`https://schema.org/\${data.inStock !== false ? 'InStock' : 'OutOfStock'}\`,
+    },
+  };
+}
+
+export function faqSchema(items: { question: string; answer: string }[]) {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: items.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  };
+}
+
+export function breadcrumbSchema(items: { name: string; url: string }[]) {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BreadcrumbList',
+    itemListElement: items.map((item, i) => ({
+      '@type': 'ListItem',
+      position: i + 1,
+      name: item.name,
+      item: item.url,
+    })),
+  };
+}
+
+/**
+ * JSON-LD Script component helper
+ */
+export function JsonLd({ schema }: { schema: Record<string, unknown> }) {
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }}
+    />
+  );
+}`,
+    explanation: `Remix comprehensive SEO utilities with:
+\u2022 Type-safe meta function helpers
+\u2022 Full Open Graph with article support
+\u2022 Twitter Cards
+\u2022 JSON-LD schema generators
+\u2022 Remix V2 meta conventions
+
+Usage in route:
+export const meta: V2_MetaFunction = () => generateMeta({ title: "Page" });`,
+    additionalFiles: [
+      {
+        file: "app/root.tsx",
+        code: `import {
+  Links,
+  LiveReload,
+  Meta,
+  Outlet,
+  Scripts,
+  ScrollRestoration,
+} from '@remix-run/react';
+import { JsonLd, websiteSchema } from '~/utils/seo';
+
+export default function App() {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <Meta />
+        <Links />
+        <JsonLd schema={websiteSchema()} />
+      </head>
+      <body>
+        <Outlet />
+        <ScrollRestoration />
+        <Scripts />
+        <LiveReload />
+      </body>
+    </html>
+  );
+}`,
+        explanation: "Remix root with SEO integration."
+      },
+      {
+        file: "public/robots.txt",
+        code: `User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /api/
+
+User-agent: GPTBot
+Allow: /
+
+Sitemap: ${siteUrl}/sitemap.xml`,
+        explanation: "Robots.txt with AI crawler support."
+      }
+    ]
+  };
+}
+function getFrameworkSpecificFixExtended(framework, options) {
+  const name = framework.name.toLowerCase();
+  if (name.includes("next")) {
+    return framework.router === "app" ? generateNextJsAppRouterMetadata(options) : generateNextJsPagesRouterHead(options);
+  }
+  if (name.includes("nuxt")) return generateNuxtSEOHead(options);
+  if (name.includes("vue")) return generateVueSEOHead(options);
+  if (name.includes("astro")) return generateAstroBaseHead(options);
+  if (name.includes("svelte")) return generateSvelteKitSEOHead(options);
+  if (name.includes("angular")) return generateAngularSEOService(options);
+  if (name.includes("remix")) return generateRemixSEO(options);
+  if (name.includes("rails") || name.includes("ruby")) return generateRailsSEOHelper(options);
+  if (name.includes("django")) return generateDjangoSEOHelper(options);
+  if (name.includes("laravel") || name.includes("php")) return generateLaravelSEOHelper(options);
+  if (name.includes("spring") || name.includes("java")) return generateSpringBootSEO(options);
+  if (name.includes("phoenix") || name.includes("elixir")) return generatePhoenixSEO(options);
+  if (name.includes("asp") || name.includes(".net") || name.includes("csharp") || name.includes("c#")) {
+    return generateAspNetCoreSEO(options);
+  }
+  if (name.includes("go") || name.includes("gin") || name.includes("echo") || name.includes("fiber")) {
+    return generateGoSEO(options);
+  }
+  if (name.includes("htmx") || name.includes("hotwire") || name.includes("turbo")) {
+    return generateHTMXSEO(options);
+  }
+  if (name.includes("hugo")) return generateHugoSEO(options);
+  if (name.includes("jekyll")) return generateJekyllSEO(options);
+  if (name.includes("eleventy") || name.includes("11ty")) return generateEleventySEO(options);
+  return generateReactSEOHead(options);
+}
+
+// src/fixer.ts
+async function generateFixes(issues, options) {
+  const { cwd, url } = options;
+  let framework = options.framework;
+  if (!framework) {
+    const result = await detectFramework3({ cwd });
+    framework = result.success ? result.data : { name: "Unknown", metaPattern: "html-head" };
+  }
+  const fixes = [];
+  const htmlEntry = await findHtmlEntry({ cwd });
+  const htmlPath = htmlEntry.success ? htmlEntry.data.path : "index.html";
+  const htmlContent = htmlEntry.success ? htmlEntry.data.content : "";
+  for (const issue of issues) {
+    const fix = await generateFixForIssue(issue, {
+      cwd,
+      url,
+      framework,
+      htmlPath,
+      htmlContent
+    });
+    if (fix) {
+      fixes.push(fix);
+    }
+  }
+  return fixes;
+}
+async function generateFixForIssue(issue, context) {
+  const { cwd, url, framework, htmlPath, htmlContent } = context;
+  const fullUrl = url || "https://example.com";
+  const siteName = new URL(fullUrl).hostname.replace("www.", "");
+  switch (issue.code) {
+    // Title issues
+    case "MISSING_TITLE":
+    case "TITLE_MISSING":
+    // Full audit code
+    case "TITLE_KEYWORD_MISMATCH":
+    case "TITLE_H1_KEYWORD_MISMATCH":
+    case "OUTDATED_YEAR_IN_TITLE":
+      return generateTitleFix(context, siteName);
+    // Meta description issues
+    case "MISSING_META_DESC":
+    case "META_DESC_MISSING":
+      return generateMetaDescFix(context, siteName);
+    // Canonical issues
+    case "MISSING_CANONICAL":
+    case "CANONICAL_MISSING":
+    // Full audit code
+    case "CANONICAL_NO_HTTPS_REDIRECT":
+      return generateCanonicalFix(context, fullUrl);
+    // Viewport issues
+    case "MISSING_VIEWPORT":
+    case "HTML_NO_VIEWPORT":
+    case "RESPONSIVE_NO_VIEWPORT":
+    case "VIEWPORT_MISSING":
+      return generateViewportFix(context);
+    // Open Graph issues
+    case "MISSING_OG_TAGS":
+    case "OG_TITLE_MISSING":
+    case "OG_DESC_MISSING":
+    case "OG_DESCRIPTION_MISSING":
+    // Full audit code
+    case "OG_IMAGE_MISSING":
+    case "OG_URL_MISSING":
+    case "OG_TYPE_MISSING":
+      return generateOGFix(context, siteName, fullUrl);
+    // Twitter Card issues
+    case "MISSING_TWITTER_CARD":
+    case "TWITTER_CARD_MISSING":
+    case "TWITTER_TITLE_MISSING":
+    case "TWITTER_DESC_MISSING":
+    case "TWITTER_DESCRIPTION_MISSING":
+    // Full audit code
+    case "TWITTER_IMAGE_MISSING":
+      return generateTwitterFix(context, siteName);
+    // Schema/structured data issues
+    case "MISSING_SCHEMA":
+    case "SCHEMA_MISSING":
+    // Full audit code
+    case "SCHEMA_ORG_MISSING":
+    case "NO_ORGANIZATION_SCHEMA":
+    case "NO_ENTITY_SCHEMA":
+    case "FAQ_SCHEMA_MISSING":
+      return generateSchemaFix(context, siteName, fullUrl);
+    // Robots.txt issues
+    case "MISSING_ROBOTS":
+    case "ROBOTS_TXT_MISSING":
+    // Full audit code
+    case "ROBOTS_TXT_WARNINGS":
+    case "ROBOTS_TXT_INVALID_SYNTAX":
+      return generateRobotsFix(context, fullUrl);
+    // Sitemap issues
+    case "MISSING_SITEMAP":
+    case "SITEMAP_MISSING":
+    // Full audit code
+    case "BING_SITEMAP_MISSING":
+      return generateSitemapFix(context, fullUrl);
+    // H1 issues
+    case "MISSING_H1":
+    case "H1_MISSING":
+    // Full audit code
+    case "NO_VISIBLE_HEADLINE":
+    case "H1_MISSING_KEYWORD":
+      return await generateH1Fix({ cwd });
+    // SPA-specific: add meta management library recommendation
+    case "SPA_NO_META_MANAGEMENT":
+    case "SPA_WITHOUT_SSR":
+    case "CLIENT_SIDE_RENDERING":
+      return generateSPAMetaFix(context, framework);
+    // Internal links - suggest adding links
+    case "NO_INTERNAL_LINKS":
+    case "LINKS_NO_INTERNAL":
+    case "NO_CONTENT_INTERNAL_LINKS":
+      return {
+        issue: { code: issue.code, message: "No internal links found", severity: "warning" },
+        file: "src/components/Footer.tsx",
+        before: null,
+        after: `// Add internal navigation links to your footer or content
+// Example: <Link to="/about">About</Link>`,
+        explanation: "Add internal links to help search engines discover your content",
+        skipped: true,
+        skipReason: "Requires manual content updates - add links to your navigation and content"
+      };
+    // Preconnect issues
+    case "GOOGLE_FONTS_NO_PRECONNECT":
+    case "MISSING_PRECONNECT":
+      return generatePreconnectFix(context);
+    // Favicon/icons
+    case "HTML_NO_FAVICON":
+    case "HTML_NO_APPLE_TOUCH_ICON":
+    case "FAVICON_MISSING":
+      return generateFaviconFix(context);
+    // Charset/lang
+    case "HTML_NO_CHARSET":
+    case "HTML_NOT_UTF8":
+      return generateCharsetFix(context);
+    case "HTML_NO_LANG":
+    case "LANG_ATTR_MISSING":
+      return generateLangFix(context);
+    // AI/LLMs.txt
+    case "AI_NO_LLMS_TXT":
+      return generateLlmsTxtFix(context, siteName, fullUrl);
+    default:
+      return null;
+  }
+}
+function generateTitleFix(context, siteName) {
+  const { htmlPath, htmlContent, framework } = context;
+  if (framework.metaPattern === "html-head") {
+    const titleTag = `<title>${siteName} - Your Product Tagline</title>`;
+    if (htmlContent.includes("<title>")) {
+      const before = htmlContent.match(/<title>.*?<\/title>/)?.[0] || "";
+      return {
+        issue: { code: "MISSING_TITLE", message: "Missing or empty title tag", severity: "critical" },
+        file: htmlPath,
+        before,
+        after: titleTag,
+        explanation: "Updated the title tag with a descriptive title"
+      };
+    } else {
+      return {
+        issue: { code: "MISSING_TITLE", message: "Missing title tag", severity: "critical" },
+        file: htmlPath,
+        before: "<head>",
+        after: `<head>
+    ${titleTag}`,
+        explanation: "Added a title tag to the document head"
+      };
+    }
+  }
+  return {
+    issue: { code: "MISSING_TITLE", message: "Missing title tag", severity: "critical" },
+    file: htmlPath,
+    before: null,
+    after: `<title>${siteName} - Your Product Tagline</title>`,
+    explanation: `Add title using ${framework.name} patterns`
+  };
+}
+function generateMetaDescFix(context, siteName) {
+  const { htmlPath, htmlContent, framework } = context;
+  const description = `${siteName} - A brief, compelling description of your product or service. Include key features and benefits.`;
+  if (framework.metaPattern === "html-head") {
+    const metaTag = `<meta name="description" content="${description}" />`;
+    if (htmlContent.includes("<title>")) {
+      return {
+        issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
+        file: htmlPath,
+        before: "</title>",
+        after: `</title>
+    ${metaTag}`,
+        explanation: "Added meta description after the title tag"
+      };
+    } else {
+      return {
+        issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
+        file: htmlPath,
+        before: "<head>",
+        after: `<head>
+    ${metaTag}`,
+        explanation: "Added meta description to the document head"
+      };
+    }
+  }
+  return {
+    issue: { code: "MISSING_META_DESC", message: "Missing meta description", severity: "critical" },
+    file: htmlPath,
+    before: null,
     after: `<meta name="description" content="${description}" />`,
     explanation: `Add meta description using ${framework.name} patterns`
   };
@@ -30394,6 +33755,121 @@ function getAIVisibilitySummary(results) {
   };
 }
 
+// src/analyzers/index.ts
+var analyzers_exports = {};
+__export(analyzers_exports, {
+  AI_CRAWLERS_INFO: () => AI_CRAWLERS_INFO,
+  analyzeCitationReadiness: () => analyzeCitationReadiness,
+  analyzeComprehensive: () => analyzeComprehensive,
+  analyzeContentStructure: () => analyzeContentStructure,
+  analyzeCoreWebVitals: () => analyzeCoreWebVitals,
+  analyzeEntityExtraction: () => analyzeEntityExtraction,
+  analyzeGEO: () => analyzeGEO,
+  analyzeImages: () => analyzeImages,
+  analyzeInternalLinking: () => analyzeInternalLinking,
+  analyzeMobileSEO: () => analyzeMobileSEO,
+  analyzeRobotsTxtForAI: () => analyzeRobotsTxtForAI,
+  analyzeSecurityHeaders: () => analyzeSecurityHeaders,
+  analyzeStructuredData: () => analyzeStructuredData,
+  calculateLLMSignals: () => calculateLLMSignals,
+  detectRenderingMode: () => detectRenderingMode,
+  generateAIFriendlyRobotsTxt: () => generateAIFriendlyRobotsTxt,
+  generateResponsiveImage: () => generateResponsiveImage,
+  generateSchemaTemplate: () => generateSchemaTemplate,
+  generateSecurityHeaders: () => generateSecurityHeaders,
+  suggestInternalLinks: () => suggestInternalLinks
+});
+async function analyzeComprehensive(html, url, options = {}) {
+  const { robotsTxt, headers } = options;
+  const { analyzeGEO: analyzeGEO2 } = await import("./geo-analyzer-D47LTMMA.mjs");
+  const { analyzeCoreWebVitals: analyzeCoreWebVitals2 } = await import("./core-web-vitals-analyzer-TE6LQJMS.mjs");
+  const { analyzeSecurityHeaders: analyzeSecurityHeaders3 } = await import("./security-headers-analyzer-3ZUQARS5.mjs");
+  const { analyzeStructuredData: analyzeStructuredData3 } = await import("./structured-data-analyzer-2I4NQAUP.mjs");
+  const { analyzeImages: analyzeImages3 } = await import("./image-optimization-analyzer-XP4OQGRP.mjs");
+  const { analyzeInternalLinking: analyzeInternalLinking2 } = await import("./internal-linking-analyzer-MRMBV7NM.mjs");
+  const { analyzeMobileSEO: analyzeMobileSEO2 } = await import("./mobile-seo-analyzer-67HNQ7IO.mjs");
+  const geo = await analyzeGEO2(html, url, robotsTxt);
+  const coreWebVitals = analyzeCoreWebVitals2(html, url, headers);
+  const security = analyzeSecurityHeaders3(headers || {}, url);
+  const structuredData = analyzeStructuredData3(html, url);
+  const images = analyzeImages3(html, url);
+  const internalLinking = analyzeInternalLinking2(html, url);
+  const mobile = analyzeMobileSEO2(html, url);
+  const allIssues = [
+    ...geo.issues,
+    ...coreWebVitals.issues,
+    ...security.issues,
+    ...structuredData.issues,
+    ...images.issues,
+    ...internalLinking.issues,
+    ...mobile.issues
+  ];
+  const severityOrder = { critical: 0, error: 1, warning: 2, info: 3, notice: 4 };
+  allIssues.sort((a, b) => (severityOrder[a.severity] ?? 5) - (severityOrder[b.severity] ?? 5));
+  const weights = {
+    geo: 0.2,
+    // AI search is crucial
+    cwv: 0.2,
+    // Core Web Vitals
+    security: 0.1,
+    // Security headers
+    schema: 0.15,
+    // Structured data
+    images: 0.1,
+    // Image optimization
+    links: 0.1,
+    // Internal linking
+    mobile: 0.15
+    // Mobile SEO
+  };
+  const securityScore = security.grade === "A+" ? 100 : security.grade === "A" ? 90 : security.grade === "B" ? 75 : security.grade === "C" ? 55 : security.grade === "D" ? 35 : 20;
+  const overallScore = Math.round(
+    geo.score * weights.geo + coreWebVitals.overallScore * weights.cwv + securityScore * weights.security + structuredData.score * weights.schema + images.score * weights.images + internalLinking.score * weights.links + mobile.score * weights.mobile
+  );
+  const prioritizedRecommendations = [];
+  if (geo.aiCrawlerAccess.blockedCrawlers.length > 0) {
+    prioritizedRecommendations.push("\u{1F6A8} URGENT: Unblock AI crawlers (GPTBot, PerplexityBot) in robots.txt");
+  }
+  if (geo.aiCrawlerAccess.jsRenderingRequired && !geo.aiCrawlerAccess.hasPrerendering) {
+    prioritizedRecommendations.push("\u{1F6A8} URGENT: Implement SSR - AI crawlers cannot see your JS-rendered content");
+  }
+  const criticalCWV = coreWebVitals.issues.filter((i) => i.severity === "critical");
+  criticalCWV.forEach((i) => prioritizedRecommendations.push(`\u26A1 ${i.title}`));
+  if (!security.https.enabled) {
+    prioritizedRecommendations.push("\u{1F512} Enable HTTPS immediately");
+  }
+  if (!mobile.viewport.hasViewport) {
+    prioritizedRecommendations.push("\u{1F4F1} Add viewport meta tag for mobile rendering");
+  }
+  geo.recommendations.slice(0, 2).forEach((r) => prioritizedRecommendations.push(r));
+  structuredData.recommendations.slice(0, 2).forEach((r) => prioritizedRecommendations.push(r));
+  images.recommendations.slice(0, 2).forEach((r) => prioritizedRecommendations.push(r));
+  internalLinking.recommendations.slice(0, 2).forEach((r) => prioritizedRecommendations.push(r));
+  return {
+    url,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    overallScore,
+    grades: {
+      geo: geo.score,
+      coreWebVitals: coreWebVitals.overallScore,
+      security: security.grade,
+      structuredData: structuredData.score,
+      images: images.score,
+      internalLinking: internalLinking.score,
+      mobile: mobile.score
+    },
+    geo,
+    coreWebVitals,
+    security,
+    structuredData,
+    images,
+    internalLinking,
+    mobile,
+    allIssues,
+    prioritizedRecommendations
+  };
+}
+
 // src/frameworks/index.ts
 var frameworks_exports = {};
 __export(frameworks_exports, {
@@ -30417,165 +33893,266 @@ __export(frameworks_exports, {
 
 // src/frameworks/detector.ts
 var HTML_SIGNATURES = [
+  // ============ JavaScript/TypeScript Frameworks ============
   // Next.js
   {
     framework: "nextjs",
-    patterns: [
-      /__next/,
-      /_next\//,
-      /data-nscript/,
-      /__NEXT_DATA__/,
-      /next\/script/
-    ],
+    language: "typescript",
+    patterns: [/__next/, /_next\//, /data-nscript/, /__NEXT_DATA__/, /next\/script/],
     confidence: "high"
   },
   // Nuxt
   {
     framework: "nuxt",
-    patterns: [
-      /__nuxt/,
-      /_nuxt\//,
-      /data-n-head/,
-      /nuxt-link/,
-      /__NUXT__/
-    ],
+    language: "typescript",
+    patterns: [/__nuxt/, /_nuxt\//, /data-n-head/, /nuxt-link/, /__NUXT__/],
     confidence: "high"
   },
   // Gatsby
   {
     framework: "gatsby",
-    patterns: [
-      /___gatsby/,
-      /gatsby-/,
-      /gatsby-image/,
-      /data-gatsby/
-    ],
+    language: "javascript",
+    patterns: [/___gatsby/, /gatsby-/, /gatsby-image/, /data-gatsby/],
     confidence: "high"
   },
   // Astro
   {
     framework: "astro",
-    patterns: [
-      /astro-/,
-      /data-astro/,
-      /_astro\//
-    ],
+    language: "typescript",
+    patterns: [/astro-/, /data-astro/, /_astro\//],
     confidence: "high"
   },
   // SvelteKit
   {
     framework: "sveltekit",
-    patterns: [
-      /__sveltekit/,
-      /_app\/immutable/,
-      /svelte-kit/
-    ],
+    language: "typescript",
+    patterns: [/__sveltekit/, /_app\/immutable/, /svelte-kit/],
     confidence: "high"
   },
   // Svelte (standalone)
   {
     framework: "svelte",
-    patterns: [
-      /svelte-\w+/,
-      /__svelte/
-    ],
+    language: "javascript",
+    patterns: [/svelte-\w+/, /__svelte/],
     confidence: "medium"
   },
   // Remix
   {
     framework: "remix",
-    patterns: [
-      /__remix/,
-      /remix-/,
-      /data-remix/
-    ],
+    language: "typescript",
+    patterns: [/__remix/, /remix-/, /data-remix/],
+    confidence: "high"
+  },
+  // Solid.js
+  {
+    framework: "solidjs",
+    language: "typescript",
+    patterns: [/solid-/, /data-solid/, /_solid/],
+    confidence: "high"
+  },
+  // Qwik
+  {
+    framework: "qwik",
+    language: "typescript",
+    patterns: [/q:/, /qwik/, /q-/],
     confidence: "high"
   },
-  // React (generic - lower priority than Next/Gatsby/Remix)
+  // Fresh (Deno)
+  {
+    framework: "fresh",
+    language: "typescript",
+    patterns: [/fresh-/, /_frsh\//, /data-fresh/],
+    confidence: "high"
+  },
+  // React (generic - lower priority)
   {
     framework: "react",
-    patterns: [
-      /data-reactroot/,
-      /data-react-helmet/,
-      /_react/,
-      /react-app/
-    ],
+    language: "javascript",
+    patterns: [/data-reactroot/, /data-react-helmet/, /_react/, /react-app/],
     confidence: "medium"
   },
-  // Vue (generic - lower priority than Nuxt)
+  // Vue (generic - lower priority)
   {
     framework: "vue",
-    patterns: [
-      /data-v-[a-f0-9]+/,
-      /v-cloak/,
-      /__vue/
-    ],
+    language: "javascript",
+    patterns: [/data-v-[a-f0-9]+/, /v-cloak/, /__vue/],
     confidence: "medium"
   },
   // Angular
   {
     framework: "angular",
-    patterns: [
-      /ng-version/,
-      /_ngcontent/,
-      /ng-\w+=/,
-      /\[ng/
-    ],
+    language: "typescript",
+    patterns: [/ng-version/, /_ngcontent/, /ng-\w+=/, /\[ng/],
+    confidence: "high"
+  },
+  // ============ Hypermedia Frameworks ============
+  // HTMX
+  {
+    framework: "htmx",
+    language: "unknown",
+    patterns: [/hx-get/, /hx-post/, /hx-trigger/, /hx-swap/, /htmx\.org/],
+    confidence: "high"
+  },
+  // Hotwire/Turbo
+  {
+    framework: "hotwire",
+    language: "ruby",
+    patterns: [/turbo-frame/, /turbo-stream/, /data-turbo/, /stimulus/],
     confidence: "high"
   },
+  // ============ PHP Frameworks ============
   // WordPress
   {
     framework: "wordpress",
-    patterns: [
-      /wp-content/,
-      /wp-includes/,
-      /wp-json/,
-      /wordpress/i
-    ],
+    language: "php",
+    patterns: [/wp-content/, /wp-includes/, /wp-json/, /wordpress/i],
     confidence: "high"
   },
   // Laravel
   {
     framework: "laravel",
-    patterns: [
-      /laravel_session/,
-      /XSRF-TOKEN/,
-      /@csrf/
-    ],
+    language: "php",
+    patterns: [/laravel_session/, /XSRF-TOKEN/, /@csrf/, /laravel/i],
+    confidence: "medium"
+  },
+  // Symfony
+  {
+    framework: "symfony",
+    language: "php",
+    patterns: [/symfony/, /sf2/, /_sf_/, /profiler\.css/],
     confidence: "medium"
   },
+  // ============ Ruby Frameworks ============
   // Rails
   {
     framework: "rails",
-    patterns: [
-      /csrf-token/,
-      /turbolinks/,
-      /data-turbo/,
-      /rails-ujs/
-    ],
+    language: "ruby",
+    patterns: [/csrf-token/, /turbolinks/, /data-turbo/, /rails-ujs/, /action-cable/],
     confidence: "medium"
   },
+  // ============ Python Frameworks ============
   // Django
   {
     framework: "django",
-    patterns: [
-      /csrfmiddlewaretoken/,
-      /django/
-    ],
+    language: "python",
+    patterns: [/csrfmiddlewaretoken/, /django/, /__debug__\//],
+    confidence: "medium"
+  },
+  // Flask
+  {
+    framework: "flask",
+    language: "python",
+    patterns: [/flask/, /werkzeug/i],
+    confidence: "low"
+  },
+  // FastAPI
+  {
+    framework: "fastapi",
+    language: "python",
+    patterns: [/fastapi/, /openapi\.json/],
+    confidence: "low"
+  },
+  // ============ Java Frameworks ============
+  // Spring Boot
+  {
+    framework: "spring",
+    language: "java",
+    patterns: [/spring/, /thymeleaf/, /th:/, /_csrf/],
+    confidence: "medium"
+  },
+  // ============ C# Frameworks ============
+  // ASP.NET Core
+  {
+    framework: "aspnet",
+    language: "csharp",
+    patterns: [/aspnetcore/, /__RequestVerificationToken/, /blazor/, /_framework\/blazor/],
+    confidence: "medium"
+  },
+  // ============ Elixir Frameworks ============
+  // Phoenix
+  {
+    framework: "phoenix",
+    language: "elixir",
+    patterns: [/phx-/, /phoenix/, /live-socket/, /data-phx/],
+    confidence: "high"
+  },
+  // ============ Static Site Generators ============
+  // Hugo
+  {
+    framework: "hugo",
+    language: "go",
+    patterns: [/hugo/, /generator.*hugo/i],
+    confidence: "medium"
+  },
+  // Jekyll
+  {
+    framework: "jekyll",
+    language: "ruby",
+    patterns: [/jekyll/, /generator.*jekyll/i],
+    confidence: "medium"
+  },
+  // Eleventy
+  {
+    framework: "eleventy",
+    language: "javascript",
+    patterns: [/11ty/, /eleventy/, /generator.*eleventy/i],
+    confidence: "medium"
+  },
+  // Pelican
+  {
+    framework: "pelican",
+    language: "python",
+    patterns: [/pelican/, /generator.*pelican/i],
     confidence: "medium"
   }
 ];
 var PACKAGE_DEPENDENCIES = [
-  { framework: "nextjs", packages: ["next"], meta_framework: "react" },
-  { framework: "gatsby", packages: ["gatsby"], meta_framework: "react" },
-  { framework: "remix", packages: ["@remix-run/react", "@remix-run/node"], meta_framework: "react" },
-  { framework: "nuxt", packages: ["nuxt", "nuxt3"], meta_framework: "vue" },
-  { framework: "sveltekit", packages: ["@sveltejs/kit"], meta_framework: "svelte" },
-  { framework: "astro", packages: ["astro"] },
-  { framework: "react", packages: ["react", "react-dom"] },
-  { framework: "vue", packages: ["vue"] },
-  { framework: "angular", packages: ["@angular/core"] },
-  { framework: "svelte", packages: ["svelte"] }
+  // Meta-frameworks (check first - more specific)
+  { framework: "nextjs", language: "typescript", packages: ["next"], meta_framework: "react" },
+  { framework: "gatsby", language: "javascript", packages: ["gatsby"], meta_framework: "react" },
+  { framework: "remix", language: "typescript", packages: ["@remix-run/react", "@remix-run/node"], meta_framework: "react" },
+  { framework: "nuxt", language: "typescript", packages: ["nuxt", "nuxt3"], meta_framework: "vue" },
+  { framework: "sveltekit", language: "typescript", packages: ["@sveltejs/kit"], meta_framework: "svelte" },
+  { framework: "astro", language: "typescript", packages: ["astro"] },
+  { framework: "solidjs", language: "typescript", packages: ["solid-js", "solid-start"] },
+  { framework: "qwik", language: "typescript", packages: ["@builder.io/qwik"] },
+  { framework: "eleventy", language: "javascript", packages: ["@11ty/eleventy"] },
+  // Base frameworks
+  { framework: "react", language: "javascript", packages: ["react", "react-dom"] },
+  { framework: "vue", language: "javascript", packages: ["vue"] },
+  { framework: "angular", language: "typescript", packages: ["@angular/core"] },
+  { framework: "svelte", language: "javascript", packages: ["svelte"] },
+  // HTMX (can be used with any backend)
+  { framework: "htmx", language: "unknown", packages: ["htmx.org"] }
+];
+var GEMFILE_DEPENDENCIES = [
+  { framework: "rails", language: "ruby", packages: ["rails"] },
+  { framework: "hotwire", language: "ruby", packages: ["turbo-rails", "stimulus-rails"], meta_framework: "rails" },
+  { framework: "jekyll", language: "ruby", packages: ["jekyll"] }
+];
+var PYTHON_DEPENDENCIES = [
+  { framework: "django", language: "python", packages: ["django", "Django"] },
+  { framework: "flask", language: "python", packages: ["flask", "Flask"] },
+  { framework: "fastapi", language: "python", packages: ["fastapi", "FastAPI"] },
+  { framework: "pelican", language: "python", packages: ["pelican", "Pelican"] }
+];
+var COMPOSER_DEPENDENCIES = [
+  { framework: "laravel", language: "php", packages: ["laravel/framework"] },
+  { framework: "symfony", language: "php", packages: ["symfony/framework-bundle", "symfony/symfony"] },
+  { framework: "wordpress", language: "php", packages: ["johnpbloch/wordpress-core"] }
+];
+var JAVA_DEPENDENCIES = [
+  { framework: "spring", language: "java", packages: ["spring-boot-starter-web", "org.springframework.boot"] }
+];
+var DOTNET_DEPENDENCIES = [
+  { framework: "aspnet", language: "csharp", packages: ["Microsoft.AspNetCore", "Microsoft.NET.Sdk.Web"] }
+];
+var GO_DEPENDENCIES = [
+  { framework: "hugo", language: "go", packages: ["github.com/gohugoio/hugo"] },
+  { framework: "go", language: "go", packages: ["github.com/gin-gonic/gin", "github.com/labstack/echo", "github.com/gofiber/fiber"] }
+];
+var ELIXIR_DEPENDENCIES = [
+  { framework: "phoenix", language: "elixir", packages: [":phoenix", "phoenix"] }
 ];
 function detectFromHtml(html) {
   for (const signature of HTML_SIGNATURES) {
@@ -30583,6 +34160,7 @@ function detectFromHtml(html) {
       if (pattern.test(html)) {
         return {
           framework: signature.framework,
+          language: signature.language,
           confidence: signature.confidence,
           detected_from: "html"
         };
@@ -30601,6 +34179,7 @@ function detectFromPackageJson(packageJson) {
       if (allDeps[pkg]) {
         return {
           framework: dep.framework,
+          language: dep.language,
           version: allDeps[pkg],
           confidence: "high",
           detected_from: "package.json",
@@ -30611,23 +34190,169 @@ function detectFromPackageJson(packageJson) {
   }
   return null;
 }
+function detectFromGemfile(gemfileContent) {
+  const gemPattern = /gem\s+['"]([^'"]+)['"]/g;
+  const gems = [];
+  let match;
+  while ((match = gemPattern.exec(gemfileContent)) !== null) {
+    gems.push(match[1]);
+  }
+  for (const dep of GEMFILE_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (gems.includes(pkg)) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "gemfile",
+          meta_framework: dep.meta_framework
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromPythonDeps(content) {
+  for (const dep of PYTHON_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      const pattern = new RegExp(`(^|\\s)${pkg.toLowerCase()}[\\s=<>~!]`, "im");
+      if (pattern.test(content.toLowerCase())) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "requirements"
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromComposerJson(composerJson) {
+  const allDeps = {
+    ...composerJson.require,
+    ...composerJson["require-dev"]
+  };
+  for (const dep of COMPOSER_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (allDeps[pkg]) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          version: allDeps[pkg],
+          confidence: "high",
+          detected_from: "composer"
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromPomXml(pomContent) {
+  for (const dep of JAVA_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (pomContent.includes(pkg)) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "pom"
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromCsproj(csprojContent) {
+  for (const dep of DOTNET_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (csprojContent.includes(pkg)) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "csproj"
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromGoMod(goModContent) {
+  for (const dep of GO_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (goModContent.includes(pkg)) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "go.mod"
+        };
+      }
+    }
+  }
+  return null;
+}
+function detectFromMixExs(mixContent) {
+  for (const dep of ELIXIR_DEPENDENCIES) {
+    for (const pkg of dep.packages) {
+      if (mixContent.includes(pkg)) {
+        return {
+          framework: dep.framework,
+          language: dep.language,
+          confidence: "high",
+          detected_from: "mix.exs"
+        };
+      }
+    }
+  }
+  return null;
+}
 function detectFromHeaders(headers) {
   const poweredBy = headers["x-powered-by"]?.toLowerCase() || "";
   const server = headers["server"]?.toLowerCase() || "";
+  const generator = headers["x-generator"]?.toLowerCase() || "";
   if (poweredBy.includes("next.js") || poweredBy.includes("next")) {
-    return { framework: "nextjs", confidence: "high", detected_from: "headers" };
+    return { framework: "nextjs", language: "typescript", confidence: "high", detected_from: "headers" };
   }
   if (poweredBy.includes("nuxt")) {
-    return { framework: "nuxt", confidence: "high", detected_from: "headers" };
+    return { framework: "nuxt", language: "typescript", confidence: "high", detected_from: "headers" };
   }
-  if (poweredBy.includes("express") || poweredBy.includes("koa")) {
+  if (poweredBy.includes("remix")) {
+    return { framework: "remix", language: "typescript", confidence: "high", detected_from: "headers" };
+  }
+  if (poweredBy.includes("phusion") || poweredBy.includes("passenger") || poweredBy.includes("puma") || poweredBy.includes("unicorn")) {
+    return { framework: "rails", language: "ruby", confidence: "medium", detected_from: "headers" };
+  }
+  if (poweredBy.includes("gunicorn") || poweredBy.includes("uvicorn") || poweredBy.includes("daphne")) {
     return null;
   }
-  if (poweredBy.includes("php") || server.includes("php")) {
+  if (poweredBy.includes("php")) {
     return null;
   }
-  if (poweredBy.includes("phusion") || poweredBy.includes("passenger")) {
-    return { framework: "rails", confidence: "medium", detected_from: "headers" };
+  if (server.includes("tomcat") || server.includes("jetty") || poweredBy.includes("spring")) {
+    return { framework: "spring", language: "java", confidence: "medium", detected_from: "headers" };
+  }
+  if (poweredBy.includes("asp.net") || server.includes("kestrel")) {
+    return { framework: "aspnet", language: "csharp", confidence: "high", detected_from: "headers" };
+  }
+  if (poweredBy.includes("phoenix") || poweredBy.includes("cowboy")) {
+    return { framework: "phoenix", language: "elixir", confidence: "medium", detected_from: "headers" };
+  }
+  if (server.includes("gin") || server.includes("echo") || server.includes("fiber")) {
+    return { framework: "go", language: "go", confidence: "medium", detected_from: "headers" };
+  }
+  if (generator.includes("hugo")) {
+    return { framework: "hugo", language: "go", confidence: "high", detected_from: "headers" };
+  }
+  if (generator.includes("jekyll")) {
+    return { framework: "jekyll", language: "ruby", confidence: "high", detected_from: "headers" };
+  }
+  if (generator.includes("eleventy") || generator.includes("11ty")) {
+    return { framework: "eleventy", language: "javascript", confidence: "high", detected_from: "headers" };
+  }
+  if (generator.includes("pelican")) {
+    return { framework: "pelican", language: "python", confidence: "high", detected_from: "headers" };
   }
   return null;
 }
@@ -30636,6 +34361,34 @@ function detectFramework4(options) {
     const result = detectFromPackageJson(options.packageJson);
     if (result) return result;
   }
+  if (options.gemfileContent) {
+    const result = detectFromGemfile(options.gemfileContent);
+    if (result) return result;
+  }
+  if (options.requirementsContent) {
+    const result = detectFromPythonDeps(options.requirementsContent);
+    if (result) return result;
+  }
+  if (options.composerJson) {
+    const result = detectFromComposerJson(options.composerJson);
+    if (result) return result;
+  }
+  if (options.pomXmlContent) {
+    const result = detectFromPomXml(options.pomXmlContent);
+    if (result) return result;
+  }
+  if (options.csprojContent) {
+    const result = detectFromCsproj(options.csprojContent);
+    if (result) return result;
+  }
+  if (options.goModContent) {
+    const result = detectFromGoMod(options.goModContent);
+    if (result) return result;
+  }
+  if (options.mixExsContent) {
+    const result = detectFromMixExs(options.mixExsContent);
+    if (result) return result;
+  }
   if (options.headers) {
     const result = detectFromHeaders(options.headers);
     if (result) return result;
@@ -30646,40 +34399,70 @@ function detectFramework4(options) {
   }
   if (options.files) {
     if (options.files.some((f) => f.includes("next.config"))) {
-      return { framework: "nextjs", confidence: "high", detected_from: "files" };
+      return { framework: "nextjs", language: "typescript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f.includes("nuxt.config"))) {
-      return { framework: "nuxt", confidence: "high", detected_from: "files" };
+      return { framework: "nuxt", language: "typescript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f.includes("astro.config"))) {
-      return { framework: "astro", confidence: "high", detected_from: "files" };
+      return { framework: "astro", language: "typescript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f.includes("svelte.config"))) {
-      return { framework: "sveltekit", confidence: "high", detected_from: "files" };
+      return { framework: "sveltekit", language: "typescript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f.includes("angular.json"))) {
-      return { framework: "angular", confidence: "high", detected_from: "files" };
+      return { framework: "angular", language: "typescript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f.includes("gatsby-config"))) {
-      return { framework: "gatsby", confidence: "high", detected_from: "files" };
+      return { framework: "gatsby", language: "javascript", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes("remix.config"))) {
+      return { framework: "remix", language: "typescript", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes(".eleventy.js") || f.includes("eleventy.config"))) {
+      return { framework: "eleventy", language: "javascript", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f === "wp-config.php")) {
-      return { framework: "wordpress", confidence: "high", detected_from: "files" };
+      return { framework: "wordpress", language: "php", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f === "artisan")) {
-      return { framework: "laravel", confidence: "high", detected_from: "files" };
+      return { framework: "laravel", language: "php", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes("symfony.lock") || f.includes("config/bundles.php"))) {
+      return { framework: "symfony", language: "php", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f === "manage.py")) {
-      return { framework: "django", confidence: "high", detected_from: "files" };
+      return { framework: "django", language: "python", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes("pelicanconf.py"))) {
+      return { framework: "pelican", language: "python", confidence: "high", detected_from: "files" };
     }
     if (options.files.some((f) => f === "Gemfile") && options.files.some((f) => f.includes("config/routes.rb"))) {
-      return { framework: "rails", confidence: "high", detected_from: "files" };
+      return { framework: "rails", language: "ruby", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f === "_config.yml") && options.files.some((f) => f === "Gemfile")) {
+      return { framework: "jekyll", language: "ruby", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes("hugo.toml") || f.includes("hugo.yaml") || f.includes("config.toml"))) {
+      return { framework: "hugo", language: "go", confidence: "high", detected_from: "files" };
+    }
+    if (options.files.some((f) => f.includes("pom.xml") || f.includes("build.gradle"))) {
+      if (options.files.some((f) => f.includes("src/main/resources/application"))) {
+        return { framework: "spring", language: "java", confidence: "high", detected_from: "files" };
+      }
+    }
+    if (options.files.some((f) => f.endsWith(".csproj"))) {
+      return { framework: "aspnet", language: "csharp", confidence: "medium", detected_from: "files" };
+    }
+    if (options.files.some((f) => f === "mix.exs") && options.files.some((f) => f.includes("lib") && f.includes("_web"))) {
+      return { framework: "phoenix", language: "elixir", confidence: "high", detected_from: "files" };
     }
   }
-  return { framework: "unknown", confidence: "low", detected_from: "html" };
+  return { framework: "unknown", language: "unknown", confidence: "low", detected_from: "html" };
 }
 function getFrameworkDisplayName(framework) {
   const names = {
+    // JavaScript/TypeScript
     react: "React",
     nextjs: "Next.js",
     vue: "Vue.js",
@@ -30690,10 +34473,35 @@ function getFrameworkDisplayName(framework) {
     astro: "Astro",
     remix: "Remix",
     gatsby: "Gatsby",
+    solidjs: "Solid.js",
+    qwik: "Qwik",
+    fresh: "Fresh (Deno)",
+    // Ruby
     rails: "Ruby on Rails",
-    laravel: "Laravel",
+    // Python
     django: "Django",
+    flask: "Flask",
+    fastapi: "FastAPI",
+    // PHP
+    laravel: "Laravel",
+    symfony: "Symfony",
     wordpress: "WordPress",
+    // Java
+    spring: "Spring Boot",
+    // C#
+    aspnet: "ASP.NET Core",
+    // Go
+    go: "Go (Gin/Echo/Fiber)",
+    // Elixir
+    phoenix: "Phoenix",
+    // Hypermedia
+    htmx: "HTMX",
+    hotwire: "Hotwire/Turbo",
+    // Static Site Generators
+    hugo: "Hugo",
+    jekyll: "Jekyll",
+    eleventy: "Eleventy (11ty)",
+    pelican: "Pelican",
     unknown: "Unknown"
   };
   return names[framework];
@@ -30702,6 +34510,7 @@ function getFrameworkDisplayName(framework) {
 // src/frameworks/suggestion-engine.ts
 import { parse as parseYaml2 } from "yaml";
 var RECIPES = {
+  // JavaScript/TypeScript
   react: null,
   nextjs: null,
   vue: null,
@@ -30712,10 +34521,36 @@ var RECIPES = {
   astro: null,
   remix: null,
   gatsby: null,
+  solidjs: null,
+  qwik: null,
+  fresh: null,
+  // Ruby
   rails: null,
-  laravel: null,
+  // Python
   django: null,
+  flask: null,
+  fastapi: null,
+  // PHP
+  laravel: null,
+  symfony: null,
   wordpress: null,
+  // Java
+  spring: null,
+  // C#
+  aspnet: null,
+  // Go
+  go: null,
+  // Elixir
+  phoenix: null,
+  // Hypermedia
+  htmx: null,
+  hotwire: null,
+  // Static Site Generators
+  hugo: null,
+  jekyll: null,
+  eleventy: null,
+  pelican: null,
+  // Unknown
   unknown: null
 };
 var RECIPE_CONTENT = {};
@@ -30898,7 +34733,7 @@ function runSyncAudit(url, html, checksLimit) {
   } catch (e) {
   }
   try {
-    const structured = analyzeStructuredData(html, url);
+    const structured = analyzeStructuredData2(html, url);
     allIssues.push(...structured.issues);
   } catch (e) {
   }
@@ -31119,7 +34954,7 @@ export {
   analyzeHeadings,
   analyzeHeadline,
   analyzeHreflang,
-  analyzeImages,
+  analyzeImages2 as analyzeImages,
   analyzeInteractiveTools,
   analyzeKeywordDensity,
   analyzeKeywordPlacement,
@@ -31139,13 +34974,14 @@ export {
   analyzeResponsiveImages,
   analyzeSERPPreview,
   analyzeSecurity,
-  analyzeSecurityHeaders,
+  analyzeSecurityHeaders2 as analyzeSecurityHeaders,
   analyzeSocialMeta,
-  analyzeStructuredData,
+  analyzeStructuredData2 as analyzeStructuredData,
   analyzeTopicalClusters,
   analyzeTrackerBloat,
   analyzeUrl,
   analyzeUrlSafety,
+  analyzers_exports as analyzers,
   applyFixes,
   buildGSCApiRequest,
   buildGSCRequest,
@@ -31241,6 +35077,7 @@ export {
   generateAICitableContent,
   generateAllFixes,
   generateAngularSEOService,
+  generateAspNetCoreSEO,
   generateAstroBaseHead,
   generateAstroMeta,
   generateBlogPost,
@@ -31249,7 +35086,9 @@ export {
   generateCommitSummary,
   generateComparisonTable,
   generateCompleteSocialMetaSetup,
+  generateDjangoSEOHelper,
   generateDuplicateIssues,
+  generateEleventySEO,
   generateFAQSchema2 as generateFAQSchema,
   generateFixes,
   generateGA4EnvTemplate,
@@ -31259,11 +35098,16 @@ export {
   generateGEOReport,
   generateGSCVerificationTag,
   generateGitHubActionSetup,
+  generateGoSEO,
   generateHTMLReport,
   generateHTMLSocialMeta,
+  generateHTMXSEO,
   generateHeadlineVariations,
+  generateHugoSEO,
+  generateJekyllSEO,
   generateJsonReport,
   generateKeyFacts,
+  generateLaravelSEOHelper,
   generateMarkdownReport,
   generateNextAppMetadata,
   generateNextJsAppRouterMetadata,
@@ -31272,12 +35116,16 @@ export {
   generateNuxtSEOHead,
   generatePDFReport,
   generatePRDescription,
+  generatePhoenixSEO,
+  generateRailsSEOHelper,
   generateReactHelmetSocialMeta,
   generateReactSEOHead,
   generateRecommendationQueries,
   generateRemixMeta,
+  generateRemixSEO,
   generateSecretsDoc,
   generateSocialMetaFix,
+  generateSpringBootSEO,
   generateSvelteKitMeta,
   generateSvelteKitSEOHead,
   generateUncertaintyQuestions,
@@ -31289,6 +35137,7 @@ export {
   getDateRange,
   getExpandedSuggestions,
   getFrameworkSpecificFix,
+  getFrameworkSpecificFixExtended,
   getGSCSetupInstructions,
   getGitUser,
   getKeywordData,