# v0.19.7 Release Notes

> v0.19.6 -> v0.19.7

## Summary

Tool registry hardening: tool descriptions and JSON schemas now follow the reviewer ruleset (single-sentence English, defaults on every optional field), tool identifiers are renamed to canonical snake_case (`patch_edit`→`patch_file`, `analyze_youtube`→`fetch_youtube_transcript`, `select_skill`→`activate_skill`, `read_tool_error`→`read_error_memory`, plus `script_*` separator normalization), scheduler and agent tool packages are reorganized into per-domain subpackages, Gemini joins the external agent roster, and the new tool-reviewer and code-reviewer skills land alongside a code-reviewer entropy bugfix.

<details>
<summary>翻譯</summary>
工具註冊強化：tool description 與 JSON schema 全面對齊 reviewer 規範（單句英文、optional 欄位一律帶 default）；tool 識別字統一改為標準 snake_case（`patch_edit`→`patch_file`、`analyze_youtube`→`fetch_youtube_transcript`、`select_skill`→`activate_skill`、`read_tool_error`→`read_error_memory`，並把 `script_*` 系列的分隔符正規化）；scheduler 與 agent tool package 依領域拆分子套件；Gemini 加入外部 agent 行列；同時新增 tool-reviewer 與 code-reviewer 兩支 skill 並修正 code-reviewer entropy 誤判。
</details>

## Changes

### FIX
- Fix code-reviewer entropy rule misclassifying MIME types (@pardnchiu) [381f46f]

<details>
<summary>翻譯</summary>

- 修正 code-reviewer entropy 規則誤將 MIME type 字串判為高熵秘密

</details>

### REFACTOR
- Rename tools to canonical snake_case identifiers and update docs (@pardnchiu) [62b3a2f]
- Align tool descriptions and schema defaults with reviewer rules (@pardnchiu) [a800c3e]
- Reorganize agent tool modules and align external call APIs (@pardnchiu) [d1235a9]
- Reorganize scheduler tools into nested cron, task, and script packages (@pardnchiu) [752fd96]
- Align scheduler tool contracts and messages in English (@pardnchiu) [1fd4ecb]
- Align cron tool schemas and responses with English naming (@pardnchiu) [b8f97a4]
- Split task and script scheduler tools into dedicated packages (@pardnchiu) [1cd5274]
- Modularize cron tools and rename tool searcher package (@pardnchiu) [a82c49c]
- Consolidate skill selection registration into toolSearcher package (@pardnchiu) [dcc85f8]
- Consolidate tool discovery registration into tool package (@pardnchiu) [9aba471]
- Refactor project analyzer and update version doc paths (@pardnchiu) [7617759]

<details>
<summary>翻譯</summary>

- 將 tool 識別字統一改為標準 snake_case 並同步更新文件
- 對齊所有 tool description 與 schema default 至 reviewer 規範
- 重整 agent tool 子模組並對齊外部呼叫 API
- 將 scheduler 工具拆分為 cron／task／script 巢狀子 package
- 對齊 scheduler tool 契約與回應訊息為英文
- 對齊 cron tool schema 與回應為英文命名
- 將 task 與 script scheduler tool 拆至獨立 package
- 模組化 cron tool 並更名 tool searcher package
- 將 skill selection 註冊整合至 toolSearcher package
- 將 tool discovery 註冊整合至 tool package
- 重構 project analyzer，並更新 version 文件輸出路徑

</details>

### ADD
- Add tool-reviewer skill with scanner, rules, and report templates (@pardnchiu) [07ae076]
- Add Gemini external agent support and configuration (@pardnchiu) [8ef3684]
- Add code reviewer skill and fix readFile path resolution (@pardnchiu) [7abad71]

<details>
<summary>翻譯</summary>

- 新增 tool-reviewer skill，含 scanner、規則文件與報告模板
- 新增 Gemini 外部 agent 支援與相關設定
- 新增 code-reviewer skill，並修正 readFile 的路徑解析

</details>

## Scope

- `internal/tools/` — REFACTOR (tool descriptions/schemas, snake_case identifier renames, scheduler and searcher structure cleanup)
- `internal/tools/file/{patchEdit.go→patchFile.go}` — REFACTOR (`patch_edit`→`patch_file`)
- `internal/tools/errorMemory/{readToolError.go→readErrorMemory.go}` — REFACTOR (`read_tool_error`→`read_error_memory`)
- `internal/tools/searcher/{selectSkill.go→activateSkill.go}` — REFACTOR (`select_skill`→`activate_skill`)
- `internal/tools/external/youtube/` — REFACTOR (`analyze_youtube`→`fetch_youtube_transcript`)
- `extensions/scripts/{threads-*,yt-dlp-*}/tool.json` — REFACTOR (separator normalization to snake_case)
- `internal/tools/agent/` — REFACTOR (agent tool module reorganization, external call API alignment)
- `configs/prompts/{system_prompt,skill_execution,agent_selector}.md` — REFACTOR (tool name references aligned with renames)
- `doc/{architecture,doc,README}.{md,zh.md}` — REFACTOR (canonical tool name references)
- `CLAUDE.md` — REFACTOR (living-doc tool name references)
- `internal/tools/scheduler/{cron,task,script}/` — REFACTOR (split into nested subpackages)
- `internal/tools/file/` — FIX (readFile path resolution)
- `internal/agents/external/` — ADD (Gemini), REFACTOR (external call API)
- `extensions/apis/` — REFACTOR (11 REST endpoint descriptions/parameters translated to English, defaults added)
- `extensions/scripts/` — REFACTOR (7 script tools translated to English, defaults added)
- `extensions/skills/tool-reviewer/` — ADD (scanner, rules, templates)
- `extensions/skills/code-reviewer/` — ADD (skill), FIX (entropy rule)
- `extensions/skills/readme-generate/` — REFACTOR (project analyzer)
- `extensions/skills/version-generate/` — REFACTOR (output paths and rules)

***

### Version Mapping (SemVer)

| Detected Tag | Version Impact |
|---|---|
| `FIX` / `UPDATE` / `SECURITY` / `REFACTOR` / `PERF` / `ADD` / `REMOVE` | PATCH (+0.0.1) |
| `STYLE` / `DOC` / `TEST` / `CHORE` | No bump (`type: none`, skip index) |

***

Generated by [SKILL](https://github.com/pardnchiu/skill-version-generate)