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
+92
View File
@@ -0,0 +1,92 @@
import type { Complexity } from './complexity.js';
import type { TaskStatus, GateKind } from './status.js';
export type Id = string;
/** 层级上限:一般 ≤3 层,极复杂 ≤4 层 */
export const DEFAULT_MAX_DEPTH = 3;
export const HARD_MAX_DEPTH = 4;
/** 自动执行边界(Easy 任务由后台执行器自动跑到什么程度) */
export type Autonomy = 'manual' | 'auto-easy' | 'auto-approved';
export interface Project {
id: Id;
name: string;
repoPath: string;
defaultBranch: string;
verifyCmd: string | null; // 执行后的校验命令(build/test/lint
autonomy: Autonomy;
model: string | null;
concurrency: number; // 每项目并发执行上限
status: 'active' | 'paused';
createdAt: string;
}
export interface ApprovalRecord {
gate: GateKind;
action: 'accept' | 'reject';
actor: string;
reason: string | null; // reject 必填(改进意见)
at: string;
}
export interface TaskResult {
branch: string | null;
worktree: string | null;
diffSummary: string | null;
commits: string[];
prUrl: string | null;
}
export interface Task {
id: Id;
projectId: Id;
parentId: Id | null;
depth: number; // 1..4
title: string;
complexity: Complexity;
status: TaskStatus;
priority: number;
deps: Id[]; // 兄弟依赖(同层)
// 三选一产出(按复杂度)
plan: string | null; // Hard:分析 + 拆解说明
spec: string | null; // Medium:改动内容 + 为什么
operations: string | null; // Easy:将执行的操作
approvals: ApprovalRecord[];
result: TaskResult | null;
assignee: 'agent' | 'human' | null;
createdAt: string;
updatedAt: string;
}
export type RunKind = 'planner' | 'executor';
export type RunStatus = 'started' | 'succeeded' | 'failed' | 'cancelled';
export interface Run {
id: Id;
taskId: Id;
kind: RunKind; // planner(产出拆解/方案)| executor(执行改动)
worktree: string | null;
branch: string | null;
status: RunStatus;
startedAt: string;
endedAt: string | null;
transcriptRef: string | null; // agent 转录日志文件路径
claudeSessionId: string | null;
error: string | null;
}
export type EventType =
| 'task.created' | 'task.updated' | 'status.changed'
| 'approval.requested' | 'approval.granted' | 'approval.rejected'
| 'run.started' | 'run.finished';
export interface Event {
id: Id;
projectId: Id;
taskId: Id | null;
type: EventType;
payload: Record<string, unknown>;
at: string;
}