openmatrix 0.1.0

package/dist/orchestrator/meeting-manager.d.ts

@@ -0,0 +1,85 @@
+import { StateManager } from '../storage/state-manager.js';
+import { ApprovalManager } from './approval-manager.js';
+import type { Approval } from '../types/index.js';
+/**
+ * Meeting 状态
+ */
+export type MeetingStatus = 'pending' | 'in_progress' | 'resolved' | 'cancelled';
+/**
+ * Meeting 类型
+ */
+export type MeetingType = 'blocking' | 'decision' | 'review' | 'planning';
+/**
+ * Meeting 记录
+ */
+export interface Meeting {
+    id: string;
+    type: MeetingType;
+    status: MeetingStatus;
+    taskId: string;
+    title: string;
+    description: string;
+    blockingReason?: string;
+    impactScope: string[];
+    participants: string[];
+    resolution?: string;
+    createdAt: string;
+    startedAt?: string;
+    resolvedAt?: string;
+}
+/**
+ * MeetingManager - Meeting 管理器
+ *
+ * 功能:
+ * 1. 创建和管理 Meeting
+ * 2. 跟踪 Meeting 状态流转
+ * 3. 与审批流程集成
+ * 4. 自动触发条件检测
+ */
+export declare class MeetingManager {
+    private stateManager;
+    private approvalManager;
+    constructor(stateManager: StateManager, approvalManager: ApprovalManager);
+    /**
+     * 创建阻塞问题 Meeting
+     */
+    createBlockingMeeting(taskId: string, blockingReason: string, impactScope: string[]): Promise<{
+        meeting: Meeting;
+        approval: Approval;
+    }>;
+    /**
+     * 创建决策 Meeting
+     */
+    createDecisionMeeting(taskId: string, decision: string, options: string[]): Promise<{
+        meeting: Meeting;
+        approval: Approval;
+    }>;
+    /**
+     * 开始 Meeting
+     */
+    startMeeting(meetingId: string): Promise<Meeting>;
+    /**
+     * 解决 Meeting
+     */
+    resolveMeeting(meetingId: string, resolution: string): Promise<Meeting>;
+    /**
+     * 取消 Meeting
+     */
+    cancelMeeting(meetingId: string, reason: string): Promise<Meeting>;
+    /**
+     * 获取待处理的 Meeting
+     */
+    getPendingMeetings(): Promise<Meeting[]>;
+    /**
+     * 获取进行中的 Meeting
+     */
+    getActiveMeetings(): Promise<Meeting[]>;
+    /**
+     * 检查是否有阻塞的 Meeting
+     */
+    hasBlockingMeetings(): Promise<boolean>;
+    /**
+     * 生成 Meeting 报告
+     */
+    generateMeetingReport(meeting: Meeting): string;
+}

package/dist/orchestrator/meeting-manager.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingManager = void 0;
+/**
+ * MeetingManager - Meeting 管理器
+ *
+ * 功能:
+ * 1. 创建和管理 Meeting
+ * 2. 跟踪 Meeting 状态流转
+ * 3. 与审批流程集成
+ * 4. 自动触发条件检测
+ */
+class MeetingManager {
+    stateManager;
+    approvalManager;
+    constructor(stateManager, approvalManager) {
+        this.stateManager = stateManager;
+        this.approvalManager = approvalManager;
+    }
+    /**
+     * 创建阻塞问题 Meeting
+     */
+    async createBlockingMeeting(taskId, blockingReason, impactScope) {
+        const meetingId = `meeting-${Date.now().toString(36)}`;
+        const now = new Date().toISOString();
+        const meeting = {
+            id: meetingId,
+            type: 'blocking',
+            status: 'pending',
+            taskId,
+            title: `🔴 阻塞问题: ${blockingReason.slice(0, 50)}...`,
+            description: `任务 ${taskId} 遇到阻塞问题，需要人工干预`,
+            blockingReason,
+            impactScope,
+            participants: ['user'],
+            createdAt: now
+        };
+        // 保存 Meeting
+        await this.stateManager.saveMeeting(meeting);
+        // 创建审批
+        const approval = await this.approvalManager.createApproval({
+            type: 'meeting',
+            taskId,
+            title: meeting.title,
+            description: `
+## 阻塞问题描述
+
+**任务**: ${taskId}
+**原因**: ${blockingReason}
+
+## 影响范围
+
+${impactScope.map(item => `- ${item}`).join('\n')}
+
+## 需要的行动
+
+请选择以下操作之一:
+
+1. **提供信息** - 提供解决阻塞所需的信息
+2. **跳过任务** - 标记任务为可选，跳过继续执行
+3. **修改方案** - 调整任务方案或参数
+4. **取消执行** - 停止整个执行流程
+`,
+            content: JSON.stringify({ meetingId, blockingReason, impactScope })
+        });
+        return { meeting, approval };
+    }
+    /**
+     * 创建决策 Meeting
+     */
+    async createDecisionMeeting(taskId, decision, options) {
+        const meetingId = `meeting-${Date.now().toString(36)}`;
+        const now = new Date().toISOString();
+        const meeting = {
+            id: meetingId,
+            type: 'decision',
+            status: 'pending',
+            taskId,
+            title: `🤔 需要决策: ${decision.slice(0, 50)}...`,
+            description: `需要用户做出技术决策`,
+            impactScope: [],
+            participants: ['user'],
+            createdAt: now
+        };
+        await this.stateManager.saveMeeting(meeting);
+        const approval = await this.approvalManager.createApproval({
+            type: 'meeting',
+            taskId,
+            title: meeting.title,
+            description: `
+## 决策点
+
+**任务**: ${taskId}
+**问题**: ${decision}
+
+## 可选方案
+
+${options.map((opt, i) => `${i + 1}. ${opt}`).join('\n')}
+
+请在审批时提供您的选择。
+`,
+            content: JSON.stringify({ meetingId, decision, options })
+        });
+        return { meeting, approval };
+    }
+    /**
+     * 开始 Meeting
+     */
+    async startMeeting(meetingId) {
+        const meeting = await this.stateManager.getMeeting(meetingId);
+        if (!meeting) {
+            throw new Error(`Meeting ${meetingId} not found`);
+        }
+        const updatedMeeting = {
+            ...meeting,
+            status: 'in_progress',
+            startedAt: new Date().toISOString()
+        };
+        await this.stateManager.saveMeeting(updatedMeeting);
+        return updatedMeeting;
+    }
+    /**
+     * 解决 Meeting
+     */
+    async resolveMeeting(meetingId, resolution) {
+        const meeting = await this.stateManager.getMeeting(meetingId);
+        if (!meeting) {
+            throw new Error(`Meeting ${meetingId} not found`);
+        }
+        const updatedMeeting = {
+            ...meeting,
+            status: 'resolved',
+            resolution,
+            resolvedAt: new Date().toISOString()
+        };
+        await this.stateManager.saveMeeting(updatedMeeting);
+        // 更新关联任务状态
+        if (meeting.type === 'blocking') {
+            // 将任务从 waiting 恢复到 pending
+            const task = await this.stateManager.getTask(meeting.taskId);
+            if (task && task.status === 'waiting') {
+                await this.stateManager.updateTask(meeting.taskId, {
+                    status: 'pending',
+                    error: undefined
+                });
+            }
+        }
+        return updatedMeeting;
+    }
+    /**
+     * 取消 Meeting
+     */
+    async cancelMeeting(meetingId, reason) {
+        const meeting = await this.stateManager.getMeeting(meetingId);
+        if (!meeting) {
+            throw new Error(`Meeting ${meetingId} not found`);
+        }
+        const updatedMeeting = {
+            ...meeting,
+            status: 'cancelled',
+            resolution: `Cancelled: ${reason}`,
+            resolvedAt: new Date().toISOString()
+        };
+        await this.stateManager.saveMeeting(updatedMeeting);
+        return updatedMeeting;
+    }
+    /**
+     * 获取待处理的 Meeting
+     */
+    async getPendingMeetings() {
+        return this.stateManager.getMeetingsByStatus('pending');
+    }
+    /**
+     * 获取进行中的 Meeting
+     */
+    async getActiveMeetings() {
+        return this.stateManager.getMeetingsByStatus('in_progress');
+    }
+    /**
+     * 检查是否有阻塞的 Meeting
+     */
+    async hasBlockingMeetings() {
+        const pending = await this.getPendingMeetings();
+        const active = await this.getActiveMeetings();
+        return [...pending, ...active].some(m => m.type === 'blocking');
+    }
+    /**
+     * 生成 Meeting 报告
+     */
+    generateMeetingReport(meeting) {
+        const lines = [];
+        lines.push(`# Meeting 报告: ${meeting.id}`);
+        lines.push('');
+        lines.push(`**类型**: ${meeting.type}`);
+        lines.push(`**状态**: ${meeting.status}`);
+        lines.push(`**任务**: ${meeting.taskId}`);
+        lines.push(`**创建时间**: ${meeting.createdAt}`);
+        lines.push('');
+        if (meeting.blockingReason) {
+            lines.push('## 阻塞原因');
+            lines.push(meeting.blockingReason);
+            lines.push('');
+        }
+        if (meeting.impactScope.length > 0) {
+            lines.push('## 影响范围');
+            for (const item of meeting.impactScope) {
+                lines.push(`- ${item}`);
+            }
+            lines.push('');
+        }
+        if (meeting.resolution) {
+            lines.push('## 解决方案');
+            lines.push(meeting.resolution);
+            lines.push('');
+        }
+        if (meeting.resolvedAt) {
+            lines.push(`**解决时间**: ${meeting.resolvedAt}`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.MeetingManager = MeetingManager;

package/dist/orchestrator/phase-executor.d.ts

@@ -0,0 +1,198 @@
+import { StateManager } from '../storage/state-manager.js';
+import { ApprovalManager } from './approval-manager.js';
+import { AgentRunner, type SubagentTask, type UserContext } from '../agents/agent-runner.js';
+import { GitCommitManager } from './git-commit-manager.js';
+import type { Task, QualityConfig, QualityReport } from '../types/index.js';
+export type Phase = 'develop' | 'verify' | 'accept' | 'tdd';
+export interface PhaseResult {
+    phase: Phase;
+    success: boolean;
+    output?: string;
+    error?: string;
+    duration: number;
+    artifacts: string[];
+    nextPhase?: Phase;
+    needsApproval: boolean;
+    /** 质量报告 (verify 阶段产出) */
+    qualityReport?: QualityReport;
+}
+export interface BuildTestResult {
+    compile: boolean;
+    staticAnalysis: boolean;
+    dependencies: boolean;
+    package: boolean;
+    errors: string[];
+}
+/**
+ * 质量门禁结果
+ */
+export interface QualityGateResult {
+    passed: boolean;
+    tests: {
+        passed: number;
+        failed: number;
+        coverage: number;
+    };
+    build: {
+        success: boolean;
+        errors: string[];
+    };
+    lint: {
+        errors: number;
+        warnings: number;
+    };
+    security: {
+        vulnerabilities: number;
+    };
+    acceptance: {
+        met: number;
+        total: number;
+    };
+}
+/**
+ * PhaseExecutor - 四阶段验证执行器 (增强版)
+ *
+ * 每个任务经历四个阶段 (TDD 模式):
+ * 0. TDD - 先写测试 (可选)
+ * 1. Develop - 开发实现
+ * 2. Verify - 严格质量门禁 (测试/构建/Lint/安全/验收)
+ * 3. Accept - 最终验收
+ *
+ * 质量级别:
+ * - fast: 无质量门禁，最快
+ * - balanced: 基础门禁 (60%覆盖率, Lint, 安全扫描)
+ * - strict: 严格门禁 (TDD, 80%覆盖率, 严格Lint, 安全扫描)
+ *
+ * 在 auto 模式下 (isAutoMode=true):
+ * - 阶段间自动流转，无需确认
+ * - 质量门禁失败时暂停
+ * - 仅在失败/异常时暂停
+ */
+export declare class PhaseExecutor {
+    private stateManager;
+    private approvalManager;
+    private agentRunner;
+    private gitCommitManager;
+    private isAutoMode;
+    private runId;
+    private userContext;
+    private minTestCoverage;
+    /** 质量配置 */
+    private qualityConfig;
+    /** 默认质量配置 (balanced) */
+    private static DEFAULT_QUALITY;
+    constructor(stateManager: StateManager, approvalManager: ApprovalManager);
+    /**
+     * 设置自动模式
+     */
+    setAutoMode(auto: boolean): void;
+    /**
+     * 获取自动模式状态
+     */
+    getAutoMode(): boolean;
+    /**
+     * 设置 Run ID (用于提交信息)
+     */
+    setRunId(runId: string): void;
+    /**
+     * 设置质量配置
+     */
+    setQualityConfig(config: Partial<QualityConfig>): void;
+    /**
+     * 获取质量配置
+     */
+    getQualityConfig(): QualityConfig;
+    /**
+     * 设置质量级别预设
+     */
+    setQualityLevel(level: 'fast' | 'balanced' | 'strict'): void;
+    /**
+     * 设置用户上下文
+     */
+    setUserContext(context: UserContext): void;
+    /**
+     * 设置最低测试覆盖率
+     */
+    setMinTestCoverage(coverage: number): void;
+    /**
+     * 获取最低测试覆盖率
+     */
+    getMinTestCoverage(): number;
+    /**
+     * 设置是否启用自动提交
+     */
+    setAutoCommit(enabled: boolean): void;
+    /**
+     * 获取 GitCommitManager 实例
+     */
+    getGitCommitManager(): GitCommitManager;
+    /**
+     * 获取任务当前阶段
+     */
+    getCurrentPhase(task: Task): Phase;
+    /**
+     * 准备阶段执行的 Subagent 任务
+     */
+    preparePhaseExecution(task: Task): Promise<SubagentTask | null>;
+    /**
+     * 准备 TDD 阶段 - 先写测试
+     */
+    private prepareTDDPhase;
+    /**
+     * 准备开发阶段
+     */
+    private prepareDevelopPhase;
+    /**
+     * 构建 TDD 阶段提示词 - 先写测试
+     */
+    private buildTDDPrompt;
+    /**
+     * 准备验证阶段
+     */
+    private prepareVerifyPhase;
+    /**
+     * 准备验收阶段
+     */
+    private prepareAcceptPhase;
+    /**
+     * 构建开发阶段提示词 (增强版: 注入验收标准和用户上下文)
+     */
+    private buildDevelopPrompt;
+    /**
+     * 构建验证阶段提示词 (增强版: 严格质量门禁)
+     */
+    private buildVerifyPrompt;
+    /**
+     * 构建验收阶段提示词 (增强版: 验收标准检查)
+     */
+    private buildAcceptPrompt;
+    /**
+     * 处理阶段结果
+     *
+     * 在 auto 模式下:
+     * - 自动进入下一阶段，needsApproval = false
+     * - 仅在失败时暂停
+     * - 自动提交代码 (如果启用)
+     */
+    processPhaseResult(task: Task, phase: Phase, result: {
+        success: boolean;
+        output: string;
+        error?: string;
+    }): Promise<PhaseResult>;
+    /**
+     * 检查 Build 测试结果
+     */
+    parseBuildTestResult(output: string): BuildTestResult;
+    /**
+     * 解析质量报告
+     */
+    parseQualityReport(output: string): QualityGateResult;
+    /**
+     * 生成质量报告 JSON
+     */
+    generateQualityReport(task: Task, gateResult: QualityGateResult): QualityReport;
+    /**
+     * 获取 AgentRunner 实例
+     */
+    getAgentRunner(): AgentRunner;
+}