wangjia/maestro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
116 Commits 1 Branch 0 Tags
7884182d2b70e2210748c6ad7d041363d65164b4
Commit Graph

37 Commits

Author SHA1 Message Date
wangjia 7884182d2b feat: 编排器跨项目全局并发上限闸（tsk_erQHNYdn6i9g） 
新增用户级设置项 globalConcurrency（settings 表，独立于新建项目默认值
来源 concurrency），缺省 0 = 不限，向后兼容无需 DB 迁移。

- store: UserSettings 加 globalConcurrency 字段 + 默认 0；新增
  globalInflightCount()（跨所有项目 started run 总数，与 inflightTaskIds 同口径）
- orchestrator.claimTick: 叠加全局闸，与 per-project 闸串联（都过才领）；
  轮初查一次全局在途、轮内手动 ++，达上限即 return 跨所有项目停止领取
- api: PUT /api/settings 支持 globalConcurrency（空/null 归一为 0）
- web: 侧栏「全局设置」入口 + 模态，编辑/回显/校验（≥0 整数）
- test: 新增全局闸达上限跨项目阻止 / 未达上限正常领取 / 边界 / 轮初短路 用例

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 19:11:42 +08:00
wangjia 5198435ba0 feat(usage): 用量明细——/api/usage 加 week 窗口+runs 计数，新增 /api/usage/detail 
costSummary 顶层补 runs 计数、period 扩 day|week|month；新增 usageDetail(day|week|month) 返回时间序列分桶 + 分项目下钻（token/花费/任务数/模型，model 维度沿用 usage JSON 近似口径）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 17:42:32 +08:00
wangjia dc7c3030a5 feat(api): 任务改动 diff 端点——GET /api/tasks/:id/diff 按文件切分 
结果评审需要看每个文件的具体改动。新增端点跑 git diff defaultBranch...branch，
按 diff --git 切分成 [{path, diff}]，供前端点击文件展开查看。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 12:11:03 +08:00
wangjia 2460b3f46c feat(api): 项目任务状态摘要——侧栏状态点 + 需人工关注数 
projectOut 此前不返 summary，前端拿到空 {} → 所有项目恒灰、无关注数。新增
store.projectSummary(projectId)：running(executor+planner 在跑)/blocked/attention(待审批闸
+needs_attention)/executing/alive 计数，projectOut 带上。前端 adaptProject 用 running 判青点、
attention 进紫徽标。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 11:04:13 +08:00
wangjia f5ea32a600 feat(settings): 用户级全局默认配置（per-user 落库 + 新建项目套默认） 
新增 settings 表（user_id PK，data JSON，单本地用户 'local'）+ store.getSettings/putSettings
（内置默认=核心策略子集）+ GET/PUT /api/settings 端点；POST /api/projects 创建时以用户
默认填充未显式传的字段（body 优先，自动放行/预算经 patchProject 套用）。前端弹框另提交。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 09:19:18 +08:00
wangjia 59ce391ecc feat(models+gate): 模型按项目可配置(默认 opus-4.8) + diff 声明外文件硬闸 
① 模型可配置（项目维度，默认 opus-4.8）
- 新增 projects.models（JSON，按角色 executor/planner/reviewer/conflict
  覆盖，值可为字符串=全复杂度统一 或 {easy,medium,hard} 分档）
- models.ts 重构 resolveModel：优先级 项目级 models > 旧 project.model
  (仅 executor/planner) > env > 默认 DEFAULT_MODEL(opus-4.8)
- 取消内置 fable/sonnet 分档默认：所有角色默认 opus-4.8（彻底回避 fable-5
  不可用问题，需要时项目级显式配置即可）；回退链改 opus→sonnet→fable
- API PATCH /projects 透传 models；sanitizeModels 落库校验

② diff 声明外文件闸（task.scopeFiles）
- 新增 tasks.scope_files（JSON glob/路径数组）
- checks.ts: globToRegExp/matchesAnyGlob + scopeFileGate（改动文件越界=硬闸，
  空声明跳过，git 出错不拦截）；pipeline runApproveGates 接入
- planner 拆解新增每子任务 files 字段：prompt 要求 + parseDecompose 解析 +
  ingest 落 scopeFiles，自动填充声明范围
- executor prompt 注入「声明文件范围约束」，让 agent 知边界（gate 才公平）

迁移：projects.models / tasks.scope_files 走 ensureColumn 幂等迁移（旧库补列）
测试：models 默认/配置/优先级、scope glob/gate、planner files 解析、
      store 持久化往返、迁移补列 —— 237 通过

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 07:06:32 +08:00
wangjia 1f318c2667 feat(agent): ② exec 自动放行（autoApproveExec）+ 抽出共享合并流程 
- 新增 exec-merge.acceptAndMerge：封装 exec_review 通过并合并的完整流程
  （merge→冲突建补救任务/成功 decide+收口+回收），API decide 与 ingest 复用同一逻辑
- server.ts decide 改调 acceptAndMerge（去重 ~40 行内联逻辑）
- ingest result：auto-approved + autoApproveExec + 双复审 approve → fire-and-forget
  自动合并（git 异步不阻塞 tick）；冲突则补救任务 + 留 exec_review 人审
- 测试：acceptAndMerge 可合并→done、冲突→补救+留审核闸（真实 git repo）

至此 plan ① ② ③ 三类优化 + 通用规则 + L1-L4 记忆注入代码侧全部落地

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:58:37 +08:00
wangjia fe7923a618 feat(agent): L2/L4 记忆注入——项目规范 + 全局规范文件喂进 4 处 prompt 
- L2 projects.agent_rules 列（schema+迁移+类型+mapper+patchProject+API 透传）
- L4 protocol.readGlobalAgentRules()：worker 直接读 <data>/agent-global.md（非DB，
  不读用户 ~/.claude/CLAUDE.md，避免个人习惯与受控执行冲突）
- runner.rulesHeaderLines 注入 executor/planner/conflict；reviewer 同注入
- 顺序：全局规范(L4)→项目规范(L2)→任务内容→上次失败(L1)→执行约束

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:29:29 +08:00
wangjia 73f80d27c9 feat(agent): 接通 plan 自动放行（autoApprovePlan）+ 项目配置可写 
之前 auto_approve_plan/auto_approve_exec/checks 列与 Project 类型已存在，但
PatchProjectInput 不含它们 → 无法启用（dead config）。本次接通：
- PatchProjectInput + patchProject 支持 autoApprovePlan/autoApproveExec/checks
- API PATCH /projects 透传三字段
- ingest decompose-result：auto-approved + autoApprovePlan + 全 easy + 子任务≤5
  → store.decide(accept) 跳过 plan_review 直达 decomposed（默认关）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:13:18 +08:00
wangjia 638f2f64f0 feat: 人工接管任务（takeover）+ 任务详情展示附件 
B-③ takeover（⑧ ★ POST /api/tasks/:id/takeover）：

后端：
- POST /api/tasks/:id/takeover：准备（或复用 result.worktree）任务 worktree，
  返回 {taskId, worktree, branch, console}——console 为用户在自己终端起交互式
  claude 的命令（daemon 无 TTY，不在进程内起交互会话）；在途 run 时拒绝

前端：
- api.takeover；TakeoverModal（展示命令 + 一键复制 + 分支提示）
- TaskDetail 加「⌨ 人工接管」按钮（onTakeover 经 TaskSection→TaskRow 线程下来）
- 顺带：TaskDetail 展示任务附件（📎 文件名，读 task._raw.attachments）

验证：typecheck 干净；206 测试通过；前端 build + dev 渲染 0 错误。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 17:06:35 +08:00
wangjia a688b6977e feat: agent 实时输出流（SSE） 
B-② SSE 实时流（⑧ ★ GET /api/tasks/:id/stream）：

后端：
- GET /api/tasks/:id/stream：SSE 跟随任务最近一条 run 的 transcript 文件，
  新写入的 agent 消息逐行推送（活跃 run=实时；已结束=回放后 end）；
  500ms 轮询 tail（按 offset 增量读），run 转非 started 即结束流，客户端断开即停

前端：
- StreamModal（EventSource 消费 SSE，summarizeMessage 把 SDK 消息→可读行：
  助手文本/⚙工具调用/■终态/·maestro 元事件，自动滚动到底）
- AgentSection agent 行可点击 → 打开实时流模态；adaptActiveAgents 带出 taskId

验证：typecheck 干净；前端 build 通过；dev 渲染 0 console 错误。
（实时效果需有运行中的 agent；端到端随 daemon 重启验证。）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 17:01:58 +08:00
wangjia 9b17d3e24f feat: 任务附件上传（图片/文件随任务提交） 
B-① 附件上传（⑧ ★ POST /api/tasks/:id/attachments）：

后端：
- 加 @fastify/multipart；schema/db.ts tasks.attachments 列（幂等迁移）
- types.Attachment{name,type,path} + Task.attachments；mappers 映射
- store.addAttachments（追加元数据 + 广播 task.updated）
- POST /api/tasks/:id/attachments：multipart files[]（单文件≤25MB/单次≤10），
  落盘 <data>/tasks/<id>/attachments/，文件名消毒，返回全部附件

前端：
- api.uploadAttachments（FormData multipart）
- 新建任务表单加文件选择 + 已选列表；创建任务后自动上传附件

验证：typecheck 干净；206 测试通过；前端 build 通过。
（端到端需重启 daemon 加载新端点——与后续 SSE/takeover 一并重启。）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 16:58:14 +08:00
wangjia 6c9b05e575 feat: 项目级成本预算系统（按模型×token 精确计费 + 超额自动暂停） 
精确到项目级的成本/预算护栏，成本按「模型 × token 用量」折算（⑧ ★ 新特性）。

定价（单源）：
- src/model/pricing.ts：MODEL_PRICES（opus/sonnet/haiku，USD/1M token，分
  input/output/cacheRead/cacheWrite）+ computeCost/addUsage，前缀容错、未知模型记 0

token 捕获链（worker → daemon）：
- cc.ts：从 SDK result 消息抓 usage，跨 resume/回退累计；CCResult.usage
- runner/reviewer：结果对象带 usage + modelUsed
- protocol.ts：新增 'usage' outbox 记录；pipeline 每次 CC（executor/复审/planner/
  conflict）后 emit usage（worker 侧写文件，不碰 DB）
- ingest.ts：'usage' → store.setRunUsage（累加、按模型折算）→ enforceBudget

存储 + 护栏：
- schema/db.ts：runs.usage/cost_usd、projects.budget_usd/budget_period（幂等迁移）
- store.ts：setRunUsage（累加）、projectSpend、costSummary（按项目/模型/总计）、
  enforceBudget（超额 → 置 paused + 广播 budget.exceeded）
- 编排器天然停领：orchestrator 既有「跳过 paused 项目」即生效，无需改

API：
- GET /api/usage：并入成本明细 {session,weekly,cost:{period,total,byProject,byModel}}，?period/?project
- GET /api/health：{ok,db,inflight,at}
- PATCH /api/projects：支持 budgetUsd/budgetPeriod

前端：
- adapt.js：agentSummary 用真实成本/token；adaptProject 透传预算字段
- app.jsx：budget.exceeded → 告警 toast
- ConfigPanel：预算 $ + 周期（day|month）受控输入

验证：typecheck 干净；206 测试通过（含新增 budget.test.ts 4 例：定价折算/累加/
costSummary/enforceBudget）；前端 build + 截图确认预算输入渲染、0 错误。
注：生效需合并后重启 daemon（迁移幂等加列、向后兼容旧库）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 15:29:44 +08:00
wangjia f8900de2f7 feat(daemon+store+api): verdict硬闸+执行期锁+conflict优先+schema 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 12:27:48 +08:00
wangjia d1e256b960 merge: 合并失败补救完成后自动收口原任务 [tsk_BagzbKZNAHXV] 
手工解决 src/api/server.ts 冲突(keep-both):main 的 cleanupTaskRunArtifacts(合并后回收 run 目录)与分支的 findMergeOriginTask/remediateOrigin(补救任务合并成功后自动把原任务标 done)互补,均保留;ensureMergeRemediationTask 调用补 conflictFiles。其余文件(store.ts/types.ts/merge.ts/web/test)自动合并。typecheck + 183 测试全绿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 20:10:00 +08:00
wangjia b1d881a4b4 feat: 合并失败→补救→完成 全程事件轨迹与自动收口 [tsk_BagzbKZNAHXV] 
不新增顶层状态，用 events + result 字段记录完整轨迹：
- 新增 merge.failed / merge.remediated 两类事件
- merge 失败时在原任务时间线记 merge.failed 节点（结构化冲突文件 + 补救任务链接）
- 补救任务成功合并后，findMergeOriginTask 反查原任务，remediateOrigin 自动把原任务标 done
  并记 merge.remediated 节点，无需人工 merge:false
- 看板：归档时间线渲染失败/补救节点；结果评审闸显示「合并失败 → 补救任务」横幅

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 15:04:39 +08:00
wangjia a365aaf06a feat(cleanup): exec_review 合并后回收 runs/<runId>/ 工作目录 + 定期扫尾 [tsk_6uziW1Dg-ftQ] 
每个 run 在 ~/.maestro/runs/<runId>/ 留下 job.json/outbox.ndjson/heartbeat，
合并（exec_review accept）后不再需要，需回收避免无限堆积。

- protocol.ts：新增 removeRunDir / isPlainRunId（幂等删 runDir，runId 白名单防越界）
- cleanup.ts（新）：
  - cleanupTaskRunArtifacts：合并/接受后即时回收某任务全部 run 工作目录
  - sweepRunArtifacts：周期扫尾终态/孤儿 runDir 与（可选）转录，按保留天数
  - isRunCleanable：仅终态(done/cancelled)/孤儿可回收，活跃/在途一律保留
  - 双保险：任务状态判定 + heartbeat 新鲜则跳过，绝不误删活跃 run
  - 保留策略可配：MAESTRO_RUN_RETENTION_DAYS(默认3) /
    MAESTRO_TRANSCRIPT_RETENTION_DAYS(默认0=永久保留，便于排查)
- server.ts：exec_review accept 合并成功后即时清 runDir（与 removeWorktree 同处）
- index.ts：startCleanupLoop 定时扫尾（MAESTRO_CLEANUP_INTERVAL 秒，默认3600，0=关闭）
- test/cleanup.test.ts：终态清/在途留/孤儿清/保留期/heartbeat 兜底/转录开关/配置

测试：npm test → 164 passed；npm run typecheck → clean

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 15:02:23 +08:00
wangjia 0b3ebbd569 feat(api): DELETE /api/projects/:id + store.deleteProject(连带 tasks/runs/events) 
新增项目删除能力：store.deleteProject 事务内删 events(无 FK,手动)+ projects(tasks/runs/
approvals 经 schema ON DELETE CASCADE 连带清)；DELETE /api/projects/:id 暴露之。
store.test 覆盖连带清除 + 重复删报错。用于清理 cutover 测试遗留的一次性 smoke-test 项目
(本次经直连 DB 删除,未重启打断在跑的 worker；端点下次重启生效)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 14:15:38 +08:00
wangjia d49192344f merge: maestro/tsk_lDx6zd-EbA00 [指标统计：执行时长 / 成功率 / 额度消耗估算] 
# Conflicts:
#	web/style.css
 2026-06-13 12:01:18 +08:00
maestro d82e07902f merge: maestro/tsk_zacmwH3chZpG [tsk_zacmwH3chZpG] 2026-06-13 11:35:53 +08:00
maestro f70004af11 merge: maestro/tsk_O9q0_u78_NPo [tsk_O9q0_u78_NPo] 2026-06-13 11:35:20 +08:00
maestro 3ad4ca2cc0 merge: maestro/tsk_sjzC4B9ctg6W [tsk_sjzC4B9ctg6W] 2026-06-13 11:35:00 +08:00
wangjia 3696604e13 feat: 指标统计（执行时长/成功率/复审通过率/重试率/额度估算）tsk_lDx6zd-EbA00 
从 runs/tasks/events 聚合健康度与成本指标，看板新增指标小面板。

- Store.metrics(projectId?)：执行时长(avg/p50/p95，未结束与负时长不计)、
  executor 成功率、复审/安全 verdict 通过率、failed→queued 重试率 +
  needs_attention、按模型额度粗估(时长×档位权重，标注估算)
- src/model/metrics.ts：类型 + 纯函数(percentile/ratio/estimateCostUnits/emptyMetrics)
- API：GET /api/metrics?project=
- web：归档区上方指标面板(数字卡 + 按模型分布)，失败/空数据静默隐藏
- test/metrics.test.ts：9 个用例(纯函数/空数据/时长/成功率/复审/重试/按模型/项目过滤)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 10:55:56 +08:00
wangjia 13572a5416 feat(complexity): 新增 AUTO·由模型判断 复杂度档位 (tsk_zacmwH3chZpG) 
新建任务时除手选 hard/medium/easy 外，新增 AUTO 档：先以 medium 落库
占位，建任务后异步用 sonnet 起一次轻量分类调用回填三档结果并记录理由，
不阻塞建任务返回；模型不可用/解析失败一律兜底 medium，绝不报错。

- web 看板：复杂度 seg 增加第四档 AUTO（默认选中，cyan 样式），提交 complexity='auto'
- src/api/server.ts：POST tasks 接受 'auto' → medium 占位 + 异步 classify 回填（可注入 classify 测试）
- src/executor/classify.ts（新增）：buildClassifyPrompt/parseClassification/classifyComplexity
  复用 cc.ts/models.ts，sonnet 省额度，无工具、限轮限时
- src/executor/models.ts：pickClassifierModel（复用 executor easy 档 + MAESTRO_MODEL_EASY 覆盖）
- src/store/store.ts：applyAutoComplexity 回填复杂度+重置状态+理由入产出字段+广播 task.updated
- test/classify.test.ts：解析映射/兜底、prompt、回填、建任务集成（13 例）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 10:46:37 +08:00
wangjia 0957a9049a feat(transcript): 归档详情内回放执行/复审转录 (tsk_O9q0_u78_NPo) 
- API：新增 GET /api/runs/:id/transcript，读 run.transcriptRef 指向的
  jsonl，逐行解析成脱敏后的结构化消息数组。校验 runId 合法且关联任务/
  项目存在；路径只允许在 transcriptDir 下（防目录穿越）。
- 脱敏：只透传 assistant 文本 / tool_use(名+摘要参数) / tool_result(截断)
  / 结论 / 模型回退；命中 secret/token/env 等敏感键名的值剔除为 [已脱敏]。
- 看板 archiveModal：执行历史从"文件路径"换成可展开的消息流，按 type
  分类渲染（文本/工具调用/工具结果/结论/回退），长内容折叠，复用 mdToHtml。
  executor 与 reviewer/security run 并列可回放。
- Store：新增 getRun(runId)。
- 测试：transcript 解析（样例 jsonl/脱敏/截断/坏行容错/路径穿越）+ 端点
  inject（合法/未知 runId/无转录/越界路径）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 10:42:57 +08:00
wangjia 60265656e2 feat: MCP/CLI 追平 Phase 2 后端能力（score/复审/合并/额度/归档） 
任务 ID：tsk_sjzC4B9ctg6W

MCP（src/mcp/index.ts，重构为可测的 createTools(apiFn)）：
- 读：新增 get_agents（自治/并发/调度/模型/在途）、get_usage（订阅额度）、
  list_archived（终态分页）；get_task 补 score（自身分+链条惯性+解锁加权）
  与 review（summary/verdict/securitySummary/securityVerdict）显式字段。
- 写：新增 patch_task（复用 store.patchTask 校验）、patch_project、sync_project、
  decide（action + merge：通过并合并 / 仅通过；reject 必带 reason）。
- 复核全部工具 description 与状态机语义一致；entry-guard 便于 import 测试。

CLI（src/cli/index.ts）对齐子命令：
- project set / task patch / decide <id> accept|reject [--no-merge] /
  agents / usage / archive。两端均薄封装走 REST，不重复实现。

API（src/api/server.ts）：新增 GET /api/usage 单独透传订阅额度。

测试：新增 test/mcp.test.ts（zod schema 边界 + 对 mock api 的 method/path/body
断言 + score/分页/错误透传），npm test 103 全过、typecheck/build 通过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 10:35:34 +08:00
wangjia 72b174fd44 feat: 支持依赖(deps)创建后编辑 (tsk_UQ7sNRM0Yi1L) 
deps 此前仅建任务时可设，本次让 PATCH /api/tasks/:id 受理 deps，
拆解后可随时调整任务依赖，无需删重建。

- API：PATCH /api/tasks/:id 受理 deps:string[]（类型校验）
- Store.patchTask：写 deps 前复用建任务校验（存在/同项目/非自身）
  并加 DFS 环检测（拒绝 A→B→A）；越权/缺失/成环 → StoreError(400)
- 仅允许在未进入执行链路的状态改 deps（与 complexity 同一组守卫）
- 写后调 reconcileDeps 重算：未满足 ready→blocked、刚补全 blocked→ready，
  广播 status.changed
- 看板：任务详情加依赖编辑器（多选当前项目其它任务，排除自身与会成环者），
  保存走 PATCH
- 测试：加/删 dep、已 done 依赖放行、环检测、跨项目/缺失拒绝、
  执行链路状态拒绝、status.changed 重算（test/patch.test.ts）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 10:33:39 +08:00
wangjia a00091329d merge: maestro/tsk_N5wO3Armums2 [重试与超时策略细化(可配 + 退避)] 
# Conflicts:
#	src/api/server.ts
#	test/store.test.ts
 2026-06-13 10:20:20 +08:00
wangjia d56b0641c5 merge: maestro/tsk_PbcHccuPmwxV [任务取消/删除的 UI 入口] 
# Conflicts:
#	web/style.css
 2026-06-13 10:16:48 +08:00
wangjia 217eb6aa1f feat(merge): 自动合并失败时建最高优先级补救任务来完成合并 
decide 端 exec_review accept→merge 冲突失败时,不再只是报错留在闸:
自动建一个 P0 easy 补救任务(operations 写明分支/目标/冲突详情与解冲突步骤),
自治项目会自动领取去解决。幂等:补救任务 id 记到原任务 result.mergeTaskId,
已有未结束补救任务则复用不重复建;结束(done/cancelled)后允许新建。

- model/types: TaskResult 加 mergeTaskId 字段
- mappers/orchestrator: 同步透传/补 null
- store.ensureMergeRemediationTask + store.test 覆盖(P0/easy/ready/operations/幂等/可重建)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 09:13:30 +08:00
wangjia c89d6d129c 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>
 2026-06-13 04:04:41 +08:00
wangjia bb6186902a feat: 项目 logo + 侧栏拖动排序 + 合并修复(主检出干净时 in-place) 
- 项目 logo：仓库内文件(logo/icon/favicon 等多路径)→git remote 头像→自定义(URL/相对路径)→
  首字母徽章兜底；GET /api/projects/:id/logo(文件流/302)，配置面板加 Logo 输入
- 侧栏项目拖动排序：projects.sort_order + POST /api/projects/reorder，乐观更新
- 合并修复：默认分支正被主检出占用时，若工作区干净则直接在主检出 in-place 合并
  (用户手动合并的等价操作，安全)；脏工作区拒绝并提示提交/暂存或仅通过
- schema: projects.logo / sort_order(ensureColumn 平滑迁移)

测试 75/75(merge 用例改为干净→成功/脏→拒绝)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 03:45:24 +08:00
wangjia b60225779c feat(tsk_PbcHccuPmwxV): 任务取消/删除 UI 入口（带确认） 
## 后端
- Store.deleteTask()：BFS 收集子孙 id，清理 events，删根节点（子孙/runs/approvals 由 FK CASCADE 自动清除），广播 task.updated{kind:'delete'}
- API POST /api/tasks/:id/cancel：transition → cancelled（复用状态机守卫）
- API DELETE /api/tasks/:id：级联删除任务及子孙

## 前端
- 任务行（task-row）：鼠标悬停后右侧出现「✕取消」「🗑删除」浮动按钮，点击弹 confirm() 二次确认（含子孙数提示），stopPropagation 防止触发行展开
- 任务详情（detail）：底部行内确认区——「取消任务」显示确认条（确认取消 / 算了），「删除」显示含级联提示的高亮确认条，折叠/切换项目时自动清除确认状态
- 归档详情对话框：底部增加「🗑 删除归档」按钮，confirm() 确认后删除并关闭弹窗
- CSS：.task-row-cancel/.task-row-delete（悬停淡入）、.detail-actions / .detail-action-confirm / .detail-confirm-msg、.archive-modal-actions

## 测试
- 新增 4 个 store 测试：deleteTask 叶子、deleteTask 级联、deleteTask 不存在、transition→cancelled
- 全部 78 条 pass

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 03:37:01 +08:00
wangjia 740d2c2637 feat: PR 审核流程 + 自动合并 + macOS 通知 + 订阅额度透传 + 归档详情 
PR 流程（开发→提PR→CodeReview→安全审计→审核→通过即合并）：
- reviewer 拆分为 code review 与安全审计两个独立 CC run（kind=reviewer/security），
  TaskResult 四字段(summary/verdict + securitySummary/securityVerdict)，闸上两节报告两枚结论徽章
- executor/merge.ts: 通过即合并——临时 worktree 内 merge --no-ff，绝不碰用户工作区/不 push；
  冲突安全拒绝(报冲突文件)；重复合并幂等；合并后回收执行 worktree + 删分支
- decide 路由 merge:false 逃生口 + 看板「仅通过」按钮(目标分支被工作区检出时用)

通知（daemon/notify.ts）：
- macOS 原生通知: 进审核闸(复审建议拒绝标⚠)/连续失败需人工/合并完成
- 同任务同类型 60s 抑制、osascript 转义截断、MAESTRO_NOTIFY=0 关闭

订阅额度透传（daemon/usage.ts）：
- OAuth usage API(与 Claude Code/claude-hud 同源)，凭证 keychain→内存零泄漏
- 60s 成败双缓存+并发去重+5s 超时，失败降级 null
- GET /api/agents 顶层 usage 字段；Agent 面板显示 5h/周用量条+重置倒计时(>80%琥珀/>95%红)

看板与生命周期：
- 归档区: 深度1整树完成沉底，时间倒序分页(尺寸 chip 10/20/50/100 置底)
- 归档详情对话框: 全属性/执行历史与时长/审批记录/状态流转时间线(GET /api/tasks/:id/events)
- 容器收口: 已拆解 Hard 子任务全 done 自动 done(afterDone 逐级向上)
- 同步按钮收进配置面板；执行白名单扩测试命令(npm/go/shellcheck/make/pytest)
- Agent 面板显示调度模式与各复杂度模型；被依赖阻塞→被阻塞

测试: 74/74(新增 merge 6/notify 10/usage 7/容器收口/双复审适配)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 03:22:30 +08:00
wangjia f18db021c3 feat: Phase2 完整管线——score 调度 + 自动复审 + 模型分级 + 归档与详情 
调度：
- model/scoring.ts: score = 自身分(P0=3/P1=2/P2=1) + 已完成依赖分(链条惯性)
  + 等待解锁的 blocked 任务分(解锁加权)，编排器与 nextExecutable 同一打分
- createTask 校验 deps 存在且同项目(依赖图天然无环)
- daemon 重启中断自愈: executing 任务标 failed run 后重新入队(reconcileInterrupted)

执行管线：
- executor/cc.ts: 公共 headless CC 执行器(转录/超时/模型回退重试)
- executor/reviewer.ts: 执行后自动复审(只读 CC 审 diff)，固定模板 summary
  (做了什么/怎么做/测试/CodeReview/安全Review/结论) + VERDICT 解析
- executor/models.ts: 按复杂度选模型(easy→sonnet/medium→opus/hard→fable5)，
  env 可覆盖、project.model 最优先、不可用自动回退链
- runner: 测试/构建命令白名单(npm/go/shellcheck/make/pytest)，prompt 要求实跑测试
- TaskResult 加 summary/verdict; RunKind 加 reviewer
- 容器收口: 已拆解 Hard 子任务全 done → 容器自动 done(afterDone 逐级向上)

看板：
- 五徽章组(待审批/待执行/执行中/被阻塞/总量，hover 展开，均不含已完成)
- 归档区: 深度1整树完成沉底，时间倒序分页(10/20/50/100 chip 选择)
- 归档详情对话框: 全属性/执行历史与时长/审批记录/状态流转时间线(含相关人或事)
- Agent 面板显示调度模式 + 各复杂度实际模型
- 结果闸展示复审 summary + 建议通过/拒绝徽章
- 筛选修复(组选与单选分离、已拆解移出进行中)、同步按钮收进配置面板、
  保存配置自动收起、预览全宽、被依赖阻塞→被阻塞
- API: GET /api/tasks/:id/events(任务级事件时间线)、/api/agents 带 scheduling/models

测试: 49/49(新增 scoring/复审/模型/容器收口/deps 校验/中断恢复)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 02:46:37 +08:00
wangjia fa472a06a7 feat: 同步引擎+Agent配置+依赖自动落位+看板大改(预览/md渲染/筛选/徽章组) 
后端：
- src/sync/todo-sync.ts: todo.json 单向同步引擎（导入=首次同步，幂等，source_ref 映射，
  subs 复杂度修正为 easy，旧侧 done 历史事实优先 forceDone）
- 依赖自动落位：ready 意图按 deps 落位 blocked，依赖全 done 自动放行，
  daemon 启动 reconcileDeps 对账，手动绕过会弹回
- 新 API: PATCH projects/:id(autonomy/concurrency)、POST :id/sync、GET /api/agents、
  PATCH tasks/:id(title/priority/complexity 重置)
- daemon 定时同步(MAESTRO_SYNC_INTERVAL 默认 300s) + project.synced 事件
- priority 语义翻转: P0 最高/P1 默认/P2 最低，取值限 0..2，排序/映射/MCP/CLI 全跟进
- 静态服务发 no-cache 头（修浏览器吃旧 CSS/JS）
- schema 迁移: tasks.source_ref / projects.last_sync_at（ensureColumn 平滑升级旧库）

看板：
- 全屏预览模式（94vh 读完整方案+就地裁决，Esc/遮罩/裁决自动关闭）
- 产出 markdown 渲染为 HTML（零依赖渲染器，转义优先）
- 任务树筛选（复杂度/状态分组/关键字）+ 顶栏徽章组（待审批/可执行/执行中，hover 展开）
- 依赖可视化：详情 DEPS 区块 + 行内⛓等依赖 + 锚点跳转定位
- 按钮收敛：提交评审/编辑产出移除（CC 经 MCP 操作），界面只留用户动作
- Agent 执行面板 + 项目配置（并发/工作模式）+ 同步按钮

测试：21 个全过（新增 sync 幂等/迁移/patch/依赖落位/对账幂等）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 23:58:28 +08:00
wangjia 3172718a94 feat: Phase1 核心——模型/状态机 + SQLite Store(守卫+审批闸) + REST/WS API + daemon 
- src/model: 复杂度分级、16 状态状态机、实体类型
- src/store: better-sqlite3 接 schema，transition 受 canTransition 守卫，
  decide 审批闸(reject 必带改进意见)，事件订阅广播，nextExecutable
- src/api: Fastify REST + ws 事件广播(/ws)
- src/daemon: maestrod 入口(env 配置，默认 ~/.maestro :4517)
- test: 9 个生命周期单测全过；typecheck/build 干净；REST+WS 端到端实跑验证

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 20:44:45 +08:00