npm - @rankcli/agent-runtime - Versions diffs - 0.0.15 → 0.0.17 - Mend

@rankcli/agent-runtime 0.0.15 → 0.0.17

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 (203) hide show

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

package/src/tracking/search-console.ts DELETED Viewed

@@ -1,335 +0,0 @@
-// Google Search Console Integration
-// Verification injection + API data fetching
-import * as fs from 'fs';
-import * as path from 'path';
-export interface GSCConfig {
-  verificationCode?: string; // For meta tag verification
-  siteUrl: string; // https://example.com or sc-domain:example.com
-  credentials?: GSCCredentials;
-}
-export interface GSCCredentials {
-  type: 'service_account' | 'oauth';
-  // Service account JSON or OAuth tokens
-  clientEmail?: string;
-  privateKey?: string;
-  accessToken?: string;
-  refreshToken?: string;
-}
-export interface GSCQueryResult {
-  query: string;
-  clicks: number;
-  impressions: number;
-  ctr: number;
-  position: number;
-  page?: string;
-}
-export interface GSCPerformanceData {
-  startDate: string;
-  endDate: string;
-  queries: GSCQueryResult[];
-  totalClicks: number;
-  totalImpressions: number;
-  avgCtr: number;
-  avgPosition: number;
-}
-export interface QuickWin {
-  query: string;
-  currentPosition: number;
-  impressions: number;
-  clicks: number;
-  ctr: number;
-  opportunity: 'page-1-close' | 'low-ctr' | 'high-impression';
-  suggestedAction: string;
-  potentialGain: number; // Estimated additional clicks
-}
-/**
- * Generate Search Console verification meta tag
- */
-export function generateGSCVerificationTag(verificationCode: string): string {
-  return `<meta name="google-site-verification" content="${verificationCode}" />`;
-}
-/**
- * Inject GSC verification into project
- */
-export async function injectGSCVerification(
-  projectPath: string,
-  verificationCode: string
-): Promise<{ success: boolean; file?: string; message: string }> {
-  // Find index.html or equivalent
-  const indexPaths = [
-    path.join(projectPath, 'index.html'),
-    path.join(projectPath, 'public', 'index.html'),
-    path.join(projectPath, 'app', 'layout.tsx'),
-    path.join(projectPath, 'src', 'app', 'layout.tsx'),
-  ];
-  for (const indexPath of indexPaths) {
-    if (fs.existsSync(indexPath)) {
-      let content = fs.readFileSync(indexPath, 'utf-8');
-      // Check if already verified
-      if (content.includes('google-site-verification')) {
-        return { success: true, file: indexPath, message: 'GSC verification already present' };
-      }
-      const verificationTag = generateGSCVerificationTag(verificationCode);
-      // For HTML files
-      if (indexPath.endsWith('.html')) {
-        content = content.replace('<head>', `<head>\n    ${verificationTag}`);
-        fs.writeFileSync(indexPath, content);
-        return { success: true, file: indexPath, message: 'GSC verification tag added' };
-      }
-      // For React/Next.js layout files
-      if (indexPath.endsWith('.tsx') || indexPath.endsWith('.jsx')) {
-        // Add to <head> section
-        if (content.includes('<head>')) {
-          content = content.replace(
-            '<head>',
-            `<head>\n        <meta name="google-site-verification" content="${verificationCode}" />`
-          );
-          fs.writeFileSync(indexPath, content);
-          return { success: true, file: indexPath, message: 'GSC verification tag added to layout' };
-        }
-      }
-    }
-  }
-  return {
-    success: false,
-    message: 'Could not find index.html or layout file. Add manually: ' + generateGSCVerificationTag(verificationCode),
-  };
-}
-/**
- * Build GSC API request (for use with Google APIs client)
- * User needs to set up OAuth or service account credentials
- */
-export function buildGSCApiRequest(
-  siteUrl: string,
-  startDate: string,
-  endDate: string,
-  options: {
-    dimensions?: ('query' | 'page' | 'country' | 'device' | 'date')[];
-    rowLimit?: number;
-    startRow?: number;
-  } = {}
-): object {
-  return {
-    siteUrl,
-    requestBody: {
-      startDate,
-      endDate,
-      dimensions: options.dimensions || ['query'],
-      rowLimit: options.rowLimit || 1000,
-      startRow: options.startRow || 0,
-    },
-  };
-}
-/**
- * Parse GSC API response into our format
- */
-export function parseGSCResponse(response: any): GSCPerformanceData {
-  const rows = response.rows || [];
-  const queries: GSCQueryResult[] = rows.map((row: any) => ({
-    query: row.keys?.[0] || '',
-    page: row.keys?.[1],
-    clicks: row.clicks || 0,
-    impressions: row.impressions || 0,
-    ctr: row.ctr || 0,
-    position: row.position || 0,
-  }));
-  const totalClicks = queries.reduce((sum, q) => sum + q.clicks, 0);
-  const totalImpressions = queries.reduce((sum, q) => sum + q.impressions, 0);
-  const avgCtr = totalImpressions > 0 ? totalClicks / totalImpressions : 0;
-  const avgPosition = queries.length > 0
-    ? queries.reduce((sum, q) => sum + q.position, 0) / queries.length
-    : 0;
-  return {
-    startDate: response.startDate || '',
-    endDate: response.endDate || '',
-    queries,
-    totalClicks,
-    totalImpressions,
-    avgCtr,
-    avgPosition,
-  };
-}
-/**
- * Identify quick wins from GSC data
- */
-export function identifyQuickWins(data: GSCPerformanceData): QuickWin[] {
-  const quickWins: QuickWin[] = [];
-  for (const query of data.queries) {
-    // Skip very low impression queries
-    if (query.impressions < 10) continue;
-    // Quick Win 1: Position 11-20 (almost page 1)
-    if (query.position >= 11 && query.position <= 20) {
-      const potentialGain = Math.round(query.impressions * 0.1); // ~10% CTR if on page 1
-      quickWins.push({
-        ...query,
-        currentPosition: query.position,
-        opportunity: 'page-1-close',
-        suggestedAction: `Improve content for "${query.query}" - you're at position ${Math.round(query.position)}, just off page 1!`,
-        potentialGain,
-      });
-    }
-    // Quick Win 2: High impressions but low CTR (position 1-10)
-    if (query.position <= 10 && query.impressions > 100 && query.ctr < 0.02) {
-      const expectedCtr = getExpectedCtr(query.position);
-      const potentialGain = Math.round(query.impressions * (expectedCtr - query.ctr));
-      if (potentialGain > 5) {
-        quickWins.push({
-          ...query,
-          currentPosition: query.position,
-          opportunity: 'low-ctr',
-          suggestedAction: `Improve title/description for "${query.query}" - CTR is ${(query.ctr * 100).toFixed(1)}% vs expected ${(expectedCtr * 100).toFixed(1)}%`,
-          potentialGain,
-        });
-      }
-    }
-    // Quick Win 3: High impressions, position 4-10 (could be #1)
-    if (query.position >= 4 && query.position <= 10 && query.impressions > 500) {
-      const potentialGain = Math.round(query.impressions * 0.15); // Gain from reaching #1
-      quickWins.push({
-        ...query,
-        currentPosition: query.position,
-        opportunity: 'high-impression',
-        suggestedAction: `Push "${query.query}" to top 3 - high traffic potential at ${query.impressions} impressions/month`,
-        potentialGain,
-      });
-    }
-  }
-  // Sort by potential gain
-  quickWins.sort((a, b) => b.potentialGain - a.potentialGain);
-  return quickWins.slice(0, 20); // Top 20 quick wins
-}
-/**
- * Expected CTR by position (industry average)
- */
-function getExpectedCtr(position: number): number {
-  const ctrByPosition: Record<number, number> = {
-    1: 0.28,
-    2: 0.15,
-    3: 0.11,
-    4: 0.08,
-    5: 0.06,
-    6: 0.05,
-    7: 0.04,
-    8: 0.03,
-    9: 0.03,
-    10: 0.02,
-  };
-  return ctrByPosition[Math.round(position)] || 0.01;
-}
-/**
- * Compare two periods to identify trends
- */
-export function comparePeriods(
-  current: GSCPerformanceData,
-  previous: GSCPerformanceData
-): {
-  improved: GSCQueryResult[];
-  declined: GSCQueryResult[];
-  newKeywords: GSCQueryResult[];
-  lostKeywords: GSCQueryResult[];
-  summary: {
-    clicksChange: number;
-    impressionsChange: number;
-    avgPositionChange: number;
-  };
-} {
-  const previousMap = new Map(previous.queries.map(q => [q.query, q]));
-  const currentMap = new Map(current.queries.map(q => [q.query, q]));
-  const improved: GSCQueryResult[] = [];
-  const declined: GSCQueryResult[] = [];
-  const newKeywords: GSCQueryResult[] = [];
-  const lostKeywords: GSCQueryResult[] = [];
-  // Check current queries
-  for (const query of current.queries) {
-    const prev = previousMap.get(query.query);
-    if (!prev) {
-      newKeywords.push(query);
-    } else if (query.position < prev.position - 2) {
-      improved.push(query);
-    } else if (query.position > prev.position + 2) {
-      declined.push(query);
-    }
-  }
-  // Check for lost keywords
-  for (const query of previous.queries) {
-    if (!currentMap.has(query.query) && query.impressions > 50) {
-      lostKeywords.push(query);
-    }
-  }
-  return {
-    improved: improved.slice(0, 10),
-    declined: declined.slice(0, 10),
-    newKeywords: newKeywords.slice(0, 10),
-    lostKeywords: lostKeywords.slice(0, 10),
-    summary: {
-      clicksChange: current.totalClicks - previous.totalClicks,
-      impressionsChange: current.totalImpressions - previous.totalImpressions,
-      avgPositionChange: current.avgPosition - previous.avgPosition,
-    },
-  };
-}
-/**
- * Generate credentials setup instructions
- */
-export function getGSCSetupInstructions(): string {
-  return `
-# Google Search Console API Setup
-## Option 1: Service Account (Recommended for GitHub Actions)
-1. Go to Google Cloud Console: https://console.cloud.google.com
-2. Create a new project or select existing
-3. Enable "Search Console API"
-4. Go to "IAM & Admin" > "Service Accounts"
-5. Create a service account
-6. Create a JSON key and download it
-7. In Search Console, add the service account email as a user
-Add to GitHub Secrets:
-  - GSC_SERVICE_ACCOUNT_EMAIL: your-service-account@project.iam.gserviceaccount.com
-  - GSC_PRIVATE_KEY: (the private_key from JSON, including -----BEGIN/END-----)
-## Option 2: OAuth (For user-specific access)
-1. Go to Google Cloud Console
-2. Enable "Search Console API"
-3. Create OAuth 2.0 credentials
-4. Download client_secret.json
-5. Run: seo auth --google
-This will open a browser for OAuth consent and save tokens locally.
-`;
-}

package/src/types.ts DELETED Viewed

@@ -1,148 +0,0 @@
-export interface AgentDefinition {
-  name: string;
-  description: string;
-  model: string;
-  temperature: number;
-  max_tokens: number;
-  tools: AgentTool[];
-  system: string;
-  prompt: string;
-}
-export interface AgentTool {
-  name: string;
-  description: string;
-}
-export interface SEOIssue {
-  severity: 'critical' | 'warning' | 'info';
-  category: 'meta' | 'schema' | 'content' | 'technical' | 'performance' | 'social' | 'accessibility';
-  code: string;
-  message: string;
-  impact: string;
-  element?: string;
-  fix?: {
-    file: string;
-    before: string | null;
-    after: string;
-  };
-}
-export interface SEOAnalysisResult {
-  url: string;
-  score: number;
-  core_web_vitals?: {
-    lcp?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
-    fid?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
-    cls?: { value: string; status: 'good' | 'needs-improvement' | 'poor' };
-  };
-  issues: SEOIssue[];
-  recommendations: SEORecommendation[];
-}
-export interface SEORecommendation {
-  priority: 'high' | 'medium' | 'low';
-  category: string;
-  message: string;
-  impact: string;
-}
-export interface CrawlResult {
-  url: string;
-  html: string;
-  statusCode: number;
-  headers: Record<string, string>;
-  loadTime: number;
-}
-export interface MetaData {
-  title?: string;
-  description?: string;
-  canonical?: string;
-  robots?: string;
-  viewport?: string;
-  charset?: string;
-  openGraph: {
-    title?: string;
-    description?: string;
-    image?: string;
-    url?: string;
-    type?: string;
-    siteName?: string;
-  };
-  twitter: {
-    card?: string;
-    title?: string;
-    description?: string;
-    image?: string;
-    site?: string;
-  };
-  other: Record<string, string>;
-}
-export interface HeadingStructure {
-  tag: string;
-  text: string;
-  level: number;
-}
-export interface ImageInfo {
-  src: string;
-  alt: string | null;
-  width?: string;
-  height?: string;
-  loading?: string;
-}
-export interface LinkInfo {
-  href: string;
-  text: string;
-  isInternal: boolean;
-  isNofollow: boolean;
-}
-export interface SchemaData {
-  type: string;
-  data: Record<string, unknown>;
-}
-export interface FrameworkInfo {
-  name: string;
-  version?: string;
-  router?: 'app' | 'pages' | 'file-based' | 'custom';
-  language?: 'javascript' | 'typescript' | 'ruby' | 'python' | 'php' | 'java' | 'csharp' | 'go' | 'elixir' | 'rust';
-  metaPattern:
-    | 'metadata-export'    // Next.js App Router
-    | 'head-component'     // React, Vue, Svelte
-    | 'frontmatter'        // Astro, Hugo, Jekyll, Eleventy
-    | 'meta-function'      // Remix
-    | 'html-head'          // Plain HTML
-    | 'erb-helpers'        // Rails with meta-tags gem
-    | 'blade-components'   // Laravel Blade
-    | 'thymeleaf'          // Spring Boot
-    | 'razor'              // ASP.NET Core
-    | 'heex'               // Phoenix/Elixir
-    | 'go-templates'       // Go (Gin/Echo/Fiber)
-    | 'django-templates'   // Django/Jinja2
-    | 'server-rendered';   // HTMX and other server-rendered
-}
-export interface Fix {
-  issue: {
-    code: string;
-    message: string;
-    severity: string;
-  };
-  file: string;
-  before: string | null;
-  after: string;
-  explanation: string;
-}
-export interface ToolResult {
-  success: boolean;
-  data?: unknown;
-  error?: string;
-}
-export type ToolFunction = (params: Record<string, unknown>) => Promise<ToolResult>;