feat: 重试与超时策略细化(可配 + 退避)tsk_N5wO3Armums2

## 变更摘要

### 1. 项目级可配重试上限与超时
- `Project` 新增 `maxRetries`(默认 2)和 `timeoutMs`(默认 30min = 1800000ms)字段
- SQLite schema:`projects` 表补 `max_retries` / `timeout_ms` 列(带 DEFAULT 的轻量迁移)
- `createProject` / `patchProject` 支持设置 / 校验新字段(maxRetries>=0, timeoutMs>=1000)
- API `POST /api/projects` 与 `PATCH /api/projects/:id` 透传新字段
- `runner.ts` 将 `project.timeoutMs` 传给 `runClaude`,不再固定 30min

### 2. 失败重试指数退避
- 编排器内存维护 `backoffUntil` Map(taskId → nextRetryAt),daemon 重启后清空
- 退避公式:`min(30s * 2^(attempt-1), 10min)`,第 1 次 30s / 第 2 次 60s / ...
- `claimable()` 过滤退避冷却中的任务
- `nowMs` 注入点(默认 `Date.now`)使测试可快进时钟验证退避行为

### 3. needs_attention 一键重投
- `Task` 新增 `retryBaseline` 字段(默认 0):记录上次重投时的失败 run 基线
- `Store.requeueTask(taskId)`:设置基线 = 当前失败 run 数 → 转 `queued`(仅限 needs_attention)
- 编排器用净失败数(`allFailed - retryBaseline`)判断是否已耗尽重试次数
- API `POST /api/tasks/:id/requeue` + MCP `requeue_task` 工具

### 4. 测试
- 重命名 `MAX_RETRIES` → `DEFAULT_MAX_RETRIES`,新增导出 `computeBackoffMs`
- 新增测试(共 +18):maxRetries=1/0、退避时序(精确 ms 边界)、重投后基线重置
- 迁移测试扩展:验证旧库补列后 maxRetries/timeoutMs/retryBaseline 使用默认值

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-06-13 04:04:41 +08:00
parent bb6186902a
commit c89d6d129c
12 changed files with 347 additions and 31 deletions
+7 -1
View File
@@ -169,17 +169,23 @@ test('迁移:旧版库(无 source_ref/last_sync_at)打开后补列且数
const projCols = (db.prepare(`PRAGMA table_info(projects)`).all() as Array<{ name: string }>).map((c) => c.name);
const taskCols = (db.prepare(`PRAGMA table_info(tasks)`).all() as Array<{ name: string }>).map((c) => c.name);
assert.ok(projCols.includes('last_sync_at'));
assert.ok(projCols.includes('max_retries'));
assert.ok(projCols.includes('timeout_ms'));
assert.ok(taskCols.includes('source_ref'));
assert.ok(taskCols.includes('retry_baseline'));
db.close();
// Store 能正常读旧数据,新字段为 null
// Store 能正常读旧数据,新字段使用默认值
const s = new Store(file);
const projects = s.listProjects();
assert.equal(projects.length, 1);
assert.equal(projects[0].name, '旧项目');
assert.equal(projects[0].lastSyncAt, null);
assert.equal(projects[0].maxRetries, 2); // 默认值
assert.equal(projects[0].timeoutMs, 1_800_000); // 默认 30min
const t = s.getTask('tsk_old');
assert.equal(t?.title, '旧任务');
assert.equal(t?.retryBaseline, 0); // 默认基线
// 新方法在迁移后的旧库上可用
s.setSourceRef('tsk_old', 'todo:99');
assert.equal(s.getTaskBySourceRef('prj_old', 'todo:99')?.id, 'tsk_old');