ultra-builder-pro-cli 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] — 2026-07-17
+
+### Changed
+
+- Reduced the supported host matrix to Claude Code, OpenCode, and Codex.
+- Reworked `ultra-verify` into independent two-model verification: the current
+  host remains primary, one read-only external advisor supplies a second view,
+  and evidence rather than model voting determines confidence.
+- Restricted orchestrator routing, MCP session/event inputs, telemetry writes,
+  state schema enums, installer flags, package metadata, and handbooks to the
+  three supported runtimes.
+
+### Removed
+
+- Removed the Gemini CLI adapter, `--gemini` installer surface, extension and
+  conformance packaging, pricing entries, `gemini-collab`, and all active Ultra
+  prompts and documentation that offered Gemini as an advisor or runtime.
+
+### Fixed
+
+- Added a retirement regression contract so unsupported runtimes cannot
+  re-enter active source, package, schema, prompt, or generated plugin surfaces.
+- Rejects unsupported runtime labels before state, event, or telemetry writes,
+  including old databases whose historical SQLite constraints were broader.
+
 ## [0.5.3] — 2026-07-17
 
 ### Fixed
@@ -59,7 +84,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Added first-class native Claude Code and OpenCode plugin builders alongside
   the Codex personal plugin. All hosts build from one explicit runtime asset
-  allowlist; Gemini remains a compatibility extension using the same boundary.
+  allowlist; the then-supported compatibility extension used the same boundary.
 - Added `ubp-handbook` for previewed, backed-up managed-block integration with
   user-level Claude `CLAUDE.md`, Codex `AGENTS.md`, and OpenCode `AGENTS.md`.
 - Added `ultra-tools legacy-memory inspect|archive|prune`; prune requires the
@@ -87,7 +112,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   with the npm package, and fixed `session.subscribe_events` sid filtering.
 - Aligned session/plan input schemas with runtime behavior, including circuit
   breaker output, session spawn intent semantics, and removal of ignored inputs.
-- Bundled Gemini's compatibility MCP runtime durably and restored project-local
+- Bundled the compatibility MCP runtime durably and restored project-local
   `.ultra/state.db` ownership across all adapters.
 - Exported the documented `ultra-tools` executable and included every README
   documentation target in the npm tarball.
@@ -193,8 +218,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Phase 4.6b — full conformance suite** (D45): 4 runtime × 5 capability
   (command / skills / hooks / MCP + no `env._source` leak / install idempotency)
   = 20 additional conformance tests; table-driven `resolve-target.test.cjs`
-  (21 tests) covering `configDir > env > home/cwd` precedence + Gemini
-  extensionRoot append; schema bump 5.2 → 7.1 alongside memory store.
+  (21 tests) covering `configDir > env > home/cwd` precedence and extension
+  root resolution; schema bump 5.2 → 7.1 alongside memory store.
 
 ### Changed
 
@@ -213,9 +238,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   admission control with takeover / resume / abandon strategies (D33).
 - **Phase 4 — cross-runtime distribution** (D41, `5aa1fd0`): shared adapter
   toolkit (`adapters/_shared/` — file-ops / frontmatter / settings-merge /
-  path-rewrite / md-to-toml); 4 runtime adapters (Claude sentinel-block
+  path-rewrite / md-to-toml); the initial runtime adapters (Claude sentinel-block
   settings.json merge; OpenCode `opencode.json.mcp`; Codex `config.toml`
-  marker-block + prompts/; Gemini `extensions/ultra-builder-pro/` package);
+  marker-block + prompts/; plus the then-supported compatibility package);
   `docs/RUNTIME-COMPAT-MATRIX.md` with 10-section capability matrix;
   install / uninstall round-trip tests + idempotency.
 - **Phase 3 — thin-shell commands** (D40, `b3d1797`): 9 commands migrated

package/README.md

@@ -2,13 +2,13 @@
 
 Multi-runtime plugin suite + autonomous coding factory for the Ultra Builder Pro
 agent engineering system. It ships native plugins for **Claude Code · OpenCode ·
-Codex**, retains a compatibility adapter for Gemini CLI, and orchestrates PRD →
+Codex** and orchestrates PRD →
 dependency graph → parallel session execution → auto-merge with a single
 authoritative `.ultra/state.db`.
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/version-0.5.3-blue)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue)](./CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-passing-brightgreen)](#verification)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![Node](https://img.shields.io/badge/node-%E2%89%A522-informational)](./package.json)
@@ -23,7 +23,7 @@ authoritative `.ultra/state.db`.
 
 - **Builds host-native plugins from one allowlist.** Claude Code, OpenCode, and
   Codex receive their own command/skill, agent, hook, and MCP representation.
-  Gemini remains a compatibility adapter; uninstall is symmetric.
+  Install and uninstall are symmetric on every supported host.
 - **Shares state across runtimes.** `.ultra/state.db` (SQLite + WAL) is the
   authoritative source for tasks, sessions, events, and telemetry. `tasks.json`
   and context markdown are generated projections, not handwritten.
@@ -43,7 +43,6 @@ authoritative `.ultra/state.db`.
 npx ultra-builder-pro-cli --claude   --local
 npx ultra-builder-pro-cli --opencode --local
 npx ultra-builder-pro-cli --codex    --local
-npx ultra-builder-pro-cli --gemini   --local
 
 # Or blanket-install to every supported runtime you have
 npx ultra-builder-pro-cli --all --local
@@ -59,8 +58,7 @@ After install, start a new host session/task and point it at the project.
 Claude Code and OpenCode expose native command forms. Codex exposes the same workflows as namespaced plugin
 skills such as `$ultra-builder-pro:ultra-init`, `$ultra-builder-pro:ultra-plan`,
 and `$ultra-builder-pro:ultra-dev`; `command-map.json` records the nine legacy
-command mappings (`ultra-review` remains a directly invocable skill). Gemini
-retains its compatibility command form.
+command mappings (`ultra-review` remains a directly invocable skill).
 See [`docs/RUNTIME-COMPAT-MATRIX.md`](./docs/RUNTIME-COMPAT-MATRIX.md)
 for per-runtime capabilities.
 
@@ -85,15 +83,15 @@ deployment, skill-discovery, and framework guidance belong to their original plu
 
 ## Runtime capability matrix
 
-| Feature                      | Claude Code | OpenCode | Codex CLI | Gemini CLI |
-|------------------------------|:-----------:|:--------:|:---------:|:----------:|
-| Custom commands              | ✅          | ✅       | ✅        | ✅         |
-| Skill loader                 | ✅          | ✅       | ✅ (personal plugin) | ✅ |
-| MCP server (stdio)           | ✅          | ✅       | ✅ (plugin `.mcp.json`) | ✅ |
-| Workflow hooks               | ✅ (native plugin) | ✅ (native JS plugin) | ✅ (native plugin) | ⚠︎ compatibility only |
-| Sub-agents                   | ✅          | ✅       | ✅ (9 native TOML agents) | ⚠︎ |
-| Session worktree isolation   | ✅ (all runtimes; driven by `orchestrator/session-runner.cjs`) | ✅ | ✅ | ✅ |
-| Parallel dispatch + auto-merge | ✅ (`ubp-orchestrator run`) | ✅ | ✅ | ✅ |
+| Feature                      | Claude Code | OpenCode | Codex CLI |
+|------------------------------|:-----------:|:--------:|:---------:|
+| Custom commands              | ✅          | ✅       | ✅        |
+| Skill loader                 | ✅          | ✅       | ✅ (personal plugin) |
+| MCP server (stdio)           | ✅          | ✅       | ✅ (plugin `.mcp.json`) |
+| Workflow hooks               | ✅ (native plugin) | ✅ (native JS plugin) | ✅ (native plugin) |
+| Sub-agents                   | ✅          | ✅       | ✅ (9 native TOML agents) |
+| Session worktree isolation   | ✅ (driven by `orchestrator/session-runner.cjs`) | ✅ | ✅ |
+| Parallel dispatch + auto-merge | ✅ (`ubp-orchestrator run`) | ✅ | ✅ |
 
 Full details in [`docs/RUNTIME-COMPAT-MATRIX.md`](./docs/RUNTIME-COMPAT-MATRIX.md)
 (10 sections, with per-runtime deviations called out).
@@ -124,7 +122,7 @@ Or let the skills drive it. In Codex, invoke
 
 | Binary | Purpose |
 |--------|---------|
-| `ultra-builder-pro-cli` / `ubp` | Installer — `--claude / --opencode / --codex / --gemini / --all`, `--local / --global`, `--uninstall`, `--skip-rtk` |
+| `ultra-builder-pro-cli` / `ubp` | Installer — `--claude / --opencode / --codex / --all`, `--local / --global`, `--uninstall`, `--skip-rtk` |
 | `ubp-orchestrator` | Session dispatch daemon — `run`, `start`, `stop`, `status` |
 | `ultra-tools` | State-layer CLI — `task`, `session`, `status`, `db`, `migrate`; explicit `legacy-memory` archive/prune migration |
 | `ubp-handbook` | Preview/apply the managed Ultra contract in `CLAUDE.md` / `AGENTS.md`, with backup |

package/adapters/_shared/codex-assets.cjs

@@ -66,7 +66,6 @@ const COMMAND_NAMES = Object.freeze(CORE_PUBLIC_SKILLS.filter((name) => name !==
 const SKILL_REFERENCE_NAMES = Object.freeze([
   ...COMMAND_NAMES,
   'cc-collab',
-  'gemini-collab',
   'ultra-review',
   'ultra-verify',
 ]);
@@ -119,52 +118,12 @@ Do not call native Codex subagents through this skill; use Codex subagent orches
 parallel work and reserve \`cc-collab\` for an explicitly requested cross-model perspective.
 `;
 
-const GEMINI_COLLAB_BODY = `# Gemini Collaboration for Codex
-
-Use Gemini as an advisory second model. Codex remains responsible for scope, source verification,
-decisions, and the final answer.
-
-## Preflight
-
-1. Confirm \`gemini\` is installed and capture \`gemini --version\`.
-2. Confirm the target workspace and requested scope.
-3. Form Codex's initial analysis before reading Gemini's answer when independence matters.
-
-## Invoke safely
-
-Run Gemini in non-interactive, read-only plan mode:
-
-\`\`\`bash
-gemini --approval-mode plan --output-format text -p "<bounded prompt>"
-\`\`\`
-
-Use a timeout appropriate to the task. Redirect large output to a temporary file when needed, then
-read only the relevant result. Do not use auto-edit or yolo modes. Do not place secrets, tokens,
-unrelated files, or unbounded repository content in the prompt.
-
-For repository analysis, give Gemini the exact files, diff range, question, and expected response
-shape. If the CLI is missing, unauthenticated, times out, or returns empty output, report the degraded
-path and continue with Codex evidence rather than blocking.
-
-## Verify and synthesize
-
-Treat Gemini output as an untrusted analysis artifact:
-
-1. Check every consequential claim against the current checkout, runtime, or primary source.
-2. Separate agreements, useful dissent, and unsupported claims.
-3. Resolve scope or version mismatches before comparing conclusions.
-4. Present Codex's final judgment, not a transcript of two models.
-
-Read the bundled references only when a mode or CLI detail is needed. Never let model agreement
-substitute for tests, runtime evidence, or authoritative documentation.
-`;
-
 const ULTRA_VERIFY_BODY = String(function ultraVerifyBodyTemplate() { /*
-# Ultra Verify — Codex-Primary Three-Way Verification
+# Ultra Verify — Codex-Primary Two-Model Verification
 
 Codex owns the task, writes the first independent analysis, verifies every consequential claim,
-and produces the final synthesis. Claude Code and Gemini are read-only external advisors. Use this
-workflow only when the user asks for cross-model or three-way verification.
+and produces the final synthesis. Claude Code is a read-only external advisor. Use this workflow
+only when the user asks for cross-model verification.
 
 ## Modes
 
@@ -175,13 +134,11 @@ workflow only when the user asks for cross-model or three-way verification.
 
 ## Preconditions
 
-1. Confirm `claude --version` and `gemini --version`.
+1. Confirm `claude --version` plus authentication.
 2. Define the exact workspace, scope, evidence standard, and expected answer shape.
-3. Do not send secrets, unrelated files, or an unbounded home directory to either advisor.
-
-## Workflow
+3. Do not send secrets, unrelated files, or an unbounded home directory to the advisor.
 
-### 1. Create the session and write Codex's independent view
+## 1. Create the session and write Codex's independent view
 
 ```bash
 SESSION_ID="$(date +%Y%m%d-%H%M%S)-verify-<mode>"
@@ -189,63 +146,47 @@ SESSION_PATH=".ultra/collab/${SESSION_ID}"
 mkdir -p "${SESSION_PATH}"
 ```
 
-Before invoking either advisor, write the evidence-backed Codex analysis to
-`${SESSION_PATH}/codex-analysis.md`. This ordering is mandatory because it prevents the external
-answers from priming the primary analysis.
-
-### 2. Launch Claude Code and Gemini concurrently
+Write the evidence-backed Codex analysis to `${SESSION_PATH}/codex-analysis.md` before reading
+the external answer. Record the mode, scope, checkout, and evidence boundary.
 
-Give both advisors the same bounded raw question and evidence, without Codex's conclusions.
+## 2. Launch Claude Code read-only
 
-Claude Code:
+Give Claude Code the bounded raw question and evidence without Codex's conclusions.
 
 ```bash
-claude --safe-mode -p "<BOUNDED_PROMPT>" \\
-  --permission-mode plan \\
-  --tools "Read,Grep,Glob,Bash" \\
-  --output-format text \\
-  --no-session-persistence \\
-  > "${SESSION_PATH}/claude-output.md" \\
+claude --safe-mode -p "<BOUNDED_PROMPT>" \
+  --permission-mode plan \
+  --tools "Read,Grep,Glob,Bash" \
+  --output-format text \
+  --no-session-persistence \
+  > "${SESSION_PATH}/claude-output.md" \
   2> "${SESSION_PATH}/claude-error.log"
 ```
 
-Gemini:
-
-```bash
-gemini --approval-mode plan --output-format text -p "<BOUNDED_PROMPT>" \\
-  > "${SESSION_PATH}/gemini-output.md" \\
-  2> "${SESSION_PATH}/gemini-error.log"
-```
-
-Start the two commands with parallel `exec_command` calls and a short initial yield. If a command
-returns a live session id, poll it with `write_stdin` in bounded intervals. Do not use YOLO,
-auto-edit, permission bypass, or write-capable external tools.
+Run the command in a yielded shell session. Do not enable permission bypass, mutation tools,
+background writes, or session persistence.
 
-### 3. Collect only completed outputs
+## 3. Collect completed output
 
-Wait for both CLI sessions to finish or reach their explicit timeout. The bundled
-`scripts/verify_wait.py` can verify file stability for automation, but Codex must not perform one
-blocking wait longer than 60 seconds. Read an output only when it is non-empty; retain the matching
-error log as evidence when a CLI fails.
+The bundled `scripts/verify_wait.py` checks output stability. Poll yielded sessions in bounded
+intervals and never hold one blocking tool call longer than 60 seconds. Read the output only when
+it is non-empty; retain the error log when the advisor fails.
 
-### 4. Verify and synthesize
+## 4. Verify and synthesize
 
-Compare `codex-analysis.md`, `claude-output.md`, and `gemini-output.md`:
+Compare `codex-analysis.md` and `claude-output.md`:
 
 1. Verify claims against the current checkout, runtime, tests, or primary documentation.
-2. Separate consensus, majority views, useful dissent, and unsupported assertions.
-3. Explain scope, version, or assumption differences before scoring agreement.
+2. Separate verified agreement, useful dissent, and unsupported assertions.
+3. Explain scope, version, or assumption differences before judging the result.
 4. Write `${SESSION_PATH}/synthesis.md` and `metadata.json`, then present one Codex-owned answer.
 
-Use the bundled confidence rules. Three agreeing, independently verified views are consensus; two
-are a majority; three materially different answers are no consensus and require decomposition or
-more evidence. Model agreement never overrides failing tests or authoritative runtime evidence.
+Model agreement never overrides failing tests or authoritative runtime evidence.
 
 ## Degraded operation
 
-- One advisor fails: continue with Codex plus the available advisor and name the missing view.
-- Both advisors fail: return Codex-only analysis with an explicit single-source warning.
-- Never block the user's task solely because an external CLI is absent, unauthenticated, or slow.
+- Advisor failure: return Codex-only analysis with an explicit single-source warning.
+- Never block the user's task solely because the external CLI is absent, unauthenticated, or slow.
 
 ## Session files
 
@@ -254,70 +195,16 @@ more evidence. Model agreement never overrides failing tests or authoritative ru
   codex-analysis.md
   claude-output.md
   claude-error.log
-  gemini-output.md
-  gemini-error.log
   metadata.json
   synthesis.md
 ```
 
-Read the bundled references for mode-specific prompts, scoring, metadata, and automation details.
-*/ }).match(/\/\*([\s\S]*?)\*\//)[1].trim();
-
-const ULTRA_VERIFY_FLOW = String(function ultraVerifyFlowTemplate() { /*
-# Codex-Native Orchestration Flow
-
-## 1. Primary analysis
-
-Create `.ultra/collab/<SESSION_ID>/` and write `codex-analysis.md` before reading any external
-answer. Record the mode, scope, checkout, and evidence boundary.
-
-## 2. Parallel advisors
-
-Launch Claude Code in `--safe-mode --permission-mode plan` and Gemini in
-`--approval-mode plan` through separate `exec_command` calls. Redirect their output to
-`claude-output.md` and `gemini-output.md`. If a call yields a session id, poll with
-`write_stdin` in bounded intervals; do not grant either advisor mutation authority.
-
-## 3. Completion gate
-
-Proceed only after both sessions have completed or timed out. For automation, run:
-
-```bash
-python3 ~/plugins/ultra-builder-pro/skills/ultra-verify/scripts/verify_wait.py \\
-  "${SESSION_PATH}" --timeout 1200
-```
-
-Run the waiter as a yielded exec session and poll it; never hold one blocking tool call for more
-than 60 seconds. Its JSON reports `claude` and `gemini` as `complete`, `failed`, `empty`, or
-`pending`.
-
-## 4. Synthesis
-
-Read `codex-analysis.md` plus each completed advisor output. Verify consequential claims, compute
-consensus using `confidence-system.md`, and write `synthesis.md` plus:
-
-```json
-{
-  "id": "<SESSION_ID>",
-  "agent": "ultra-verify",
-  "mode": "<mode>",
-  "models": {"codex": "<primary>", "claude": "<advisor>", "gemini": "<advisor>"},
-  "scope": "<scope>",
-  "timestamp": "<ISO 8601>",
-  "confidence": "<consensus|majority|no_consensus>",
-  "degraded": false
-}
-```
-
-If one advisor fails, cap the result at majority and name the missing perspective. If both fail,
-set `degraded: true`, `agents_responded: ["codex"]`, and mark the result single-source.
+Read the bundled references for mode-specific evidence and confidence guidance.
 */ }).match(/\/\*([\s\S]*?)\*\//)[1].trim();
-
 function titleCase(name) {
   const special = {
     'ai-collab-base': 'AI Collaboration Base',
     'cc-collab': 'Claude Code Collaboration',
-    'gemini-collab': 'Gemini Collaboration',
     'use-railway': 'Use Railway',
   };
   if (special[name]) return special[name];
@@ -600,8 +487,6 @@ and does not require an interactive MCP or legacy CLI menu.
 }
 
 function adaptUltraVerifyAsset(input, rel) {
-  if (rel === path.join('references', 'orchestration-flow.md')) return ULTRA_VERIFY_FLOW;
-
   let text = adaptHostText(String(input), '');
   if (rel === path.join('scripts', 'verify_wait.py')) {
     text = text.replaceAll('Codex', 'Claude Code');
@@ -621,7 +506,6 @@ function adaptUltraVerifyAsset(input, rel) {
   text = text.replaceAll('"codex": "<model>"', '"claude": "<advisor>"');
   text = text.replaceAll('["claude"]', '["codex"]');
   text = text.replaceAll('Claude Code-only', 'Codex-only');
-  text = text.replaceAll('Gemini and Claude Code in parallel (native parallel execution)', 'Claude Code and Gemini concurrently');
   text = text.replaceAll('run_in_background', 'native concurrent execution');
   text = text.replaceAll('Bash tool', '`exec_command`');
   text = text.replaceAll('Read tool', 'targeted file reads');
@@ -661,7 +545,7 @@ function adaptHostText(input, skillName = '') {
     text = adaptCodexPrimaryText(text, skillName);
   }
 
-  if (skillName === 'gemini-collab' || skillName === 'ai-collab-base') {
+  if (skillName === 'ai-collab-base') {
     text = text.replaceAll("Claude's", "Codex's");
     text = text.replaceAll('Claude-only', 'Codex-only');
     text = text.replaceAll('Claude ', 'Codex ');
@@ -716,8 +600,7 @@ function adaptHostText(input, skillName = '') {
 function adaptedDescription(sourceDescription, targetName) {
   const special = {
     'cc-collab': 'Ask Claude Code for an independent read-only analysis while Codex owns verification and synthesis. Use only when the user explicitly requests CC or Claude Code collaboration.',
-    'gemini-collab': 'Ask Gemini CLI for an independent read-only analysis while Codex verifies and synthesizes. Use only when the user explicitly requests Gemini collaboration.',
-    'ultra-verify': 'Run Codex-primary three-way verification with read-only Claude Code and Gemini advisors, then verify and synthesize the evidence.',
+    'ultra-verify': 'Run Codex-primary two-model verification with a read-only Claude Code advisor, then verify and synthesize the evidence.',
     'ultra-dev': 'Execute one Ultra task with Codex-native TDD, persistent task.update state, workflow checkpoints, and the native Ultra review agents.',
     'learn': 'Extract one reusable pattern from the current Codex task into a valid user skill, with explicit user approval before writing.',
   };
@@ -730,7 +613,6 @@ function buildSkillMarkdown(sourceText, sourceName, targetName) {
   const { fm, body } = parseFrontmatter(sourceText);
   let adaptedBody;
   if (targetName === 'cc-collab') adaptedBody = CC_COLLAB_BODY;
-  else if (targetName === 'gemini-collab') adaptedBody = GEMINI_COLLAB_BODY;
   else if (targetName === 'ultra-verify') adaptedBody = ULTRA_VERIFY_BODY;
   else adaptedBody = adaptHostText(body, targetName);
   return yaml.dump({
@@ -745,7 +627,6 @@ function buildOpenAiYaml(name, description) {
     COMMAND_NAMES.includes(name)
     || INTERNAL_SKILLS.has(name)
     || name === 'cc-collab'
-    || name === 'gemini-collab'
     || name.startsWith('ultra-')
   );
   const short = description.replace(/\s+/g, ' ').trim().slice(0, 63).replace(/[\s.,;:]+$/, '');

package/adapters/_shared/frontmatter.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 // YAML frontmatter parsing / serialization for markdown assets.
-// Every runtime adapter consumes this — OpenCode lowercases keys,
-// Gemini extracts description for toml, Claude preserves verbatim.
+// Every runtime adapter consumes this — OpenCode lowercases keys while
+// Claude Code and Codex preserve their native metadata contracts.
 
 const yaml = require('js-yaml');
 

package/adapters/_shared/handbook.cjs

@@ -15,21 +15,21 @@ const HOSTS = Object.freeze({
     name: 'Claude Code',
     handbook: ['.claude', 'CLAUDE.md'],
     invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status` and `/ultra-think`',
-    collaboration: '`/codex-collab` and `/gemini-collab` are explicitly requested read-only advisors',
+    collaboration: '`/codex-collab` is an explicitly requested read-only advisor',
     coordination: 'Claude Code task UI is host coordination; it does not replace Ultra task state',
   }),
   codex: Object.freeze({
     name: 'Codex',
     handbook: ['.codex', 'AGENTS.md'],
     invocation: '`$ultra-builder-pro:ultra-init`, `$ultra-builder-pro:ultra-research`, `$ultra-builder-pro:ultra-plan`, `$ultra-builder-pro:ultra-dev`, `$ultra-builder-pro:ultra-test`, `$ultra-builder-pro:ultra-review`, and `$ultra-builder-pro:ultra-deliver`; diagnostics use `$ultra-builder-pro:ultra-status` and `$ultra-builder-pro:ultra-think`',
-    collaboration: '`$ultra-builder-pro:cc-collab` and `$ultra-builder-pro:gemini-collab` are explicitly requested read-only advisors',
+    collaboration: '`$ultra-builder-pro:cc-collab` is an explicitly requested read-only advisor',
     coordination: 'The Codex plan is turn-facing coordination; it does not replace Ultra task state',
   }),
   opencode: Object.freeze({
     name: 'OpenCode',
     handbook: ['.config', 'opencode', 'AGENTS.md'],
     invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status` and `/ultra-think`',
-    collaboration: '`/cc-collab`, `/codex-collab`, and `/gemini-collab` are explicitly requested read-only advisors',
+    collaboration: '`/cc-collab` and `/codex-collab` are explicitly requested read-only advisors',
     coordination: 'OpenCode session coordination does not replace Ultra task state',
   }),
 });

package/adapters/_shared/path-rewrite.cjs

@@ -14,7 +14,6 @@ const RUNTIME_SKILL_ROOT = {
   claude: '.claude/skills',
   opencode: '.config/opencode/skills',
   codex: '.agents/skills',
-  gemini: '.gemini/extensions/ultra-builder-pro/skills',
 };
 
 function parseSkillRef(ref) {
@@ -52,7 +51,6 @@ function runtimeRoot(runtime) {
     case 'claude': return '.claude';
     case 'opencode': return '.config/opencode';
     case 'codex': return '.agents';
-    case 'gemini': return '.gemini/extensions/ultra-builder-pro';
     default: throw new Error(`unknown runtime: ${runtime}`);
   }
 }
@@ -62,7 +60,6 @@ function localRoot(runtime) {
     case 'claude': return '.claude';
     case 'opencode': return '.opencode';
     case 'codex': return '.agents';
-    case 'gemini': return '.gemini/extensions/ultra-builder-pro';
     default: throw new Error(`unknown runtime: ${runtime}`);
   }
 }

package/adapters/_shared/runtime-assets.cjs

@@ -27,11 +27,12 @@ const INTERNAL_AGENT_SKILLS = Object.freeze([
   'testing-rules',
 ]);
 
+const SUPPORTED_RUNTIMES = Object.freeze(['claude', 'opencode', 'codex']);
+
 const COLLAB_SKILLS_BY_RUNTIME = Object.freeze({
-  claude: Object.freeze(['codex-collab', 'gemini-collab', 'ultra-verify']),
-  codex: Object.freeze(['cc-collab', 'gemini-collab', 'ultra-verify']),
-  opencode: Object.freeze(['cc-collab', 'codex-collab', 'gemini-collab', 'ultra-verify']),
-  gemini: Object.freeze(['cc-collab', 'codex-collab', 'ultra-verify']),
+  claude: Object.freeze(['codex-collab', 'ultra-verify']),
+  codex: Object.freeze(['cc-collab', 'ultra-verify']),
+  opencode: Object.freeze(['cc-collab', 'codex-collab', 'ultra-verify']),
 });
 
 const RETIRED_SKILLS = Object.freeze([
@@ -60,11 +61,17 @@ function skillsForRuntime(runtime) {
   return [...CORE_PUBLIC_SKILLS, ...INTERNAL_AGENT_SKILLS, ...collab];
 }
 
+function isSupportedRuntime(runtime) {
+  return SUPPORTED_RUNTIMES.includes(runtime);
+}
+
 module.exports = {
   CORE_PUBLIC_SKILLS,
   INTERNAL_AGENT_SKILLS,
+  SUPPORTED_RUNTIMES,
   COLLAB_SKILLS_BY_RUNTIME,
   RETIRED_SKILLS,
   WORKFLOW_HOOK_FILES,
+  isSupportedRuntime,
   skillsForRuntime,
 };

package/adapters/_shared/tests/path-rewrite.test.cjs

@@ -26,12 +26,10 @@ test('resolveSkillRef routes to runtime-specific root under homeDir', () => {
   const claude = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'claude', homeDir: home });
   const opencode = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'opencode', homeDir: home });
   const codex = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'codex', homeDir: home });
-  const gemini = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'gemini', homeDir: home });
 
   assert.equal(claude, path.join(home, '.claude/skills/ultra-init/SKILL.md'));
   assert.equal(opencode, path.join(home, '.config/opencode/skills/ultra-init/SKILL.md'));
   assert.equal(codex, path.join(home, '.agents/skills/ultra-init/SKILL.md'));
-  assert.equal(gemini, path.join(home, '.gemini/extensions/ultra-builder-pro/skills/ultra-init/SKILL.md'));
 
   assert.throws(
     () => resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'unknown', homeDir: home }),
@@ -47,7 +45,7 @@ test('rewriteWorkflowRefInText + resolveAssetTarget give predictable paths', ()
   assert.equal(out, `see ${path.join(home, '.claude/skills/ultra-init/SKILL.md')} for details`);
 
   // Cover every runtime × every scope so runtimeRoot/localRoot branches hit
-  for (const rt of ['claude', 'opencode', 'codex', 'gemini']) {
+  for (const rt of ['claude', 'opencode', 'codex']) {
     const g = resolveAssetTarget('x', { runtime: rt, scope: 'global', homeDir: home, cwd });
     const l = resolveAssetTarget('x', { runtime: rt, scope: 'local', homeDir: home, cwd });
     assert.ok(g.startsWith(home));

package/adapters/_shared/tests/resolve-target.test.cjs

@@ -1,13 +1,10 @@
 'use strict';
 
-// Phase 4.6b reviewer suggestion — scope-precedence contract across all
-// four adapter.resolveTarget implementations.
+// Scope-precedence contract across every supported adapter.resolveTarget.
 //
 // Each adapter honors the same ordering:
 //   ctx.configDir  >  ctx.scope='global' → env var or homeDir/.<runtime>
 //                  >  ctx.scope='local'  → cwd/.<runtime>
-//
-// Gemini also exposes resolveExtensionRoot that appends extensions/<NAME>.
 
 const { test } = require('node:test');
 const assert = require('node:assert/strict');
@@ -16,7 +13,6 @@ const path = require('node:path');
 const claude = require('../../../adapters/claude.js');
 const opencode = require('../../../adapters/opencode.js');
 const codex = require('../../../adapters/codex.js');
-const gemini = require('../../../adapters/gemini.js');
 
 // Stable fake values so assertions don't depend on real $HOME / $CWD.
 const FAKE_HOME = '/fake-home';
@@ -43,7 +39,6 @@ const CASES = [
   { name: 'claude',   resolve: claude.resolveTarget,   localLeaf: '.claude',   globalHome: '.claude',   envKey: 'CLAUDE_CONFIG_DIR' },
   { name: 'opencode', resolve: opencode.resolveTarget, localLeaf: '.opencode', globalHome: path.join('.config', 'opencode'), envKey: 'OPENCODE_CONFIG_DIR' },
   { name: 'codex',    resolve: codex.resolveTarget,    localLeaf: '.codex',    globalHome: '.codex',    envKey: 'CODEX_HOME' },
-  { name: 'gemini',   resolve: gemini.resolveTarget,   localLeaf: '.gemini',   globalHome: '.gemini',   envKey: 'GEMINI_CONFIG_DIR' },
 ];
 
 for (const tc of CASES) {
@@ -78,8 +73,3 @@ for (const tc of CASES) {
     assert.equal(out, path.join(FAKE_CWD, tc.localLeaf));
   });
 }
-
-test('gemini.resolveExtensionRoot layers extensions/<NAME> on top of resolveTarget', () => {
-  const out = gemini.resolveExtensionRoot({ configDir: '/explicit' });
-  assert.equal(out, path.join('/explicit', 'extensions', 'ultra-builder-pro'));
-});

package/adapters/_shared/tests/runtime-assets.test.cjs

@@ -9,6 +9,7 @@ const REPO_ROOT = path.resolve(__dirname, '..', '..', '..');
 const {
   CORE_PUBLIC_SKILLS,
   INTERNAL_AGENT_SKILLS,
+  SUPPORTED_RUNTIMES,
   COLLAB_SKILLS_BY_RUNTIME,
   RETIRED_SKILLS,
   WORKFLOW_HOOK_FILES,
@@ -51,19 +52,17 @@ test('runtime asset manifest exposes only Ultra-owned core and internal skills',
   assert.deepEqual(RETIRED_SKILLS, RETIRED);
 
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.claude, [
-    'codex-collab', 'gemini-collab', 'ultra-verify',
+    'codex-collab', 'ultra-verify',
   ]);
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.codex, [
-    'cc-collab', 'gemini-collab', 'ultra-verify',
+    'cc-collab', 'ultra-verify',
   ]);
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.opencode, [
-    'cc-collab', 'codex-collab', 'gemini-collab', 'ultra-verify',
-  ]);
-  assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.gemini, [
     'cc-collab', 'codex-collab', 'ultra-verify',
   ]);
+  assert.deepEqual(SUPPORTED_RUNTIMES, ['claude', 'opencode', 'codex']);
 
-  for (const runtime of ['claude', 'codex', 'opencode', 'gemini']) {
+  for (const runtime of SUPPORTED_RUNTIMES) {
     const names = skillsForRuntime(runtime);
     for (const retired of RETIRED) assert.ok(!names.includes(retired));
     assert.ok(!names.some((name) => /impeccable/i.test(name)));