axon-code 2.4.0

package/dist/blueprint/types.d.ts

@@ -0,0 +1,1054 @@
+/**
+ * 蜂群架构 v3.0 - 完整类型定义
+ *
+ * 核心理念：
+ * - Blueprint（蓝图）：需求锚点，所有Worker参照执行
+ * - LeadAgent（持久大脑）：贯穿整个项目的AI协调者，替代代码调度器
+ * - SmartTask：智能任务，Worker自主决策是否需要测试
+ * - AutonomousWorker：执行手臂，接受LeadAgent的详细Brief
+ * - Git并发：用分支代替文件锁
+ */
+/**
+ * 蓝图状态
+ */
+export type BlueprintStatus = 'draft' | 'review' | 'approved' | 'confirmed' | 'executing' | 'completed' | 'paused' | 'modified' | 'failed' | 'cancelled';
+/**
+ * 蓝图 - 需求锚点，所有Worker必须参照
+ */
+export interface Blueprint {
+    id: string;
+    name: string;
+    description: string;
+    version?: string;
+    projectPath: string;
+    status: BlueprintStatus;
+    businessProcesses?: BusinessProcess[];
+    modules?: BlueprintModule[] | SimpleModule[];
+    nfrs?: NFR[];
+    requirements?: string[];
+    techStack?: TechStack;
+    constraints?: string[];
+    source?: 'requirement' | 'codebase';
+    createdAt: Date | string;
+    updatedAt: Date | string;
+    confirmedAt?: Date | string;
+    approvedAt?: Date | string;
+    approvedBy?: string;
+    lastExecutionPlan?: SerializableExecutionPlan;
+    designImages?: DesignImage[];
+    apiContract?: APIContract;
+    swarmMemory?: SwarmMemory;
+    brief?: string;
+}
+/**
+ * UI 设计图
+ * 用于存储 AI 生成的界面设计图，作为验收标准
+ */
+export interface DesignImage {
+    id: string;
+    name: string;
+    description?: string;
+    imageData?: string;
+    filePath?: string;
+    style: 'modern' | 'minimal' | 'corporate' | 'creative';
+    createdAt: Date | string;
+    isAccepted?: boolean;
+}
+/**
+ * 业务流程类型
+ */
+export type ProcessType = 'as-is' | 'to-be';
+/**
+ * 业务流程
+ */
+export interface BusinessProcess {
+    id: string;
+    name: string;
+    description: string;
+    type: ProcessType;
+    steps: ProcessStep[];
+    actors: string[];
+    inputs: string[];
+    outputs: string[];
+}
+/**
+ * 流程步骤
+ */
+export interface ProcessStep {
+    id: string;
+    order: number;
+    name: string;
+    description: string;
+    actor: string;
+    inputs?: string[];
+    outputs?: string[];
+}
+/**
+ * 模块类型
+ */
+export type ModuleType = 'frontend' | 'backend' | 'database' | 'service' | 'infrastructure' | 'shared' | 'other';
+/**
+ * 模块来源
+ */
+export type ModuleSource = 'requirement' | 'existing' | 'ai_generated';
+/**
+ * 蓝图模块（完整版）
+ */
+export interface BlueprintModule {
+    id: string;
+    name: string;
+    description: string;
+    type: ModuleType;
+    responsibilities: string[];
+    techStack: string[];
+    interfaces: ModuleInterface[];
+    dependencies: string[];
+    rootPath: string;
+    source: ModuleSource;
+    files?: string[];
+}
+/**
+ * 模块接口
+ */
+export interface ModuleInterface {
+    name: string;
+    type: 'api' | 'event' | 'function' | 'class';
+    description: string;
+    signature?: string;
+}
+/**
+ * 简化的模块定义（兼容用）
+ */
+export interface SimpleModule {
+    id?: string;
+    name: string;
+    description: string;
+    type?: ModuleType;
+    path?: string;
+    files?: string[];
+    dependencies?: string[];
+}
+/**
+ * NFR 类别
+ */
+export type NFRCategory = 'performance' | 'security' | 'reliability' | 'scalability' | 'maintainability' | 'usability' | 'other';
+/**
+ * 非功能需求
+ */
+export interface NFR {
+    id: string;
+    category: NFRCategory;
+    name: string;
+    description: string;
+    priority: 'must' | 'should' | 'could' | 'wont' | 'high' | 'medium' | 'low';
+    metrics?: string[];
+    metric?: string;
+}
+/**
+ * API 端点定义
+ */
+export interface APIEndpoint {
+    /** HTTP 方法 */
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** 路径（不含前缀），如 /users/:id */
+    path: string;
+    /** 端点描述 */
+    description: string;
+    /** 请求体类型描述 */
+    requestBody?: string;
+    /** 响应类型描述 */
+    responseType?: string;
+    /** 关联的业务流程 ID */
+    processId?: string;
+    /** 关联的模块 ID */
+    moduleId?: string;
+}
+/**
+ * API 契约
+ * 在任务分解前生成，作为前后端开发的统一标准
+ * 存储在蓝图中，Worker 必须遵循
+ */
+export interface APIContract {
+    /** API 路径前缀，如 /api/v1 */
+    apiPrefix: string;
+    /** 端点列表 */
+    endpoints: APIEndpoint[];
+    /** 契约文件路径（可选，如 api-contract.yaml） */
+    filePath?: string;
+    /** 生成时间 */
+    generatedAt: Date | string;
+    /** 版本号 */
+    version?: string;
+}
+/**
+ * 蜂群共享记忆
+ * 存储在蓝图中，所有 Worker 可读取
+ * 由 Coordinator 自动维护，Worker 无需手动更新
+ */
+export interface SwarmMemory {
+    /** 任务进度概览（一行文本） */
+    overview: string;
+    /** 已注册的 API 列表（从后端任务 summary 中自动提取） */
+    apis: SwarmAPI[];
+    /** 已完成任务的摘要 */
+    completedTasks: SwarmTaskSummary[];
+    /** 最后更新时间 */
+    updatedAt: Date | string;
+}
+/**
+ * 蜂群 API 记录
+ */
+export interface SwarmAPI {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    description?: string;
+    sourceTaskId: string;
+}
+/**
+ * 蜂群任务摘要（精简版）
+ */
+export interface SwarmTaskSummary {
+    taskId: string;
+    taskName: string;
+    category: TaskCategory;
+    summary: string;
+    completedAt: Date | string;
+}
+/**
+ * 技术栈（结构化）
+ */
+export interface TechStack {
+    language: ProjectLanguage;
+    framework?: string;
+    packageManager: PackageManagerType;
+    testFramework?: TestFrameworkType;
+    buildTool?: string;
+    additionalTools?: string[];
+    /** UI 组件库 */
+    uiFramework?: 'antd' | 'shadcn' | 'mui' | 'chakra' | 'element-plus' | 'none';
+    /** CSS 方案 */
+    cssFramework?: 'tailwind' | 'css-modules' | 'styled-components' | 'sass' | 'none';
+    /** API 风格 */
+    apiStyle?: 'rest' | 'graphql' | 'trpc';
+    testEnvironment?: TestEnvironmentConfig;
+}
+/**
+ * v3.3: 测试环境配置
+ * 定义如何连接测试数据库、外部服务等
+ */
+export interface TestEnvironmentConfig {
+    database?: {
+        type: 'sqlite-memory' | 'docker' | 'remote' | 'none';
+        dockerComposePath?: string;
+        connectionString?: string;
+        envVar?: string;
+    };
+    externalServices?: {
+        mockServerUrl?: string;
+        vcrCassettesDir?: string;
+    };
+    envFile?: string;
+    setupCommand?: string;
+    teardownCommand?: string;
+}
+export type ProjectLanguage = 'javascript' | 'typescript' | 'python' | 'go' | 'rust' | 'java' | 'unknown';
+export type PackageManagerType = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'pip' | 'poetry' | 'uv' | 'go_mod' | 'cargo' | 'maven' | 'gradle';
+export type TestFrameworkType = 'vitest' | 'jest' | 'mocha' | 'pytest' | 'unittest' | 'go_test' | 'cargo_test' | 'junit' | 'testng';
+/**
+ * 任务类型
+ */
+export type TaskType = 'code' | 'config' | 'test' | 'refactor' | 'docs' | 'integrate' | 'verify';
+/**
+ * 任务复杂度
+ */
+export type TaskComplexity = 'trivial' | 'simple' | 'moderate' | 'complex';
+/**
+ * 任务状态（简化）
+ */
+export type TaskStatus = 'pending' | 'running' | 'reviewing' | 'completed' | 'failed' | 'skipped';
+/**
+ * 测试策略类型
+ * v3.3: 支持不同的测试方式
+ */
+export type TestStrategy = 'unit' | 'integration' | 'e2e' | 'mock' | 'vcr' | 'skip';
+/**
+ * 任务领域/分类
+ * SmartPlanner 在拆分任务时直接标记，Worker 无需猜测
+ */
+export type TaskCategory = 'frontend' | 'backend' | 'database' | 'shared' | 'other';
+/**
+ * 智能任务
+ * Worker自主决策如何执行
+ */
+export interface SmartTask {
+    id: string;
+    name: string;
+    description: string;
+    type: TaskType;
+    complexity: TaskComplexity;
+    /** 任务领域：前端/后端/数据库/共享/其他 - SmartPlanner 拆分时标记 */
+    category?: TaskCategory;
+    blueprintId: string;
+    moduleId?: string;
+    files: string[];
+    dependencies: string[];
+    needsTest: boolean;
+    testStrategy?: TestStrategy;
+    estimatedMinutes: number;
+    status: TaskStatus;
+    workerId?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    result?: TaskResult;
+    /** LeadAgent 写的详细上下文简报（替代泛泛的任务描述） */
+    brief?: string;
+    /** 执行模式：worker=派发给Worker，lead-agent=LeadAgent自己做 */
+    executionMode?: 'worker' | 'lead-agent';
+    /** 是否跳过独立 Reviewer 审查（LeadAgent 模式下由 LeadAgent 自己审查） */
+    skipReview?: boolean;
+    /** 已尝试次数 */
+    attemptCount?: number;
+    /** 上次失败的 Review 反馈 */
+    lastReviewFeedback?: {
+        verdict: 'failed' | 'needs_revision';
+        reasoning: string;
+        issues?: string[];
+        suggestions?: string[];
+        timestamp: Date;
+        /** v3.9: 合并冲突详情 - 让 Worker 自己解决 */
+        mergeConflict?: {
+            files: Array<{
+                path: string;
+                /** 带冲突标记的完整内容 */
+                conflictContent: string;
+                /** 主分支内容 */
+                oursContent: string;
+                /** Worker 分支内容 */
+                theirsContent: string;
+            }>;
+        };
+    };
+}
+/**
+ * 任务结果
+ */
+export interface TaskResult {
+    success: boolean;
+    changes: FileChange[];
+    testsRan?: boolean;
+    testsPassed?: boolean;
+    error?: string;
+    decisions: WorkerDecision[];
+    /** 任务完成摘要（供依赖任务理解语义） */
+    summary?: string;
+    /** v9.0: 完整摘要（LeadAgent 模式下不截断） */
+    fullSummary?: string;
+    /** v10.0: Worker 的完整文本输出（对齐 TaskTool 模式） */
+    rawResponse?: string;
+    /** v9.0: 审查者标记 */
+    reviewedBy?: 'lead-agent' | 'reviewer' | 'none';
+    /** v3.7: Review 反馈（失败时包含，用于下次重试） */
+    reviewFeedback?: {
+        verdict: 'failed' | 'needs_revision';
+        reasoning: string;
+        issues?: string[];
+        suggestions?: string[];
+    };
+}
+/**
+ * 文件变更
+ */
+export interface FileChange {
+    filePath: string;
+    type: 'create' | 'modify' | 'delete';
+    content?: string;
+    diff?: string;
+}
+/**
+ * Worker决策记录
+ */
+export interface WorkerDecision {
+    type: 'strategy' | 'skip_test' | 'add_test' | 'install_dep' | 'retry' | 'other';
+    description: string;
+    timestamp: Date;
+}
+/**
+ * 执行计划
+ * 由SmartPlanner生成
+ */
+export interface ExecutionPlan {
+    id: string;
+    blueprintId: string;
+    tasks: SmartTask[];
+    parallelGroups: string[][];
+    estimatedCost: number;
+    estimatedMinutes: number;
+    autoDecisions: PlanDecision[];
+    status: 'ready' | 'executing' | 'completed' | 'failed' | 'paused';
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+/**
+ * 规划决策
+ */
+export interface PlanDecision {
+    type: 'task_split' | 'parallel' | 'dependency' | 'tech_choice' | 'other';
+    description: string;
+    reasoning?: string;
+}
+/**
+ * 自治Worker
+ */
+export interface AutonomousWorker {
+    id: string;
+    status: 'idle' | 'working' | 'waiting' | 'error';
+    currentTaskId?: string;
+    branchName?: string;
+    history: WorkerAction[];
+    errorCount: number;
+    createdAt: Date;
+    lastActiveAt: Date;
+}
+/**
+ * Worker动作类型
+ * v2.0 新增: explore（探索代码库）、analyze（分析文件）
+ */
+export type WorkerActionType = 'read' | 'write' | 'edit' | 'run_test' | 'install_dep' | 'git' | 'think' | 'explore' | 'analyze';
+/**
+ * Worker动作
+ */
+export interface WorkerAction {
+    id: string;
+    type: WorkerActionType;
+    description: string;
+    timestamp: Date;
+    duration: number;
+    success: boolean;
+    output?: string;
+}
+/**
+ * 执行状态
+ */
+export interface ExecutionStatus {
+    planId: string;
+    blueprintId: string;
+    totalTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    runningTasks: number;
+    activeWorkers: number;
+    startedAt: Date;
+    estimatedCompletion?: Date;
+    currentCost: number;
+    estimatedTotalCost: number;
+    issues: ExecutionIssue[];
+}
+/**
+ * 执行问题
+ */
+export interface ExecutionIssue {
+    id: string;
+    taskId: string;
+    type: 'error' | 'warning' | 'conflict' | 'timeout';
+    description: string;
+    timestamp: Date;
+    resolved: boolean;
+    resolution?: string;
+}
+/**
+ * 合并结果
+ */
+export interface MergeResult {
+    success: boolean;
+    workerId: string;
+    branchName: string;
+    autoResolved: boolean;
+    conflict?: ConflictInfo;
+    needsHumanReview: boolean;
+}
+/**
+ * 冲突信息
+ */
+export interface ConflictInfo {
+    files: string[];
+    description: string;
+    suggestedResolution?: string;
+    /** v3.9: 冲突文件详情 - 供 Worker 自己解决冲突 */
+    fileDetails?: Array<{
+        path: string;
+        /** 带冲突标记的完整文件内容 */
+        conflictContent: string;
+        /** 主分支内容 */
+        oursContent: string;
+        /** Worker 分支内容 */
+        theirsContent: string;
+    }>;
+}
+/**
+ * 冲突文件详情
+ */
+export interface ConflictFileDetail {
+    path: string;
+    /** 当前 main 分支内容 */
+    oursContent: string;
+    /** Worker 分支内容 */
+    theirsContent: string;
+    /** 共同祖先内容（如果有） */
+    baseContent?: string;
+    /** 冲突类型 */
+    conflictType: 'append' | 'modify' | 'delete' | 'unknown';
+}
+/**
+ * 冲突决策类型
+ */
+export type ConflictDecisionType = 'auto_merge' | 'keep_ours' | 'keep_theirs' | 'ai_merge' | 'manual';
+/**
+ * 冲突决策结果
+ */
+export interface ConflictDecision {
+    type: ConflictDecisionType;
+    /** 合并后的文件内容（如果适用） */
+    mergedContents?: Record<string, string>;
+    /** 决策理由 */
+    reasoning: string;
+    /** 是否成功 */
+    success: boolean;
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/**
+ * 冲突解决请求
+ */
+export interface ConflictResolutionRequest {
+    workerId: string;
+    taskId: string;
+    branchName: string;
+    files: ConflictFileDetail[];
+    /** 任务描述（帮助AI理解上下文） */
+    taskDescription: string;
+}
+/**
+ * 待处理的冲突（需要人工干预）
+ */
+export interface PendingConflict {
+    id: string;
+    workerId: string;
+    taskId: string;
+    taskName: string;
+    branchName: string;
+    files: ConflictFileForUI[];
+    timestamp: Date;
+    status: 'pending' | 'resolving' | 'resolved';
+}
+/**
+ * 冲突文件（前端展示用）
+ */
+export interface ConflictFileForUI {
+    path: string;
+    oursContent: string;
+    theirsContent: string;
+    baseContent?: string;
+    suggestedMerge?: string;
+    conflictType: 'append' | 'modify' | 'delete' | 'unknown';
+}
+/**
+ * 人工决策类型
+ */
+export type HumanDecisionType = 'use_suggested' | 'use_ours' | 'use_theirs' | 'use_both' | 'custom';
+/**
+ * 人工决策请求
+ */
+export interface HumanDecisionRequest {
+    conflictId: string;
+    decision: HumanDecisionType;
+    /** 自定义内容（当 decision 为 'custom' 时使用） */
+    customContents?: Record<string, string>;
+}
+/**
+ * 人工决策结果
+ */
+export interface HumanDecisionResult {
+    success: boolean;
+    conflictId: string;
+    message: string;
+}
+/**
+ * 模型类型
+ */
+export type ModelType = 'opus' | 'sonnet' | 'haiku';
+/**
+ * 模型选择结果
+ * v5.0: 移除 estimatedCost，成本应该是执行后的实际统计，而不是拍脑袋的预估
+ */
+export interface ModelSelection {
+    model: ModelType;
+    reason: string;
+}
+/**
+ * 错误类型
+ */
+export type ErrorType = 'syntax' | 'import' | 'type' | 'runtime' | 'test_fail' | 'timeout' | 'unknown';
+/**
+ * 错误分析结果
+ */
+export interface ErrorAnalysis {
+    type: ErrorType;
+    message: string;
+    file?: string;
+    line?: number;
+    suggestion: string;
+    canAutoFix: boolean;
+}
+/**
+ * 错误处理动作
+ */
+export interface ErrorAction {
+    action: 'retry' | 'skip' | 'fix' | 'escalate';
+    strategy?: string;
+    reason: string;
+}
+/**
+ * 对话阶段
+ */
+export type DialogPhase = 'greeting' | 'requirements' | 'clarification' | 'tech_choice' | 'confirmation' | 'done';
+/**
+ * 对话状态
+ */
+export interface DialogState {
+    phase: DialogPhase;
+    messages: DialogMessage[];
+    collectedRequirements: string[];
+    collectedConstraints: string[];
+    techStack?: Partial<TechStack>;
+    isComplete: boolean;
+    /** 确认时生成的蓝图（避免重复生成） */
+    generatedBlueprint?: Blueprint;
+    /** v2.2: 对话过程中生成的设计图（会保存到最终蓝图中） */
+    designImages?: DesignImage[];
+}
+/**
+ * 对话消息
+ */
+export interface DialogMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+}
+/**
+ * 蜂群事件类型
+ * v2.0 新增: planner:exploring, planner:analyzed, worker:analyzing
+ */
+export type SwarmEventType = 'plan:created' | 'plan:started' | 'plan:completed' | 'plan:failed' | 'plan:paused' | 'plan:resumed' | 'plan:cancelled' | 'plan:group_failed' | 'planner:exploring' | 'planner:explored' | 'planner:decomposing' | 'task:started' | 'task:completed' | 'task:failed' | 'task:modified' | 'task:skipped' | 'worker:created' | 'worker:idle' | 'worker:error' | 'worker:analyzing' | 'worker:analyzed' | 'worker:strategy_decided' | 'merge:success' | 'merge:conflict' | 'progress:update' | 'verification:started' | 'verification:progress' | 'verification:completed' | 'lead:started' | 'lead:exploring' | 'lead:planning' | 'lead:dispatch' | 'lead:reviewing' | 'lead:executing' | 'lead:plan_update' | 'lead:completed';
+/**
+ * 蜂群事件
+ */
+export interface SwarmEvent {
+    type: SwarmEventType;
+    timestamp: Date;
+    data: Record<string, unknown>;
+}
+/**
+ * 蜂群配置
+ */
+export interface SwarmConfig {
+    maxWorkers: number;
+    workerTimeout: number;
+    defaultModel: ModelType;
+    complexTaskModel: ModelType;
+    simpleTaskModel: ModelType;
+    autoTest: boolean;
+    testTimeout: number;
+    maxRetries: number;
+    skipOnFailure: boolean;
+    stopOnGroupFailure?: boolean;
+    useGitBranches: boolean;
+    autoMerge: boolean;
+    maxCost: number;
+    costWarningThreshold: number;
+    plannerExploreEnabled?: boolean;
+    plannerExploreMaxTurns?: number;
+    workerAnalyzeEnabled?: boolean;
+    workerAnalyzeMaxTurns?: number;
+    enableReviewer?: boolean;
+    reviewerModel?: 'haiku' | 'sonnet' | 'opus';
+    reviewerStrictness?: 'lenient' | 'normal' | 'strict';
+    /** 是否启用 LeadAgent 模式（默认false，保持向后兼容） */
+    enableLeadAgent?: boolean;
+    /** LeadAgent 使用的模型（默认sonnet） */
+    leadAgentModel?: 'haiku' | 'sonnet' | 'opus';
+    /** LeadAgent 最大 turn 数（默认200） */
+    leadAgentMaxTurns?: number;
+    /** LeadAgent 自己执行任务的最大复杂度阈值（超过此复杂度的任务LeadAgent自己做） */
+    leadAgentSelfExecuteComplexity?: TaskComplexity;
+    /** API Key（主 agent 透传） */
+    apiKey?: string;
+    /** Auth Token（主 agent 透传） */
+    authToken?: string;
+    /** Base URL（主 agent 透传） */
+    baseUrl?: string;
+}
+/**
+ * 默认配置
+ */
+export declare const DEFAULT_SWARM_CONFIG: SwarmConfig;
+/**
+ * 代码库探索结果
+ * SmartPlanner Agent 探索后生成
+ */
+export interface CodebaseExploration {
+    directoryStructure: string;
+    discoveredModules: {
+        name: string;
+        path: string;
+        description: string;
+        files: string[];
+    }[];
+    detectedTechStack: {
+        language: ProjectLanguage;
+        framework?: string;
+        testFramework?: string;
+        packageManager?: string;
+    };
+    codeConventions: {
+        namingStyle?: 'camelCase' | 'snake_case' | 'PascalCase';
+        hasTypescript?: boolean;
+        hasTests?: boolean;
+        testPattern?: string;
+    };
+    keyFiles: {
+        entryPoint?: string;
+        config?: string[];
+        tests?: string[];
+    };
+    observations: string[];
+}
+/**
+ * 文件分析结果
+ * Worker Agent 策略决策前生成
+ */
+export interface FileAnalysis {
+    targetFiles: string[];
+    fileSummaries: {
+        path: string;
+        exists: boolean;
+        summary?: string;
+        lineCount?: number;
+        hasTests?: boolean;
+        relatedTestFile?: string;
+    }[];
+    dependencies: {
+        imports: string[];
+        exports: string[];
+        relatedFiles: string[];
+    };
+    suggestions: string[];
+    observations: string[];
+}
+/**
+ * 可序列化的任务结果（用于持久化）
+ */
+export interface SerializableTaskResult {
+    taskId: string;
+    success: boolean;
+    changes: FileChange[];
+    testsRan?: boolean;
+    testsPassed?: boolean;
+    error?: string;
+    decisions: {
+        type: string;
+        description: string;
+        timestamp: string;
+    }[];
+}
+/**
+ * 可序列化的执行问题（用于持久化）
+ */
+export interface SerializableExecutionIssue {
+    id: string;
+    taskId: string;
+    type: 'error' | 'warning' | 'conflict' | 'timeout';
+    description: string;
+    timestamp: string;
+    resolved: boolean;
+    resolution?: string;
+}
+/**
+ * 可序列化的执行计划（用于持久化）
+ * 将 Date 类型转换为 ISO 字符串
+ */
+export interface SerializableExecutionPlan {
+    id: string;
+    blueprintId: string;
+    tasks: SerializableSmartTask[];
+    parallelGroups: string[][];
+    estimatedCost: number;
+    estimatedMinutes: number;
+    autoDecisions: PlanDecision[];
+    status: 'ready' | 'executing' | 'completed' | 'failed' | 'paused';
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+/**
+ * 可序列化的任务（用于持久化）
+ */
+export interface SerializableSmartTask {
+    id: string;
+    name: string;
+    description: string;
+    type: TaskType;
+    complexity: TaskComplexity;
+    category?: TaskCategory;
+    blueprintId: string;
+    moduleId?: string;
+    files: string[];
+    dependencies: string[];
+    needsTest: boolean;
+    estimatedMinutes: number;
+    status: TaskStatus;
+    workerId?: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+/**
+ * 执行状态（用于持久化和恢复）
+ * 保存执行的中间状态，支持重启后恢复
+ *
+ * v3.0: 状态现在保存在蓝图文件（.blueprint/{id}.json）的 lastExecutionPlan 和 executionState 字段中
+ */
+export interface ExecutionState {
+    plan: SerializableExecutionPlan;
+    projectPath: string;
+    currentGroupIndex: number;
+    completedTaskIds: string[];
+    failedTaskIds: string[];
+    skippedTaskIds: string[];
+    taskResults: SerializableTaskResult[];
+    issues: SerializableExecutionIssue[];
+    taskModifications: {
+        taskId: string;
+        newDescription?: string;
+        skip?: boolean;
+    }[];
+    currentCost: number;
+    startedAt: string;
+    lastUpdatedAt: string;
+    pausedAt?: string;
+    isPaused: boolean;
+    isCancelled: boolean;
+    version: string;
+}
+/**
+ * 验收测试状态
+ */
+export type VerificationStatus = 'idle' | 'checking_env' | 'running_tests' | 'fixing' | 'passed' | 'failed';
+/**
+ * 验收测试结果
+ * AI Worker 执行完毕后返回的结构化结果
+ */
+export interface VerificationResult {
+    status: VerificationStatus;
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    skippedTests: number;
+    testOutput: string;
+    failures: {
+        name: string;
+        error: string;
+    }[];
+    fixAttempts: {
+        description: string;
+        success: boolean;
+    }[];
+    envIssues: string[];
+    startedAt: string;
+    completedAt?: string;
+}
+/**
+ * 轻量级任务计划
+ * 当 Planner 需要委派一组任务但不需要完整蓝图时使用
+ */
+export interface TaskPlan {
+    /** 唯一标识 */
+    id: string;
+    /** 总体目标 */
+    goal: string;
+    /** 上下文说明（代码库状况、前置条件等） */
+    context: string;
+    /** 任务列表 */
+    tasks: TaskPlanItem[];
+    /** 约束条件 */
+    constraints?: string[];
+    /** 验收标准 */
+    acceptanceCriteria?: string[];
+    /** 技术栈（可选，可从项目自动检测） */
+    techStack?: TechStack;
+    /** 项目路径 */
+    projectPath: string;
+    /** 创建时间 */
+    createdAt: Date | string;
+}
+/**
+ * TaskPlan 中的单个任务项
+ */
+export interface TaskPlanItem {
+    /** 任务标识 */
+    id: string;
+    /** 任务名称 */
+    name: string;
+    /** 任务描述（详细的 brief） */
+    description: string;
+    /** 预期修改的文件 */
+    files?: string[];
+    /** 依赖的其他任务 ID */
+    dependencies?: string[];
+    /** 复杂度估计 */
+    complexity?: TaskComplexity;
+    /** 任务类型 */
+    type?: TaskType;
+}
+/**
+ * 判断输入是 Blueprint 还是 TaskPlan
+ */
+export declare function isBlueprint(input: Blueprint | TaskPlan): input is Blueprint;
+/**
+ * LeadAgent 配置
+ */
+export interface LeadAgentConfig {
+    /** 蓝图或轻量级任务计划 */
+    blueprint: Blueprint | TaskPlan;
+    /** 执行计划（SmartPlanner 生成的任务列表） */
+    executionPlan?: ExecutionPlan;
+    /** 项目路径 */
+    projectPath: string;
+    /** 使用的模型（默认 sonnet） */
+    model?: string;
+    /** 最大 turn 数（默认 200） */
+    maxTurns?: number;
+    /** 蜂群配置 */
+    swarmConfig?: SwarmConfig;
+    /** 事件回调（用于转发给 WebUI） */
+    onEvent?: (event: LeadAgentEvent) => void;
+    /** 用户交互处理器（WebUI 环境下） */
+    askUserHandler?: (input: unknown) => Promise<unknown>;
+    /** 是否为恢复模式（从中断位置继续执行） */
+    isResume?: boolean;
+    /** API Key（显式传入，避免子 agent 走 initAuth 拿到错误的认证） */
+    apiKey?: string;
+    /** Auth Token（显式传入） */
+    authToken?: string;
+    /** Base URL（显式传入） */
+    baseUrl?: string;
+}
+/**
+ * LeadAgent 事件
+ */
+export interface LeadAgentEvent {
+    type: SwarmEventType;
+    data: Record<string, unknown>;
+    timestamp: Date;
+}
+/**
+ * LeadAgent 执行结果
+ */
+export interface LeadAgentResult {
+    success: boolean;
+    /** 完成的任务 */
+    completedTasks: string[];
+    /** 失败的任务 */
+    failedTasks: string[];
+    /** 总 token 消耗（估算） */
+    estimatedTokens: number;
+    /** 总成本（估算） */
+    estimatedCost: number;
+    /** 执行时间（毫秒） */
+    durationMs: number;
+    /** LeadAgent 的最终总结 */
+    summary: string;
+    /** v10.0: LeadAgent 的完整文本输出（对齐 TaskTool 模式） */
+    rawResponse: string;
+    /** 所有任务结果 */
+    taskResults: Map<string, TaskResult>;
+}
+/**
+ * DispatchWorker 工具的输入
+ */
+export interface DispatchWorkerInput {
+    /** 任务 ID */
+    taskId: string;
+    /** LeadAgent 写的详细上下文简报 */
+    brief: string;
+    /** 目标文件列表 */
+    targetFiles: string[];
+    /** 约束条件 */
+    constraints?: string[];
+    /** 使用的模型（默认由任务复杂度决定） */
+    model?: 'haiku' | 'sonnet' | 'opus';
+}
+/**
+ * DispatchWorker 工具的结果
+ */
+export interface DispatchWorkerResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 任务 ID */
+    taskId: string;
+    /** Worker ID */
+    workerId: string;
+    /** 完整的执行摘要（不截断） */
+    fullSummary: string;
+    /** 文件变更列表 */
+    fileChanges: FileChange[];
+    /** 是否运行了测试 */
+    testsRan?: boolean;
+    /** 测试是否通过 */
+    testsPassed?: boolean;
+    /** 错误信息 */
+    error?: string;
+    /** Worker 的决策记录 */
+    decisions: WorkerDecision[];
+}
+/**
+ * UpdateTaskPlan 工具的输入
+ * LeadAgent 用此工具动态更新执行计划中的任务状态
+ */
+export interface TaskPlanUpdateInput {
+    /** 操作类型 */
+    action: 'start_task' | 'complete_task' | 'fail_task' | 'skip_task' | 'add_task';
+    /** 任务 ID（必须是 ExecutionPlan 中的 ID，或 add_task 时自定义） */
+    taskId: string;
+    /** 执行模式（start_task 时指定） */
+    executionMode?: 'worker' | 'lead-agent';
+    /** 完成摘要（complete_task 时使用） */
+    summary?: string;
+    /** 错误信息（fail_task 时使用） */
+    error?: string;
+    /** 跳过原因（skip_task 时使用） */
+    reason?: string;
+    /** 新任务名称（add_task 时使用） */
+    name?: string;
+    /** 新任务描述（add_task 时使用） */
+    description?: string;
+    /** 新任务复杂度（add_task 时使用） */
+    complexity?: TaskComplexity;
+    /** 新任务类型（add_task 时使用） */
+    type?: TaskType;
+    /** 新任务预期修改文件（add_task 时使用） */
+    files?: string[];
+    /** 新任务依赖（add_task 时使用） */
+    dependencies?: string[];
+}
+/**
+ * TaskPlan 上下文（由 LeadAgent 在启动前设置）
+ */
+export interface TaskPlanContext {
+    /** 当前执行计划 */
+    executionPlan: ExecutionPlan;
+    /** 蓝图 ID */
+    blueprintId: string;
+    /** 任务状态更新回调 → LeadAgent → Coordinator → WebSocket → 前端 */
+    onPlanUpdate: (update: TaskPlanUpdateInput) => void;
+}
+//# sourceMappingURL=types.d.ts.map