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/fixer.ts ADDED Viewed

@@ -0,0 +1,416 @@
+import { readFileSync, existsSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import type { SEOIssue, Fix, FrameworkInfo } from './types.js';
+import { detectFramework, findHtmlEntry, readFile } from './tools/files.js';
+import { generateH1Fix } from './tools/h1-fixer.js';
+export interface FixGeneratorOptions {
+  cwd: string;
+  url?: string;
+  framework?: FrameworkInfo;
+}
+export interface GeneratedFix extends Fix {
+  applied?: boolean;
+  skipped?: boolean;
+  skipReason?: string;
+}
+// Generate fixes for SEO issues based on framework
+export async function generateFixes(
+  issues: SEOIssue[],
+  options: FixGeneratorOptions
+): Promise<GeneratedFix[]> {
+  const { cwd, url } = options;
+  // Detect framework if not provided
+  let framework = options.framework;
+  if (!framework) {
+    const result = await detectFramework({ cwd });
+    framework = result.success ? (result.data as FrameworkInfo) : { name: 'Unknown', metaPattern: 'html-head' as const };
+  }
+  const fixes: GeneratedFix[] = [];
+  // Find the HTML entry point for Vite/React apps
+  const htmlEntry = await findHtmlEntry({ cwd });
+  const htmlPath = htmlEntry.success ? (htmlEntry.data as { path: string; content: string }).path : 'index.html';
+  const htmlContent = htmlEntry.success ? (htmlEntry.data as { path: string; content: string }).content : '';
+  for (const issue of issues) {
+    const fix = await generateFixForIssue(issue, {
+      cwd,
+      url,
+      framework,
+      htmlPath,
+      htmlContent,
+    });
+    if (fix) {
+      fixes.push(fix);
+    }
+  }
+  return fixes;
+}
+interface FixContext {
+  cwd: string;
+  url?: string;
+  framework: FrameworkInfo;
+  htmlPath: string;
+  htmlContent: string;
+}
+async function generateFixForIssue(
+  issue: SEOIssue,
+  context: FixContext
+): Promise<GeneratedFix | null> {
+  const { cwd, url, framework, htmlPath, htmlContent } = context;
+  const fullUrl = url || 'https://example.com';
+  const siteName = new URL(fullUrl).hostname.replace('www.', '');
+  switch (issue.code) {
+    case 'MISSING_TITLE':
+      return generateTitleFix(context, siteName);
+    case 'MISSING_META_DESC':
+      return generateMetaDescFix(context, siteName);
+    case 'MISSING_CANONICAL':
+      return generateCanonicalFix(context, fullUrl);
+    case 'MISSING_VIEWPORT':
+      return generateViewportFix(context);
+    case 'MISSING_OG_TAGS':
+      return generateOGFix(context, siteName, fullUrl);
+    case 'MISSING_TWITTER_CARD':
+      return generateTwitterFix(context, siteName);
+    case 'MISSING_SCHEMA':
+      return generateSchemaFix(context, siteName, fullUrl);
+    case 'MISSING_ROBOTS':
+      return generateRobotsFix(context, fullUrl);
+    case 'MISSING_SITEMAP':
+      return generateSitemapFix(context, fullUrl);
+    case 'MISSING_H1':
+      return await generateH1Fix({ cwd });
+    default:
+      return null;
+  }
+}
+function generateTitleFix(context: FixContext, siteName: string): GeneratedFix {
+  const { htmlPath, htmlContent, framework } = context;
+  if (framework.metaPattern === 'html-head') {
+    // Vite/React - modify index.html
+    const titleTag = `<title>${siteName} - Your Product Tagline</title>`;
+    if (htmlContent.includes('<title>')) {
+      // Replace existing 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 {
+      // Add title after <head>
+      return {
+        issue: { code: 'MISSING_TITLE', message: 'Missing title tag', severity: 'critical' },
+        file: htmlPath,
+        before: '<head>',
+        after: `<head>\n    ${titleTag}`,
+        explanation: 'Added a title tag to the document head',
+      };
+    }
+  }
+  // For other frameworks, provide guidance
+  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: FixContext, siteName: string): GeneratedFix {
+  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>\n    ${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>\n    ${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`,
+  };
+}
+function generateCanonicalFix(context: FixContext, url: string): GeneratedFix {
+  const { htmlPath, htmlContent, framework } = context;
+  const canonicalTag = `<link rel="canonical" href="${url}" />`;
+  // Check if canonical already exists
+  if (htmlContent.includes('rel="canonical"') || htmlContent.includes("rel='canonical'")) {
+    return {
+      issue: { code: 'MISSING_CANONICAL', message: 'No canonical URL specified', severity: 'warning' },
+      file: htmlPath,
+      before: null,
+      after: canonicalTag,
+      explanation: 'Canonical URL already exists',
+      skipped: true,
+      skipReason: 'Canonical tag already present',
+    };
+  }
+  if (framework.metaPattern === 'html-head') {
+    return {
+      issue: { code: 'MISSING_CANONICAL', message: 'No canonical URL specified', severity: 'warning' },
+      file: htmlPath,
+      before: '</head>',
+      after: `    ${canonicalTag}\n  </head>`,
+      explanation: 'Added canonical URL to prevent duplicate content issues',
+    };
+  }
+  return {
+    issue: { code: 'MISSING_CANONICAL', message: 'No canonical URL specified', severity: 'warning' },
+    file: htmlPath,
+    before: null,
+    after: canonicalTag,
+    explanation: `Add canonical URL using ${framework.name} patterns`,
+  };
+}
+function generateViewportFix(context: FixContext): GeneratedFix {
+  const { htmlPath, htmlContent, framework } = context;
+  const viewportTag = '<meta name="viewport" content="width=device-width, initial-scale=1.0" />';
+  if (framework.metaPattern === 'html-head' && !htmlContent.includes('viewport')) {
+    return {
+      issue: { code: 'MISSING_VIEWPORT', message: 'Missing viewport meta tag', severity: 'critical' },
+      file: htmlPath,
+      before: '<head>',
+      after: `<head>\n    ${viewportTag}`,
+      explanation: 'Added viewport meta tag for mobile responsiveness',
+    };
+  }
+  return {
+    issue: { code: 'MISSING_VIEWPORT', message: 'Missing viewport meta tag', severity: 'critical' },
+    file: htmlPath,
+    before: null,
+    after: viewportTag,
+    explanation: 'Add viewport meta tag for mobile-first indexing',
+  };
+}
+function generateOGFix(context: FixContext, siteName: string, url: string): GeneratedFix {
+  const { htmlPath, htmlContent } = context;
+  // Check which OG tags are missing
+  const missingTags: string[] = [];
+  if (!htmlContent.includes('og:image')) {
+    missingTags.push(`<meta property="og:image" content="${url}/og-image.png" />`);
+  }
+  if (!htmlContent.includes('og:url')) {
+    missingTags.push(`<meta property="og:url" content="${url}" />`);
+  }
+  if (missingTags.length === 0) {
+    return {
+      issue: { code: 'MISSING_OG_TAGS', message: 'Missing Open Graph tags', severity: 'warning' },
+      file: htmlPath,
+      before: null,
+      after: '',
+      explanation: 'All essential OG tags are present',
+      skipped: true,
+      skipReason: 'OG tags already exist',
+    };
+  }
+  const ogTags = `<!-- SEO Autopilot: Missing OG tags -->\n    ${missingTags.join('\n    ')}`;
+  return {
+    issue: { code: 'MISSING_OG_TAGS', message: 'Missing Open Graph tags', severity: 'warning' },
+    file: htmlPath,
+    before: '</head>',
+    after: `    ${ogTags}\n  </head>`,
+    explanation: `Added missing Open Graph meta tags: ${missingTags.length} tag(s)`,
+  };
+}
+function generateTwitterFix(context: FixContext, siteName: string): GeneratedFix {
+  const { htmlPath } = context;
+  const twitterTags = `<!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="${siteName} - Your Product Tagline" />
+    <meta name="twitter:description" content="A compelling description for Twitter sharing." />
+    <meta name="twitter:image" content="/og-image.png" />`;
+  return {
+    issue: { code: 'MISSING_TWITTER_CARD', message: 'Missing Twitter Card meta tags', severity: 'info' },
+    file: htmlPath,
+    before: '</head>',
+    after: `    ${twitterTags}\n  </head>`,
+    explanation: 'Added Twitter Card meta tags for better X/Twitter sharing',
+  };
+}
+function generateSchemaFix(context: FixContext, siteName: string, url: string): GeneratedFix {
+  const { htmlPath, framework } = context;
+  const schema = {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    'name': siteName,
+    'url': url,
+    'applicationCategory': 'WebApplication',
+    'operatingSystem': 'Web Browser',
+    'offers': {
+      '@type': 'Offer',
+      'price': '0',
+      'priceCurrency': 'USD',
+    },
+  };
+  const schemaScript = `<script type="application/ld+json">
+${JSON.stringify(schema, null, 2)}
+    </script>`;
+  return {
+    issue: { code: 'MISSING_SCHEMA', message: 'No JSON-LD structured data found', severity: 'warning' },
+    file: htmlPath,
+    before: '</head>',
+    after: `    ${schemaScript}\n  </head>`,
+    explanation: 'Added JSON-LD structured data for rich search results',
+  };
+}
+function generateRobotsFix(context: FixContext, url: string): GeneratedFix {
+  const robotsTxt = `# robots.txt for ${new URL(url).hostname}
+User-agent: *
+Allow: /
+# Sitemap
+Sitemap: ${url}/sitemap.xml`;
+  return {
+    issue: { code: 'MISSING_ROBOTS', message: 'No robots.txt file found', severity: 'warning' },
+    file: 'public/robots.txt',
+    before: null,
+    after: robotsTxt,
+    explanation: 'Created robots.txt to provide crawling instructions to search engines',
+  };
+}
+function generateSitemapFix(context: FixContext, url: string): GeneratedFix {
+  const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>${url}</loc>
+    <lastmod>${new Date().toISOString().split('T')[0]}</lastmod>
+    <priority>1.0</priority>
+  </url>
+</urlset>`;
+  return {
+    issue: { code: 'MISSING_SITEMAP', message: 'No sitemap.xml found', severity: 'warning' },
+    file: 'public/sitemap.xml',
+    before: null,
+    after: sitemap,
+    explanation: 'Created sitemap.xml to help search engines discover all pages',
+  };
+}
+// Apply fixes to the codebase
+export async function applyFixes(
+  fixes: GeneratedFix[],
+  options: { cwd: string; dryRun?: boolean }
+): Promise<{ applied: GeneratedFix[]; skipped: GeneratedFix[] }> {
+  const { cwd, dryRun = false } = options;
+  const applied: GeneratedFix[] = [];
+  const skipped: GeneratedFix[] = [];
+  for (const fix of fixes) {
+    if (fix.skipped) {
+      skipped.push(fix);
+      continue;
+    }
+    try {
+      const filePath = join(cwd, fix.file);
+      if (dryRun) {
+        applied.push({ ...fix, applied: false });
+        continue;
+      }
+      if (fix.before === null) {
+        // Create new file
+        const dir = join(cwd, fix.file.split('/').slice(0, -1).join('/'));
+        if (dir !== cwd && !existsSync(dir)) {
+          const { mkdirSync } = await import('fs');
+          mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(filePath, fix.after, 'utf-8');
+        applied.push({ ...fix, applied: true });
+      } else if (existsSync(filePath)) {
+        // Modify existing file
+        let content = readFileSync(filePath, 'utf-8');
+        if (content.includes(fix.before)) {
+          content = content.replace(fix.before, fix.after);
+          writeFileSync(filePath, content, 'utf-8');
+          applied.push({ ...fix, applied: true });
+        } else {
+          skipped.push({ ...fix, skipped: true, skipReason: 'Pattern not found in file' });
+        }
+      } else {
+        skipped.push({ ...fix, skipped: true, skipReason: 'File not found' });
+      }
+    } catch (error) {
+      skipped.push({
+        ...fix,
+        skipped: true,
+        skipReason: error instanceof Error ? error.message : 'Unknown error',
+      });
+    }
+  }
+  return { applied, skipped };
+}

package/src/frameworks/detector.test.ts ADDED Viewed

@@ -0,0 +1,248 @@
+import { describe, it, expect } from 'vitest';
+import {
+  detectFromHtml,
+  detectFromPackageJson,
+  detectFromHeaders,
+  detectFramework,
+  getFrameworkDisplayName,
+} from './detector.js';
+describe('Framework Detector', () => {
+  describe('detectFromHtml', () => {
+    it('detects Next.js from __next data', () => {
+      const html = '<div id="__next"><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('nextjs');
+      expect(result?.confidence).toBe('high');
+    });
+    it('detects Next.js from _next scripts', () => {
+      const html = '<script src="/_next/static/chunks/main.js"></script>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('nextjs');
+    });
+    it('detects Nuxt from __nuxt data', () => {
+      const html = '<div id="__nuxt"><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('nuxt');
+    });
+    it('detects Gatsby from ___gatsby', () => {
+      const html = '<div id="___gatsby"><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('gatsby');
+    });
+    it('detects Astro from data-astro attributes', () => {
+      const html = '<div data-astro-cid-xyz><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('astro');
+    });
+    it('detects SvelteKit from __sveltekit', () => {
+      const html = '<div id="__sveltekit"><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('sveltekit');
+    });
+    it('detects React from data-reactroot', () => {
+      const html = '<div data-reactroot><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('react');
+    });
+    it('detects Vue from data-v- attributes', () => {
+      const html = '<div data-v-abc123><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('vue');
+    });
+    it('detects Angular from ng-version', () => {
+      const html = '<app-root ng-version="17.0.0"><h1>Hello</h1></app-root>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('angular');
+    });
+    it('detects Angular from _ngcontent', () => {
+      const html = '<div _ngcontent-abc-c123><h1>Hello</h1></div>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('angular');
+    });
+    it('detects WordPress from wp-content', () => {
+      const html = '<link rel="stylesheet" href="/wp-content/themes/theme/style.css">';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('wordpress');
+    });
+    it('detects Rails from turbolinks', () => {
+      const html = '<script src="/assets/turbolinks.js"></script>';
+      const result = detectFromHtml(html);
+      expect(result?.framework).toBe('rails');
+    });
+    it('returns null for unknown HTML', () => {
+      const html = '<html><body><h1>Hello</h1></body></html>';
+      const result = detectFromHtml(html);
+      expect(result).toBeNull();
+    });
+  });
+  describe('detectFromPackageJson', () => {
+    it('detects Next.js from dependencies', () => {
+      const packageJson = {
+        dependencies: { next: '^14.0.0', react: '^18.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('nextjs');
+      expect(result?.version).toBe('^14.0.0');
+      expect(result?.meta_framework).toBe('react');
+    });
+    it('detects Nuxt from dependencies', () => {
+      const packageJson = {
+        dependencies: { nuxt: '^3.0.0', vue: '^3.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('nuxt');
+      expect(result?.meta_framework).toBe('vue');
+    });
+    it('detects React from devDependencies', () => {
+      const packageJson = {
+        devDependencies: { react: '^18.0.0', 'react-dom': '^18.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('react');
+    });
+    it('detects Astro', () => {
+      const packageJson = {
+        dependencies: { astro: '^4.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('astro');
+    });
+    it('detects SvelteKit', () => {
+      const packageJson = {
+        devDependencies: { '@sveltejs/kit': '^2.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('sveltekit');
+      expect(result?.meta_framework).toBe('svelte');
+    });
+    it('detects Angular', () => {
+      const packageJson = {
+        dependencies: { '@angular/core': '^17.0.0' },
+      };
+      const result = detectFromPackageJson(packageJson);
+      expect(result?.framework).toBe('angular');
+    });
+    it('returns null for empty package.json', () => {
+      const packageJson = {};
+      const result = detectFromPackageJson(packageJson);
+      expect(result).toBeNull();
+    });
+  });
+  describe('detectFromHeaders', () => {
+    it('detects Next.js from X-Powered-By', () => {
+      const headers = { 'x-powered-by': 'Next.js' };
+      const result = detectFromHeaders(headers);
+      expect(result?.framework).toBe('nextjs');
+    });
+    it('detects Nuxt from X-Powered-By', () => {
+      const headers = { 'x-powered-by': 'Nuxt' };
+      const result = detectFromHeaders(headers);
+      expect(result?.framework).toBe('nuxt');
+    });
+    it('detects Rails from Phusion Passenger', () => {
+      const headers = { 'x-powered-by': 'Phusion Passenger' };
+      const result = detectFromHeaders(headers);
+      expect(result?.framework).toBe('rails');
+    });
+    it('returns null for generic headers', () => {
+      const headers = { 'x-powered-by': 'Express' };
+      const result = detectFromHeaders(headers);
+      expect(result).toBeNull();
+    });
+  });
+  describe('detectFramework', () => {
+    it('prioritizes package.json over HTML', () => {
+      const result = detectFramework({
+        packageJson: { dependencies: { next: '^14.0.0' } },
+        html: '<div data-reactroot>',
+      });
+      expect(result.framework).toBe('nextjs');
+    });
+    it('falls back to HTML when no package.json', () => {
+      const result = detectFramework({
+        html: '<div id="__nuxt">',
+      });
+      expect(result.framework).toBe('nuxt');
+    });
+    it('detects from file patterns', () => {
+      const result = detectFramework({
+        files: ['next.config.js', 'pages/index.tsx'],
+      });
+      expect(result.framework).toBe('nextjs');
+    });
+    it('detects WordPress from wp-config.php', () => {
+      const result = detectFramework({
+        files: ['wp-config.php', 'wp-content/themes/theme'],
+      });
+      expect(result.framework).toBe('wordpress');
+    });
+    it('detects Django from manage.py', () => {
+      const result = detectFramework({
+        files: ['manage.py', 'myapp/settings.py'],
+      });
+      expect(result.framework).toBe('django');
+    });
+    it('detects Rails from Gemfile + routes.rb', () => {
+      const result = detectFramework({
+        files: ['Gemfile', 'config/routes.rb'],
+      });
+      expect(result.framework).toBe('rails');
+    });
+    it('detects Laravel from artisan', () => {
+      const result = detectFramework({
+        files: ['artisan', 'app/Http/Controllers'],
+      });
+      expect(result.framework).toBe('laravel');
+    });
+    it('returns unknown for unrecognized input', () => {
+      const result = detectFramework({});
+      expect(result.framework).toBe('unknown');
+      expect(result.confidence).toBe('low');
+    });
+  });
+  describe('getFrameworkDisplayName', () => {
+    it('returns correct display names', () => {
+      expect(getFrameworkDisplayName('react')).toBe('React');
+      expect(getFrameworkDisplayName('nextjs')).toBe('Next.js');
+      expect(getFrameworkDisplayName('vue')).toBe('Vue.js');
+      expect(getFrameworkDisplayName('nuxt')).toBe('Nuxt');
+      expect(getFrameworkDisplayName('angular')).toBe('Angular');
+      expect(getFrameworkDisplayName('rails')).toBe('Ruby on Rails');
+      expect(getFrameworkDisplayName('wordpress')).toBe('WordPress');
+      expect(getFrameworkDisplayName('unknown')).toBe('Unknown');
+    });
+  });
+});