autowonder 0.2.140 → 0.2.142

package/README.md

@@ -6,16 +6,16 @@ AutoWonder 本地 agent runtime。安装后启动 daemon，持续轮询本地 as
 
 ```bash
 # Qoder CLI（模型使用 provider model ID；Context Window 使用固定档位）
-npx -y autowonder@0.2.140 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
+npx -y autowonder@0.2.142 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qoder --model qmodel_latest --reasoning-effort medium --context-window 260000
 
 # Qoder CLI CN
-npx -y autowonder@0.2.140 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
+npx -y autowonder@0.2.142 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
 
 # Claude Code
-npx -y autowonder@0.2.140 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider claude
+npx -y autowonder@0.2.142 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider claude
 
 # Codex CLI
-npx -y autowonder@0.2.140 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider codex --model gpt-5.5 --reasoning-effort medium
+npx -y autowonder@0.2.142 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider codex --model gpt-5.5 --reasoning-effort medium
 ```
 
 `connect` 会安装当前 npm 包内置的 daemon，并使用页面生成的 WebSocket endpoint、Token 和执行器 ID 建立连接。选择 Qoder 时需要 Node.js 20+；runtime 会在缺少 `qodercli` 时自动通过 npm 安装，并在尚未登录时打开 Qoder 浏览器登录。Claude Code 和 Codex CLI 仍需提前安装并登录。runtime 会继承当前用户的 HOME、环境变量和 CLI 登录状态。
@@ -26,6 +26,8 @@ Qoder 的 Context Window 只能使用 `1000000`、`400000` 或 `260000`，Reason
 
 给 `connect` 追加 `--token-aware-enable` 可开启 qoder / qodercn 的 token 用量采集：CLI 会以 sidecar 方式启动本地 HTTPS 转发代理（`bin/token-proxy.js`），从 Qoder API 的 SSE 响应流中提取 usage 数据并按 dispatch ID 归属上报。该功能旁路设计、不阻塞任务执行，代理启动失败时仅告警并继续。代理端口可用 `TOKEN_PROXY_PORT` 环境变量调整（默认 19876）；CA 证书位于 `~/.autowonder/token-tap/ca-cert.pem`。daemon 退出时 sidecar 一并停止。
 
+`connect` 支持 `--workspace-root <path>` 指定 dispatch 仓库与任务工作区所在目录（默认 `~/autowonder_workspaces`）。该参数会转发给 daemon，等价于设置 `AUTOWONDER_WORKSPACE_ROOT` 环境变量，适合把工作区放在非默认路径的执行机上（如 Windows 的 `D:\autowonder`）。
+
 ## 自动更新
 
 安装首个支持自动更新的正式版本后，daemon 会直接查询 npm 的 `autowonder/latest`。首次检查会随机分散在启动后的 30～90 秒，之后约每 5 分钟检查一次并加入随机抖动；npm 临时错误会指数退避，HTTP 429/503 的 `Retry-After` 会被遵循。发现更高的稳定版本时，它会在后台下载 npm tarball，校验 SHA-512 SRI、包版本和平台二进制；只有在没有运行/恢复任务且结果 outbox 已收到服务端确认时，才会暂停接单、原子切换二进制并自动重启。启动失败会恢复上一个二进制。
@@ -46,7 +48,7 @@ npx -y autowonder@latest connect ...
 
 ## 发布构建
 
-`npm run build` 和发布脚本只接受没有已跟踪或未跟踪改动的 Git worktree。脚本会把准确的 release commit 克隆到仓库外的 detached checkout，再从该目录构建四个平台的 daemon。
+`npm run build` 和发布脚本只接受没有已跟踪或未跟踪改动的 Git worktree。脚本会把准确的 release commit 克隆到仓库外的 detached checkout，再从该目录构建六个平台（darwin/linux/windows × amd64/arm64）的 daemon。
 
 每个产物都必须在 Go BuildInfo 中报告相同的完整 commit、`vcs.modified=false` 和目标平台；本机产物的 `--self-check` 还必须与 npm 包版本、短 commit 和平台一致。任一检查失败都会在替换 `vendor` 或执行 `npm publish` 前终止。
 
@@ -64,7 +66,7 @@ mv "$queue/.assignment.tmp" "$queue/assignment.json"
 也可以直接提交到本地 API：
 
 ```bash
-npx -y autowonder@0.2.140 dispatch ./assignment.json
+npx -y autowonder@0.2.142 dispatch ./assignment.json
 ```
 
 ## 上传工单附件
@@ -72,16 +74,26 @@ npx -y autowonder@0.2.140 dispatch ./assignment.json
 把本地需求/设计文档直接上传到工单，避免在会话里传递大文件：
 
 ```bash
-npx -y autowonder@0.2.140 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
+npx -y autowonder@0.2.142 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
 ```
 
 上传令牌通过 MCP 工具 `autowonder.workitem_cli_upload_token` 签发，经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 环境变量传入。`--file` 可重复指定多个文件；`--json` 输出机器可读结果。失败时按错误类型返回不同退出码（401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9）。
 
+## 上传定时任务附件
+
+把需求/设计文档上传到 7x24 定时任务，用法与工单附件一致（同一套上传令牌与预检规则）：
+
+```bash
+npx -y autowonder@0.2.142 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
+```
+
+上传令牌同样通过 `autowonder.workitem_cli_upload_token` 签发（令牌为用户级，对当前可修改的任意定时任务生效），经 `--token` 或 `AUTOWONDER_UPLOAD_TOKEN` 传入；退出码约定与 `workitem upload` 相同。
+
 ## 管理 daemon
 
 ```bash
-npx -y autowonder@0.2.140 status
-npx -y autowonder@0.2.140 stop
+npx -y autowonder@0.2.142 status
+npx -y autowonder@0.2.142 stop
 ```
 
 默认 API 是 `http://127.0.0.1:34989`，日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
@@ -89,7 +101,7 @@ npx -y autowonder@0.2.140 stop
 ## 调试
 
 ```bash
-npx -y autowonder@0.2.140 connect ... --debug
+npx -y autowonder@0.2.142 connect ... --debug
 ```
 
 `--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon，把完整的 daemon 与 agent 活动（runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点）同时输出到控制台和会话调试日志。调试日志不做脱敏，仅用于本机排障；不传 `--debug` 时该环境变量不会注入。

package/bin/cli.js

@@ -331,10 +331,10 @@ function buildFromSource() {
 // ─── Commands ────────────────────────────────────────────────────────
 
 async function cmdConnect(args) {
-  const flags = parseFlags(args, ["ws-url", "token", "executor-id", "provider", "name", "max-tasks", "model", "reasoning-effort", "context-window", "memory-mode", "settings", "token-aware-enable"]);
+  const flags = parseFlags(args, ["ws-url", "token", "executor-id", "provider", "name", "max-tasks", "model", "reasoning-effort", "context-window", "memory-mode", "settings", "workspace-root", "token-aware-enable"]);
 
   if (!flags["ws-url"] || !flags.token || !flags["executor-id"]) {
-    error("Usage: autowonder connect --ws-url <url> --token <token> --executor-id <id> [--provider qoder|qodercn]");
+    error("Usage: autowonder connect --ws-url <url> --token <token> --executor-id <id> [--provider qoder|qodercn] [--workspace-root <path>]");
     process.exit(1);
   }
 
@@ -408,13 +408,16 @@ async function cmdConnect(args) {
   log("");
 
   // Start daemon in foreground (like harness connect)
+  const workspaceRoot = flags["workspace-root"] && flags["workspace-root"] !== "true"
+    ? path.resolve(resolveUserPath(flags["workspace-root"]))
+    : path.join(os.homedir(), `autowonder_workspaces_${provider}_${executorId}`);
   const env = {
     ...process.env,
     AUTOWONDER_PROVIDER: config.provider,
     AUTOWONDER_MAX_CONCURRENT_DISPATCHES: String(config.maxTasks),
     AUTOWONDER_DAEMON_ID: config.name,
     AUTOWONDER_RUNTIME_ID: `rt_${provider}_${executorId}`,
-    AUTOWONDER_WORKSPACE_ROOT: path.join(os.homedir(), `autowonder_workspaces_${provider}_${executorId}`),
+    AUTOWONDER_WORKSPACE_ROOT: workspaceRoot,
     AUTOWONDER_LOCAL_API_ADDR: "127.0.0.1:0",
     AUTOWONDER_SERVER_WS_URL: config.serverUrl,
     AUTOWONDER_EXECUTOR_TOKEN: config.token,
@@ -745,6 +748,66 @@ async function cmdWorkitemUpload(args) {
   }
 }
 
+async function cmdScheduledTask(args) {
+  const sub = args[0];
+  if (sub === "upload") {
+    return cmdScheduledTaskUpload(args.slice(1));
+  }
+  error(`Unknown scheduled-task command: ${sub || "(none)"}`);
+  cmdHelp();
+  process.exit(1);
+}
+
+async function cmdScheduledTaskUpload(args) {
+  const upload = require("../lib/workitem-upload");
+  const json = args.includes("--json");
+  try {
+    const parsed = upload.parseUploadFlags(args, {
+      idFlag: "scheduled-task-id",
+      idKey: "scheduledTaskId",
+    });
+    const serverUrl = upload.validateServerUrl(parsed.serverUrl);
+    const scheduledTaskId = upload.validateScheduledTaskId(parsed.scheduledTaskId);
+    const token = parsed.token || process.env.AUTOWONDER_UPLOAD_TOKEN;
+    if (!token) {
+      throw new upload.UploadError(
+        "no upload token provided. Invoke the MCP tool autowonder.workitem_cli_upload_token to mint one, " +
+        "then pass it via --token or the AUTOWONDER_UPLOAD_TOKEN environment variable.",
+        { kind: "token" },
+      );
+    }
+    const files = upload.preflightFiles(parsed.files);
+
+    const { statusCode, body } = await upload.uploadScheduledTaskDocuments({
+      serverUrl, scheduledTaskId, files, token,
+    });
+
+    if (statusCode === 200) {
+      let parsedBody = null;
+      try { parsedBody = JSON.parse(body); } catch { /* non-JSON success bodies are ignored */ }
+      if (json) {
+        console.log(JSON.stringify({
+          success: true,
+          scheduledTaskId: Number(scheduledTaskId),
+          uploaded: files.map((f) => f.filename),
+          response: parsedBody,
+        }));
+      } else {
+        log(`Uploaded ${files.length} file(s) to scheduled task ${scheduledTaskId}: ${files.map((f) => f.filename).join(", ")}`);
+      }
+      return;
+    }
+
+    throw new upload.UploadError(
+      `server rejected the upload (HTTP ${statusCode})`,
+      { kind: "http", statusCode, serverError: upload.parseServerError(body) },
+    );
+  } catch (err) {
+    reportUploadFailure(err, json);
+    process.exit(uploadExitCode(err));
+  }
+}
+
 async function cmdInstall(args) {
   const flags = parseFlags(args, ["force", "provider", "max-tasks", "addr"]);
   const force = flags.force === "true" || args.includes("--force");
@@ -769,6 +832,8 @@ function cmdHelp() {
     autowonder install [--force]                             Install/update and start daemon
     autowonder workitem upload --server-url <url> --workitem-id <id> --file <path> [--file <path>...]
                                                              Upload local requirement/design files to a workitem
+    autowonder scheduled-task upload --server-url <url> --scheduled-task-id <id> --file <path> [--file <path>...]
+                                                             Upload local requirement/design files to a scheduled task
 
   Options:
     --provider <name>     Agent provider: claude, codex, qoder, qodercn (default: auto-detect; qodercn must be explicit)
@@ -783,17 +848,25 @@ function cmdHelp() {
     --settings <file>     Claude settings JSON file
     --memory-mode <mode>  Memory: platform, provider-local, or none (default: platform)
     --name <name>         Runtime name (default: provider + executor ID)
+    --workspace-root <path>  Workspace directory for dispatch repos
+                          (default: ~/autowonder_workspaces_<provider>_<executor-id>;
+                          also settable via AUTOWONDER_WORKSPACE_ROOT. On Windows use a
+                          non-C drive path here when the default location is not writable)
     --debug               Stream full daemon and agent activity to console + log file
-    --server-url <url>    AutoWonder server base URL (workitem upload)
+    --server-url <url>    AutoWonder server base URL (workitem/scheduled-task upload)
     --workitem-id <id>    Target workitem ID (workitem upload)
-    --file <path>         Local file to upload, repeatable (workitem upload)
-    --json                Machine-readable output (workitem upload)
+    --scheduled-task-id <id>  Target scheduled task ID (scheduled-task upload)
+    --file <path>         Local file to upload, repeatable (workitem/scheduled-task upload)
+    --json                Machine-readable output (workitem/scheduled-task upload)
     -h, --help            Show this help
 
   Examples:
     # Quick start — connect to server
     npx -y autowonder connect --ws-url wss://autowonder.example.com/ws/executor --token xxx --executor-id 10000 --provider qoder
 
+    # Use a custom workspace directory (e.g. a non-C drive on Windows)
+    npx -y autowonder connect --ws-url wss://autowonder.example.com/ws/executor --token xxx --executor-id 10000 --provider qoder --workspace-root D:\\autowonder
+
     # Local mode — start daemon, submit tasks manually
     npx -y autowonder start
     npx -y autowonder dispatch ./assignment.json
@@ -801,6 +874,9 @@ function cmdHelp() {
     # Upload requirement/design documents from local files
     npx -y autowonder@0.2.130 workitem upload --server-url https://private-autowonder.example.com --workitem-id 50063 --file <filepath-1> --file <filepath-2> --file <images-1> --json
 
+    # Upload requirement/design documents to a 7x24 scheduled task
+    npx -y autowonder scheduled-task upload --server-url https://auto-wonder.example.com --scheduled-task-id 123 --file <filepath-1> --file <filepath-2> --json
+
     # Check what's happening
     npx -y autowonder status
   `);
@@ -839,6 +915,7 @@ async function main() {
     case "dispatch": return cmdDispatch(commandArgs);
     case "install":  return cmdInstall(commandArgs);
     case "workitem": return cmdWorkitem(commandArgs);
+    case "scheduled-task": return cmdScheduledTask(commandArgs);
     case "help":
     case "--help":
     case "-h":       return cmdHelp();

package/lib/workitem-upload.js

@@ -1,8 +1,8 @@
 "use strict";
 
-// Workitem requirement/design document upload: streaming multipart over
-// Node >= 16 built-ins only. Never Base64 encodes and never buffers whole
-// file bodies; the server is authoritative for validation.
+// Workitem and scheduled-task requirement/design document upload: streaming
+// multipart over Node >= 16 built-ins only. Never Base64 encodes and never
+// buffers whole file bodies; the server is authoritative for validation.
 
 const crypto = require("node:crypto");
 const fs = require("node:fs");
@@ -34,10 +34,12 @@ class UploadError extends Error {
   }
 }
 
-function parseUploadFlags(args) {
+function parseUploadFlags(args, flagOptions = {}) {
+  const idFlag = flagOptions.idFlag || "workitem-id";
+  const idKey = flagOptions.idKey || "workitemId";
   const FLAG_KEYS = {
     "server-url": "serverUrl",
-    "workitem-id": "workitemId",
+    [idFlag]: idKey,
     token: "token",
     file: "file",
   };
@@ -97,13 +99,21 @@ function validateServerUrl(value) {
   return `${url.protocol}//${url.host}${url.pathname.replace(/\/+$/, "")}`;
 }
 
-function validateWorkitemId(value) {
+function validatePositiveIntegerId(value, flagName) {
   if (value === undefined || value === null || !/^[1-9][0-9]*$/.test(String(value))) {
-    throw new UploadError(`--workitem-id must be a positive integer: ${value}`, { kind: "usage" });
+    throw new UploadError(`--${flagName} must be a positive integer: ${value}`, { kind: "usage" });
   }
   return String(value);
 }
 
+function validateWorkitemId(value) {
+  return validatePositiveIntegerId(value, "workitem-id");
+}
+
+function validateScheduledTaskId(value) {
+  return validatePositiveIntegerId(value, "scheduled-task-id");
+}
+
 function preflightFiles(filePaths) {
   if (!filePaths.length) {
     throw new UploadError("at least one --file is required", { kind: "usage" });
@@ -196,9 +206,29 @@ function parseServerError(body) {
 }
 
 function uploadWorkitemDocuments({ serverUrl, workitemId, files, token }) {
+  return postMultipartUpload({
+    serverUrl,
+    uploadPath: `${UPLOAD_PATH_PREFIX}${workitemId}${UPLOAD_PATH_SUFFIX}`,
+    files,
+    token,
+    ownerLabel: "the workitem's",
+  });
+}
+
+function uploadScheduledTaskDocuments({ serverUrl, scheduledTaskId, files, token }) {
+  return postMultipartUpload({
+    serverUrl,
+    uploadPath: `/api/cli/scheduled-tasks/${scheduledTaskId}/documents`,
+    files,
+    token,
+    ownerLabel: "the scheduled task's",
+  });
+}
+
+function postMultipartUpload({ serverUrl, uploadPath, files, token, ownerLabel }) {
   return new Promise((resolve, reject) => {
     const boundary = `----autowonder${crypto.randomBytes(16).toString("hex")}`;
-    const url = new URL(`${serverUrl}${UPLOAD_PATH_PREFIX}${workitemId}${UPLOAD_PATH_SUFFIX}`);
+    const url = new URL(`${serverUrl}${uploadPath}`);
     const client = url.protocol === "https:" ? https : http;
     let settled = false;
     let sentAny = false;
@@ -245,7 +275,7 @@ function uploadWorkitemDocuments({ serverUrl, workitemId, files, token }) {
       fail(new UploadError(
         sentAny
           ? "connection lost after part of the upload was sent; the outcome is ambiguous. " +
-            "List the workitem's documents to see what arrived before retrying."
+            `List ${ownerLabel} documents to see what arrived before retrying.`
           : `connection failed: ${err.message}`,
         { kind: "network" },
       ));
@@ -279,7 +309,9 @@ module.exports = {
   parseUploadFlags,
   validateServerUrl,
   validateWorkitemId,
+  validateScheduledTaskId,
   preflightFiles,
   parseServerError,
   uploadWorkitemDocuments,
+  uploadScheduledTaskDocuments,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autowonder",
-  "version": "0.2.140",
+  "version": "0.2.142",
   "description": "AutoWonder local runtime — execute AI agent dispatch packages on your machine",
   "bin": {
     "autowonder": "bin/cli.js"