Skip to content

Commit e9661a5

Browse files
popup-kaypopup-kay
authored
Merge pull request #10 from popup-studio-ai/feature/v1.5.7-gemini-032-migration
feat: bkit v1.5.7 - Gemini CLI v0.32.x full migration
2 parents 2b3b6ee + a7e9a92 commit e9661a5

File tree

67 files changed

+7836
-491
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

67 files changed

+7836
-491
lines changed

‎.gemini/context/tool-reference.md‎

Lines changed: 53 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,42 @@
11
## Tool Name Reference
22

3-
bkit uses Gemini CLI native tool names (v0.29.0+ verified):
4-
5-
| Tool | Purpose | Example |
6-
|------|---------|---------|
7-
| `write_file` | Create/overwrite files | Creating new components |
8-
| `replace` | Edit existing files | Modifying code |
9-
| `read_file` | Read file contents | Understanding code |
10-
| `read_many_files` | Read multiple files | Batch analysis |
11-
| `run_shell_command` | Execute shell commands | Git, npm, docker |
12-
| `glob` | Find files by pattern | `**/*.tsx` |
13-
| `grep_search` | Search file contents | Finding definitions |
14-
| `list_directory` | List directory contents | Exploring structure |
15-
| `google_web_search` | Search the web | Finding documentation |
16-
| `web_fetch` | Fetch URL content | Reading web pages |
17-
| `activate_skill` | Load skill context | On-demand expertise |
18-
| `write_todos` | Manage task lists | Task tracking |
19-
| `save_memory` | Save to long-term memory | Cross-session persistence |
20-
| `ask_user` | Ask user a question | Clarifying requirements |
21-
| `get_internal_docs` | Get extension docs | Internal reference |
22-
| `enter_plan_mode` | Enter planning mode | Structured planning (v0.29.0+) |
23-
| `exit_plan_mode` | Exit planning mode | Plan completion (v0.29.0+) |
24-
25-
## Tool Alias Reference (v1.5.6)
3+
bkit uses Gemini CLI native tool names (v0.29.0~v0.32.1 verified):
4+
5+
| Tool | Purpose | Category | Since |
6+
|------|---------|----------|-------|
7+
| `write_file` | Create/overwrite files | File | v0.29.0 |
8+
| `replace` | Edit existing files | File | v0.29.0 |
9+
| `read_file` | Read file contents | File | v0.29.0 |
10+
| `read_many_files` | Read multiple files | File | v0.29.0 |
11+
| `run_shell_command` | Execute shell commands | Shell | v0.29.0 |
12+
| `glob` | Find files by pattern | Search | v0.29.0 |
13+
| `grep_search` | Search file contents | Search | v0.29.0 |
14+
| `list_directory` | List directory contents | Search | v0.29.0 |
15+
| `google_web_search` | Search the web | Web | v0.29.0 |
16+
| `web_fetch` | Fetch URL content | Web | v0.29.0 |
17+
| `activate_skill` | Load skill context | Skill | v0.29.0 |
18+
| `write_todos` | Manage task lists | Task | v0.29.0 |
19+
| `save_memory` | Save to long-term memory | Memory | v0.29.0 |
20+
| `ask_user` | Ask user a question | Interaction | v0.29.0 |
21+
| `get_internal_docs` | Get extension docs | Reference | v0.29.0 |
22+
| `enter_plan_mode` | Enter planning mode | Planning | v0.29.0 |
23+
| `exit_plan_mode` | Exit planning mode | Planning | v0.29.0 |
24+
| `tracker_create_task` | Create tracker task | Task Tracker | v0.32.0 |
25+
| `tracker_update_task` | Update tracker task | Task Tracker | v0.32.0 |
26+
| `tracker_get_task` | Get tracker task details | Task Tracker | v0.32.0 |
27+
| `tracker_list_tasks` | List tracker tasks | Task Tracker | v0.32.0 |
28+
| `tracker_add_dependency` | Add task dependency | Task Tracker | v0.32.0 |
29+
| `tracker_visualize` | Visualize task graph | Task Tracker | v0.32.0 |
30+
31+
## Breaking Changes (v0.32.0)
32+
33+
| ID | Tool | Change | Impact |
34+
|----|------|--------|--------|
35+
| BC-1 | `grep_search` | `include_pattern` renamed to `file_pattern` | Use version-detector to select correct param |
36+
| BC-2 | `read_file` | New `start_line`/`end_line` params (replaces `offset`/`limit` usage) | Optional enhancement for v0.32.0+ |
37+
| BC-3 | `replace` | New `allow_multiple` param for multi-occurrence replace | Optional enhancement for v0.32.0+ |
38+
39+
## Tool Alias Reference (v1.5.7)
2640

2741
### Forward Aliases (Future Compatibility)
2842

@@ -38,7 +52,16 @@ These aliases are pre-mapped for potential future Gemini CLI tool renames:
3852

3953
bkit-gemini resolves both current and future names automatically via `tool-registry.js`.
4054

41-
## Tool Annotations (v1.5.6)
55+
### Claude Code Mappings (v1.5.7)
56+
57+
| Claude Code Tool | Gemini CLI Tool |
58+
|-----------------|-----------------|
59+
| TaskCreate | tracker_create_task |
60+
| TaskUpdate | tracker_update_task |
61+
| TaskGet | tracker_get_task |
62+
| TaskList | tracker_list_tasks |
63+
64+
## Tool Annotations (v1.5.7)
4265

4366
Tool annotations provide hints for Gemini CLI's v0.31.0+ trust model and parallel execution:
4467

@@ -61,6 +84,12 @@ Tool annotations provide hints for Gemini CLI's v0.31.0+ trust model and paralle
6184
| `run_shell_command` | false | true | false |
6285
| `enter_plan_mode` | false | false | true |
6386
| `exit_plan_mode` | false | false | true |
87+
| `tracker_create_task` | false | false | false |
88+
| `tracker_update_task` | false | false | false |
89+
| `tracker_get_task` | true | false | true |
90+
| `tracker_list_tasks` | true | false | true |
91+
| `tracker_add_dependency` | false | false | false |
92+
| `tracker_visualize` | true | false | true |
6493

6594
- **readOnlyHint**: Tool does not modify state
6695
- **destructiveHint**: Tool may cause irreversible side effects

‎.gemini/policies/bkit-starter-policy.toml‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# bkit-gemini v1.5.7 - Starter Level Policy
2+
# Restrictive policy for beginners - safe defaults
3+
# Auto-generated for Gemini CLI v0.31.0+ Project-Level Policy Engine (Tier 3)
4+
# Generated: 2026-03-04
5+
6+
[[rule]]
7+
toolName = "write_file"
8+
decision = "ask_user"
9+
priority = 30
10+
11+
[[rule]]
12+
toolName = "replace"
13+
decision = "ask_user"
14+
priority = 30
15+
16+
[[rule]]
17+
toolName = "run_shell_command"
18+
decision = "ask_user"
19+
priority = 40
20+
21+
[[rule]]
22+
toolName = "run_shell_command"
23+
commandPrefix = "rm"
24+
decision = "deny"
25+
priority = 100
26+
27+
[[rule]]
28+
toolName = "run_shell_command"
29+
commandPrefix = "git push --force"
30+
decision = "deny"
31+
priority = 100
32+
33+
[[rule]]
34+
toolName = "run_shell_command"
35+
commandPrefix = "git reset --hard"
36+
decision = "deny"
37+
priority = 100
38+
39+
[[rule]]
40+
toolName = "read_file"
41+
decision = "allow"
42+
priority = 10
43+
44+
[[rule]]
45+
toolName = "glob"
46+
decision = "allow"
47+
priority = 10
48+
49+
[[rule]]
50+
toolName = "grep_search"
51+
decision = "allow"
52+
priority = 10
53+
54+
[[rule]]
55+
toolName = "google_web_search"
56+
decision = "allow"
57+
priority = 10

‎.pdca-status.json‎

Lines changed: 35 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,47 @@
11
{
22
"version": "2.0",
3+
"primaryFeature": "bkit-v157-doc-sync",
34
"activeFeatures": {
4-
"bkit-gemini-comprehensive-test": {
5+
"bkit-v157-doc-sync": {
6+
"phase": "completed",
7+
"matchRate": 100,
8+
"iterationCount": 0,
9+
"lastUpdated": "2026-03-04T00:00:00Z",
10+
"completedAt": "2026-03-04T00:00:00Z",
11+
"documents": {
12+
"plan": "docs/01-plan/features/bkit-v157-doc-sync.plan.md",
13+
"design": "docs/02-design/features/bkit-v157-doc-sync.design.md",
14+
"analysis": "docs/03-analysis/bkit-v157-doc-sync.analysis.md",
15+
"report": "docs/04-report/features/bkit-v157-doc-sync.report.md"
16+
}
17+
},
18+
"bkit-v157-comprehensive-test": {
519
"phase": "completed",
620
"matchRate": 100,
721
"iterationCount": 1,
8-
"lastUpdated": "2026-02-01T00:00:00Z",
9-
"completedAt": "2026-02-01T00:00:00Z",
22+
"lastUpdated": "2026-03-04T00:00:00Z",
23+
"completedAt": "2026-03-04T00:00:00Z",
1024
"documents": {
11-
"plan": "docs/01-plan/features/bkit-gemini-comprehensive-test.plan.md",
12-
"design": "docs/02-design/features/bkit-gemini-comprehensive-test.design.md",
13-
"report": "docs/04-report/features/bkit-gemini-comprehensive-test.report.md"
14-
},
15-
"note": "Test feature - not archived"
25+
"plan": "docs/01-plan/features/bkit-v157-comprehensive-test.plan.md",
26+
"design": "docs/02-design/features/bkit-v157-comprehensive-test.design.md",
27+
"report": "docs/04-report/features/bkit-v157-comprehensive-test.report.md"
28+
}
1629
}
1730
},
1831
"archivedFeatures": {
32+
"gemini-cli-032-migration": {
33+
"phase": "archived",
34+
"matchRate": 100,
35+
"iterationCount": 1,
36+
"archivedAt": "2026-03-04T00:00:00Z",
37+
"archivedTo": "docs/archive/2026-03/gemini-cli-032-migration/"
38+
},
39+
"bkit-gemini-comprehensive-test": {
40+
"phase": "archived",
41+
"matchRate": 100,
42+
"archivedAt": "2026-03-04T00:00:00Z",
43+
"archivedTo": "docs/archive/2026-02/bkit-gemini-comprehensive-test/"
44+
},
1945
"bkit-gemini-conversion": {
2046
"phase": "archived",
2147
"matchRate": 100,
@@ -40,5 +66,5 @@
4066
"currentPhase": 9,
4167
"phaseHistory": []
4268
},
43-
"lastChecked": "2026-02-01T00:00:00Z"
69+
"lastChecked": "2026-03-04T00:00:00Z"
4470
}

‎CHANGELOG.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,36 @@ All notable changes to bkit-gemini will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [1.5.7] - 2026-03-04
9+
10+
### Added
11+
- 6 Task Tracker tool registrations (v0.32.0+): tracker_create_task, tracker_update_task, tracker_get_task, tracker_list_tasks, tracker_add_dependency, tracker_visualize
12+
- 11 v0.32.0+ feature flags in version-detector (hasTaskTracker, hasModelFamilyToolsets, hasExtensionPolicies, hasPlanModeEnhanced, hasA2AStreaming, hasShellAutocompletion, hasGrepIncludePatternRename, hasReadFileLineParams, hasReplaceAllowMultiple, hasExcludeToolsRemoved, hasParallelExtensionLoading)
13+
- Nightly version format parsing support in version-detector
14+
- Extension-level TOML policy (Tier 2) replacing deprecated excludeTools
15+
- Task Tracker - PDCA Bridge module (tracker-bridge.js) with instruction-based architecture
16+
- AfterAgent loop guard (Issue #20426 mitigation) with MAX_REENTRY=3
17+
- Sub-agent timeout cap (600s) and non-interactive mode for v0.32.0+
18+
- New hooks/runtime-hooks.js SDK registration module for HookSystem.registerHook()
19+
- 4 Claude→Gemini tool mappings: TaskCreate, TaskUpdate, TaskGet, TaskList
20+
21+
### Changed
22+
- 6 hot-path hook scripts converted to SDK dual-mode (handler export + stdin command fallback)
23+
- hook-adapter.js activated with activateRuntimeHooks(), loadHookHandler(), getMigrationStatus()
24+
- Policy Engine extended to 4-tier system (Default/Extension/Workspace/Admin)
25+
- Tool registry expanded from 17 to 23 built-in tools
26+
- Tool reference docs updated for 23 tools with Breaking Changes section
27+
- 4 agent frontmatters updated with tracker tools (cto-lead, product-manager, pdca-iterator, qa-strategist)
28+
- 3 skill frontmatters updated with tracker tools (pdca, development-pipeline, phase-8-review)
29+
- session-start.js integrates tracker context injection and extension policy generation
30+
- bkit.config.json updated with runtimeHooks and taskTracker compatibility sections
31+
32+
### Removed
33+
- excludeTools from gemini-extension.json (replaced by Extension TOML policy)
34+
35+
### Fixed
36+
- validateTomlStructure() now validates toolName field casing (rejects lowercase `toolname`)
37+
838
## [1.5.6] - 2026-02-28
939

1040
### Added
@@ -249,6 +279,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
249279

250280
---
251281

282+
[1.5.7]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.6...v1.5.7
252283
[1.5.6]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.5...v1.5.6
253284
[1.5.5]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.4...v1.5.5
254285
[1.5.4]: https://github.com/popup-studio-ai/bkit-gemini/compare/v1.5.3...v1.5.4

‎GEMINI.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# bkit Vibecoding Kit v1.5.6 - Gemini CLI Edition
1+
# bkit Vibecoding Kit v1.5.7 - Gemini CLI Edition
22

33
> AI-native development toolkit implementing PDCA methodology with Context Engineering
44
@@ -58,5 +58,5 @@ docs/
5858

5959
---
6060

61-
*bkit Vibecoding Kit v1.5.6 - Empowering AI-native development*
61+
*bkit Vibecoding Kit v1.5.7 - Empowering AI-native development*
6262
*Copyright 2024-2026 POPUP STUDIO PTE. LTD.*

‎README.md‎

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# bkit - Vibecoding Kit (Gemini CLI Edition)
22

33
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
4-
[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-v0.29.0~v0.31.0-blue.svg)](https://github.com/google-gemini/gemini-cli)
5-
[![Version](https://img.shields.io/badge/Version-1.5.6-green.svg)](CHANGELOG.md)
4+
[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-v0.29.0~v0.32.1-blue.svg)](https://github.com/google-gemini/gemini-cli)
5+
[![Version](https://img.shields.io/badge/Version-1.5.7-green.svg)](CHANGELOG.md)
66
[![Author](https://img.shields.io/badge/Author-POPUP%20STUDIO-orange.svg)](https://popupstudio.ai)
77

88
> **PDCA methodology + Context Engineering for AI-native development**
@@ -62,7 +62,7 @@ Event 10: SessionEnd -> Session cleanup, memory persistence
6262

6363
```
6464
bkit-gemini/
65-
|-- gemini-extension.json # Extension manifest (v1.5.6)
65+
|-- gemini-extension.json # Extension manifest (v1.5.7)
6666
|-- GEMINI.md # Global context with 6 @import modules
6767
|-- bkit.config.json # Centralized configuration (12 sections)
6868
|-- CHANGELOG.md # Version history
@@ -166,10 +166,11 @@ bkit-gemini/
166166
| | +-- permission.js # Glob pattern permission engine (381 lines)
167167
| +-- adapters/gemini/
168168
| |-- index.js # Platform adapter with TOOL_MAP
169-
| |-- tool-registry.js # Tool name registry + Annotations (v0.29.0~v0.31.0)
170-
| |-- version-detector.js # 3-strategy CLI version detection + 17 feature flags
171-
| |-- policy-migrator.js # Permission -> TOML Policy + Level Policy (v0.30.0+)
172-
| |-- hook-adapter.js # RuntimeHook function detection (v0.31.0 prep)
169+
| |-- tool-registry.js # Tool name registry + Annotations (v0.29.0~v0.32.1, 23 tools)
170+
| |-- version-detector.js # 3-strategy CLI version detection + 34 feature flags
171+
| |-- policy-migrator.js # Permission -> TOML Policy + Extension/Level Policy (v0.30.0+)
172+
| |-- hook-adapter.js # RuntimeHook SDK integration (v0.31.0+)
173+
| |-- tracker-bridge.js # Task Tracker - PDCA Bridge (v0.32.0+)
173174
| |-- context-fork.js # Snapshot isolation, LRU(10) (477 lines)
174175
| +-- import-resolver.js # @import resolution (118 lines)
175176
|
@@ -181,6 +182,16 @@ bkit-gemini/
181182

182183
## Features
183184

185+
### v1.5.7 Highlights
186+
187+
- **Gemini CLI v0.32.x Compatibility** -- 11 new feature flags for Task Tracker, Extension Policies, Model Family Toolsets, A2A Streaming, and more
188+
- **23 Built-in Tools** -- 6 new Task Tracker tools registered (tracker_create_task, tracker_update_task, tracker_get_task, tracker_list_tasks, tracker_add_dependency, tracker_visualize)
189+
- **SDK RuntimeHook Dual-Mode** -- 6 hot-path hooks converted to SDK function export + stdin command fallback for 40-97% latency reduction
190+
- **Extension Policy Engine** -- Tier 2 TOML extension policy replacing deprecated excludeTools in gemini-extension.json
191+
- **Task Tracker - PDCA Bridge** -- Instruction-based bridge connecting PDCA workflow to native Task Tracker (v0.32.0+)
192+
- **Bug Guards** -- AfterAgent loop guard (Issue #20426) and sub-agent timeout cap (600s) with SIGTERM→SIGKILL escalation
193+
- **Nightly Version Parsing** -- parseVersion() now handles `0.34.0-nightly.20260304` format
194+
184195
### v1.5.6 Highlights
185196

186197
- **Gemini CLI v0.31.0 Compatibility** -- 9 new feature flags including RuntimeHook functions, Browser Agent, Tool Annotations, and Project-Level Policy
@@ -391,7 +402,7 @@ All 16 agents remember context across sessions automatically:
391402

392403
### Team Mode Foundation
393404

394-
bkit v1.5.6 includes team mode foundation with 3 MCP tools:
405+
bkit includes team mode foundation with 3 MCP tools:
395406
- `team_create` -- Create agent teams with configurable strategies
396407
- `team_assign` -- Assign tasks to team members
397408
- `team_status` -- Monitor team progress
@@ -533,6 +544,10 @@ bkit uses Gemini CLI native tool names (v0.29.0+ verified from source):
533544
| SaveMemory | save_memory |
534545
| EnterPlanMode | enter_plan_mode |
535546
| ExitPlanMode | exit_plan_mode |
547+
| TaskCreate | tracker_create_task |
548+
| TaskUpdate | tracker_update_task |
549+
| TaskGet | tracker_get_task |
550+
| TaskList | tracker_list_tasks |
536551

537552
---
538553

@@ -612,7 +627,7 @@ These hooks are non-interactive, performance-optimized, and essential for the Co
612627

613628
| Requirement | Version |
614629
|-------------|---------|
615-
| Gemini CLI | v0.29.0+ (forward-compatible with v0.31.0 Policy Engine + Tool Annotations) |
630+
| Gemini CLI | v0.29.0+ (forward-compatible with v0.32.1 Task Tracker + Extension Policies) |
616631
| Node.js | v18+ (for hook scripts) |
617632
| Git | Any recent version |
618633

‎agents/cto-lead.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ tools:
3333
- run_shell_command
3434
- google_web_search
3535
- web_fetch
36+
- tracker_create_task
37+
- tracker_update_task
38+
- tracker_list_tasks
39+
- tracker_visualize
3640
temperature: 0.4
3741
max_turns: 30
3842
timeout_mins: 15

‎agents/pdca-iterator.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ tools:
3333
- grep_search
3434
- glob
3535
- run_shell_command
36+
- tracker_update_task
37+
- tracker_get_task
3638
temperature: 0.4
3739
max_turns: 30
3840
timeout_mins: 15

‎agents/product-manager.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ tools:
2828
- grep_search
2929
- google_web_search
3030
- web_fetch
31+
- tracker_create_task
32+
- tracker_list_tasks
3133
temperature: 0.6
3234
max_turns: 15
3335
timeout_mins: 10

‎agents/qa-strategist.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ tools:
2727
- glob
2828
- grep_search
2929
- run_shell_command
30+
- tracker_list_tasks
31+
- tracker_visualize
3032
temperature: 0.3
3133
max_turns: 20
3234
timeout_mins: 10

0 commit comments

Comments
 (0)