seo 0.15.2 → 0.16.0

package/dist/index.d.ts

@@ -198,7 +198,7 @@ export interface PageFetchDiagnostics {
     };
     documentDifference?: RenderingDocumentDifference;
     browser?: {
-      source: 'environment' | 'playwright-cache' | 'system';
+      source: 'environment' | 'playwright-cache' | 'agent-browser-cache' | 'system';
       product: string;
       version?: string;
     };
@@ -680,6 +680,19 @@ declare const RULE_DEFINITIONS: readonly [{
     readonly evidenceFields: ["page.wordCount", "page.contentSample", "page.outgoingInternalCount", "page.fetchDiagnostics.rendering"];
     readonly suggestedCommands: ["seo crawl <url> --max-pages 1 --json"];
   };
+}, {
+  readonly id: "crawl_single_page_reach";
+  readonly title: "Crawl could reach only the start page";
+  readonly category: "links";
+  readonly defaultSeverity: "high";
+  readonly whyItMatters: "The start page had no crawlable internal links and no sitemap returned URLs, so the crawl checked one page. Every other finding in this report covers that page only. The page probably builds its links with JavaScript.";
+  readonly howToFix: "Rerun with `--rendering on` so the crawler reads the links a browser sees, or pass the pages to check with `--mode list`. For crawlers that do not run JavaScript, put plain `<a href>` links in the initial HTML and publish a sitemap.";
+  readonly impactIfIgnored: "Crawlers and audits that do not run JavaScript can find only this page, so the rest of the site stays unchecked and harder to discover.";
+  readonly howToVerify: "Rerun the crawl and confirm it retains more than one page and the start page reports internal links.";
+  readonly agentHints: {
+    readonly evidenceFields: ["page.outgoingInternalCount", "report.sitemapDiscovery.urlsReturned", "page.fetchDiagnostics.rendering"];
+    readonly suggestedCommands: ["seo crawl <url> --rendering on --json", "seo crawl --mode list --urls <url>,<url> --json"];
+  };
 }, {
   readonly id: "soft_404";
   readonly title: "Unknown URLs return a successful response";
@@ -688,7 +701,7 @@ declare const RULE_DEFINITIONS: readonly [{
   readonly whyItMatters: "Known-nonexistent URLs returned a successful response or redirected to another successful page. Search engines and users cannot reliably distinguish missing content from a real page.";
   readonly howToFix: "Return 404 or 410 for missing URLs. If a replacement exists, redirect only the specific retired URL to its closest relevant replacement rather than sending every unknown path to a generic page.";
   readonly impactIfIgnored: "Missing URLs can remain in crawl queues, waste crawl attention, and create confusing search or monitoring evidence.";
-  readonly howToVerify: "Request several known-nonexistent paths and confirm each returns 404 or 410 without redirecting to a generic successful page.";
+  readonly howToVerify: "Request several made-up paths, including one at the site root and one nested path, and confirm each returns 404 or 410 without redirecting to a generic successful page.";
   readonly agentHints: {
     readonly evidenceFields: ["report.siteChecks.soft404"];
     readonly suggestedCommands: ["seo crawl <url> --json"];
@@ -2818,7 +2831,7 @@ export declare function fetchSitemapUrls(input: {
   limit?: number;
   maxNested?: number;
 }): Promise<SitemapFetchResult>;
-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 declare const CRAWL_SKIP_REASONS: readonly ["asset-url", "configured-exclusion", "duplicate-normalization", "invalid-url", "memory-pressure", "off-origin", "origin-backpressure", "queue-safety-limit", "query-variant-limit", "robots-disallowed", "robots-uncertain", "legacy-unclassified"];
 export type CrawlSkipReason = (typeof CRAWL_SKIP_REASONS)[number];
 export type CrawlSkipImpact = 'coverage-affecting' | 'non-impacting';
 export type CrawlSkipReasonCount = {
@@ -3568,6 +3581,7 @@ export declare const crawlPageSnapshotSchema: z.ZodObject<{
         source: z.ZodEnum<{
           environment: "environment";
           "playwright-cache": "playwright-cache";
+          "agent-browser-cache": "agent-browser-cache";
           system: "system";
         }>;
         product: z.ZodString;
@@ -4314,6 +4328,7 @@ export declare const crawlReportSummarySchema: z.ZodObject<{
       "memory-pressure": "memory-pressure";
       "off-origin": "off-origin";
       "queue-safety-limit": "queue-safety-limit";
+      "query-variant-limit": "query-variant-limit";
       "robots-uncertain": "robots-uncertain";
       "legacy-unclassified": "legacy-unclassified";
     }>;
@@ -4480,6 +4495,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
         "queue-safety-limit": "queue-safety-limit";
+        "query-variant-limit": "query-variant-limit";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -4751,6 +4767,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
           source: z.ZodEnum<{
             environment: "environment";
             "playwright-cache": "playwright-cache";
+            "agent-browser-cache": "agent-browser-cache";
             system: "system";
           }>;
           product: z.ZodString;
@@ -5795,6 +5812,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
         "queue-safety-limit": "queue-safety-limit";
+        "query-variant-limit": "query-variant-limit";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -6066,6 +6084,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
           source: z.ZodEnum<{
             environment: "environment";
             "playwright-cache": "playwright-cache";
+            "agent-browser-cache": "agent-browser-cache";
             system: "system";
           }>;
           product: z.ZodString;
@@ -7110,6 +7129,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "memory-pressure": "memory-pressure";
         "off-origin": "off-origin";
         "queue-safety-limit": "queue-safety-limit";
+        "query-variant-limit": "query-variant-limit";
         "robots-uncertain": "robots-uncertain";
         "legacy-unclassified": "legacy-unclassified";
       }>;
@@ -7381,6 +7401,7 @@ export declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
           source: z.ZodEnum<{
             environment: "environment";
             "playwright-cache": "playwright-cache";
+            "agent-browser-cache": "agent-browser-cache";
             system: "system";
           }>;
           product: z.ZodString;
@@ -8427,6 +8448,7 @@ export declare const crawlerSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -8698,6 +8720,7 @@ export declare const crawlerSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -9742,6 +9765,7 @@ export declare const crawlerSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -10013,6 +10037,7 @@ export declare const crawlerSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -11057,6 +11082,7 @@ export declare const crawlerSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -11328,6 +11354,7 @@ export declare const crawlerSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -12767,6 +12794,7 @@ export declare const crawlerSchemas: {
           source: z.ZodEnum<{
             environment: "environment";
             "playwright-cache": "playwright-cache";
+            "agent-browser-cache": "agent-browser-cache";
             system: "system";
           }>;
           product: z.ZodString;
@@ -13300,6 +13328,7 @@ export declare const crawlerJsonSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -13571,6 +13600,7 @@ export declare const crawlerJsonSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -14615,6 +14645,7 @@ export declare const crawlerJsonSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -14886,6 +14917,7 @@ export declare const crawlerJsonSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -15930,6 +15962,7 @@ export declare const crawlerJsonSchemas: {
           "memory-pressure": "memory-pressure";
           "off-origin": "off-origin";
           "queue-safety-limit": "queue-safety-limit";
+          "query-variant-limit": "query-variant-limit";
           "robots-uncertain": "robots-uncertain";
           "legacy-unclassified": "legacy-unclassified";
         }>;
@@ -16201,6 +16234,7 @@ export declare const crawlerJsonSchemas: {
             source: z.ZodEnum<{
               environment: "environment";
               "playwright-cache": "playwright-cache";
+              "agent-browser-cache": "agent-browser-cache";
               system: "system";
             }>;
             product: z.ZodString;
@@ -17640,6 +17674,7 @@ export declare const crawlerJsonSchemas: {
           source: z.ZodEnum<{
             environment: "environment";
             "playwright-cache": "playwright-cache";
+            "agent-browser-cache": "agent-browser-cache";
             system: "system";
           }>;
           product: z.ZodString;
@@ -18056,12 +18091,12 @@ export declare const providerPackageNameSchema: z.ZodString;
 export declare const providerExactVersionSchema: z.ZodString;
 export declare const providerIntegritySchema: z.ZodString;
 export declare const providerKindSchema: z.ZodEnum<{
+  "local-search": "local-search";
   "traffic-analytics": "traffic-analytics";
   "search-results": "search-results";
   "keyword-data": "keyword-data";
   "domain-data": "domain-data";
   "link-data": "link-data";
-  "local-search": "local-search";
   "ai-data": "ai-data";
   other: "other";
 }>;
@@ -18104,12 +18139,12 @@ export declare const providerRegistrationSchema: z.ZodObject<{
   displayName: z.ZodString;
   description: z.ZodString;
   kinds: z.ZodArray<z.ZodEnum<{
+    "local-search": "local-search";
     "traffic-analytics": "traffic-analytics";
     "search-results": "search-results";
     "keyword-data": "keyword-data";
     "domain-data": "domain-data";
     "link-data": "link-data";
-    "local-search": "local-search";
     "ai-data": "ai-data";
     other: "other";
   }>>;
@@ -18174,10 +18209,9 @@ export declare const providerIdSchema: z.ZodString;
 export type ProviderId = z.infer<typeof providerIdSchema>;
 export type ExternalServiceId = string;
 export declare const providerCapabilitySchema: z.ZodEnum<{
-  "local-search": "local-search";
-  "serp-snapshot": "serp-snapshot";
   "keyword-metrics": "keyword-metrics";
   "keyword-discovery": "keyword-discovery";
+  "serp-snapshot": "serp-snapshot";
   "domain-overview": "domain-overview";
   "ranked-keywords": "ranked-keywords";
   "relevant-pages": "relevant-pages";
@@ -18186,6 +18220,7 @@ export declare const providerCapabilitySchema: z.ZodEnum<{
   "referring-domains": "referring-domains";
   backlinks: "backlinks";
   "domain-rating": "domain-rating";
+  "local-search": "local-search";
   "ai-mentions": "ai-mentions";
   "ai-prompt-observation": "ai-prompt-observation";
 }>;
@@ -21616,6 +21651,7 @@ type WeekSite = {
     previous: number;
   } | null;
   opportunities?: WeekOpportunities | null;
+  google_updates?: WeekGoogleUpdate[];
   measured?: {
     total: number;
     items: (IssueMeasure & {
@@ -21653,6 +21689,18 @@ type WeekData = {
   account: string;
   sites: WeekSite[];
 };
+type WeekGoogleUpdate = {
+  name: string;
+  start: string;
+  end: string | null;
+  ready: boolean;
+  result: {
+    verdict: 'within-normal' | 'outside-normal' | 'not-enough-data';
+    clicks: number;
+    previous: number;
+    days: number;
+  } | null;
+};
 export declare const CLOUD_URL = "https://seoskill.dev";
 type Pending = {
   device: string;