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>
This commit is contained in:
wangjia
2026-06-12 20:44:45 +08:00
commit 3172718a94
18 changed files with 2757 additions and 0 deletions
+95
View File
@@ -0,0 +1,95 @@
import type { Complexity } from './complexity.js';
/** 任务执行状态机(设计见 DESIGN.md §5 */
export type TaskStatus =
| 'init' // 新建,未分析 / 未定方案
| 'analyzing' // Hardplan 分析 + 拆解中
| 'plan_review' // Hard)拆解完成,待 accept
| 'decomposed' // (Hard)已拆解,作为容器,进度由子任务汇总
| 'speccing' // Medium)写方案中
| 'spec_review' // Medium)方案完成,待 accept
| 'ready' // 可执行叶子
| 'blocked' // 依赖未满足
| 'queued' // 编排器已领取,等 worker 槽位
| 'executing' // agent 在 worktree 跑 headless Claude Code
| 'exec_review' // 执行完成,改动在分支,待审 / 合
| 'failed' // 执行失败
| 'needs_attention' // 失败超阈值 / 冲突 / 歧义,需人工
| 'done' // 已合并 / 已接受
| 'paused'
| 'cancelled';
export const STATUS_LABEL: Record<TaskStatus, string> = {
init: '新建',
analyzing: '分析拆解中',
plan_review: '待确认拆解',
decomposed: '已拆解',
speccing: '写方案中',
spec_review: '待确认方案',
ready: '可执行',
blocked: '被依赖阻塞',
queued: '排队中',
executing: '执行中',
exec_review: '待审/合',
failed: '失败',
needs_attention: '需人工',
done: '完成',
paused: '暂停',
cancelled: '取消',
};
/** 审批闸类型 */
export type GateKind = 'plan' | 'spec' | 'exec';
/** 哪些状态在等待用户审批,以及对应的闸类型 */
export const GATE_STATUS: Partial<Record<TaskStatus, GateKind>> = {
plan_review: 'plan',
spec_review: 'spec',
exec_review: 'exec',
};
export function gateOf(s: TaskStatus): GateKind | null {
return GATE_STATUS[s] ?? null;
}
export const TERMINAL_STATUS: ReadonlySet<TaskStatus> = new Set<TaskStatus>(['done', 'cancelled']);
/** 合法状态流转表:from → 允许的 to[] */
export const TRANSITIONS: Record<TaskStatus, TaskStatus[]> = {
init: ['analyzing', 'speccing', 'ready', 'cancelled'], // 按复杂度分流
analyzing: ['plan_review', 'cancelled', 'paused'],
plan_review: ['decomposed', 'analyzing', 'cancelled'], // accept / reject(+意见)
decomposed: ['done', 'analyzing', 'cancelled', 'paused'], // 子全 done / 重拆
speccing: ['spec_review', 'cancelled', 'paused'],
spec_review: ['ready', 'speccing', 'cancelled'], // accept / reject(+意见)
ready: ['blocked', 'queued', 'speccing', 'analyzing', 'cancelled', 'paused'],
blocked: ['ready', 'cancelled', 'paused'],
queued: ['executing', 'ready', 'cancelled', 'paused'],
executing: ['exec_review', 'failed', 'cancelled'],
exec_review: ['done', 'ready', 'failed', 'cancelled'], // accept(合并) / reject(返工)
failed: ['queued', 'needs_attention', 'cancelled'], // 重试 / 升级
needs_attention: ['ready', 'queued', 'analyzing', 'speccing', 'cancelled', 'paused'],
done: [],
paused: ['ready', 'analyzing', 'speccing', 'queued', 'cancelled'],
cancelled: [],
};
export function canTransition(from: TaskStatus, to: TaskStatus): boolean {
return TRANSITIONS[from]?.includes(to) ?? false;
}
/** 新建任务按复杂度决定从 init 进入的下一个状态 */
export function initialNextStatus(c: Complexity): TaskStatus {
if (c === 'hard') return 'analyzing'; // 强制分析 + 拆解
if (c === 'medium') return 'speccing'; // 写方案
return 'ready'; // Easy:写完 operations 即可执行
}
/** 可被执行器领取的状态(叶子 + 依赖满足由调用方另判) */
export function isExecutable(s: TaskStatus): boolean {
return s === 'ready';
}
export function isGate(s: TaskStatus): boolean {
return s in GATE_STATUS;
}