# v0.22.0 Release Notes

> v0.21.3 -> v0.22.0

## Summary

Rebuilds the scheduler from the ground up around dedicated cron and task storage with skill bindings and TUI controls. Reorganizes interactive surfaces under a unified runtime namespace and expands the TUI with inline bot editing and MCP integration. Retires legacy script extensions as the public API discovery flow takes their place.
<details>
<summary>翻譯</summary>
從零重建 scheduler，配上獨立 cron／task storage、skill 綁定與 TUI 操作介面。將互動層整合至統一的 runtime 命名空間，並擴展 TUI 加入 inline bot 編輯與 MCP 整合。下架 legacy script 擴展，由 public API 發現流程接棒。
</details>

## ⚠️ Breaking Changes

### Scheduler tool surface renamed and trimmed

舊 scheduler 套件（`internal/scheduler/{crons,tasks,script}/` 與 `internal/tools/scheduler/{cron,task,script}/`）整批移除並以 flat 結構重建於 `internal/tools/scheduler/`。Tool 名稱與行為對應如下：

**Before:**
- `add_cron` / `update_cron` / `remove_cron` / `get_cron` / `list_crons`
- `add_task` / `update_task` / `remove_task` / `get_task` / `list_tasks`
- `read_script` / `update_script`

**After:**
- `add_cron` / `patch_cron` / `remove_cron`
- `add_task` / `patch_task` / `remove_task`
- Script-storage tools 整段移除

**Migration:**
- 把 `update_cron` 呼叫改為 `patch_cron`，`update_task` 改為 `patch_task`（語意改為部分欄位更新）
- `list_*` 與 `get_*` query 改由 TUI `/cron` ／`/task` 流程或直接讀 storage 取得（runtime 不再暴露 LLM 端 listing tool）
- 仰賴 `read_script` / `update_script` 的流程改由 `scheduler-skill-creator` skill 產生 skill 檔，scheduler 改以 skill 名稱觸發

### Scheduler skills replaced

**Before:** `extensions/skills/schedule-task` 與 `extensions/skills/script-tool-creator`

**After:** `extensions/skills/scheduler-skill-creator`（新流程，產生帶 hash 命名的 scheduler skill 檔）

**Migration:** 舊兩個 skill 已不存在；既有 cron／task entry 之 skill 參照若指向移除的 skill 名稱需以 `scheduler-skill-creator` 重新產生對應 skill 檔。

### Legacy Threads and yt-dlp script extensions removed

**Before:**
- `extensions/scripts/threads-{get-quota,publish-carousel,publish-image,publish-text,refresh-token}`
- `extensions/scripts/yt-dlp-{downloader,info}`
- `install_threads.sh` / `install_youtube.sh`

**After:** 全數移除，**無**內建替代

**Migration:**
- Threads 相關自動化改以使用者自行維護的 `api_*` JSON endpoint（透過 `extensions/apis/`）或外部 script
- YouTube 下載／資訊改由其他 CLI tool 或自行於 `extensions/scripts/` 補回；新版偏好以 `fetch_youtube_transcript` 等內建 tool 走資料抽取路徑

### Tool path layout flattened

**Before:** Scheduler tools 分散於 `internal/tools/scheduler/{cron,task,script}/`，storage helper 散落於 `internal/filesystem/scheduler.go`

**After:** Tool 檔案統一於 `internal/tools/scheduler/`（無子套件），storage paths 改由 `filesystem.go` 集中計算；scheduler 寫入路徑同步 reshape

**Migration:** 引用 `internal/tools/scheduler/cron`／`internal/tools/scheduler/task` 等子套件的本地分支需改 import；現有 cron／task 儲存資料於首次啟動由新 layout 接管，**舊路徑下殘留檔案需手動清除**。

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

**Scheduler tool surface 改名／瘦身：** `update_*` 改 `patch_*`；`list_*` ／ `get_*` ／ script-storage tools 整批移除，listing 改走 TUI 介面，script 編輯改由 `scheduler-skill-creator` skill 產生 skill 檔。

**Scheduler skills 替換：** `schedule-task` 與 `script-tool-creator` 移除，由 `scheduler-skill-creator` 接手。

**Legacy script extensions 下架：** Threads（5 個 tool）與 yt-dlp（2 個 tool）script extension 全數移除，無內建替代；改以 `extensions/apis/` JSON endpoint 或自行於 `extensions/scripts/` 補回。

**Tool path layout 拍平：** scheduler tool 子套件合併成單一 flat package；舊路徑殘留資料需手動清除。

</details>

## Changes

### FEAT
- Add runtime scheduler with task and cron storage [56a0363]
- Add TUI cron controls and scheduler skill command routing [6852765]
- Add TUI one-shot task management commands [179cbda]
- Add MCP server management flow in TUI [c7c7459]
- Add inline bot editing flow with multiline popup support [ac288de]

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

- 新增 runtime scheduler，含 task 與 cron storage
- TUI 加入 cron 操作介面與 scheduler skill 指令路由
- TUI 加入 one-shot task 管理指令
- TUI 加入 MCP server 管理流程
- TUI 加入 inline bot 編輯流程，支援 multiline popup

</details>

### FIX
- Show scheduler skill and time in tool rendering [06ca32c]

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

- 修正 tool 渲染未顯示 scheduler skill 與時間資訊

</details>

### UPDATE
- Add scheduler cleanup paths and adjust TUI rendering behavior [2eb039b]
- Rework README to document CLI, TUI, tools [92401b4]

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

- 補上 scheduler 清理路徑，並調整 TUI 渲染行為
- 改寫 README 文件，補上 CLI／TUI／tools 說明

</details>

### REFACTOR
- Move interactive packages under runtime namespace [6d3c3c9]
- Move TUI package under internal/interactive namespace [81ef83b]

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

- 將 interactive 相關套件遷移至 runtime 命名空間
- 將 TUI 套件遷移至 internal/interactive 命名空間

</details>

### ADD
- Add hashed scheduler skill naming and manual trigger guards [004220f]
- Add scheduler patch/remove commands and cron task storage split [8eddca9]
- Add low-level scheduler binding tools [e720943]
- Add installer and updater shell scripts [e2fb3b3]
- Add public API discovery skills and initialize scanner before exec [7aa54e4]
- Add scheduler skill creator and initializer script [972acba]

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

- 新增 scheduler skill 命名 hash 機制與手動觸發 guard
- 新增 scheduler patch／remove 指令並拆分 cron 與 task storage
- 新增低階 scheduler binding tools
- 新增安裝／更新 shell scripts
- 新增 public API 探索 skill，並於 exec 前初始化 scanner
- 新增 scheduler skill 建立器與初始化 script

</details>

### DOC
- Document scheduler slash commands and runtime architecture [7dd7d65]
- Update API tool path references to tools/api [61e8402]

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

- 補上 scheduler slash command 與 runtime 架構說明
- 更新 API tool 路徑指引至 tools/api

</details>

***

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