feat(searchconsole): add URL inspection and preserve API error codes

.agents/skills/gog-searchconsole/SKILL.md

@@ -28,6 +28,7 @@ gog --readonly --account user@example.com searchconsole --help
 
 | Command | Purpose |
 | --- | --- |
+| `inspect` | Inspect URL index status (URL Inspection API) |
 | `query` | Run a Search Analytics query |
 | `searchanalytics` | Search Analytics queries |
 | `sitemaps` | List/get/submit/delete sitemaps |

.agents/skills/gog-sheets/SKILL.md

@@ -41,6 +41,7 @@ gog --readonly --account user@example.com sheets get SHEET_ID 'Sheet1!A1:D20' --
 | `datasource` | Manage Connected Sheets data sources and extracts |
 | `delete-dimension` | Delete rows or columns while preserving intersecting tables |
 | `delete-tab` | Delete a tab/sheet from a spreadsheet (use --force to skip confirmation) |
+| `duplicate-tab` | Duplicate a tab within a spreadsheet |
 | `export` | Export a Google Sheet (pdf\|xlsx\|csv) via Drive |
 | `filter` | Manage basic filters |
 | `find-replace` | Find and replace text across a spreadsheet |

.agents/skills/gog-slides/SKILL.md

@@ -46,6 +46,7 @@ gog --readonly --account user@example.com slides --help
 | `locate` | Locate text in shapes and table cells with object IDs and UTF-16 ranges |
 | `move-slide` | Move a slide to a zero-based insertion index |
 | `new-slide` | Create a native themed slide |
+| `paragraph-style` | Set paragraph alignment, spacing, indentation, or direction |
 | `raw` | Dump raw Google Slides API response as JSON (Presentations.Get; lossless; for scripting and LLM consumption) |
 | `read-slide` | Read slide content: speaker notes, text elements, and images |
 | `replace-slide` | Replace an existing slide image from a local file or public URL |

.github/workflows/ci.yml

@@ -2,6 +2,8 @@ name: ci
 
 on:
   push:
+    branches:
+      - main
   pull_request:
 
 permissions:
@@ -34,8 +36,23 @@ jobs:
         run: make lint
       - name: Deadcode
         run: make deadcode
-      - name: Docs check
-        run: make docs-check
+      - name: Docs, skills, and Docker version checks
+        run: make docs-check agent-skills-check docker-version-check
+
+  minimum-go:
+    runs-on: ubuntu-latest
+    env:
+      GOTOOLCHAIN: local
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
+        with:
+          go-version: "1.26.8"
+          cache: true
+      - name: Test minimum supported Go series
+        run: go test ./...
+      - name: Build
+        run: go build ./cmd/gog
 
   worker:
     runs-on: ubuntu-latest
@@ -47,11 +64,13 @@ jobs:
       - name: Enable Corepack (pnpm)
         run: |
           corepack enable
-          corepack prepare pnpm@11.25.0 --activate
+          corepack prepare pnpm@11.26.0 --activate
       - name: Install dependencies
         run: pnpm -C internal/tracking/worker install --frozen-lockfile
       - name: Lint
         run: pnpm -C internal/tracking/worker lint
+      - name: Typecheck
+        run: pnpm -C internal/tracking/worker typecheck
       - name: Build
         run: pnpm -C internal/tracking/worker build
       - name: Test

CHANGELOG.md

@@ -1,6 +1,26 @@
 # Changelog
 
-## 0.39.2 - Unreleased
+## 0.40.1 - Unreleased
+
+- Search Console: add `searchconsole inspect` for per-URL index status via the URL Inspection API (coverage state, indexing/page-fetch/robots.txt state, canonical, sitemaps, last crawl time), using the existing `webmasters` OAuth scope. (#1094) — thanks @laihenyi.
+- Search Console: preserve permission-denied exit codes when adding API setup or scope guidance. (#1094)
+- Dependencies and CI: refresh Google protocol modules and tracking-worker tooling within release-age limits; test the Go 1.26 minimum, check worker types and generated skills, and avoid duplicate pull-request test runs. (#1131)
+
+## 0.40.0 - 2026-09-11
+
+**Highlights:** Preserve Slides styling, format paragraphs, and reuse cached Discovery documents; duplicate or inspect individual spreadsheet tabs and sort Drive files.
+
+- Slides: preserve leading text styling during `insert-text --replace`, including template inheritance, with revision protection and correct empty-target and UTF-16 handling. (#1111, #1122) — thanks @sebsnyk.
+- Slides: add `paragraph-style` for shape and table-cell alignment, spacing, indentation, and direction, with explicit field masks and zero-value support. (#1098, #1123) — thanks @sebsnyk.
+- API: cache Discovery documents for 24 hours with bounded disk usage, isolated endpoint/version keys, and explicit `--no-cache` bypass; keep API responses and authorization checks uncached. (#1106, #1121) — thanks @gurgeous.
+- Sheets: duplicate a tab within its spreadsheet, with an explicit destination name and optional insertion index. (#1102, #1116) — thanks @gurgeous.
+- Sheets: filter raw API reads by exact tab title with `--sheet`, including A1-like names and apostrophes, while retaining spreadsheet metadata and the grid-data opt-in. (#1104, #1115) — thanks @gurgeous.
+- Drive: add opt-in `ls --sort` and `--order` controls while preserving the existing modification-time default and native pagination. (#1105, #1117) — thanks @gurgeous.
+- Slides: delete several page elements in one guarded API batch, retain single-element output compatibility, and document replacing WordArt elements. (#1109) — thanks @sebsnyk.
+- Sheets: preserve zero-valued dimension indices so inserting before the first row or column succeeds. (#1107, #1114) — thanks @gurgeous.
+- Docs: replace the reserved `default` alias command with the account manager's **Set default** action and explain account-selection precedence. (#1092, #1093) — thanks @gianpaj and @goutamadwant.
+- Dependencies: refresh Go networking, authentication and cryptography modules and tracking-worker tooling, including the patched Sharp dependency, while retaining Go 1.26 compatibility and the worker's 24-hour release-age policy.
+- Tooling: refresh goimports and deadcode to x/tools v0.50.0 while retaining the Go 1.26 minimum. (#1120)
 
 ## 0.39.1 - 2026-09-05
 

Makefile

@@ -25,7 +25,7 @@ GOIMPORTS := $(TOOLS_DIR)/goimports
 GOLANGCI_LINT := $(TOOLS_DIR)/golangci-lint
 DEADCODE := $(TOOLS_DIR)/deadcode
 TOOLS_STAMP := $(TOOLS_DIR)/.versions
-TOOLS_VERSION := gofumpt=v0.11.0;goimports=v0.49.0;golangci-lint=v2.13.2;deadcode=v0.49.0
+TOOLS_VERSION := gofumpt=v0.11.0;goimports=v0.50.0;golangci-lint=v2.13.2;deadcode=v0.50.0
 
 # Allow passing CLI args as extra "targets":
 #   make gogcli -- --help
@@ -91,9 +91,9 @@ tools:
 	else \
 		set -e; \
 		GOBIN=$(TOOLS_DIR) go install mvdan.cc/gofumpt@v0.11.0; \
-		GOBIN=$(TOOLS_DIR) go install golang.org/x/tools/cmd/goimports@v0.49.0; \
+		GOBIN=$(TOOLS_DIR) go install golang.org/x/tools/cmd/goimports@v0.50.0; \
 		GOBIN=$(TOOLS_DIR) go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.13.2; \
-		GOBIN=$(TOOLS_DIR) go install golang.org/x/tools/cmd/deadcode@v0.49.0; \
+		GOBIN=$(TOOLS_DIR) go install golang.org/x/tools/cmd/deadcode@v0.50.0; \
 		printf '%s\n' "$(TOOLS_VERSION)" > "$(TOOLS_STAMP)"; \
 	fi
 
@@ -164,5 +164,6 @@ ci: pnpm-gate docker-version-check fmt-check lint deadcode test docs-check agent
 
 worker-ci:
 	@pnpm -C internal/tracking/worker lint
+	@pnpm -C internal/tracking/worker typecheck
 	@pnpm -C internal/tracking/worker build
 	@pnpm -C internal/tracking/worker test

README.md

@@ -163,7 +163,7 @@ binary.
 | meet | yes | Meet REST API | `https://www.googleapis.com/auth/meetings.space.created`<br>`https://www.googleapis.com/auth/meetings.space.readonly`<br>`https://www.googleapis.com/auth/meetings.space.settings` |  |
 | appscript | yes | Apps Script API | `https://www.googleapis.com/auth/script.projects`<br>`https://www.googleapis.com/auth/script.deployments`<br>`https://www.googleapis.com/auth/script.processes` |  |
 | analytics | yes | Analytics Admin API, Analytics Data API | `https://www.googleapis.com/auth/analytics.readonly` | GA4 account summaries + reporting |
-| searchconsole | yes | Search Console API | `https://www.googleapis.com/auth/webmasters` | Search Analytics + sitemap management |
+| searchconsole | yes | Search Console API | `https://www.googleapis.com/auth/webmasters` | Search Analytics + sitemap management + URL Inspection |
 | adsense | no | AdSense Management API | `https://www.googleapis.com/auth/adsense.readonly` | Consumer OAuth; explicit opt-in with --services adsense; read-only |
 | ads | yes | Google Ads API | `https://www.googleapis.com/auth/adwords` | OAuth scope only |
 | groups | no | Cloud Identity API | `https://www.googleapis.com/auth/cloud-identity.groups.readonly` | Workspace only |

docs/automation.md

@@ -187,6 +187,20 @@ fi
 
 New classifications may be added. Keep a generic non-zero fallback.
 
+## Discovery document cache
+
+`gog api call` and `gog api describe` share a 24-hour on-disk cache of
+Discovery documents under the configured cache directory's `discovery`
+subdirectory. It keeps at most 32 documents and 64 MiB, evicting the oldest
+documents; individual documents are limited to 16 MiB. API versions, endpoint
+overrides and service-hosted fallback behavior use separate cache keys.
+
+Pass `--no-cache` to either command to fetch without reading or writing this
+cache. Missing, expired or corrupt entries are fetched again. Cache failures
+do not prevent network access, and failed fetches are not cached. `api list`
+and actual API responses remain uncached; authorization and command-policy
+checks still run on every call.
+
 ## MCP discovery
 
 MCP uses its standard `tools/list` request for client-side tool discovery. To

docs/commands.generated.md

@@ -64,7 +64,7 @@ Generated from `gog schema --json`.
     - [`gog analytics (ga) report <property> [flags]`](commands/gog-analytics-report.md) - Run a GA4 report (Analytics Data API)
   - [`gog api <command> [flags]`](commands/gog-api.md) - Google Discovery APIs and generic method calls
     - [`gog api call <api> <version> <method> [flags]`](commands/gog-api-call.md) - Call a Discovery-described API method
-    - [`gog api describe <api> <version> [<method>]`](commands/gog-api-describe.md) - Describe a Discovery API or method
+    - [`gog api describe <api> <version> [<method>] [flags]`](commands/gog-api-describe.md) - Describe a Discovery API or method
     - [`gog api list [flags]`](commands/gog-api-list.md) - List Google Discovery APIs
   - [`gog appscript (script,apps-script) <command> [flags]`](commands/gog-appscript.md) - Google Apps Script
     - [`gog appscript (script,apps-script) content (cat) <scriptId>`](commands/gog-appscript-content.md) - Get Apps Script project content
@@ -574,6 +574,7 @@ Generated from `gog schema --json`.
   - [`gog schema (help-json,helpjson) [<command> ...] [flags]`](commands/gog-schema.md) - Machine-readable command/flag schema
   - [`gog search (find) <query> ... [flags]`](commands/gog-search.md) - Search Drive files (alias for 'drive search')
   - [`gog searchconsole (gsc,search-console,webmasters) <command> [flags]`](commands/gog-searchconsole.md) - Google Search Console
+    - [`gog searchconsole (gsc,search-console,webmasters) inspect <siteUrl> <url> [flags]`](commands/gog-searchconsole-inspect.md) - Inspect URL index status (URL Inspection API)
     - [`gog searchconsole (gsc,search-console,webmasters) query (report) <siteUrl> [flags]`](commands/gog-searchconsole-query.md) - Run a Search Analytics query
     - [`gog searchconsole (gsc,search-console,webmasters) searchanalytics (analytics) <command>`](commands/gog-searchconsole-searchanalytics.md) - Search Analytics queries
       - [`gog searchconsole (gsc,search-console,webmasters) searchanalytics (analytics) query (run) <siteUrl> [flags]`](commands/gog-searchconsole-searchanalytics-query.md) - Run a Search Analytics query
@@ -621,6 +622,7 @@ Generated from `gog schema --json`.
       - [`gog sheets (sheet) datasource (data-source,data-sources,connected-sheets) update <spreadsheetId> <dataSourceId> [flags]`](commands/gog-sheets-datasource-update.md) - Update one BigQuery Connected Sheets data source
     - [`gog sheets (sheet) delete-dimension (delete-dim) --dimension=STRING <spreadsheetId> <rangeOrSheet> [flags]`](commands/gog-sheets-delete-dimension.md) - Delete rows or columns while preserving intersecting tables
     - [`gog sheets (sheet) delete-tab (delete-sheet) <spreadsheetId> <tabName>`](commands/gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation)
+    - [`gog sheets (sheet) duplicate-tab <spreadsheetId> <sourceTab> <newName> [flags]`](commands/gog-sheets-duplicate-tab.md) - Duplicate a tab within a spreadsheet
     - [`gog sheets (sheet) export (download,dl) <spreadsheetId> [flags]`](commands/gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive
     - [`gog sheets (sheet) filter (filters,basic-filter,basic-filters) <command>`](commands/gog-sheets-filter.md) - Manage basic filters
       - [`gog sheets (sheet) filter (filters,basic-filter,basic-filters) set (create,add) <spreadsheetId> <range>`](commands/gog-sheets-filter-set.md) - Set a basic filter on a range; replacing an existing filter requires confirmation (or --force)
@@ -680,7 +682,7 @@ Generated from `gog schema --json`.
       - [`gog slides (slide) element alt-text <presentationId> <objectId> [flags]`](commands/gog-slides-element-alt-text.md) - Set or clear element accessibility text
       - [`gog slides (slide) element create-line <presentationId> <slideId> [flags]`](commands/gog-slides-element-create-line.md) - Create a native line on a slide
       - [`gog slides (slide) element create-shape <presentationId> <slideId> [flags]`](commands/gog-slides-element-create-shape.md) - Create a native shape on a slide
-      - [`gog slides (slide) element delete (rm) <presentationId> <objectId>`](commands/gog-slides-element-delete.md) - Delete one page element
+      - [`gog slides (slide) element delete (rm) <presentationId> <objectId> ...`](commands/gog-slides-element-delete.md) - Delete one or more page elements
       - [`gog slides (slide) element group <presentationId> <objectId> ... [flags]`](commands/gog-slides-element-group.md) - Group two or more elements
       - [`gog slides (slide) element style <presentationId> <objectId> [flags]`](commands/gog-slides-element-style.md) - Style a shape fill/outline or a line
       - [`gog slides (slide) element transform (move,resize,rotate) <presentationId> <objectId> [flags]`](commands/gog-slides-element-transform.md) - Move, resize, rotate, or replace an element transform
@@ -695,6 +697,7 @@ Generated from `gog schema --json`.
     - [`gog slides (slide) locate (find-element) <presentationId> <text> [flags]`](commands/gog-slides-locate.md) - Locate text in shapes and table cells with object IDs and UTF-16 ranges
     - [`gog slides (slide) move-slide --to-index=TO-INDEX <presentationId> <slideId>`](commands/gog-slides-move-slide.md) - Move a slide to a zero-based insertion index
     - [`gog slides (slide) new-slide <presentationId> [flags]`](commands/gog-slides-new-slide.md) - Create a native themed slide
+    - [`gog slides (slide) paragraph-style <presentationId> <objectId> [flags]`](commands/gog-slides-paragraph-style.md) - Set paragraph alignment, spacing, indentation, or direction
     - [`gog slides (slide) raw <presentationId> [flags]`](commands/gog-slides-raw.md) - Dump raw Google Slides API response as JSON (Presentations.Get; lossless; for scripting and LLM consumption)
     - [`gog slides (slide) read-slide <presentationId> <slideId> [flags]`](commands/gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images
     - [`gog slides (slide) replace-slide <presentationId> <slideId> [<image>] [flags]`](commands/gog-slides-replace-slide.md) - Replace an existing slide image from a local file or public URL

docs/commands/README.md

@@ -2,7 +2,7 @@
 
 Every `gog` command has a generated docs page. The source of truth is the live CLI schema; run `make docs-commands` after changing command names, flags, help text, aliases, or arguments.
 
-Generated pages: 766.
+Generated pages: 769.
 
 ## Top-level Commands
 
@@ -628,6 +628,7 @@ Generated pages: 766.
   - [gog schema](gog-schema.md) - Machine-readable command/flag schema
   - [gog search](gog-search.md) - Search Drive files (alias for 'drive search')
   - [gog searchconsole](gog-searchconsole.md) - Google Search Console
+    - [gog searchconsole inspect](gog-searchconsole-inspect.md) - Inspect URL index status (URL Inspection API)
     - [gog searchconsole query](gog-searchconsole-query.md) - Run a Search Analytics query
     - [gog searchconsole searchanalytics](gog-searchconsole-searchanalytics.md) - Search Analytics queries
       - [gog searchconsole searchanalytics query](gog-searchconsole-searchanalytics-query.md) - Run a Search Analytics query
@@ -675,6 +676,7 @@ Generated pages: 766.
       - [gog sheets datasource update](gog-sheets-datasource-update.md) - Update one BigQuery Connected Sheets data source
     - [gog sheets delete-dimension](gog-sheets-delete-dimension.md) - Delete rows or columns while preserving intersecting tables
     - [gog sheets delete-tab](gog-sheets-delete-tab.md) - Delete a tab/sheet from a spreadsheet (use --force to skip confirmation)
+    - [gog sheets duplicate-tab](gog-sheets-duplicate-tab.md) - Duplicate a tab within a spreadsheet
     - [gog sheets export](gog-sheets-export.md) - Export a Google Sheet (pdf|xlsx|csv) via Drive
     - [gog sheets filter](gog-sheets-filter.md) - Manage basic filters
       - [gog sheets filter set](gog-sheets-filter-set.md) - Set a basic filter on a range; replacing an existing filter requires confirmation (or --force)
@@ -734,7 +736,7 @@ Generated pages: 766.
       - [gog slides element alt-text](gog-slides-element-alt-text.md) - Set or clear element accessibility text
       - [gog slides element create-line](gog-slides-element-create-line.md) - Create a native line on a slide
       - [gog slides element create-shape](gog-slides-element-create-shape.md) - Create a native shape on a slide
-      - [gog slides element delete](gog-slides-element-delete.md) - Delete one page element
+      - [gog slides element delete](gog-slides-element-delete.md) - Delete one or more page elements
       - [gog slides element group](gog-slides-element-group.md) - Group two or more elements
       - [gog slides element style](gog-slides-element-style.md) - Style a shape fill/outline or a line
       - [gog slides element transform](gog-slides-element-transform.md) - Move, resize, rotate, or replace an element transform
@@ -749,6 +751,7 @@ Generated pages: 766.
     - [gog slides locate](gog-slides-locate.md) - Locate text in shapes and table cells with object IDs and UTF-16 ranges
     - [gog slides move-slide](gog-slides-move-slide.md) - Move a slide to a zero-based insertion index
     - [gog slides new-slide](gog-slides-new-slide.md) - Create a native themed slide
+    - [gog slides paragraph-style](gog-slides-paragraph-style.md) - Set paragraph alignment, spacing, indentation, or direction
     - [gog slides raw](gog-slides-raw.md) - Dump raw Google Slides API response as JSON (Presentations.Get; lossless; for scripting and LLM consumption)
     - [gog slides read-slide](gog-slides-read-slide.md) - Read slide content: speaker notes, text elements, and images
     - [gog slides replace-slide](gog-slides-replace-slide.md) - Replace an existing slide image from a local file or public URL

docs/commands/gog-api-call.md

@@ -33,6 +33,7 @@ gog api call <api> <version> <method> [flags]
 | `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
 | `--home` | `string` |  | Override gogcli config/data/state/cache root (equivalent to GOG_HOME) |
 | `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-cache` | `bool` |  | Fetch the Discovery document without reading or writing the 24-hour disk cache |
 | `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
 | `--params` | `string` | {} | JSON object of path and query parameters |
 | `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |