hamster-wheel-cli 0.3.1 → 0.3.4

package/.wheel-ai/config.toml

@@ -0,0 +1,2 @@
+[agent]
+glm = "goose run --text"

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本项目遵循语义化版本，变更日志以时间倒序记录。
 
+## [0.3.4] - 2025-12-25
+### Fixed
+- `agent set` 允许透传包含 `--` 的子命令参数，避免 `unknown option` 报错。
+
+## [0.3.3] - 2025-12-25
+### Fixed
+- `--version` 改为从 `package.json` 读取版本号，避免硬编码不一致。
+
+## [0.3.2] - 2025-12-24
+### Fixed
+- webhook 的 `project` 字段固定为首次识别的仓库目录名，切换 worktree 后保持不变。
+
 ## [0.3.1] - 2025-12-24
 ### Added
 - webhook 在“计划生成”阶段新增 `plan` 字段，携带计划原文便于下游对接。

package/README.md

@@ -106,6 +106,12 @@ wheel-ai agent delete claude
 wheel-ai agent list
 ```
 
+当 agent 命令包含以 `-`/`--` 开头的参数时，已支持直接透传；如需显式终止解析可使用 `--`，例如：
+```bash
+wheel-ai agent set glm goose run --text
+wheel-ai agent set glm -- goose run --text
+```
+
 在 run 中使用 agent：
 ```bash
 wheel-ai run --use-agent claude -t "补充文档"
@@ -148,7 +154,7 @@ Payload 示例：
 字段说明：
 - `event`：`task_start` / `iteration_start` / `task_end`
 - `task`：任务描述（仅 `task_start` 会携带）
-- `project`：当前工作目录名称（仅文件夹名，不含路径）
+- `project`：首次识别的仓库根目录名称（仅文件夹名，不含路径），切换 worktree 后保持不变
 - `branch`：分支名（可能为空）
 - `iteration`：当前轮次（任务开始为 0）
 - `stage`：当前节点描述

package/dist/cli.js

@@ -35,6 +35,7 @@ __export(cli_exports, {
 });
 module.exports = __toCommonJS(cli_exports);
 var import_node_child_process = require("child_process");
+var import_node_path12 = __toESM(require("path"));
 var import_fs_extra12 = __toESM(require("fs-extra"));
 var import_commander = require("commander");
 
@@ -2520,14 +2521,14 @@ async function safeRemove(logFile, logger) {
   }
 }
 async function createRunTracker(options) {
-  const { logFile, command, path: path12, logger } = options;
+  const { logFile, command, path: path13, logger } = options;
   if (!logFile) return null;
   const update = async (round, tokenUsed) => {
     const metadata = {
       command,
       round,
       tokenUsed,
-      path: path12,
+      path: path13,
       pid: process.pid
     };
     await safeWrite(logFile, metadata, logger);
@@ -3045,6 +3046,7 @@ async function runLoop(config) {
   const logger = new Logger({ verbose: config.verbose, logFile: config.logFile });
   const repoRoot = await getRepoRoot(config.cwd, logger);
   logger.debug(`\u4ED3\u5E93\u6839\u76EE\u5F55: ${repoRoot}`);
+  const initialProjectName = import_node_path9.default.basename(repoRoot);
   let branchName = config.git.branchName;
   let workDir = repoRoot;
   let worktreeCreated = false;
@@ -3063,7 +3065,7 @@ async function runLoop(config) {
   let commitCreated = false;
   let pushSucceeded = false;
   const preWorktreeRecords = [];
-  const resolveProjectName = () => import_node_path9.default.basename(workDir);
+  const resolveProjectName = () => initialProjectName;
   const notifyWebhook = async (event, iteration, stage, plan) => {
     const project = resolveProjectName();
     const payload = event === "task_start" ? buildWebhookPayload({
@@ -4120,6 +4122,26 @@ var RUN_OPTION_FLAG_MAP = new Map(
 );
 var USE_ALIAS_FLAG = "--use-alias";
 var USE_AGENT_FLAG = "--use-agent";
+var PACKAGE_VERSION_FALLBACK = "0.0.0";
+async function resolveCliVersion() {
+  const candidatePaths = [
+    import_node_path12.default.resolve(__dirname, "..", "package.json"),
+    import_node_path12.default.resolve(process.cwd(), "package.json")
+  ];
+  for (const candidatePath of candidatePaths) {
+    const exists = await import_fs_extra12.default.pathExists(candidatePath);
+    if (!exists) continue;
+    try {
+      const pkg = await import_fs_extra12.default.readJson(candidatePath);
+      if (typeof pkg?.version === "string") {
+        const trimmed = pkg.version.trim();
+        if (trimmed.length > 0) return trimmed;
+      }
+    } catch {
+    }
+  }
+  return PACKAGE_VERSION_FALLBACK;
+}
 function parseInteger(value, defaultValue) {
   const parsed = Number.parseInt(value, 10);
   if (Number.isNaN(parsed)) return defaultValue;
@@ -4462,11 +4484,13 @@ async function runForegroundWithDetach(options) {
 async function runCli(argv) {
   const globalConfig = await loadGlobalConfig(defaultLogger);
   const effectiveArgv = applyShortcutArgv(argv, globalConfig);
+  const cliVersion = await resolveCliVersion();
   const program = new import_commander.Command();
-  program.name("wheel-ai").description("\u57FA\u4E8E AI CLI \u7684\u6301\u7EED\u8FED\u4EE3\u5F00\u53D1\u5DE5\u5177").version("0.2.1");
+  program.name("wheel-ai").description("\u57FA\u4E8E AI CLI \u7684\u6301\u7EED\u8FED\u4EE3\u5F00\u53D1\u5DE5\u5177").version(cliVersion);
+  program.enablePositionalOptions();
   program.addHelpText(
     "after",
-    "\nalias \u7BA1\u7406\uFF1A\n  wheel-ai alias set <name> <options...>\n  wheel-ai alias list\n  wheel-ai alias delete <name>\n\nalias/agent \u53E0\u52A0\uFF1A\n  wheel-ai run --use-alias <name> [--use-alias <name>...]\n  wheel-ai run --use-agent <name> [--use-agent <name>...]\n  \u540C\u540D\u9009\u9879\u6309\u51FA\u73B0\u987A\u5E8F\u8986\u76D6\u3002\n"
+    "\nalias \u7BA1\u7406\uFF1A\n  wheel-ai alias set <name> <options...>\n  wheel-ai alias list\n  wheel-ai alias delete <name>\n\nalias/agent \u53E0\u52A0\uFF1A\n  wheel-ai run --use-alias <name> [--use-alias <name>...]\n  wheel-ai run --use-agent <name> [--use-agent <name>...]\n  \u540C\u540D\u9009\u9879\u6309\u51FA\u73B0\u987A\u5E8F\u8986\u76D6\u3002\n\nagent \u5F55\u5165\u5305\u542B\u9009\u9879\u65F6\u4F7F\u7528 -- \u7EC8\u6B62\u89E3\u6790\uFF1A\n  wheel-ai agent set <name> -- <command...>\n  \u4F8B\u5982\uFF1Awheel-ai agent set glm -- goose run --text\n"
   );
   program.command("run").option("-t, --task <task>", "\u9700\u8981\u5B8C\u6210\u7684\u4EFB\u52A1\u63CF\u8FF0\uFF08\u53EF\u91CD\u590D\u4F20\u5165\uFF0C\u72EC\u7ACB\u5904\u7406\uFF09", collect, []).option("--use-alias <name>", "\u53E0\u52A0 alias \u914D\u7F6E\uFF08\u53EF\u91CD\u590D\uFF09", collect, []).option("--use-agent <name>", "\u53E0\u52A0 agent \u914D\u7F6E\uFF08\u53EF\u91CD\u590D\uFF09", collect, []).option("-i, --iterations <number>", "\u6700\u5927\u8FED\u4EE3\u6B21\u6570", (value) => parseInteger(value, 5), 5).option("--ai-cli <command>", "AI CLI \u547D\u4EE4", "claude").option("--ai-args <args...>", "AI CLI \u53C2\u6570", []).option("--ai-prompt-arg <flag>", "\u7528\u4E8E\u4F20\u5165 prompt \u7684\u53C2\u6570\uFF08\u4E3A\u7A7A\u5219\u4F7F\u7528 stdin\uFF09").option("--notes-file <path>", "\u6301\u4E45\u5316\u8BB0\u5FC6\u6587\u4EF6", defaultNotesPath()).option("--plan-file <path>", "\u8BA1\u5212\u6587\u4EF6", defaultPlanPath()).option("--workflow-doc <path>", "AI \u5DE5\u4F5C\u6D41\u7A0B\u8BF4\u660E\u6587\u4EF6", defaultWorkflowDoc()).option("--worktree", "\u5728\u72EC\u7ACB worktree \u4E0A\u6267\u884C", false).option("--branch <name>", "worktree \u5206\u652F\u540D\uFF08\u9ED8\u8BA4\u81EA\u52A8\u751F\u6210\u6216\u5F53\u524D\u5206\u652F\uFF09").option("--worktree-path <path>", "worktree \u8DEF\u5F84\uFF0C\u9ED8\u8BA4 ../worktrees/<branch>").option("--base-branch <name>", "\u521B\u5EFA\u5206\u652F\u7684\u57FA\u7EBF\u5206\u652F", "main").option("--skip-install", "\u8DF3\u8FC7\u5F00\u59CB\u4EFB\u52A1\u524D\u7684\u4F9D\u8D56\u68C0\u67E5", false).option("--run-tests", "\u8FD0\u884C\u5355\u5143\u6D4B\u8BD5\u547D\u4EE4", false).option("--run-e2e", "\u8FD0\u884C e2e \u6D4B\u8BD5\u547D\u4EE4", false).option("--unit-command <cmd>", "\u5355\u5143\u6D4B\u8BD5\u547D\u4EE4", "yarn test").option("--e2e-command <cmd>", "e2e \u6D4B\u8BD5\u547D\u4EE4", "yarn e2e").option("--auto-commit", "\u81EA\u52A8 git commit", false).option("--auto-push", "\u81EA\u52A8 git push", false).option("--pr", "\u4F7F\u7528 gh \u521B\u5EFA PR", false).option("--pr-title <title>", "PR \u6807\u9898").option("--pr-body <path>", "PR \u63CF\u8FF0\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u7559\u7A7A\u81EA\u52A8\u751F\u6210\uFF09").option("--draft", "\u4EE5\u8349\u7A3F\u5F62\u5F0F\u521B\u5EFA PR", false).option("--reviewer <user...>", "PR reviewers", collect, []).option("--auto-merge", "PR \u68C0\u67E5\u901A\u8FC7\u540E\u81EA\u52A8\u5408\u5E76", false).option("--webhook <url>", "webhook \u901A\u77E5 URL\uFF08\u53EF\u91CD\u590D\uFF09", collect, []).option("--webhook-timeout <ms>", "webhook \u8BF7\u6C42\u8D85\u65F6\uFF08\u6BEB\u79D2\uFF09", (value) => parseInteger(value, 8e3)).option("--multi-task-mode <mode>", "\u591A\u4EFB\u52A1\u6267\u884C\u6A21\u5F0F\uFF08relay/serial/serial-continue/parallel\uFF0C\u6216\u4E2D\u6587\u63CF\u8FF0\uFF09", "relay").option("--stop-signal <token>", "AI \u8F93\u51FA\u4E2D\u7684\u505C\u6B62\u6807\u8BB0", "<<DONE>>").option("--log-file <path>", "\u65E5\u5FD7\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84").option("--background", "\u5207\u5165\u540E\u53F0\u8FD0\u884C", false).option("-v, --verbose", "\u8F93\u51FA\u8C03\u8BD5\u65E5\u5FD7", false).option("--skip-quality", "\u8DF3\u8FC7\u4EE3\u7801\u8D28\u91CF\u68C0\u67E5", false).action(async (options) => {
     const rawRunArgs = extractRunCommandArgs(effectiveArgv);
@@ -4685,7 +4709,7 @@ async function runCli(argv) {
     await upsertAgentEntry(normalized, commandLine);
     console.log(`\u5DF2\u65B0\u589E agent\uFF1A${normalized}`);
   });
-  agentCommand.command("set <name> [command...]").description("\u5199\u5165 agent").allowUnknownOption(true).allowExcessArguments(true).action(async (name) => {
+  agentCommand.command("set <name> [command...]").description("\u5199\u5165 agent").passThroughOptions().allowUnknownOption(true).allowExcessArguments(true).action(async (name) => {
     const normalized = normalizeAgentName(name);
     if (!normalized) {
       throw new Error("agent \u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A\u4E14\u4E0D\u80FD\u5305\u542B\u7A7A\u767D\u5B57\u7B26");