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,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;
|
||||
}
|
||||
Reference in New Issue
Block a user