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

55 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 3780f1c064 fix(orchestrator): 拆解未批准前冻结子任务——父任务 plan_review/analyzing 期间子任务不可领取 
修复 bug：auto-approved 项目里 planner 拆解后子任务立即被领取执行，而父任务还在
plan_review 等人审批，导致拆解若被驳回则子任务已白跑。claimable 加闸：子任务的父任务
处于 plan_review(待审拆解)或 analyzing(拆解中)时冻结，批准(decomposed)后放行。
仅冻结这两态，不影响 todo-sync 等其它带 parentId 的流程。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 10:57:24 +08:00
wangjia fa4ba3db28 feat(rule13): 执行前分歧重评估闸——main 撞声明范围→needs_attention 重评估 
通用规则13的(B)半边：sync main 之前先跑 reevalScopeGate，
以 git diff HEAD...origin/main 取 main 自分支点以来改动的文件，
与任务 scopeFiles 求交集；非空即 emit needs-reeval →
daemon markReeval 直接转 needs_attention（不重试/不计失败/run收尾cancelled）。

- checks.ts: + reevalScopeGate / ReevalGateFn / ReevalGateResult
- pipeline.ts: createWorktree 后、syncMain 前插入重评估闸 + reevalGate 依赖注入
- protocol.ts: + needs-reeval OutboxRecord/Payload 事件
- ingest.ts: + case 'needs-reeval' → store.markReeval
- store.ts: + markReeval（executing→needs_attention，不进重试链）
- status.ts: executing 合法转移 + needs_attention
- 测试 +5：reevalScopeGate(命中/未命中/空/无前移/git错) · pipeline(命中emit/未命中续跑) · store.markReeval；全套 242 绿
- docs: optimization-plan.html 规则13 标 ✅ 已实现

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 20:15:02 +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 4c09186f36 fix(ingest): autoApproveExec 传错 id 致自动合并不触发（线上实测捕获） 
condition 误把 taskId 传给 autoApproveExecOn(projectId) → getProject(taskId)=null
→ 永远 false，自动合并从不触发（任务卡 exec_review）。
重构为 shouldAutoApproveExec(store, task, codeV, secV)，内部读 task.projectId 自取项目，
杜绝传错 id；补单测覆盖。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 23:51:07 +08:00
wangjia a9c51021aa fix(models): isModelError 识别「issue with the selected model」→ 触发回退链 
线上实测：reviewer 用 fable-5 报「There's an issue with the selected model
(claude-fable-5)」（该档未对当前账号开通），但 isModelError 未命中此措辞 → 不回退 →
复审失败（verdict=null）。补正则后 fable-5 不可用会自动回退 opus 重试，复审正常。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 23:44:48 +08:00
wangjia 1bf3fecf42 fix(store): 补 checks/auto_approve_* 列的 ensureColumn 迁移（旧 DB 缺列 bug） 
线上实测复现：既有 DB 的 projects 表早于这三列创建，schema.sql 的
CREATE TABLE IF NOT EXISTS 对已存在表是 no-op，故必须靠 ensureColumn 补列，
否则 createProject 的 INSERT 引用不存在的列报错「table projects has no column named checks」。
上个会话加列时漏了迁移，:memory: 测试走全新建表没暴露。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 23:41:10 +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 2d127698d1 feat(agent): ② approve 前硬闸——分项检查(lint/typecheck/build) + diff 体量闸 
- checks.ts：runChecks 按 lint→typecheck→build 逐项跑（worktree 内，各 10min，
  任一非0=硬失败报哪项挂）；parseChecks 解析 project.checks JSON
- diffSizeGate：git diff --numstat 统计文件数+增删行数，超阈值=硬失败（提示拆解）；
  阈值 env 可配 MAESTRO_DIFF_MAX_FILES/LINES（默认 60/3000，0=不限）；git 出错不拦截
- pipeline：verify 后插 checks+diff 闸，任一失败 emit failed 不进复审；
  conflict 管线只跑 checks（diff 含整条原分支，体量闸会误伤）
- 注：diff「声明外文件」闸未做——task 无声明文件范围字段

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:53:56 +08:00
wangjia 74be3ecec1 feat(agent): L3 记忆注入——子任务带父任务拆解意图 + 兄弟状态 
- types.TaskContext + Task.context（daemon 装配、不持久化）
- store.taskContextOf(taskId)：父 plan + 同层兄弟概览（标题/状态/复杂度，排除自身）
- orchestrator.claimOne：executor 子任务填充 context 下发（planner 跑在父任务上不需要）
- runner.buildPrompt 注入「## 拆解背景」段（顺序：规范→背景→任务内容）
- 仅 DB 读，不做 git/RAG 检索（成本控制）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:32:21 +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 ff2d7c22e7 feat(agent): 模型档位升 fable-5（复审/hard拆解/解冲突）+ 回退链 fable 置首 
按 plan ①②③④ 定稿（用户确认）：
- reviewer 三档统一 fable-5（不被 project.model 降档，保复审严格度）
- planner hard 拆解 opus→fable-5（最烧脑用最强档）；medium=opus/easy=sonnet 不变
- conflict 固定 fable-5（解冲突恒用最强档）
- MODEL_FALLBACK_CHAIN: [fable-5, opus-4-8, sonnet-4-6]（fable 置链首）
- executor 档不变（per plan ②）；CLAUDE.md 档位表同步更正

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:24:30 +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 ecea1ae9b6 feat(agent): L1 记忆注入——重试任务带上次失败原因喂回 prompt 
- store.lastRunErrorOf(taskId)：取最近一次失败 run 的 error（任意 kind）
- orchestrator.claimOne：写 job.json 时填充 task.lastRunError 下发 worker
- runner 三处 prompt（executor/planner/conflict）注入「## 上次失败原因」段（截断 2000 字符）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:09:06 +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 a5a3c967ce fix: 全量替换 claude-fable-5 → claude-opus-4-8（模型不可用） 
- models.ts: 所有档位默认值、回退链、conflict 固定值全部换为 opus-4-8
- 回退链从三项缩为两项 [opus-4-8, sonnet-4-6]（删除重复项）
- metrics.ts: 额度权重 opus-4-8 升为 1.0（现为最高档）
- 测试同步更新

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 15:14:09 +08:00
wangjia 027a9cb2d6 fix(tests): 修复三类优化实现后的测试适配 
- pipeline.test.ts：PipelineDeps 增加 syncMain 可注入接口（默认用真 git），
  测试 mockDeps 加 syncMain=no-op + runConflict，消除 fake-worktree 上真 git 调用失败
- models.test.ts：reviewer 三档默认 fable-5、project.model 不覆盖复审/conflict、
  MODEL_FALLBACK_CHAIN 三项链；pickFallbackModel 改为取链上下一档（循环）而非首个不等项
- ingest.test.ts：verdict=reject 硬闸测试改为断言未进 exec_review

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 14:05:22 +08:00
wangjia a8f75cf10a fix(store): reconcileInterrupted 跳过已终态任务,避免 cancelled→failed 让 daemon 启动崩溃 
执行中的任务被 cancel 后仍挂 started run;daemon 重启时 reconcileInterrupted 对它调 failTaskAttempt → transition(cancelled→failed) 非法 → 启动抛错退出(整个 daemon 起不来)。修:终态(cancelled/done)任务只 finishRun 收尾,不再 fail*Attempt。含回归测试(202 全绿)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 23:27:53 +08:00
wangjia d1862efb4b merge: planner runs — 编排器自动拆解 hard / 自动写方案 medium [planner; tsk_1dkswD5Ub7gT] 
部署 planner 功能(此前实现在 planner 分支、测试绿,未合):编排器把 analyzing/speccing 也当可执行,派 planner run 自动拆解(hard→子任务+plan_review)/写方案(medium→spec+spec_review);in-flight 从 status 泛化为'有 started run';reap 区分 executor/planner。与 main 干净合并,typecheck + 201 测试全绿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 23:10:12 +08:00
wangjia 645d36323e merge: worker 池化 + SDK resume 抗抖动 [tsk_74Acz1Nh4K1J] 
手工正确合并(破除补救死循环):带上 src/executor/cc.ts 池化 + SDK resume + test/cc.test.ts(typecheck + 189 测试全绿)。DESIGN.md 冲突取 main 新版(多进程 re-adopt / worker 不碰 DB 描述),保留 246 行 SDK-resume 新增条目,丢弃分支过时描述。

此前补救任务只啃了 DESIGN.md 冲突文件、没带 cc.ts 代码,导致真代码一直没落地、原任务卡 exec_review、每次重试又生新补救(xbtd6GpS4NYg→Yb8eFAX2VUxZ)的死循环,至此终结。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 20:32:10 +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 8392944877 feat(planner): 编排器把 analyzing/speccing 也当可执行——派 planner run 自动拆解/写方案 
修复"hard/medium 任务建后永远停在 analyzing/speccing"的缺口：编排器现在对 analyzing(hard)
派 planner-decompose、对 speccing(medium) 派 planner-spec（auto-approved 下；auto-easy 仍只执行 easy），
planner 只读跑 CC（无 worktree/无写）产出 → daemon 落库 + 自动提交到 plan_review/spec_review 闸（仍人审）。

- protocol: JobSpec.runKind + spec-result/decompose-result 两型 outbox + DecomposeResult
- runner: runPlanner（只读 Read/Glob/Grep 跑在 repo，opus 档）+ buildPlannerPrompt
- pipeline: runKind 分支 + parseDecompose（取末尾 fenced JSON，非法→failed）
- orchestrator: claimable 纳入 analyzing/speccing + 排除在途；并发/in-flight 从 countExecuting 泛化为
  inflightTaskIds（有 started run 的任务，executor+planner 通用）；claimOne 按状态分 executor/planner
  （planner 不转状态）；reap 泛化（死 planner→failPlanAttempt）
- ingest: ingestAll 覆盖所有 started run；spec-result→setSpec+spec_review；decompose-result→setPlan+建子任务+plan_review；
  failed 按 kind 分流（planner→failPlanAttempt 退避留态、超限→needs_attention）
- store: inflightTaskIds / liveRunsWithTask / failPlanAttempt；reconcile 泛化到所有 started run
- status: analyzing/speccing 加 →needs_attention（planner 失败超限升级）
- models: planner 角色（opus）；status: RunKind 已含 planner
- 测试 +12（pipeline 5 / ingest 3 / orchestrator 4），194 全绿

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 16:59:30 +08:00
maestro dcf610f6fd merge: maestro/tsk_oTFzOMeAU20D [tsk_oTFzOMeAU20D] 2026-06-13 15:51:31 +08:00
wangjia d0b807460e feat(executor): worker OS 级沙箱 + 资源限额（sandbox-exec / ulimit）[tsk_oTFzOMeAU20D] 
进程隔离之上再加一层 OS 级硬隔离，默认关闭，便于先在一个项目灰度：

- 新增 src/executor/sandbox.ts：
  - macOS sandbox-exec 写围栏 profile（allow default 基线 + deny file-write* 收口
    + 逐条放行 worktree/主仓.git/node_modules/runs/transcripts/tmp/工具缓存）。
    不 deny default 全围栏——合法 git/npm/go/node 需读海量系统路径，写才是破坏向量。
  - ulimit 资源上限（CPU 时间/虚拟内存/打开文件数/单文件大小），经 sh -c 下发，
    exec 链保证 pid 不变（daemon 记录的 workerPid 仍是真 worker）。
  - 全部由 env 解析（MAESTRO_SANDBOX*），网络默认放行（SDK 连 Anthropic）。
- orchestrator.defaultSpawnWorker 接入：开启时把命令包成
  sh -c 'ulimit…; exec sandbox-exec -f profile <原命令>'；关闭时行为零变化。
  startOrchestrator 启动时打印生效策略，每个 run 的 profile 落 runs/<runId>/sandbox.sb。
- README 增补环境变量与「worker 沙箱」说明。
- 新增 test/sandbox.test.ts（18 例：config 解析 / profile 生成 / ulimit / 包装 / 预建目录）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 15:08:18 +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 53efe32a6e feat(executor): SDK 抖动 resume 续跑 + worker 池化评估暂缓 [tsk_74Acz1Nh4K1J] 
可选优化任务，先评估收益再做：

- worker 池化：评估后暂缓。当前「一 run ↔ 一 pid」模型干净（判活/回收/
  re-adopt 全靠每 run 一 pid+心跳，worker 与 DB 隔离 + 重启 re-adopt 天然
  崩溃恢复），池化会打破该不变量且只在高并发量下兑现收益。现规模保持
  「每任务一进程 + 失败从头重跑」简单模型，仅记入 DESIGN.md。

- SDK resume：实现 worker 内部健壮性小优化。cc.ts 单次会话因流式异常中断
  （流断/没收到 result，非超时取消、非 max_turns 终态）且已拿到 sessionId 时，
  用 resume 接着原会话续跑一次（保留已干的活，不从头重来），剩余预算不足留 60s。
  与「重启 re-adopt / 整体失败 daemon 从头重跑」正交不替代；与模型回退互斥；
  MAESTRO_SDK_RESUME=0 可关闭。query 改为可注入便于单测。

测试：新增 test/cc.test.ts（6 例：续跑成功/终态不续/无 session 不续/
开关关闭/超时不续/模型回退）。npm test 全绿 163/163。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 15:03:25 +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 d160d27645 fix(merge): in-place 合并脏树守卫忽略未跟踪文件(--untracked-files=no) 
之前 mergeInPrimaryCheckout 用 git status --porcelain 判脏，未跟踪文件(GEMINI.md/.claude/
本地杂物)也算进去 → 误判拒绝合并(jiu/dudu 等带未跟踪文件的项目「通过并合并」必失败)。
改为 --untracked-files=no 只看已跟踪改动；未跟踪文件不挡合并(真要被覆盖时 git merge 自报错走 catch)。
测试加：仅未跟踪文件 → 仍 in-place 合并成功。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 14:40:31 +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 0d45de4507 fix(worker): env 收敛改黑名单 + 不 detached —— 修 worker 'Not logged in' 
cutover 实测：worker 起的 claude 报 Not logged in。根因：① 严格 env allowlist 把 macOS
keychain/Security 访问所需的会话变量(USER/LOGNAME/__CF_USER_TEXT_ENCODING/TMPDIR/XPC_* 等，
均非密钥)也滤掉了；本机鉴权走 keychain(无 API_KEY/凭证文件) → 读不到。
② detached(setsid)另起会话也不利于沿用 daemon 鉴权上下文。
修：workerEnv 改黑名单(会话变量透传保 keychain，仅剥 *_SECRET/*_TOKEN/*_KEY/AWS_/CF_ 等密钥，
ANTHROPIC_/CLAUDE_ 始终留)；spawn 不 detached(同会话，unref 后孤儿仍被 init 收养存活)。
实测：smoke 任务 worker 真建文件+提交、双复审 approve、到 exec_review。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 13:26:17 +08:00
wangjia 70d996110d phase3(集成测试): 真 worker 进程 spawn → 重启 re-adopt 存活 worker → ingest;死亡→回收重试 
用假 worker(走 outbox 协议、不烧 SDK token)验证 daemon↔worker 真进程 seam:
- 头条: spawn 真进程→等 started→换 Store 重连 reconcile(真判活)→re-adopt(任务仍 executing 不重跑)
  →finish 哨兵→ingest 到 exec_review(四字段 + reviewer/security/executor run 就位)
- 回收: 杀进程组 + 心跳调陈旧→reconcile 回收→failTaskAttempt 退避重入队

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 13:07:42 +08:00
wangjia adf88e82cd merge phase3-C: daemon 侧（监工 + ingest + 接线 + 测试） 2026-06-13 13:02:13 +08:00
wangjia da7c93105c phase3(daemon): 监工 tick(spawn worker)+ ingest(outbox→DB)+ reaper + reconcile 接真判活 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 13:00:50 +08:00
wangjia d8f8b5da1e phase3(worker): pipeline.ts 纯执行管线 + worker.ts 进程入口（不碰 DB，经 outbox 文件汇报） 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 12:56:50 +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 fcca3f95e0 fix(executor): node_modules 软链写入仓库本地 exclude,杜绝被提交进历史 
上一版软链修复有回归:.gitignore 的 `node_modules/`(带斜杠)只匹配目录不匹配软链,
导致 agent 的 `git add -A` 把 `node_modules -> /abs/path` 软链提交进分支,泄露本机绝对路径
(code review + 安全审计已正确 reject)。改为建软链前先把 node_modules 写进共享
<repo>/.git/info/exclude(git 的 info/exclude 取 common dir,worktree 也读它;untracked、幂等、
不动 tracked 的 .gitignore)。测试加回归断言:git add -A 后软链不出现在 status。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 09:18:18 +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 9bd02f2479 fix(executor): worktree 软链主仓 node_modules,修 verify exit 127 误判 
git worktree 是干净检出不带 gitignored 的 node_modules,导致 verify
(tsc/tsx 等)与执行 agent 跑 npm 脚本时 command not found(exit 127)被误判为失败。
建 worktree 后软链主仓 node_modules:零网络、同平台 native 兼容、被 gitignore 忽略不污染 diff;
非 Node 项目(无 node_modules)自动跳过。removeWorktree 只移除软链不动主仓依赖。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 09:01:47 +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