hamster-wheel-cli 0.1.0 → 0.2.0-beta.1

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 本项目遵循语义化版本，变更日志以时间倒序记录。
 
+## [0.2.0] - 2025-12-24
+### Added
+- 支持多任务执行与 multi-task 模式，提供 relay（接力）、serial（串行）、serial-continue（串行继续）、parallel（并行）四种执行方式。
+- 新增 `alias` 命令，提供交互式 alias 配置浏览界面，支持上下键选择与 q 退出。
+- Monitor 支持通过 `t` 键终止运行中的任务，增加确认对话框防止误操作。
+- 前台运行时支持按 Esc 切入后台运行，日志自动输出到文件。
+- 日志查看器（logs）支持单行滚动与翻页浏览，Esc 或 b 返回列表。
+
+### Changed
+- 优化 AI 多阶段流程与交付闭环，改进分阶段 session 执行逻辑。
+- 项目从 hamster-wheel-cli 重命名为 wheel-ai，更新相关引用与命令入口。
+- GitHub Actions 工作流 Node.js 版本从 18 升级到 20。
+
+### Fixed
+- 修复分支名格式生成逻辑，确保符合 git 分支命名规范。
+
+## [0.1.1] - 2025-12-24
+### Added
+- 引入分阶段 AI session 流程：分支名生成、计划执行、质量检查、测试、文档更新。
+- 支持根据任务生成分支名（AI 优先，失败兜底）。
+- 自动检测并执行代码质量检查，支持失败修复循环。
+- 新增 `--skip-quality` 与 `--auto-merge` CLI 选项。
+
+### Changed
+- 多任务未显式指定分支时不再自动生成分支名，改由 AI 在运行时生成。
+- 迭代记录补充阶段与质量检查结果，便于回溯。
+
 ## [0.1.0] - 2025-12-23
 ### Added
 - 基于 commander 的 AI 驱动 CLI，支持通过外部 AI CLI 运行迭代流程。
@@ -9,4 +36,3 @@
 - 支持单元测试与 e2e 测试的统一触发与结果收集。
 - 提供计划与记录持久化（`memory/plan.md`、`memory/notes.md`），便于多轮迭代复用。
 - 支持 webhook 通知、日志查看与本地配置快捷指令，提升可观测性与易用性。
-

package/README.md

@@ -13,8 +13,10 @@ yarn build
 ```bash
 node dist/cli.js run \
   --task "为现有项目补充自动化 CI" \
+  --task "补充测试覆盖" \
   --ai-cli "claude" \
   --ai-args "--model" "claude-3-opus" \
+  --multi-task-mode relay \
   --worktree \
   --base-branch main \
   --branch wheel-ai/ci-upgrade \
@@ -23,17 +25,21 @@ node dist/cli.js run \
   --pr --pr-title "chore: 自动化 CI" \
   --stop-signal "<<DONE>>"
 ```
+- `-t, --task`：任务描述，可重复传入多个任务，默认按接力模式依次执行。
 - `--ai-cli`/`--ai-args`：指向系统已有的 AI CLI，提示文本通过 stdin（或 `--ai-prompt-arg`）传入。
 - `--worktree`：在独立分支 worktree 中作业；基线分支通过 `--base-branch` 指定。
 - 使用 `--worktree` 创建的临时工作目录，在确认分支已提交、推送且存在 PR 后会自动清理（仅删除本次创建的 worktree）。
 - `--run-tests`/`--run-e2e`：运行测试命令（默认 `yarn test`、`yarn e2e`）。
 - `--auto-commit`/`--auto-push`：迭代结束后自动提交与推送。
 - `--pr`：使用 `gh pr create` 创建 PR，可配合 `--pr-title`/`--pr-body`/`--draft`/`--reviewer`，未提供标题时会自动生成默认标题。
+- `--auto-merge`：为 PR 启用自动合并（通过后自动 merge）。
 - `--skip-install`：任务启动前跳过依赖检查与自动安装。
+- `--skip-quality`：跳过代码质量检查环节。
 - `--log-file`：将日志写入指定文件（相对路径基于当前工作目录）。
 - `-v, --verbose`：输出完整调试日志（包含执行命令、stdout/stderr），便于开发排查。
 - `--webhook`：配置通知回调地址（可重复设置多个 URL）。
 - `--webhook-timeout`：webhook 请求超时（毫秒），默认 8000。
+- `--multi-task-mode`：多任务执行模式，支持 `relay`（默认接力）、`serial`、`serial-continue`、`parallel`，也可用中文描述。
 
 ## 全局配置快捷指令
 支持在 `~/.wheel-ai/config.toml` 配置一个快捷指令，用于减少重复的命令行参数书写。
@@ -57,11 +63,34 @@ wheel-ai run --task "补充文档" --ai-cli "claude" --ai-args "--model" "claude
 - 仅支持一个 `[shortcut]`，且 `name` 不能包含空白字符。
 - 配置文件不存在或内容不合法会被忽略，不影响正常使用。
 
+## alias 浏览
+可在 `~/.wheel-ai/config.toml` 中维护多个 alias，便于集中查看常用命令组合：
+
+```toml
+[alias]
+daily = "--task \"补充文档\" --ai-cli \"claude\""
+weekly = "run --task \"补充测试\" --run-tests"
+```
+
+运行 `wheel-ai alias` 进入交互式列表：
+- ↑/↓ 选择 alias
+- 底部会显示选中的命令内容
+- alias 名称不能包含空白字符
+
+也可以使用命令行直接写入 alias：
+```bash
+wheel-ai set alias daily --task "补充文档" --run-tests
+```
+
 ## 持久化记忆
 - `docs/ai-workflow.md`：AI 执行前的工作流基线，需作为提示前置输入。
 - `memory/plan.md`：分阶段计划（可被 AI 重写保持最新）。
 - `memory/notes.md`：每轮迭代的输出、结论、风险与下一步。
 
+## 运行中任务监控
+- `wheel-ai monitor` 启动交互式监控，←/→ 切换任务，↑/↓ 上下 1 行，PageUp/PageDown 翻页。
+- 在监控界面按 `t` 触发终止，会弹出确认框（y/n）。
+
 ## Webhook 通知
 可通过 `--webhook` 配置通知回调地址，系统会在任务开始、第 N 轮开始、任务结束时发送 POST JSON。