fix: Gemini CLI v0.29.0+ compatibility - fix all tool names (Issue #5)

BREAKING: Minimum Gemini CLI version changed from v0.28.0 to v0.29.0

- Add centralized Tool Registry module (lib/adapters/gemini/tool-registry.js)
  with all 17 built-in tool names verified from Gemini CLI source code
- Fix glob_tool→glob in 16 agents and 29 skills (was never a valid name)
- Fix web_search→google_web_search in 7 agents and 10 skills
- Fix Grep→grep_search, Skill→activate_skill in adapter TOOL_MAP
- Remove spawn_agent from cto-lead agent and pdca skill (not a built-in tool)
- Remove experimental.skills block from gemini-extension.json (GA since v0.26.0)
- Update hook scripts to use Tool Registry instead of hardcoded tool names
- Fix hooks.json AfterTool matcher: skill→activate_skill
- Bump version to v1.5.3 across all config files
- Add 4 new test cases (CFG-03, CFG-06~08) for tool name validation
- Test suite: 70/72 pass (97.2%)

Resolves #5

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: popup-kay

.gemini/context/tool-reference.md

@@ -1,6 +1,6 @@
 ## Tool Name Reference
 
-bkit uses Gemini CLI native tool names:
+bkit uses Gemini CLI native tool names (v0.29.0+ verified):
 
 | Tool | Purpose | Example |
 |------|---------|---------|
@@ -10,10 +10,14 @@ bkit uses Gemini CLI native tool names:
 | `read_many_files` | Read multiple files | Batch analysis |
 | `run_shell_command` | Execute shell commands | Git, npm, docker |
 | `glob` | Find files by pattern | `**/*.tsx` |
-| `grep` | Search file contents | Finding definitions |
+| `grep_search` | Search file contents | Finding definitions |
 | `list_directory` | List directory contents | Exploring structure |
-| `web_search` | Search the web | Finding documentation |
+| `google_web_search` | Search the web | Finding documentation |
 | `web_fetch` | Fetch URL content | Reading web pages |
-| `spawn_agent` | Launch sub-agent | Complex multi-step tasks |
-| `task_write` | Manage tasks | Task tracking |
 | `activate_skill` | Load skill context | On-demand expertise |
+| `write_todos` | Manage task lists | Task tracking |
+| `save_memory` | Save to long-term memory | Cross-session persistence |
+| `ask_user` | Ask user a question | Clarifying requirements |
+| `get_internal_docs` | Get extension docs | Internal reference |
+| `enter_plan_mode` | Enter planning mode | Structured planning (v0.29.0+) |
+| `exit_plan_mode` | Exit planning mode | Plan completion (v0.29.0+) |

CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to bkit-gemini will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.3] - 2026-02-19
+
+### Added
+
+- **Tool Registry Module**: `lib/adapters/gemini/tool-registry.js` - Centralized Source of Truth for all 17 Gemini CLI built-in tool names, verified from source code
+- **v0.30.0 Policy Engine Detection**: Compatibility layer that detects Policy Engine TOML files and logs warnings for future migration
+- **Plan Mode Tool Mapping**: `enter_plan_mode`, `exit_plan_mode` added to TOOL_MAP (v0.29.0+ new tools)
+- **New TOOL_MAP Entries**: `SaveMemory` -> `save_memory`, `TodoWrite` -> `write_todos`
+
+### Fixed
+
+- **CRITICAL: All 16 Agents Loading Failure** (Issue #5): `glob_tool` was never a valid Gemini CLI tool name - corrected to `glob` across all 16 agent frontmatter files
+- **7 Agents Web Search Failure**: `web_search` corrected to `google_web_search` (cto-lead, enterprise-expert, frontend-architect, gap-detector, product-manager, security-architect, starter-guide)
+- **29 Skills Tool Name Errors**: `glob_tool` -> `glob` in all skill `allowed-tools` frontmatter
+- **11 Skills Web Search Errors**: `web_search` -> `google_web_search` in affected skill frontmatter
+- **TOOL_MAP Corrections**: `Grep: 'grep'` -> `'grep_search'`, `WebSearch: 'web_search'` -> `'google_web_search'`, `Skill: 'skill'` -> `'activate_skill'`
+- **Hook Scripts**: `before-tool-selection.js` readOnlyTools array updated to use Tool Registry (removed invalid `glob_tool`, `web_search`, `task_write`, `spawn_agent`)
+- **hooks.json Matcher**: `"skill"` -> `"activate_skill"` for AfterTool skill matcher
+- **after-tool.js**: `toolName === 'skill'` -> `toolName === 'activate_skill'`
+- **cto-lead Agent**: Removed non-existent `spawn_agent` from tools (not a built-in tool)
+- **pdca Skill**: Removed non-existent `spawn_agent` from allowed-tools
+
+### Changed
+
+- **Minimum Gemini CLI Version**: v0.28.0 -> **v0.29.0** (tool name changes require v0.29.0+)
+- **gemini-extension.json**: Removed `experimental.skills` block (Skills/Hooks GA since v0.26.0)
+- **TOOL_MAP Architecture**: Now imports from Tool Registry instead of hardcoded values
+- **before-tool-selection.js**: Uses `getReadOnlyTools()` from Tool Registry instead of hardcoded array
+- **hooks.json**: Version description updated to v1.5.3
+- **README.md**: Updated version badges, tool mapping table, compatibility requirements, component map
+
+### Documentation
+
+- **tool-reference.md**: Complete rewrite with all 17 built-in tools (v0.29.0+ verified)
+- **README.md**: Added v1.5.3 highlights section, updated all version references
+- **Philosophy Docs**: Updated bkit-system/philosophy for v1.5.3 Tool Registry and Context Engineering principles
+
 ## [1.5.2] - 2026-02-14
 
 ### Added
@@ -124,6 +161,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+[1.5.3]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.2...v1.5.3
 [1.5.2]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.1...v1.5.2
 [1.5.1]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.0...v1.5.1
 [1.5.0]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.4.0...v1.5.0

README.md

@@ -1,8 +1,8 @@
 # bkit - Vibecoding Kit (Gemini CLI Edition)
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-v0.28.0+-blue.svg)](https://github.com/google-gemini/gemini-cli)
-[![Version](https://img.shields.io/badge/Version-1.5.2-green.svg)](CHANGELOG.md)
+[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-v0.29.0+-blue.svg)](https://github.com/google-gemini/gemini-cli)
+[![Version](https://img.shields.io/badge/Version-1.5.3-green.svg)](CHANGELOG.md)
 [![Author](https://img.shields.io/badge/Author-POPUP%20STUDIO-orange.svg)](https://popupstudio.ai)
 
 > **PDCA methodology + Context Engineering for AI-native development**
@@ -62,7 +62,7 @@ Event 10: SessionEnd           -> Session cleanup, memory persistence
 
 ```
 bkit-gemini/
-|-- gemini-extension.json         # Extension manifest (v1.5.2)
+|-- gemini-extension.json         # Extension manifest (v1.5.3)
 |-- GEMINI.md                     # Global context with 6 @import modules
 |-- bkit.config.json              # Centralized configuration (12 sections)
 |-- CHANGELOG.md                  # Version history
@@ -165,6 +165,8 @@ bkit-gemini/
 |   |   |-- agent-memory.js       # Per-agent persistence (214 lines)
 |   |   +-- permission.js         # Glob pattern permission engine (381 lines)
 |   +-- adapters/gemini/
+|       |-- index.js              # Platform adapter with TOOL_MAP
+|       |-- tool-registry.js      # Centralized tool name registry (v0.29.0+ verified)
 |       |-- context-fork.js       # Snapshot isolation, LRU(10) (477 lines)
 |       +-- import-resolver.js    # @import resolution (118 lines)
 |
@@ -176,6 +178,13 @@ bkit-gemini/
 
 ## Features
 
+### v1.5.3 Highlights
+
+- **Gemini CLI v0.29.0+ Compatibility** -- All tool names verified from source code (Issue #5 fix)
+- **Tool Registry Module** -- Centralized tool name management for future-proof maintenance
+- **17 Built-in Tools Mapped** -- Including new Plan Mode tools (enter_plan_mode, exit_plan_mode)
+- **v0.30.0 Readiness** -- Policy Engine detection layer for smooth migration
+
 ### v1.5.2 Highlights
 
 - **8 bkend.ai Domain Skills** -- quickstart, auth, data, storage, mcp, security, cookbook, guides
@@ -206,7 +215,7 @@ bkit-gemini/
 
 ### Prerequisites
 
-- [Gemini CLI](https://github.com/google-gemini/gemini-cli) v0.28.0 or later
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli) v0.29.0 or later
 - [Git](https://git-scm.com/) installed on your machine
 
 ### Installation
@@ -238,7 +247,7 @@ gemini extensions list
 
 ### Hooks Configuration
 
-Hooks are **enabled by default** in Gemini CLI v0.28.0+. If you need to manually configure:
+Hooks are **enabled by default** in Gemini CLI v0.29.0+. If you need to manually configure:
 
 ```json
 // ~/.gemini/settings.json
@@ -363,7 +372,7 @@ All 16 agents remember context across sessions automatically:
 
 ### Team Mode Foundation
 
-bkit v1.5.2 includes team mode foundation with 3 MCP tools:
+bkit v1.5.3 includes team mode foundation with 3 MCP tools:
 - `team_create` -- Create agent teams with configurable strategies
 - `team_assign` -- Assign tasks to team members
 - `team_status` -- Monitor team progress
@@ -487,7 +496,7 @@ Current status:
 
 ## Tool Name Mapping
 
-bkit uses Gemini CLI native tool names:
+bkit uses Gemini CLI native tool names (v0.29.0+ verified from source):
 
 | Claude Code Tool | Gemini CLI Tool |
 |------------------|-----------------|
@@ -496,12 +505,15 @@ bkit uses Gemini CLI native tool names:
 | Read | read_file |
 | Bash | run_shell_command |
 | Glob | glob |
-| Grep | grep |
-| WebSearch | web_search |
+| Grep | grep_search |
+| WebSearch | google_web_search |
 | WebFetch | web_fetch |
-| Task | spawn_agent |
-| TodoWrite | task_write |
-| TodoRead | task_read |
+| AskUserQuestion | ask_user |
+| Skill | activate_skill |
+| TodoWrite | write_todos |
+| SaveMemory | save_memory |
+| EnterPlanMode | enter_plan_mode |
+| ExitPlanMode | exit_plan_mode |
 
 ---
 
@@ -581,7 +593,7 @@ These hooks are non-interactive, performance-optimized, and essential for the Co
 
 | Requirement | Version |
 |-------------|---------|
-| Gemini CLI | v0.28.0+ |
+| Gemini CLI | v0.29.0+ |
 | Node.js | v18+ (for hook scripts) |
 | Git | Any recent version |
 
@@ -593,7 +605,7 @@ These hooks are non-interactive, performance-optimized, and essential for the Co
 | 10 Hook Events | All 10 events registered with matcher patterns |
 | @import syntax | 6 context modules in `.gemini/context/` |
 | TOML commands with `@{}`, `!{}`, `{{}}` | 18 enhanced commands |
-| Agent Skills (experimental) | 29 skills with progressive disclosure |
+| Agent Skills (GA since v0.26.0) | 29 skills with progressive disclosure |
 | MCP servers | 6 tools via `spawn-agent-server.js` |
 | Extension manifest `settings` | 2 user-configurable options |
 | `${extensionPath}` variable | Used in hooks.json for portable paths |
@@ -629,7 +641,7 @@ bkit-gemini is a fork of [bkit-claude-code](https://github.com/popup-studio-ai/b
 | Variables | N/A | `${extensionPath}`, `${workspacePath}` |
 | Hooks | Claude Code hooks | Gemini CLI 10-event hook system |
 | Commands | Slash commands | TOML commands with `@`, `!`, `{{}}` syntax |
-| Skills | Native skills | Experimental skills (enabled via manifest) |
+| Skills | Native skills | Skills (GA since v0.26.0) |
 | Agent format | .md with custom fields | .md with Gemini native frontmatter |
 
 ---

agents/bkend-expert.md

@@ -26,7 +26,7 @@ tools:
   - read_file
   - write_file
   - replace
-  - glob_tool
+  - glob
   - grep_search
   - run_shell_command
   - web_fetch

agents/code-analyzer.md

@@ -22,7 +22,7 @@ tools:
   - read_file
   - read_many_files
   - grep_search
-  - glob_tool
+  - glob
   - list_directory
 temperature: 0.2
 max_turns: 20

agents/cto-lead.md

@@ -28,12 +28,11 @@ tools:
   - write_file
   - replace
   - grep_search
-  - glob_tool
+  - glob
   - list_directory
   - run_shell_command
-  - web_search
+  - google_web_search
   - web_fetch
-  - spawn_agent
 temperature: 0.3
 max_turns: 30
 timeout_mins: 15

agents/design-validator.md

@@ -22,7 +22,7 @@ tools:
   - read_file
   - read_many_files
   - grep_search
-  - glob_tool
+  - glob
   - list_directory
 temperature: 0.1
 max_turns: 15

agents/enterprise-expert.md

@@ -22,9 +22,9 @@ tools:
   - read_file
   - write_file
   - replace
-  - glob_tool
+  - glob
   - grep_search
-  - web_search
+  - google_web_search
 temperature: 0.2
 max_turns: 25
 timeout_mins: 10

agents/frontend-architect.md

@@ -27,10 +27,10 @@ tools:
   - read_file
   - write_file
   - replace
-  - glob_tool
+  - glob
   - grep_search
   - run_shell_command
-  - web_search
+  - google_web_search
 temperature: 0.3
 max_turns: 20
 timeout_mins: 10

agents/gap-detector.md

@@ -21,9 +21,9 @@ tools:
   - read_file
   - read_many_files
   - grep_search
-  - glob_tool
+  - glob
   - list_directory
-  - web_search
+  - google_web_search
 temperature: 0.1
 max_turns: 20
 timeout_mins: 10