gsc-cli 2.2.2 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab180fed2f9ef6a48d37dd386354f989bc28754efed1ab80d266376663508758
-  data.tar.gz: e6da57a476597d37e570d8fabd2853fbbec7b06d26be4fcf1c2fb6dee3de6627
+  metadata.gz: c6cfd0972501711b114e27b2a286612efcfe85bd51aaf91947bc44b8fdfd9aff
+  data.tar.gz: 5bd6e630844f13a3115bbb4c54deda04f7f3e1585c79ac4d9037dd7c216d02a1
 SHA512:
-  metadata.gz: 44f6b7a4bb0a9234cc55cf106454bca07bafa45f6137cbb34a159ca4641f7b2e2733313480730f65168444332b8b52d617051f98582c408e53373a12dd81323b
-  data.tar.gz: bf58ea4760ab212945846dabcddbb75e65e3c3a482c86d6ec34b2ecf4480b89a3aaa16b0810c5b84b61d31624ed1c6990aaa44503fc4fbac19551d0d5e52908c
+  metadata.gz: ab41e83aa4f41ca0d296218f288cb2291275c893cf60347d6cbc7083371430e06feebf00aa084d5c5978fd0bd0bd5a35f29a1beaf5839f322f2efc629bf38429
+  data.tar.gz: 50ea5330dee9bae3b09570be862e69c3b4ec5e1aafc7126525bdd2dbe1a894c2392204749b5c7f187d32c0273530cc55f6ba66599502068b8870f1a7bdcd3f6b

data/AUTH.md

@@ -96,23 +96,50 @@ export GA4_PROPERTY_ID=123456789
 
 Audit official mobile and desktop Lighthouse scores and 75th percentile Chrome User Experience Report (CrUX) metrics (LCP, INP, CLS, FCP, TTFB).
 
-### Unauthenticated Mode (Default)
-`gsc speed` works immediately with **zero configuration** for normal development auditing:
-```bash
-gsc speed https://example.com
-```
-
-### High-Throughput Mode (Optional Free API Key)
-If you run high-frequency batch audits in CI/CD pipelines (up to 25,000 queries/day free):
-1. In Google Cloud Console, enable **PageSpeed Insights API**.
-2. Go to **APIs & Services > Credentials** > **Create Credentials** > **API Key**.
-3. Save the key:
-```bash
-gsc config set pagespeed_api_key AIzaSyYourKeyHere
-
-# Or pass as environment variable
-export PAGESPEED_API_KEY=AIzaSyYourKeyHere
-```
+### Understanding Lab vs. Field (CrUX) Data:
+* **🔬 Lighthouse Lab Data (Synthetic Simulation):** Evaluated instantaneously in a headless Chrome environment under fixed 4G mobile or desktop throttling. Ideal for immediate debugging and identifying optimization opportunities (LCP, FCP, CLS, TBT, Speed Index).
+* **🌐 CrUX Field Data (28-Day Real User Monitoring):** Aggregated 75th percentile measurements collected from real Google Chrome users over a rolling 28-day window. This is the **actual telemetry Google Search uses for Core Web Vitals ranking signals** (LCP, INP, CLS, FCP, TTFB).
+* **Traffic Thresholds:** For new or low-traffic pages, Google does not have enough real-user Chrome sessions to publish CrUX data. In those cases, `gsc speed` automatically displays the instantaneous Lighthouse Lab audit and flags that CrUX field data is pending sufficient 28-day visitor volume.
+
+> 💡 **Why an API Key is Recommended:**  
+> While Google technically permits unauthenticated queries, Google's public unauthenticated IP pool frequently hits `429 Quota Exceeded (RESOURCE_EXHAUSTED)`. Generating a personal API key in Google Cloud gives you **25,000 queries per day at $0 cost**.
+
+### 1-Minute API Key Setup
+
+1. **Enable the API:**
+   * Open [Google Cloud Console: PageSpeed Insights API](https://console.cloud.google.com/apis/library/pagespeedonline.googleapis.com).
+   * Ensure your active project is selected in the top bar.
+   * Click **Enable** (if not already enabled, Google will return a `403 SERVICE_DISABLED` error).
+
+2. **Create the API Key:**
+   * In the left sidebar, navigate to **APIs & Services > Credentials**.
+   * Click **+ Create Credentials** at the top → select **API Key**.
+   * In the side panel:
+     * **Name:** `gsc-pagespeed-key` (or default `API key 1`).
+     * **Application restrictions:** Keep **None** (since `gsc` is a local command-line tool).
+     * **API restrictions:** (Optional) Select **Restrict key** → check **PageSpeed Insights API**.
+     * Click the blue **Create** button.
+   * Copy the generated key (`AIzaSy...`).
+
+3. **Save Your Key:**
+   ```bash
+   gsc config set pagespeed_api_key AIzaSyYourKeyHere
+
+   # Or pass as environment variable
+   export PAGESPEED_API_KEY=AIzaSyYourKeyHere
+   ```
+
+4. **Run Speed Audits:**
+   ```bash
+   # Mobile Core Web Vitals (Default)
+   gsc speed https://example.com
+
+   # Desktop Core Web Vitals
+   gsc speed https://example.com --strategy desktop
+
+   # Correlate CWV with Google Search Console traffic
+   gsc speed-correlate https://example.com
+   ```
 
 ---
 

data/README.md

@@ -100,6 +100,7 @@ By implementing Google's JWT service account authentication in pure `OpenSSL` an
 - 🛡️ **Cannibalization & Decay Detection (`gsc cannibalization`, `gsc decay`)**: Spot internal URLs fighting for the same queries, and compare 28-day period-over-period traffic trends.
 - 📊 **Google Analytics 4 (GA4) Behavioral Link (`gsc realtime`, `gsc ga4`)**: Stream live active visitors and correlate SERP rankings with landing page bounce rates.
 - 🕷️ **Autonomous Site Audit & Broken Link Repair (`gsc site-audit`)**: Crawls all sitemap URLs, checks HTTP response codes for dead internal links (404/500/timeouts), audits missing image alts and heading defects, and exports an AI-actionable Markdown fix sprint.
+- ⚡ **Dual Lab & Field Core Web Vitals (`gsc speed` & `gsc speed-correlate`)**: Audits simulated Lighthouse Lab metrics (LCP, FCP, CLS, TBT, Speed Index) alongside official 28-day Chrome User Experience Report (CrUX) Real User Monitoring (RUM) field data (LCP, INP, CLS, FCP, TTFB) and correlates page speed directly with organic GSC search rankings.
 - 🤖 **AI Agent Native**: Every single command supports `--compact`, `--ndjson`, and `--json` for instantaneous programmatic consumption by AI agents.
 
 ---
@@ -465,7 +466,7 @@ gsc use 2
 | `gsc report` | — | Executive 360° Health Scorecard with letter grade and sparklines | `--days`, `--sparkline`, `--json` |
 | `gsc page <url>` | — | Detailed On-Page DOM audit (meta, headings, alts, schema) + GSC performance | `--check-links`, `--json` |
 | `gsc site-audit <sitemap>`| — | Crawls sitemaps, tests 404 dead links, audits DOM flaws, and outputs fix sprint | `--report <file>`, `--json` |
-| `gsc speed <url>` | `vitals` | Official Core Web Vitals via PageSpeed Insights (LCP, INP, CLS, TTFB) | `--strategy mobile|desktop`, `--json` |
+| `gsc speed <url>` | `vitals` | Dual Lab (Lighthouse) & Field (CrUX 28-day RUM) Core Web Vitals (LCP, INP, CLS, TTFB) | `--strategy mobile|desktop`, `--json` |
 | `gsc speed-correlate` | `sc-perf` | Correlates Core Web Vitals page speed with GSC organic rankings | `--days`, `--strategy`, `--json` |
 | `gsc canonical-chains` | `chains` | Canonical redirect loops and multi-hop chain detector | `--limit`, `--json` |
 | `gsc low-ctr` | — | High-impression low-CTR title & meta description rewriter | `--limit`, `--min-imp`, `--json` |

data/bin/gsc

@@ -3,7 +3,7 @@
 
 # ==============================================================================
 # Google Search Console & Indexing API CLI Tool (Pure Ruby - Zero Gem Dependencies)
-# Standalone Single-File Distribution (Built from lib/gsc v2.2.2)
+# Standalone Single-File Distribution (Built from lib/gsc v2.2.3)
 # ==============================================================================
 
 require 'net/http'
@@ -20,7 +20,7 @@ require 'stringio'
 
 # --- version.rb ---
 module GSC
-  VERSION = '2.2.2'
+  VERSION = '2.2.3'
 end
 
 # --- color.rb ---
@@ -3116,9 +3116,9 @@ module GSC
 
       uri = URI("#{API_URL}?#{query_params.join('&')}")
       req = Net::HTTP::Get.new(uri)
-      req['User-Agent'] = 'gsc-cli/2.1'
+      req['User-Agent'] = "gsc-cli/#{GSC::VERSION}"
 
-      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 15, read_timeout: 60) do |http|
         http.request(req)
       end
 
@@ -3152,16 +3152,28 @@ module GSC
       tbt = audits.dig('total-blocking-time', 'displayValue')
       si  = audits.dig('speed-index', 'displayValue')
 
-      # CrUX Field Data (if available)
+      # CrUX Field Data (URL or Origin fallback if available)
       crux_metrics = {}
+      crux_source = nil
       crux = data.dig('loadingExperience', 'metrics') || {}
-      crux.each do |k, v|
-        crux_metrics[k] = {
-          percentile: v['percentile'],
-          category: v['category']
-        }
+      if crux && !crux.empty?
+        crux_source = :url
+      else
+        crux = data.dig('originLoadingExperience', 'metrics') || {}
+        crux_source = :origin unless crux.empty?
       end
 
+      if crux && !crux.empty?
+        crux.each do |k, v|
+          crux_metrics[k] = {
+            percentile: v['percentile'],
+            category: v['category']
+          }
+        end
+      end
+
+      overall_category = data.dig('loadingExperience', 'overall_category') || data.dig('originLoadingExperience', 'overall_category')
+
       # Opportunities
       opportunities = []
       audits.each do |k, v|
@@ -3191,6 +3203,8 @@ module GSC
           speed_index: si
         },
         field_data: crux_metrics,
+        field_source: crux_source,
+        overall_category: overall_category,
         opportunities: opportunities.first(5)
       }
     end
@@ -22833,13 +22847,61 @@ module GSC
         puts "╚══════════════════════════════════════════════════════════════╝"
 
         m = data[:metrics] || {}
-        puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+        puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
         puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
         puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
         puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
         puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
         puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+        fd = data[:field_data] || {}
+        if fd.any?
+          source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+          overall = data[:overall_category] || "UNKNOWN"
+          overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+          puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+          if fd['LARGEST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['INTERACTION_TO_NEXT_PAINT']
+            val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+            cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+            val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+            cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['FIRST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+            val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+            cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+        else
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+          puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+          puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+        end
+
         opps = data[:opportunities] || []
         unless opps.empty?
           puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"
@@ -29944,13 +30006,61 @@ module GSC
       puts "╚══════════════════════════════════════════════════════════════╝"
 
       m = data[:metrics] || {}
-      puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+      puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
       puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
       puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
       puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
       puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
       puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+      fd = data[:field_data] || {}
+      if fd.any?
+        source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+        overall = data[:overall_category] || "UNKNOWN"
+        overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+        puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+        if fd['LARGEST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['INTERACTION_TO_NEXT_PAINT']
+          val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+          cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+          val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+          cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['FIRST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+          val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+          cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+      else
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+        puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+        puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+      end
+
       opps = data[:opportunities] || []
       unless opps.empty?
         puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"

data/dist/gsc

@@ -3,7 +3,7 @@
 
 # ==============================================================================
 # Google Search Console & Indexing API CLI Tool (Pure Ruby - Zero Gem Dependencies)
-# Standalone Single-File Distribution (Built from lib/gsc v2.2.2)
+# Standalone Single-File Distribution (Built from lib/gsc v2.2.3)
 # ==============================================================================
 
 require 'net/http'
@@ -20,7 +20,7 @@ require 'stringio'
 
 # --- version.rb ---
 module GSC
-  VERSION = '2.2.2'
+  VERSION = '2.2.3'
 end
 
 # --- color.rb ---
@@ -3116,9 +3116,9 @@ module GSC
 
       uri = URI("#{API_URL}?#{query_params.join('&')}")
       req = Net::HTTP::Get.new(uri)
-      req['User-Agent'] = 'gsc-cli/2.1'
+      req['User-Agent'] = "gsc-cli/#{GSC::VERSION}"
 
-      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 15, read_timeout: 60) do |http|
         http.request(req)
       end
 
@@ -3152,16 +3152,28 @@ module GSC
       tbt = audits.dig('total-blocking-time', 'displayValue')
       si  = audits.dig('speed-index', 'displayValue')
 
-      # CrUX Field Data (if available)
+      # CrUX Field Data (URL or Origin fallback if available)
       crux_metrics = {}
+      crux_source = nil
       crux = data.dig('loadingExperience', 'metrics') || {}
-      crux.each do |k, v|
-        crux_metrics[k] = {
-          percentile: v['percentile'],
-          category: v['category']
-        }
+      if crux && !crux.empty?
+        crux_source = :url
+      else
+        crux = data.dig('originLoadingExperience', 'metrics') || {}
+        crux_source = :origin unless crux.empty?
       end
 
+      if crux && !crux.empty?
+        crux.each do |k, v|
+          crux_metrics[k] = {
+            percentile: v['percentile'],
+            category: v['category']
+          }
+        end
+      end
+
+      overall_category = data.dig('loadingExperience', 'overall_category') || data.dig('originLoadingExperience', 'overall_category')
+
       # Opportunities
       opportunities = []
       audits.each do |k, v|
@@ -3191,6 +3203,8 @@ module GSC
           speed_index: si
         },
         field_data: crux_metrics,
+        field_source: crux_source,
+        overall_category: overall_category,
         opportunities: opportunities.first(5)
       }
     end
@@ -22833,13 +22847,61 @@ module GSC
         puts "╚══════════════════════════════════════════════════════════════╝"
 
         m = data[:metrics] || {}
-        puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+        puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
         puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
         puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
         puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
         puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
         puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+        fd = data[:field_data] || {}
+        if fd.any?
+          source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+          overall = data[:overall_category] || "UNKNOWN"
+          overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+          puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+          if fd['LARGEST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['INTERACTION_TO_NEXT_PAINT']
+            val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+            cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+            val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+            cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['FIRST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+            val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+            cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+        else
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+          puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+          puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+        end
+
         opps = data[:opportunities] || []
         unless opps.empty?
           puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"
@@ -29944,13 +30006,61 @@ module GSC
       puts "╚══════════════════════════════════════════════════════════════╝"
 
       m = data[:metrics] || {}
-      puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+      puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
       puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
       puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
       puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
       puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
       puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+      fd = data[:field_data] || {}
+      if fd.any?
+        source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+        overall = data[:overall_category] || "UNKNOWN"
+        overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+        puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+        if fd['LARGEST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['INTERACTION_TO_NEXT_PAINT']
+          val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+          cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+          val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+          cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['FIRST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+          val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+          cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+      else
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+        puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+        puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+      end
+
       opps = data[:opportunities] || []
       unless opps.empty?
         puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"

data/lib/gsc/cli/audit.rb

@@ -160,13 +160,61 @@ module GSC
         puts "╚══════════════════════════════════════════════════════════════╝"
 
         m = data[:metrics] || {}
-        puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+        puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
         puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
         puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
         puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
         puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
         puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+        fd = data[:field_data] || {}
+        if fd.any?
+          source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+          overall = data[:overall_category] || "UNKNOWN"
+          overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+          puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+          if fd['LARGEST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['INTERACTION_TO_NEXT_PAINT']
+            val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+            cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+            val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+            cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['FIRST_CONTENTFUL_PAINT_MS']
+            val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+            cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+
+          if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+            val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+            cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+            col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+            puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+          end
+        else
+          puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+          puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+          puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+        end
+
         opps = data[:opportunities] || []
         unless opps.empty?
           puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"

data/lib/gsc/cli_advanced.rb

@@ -170,13 +170,61 @@ module GSC
       puts "╚══════════════════════════════════════════════════════════════╝"
 
       m = data[:metrics] || {}
-      puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+      puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
       puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
       puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
       puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
       puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
       puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+      fd = data[:field_data] || {}
+      if fd.any?
+        source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+        overall = data[:overall_category] || "UNKNOWN"
+        overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+        puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+        if fd['LARGEST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['INTERACTION_TO_NEXT_PAINT']
+          val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+          cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+          val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+          cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['FIRST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+          val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+          cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+      else
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+        puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+        puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+      end
+
       opps = data[:opportunities] || []
       unless opps.empty?
         puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"

data/lib/gsc/page_speed.rb

@@ -28,9 +28,9 @@ module GSC
 
       uri = URI("#{API_URL}?#{query_params.join('&')}")
       req = Net::HTTP::Get.new(uri)
-      req['User-Agent'] = 'gsc-cli/2.1'
+      req['User-Agent'] = "gsc-cli/#{GSC::VERSION}"
 
-      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 15, read_timeout: 60) do |http|
         http.request(req)
       end
 
@@ -64,16 +64,28 @@ module GSC
       tbt = audits.dig('total-blocking-time', 'displayValue')
       si  = audits.dig('speed-index', 'displayValue')
 
-      # CrUX Field Data (if available)
+      # CrUX Field Data (URL or Origin fallback if available)
       crux_metrics = {}
+      crux_source = nil
       crux = data.dig('loadingExperience', 'metrics') || {}
-      crux.each do |k, v|
-        crux_metrics[k] = {
-          percentile: v['percentile'],
-          category: v['category']
-        }
+      if crux && !crux.empty?
+        crux_source = :url
+      else
+        crux = data.dig('originLoadingExperience', 'metrics') || {}
+        crux_source = :origin unless crux.empty?
       end
 
+      if crux && !crux.empty?
+        crux.each do |k, v|
+          crux_metrics[k] = {
+            percentile: v['percentile'],
+            category: v['category']
+          }
+        end
+      end
+
+      overall_category = data.dig('loadingExperience', 'overall_category') || data.dig('originLoadingExperience', 'overall_category')
+
       # Opportunities
       opportunities = []
       audits.each do |k, v|
@@ -103,6 +115,8 @@ module GSC
           speed_index: si
         },
         field_data: crux_metrics,
+        field_source: crux_source,
+        overall_category: overall_category,
         opportunities: opportunities.first(5)
       }
     end

data/lib/gsc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GSC
-  VERSION = '2.2.2'
+  VERSION = '2.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gsc-cli
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.2.3
 platform: ruby
 authors:
 - ApollosWave LLC