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:
@@ -0,0 +1,95 @@
|
||||
import type { Complexity } from './complexity.js';
|
||||
|
||||
/** 任务执行状态机(设计见 DESIGN.md §5) */
|
||||
export type TaskStatus =
|
||||
| 'init' // 新建,未分析 / 未定方案
|
||||
| 'analyzing' // (Hard)plan 分析 + 拆解中
|
||||
| '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;
|
||||
}
|
||||
Reference in New Issue
Block a user