@nuxtseo/cli 0.5.1 → 0.5.3

package/dist/pull.js

@@ -304,6 +304,7 @@ export async function runPull(runtime, globals, args, resolve, catalogue = PULL_
     const skipped = [];
     let stopped = false;
     let completed = 0;
+    let explainedAnalyticsConnection = false;
     await forEachBounded(operations, concurrency.value, async (candidate) => {
         if (stopped) {
             skipped.push(candidate.name);
@@ -318,6 +319,15 @@ export async function runPull(runtime, globals, args, resolve, catalogue = PULL_
         });
         const outcome = pullLine(candidate.name, result);
         writeProtocolResponse(runtime, outcome.line);
+        if (!explainedAnalyticsConnection
+            && candidate.name.startsWith('analytics ')
+            && result._tag === 'Err'
+            && result.error._tag === 'ApiFailure'
+            && result.error.code === 'conflict'
+            && result.error.details?.action === 'connect_web_analytics') {
+            explainedAnalyticsConnection = true;
+            writeDiagnostic(runtime, 'Web Analytics is not connected. Connect a property to read these views. For a full SEO pull, use --exclude analytics.');
+        }
         exitCodes.push(outcome.exitCode);
         completed++;
         // An expired or rejected credential fails every later read the same way.

package/dist/render.js

@@ -893,10 +893,26 @@ export function renderScanDetail(data) {
     ];
     if (data.lcpElement)
         blocks.push(`LCP element  ${data.lcpElement.selector ?? data.lcpElement.nodeLabel ?? 'unknown'}`);
-    if (data.performanceIssues.length) {
+    if (data.observedTrace?._tag === 'available') {
+        const trace = data.observedTrace;
         blocks.push([
-            `Wasteful assets (${data.performanceIssues.length})`,
-            ...data.performanceIssues.map(issue => `  ${issue.wastedMs ?? 0}ms  ${issue.wastedBytes ?? 0}b  ${issue.subtype ?? issue.type}  ${issue.url ?? ''}`.trimEnd()),
+            `Observed trace LCP  ${trace.observedLcpMs}ms  throttling ${trace.throttlingMethod}`,
+            ...trace.phases.map(phase => `  ${phase.id}  ${phase.durationMs}ms`),
+            'Trace phases describe observed LCP. Reported LCP can be simulated.',
+        ].join('\n'));
+    }
+    else {
+        blocks.push(`Observed trace unavailable  ${data.observedTrace?.reason ?? 'legacy-response'}`);
+    }
+    if (data.javascript) {
+        const bytes = (amount) => amount === null ? 'unknown' : `${amount}b`;
+        blocks.push(`JavaScript  ${bytes(data.javascript.transferBytes)} transferred  ${bytes(data.javascript.decodedBytes)} decoded  ${data.javascript.scriptCount ?? 'unknown'} resources`);
+    }
+    const waste = data.performanceIssues.filter(issue => issue.subtype !== 'js-transfer-weight');
+    if (waste.length) {
+        blocks.push([
+            `Wasteful assets (${waste.length})`,
+            ...waste.map(issue => `  ${issue.wastedMs ?? 0}ms  ${issue.wastedBytes ?? 0}b  ${issue.subtype ?? issue.type}  ${issue.url ?? ''}`.trimEnd()),
         ].join('\n'));
     }
     if (data.thirdParties.length) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuxtseo/cli",
   "type": "module",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Command line interface for the Nuxt SEO public API.",
   "license": "MIT",
   "homepage": "https://nuxtseo.com/pro",
@@ -33,8 +33,8 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.0",
-    "@nuxtseo/protocol": "^0.5.1",
-    "@nuxtseo/sdk": "^0.5.1",
+    "@nuxtseo/protocol": "^0.5.3",
+    "@nuxtseo/sdk": "^0.5.3",
     "citty": "^0.2.2",
     "pathe": "^2.0.3"
   },

package/skills/nuxtseo-cli/references/commands.md

@@ -138,9 +138,35 @@ lines.
 | `scans show <scan-id>` | One Scan, and the evidence behind its scores: wasteful assets, repeat-visit cache policy, third-party scripts, the LCP element, and every failing accessibility and best-practices check with its CSS selectors and DOM snippets. Read `coverage` before quoting a total |
 | `scans pages` | The Pages this Site scans on a schedule. Add one with `page scan <url>` |
 
+`scans show` can include `observedTrace` from the retained Lighthouse projection.
+If its tag is `available`, its phases describe `observedLcpMs` from the browser trace.
+`throttlingMethod` names how Lighthouse computed the reported metrics.
+With `simulate`, reported `lcp` is modeled. Observed trace phases do not partition that modeled value.
+With `devtools` or `provided`, Lighthouse uses observed metrics.
+Neither value is real-user field data.
+An `unavailable` tag names missing, invalid, or legacy evidence.
+Older servers can omit the field. Omission also means unavailable.
+This command never reads raw reports or starts a projection backfill.
+
 `page inspect` and `page scan` take an absolute URL, for example
 `https://example.com/about`.
 
+### JavaScript byte measurements
+
+`scans show` returns `data.javascript` with stored `transferBytes`, `decodedBytes`, and `scriptCount`.
+Each measurement is nullable. `javascript: null` means no stored JavaScript measurement.
+An older server may omit the field.
+
+The extractor counts JavaScript by resource type, MIME type, or `.js` / `.mjs` URL.
+It includes downloaded JavaScript labelled `Other`, which can include prefetch requests.
+The stored totals do not separate prefetch from executed JavaScript.
+They do not measure parse, compile, or execution work.
+
+For a `js-transfer-weight` diagnostic, `wastedBytes` holds total decoded JavaScript bytes.
+It is not removable code or Lighthouse unused-byte savings.
+Use `data.javascript` for byte comparisons, and `unused` findings for unused-byte evidence.
+Do not infer a reduction in executed JavaScript from download totals alone.
+
 `page scan` enables recurring monitoring.
 Read `scans pages` before scanning many new URLs. The server refuses a new
 Page when five monitored Pages are already enabled. That limit comes from