@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/WorkflowEngine.js

@@ -0,0 +1,183 @@
+// SCALE Engine — Workflow Integration
+// 工作流与 CLI/MCP 的集成层
+import { GateSystem } from './gates/GateSystem.js';
+import { AmbiguityScorer } from './cognitive/AmbiguityScorer.js';
+import { ConsensusPlanner } from './cognitive/ConsensusPlanner.js';
+import { SocraticQuestioner } from './cognitive/SocraticQuestioner.js';
+import { RalphEngine, PRDManager } from './execution/RalphEngine.js';
+import { UltraworkEngine, ModelRouter } from './execution/UltraworkEngine.js';
+import { KarpathyEvaluator } from './quality/KarpathyEvaluator.js';
+import { WorkflowArtifactWriter } from './WorkflowArtifactWriter.js';
+export class WorkflowEngine {
+    constructor(config) {
+        this.eventBus = config.eventBus;
+        this.capabilityRegistry = config.capabilityRegistry;
+        this.skillRegistry = config.skillRegistry;
+        // Initialize artifact writer (shared with GateSystem)
+        const scaleDir = config.scaleDir ?? '.scale';
+        this.artifactWriter = new WorkflowArtifactWriter(scaleDir);
+        // Initialize workflow modules
+        this.gateSystem = new GateSystem(this.eventBus, config.verificationCommands, this.artifactWriter);
+        this.ambiguityScorer = new AmbiguityScorer();
+        this.consensusPlanner = new ConsensusPlanner(this.eventBus);
+        this.socraticQuestioner = new SocraticQuestioner(this.eventBus);
+        this.ralphEngine = new RalphEngine(this.eventBus);
+        this.ultraworkEngine = new UltraworkEngine(this.eventBus);
+        this.prdManager = new PRDManager();
+        this.modelRouter = new ModelRouter();
+        this.karpathyEvaluator = new KarpathyEvaluator();
+    }
+    // Phase 1: Exploration with Gate G1
+    async explore(requirement, options = {}) {
+        // Analyze requirement ambiguity
+        const ambiguityResult = this.ambiguityScorer.analyzeRequirement(requirement);
+        // If ambiguity > 20%, start Socratic session
+        let socraticSession = undefined;
+        if (ambiguityResult.requiresQuestioning) {
+            socraticSession = this.socraticQuestioner.startSession(requirement, ambiguityResult);
+        }
+        const files = options.files ?? [];
+        const mainContradiction = options.mainContradiction ?? '';
+        if (options.persistArtifact !== false) {
+            this.artifactWriter.writeExploreResult({
+                timestamp: new Date().toISOString(),
+                files,
+                fileCount: files.length,
+                mainContradiction,
+                ambiguityScore: ambiguityResult.totalScore,
+                socraticCompleted: !ambiguityResult.requiresQuestioning
+            });
+        }
+        const gateResult = options.runGate === false ? undefined : await this.gateSystem.executeGate('G1');
+        return {
+            ambiguityScore: ambiguityResult.totalScore,
+            gateResult,
+            socraticSession
+        };
+    }
+    // Continue Socratic refinement session
+    refineRequirement(session, questionId, answer) {
+        this.socraticQuestioner.recordAnswer(session.sessionId, questionId, answer);
+        const progress = this.socraticQuestioner.evaluateProgress(session);
+        // If refined, generate refined requirement
+        if (progress.refined) {
+            const refined = this.socraticQuestioner.generateRefinedRequirement(session);
+            session.status = 'refined';
+            // Store refined requirement in session
+            if (session.finalAmbiguity) {
+                session.finalAmbiguity.totalScore = progress.newAmbiguity;
+            }
+        }
+        return session;
+    }
+    // Get next question for refinement
+    getNextQuestion(session) {
+        return this.socraticQuestioner.askNextQuestion(session);
+    }
+    // Phase 2: Planning with Consensus
+    async plan(requirement, options = {}) {
+        // Run consensus planner
+        const consensusResult = await this.consensusPlanner.execute(requirement);
+        const planId = options.planId ?? `engine-${Date.now()}`;
+        if (options.persistArtifact !== false) {
+            this.artifactWriter.writePlanResult({
+                timestamp: new Date().toISOString(),
+                planId,
+                specId: options.specId ?? '',
+                hasBoundaryAnalysis: consensusResult.viableOptions.length > 1,
+                hasExceptionHandling: consensusResult.preMortem?.rootCauses?.length > 0,
+                hasRollbackStrategy: Boolean(options.rollbackStrategy),
+                modules: options.modules ?? [],
+                consensusRounds: consensusResult.iterationCount,
+                verdict: consensusResult.verdict
+            });
+        }
+        if (options.runGate !== false && consensusResult.viableOptions.length > 1) {
+            await this.gateSystem.executeGate('G2');
+        }
+        return consensusResult;
+    }
+    // Phase 3: Build with Task orchestration
+    async build(tasks) {
+        this.ultraworkEngine.addTasks(tasks);
+        return await this.ultraworkEngine.executeParallel();
+    }
+    // Phase 4: Verify with build and quality gates
+    async verify(commandOverrides) {
+        if (commandOverrides) {
+            this.gateSystem = new GateSystem(this.eventBus, commandOverrides, this.artifactWriter);
+        }
+        const defaultGates = commandOverrides?.smoke
+            ? ['G8']
+            : ['G3', 'G0', 'G4', 'G5', 'G6', 'G7'];
+        const results = await this.gateSystem.executeAll(commandOverrides?.gates ?? defaultGates);
+        return results;
+    }
+    // Phase 5: PRD-driven execution with Ralph
+    async executePRD(title, stories) {
+        const prd = this.prdManager.createPRD(title, stories);
+        this.ralphEngine.setPRD(prd);
+        return await this.ralphEngine.run();
+    }
+    // Karpathy principles check
+    checkKarpathy(context) {
+        return this.karpathyEvaluator.evaluateAll(context);
+    }
+    // Generate honest delivery report
+    generateDeliveryReport() {
+        return this.ralphEngine.generateDeliveryReport();
+    }
+    // Execute skill (MCP integration)
+    async executeSkill(skillId, input) {
+        if (!this.skillRegistry) {
+            throw new Error('Skill registry not configured');
+        }
+        // This would integrate with SkillExecutor
+        const skill = this.skillRegistry.get(skillId);
+        if (!skill) {
+            throw new Error(`Skill not found: ${skillId}`);
+        }
+        return { skillId, input, status: 'delegated' };
+    }
+    // Execute MCP capability
+    async executeMCPCapability(toolName, input) {
+        if (!this.capabilityRegistry) {
+            throw new Error('Capability registry not configured');
+        }
+        // Route to appropriate capability
+        if (toolName.includes('browser')) {
+            const browser = this.capabilityRegistry.getBrowser();
+            if (!browser)
+                throw new Error('Browser capability not available');
+            return { capability: 'browser', toolName, input };
+        }
+        if (toolName.includes('search') || toolName.includes('fetch')) {
+            const search = this.capabilityRegistry.getSearch();
+            if (!search)
+                throw new Error('Search capability not available');
+            return { capability: 'search', toolName, input };
+        }
+        if (toolName.includes('exa')) {
+            const exa = this.capabilityRegistry.getExa();
+            if (!exa)
+                throw new Error('Exa capability not available');
+            return { capability: 'exa', toolName, input };
+        }
+        throw new Error(`Unknown MCP tool: ${toolName}`);
+    }
+    // Model routing for task execution
+    routeModel(taskType) {
+        return this.modelRouter.route(taskType);
+    }
+    // Getters for individual modules
+    getGates() { return this.gateSystem; }
+    getAmbiguityScorer() { return this.ambiguityScorer; }
+    getConsensusPlanner() { return this.consensusPlanner; }
+    getSocraticQuestioner() { return this.socraticQuestioner; }
+    getRalphEngine() { return this.ralphEngine; }
+    getUltraworkEngine() { return this.ultraworkEngine; }
+    getPRDManager() { return this.prdManager; }
+    getKarpathyEvaluator() { return this.karpathyEvaluator; }
+    getArtifactWriter() { return this.artifactWriter; }
+}
+//# sourceMappingURL=WorkflowEngine.js.map

package/dist/workflow/WorkflowEngine.js.map

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

package/dist/workflow/WorkflowGuidance.d.ts

@@ -0,0 +1,30 @@
+import type { WorkflowTaskLevel } from './WorkflowArtifactWriter.js';
+import type { SkillRole } from '../skills/RoleSkills.js';
+export type WorkflowGuidancePhase = 'explore' | 'plan' | 'build' | 'verify' | 'review' | 'ship';
+export interface WorkflowGuidanceItem {
+    id: string;
+    phase: WorkflowGuidancePhase;
+    required: boolean;
+    reason: string;
+    command: string;
+    role?: SkillRole;
+}
+export interface WorkflowGuidance {
+    taskId: string;
+    level: WorkflowTaskLevel;
+    items: WorkflowGuidanceItem[];
+    requiredCommandCount: number;
+}
+export interface WorkflowGuidanceInput {
+    taskId: string;
+    description: string;
+    level: WorkflowTaskLevel;
+    artifactDir?: string;
+    files?: string[];
+    skillIntents?: string[];
+    requiredSkillVerification?: string[];
+}
+export declare function createWorkflowGuidance(input: WorkflowGuidanceInput): WorkflowGuidance;
+export declare function renderWorkflowGuidance(guidance: WorkflowGuidance): string;
+export declare function getRoleGuidanceForPhase(phase: WorkflowGuidancePhase): SkillRole[];
+export declare function createRoleGuidanceItem(role: SkillRole, phase: WorkflowGuidancePhase, taskId: string, description: string): WorkflowGuidanceItem;

package/dist/workflow/WorkflowGuidance.js

@@ -0,0 +1,204 @@
+const BUG_TERMS = [
+    'bug',
+    'fix',
+    'error',
+    'fail',
+    'failure',
+    '404',
+    '500',
+    'crash',
+    'regression',
+    'exception',
+    '修复',
+    '报错',
+    '失败',
+    '异常',
+    '回归',
+];
+const TOOL_EVIDENCE_DOMAINS = new Set([
+    'ui-ux',
+    'frontend',
+    'browser-automation',
+    'e2e',
+    'visual-qa',
+    'design',
+]);
+export function createWorkflowGuidance(input) {
+    const items = [];
+    const normalizedLevel = input.level;
+    if (normalizedLevel !== 'S') {
+        items.push({
+            id: 'context-grill',
+            phase: 'explore',
+            required: true,
+            reason: 'M/L/CRITICAL work needs current-context alignment before editing.',
+            command: joinCommand([
+                'scale',
+                'context',
+                'grill',
+                '--task-id',
+                input.taskId,
+                '--task',
+                input.description,
+                ...artifactArgs(input.artifactDir),
+                ...filesArgs(input.files),
+                '--write',
+            ]),
+        });
+        if (isBugLike(input.description)) {
+            items.push({
+                id: 'diagnostic-loop',
+                phase: 'plan',
+                required: true,
+                reason: 'Bug work needs a reproducible failure, competing hypotheses, and cleanup/verification commands.',
+                command: joinCommand([
+                    'scale',
+                    'diagnose',
+                    'plan',
+                    '--task-id',
+                    input.taskId,
+                    '--symptom',
+                    input.description,
+                    '--repro',
+                    '<reproduction command>',
+                    '--expected-failure',
+                    '<expected failure>',
+                    ...artifactArgs(input.artifactDir),
+                    ...filesArgs(input.files),
+                    '--write',
+                ]),
+            });
+        }
+        items.push({
+            id: 'tdd-slice',
+            phase: 'build',
+            required: true,
+            reason: 'Behavior-changing work needs RED/GREEN/REFACTOR evidence or an explicit non-applicability reason.',
+            command: joinCommand([
+                'scale',
+                'tdd',
+                'slice',
+                '--task-id',
+                input.taskId,
+                '--behavior',
+                input.description,
+                '--public-interface',
+                '<public interface>',
+                '--failing-test',
+                '<failing test command>',
+                '--test-file',
+                '<test file>',
+                '--impl-files',
+                implFilesValue(input.files),
+                ...artifactArgs(input.artifactDir),
+                '--write',
+            ]),
+        });
+        if (needsToolEvidence(input)) {
+            items.push({
+                id: 'tool-evidence',
+                phase: 'verify',
+                required: Boolean(input.requiredSkillVerification?.length),
+                reason: 'Selected skill domains require executable tool evidence instead of prose-only claims.',
+                command: joinCommand([
+                    'scale',
+                    'tool',
+                    'run',
+                    '--task-id',
+                    input.taskId,
+                    '--task',
+                    input.description,
+                    '--level',
+                    input.level,
+                    ...filesArgs(input.files),
+                ]),
+            });
+        }
+    }
+    items.push({
+        id: 'verification',
+        phase: 'verify',
+        required: true,
+        reason: 'Completion claims require real verification output.',
+        command: `scale verify ${input.taskId}`,
+    });
+    return {
+        taskId: input.taskId,
+        level: normalizedLevel,
+        items,
+        requiredCommandCount: items.filter(item => item.required).length,
+    };
+}
+export function renderWorkflowGuidance(guidance) {
+    if (!guidance.items.length)
+        return '';
+    const lines = ['Next workflow commands:'];
+    for (const item of guidance.items) {
+        const marker = item.required ? 'required' : 'recommended';
+        lines.push(`   - [${marker}] ${item.command}`);
+        lines.push(`     reason: ${item.reason}`);
+    }
+    return lines.join('\n');
+}
+function isBugLike(description) {
+    const lower = description.toLowerCase();
+    return BUG_TERMS.some(term => lower.includes(term.toLowerCase()));
+}
+function needsToolEvidence(input) {
+    if (input.requiredSkillVerification?.length)
+        return true;
+    return (input.skillIntents ?? []).some(intent => TOOL_EVIDENCE_DOMAINS.has(intent));
+}
+function artifactArgs(artifactDir) {
+    return artifactDir ? ['--artifact-dir', artifactDir] : [];
+}
+function filesArgs(files) {
+    const normalized = (files ?? []).filter(Boolean);
+    return normalized.length ? ['--files', normalized.join(',')] : [];
+}
+function implFilesValue(files) {
+    const normalized = (files ?? []).filter(Boolean);
+    return normalized.length ? normalized.join(',') : '<impl files>';
+}
+function joinCommand(parts) {
+    return parts.map(quoteArg).join(' ');
+}
+function quoteArg(value) {
+    if (!value)
+        return '""';
+    if (/^[A-Za-z0-9_./:@=,+-]+$/.test(value))
+        return value;
+    return `"${value.replace(/(["\\$`])/g, '\\$1')}"`;
+}
+// ============================================================================
+// Role-Based Guidance
+// ============================================================================
+export function getRoleGuidanceForPhase(phase) {
+    switch (phase) {
+        case 'explore':
+            return ['eng-manager'];
+        case 'plan':
+            return ['ceo-reviewer', 'eng-manager'];
+        case 'build':
+            return [];
+        case 'verify':
+            return ['qa-lead', 'security-reviewer'];
+        case 'review':
+            return ['eng-manager', 'security-reviewer'];
+        case 'ship':
+            return ['release-engineer'];
+        default:
+            return [];
+    }
+}
+export function createRoleGuidanceItem(role, phase, taskId, description) {
+    return {
+        id: `role-${role}`,
+        phase,
+        required: phase === 'review' || phase === 'verify',
+        reason: `${role} perspective ensures multi-angle review coverage.`,
+        command: `scale review --role ${role} --task-id ${taskId}`,
+        role,
+    };
+}
+//# sourceMappingURL=WorkflowGuidance.js.map

package/dist/workflow/WorkflowGuidance.js.map

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

package/dist/workflow/WorkflowOpenTasks.d.ts

@@ -0,0 +1,16 @@
+export type WorkflowOpenTaskKind = 'context-grill' | 'diagnostic-loop' | 'tdd-slice' | 'tool-evidence' | 'verification';
+export type WorkflowOpenTaskAction = {
+    kind: 'command' | 'blocker';
+    value: string;
+};
+export declare function removeWorkflowOpenTask(openTasks: string[] | undefined, kind: WorkflowOpenTaskKind): string[];
+export declare function firstExecutableOpenTask(openTasks: string[] | undefined): string | undefined;
+export declare function nextWorkflowOpenTask(openTasks: string[] | undefined): WorkflowOpenTaskAction | undefined;
+export declare function blockingWorkflowOpenTasks(openTasks: string[] | undefined, taskId: string): string[];
+export declare function toolEvidenceRunCompletesOpenTask(report: {
+    ok: boolean;
+    dryRun: boolean;
+    evidence: Array<{
+        status: string;
+    }>;
+}): boolean;

package/dist/workflow/WorkflowOpenTasks.js

@@ -0,0 +1,37 @@
+const TASK_PREFIXES = {
+    'context-grill': 'scale context grill',
+    'diagnostic-loop': 'scale diagnose plan',
+    'tdd-slice': 'scale tdd slice',
+    'tool-evidence': 'scale tool run',
+    verification: 'scale verify',
+};
+export function removeWorkflowOpenTask(openTasks, kind) {
+    const prefix = TASK_PREFIXES[kind];
+    return (openTasks ?? []).filter(task => !task.trim().startsWith(prefix));
+}
+export function firstExecutableOpenTask(openTasks) {
+    return (openTasks ?? []).find(task => task.trim().startsWith('scale '));
+}
+export function nextWorkflowOpenTask(openTasks) {
+    const value = (openTasks ?? []).find(task => task.trim().length > 0);
+    if (!value)
+        return undefined;
+    return {
+        kind: value.trim().startsWith('scale ') ? 'command' : 'blocker',
+        value,
+    };
+}
+export function blockingWorkflowOpenTasks(openTasks, taskId) {
+    const currentVerifyCommand = `scale verify ${taskId}`;
+    return (openTasks ?? []).filter(task => {
+        const value = task.trim();
+        return value.length > 0 && value !== currentVerifyCommand;
+    });
+}
+export function toolEvidenceRunCompletesOpenTask(report) {
+    return report.ok &&
+        !report.dryRun &&
+        report.evidence.length > 0 &&
+        report.evidence.every(record => record.status === 'passed');
+}
+//# sourceMappingURL=WorkflowOpenTasks.js.map

package/dist/workflow/WorkflowOpenTasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowOpenTasks.js","sourceRoot":"","sources":["../../src/workflow/WorkflowOpenTasks.ts"],"names":[],"mappings":"AAGA,MAAM,aAAa,GAAyC;IAC1D,eAAe,EAAE,qBAAqB;IACtC,iBAAiB,EAAE,qBAAqB;IACxC,WAAW,EAAE,iBAAiB;IAC9B,eAAe,EAAE,gBAAgB;IACjC,YAAY,EAAE,cAAc;CAC7B,CAAA;AAED,MAAM,UAAU,sBAAsB,CAAC,SAA+B,EAAE,IAA0B;IAChG,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAClC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAA+B;IACrE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAA+B;IAClE,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC/D,KAAK;KACN,CAAA;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAA+B,EAAE,MAAc;IACvF,MAAM,oBAAoB,GAAG,gBAAgB,MAAM,EAAE,CAAA;IACrD,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACzB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,oBAAoB,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,MAIhD;IACC,OAAO,MAAM,CAAC,EAAE;QACd,CAAC,MAAM,CAAC,MAAM;QACd,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAA;AAC/D,CAAC"}

package/dist/workflow/WorkflowOrchestrator.d.ts

@@ -0,0 +1,59 @@
+import { type TaskLevel } from './TaskLevelDetector.js';
+export type PhaseName = 'define' | 'plan' | 'build' | 'verify' | 'review' | 'ship';
+export interface RunOptions {
+    title: string;
+    description?: string;
+    successCriteria?: string[];
+    level?: TaskLevel;
+    skipPhases?: PhaseName[];
+    stopOnFailure?: boolean;
+    autoCommit?: boolean;
+    scaleDir?: string;
+    projectDir?: string;
+}
+export interface PhaseResult {
+    phase: PhaseName;
+    success: boolean;
+    duration: number;
+    artifactId?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface TokenUsage {
+    totalEstimated: number;
+    byPhase: Record<string, number>;
+}
+export interface RunResult {
+    success: boolean;
+    phases: PhaseResult[];
+    artifacts: {
+        needId?: string;
+        specId?: string;
+        planId?: string;
+        taskId?: string;
+    };
+    tokenUsage: TokenUsage;
+    duration: number;
+}
+export declare class WorkflowOrchestrator {
+    private eventBus;
+    private store;
+    private fsm;
+    private workflowEngine;
+    private scaleDir;
+    private projectDir;
+    constructor(opts?: {
+        scaleDir?: string;
+        projectDir?: string;
+    });
+    run(options: RunOptions): Promise<RunResult>;
+    private executeDefine;
+    private executePlan;
+    private executeBuild;
+    private executeVerify;
+    private executeReview;
+    private executeShip;
+    private buildResult;
+    /** Close database connections */
+    close(): void;
+}