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

21 Commits

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 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