@hongmaple0820/scale-engine 0.9.0 → 0.10.1

package/dist/workflow/cognitive/ConsensusPlanner.js

@@ -0,0 +1,141 @@
+// SCALE Engine — Consensus Planner
+// 共识规划引擎 (三角色循环: Planner -> Architect -> Critic)
+export class ConsensusPlanner {
+    constructor(eventBus) {
+        this.maxIterations = 5;
+        this.rounds = [];
+        this.eventBus = eventBus;
+        this.planner = new PlannerRole();
+        this.architect = new ArchitectRole();
+        this.critic = new CriticRole();
+    }
+    setMaxIterations(n) {
+        this.maxIterations = n;
+    }
+    async execute(requirement) {
+        this.rounds = [];
+        let currentInput = requirement;
+        let verdict = 'ITERATE';
+        let iterationCount = 0;
+        while (verdict === 'ITERATE' && iterationCount < this.maxIterations) {
+            iterationCount++;
+            const plannerOutput = await this.planner.process(currentInput);
+            const architectReview = await this.architect.process(plannerOutput);
+            const criticReview = await this.critic.process(architectReview);
+            verdict = this.evaluateVerdict(plannerOutput, architectReview, criticReview);
+            const round = {
+                round: iterationCount,
+                plannerOutput,
+                architectReview,
+                criticReview,
+                verdict
+            };
+            this.rounds.push(round);
+            this.eventBus.emit('consensus.round', round);
+            if (verdict === 'ITERATE') {
+                currentInput = this.synthesizeFeedback(plannerOutput, architectReview, criticReview);
+            }
+        }
+        return this.generateRALPLANOutput(verdict, iterationCount);
+    }
+    evaluateVerdict(planner, architect, critic) {
+        const architectApproved = architect.includes('APPROVE') || architect.includes('可行');
+        const criticApproved = critic.includes('APPROVE') || critic.includes('无风险');
+        const hasBlockingIssues = critic.includes('BLOCK') || critic.includes('CRITICAL');
+        if (hasBlockingIssues)
+            return 'REJECT';
+        if (architectApproved && criticApproved)
+            return 'APPROVE';
+        return 'ITERATE';
+    }
+    synthesizeFeedback(planner, architect, critic) {
+        return `Previous Plan:\n${planner}\n\nArchitect Feedback:\n${architect}\n\nCritic Concerns:\n${critic}\n\nPlease revise the plan addressing all concerns.`;
+    }
+    generateRALPLANOutput(verdict, iterations) {
+        const lastRound = this.rounds[this.rounds.length - 1];
+        return {
+            principles: this.extractPrinciples(lastRound?.plannerOutput || ''),
+            decisionDrivers: this.extractDrivers(lastRound?.architectReview || ''),
+            viableOptions: this.extractOptions(lastRound?.plannerOutput || ''),
+            preMortem: this.extractPreMortem(lastRound?.criticReview || ''),
+            verdict,
+            iterationCount: iterations
+        };
+    }
+    extractPrinciples(text) {
+        const match = text.match(/原则[:：]\s*([\s\S]*?)(?=驱动|$)/);
+        if (match) {
+            return match[1].split('\n').map(s => s.trim()).filter(s => s.length > 0);
+        }
+        return ['可维护性优先', '渐进式实现', '测试驱动'];
+    }
+    extractDrivers(text) {
+        const match = text.match(/驱动[:：]\s*([\s\S]*?)(?=方案|$)/);
+        if (match) {
+            return match[1].split('\n').map(s => s.trim()).filter(s => s.length > 0).slice(0, 3);
+        }
+        return ['性能要求', '安全约束', '向下兼容'];
+    }
+    extractOptions(text) {
+        return [
+            { name: '方案A', description: '标准实现路径', pros: ['稳定'], cons: ['慢'], selected: true },
+            { name: '方案B', description: '快速实现路径', pros: ['快'], cons: ['风险高'], selected: false }
+        ];
+    }
+    extractPreMortem(text) {
+        return {
+            assumedFailure: '实现超时',
+            rootCauses: ['技术债务', '需求变更'],
+            mitigations: ['增量交付', '及时沟通']
+        };
+    }
+    getRounds() {
+        return this.rounds;
+    }
+    formatReport(output) {
+        const lines = ['=== RALPLAN-DR Report ==='];
+        lines.push(`Verdict: ${output.verdict} (${output.iterationCount} iterations)`);
+        lines.push('');
+        lines.push('Principles:');
+        output.principles.forEach(p => lines.push(`  - ${p}`));
+        lines.push('');
+        lines.push('Decision Drivers (Top 3):');
+        output.decisionDrivers.forEach(d => lines.push(`  - ${d}`));
+        lines.push('');
+        lines.push('Viable Options:');
+        output.viableOptions.forEach(o => {
+            lines.push(`  ${o.selected ? '[SELECTED]' : '[ALT]'} ${o.name}: ${o.description}`);
+        });
+        lines.push('');
+        lines.push('Pre-Mortem Analysis:');
+        lines.push(`  Assumed Failure: ${output.preMortem.assumedFailure}`);
+        lines.push(`  Root Causes: ${output.preMortem.rootCauses.join(', ')}`);
+        lines.push(`  Mitigations: ${output.preMortem.mitigations.join(', ')}`);
+        return lines.join('\n');
+    }
+}
+class PlannerRole {
+    constructor() {
+        this.name = 'Planner';
+    }
+    async process(input) {
+        return `Plan for: ${input}\n\n原则：\n- 渐进式实现\n- 测试驱动\n- 最小变更\n\n驱动因素：\n1. 用户需求\n2. 技术约束\n3. 时间限制\n\n方案A：标准路径（推荐）\n方案B：快速路径`;
+    }
+}
+class ArchitectRole {
+    constructor() {
+        this.name = 'Architect';
+    }
+    async process(input) {
+        return `Architecture Review:\n\nAPPROVE - 技术可行性确认\n\n架构建议：\n- 模块化设计\n- 接口抽象\n- 依赖隔离`;
+    }
+}
+class CriticRole {
+    constructor() {
+        this.name = 'Critic';
+    }
+    async process(input) {
+        return `Critical Review:\n\n风险评估：\n- 性能瓶颈：中等风险\n- 安全隐患：低风险\n- 兼容性问题：需关注\n\nAPPROVE - 无阻断性风险`;
+    }
+}
+//# sourceMappingURL=ConsensusPlanner.js.map

package/dist/workflow/cognitive/ConsensusPlanner.js.map

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

package/dist/workflow/cognitive/SocraticQuestioner.d.ts

@@ -0,0 +1,33 @@
+import type { IEventBus } from '../../core/eventBus.js';
+import type { AmbiguityScoreResult, SocraticQuestion, SocraticSession } from '../types.js';
+export interface ISocraticQuestioner {
+    startSession(requirement: string, ambiguityResult: AmbiguityScoreResult): SocraticSession;
+    askNextQuestion(session: SocraticSession): SocraticQuestion | null;
+    recordAnswer(sessionId: string, questionId: string, answer: string): void;
+    evaluateProgress(session: SocraticSession): {
+        refined: boolean;
+        newAmbiguity: number;
+    };
+    shouldBlock(session: SocraticSession): boolean;
+    generateRefinedRequirement(session: SocraticSession): string;
+}
+export declare class SocraticQuestioner implements ISocraticQuestioner {
+    private eventBus;
+    private sessions;
+    private maxRounds;
+    constructor(eventBus: IEventBus);
+    startSession(requirement: string, ambiguityResult: AmbiguityScoreResult): SocraticSession;
+    askNextQuestion(session: SocraticSession): SocraticQuestion | null;
+    recordAnswer(sessionId: string, questionId: string, answer: string): void;
+    evaluateProgress(session: SocraticSession): {
+        refined: boolean;
+        newAmbiguity: number;
+    };
+    shouldBlock(session: SocraticSession): boolean;
+    generateRefinedRequirement(session: SocraticSession): string;
+    getSession(sessionId: string): SocraticSession | undefined;
+    formatSessionReport(session: SocraticSession): string;
+    private getQuestionPriority;
+    private evaluateAnswerClarity;
+    private generateFollowUp;
+}

package/dist/workflow/cognitive/SocraticQuestioner.js

@@ -0,0 +1,276 @@
+// SCALE Engine — Socratic Questioner
+// 苏格拉底提问器 - 需求精炼 (六问重构框架)
+// 来源借鉴: OMC deep-interview + gstack office-hours
+// 六问重构框架
+const SIX_QUESTIONS = [
+    {
+        id: 'q-goal',
+        category: 'goal',
+        question: '你想要达成什么具体结果？请描述期望的最终状态。',
+        followUps: [
+            '这个结果是否可量化？',
+            '达成后用户会如何使用？',
+            '有没有参考案例？'
+        ],
+        answered: false,
+        clarityScore: 0
+    },
+    {
+        id: 'q-constraint',
+        category: 'constraint',
+        question: '有哪些不可逾越的边界？包括技术、时间、资源限制。',
+        followUps: [
+            '技术栈是否已确定？',
+            '有固定的截止日期吗？',
+            '预算/人力约束是什么？'
+        ],
+        answered: false,
+        clarityScore: 0
+    },
+    {
+        id: 'q-acceptance',
+        category: 'acceptance',
+        question: '如何验证成功？请给出可测试的验收标准。',
+        followUps: [
+            '能否用具体指标描述？',
+            '用户如何确认满足需求？',
+            '最小可接受标准是什么？'
+        ],
+        answered: false,
+        clarityScore: 0
+    },
+    {
+        id: 'q-context',
+        category: 'context',
+        question: '现有系统/依赖有哪些需要兼容？',
+        followUps: [
+            '是否需要向下兼容？',
+            '有哪些现有接口需要保持？',
+            '数据迁移需求？'
+        ],
+        answered: false,
+        clarityScore: 0
+    },
+    {
+        id: 'q-risk',
+        category: 'risk',
+        question: '最可能的2种失败场景是什么？',
+        followUps: [
+            '如果数据丢失会怎样？',
+            '如果性能下降会怎样？',
+            '回滚方案是什么？'
+        ],
+        answered: false,
+        clarityScore: 0
+    },
+    {
+        id: 'q-priority',
+        category: 'priority',
+        question: '如果只能完成一半，哪些必须先做？',
+        followUps: [
+            '核心功能是什么？',
+            '哪些可以后续迭代？',
+            'MVP 定义是什么？'
+        ],
+        answered: false,
+        clarityScore: 0
+    }
+];
+export class SocraticQuestioner {
+    constructor(eventBus) {
+        this.sessions = new Map();
+        this.maxRounds = 3;
+        this.eventBus = eventBus;
+    }
+    startSession(requirement, ambiguityResult) {
+        const sessionId = `socratic-${Date.now()}`;
+        const session = {
+            sessionId,
+            requirement,
+            initialAmbiguity: ambiguityResult,
+            questions: SIX_QUESTIONS.map(q => ({ ...q, clarityScore: 0 })),
+            currentRound: 0,
+            maxRounds: this.maxRounds,
+            status: 'in_progress',
+            refinementHistory: []
+        };
+        this.sessions.set(sessionId, session);
+        this.eventBus.emit('socratic.session.started', { sessionId, initialAmbiguity: ambiguityResult.totalScore });
+        return session;
+    }
+    askNextQuestion(session) {
+        if (session.status !== 'in_progress')
+            return null;
+        // 找到未回答的最高优先级问题
+        const unanswered = session.questions
+            .filter(q => !q.answered)
+            .sort((a, b) => this.getQuestionPriority(a) - this.getQuestionPriority(b));
+        if (unanswered.length === 0) {
+            // 所有问题已回答，评估是否需要继续
+            const progress = this.evaluateProgress(session);
+            if (progress.refined) {
+                session.status = 'refined';
+                return null;
+            }
+            // 需要深入追问
+            return this.generateFollowUp(session);
+        }
+        return unanswered[0];
+    }
+    recordAnswer(sessionId, questionId, answer) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        const question = session.questions.find(q => q.id === questionId);
+        if (!question)
+            return;
+        question.answered = true;
+        question.answer = answer;
+        question.clarityScore = this.evaluateAnswerClarity(answer);
+        this.eventBus.emit('socratic.answer.recorded', { sessionId, questionId, clarityScore: question.clarityScore });
+    }
+    evaluateProgress(session) {
+        const answeredCount = session.questions.filter(q => q.answered).length;
+        const totalClarity = session.questions.reduce((sum, q) => sum + q.clarityScore, 0);
+        const avgClarity = answeredCount > 0 ? totalClarity / answeredCount : 0;
+        // 计算新的模糊度
+        const initialAmbiguity = session.initialAmbiguity.totalScore;
+        const reductionFactor = avgClarity * 0.5; // 每个清晰回答减少最多 50% 模糊度
+        const newAmbiguity = Math.max(0.05, initialAmbiguity * (1 - reductionFactor));
+        // 记录本轮
+        const round = {
+            round: session.currentRound + 1,
+            questionsAsked: session.questions.filter(q => q.answered).map(q => q.id),
+            answersReceived: session.questions.filter(q => q.answered && q.answer).map(q => q.answer || ''),
+            ambiguityBefore: session.refinementHistory.length > 0
+                ? session.refinementHistory[session.refinementHistory.length - 1].ambiguityAfter
+                : initialAmbiguity,
+            ambiguityAfter: newAmbiguity
+        };
+        session.refinementHistory.push(round);
+        session.currentRound++;
+        const refined = newAmbiguity <= 0.20;
+        if (refined) {
+            session.status = 'refined';
+            session.finalAmbiguity = {
+                ...session.initialAmbiguity,
+                totalScore: newAmbiguity,
+                shouldProceed: true,
+                requiresQuestioning: false,
+                blocked: false
+            };
+        }
+        return { refined, newAmbiguity };
+    }
+    shouldBlock(session) {
+        // 连续 3 轮仍未达标
+        if (session.currentRound >= session.maxRounds && session.status === 'in_progress') {
+            session.status = 'blocked';
+            this.eventBus.emit('socratic.session.blocked', { sessionId: session.sessionId });
+            return true;
+        }
+        return false;
+    }
+    generateRefinedRequirement(session) {
+        const parts = [];
+        // 目标
+        const goalQ = session.questions.find(q => q.id === 'q-goal');
+        if (goalQ?.answer)
+            parts.push(`目标: ${goalQ.answer}`);
+        // 约束
+        const constraintQ = session.questions.find(q => q.id === 'q-constraint');
+        if (constraintQ?.answer)
+            parts.push(`约束: ${constraintQ.answer}`);
+        // 验收标准
+        const acceptanceQ = session.questions.find(q => q.id === 'q-acceptance');
+        if (acceptanceQ?.answer)
+            parts.push(`验收标准: ${acceptanceQ.answer}`);
+        // 上下文
+        const contextQ = session.questions.find(q => q.id === 'q-context');
+        if (contextQ?.answer)
+            parts.push(`上下文: ${contextQ.answer}`);
+        // 风险
+        const riskQ = session.questions.find(q => q.id === 'q-risk');
+        if (riskQ?.answer)
+            parts.push(`风险边界: ${riskQ.answer}`);
+        // 优先级
+        const priorityQ = session.questions.find(q => q.id === 'q-priority');
+        if (priorityQ?.answer)
+            parts.push(`优先级: ${priorityQ.answer}`);
+        return parts.join('\n\n');
+    }
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    formatSessionReport(session) {
+        const lines = [];
+        lines.push('=== Socratic Questioning Report ===');
+        lines.push(`Session: ${session.sessionId}`);
+        lines.push(`Status: ${session.status}`);
+        lines.push(`Rounds: ${session.currentRound}/${session.maxRounds}`);
+        lines.push('');
+        lines.push(`Initial Ambiguity: ${session.initialAmbiguity.totalScore.toFixed(2)}`);
+        if (session.finalAmbiguity) {
+            lines.push(`Final Ambiguity: ${session.finalAmbiguity.totalScore.toFixed(2)}`);
+        }
+        lines.push('');
+        lines.push('Questions:');
+        session.questions.forEach(q => {
+            const status = q.answered ? `[✓]` : `[ ]`;
+            lines.push(`  ${status} ${q.category}: ${q.question}`);
+            if (q.answer) {
+                lines.push(`       Answer: ${q.answer.slice(0, 100)}...`);
+                lines.push(`       Clarity: ${q.clarityScore.toFixed(2)}`);
+            }
+        });
+        if (session.status === 'refined') {
+            lines.push('');
+            lines.push('Refined Requirement:');
+            lines.push(this.generateRefinedRequirement(session));
+        }
+        return lines.join('\n');
+    }
+    // 私有方法
+    getQuestionPriority(question) {
+        // 目标 > 验收 > 约束 > 上下文 > 风险 > 优先级
+        const priorities = {
+            goal: 1,
+            acceptance: 2,
+            constraint: 3,
+            context: 4,
+            risk: 5,
+            priority: 6
+        };
+        return priorities[question.category] ?? 7;
+    }
+    evaluateAnswerClarity(answer) {
+        if (!answer || answer.length < 10)
+            return 0.2;
+        if (answer.length < 30)
+            return 0.4;
+        if (answer.includes('具体') || answer.includes('明确') || answer.includes('标准'))
+            return 0.8;
+        if (answer.includes('可能') || answer.includes('也许') || answer.includes('大概'))
+            return 0.3;
+        return 0.6;
+    }
+    generateFollowUp(session) {
+        // 找到模糊度最高的已回答问题，生成追问
+        const lowClarity = session.questions
+            .filter(q => q.answered && q.clarityScore < 0.5)
+            .sort((a, b) => a.clarityScore - b.clarityScore);
+        if (lowClarity.length === 0)
+            return null;
+        const target = lowClarity[0];
+        const followUpIndex = Math.floor(Math.random() * target.followUps.length);
+        return {
+            id: `${target.id}-follow-${followUpIndex}`,
+            category: target.category,
+            question: target.followUps[followUpIndex],
+            followUps: [],
+            answered: false,
+            clarityScore: 0
+        };
+    }
+}
+//# sourceMappingURL=SocraticQuestioner.js.map

package/dist/workflow/cognitive/SocraticQuestioner.js.map

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

package/dist/workflow/execution/RalphEngine.d.ts

@@ -0,0 +1,36 @@
+import type { IEventBus } from '../../core/eventBus.js';
+import type { PRDDocument, UserStory, VerificationResult } from '../types.js';
+export interface IStoryExecutor {
+    execute(story: UserStory): Promise<unknown>;
+}
+export interface IStoryVerifier {
+    verify(story: UserStory, result: unknown): Promise<VerificationResult[]>;
+}
+export declare class RalphEngine {
+    private eventBus;
+    private prd;
+    private executor;
+    private verifier;
+    private maxIterations;
+    private currentIteration;
+    constructor(eventBus: IEventBus);
+    setPRD(prd: PRDDocument): void;
+    setMaxIterations(n: number): void;
+    run(): Promise<PRDDocument>;
+    private executeStory;
+    private allStoriesPassed;
+    private runDeslopPass;
+    generateDeliveryReport(): string;
+    getProgress(): {
+        total: number;
+        passed: number;
+        pending: number;
+    };
+}
+export declare class PRDManager {
+    private prds;
+    createPRD(title: string, stories: UserStory[]): PRDDocument;
+    getPRD(id: string): PRDDocument | undefined;
+    updatePRD(id: string, updates: Partial<PRDDocument>): PRDDocument | undefined;
+    listPRDs(): PRDDocument[];
+}

package/dist/workflow/execution/RalphEngine.js

@@ -0,0 +1,123 @@
+// SCALE Engine — Ralph Engine
+// PRD驱动持久执行引擎
+import { HonestDelivery } from '../quality/HonestDelivery.js';
+export class RalphEngine {
+    constructor(eventBus) {
+        this.prd = null;
+        this.maxIterations = 5;
+        this.currentIteration = 0;
+        this.eventBus = eventBus;
+        this.executor = new DefaultStoryExecutor();
+        this.verifier = new DefaultStoryVerifier();
+    }
+    setPRD(prd) {
+        this.prd = prd;
+    }
+    setMaxIterations(n) {
+        this.maxIterations = n;
+    }
+    async run() {
+        if (!this.prd) {
+            throw new Error('PRD not set');
+        }
+        this.currentIteration = 0;
+        while (!this.allStoriesPassed() && this.currentIteration < this.maxIterations) {
+            this.currentIteration++;
+            this.eventBus.emit('ralph.iteration', { iteration: this.currentIteration });
+            for (const story of this.prd.userStories) {
+                if (!story.passes) {
+                    await this.executeStory(story);
+                }
+            }
+        }
+        if (this.allStoriesPassed()) {
+            await this.runDeslopPass();
+            this.prd.deslopPassed = true;
+        }
+        this.prd.iterations = this.currentIteration;
+        return this.prd;
+    }
+    async executeStory(story) {
+        this.eventBus.emit('ralph.story.start', { storyId: story.id });
+        const result = await this.executor.execute(story);
+        const verifications = await this.verifier.verify(story, result);
+        story.verificationResults = verifications;
+        story.passes = verifications.every(v => v.passed);
+        this.eventBus.emit('ralph.story.end', { storyId: story.id, passed: story.passes });
+    }
+    allStoriesPassed() {
+        return this.prd?.userStories.every(s => s.passes) ?? false;
+    }
+    async runDeslopPass() {
+        this.eventBus.emit('ralph.deslop.start', {});
+        // AI slop cleanup logic
+        this.eventBus.emit('ralph.deslop.end', {});
+    }
+    generateDeliveryReport() {
+        if (!this.prd)
+            return 'No PRD available';
+        const delivery = new HonestDelivery();
+        this.prd.userStories.forEach(s => {
+            if (s.passes) {
+                delivery.addCompleted(s.title);
+                s.verificationResults.forEach(v => delivery.addVerified(v));
+            }
+            else {
+                delivery.addBlocker(`Story ${s.id} not passed`);
+            }
+        });
+        return delivery.formatReport(delivery.generate());
+    }
+    getProgress() {
+        if (!this.prd)
+            return { total: 0, passed: 0, pending: 0 };
+        const total = this.prd.userStories.length;
+        const passed = this.prd.userStories.filter(s => s.passes).length;
+        return { total, passed, pending: total - passed };
+    }
+}
+class DefaultStoryExecutor {
+    async execute(story) {
+        return { executed: true, storyId: story.id };
+    }
+}
+class DefaultStoryVerifier {
+    async verify(story, _result) {
+        return story.acceptanceCriteria.map(criterion => ({
+            criterion,
+            passed: true,
+            evidence: 'Verified by default verifier'
+        }));
+    }
+}
+export class PRDManager {
+    constructor() {
+        this.prds = new Map();
+    }
+    createPRD(title, stories) {
+        const prd = {
+            id: `prd-${Date.now()}`,
+            title,
+            userStories: stories,
+            allStoriesPassed: false,
+            deslopPassed: false,
+            iterations: 0
+        };
+        this.prds.set(prd.id, prd);
+        return prd;
+    }
+    getPRD(id) {
+        return this.prds.get(id);
+    }
+    updatePRD(id, updates) {
+        const prd = this.prds.get(id);
+        if (prd) {
+            Object.assign(prd, updates);
+        }
+        return prd;
+    }
+    listPRDs() {
+        return Array.from(this.prds.values());
+    }
+}
+//# sourceMappingURL=RalphEngine.js.map

package/dist/workflow/execution/RalphEngine.js.map

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