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

89 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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 7a6c826610 feat(app): 任务生命周期操作 UI（编辑/取消/重投/删除 + 复杂度落库） 
补齐前端缺失的任务管理闭环（均接现有后端端点，无需后端改动）：

- api.js：patchTask / cancelTask / requeueTask / deleteTask
- app.jsx：taskOps{patch,cancel,requeue,del}，统一带刷新 + toast
- TaskDetail 操作工具条：✎编辑 / ⌨接管 / ↻重投 / ⊘取消 / 🗑删除（删除带确认；
  重投/取消按状态显隐）
- 编辑表单：标题 + 优先级 + 依赖（点选其他任务）→ PATCH /tasks/:id
- 修复：行内复杂度选择器（CplxPicker）从「仅本地 state」改为真正 PATCH 落库

验证：build 通过；建临时任务实测——工具条/编辑表单渲染 0 错误、DELETE 成功
（deleted:1）、PATCH 在途守卫正确拒绝；测试残留已清理。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 17:26:29 +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 0a1f500c12 feat(app+ds): 阶段2 接前端写操作——任务创建/配置保存/新建项目 
让原型里的视觉 mock 表单变为真正可写（附加式、向后兼容原型 index.html）：

design/ui_kits/console（surface 功能化，DS 组件本就支持 onChange）：
- NewTaskPanel：表单受控（title/complexity/priority/parentId），onCreate 出参；
  父任务下拉扁平化含子任务
- TaskSection：暴露 onCreate prop（无则回退原 toast）
- ConfigPanel：受控（concurrency/autonomy/logo/verifyCmd/model），onSave 出参

app/：
- api.js：加 createProject
- app.jsx：createTask→POST /tasks、saveConfig→PATCH /projects、createProject→
  POST /projects；新增 NewProjectModal（design 无现成 surface，用 DS 组件就地拼装，
  zh/en 标签自含）；接 Sidebar 新建项目入口

验证：dev + 生产构建双通过；Playwright 实测新建项目模态打开、受控输入捕获值
（["demo-app",".../demo-app","main"]）、0 console 错误。写端点契约逐字段比对
server.ts（PATCH camelCase / POST tasks {title,complexity(auto),priority,parentId,deps}）。
活写测试从略：maestro 为 auto-approved，建真实任务会触发 agent。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 14:44:46 +08:00
wangjia d6ae4dbe13 feat(app): 阶段2 接真实数据——REST + WS 直连本地 daemon 
前端从 mock 切换到真实数据源（按 ⑧ 前端 API 契约，复用现有 :4517 daemon API）：

- src/api.js：REST 封装 + WS 单向订阅（断线指数退避重连）
- src/adapt.js：纯映射层，把 API 的 camelCase 行映射成各 surface 期望形状
  （扁平任务→children 树、priority 整数→P0/1/2、complexity→cplx、终态→归档卡）
- src/app.jsx：改为 useEffect 拉取 + WS 增量刷新；decide/sync 走真实 POST；
  审批闸收紧到 plan/spec/exec_review 三态（needs_attention 仍在任务树可见）
- vite.config.js：加 /api + /ws 反代到 :4517；去掉 jsxInject（surface 走全局
  React，避免生产构建 rollup 从 design/ 解析 react 失败）
- main.jsx：移除 data.js mock 导入

验证：dev + 生产构建双通过；真实数据渲染（4 项目/审批闸带 diff/真实配额），
WS 已连接，0 console 错误。token/成本类（agentSummary）属 ⑧ ★ 新 /api/usage
（预算特性），暂留空待补。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 14:29:19 +08:00
wangjia 1fcd811c12 docs: maestro 后端重构 Phase1 设计文档（schedule_status × work_type） 
8 章设计文档 HTML（架构决策/状态设计/DB Schema/记忆注入/Agent 规格/
运维护栏/安全沙箱/前端 API 契约），全图深色内联 SVG，附 docs/index.html 索引。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 13:52:53 +08:00
wangjia 0a896439d1 feat(app): React 18 + Vite 前端，像素级复刻 Maestro 设计系统 console 
复用 design/ 设计系统作单一真相源（token + _ds_bundle.js + 6 个 surface
源文件不改），只移植 App 入口。整屏 console 与原型截图 diff 0.023%（≤0.5% 阈）。

- vite.config.js：经典 JSX + 注入 React，alias @ds → ../design
- src/globals.js：先注入 window.React，供预编译 bundle 使用
- src/main.jsx：按序加载 tokens → bundle → mock/i18n → 6 surface → App
- src/app.jsx：移植自原型 App()，三栏可拖拽 grid
- src/ambience.css：扫描线 + 暗角 phosphor 氛围层

下一步：mock data.js/i18n.js 换成真实 REST + WebSocket（按 ⑧ 前端 API 契约）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 13:50:22 +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 433b2dc232 feat(web+store): needs_attention 任务显示在审核区，附失败原因 
- pendingApprovals 扩展到包含 needs_attention，subquery 取最近 executor 失败 error
- Task 类型增加 lastRunError 字段，mappers 映射
- 审核区（renderGates）将 needs_attention 渲染为独立橙色卡片，
  展示「需人工确认」标签 + 具体失败原因 + 重新排队/取消按钮
- i18n zh/en 补充 attnLabel/attnReason/attnRequeue/attnCancel/toastRequeued

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 14:46:21 +08:00
wangjia 4a2b4e1094 feat: launch.sh — start/stop/restart 服务管理脚本 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 14:33:14 +08:00
wangjia 36e8f736e6 fix(web): renderPreview 中 task 变量遮蔽全局 t() 翻译函数导致预览点击无效 
将 renderPreview 内 const t = tasks.find() 改名为 task，
避免局部变量 t（任务对象）遮蔽全局翻译函数 t()，
使预览面板渲染时抛 't is not a function' 导致面板无法打开。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 14:23:56 +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 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 ae9ff7a469 feat(pipeline): 并行复审+sync-main+conflict-pipeline 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 12:23:57 +08:00
wangjia 76d11a8307 feat(runner): planner prompt扩展+conflict agent 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 12:20:26 +08:00
wangjia fa19ff6de1 feat(models/protocol/types): 模型档位优化+协议扩展 
- models.ts: 回退链加 fable-5 首位；planner 按复杂度分化（sonnet/opus/fable）；reviewer 全升 fable-5；加 conflict 角色，reviewer/conflict 不受 project.model 覆盖
- protocol.ts: RunKind 加 conflict；DecomposeResult.subtasks 扩展 priority/deps 字段；OutboxRecord decompose-result 同步对齐
- types.ts: Project 加 autoApprovePlan / autoApproveExec / checks 可选字段

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 12:18:02 +08:00
wangjia 90d963312f fix(web): renderNode 内 t 被 task 参数遮蔽导致 t is not a function 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 00:57:57 +08:00
wangjia 33513757a3 fix(web): renderNode 内 t 被 task 参数遮蔽导致 t is not a function 
renderNode=(t)=> 里 t 是任务对象，line 1418 的 t('depsWait') 调用
全局 i18n 函数时 t 已被遮蔽。在 renderNode 前保存 const i18n=t，
内部改用 i18n()，消除 "t is not a function" 错误。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 00:57:52 +08:00
wangjia 989f017308 docs: add CLAUDE.md with architecture and dev commands 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 00:34:36 +08:00
wangjia 930db2d921 docs: add CLAUDE.md with architecture and dev commands 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-14 00:33:31 +08:00
wangjia 3ba66b82d5 feat(web): i18n 补全静态 HTML data-i18n 标签 + 样式 [tsk_6-VbN2XHWT4s] 
为侧栏/区段/弹窗等静态 HTML 补 data-i18n 属性(36 个 key,均已在 app.js 的 I18N 表定义)+ style.css 配套,与上一提交的 app.js i18n(t()+I18N 表)共同构成完整 zh/en 双语。index.html 结尾完整、key 全部匹配。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 23:58:41 +08:00
wangjia 8553939367 feat(web): 看板 zh/en 双语 i18n [tsk_6-VbN2XHWT4s] 
采用 main 工作树中已完成的完整 i18n 实现(293 个 t() 调用、188 处 I18N、全 UI 接入),此前一直未提交进任何分支。原 i18n 任务 B4 多次因环境(worker 崩/TLS 证书/abort)失败被 requeue 重做,改为直接采用这份现成成果,B4 收口。board 此前已在此版本上运行。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-13 23:54:36 +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
maestro 3d73b0cd85 merge: maestro/tsk_xbtd6GpS4NYg [tsk_xbtd6GpS4NYg] 2026-06-13 20:01:05 +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
wangjia 724cebb653 merge: 合并冲突解决 —— worker 池化评估 + SDK resume 抗抖动 [tsk_xbtd6GpS4NYg] 
将 maestro/tsk_74Acz1Nh4K1J 分支的 DESIGN.md 改动手动合并：
1. §19 分期状态：新增「🟡 worker 池化（已评估，暂缓）」说明
2. §20 风险与注意事项：新增「SDK 抖动 → resume 续跑」条目

保留了 HEAD 中已有的更详细版本的「自动执行安全」和「中断恢复（多进程 re-adopt）」条目。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 16:46:50 +08:00
maestro 0ed4f73106 merge: maestro/tsk_3uhHOGU0qzj0 [tsk_3uhHOGU0qzj0] 2026-06-13 15:51:39 +08:00
maestro dcf610f6fd merge: maestro/tsk_oTFzOMeAU20D [tsk_oTFzOMeAU20D] 2026-06-13 15:51:31 +08:00
maestro 4d5344ef63 merge: maestro/tsk_6uziW1Dg-ftQ [tsk_6uziW1Dg-ftQ] 2026-06-13 15:50:53 +08:00
maestro d4580ab32d merge: maestro/tsk_-HYVwxzHIbrS [tsk_-HYVwxzHIbrS] 2026-06-13 15:50:42 +08:00
wangjia 1c4a81b3f3 feat(web): SVG 图标集替换 Unicode —— tsk_3uhHOGU0qzj0 
用 design/assets/icons/ 的 15 个双色 SVG 图标替换现网纯 Unicode 图标：

• 拷贝 design/assets/icons/*.svg → web/assets/icons/（15 个）
• app.js 顶部新增 ICONS 对象 + icon() 内联 helper
• index.html：徽章组（gate/ready/running/deps）、配置按钮（config）、
  同步按钮（sync）、搜索输入框（search + filter-search-wrap 包装）、
  清除筛选按钮（close）、「新建」/「新建任务」按钮（add）
  各区块头加语义图标：project/task/gate/running/flow
• app.js 模板字符串：⛓→deps、✕→close（任务行取消/预览关闭/归档关闭）、
  依赖等待标签、ap-reason→reason SVG、分支显示→git、事件项 ev-type→event
• style.css：新增 svg.icon 基础尺寸规则、filter-search-wrap 布局、
  各语义上下文 --icon-accent 注入（暗/浅主题均用 CSS 变量自动适配）、
  .ap-reason::before 移除 content:'↳' 改用 SVG
• 品牌字符保留不动：▍▮→·— 及状态 CSS 圆点

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-13 15:08:53 +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 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