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

9 Commits

Author SHA1 Message Date
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 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 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 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 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 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 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