@winspan/claude-forge 1.16.15 → 1.17.0

package/dist/pipeline/event-sourced-engine.js

@@ -0,0 +1,266 @@
+/**
+ * Pipeline 事件溯源 + 状态机 集成示例
+ *
+ * 展示如何使用新架构替代旧的 PipelineEngine
+ */
+import { EventStore } from './event-store.js';
+import { SnapshotStore } from './snapshot-store.js';
+import { OptimizedAggregator } from './optimized-aggregator.js';
+import { PipelineStateMachine } from './state-machine.js';
+import { PipelineStateQuery } from './state-query.js';
+import { PipelineEventType } from './events.js';
+/**
+ * 新架构的 Pipeline 引擎
+ */
+export class EventSourcedPipelineEngine {
+    eventStore;
+    snapshotStore;
+    aggregator;
+    stateMachine;
+    stateQuery;
+    constructor(dbPath) {
+        // 初始化各个组件
+        this.eventStore = new EventStore(dbPath);
+        this.snapshotStore = new SnapshotStore(dbPath);
+        this.aggregator = new OptimizedAggregator(this.eventStore, this.snapshotStore);
+        this.stateMachine = new PipelineStateMachine(this.eventStore, this.aggregator);
+        this.stateQuery = new PipelineStateQuery(this.aggregator, this.eventStore, this.stateMachine);
+    }
+    /**
+     * 创建 Pipeline
+     */
+    async createPipeline(params) {
+        const pipelineId = `pipeline-${Date.now()}`;
+        // 生成 PIPELINE_CREATED 事件
+        this.eventStore.append({
+            pipelineId,
+            type: PipelineEventType.PIPELINE_CREATED,
+            payload: {
+                requirement: params.requirement,
+                projectPath: params.projectPath,
+                sessionId: params.sessionId,
+                techStack: params.techStack,
+                complexity: params.complexity,
+                taskType: 'feature',
+                plannedPhases: params.plannedPhases,
+            },
+            metadata: {
+                sessionId: params.sessionId,
+            },
+        });
+        return pipelineId;
+    }
+    /**
+     * 添加任务
+     */
+    async addTask(pipelineId, task) {
+        this.eventStore.append({
+            pipelineId,
+            type: PipelineEventType.TASK_CREATED,
+            payload: {
+                taskId: task.id,
+                title: task.title,
+                phase: task.phase,
+                description: task.description,
+                source: 'manual',
+            },
+            metadata: {
+                sessionId: '',
+            },
+        });
+    }
+    /**
+     * 标记任务完成
+     */
+    async completeTask(pipelineId, taskId, artifact) {
+        this.eventStore.append({
+            pipelineId,
+            type: PipelineEventType.TASK_COMPLETED,
+            payload: {
+                taskId,
+                title: '',
+                phase: '',
+                artifact,
+                detectionMethod: 'explicit_signal',
+            },
+            metadata: {
+                sessionId: '',
+            },
+        });
+        // 检查是否所有任务完成
+        const pipeline = this.aggregator.rebuild(pipelineId);
+        if (!pipeline)
+            return;
+        const phaseTasks = pipeline.tasks.filter(t => t.phase === pipeline.phase);
+        const completed = phaseTasks.filter(t => t.status === 'completed').length;
+        if (completed === phaseTasks.length && phaseTasks.length > 0) {
+            // 触发质量检查
+            await this.stateMachine.transition(pipelineId, {
+                type: 'ALL_TASKS_COMPLETED',
+            });
+        }
+    }
+    /**
+     * 质量检查通过
+     */
+    async qualityCheckPassed(pipelineId, level) {
+        await this.stateMachine.transition(pipelineId, {
+            type: 'QUALITY_CHECK_PASSED',
+            level,
+        });
+    }
+    /**
+     * 质量检查失败
+     */
+    async qualityCheckFailed(pipelineId, issues, fixAttempt) {
+        if (fixAttempt >= 2) {
+            // 达到最大次数，强制放行
+            await this.stateMachine.transition(pipelineId, {
+                type: 'QUALITY_MAX_ATTEMPTS_REACHED',
+                unresolvedIssues: issues,
+            });
+        }
+        else {
+            // 阻塞并等待修复
+            await this.stateMachine.transition(pipelineId, {
+                type: 'QUALITY_CHECK_FAILED',
+                issues,
+                fixAttempt,
+            });
+        }
+    }
+    /**
+     * 手动推进阶段（强制放行后）
+     */
+    async manualAdvance(pipelineId, reason) {
+        await this.stateMachine.transition(pipelineId, {
+            type: 'MANUAL_ADVANCE',
+            reason,
+        });
+    }
+    /**
+     * 获取进度快照
+     */
+    getProgressSnapshot(pipelineId) {
+        const pipeline = this.aggregator.rebuild(pipelineId);
+        if (!pipeline)
+            return 'Pipeline not found';
+        const state = this.stateQuery.getCurrentState(pipelineId);
+        if (!state)
+            return 'State not found';
+        const progress = this.aggregator.getPhaseProgress(pipelineId, state.phase);
+        const globalProgress = this.aggregator.getGlobalProgress(pipelineId);
+        const phaseLabel = this.getPhaseLabel(state.phase);
+        const statusEmoji = this.getStatusEmoji(state.status);
+        const progressBar = this.renderProgressBar(progress.completed, progress.total);
+        let snapshot = `#${pipelineId.slice(0, 8)} ${phaseLabel} ${progress.completed}/${progress.total} [${progressBar}] 全局${globalProgress.percentage}%`;
+        // 添加状态标记
+        if (state.status === 'quality_checking') {
+            snapshot += '\n  🚦 阶段状态: 🔍 质量检查中...';
+        }
+        else if (state.status === 'quality_blocked') {
+            const fixAttempt = state.fixAttempt || 1;
+            snapshot += `\n  🚦 阶段状态: ⚠️ 待修复 (第${fixAttempt}次)`;
+            const blockReason = this.stateQuery.getBlockReason(pipelineId);
+            if (blockReason) {
+                snapshot += `\n    ${blockReason}`;
+            }
+            snapshot += '\n  ⏸️  阶段推进已暂停，修复后将自动继续';
+        }
+        else if (state.status === 'quality_forced_pass') {
+            snapshot += '\n  🚦 阶段状态: 🟡 强制放行（质量不达标）';
+            snapshot += '\n  ⚠️  请手动确认产物质量后，使用 MANUAL_ADVANCE 推进阶段';
+        }
+        // 添加任务列表
+        const phaseTasks = pipeline.tasks.filter(t => t.phase === state.phase);
+        if (phaseTasks.length > 0) {
+            snapshot += '\n' + phaseTasks.map(t => {
+                const icon = t.status === 'completed' ? '✅' : t.status === 'in_progress' ? '▶' : '○';
+                return `    ${icon} ${t.title}`;
+            }).join('\n');
+        }
+        return snapshot;
+    }
+    /**
+     * 获取状态历史
+     */
+    getStateHistory(pipelineId) {
+        return this.stateQuery.getStateHistory(pipelineId);
+    }
+    /**
+     * 获取质量门禁统计
+     */
+    getQualityStats(pipelineId) {
+        return this.stateQuery.getQualityGateStats(pipelineId);
+    }
+    getPhaseLabel(phase) {
+        const labels = {
+            analyze: '需求分析',
+            design: '架构设计',
+            profile: '用户画像',
+            code: '编码实现',
+            test: '测试',
+            review: '代码审查',
+            done: '完成',
+        };
+        return labels[phase] || phase;
+    }
+    getStatusEmoji(status) {
+        switch (status) {
+            case 'in_progress': return '▶';
+            case 'quality_checking': return '🔍';
+            case 'quality_blocked': return '⚠️';
+            case 'quality_forced_pass': return '🟡';
+            case 'completed': return '✅';
+            default: return '○';
+        }
+    }
+    renderProgressBar(completed, total) {
+        if (total === 0)
+            return '░░░░░░░░░░';
+        const filled = Math.round((completed / total) * 10);
+        return '█'.repeat(filled) + '░'.repeat(10 - filled);
+    }
+}
+/**
+ * 使用示例
+ */
+export async function example() {
+    const engine = new EventSourcedPipelineEngine('./pipeline.db');
+    // 1. 创建 Pipeline
+    const pipelineId = await engine.createPipeline({
+        requirement: '实现用户登录功能',
+        projectPath: '/path/to/project',
+        sessionId: 'session-123',
+        plannedPhases: ['analyze', 'design', 'code', 'test', 'review'],
+    });
+    console.log('Pipeline 创建:', pipelineId);
+    // 2. 添加任务
+    await engine.addTask(pipelineId, {
+        id: 'task-1',
+        title: '分析登录流程',
+        phase: 'analyze',
+    });
+    await engine.addTask(pipelineId, {
+        id: 'task-2',
+        title: '设计数据库表结构',
+        phase: 'analyze',
+    });
+    // 3. 完成任务
+    await engine.completeTask(pipelineId, 'task-1', '登录流程分析完成');
+    await engine.completeTask(pipelineId, 'task-2', '数据库表结构设计完成');
+    // 此时会自动触发质量检查
+    // 4. 质量检查失败
+    await engine.qualityCheckFailed(pipelineId, ['缺少安全性分析'], 1);
+    console.log('进度快照:', engine.getProgressSnapshot(pipelineId));
+    // 5. 修复后重新检查
+    await engine.qualityCheckPassed(pipelineId, 'pass');
+    console.log('进度快照:', engine.getProgressSnapshot(pipelineId));
+    // 6. 查看状态历史
+    const history = engine.getStateHistory(pipelineId);
+    console.log('状态历史:', history);
+    // 7. 查看质量统计
+    const stats = engine.getQualityStats(pipelineId);
+    console.log('质量统计:', stats);
+}
+//# sourceMappingURL=event-sourced-engine.js.map

package/dist/pipeline/event-sourced-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourced-engine.js","sourceRoot":"","sources":["../../src/pipeline/event-sourced-engine.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/event-store.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pipeline 事件存储层
+ *
+ * 职责：
+ * 1. 持久化事件到数据库
+ * 2. 按 Pipeline ID 查询事件流
+ * 3. 支持事件类型过滤
+ * 4. 保证事件顺序（timestamp 递增）
+ */
+import { PipelineEvent, PipelineEventType } from './events.js';
+export declare class EventStore {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * 初始化事件表
+     */
+    private initSchema;
+    /**
+     * 追加事件到事件流
+     */
+    append<T>(event: Omit<PipelineEvent<T>, 'id' | 'timestamp'>): PipelineEvent<T>;
+    /**
+     * 获取 Pipeline 的完整事件流
+     */
+    getEvents(pipelineId: string, options?: {
+        types?: PipelineEventType[];
+        since?: number;
+        limit?: number;
+    }): PipelineEvent[];
+    /**
+     * 获取所有 Pipeline ID
+     */
+    getAllPipelineIds(): string[];
+    /**
+     * 获取最新的 N 个事件
+     */
+    getLatestEvents(pipelineId: string, limit: number): PipelineEvent[];
+    /**
+     * 获取特定类型的最新事件
+     */
+    getLatestEventByType(pipelineId: string, type: PipelineEventType): PipelineEvent | null;
+    /**
+     * 统计事件数量
+     */
+    countEvents(pipelineId: string, options?: {
+        types?: PipelineEventType[];
+        since?: number;
+    }): number;
+    /**
+     * 清理过期事件（可选功能，用于数据归档）
+     */
+    pruneEvents(beforeTimestamp: number): number;
+    /**
+     * 关闭数据库连接
+     */
+    close(): void;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/pipeline/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/pipeline/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAK1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAwB9E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACtC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,aAAa,EAAE;IA8CnB;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAW7B;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IA4BnE;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI;IA8BvF;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACxC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,MAAM;IAmBV;;OAEG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;IAQ5C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/pipeline/event-store.js

@@ -0,0 +1,184 @@
+/**
+ * Pipeline 事件存储层
+ *
+ * 职责：
+ * 1. 持久化事件到数据库
+ * 2. 按 Pipeline ID 查询事件流
+ * 3. 支持事件类型过滤
+ * 4. 保证事件顺序（timestamp 递增）
+ */
+import Database from 'better-sqlite3';
+import { v4 as uuidv4 } from 'uuid';
+export class EventStore {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.initSchema();
+    }
+    /**
+     * 初始化事件表
+     */
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS pipeline_events (
+        id TEXT PRIMARY KEY,
+        pipeline_id TEXT NOT NULL,
+        type TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        payload TEXT NOT NULL,
+        metadata TEXT NOT NULL,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_pipeline_events_pipeline_id
+        ON pipeline_events(pipeline_id);
+
+      CREATE INDEX IF NOT EXISTS idx_pipeline_events_timestamp
+        ON pipeline_events(pipeline_id, timestamp);
+
+      CREATE INDEX IF NOT EXISTS idx_pipeline_events_type
+        ON pipeline_events(pipeline_id, type);
+    `);
+    }
+    /**
+     * 追加事件到事件流
+     */
+    append(event) {
+        const fullEvent = {
+            id: uuidv4(),
+            timestamp: Date.now(),
+            ...event,
+        };
+        const stmt = this.db.prepare(`
+      INSERT INTO pipeline_events (id, pipeline_id, type, timestamp, payload, metadata)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(fullEvent.id, fullEvent.pipelineId, fullEvent.type, fullEvent.timestamp, JSON.stringify(fullEvent.payload), JSON.stringify(fullEvent.metadata));
+        return fullEvent;
+    }
+    /**
+     * 获取 Pipeline 的完整事件流
+     */
+    getEvents(pipelineId, options) {
+        let sql = `
+      SELECT id, pipeline_id, type, timestamp, payload, metadata
+      FROM pipeline_events
+      WHERE pipeline_id = ?
+    `;
+        const params = [pipelineId];
+        if (options?.types && options.types.length > 0) {
+            sql += ` AND type IN (${options.types.map(() => '?').join(',')})`;
+            params.push(...options.types);
+        }
+        if (options?.since) {
+            sql += ` AND timestamp > ?`;
+            params.push(options.since);
+        }
+        sql += ` ORDER BY timestamp ASC`;
+        if (options?.limit) {
+            sql += ` LIMIT ?`;
+            params.push(options.limit);
+        }
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(row => ({
+            id: row.id,
+            pipelineId: row.pipeline_id,
+            type: row.type,
+            timestamp: row.timestamp,
+            payload: JSON.parse(row.payload),
+            metadata: JSON.parse(row.metadata),
+        }));
+    }
+    /**
+     * 获取所有 Pipeline ID
+     */
+    getAllPipelineIds() {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT pipeline_id
+      FROM pipeline_events
+      ORDER BY pipeline_id
+    `);
+        const rows = stmt.all();
+        return rows.map(row => row.pipeline_id);
+    }
+    /**
+     * 获取最新的 N 个事件
+     */
+    getLatestEvents(pipelineId, limit) {
+        const stmt = this.db.prepare(`
+      SELECT id, pipeline_id, type, timestamp, payload, metadata
+      FROM pipeline_events
+      WHERE pipeline_id = ?
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `);
+        const rows = stmt.all(pipelineId, limit);
+        return rows.reverse().map(row => ({
+            id: row.id,
+            pipelineId: row.pipeline_id,
+            type: row.type,
+            timestamp: row.timestamp,
+            payload: JSON.parse(row.payload),
+            metadata: JSON.parse(row.metadata),
+        }));
+    }
+    /**
+     * 获取特定类型的最新事件
+     */
+    getLatestEventByType(pipelineId, type) {
+        const stmt = this.db.prepare(`
+      SELECT id, pipeline_id, type, timestamp, payload, metadata
+      FROM pipeline_events
+      WHERE pipeline_id = ? AND type = ?
+      ORDER BY timestamp DESC
+      LIMIT 1
+    `);
+        const row = stmt.get(pipelineId, type);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            pipelineId: row.pipeline_id,
+            type: row.type,
+            timestamp: row.timestamp,
+            payload: JSON.parse(row.payload),
+            metadata: JSON.parse(row.metadata),
+        };
+    }
+    /**
+     * 统计事件数量
+     */
+    countEvents(pipelineId, options) {
+        let sql = `SELECT COUNT(*) as count FROM pipeline_events WHERE pipeline_id = ?`;
+        const params = [pipelineId];
+        if (options?.types && options.types.length > 0) {
+            sql += ` AND type IN (${options.types.map(() => '?').join(',')})`;
+            params.push(...options.types);
+        }
+        if (options?.since) {
+            sql += ` AND timestamp > ?`;
+            params.push(options.since);
+        }
+        const stmt = this.db.prepare(sql);
+        const result = stmt.get(...params);
+        return result.count;
+    }
+    /**
+     * 清理过期事件（可选功能，用于数据归档）
+     */
+    pruneEvents(beforeTimestamp) {
+        const stmt = this.db.prepare(`
+      DELETE FROM pipeline_events WHERE timestamp < ?
+    `);
+        const result = stmt.run(beforeTimestamp);
+        return result.changes;
+    }
+    /**
+     * 关闭数据库连接
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=event-store.js.map

package/dist/pipeline/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/pipeline/event-store.ts"],"names":[],"mappings":"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"}