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

149 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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 52c053baf4 docs: 更新 DESIGN.md/README 到 Phase 3 多进程执行架构 [tsk_-HYVwxzHIbrS] 
- 写清工作模式：daemon=唯一 DB 写者+监工；worker=哑执行器（不碰 DB）
- 通讯协议：job.json / outbox.ndjson（幂等 ingest）/ heartbeat / SIGTERM
- 重启语义：reconcile 按 worker_pid+心跳判活 → re-adopt 或回收重试 + 持久化退避
- 同步更新系统总览图、数据模型(worker_pid/last_seq/next_eligible_at)、后端架构、风险、Phase 进度、env 表

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 15:00:42 +08:00
maestro f020e15137 merge: maestro/tsk_KhcaF4zoESVe [tsk_KhcaF4zoESVe] 2026-06-13 14:53:40 +08:00
wangjia 10f881130b style(web): 小圆角 + 审批闸琥珀→紫 + 组件样式对齐 design [tsk_KhcaF4zoESVe] 
看板重构 B2：对照 design/components 与 design/tokens 精修 web 组件样式。

圆角（采用 --radius-* 令牌，状态点保持正圆）：
- xs(3) chip/徽章：StatusChip(.chip)、ComplexityBadge(.cplx)、CountBadge 顶栏 count、
  .verdict/.fchip/.fgroup/.gate-kind/.run-st/.t-badge/.t-deps-wait/.agent-run-kind/
  .gate-stripe/.metric-model-bar/.gate-count/.ready-count/.doc.md code
- sm(4) 按钮/输入/doc 块：.btn、input/select/textarea、.seg、.bdg、pre.doc、.doc.md、
  codeblock、.t-pre、.dep-item/.dep-pick、.detail-action-confirm、archive-size select、
  .doc-pending
- md(6) 面板/卡片/toast：.panel、.gate-card、.toast、.filter-bar、.agent-flex/.agent-empty、
  .tree-empty、.metric-card/.metric-models、.run-item、.cplx-pop
- lg(10) 模态/预览浮层：.modal、.preview-panel

审批闸 琥珀→紫（--violet/--violet-dim），与 MED(--amber) 区分：
- gate-stripe 斜纹条、gate-head/gate-section 区块头、gate-card 边框、gate-kind 徽章、
  bdg-gate 待审批徽章、chip-gate 待审/合状态 chip、gate-count、ev-gatewait 事件、
  is-gate 行底色、preview-panel 边框；index.html 审批闸 head-mark 改 violet
- MED 保持琥珀：cplx-medium / seg-m / fc-medium / bdg-blocked / t-deps-wait / dep-item

组件对齐 design 卡片：GateCard 加 overflow:hidden + body 字号 12.5px、gate-title 13px；
浮层阴影统一走 --shadow-pop/modal/toast 令牌；EventItem 圆点 1.5px 微圆角。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 14:45:03 +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
maestro c1cdcc7e5e merge: maestro/tsk_pusPU3oCPVfc [tsk_pusPU3oCPVfc] 2026-06-13 14:36:22 +08:00
wangjia 4be02cbf0f feat(tokens): 设计令牌落地 + 浅色主题骨架 [tsk_pusPU3oCPVfc] 
在 web/style.css :root 补全缺失令牌：
- --violet / --violet-dim（磷光紫，审批闸色）
- --glow-green/violet/cyan/red（辉光 shadow 值）
- --radius-xs/sm/md/lg/dot（圆角阶梯）
- --space-1..9（间距阶）
- --pad-btn/btn-xs/input/chip/card（控件内边距）
- --shadow-pop/modal/toast（浮层阴影）
- --surface-*/--text-*/--border-*/--accent*/--status-go|gate|bad|run（语义别名）

新增 [data-theme="light"] 完整块，覆盖全部底色、文字、
信号色与辉光变量，确保浅色切换不崩版。

现有 --green/amber/red/cyan 及 @keyframes blink/pulse/rise
均未改动，暗色主题视觉零影响。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 14:32:29 +08:00
wangjia 5a1e185b1a docs(design): 解压 Maestro Design System 到 design/（重构参照材料） 
phosphor console v1.1 设计系统（从现网 web/style.css 演化）：tokens(colors/effects/
typography/fonts) + components(core/forms/surfaces .jsx) + ui_kits(console + console_mobile)
+ assets/icons(15 双色 SVG) + guidelines + CLAUDE/SKILL/readme。供 B1–B6 重构任务对照实现。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 14:29:07 +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 7d3946dc97 merge phase3: 多进程执行解耦(daemon 监工 + worker 进程 + 文件通讯 + 重启 re-adopt) 2026-06-13 13:13:34 +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 b0ef60ab58 merge phase3-B: worker 侧（pipeline + worker + 测试） 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 007dffac39 phase3(契约层): protocol.ts + 落盘状态 + store 失败策略/判活原语 
多进程执行解耦的 Phase 0 共享契约（worker 与 daemon 都 import 它）：
- executor/protocol.ts: JobSpec(daemon→worker 唯一输入) + OutboxRecord(worker→daemon) +
  文件 IO(job/outbox/heartbeat) + isWorkerAlive(心跳为主/boot 窗口 pid 兜底/防 pid 复用)
- schema+db+types+mappers: runs.worker_pid/last_seq、tasks.next_eligible_at(持久化退避)
- store: failTaskAttempt(失败/重试策略唯一落点) + setNextEligibleAt/setWorkerPid/setLastSeq +
  countExecuting + executingWithLatestExecutorRun + reconcileInterrupted(isAlive 注入,默认保守回收)

纯增量,140 测试全绿。worker.ts/pipeline.ts(worker 侧) 与 orchestrator/ingest/index(daemon 侧) 待接。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 12:51:09 +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
maestro 6b64037216 merge: maestro/tsk_UQ7sNRM0Yi1L [tsk_UQ7sNRM0Yi1L] 2026-06-13 11:34:51 +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
maestro 872354cf7c merge: maestro/tsk_nqvOyIZkd1Dn [tsk_nqvOyIZkd1Dn] 2026-06-13 10:26:42 +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 3fc19e47c4 fix(web): 任务树/父任务下拉对异常 depth/id 加固,避免整页崩溃 
renderParentOptions 的 '· '.repeat(depth-1) 在 depth=0 时抛 RangeError(Invalid count value)、
renderNode 的 t.id.slice(-6) 在 id 缺失时抛 TypeError——任一都会让看板整页崩。
改为 repeat(Math.max(0,(depth||1)-1)) 与 String(t.id||'').slice。
(node:vm + 最小 DOM harness 复现并验证)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 09:40:55 +08:00
wangjia 2c4140a1a2 feat(daemon): launchd plist + install/uninstall 脚本（tsk_nqvOyIZkd1Dn） 
提供三个文件让 maestrod 作为 macOS User Agent 开机自启、崩溃自拉：

- scripts/com.maestro.maestrod.plist  — launchd plist 模板
    KeepAlive=true（崩溃自拉）、RunAtLoad=true（登录即启）
    stdout+stderr 统一写入 ~/.maestro/maestrod.log
    ThrottleInterval=10s 防崩溃风暴；ProcessType=Background
    占位符：__NODE__ / __PROJ_DIR__ / __HOME__ / __PATH__

- scripts/install-daemon.sh  — 安装脚本
    1. 检测 node（>= 20）
    2. npm run build 构建项目
    3. sed 替换占位符，生成真实 plist 并用 plutil 校验
    4. launchctl bootstrap gui/$UID（回退 load -w）加载服务

- scripts/uninstall-daemon.sh  — 卸载脚本
    launchctl bootout / unload -w 卸载，删除 plist

shellcheck 通过（两个脚本）；现有 77 个单元测试全部通过。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 09:24:04 +08:00
maestro ac0d5b7b77 merge: maestro/tsk_ExRzLoBj12Fr [tsk_ExRzLoBj12Fr] 2026-06-13 09:22:35 +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 47eeaf1902 merge: maestro/tsk_kmdMuWSn0HUS [配置面板补 verifyCmd / 项目级 model] 
# Conflicts:
#	web/app.js
#	web/index.html
 2026-06-13 09:02:52 +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 52169e412c docs: 更新 DESIGN.md v0.2 + README 到现状 [tsk_ExRzLoBj12Fr] 
新增/更新：score 调度算法（§8）、双复审 PR 流程（§9）、模型分级与回退
（§10）、自动合并边界（§11，两条路径 + 逃生口）、归档与运行历史（§12）、
macOS 通知（§13）、额度透传（§14）。分期实施状态更新为 Phase 1+2+3 已落地。

README 新增：环境变量表、各功能速览（score 调度公式、双复审流程、模型分级
表、归档 API、通知触发条件、自动合并逻辑）；当前状态由「脚手架」更新为实际
已落地功能。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 04:10:16 +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 f2c2d9aebd feat(ui): 配置面板补 verifyCmd / 项目级 model 输入项 
在 #configPanel 新增一行 form-row，包含「校验命令」(cfgVerifyCmd) 和
「项目 Model」(cfgModel) 两个文本输入；打开面板时从 project 读取当前值，
保存时通过 PATCH /api/projects/:id 写入（空白 → null 清空）。

任务 ID：tsk_kmdMuWSn0HUS

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 03:32:23 +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 c6e66baa19 feat: Phase1 完整交付——Web 看板(frontend-design) + MCP server(12 工具) + CLI/导入器 
- web/: phosphor 调度台风格纯静态看板，审批闸内联 accept/reject(拒绝必填意见)，WS 实时
- src/api/static.ts: 手写静态服务(路径穿越防护)，daemon 接入
- src/mcp/: stdio MCP server，@modelcontextprotocol/sdk 1.29.0，12 工具薄封装 REST
- src/cli/: 零依赖 CLI(project/task/next/approvals/import-todo)，旧 todo.json 导入器
- 实测: pangolin 18 条旧任务导入 45 条；端到端验证通过

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 21:23:08 +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