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

23 Commits

Author SHA1 Message Date
maestro 7f014ba246 merge: maestro/tsk_JKAzHuXvSw7h [tsk_JKAzHuXvSw7h] 2026-06-30 09:22:42 +08:00
wangjia d0aa53c79d fix(usage): 修按天分桶时区错位 + 区分账号额度/maestro用量口径 + 成本说明文档 (tsk_JKAzHuXvSw7h) 
全局面板「用量」数据问题修复与澄清：

1. 时区分桶根因（store.ts）：按天/周/月分桶与今天/本月窗口起点原全用 UTC，
   UTC+8 用户本地 00:00–08:00 的 run 被算进前一天、当天窗口晚 8h → 柱状图偏移
   一天、当天偏小。新增 localDay/localMonth，periodStartISO/weekStartLabel/
   usageDetail 改用 daemon 本地时区（SQL 比绝对时刻仍正确）。

2. UI 口径区分（design/ui_kits/console）：额度条标注账号级含交互会话，AGENT 卡/
   详情弹框标注仅统计 maestro 任务执行，$ 加 API 列表价估算非实际扣费提示并以 ≈
   前缀，模型列加近似角标。新增 4 个 i18n key×5 语言。

3. 文档：新增 docs/usage-cost-explained.html（两数据源/为何对不上/cost 公式/
   单价表/本地时区分桶/已知近似），登记进 docs/index.html 知识库调研。

4. 测试：budget.test.ts 新增 UTC+8 跨日分桶用例。typecheck + 268 测试全绿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 09:18:36 +08:00
wangjia 0c1f630dca 前端：任务详情展示审批/驳回记录 + 任务行 ID 不被长标题挤掉 + i18n 五语 (tsk_EmZ6vjtVbrOk) 
- TaskDetail 渲染 _raw.approvals：闸名·通过/驳回 + 审批人 + 时间，
  驳回用红色边框+红底高亮块突出 reason（t.rejectReason 标签），
  通过用绿色、reason 走低调 ↳ 行；无审批记录不渲染该分区。
- 安全：reason/actor/gate 全部走 React 文本节点（默认转义），
  不经 MaestroRichDoc/innerHTML，避免同源存储型 XSS。
- TaskRow：taskid 拆为独立 flex:none span，title 加 minWidth:0，
  长标题省略号截断时 id 完整不被挤掉；ArchiveRow 同步处理保持一致。
- i18n：zh/en/es/ja/fr 五语新增 rejectReason 键。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 09:04:42 +08:00
wangjia 5443ffa21c fix(console): 评审/归档卡片的 markdown 渲染成 HTML 
内联评审闸卡片与归档详情此前把 agent 产出的 markdown（plan/spec/
operations）直接塞进 <pre> 当纯文本，满屏裸 ## / - / 反引号未渲染。
改为在 ui_kit 层用 window.MaestroRichDoc（marked + DOMPurify 净化）
渲染，与 TaskTree 既有写法一致；保留 280px 限高滚动与容器样式。

- GateSection.jsx: GateCard doc 改为 undefined，children 内对非
  attention 闸用 MaestroRichDoc 渲染 a.doc；删除未引用的 reportBox 死代码
- ArchiveSection.jsx: doc() 助手由 <pre> 改为 MaestroRichDoc 容器，
  SPEC/OPERATIONS 两块随之正确渲染
- 安全：两处均走 RichDoc 的 DOMPurify 净化，挡住 same-origin 存储型 XSS；
  不绕过 sanitize 直接注入 HTML。CDN 不可用时回退纯文本不崩
- 不改 GateCard.jsx（避免底层组件反向依赖 ui_kit 全局 + 触发 bundle 重编）
- DiffBody 的 <pre> 渲染 git diff（非 markdown）保持不动

类似但未改：console_mobile/MobileViews.jsx 为独立非在线 demo，其
index.html 未加载 RichDoc/marked/DOMPurify，修复需整套引入，超出本次范围。

tsk_sp0DwZ2Kc319

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 08:30:15 +08:00
maestro ee9232e575 merge: maestro/tsk_sTHRFtFoHf-G [tsk_sTHRFtFoHf-G] 2026-06-30 07:45:44 +08:00
wangjia 8d3192e7cb app接线: 上传去重响应/已存附件删除/缩略图白名单对齐后端 (tsk_sTHRFtFoHf-G) 
- createTask 消费后端去重后的权威 attachments 列表，按入库数报数并提示去重数
- 附件删除 toast 语义由 warn 调整为 ok（attDeleted 为成功语义）
- TaskDetail 缩略图 isImg 收敛到 KIT_ATT_SAFE_INLINE 硬白名单(png/jpeg/gif/webp)，
  与后端 src/api/server.ts SAFE_INLINE 一字不差，svg/html 不走 <img src=服务端URL> inline，
  钉死同源存储型 XSS
- i18n 新增 attUploaded/attDeduped 两个带 {n} 占位的 key，覆盖 zh/en/es/ja/fr

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 07:42:46 +08:00
wangjia 33bef7f5fc feat(console): 侧栏项目按优先级显示三类计数徽标 
左侧项目状态新增数字提示，按优先级展示：
1. 需人工处理数（紫，attention）
2. agent 运行数（青，executing）
3. 被阻塞数（琥珀，blocked）
仅非零显示，固定「人工 > 运行 > 阻塞」排列；折叠态仍单状态点，
任一计数 > 0 时放大。后端 projectSummary 已就绪，仅透出 blocked
并渲染。i18n 五语言补齐 projAgentsTip / projBlockedTip。

tsk_0VF1URfdoe3d

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 07:34:47 +08:00
wangjia 64b8c912ef chore(console): 验证附件创建面板已上线 + 低风险加固（粘贴/拖拽体量上限 + render 副作用收敛）[tsk_ia4uiOfk6ZdV] 
任务功能（统一 files 状态 / 缩略图预览 / 单项删除 / 客户端去重 / 5 语 i18n）
已于 65cd5ad、00e6bc7 实现并合并，后端同源存储型 XSS 防护已于 d9d3de2 落实，
逐条核对全部满足，故不重复实现。仅做两处低风险加固（范围限 design/ui_kits/console/**）：

- NewTaskPanel.addFiles 增加单文件 25MB 软上限，超限跳过并内联提示，
  新增 i18n key attTooLarge（zh/en/es/ja/fr 五语齐备）
- 缩略图 objectURL 改为在 addFiles 中预生成（ensureThumb），render 仅读，
  消除 map 渲染期写 urlMapRef 的副作用，避免 React 严格模式下重复创建/泄漏

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 07:23:12 +08:00
wangjia 00e6bc72e7 feat(console): 附件全链路接线（预览/下载/删除 + 已建任务交互） 
- app/src/api.js: 新增 attachmentUrl（inline/下载 URL 构造）与 deleteAttachment 封装
- app/src/app.jsx: taskOps 增 delAttachment（删除→toast→局部刷新）
- design/ui_kits/console/TaskTree.jsx: TaskDetail 附件区从纯文本升级为画廊
  （图片缩略图点击新标签预览 + 下载按钮 + 确认删除），URL 内联零依赖、删除走 taskOps
- design/ui_kits/console/i18n.js: 新增 attSection/attDownload/attDeleteConfirm/
  attDeleted/attDeleteFailed（zh/en/es/ja/fr 五语齐全）

tsk_dbtI_ffTJll9

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-30 01:49:17 +08:00
maestro 65cd5add5c maestro(tsk_tqxHX6NRQ3iA): 前端 NewTaskPanel：剪贴板粘贴图片 + 拖拽上传 + 统一 files 状态 + 缩略图预览 + 单个删除 + 客户端去重 + 5 语 i18n 2026-06-30 01:36:43 +08:00
wangjia af690701bf feat(web): Markdown 渲染器 + 拆解轨迹 + 需你处理区 + 复审报告折叠卡片 
- RichDoc(marked+DOMPurify+highlight.js CDN)统一渲染 gate spec/复审报告/任务树 SPEC；- Transcript 组件：拆解评审「拆解轨迹」懒加载 planner run transcript；- 「审批闸」改名「需你处理」并并入 needs_attention（requeue/接管/取消 + 完整复审报告，按代码/安全分段折叠卡片、标裁决徽章）；- 子任务显 scopeFiles 文件范围 + frozen「待拆解确认」标。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 23:32:30 +08:00
wangjia 1c62059424 feat(web): 控制台 UI 批次——用量卡片精简+详情弹框、项目列表封顶 6、评审弹框增强、live 输出流、标题栏置顶 
- 全局 AGENT 卡片精简为 2×2 概览（近 7 天窗口 + 真实运行数），删按项目列表，加「详情」弹框（按天/周/月柱状图 + 分项目下钻表）；- 项目列表展开态封顶 6，多余折叠；- plan/exec 评审弹框：markdown 折叠卡片 + 点文件看 diff；- live 输出流提取 tool_use/tool_result；- Agent/审批闸/任务树/已归档标题栏滚动置顶。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 17:42:39 +08:00
wangjia 8765e61498 feat(console): 任务树筛选/折叠/统一标题 + 侧栏全局Agent卡片/拖拽排序/全局设置弹框/记忆项目 + 状态点真实化 
任务树：四维多选下拉筛选(状态/复杂度/优先级/执行者)、已选置顶、新建任务按钮移右上角(0任务也能建)。
四块主区(Agent/审批闸/任务树/归档)统一标题组件(图标+名称+数量徽标)+ 折叠按钮(localStorage 记忆)。
侧栏：全局 Agent 弹层改常驻卡片(项目默认3+折叠+按活跃排序)、顶部项目拖拽排序、全局设置移入用户菜单弹框(保存/取消，落库)、记忆当前项目。
adaptProject 用后端 summary 的 running/attention 判状态点颜色(青/琥珀/灰)+ 紫色关注数徽标；agent 标题不再越界；i18n 5 语言补全。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 11:30:32 +08:00
wangjia 43fa1f7dbb feat(ds): 表单输入/下拉文字改柔和灰——新增 --field-ink token 作单一真相源 
输入/下拉文字此前用 --ink(近白)太刺眼且与正文耦合。新增 --field-ink token
(深 #a7b3a1 / 浅 #3c4838)，Input/Select 组件引用之；改一个值即全改。
因项目无 DS 编译器，同步改 _ds_bundle.js(运行加载源)+ ambience.css 兜底，确保即时生效。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-29 11:30:17 +08:00
wangjia eef59830d6 chore: 不跟踪 todo/ 与 design/maestro-ds/（误入 git add -A，应保持未跟踪） 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 22:33:25 +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 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 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