npm - @rankcli/agent-runtime - Versions diffs - 0.0.1 - Mend

@rankcli/agent-runtime 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (178) hide show

package/README.md +242 -0
package/dist/analyzer-2CSWIQGD.mjs +6 -0
package/dist/chunk-YNZYHEYM.mjs +774 -0
package/dist/index.d.mts +4012 -0
package/dist/index.d.ts +4012 -0
package/dist/index.js +29672 -0
package/dist/index.mjs +28602 -0
package/package.json +53 -0
package/scripts/build-deno.ts +134 -0
package/src/audit/ai/analyzer.ts +347 -0
package/src/audit/ai/index.ts +29 -0
package/src/audit/ai/prompts/content-analysis.ts +271 -0
package/src/audit/ai/types.ts +179 -0
package/src/audit/checks/additional-checks.ts +439 -0
package/src/audit/checks/ai-citation-worthiness.ts +399 -0
package/src/audit/checks/ai-content-structure.ts +325 -0
package/src/audit/checks/ai-readiness.ts +339 -0
package/src/audit/checks/anchor-text.ts +179 -0
package/src/audit/checks/answer-conciseness.ts +322 -0
package/src/audit/checks/asset-minification.ts +270 -0
package/src/audit/checks/bing-optimization.ts +206 -0
package/src/audit/checks/brand-mention-optimization.ts +349 -0
package/src/audit/checks/caching-headers.ts +305 -0
package/src/audit/checks/canonical-advanced.ts +150 -0
package/src/audit/checks/canonical-domain.ts +196 -0
package/src/audit/checks/citation-quality.ts +358 -0
package/src/audit/checks/client-rendering.ts +542 -0
package/src/audit/checks/color-contrast.ts +342 -0
package/src/audit/checks/content-freshness.ts +170 -0
package/src/audit/checks/content-science.ts +589 -0
package/src/audit/checks/conversion-elements.ts +526 -0
package/src/audit/checks/crawlability.ts +220 -0
package/src/audit/checks/directory-listing.ts +172 -0
package/src/audit/checks/dom-analysis.ts +191 -0
package/src/audit/checks/dom-size.ts +246 -0
package/src/audit/checks/duplicate-content.ts +194 -0
package/src/audit/checks/eeat-signals.ts +990 -0
package/src/audit/checks/entity-seo.ts +396 -0
package/src/audit/checks/featured-snippet.ts +473 -0
package/src/audit/checks/freshness-signals.ts +443 -0
package/src/audit/checks/funnel-intent.ts +463 -0
package/src/audit/checks/hreflang.ts +174 -0
package/src/audit/checks/html-compliance.ts +302 -0
package/src/audit/checks/image-dimensions.ts +167 -0
package/src/audit/checks/images.ts +160 -0
package/src/audit/checks/indexnow.ts +275 -0
package/src/audit/checks/interactive-tools.ts +475 -0
package/src/audit/checks/internal-link-graph.ts +436 -0
package/src/audit/checks/keyword-analysis.ts +239 -0
package/src/audit/checks/keyword-cannibalization.ts +385 -0
package/src/audit/checks/keyword-placement.ts +471 -0
package/src/audit/checks/links.ts +203 -0
package/src/audit/checks/llms-txt.ts +224 -0
package/src/audit/checks/local-seo.ts +296 -0
package/src/audit/checks/mobile.ts +167 -0
package/src/audit/checks/modern-images.ts +226 -0
package/src/audit/checks/navboost-signals.ts +395 -0
package/src/audit/checks/on-page.ts +209 -0
package/src/audit/checks/page-resources.ts +285 -0
package/src/audit/checks/pagination.ts +180 -0
package/src/audit/checks/performance.ts +153 -0
package/src/audit/checks/platform-presence.ts +580 -0
package/src/audit/checks/redirect-analysis.ts +153 -0
package/src/audit/checks/redirect-chain.ts +389 -0
package/src/audit/checks/resource-hints.ts +420 -0
package/src/audit/checks/responsive-css.ts +247 -0
package/src/audit/checks/responsive-images.ts +396 -0
package/src/audit/checks/review-ecosystem.ts +415 -0
package/src/audit/checks/robots-validation.ts +373 -0
package/src/audit/checks/security-headers.ts +172 -0
package/src/audit/checks/security.ts +144 -0
package/src/audit/checks/serp-preview.ts +251 -0
package/src/audit/checks/site-maturity.ts +444 -0
package/src/audit/checks/social-meta.test.ts +275 -0
package/src/audit/checks/social-meta.ts +134 -0
package/src/audit/checks/soft-404.ts +151 -0
package/src/audit/checks/structured-data.ts +238 -0
package/src/audit/checks/tech-detection.ts +496 -0
package/src/audit/checks/topical-clusters.ts +435 -0
package/src/audit/checks/tracker-bloat.ts +462 -0
package/src/audit/checks/tracking-verification.test.ts +371 -0
package/src/audit/checks/tracking-verification.ts +636 -0
package/src/audit/checks/url-safety.ts +682 -0
package/src/audit/deno-entry.ts +66 -0
package/src/audit/discovery/index.ts +15 -0
package/src/audit/discovery/link-crawler.ts +232 -0
package/src/audit/discovery/repo-routes.ts +347 -0
package/src/audit/engine.ts +620 -0
package/src/audit/fixes/index.ts +209 -0
package/src/audit/fixes/social-meta-fixes.test.ts +329 -0
package/src/audit/fixes/social-meta-fixes.ts +463 -0
package/src/audit/index.ts +74 -0
package/src/audit/runner.test.ts +299 -0
package/src/audit/runner.ts +130 -0
package/src/audit/types.ts +1953 -0
package/src/content/featured-snippet.ts +367 -0
package/src/content/generator.test.ts +534 -0
package/src/content/generator.ts +501 -0
package/src/content/headline.ts +317 -0
package/src/content/index.ts +62 -0
package/src/content/intent.ts +258 -0
package/src/content/keyword-density.ts +349 -0
package/src/content/readability.ts +262 -0
package/src/executor.ts +336 -0
package/src/fixer.ts +416 -0
package/src/frameworks/detector.test.ts +248 -0
package/src/frameworks/detector.ts +371 -0
package/src/frameworks/index.ts +68 -0
package/src/frameworks/recipes/angular.yaml +171 -0
package/src/frameworks/recipes/astro.yaml +206 -0
package/src/frameworks/recipes/django.yaml +180 -0
package/src/frameworks/recipes/laravel.yaml +137 -0
package/src/frameworks/recipes/nextjs.yaml +268 -0
package/src/frameworks/recipes/nuxt.yaml +175 -0
package/src/frameworks/recipes/rails.yaml +188 -0
package/src/frameworks/recipes/react.yaml +202 -0
package/src/frameworks/recipes/sveltekit.yaml +154 -0
package/src/frameworks/recipes/vue.yaml +137 -0
package/src/frameworks/recipes/wordpress.yaml +209 -0
package/src/frameworks/suggestion-engine.ts +320 -0
package/src/geo/geo-content.test.ts +305 -0
package/src/geo/geo-content.ts +266 -0
package/src/geo/geo-history.test.ts +473 -0
package/src/geo/geo-history.ts +433 -0
package/src/geo/geo-tracker.test.ts +359 -0
package/src/geo/geo-tracker.ts +411 -0
package/src/geo/index.ts +10 -0
package/src/git/commit-helper.test.ts +261 -0
package/src/git/commit-helper.ts +329 -0
package/src/git/index.ts +12 -0
package/src/git/pr-helper.test.ts +284 -0
package/src/git/pr-helper.ts +307 -0
package/src/index.ts +66 -0
package/src/keywords/ai-keyword-engine.ts +1062 -0
package/src/keywords/ai-summarizer.ts +387 -0
package/src/keywords/ci-mode.ts +555 -0
package/src/keywords/engine.ts +359 -0
package/src/keywords/index.ts +151 -0
package/src/keywords/llm-judge.ts +357 -0
package/src/keywords/nlp-analysis.ts +706 -0
package/src/keywords/prioritizer.ts +295 -0
package/src/keywords/site-crawler.ts +342 -0
package/src/keywords/sources/autocomplete.ts +139 -0
package/src/keywords/sources/competitive-search.ts +450 -0
package/src/keywords/sources/competitor-analysis.ts +374 -0
package/src/keywords/sources/dataforseo.ts +206 -0
package/src/keywords/sources/free-sources.ts +294 -0
package/src/keywords/sources/gsc.ts +123 -0
package/src/keywords/topic-grouping.ts +327 -0
package/src/keywords/types.ts +144 -0
package/src/keywords/wizard.ts +457 -0
package/src/loader.ts +40 -0
package/src/reports/index.ts +7 -0
package/src/reports/report-generator.test.ts +293 -0
package/src/reports/report-generator.ts +713 -0
package/src/scheduler/alerts.test.ts +458 -0
package/src/scheduler/alerts.ts +328 -0
package/src/scheduler/index.ts +8 -0
package/src/scheduler/scheduled-audit.test.ts +377 -0
package/src/scheduler/scheduled-audit.ts +149 -0
package/src/test/integration-test.ts +325 -0
package/src/tools/analyzer.ts +373 -0
package/src/tools/crawl.ts +293 -0
package/src/tools/files.ts +301 -0
package/src/tools/h1-fixer.ts +249 -0
package/src/tools/index.ts +67 -0
package/src/tracking/github-action.ts +326 -0
package/src/tracking/google-analytics.ts +265 -0
package/src/tracking/index.ts +45 -0
package/src/tracking/report-generator.ts +386 -0
package/src/tracking/search-console.ts +335 -0
package/src/types.ts +134 -0
package/src/utils/http.ts +302 -0
package/src/wasm-adapter.ts +297 -0
package/src/wasm-entry.ts +14 -0
package/tsconfig.json +17 -0
package/tsup.wasm.config.ts +26 -0
package/vitest.config.ts +15 -0

package/src/audit/fixes/index.ts ADDED Viewed

@@ -0,0 +1,209 @@
+/**
+ * Fix generators for SEO issues
+ *
+ * These modules generate framework-specific code to fix SEO issues
+ * detected during audits.
+ */
+import type { AuditReport, AuditIssue } from '../types.js';
+// Alias for clarity
+type SEOIssue = AuditIssue;
+export * from './social-meta-fixes.js';
+export interface FixFile {
+  path: string;
+  content: string;
+}
+export interface FixResult {
+  category: string;
+  issues: string[];
+  files: FixFile[];
+}
+/**
+ * Groups issues by category
+ */
+function groupIssuesByCategory(issues: SEOIssue[]): Map<string, SEOIssue[]> {
+  const grouped = new Map<string, SEOIssue[]>();
+  for (const issue of issues) {
+    const existing = grouped.get(issue.category) || [];
+    existing.push(issue);
+    grouped.set(issue.category, existing);
+  }
+  return grouped;
+}
+/**
+ * Generates fixes for on-page issues (titles, meta descriptions, headings)
+ */
+function generateOnPageFixes(issues: SEOIssue[]): FixResult | null {
+  if (issues.length === 0) return null;
+  const issueCodes = issues.map((i) => i.code);
+  const files: FixFile[] = [];
+  // Generate appropriate fixes based on detected issues
+  if (issueCodes.includes('TITLE_MISSING') || issueCodes.includes('META_DESC_MISSING')) {
+    files.push({
+      path: 'index.html',
+      content: `<head>
+  <title>Site Title - Your tagline here</title>
+  <meta name="description" content="A compelling description of your site in 150-160 characters." />
+</head>`,
+    });
+  }
+  if (files.length === 0) return null;
+  return {
+    category: 'on-page',
+    issues: issueCodes,
+    files,
+  };
+}
+/**
+ * Generates fixes for social meta issues (Open Graph, Twitter Cards)
+ */
+function generateSocialMetaFixes(issues: SEOIssue[]): FixResult | null {
+  if (issues.length === 0) return null;
+  const issueCodes = issues.map((i) => i.code);
+  const files: FixFile[] = [];
+  // Generate OG tags
+  if (issueCodes.some((c) => c.startsWith('OG_'))) {
+    files.push({
+      path: 'index.html',
+      content: `<meta property="og:title" content="Site Title" />
+<meta property="og:description" content="Site description" />
+<meta property="og:image" content="https://example.com/og-image.png" />
+<meta property="og:url" content="https://example.com" />
+<meta property="og:type" content="website" />`,
+    });
+  }
+  // Generate Twitter Card tags
+  if (issueCodes.some((c) => c.startsWith('TWITTER_'))) {
+    files.push({
+      path: 'index.html',
+      content: `<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content="Site Title" />
+<meta name="twitter:description" content="Site description" />
+<meta name="twitter:image" content="https://example.com/twitter-image.png" />`,
+    });
+  }
+  if (files.length === 0) return null;
+  return {
+    category: 'social-meta',
+    issues: issueCodes,
+    files,
+  };
+}
+/**
+ * Generates fixes for structured data issues (JSON-LD, Schema.org)
+ */
+function generateStructuredDataFixes(issues: SEOIssue[]): FixResult | null {
+  if (issues.length === 0) return null;
+  const issueCodes = issues.map((i) => i.code);
+  const files: FixFile[] = [];
+  if (issueCodes.includes('SCHEMA_MISSING')) {
+    files.push({
+      path: 'index.html',
+      content: `<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "Site Name",
+  "url": "https://example.com"
+}
+</script>`,
+    });
+  }
+  if (files.length === 0) return null;
+  return {
+    category: 'structured-data',
+    issues: issueCodes,
+    files,
+  };
+}
+/**
+ * Generates fixes for crawlability issues (robots.txt, sitemap)
+ */
+function generateCrawlabilityFixes(issues: SEOIssue[]): FixResult | null {
+  if (issues.length === 0) return null;
+  const issueCodes = issues.map((i) => i.code);
+  const files: FixFile[] = [];
+  if (issueCodes.includes('ROBOTS_TXT_MISSING')) {
+    files.push({
+      path: 'robots.txt',
+      content: `User-agent: *
+Allow: /
+Sitemap: https://example.com/sitemap.xml`,
+    });
+  }
+  if (issueCodes.includes('SITEMAP_MISSING')) {
+    files.push({
+      path: 'sitemap.xml',
+      content: `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://example.com/</loc>
+    <lastmod>${new Date().toISOString().split('T')[0]}</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+</urlset>`,
+    });
+  }
+  if (files.length === 0) return null;
+  return {
+    category: 'crawlability',
+    issues: issueCodes,
+    files,
+  };
+}
+/**
+ * Generates all fixes for issues found in an audit report
+ */
+export function generateAllFixes(report: AuditReport): FixResult[] {
+  const fixes: FixResult[] = [];
+  const groupedIssues = groupIssuesByCategory(report.issues);
+  // Generate fixes for each category
+  const onPageIssues = groupedIssues.get('on-page') || [];
+  const onPageFix = generateOnPageFixes(onPageIssues);
+  if (onPageFix) fixes.push(onPageFix);
+  const socialMetaIssues = groupedIssues.get('social-meta') || [];
+  const socialMetaFix = generateSocialMetaFixes(socialMetaIssues);
+  if (socialMetaFix) fixes.push(socialMetaFix);
+  const structuredDataIssues = groupedIssues.get('structured-data') || [];
+  const structuredDataFix = generateStructuredDataFixes(structuredDataIssues);
+  if (structuredDataFix) fixes.push(structuredDataFix);
+  const crawlabilityIssues = groupedIssues.get('crawlability') || [];
+  const crawlabilityFix = generateCrawlabilityFixes(crawlabilityIssues);
+  if (crawlabilityFix) fixes.push(crawlabilityFix);
+  return fixes;
+}

package/src/audit/fixes/social-meta-fixes.test.ts ADDED Viewed

@@ -0,0 +1,329 @@
+import { describe, it, expect } from 'vitest';
+import {
+  detectFramework,
+  generateHTMLSocialMeta,
+  generateReactHelmetSocialMeta,
+  generateNextAppMetadata,
+  generateNextPagesHead,
+  generateAstroMeta,
+  generateRemixMeta,
+  generateSvelteKitMeta,
+  generateSocialMetaFix,
+  generateCompleteSocialMetaSetup,
+  OG_IMAGE_SPECS,
+  type SocialMetaConfig,
+} from './social-meta-fixes.js';
+describe('social-meta-fixes', () => {
+  const defaultConfig: SocialMetaConfig = {
+    title: 'Test Page',
+    description: 'A test description for SEO',
+    image: 'https://example.com/og.png',
+    url: 'https://example.com',
+    siteName: 'Example Site',
+    twitterSite: '@example',
+    twitterCreator: '@author',
+    type: 'website',
+    locale: 'en_US',
+  };
+  describe('detectFramework', () => {
+    it('detects Next.js App Router', () => {
+      // The path check looks for '/app/' or '\\app\\' in the file paths
+      const files = ['next.config.js', 'src/app/page.tsx', 'src/app/layout.tsx'];
+      expect(detectFramework(files)).toBe('nextjs-app');
+    });
+    it('detects Next.js Pages Router', () => {
+      const files = ['next.config.js', 'pages/index.tsx', 'pages/_app.tsx'];
+      expect(detectFramework(files)).toBe('nextjs-pages');
+    });
+    it('detects Astro', () => {
+      const files = ['astro.config.mjs', 'src/pages/index.astro'];
+      expect(detectFramework(files)).toBe('astro');
+    });
+    it('detects Remix', () => {
+      const files = ['remix.config.js', 'app/root.tsx'];
+      expect(detectFramework(files)).toBe('remix');
+    });
+    it('detects SvelteKit', () => {
+      const files = ['svelte.config.js', 'src/routes/+page.svelte'];
+      expect(detectFramework(files)).toBe('sveltekit');
+    });
+    it('detects Vite React', () => {
+      const files = ['vite.config.ts', 'src/App.tsx', 'index.html'];
+      expect(detectFramework(files)).toBe('vite-react');
+    });
+    it('detects plain React', () => {
+      const files = ['src/App.tsx', 'src/index.tsx'];
+      expect(detectFramework(files)).toBe('react');
+    });
+    it('defaults to HTML', () => {
+      const files = ['index.html', 'styles.css'];
+      expect(detectFramework(files)).toBe('html');
+    });
+    it('is case-insensitive for config files', () => {
+      // Config files are lowercased, but path check needs /app/ or \\app\\
+      const files = ['NEXT.CONFIG.JS', 'src/app/page.tsx'];
+      expect(detectFramework(files)).toBe('nextjs-app');
+    });
+  });
+  describe('generateHTMLSocialMeta', () => {
+    it('generates complete HTML meta tags', () => {
+      const result = generateHTMLSocialMeta(defaultConfig);
+      // Primary meta tags
+      expect(result).toContain('<title>Test Page</title>');
+      expect(result).toContain('<meta name="title" content="Test Page" />');
+      expect(result).toContain('<meta name="description" content="A test description for SEO" />');
+      // Open Graph tags
+      expect(result).toContain('<meta property="og:type" content="website" />');
+      expect(result).toContain('<meta property="og:url" content="https://example.com" />');
+      expect(result).toContain('<meta property="og:title" content="Test Page" />');
+      expect(result).toContain('<meta property="og:image" content="https://example.com/og.png" />');
+      expect(result).toContain('<meta property="og:site_name" content="Example Site" />');
+      expect(result).toContain('<meta property="og:locale" content="en_US" />');
+      // Twitter tags
+      expect(result).toContain('<meta name="twitter:card" content="summary_large_image" />');
+      expect(result).toContain('<meta name="twitter:title" content="Test Page" />');
+      expect(result).toContain('<meta name="twitter:site" content="@example" />');
+      expect(result).toContain('<meta name="twitter:creator" content="@author" />');
+    });
+    it('omits optional fields when not provided', () => {
+      const minimalConfig: SocialMetaConfig = {
+        title: 'Minimal',
+        description: 'Minimal description',
+        image: 'https://example.com/og.png',
+        url: 'https://example.com',
+      };
+      const result = generateHTMLSocialMeta(minimalConfig);
+      expect(result).not.toContain('og:site_name');
+      expect(result).not.toContain('twitter:site');
+      expect(result).not.toContain('twitter:creator');
+    });
+  });
+  describe('generateReactHelmetSocialMeta', () => {
+    it('generates React Helmet component', () => {
+      const result = generateReactHelmetSocialMeta(defaultConfig);
+      expect(result).toContain("import { Helmet } from 'react-helmet-async'");
+      expect(result).toContain('export function SEO');
+      expect(result).toContain('<Helmet>');
+      expect(result).toContain('<title>{title}</title>');
+      expect(result).toContain('og:type');
+      expect(result).toContain('twitter:card');
+    });
+    it('includes default props', () => {
+      const result = generateReactHelmetSocialMeta(defaultConfig);
+      expect(result).toContain('title = "Test Page"');
+      expect(result).toContain('description = "A test description for SEO"');
+    });
+  });
+  describe('generateNextAppMetadata', () => {
+    it('generates Next.js App Router metadata', () => {
+      const result = generateNextAppMetadata(defaultConfig);
+      expect(result).toContain("import type { Metadata } from 'next'");
+      expect(result).toContain('export const metadata: Metadata');
+      expect(result).toContain('title: "Test Page"');
+      expect(result).toContain('openGraph:');
+      expect(result).toContain('twitter:');
+      expect(result).toContain("card: 'summary_large_image'");
+    });
+    it('includes image dimensions', () => {
+      const result = generateNextAppMetadata(defaultConfig);
+      expect(result).toContain('width: 1200');
+      expect(result).toContain('height: 630');
+    });
+  });
+  describe('generateNextPagesHead', () => {
+    it('generates Next.js Pages Router Head component', () => {
+      const result = generateNextPagesHead(defaultConfig);
+      expect(result).toContain("import Head from 'next/head'");
+      expect(result).toContain('<Head>');
+      expect(result).toContain('<title>Test Page</title>');
+      expect(result).toContain('og:title');
+      expect(result).toContain('twitter:card');
+    });
+  });
+  describe('generateAstroMeta', () => {
+    it('generates Astro component with frontmatter', () => {
+      const result = generateAstroMeta(defaultConfig);
+      expect(result).toContain('---');
+      expect(result).toContain('export interface Props');
+      expect(result).toContain('Astro.props');
+      expect(result).toContain('<title>{title}</title>');
+      expect(result).toContain('og:type');
+      expect(result).toContain('twitter:card');
+    });
+    it('uses Astro.url for dynamic URL', () => {
+      const result = generateAstroMeta(defaultConfig);
+      expect(result).toContain('url = Astro.url.href');
+    });
+  });
+  describe('generateRemixMeta', () => {
+    it('generates Remix meta function', () => {
+      const result = generateRemixMeta(defaultConfig);
+      expect(result).toContain("import type { MetaFunction } from \"@remix-run/node\"");
+      expect(result).toContain('export const meta: MetaFunction');
+      expect(result).toContain('return [');
+      expect(result).toContain('{ title: "Test Page" }');
+      expect(result).toContain('{ property: "og:title"');
+      expect(result).toContain('{ name: "twitter:card"');
+    });
+  });
+  describe('generateSvelteKitMeta', () => {
+    it('generates SvelteKit svelte:head', () => {
+      const result = generateSvelteKitMeta(defaultConfig);
+      expect(result).toContain('<svelte:head>');
+      expect(result).toContain('<title>Test Page</title>');
+      expect(result).toContain('og:type');
+      expect(result).toContain('twitter:card');
+    });
+  });
+  describe('generateSocialMetaFix', () => {
+    const existingData = {
+      openGraph: {},
+      twitter: {},
+      hasFavicon: false,
+    };
+    it('generates fix for missing OG title', () => {
+      const fix = generateSocialMetaFix(
+        'OG_TITLE_MISSING',
+        'html',
+        existingData,
+        { url: 'https://example.com', title: 'My Page' }
+      );
+      expect(fix.issueCode).toBe('OG_TITLE_MISSING');
+      expect(fix.framework).toBe('html');
+      expect(fix.filePath).toBe('index.html');
+      expect(fix.after).toContain('og:title');
+      expect(fix.explanation).toContain('Open Graph title');
+    });
+    it('generates fix for missing Twitter Card', () => {
+      const fix = generateSocialMetaFix(
+        'TWITTER_CARD_MISSING',
+        'react',
+        existingData,
+        { url: 'https://example.com' }
+      );
+      expect(fix.issueCode).toBe('TWITTER_CARD_MISSING');
+      expect(fix.filePath).toBe('src/components/SEO.tsx');
+      expect(fix.after).toContain('twitter:card');
+      expect(fix.after).toContain('summary_large_image');
+    });
+    it('uses correct file paths for each framework', () => {
+      const frameworks = [
+        { framework: 'html' as const, expectedPath: 'index.html' },
+        { framework: 'react' as const, expectedPath: 'src/components/SEO.tsx' },
+        { framework: 'vite-react' as const, expectedPath: 'index.html' },
+        { framework: 'nextjs-app' as const, expectedPath: 'app/layout.tsx' },
+        { framework: 'nextjs-pages' as const, expectedPath: 'pages/_app.tsx' },
+        { framework: 'astro' as const, expectedPath: 'src/components/BaseHead.astro' },
+        { framework: 'remix' as const, expectedPath: 'app/root.tsx' },
+        { framework: 'sveltekit' as const, expectedPath: 'src/routes/+layout.svelte' },
+      ];
+      frameworks.forEach(({ framework, expectedPath }) => {
+        const fix = generateSocialMetaFix(
+          'OG_TITLE_MISSING',
+          framework,
+          existingData,
+          { url: 'https://example.com' }
+        );
+        expect(fix.filePath).toBe(expectedPath);
+      });
+    });
+    it('throws error for unknown issue code', () => {
+      expect(() =>
+        generateSocialMetaFix(
+          'UNKNOWN_ISSUE',
+          'html',
+          existingData,
+          { url: 'https://example.com' }
+        )
+      ).toThrow('Unknown issue code: UNKNOWN_ISSUE');
+    });
+  });
+  describe('generateCompleteSocialMetaSetup', () => {
+    it('generates complete setup for each framework', () => {
+      const frameworks = [
+        'html',
+        'react',
+        'vite-react',
+        'nextjs-app',
+        'nextjs-pages',
+        'astro',
+        'remix',
+        'sveltekit',
+      ] as const;
+      frameworks.forEach((framework) => {
+        const result = generateCompleteSocialMetaSetup(framework, defaultConfig);
+        expect(result).toHaveProperty('filePath');
+        expect(result).toHaveProperty('content');
+        expect(result).toHaveProperty('explanation');
+        expect(result.content.length).toBeGreaterThan(0);
+        expect(result.explanation).toContain(framework);
+      });
+    });
+  });
+  describe('OG_IMAGE_SPECS', () => {
+    it('has recommended dimensions', () => {
+      expect(OG_IMAGE_SPECS.recommended.width).toBe(1200);
+      expect(OG_IMAGE_SPECS.recommended.height).toBe(630);
+    });
+    it('has Twitter specs', () => {
+      expect(OG_IMAGE_SPECS.twitter.summary_large_image.width).toBe(1200);
+      expect(OG_IMAGE_SPECS.twitter.summary_large_image.height).toBe(600);
+    });
+    it('has Facebook specs', () => {
+      expect(OG_IMAGE_SPECS.facebook.recommended.width).toBe(1200);
+      expect(OG_IMAGE_SPECS.facebook.recommended.height).toBe(630);
+    });
+    it('has LinkedIn specs', () => {
+      expect(OG_IMAGE_SPECS.linkedin.recommended.width).toBe(1200);
+    });
+  });
+});