@hongmaple0820/scale-engine 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/README.en.md +237 -0
  2. package/README.md +111 -50
  3. package/dist/adapters/ClaudeCodeAdapter.d.ts +2 -0
  4. package/dist/adapters/ClaudeCodeAdapter.js +5 -0
  5. package/dist/adapters/ClaudeCodeAdapter.js.map +1 -1
  6. package/dist/adapters/CodexAdapter.d.ts +1 -0
  7. package/dist/adapters/CodexAdapter.js +5 -0
  8. package/dist/adapters/CodexAdapter.js.map +1 -1
  9. package/dist/adapters/GeminiAdapter.d.ts +1 -0
  10. package/dist/adapters/GeminiAdapter.js +4 -0
  11. package/dist/adapters/GeminiAdapter.js.map +1 -1
  12. package/dist/adapters/HermesAdapter.d.ts +1 -0
  13. package/dist/adapters/HermesAdapter.js +4 -0
  14. package/dist/adapters/HermesAdapter.js.map +1 -1
  15. package/dist/adapters/OpenClawAdapter.d.ts +1 -0
  16. package/dist/adapters/OpenClawAdapter.js +4 -0
  17. package/dist/adapters/OpenClawAdapter.js.map +1 -1
  18. package/dist/adapters/QCoderAdapter.d.ts +1 -0
  19. package/dist/adapters/QCoderAdapter.js +4 -0
  20. package/dist/adapters/QCoderAdapter.js.map +1 -1
  21. package/dist/adapters/TraeAdapter.d.ts +1 -0
  22. package/dist/adapters/TraeAdapter.js +4 -0
  23. package/dist/adapters/TraeAdapter.js.map +1 -1
  24. package/dist/adapters/VSCAdapter.d.ts +1 -0
  25. package/dist/adapters/VSCAdapter.js +4 -0
  26. package/dist/adapters/VSCAdapter.js.map +1 -1
  27. package/dist/adapters/WorkBuddyAdapter.d.ts +1 -0
  28. package/dist/adapters/WorkBuddyAdapter.js +4 -0
  29. package/dist/adapters/WorkBuddyAdapter.js.map +1 -1
  30. package/dist/agents/AgentSourceLoader.js +1 -1
  31. package/dist/agents/AgentSourceLoader.js.map +1 -1
  32. package/dist/agents/types.d.ts +1 -1
  33. package/dist/api/cli.js +236 -5
  34. package/dist/api/cli.js.map +1 -1
  35. package/dist/api/quickstart.d.ts +23 -0
  36. package/dist/api/quickstart.js +57 -0
  37. package/dist/api/quickstart.js.map +1 -0
  38. package/dist/artifact/types.d.ts +9 -1
  39. package/dist/artifact/types.js.map +1 -1
  40. package/dist/capabilities/BrowserCapability.d.ts +30 -0
  41. package/dist/capabilities/BrowserCapability.js +73 -0
  42. package/dist/capabilities/BrowserCapability.js.map +1 -0
  43. package/dist/capabilities/CapabilityRegistry.d.ts +17 -0
  44. package/dist/capabilities/CapabilityRegistry.js +65 -0
  45. package/dist/capabilities/CapabilityRegistry.js.map +1 -0
  46. package/dist/capabilities/ComputerCapability.d.ts +28 -0
  47. package/dist/capabilities/ComputerCapability.js +40 -0
  48. package/dist/capabilities/ComputerCapability.js.map +1 -0
  49. package/dist/capabilities/InstalledSkillsIntegration.d.ts +66 -0
  50. package/dist/capabilities/InstalledSkillsIntegration.js +188 -0
  51. package/dist/capabilities/InstalledSkillsIntegration.js.map +1 -0
  52. package/dist/capabilities/SearchCapability.d.ts +46 -0
  53. package/dist/capabilities/SearchCapability.js +88 -0
  54. package/dist/capabilities/SearchCapability.js.map +1 -0
  55. package/dist/capabilities/index.d.ts +6 -0
  56. package/dist/capabilities/index.js +9 -0
  57. package/dist/capabilities/index.js.map +1 -0
  58. package/dist/capabilities/types.d.ts +92 -0
  59. package/dist/capabilities/types.js +7 -0
  60. package/dist/capabilities/types.js.map +1 -0
  61. package/dist/cli/liteCommands.d.ts +81 -0
  62. package/dist/cli/liteCommands.js +148 -0
  63. package/dist/cli/liteCommands.js.map +1 -0
  64. package/dist/cli/phaseCommands.d.ts +159 -0
  65. package/dist/cli/phaseCommands.js +826 -0
  66. package/dist/cli/phaseCommands.js.map +1 -0
  67. package/dist/core/logger.js +9 -2
  68. package/dist/core/logger.js.map +1 -1
  69. package/dist/hooks/HookGeneratorEnhanced.js +84 -5
  70. package/dist/hooks/HookGeneratorEnhanced.js.map +1 -1
  71. package/dist/hooks/WorkflowHooksManager.d.ts +30 -0
  72. package/dist/hooks/WorkflowHooksManager.js +117 -0
  73. package/dist/hooks/WorkflowHooksManager.js.map +1 -0
  74. package/dist/hooks/index.d.ts +2 -0
  75. package/dist/hooks/index.js +2 -1
  76. package/dist/hooks/index.js.map +1 -1
  77. package/dist/skills/SkillDiscovery.d.ts +27 -1
  78. package/dist/skills/SkillDiscovery.js +106 -11
  79. package/dist/skills/SkillDiscovery.js.map +1 -1
  80. package/dist/skills/SkillExecutor.d.ts +11 -1
  81. package/dist/skills/SkillExecutor.js +160 -5
  82. package/dist/skills/SkillExecutor.js.map +1 -1
  83. package/dist/workflow/EvidenceStore.d.ts +20 -0
  84. package/dist/workflow/EvidenceStore.js +48 -0
  85. package/dist/workflow/EvidenceStore.js.map +1 -0
  86. package/dist/workflow/ReviewAnalyzer.d.ts +28 -0
  87. package/dist/workflow/ReviewAnalyzer.js +80 -0
  88. package/dist/workflow/ReviewAnalyzer.js.map +1 -0
  89. package/dist/workflow/ReviewStore.d.ts +32 -0
  90. package/dist/workflow/ReviewStore.js +42 -0
  91. package/dist/workflow/ReviewStore.js.map +1 -0
  92. package/dist/workflow/VerificationCommands.d.ts +19 -0
  93. package/dist/workflow/VerificationCommands.js +123 -0
  94. package/dist/workflow/VerificationCommands.js.map +1 -0
  95. package/dist/workflow/WorkflowEngine.d.ts +62 -0
  96. package/dist/workflow/WorkflowEngine.js +151 -0
  97. package/dist/workflow/WorkflowEngine.js.map +1 -0
  98. package/dist/workflow/cognitive/AmbiguityScorer.d.ts +17 -0
  99. package/dist/workflow/cognitive/AmbiguityScorer.js +107 -0
  100. package/dist/workflow/cognitive/AmbiguityScorer.js.map +1 -0
  101. package/dist/workflow/cognitive/ConsensusPlanner.d.ts +26 -0
  102. package/dist/workflow/cognitive/ConsensusPlanner.js +141 -0
  103. package/dist/workflow/cognitive/ConsensusPlanner.js.map +1 -0
  104. package/dist/workflow/cognitive/SocraticQuestioner.d.ts +33 -0
  105. package/dist/workflow/cognitive/SocraticQuestioner.js +276 -0
  106. package/dist/workflow/cognitive/SocraticQuestioner.js.map +1 -0
  107. package/dist/workflow/execution/RalphEngine.d.ts +36 -0
  108. package/dist/workflow/execution/RalphEngine.js +123 -0
  109. package/dist/workflow/execution/RalphEngine.js.map +1 -0
  110. package/dist/workflow/execution/UltraworkEngine.d.ts +43 -0
  111. package/dist/workflow/execution/UltraworkEngine.js +135 -0
  112. package/dist/workflow/execution/UltraworkEngine.js.map +1 -0
  113. package/dist/workflow/gates/GateSystem.d.ts +104 -0
  114. package/dist/workflow/gates/GateSystem.js +579 -0
  115. package/dist/workflow/gates/GateSystem.js.map +1 -0
  116. package/dist/workflow/index.d.ts +12 -0
  117. package/dist/workflow/index.js +14 -0
  118. package/dist/workflow/index.js.map +1 -0
  119. package/dist/workflow/quality/HonestDelivery.d.ts +19 -0
  120. package/dist/workflow/quality/HonestDelivery.js +77 -0
  121. package/dist/workflow/quality/HonestDelivery.js.map +1 -0
  122. package/dist/workflow/quality/KarpathyEvaluator.d.ts +18 -0
  123. package/dist/workflow/quality/KarpathyEvaluator.js +76 -0
  124. package/dist/workflow/quality/KarpathyEvaluator.js.map +1 -0
  125. package/dist/workflow/types.d.ts +139 -0
  126. package/dist/workflow/types.js +4 -0
  127. package/dist/workflow/types.js.map +1 -0
  128. package/dist/workflows/DAGBuilder.js +1 -1
  129. package/dist/workflows/DAGBuilder.js.map +1 -1
  130. package/dist/workflows/WorkflowOrchestrator.js +1 -1
  131. package/dist/workflows/WorkflowOrchestrator.js.map +1 -1
  132. package/dist/workflows/index.js +1 -1
  133. package/dist/workflows/index.js.map +1 -1
  134. package/package.json +2 -2
@@ -0,0 +1,107 @@
1
+ // SCALE Engine - Ambiguity Scorer
2
+ // Requirement ambiguity scorer with seven weighted dimensions.
3
+ const WEIGHTS = {
4
+ goalClarity: 0.20,
5
+ inputOutputBoundary: 0.15,
6
+ techStackConstraints: 0.15,
7
+ timeConstraints: 0.10,
8
+ qualityStandards: 0.15,
9
+ riskBoundaries: 0.10,
10
+ acceptanceCriteria: 0.15
11
+ };
12
+ export class AmbiguityScorer {
13
+ constructor() {
14
+ this.dimensions = {
15
+ goalClarity: 0,
16
+ inputOutputBoundary: 0,
17
+ techStackConstraints: 0,
18
+ timeConstraints: 0,
19
+ qualityStandards: 0,
20
+ riskBoundaries: 0,
21
+ acceptanceCriteria: 0
22
+ };
23
+ this.threshold = 0.20;
24
+ }
25
+ setThreshold(value) {
26
+ this.threshold = value;
27
+ }
28
+ setGoalClarity(score) {
29
+ this.dimensions.goalClarity = Math.max(0, Math.min(1, score));
30
+ }
31
+ setInputOutputBoundary(score) {
32
+ this.dimensions.inputOutputBoundary = Math.max(0, Math.min(1, score));
33
+ }
34
+ setTechStackConstraints(score) {
35
+ this.dimensions.techStackConstraints = Math.max(0, Math.min(1, score));
36
+ }
37
+ setTimeConstraints(score) {
38
+ this.dimensions.timeConstraints = Math.max(0, Math.min(1, score));
39
+ }
40
+ setQualityStandards(score) {
41
+ this.dimensions.qualityStandards = Math.max(0, Math.min(1, score));
42
+ }
43
+ setRiskBoundaries(score) {
44
+ this.dimensions.riskBoundaries = Math.max(0, Math.min(1, score));
45
+ }
46
+ setAcceptanceCriteria(score) {
47
+ this.dimensions.acceptanceCriteria = Math.max(0, Math.min(1, score));
48
+ }
49
+ calculate() {
50
+ const totalScore = this.calculateWeightedSum();
51
+ const shouldProceed = totalScore <= this.threshold;
52
+ const requiresQuestioning = totalScore > this.threshold && totalScore <= 0.40;
53
+ const blocked = totalScore > 0.40;
54
+ return {
55
+ totalScore,
56
+ dimensions: this.dimensions,
57
+ threshold: this.threshold,
58
+ shouldProceed,
59
+ requiresQuestioning,
60
+ blocked
61
+ };
62
+ }
63
+ calculateWeightedSum() {
64
+ return (this.dimensions.goalClarity * WEIGHTS.goalClarity +
65
+ this.dimensions.inputOutputBoundary * WEIGHTS.inputOutputBoundary +
66
+ this.dimensions.techStackConstraints * WEIGHTS.techStackConstraints +
67
+ this.dimensions.timeConstraints * WEIGHTS.timeConstraints +
68
+ this.dimensions.qualityStandards * WEIGHTS.qualityStandards +
69
+ this.dimensions.riskBoundaries * WEIGHTS.riskBoundaries +
70
+ this.dimensions.acceptanceCriteria * WEIGHTS.acceptanceCriteria);
71
+ }
72
+ analyzeRequirement(requirement) {
73
+ // Simple heuristic analysis
74
+ const normalized = requirement.toLowerCase();
75
+ const hasAny = (keywords) => keywords.some(keyword => normalized.includes(keyword.toLowerCase()));
76
+ const hasGoal = hasAny(['implement', 'build', 'create', 'deliver', '实现', '完成', '构建']);
77
+ const hasInput = hasAny(['input', 'receive', 'accept', 'argument', '输入', '接收', '参数']);
78
+ const hasOutput = hasAny(['output', 'return', 'persist', 'emit', '输出', '返回', '持久化']);
79
+ const hasTech = hasAny(['react', 'typescript', 'node', 'cli', 'vitest', '技术栈', '使用']);
80
+ const hasTime = hasAny(['deadline', 'time', 'duration', 'today', '期限', '时间']);
81
+ const hasQuality = hasAny(['quality', 'standard', 'performance', 'lint', 'typecheck', '质量', '标准', '性能']);
82
+ const hasRisk = hasAny(['risk', 'boundary', 'constraint', 'rollback', '风险', '边界', '约束', '回滚']);
83
+ const hasAcceptance = hasAny(['acceptance', 'test', 'verify', 'verification', 'evidence', '验收', '测试', '验证']);
84
+ this.setGoalClarity(hasGoal ? 0.1 : 0.8);
85
+ this.setInputOutputBoundary((hasInput && hasOutput) ? 0.1 : 0.7);
86
+ this.setTechStackConstraints(hasTech ? 0.1 : 0.6);
87
+ this.setTimeConstraints(hasTime ? 0.1 : 0.5);
88
+ this.setQualityStandards(hasQuality ? 0.1 : 0.6);
89
+ this.setRiskBoundaries(hasRisk ? 0.1 : 0.7);
90
+ this.setAcceptanceCriteria(hasAcceptance ? 0.1 : 0.8);
91
+ return this.calculate();
92
+ }
93
+ formatReport(result) {
94
+ const lines = ['=== Ambiguity Score Report ==='];
95
+ lines.push(`Total Score: ${result.totalScore.toFixed(2)} (threshold: ${result.threshold})`);
96
+ lines.push('');
97
+ lines.push('Dimensions:');
98
+ Object.entries(result.dimensions).forEach(([key, value]) => {
99
+ const weight = WEIGHTS[key];
100
+ lines.push(` ${key}: ${value.toFixed(2)} (weight: ${weight})`);
101
+ });
102
+ lines.push('');
103
+ lines.push(`Status: ${result.blocked ? 'BLOCKED' : result.requiresQuestioning ? 'QUESTIONING REQUIRED' : 'PROCEED'}`);
104
+ return lines.join('\n');
105
+ }
106
+ }
107
+ //# sourceMappingURL=AmbiguityScorer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AmbiguityScorer.js","sourceRoot":"","sources":["../../../src/workflow/cognitive/AmbiguityScorer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import type { IEventBus } from '../../core/eventBus.js';
2
+ import type { RALPLANOutput, ConsensusRound } from '../types.js';
3
+ export interface IConsensusRole {
4
+ name: string;
5
+ process(input: string): Promise<string>;
6
+ }
7
+ export declare class ConsensusPlanner {
8
+ private eventBus;
9
+ private maxIterations;
10
+ private rounds;
11
+ private planner;
12
+ private architect;
13
+ private critic;
14
+ constructor(eventBus: IEventBus);
15
+ setMaxIterations(n: number): void;
16
+ execute(requirement: string): Promise<RALPLANOutput>;
17
+ private evaluateVerdict;
18
+ private synthesizeFeedback;
19
+ private generateRALPLANOutput;
20
+ private extractPrinciples;
21
+ private extractDrivers;
22
+ private extractOptions;
23
+ private extractPreMortem;
24
+ getRounds(): ConsensusRound[];
25
+ formatReport(output: RALPLANOutput): string;
26
+ }
@@ -0,0 +1,141 @@
1
+ // SCALE Engine — Consensus Planner
2
+ // 共识规划引擎 (三角色循环: Planner -> Architect -> Critic)
3
+ export class ConsensusPlanner {
4
+ constructor(eventBus) {
5
+ this.maxIterations = 5;
6
+ this.rounds = [];
7
+ this.eventBus = eventBus;
8
+ this.planner = new PlannerRole();
9
+ this.architect = new ArchitectRole();
10
+ this.critic = new CriticRole();
11
+ }
12
+ setMaxIterations(n) {
13
+ this.maxIterations = n;
14
+ }
15
+ async execute(requirement) {
16
+ this.rounds = [];
17
+ let currentInput = requirement;
18
+ let verdict = 'ITERATE';
19
+ let iterationCount = 0;
20
+ while (verdict === 'ITERATE' && iterationCount < this.maxIterations) {
21
+ iterationCount++;
22
+ const plannerOutput = await this.planner.process(currentInput);
23
+ const architectReview = await this.architect.process(plannerOutput);
24
+ const criticReview = await this.critic.process(architectReview);
25
+ verdict = this.evaluateVerdict(plannerOutput, architectReview, criticReview);
26
+ const round = {
27
+ round: iterationCount,
28
+ plannerOutput,
29
+ architectReview,
30
+ criticReview,
31
+ verdict
32
+ };
33
+ this.rounds.push(round);
34
+ this.eventBus.emit('consensus.round', round);
35
+ if (verdict === 'ITERATE') {
36
+ currentInput = this.synthesizeFeedback(plannerOutput, architectReview, criticReview);
37
+ }
38
+ }
39
+ return this.generateRALPLANOutput(verdict, iterationCount);
40
+ }
41
+ evaluateVerdict(planner, architect, critic) {
42
+ const architectApproved = architect.includes('APPROVE') || architect.includes('可行');
43
+ const criticApproved = critic.includes('APPROVE') || critic.includes('无风险');
44
+ const hasBlockingIssues = critic.includes('BLOCK') || critic.includes('CRITICAL');
45
+ if (hasBlockingIssues)
46
+ return 'REJECT';
47
+ if (architectApproved && criticApproved)
48
+ return 'APPROVE';
49
+ return 'ITERATE';
50
+ }
51
+ synthesizeFeedback(planner, architect, critic) {
52
+ return `Previous Plan:\n${planner}\n\nArchitect Feedback:\n${architect}\n\nCritic Concerns:\n${critic}\n\nPlease revise the plan addressing all concerns.`;
53
+ }
54
+ generateRALPLANOutput(verdict, iterations) {
55
+ const lastRound = this.rounds[this.rounds.length - 1];
56
+ return {
57
+ principles: this.extractPrinciples(lastRound?.plannerOutput || ''),
58
+ decisionDrivers: this.extractDrivers(lastRound?.architectReview || ''),
59
+ viableOptions: this.extractOptions(lastRound?.plannerOutput || ''),
60
+ preMortem: this.extractPreMortem(lastRound?.criticReview || ''),
61
+ verdict,
62
+ iterationCount: iterations
63
+ };
64
+ }
65
+ extractPrinciples(text) {
66
+ const match = text.match(/原则[::]\s*([\s\S]*?)(?=驱动|$)/);
67
+ if (match) {
68
+ return match[1].split('\n').map(s => s.trim()).filter(s => s.length > 0);
69
+ }
70
+ return ['可维护性优先', '渐进式实现', '测试驱动'];
71
+ }
72
+ extractDrivers(text) {
73
+ const match = text.match(/驱动[::]\s*([\s\S]*?)(?=方案|$)/);
74
+ if (match) {
75
+ return match[1].split('\n').map(s => s.trim()).filter(s => s.length > 0).slice(0, 3);
76
+ }
77
+ return ['性能要求', '安全约束', '向下兼容'];
78
+ }
79
+ extractOptions(text) {
80
+ return [
81
+ { name: '方案A', description: '标准实现路径', pros: ['稳定'], cons: ['慢'], selected: true },
82
+ { name: '方案B', description: '快速实现路径', pros: ['快'], cons: ['风险高'], selected: false }
83
+ ];
84
+ }
85
+ extractPreMortem(text) {
86
+ return {
87
+ assumedFailure: '实现超时',
88
+ rootCauses: ['技术债务', '需求变更'],
89
+ mitigations: ['增量交付', '及时沟通']
90
+ };
91
+ }
92
+ getRounds() {
93
+ return this.rounds;
94
+ }
95
+ formatReport(output) {
96
+ const lines = ['=== RALPLAN-DR Report ==='];
97
+ lines.push(`Verdict: ${output.verdict} (${output.iterationCount} iterations)`);
98
+ lines.push('');
99
+ lines.push('Principles:');
100
+ output.principles.forEach(p => lines.push(` - ${p}`));
101
+ lines.push('');
102
+ lines.push('Decision Drivers (Top 3):');
103
+ output.decisionDrivers.forEach(d => lines.push(` - ${d}`));
104
+ lines.push('');
105
+ lines.push('Viable Options:');
106
+ output.viableOptions.forEach(o => {
107
+ lines.push(` ${o.selected ? '[SELECTED]' : '[ALT]'} ${o.name}: ${o.description}`);
108
+ });
109
+ lines.push('');
110
+ lines.push('Pre-Mortem Analysis:');
111
+ lines.push(` Assumed Failure: ${output.preMortem.assumedFailure}`);
112
+ lines.push(` Root Causes: ${output.preMortem.rootCauses.join(', ')}`);
113
+ lines.push(` Mitigations: ${output.preMortem.mitigations.join(', ')}`);
114
+ return lines.join('\n');
115
+ }
116
+ }
117
+ class PlannerRole {
118
+ constructor() {
119
+ this.name = 'Planner';
120
+ }
121
+ async process(input) {
122
+ return `Plan for: ${input}\n\n原则:\n- 渐进式实现\n- 测试驱动\n- 最小变更\n\n驱动因素:\n1. 用户需求\n2. 技术约束\n3. 时间限制\n\n方案A:标准路径(推荐)\n方案B:快速路径`;
123
+ }
124
+ }
125
+ class ArchitectRole {
126
+ constructor() {
127
+ this.name = 'Architect';
128
+ }
129
+ async process(input) {
130
+ return `Architecture Review:\n\nAPPROVE - 技术可行性确认\n\n架构建议:\n- 模块化设计\n- 接口抽象\n- 依赖隔离`;
131
+ }
132
+ }
133
+ class CriticRole {
134
+ constructor() {
135
+ this.name = 'Critic';
136
+ }
137
+ async process(input) {
138
+ return `Critical Review:\n\n风险评估:\n- 性能瓶颈:中等风险\n- 安全隐患:低风险\n- 兼容性问题:需关注\n\nAPPROVE - 无阻断性风险`;
139
+ }
140
+ }
141
+ //# sourceMappingURL=ConsensusPlanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ConsensusPlanner.js","sourceRoot":"","sources":["../../../src/workflow/cognitive/ConsensusPlanner.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,iDAAiD;AAUjD,MAAM,OAAO,gBAAgB;IAQ3B,YAAY,QAAmB;QANvB,kBAAa,GAAW,CAAC,CAAA;QACzB,WAAM,GAAqB,EAAE,CAAA;QAMnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,EAAE,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,EAAE,CAAA;IAChC,CAAC;IAED,gBAAgB,CAAC,CAAS;QACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,YAAY,GAAG,WAAW,CAAA;QAC9B,IAAI,OAAO,GAAY,SAAS,CAAA;QAChC,IAAI,cAAc,GAAG,CAAC,CAAA;QAEtB,OAAO,OAAO,KAAK,SAAS,IAAI,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACpE,cAAc,EAAE,CAAA;YAChB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;YAC9D,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;YACnE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;YAC/D,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,CAAC,CAAA;YAE5E,MAAM,KAAK,GAAmB;gBAC5B,KAAK,EAAE,cAAc;gBACrB,aAAa;gBACb,eAAe;gBACf,YAAY;gBACZ,OAAO;aACR,CAAA;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;YAE5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,CAAC,CAAA;YACtF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IAC5D,CAAC;IAEO,eAAe,CAAC,OAAe,EAAE,SAAiB,EAAE,MAAc;QACxE,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACnF,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QAEjF,IAAI,iBAAiB;YAAE,OAAO,QAAQ,CAAA;QACtC,IAAI,iBAAiB,IAAI,cAAc;YAAE,OAAO,SAAS,CAAA;QACzD,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,kBAAkB,CAAC,OAAe,EAAE,SAAiB,EAAE,MAAc;QAC3E,OAAO,mBAAmB,OAAO,4BAA4B,SAAS,yBAAyB,MAAM,qDAAqD,CAAA;IAC5J,CAAC;IAEO,qBAAqB,CAAC,OAAgB,EAAE,UAAkB;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACrD,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC;YAClE,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,eAAe,IAAI,EAAE,CAAC;YACtE,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC;YAClE,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC;YAC/D,OAAO;YACP,cAAc,EAAE,UAAU;SAC3B,CAAA;IACH,CAAC;IAEO,iBAAiB,CAAC,IAAY;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACtF,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,OAAO;YACL,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;YACjF,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;SACpF,CAAA;IACH,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACnC,OAAO;YACL,cAAc,EAAE,MAAM;YACtB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;YAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC9B,CAAA;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,YAAY,CAAC,MAAqB;QAChC,MAAM,KAAK,GAAa,CAAC,2BAA2B,CAAC,CAAA;QACrD,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,cAAc,cAAc,CAAC,CAAA;QAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACzB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACvC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC7B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;QACpF,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAClC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAA;QACnE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACtE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,WAAW;IAAjB;QACE,SAAI,GAAG,SAAS,CAAA;IAKlB,CAAC;IAHC,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,OAAO,aAAa,KAAK,gGAAgG,CAAA;IAC3H,CAAC;CACF;AAED,MAAM,aAAa;IAAnB;QACE,SAAI,GAAG,WAAW,CAAA;IAKpB,CAAC;IAHC,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,OAAO,6EAA6E,CAAA;IACtF,CAAC;CACF;AAED,MAAM,UAAU;IAAhB;QACE,SAAI,GAAG,QAAQ,CAAA;IAKjB,CAAC;IAHC,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,OAAO,qFAAqF,CAAA;IAC9F,CAAC;CACF"}
@@ -0,0 +1,33 @@
1
+ import type { IEventBus } from '../../core/eventBus.js';
2
+ import type { AmbiguityScoreResult, SocraticQuestion, SocraticSession } from '../types.js';
3
+ export interface ISocraticQuestioner {
4
+ startSession(requirement: string, ambiguityResult: AmbiguityScoreResult): SocraticSession;
5
+ askNextQuestion(session: SocraticSession): SocraticQuestion | null;
6
+ recordAnswer(sessionId: string, questionId: string, answer: string): void;
7
+ evaluateProgress(session: SocraticSession): {
8
+ refined: boolean;
9
+ newAmbiguity: number;
10
+ };
11
+ shouldBlock(session: SocraticSession): boolean;
12
+ generateRefinedRequirement(session: SocraticSession): string;
13
+ }
14
+ export declare class SocraticQuestioner implements ISocraticQuestioner {
15
+ private eventBus;
16
+ private sessions;
17
+ private maxRounds;
18
+ constructor(eventBus: IEventBus);
19
+ startSession(requirement: string, ambiguityResult: AmbiguityScoreResult): SocraticSession;
20
+ askNextQuestion(session: SocraticSession): SocraticQuestion | null;
21
+ recordAnswer(sessionId: string, questionId: string, answer: string): void;
22
+ evaluateProgress(session: SocraticSession): {
23
+ refined: boolean;
24
+ newAmbiguity: number;
25
+ };
26
+ shouldBlock(session: SocraticSession): boolean;
27
+ generateRefinedRequirement(session: SocraticSession): string;
28
+ getSession(sessionId: string): SocraticSession | undefined;
29
+ formatSessionReport(session: SocraticSession): string;
30
+ private getQuestionPriority;
31
+ private evaluateAnswerClarity;
32
+ private generateFollowUp;
33
+ }
@@ -0,0 +1,276 @@
1
+ // SCALE Engine — Socratic Questioner
2
+ // 苏格拉底提问器 - 需求精炼 (六问重构框架)
3
+ // 来源借鉴: OMC deep-interview + gstack office-hours
4
+ // 六问重构框架
5
+ const SIX_QUESTIONS = [
6
+ {
7
+ id: 'q-goal',
8
+ category: 'goal',
9
+ question: '你想要达成什么具体结果?请描述期望的最终状态。',
10
+ followUps: [
11
+ '这个结果是否可量化?',
12
+ '达成后用户会如何使用?',
13
+ '有没有参考案例?'
14
+ ],
15
+ answered: false,
16
+ clarityScore: 0
17
+ },
18
+ {
19
+ id: 'q-constraint',
20
+ category: 'constraint',
21
+ question: '有哪些不可逾越的边界?包括技术、时间、资源限制。',
22
+ followUps: [
23
+ '技术栈是否已确定?',
24
+ '有固定的截止日期吗?',
25
+ '预算/人力约束是什么?'
26
+ ],
27
+ answered: false,
28
+ clarityScore: 0
29
+ },
30
+ {
31
+ id: 'q-acceptance',
32
+ category: 'acceptance',
33
+ question: '如何验证成功?请给出可测试的验收标准。',
34
+ followUps: [
35
+ '能否用具体指标描述?',
36
+ '用户如何确认满足需求?',
37
+ '最小可接受标准是什么?'
38
+ ],
39
+ answered: false,
40
+ clarityScore: 0
41
+ },
42
+ {
43
+ id: 'q-context',
44
+ category: 'context',
45
+ question: '现有系统/依赖有哪些需要兼容?',
46
+ followUps: [
47
+ '是否需要向下兼容?',
48
+ '有哪些现有接口需要保持?',
49
+ '数据迁移需求?'
50
+ ],
51
+ answered: false,
52
+ clarityScore: 0
53
+ },
54
+ {
55
+ id: 'q-risk',
56
+ category: 'risk',
57
+ question: '最可能的2种失败场景是什么?',
58
+ followUps: [
59
+ '如果数据丢失会怎样?',
60
+ '如果性能下降会怎样?',
61
+ '回滚方案是什么?'
62
+ ],
63
+ answered: false,
64
+ clarityScore: 0
65
+ },
66
+ {
67
+ id: 'q-priority',
68
+ category: 'priority',
69
+ question: '如果只能完成一半,哪些必须先做?',
70
+ followUps: [
71
+ '核心功能是什么?',
72
+ '哪些可以后续迭代?',
73
+ 'MVP 定义是什么?'
74
+ ],
75
+ answered: false,
76
+ clarityScore: 0
77
+ }
78
+ ];
79
+ export class SocraticQuestioner {
80
+ constructor(eventBus) {
81
+ this.sessions = new Map();
82
+ this.maxRounds = 3;
83
+ this.eventBus = eventBus;
84
+ }
85
+ startSession(requirement, ambiguityResult) {
86
+ const sessionId = `socratic-${Date.now()}`;
87
+ const session = {
88
+ sessionId,
89
+ requirement,
90
+ initialAmbiguity: ambiguityResult,
91
+ questions: SIX_QUESTIONS.map(q => ({ ...q, clarityScore: 0 })),
92
+ currentRound: 0,
93
+ maxRounds: this.maxRounds,
94
+ status: 'in_progress',
95
+ refinementHistory: []
96
+ };
97
+ this.sessions.set(sessionId, session);
98
+ this.eventBus.emit('socratic.session.started', { sessionId, initialAmbiguity: ambiguityResult.totalScore });
99
+ return session;
100
+ }
101
+ askNextQuestion(session) {
102
+ if (session.status !== 'in_progress')
103
+ return null;
104
+ // 找到未回答的最高优先级问题
105
+ const unanswered = session.questions
106
+ .filter(q => !q.answered)
107
+ .sort((a, b) => this.getQuestionPriority(a) - this.getQuestionPriority(b));
108
+ if (unanswered.length === 0) {
109
+ // 所有问题已回答,评估是否需要继续
110
+ const progress = this.evaluateProgress(session);
111
+ if (progress.refined) {
112
+ session.status = 'refined';
113
+ return null;
114
+ }
115
+ // 需要深入追问
116
+ return this.generateFollowUp(session);
117
+ }
118
+ return unanswered[0];
119
+ }
120
+ recordAnswer(sessionId, questionId, answer) {
121
+ const session = this.sessions.get(sessionId);
122
+ if (!session)
123
+ return;
124
+ const question = session.questions.find(q => q.id === questionId);
125
+ if (!question)
126
+ return;
127
+ question.answered = true;
128
+ question.answer = answer;
129
+ question.clarityScore = this.evaluateAnswerClarity(answer);
130
+ this.eventBus.emit('socratic.answer.recorded', { sessionId, questionId, clarityScore: question.clarityScore });
131
+ }
132
+ evaluateProgress(session) {
133
+ const answeredCount = session.questions.filter(q => q.answered).length;
134
+ const totalClarity = session.questions.reduce((sum, q) => sum + q.clarityScore, 0);
135
+ const avgClarity = answeredCount > 0 ? totalClarity / answeredCount : 0;
136
+ // 计算新的模糊度
137
+ const initialAmbiguity = session.initialAmbiguity.totalScore;
138
+ const reductionFactor = avgClarity * 0.5; // 每个清晰回答减少最多 50% 模糊度
139
+ const newAmbiguity = Math.max(0.05, initialAmbiguity * (1 - reductionFactor));
140
+ // 记录本轮
141
+ const round = {
142
+ round: session.currentRound + 1,
143
+ questionsAsked: session.questions.filter(q => q.answered).map(q => q.id),
144
+ answersReceived: session.questions.filter(q => q.answered && q.answer).map(q => q.answer || ''),
145
+ ambiguityBefore: session.refinementHistory.length > 0
146
+ ? session.refinementHistory[session.refinementHistory.length - 1].ambiguityAfter
147
+ : initialAmbiguity,
148
+ ambiguityAfter: newAmbiguity
149
+ };
150
+ session.refinementHistory.push(round);
151
+ session.currentRound++;
152
+ const refined = newAmbiguity <= 0.20;
153
+ if (refined) {
154
+ session.status = 'refined';
155
+ session.finalAmbiguity = {
156
+ ...session.initialAmbiguity,
157
+ totalScore: newAmbiguity,
158
+ shouldProceed: true,
159
+ requiresQuestioning: false,
160
+ blocked: false
161
+ };
162
+ }
163
+ return { refined, newAmbiguity };
164
+ }
165
+ shouldBlock(session) {
166
+ // 连续 3 轮仍未达标
167
+ if (session.currentRound >= session.maxRounds && session.status === 'in_progress') {
168
+ session.status = 'blocked';
169
+ this.eventBus.emit('socratic.session.blocked', { sessionId: session.sessionId });
170
+ return true;
171
+ }
172
+ return false;
173
+ }
174
+ generateRefinedRequirement(session) {
175
+ const parts = [];
176
+ // 目标
177
+ const goalQ = session.questions.find(q => q.id === 'q-goal');
178
+ if (goalQ?.answer)
179
+ parts.push(`目标: ${goalQ.answer}`);
180
+ // 约束
181
+ const constraintQ = session.questions.find(q => q.id === 'q-constraint');
182
+ if (constraintQ?.answer)
183
+ parts.push(`约束: ${constraintQ.answer}`);
184
+ // 验收标准
185
+ const acceptanceQ = session.questions.find(q => q.id === 'q-acceptance');
186
+ if (acceptanceQ?.answer)
187
+ parts.push(`验收标准: ${acceptanceQ.answer}`);
188
+ // 上下文
189
+ const contextQ = session.questions.find(q => q.id === 'q-context');
190
+ if (contextQ?.answer)
191
+ parts.push(`上下文: ${contextQ.answer}`);
192
+ // 风险
193
+ const riskQ = session.questions.find(q => q.id === 'q-risk');
194
+ if (riskQ?.answer)
195
+ parts.push(`风险边界: ${riskQ.answer}`);
196
+ // 优先级
197
+ const priorityQ = session.questions.find(q => q.id === 'q-priority');
198
+ if (priorityQ?.answer)
199
+ parts.push(`优先级: ${priorityQ.answer}`);
200
+ return parts.join('\n\n');
201
+ }
202
+ getSession(sessionId) {
203
+ return this.sessions.get(sessionId);
204
+ }
205
+ formatSessionReport(session) {
206
+ const lines = [];
207
+ lines.push('=== Socratic Questioning Report ===');
208
+ lines.push(`Session: ${session.sessionId}`);
209
+ lines.push(`Status: ${session.status}`);
210
+ lines.push(`Rounds: ${session.currentRound}/${session.maxRounds}`);
211
+ lines.push('');
212
+ lines.push(`Initial Ambiguity: ${session.initialAmbiguity.totalScore.toFixed(2)}`);
213
+ if (session.finalAmbiguity) {
214
+ lines.push(`Final Ambiguity: ${session.finalAmbiguity.totalScore.toFixed(2)}`);
215
+ }
216
+ lines.push('');
217
+ lines.push('Questions:');
218
+ session.questions.forEach(q => {
219
+ const status = q.answered ? `[✓]` : `[ ]`;
220
+ lines.push(` ${status} ${q.category}: ${q.question}`);
221
+ if (q.answer) {
222
+ lines.push(` Answer: ${q.answer.slice(0, 100)}...`);
223
+ lines.push(` Clarity: ${q.clarityScore.toFixed(2)}`);
224
+ }
225
+ });
226
+ if (session.status === 'refined') {
227
+ lines.push('');
228
+ lines.push('Refined Requirement:');
229
+ lines.push(this.generateRefinedRequirement(session));
230
+ }
231
+ return lines.join('\n');
232
+ }
233
+ // 私有方法
234
+ getQuestionPriority(question) {
235
+ // 目标 > 验收 > 约束 > 上下文 > 风险 > 优先级
236
+ const priorities = {
237
+ goal: 1,
238
+ acceptance: 2,
239
+ constraint: 3,
240
+ context: 4,
241
+ risk: 5,
242
+ priority: 6
243
+ };
244
+ return priorities[question.category] ?? 7;
245
+ }
246
+ evaluateAnswerClarity(answer) {
247
+ if (!answer || answer.length < 10)
248
+ return 0.2;
249
+ if (answer.length < 30)
250
+ return 0.4;
251
+ if (answer.includes('具体') || answer.includes('明确') || answer.includes('标准'))
252
+ return 0.8;
253
+ if (answer.includes('可能') || answer.includes('也许') || answer.includes('大概'))
254
+ return 0.3;
255
+ return 0.6;
256
+ }
257
+ generateFollowUp(session) {
258
+ // 找到模糊度最高的已回答问题,生成追问
259
+ const lowClarity = session.questions
260
+ .filter(q => q.answered && q.clarityScore < 0.5)
261
+ .sort((a, b) => a.clarityScore - b.clarityScore);
262
+ if (lowClarity.length === 0)
263
+ return null;
264
+ const target = lowClarity[0];
265
+ const followUpIndex = Math.floor(Math.random() * target.followUps.length);
266
+ return {
267
+ id: `${target.id}-follow-${followUpIndex}`,
268
+ category: target.category,
269
+ question: target.followUps[followUpIndex],
270
+ followUps: [],
271
+ answered: false,
272
+ clarityScore: 0
273
+ };
274
+ }
275
+ }
276
+ //# sourceMappingURL=SocraticQuestioner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SocraticQuestioner.js","sourceRoot":"","sources":["../../../src/workflow/cognitive/SocraticQuestioner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import type { IEventBus } from '../../core/eventBus.js';
2
+ import type { PRDDocument, UserStory, VerificationResult } from '../types.js';
3
+ export interface IStoryExecutor {
4
+ execute(story: UserStory): Promise<unknown>;
5
+ }
6
+ export interface IStoryVerifier {
7
+ verify(story: UserStory, result: unknown): Promise<VerificationResult[]>;
8
+ }
9
+ export declare class RalphEngine {
10
+ private eventBus;
11
+ private prd;
12
+ private executor;
13
+ private verifier;
14
+ private maxIterations;
15
+ private currentIteration;
16
+ constructor(eventBus: IEventBus);
17
+ setPRD(prd: PRDDocument): void;
18
+ setMaxIterations(n: number): void;
19
+ run(): Promise<PRDDocument>;
20
+ private executeStory;
21
+ private allStoriesPassed;
22
+ private runDeslopPass;
23
+ generateDeliveryReport(): string;
24
+ getProgress(): {
25
+ total: number;
26
+ passed: number;
27
+ pending: number;
28
+ };
29
+ }
30
+ export declare class PRDManager {
31
+ private prds;
32
+ createPRD(title: string, stories: UserStory[]): PRDDocument;
33
+ getPRD(id: string): PRDDocument | undefined;
34
+ updatePRD(id: string, updates: Partial<PRDDocument>): PRDDocument | undefined;
35
+ listPRDs(): PRDDocument[];
36
+ }