seo 0.13.3 → 0.14.0

package/dist/index.d.ts

@@ -5,7 +5,6 @@ import { Headers as Headers$1, RequestInit as RequestInit$1, Response as Respons
 import Libsql from "libsql";
 import "htmlparser2";
 import pino from "pino";
-//#region packages/core/src/types/auth.d.ts
 export declare const tokenSchema: z.ZodObject<{
   provider: z.ZodLiteral<"google">;
   account_email: z.ZodString;
@@ -40,8 +39,6 @@ export declare const tokenStoreSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type StoredTokenStore = z.infer<typeof tokenStoreSchema>;
-//#endregion
-//#region packages/core/src/types/config.d.ts
 export declare const providerPreferenceSchema: z.ZodEnum<{
   cheap: "cheap";
   authoritative: "authoritative";
@@ -83,8 +80,6 @@ export declare const configSchema: z.ZodObject<{
 export type AppConfig = z.infer<typeof configSchema>;
 export type AnalyticsConnection = z.infer<typeof analyticsConnectionSchema>;
 export type AnalyticsProvider = z.infer<typeof analyticsProviderSchema>;
-//#endregion
-//#region packages/core/src/extract/canonical.d.ts
 type CanonicalSource = 'html-head' | 'html-body' | 'http-header';
 type CanonicalCandidate = {
   source: CanonicalSource;
@@ -106,8 +101,6 @@ type CanonicalEvidence = {
   selectedUrl?: string;
   candidates: CanonicalCandidate[];
 };
-//#endregion
-//#region packages/core/src/types/pages.d.ts
 export interface GscRow {
   keys: string[];
   clicks: number;
@@ -421,8 +414,6 @@ export interface ExtractedPage {
   contentExtraction: ContentExtractionDiagnostics;
   warnings: string[];
 }
-//#endregion
-//#region packages/core/src/types/providers.d.ts
 /** Calls and units one provider used during a report run. */
 export interface CreditUsage {
   provider: string;
@@ -432,8 +423,6 @@ export interface CreditUsage {
   calls: number;
   cacheHits?: number;
 }
-//#endregion
-//#region packages/core/src/rules.d.ts
 type RuleDefinition = {
   id: string;
   title: string;
@@ -1244,8 +1233,6 @@ export declare function listRules(): RuleInfo[];
 export declare function explainRule(ruleId: string): RuleInfo | undefined;
 export declare function recommendationForRule(ruleId: string): RuleRecommendation;
 export declare function hasRule(ruleId: string): ruleId is RuleId;
-//#endregion
-//#region packages/core/src/brand-evidence.d.ts
 type BrandQueryEvidence = {
   query: string;
   clicks: number;
@@ -1274,8 +1261,6 @@ type ReportBrandTerms = {
   excluded: ExcludedBrandTerm[];
   heuristic: boolean;
 };
-//#endregion
-//#region packages/core/src/analyze/page-patterns.d.ts
 type PageTemplate = {
   id: string;
   label: string;
@@ -1287,8 +1272,6 @@ type TemplateSummary = {
   count: number;
   sampleUrls: string[];
 };
-//#endregion
-//#region packages/core/src/analyze/second-page-analysis-types.d.ts
 type SecondPageSelection = {
   sourceRows: number;
   invalidRows: number;
@@ -1470,8 +1453,6 @@ type SecondPageReport = {
     message: string;
   }>;
 };
-//#endregion
-//#region packages/core/src/types/reports.d.ts
 export interface Recommendation {
   principle: string;
   evidenceRef: string;
@@ -1549,8 +1530,6 @@ export interface CacheStats {
   maxSizeBytes: number;
   counts: Record<string, number>;
 }
-//#endregion
-//#region packages/core/src/analytics/providers.d.ts
 export type AnalyticsProviderDetails = {
   label: string;
   landingMetricLabel: 'sessions' | 'landing-page visits';
@@ -1559,8 +1538,6 @@ export declare const ANALYTICS_PROVIDER_IDS: readonly ["google", "clicky"];
 export declare function analyticsProviderDetails(provider: AnalyticsProvider | string): AnalyticsProviderDetails;
 export declare function analyticsConnectionProviderId(connection: AnalyticsConnection): string;
 export declare function analyticsConnectionLabel(connection: AnalyticsConnection): string;
-//#endregion
-//#region packages/core/src/analyze/agent-report.d.ts
 export type AgentFindingStatus = 'open';
 type AgentFindingBase = {
   id: string;
@@ -1670,8 +1647,6 @@ export declare function buildAgentFindings(report: JsonRecord, options?: AgentRe
 };
 export declare function withAgentReportContract(report: JsonRecord, options?: AgentReportOptions): JsonRecord;
 export declare function agentActionsView(report: JsonRecord, options?: AgentReportOptions): JsonRecord;
-//#endregion
-//#region packages/core/src/errors.d.ts
 export type SeoErrorCode = 'ACCESS_DENIED' | 'AUTH_CONFIG_REQUIRED' | 'AUTH_EXPIRED' | 'AUTH_REQUIRED' | 'INSUFFICIENT_DATA' | 'INTERNAL_ERROR' | 'INVALID_INPUT' | 'OPTIONAL_PROVIDER_UNAVAILABLE' | 'PROPERTY_NOT_FOUND' | 'PROVIDER_UNAVAILABLE' | 'RATE_LIMITED';
 export declare class SeoError extends Error {
   readonly code: SeoErrorCode;
@@ -1689,8 +1664,6 @@ export declare function seoErrorEnvelope(error: unknown): {
     retryable: boolean;
   };
 };
-//#endregion
-//#region packages/core/src/ga4/account-summaries.d.ts
 interface Ga4PropertySummary {
   property: string;
   displayName?: string;
@@ -1702,8 +1675,6 @@ interface Ga4AccountSummary {
   displayName?: string;
   propertySummaries: Ga4PropertySummary[];
 }
-//#endregion
-//#region packages/core/src/gsc/client/types.d.ts
 export interface SearchAnalyticsRequest {
   startDate: string;
   endDate: string;
@@ -1764,8 +1735,6 @@ export interface UrlInspectionResult {
     richResultsResult?: unknown;
   };
 }
-//#endregion
-//#region packages/core/src/google/api.d.ts
 export type GoogleFetch = (url: string, init?: RequestInit) => Promise<Response>;
 export type GoogleCallOptions = {
   signIn: string;
@@ -1803,8 +1772,6 @@ export interface Ga4DataStream {
 }
 export declare function listAnalyticsDataStreams(gfetch: GoogleFetch, propertyId: string, options: GoogleCallOptions): Promise<Ga4DataStream[]>;
 export declare function runAnalyticsReport<T = unknown>(gfetch: GoogleFetch, propertyId: string, body: unknown, options: GoogleCallOptions): Promise<T>;
-//#endregion
-//#region packages/core/src/ga4/client.d.ts
 export interface Ga4ReportRequest {
   dateRanges: Array<{
     startDate: string;
@@ -1862,8 +1829,6 @@ export declare function listGa4DataStreams(propertyId: string, accountEmail?: st
 export declare function ga4PropertyIdFromName(name: string): string;
 export declare function ga4RowsToObjects(result: Ga4RunReportResult): Array<Record<string, string>>;
 export declare function ga4ReportQualityWarnings(result: Ga4RunReportResult, label?: string): string[];
-//#endregion
-//#region packages/core/src/analyze/ai-referrals-types.d.ts
 type AiReferralMetrics = {
   sessions: number;
   eventCount: number;
@@ -1957,8 +1922,6 @@ type AiReferralReport = {
   }>;
   caveats: string[];
 };
-//#endregion
-//#region packages/core/src/analyze/ai-referrals-analysis.d.ts
 type AiReferralAnalysisInput = {
   property: string;
   generatedAt: string;
@@ -1973,16 +1936,10 @@ type AiReferralAnalysisInput = {
   totalUsersEvidence: AiReferralQueryEvidence;
 };
 export declare function analyzeAiReferralRows(input: AiReferralAnalysisInput): AiReferralReport;
-//#endregion
-//#region packages/core/src/analyze/ai-referrals-query.d.ts
 export declare function sessionSourceInListFilter(values: string[]): unknown;
-//#endregion
-//#region packages/core/src/analyze/ai-referrals-sources.d.ts
 export declare const AI_REFERRAL_SOURCES_VERSION: "ai-referral-sources@1";
 export declare const AI_REFERRAL_SOURCES: readonly AiReferralSourceDefinition[];
 export declare function aiReferralSourceForValue(value: string): AiReferralSourceDefinition | undefined;
-//#endregion
-//#region packages/core/src/analyze/ai-referrals.d.ts
 type RunGa4Report = typeof runGa4Report;
 export declare function aiReferralsReport(input: {
   property: string;
@@ -1996,8 +1953,6 @@ export declare function aiReferralsReport(input: {
   runGa4Report?: RunGa4Report;
   now?: () => Date;
 }): Promise<AiReferralReport>;
-//#endregion
-//#region packages/core/src/fetch/page-fetcher/types.d.ts
 interface FetchRateControls {
   concurrency?: number;
   intervalCap?: number;
@@ -2057,11 +2012,7 @@ type RobotsResult = {
   url: string;
 };
 type RobotsResolver = (origin: string, targetUrl: string) => Promise<RobotsResult>;
-//#endregion
-//#region packages/core/src/fetch/page-fetcher/plain.d.ts
 declare function fetchPlain(url: string, refresh: boolean | undefined, timeoutMs: number | undefined, rate: NormalizedFetchRateControls, signal?: AbortSignal, respectRobots?: boolean, writeCache?: boolean): Promise<PageFetchResult>;
-//#endregion
-//#region packages/core/src/fetch/page-fetcher/rendered.d.ts
 /**
  * One renderer owns one browser process and a bounded number of isolated
  * contexts. Create it once for a crawl, then close it after the crawl exits.
@@ -2069,19 +2020,13 @@ declare function fetchPlain(url: string, refresh: boolean | undefined, timeoutMs
 export declare function createPageRenderer(input?: {
   concurrency?: number;
 }): PageRenderer;
-//#endregion
-//#region packages/core/src/fetch/page-fetcher/status-probe.d.ts
 export declare function fetchPageStatus(url: string, opts?: FetchPageOptions): Promise<PageFetchResult>;
-//#endregion
-//#region packages/core/src/fetch/page-fetcher.d.ts
 export type FetchPageDependencies = {
   fetchPlain?: typeof fetchPlain;
   createPageRenderer?: typeof createPageRenderer;
 };
 export declare function normalizeJavaScriptRenderingMode(input: JavaScriptRenderingInput | undefined): JavaScriptRenderingMode;
 export declare function fetchPage(url: string, opts?: FetchPageOptions, dependencies?: FetchPageDependencies): Promise<PageFetchResult>;
-//#endregion
-//#region packages/core/src/gsc/client/inspection.d.ts
 export declare function urlInspectionQuota(input: {
   siteUrl: string;
   accountEmail?: string;
@@ -2091,8 +2036,6 @@ export declare function urlInspectionQuota(input: {
   resetAt: string;
 }>;
 export declare function inspectUrl(input: UrlInspectionRequest): Promise<UrlInspectionResult>;
-//#endregion
-//#region packages/core/src/gsc/client/search-analytics.d.ts
 export type PageSearchMetrics = {
   clicks: number;
   impressions: number;
@@ -2119,15 +2062,11 @@ export declare function queryPagesMetricsBatch(site: string, pageUrls: string[],
 export declare function queryPageTopQuery(site: string, pageUrl: string, days?: number): Promise<PageTopQuery | undefined>;
 export declare function queryPagesTopQueries(site: string, pageUrls: string[], days?: number): Promise<Map<string, PageTopQuery>>;
 export declare function queryPagesTopQueriesBatch(site: string, pageUrls: string[], range?: number | SearchDateWindow): Promise<SearchPageBatch<PageTopQuery>>;
-//#endregion
-//#region packages/core/src/gsc/client/sites.d.ts
 export declare function listSites(_refresh?: boolean, accountEmail?: string): Promise<Array<{
   siteUrl: string;
   permissionLevel?: string;
   siteType?: string;
 }>>;
-//#endregion
-//#region packages/core/src/analyze/audit-page.d.ts
 export declare const AUDIT_PAGE_RULE_IDS: readonly ["missing_title", "title_too_wide", "h1_missing", "canonical_invalid", "canonical_conflict", "canonical_multiple", "canonical_outside_head", "canonical_streamed_in_body", "canonical_mismatch"];
 export type AuditPageDependencies = {
   fetchPage: typeof fetchPage;
@@ -2141,8 +2080,6 @@ export declare function auditPage(input: {
   refresh?: boolean;
   extractor?: 'defuddle' | 'readability';
 }, dependencies?: AuditPageDependencies): Promise<AuditPageReport>;
-//#endregion
-//#region packages/core/src/analyze/content-coverage-analysis.d.ts
 /** Fetches one page. The local binding uses the cached page fetcher. */
 export type PageFetcher = (url: string, options?: FetchPageOptions) => Promise<PageFetchResult>;
 /** Extracts page fields from a fetched page. */
@@ -2186,14 +2123,10 @@ export declare function verifyQueryContentWith(input: VerifyQueryContentInput &
   fetch: PageFetcher;
   extract: PageExtractor;
 }): Promise<QueryContentCoverage>;
-//#endregion
-//#region packages/core/src/analyze/content-coverage.d.ts
 export declare function verifyQueryContent(input: VerifyQueryContentInput & {
   fetch?: PageFetcher;
   extract?: PageExtractor;
 }): Promise<QueryContentCoverage>;
-//#endregion
-//#region packages/core/src/extract/content-sketch.d.ts
 type ContentSketch = {
   version: 1;
   wordCount: number;
@@ -2201,8 +2134,6 @@ type ContentSketch = {
   sampledShingles: number;
   hashes: string[];
 };
-//#endregion
-//#region packages/core/src/extract/main-content.d.ts
 interface DefuddleResult {
   content?: string;
   description?: string;
@@ -2215,8 +2146,6 @@ interface MainContentDependencies {
     useAsync: false;
   }) => DefuddleResult;
 }
-//#endregion
-//#region packages/core/src/extract/page-extractor.d.ts
 type CrawlerExtractionEvidence = {
   h1?: string;
   h1Count: number;
@@ -2259,8 +2188,6 @@ type PageExtraction = ExtractedPage & {
   crawlerEvidence?: CrawlerExtractionEvidence;
 };
 declare function extractPage(fetchResult: PageFetchResult, extractor?: ContentExtractor, dependencies?: MainContentDependencies): Promise<PageExtraction>;
-//#endregion
-//#region packages/core/src/analyze/page-opportunities-types.d.ts
 type PageOpportunityType = 'ctr' | 'ranking' | 'content-gap' | 'serp-framing' | 'covered' | 'technical-check' | 'unverified';
 type PageOpportunityBenchmark = {
   applicable: boolean;
@@ -2350,11 +2277,7 @@ type PageOpportunityAnalysisInput = {
   fetchDiagnostics?: PageFetchDiagnostics;
   httpStatus?: number;
 };
-//#endregion
-//#region packages/core/src/analyze/shared.d.ts
 export declare function unicodeTokens(value: string): string[];
-//#endregion
-//#region packages/core/src/analyze/opportunity-primitives.d.ts
 export type OpportunityBenchmarkRow = {
   keys?: string[];
   clicks: number;
@@ -2419,8 +2342,6 @@ export declare function queryOpportunityRecommendation(input: {
   reason: string;
   expectedImpact: string;
 };
-//#endregion
-//#region packages/core/src/analyze/page-technical-signals.d.ts
 type PageTechnicalSignal = Extract<QueryContentSignal, 'http-non-2xx' | 'http-no-content' | 'blocked' | 'fetch-incomplete' | 'redirected' | 'meta-noindex' | 'x-robots-noindex' | 'canonical-mismatch'>;
 declare function pageTechnicalSignals(input: {
   url: string;
@@ -2428,14 +2349,8 @@ declare function pageTechnicalSignals(input: {
   fetchDiagnostics?: PageFetchDiagnostics;
   httpStatus?: number;
 }): PageTechnicalSignal[];
-//#endregion
-//#region packages/core/src/analyze/page-opportunities-analysis.d.ts
 export declare function analyzePageOpportunitiesFromRows(input: PageOpportunityAnalysisInput): PageOpportunityAnalysis;
-//#endregion
-//#region packages/core/src/analyze/page-opportunities-presentation.d.ts
 type PageOpportunityFocus = PageOpportunityType | 'no-data';
-//#endregion
-//#region packages/core/src/analyze/page-opportunities.d.ts
 type SearchAnalytics$2 = typeof querySearchAnalytics;
 type FetchPage = typeof fetchPage;
 type ExtractPage = typeof extractPage;
@@ -2514,8 +2429,6 @@ type PageOpportunityDependencies = {
   now: () => Date;
 };
 export declare function pageOpportunitiesReport(input: PageOpportunityInput, dependencies?: PageOpportunityDependencies): Promise<PageOpportunityReport>;
-//#endregion
-//#region packages/core/src/analyze/content-optimization.d.ts
 export type ContentOptimizationIntent = 'comparison' | 'commercial' | 'how-to' | 'definition' | 'local' | 'navigational' | 'general';
 export type ContentOptimizationReport = {
   site: string;
@@ -2569,8 +2482,6 @@ export declare function contentOptimizationReport(input: {
   refresh?: boolean;
   js?: boolean | 'auto';
 }): Promise<ContentOptimizationReport>;
-//#endregion
-//#region packages/core/src/analyze/monitoring/types.d.ts
 export type CrawlPageSnapshot = {
   url: string;
   finalUrl: string;
@@ -2798,8 +2709,6 @@ export type CrawlRequestObservation = CrawlResponseObservation | {
   error: string;
   extraction: 'not-applicable';
 };
-//#endregion
-//#region packages/core/src/analyze/monitoring/sitemaps.d.ts
 export type SitemapInvalidLoc = {
   sitemapUrl: string;
   kind: 'url' | 'sitemap';
@@ -2883,8 +2792,6 @@ export declare function fetchSitemapUrls(input: {
   limit?: number;
   maxNested?: number;
 }): Promise<SitemapFetchResult>;
-//#endregion
-//#region packages/core/src/analyze/crawler/crawl-skip-reasons.d.ts
 export declare const CRAWL_SKIP_REASONS: readonly ["asset-url", "configured-exclusion", "duplicate-normalization", "invalid-url", "memory-pressure", "off-origin", "origin-backpressure", "queue-safety-limit", "robots-disallowed", "robots-uncertain", "legacy-unclassified"];
 export type CrawlSkipReason = (typeof CRAWL_SKIP_REASONS)[number];
 export type CrawlSkipImpact = 'coverage-affecting' | 'non-impacting';
@@ -2907,11 +2814,7 @@ export declare function normalizeCrawlSkipReasonCounts(input: {
   skippedUrlsByImpact: CrawlSkippedUrlsByImpact;
 };
 export declare function crawlSkipReasonCountsFromRecord(input?: Partial<Record<CrawlSkipReason, number>>): CrawlSkipReasonCount[];
-//#endregion
-//#region packages/core/src/analyze/crawler/crawl-status.d.ts
 type CrawlStatusPhase = 'started' | 'url_queued' | 'url_skipped' | 'page_started' | 'page_completed' | 'page_failed' | 'page_skipped' | 'external_links_started' | 'external_links_completed' | 'cancelled' | 'completed';
-//#endregion
-//#region packages/core/src/analyze/monitoring/crawl-page.d.ts
 export type CrawlOneResult = {
   request?: CrawlRequestObservation;
   page?: CrawlPageSnapshot;
@@ -2919,9 +2822,8 @@ export type CrawlOneResult = {
   warning?: string;
 };
 export declare function crawlOne(url: string, opts?: FetchPageOptions): Promise<CrawlOneResult>;
+export declare function snapshotFetchedPage(url: string, fetched: PageFetchResult): Promise<CrawlOneResult>;
 export declare function crawlStatusOnly(url: string, opts?: FetchPageOptions): Promise<CrawlOneResult>;
-//#endregion
-//#region packages/core/src/analyze/crawler/site-checks.d.ts
 type CrawlSiteChecks = {
   soft404: {
     status: 'pass' | 'warning' | 'unknown';
@@ -2937,8 +2839,6 @@ type CrawlSiteChecks = {
     complete: boolean;
   };
 };
-//#endregion
-//#region packages/core/src/analyze/crawler/site-crawl-ai-types.d.ts
 type CrawlAiAvailability = 'available' | 'absent' | 'access-blocked' | 'rate-limited' | 'unreachable';
 type CrawlAiBotAccess = {
   userAgent: string;
@@ -3015,8 +2915,6 @@ type CrawlAiSignals = {
     contentSignal?: string;
   };
 };
-//#endregion
-//#region packages/core/src/analyze/crawler/report.d.ts
 export type CrawlMode = 'site' | 'page' | 'list' | 'sitemap';
 export type CrawlStrategy = 'full' | 'health';
 export declare const MAX_CRAWL_PAGES = 10000;
@@ -3280,14 +3178,10 @@ export declare function createCrawlReport(input: {
   generatedAt?: string;
 }): CrawlReport;
 export declare function normalizeLoadedCrawlReport(report: CrawlReport): CrawlReport;
-//#endregion
-//#region packages/core/src/analyze/crawler/audit.d.ts
 export declare function auditCrawlRequests(requests: CrawlRequestObservation[]): CrawlIssue[];
 export declare function auditCrawlPages(pages: CrawlPageSnapshot[], opts?: {
   startUrl?: string;
 }): CrawlIssue[];
-//#endregion
-//#region packages/core/src/analyze/crawler/top-fixes.d.ts
 export type TopFixFilters = {
   category?: RuleCategory | string;
   severity?: RuleSeverity | string;
@@ -3321,8 +3215,6 @@ export type TopFix = CrawlIssueGroup & {
 };
 export declare function topFixes(report: CrawlReport, filters?: TopFixFilters): TopFix[];
 export declare function reviewObservations(report: CrawlReport, filters?: Omit<TopFixFilters, 'recommendation'>): TopFix[];
-//#endregion
-//#region packages/core/src/analyze/crawler/export.d.ts
 export type CrawlOutputFormat = 'pretty' | 'json' | 'csv' | 'html' | 'markdown' | 'junit';
 export declare function renderCrawlCsv(report: CrawlReport): string;
 export declare function renderCrawlPagesCsv(report: CrawlReport): string;
@@ -3330,8 +3222,6 @@ export declare function renderCrawlPretty(report: CrawlReport, fixes?: TopFix[])
 export declare function renderCrawlJunit(report: CrawlReport): string;
 export declare function renderCrawlHtml(report: CrawlReport, fixes?: TopFix[]): string;
 export declare function renderCrawlMarkdownTickets(report: CrawlReport, fixes?: TopFix[]): string;
-//#endregion
-//#region packages/core/src/analyze/crawler/schemas.d.ts
 export declare const crawlerRuleSeveritySchema: z.ZodEnum<{
   high: "high";
   low: "low";
@@ -18020,13 +17910,9 @@ export declare const crawlerJsonSchemas: {
     }, z.core.$strip>>;
   }, z.core.$strip>>;
 };
-//#endregion
-//#region packages/core/src/fetch/crawler-identity.d.ts
 export declare const SEO_CRAWLER_TOKEN = "SEO-Skill";
 export declare const SEO_CRAWLER_USER_AGENT: string;
 export declare const SEO_CRAWLER_IDENTITY: CrawlerIdentity;
-//#endregion
-//#region packages/core/src/fetch/http-client.d.ts
 export type HttpProfile = 'browser' | 'bot';
 export declare class ResponseSizeLimitError extends Error {
   readonly maxBytes: number;
@@ -18039,8 +17925,6 @@ export declare function publicHttpFetch(url: string, input?: RequestInit$1 & {
   profile?: HttpProfile;
 }): Promise<import("undici").Response>;
 export declare function readBoundedResponseText(response: Awaited<ReturnType<typeof publicHttpFetch>>, maxBytes: number, label?: string): Promise<string>;
-//#endregion
-//#region packages/core/src/provider-extensions/contracts.d.ts
 export declare const providerExtensionIdSchema: z.ZodString;
 export declare const providerPackageNameSchema: z.ZodString;
 export declare const providerExactVersionSchema: z.ZodString;
@@ -18110,8 +17994,6 @@ export declare const providerRegistrationSchema: z.ZodObject<{
 export type ProviderPackageManifest = z.infer<typeof providerPackageManifestSchema>;
 export type InstalledProviderPackage = z.infer<typeof installedProviderPackageSchema>;
 export type InstalledProviderPackages = z.infer<typeof installedProviderPackagesSchema>;
-//#endregion
-//#region packages/core/src/provider-extensions/registry.d.ts
 export type RegisteredProviderExtension = SeoProviderRegistration & {
   package: string;
   version: string;
@@ -18130,8 +18012,6 @@ export declare class ProviderExtensionRegistry {
   action(providerId: string, actionId: string): SeoProviderActionAdapter | undefined;
   list(): RegisteredProviderExtension[];
 }
-//#endregion
-//#region packages/core/src/provider-extensions/loader.d.ts
 type ImportedProviderModule = {
   default?: unknown;
 };
@@ -18158,16 +18038,12 @@ export declare function loadProviderPackage(input: {
   importModule?: (url: string) => Promise<ImportedProviderModule>;
 }): Promise<RegisteredProviderExtension[]>;
 export declare function loadInstalledProviderExtensions(options?: ProviderExtensionLoaderOptions): Promise<LoadedProviderExtensions>;
-//#endregion
-//#region packages/core/src/providers/imports/research-columns.d.ts
 export declare const RESEARCH_IMPORT_COLUMN_KEYS: readonly ["keyword", "url", "position", "absolutePosition", "searchVolume", "keywordDifficulty", "cpc", "paidCompetition", "intent", "resultCount", "estimatedTraffic", "resultType", "searchVolumeUpdatedAt"];
 export type ResearchImportColumn = (typeof RESEARCH_IMPORT_COLUMN_KEYS)[number];
 export type ResearchImportColumns = Partial<Record<ResearchImportColumn, string>>;
 export declare function normalizedResearchColumnName(value: string): string;
 export declare function researchImportColumns(value: ResearchImportColumns | undefined): ResearchImportColumns | undefined;
 export declare function validateResearchImportColumnSources(columns: ResearchImportColumns | undefined, includedFields: Iterable<string>): void;
-//#endregion
-//#region packages/core/src/providers/contracts.d.ts
 export declare const providerIdSchema: z.ZodString;
 export type ProviderId = z.infer<typeof providerIdSchema>;
 export type ExternalServiceId = string;
@@ -18240,8 +18116,6 @@ export type KeywordMonthlySearch = {
   month: number;
   searchVolume: number;
 };
-//#endregion
-//#region packages/core/src/providers/transport.d.ts
 export type ProviderFetch = (url: string | URL, init?: RequestInit$1) => Promise<Response$1>;
 export type ProviderRequestInput = {
   provider: ExternalServiceId;
@@ -18259,8 +18133,6 @@ export declare function providerRequestText(input: ProviderRequestInput): Promis
 export declare function providerRequestJson<T>(input: ProviderRequestInput & {
   schema: z.ZodType<T>;
 }): Promise<T>;
-//#endregion
-//#region packages/core/src/provider-extensions/runtime.d.ts
 export type ProviderRuntimeOptions = {
   fetch?: ProviderFetch;
   maxRequests?: number;
@@ -18276,8 +18148,6 @@ export declare function verifyProviderExtension(input: {
   credentials: Readonly<Record<string, string>>;
   runtime?: ProviderRuntimeOptions;
 }): Promise<void>;
-//#endregion
-//#region packages/core/src/provider-extensions/analytics.d.ts
 export type AnalyticsProviderRuntimeOptions = ProviderRuntimeOptions;
 export declare function verifyAnalyticsProvider(input: {
   providerId: string;
@@ -18295,8 +18165,6 @@ export declare function runAnalyticsProviderLandingPages(input: {
   refresh?: boolean;
   runtime?: AnalyticsProviderRuntimeOptions;
 }): Promise<SeoLandingPageVisitsResult>;
-//#endregion
-//#region packages/core/src/analyze/workflows/analytics-value.d.ts
 type LandingPageValue = {
   sessions: number;
   totalUsers?: number;
@@ -18330,8 +18198,6 @@ declare function fetchLandingPageValues(input: {
   limit?: number;
   refresh?: boolean;
 }, dependencies?: Partial<LandingPageValueDependencies>): Promise<LandingPageValueResult>;
-//#endregion
-//#region packages/core/src/analyze/crawler/site-crawl-dependencies.d.ts
 type ResolvedCrawlSiteDependencies = {
   fetchPage: typeof crawlOne;
   fetchStatusPage: typeof crawlStatusOnly;
@@ -18350,11 +18216,7 @@ type ResolvedCrawlSiteDependencies = {
   totalMemory: () => number;
 };
 type CrawlSiteDependencies = Partial<ResolvedCrawlSiteDependencies>;
-//#endregion
-//#region packages/core/src/analyze/crawler/site-crawl.d.ts
 export declare function crawlSite(input: CrawlConfigInput, dependencies?: CrawlSiteDependencies): Promise<CrawlReport>;
-//#endregion
-//#region packages/core/src/analyze/query-quality.d.ts
 type QueryFlag = 'likely-automated' | 'navigational-other';
 declare const QUERY_FLAG_METHOD: {
   readonly id: "query_flags_v1";
@@ -18365,8 +18227,6 @@ declare const QUERY_FLAG_METHOD: {
     readonly 'navigational-other': "Names a domain that is not the property's host, ends with a spoken domain suffix or a login/site/app word, starts with a large platform name and adds no topic word, or is one short ASCII word that is not a brand term. Such queries usually look for another site.";
   };
 };
-//#endregion
-//#region packages/core/src/analyze/ctr-underperformers-types.d.ts
 type CtrUnderperformerSelection = {
   sourceRows: number;
   invalidRows: number;
@@ -18419,8 +18279,6 @@ type CtrUnderperformer = {
     confidence: 'low';
   };
 };
-//#endregion
-//#region packages/core/src/analyze/min-impressions-policy.d.ts
 type MinImpressionsScale = {
   share: number;
   floor: number;
@@ -18434,8 +18292,6 @@ type MinImpressionsPolicy = {
   basisImpressions: number;
   scale: MinImpressionsScale;
 };
-//#endregion
-//#region packages/core/src/analyze/ctr-underperformers-report.d.ts
 export interface CtrUnderperformerDependencies {
   searchAnalytics: SearchAnalyticsQuery;
   now: () => Date;
@@ -18547,8 +18403,6 @@ export declare function ctrUnderperformersReportWith(input: CtrUnderperformersIn
   caveats: string[];
   recommendations: string[];
 }>;
-//#endregion
-//#region packages/core/src/analyze/ctr-underperformers-analysis.d.ts
 export declare const CTR_MAX_MIN_IMPRESSIONS = 1000000000;
 export declare const CTR_DEFAULT_LIMIT = 25;
 export declare const CTR_MAX_LIMIT = 100;
@@ -18570,14 +18424,8 @@ export declare function analyzeCtrUnderperformersFromRows(input: {
   brand: ReportBrandTerms;
   benchmarkByPosition: Record<string, PositionBenchmark>;
 };
-//#endregion
-//#region packages/core/src/analyze/ctr-underperformers.d.ts
 export declare function ctrUnderperformersReport(input: CtrUnderperformersInput, dependencies?: CtrUnderperformerDependencies): Promise<CtrUnderperformersReport>;
-//#endregion
-//#region packages/core/src/progress.d.ts
 export type ProgressReporter = (message: string) => void;
-//#endregion
-//#region packages/core/src/analyze/segment-impact-types.d.ts
 type SegmentDimension = 'page' | 'query' | 'country' | 'device';
 type SegmentRange = {
   startDate: string;
@@ -18675,8 +18523,6 @@ type SegmentImpactReport = {
   warnings: string[];
   caveats: string[];
 };
-//#endregion
-//#region packages/core/src/analyze/segment-impact-analysis.d.ts
 export declare function analyzeSegmentRows(input: {
   site: string;
   dimension: SegmentImpactReport['dimension'];
@@ -18695,8 +18541,6 @@ export declare function analyzeSegmentRows(input: {
   beforeRowsFetched?: number;
   afterRowsFetched?: number;
 }): SegmentImpactReport;
-//#endregion
-//#region packages/core/src/analyze/segment-impact-fallback.d.ts
 export declare function unavailableSegmentImpactReport(input: {
   site: string;
   dimension: SegmentDimension;
@@ -18704,8 +18548,6 @@ export declare function unavailableSegmentImpactReport(input: {
   reason: string;
   generatedAt?: string;
 }): SegmentImpactReport;
-//#endregion
-//#region packages/core/src/analyze/segment-impact-input.d.ts
 export declare function segmentRangeDays(range: SegmentRange): number;
 export declare function segmentComparisonRange(after: SegmentRange, compareDays: number): SegmentRange;
 export declare function resolveSegmentRanges(input: {
@@ -18718,8 +18560,6 @@ export declare function resolveSegmentRanges(input: {
   before: SegmentRange;
   after: SegmentRange;
 };
-//#endregion
-//#region packages/core/src/analyze/segment-impact.d.ts
 type SearchAnalytics$1 = typeof querySearchAnalytics;
 export interface SegmentImpactInput {
   site: string;
@@ -18756,8 +18596,6 @@ export declare function compareSegmentRows(input: {
   generatedAt?: string;
 }): SegmentImpactReport;
 export declare function segmentImpact(input: SegmentImpactInput, dependencies?: SegmentImpactDependencies): Promise<SegmentImpactReport>;
-//#endregion
-//#region packages/core/src/providers/domain-contracts.d.ts
 type ResearchImportSource = {
   dataset: 'ranked-keywords';
   file: string;
@@ -18774,13 +18612,9 @@ type RankedKeyword = KeywordMetric & {
   resultType: string;
   estimatedMonthlyTraffic: ProviderValue<number>;
 };
-//#endregion
-//#region packages/core/src/providers/imports/research-rows.d.ts
 type ImportedResearchRow = RankedKeyword & {
   domain: string;
 };
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/cannibal-types.d.ts
 type CannibalSuppressionReason = 'brand_query';
 interface CannibalSuppression {
   query: string;
@@ -19042,8 +18876,6 @@ interface CannibalAnalysis {
   suppressionSummary: Record<string, number>;
   templates: TemplateSummary[];
 }
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/cannibal-report.d.ts
 /** Search Console input. Local research-file imports use the Node binding. */
 export interface CannibalSearchConsoleInput {
   site: string;
@@ -19061,13 +18893,16 @@ export interface CannibalDependencies {
   now: () => Date;
 }
 export declare function cannibalReportWith(input: CannibalSearchConsoleInput, dependencies: CannibalDependencies): Promise<CannibalReport>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/cannibal-analysis.d.ts
 export declare function analyzeCannibalRows(input: AnalyzeCannibalRowsInput): CannibalAnalysis;
+/**
+ * Empty, partial, filtered or complete. Partial evidence (a possibly capped
+ * source, invalid rows, or a candidate with no query-level demand row) never
+ * becomes filtered, so it cannot read as an all-clear.
+ */
+export declare function cannibalDataStatus(selection: CannibalSelection, possiblyTruncated: boolean): CannibalReport['dataStatus'];
+export declare const CANNIBAL_MINIMUM_PAGE_IMPRESSIONS = 10;
 export declare const CANNIBAL_MINIMUM_PAGE_SHARE = 0.1;
 export declare const CANNIBAL_MAXIMUM_DOMINANT_SHARE = 0.8;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/cannibal-import.d.ts
 export interface CannibalImportReportInput {
   site: string;
   researchFiles: ResearchImportSource[];
@@ -19080,8 +18915,6 @@ export interface CannibalImportDependencies {
 }
 export declare function analyzeCannibalImportRows(input: AnalyzeCannibalImportRowsInput): CannibalImportAnalysis;
 export declare function cannibalImportReport(input: CannibalImportReportInput, dependencies?: CannibalImportDependencies): Promise<CannibalImportReport>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/cannibal.d.ts
 export interface CannibalReportInput extends CannibalSearchConsoleInput {
   researchFiles?: ResearchImportSource[];
 }
@@ -19091,8 +18924,6 @@ export declare function cannibalReport(input: CannibalReportInput & {
 export declare function cannibalReport(input: CannibalReportInput & {
   researchFiles?: undefined;
 }, dependencies?: CannibalDependencies): Promise<CannibalReport>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/decay-types.d.ts
 type DecayDiagnosis = 'lost_position' | 'lost_ctr' | 'lost_impressions' | 'lost_clicks';
 type DecayComparison = 'previous-period' | 'year-over-year';
 type DecaySignal = 'position_decline' | 'ctr_decline' | 'impression_decline' | 'click_decline';
@@ -19243,11 +19074,7 @@ interface DecayReport {
   ledgerSummary: string;
   warnings: string[];
 }
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/decay-analysis.d.ts
 export declare function analyzeDecay(input: AnalyzeDecayInput): DecayAnalysis;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/decay-report-input.d.ts
 export declare function decayComparisonRange(current: {
   startDate: string;
   endDate: string;
@@ -19255,8 +19082,6 @@ export declare function decayComparisonRange(current: {
   startDate: string;
   endDate: string;
 };
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/decaying-report.d.ts
 export interface DecayingReportInput {
   site: string;
   days?: number;
@@ -19276,11 +19101,7 @@ export interface DecayingDependencies {
   now: () => Date;
 }
 export declare function decayingReportWith(input: DecayingReportInput, dependencies: DecayingDependencies): Promise<DecayReport>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/decaying.d.ts
 export declare function decayingReport(input: DecayingReportInput, dependencies?: DecayingDependencies): Promise<DecayReport>;
-//#endregion
-//#region packages/core/src/analyze/site-ctr-curve.d.ts
 declare const SITE_CTR_CURVE_METHOD: {
   readonly method: "position_bucket_url_p75_v2";
   readonly samplePopulation: "all_qualified_url_samples";
@@ -19302,8 +19123,6 @@ declare const SITE_CTR_CURVE_METHOD: {
   readonly sharedWith: readonly ["quick-wins", "ctr-underperformers"];
   readonly heuristic: true;
 };
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/quick-wins-types.d.ts
 type QuickWinSelection = {
   sourceRows: number;
   invalidRows: number;
@@ -19439,8 +19258,6 @@ type AnalyzeQuickWinsInput = {
   brandTerms?: string[];
   includeBrand?: boolean;
 };
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/quick-wins-report.d.ts
 export type QuickWinsInput = {
   site: string;
   days?: number;
@@ -19576,19 +19393,11 @@ export declare function quickWinsReportWith(input: QuickWinsInput, dependencies:
     message: string;
   })[];
 }>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/quick-wins-analysis.d.ts
 export declare function analyzeQuickWinsFromRows(input: AnalyzeQuickWinsInput): QuickWinAnalysis;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/quick-wins.d.ts
 export declare function quickWinsReport(input: QuickWinsInput, dependencies?: QuickWinsDependencies): Promise<QuickWinsReport>;
-//#endregion
-//#region packages/core/src/analyze/site-diagnostics/types.d.ts
 export interface TemplateAwareReport {
   templates: TemplateSummary[];
 }
-//#endregion
-//#region packages/core/src/analyze/striking-distance-analysis-types.d.ts
 type StrikingDistanceSelection = {
   sourceRows: number;
   /** Source rows whose page URL had a #fragment; merged into the base URL. */
@@ -19703,11 +19512,7 @@ type AnalyzeStrikingDistanceInput = {
   brandTerms?: string[];
   includeBrand?: boolean;
 };
-//#endregion
-//#region packages/core/src/analyze/striking-distance-analysis.d.ts
 export declare function analyzeStrikingDistanceRows(input: AnalyzeStrikingDistanceInput): StrikingDistanceAnalysis;
-//#endregion
-//#region packages/core/src/analyze/striking-distance-report.d.ts
 export type StrikingDistanceInput = {
   site: string;
   /** Window length in days; ignored when startDate and endDate are given. */
@@ -19784,11 +19589,7 @@ export type StrikingDistanceDependencies = {
   now: () => Date;
 };
 export declare function strikingDistanceWith(input: StrikingDistanceInput, dependencies: StrikingDistanceDependencies): Promise<StrikingDistanceReport>;
-//#endregion
-//#region packages/core/src/analyze/striking-distance.d.ts
 export declare function strikingDistance(input: StrikingDistanceInput, dependencies?: StrikingDistanceDependencies): Promise<StrikingDistanceReport>;
-//#endregion
-//#region packages/core/src/updates/search-updates.d.ts
 interface SearchStatusIncident {
   id: string;
   begin: string;
@@ -19820,8 +19621,6 @@ export declare function findOverlappingSearchUpdates(input: {
   endDate: string;
   paddingDays?: number;
 }): SearchUpdate[];
-//#endregion
-//#region packages/core/src/analyze/traffic-anomaly-analysis.d.ts
 export interface TrafficAnomaly {
   site: string;
   metric: 'clicks' | 'impressions';
@@ -19971,8 +19770,6 @@ export declare function analyzeTrafficAnomalyRows(input: {
   coverage: TrafficAnomalyCoverage;
   detection: TrafficAnomalyDetection;
 };
-//#endregion
-//#region packages/core/src/analyze/traffic-anomaly-report.d.ts
 export type TrafficAnomalyInput = {
   site: string;
   days?: number;
@@ -19986,8 +19783,6 @@ export type TrafficAnomalyDependencies = {
   now: () => Date;
 };
 export declare function trafficAnomalyWith(input: TrafficAnomalyInput, dependencies: TrafficAnomalyDependencies): Promise<TrafficAnomalyReport>;
-//#endregion
-//#region packages/core/src/analyze/traffic-anomaly.d.ts
 export declare function trafficAnomaly(input: TrafficAnomalyInput, dependencies?: TrafficAnomalyDependencies): Promise<TrafficAnomalyReport>;
 export declare function updateCorrelation(input: {
   site: string;
@@ -20000,8 +19795,6 @@ export declare function updateCorrelation(input: {
   refresh?: boolean;
   trafficAnomalies?: TrafficAnomaly[];
 }): Promise<UpdateCorrelationReport>;
-//#endregion
-//#region packages/core/src/analyze/diagnose-property.d.ts
 export type DiagnosisPriority = {
   label: string;
   reason: string;
@@ -20076,8 +19869,6 @@ export declare function diagnoseProperty(input: {
   skipSearchData?: boolean;
   progress?: ProgressReporter;
 }, dependencies?: Partial<DiagnosePropertyDependencies>): Promise<DiagnosePropertyReport>;
-//#endregion
-//#region packages/core/src/decision-model.d.ts
 export type DecisionQuestion = {
   type: 'noul';
   instructions: unknown;
@@ -20151,8 +19942,6 @@ export declare class DecisionRunner {
   private release;
   ask(request: DecisionRequest): Promise<DecisionResponse | null>;
 }
-//#endregion
-//#region packages/core/src/analyze/internal-links-placement.d.ts
 interface LinkSentence {
   text: string;
   section: string;
@@ -20161,8 +19950,6 @@ interface LinkSentence {
 interface TermWeights {
   idf(term: string): number;
 }
-//#endregion
-//#region packages/core/src/analyze/internal-links-index.d.ts
 declare class SiteIndex implements TermWeights {
   private readonly ids;
   private readonly df;
@@ -20181,8 +19968,6 @@ declare class SiteIndex implements TermWeights {
     score: number;
   }>;
 }
-//#endregion
-//#region packages/core/src/analyze/internal-links-crawl.d.ts
 export declare const DEFAULT_MAX_PAGES = 500;
 export declare const MAX_MAX_PAGES = 5000;
 type CrawlSkipReason$1 = 'robots' | 'not-html' | 'http-error' | 'fetch-failed' | 'canonicalised' | 'duplicate' | 'off-site';
@@ -20253,8 +20038,6 @@ interface CrawlInput {
   progress?: ProgressReporter;
 }
 declare function crawlForLinks(input: CrawlInput): Promise<SiteCrawl>;
-//#endregion
-//#region packages/core/src/analyze/internal-links-judge.d.ts
 export declare const PAGE_TYPES: {
   readonly pillar_guide: "A long, broad guide that covers a whole topic and would naturally link out to many narrower pages";
   readonly support_article: "A focused article, post, tutorial, or explainer about one narrower subject";
@@ -20288,8 +20071,6 @@ export declare const LINK_ROLES: {
 };
 type LinkRole = keyof typeof LINK_ROLES;
 type HeldBackReason = 'weak-sentence' | 'no-sentence';
-//#endregion
-//#region packages/core/src/analyze/internal-links-types.d.ts
 interface InternalLinkSuggestion {
   source: string;
   target: string;
@@ -20419,8 +20200,6 @@ interface InternalLinksReport {
   caveats: string[];
   next: string | null;
 }
-//#endregion
-//#region packages/core/src/analyze/internal-links.d.ts
 export interface InternalLinksInput {
   site: string;
   targetUrl?: string;
@@ -20451,8 +20230,6 @@ export interface InternalLinksDependencies {
 }
 export declare function siteStartUrl(site: string): string;
 export declare function internalLinksReport(input: InternalLinksInput, dependencies: Partial<InternalLinksDependencies> & Pick<InternalLinksDependencies, 'searchConsole' | 'decisionModel'>): Promise<InternalLinksReport>;
-//#endregion
-//#region packages/core/src/analyze/url-templates.d.ts
 type PseoTemplateCluster = {
   id: string;
   signature: string;
@@ -20475,8 +20252,6 @@ type PseoTemplateShape = {
     tokenExamples: string[];
   }>;
 };
-//#endregion
-//#region packages/core/src/analyze/monitoring/index-coverage.d.ts
 export type IndexCoverageSourceCompleteness = 'complete' | 'partial' | 'truncated' | 'unknown' | 'unavailable';
 export type IndexCoverageSourceEvidence = {
   completeness: IndexCoverageSourceCompleteness;
@@ -20619,8 +20394,6 @@ export type IndexCoverageSignalsReport = {
   caveats: string[];
 };
 export declare function analyzeIndexCoverageSignals(input: IndexCoverageInput): IndexCoverageSignalsReport;
-//#endregion
-//#region packages/core/src/analyze/monitoring/index-coverage-report.d.ts
 type SearchAnalytics = typeof querySearchAnalytics;
 type FetchSitemap = typeof fetchSitemapUrls;
 export type IndexCoverageReportInput = {
@@ -20666,8 +20439,6 @@ export type IndexCoverageReportDependencies = {
   now: () => Date;
 };
 export declare function indexCoverageSignals(input: IndexCoverageReportInput, dependencies?: IndexCoverageReportDependencies): Promise<IndexCoverageReport>;
-//#endregion
-//#region packages/core/src/analyze/monitoring/redirect-trace.d.ts
 export type RedirectTraceStep = {
   url: string;
   status: number;
@@ -20703,8 +20474,6 @@ export declare function redirectTrace(input: {
   refresh?: boolean;
   js?: boolean | 'auto';
 }): Promise<RedirectTraceReport>;
-//#endregion
-//#region packages/core/src/analyze/monitoring/link-recover.d.ts
 export type LinkRecoverItem = {
   url: string;
   finalUrl: string;
@@ -20753,8 +20522,6 @@ export declare function linkRecover(input: {
   refresh?: boolean;
   js?: boolean | 'auto';
 }): Promise<LinkRecoverReport>;
-//#endregion
-//#region packages/core/src/analyze/performance-types.d.ts
 export type PerformanceRating = 'good' | 'needs-work' | 'poor' | 'unknown';
 export type PerformanceMetric = {
   value?: number;
@@ -20859,8 +20626,6 @@ export type PerformanceAuditReport = {
   caveats: string[];
   raw?: unknown;
 };
-//#endregion
-//#region packages/core/src/analyze/performance-crux.d.ts
 type CruxResult = {
   fieldData?: PerformanceAuditReport['fieldData'];
   status: PerformanceAuditReport['fieldDataStatus'];
@@ -20873,8 +20638,6 @@ export declare function fetchCruxFieldData(input: {
   fetchImpl?: typeof fetch$1;
   timeoutMs?: number;
 }): Promise<CruxResult>;
-//#endregion
-//#region packages/core/src/analyze/performance.d.ts
 export declare function performanceReportIsCacheable(input: {
   report: PerformanceAuditReport;
   customCrux?: boolean;
@@ -20893,8 +20656,6 @@ export declare function performanceAudit(input: {
   includeRaw?: boolean;
   now?: () => Date;
 }): Promise<PerformanceAuditReport>;
-//#endregion
-//#region packages/core/src/analyze/query-cluster-primitives.d.ts
 type QueryClusterRow = {
   query: string;
   impressions: number;
@@ -20910,8 +20671,6 @@ type QueryClusterPage = {
 };
 export declare function queryClusterTokens(query: string): string[];
 export declare function clusterQueryRows(rows: QueryClusterRow[]): QueryClusterRow[][];
-//#endregion
-//#region packages/core/src/analyze/query-cluster-analysis.d.ts
 export declare function analyzeQueryClustersFromRows(input: {
   rows: QueryClusterRow[];
   brand?: string;
@@ -20928,8 +20687,6 @@ export declare function analyzeQueryClustersFromRows(input: {
   minImpressions: number;
   limit: number;
 };
-//#endregion
-//#region packages/core/src/analyze/query-cluster.d.ts
 export type QueryClusterReport = {
   site: string;
   scope?: string;
@@ -20981,8 +20738,6 @@ export declare function buildQueryClusterReportFromRows(input: {
   minImpressions?: number;
   limit?: number;
 }): QueryClusterReport;
-//#endregion
-//#region packages/core/src/analyze/reports/types.d.ts
 export type NarrativeSection = {
   title: string;
   bullets: string[];
@@ -21006,8 +20761,6 @@ export type ReportNarrative = {
   }>;
   diagnosis: DiagnosePropertyReport;
 };
-//#endregion
-//#region packages/core/src/analyze/reports/narrative.d.ts
 export declare function reportNarrative(input: {
   site: string;
   days?: number;
@@ -21027,8 +20780,6 @@ export declare function reportNarrative(input: {
 }): Promise<ReportNarrative & {
   markdown: string;
 }>;
-//#endregion
-//#region packages/core/src/analyze/second-page-report.d.ts
 export type SecondPageInput = {
   site: string;
   /** Window length in days; ignored when startDate and endDate are given. */
@@ -21056,14 +20807,8 @@ export type SecondPageDependencies = {
   now: () => Date;
 };
 export declare function secondPageWith(input: SecondPageInput, dependencies: SecondPageDependencies): Promise<SecondPageReport>;
-//#endregion
-//#region packages/core/src/analyze/second-page-analysis.d.ts
 export declare function analyzeSecondPageRows(input: AnalyzeSecondPageInput): SecondPageAnalysis;
-//#endregion
-//#region packages/core/src/analyze/second-page.d.ts
 export declare function secondPage(input: SecondPageInput, dependencies?: SecondPageDependencies): Promise<SecondPageReport>;
-//#endregion
-//#region packages/core/src/analyze/title-width.d.ts
 export declare const SERP_TITLE_REFERENCE_WIDTH_PX = 580;
 export declare const SERP_TITLE_WIDTH_PROFILE: {
   readonly id: "arial-20-v1";
@@ -21081,8 +20826,6 @@ export type TitleWidthEstimate = {
   fallbackGraphemes: string[];
 };
 export declare function estimateSerpTitleWidth(title: string): TitleWidthEstimate;
-//#endregion
-//#region packages/core/src/analyze/workflows/types.d.ts
 export type WorkflowStep = {
   tool: string;
   status: 'completed' | 'skipped';
@@ -21152,8 +20895,6 @@ export type PriorityQueueItem = {
   action: string;
   evidence: string;
 };
-//#endregion
-//#region packages/core/src/analyze/workflows/crawl-implementation-queue.d.ts
 export type CrawlImplementationQueueItem = PriorityQueueItem & {
   ruleId: string;
   severity: RuleSeverity;
@@ -21173,8 +20914,6 @@ export type CrawlImplementationQueueInput = CrawlConfigInput & {
 };
 export declare function crawlFixToQueueItem(fix: TopFix): CrawlImplementationQueueItem;
 export declare function crawlImplementationQueueWorkflow(input: CrawlImplementationQueueInput, dependencies?: CrawlSiteDependencies): Promise<WorkflowReport<CrawlImplementationQueueOutput>>;
-//#endregion
-//#region packages/core/src/analyze/workflows/diagnose-property.d.ts
 export declare function diagnosePropertyWorkflow(input: {
   site: string;
   days?: number;
@@ -21187,13 +20926,9 @@ export declare function diagnosePropertyWorkflow(input: {
 }): Promise<WorkflowReport<{
   narrative: Awaited<ReturnType<typeof reportNarrative>>;
 }>>;
-//#endregion
-//#region packages/core/src/analyze/workflows/markdown.d.ts
 export declare function renderWorkflowMarkdown(report: WorkflowReport<unknown>, options?: {
   queueLimit?: number;
 }): string;
-//#endregion
-//#region packages/core/src/presentation.d.ts
 export type PresentationScalar = boolean | number | string | null;
 export type PresentationTableColumn = {
   key: string;
@@ -21218,17 +20953,11 @@ export type Presentation = {
   tables: PresentationTable[];
   charts: PresentationChart[];
 };
-//#endregion
-//#region packages/core/src/analyze/workflows/presentation.d.ts
 export declare function workflowPresentation(report: WorkflowReport<unknown>, options?: {
   queueLimit?: number;
 }): Presentation;
-//#endregion
-//#region packages/core/src/analyze/workflows/priority-scoring.d.ts
 type PriorityCategory = 'technical' | 'content' | 'serp' | 'authority' | 'strategy';
 declare function priorityCategory(source: PriorityQueueItem['source'], verification?: QueryContentClassification): PriorityCategory;
-//#endregion
-//#region packages/core/src/analyze/workflows/refresh-priorities.d.ts
 type QueueDraft = Omit<PriorityQueueItem, 'category' | 'score' | 'impact' | 'scoreBreakdown'> & {
   impact: number;
   effort?: 'S' | 'M' | 'L';
@@ -21267,8 +20996,6 @@ export declare function refreshPrioritiesWorkflow(input: {
   warnings: string[];
   diagnosis: Awaited<ReturnType<typeof diagnoseProperty>>;
 }>>;
-//#endregion
-//#region packages/core/src/analyze/workflows/segments.d.ts
 type WorkflowSegmentCoverage = {
   evidenceScope: 'matched-retained-segments';
   eligibleRows: number;
@@ -21290,8 +21017,6 @@ type WorkflowSegmentSplit = {
   warnings: string[];
 };
 declare function splitSegments(report: SegmentImpactReport): WorkflowSegmentSplit;
-//#endregion
-//#region packages/core/src/analyze/workflows/update-postmortem.d.ts
 type SplitSegment = ReturnType<typeof splitSegments>;
 type PostmortemInsight = {
   dimension: 'page' | 'query' | 'device' | 'country';
@@ -21342,8 +21067,6 @@ export declare function updatePostmortemWorkflow(input: {
   updateCorrelation?: typeof updateCorrelation;
   segmentImpact?: typeof segmentImpact;
 }): Promise<WorkflowReport<PostmortemOutput>>;
-//#endregion
-//#region packages/core/src/brand.d.ts
 export declare function normalizeBrandText(value: string): string;
 /**
  * The registrable part of a Search Console property host, using the small
@@ -21367,8 +21090,6 @@ export declare function shouldExcludeBrandQuery(input: {
   brandTerms?: string[];
   includeBrand?: boolean;
 }): boolean;
-//#endregion
-//#region packages/core/src/brand-detect.d.ts
 type BrandEvidence = {
   query: string;
   clicks: number;
@@ -21396,8 +21117,6 @@ export declare function detectBrandTerms(input: {
   suggestedTerms: string[];
   candidates: BrandTermCandidate[];
 }>;
-//#endregion
-//#region packages/core/src/storage/provider-secrets.d.ts
 export declare const PROVIDER_SECRET_NAMES: {
   readonly ahrefsApiKey: "ahrefs-api-key";
   readonly bingApiKey: "bing-api-key";
@@ -21419,8 +21138,6 @@ export declare function readProviderSecret(input: {
 export declare function writeProviderSecret(name: string, value: string): Promise<Exclude<ProviderSecretSource, 'environment'>>;
 export declare function deleteProviderSecret(name: string): Promise<void>;
 export declare function deleteManagedProviderSecrets(): Promise<void>;
-//#endregion
-//#region packages/core/src/clicky/credentials.d.ts
 export declare const CLICKY_SITEKEY_ENV = "SEO_CLICKY_SITEKEY";
 export declare const CLICKY_SITE_KEYS_SECRET: "clicky-sitekeys";
 export type StoredClickySiteKey = {
@@ -21435,23 +21152,15 @@ export declare function readClickySiteKey(siteIdValue: string, input?: {
 }): Promise<StoredClickySiteKey | undefined>;
 export declare function writeClickySiteKey(siteIdValue: string, siteKeyValue: string): Promise<Exclude<ProviderSecretSource, 'environment'>>;
 export declare function deleteClickySiteKey(siteIdValue: string): Promise<void>;
-//#endregion
-//#region packages/core/src/bing/api.d.ts
 type BingCall = (method: string, params?: Record<string, string>) => Promise<unknown>;
-//#endregion
-//#region packages/core/src/commands/sites.d.ts
 type GoogleAccount = {
   email: string | null;
   google: GoogleFetch;
 };
-//#endregion
-//#region packages/core/src/commands/analytics-site.d.ts
 type AnalyticsAccess = {
   accounts: () => Promise<GoogleAccount[]>;
   signIn: string;
 };
-//#endregion
-//#region packages/core/src/commands/audit-checks.d.ts
 type AuditCheckRow = {
   url: string;
   in_sitemap: boolean;
@@ -21517,8 +21226,6 @@ type AuditChecks = {
   started: boolean;
   as_of: number;
 };
-//#endregion
-//#region packages/core/src/commands/audit.d.ts
 type AuditSummary = {
   status: 'done' | 'failed';
   complete: boolean;
@@ -21601,8 +21308,26 @@ type AuditAccess = {
   checks: (site: string, offset: number, limit: number) => Promise<AuditChecks | null>;
   add: (site: string) => Promise<'added' | 'exists' | 'full'>;
 };
-//#endregion
-//#region packages/core/src/commands/page-facts.d.ts
+declare const ISSUE_MARKS: readonly ["open", "fixed", "ignored"];
+type IssueMark = (typeof ISSUE_MARKS)[number];
+type IssueSeen = 'found' | 'not-found' | 'not-checked';
+type StoredIssue = {
+  id: string;
+  kind: string;
+  subject: string;
+  evidence: string;
+  mark: IssueMark;
+  marked_at: string | null;
+  note: string | null;
+  first_found: string;
+  last_found: string | null;
+  seen: IssueSeen;
+  checked_at: string | null;
+};
+type IssueStore = {
+  read: (site: string) => Promise<StoredIssue[] | null>;
+  write: (site: string, issues: StoredIssue[]) => Promise<void>;
+};
 type RedirectKind = 'permanent' | 'temporary';
 type LiveCheck = {
   first: PageFacts;
@@ -21614,8 +21339,6 @@ type LiveCheck = {
   }[];
   last: PageFacts | null;
 };
-//#endregion
-//#region packages/core/src/commands/types.d.ts
 declare const COMMANDS: {
   readonly report: {
     readonly where: "anywhere";
@@ -21701,6 +21424,7 @@ type CommandDeps = {
   audit?: AuditAccess;
   week?: () => Promise<WeekData | null>;
   startAudit?: (site: string) => Promise<StartAudit>;
+  issues?: IssueStore;
   now?: () => Date;
 };
 type StartAudit = {
@@ -21722,8 +21446,6 @@ type PageMarkdown = {
 } | {
   error: string;
 };
-//#endregion
-//#region packages/core/src/commands/week.d.ts
 type WeekSite = {
   property: string;
   link: string | null;
@@ -21759,8 +21481,6 @@ type WeekData = {
   account: string;
   sites: WeekSite[];
 };
-//#endregion
-//#region packages/core/src/cloud.d.ts
 export declare const CLOUD_URL = "https://seoskill.dev";
 type Pending = {
   device: string;
@@ -21801,8 +21521,6 @@ export declare function pendingCloudLogin(): Pending | null;
 export declare function finishCloudLogin(): Promise<'linked' | 'pending' | 'expired'>;
 export declare function cloudLogout(): Promise<boolean>;
 export declare function openCloudLink(url: string): Promise<void>;
-//#endregion
-//#region packages/core/src/storage/config.d.ts
 export type TokenStorageMode = 'keychain' | 'file';
 export type TokenStorageStatus = {
   configured: TokenStorageMode;
@@ -21840,8 +21558,6 @@ export declare function getPrivacySnapshot(): Array<{
   mode: string;
   sizeBytes: number;
 }>;
-//#endregion
-//#region packages/core/src/gsc/auth/types.d.ts
 interface OAuthClientConfig {
   clientId: string;
   clientSecret: string;
@@ -21850,8 +21566,6 @@ interface OAuthClientConfig {
 interface GoogleAccessTokenClient {
   getAccessToken(): Promise<string>;
 }
-//#endregion
-//#region packages/core/src/gsc/auth/service-account.d.ts
 type ServiceAccountSource = 'environment-json' | 'environment-file' | 'application-default-file';
 export type ServiceAccountConfig = {
   clientEmail: string;
@@ -21875,8 +21589,6 @@ export declare class ServiceAccountAccessTokenClient implements GoogleAccessToke
   constructor(config: ServiceAccountConfig, fetchImpl?: typeof fetch);
   getAccessToken(): Promise<string>;
 }
-//#endregion
-//#region packages/core/src/gsc/auth/authorized-client.d.ts
 export declare function createAuthorizedClient(accountEmail?: string): Promise<{
   client: GoogleAccessTokenClient;
   tokens: StoredTokens;
@@ -21903,25 +21615,17 @@ export declare function authStatus(): Promise<{
   identity?: string;
   serviceAccount: ServiceAccountStatus;
 }>;
-//#endregion
-//#region packages/core/src/gsc/auth/client-config.d.ts
 export declare function getAuthModeStatus(): {
   sharedConfigured: boolean;
   byoConfigured: boolean;
 };
 export declare function getClientConfig(source?: OAuthClientConfig['source']): OAuthClientConfig | undefined;
 export declare function missingOAuthClientMessage(source: OAuthClientConfig['source']): string;
-//#endregion
-//#region packages/core/src/gsc/auth/loopback.d.ts
 export declare function missingSharedClientLoginMessage(): string;
 export declare function loginWithLoopback(clientConfig?: OAuthClientConfig | undefined): Promise<StoredTokens>;
-//#endregion
-//#region packages/core/src/gsc/client/fetch.d.ts
 export declare const LOCAL_SIGN_IN: {
   signIn: string;
 };
-//#endregion
-//#region packages/core/src/commands-node.d.ts
 export declare function nodeCommandDeps(options: {
   call: Caller;
   account?: string;
@@ -21943,8 +21647,6 @@ export declare function resolveLocalSite(site: string, options?: {
 }): Promise<string>;
 export declare function localError(error: unknown): unknown;
 export declare function localGoogleFetch(account?: string): Promise<GoogleFetch>;
-//#endregion
-//#region packages/core/src/storage/sqlite.d.ts
 type TransactionFunction = (...params: never[]) => unknown;
 declare class Statement {
   private readonly statement;
@@ -21969,8 +21671,6 @@ declare namespace SqliteDatabase {
     lastInsertRowid: number | bigint;
   };
 }
-//#endregion
-//#region packages/core/src/storage/database.d.ts
 export declare function ensurePrivateDatabaseFiles(path: string): void;
 export declare function getDb(): SqliteDatabase.Database;
 export declare function cacheDb(): SqliteDatabase.Database;
@@ -21982,8 +21682,6 @@ export declare function checkDatabaseReadiness(): {
 export declare function hashKey(parts: unknown[]): string;
 export declare function getCacheStats(): CacheStats;
 export declare function clearCache(provider?: 'gsc' | 'google-analytics' | 'dataforseo' | 'ahrefs' | 'clicky' | 'http', olderThanMs?: number): number;
-//#endregion
-//#region packages/core/src/doctor.d.ts
 export type DoctorCheck = {
   id: string;
   label: string;
@@ -21999,8 +21697,6 @@ export declare function runDoctor(dependencies?: DoctorDependencies): Promise<{
   generatedAt: string;
   checks: DoctorCheck[];
 }>;
-//#endregion
-//#region packages/core/src/export/csv.d.ts
 export type CsvValue = string | number | boolean | null | undefined;
 export type CsvRow = Record<string, CsvValue>;
 export type CsvFile = {
@@ -22016,8 +21712,6 @@ export declare function refreshPrioritiesCsvFiles(report: WorkflowReport<{
   warnings: string[];
   diagnosis: DiagnosePropertyReport;
 }>): CsvFile[];
-//#endregion
-//#region packages/core/src/export/update-postmortem.d.ts
 type PostmortemCsvReport = WorkflowReport<{
   update: {
     attribution: string;
@@ -22096,8 +21790,6 @@ type SegmentItem = {
   positionDelta: number | null;
 };
 export declare function updatePostmortemCsvFiles(report: PostmortemCsvReport): CsvFile[];
-//#endregion
-//#region packages/core/src/ga4/matching.d.ts
 export type Ga4WebStreamCandidate = {
   account: string;
   property: string;
@@ -22111,8 +21803,6 @@ export type Ga4WebStreamMatch = Ga4WebStreamCandidate & {
 };
 export declare function matchGa4WebStreams(site: string, candidates: Ga4WebStreamCandidate[]): Ga4WebStreamMatch[];
 export declare function ga4MatchReason(match: Ga4WebStreamMatch, site: string): string;
-//#endregion
-//#region packages/core/src/gsc/dates.d.ts
 export declare const GSC_TIME_ZONE = "America/Los_Angeles";
 export declare const GSC_FINAL_DATA_LAG_DAYS = 4;
 export declare function shiftIsoDate(date: string, days: number): string;
@@ -22121,8 +21811,6 @@ export declare function finalGscDateRange(days?: number, now?: Date): {
   startDate: string;
   endDate: string;
 };
-//#endregion
-//#region packages/core/src/gsc/local-export.d.ts
 export declare const DEFAULT_SEARCH_CONSOLE_EXPORT_ROW_LIMIT = 5000;
 export declare const MAX_SEARCH_CONSOLE_EXPORT_ROW_LIMIT = 100000;
 export declare const MAX_SEARCH_CONSOLE_EXPORT_FILES = 20;
@@ -22182,8 +21870,6 @@ export declare function loadSearchConsoleExport(input: {
   now?: Date;
   exportedAt?: Date;
 }): Promise<SearchConsoleExportEvidence>;
-//#endregion
-//#region packages/core/src/gsc/local-export-reconcile.d.ts
 export declare const DEFAULT_UNREACHED_PAGE_LIMIT = 100;
 export type SearchConsoleExportReconciliation = {
   joinBasis: 'path';
@@ -22201,25 +21887,15 @@ export declare function reconcileExportPagesWithCrawl(input: {
   crawlOrigin: string;
   limit?: number;
 }): SearchConsoleExportReconciliation;
-//#endregion
-//#region packages/core/src/gsc/property-url.d.ts
 export declare function normalizeHttpUrl(value: string): string;
 export declare function assertUrlMatchesGscProperty(property: string, value: string): string;
-//#endregion
-//#region packages/core/src/http/read-json.d.ts
 export declare function readJson<T = unknown>(response: Response, label: string, options?: {
   maxBytes?: number;
 }): Promise<T>;
 export declare function readJsonOrUndefined<T = unknown>(response: Response, label: string): Promise<T | undefined>;
-//#endregion
-//#region packages/core/src/logger.d.ts
 export declare function createLogger(runId: string): pino.Logger;
 export declare function makeRunId(): string;
-//#endregion
-//#region packages/core/src/markdown.d.ts
 export declare function renderPresentationTablesMarkdown(tables: PresentationTable[]): string[];
-//#endregion
-//#region packages/core/src/paths.d.ts
 export interface SeoCliPaths {
   configDir: string;
   cacheDir: string;
@@ -22243,12 +21919,8 @@ export declare function migrateLegacyMacConfig(input?: SeoCliPathOptions): void;
 export declare function getSeoCliPaths(): SeoCliPaths;
 export declare function ensureSeoCliDirs(): SeoCliPaths;
 export declare function fileSize(path: string): number;
-//#endregion
-//#region packages/core/src/phrasing.d.ts
 export declare function plural(count: number, singular: string, pluralLabel?: string): string;
 export declare function countLabel(count: number, singular: string, pluralLabel?: string): string;
-//#endregion
-//#region packages/core/src/provider-extensions/actions.d.ts
 export type ProviderActionResult = {
   provider: string;
   action: string;
@@ -22264,13 +21936,9 @@ export declare function runProviderExtensionAction(input: {
   refresh?: boolean;
   runtime?: ProviderRuntimeOptions;
 }): Promise<ProviderActionResult>;
-//#endregion
-//#region packages/core/src/provider-extensions/connections.d.ts
 export declare function readProviderExtensionAccount(providerIdValue: string): Record<string, string>;
 export declare function writeProviderExtensionAccount(providerIdValue: string, account: Readonly<Record<string, string>>): Record<string, string>;
 export declare function deleteProviderExtensionAccount(providerIdValue: string): void;
-//#endregion
-//#region packages/core/src/provider-extensions/credentials.d.ts
 export declare function readProviderExtensionCredentials(input: {
   providerId: string;
   account: Readonly<Record<string, string>>;
@@ -22286,8 +21954,6 @@ export declare function deleteProviderExtensionCredentials(input: {
   providerId: string;
   account: Readonly<Record<string, string>>;
 }): Promise<void>;
-//#endregion
-//#region packages/core/src/provider-extensions/discovery.d.ts
 export declare function listInstalledProviderExtensions(): Promise<{
   schemaVersion: 1;
   installed: {
@@ -22326,8 +21992,6 @@ export declare function describeInstalledProviderExtension(id: string): Promise<
     cacheTtlMs: number;
   }[];
 }>;
-//#endregion
-//#region packages/core/src/provider-extensions/installer.d.ts
 declare const providerPackageReleaseSchema: z.ZodObject<{
   package: z.ZodString;
   version: z.ZodString;
@@ -22355,14 +22019,10 @@ export type ProviderInstallerOptions = {
 export declare function inspectProviderPackage(value: string, options?: ProviderInstallerOptions): Promise<ProviderPackageRelease>;
 export declare function installProviderPackage(input: ProviderPackageRelease, options?: ProviderInstallerOptions): Promise<InstalledProviderPackage>;
 export declare function uninstallProviderExtension(id: string, options?: ProviderInstallerOptions): Promise<InstalledProviderPackage | undefined>;
-//#endregion
-//#region packages/core/src/provider-extensions/store.d.ts
 export declare function readInstalledProviderPackages(): InstalledProviderPackages;
 export declare function writeInstalledProviderPackages(value: InstalledProviderPackages): InstalledProviderPackages;
 export declare function saveInstalledProviderPackage(value: InstalledProviderPackage): InstalledProviderPackages;
 export declare function removeInstalledProviderPackage(id: string): InstalledProviderPackage | undefined;
-//#endregion
-//#region packages/core/src/providers/ahrefs/client.d.ts
 export type AhrefsLimitsAndUsage = {
   provider: 'ahrefs';
   apiVersion: 3;
@@ -22402,8 +22062,6 @@ export declare class AhrefsClient {
   private limitsAndUsageForKey;
   limitsAndUsage(): Promise<AhrefsLimitsAndUsage>;
 }
-//#endregion
-//#region packages/core/src/providers/ahrefs/credentials.d.ts
 export declare const AHREFS_API_KEY_ENV = "SEO_AHREFS_API_KEY";
 export declare const AHREFS_API_KEY_SECRET: "ahrefs-api-key";
 declare const store: {
@@ -22425,8 +22083,6 @@ export declare function readAhrefsApiKey(input?: {
   source: ProviderSecretSource;
 } | undefined>;
 export declare function deleteAhrefsApiKey(): Promise<void>;
-//#endregion
-//#region packages/core/src/providers/bing/credentials.d.ts
 export declare const BING_API_KEY_ENV = "SEO_BING_API_KEY";
 export declare const BING_API_KEY_SECRET: "bing-api-key";
 export declare function writeBingApiKey(value: string): Promise<"file" | "keychain">;
@@ -22437,8 +22093,6 @@ export declare function readBingApiKey(input?: {
   source: ProviderSecretSource;
 } | undefined>;
 export declare function deleteBingApiKey(): Promise<void>;
-//#endregion
-//#region packages/core/src/providers/dataforseo/credentials.d.ts
 export declare const DATAFORSEO_LOGIN_ENV = "SEO_DATAFORSEO_LOGIN";
 export declare const DATAFORSEO_PASSWORD_ENV = "SEO_DATAFORSEO_PASSWORD";
 export declare const DATAFORSEO_CREDENTIAL_SECRET: "dataforseo-credentials";
@@ -22455,8 +22109,6 @@ export declare function readDataForSeoCredentials(input?: {
   env?: NodeJS.ProcessEnv;
 }): Promise<StoredDataForSeoCredentials | undefined>;
 export declare function deleteDataForSeoCredentials(): Promise<void>;
-//#endregion
-//#region packages/core/src/providers/dataforseo/client-types.d.ts
 type DataForSeoAccountSnapshot = {
   provider: 'dataforseo';
   login: string;
@@ -22476,8 +22128,6 @@ type DataForSeoClientOptions = {
   maxResponseBytes?: number;
   now?: () => Date;
 };
-//#endregion
-//#region packages/core/src/providers/dataforseo/client.d.ts
 export declare class DataForSeoClient {
   private readonly fetch;
   private readonly credentials;
@@ -22491,8 +22141,6 @@ export declare class DataForSeoClient {
   private userDataForCredentials;
   userData(): Promise<DataForSeoAccountSnapshot>;
 }
-//#endregion
-//#region packages/core/src/providers/errors.d.ts
 export type ProviderErrorCode = 'configuration' | 'authentication' | 'rate-limit' | 'timeout' | 'response-too-large' | 'invalid-response' | 'remote-error';
 export declare const PROVIDER_ERROR_CODES: Record<ProviderErrorCode, SeoErrorCode>;
 export declare class ProviderError extends Error {
@@ -22512,8 +22160,6 @@ export declare class ProviderError extends Error {
   });
   toJSON(): Record<string, unknown>;
 }
-//#endregion
-//#region packages/core/src/robots-directives.d.ts
 export type RobotsDirective = 'noindex' | 'nofollow' | 'nosnippet';
 export type SnippetControlEvidence = {
   source: 'meta-robots' | 'x-robots-tag';
@@ -22540,8 +22186,6 @@ export declare function effectiveSnippetControl(input: {
   metaRobots?: string | string[];
   xRobotsTag?: string | string[];
 }): EffectiveSnippetControl;
-//#endregion
-//#region packages/core/src/runtime/interfaces.d.ts
 export interface CredentialsProvider {
   getGoogleOAuthClient(): OAuthClientConfig | undefined;
   readGoogleTokens(): Promise<StoredTokens | undefined>;
@@ -22569,8 +22213,50 @@ export declare class JsonFileStorageAdapter implements StorageAdapter {
   private writeAll;
 }
 export declare const localCredentialsProvider: LocalCredentialsProvider;
-//#endregion
-//#region packages/core/src/storage/ledger.d.ts
+type SiteCheckGroup = 'pages' | 'copy' | 'design' | 'data';
+type SiteCheckLevel = 'fail' | 'warn';
+export declare const SITE_CHECK_MAX_PAGES = 10000;
+export declare const SITE_CHECK_MAX_ISSUES = 1000;
+export declare const SITEMAP_FILE_URL_LIMIT = 5000;
+export type BuiltSite = {
+  origin: string;
+  files: readonly string[];
+  readText: (path: string) => Promise<string>;
+  readBytes: (path: string) => Promise<Uint8Array>;
+  allowWords?: readonly string[];
+  sources?: {
+    files: readonly string[];
+    readText: (path: string) => Promise<string>;
+  };
+  now?: Date;
+};
+export type SiteCheckIssue = {
+  rule: string;
+  group: SiteCheckGroup;
+  level: SiteCheckLevel;
+  file: string;
+  found: string;
+  fix: string;
+};
+export type SiteCheckResult = {
+  status: 'passed' | 'failed' | 'partial';
+  origin: string;
+  pagesFound: number;
+  pagesChecked: number;
+  failures: number;
+  warnings: number;
+  rules: Array<{
+    rule: string;
+    group: SiteCheckGroup;
+    level: SiteCheckLevel;
+    count: number;
+    fix: string;
+  }>;
+  issues: SiteCheckIssue[];
+  issuesOmitted: number;
+};
+export declare function builtPagePath(file: string): string;
+export declare function checkBuiltSite(site: BuiltSite): Promise<SiteCheckResult>;
 export declare class SessionLedger {
   private readonly entries;
   private gscCalls;
@@ -22579,8 +22265,6 @@ export declare class SessionLedger {
   addGsc(calls: number, rows: number): void;
   summary(): string;
 }
-//#endregion
-//#region packages/core/src/storage/log-retention.d.ts
 export declare const LOG_MAX_FILE_BYTES: number;
 export declare const LOG_MAX_TOTAL_BYTES: number;
 export declare const LOG_MAX_AGE_MS: number;
@@ -22596,11 +22280,7 @@ export declare function pruneLogs(options?: {
   maxTotalBytes?: number;
   maxAgeMs?: number;
 }): LogPruneResult;
-//#endregion
-//#region packages/core/src/storage/reset.d.ts
 export declare function resetSeoData(): Promise<void>;
-//#endregion
-//#region packages/core/src/telemetry-failures.d.ts
 export declare const TELEMETRY_ERROR_CATEGORIES: readonly ["auth", "crawl_timeout", "network", "config", "data", "database", "filesystem", "internal", "unknown"];
 export declare const TELEMETRY_FAILURE_REASONS: readonly ["access_denied", "auth_config_required", "auth_expired", "auth_required", "crawl_timeout", "database_constraint", "database_corrupt", "database_locked", "database_read_only", "database_unique_constraint", "filesystem_full", "filesystem_not_found", "filesystem_permission", "insufficient_data", "internal_error", "invalid_input", "network_connection", "network_dns", "network_timeout", "network_tls", "optional_provider_unavailable", "property_not_found", "provider_unavailable", "rate_limited", "unknown"];
 export declare const TELEMETRY_FAILURE_CONTEXTS: readonly ["crawl_pages_run_id_url"];
@@ -22616,13 +22296,9 @@ type TelemetryFailureClassification = {
 };
 export declare function classifyTelemetryFailure(error: unknown): TelemetryFailureClassification;
 export declare function isTelemetryOperation(value: unknown): value is TelemetryOperation;
-//#endregion
-//#region packages/core/src/telemetry-shared.d.ts
 export declare const TELEMETRY_ENDPOINT = "https://seoskill.dev/api/t";
 export declare const TELEMETRY_SCHEMA_VERSION = 2;
 export declare function isoWeek(date: Date): string;
-//#endregion
-//#region packages/core/src/telemetry.d.ts
 export declare const TELEMETRY_TIMEOUT_MS = 2000;
 export declare const TELEMETRY_EVENTS: readonly ["first_run", "setup_complete", "audit_start", "audit_complete", "audit_failed", "command_failed", "first_audit_complete", "active_d1", "active_d7", "active_d30"];
 export declare const TELEMETRY_AGENTS: readonly ["claude-code", "cursor", "codex", "cli", "unknown"];
@@ -22698,8 +22374,6 @@ export declare function trackTelemetryReportFailed(report: string, error: unknow
 export declare function trackTelemetryCommandFailed(operation: string, error: unknown, options?: TelemetryOptions): void;
 export declare function trackTelemetrySetupComplete(options?: TelemetryOptions): void;
 export declare function telemetryErrorCategory(error: unknown): TelemetryErrorCategory;
-//#endregion
-//#region packages/core/src/update-notice.d.ts
 export type UpdateNoticeOptions = {
   argv?: string[];
   cacheFile?: string;
@@ -22710,22 +22384,15 @@ export type UpdateNoticeOptions = {
 };
 export declare function isNewerVersion(current: string, latest: string): boolean;
 export declare function updateNotice(options?: UpdateNoticeOptions): string | undefined;
-//#endregion
-//#region packages/core/src/updates/search-status.d.ts
 export declare const INCIDENTS_URL = "https://status.search.google.com/incidents.json";
 export declare function fetchSearchStatusIncidents(): Promise<SearchStatusIncident[]>;
 export declare function listSearchUpdates(input?: {
   product?: string;
   limit?: number;
 }): Promise<SearchUpdate[]>;
-//#endregion
-//#region packages/core/src/utils/time.d.ts
 export declare function parseOlderThan(input?: string): number | undefined;
 export declare function formatRelativeExpiry(expiresAt: number): string;
 export declare function isoDate(daysAgo?: number): string;
-//#endregion
-//#region packages/core/src/version.d.ts
 export declare const SEO_VERSION: string;
-//#endregion
 export { type AiReferralDataSource, type AiReferralMetrics, type AiReferralQueryEvidence, type AiReferralReport, type AiReferralSourceDefinition, type AnalyzeCannibalImportRowsInput, type AnalyzeCannibalRowsInput, type AnalyzeDecayInput, type AnalyzeQuickWinsInput, type AnalyzeSecondPageInput, type AnalyzeStrikingDistanceInput, type CannibalAnalysis, type CannibalImportAnalysis, type CannibalImportItem, type CannibalImportPage, type CannibalImportReport, type CannibalImportSelection, type CannibalItem, type CannibalPage, type CannibalReport, type CannibalSelection, type CannibalSuppression, type CannibalSuppressionReason, type CrawlAiAvailability, type CrawlAiBotAccess, type CrawlAiLinkCheck, type CrawlAiResourceSignal, type CrawlAiSignals, type CrawlSiteChecks, type CrawlSiteDependencies, type CrawlStatusPhase, type CtrUnderperformer, type CtrUnderperformerSelection, type DataForSeoAccountSnapshot, type DataForSeoClientOptions, type DecayAnalysis, type DecayComparison, type DecayDiagnosis, type DecayGroup, type DecayItem, type DecayMetrics, type DecayReport, type DecaySelection, type DecaySignal, type FetchPageOptions, type FetchRateControls, type Ga4AccountSummary, type Ga4PropertySummary, type GoogleAccessTokenClient, type InternalLinkSuggestion, type InternalLinksPage, type InternalLinksReport, type JavaScriptRenderingInput, type JavaScriptRenderingMode, type OAuthClientConfig, type PageOpportunityAnalysis, type PageOpportunityAnalysisInput, type PageOpportunityBenchmark, type PageOpportunityItem, type PageOpportunitySelection, type PageOpportunityType, type PageOpportunityVerification, type PageRenderer, type QueryClusterPage, type QueryClusterRow, type QuickWinAnalysis, type QuickWinGroup, type QuickWinItem, type QuickWinSelection, type QuickWinTemplateRecommendation, SEO_PROVIDER_API_VERSION, type SearchStatusIncident, type SearchUpdate, type SecondPageAnalysis, type SecondPageItem, type SecondPageQuery, type SecondPageRecommendation, type SecondPageReport, type SecondPageSelection, type SegmentDimension, type SegmentImpactItem, type SegmentImpactReport, type SegmentImpactSelection, type SegmentPeriodEvidence, type SegmentRange, SeoAnalyticsConnection, SeoAnalyticsLandingPageResult, SeoLandingPageVisitRow, SeoLandingPageVisitsCapability, SeoLandingPageVisitsResult, SeoProviderActionAdapter, SeoProviderActivate, SeoProviderApiVersion, SeoProviderCapabilityAdapter, SeoProviderCapabilityId, SeoProviderConnection, SeoProviderConnectionAdapter, SeoProviderConnectionField, SeoProviderHost, SeoProviderJson, SeoProviderJsonSchema, SeoProviderKind, SeoProviderRegistration, SeoProviderRequest, SeoProviderRuntime, SeoSearchMarket, SeoSerpLocalPackResult, SeoSerpOrganicResult, SeoSerpSnapshotCapability, SeoSerpSnapshotResult, type StrikingDistanceAnalysis, type StrikingDistanceAnalysisGroup, type StrikingDistanceAnalysisItem, type TelemetryErrorCategory, type TelemetryFailureClassification, type TelemetryFailureContext, type TelemetryFailureReason, type TelemetryOperation, type UnmatchedSegment, pageTechnicalSignals as technicalPageSignals };
 //# sourceMappingURL=index.d.ts.map