@rankcli/agent-runtime 0.0.26 → 0.0.28

package/dist/{analyzer-MCBRQHB7.mjs → analyzer-BYAFIO33.mjs}

@@ -1,6 +1,6 @@
 import {
   analyzeUrl
-} from "./chunk-NATXE6B3.mjs";
+} from "./chunk-O7B2LBKG.mjs";
 import "./chunk-6BWS3CLP.mjs";
 export {
   analyzeUrl

package/dist/{chunk-NATXE6B3.mjs → chunk-O7B2LBKG.mjs}

@@ -13,6 +13,12 @@ function headersToObject(headers) {
   });
   return obj;
 }
+function looksLikeHtmlFallback(body, contentType) {
+  if (contentType && /text\/html/i.test(contentType)) return true;
+  if (typeof body !== "string") return false;
+  const head = body.trimStart().slice(0, 200).toLowerCase();
+  return head.startsWith("<!doctype html") || head.startsWith("<html");
+}
 async function httpGet(url, config = {}) {
   const {
     headers = {},
@@ -745,6 +751,7 @@ function generateRecommendations(issues) {
 }
 
 export {
+  looksLikeHtmlFallback,
   httpGet,
   httpHead,
   httpPost,

package/dist/index.d.mts

@@ -2846,6 +2846,7 @@ declare function generateGitHubActionSetup(config: WorkflowConfig): {
     secretsDoc: string;
     readmeBadge: string;
 };
+
 /**
  * Write GitHub Action files to project
  */
@@ -2982,6 +2983,46 @@ declare function generateEleventySEO(options: MetaFixOptions): GeneratedCode;
 declare function generateRemixSEO(options: MetaFixOptions): GeneratedCode;
 declare function getFrameworkSpecificFixExtended(framework: FrameworkInfo$1, options: MetaFixOptions): GeneratedCode;
 
+interface DeterministicFixInput {
+    siteUrl: string;
+    siteName: string;
+    /** Monorepo app root, '' at the repository root. Every emitted path starts with it. */
+    appRoot: string;
+    /** Issue codes open on the audit; a fix is only offered for something actually reported. */
+    issueCodes: Set<string> | string[];
+    /** Current file contents, null when the file does not exist. */
+    existing: {
+        indexHtml?: string | null;
+        robotsTxt?: string | null;
+        sitemapXml?: string | null;
+        llmsTxt?: string | null;
+    };
+    /** URLs the audit saw, for the sitemap. The site URL alone is a valid sitemap. */
+    pages?: string[];
+    /** Meta description already on the page, if any. Never invented when absent. */
+    description?: string | null;
+}
+interface DeterministicFile {
+    path: string;
+    content: string;
+    message: string;
+    /** 'created' for a new file, 'edited' for an insertion into an existing one. */
+    action: 'created' | 'edited';
+}
+interface DeterministicFixes {
+    files: DeterministicFile[];
+    /** Issue codes these files address, for the PR body and issue bookkeeping. */
+    addressed: string[];
+    summary: string;
+}
+declare function buildDeterministicFixes(input: DeterministicFixInput): DeterministicFixes;
+
+/**
+ * @param files every path in the repository, as returned by the git tree API
+ * @returns the app root with a trailing slash, or '' for the repository root
+ */
+declare function findAppRoot(files: string[]): string;
+
 /**
  * World-Class JSON-LD Schema Generators
  *
@@ -5542,4 +5583,4 @@ declare namespace index {
   export { type index_Framework as Framework, type index_FrameworkCheck as FrameworkCheck, type index_FrameworkInfo as FrameworkInfo, type index_FrameworkRecipe as FrameworkRecipe, index_SUPPORTED_FRAMEWORKS as SUPPORTED_FRAMEWORKS, index_detectFramework as detectFramework, 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 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, 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, detectDuplicates, detectFramework$1 as 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, 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, buildDeterministicFixes, 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, detectDuplicates, detectFramework$1 as 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 };

package/dist/index.d.ts

@@ -2846,6 +2846,7 @@ declare function generateGitHubActionSetup(config: WorkflowConfig): {
     secretsDoc: string;
     readmeBadge: string;
 };
+
 /**
  * Write GitHub Action files to project
  */
@@ -2982,6 +2983,46 @@ declare function generateEleventySEO(options: MetaFixOptions): GeneratedCode;
 declare function generateRemixSEO(options: MetaFixOptions): GeneratedCode;
 declare function getFrameworkSpecificFixExtended(framework: FrameworkInfo$1, options: MetaFixOptions): GeneratedCode;
 
+interface DeterministicFixInput {
+    siteUrl: string;
+    siteName: string;
+    /** Monorepo app root, '' at the repository root. Every emitted path starts with it. */
+    appRoot: string;
+    /** Issue codes open on the audit; a fix is only offered for something actually reported. */
+    issueCodes: Set<string> | string[];
+    /** Current file contents, null when the file does not exist. */
+    existing: {
+        indexHtml?: string | null;
+        robotsTxt?: string | null;
+        sitemapXml?: string | null;
+        llmsTxt?: string | null;
+    };
+    /** URLs the audit saw, for the sitemap. The site URL alone is a valid sitemap. */
+    pages?: string[];
+    /** Meta description already on the page, if any. Never invented when absent. */
+    description?: string | null;
+}
+interface DeterministicFile {
+    path: string;
+    content: string;
+    message: string;
+    /** 'created' for a new file, 'edited' for an insertion into an existing one. */
+    action: 'created' | 'edited';
+}
+interface DeterministicFixes {
+    files: DeterministicFile[];
+    /** Issue codes these files address, for the PR body and issue bookkeeping. */
+    addressed: string[];
+    summary: string;
+}
+declare function buildDeterministicFixes(input: DeterministicFixInput): DeterministicFixes;
+
+/**
+ * @param files every path in the repository, as returned by the git tree API
+ * @returns the app root with a trailing slash, or '' for the repository root
+ */
+declare function findAppRoot(files: string[]): string;
+
 /**
  * World-Class JSON-LD Schema Generators
  *
@@ -5542,4 +5583,4 @@ declare namespace index {
   export { type index_Framework as Framework, type index_FrameworkCheck as FrameworkCheck, type index_FrameworkInfo as FrameworkInfo, type index_FrameworkRecipe as FrameworkRecipe, index_SUPPORTED_FRAMEWORKS as SUPPORTED_FRAMEWORKS, index_detectFramework as detectFramework, 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 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, 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, detectDuplicates, detectFramework$1 as 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, 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, buildDeterministicFixes, 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, detectDuplicates, detectFramework$1 as 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 };

package/dist/index.js

@@ -43,6 +43,12 @@ function headersToObject(headers) {
   });
   return obj;
 }
+function looksLikeHtmlFallback(body, contentType) {
+  if (contentType && /text\/html/i.test(contentType)) return true;
+  if (typeof body !== "string") return false;
+  const head = body.trimStart().slice(0, 200).toLowerCase();
+  return head.startsWith("<!doctype html") || head.startsWith("<html");
+}
 async function httpGet(url, config = {}) {
   const {
     headers = {},
@@ -535,8 +541,8 @@ async function analyzeUrl(params) {
     }
     const sitemapResult = await checkSitemap2({ url });
     if (sitemapResult.success) {
-      const sitemap = sitemapResult.data;
-      if (!sitemap.exists) {
+      const sitemap2 = sitemapResult.data;
+      if (!sitemap2.exists) {
         issues.push({
           severity: "warning",
           category: "technical",
@@ -3346,6 +3352,7 @@ __export(index_exports, {
   analyzeUrlSafety: () => analyzeUrlSafety,
   analyzers: () => analyzers_exports,
   applyFixes: () => applyFixes,
+  buildDeterministicFixes: () => buildDeterministicFixes,
   buildGSCApiRequest: () => buildGSCApiRequest,
   buildGSCRequest: () => buildGSCRequest,
   calculateAIVisibilityScore: () => calculateAIVisibilityScore,
@@ -3415,6 +3422,7 @@ __export(index_exports, {
   extractTopics: () => extractTopics,
   fetchCoreWebVitals: () => fetchCoreWebVitals,
   findAlmostPage1Keywords: () => findAlmostPage1Keywords,
+  findAppRoot: () => findAppRoot,
   findCTROpportunities: () => findCTROpportunities,
   findHtmlEntry: () => findHtmlEntry,
   findLSIKeywords: () => findLSIKeywords,
@@ -8406,6 +8414,17 @@ async function checkRobotsTxt(baseUrl) {
       };
     }
     const content = response.data;
+    if (looksLikeHtmlFallback(content, response.headers?.["content-type"])) {
+      issues.push({
+        ...ISSUE_DEFINITIONS.ROBOTS_TXT_MISSING,
+        affectedUrls: [url],
+        details: { servedHtml: true }
+      });
+      return {
+        issues,
+        data: { exists: false, blocksAll: false, hasSitemap: false, sitemapUrls: [] }
+      };
+    }
     const lines = content.toLowerCase().split("\n");
     let blocksAll = false;
     let currentUserAgent = "";
@@ -10547,6 +10566,13 @@ async function checkLlmsTxt(baseUrl) {
       };
     }
     const content = response.data;
+    if (looksLikeHtmlFallback(content, response.headers?.["content-type"])) {
+      issues.push({
+        ...ISSUE_DEFINITIONS.LLMS_TXT_MISSING,
+        affectedUrls: [url]
+      });
+      return { issues, data: { exists: false, valid: false, errors: ["File not found (the site served HTML)"] } };
+    }
     const lines = content.split("\n").filter((line) => line.trim());
     const errors = [];
     let valid = true;
@@ -14983,7 +15009,7 @@ async function analyzeLlmsTxt(url) {
       timeout: 1e4,
       validateStatus: () => true
     });
-    if (response.status === 200) {
+    if (response.status === 200 && !looksLikeHtmlFallback(response.data, response.headers?.["content-type"])) {
       exists = true;
       content = response.data;
       contentLength = content.length;
@@ -14993,7 +15019,7 @@ async function analyzeLlmsTxt(url) {
       timeout: 1e4,
       validateStatus: () => true
     });
-    if (fullResponse.status === 200) {
+    if (fullResponse.status === 200 && !looksLikeHtmlFallback(fullResponse.data, fullResponse.headers?.["content-type"])) {
       fullVersionExists = true;
     }
   } catch {
@@ -25336,7 +25362,7 @@ This will open a browser for OAuth consent and save tokens locally.
 `;
 }
 
-// src/tracking/github-action.ts
+// src/tracking/github-action-template.ts
 function generateWorkflow(config) {
   const cronSchedule = getCronSchedule(config.schedule);
   const sync = !!config.syncToDashboard;
@@ -25567,6 +25593,8 @@ function generateGitHubActionSetup(config) {
     readmeBadge: `[![SEO Status](https://github.com/YOUR_ORG/YOUR_REPO/actions/workflows/seo.yml/badge.svg)](https://github.com/YOUR_ORG/YOUR_REPO/actions/workflows/seo.yml)`
   };
 }
+
+// src/tracking/github-action.ts
 function writeGitHubActionFiles(projectPath, config) {
   const fs3 = require("fs");
   const path3 = require("path");
@@ -32097,7 +32125,7 @@ Sitemap: ${url}/sitemap.xml`;
   };
 }
 function generateSitemapFix(context, url) {
-  const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+  const sitemap2 = `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>${url}</loc>
@@ -32109,7 +32137,7 @@ function generateSitemapFix(context, url) {
     issue: { code: "MISSING_SITEMAP", message: "No sitemap.xml found", severity: "warning" },
     file: "public/sitemap.xml",
     before: null,
-    after: sitemap,
+    after: sitemap2,
     explanation: "Created sitemap.xml to help search engines discover all pages"
   };
 }
@@ -32206,7 +32234,7 @@ function generateLangFix(context) {
   };
 }
 function generateLlmsTxtFix(context, siteName, url) {
-  const llmsTxt = `# ${siteName}
+  const llmsTxt2 = `# ${siteName}
 > ${siteName} - A brief description of your product/service
 
 ## About
@@ -32229,7 +32257,7 @@ ${siteName} is... [Add your description here]
     issue: { code: "AI_NO_LLMS_TXT", message: "No llms.txt file for AI crawlers", severity: "info" },
     file: "public/llms.txt",
     before: null,
-    after: llmsTxt,
+    after: llmsTxt2,
     explanation: "Created llms.txt to help AI systems understand your site. Customize the content."
   };
 }
@@ -32279,6 +32307,9 @@ async function applyFixes(fixes, options) {
   return { applied, skipped };
 }
 
+// src/fixer/deterministic.ts
+init_geo_analyzer();
+
 // src/fixer/schemas.ts
 function generateOrganizationSchema(data) {
   return {
@@ -32861,6 +32892,155 @@ var Schemas = {
   sitelinksSearchbox: generateSitelinksSearchboxSchema
 };
 
+// src/fixer/deterministic.ts
+function xmlEscape(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function sitemap(urls) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const entries = urls.map(
+    (url) => `  <url>
+    <loc>${xmlEscape(url)}</loc>
+    <lastmod>${today}</lastmod>
+  </url>`
+  ).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generated by RankCLI - https://rankcli.dev -->
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries}
+</urlset>
+`;
+}
+function llmsTxt(siteName, siteUrl, description, pages) {
+  const base = siteUrl.replace(/\/$/, "");
+  const trim = (url) => url.replace(/\/$/, "");
+  const links = pages.filter((url) => trim(url) !== base).map((url) => ({ url, path: url.replace(base, "").replace(/^$/, "/") })).filter((page) => page.path !== "/").slice(0, 20).map((page) => `- [${page.path}](${page.url})`).join("\n");
+  return `# ${siteName}
+
+${description ? `> ${description}
+
+` : ""}${base}
+
+## Pages
+- [Home](${base}/)
+${links}
+
+<!-- Generated by RankCLI - https://rankcli.dev -->
+`;
+}
+function jsonLdBlock(siteName, siteUrl, description) {
+  const base = siteUrl.replace(/\/$/, "");
+  const graph = [
+    generateWebSiteSchema({ name: siteName, url: base, ...description ? { description } : {} }),
+    generateOrganizationSchema({ name: siteName, url: base, ...description ? { description } : {} })
+  ];
+  return `    <script type="application/ld+json">
+${JSON.stringify(graph, null, 2).split("\n").map((line) => `    ${line}`).join("\n")}
+    </script>
+`;
+}
+var SCHEMA_CODES = [
+  "SCHEMA_MISSING",
+  "SCHEMA_ORG_MISSING",
+  "ORGANIZATION_SCHEMA_MISSING",
+  "NO_ORGANIZATION_SCHEMA",
+  "NO_ENTITY_SCHEMA",
+  "STRUCTURED_DATA_MISSING"
+];
+function metaDescriptionOf(html) {
+  if (!html) return null;
+  const match = html.match(/<meta[^>]+name=["']description["'][^>]+content=["']([^"']+)["']/i) || html.match(/<meta[^>]+content=["']([^"']+)["'][^>]+name=["']description["']/i);
+  return match?.[1]?.trim() || null;
+}
+function buildDeterministicFixes(input) {
+  const codes = new Set(input.issueCodes);
+  const has = (...wanted) => wanted.some((code) => codes.has(code));
+  const root = input.appRoot || "";
+  const files = [];
+  const addressed = [];
+  const base = input.siteUrl.replace(/\/$/, "");
+  const pages = input.pages?.length ? input.pages : [`${base}/`];
+  const description = input.description ?? metaDescriptionOf(input.existing.indexHtml);
+  if (has("ROBOTS_TXT_MISSING", "AI_BOTS_BLOCKED", "AI_CRAWLERS_BLOCKED") && !input.existing.robotsTxt) {
+    files.push({
+      path: `${root}public/robots.txt`,
+      content: generateAIFriendlyRobotsTxt(base),
+      message: "fix(seo): add robots.txt allowing search and AI crawlers",
+      action: "created"
+    });
+    addressed.push("ROBOTS_TXT_MISSING");
+  }
+  if (has("SITEMAP_MISSING") && !input.existing.sitemapXml) {
+    files.push({
+      path: `${root}public/sitemap.xml`,
+      content: sitemap(pages),
+      message: "fix(seo): add sitemap.xml",
+      action: "created"
+    });
+    addressed.push("SITEMAP_MISSING");
+  }
+  if (has("LLMS_TXT_MISSING") && !input.existing.llmsTxt) {
+    files.push({
+      path: `${root}public/llms.txt`,
+      content: llmsTxt(input.siteName, base, description, pages),
+      message: "fix(seo): add llms.txt for AI assistants",
+      action: "created"
+    });
+    addressed.push("LLMS_TXT_MISSING");
+  }
+  const indexHtml = input.existing.indexHtml;
+  if (has(...SCHEMA_CODES) && indexHtml && !indexHtml.includes("application/ld+json") && indexHtml.includes("</head>")) {
+    files.push({
+      path: `${root}index.html`,
+      content: indexHtml.replace("</head>", `${jsonLdBlock(input.siteName, base, description)}  </head>`),
+      message: "fix(seo): add WebSite and Organization JSON-LD",
+      action: "edited"
+    });
+    addressed.push(...SCHEMA_CODES.filter((code) => codes.has(code)));
+  }
+  const name = (file) => file.path.split("/").pop();
+  const created = files.filter((f) => f.action === "created").map(name);
+  const edited = files.filter((f) => f.action === "edited").map(name);
+  const parts = [
+    created.length ? `Added ${created.join(", ")}` : null,
+    edited.length ? `updated ${edited.join(", ")}` : null
+  ].filter(Boolean);
+  const summary = files.length ? `${parts.join("; ")} from RankCLI's templates - generated from the site's URL and name, with no AI and nothing invented.` : "No template-generatable issues were open on this report.";
+  return { files, addressed, summary };
+}
+
+// src/fixer/app-root.ts
+var PREFERRED_NAMES = ["web", "app", "site", "www", "frontend", "client", "ui", "saas", "marketing", "docs"];
+function directoryOf(path3) {
+  const cut = path3.lastIndexOf("/");
+  return cut === -1 ? "" : path3.slice(0, cut);
+}
+function findAppRoot(files) {
+  const real = files.filter((f) => !f.includes("node_modules/") && !f.startsWith("."));
+  const packageDirs = new Set(
+    real.filter((f) => f === "package.json" || f.endsWith("/package.json")).map(directoryOf)
+  );
+  const candidates = real.filter((f) => f === "index.html" || f.endsWith("/index.html")).map(directoryOf).map((dir) => dir.endsWith("/public") ? dir.slice(0, -"/public".length) : dir === "public" ? "" : dir).filter((dir) => packageDirs.has(dir));
+  if (candidates.length > 0) {
+    const depth = (dir) => dir === "" ? 0 : dir.split("/").length;
+    candidates.sort((a, b) => {
+      if (depth(a) !== depth(b)) return depth(a) - depth(b);
+      const rank = (dir) => {
+        const name = dir.split("/").pop() ?? "";
+        const index = PREFERRED_NAMES.indexOf(name);
+        return index === -1 ? PREFERRED_NAMES.length : index;
+      };
+      return rank(a) - rank(b) || a.localeCompare(b);
+    });
+    const best = candidates[0];
+    return best === "" ? "" : `${best}/`;
+  }
+  const nonRoot = [...packageDirs].filter((dir) => dir !== "");
+  if (packageDirs.has("") || nonRoot.length === 0) return "";
+  nonRoot.sort((a, b) => a.split("/").length - b.split("/").length || a.localeCompare(b));
+  return `${nonRoot[0]}/`;
+}
+
 // src/git/commit-helper.ts
 var import_child_process2 = require("child_process");
 var import_util2 = require("util");
@@ -35468,6 +35648,7 @@ var SUPPORTED_FRAMEWORKS = [
   analyzeUrlSafety,
   analyzers,
   applyFixes,
+  buildDeterministicFixes,
   buildGSCApiRequest,
   buildGSCRequest,
   calculateAIVisibilityScore,
@@ -35537,6 +35718,7 @@ var SUPPORTED_FRAMEWORKS = [
   extractTopics,
   fetchCoreWebVitals,
   findAlmostPage1Keywords,
+  findAppRoot,
   findCTROpportunities,
   findHtmlEntry,
   findLSIKeywords,

package/dist/index.mjs

@@ -13,8 +13,9 @@ import {
   extractSchema,
   httpGet,
   httpHead,
-  httpPost
-} from "./chunk-NATXE6B3.mjs";
+  httpPost,
+  looksLikeHtmlFallback
+} from "./chunk-O7B2LBKG.mjs";
 import {
   AI_CRAWLERS_INFO,
   analyzeCitationReadiness,
@@ -4884,6 +4885,17 @@ async function checkRobotsTxt(baseUrl) {
       };
     }
     const content = response.data;
+    if (looksLikeHtmlFallback(content, response.headers?.["content-type"])) {
+      issues.push({
+        ...ISSUE_DEFINITIONS.ROBOTS_TXT_MISSING,
+        affectedUrls: [url],
+        details: { servedHtml: true }
+      });
+      return {
+        issues,
+        data: { exists: false, blocksAll: false, hasSitemap: false, sitemapUrls: [] }
+      };
+    }
     const lines = content.toLowerCase().split("\n");
     let blocksAll = false;
     let currentUserAgent = "";
@@ -7017,6 +7029,13 @@ async function checkLlmsTxt(baseUrl) {
       };
     }
     const content = response.data;
+    if (looksLikeHtmlFallback(content, response.headers?.["content-type"])) {
+      issues.push({
+        ...ISSUE_DEFINITIONS.LLMS_TXT_MISSING,
+        affectedUrls: [url]
+      });
+      return { issues, data: { exists: false, valid: false, errors: ["File not found (the site served HTML)"] } };
+    }
     const lines = content.split("\n").filter((line) => line.trim());
     const errors = [];
     let valid = true;
@@ -11443,7 +11462,7 @@ async function analyzeLlmsTxt(url) {
       timeout: 1e4,
       validateStatus: () => true
     });
-    if (response.status === 200) {
+    if (response.status === 200 && !looksLikeHtmlFallback(response.data, response.headers?.["content-type"])) {
       exists = true;
       content = response.data;
       contentLength = content.length;
@@ -11453,7 +11472,7 @@ async function analyzeLlmsTxt(url) {
       timeout: 1e4,
       validateStatus: () => true
     });
-    if (fullResponse.status === 200) {
+    if (fullResponse.status === 200 && !looksLikeHtmlFallback(fullResponse.data, fullResponse.headers?.["content-type"])) {
       fullVersionExists = true;
     }
   } catch {
@@ -21784,7 +21803,7 @@ This will open a browser for OAuth consent and save tokens locally.
 `;
 }
 
-// src/tracking/github-action.ts
+// src/tracking/github-action-template.ts
 function generateWorkflow(config) {
   const cronSchedule = getCronSchedule(config.schedule);
   const sync = !!config.syncToDashboard;
@@ -22015,6 +22034,8 @@ function generateGitHubActionSetup(config) {
     readmeBadge: `[![SEO Status](https://github.com/YOUR_ORG/YOUR_REPO/actions/workflows/seo.yml/badge.svg)](https://github.com/YOUR_ORG/YOUR_REPO/actions/workflows/seo.yml)`
   };
 }
+
+// src/tracking/github-action.ts
 function writeGitHubActionFiles(projectPath, config) {
   const fs3 = __require("fs");
   const path3 = __require("path");
@@ -23071,7 +23092,7 @@ async function executeAgent(agent, options = {}) {
   }
 }
 async function runDirectAnalysis(url) {
-  const { analyzeUrl: analyzeUrl2 } = await import("./analyzer-MCBRQHB7.mjs");
+  const { analyzeUrl: analyzeUrl2 } = await import("./analyzer-BYAFIO33.mjs");
   const result = await analyzeUrl2({ url });
   if (!result.success || !result.data) {
     throw new Error(result.error || "Analysis failed");
@@ -28539,7 +28560,7 @@ Sitemap: ${url}/sitemap.xml`;
   };
 }
 function generateSitemapFix(context, url) {
-  const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+  const sitemap2 = `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>${url}</loc>
@@ -28551,7 +28572,7 @@ function generateSitemapFix(context, url) {
     issue: { code: "MISSING_SITEMAP", message: "No sitemap.xml found", severity: "warning" },
     file: "public/sitemap.xml",
     before: null,
-    after: sitemap,
+    after: sitemap2,
     explanation: "Created sitemap.xml to help search engines discover all pages"
   };
 }
@@ -28648,7 +28669,7 @@ function generateLangFix(context) {
   };
 }
 function generateLlmsTxtFix(context, siteName, url) {
-  const llmsTxt = `# ${siteName}
+  const llmsTxt2 = `# ${siteName}
 > ${siteName} - A brief description of your product/service
 
 ## About
@@ -28671,7 +28692,7 @@ ${siteName} is... [Add your description here]
     issue: { code: "AI_NO_LLMS_TXT", message: "No llms.txt file for AI crawlers", severity: "info" },
     file: "public/llms.txt",
     before: null,
-    after: llmsTxt,
+    after: llmsTxt2,
     explanation: "Created llms.txt to help AI systems understand your site. Customize the content."
   };
 }
@@ -29303,6 +29324,155 @@ var Schemas = {
   sitelinksSearchbox: generateSitelinksSearchboxSchema
 };
 
+// src/fixer/deterministic.ts
+function xmlEscape(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function sitemap(urls) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const entries = urls.map(
+    (url) => `  <url>
+    <loc>${xmlEscape(url)}</loc>
+    <lastmod>${today}</lastmod>
+  </url>`
+  ).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generated by RankCLI - https://rankcli.dev -->
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries}
+</urlset>
+`;
+}
+function llmsTxt(siteName, siteUrl, description, pages) {
+  const base = siteUrl.replace(/\/$/, "");
+  const trim = (url) => url.replace(/\/$/, "");
+  const links = pages.filter((url) => trim(url) !== base).map((url) => ({ url, path: url.replace(base, "").replace(/^$/, "/") })).filter((page) => page.path !== "/").slice(0, 20).map((page) => `- [${page.path}](${page.url})`).join("\n");
+  return `# ${siteName}
+
+${description ? `> ${description}
+
+` : ""}${base}
+
+## Pages
+- [Home](${base}/)
+${links}
+
+<!-- Generated by RankCLI - https://rankcli.dev -->
+`;
+}
+function jsonLdBlock(siteName, siteUrl, description) {
+  const base = siteUrl.replace(/\/$/, "");
+  const graph = [
+    generateWebSiteSchema({ name: siteName, url: base, ...description ? { description } : {} }),
+    generateOrganizationSchema({ name: siteName, url: base, ...description ? { description } : {} })
+  ];
+  return `    <script type="application/ld+json">
+${JSON.stringify(graph, null, 2).split("\n").map((line) => `    ${line}`).join("\n")}
+    </script>
+`;
+}
+var SCHEMA_CODES = [
+  "SCHEMA_MISSING",
+  "SCHEMA_ORG_MISSING",
+  "ORGANIZATION_SCHEMA_MISSING",
+  "NO_ORGANIZATION_SCHEMA",
+  "NO_ENTITY_SCHEMA",
+  "STRUCTURED_DATA_MISSING"
+];
+function metaDescriptionOf(html) {
+  if (!html) return null;
+  const match = html.match(/<meta[^>]+name=["']description["'][^>]+content=["']([^"']+)["']/i) || html.match(/<meta[^>]+content=["']([^"']+)["'][^>]+name=["']description["']/i);
+  return match?.[1]?.trim() || null;
+}
+function buildDeterministicFixes(input) {
+  const codes = new Set(input.issueCodes);
+  const has = (...wanted) => wanted.some((code) => codes.has(code));
+  const root = input.appRoot || "";
+  const files = [];
+  const addressed = [];
+  const base = input.siteUrl.replace(/\/$/, "");
+  const pages = input.pages?.length ? input.pages : [`${base}/`];
+  const description = input.description ?? metaDescriptionOf(input.existing.indexHtml);
+  if (has("ROBOTS_TXT_MISSING", "AI_BOTS_BLOCKED", "AI_CRAWLERS_BLOCKED") && !input.existing.robotsTxt) {
+    files.push({
+      path: `${root}public/robots.txt`,
+      content: generateAIFriendlyRobotsTxt(base),
+      message: "fix(seo): add robots.txt allowing search and AI crawlers",
+      action: "created"
+    });
+    addressed.push("ROBOTS_TXT_MISSING");
+  }
+  if (has("SITEMAP_MISSING") && !input.existing.sitemapXml) {
+    files.push({
+      path: `${root}public/sitemap.xml`,
+      content: sitemap(pages),
+      message: "fix(seo): add sitemap.xml",
+      action: "created"
+    });
+    addressed.push("SITEMAP_MISSING");
+  }
+  if (has("LLMS_TXT_MISSING") && !input.existing.llmsTxt) {
+    files.push({
+      path: `${root}public/llms.txt`,
+      content: llmsTxt(input.siteName, base, description, pages),
+      message: "fix(seo): add llms.txt for AI assistants",
+      action: "created"
+    });
+    addressed.push("LLMS_TXT_MISSING");
+  }
+  const indexHtml = input.existing.indexHtml;
+  if (has(...SCHEMA_CODES) && indexHtml && !indexHtml.includes("application/ld+json") && indexHtml.includes("</head>")) {
+    files.push({
+      path: `${root}index.html`,
+      content: indexHtml.replace("</head>", `${jsonLdBlock(input.siteName, base, description)}  </head>`),
+      message: "fix(seo): add WebSite and Organization JSON-LD",
+      action: "edited"
+    });
+    addressed.push(...SCHEMA_CODES.filter((code) => codes.has(code)));
+  }
+  const name = (file) => file.path.split("/").pop();
+  const created = files.filter((f) => f.action === "created").map(name);
+  const edited = files.filter((f) => f.action === "edited").map(name);
+  const parts = [
+    created.length ? `Added ${created.join(", ")}` : null,
+    edited.length ? `updated ${edited.join(", ")}` : null
+  ].filter(Boolean);
+  const summary = files.length ? `${parts.join("; ")} from RankCLI's templates - generated from the site's URL and name, with no AI and nothing invented.` : "No template-generatable issues were open on this report.";
+  return { files, addressed, summary };
+}
+
+// src/fixer/app-root.ts
+var PREFERRED_NAMES = ["web", "app", "site", "www", "frontend", "client", "ui", "saas", "marketing", "docs"];
+function directoryOf(path3) {
+  const cut = path3.lastIndexOf("/");
+  return cut === -1 ? "" : path3.slice(0, cut);
+}
+function findAppRoot(files) {
+  const real = files.filter((f) => !f.includes("node_modules/") && !f.startsWith("."));
+  const packageDirs = new Set(
+    real.filter((f) => f === "package.json" || f.endsWith("/package.json")).map(directoryOf)
+  );
+  const candidates = real.filter((f) => f === "index.html" || f.endsWith("/index.html")).map(directoryOf).map((dir) => dir.endsWith("/public") ? dir.slice(0, -"/public".length) : dir === "public" ? "" : dir).filter((dir) => packageDirs.has(dir));
+  if (candidates.length > 0) {
+    const depth = (dir) => dir === "" ? 0 : dir.split("/").length;
+    candidates.sort((a, b) => {
+      if (depth(a) !== depth(b)) return depth(a) - depth(b);
+      const rank = (dir) => {
+        const name = dir.split("/").pop() ?? "";
+        const index = PREFERRED_NAMES.indexOf(name);
+        return index === -1 ? PREFERRED_NAMES.length : index;
+      };
+      return rank(a) - rank(b) || a.localeCompare(b);
+    });
+    const best = candidates[0];
+    return best === "" ? "" : `${best}/`;
+  }
+  const nonRoot = [...packageDirs].filter((dir) => dir !== "");
+  if (packageDirs.has("") || nonRoot.length === 0) return "";
+  nonRoot.sort((a, b) => a.split("/").length - b.split("/").length || a.localeCompare(b));
+  return `${nonRoot[0]}/`;
+}
+
 // src/git/commit-helper.ts
 import { execSync, exec as exec2 } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -31902,6 +32072,7 @@ export {
   analyzeUrlSafety,
   analyzers_exports as analyzers,
   applyFixes,
+  buildDeterministicFixes,
   buildGSCApiRequest,
   buildGSCRequest,
   calculateAIVisibilityScore,
@@ -31971,6 +32142,7 @@ export {
   extractTopics,
   fetchCoreWebVitals,
   findAlmostPage1Keywords,
+  findAppRoot,
   findCTROpportunities,
   findHtmlEntry,
   findLSIKeywords,

package/package.json

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