fix(#4728): stop presenting the retired Gemini CLI as a supported runtime (#4743)

* fix(#4728): stop presenting the retired Gemini CLI as a supported runtime #1928 removed the Gemini CLI runtime after Google sunset it on 2026-06-18, and updated the ENGLISH docs. The locale mirrors and the runtime-loaded workflow prose were not updated in the same change, and no gate asserts the ABSENCE of a retired runtime, so both drifted quietly for a year. The finding that shaped this change: English is already correct. docs/ ARCHITECTURE.md, CONFIGURATION.md, USER-GUIDE.md, how-to/install-on-your-runtime.md and CLI-TOOLS.md carry zero runtime-axis Gemini references; the only English hits anywhere are a Gemini 2.5 Pro MODEL line, the GEMINI_API_KEY row, and prose that correctly documents the retirement. So the docs half of this is translation lag, not a content decision, and every locale edit here is parity with an existing English line rather than new wording: - install-on-your-runtime.md English has NO `### Gemini CLI` section -> deleted - USER-GUIDE.md :843 "…, Antigravity CLI, Kilo)" -> substituted - ARCHITECTURE.md English has NO Gemini CLI table row -> row deleted - ARCHITECTURE.md :24 English holds `Kimi CLI` in that slot -> Kimi CLI - context-monitor.md :3 "`AfterTool` for Antigravity CLI" -> substituted - spike-and-sketch.md :93 "(Codex, Antigravity CLI, etc.)" -> substituted - configure-model-profiles "Codex, OpenCode, Antigravity CLI, or Kilo" -> substituted - COMMANDS.md English keeps only hyphen + Codex bullets -> colon bullet deleted - FEATURES.md source docs/features/multi-runtime-support.md:10 lists no Gemini CLI -> name removed ARCHITECTURE.md:24 is the clearest case for reading English rather than substituting blind: Antigravity ALREADY appears later in that list, so replacing Gemini CLI with Antigravity would have named it twice. English holds Kimi CLI there, so that is what the locales get. The largest single class was hand-duplicated boilerplate. A "Text mode" paragraph repeated across 34 runtime-loaded workflow files ends "…required for non-Claude runtimes (OpenAI Codex, Gemini CLI, etc.)". No lint enforces that sentence and no script syncs it, so every copy was edited. These files are read by the agent at runtime, so they steer behavior rather than only informing a reader — which is why this class matters more than its word count suggests. The slash-command-form section is restructured in all four languages to match English, which had already dropped its colon-form bullet. That bullet claimed the colon form is "Gemini CLI only", which was false on its own terms independent of the retirement: `/gsd:…` is GSD's canonical AUTHORING token, rewritten per runtime at install time, and NO runtime registers it — VALID_COMMAND_STYLES is {slash-hyphen, shell-var} and 18 of 19 runtimes declare slash-hyphen. Substituting the runtime name would have left the claim false with Antigravity's name in it, so the claim is gone, matching English. Two anchor regressions were caught and fixed while doing that. zh-CN lost its explicit {#slash-command-forms-hyphen-vs-colon} anchor while its TOC still linked it; the anchor is restored. ko-KR and pt-BR never had an explicit anchor and rely on the slug generated from the heading text, so shortening the heading broke their own TOC links; those links now point at the new slugs. English's heading lost its anchor while its TOC still links the old one — that latent English bug is deliberately NOT copied. Preserved, because `gemini` is not one thing here and a blanket sweep breaks the product: ~/.gemini/antigravity{,-ide,-cli} and ~/.gemini as their parent; ~/.gemini/config (#3738); GEMINI.md; hookEvents "gemini"; GEMINI_API_KEY in all four locales; every gemini-* model id and the Gemini 2.5 Pro references in ko-KR/pt-BR/zh-CN (ja-JP genuinely lacks that line — the locales have diverged, so a uniform patch would be wrong); the hook-event dialect notes, which are RE-ATTRIBUTED rather than deleted because Antigravity inherits that dialect; reapply-patches.md:93's legacy-install note; host-integration-capability-matrix.md :27 and :342, which correctly record the sunset and Antigravity's contract; whats-new-1.7.0.md and FEATURES.md:3506, which document the retirement itself; and the generated launcher preamble, which belongs to epic #4632 — zero _GSD_SHIM_NAME lines appear in this diff. Coverage: a #4728 block in tests/gemini-runtime-removed.test.cjs asserts the retired name is gone from STRUCTURAL POSITIONS (a level-3 heading, a table row's first cell, a runtime-example parenthetical) rather than asserting the string is absent, which would be wrong. It pairs those with positive PRESERVE assertions over the same files — Antigravity's heading, ~/.gemini/antigravity, GEMINI_API_KEY, AfterTool — so a patch that deletes too much fails as loudly as one that deletes too little. The model-axis test pins both the presence in three locales and the absence in ja-JP, so a later uniform patch that "helpfully" adds it back fails. The new docs/ reads tripped lint-docs-guard-registration for the first time in this file, so the test is registered in scripts/docs-guard-registry.cjs. Not covered here, by design: nothing above would catch a Gemini-as-runtime reference appearing in a NEW file tomorrow. That is the repo-wide drift guard, #4729, which must land last — written now it would red on the very references this change removes. Fixes #4728 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(#4728): fix four review blockers, including a vacuous test and my own duplicate A full matrix run on 31f12d7943 FAILED with 3 real failures, and an isolated adversarial review returned BLOCK on four blockers. All of it was correct. 1. I committed the exact error I claimed to have avoided. The commit message boasted that ARCHITECTURE.md:24 proved the value of reading English rather than substituting blind, because Antigravity already appeared later in that list. Five hundred lines further down the SAME four files, my `Gemini:` -> `Antigravity:` substitution produced TWO consecutive `- Antigravity:` bullets, because an Antigravity bullet was already there. English (ARCHITECTURE.md:827) merges them into one. Now merged in all four locales, reusing each locale's existing words. 2. `--gemini` survived in the runtime-detection CLI flag list in all four locale ARCHITECTURE.md files. English:817 holds `--kimi` in that slot and already lists `--antigravity` later, so this is another place where substituting Antigravity would have duplicated it. Now `--kimi`. 3. Two runtime-loaded workflow files still enumerated Gemini one line ABOVE the line I had already corrected -- the "Adaptive (Recommended)" option in settings.md:192 and new-project/steps/auto-mode-config.md:95. 4. THE NEW TEST WAS VACUOUS for two of its five files. It matched only `non-Claude runtimes (` and `(e.g. `, and neither regex could reach the two lines the change actually fixed: health.md:52 reads `non-Claude (Codex, ...)` without the word "runtimes", and execute-phase.md:1028 has no parenthetical at all. The reviewer proved it by re-introducing Gemini at both lines and watching the assertion stay GREEN. That same blind spot is what hid finding 3. Replaced with a case-sensitive `/\bGemini\b/` walk over every `gsd-core/workflows/**/*.md`, which works because every LEGITIMATE gemini reference in that tree is spelled differently and cannot match: Antigravity's paths are lowercase with a slash (`~/.gemini/antigravity`), Google's model ids are lowercase and hyphenated (`gemini-3.1-pro-preview`), and the env vars are uppercase (`GEMINI_CONFIG_DIR`, `GEMINI_SESSION_ID`). A bare capitalised `Gemini` there means the retired RUNTIME is being named. The walk asserts it found at least 50 files so an empty walk cannot pass vacuously, and it now covers the nested `new-project/steps/` directory where finding 3 lived. Two allowlist entries, both by line CONTENT and both justified: reapply-patches.md's `Legacy: ... pre-#1928` note, and settings-advanced.md's `Known provider` menu. The second was escalated by the agent rather than decided: Section 8 of that file says model policy is defined "independently" of the runtime, so `(Claude / OpenAI / Gemini / Qwen)` is the PROVIDER axis -- the same axis as the lowercase model ids -- and must keep working. Proven to fail, not just asserted: the predicate reports 0 offenders on the real tree and exactly 2 on a /tmp copy with Gemini re-injected at health.md:52 and execute-phase.md:1028. Also from the review: a `| Gemini |` COLUMN survived in the locale FEATURES.md comparison tables (English has none) -- removed from all three, with header, separator and every body row kept aligned; two ENGLISH runtime-axis sites were missed by my own parity standard (how-to/execute-a-phase.md:88 and how-to/verify-and-ship.md:89, the latter doubly stale since #4716 retired the Gemini reviewer lane); docs/USER-GUIDE.md:12 linked a dead anchor, which I had found and deliberately left -- record-and-proceed on a known defect is exactly what the rules forbid, so it is fixed; docs/COMMANDS.md:12 and all four mirrors still claimed "the hyphen and colon forms are runtime-specific spellings" with no colon form documented anywhere, so that false sentence is deleted; and ko-KR had the installer rather than the user doing the targeting. The other two matrix failures were the compact-content benchmark baseline, which drifted because this PR changes byte counts, refreshed via the script's own `--write` path rather than by hand; and this commit's emitted-drift-ack trailers. Method note on the acks: the failing run measured growth against origin/next@1110c3b4ee, which is the STALE LOCAL `next` ref -- gsd-test merges into the local base branch, and this machine's `next` is seven commits behind origin/next, which is checked out in the main worktree and so cannot be fast-forwarded from here. The 32 trailers below are computed against the REAL base (origin/next @ ca8d9d4459) by comparing each tracked file's blob size, which is one more file than that run reported -- the extra is settings.md, grown again by fix 3. docs-update.md and map-codebase.md are deliberately NOT acked: they SHRANK, since there the fix deleted ", Gemini CLI" rather than substituting, and acking a file no delta consumed is itself an error. Refs #4728 Emitted-Drift-Ack-Growth: add-tests.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: add-todo.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: ai-integration-phase.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: check-todos.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: cleanup.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: complete-milestone.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: do.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: eval-review.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: execute-phase.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: execute-plan.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: health.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: import.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: inbox.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: manager.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: new-milestone.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: new-workspace.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: note.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: onboard.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: plant-seed.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: profile-user.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: quick.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: remove-workspace.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: secure-phase.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: settings.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: ship.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: smart-entry.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: ui-phase.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: ui-review.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: undo.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: update.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: validate-phase.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Emitted-Drift-Ack-Growth: verify-work.md — retiring the Gemini CLI runtime name; Antigravity is one byte longer Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * chore(#4728): add the changeset fragment The PR body claimed one was present and it was not — caught by scripts/changeset/lint.cjs reporting fail_missing_fragment, not by the checklist, which is exactly why the lint exists. Type Fixed: the diff is prose, and a docs-only fix uses Fixed since there is no Documentation type. Refs #4728 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: sim <sim@local> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-14 16:49:52 -04:00
parent b647e28313
commit eb49ff98df
83 changed files with 365 additions and 247 deletions
--- a/tests/fixtures/compact-content-benchmark-baseline.json
+++ b/tests/fixtures/compact-content-benchmark-baseline.json
@@ -8,18 +8,18 @@
  "label": "PROXY-TOKENIZER DELTA — gpt-tokenizer is a stand-in; Anthropic publishes no tokenizer for Claude 3+. The on/off COMPARISON is exact under this pinned tokenizer; absolute counts are not Claude's real token counts.",
  "splits": {
    "complete-milestone": {
-      "offTokens": 13199,
-      "onTokens": 8359,
+      "offTokens": 13200,
+      "onTokens": 8360,
      "reductionPct": 36.67
    },
    "docs-update": {
-      "offTokens": 14232,
-      "onTokens": 11882,
+      "offTokens": 14230,
+      "onTokens": 11880,
      "reductionPct": 16.51
    },
    "execute-phase": {
-      "offTokens": 26103,
-      "onTokens": 23852,
+      "offTokens": 26104,
+      "onTokens": 23853,
      "reductionPct": 8.62
    },
    "new-project": {
@@ -33,14 +33,14 @@
      "reductionPct": 11.9
    },
    "verify-work": {
-      "offTokens": 12112,
-      "onTokens": 10139,
+      "offTokens": 12113,
+      "onTokens": 10140,
      "reductionPct": 16.29
    }
  },
  "aggregate": {
-    "offTokens": 107591,
-    "onTokens": 90943,
+    "offTokens": 107592,
+    "onTokens": 90944,
    "reductionPct": 15.47
  }
 }
--- a/tests/gemini-runtime-removed.test.cjs
+++ b/tests/gemini-runtime-removed.test.cjs
@@ -584,3 +584,179 @@ describe('#4709 the Gemini CLI reviewer lane is retired', () => {
  });
 });
 });
+
+/**
+ * #4728 — localized docs and runtime-loaded workflow prose still surface the retired Gemini CLI
+ * runtime as a selectable option, outside the English `how-to`/`ARCHITECTURE.md` surfaces #4709
+ * already covers.
+ *
+ * As with #4709, every assertion here is STRUCTURAL: a heading position, a table's first cell, or
+ * a captured runtime-example parenthetical — never "the string gemini is absent". `gemini` is
+ * load-bearing across Antigravity's real on-disk contract (~/.gemini/antigravity, ~/.gemini/config,
+ * GEMINI.md, hookEvents "gemini", GEMINI_API_KEY, every gemini-* model id), so a bare-string
+ * assertion would be wrong and would fail on correct code. The PRESERVE block below is the
+ * over-reach guard: it is what fails first if a "helpful" blanket gemini->antigravity sweep lands
+ * instead of the scoped removal this issue asks for.
+ */
+describe('#4728 Gemini CLI prose retired from localized docs and runtime-loaded workflows', () => {
+  const LOCALES = ['ja-JP', 'ko-KR', 'pt-BR', 'zh-CN'];
+  const linesOf = (file) => fs.readFileSync(file, 'utf8').split(/\r?\n/);
+  const relPath = (p) => path.relative(ROOT, p).split(path.sep).join('/');
+
+  test('no locale install-on-your-runtime.md has a Gemini CLI ### heading', () => {
+    // Heading-scoped (### only) so Antigravity's own ~/.gemini/... paths documented in the same
+    // file cannot trip this — a bare substring match on "Gemini CLI" would be too broad here.
+    const HEADING = /^###\s+Gemini CLI\s*$/m;
+    const offenders = LOCALES
+      .map((locale) => path.join(ROOT, 'docs', locale, 'how-to', 'install-on-your-runtime.md'))
+      .filter((file) => HEADING.test(fs.readFileSync(file, 'utf8')))
+      .map(relPath);
+
+    assert.deepStrictEqual(offenders, [],
+      'a localized how-to still documents Gemini CLI as an installable runtime under its own '
+        + `heading, after #1928 retired the runtime. Offenders:\n  ${offenders.join('\n  ')}`);
+  });
+
+  test('no locale ARCHITECTURE.md tables a Gemini CLI row', () => {
+    // First-cell-scoped so the Antigravity row's ~/.gemini/antigravity cells are untouched.
+    const ROW = /^\|\s*Gemini CLI\s*\|/m;
+    const offenders = LOCALES
+      .map((locale) => path.join(ROOT, 'docs', locale, 'ARCHITECTURE.md'))
+      .filter((file) => ROW.test(fs.readFileSync(file, 'utf8')))
+      .map(relPath);
+
+    assert.deepStrictEqual(offenders, [],
+      'a localized ARCHITECTURE.md still tables Gemini CLI as a runtime row, after #1928 retired '
+        + `the runtime. Offenders:\n  ${offenders.join('\n  ')}`);
+  });
+
+  test('no locale USER-GUIDE.md tables a Gemini CLI row', () => {
+    const ROW = /^\|\s*Gemini CLI\s*\|/m;
+    const offenders = LOCALES
+      .map((locale) => path.join(ROOT, 'docs', locale, 'USER-GUIDE.md'))
+      .filter((file) => ROW.test(fs.readFileSync(file, 'utf8')))
+      .map(relPath);
+
+    assert.deepStrictEqual(offenders, [],
+      'a localized USER-GUIDE.md still tables Gemini CLI as a runtime row, after #1928 retired the '
+        + `runtime. Offenders:\n  ${offenders.join('\n  ')}`);
+  });
+
+  test('no runtime-loaded workflow file names the retired Gemini runtime', () => {
+    // Walk gsd-core/workflows/ recursively (this MUST cover nested dirs like
+    // new-project/steps/, where #4728's auto-mode-config.md defect lived) and assert no `.md`
+    // file contains a case-sensitive standalone `Gemini` token, i.e. no match for /\bGemini\b/.
+    //
+    // Why a bare `/\bGemini\b/` is the right predicate, and not a narrower parenthetical/heading
+    // scoped one: every LEGITIMATE gemini reference in this directory is spelled differently and
+    // therefore cannot collide with this assertion —
+    //   - Antigravity's config paths are lowercase with a slash: ~/.gemini/antigravity,
+    //     ~/.gemini/config, .gemini/antigravity-ide
+    //   - Google model ids are lowercase and hyphenated: gemini-3.1-pro-preview,
+    //     gemini-2.5-flash-lite
+    //   - env vars are uppercase: GEMINI_CONFIG_DIR, GEMINI_SESSION_ID, GEMINI_API_KEY
+    //   - the generated runtime-launcher preamble only ever uses GEMINI_CONFIG_DIR / $HOME/.gemini
+    // So a bare capitalised `Gemini` anywhere under gsd-core/workflows/ can only mean the retired
+    // RUNTIME is being named — which is exactly the defect this test exists to catch. These files
+    // are runtime-loaded (read by the agent at execution time), so a stale "Gemini" mention here
+    // actively steers execution toward a retired runtime, not merely misinforms a reader.
+    const WORKFLOWS_ROOT = path.join(ROOT, 'gsd-core', 'workflows');
+    const GEMINI_TOKEN = /\bGemini\b/;
+    // Two allowlisted exceptions, both matched by line CONTENT (never line number, so neither can
+    // silently drift if the file is edited above the matched line):
+    //   1. reapply-patches.md's historical note about where a pre-#1928 Gemini CLI install used
+    //      to place patches.
+    //   2. settings-advanced.md's Section 8 "Known provider" menu option. This predicate forbids
+    //      `Gemini` naming the retired RUNTIME axis; it does NOT forbid `Gemini` naming the
+    //      PROVIDER / MODEL-FAMILY axis. Section 8 ("Model Policy") is explicitly scoped to model
+    //      selection, independent of which runtime is installed, and its own intro says so. The
+    //      "Known provider" option lists Gemini alongside Claude/OpenAI/Qwen as a model provider —
+    //      the same axis as the lowercase `gemini-*` model ids used elsewhere in this file — and
+    //      Antigravity runs on that provider's models. That is the same runtime-vs-provider
+    //      taxonomy the whole #4709 epic rests on, so this line is correct as written and must
+    //      keep working, not get rewritten to dodge the predicate.
+    const isAllowlistedLegacyLine = (file, line) =>
+      (relPath(file) === 'gsd-core/workflows/reapply-patches.md'
+        && line.includes('Legacy:')
+        && line.includes('pre-#1928'))
+      || (relPath(file) === 'gsd-core/workflows/settings-advanced.md'
+        && line.includes('Known provider'));
+
+    /** Recursively collect every `.md` file under `dir`. */
+    function markdownFilesUnder(dir) {
+      const out = [];
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          out.push(...markdownFilesUnder(full));
+        } else if (entry.isFile() && entry.name.endsWith('.md')) {
+          out.push(full);
+        }
+      }
+      return out;
+    }
+
+    const files = markdownFilesUnder(WORKFLOWS_ROOT);
+    // Guard against an empty or failed walk making this test pass vacuously.
+    assert.ok(files.length >= 50,
+      `expected at least 50 .md files under gsd-core/workflows/, found ${files.length} — the `
+        + 'recursive walk may be broken');
+
+    const offenders = [];
+    for (const file of files) {
+      linesOf(file).forEach((line, i) => {
+        if (isAllowlistedLegacyLine(file, line)) return;
+        if (GEMINI_TOKEN.test(line)) {
+          offenders.push(`${relPath(file)}:${i + 1} names Gemini: "${line.trim()}"`);
+        }
+      });
+    }
+
+    assert.deepStrictEqual(offenders, [],
+      'a runtime-loaded workflow file under gsd-core/workflows/ still names the retired Gemini '
+        + 'runtime, steering the agent (these files are read at execution time, not just by a '
+        + `reader) toward a retired runtime. Offenders:\n  ${offenders.join('\n  ')}`);
+  });
+
+  test('PRESERVE: Antigravity survives in every surface the removal above touches (over-reach guard)', () => {
+    // These four assertions are what fails first if someone "fixes" #4728 with a blanket
+    // gemini->antigravity string sweep instead of the scoped, structural removal above.
+    for (const locale of LOCALES) {
+      const installGuide = fs.readFileSync(
+        path.join(ROOT, 'docs', locale, 'how-to', 'install-on-your-runtime.md'), 'utf8',
+      );
+      assert.match(installGuide, /^###\s+Antigravity\s*$/m,
+        `docs/${locale}/how-to/install-on-your-runtime.md must still document Antigravity under its own heading`);
+
+      const architecture = fs.readFileSync(path.join(ROOT, 'docs', locale, 'ARCHITECTURE.md'), 'utf8');
+      assert.ok(architecture.includes('~/.gemini/antigravity'),
+        `docs/${locale}/ARCHITECTURE.md must still document Antigravity's ~/.gemini/antigravity config home`);
+
+      const configuration = fs.readFileSync(path.join(ROOT, 'docs', locale, 'CONFIGURATION.md'), 'utf8');
+      assert.ok(configuration.includes('GEMINI_API_KEY'),
+        `docs/${locale}/CONFIGURATION.md must still document GEMINI_API_KEY`);
+
+      const contextMonitor = fs.readFileSync(path.join(ROOT, 'docs', locale, 'context-monitor.md'), 'utf8');
+      assert.ok(contextMonitor.includes('AfterTool'),
+        `docs/${locale}/context-monitor.md must still document AfterTool, the hook dialect Antigravity `
+          + 'inherits — re-attributed on gemini removal, never deleted');
+    }
+  });
+
+  test('MODEL AXIS: Gemini 2.5 Pro asymmetry across locale ARCHITECTURE.md is a measured fact, not an assumption', () => {
+    // Measured on 2026-09-14: ko-KR/pt-BR/zh-CN mention Gemini 2.5 Pro on the model axis (distinct
+    // from the retired RUNTIME axis covered above); ja-JP genuinely does not. Both sides are
+    // asserted so a later "helpful" uniform patch that adds the mention to ja-JP — treating the
+    // asymmetry as an oversight rather than a measured divergence — fails here.
+    for (const locale of ['ko-KR', 'pt-BR', 'zh-CN']) {
+      const text = fs.readFileSync(path.join(ROOT, 'docs', locale, 'ARCHITECTURE.md'), 'utf8');
+      assert.ok(text.includes('Gemini 2.5 Pro'),
+        `docs/${locale}/ARCHITECTURE.md must still mention Gemini 2.5 Pro on the model axis`);
+    }
+
+    const jaText = fs.readFileSync(path.join(ROOT, 'docs', 'ja-JP', 'ARCHITECTURE.md'), 'utf8');
+    assert.ok(!jaText.includes('Gemini 2.5 Pro'),
+      'docs/ja-JP/ARCHITECTURE.md does not mention Gemini 2.5 Pro — this locale genuinely diverged '
+        + 'from the other three and must not be uniformly patched to match them');
+  });
+});