@nuxtseo/cli 0.5.7 → 0.5.8

package/dist/commands.js

@@ -9,7 +9,7 @@ import { EXIT_CODE, fail, fromSdkFailure, ok } from './failures.js';
 import { awaitPairingApproval, createCliPairingClient, startPairing } from './pairing.js';
 import { parseAbsolutePageUrl, parseChoice, parseInteger, parsePageUrlOrPath, parseRatio } from './parse.js';
 import { PULL_PERIODS, runPull } from './pull.js';
-import { renderAccountToken, renderAction, renderActionDismissal, renderActionResolution, renderActions, renderAnalytics, renderAnnotation, renderAnnotationDeleted, renderAnnotations, renderAuditChanges, renderBacklinkAnchors, renderBacklinksHistory, renderBacklinksSummary, renderContentDecay, renderDomainAvailability, renderDomainTraffic, renderDuplicateClusters, renderFieldVitalFindings, renderFieldVitals, renderIndexCohorts, renderIndexingDiagnostics, renderIndexingHistory, renderKeywordResearch, renderLinkOpportunities, renderLinkStructure, renderMentions, renderMonitoredPages, renderPageInspection, renderPageIssues, renderPageScan, renderPerformance, renderRankingsResearch, renderRecoverableBacklinks, renderReferringDomains, renderResearchOverview, renderScanDetail, renderScans, renderSearchAnalytics, renderSearchStatus, renderSerpResearch, renderSitemapAction, renderSitemaps, renderSitemapUrls, renderSites, renderSiteStatus, renderTimeline, renderUrlInspection, renderUrlInspectionRefresh, renderUsage, } from './render.js';
+import { renderAccountToken, renderAction, renderActionDismissal, renderActionResolution, renderActions, renderAnalytics, renderAnnotation, renderAnnotationDeleted, renderAnnotations, renderAuditChanges, renderBacklinkAnchors, renderBacklinksHistory, renderBacklinksSummary, renderContentDecay, renderDomainAvailability, renderDomainTraffic, renderDuplicateClusters, renderFieldVitalFindings, renderFieldVitals, renderIndexCohorts, renderIndexingDiagnostics, renderIndexingHistory, renderIndexingWatches, renderKeywordResearch, renderLinkOpportunities, renderLinkStructure, renderMentions, renderMonitoredPages, renderPageInspection, renderPageIssues, renderPageScan, renderPerformance, renderRankingsResearch, renderRecoverableBacklinks, renderReferringDomains, renderResearchOverview, renderScanDetail, renderScans, renderSearchAnalytics, renderSearchStatus, renderSerpResearch, renderSitemapAction, renderSitemapEvidence, renderSitemaps, renderSitemapSubmission, renderSitemapUrls, renderSites, renderSiteStatus, renderTimeline, renderUrlInspection, renderUrlInspectionRefresh, renderUsage, } from './render.js';
 import { writeCliResponse, writeDiagnostic, writeOutput, writeProtocolResponse } from './runtime.js';
 import { resolveSite } from './site.js';
 import { installSkill, SKILL_AGENTS } from './skill.js';
@@ -1010,6 +1010,54 @@ async function sitemapsList(runtime, globals) {
     }, { signal: runtime.requestSignal }));
     return present(runtime, globals, response, value => renderSitemaps(value.data));
 }
+async function sitemapsSubmission(runtime, globals) {
+    const resolved = await apiAndSite(runtime, globals);
+    if (resolved._tag === 'Err')
+        return resolved;
+    const response = await withSpinner(runtime, 'Loading Sitemap submission', () => resolved.value.api.client.sitemaps.readSubmission({
+        params: { siteId: resolved.value.siteId },
+    }, { signal: runtime.requestSignal }));
+    return present(runtime, globals, response, value => renderSitemapSubmission(value.data));
+}
+async function searchWatches(runtime, globals) {
+    const resolved = await apiAndSite(runtime, globals);
+    if (resolved._tag === 'Err')
+        return resolved;
+    const response = await withSpinner(runtime, 'Loading Watched URLs', () => resolved.value.api.client.search.listWatches({
+        params: { siteId: resolved.value.siteId },
+    }, { signal: runtime.requestSignal }));
+    return present(runtime, globals, response, value => renderIndexingWatches(value.data));
+}
+async function sitemapsInspect(runtime, globals, rawUrl, engine) {
+    const url = parseAbsolutePageUrl(rawUrl);
+    if (url._tag === 'Err')
+        return url;
+    const resolved = await apiAndSite(runtime, globals);
+    if (resolved._tag === 'Err')
+        return resolved;
+    const response = await withSpinner(runtime, 'Reading Sitemap evidence', () => resolved.value.api.client.sitemaps.inspect({
+        params: { siteId: resolved.value.siteId },
+        query: { url: url.value, searchEngine: engine },
+    }, { signal: runtime.requestSignal }));
+    if (response._tag === 'Err')
+        return fromSdkFailure(response.error);
+    if (response.value.data.state._tag === 'unavailable') {
+        const { reason } = response.value.data.state;
+        const exitCode = reason === 'throttled' || reason === 'provider-unavailable'
+            ? EXIT_CODE.retryable
+            : reason === 'grant-missing' || reason === 'reauthorization-required'
+                ? EXIT_CODE.authentication
+                : reason === 'permission-lost' || reason === 'not-enabled'
+                    ? EXIT_CODE.authorization
+                    : EXIT_CODE.conflict;
+        const incomplete = fail(exitCode, `Sitemap evidence is unavailable: ${reason}.`);
+        if (globals.json)
+            return { _tag: 'Err', error: { ...incomplete.error, protocolResponse: response.value } };
+        writeOutput(runtime, renderSitemapEvidence(response.value.data));
+        return incomplete;
+    }
+    return present(runtime, globals, response, value => renderSitemapEvidence(value.data));
+}
 async function sitemapsUrls(runtime, globals, args) {
     const limit = parseInteger(args.limit, { name: '--limit', minimum: 1, maximum: 1000, defaultValue: 500 });
     if (limit._tag === 'Err')
@@ -2042,6 +2090,10 @@ export function createRootCommand(runtime, globals, execution) {
     const search = defineCommand({
         meta: { name: 'search', description: 'Read Search Console state' },
         subCommands: {
+            'watches': defineCommand({
+                meta: { name: 'watches', description: 'Read Watched URLs and retained Checkpoints' },
+                run: ({ args }) => capture(execution, () => searchWatches(runtime, globals), args._, 0)(),
+            }),
             'status': defineCommand({
                 meta: { name: 'status', description: 'Read the stored Search Console connection' },
                 run: ({ args }) => capture(execution, () => searchStatus(runtime, globals), args._, 0)(),
@@ -2149,6 +2201,18 @@ export function createRootCommand(runtime, globals, execution) {
     const sitemaps = defineCommand({
         meta: { name: 'sitemaps', description: 'Read and manage Search Console sitemaps' },
         subCommands: {
+            submission: defineCommand({
+                meta: { name: 'submission', description: 'Read site-level Google Sitemap submission readiness' },
+                run: ({ args }) => capture(execution, () => sitemapsSubmission(runtime, globals), args._, 0)(),
+            }),
+            inspect: defineCommand({
+                meta: { name: 'inspect', description: 'Read exact Sitemap listing evidence' },
+                args: {
+                    url: positional('sitemap-url', 'Absolute Sitemap URL'),
+                    engine: { type: 'enum', options: ['google', 'bing'], default: 'google', description: 'Google live or Bing stored evidence' },
+                },
+                run: ({ args }) => capture(execution, () => sitemapsInspect(runtime, globals, args.url, args.engine), args._, 1)(),
+            }),
             list: defineCommand({
                 meta: { name: 'list', description: 'List the sitemaps Search Console knows' },
                 run: ({ args }) => capture(execution, () => sitemapsList(runtime, globals), args._, 0)(),

package/dist/render.d.ts

@@ -4,11 +4,11 @@ import type { ActionDismiss, ActionList, ActionResolve, ActionShow } from '@nuxt
 import type { AnalyticsQueryData, AnalyticsView } from '@nuxtseo/protocol/v1/analytics';
 import type { AuditChanges, AuditContentDecay, AuditDuplicateClusters, AuditLinkOpportunities, AuditLinkStructure } from '@nuxtseo/protocol/v1/audit';
 import type { BacklinkAnchorsData, BacklinksHistory, BacklinksSummaryData, MentionsData, RecoverableBacklinksData, ReferringDomainsData } from '@nuxtseo/protocol/v1/backlinks';
-import type { IndexCohorts, IndexingDiagnosticsData, IndexingHistoryData, SearchAnalyticsData, SearchStatusData, UrlInspectionData, UrlInspectionRefreshData } from '@nuxtseo/protocol/v1/gsc';
+import type { IndexCohorts, IndexingDiagnosticsData, IndexingHistoryData, IndexingWatchesData, SearchAnalyticsData, SearchStatusData, UrlInspectionData, UrlInspectionRefreshData } from '@nuxtseo/protocol/v1/gsc';
 import type { PageInspectData, PageIssues, PageScan } from '@nuxtseo/protocol/v1/pages';
 import type { FieldVitalFindings, FieldVitals, MonitoredPages, PerformanceScanDetail, PerformanceScans, SitePerformanceOverview } from '@nuxtseo/protocol/v1/performance';
 import type { DomainAvailability, DomainTraffic, KeywordResearchData, RankingsResearchData, SerpResearchData, StoredResearchOverview } from '@nuxtseo/protocol/v1/research';
-import type { SiteSitemapActionResponse, SiteSitemapsResponse, SiteSitemapUrlsResponse } from '@nuxtseo/protocol/v1/sitemaps';
+import type { SiteSitemapActionResponse, SiteSitemapEvidenceData, SiteSitemapsResponse, SiteSitemapSubmissionData, SiteSitemapUrlsResponse } from '@nuxtseo/protocol/v1/sitemaps';
 import type { Annotation, AnnotationDeleted, Annotations, TimelineEntries } from '@nuxtseo/protocol/v1/timeline';
 export declare function renderSites(response: SitesListResponse, selectedSiteId?: string): string;
 export declare function renderUsage(response: AccountUsageResponse): string;
@@ -25,6 +25,9 @@ export declare function renderUrlInspectionRefresh(data: UrlInspectionRefreshDat
 export declare function renderUrlInspection(data: UrlInspectionData): string;
 export declare function renderAuditChanges(data: AuditChanges): string;
 export declare function renderLinkStructure(data: AuditLinkStructure): string;
+export declare function renderSitemapSubmission(data: SiteSitemapSubmissionData): string;
+export declare function renderSitemapEvidence(data: SiteSitemapEvidenceData): string;
+export declare function renderIndexingWatches(data: IndexingWatchesData): string;
 export declare function renderSitemaps(data: SiteSitemapsResponse['data']): string;
 export declare function renderSitemapUrls(data: SiteSitemapUrlsResponse['data']): string;
 export declare function renderSitemapAction(data: SiteSitemapActionResponse['data']): string;

package/dist/render.js

@@ -348,6 +348,23 @@ export function renderLinkStructure(data) {
         ];
     return [header, ...slots, ...deadEnds, ...anchors].join('\n');
 }
+export function renderSitemapSubmission(data) {
+    return `Google Sitemap submission: ${data.state._tag}\n${JSON.stringify(data.state, null, 2)}\nCan act: ${data.callerCanAct}`;
+}
+export function renderSitemapEvidence(data) {
+    return [
+        `${data.searchEngine} Sitemap: ${data.sitemapUrl}`,
+        `State: ${data.state._tag}`,
+        data.capture._tag === 'captured' ? `Capture: ${data.capture.source} at ${data.capture.capturedAt}` : 'Capture: unavailable',
+        JSON.stringify(data.state, null, 2),
+    ].join('\n');
+}
+export function renderIndexingWatches(data) {
+    return [
+        `Watched URLs: ${data.watched.length}/${data.limit}. Cadence: ${data.cadenceDays} days.`,
+        ...data.watched.map(watch => `${watch.url}\n  Due: ${watch.dueAt}\n  Checkpoints: ${JSON.stringify(watch.checkpoints)}`),
+    ].join('\n');
+}
 export function renderSitemaps(data) {
     if (data.sitemaps.length === 0)
         return `No sitemaps are known for ${data.meta.siteUrl}.`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuxtseo/cli",
   "type": "module",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "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.7",
-    "@nuxtseo/sdk": "^0.5.7",
+    "@nuxtseo/protocol": "^0.5.8",
+    "@nuxtseo/sdk": "^0.5.8",
     "citty": "^0.2.2",
     "pathe": "^2.0.3"
   },

package/skills/nuxtseo-cli/SKILL.md

@@ -17,7 +17,7 @@ Read the matching file before you act on its subject:
 | --- | --- |
 | [references/commands.md](references/commands.md) | use a flag, range, or default. Never guess a flag |
 | [references/protocol.md](references/protocol.md) | parse output, page through a list, or handle an exit code |
-| [references/indexing.md](references/indexing.md) | report an indexed count or name indexed URLs |
+| [references/indexing.md](references/indexing.md) | interpret indexing, Sitemap evidence, or Watched URLs |
 
 ## Setup
 

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

@@ -198,6 +198,9 @@ The monitored Page then follows its own recurring schedule.
 | `search inspect <url>` | Latest retained Google URL Inspection for one URL. Takes an absolute URL or a site-relative path. `--fresh --yes` requests Google URL Inspection through the Site connection and uses inspection quota. Errors or skipped URLs produce a nonzero exit code |
 | `search cohorts` | Not-indexed rate per route family. Returns `analysed: false` when the not-indexed list is a sample (`reason: sampled-index-state`). `--limit 1..50` (default 12), `--min-pages 1..500` (default 5). Paused Sites exit `4` or `5`. Removed Sites return `not_found` with exit `8` |
 | `sitemaps list` | Search Console sitemap snapshot: errors, warnings, URL counts, sync status |
+| `sitemaps submission` | Site-level Google Sitemap submission state. Redacts account identity. Does not prove listing for an arbitrary Sitemap URL |
+| `sitemaps inspect <sitemap-url>` | Exact Sitemap listing evidence. `--engine google\|bing` defaults to `google`. Google reads live. Bing reads dated stored data. Missing exits `0`; unavailable exits `3`, `4`, `5`, or `6` |
+| `search watches` | Retained Watched URLs, `dueAt`, and Checkpoints. An empty Checkpoint list means no retained Checkpoint for that watch |
 | `sitemaps urls` | Sitemap URL membership. `--generation-id`, `--feedpath`, `--cursor`, `--limit 1..1000` |
 | `sitemaps submit <sitemap-url>` | Mutation. Submits one sitemap through the Site's stored Search Console credential. Success means Search Console accepted it, not that Google downloaded it. Read `lastDownloaded` and `isPending` in `sitemaps list` |
 | `sitemaps delete <sitemap-url>` | Mutation. Removes one sitemap through the Site's stored Search Console credential |

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

@@ -65,4 +65,19 @@ Keep these reads separate:
 | Which URLs appeared in the current period? | `search analytics pages` | Rows with `impressions > 0`, then each `url` |
 | What did Google say at the last inspection? | `search inspect <url>` | The retained verdict and inspection date |
 | What does Google say about one URL now? | `search inspect <url>` | Add `--fresh --yes`. Report fresh results, quota, and explicit errors or skipped URLs |
-| Which URLs did the Site submit? | `sitemaps list`, then `sitemaps urls` | Sitemap totals and membership |
+| Which URLs belong to the Sitemap generation? | `sitemaps list`, then `sitemaps urls` | Sitemap totals and retained membership |
+| Does a provider list this exact Sitemap URL? | `sitemaps inspect <sitemap-url>` | `state`, `capture.source`, and `capture.capturedAt` |
+| Can the Site submit its selected Google Sitemap? | `sitemaps submission` | Site-level `state` and `callerCanAct` |
+| What checks exist for Watched URLs? | `search watches` | Each URL's `dueAt` and retained Checkpoints |
+
+`sitemaps inspect` uses `--engine google` by default. Use `--engine bing` for Bing's stored evidence.
+Google reads live. Bing reports its stored capture time; it does not make a live provider request.
+`state._tag: missing` proves absence only within that successful dated read.
+`state._tag: unavailable` provides no listing conclusion and produces a nonzero exit.
+Grant or reauthorization failures exit `3`. Permission loss or disabled access exits `4`.
+Unverified or unchecked evidence exits `5`. Throttling or provider failure exits `6`.
+The JSON response preserves the evidence with these failures.
+
+Watched URL due times describe scheduling. They do not prove that checks can run.
+An empty Checkpoint list means no retained Checkpoint for that watch.
+Neither Sitemap listing nor Watched URL enrollment proves that Google indexed a Page.

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

@@ -135,6 +135,9 @@ command returns; never guess a chain. Verified against the response schemas.
 | `search index-history` | `data.changes` | none |
 | `search cohorts` | `data.established` and `data.ranked` | `data.rankedTotal` |
 | `sitemaps list` | `data.sitemaps` | none |
+| `sitemaps submission` | no list; `data.state` | none |
+| `sitemaps inspect` | no list; `data.capture`, `data.state` | none |
+| `search watches` | `data.watched`; each item's `checkpoints` | none |
 | `sitemaps urls` | `data.items` | `data.page.nextCursor`, `data.page.limit` |
 | `audit content-decay` | `data.rows` | `data.page`; `data.total`, `data.truncated` |
 | `audit link-opportunities` | `data.rows` | `data.page`; `data.total` |