From 223d448575e933cd6a76a0cf3967d37467ce5c2e Mon Sep 17 00:00:00 2001
From: Dmitry Lyalin <dmitry.lyalin@lyalin.com>
Date: Mon, 16 Feb 2026 11:08:59 -0500
Subject: [PATCH] chore(ci): enforce settings docs parity in preflight

Add a dedicated check:docs:settings script and run it from preflight to catch settings doc drift locally before CI.

Update GEMINI.md testing guidance to include the new CI-parity check for CLI/UI changes.
---
 GEMINI.md    | 6 +++++-
 package.json | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/GEMINI.md b/GEMINI.md
index daeaa747f7..8a511f773d 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -47,8 +47,12 @@ powerful tool for developers.
     be relative to the workspace root, e.g.,
     `-w @google/gemini-cli-core -- src/routing/modelRouterService.test.ts`)
 - **Full Validation:** `npm run preflight` (Heaviest check; runs clean, install,
-  build, lint, type check, and tests. Recommended before submitting PRs.)
+  build, settings docs verification, lint, type check, and tests. Recommended
+  before submitting PRs.)
 - **Individual Checks:** `npm run lint` / `npm run format` / `npm run typecheck`
+- **CI-Parity Checks for CLI/UI changes:** Run these before pushing:
+  `npm run test:ci --workspace @google/gemini-cli` and
+  `npm run check:docs:settings`.
 
 ## Development Conventions
 
diff --git a/package.json b/package.json
index 820ae04826..5abed482c1 100644
--- a/package.json
+++ b/package.json
@@ -28,6 +28,7 @@
     "auth": "npm run auth:npm && npm run auth:docker",
     "generate": "node scripts/generate-git-commit-info.js",
     "predocs:settings": "npm run build --workspace @google/gemini-cli-core",
+    "check:docs:settings": "npm run predocs:settings && npm run docs:settings -- --check",
     "schema:settings": "tsx ./scripts/generate-settings-schema.ts",
     "docs:settings": "tsx ./scripts/generate-settings-doc.ts",
     "docs:keybindings": "tsx ./scripts/generate-keybindings-doc.ts",
@@ -54,7 +55,7 @@
     "lint:all": "node scripts/lint.js",
     "format": "prettier --experimental-cli --write .",
     "typecheck": "npm run typecheck --workspaces --if-present",
-    "preflight": "npm run clean && npm ci && npm run format && npm run build && npm run lint:ci && npm run typecheck && npm run test:ci",
+    "preflight": "npm run clean && npm ci && npm run format && npm run build && npm run check:docs:settings && npm run lint:ci && npm run typecheck && npm run test:ci",
     "prepare": "husky && npm run bundle",
     "prepare:package": "node scripts/prepare-package.js",
     "release:version": "node scripts/version.js",