hamster-wheel-cli 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 本项目遵循语义化版本，变更日志以时间倒序记录。
 
+## [0.3.1] - 2025-12-24
+### Added
+- webhook 在“计划生成”阶段新增 `plan` 字段，携带计划原文便于下游对接。
+
+### Fixed
+- webhook 发送的 `plan` 内容统一为 `\n` 换行，确保换行不丢失。
+
+## [0.3.0] - 2025-12-24
+### Added
+- 新增 `alias set/list/delete` 命令，用于管理全局 alias 配置。
+- `run` 支持多次 `--use-alias` 叠加，并按命令行顺序覆盖同名选项。
+- `run` 新增 `--use-agent`，支持叠加 agent 配置并参与覆盖合并。
+
+### Changed
+- alias 管理方式调整为 `alias set/list/delete`，便于显式维护与查看。
+- alias 列表仅展示 `[alias]` 段，避免与 shortcut 混淆。
+- run 参数合并规则统一为“同名选项后出现覆盖前出现”。
+
+## [0.2.1] - 2025-12-24
+### Added
+- webhook payload 新增 `project` 字段，值为当前工作目录名称（仅文件夹名）。
+- webhook payload 新增 `commit` 与 `pr` 字段，用于提交与 PR 链接（无链接时为空字符串）。
+- 新增 `agent add/delete/set/list` 命令，支持管理 AI CLI 命令配置。
+- 支持在全局配置中存储与解析 `[agent]` 表（兼容 `[agents]` 读取），便于复用 AI CLI 命令。
+
+### Changed
+- 仅在 `task_start` 事件发送 `task` 字段，其余阶段不再携带。
+- webhook 时间戳改为本地时区 `YYYYMMDD-HHmmss` 格式。
+- logs 列表支持 PageUp/PageDown 翻页，并补充按键提示。
+
 ## [0.2.0] - 2025-12-24
 ### Added
 - 新增 `alias run` 子命令，支持执行 alias 时追加参数并覆盖同名选项。

package/README.md

@@ -27,6 +27,7 @@ node dist/cli.js run \
 ```
 - `-t, --task`：任务描述，可重复传入多个任务，默认按接力模式依次执行。
 - `--ai-cli`/`--ai-args`：指向系统已有的 AI CLI，提示文本通过 stdin（或 `--ai-prompt-arg`）传入。
+- `--use-alias`/`--use-agent`：叠加 alias/agent 配置参数，重复传入时按命令行顺序覆盖。
 - `--worktree`：在独立分支 worktree 中作业；基线分支通过 `--base-branch` 指定。
 - 使用 `--worktree` 创建的临时工作目录，在确认分支已提交、推送且存在 PR 后会自动清理（仅删除本次创建的 worktree）。
 - `--run-tests`/`--run-e2e`：运行测试命令（默认 `yarn test`、`yarn e2e`）。
@@ -63,31 +64,60 @@ wheel-ai run --task "补充文档" --ai-cli "claude" --ai-args "--model" "claude
 - 仅支持一个 `[shortcut]`，且 `name` 不能包含空白字符。
 - 配置文件不存在或内容不合法会被忽略，不影响正常使用。
 
-## alias 浏览
-可在 `~/.wheel-ai/config.toml` 中维护多个 alias，便于集中查看常用命令组合：
+## alias 管理与使用
+可在 `~/.wheel-ai/config.toml` 中维护多个 alias，便于复用常用参数组合：
 
 ```toml
 [alias]
-daily = "--task \"补充文档\" --ai-cli \"claude\""
-weekly = "run --task \"补充测试\" --run-tests"
+daily = "--task \"补充文档\" --run-tests"
+weekly = "--task \"补充测试\" --run-tests --run-e2e"
 ```
 
-运行 `wheel-ai alias` 进入交互式列表：
-- ↑/↓ 选择 alias
-- 底部会显示选中的命令内容
-- alias 名称不能包含空白字符
+命令示例：
+```bash
+wheel-ai alias set daily --task "补充文档" --run-tests
+wheel-ai alias list
+wheel-ai alias delete daily
+```
+
+在 run 中叠加 alias：
+```bash
+wheel-ai run --use-alias daily --use-alias weekly -t "balabala"
+```
+
+- alias 名称不能为空且不能包含空白字符。
+- `--use-alias` 可重复传入，按出现顺序叠加参数。
+- 当出现同名选项时，后出现的 alias 覆盖前面的。
 
-也可以使用命令行直接写入 alias：
+## agent 配置
+可在 `~/.wheel-ai/config.toml` 中维护多个 AI CLI 命令，便于复用：
+
+```toml
+[agent]
+claude = "claude --model sonnet"
+openai = "openai --model gpt-4o"
+```
+
+命令示例：
 ```bash
-wheel-ai set alias daily --task "补充文档" --run-tests
+wheel-ai agent add claude claude --model sonnet
+wheel-ai agent set openai openai --model gpt-4o
+wheel-ai agent delete claude
+wheel-ai agent list
 ```
 
-也可以直接执行 alias，并在末尾追加命令：
+在 run 中使用 agent：
 ```bash
-wheel-ai alias run daily --run-e2e --task "补充 e2e"
+wheel-ai run --use-agent claude -t "补充文档"
 ```
-- `<addition...>` 支持多个命令/参数组合，等价于将追加内容放在 alias 命令末尾。
-- 当追加的命令/参数与 alias 内已有内容重复时，以追加的为准。
+
+- `--use-agent` 会叠加 agent 配置的参数，冲突时按命令行出现顺序覆盖。
+
+- `add` 仅新增，已存在会报错。
+- `set` 新增或覆盖。
+- `delete` 删除指定 agent。
+- `list` 输出全部 agent 配置。
+- agent 名称不能为空且不能包含空白字符。
 
 ## 持久化记忆
 - `docs/ai-workflow.md`：AI 执行前的工作流基线，需作为提示前置输入。
@@ -99,26 +129,33 @@ wheel-ai alias run daily --run-e2e --task "补充 e2e"
 - 在监控界面按 `t` 触发终止，会弹出确认框（y/n）。
 
 ## Webhook 通知
-可通过 `--webhook` 配置通知回调地址，系统会在任务开始、第 N 轮开始、任务结束时发送 POST JSON。
+可通过 `--webhook` 配置通知回调地址，系统会在任务开始、第 N 轮开始、任务结束时发送 POST JSON；其中“计划生成”阶段（`iteration_start` 且 `stage` 为“计划生成”）会额外携带 `plan` 字段，换行统一为 `\n`。
 
 Payload 示例：
 ```json
 {
   "event": "task_start",
   "task": "修复依赖安装错误",
+  "project": "webhook-start-task-project",
   "branch": "feat/webhooks",
   "iteration": 0,
   "stage": "任务开始",
-  "timestamp": "2024-01-01T00:00:00.000Z"
+  "timestamp": "20251224-210815",
+  "commit": "",
+  "pr": ""
 }
 ```
 字段说明：
 - `event`：`task_start` / `iteration_start` / `task_end`
-- `task`：任务描述
+- `task`：任务描述（仅 `task_start` 会携带）
+- `project`：当前工作目录名称（仅文件夹名，不含路径）
 - `branch`：分支名（可能为空）
 - `iteration`：当前轮次（任务开始为 0）
 - `stage`：当前节点描述
-- `timestamp`：ISO 时间戳
+- `timestamp`：本地时区 `YYYYMMDD-HHmmss` 时间戳
+- `commit`：提交链接（仅在自动提交且推送成功时写入，否则为空字符串）
+- `pr`：PR 链接（存在时写入，否则为空字符串）
+- `plan`：计划原文（仅 `iteration_start` 且 `stage` 为“计划生成”时携带，换行标准化为 `\n`）
 
 ## 开发约束
 - 使用 yarn 管理依赖，TypeScript 避免 `any`。