@rankcli/agent-runtime 0.0.31 → 0.0.33

package/dist/index.d.mts

@@ -3031,20 +3031,6 @@ declare function buildDeterministicFixes(input: DeterministicFixInput): Determin
  */
 declare function findAppRoot(files: string[]): string;
 
-interface ReplacementConcern {
-    /** Machine-readable, for logs and the PR body. */
-    code: 'shrunk' | 'lost_closing_tag' | 'lost_script' | 'lost_stylesheet' | 'lost_verification' | 'lost_import' | 'invalid_json' | 'invalid_xml' | 'invalid_json_ld' | 'fewer_sitemap_urls' | 'lastmod_moved_backwards';
-    detail: string;
-}
-/**
- * Everything wrong with replacing `original` with `replacement` at `path`. Empty means safe
- * to commit. `original` is null for a file being created, where there is nothing to lose and
- * only the content's own validity matters.
- */
-declare function assessReplacement(path: string, original: string | null, replacement: string): ReplacementConcern[];
-/** One line naming why a file was dropped, for a log line or a PR body. */
-declare function describeConcerns(concerns: ReplacementConcern[]): string;
-
 /**
  * Framework Detection
  *
@@ -3056,7 +3042,7 @@ declare function describeConcerns(concerns: ReplacementConcern[]): string;
  *
  * Supports 25+ frameworks across JavaScript, Ruby, Python, PHP, Java, C#, Go, and Elixir.
  */
-type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'solidjs' | 'qwik' | 'fresh' | 'rails' | 'django' | 'flask' | 'fastapi' | 'laravel' | 'symfony' | 'wordpress' | 'spring' | 'aspnet' | 'go' | 'phoenix' | 'htmx' | 'hotwire' | 'hugo' | 'jekyll' | 'eleventy' | 'pelican' | 'sphinx' | 'unknown';
+type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'solidjs' | 'qwik' | 'fresh' | 'rails' | 'django' | 'flask' | 'fastapi' | 'laravel' | 'symfony' | 'wordpress' | 'spring' | 'aspnet' | 'go' | 'phoenix' | 'htmx' | 'hotwire' | 'hugo' | 'jekyll' | 'eleventy' | 'pelican' | 'sphinx' | 'docusaurus' | 'unknown';
 type Language = 'javascript' | 'typescript' | 'ruby' | 'python' | 'php' | 'java' | 'csharp' | 'go' | 'elixir' | 'rust' | 'unknown';
 interface FrameworkInfo {
     framework: Framework;
@@ -3108,6 +3094,30 @@ declare function detectFramework$1(options: {
  */
 declare function getFrameworkDisplayName(framework: Framework): string;
 
+/**
+ * Where to write a file that must be served at the site root.
+ *
+ * @param framework what detection identified, or 'unknown'
+ * @param files every path in the repository
+ * @param appRoot the app's directory, with a trailing slash, or ''
+ * @returns a path prefix relative to appRoot: 'public/', 'static/', or '' for the app root
+ */
+declare function servedDir(framework: Framework | undefined, files: string[], appRoot?: string): string;
+
+interface ReplacementConcern {
+    /** Machine-readable, for logs and the PR body. */
+    code: 'shrunk' | 'lost_closing_tag' | 'lost_script' | 'lost_stylesheet' | 'lost_verification' | 'lost_import' | 'invalid_json' | 'invalid_xml' | 'invalid_json_ld' | 'fewer_sitemap_urls' | 'lastmod_moved_backwards';
+    detail: string;
+}
+/**
+ * Everything wrong with replacing `original` with `replacement` at `path`. Empty means safe
+ * to commit. `original` is null for a file being created, where there is nothing to lose and
+ * only the content's own validity matters.
+ */
+declare function assessReplacement(path: string, original: string | null, replacement: string): ReplacementConcern[];
+/** One line naming why a file was dropped, for a log line or a PR body. */
+declare function describeConcerns(concerns: ReplacementConcern[]): string;
+
 /**
  * Framework-Specific SEO Suggestion Engine
  *
@@ -3131,6 +3141,13 @@ interface FrameworkCheck {
     };
     app_router_only?: boolean;
     pages_router_only?: boolean;
+    /**
+     * Only meaningful on a page search engines are allowed to index. A check that
+     * says "crawlers will not see your content" is not a finding on a page that
+     * asks not to be crawled - every SaaS has a noindex /login, and reporting a
+     * critical SEO error on it is noise that drags the score down.
+     */
+    indexable_only?: boolean;
 }
 interface FrameworkRecipe {
     framework: Framework;
@@ -3158,7 +3175,9 @@ declare function loadRecipe(framework: Framework): Promise<FrameworkRecipe | nul
 /**
  * Get framework-specific issues based on HTML analysis
  */
-declare function getFrameworkIssues(frameworkInfo: FrameworkInfo, html: string, url: string): Promise<AuditIssue[]>;
+declare function getFrameworkIssues(frameworkInfo: FrameworkInfo, html: string, url: string, options?: {
+    indexable?: boolean;
+}): Promise<AuditIssue[]>;
 /**
  * Get framework-specific suggestions for fixing issues
  */
@@ -5689,4 +5708,4 @@ declare namespace index {
   export { type index_DetectionResult as DetectionResult, type index_Evidence as Evidence, type index_Framework as Framework, type index_FrameworkCheck as FrameworkCheck, type index_FrameworkInfo as FrameworkInfo, type index_FrameworkRecipe as FrameworkRecipe, index_SCORE_FLOOR as SCORE_FLOOR, index_SIGNALS as SIGNALS, index_SUPPORTED_FRAMEWORKS as SUPPORTED_FRAMEWORKS, type index_Signal as Signal, index_WEIGHT as WEIGHT, detectFramework$1 as detectFramework, index_detectFromEvidence as detectFromEvidence, index_detectFromHeaders as detectFromHeaders, index_detectFromHtml as detectFromHtml, index_detectFromPackageJson as detectFromPackageJson, index_embedRecipe as embedRecipe, index_getFrameworkChecks as getFrameworkChecks, index_getFrameworkDisplayName as getFrameworkDisplayName, index_getFrameworkIssues as getFrameworkIssues, index_getFrameworkSuggestions as getFrameworkSuggestions, index_getFrameworkSummary as getFrameworkSummary, index_getMigrationPaths as getMigrationPaths, index_getPerformanceTips as getPerformanceTips, index_getSeoChallenges as getSeoChallenges, index_getTotalFrameworkChecks as getTotalFrameworkChecks, index_loadRecipe as loadRecipe };
 }
 
-export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type CompetitorUrl, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DeterministicFixInput, type DeterministicFixes, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$2 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordLLM, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type KeywordTrend, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo$1 as LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type RankCheckOptions, type RankCheckResult, type RankHistory, RankTracker, type RankingResult, type RankingTierLimits, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SerpApiConfig, SerpClient, type SerpClientConfig, type SerpFeature, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, TIER_LIMITS, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackedKeyword, type TrackerConfig, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeDOMStructure, analyzeFeaturedSnippetPotential, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages$1 as analyzeImages, analyzeKeywordDensity, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeOnPage, analyzePagination, analyzePerformance, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders$1 as analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData$1 as analyzeStructuredData, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, index$1 as analyzers, applyFixes, assessReplacement, buildDeterministicFixes, buildFrameworkGuidance, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, describeConcerns, detectDuplicates, detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findAppRoot, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAspNetCoreSEO, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDjangoSEOHelper, generateDuplicateIssues, generateEleventySEO, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateGoSEO, generateHTMLReport, generateHTMLSocialMeta, generateHTMXSEO, generateHeadlineVariations, generateHugoSEO, generateJekyllSEO, generateJsonReport, generateKeyFacts, generateLaravelSEOHelper, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generatePhoenixSEO, generateRailsSEOHelper, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateRemixSEO, generateSecretsDoc, generateSocialMetaFix, generateSpringBootSEO, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getFrameworkSpecificFixExtended, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, keywordLLM, listFiles, loadAgent, loadAgentByName, mergePages, openAIKeywordLLM, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseJsonReply, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };
+export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type CompetitorUrl, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DeterministicFixInput, type DeterministicFixes, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$2 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordLLM, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type KeywordTrend, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo$1 as LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type RankCheckOptions, type RankCheckResult, type RankHistory, RankTracker, type RankingResult, type RankingTierLimits, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SerpApiConfig, SerpClient, type SerpClientConfig, type SerpFeature, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, TIER_LIMITS, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackedKeyword, type TrackerConfig, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeDOMStructure, analyzeFeaturedSnippetPotential, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages$1 as analyzeImages, analyzeKeywordDensity, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeOnPage, analyzePagination, analyzePerformance, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders$1 as analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData$1 as analyzeStructuredData, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, index$1 as analyzers, applyFixes, assessReplacement, buildDeterministicFixes, buildFrameworkGuidance, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, describeConcerns, detectDuplicates, detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findAppRoot, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAspNetCoreSEO, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDjangoSEOHelper, generateDuplicateIssues, generateEleventySEO, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateGoSEO, generateHTMLReport, generateHTMLSocialMeta, generateHTMXSEO, generateHeadlineVariations, generateHugoSEO, generateJekyllSEO, generateJsonReport, generateKeyFacts, generateLaravelSEOHelper, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generatePhoenixSEO, generateRailsSEOHelper, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateRemixSEO, generateSecretsDoc, generateSocialMetaFix, generateSpringBootSEO, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getFrameworkSpecificFixExtended, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, keywordLLM, listFiles, loadAgent, loadAgentByName, mergePages, openAIKeywordLLM, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseJsonReply, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, servedDir, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };

package/dist/index.d.ts

@@ -3031,20 +3031,6 @@ declare function buildDeterministicFixes(input: DeterministicFixInput): Determin
  */
 declare function findAppRoot(files: string[]): string;
 
-interface ReplacementConcern {
-    /** Machine-readable, for logs and the PR body. */
-    code: 'shrunk' | 'lost_closing_tag' | 'lost_script' | 'lost_stylesheet' | 'lost_verification' | 'lost_import' | 'invalid_json' | 'invalid_xml' | 'invalid_json_ld' | 'fewer_sitemap_urls' | 'lastmod_moved_backwards';
-    detail: string;
-}
-/**
- * Everything wrong with replacing `original` with `replacement` at `path`. Empty means safe
- * to commit. `original` is null for a file being created, where there is nothing to lose and
- * only the content's own validity matters.
- */
-declare function assessReplacement(path: string, original: string | null, replacement: string): ReplacementConcern[];
-/** One line naming why a file was dropped, for a log line or a PR body. */
-declare function describeConcerns(concerns: ReplacementConcern[]): string;
-
 /**
  * Framework Detection
  *
@@ -3056,7 +3042,7 @@ declare function describeConcerns(concerns: ReplacementConcern[]): string;
  *
  * Supports 25+ frameworks across JavaScript, Ruby, Python, PHP, Java, C#, Go, and Elixir.
  */
-type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'solidjs' | 'qwik' | 'fresh' | 'rails' | 'django' | 'flask' | 'fastapi' | 'laravel' | 'symfony' | 'wordpress' | 'spring' | 'aspnet' | 'go' | 'phoenix' | 'htmx' | 'hotwire' | 'hugo' | 'jekyll' | 'eleventy' | 'pelican' | 'sphinx' | 'unknown';
+type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'solidjs' | 'qwik' | 'fresh' | 'rails' | 'django' | 'flask' | 'fastapi' | 'laravel' | 'symfony' | 'wordpress' | 'spring' | 'aspnet' | 'go' | 'phoenix' | 'htmx' | 'hotwire' | 'hugo' | 'jekyll' | 'eleventy' | 'pelican' | 'sphinx' | 'docusaurus' | 'unknown';
 type Language = 'javascript' | 'typescript' | 'ruby' | 'python' | 'php' | 'java' | 'csharp' | 'go' | 'elixir' | 'rust' | 'unknown';
 interface FrameworkInfo {
     framework: Framework;
@@ -3108,6 +3094,30 @@ declare function detectFramework$1(options: {
  */
 declare function getFrameworkDisplayName(framework: Framework): string;
 
+/**
+ * Where to write a file that must be served at the site root.
+ *
+ * @param framework what detection identified, or 'unknown'
+ * @param files every path in the repository
+ * @param appRoot the app's directory, with a trailing slash, or ''
+ * @returns a path prefix relative to appRoot: 'public/', 'static/', or '' for the app root
+ */
+declare function servedDir(framework: Framework | undefined, files: string[], appRoot?: string): string;
+
+interface ReplacementConcern {
+    /** Machine-readable, for logs and the PR body. */
+    code: 'shrunk' | 'lost_closing_tag' | 'lost_script' | 'lost_stylesheet' | 'lost_verification' | 'lost_import' | 'invalid_json' | 'invalid_xml' | 'invalid_json_ld' | 'fewer_sitemap_urls' | 'lastmod_moved_backwards';
+    detail: string;
+}
+/**
+ * Everything wrong with replacing `original` with `replacement` at `path`. Empty means safe
+ * to commit. `original` is null for a file being created, where there is nothing to lose and
+ * only the content's own validity matters.
+ */
+declare function assessReplacement(path: string, original: string | null, replacement: string): ReplacementConcern[];
+/** One line naming why a file was dropped, for a log line or a PR body. */
+declare function describeConcerns(concerns: ReplacementConcern[]): string;
+
 /**
  * Framework-Specific SEO Suggestion Engine
  *
@@ -3131,6 +3141,13 @@ interface FrameworkCheck {
     };
     app_router_only?: boolean;
     pages_router_only?: boolean;
+    /**
+     * Only meaningful on a page search engines are allowed to index. A check that
+     * says "crawlers will not see your content" is not a finding on a page that
+     * asks not to be crawled - every SaaS has a noindex /login, and reporting a
+     * critical SEO error on it is noise that drags the score down.
+     */
+    indexable_only?: boolean;
 }
 interface FrameworkRecipe {
     framework: Framework;
@@ -3158,7 +3175,9 @@ declare function loadRecipe(framework: Framework): Promise<FrameworkRecipe | nul
 /**
  * Get framework-specific issues based on HTML analysis
  */
-declare function getFrameworkIssues(frameworkInfo: FrameworkInfo, html: string, url: string): Promise<AuditIssue[]>;
+declare function getFrameworkIssues(frameworkInfo: FrameworkInfo, html: string, url: string, options?: {
+    indexable?: boolean;
+}): Promise<AuditIssue[]>;
 /**
  * Get framework-specific suggestions for fixing issues
  */
@@ -5689,4 +5708,4 @@ declare namespace index {
   export { type index_DetectionResult as DetectionResult, type index_Evidence as Evidence, type index_Framework as Framework, type index_FrameworkCheck as FrameworkCheck, type index_FrameworkInfo as FrameworkInfo, type index_FrameworkRecipe as FrameworkRecipe, index_SCORE_FLOOR as SCORE_FLOOR, index_SIGNALS as SIGNALS, index_SUPPORTED_FRAMEWORKS as SUPPORTED_FRAMEWORKS, type index_Signal as Signal, index_WEIGHT as WEIGHT, detectFramework$1 as detectFramework, index_detectFromEvidence as detectFromEvidence, index_detectFromHeaders as detectFromHeaders, index_detectFromHtml as detectFromHtml, index_detectFromPackageJson as detectFromPackageJson, index_embedRecipe as embedRecipe, index_getFrameworkChecks as getFrameworkChecks, index_getFrameworkDisplayName as getFrameworkDisplayName, index_getFrameworkIssues as getFrameworkIssues, index_getFrameworkSuggestions as getFrameworkSuggestions, index_getFrameworkSummary as getFrameworkSummary, index_getMigrationPaths as getMigrationPaths, index_getPerformanceTips as getPerformanceTips, index_getSeoChallenges as getSeoChallenges, index_getTotalFrameworkChecks as getTotalFrameworkChecks, index_loadRecipe as loadRecipe };
 }
 
-export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type CompetitorUrl, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DeterministicFixInput, type DeterministicFixes, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$2 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordLLM, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type KeywordTrend, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo$1 as LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type RankCheckOptions, type RankCheckResult, type RankHistory, RankTracker, type RankingResult, type RankingTierLimits, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SerpApiConfig, SerpClient, type SerpClientConfig, type SerpFeature, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, TIER_LIMITS, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackedKeyword, type TrackerConfig, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeDOMStructure, analyzeFeaturedSnippetPotential, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages$1 as analyzeImages, analyzeKeywordDensity, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeOnPage, analyzePagination, analyzePerformance, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders$1 as analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData$1 as analyzeStructuredData, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, index$1 as analyzers, applyFixes, assessReplacement, buildDeterministicFixes, buildFrameworkGuidance, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, describeConcerns, detectDuplicates, detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findAppRoot, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAspNetCoreSEO, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDjangoSEOHelper, generateDuplicateIssues, generateEleventySEO, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateGoSEO, generateHTMLReport, generateHTMLSocialMeta, generateHTMXSEO, generateHeadlineVariations, generateHugoSEO, generateJekyllSEO, generateJsonReport, generateKeyFacts, generateLaravelSEOHelper, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generatePhoenixSEO, generateRailsSEOHelper, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateRemixSEO, generateSecretsDoc, generateSocialMetaFix, generateSpringBootSEO, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getFrameworkSpecificFixExtended, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, keywordLLM, listFiles, loadAgent, loadAgentByName, mergePages, openAIKeywordLLM, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseJsonReply, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };
+export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type CompetitorUrl, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DeterministicFixInput, type DeterministicFixes, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$2 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordLLM, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type KeywordTrend, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo$1 as LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type RankCheckOptions, type RankCheckResult, type RankHistory, RankTracker, type RankingResult, type RankingTierLimits, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SerpApiConfig, SerpClient, type SerpClientConfig, type SerpFeature, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, TIER_LIMITS, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackedKeyword, type TrackerConfig, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeDOMStructure, analyzeFeaturedSnippetPotential, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages$1 as analyzeImages, analyzeKeywordDensity, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeOnPage, analyzePagination, analyzePerformance, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders$1 as analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData$1 as analyzeStructuredData, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, index$1 as analyzers, applyFixes, assessReplacement, buildDeterministicFixes, buildFrameworkGuidance, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, describeConcerns, detectDuplicates, detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findAppRoot, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAspNetCoreSEO, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDjangoSEOHelper, generateDuplicateIssues, generateEleventySEO, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateGoSEO, generateHTMLReport, generateHTMLSocialMeta, generateHTMXSEO, generateHeadlineVariations, generateHugoSEO, generateJekyllSEO, generateJsonReport, generateKeyFacts, generateLaravelSEOHelper, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generatePhoenixSEO, generateRailsSEOHelper, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateRemixSEO, generateSecretsDoc, generateSocialMetaFix, generateSpringBootSEO, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getFrameworkSpecificFixExtended, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, keywordLLM, listFiles, loadAgent, loadAgentByName, mergePages, openAIKeywordLLM, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseJsonReply, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, servedDir, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };

package/dist/index.js

@@ -3562,6 +3562,7 @@ __export(index_exports, {
   sendAlerts: () => sendAlerts,
   sendDiscordAlert: () => sendDiscordAlert,
   sendSlackAlert: () => sendSlackAlert,
+  servedDir: () => servedDir,
   shouldRunAudit: () => shouldRunAudit,
   shouldSendAlert: () => shouldSendAlert,
   startWizardSession: () => startWizardSession,
@@ -3623,6 +3624,7 @@ var RECIPES = {
   eleventy: null,
   pelican: null,
   sphinx: null,
+  docusaurus: null,
   // Unknown
   unknown: null
 };
@@ -3658,12 +3660,13 @@ async function loadRecipe(framework) {
   }
   return null;
 }
-async function getFrameworkIssues(frameworkInfo, html, url) {
+async function getFrameworkIssues(frameworkInfo, html, url, options = {}) {
   const recipe = await loadRecipe(frameworkInfo.framework);
   if (!recipe) return [];
   const issues = [];
+  const indexable = options.indexable ?? true;
   for (const check of recipe.checks) {
-    const matched = evaluateCheck(check, html, frameworkInfo);
+    const matched = evaluateCheck(check, html, frameworkInfo, indexable);
     if (matched) {
       issues.push({
         code: check.code,
@@ -3684,7 +3687,10 @@ async function getFrameworkIssues(frameworkInfo, html, url) {
   }
   return issues;
 }
-function evaluateCheck(check, html, frameworkInfo) {
+function evaluateCheck(check, html, frameworkInfo, indexable = true) {
+  if (check.indexable_only && !indexable) {
+    return false;
+  }
   if (check.app_router_only && html.includes("__next")) {
     return false;
   }
@@ -3798,6 +3804,7 @@ seo_challenges:
 
 checks:
   - code: ANGULAR_NO_UNIVERSAL
+    indexable_only: true
     severity: error
     title: "Angular app without Universal (SSR)"
     description: "Client-side Angular apps send empty HTML to crawlers."
@@ -3816,6 +3823,7 @@ checks:
       missing_content: true
 
   - code: ANGULAR_NO_TITLE_SERVICE
+    indexable_only: true
     severity: error
     title: "Not using Title/Meta services"
     description: "Angular has built-in services for managing title and meta tags."
@@ -3864,6 +3872,7 @@ checks:
       \`\`\`
 
   - code: ANGULAR_PRERENDER_MISSING
+    indexable_only: true
     severity: warning
     title: "Static routes not prerendered"
     description: "Static pages should be prerendered at build time."
@@ -4222,6 +4231,7 @@ checks:
       \`\`\`
 
   - code: DJANGO_NO_META_FRAMEWORK
+    indexable_only: true
     severity: warning
     title: "No SEO meta framework detected"
     description: "Use django-meta for consistent meta tag management."
@@ -4369,6 +4379,7 @@ seo_strengths:
 
 checks:
   - code: LARAVEL_NO_META_PACKAGE
+    indexable_only: true
     severity: warning
     title: "No SEO package detected"
     description: "Laravel benefits from an SEO package like artesaos/seotools."
@@ -4420,6 +4431,7 @@ checks:
       \`\`\`
 
   - code: LARAVEL_INERTIA_NO_SSR
+    indexable_only: true
     severity: error
     title: "Inertia.js without SSR"
     description: "Inertia apps are client-rendered by default, losing SEO benefits."
@@ -4514,6 +4526,7 @@ seo_strengths:
 checks:
   # App Router specific
   - code: NEXTJS_NO_METADATA_API
+    indexable_only: true
     severity: warning
     title: "Not using Next.js Metadata API"
     description: "Next.js 13+ has a built-in Metadata API that's better than react-helmet."
@@ -4786,6 +4799,7 @@ seo_strengths:
 
 checks:
   - code: NUXT_NO_USESEOMETA
+    indexable_only: true
     severity: warning
     title: "Not using useSeoMeta composable"
     description: "Nuxt 3 has built-in SEO meta composables that are cleaner than useHead."
@@ -4895,6 +4909,7 @@ checks:
       \`\`\`
 
   - code: NUXT_SPA_MODE
+    indexable_only: true
     severity: error
     title: "Nuxt running in SPA mode"
     description: "SPA mode disables SSR, losing SEO benefits."
@@ -4920,6 +4935,7 @@ checks:
       missing_content: true
 
   - code: NUXT_NO_PRERENDER
+    indexable_only: true
     severity: notice
     title: "Static pages not pre-rendered"
     description: "Static pages could be pre-rendered for better performance."
@@ -4963,6 +4979,7 @@ seo_strengths:
 
 checks:
   - code: RAILS_NO_META_TAGS_GEM
+    indexable_only: true
     severity: warning
     title: "Not using meta-tags gem"
     description: "The meta-tags gem provides a clean API for SEO tags."
@@ -5035,6 +5052,7 @@ checks:
       \`\`\`
 
   - code: RAILS_TURBO_BREAKS_CRAWLERS
+    indexable_only: true
     severity: notice
     title: "Turbo may affect JavaScript-dependent crawlers"
     description: "Turbo Drive updates pages via JavaScript, which some crawlers may miss."
@@ -5157,6 +5175,7 @@ seo_challenges:
 checks:
   # Critical - these will severely hurt SEO
   - code: REACT_CSR_DETECTED
+    indexable_only: true
     severity: error
     title: "Client-side rendered React app detected"
     description: "React apps without SSR send empty HTML to crawlers. Search engines may not index your content."
@@ -5172,6 +5191,7 @@ checks:
       missing_content: true  # Body has minimal text content
 
   - code: REACT_NO_SSR_META
+    indexable_only: true
     severity: error
     title: "Meta tags not server-rendered"
     description: "Title and meta description are set client-side and won't be seen by crawlers."
@@ -5238,6 +5258,7 @@ checks:
       \`\`\`
 
   - code: REACT_ROUTER_NO_SSR
+    indexable_only: true
     severity: warning
     title: "React Router without server-side support"
     description: "Client-side routing breaks when crawlers access URLs directly."
@@ -5256,6 +5277,7 @@ checks:
       \`\`\`
 
   - code: REACT_NO_PRERENDER
+    indexable_only: true
     severity: warning
     title: "No prerendering configured"
     description: "Static pages could be prerendered for better SEO and performance."
@@ -5412,6 +5434,7 @@ checks:
         - 'name="description"'
 
   - code: SVELTEKIT_NO_PRERENDER
+    indexable_only: true
     severity: notice
     title: "Static pages not prerendered"
     description: "Static pages should be prerendered for best performance."
@@ -5517,6 +5540,7 @@ seo_challenges:
 
 checks:
   - code: VUE_CSR_DETECTED
+    indexable_only: true
     severity: error
     title: "Client-side rendered Vue app detected"
     description: "Vue apps without SSR send empty HTML to crawlers."
@@ -5533,6 +5557,7 @@ checks:
       missing_content: true
 
   - code: VUE_NO_META_MANAGEMENT
+    indexable_only: true
     severity: error
     title: "No meta tag management library"
     description: "Title and meta description are not dynamically managed."
@@ -7836,6 +7861,11 @@ var SIGNALS = [
   // Sphinx: what nearly every Python project's documentation is built with, and the shape
   // flask.palletsprojects.com turned out to be. Structural markers only - not the word
   // "sphinx", which appears in plenty of prose.
+  // Validated against docusaurus.io, jestjs.io and redux.js.org - all three carry the mount
+  // point and the skip-to-content id. Deliberately not the word "docusaurus", which appears on
+  // deno.com purely as a link in a logo list; that near-miss is why this needed a real marker.
+  { framework: "docusaurus", language: "typescript", weight: WEIGHT.DECISIVE, name: "docusaurus-root", html: /id=["']__docusaurus/ },
+  { framework: "docusaurus", language: "typescript", weight: WEIGHT.STRONG, name: "docusaurus-skip-link", html: /__docusaurus_skipToContent/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.DECISIVE, name: "sphinx-doc-options", html: /_static\/documentation_options\.js/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.STRONG, name: "sphinx-theme-markup", html: /class=["'][^"']*sphinxsidebar|sphinx-highlight|_static\/searchtools\.js/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.STRONG, name: "docutils-generator", html: /name=["']?generator["']?[^>]*content=["']?Docutils/i }
@@ -8249,6 +8279,7 @@ function getFrameworkDisplayName(framework) {
     eleventy: "Eleventy (11ty)",
     pelican: "Pelican",
     sphinx: "Sphinx",
+    docusaurus: "Docusaurus",
     unknown: "Unknown"
   };
   return names[framework];
@@ -8494,6 +8525,23 @@ function metaHasNoindex(content) {
   if (!content) return false;
   return content.toLowerCase().split(",").some((d) => ["noindex", "none"].includes(d.trim()));
 }
+function readRobotsDirectives(html, headers) {
+  const $ = cheerio.load(html);
+  const metaValues = [];
+  $("meta[name]").each((_, el) => {
+    const name = ($(el).attr("name") || "").toLowerCase();
+    if (name === "robots" || name === "googlebot") {
+      metaValues.push($(el).attr("content") || "");
+    }
+  });
+  const metaNoindex = metaValues.some(metaHasNoindex);
+  const xRobotsTag = headers ? Object.entries(headers).find(([k]) => k.toLowerCase() === "x-robots-tag")?.[1] : void 0;
+  const headerNoindex = xRobotsTagHasNoindex(xRobotsTag);
+  return { metaValues, metaNoindex, xRobotsTag, headerNoindex, hasNoindex: metaNoindex || headerNoindex };
+}
+function pageHasNoindex(html, headers) {
+  return readRobotsDirectives(html, headers).hasNoindex;
+}
 function isSiteRoot(url) {
   try {
     const u = new URL(url);
@@ -8509,17 +8557,7 @@ function analyzeOnPage(html, url, headers, options = {}) {
   const description = $('meta[name="description"]').attr("content")?.trim();
   const canonical = $('link[rel="canonical"]').attr("href");
   const metaRobots = $('meta[name="robots"]').attr("content");
-  const robotsMetaValues = [];
-  $("meta[name]").each((_, el) => {
-    const name = ($(el).attr("name") || "").toLowerCase();
-    if (name === "robots" || name === "googlebot") {
-      robotsMetaValues.push($(el).attr("content") || "");
-    }
-  });
-  const metaNoindex = robotsMetaValues.some(metaHasNoindex);
-  const headerLookup = headers ? Object.entries(headers).find(([k]) => k.toLowerCase() === "x-robots-tag")?.[1] : void 0;
-  const headerNoindex = xRobotsTagHasNoindex(headerLookup);
-  const hasNoindex = metaNoindex || headerNoindex;
+  const { metaValues: robotsMetaValues, metaNoindex, xRobotsTag: headerLookup, headerNoindex, hasNoindex } = readRobotsDirectives(html, headers);
   const h1s = [];
   $("h1").each((_, el) => {
     h1s.push($(el).text().trim());
@@ -15940,6 +15978,17 @@ var NAMED_COLORS = {
   transparent: [255, 255, 255]
   // Treat as white for calculation
 };
+function inheritedBackground($el) {
+  for (const ancestor of $el.parents().toArray()) {
+    const style = ancestor.attribs?.style;
+    if (!style) continue;
+    const match = style.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i);
+    if (!match) continue;
+    const value = match[1].trim();
+    if (!/^(transparent|none)$/i.test(value)) return value;
+  }
+  return null;
+}
 function analyzeColorContrast(html, url) {
   const issues = [];
   const $ = cheerio32.load(html);
@@ -15960,12 +16009,16 @@ function analyzeColorContrast(html, url) {
     const colorMatch = style.match(/(?:^|;)\s*color\s*:\s*([^;]+)/i);
     const bgMatch = style.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i);
     const foreground = colorMatch ? colorMatch[1].trim() : null;
-    const background = bgMatch ? bgMatch[1].trim() : null;
+    const background = bgMatch ? bgMatch[1].trim() : inheritedBackground($el);
     if (!foreground) {
       cannotDetermine++;
       return;
     }
-    const bgColor = background || "white";
+    if (!background) {
+      cannotDetermine++;
+      return;
+    }
+    const bgColor = background;
     const fgRgb = parseColor(foreground);
     const bgRgb = parseColor(bgColor);
     if (!fgRgb || !bgRgb) {
@@ -17661,7 +17714,9 @@ async function runFullAudit(options) {
   asyncChecks.push(safeAsyncIssues("Framework Detection", async () => {
     const frameworkInfo = detectFramework({ html, headers });
     if (frameworkInfo.framework === "unknown") return [];
-    return getFrameworkIssues(frameworkInfo, html, url);
+    return getFrameworkIssues(frameworkInfo, html, url, {
+      indexable: !pageHasNoindex(html, headers)
+    });
   }));
   if (runExtendedChecks) {
     asyncChecks.push(safeAsync("Hreflang", () => analyzeHreflang(html, url, { validateUrls: checkHreflangUrls })));
@@ -32936,6 +32991,48 @@ function findAppRoot(files) {
   return `${nonRoot[0]}/`;
 }
 
+// src/fixer/served-dir.ts
+var SERVED_DIR = {
+  // Bundlers and meta-frameworks that copy a public/ directory verbatim.
+  react: "public/",
+  vue: "public/",
+  svelte: "public/",
+  angular: "public/",
+  solidjs: "public/",
+  qwik: "public/",
+  nextjs: "public/",
+  nuxt: "public/",
+  astro: "public/",
+  sveltekit: "static/",
+  // SvelteKit's is static/, not public/
+  remix: "public/",
+  fresh: "static/",
+  // Gatsby, Hugo, Eleventy and Docusaurus all name theirs static/.
+  gatsby: "static/",
+  hugo: "static/",
+  eleventy: "public/",
+  docusaurus: "static/",
+  // Server frameworks with a public document root.
+  rails: "public/",
+  laravel: "public/",
+  symfony: "public/",
+  phoenix: "priv/static/",
+  spring: "src/main/resources/static/",
+  aspnet: "wwwroot/",
+  // Jekyll and Pelican copy their source tree, so the app root is the served root.
+  jekyll: "",
+  pelican: ""
+  // Python web frameworks have no single convention; the tree decides below.
+};
+function servedDir(framework, files, appRoot = "") {
+  const known = framework ? SERVED_DIR[framework] : void 0;
+  if (known !== void 0) return known;
+  for (const candidate of ["public/", "static/", "assets/"]) {
+    if (files.some((f) => f.startsWith(`${appRoot}${candidate}`))) return candidate;
+  }
+  return "";
+}
+
 // src/fixer/safety.ts
 var HTML_EXT = /\.html?$/i;
 var SOURCE_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|vue|svelte|astro)$/i;
@@ -35915,6 +36012,7 @@ var SUPPORTED_FRAMEWORKS = [
   sendAlerts,
   sendDiscordAlert,
   sendSlackAlert,
+  servedDir,
   shouldRunAudit,
   shouldSendAlert,
   startWizardSession,

package/dist/index.mjs

@@ -95,6 +95,7 @@ var RECIPES = {
   eleventy: null,
   pelican: null,
   sphinx: null,
+  docusaurus: null,
   // Unknown
   unknown: null
 };
@@ -130,12 +131,13 @@ async function loadRecipe(framework) {
   }
   return null;
 }
-async function getFrameworkIssues(frameworkInfo, html, url) {
+async function getFrameworkIssues(frameworkInfo, html, url, options = {}) {
   const recipe = await loadRecipe(frameworkInfo.framework);
   if (!recipe) return [];
   const issues = [];
+  const indexable = options.indexable ?? true;
   for (const check of recipe.checks) {
-    const matched = evaluateCheck(check, html, frameworkInfo);
+    const matched = evaluateCheck(check, html, frameworkInfo, indexable);
     if (matched) {
       issues.push({
         code: check.code,
@@ -156,7 +158,10 @@ async function getFrameworkIssues(frameworkInfo, html, url) {
   }
   return issues;
 }
-function evaluateCheck(check, html, frameworkInfo) {
+function evaluateCheck(check, html, frameworkInfo, indexable = true) {
+  if (check.indexable_only && !indexable) {
+    return false;
+  }
   if (check.app_router_only && html.includes("__next")) {
     return false;
   }
@@ -270,6 +275,7 @@ seo_challenges:
 
 checks:
   - code: ANGULAR_NO_UNIVERSAL
+    indexable_only: true
     severity: error
     title: "Angular app without Universal (SSR)"
     description: "Client-side Angular apps send empty HTML to crawlers."
@@ -288,6 +294,7 @@ checks:
       missing_content: true
 
   - code: ANGULAR_NO_TITLE_SERVICE
+    indexable_only: true
     severity: error
     title: "Not using Title/Meta services"
     description: "Angular has built-in services for managing title and meta tags."
@@ -336,6 +343,7 @@ checks:
       \`\`\`
 
   - code: ANGULAR_PRERENDER_MISSING
+    indexable_only: true
     severity: warning
     title: "Static routes not prerendered"
     description: "Static pages should be prerendered at build time."
@@ -694,6 +702,7 @@ checks:
       \`\`\`
 
   - code: DJANGO_NO_META_FRAMEWORK
+    indexable_only: true
     severity: warning
     title: "No SEO meta framework detected"
     description: "Use django-meta for consistent meta tag management."
@@ -841,6 +850,7 @@ seo_strengths:
 
 checks:
   - code: LARAVEL_NO_META_PACKAGE
+    indexable_only: true
     severity: warning
     title: "No SEO package detected"
     description: "Laravel benefits from an SEO package like artesaos/seotools."
@@ -892,6 +902,7 @@ checks:
       \`\`\`
 
   - code: LARAVEL_INERTIA_NO_SSR
+    indexable_only: true
     severity: error
     title: "Inertia.js without SSR"
     description: "Inertia apps are client-rendered by default, losing SEO benefits."
@@ -986,6 +997,7 @@ seo_strengths:
 checks:
   # App Router specific
   - code: NEXTJS_NO_METADATA_API
+    indexable_only: true
     severity: warning
     title: "Not using Next.js Metadata API"
     description: "Next.js 13+ has a built-in Metadata API that's better than react-helmet."
@@ -1258,6 +1270,7 @@ seo_strengths:
 
 checks:
   - code: NUXT_NO_USESEOMETA
+    indexable_only: true
     severity: warning
     title: "Not using useSeoMeta composable"
     description: "Nuxt 3 has built-in SEO meta composables that are cleaner than useHead."
@@ -1367,6 +1380,7 @@ checks:
       \`\`\`
 
   - code: NUXT_SPA_MODE
+    indexable_only: true
     severity: error
     title: "Nuxt running in SPA mode"
     description: "SPA mode disables SSR, losing SEO benefits."
@@ -1392,6 +1406,7 @@ checks:
       missing_content: true
 
   - code: NUXT_NO_PRERENDER
+    indexable_only: true
     severity: notice
     title: "Static pages not pre-rendered"
     description: "Static pages could be pre-rendered for better performance."
@@ -1435,6 +1450,7 @@ seo_strengths:
 
 checks:
   - code: RAILS_NO_META_TAGS_GEM
+    indexable_only: true
     severity: warning
     title: "Not using meta-tags gem"
     description: "The meta-tags gem provides a clean API for SEO tags."
@@ -1507,6 +1523,7 @@ checks:
       \`\`\`
 
   - code: RAILS_TURBO_BREAKS_CRAWLERS
+    indexable_only: true
     severity: notice
     title: "Turbo may affect JavaScript-dependent crawlers"
     description: "Turbo Drive updates pages via JavaScript, which some crawlers may miss."
@@ -1629,6 +1646,7 @@ seo_challenges:
 checks:
   # Critical - these will severely hurt SEO
   - code: REACT_CSR_DETECTED
+    indexable_only: true
     severity: error
     title: "Client-side rendered React app detected"
     description: "React apps without SSR send empty HTML to crawlers. Search engines may not index your content."
@@ -1644,6 +1662,7 @@ checks:
       missing_content: true  # Body has minimal text content
 
   - code: REACT_NO_SSR_META
+    indexable_only: true
     severity: error
     title: "Meta tags not server-rendered"
     description: "Title and meta description are set client-side and won't be seen by crawlers."
@@ -1710,6 +1729,7 @@ checks:
       \`\`\`
 
   - code: REACT_ROUTER_NO_SSR
+    indexable_only: true
     severity: warning
     title: "React Router without server-side support"
     description: "Client-side routing breaks when crawlers access URLs directly."
@@ -1728,6 +1748,7 @@ checks:
       \`\`\`
 
   - code: REACT_NO_PRERENDER
+    indexable_only: true
     severity: warning
     title: "No prerendering configured"
     description: "Static pages could be prerendered for better SEO and performance."
@@ -1884,6 +1905,7 @@ checks:
         - 'name="description"'
 
   - code: SVELTEKIT_NO_PRERENDER
+    indexable_only: true
     severity: notice
     title: "Static pages not prerendered"
     description: "Static pages should be prerendered for best performance."
@@ -1989,6 +2011,7 @@ seo_challenges:
 
 checks:
   - code: VUE_CSR_DETECTED
+    indexable_only: true
     severity: error
     title: "Client-side rendered Vue app detected"
     description: "Vue apps without SSR send empty HTML to crawlers."
@@ -2005,6 +2028,7 @@ checks:
       missing_content: true
 
   - code: VUE_NO_META_MANAGEMENT
+    indexable_only: true
     severity: error
     title: "No meta tag management library"
     description: "Title and meta description are not dynamically managed."
@@ -4305,6 +4329,11 @@ var SIGNALS = [
   // Sphinx: what nearly every Python project's documentation is built with, and the shape
   // flask.palletsprojects.com turned out to be. Structural markers only - not the word
   // "sphinx", which appears in plenty of prose.
+  // Validated against docusaurus.io, jestjs.io and redux.js.org - all three carry the mount
+  // point and the skip-to-content id. Deliberately not the word "docusaurus", which appears on
+  // deno.com purely as a link in a logo list; that near-miss is why this needed a real marker.
+  { framework: "docusaurus", language: "typescript", weight: WEIGHT.DECISIVE, name: "docusaurus-root", html: /id=["']__docusaurus/ },
+  { framework: "docusaurus", language: "typescript", weight: WEIGHT.STRONG, name: "docusaurus-skip-link", html: /__docusaurus_skipToContent/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.DECISIVE, name: "sphinx-doc-options", html: /_static\/documentation_options\.js/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.STRONG, name: "sphinx-theme-markup", html: /class=["'][^"']*sphinxsidebar|sphinx-highlight|_static\/searchtools\.js/ },
   { framework: "sphinx", language: "python", weight: WEIGHT.STRONG, name: "docutils-generator", html: /name=["']?generator["']?[^>]*content=["']?Docutils/i }
@@ -4718,6 +4747,7 @@ function getFrameworkDisplayName(framework) {
     eleventy: "Eleventy (11ty)",
     pelican: "Pelican",
     sphinx: "Sphinx",
+    docusaurus: "Docusaurus",
     unknown: "Unknown"
   };
   return names[framework];
@@ -4962,6 +4992,23 @@ function metaHasNoindex(content) {
   if (!content) return false;
   return content.toLowerCase().split(",").some((d) => ["noindex", "none"].includes(d.trim()));
 }
+function readRobotsDirectives(html, headers) {
+  const $ = cheerio.load(html);
+  const metaValues = [];
+  $("meta[name]").each((_, el) => {
+    const name = ($(el).attr("name") || "").toLowerCase();
+    if (name === "robots" || name === "googlebot") {
+      metaValues.push($(el).attr("content") || "");
+    }
+  });
+  const metaNoindex = metaValues.some(metaHasNoindex);
+  const xRobotsTag = headers ? Object.entries(headers).find(([k]) => k.toLowerCase() === "x-robots-tag")?.[1] : void 0;
+  const headerNoindex = xRobotsTagHasNoindex(xRobotsTag);
+  return { metaValues, metaNoindex, xRobotsTag, headerNoindex, hasNoindex: metaNoindex || headerNoindex };
+}
+function pageHasNoindex(html, headers) {
+  return readRobotsDirectives(html, headers).hasNoindex;
+}
 function isSiteRoot(url) {
   try {
     const u = new URL(url);
@@ -4977,17 +5024,7 @@ function analyzeOnPage(html, url, headers, options = {}) {
   const description = $('meta[name="description"]').attr("content")?.trim();
   const canonical = $('link[rel="canonical"]').attr("href");
   const metaRobots = $('meta[name="robots"]').attr("content");
-  const robotsMetaValues = [];
-  $("meta[name]").each((_, el) => {
-    const name = ($(el).attr("name") || "").toLowerCase();
-    if (name === "robots" || name === "googlebot") {
-      robotsMetaValues.push($(el).attr("content") || "");
-    }
-  });
-  const metaNoindex = robotsMetaValues.some(metaHasNoindex);
-  const headerLookup = headers ? Object.entries(headers).find(([k]) => k.toLowerCase() === "x-robots-tag")?.[1] : void 0;
-  const headerNoindex = xRobotsTagHasNoindex(headerLookup);
-  const hasNoindex = metaNoindex || headerNoindex;
+  const { metaValues: robotsMetaValues, metaNoindex, xRobotsTag: headerLookup, headerNoindex, hasNoindex } = readRobotsDirectives(html, headers);
   const h1s = [];
   $("h1").each((_, el) => {
     h1s.push($(el).text().trim());
@@ -12387,6 +12424,17 @@ var NAMED_COLORS = {
   transparent: [255, 255, 255]
   // Treat as white for calculation
 };
+function inheritedBackground($el) {
+  for (const ancestor of $el.parents().toArray()) {
+    const style = ancestor.attribs?.style;
+    if (!style) continue;
+    const match = style.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i);
+    if (!match) continue;
+    const value = match[1].trim();
+    if (!/^(transparent|none)$/i.test(value)) return value;
+  }
+  return null;
+}
 function analyzeColorContrast(html, url) {
   const issues = [];
   const $ = cheerio32.load(html);
@@ -12407,12 +12455,16 @@ function analyzeColorContrast(html, url) {
     const colorMatch = style.match(/(?:^|;)\s*color\s*:\s*([^;]+)/i);
     const bgMatch = style.match(/(?:^|;)\s*background(?:-color)?\s*:\s*([^;]+)/i);
     const foreground = colorMatch ? colorMatch[1].trim() : null;
-    const background = bgMatch ? bgMatch[1].trim() : null;
+    const background = bgMatch ? bgMatch[1].trim() : inheritedBackground($el);
     if (!foreground) {
       cannotDetermine++;
       return;
     }
-    const bgColor = background || "white";
+    if (!background) {
+      cannotDetermine++;
+      return;
+    }
+    const bgColor = background;
     const fgRgb = parseColor(foreground);
     const bgRgb = parseColor(bgColor);
     if (!fgRgb || !bgRgb) {
@@ -14105,7 +14157,9 @@ async function runFullAudit(options) {
   asyncChecks.push(safeAsyncIssues("Framework Detection", async () => {
     const frameworkInfo = detectFramework({ html, headers });
     if (frameworkInfo.framework === "unknown") return [];
-    return getFrameworkIssues(frameworkInfo, html, url);
+    return getFrameworkIssues(frameworkInfo, html, url, {
+      indexable: !pageHasNoindex(html, headers)
+    });
   }));
   if (runExtendedChecks) {
     asyncChecks.push(safeAsync("Hreflang", () => analyzeHreflang(html, url, { validateUrls: checkHreflangUrls })));
@@ -29365,6 +29419,48 @@ function findAppRoot(files) {
   return `${nonRoot[0]}/`;
 }
 
+// src/fixer/served-dir.ts
+var SERVED_DIR = {
+  // Bundlers and meta-frameworks that copy a public/ directory verbatim.
+  react: "public/",
+  vue: "public/",
+  svelte: "public/",
+  angular: "public/",
+  solidjs: "public/",
+  qwik: "public/",
+  nextjs: "public/",
+  nuxt: "public/",
+  astro: "public/",
+  sveltekit: "static/",
+  // SvelteKit's is static/, not public/
+  remix: "public/",
+  fresh: "static/",
+  // Gatsby, Hugo, Eleventy and Docusaurus all name theirs static/.
+  gatsby: "static/",
+  hugo: "static/",
+  eleventy: "public/",
+  docusaurus: "static/",
+  // Server frameworks with a public document root.
+  rails: "public/",
+  laravel: "public/",
+  symfony: "public/",
+  phoenix: "priv/static/",
+  spring: "src/main/resources/static/",
+  aspnet: "wwwroot/",
+  // Jekyll and Pelican copy their source tree, so the app root is the served root.
+  jekyll: "",
+  pelican: ""
+  // Python web frameworks have no single convention; the tree decides below.
+};
+function servedDir(framework, files, appRoot = "") {
+  const known = framework ? SERVED_DIR[framework] : void 0;
+  if (known !== void 0) return known;
+  for (const candidate of ["public/", "static/", "assets/"]) {
+    if (files.some((f) => f.startsWith(`${appRoot}${candidate}`))) return candidate;
+  }
+  return "";
+}
+
 // src/fixer/safety.ts
 var HTML_EXT = /\.html?$/i;
 var SOURCE_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|vue|svelte|astro)$/i;
@@ -32336,6 +32432,7 @@ export {
   sendAlerts,
   sendDiscordAlert,
   sendSlackAlert,
+  servedDir,
   shouldRunAudit,
   shouldSendAlert,
   startWizardSession,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/agent-runtime",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "description": "RankCLI agent runtime - executes SEO audits and fixes with AI",
   "homepage": "https://rankcli.dev",
   "main": "dist/index.js",