wangjia
c89d6d129c
## 变更摘要 ### 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>
maestro
多项目 TODO 管理与 Agent 执行系统（本地优先 daemon · Node/TypeScript）。
按任务复杂度（Hard / Medium / Easy）分级驱动审批闸，用后台 agent（Claude Code）在隔离 git worktree 自动执行可执行任务，改动不自动合并、等你审。
- 完整设计见 DESIGN.md。
- 当前状态：脚手架 + 基础模型/状态机/schema（Phase 1 起步）。
结构
src/model/ 复杂度、状态机、实体类型（已落地）
src/store/ SQLite schema + 访问层
src/api/ REST + WebSocket
src/mcp/ MCP server（给 Claude Code）
src/executor/ Agent SDK 封装、worktree 管理、verify
src/daemon/ maestrod 入口、编排器、worker
web/ 看板 cli/ maestro CLI
开发
npm install
npm run typecheck # tsc --noEmit
npm run build # → dist/
npm run dev # 启动 daemon（开发）
依赖版本为初始值；MCP SDK 与 Claude Agent SDK 在 Phase 2 接入时按官方文档核定后再加。
接入 Claude Code（MCP）
先 npm run build，并保证 maestrod 在跑（npm run dev，默认 http://127.0.0.1:4517）。两种接法：
# 方式一：claude mcp add（在要接入的项目里执行）
claude mcp add maestro -e MAESTRO_URL=http://127.0.0.1:4517 -- node /绝对路径/maestro/dist/mcp/index.js
// 方式二：项目根放 .mcp.json（模板见本仓库 .mcp.json.example）
{ "mcpServers": { "maestro": {
"command": "node",
"args": ["/绝对路径/maestro/dist/mcp/index.js"],
"env": { "MAESTRO_URL": "http://127.0.0.1:4517" } } } }
工具：list_projects / create_project / list_tasks / get_task / create_task / decompose_task / write_plan / write_spec / write_operations / update_status / get_next_executable / get_pending_approvals（只读；accept/reject 在 Web 看板做）。