autowonder 0.3.19 → 0.3.21

package/README.md

@@ -6,10 +6,10 @@ AutoWonder 本地 agent runtime。安装后启动 daemon，持续轮询本地 as
 
 ```bash
 # Qoder CLI（模型使用 provider model ID；Context Window 使用固定档位）
-npx -y autowonder@0.3.19 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.3.21 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.3.19 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
+npx -y autowonder@0.3.21 connect --ws-url <wss-endpoint> --token <executor-token> --executor-id <executor-id> --provider qodercn
 ```
 
 `connect` 会安装当前 npm 包内置的 daemon，并使用页面生成的 WebSocket endpoint、Token 和执行器 ID 建立连接。客户端只支持通过 Qoder 系列 CLI 启动（`qoder` 对应 `qodercli`，`qodercn` 对应 `qodercn`），其他 `--provider` 取值会在启动 daemon 前直接报错拦截并提示 `Unsupported provider`。选择 Qoder CLI 或 Qoder CLI CN 时需要 Node.js 20+；runtime 会在缺少对应 CLI 时自动通过 npm 安装，并在尚未登录时打开浏览器登录。runtime 会继承当前用户的 HOME、环境变量和 CLI 登录状态。
@@ -27,7 +27,7 @@ runtime 启动时始终只拉取一次 Platform 环境变量快照，即使已
 
 出于安全考虑，命令行 token 可能出现在 shell 历史和操作系统进程列表中，建议优先使用环境变量或 Platform 绑定。
 
-`connect` 和 `start` 都要求 Qoder CLI / Qoder CLI CN 版本至少为 `1.1.65`。版本探测保留退出码、信号与有界输出作为证据；单次探测没有拿到版本（超时、启动失败或输出无法解析）时先按有界节奏重试，确认确实不满足后才对当前优先选中的用户 CLI 执行内置 `update`，原位升级到最新版并再次强校验；升级失败或升级后仍不满足最低版本时拒绝启动 daemon，并在日志中打印探测证据。所有 Qoder 系列子进程（普通任务、conversation、warm 会话、恢复回退、命令与模型探测）都会强制注入固定的 `QODER_INTEGRATION_ID`，调用方环境不能覆盖该流量归因标识。
+`connect` 和 `start` 都要求 Qoder CLI / Qoder CLI CN 版本至少为 `1.1.65`。检测到旧版或无法解析的版本时，runtime 会对当前优先选中的用户 CLI 执行内置 `update`，原位升级到最新版并再次强校验；升级失败或升级后仍不满足最低版本时拒绝启动 daemon。所有 Qoder 系列子进程（普通任务、conversation、warm 会话、恢复回退、命令与模型探测）都会强制注入固定的 `QODER_INTEGRATION_ID`，调用方环境不能覆盖该流量归因标识。
 
 `qodercn` 是国内版 Qoder CLI。runtime 会在缺少 `qodercn` 时自动把 `@qodercn-ai/qoderclicn` 安装到 `~/.autowonder/qoder-cn-cli`，并在尚未登录时打开浏览器登录。它使用自己的配置根（`QODERCN_CONFIG_DIR`，默认 `~/.qoder-cn`），与国际版 `qoder` 不共享可执行文件、凭证和会话。可用 `AUTOWONDER_QODERCN_CLI` 指定自定义可执行文件路径。
 
@@ -65,16 +65,18 @@ Qoder 系列执行器的跨派单记忆由平台托管。服务端在派单里
 
 ## 工作区保留与 Git 对象复用
 
-daemon 默认启用本地工作区 GC：启动 30 秒后开始检查，之后每小时执行有限量的后台清理。非会话任务仅在终态且最后活动时间超过所配置的任务 TTL（默认 72 小时）后才符合清理条件；会话目录仅在最后活动时间超过所配置的会话 TTL（默认 720 小时）后才符合条件。清理的单位是整个 attempt capsule 或整个 conversation capsule，不会只删除其中部分文件。未知或格式异常、非终态（包括 uploading）、仍在运行、由恢复流程持有、结果仍待确认，或结果状态查询失败的 capsule 都会保留。
+daemon 默认启用本地工作区 GC：启动 30 秒后开始检查，之后每 15 分钟开始一次检查。尚有健康的分片工作时每 250 毫秒继续，错误仍按退避重试；每次操作保持有限的节点和时间预算。非会话任务在终态且最后活动时间超过所配置的任务 TTL（默认 48 小时）后符合清理条件；会话目录的 TTL 仍为 720 小时。清理单位是整个 attempt capsule 或 conversation capsule。未知或格式异常、非终态（包括 uploading）、仍在运行、由恢复流程持有、结果仍待确认，或结果状态查询失败的 capsule 都会保留。只有 package 缓存、没有可信终态证据的历史目录不会按目录年龄删除，恢复扫描也不会为它们凭空创建 assigned 状态。
 
-磁盘使用率达到 85% 或可用空间低于 10 GiB 时进入压力模式，恢复目标是使用率不高于 75% 且可用空间至少 15 GiB。压力只会调整有限量清理工作的调度和顺序；它不会放宽所配置的任务/会话 TTL（默认 72/720 小时），也不会让较新的 capsule 提前被删除。
+磁盘使用率达到 85% 或可用空间低于 10 GiB 时进入压力模式，恢复目标是使用率不高于 75% 且可用空间至少 15 GiB。压力模式还允许清理未满 TTL 的 completed attempt；符合条件的 attempt 按最后活动时间从旧到新清理。近期 failed/cancelled 和会话目录的 TTL 不变。每次实际删除后检查恢复目标，隔离重命名不算释放空间。删除前不为统计额外遍历目录；文件数和逻辑字节估算直接从删除操作取得。
+
+工作区 GC 另写独立审计日志 `~/.autowonder/gc/gc_exector_<executorId>.log`（文件名单词拼写如此），每文件上限 50 MiB、共保留 5 个文件，不改变下面托管日志的保留设置。
 
 相关环境变量及默认值如下：
 
 - `AUTOWONDER_WORKSPACE_GC_ENABLED=true`
 - `AUTOWONDER_WORKSPACE_GC_INITIAL_DELAY=30s`
-- `AUTOWONDER_WORKSPACE_GC_INTERVAL=1h`
-- `AUTOWONDER_WORKSPACE_GC_TASK_TTL=72h`
+- `AUTOWONDER_WORKSPACE_GC_INTERVAL=15m`
+- `AUTOWONDER_WORKSPACE_GC_TASK_TTL=48h`
 - `AUTOWONDER_WORKSPACE_GC_CONVERSATION_TTL=720h`
 - `AUTOWONDER_WORKSPACE_GC_HIGH_WATERMARK_PERCENT=85`
 - `AUTOWONDER_WORKSPACE_GC_LOW_WATERMARK_PERCENT=75`
@@ -173,7 +175,7 @@ mv "$queue/.assignment.tmp" "$queue/assignment.json"
 也可以直接提交到本地 API：
 
 ```bash
-npx -y autowonder@0.3.19 dispatch ./assignment.json
+npx -y autowonder@0.3.21 dispatch ./assignment.json
 ```
 
 ## 上传工单附件
@@ -181,7 +183,7 @@ npx -y autowonder@0.3.19 dispatch ./assignment.json
 把本地需求/设计文档直接上传到工单，避免在会话里传递大文件：
 
 ```bash
-npx -y autowonder@0.3.19 workitem upload --server-url <autowonder-server-url> --workitem-id <id> --file <filepath-1> --file <filepath-2> --json
+npx -y autowonder@0.3.21 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）。
@@ -191,7 +193,7 @@ npx -y autowonder@0.3.19 workitem upload --server-url <autowonder-server-url> --
 把工单上已有的需求/设计文档下载到本地目录，再用本地文件工具阅读，避免把大文件或二进制附件搬进会话上下文：
 
 ```bash
-npx -y autowonder@0.3.19 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
+npx -y autowonder@0.3.21 workitem download --server-url <autowonder-server-url> --workitem-id <id> --file <name-or-id> --output-dir <dir> --json
 ```
 
 下载令牌通过 MCP 工具 `autowonder.workitem_cli_download_token` 签发（与上传令牌相互独立），经 `--token` 或 `AUTOWONDER_DOWNLOAD_TOKEN` 环境变量传入。`--file` 可重复指定文档名或 artifact id，省略则下载该工单的全部附件；`--output-dir` 默认为当前目录；`--json` 输出机器可读结果，含每个文件的 `id`、`name`、`path`、`size`。退出码约定与 `workitem upload` 相同（401→3、403→4、404→5、409→6、413→7、其他 4xx→8、网络/重定向→9）。
@@ -201,7 +203,7 @@ npx -y autowonder@0.3.19 workitem download --server-url <autowonder-server-url>
 把需求/设计文档上传到 7x24 定时任务，用法与工单附件一致（同一套上传令牌与预检规则）：
 
 ```bash
-npx -y autowonder@0.3.19 scheduled-task upload --server-url <autowonder-server-url> --scheduled-task-id <id> --file <filepath-1> --file <filepath-2> --json
+npx -y autowonder@0.3.21 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` 相同。
@@ -209,8 +211,8 @@ npx -y autowonder@0.3.19 scheduled-task upload --server-url <autowonder-server-u
 ## 管理 daemon
 
 ```bash
-npx -y autowonder@0.3.19 status
-npx -y autowonder@0.3.19 stop
+npx -y autowonder@0.3.21 status
+npx -y autowonder@0.3.21 stop
 ```
 
 默认 API 是 `http://127.0.0.1:34989`，日志位于 `~/.autowonder/daemon.log`。npm 包不包含任何 agent、MCP 或服务端凭证。
@@ -233,7 +235,7 @@ daemon 内置独立于工作区 GC 的保留清扫：默认每小时运行一次
 ## 调试
 
 ```bash
-npx -y autowonder@0.3.19 connect ... --debug
+npx -y autowonder@0.3.21 connect ... --debug
 ```
 
 `--debug` 会让 CLI 以 `AUTOWONDER_DEBUG=1` 启动 daemon，把完整的 daemon 与 agent 活动（runtime 事件流、provider 事件解码、重试退避与会话门等待、空闲时的阻塞点）同时输出到控制台和会话调试日志。调试日志不做脱敏，仅用于本机排障；不传 `--debug` 时该环境变量不会注入。

package/package.json

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