@hongmaple0820/scale-engine 0.1.0

package/dist/tasks/TaskEngine.d.ts

@@ -0,0 +1,97 @@
+import type { ArtifactId } from '../artifact/types.js';
+import type { IArtifactStore } from '../artifact/store.js';
+import type { IFSM } from '../artifact/fsm.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface Checkpoint {
+    id: string;
+    taskId: ArtifactId;
+    timestamp: number;
+    state: CheckpointState;
+    description?: string;
+    canResume: boolean;
+}
+export interface CheckpointState {
+    context: Record<string, unknown>;
+    currentStep: number;
+    completedSteps: string[];
+    failedSteps: string[];
+}
+export interface TaskStep {
+    id: string;
+    name: string;
+    handler: StepHandler;
+    timeout?: number;
+    retries?: number;
+    checkpoint?: boolean;
+}
+export type StepResult = {
+    success: true;
+    output?: unknown;
+} | {
+    success: false;
+    error: string;
+    retryable?: boolean;
+};
+export type StepHandler = (ctx: StepContext) => Promise<StepResult>;
+export interface StepContext {
+    taskId: ArtifactId;
+    stepId: string;
+    stepIndex: number;
+    get: (key: string) => unknown;
+    set: (key: string, value: unknown) => void;
+    emit: (type: string, payload: unknown) => void;
+    log: (msg: string) => void;
+}
+export interface TaskDecomposition {
+    parentTaskId: ArtifactId;
+    subtasks: Array<{
+        title: string;
+        payload: unknown;
+        dependencies?: string[];
+    }>;
+}
+export interface ITaskEngine {
+    schedule(taskId: ArtifactId): Promise<void>;
+    execute(taskId: ArtifactId, steps?: TaskStep[]): Promise<ExecutionResult>;
+    pause(taskId: ArtifactId, reason: string): Promise<void>;
+    resume(taskId: ArtifactId, steps?: TaskStep[]): Promise<ExecutionResult>;
+    cancel(taskId: ArtifactId, reason: string): Promise<void>;
+    checkpoint(taskId: ArtifactId, label?: string): Promise<Checkpoint>;
+    restoreFromCheckpoint(taskId: ArtifactId, checkpointId?: string): Promise<CheckpointState>;
+    decompose(decomposition: TaskDecomposition): Promise<ArtifactId[]>;
+    getContext(taskId: ArtifactId): Record<string, unknown>;
+    setContext(taskId: ArtifactId, key: string, value: unknown): void;
+}
+export interface ExecutionResult {
+    taskId: ArtifactId;
+    success: boolean;
+    completedSteps: string[];
+    failedStep?: string;
+    error?: string;
+    duration: number;
+}
+export declare class TaskEngine implements ITaskEngine {
+    private store;
+    private fsm;
+    private eventBus;
+    private runtimes;
+    private checkpointsDir;
+    constructor(store: IArtifactStore, fsm: IFSM, eventBus: IEventBus, opts?: {
+        checkpointsDir?: string;
+    });
+    schedule(taskId: ArtifactId): Promise<void>;
+    execute(taskId: ArtifactId, steps?: TaskStep[]): Promise<ExecutionResult>;
+    pause(taskId: ArtifactId, reason: string): Promise<void>;
+    resume(taskId: ArtifactId, steps?: TaskStep[]): Promise<ExecutionResult>;
+    cancel(taskId: ArtifactId, reason: string): Promise<void>;
+    checkpoint(taskId: ArtifactId, label?: string): Promise<Checkpoint>;
+    restoreFromCheckpoint(taskId: ArtifactId, checkpointId?: string): Promise<CheckpointState>;
+    decompose(decomposition: TaskDecomposition): Promise<ArtifactId[]>;
+    getContext(taskId: ArtifactId): Record<string, unknown>;
+    setContext(taskId: ArtifactId, key: string, value: unknown): void;
+    private getOrCreateRuntime;
+    private executeStep;
+    private timeoutPromise;
+    /** resume 后继续执行剩余步骤（不再走 start transition） */
+    private executeFromRuntime;
+}

package/dist/tasks/TaskEngine.js

@@ -0,0 +1,269 @@
+// SCALE Engine — Task Engine (W4 完整实现)
+// 长时任务: 步骤执行 + Checkpoint + Resume + 超时熔断 + 子任务分解
+// 设计参考：docs/03-CORE-MODULES.md §3.3
+import { logger } from '../core/logger.js';
+import { writeFileSync, readFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+const SYSTEM_ACTOR = { kind: 'system', component: 'TaskEngine' };
+const DEFAULT_STEP_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+const MAX_STEP_TIMEOUT = 30 * 60 * 1000; // 30 minutes
+// ============================================================================
+// TaskEngine
+// ============================================================================
+export class TaskEngine {
+    store;
+    fsm;
+    eventBus;
+    runtimes = new Map();
+    checkpointsDir;
+    constructor(store, fsm, eventBus, opts = {}) {
+        this.store = store;
+        this.fsm = fsm;
+        this.eventBus = eventBus;
+        this.checkpointsDir = opts.checkpointsDir ?? '.scale/checkpoints';
+        if (!existsSync(this.checkpointsDir))
+            mkdirSync(this.checkpointsDir, { recursive: true });
+    }
+    // ===== Schedule =====
+    async schedule(taskId) {
+        await this.fsm.transition(taskId, 'schedule', { actor: SYSTEM_ACTOR });
+        this.runtimes.set(taskId, { context: {}, currentStep: 0, completedSteps: [], failedSteps: [] });
+        this.eventBus.emit('task.scheduled', { taskId }, { artifactId: taskId });
+    }
+    // ===== Execute =====
+    async execute(taskId, steps = []) {
+        const startTime = Date.now();
+        // 确保 task 在 READY 状态
+        const task = await this.store.get(taskId);
+        if (!task)
+            throw new Error(`Task not found: ${taskId}`);
+        // READY → RUNNING
+        await this.fsm.transition(taskId, 'start', { actor: SYSTEM_ACTOR });
+        this.eventBus.emit('task.started', { taskId, stepCount: steps.length }, { artifactId: taskId });
+        // 获取或创建运行时
+        const runtime = this.getOrCreateRuntime(taskId);
+        // 如果 resume，从上次的 currentStep 继续
+        const startStep = runtime.currentStep;
+        // 逐步执行
+        for (let i = startStep; i < steps.length; i++) {
+            const step = steps[i];
+            runtime.currentStep = i;
+            logger.info({ taskId, step: step.id, index: i }, 'Executing step');
+            this.eventBus.emit('task.step_started', { taskId, stepId: step.id, index: i }, { artifactId: taskId });
+            // 执行步骤（带超时和重试）
+            const result = await this.executeStep(taskId, step, runtime);
+            if (result.success) {
+                runtime.completedSteps.push(step.id);
+                this.eventBus.emit('task.step_completed', { taskId, stepId: step.id, output: result.output }, { artifactId: taskId });
+                // 自动 checkpoint（默认开启）
+                if (step.checkpoint !== false) {
+                    await this.checkpoint(taskId, `after-${step.id}`);
+                }
+            }
+            else {
+                runtime.failedSteps.push(step.id);
+                this.eventBus.emit('task.step_failed', { taskId, stepId: step.id, error: result.error }, { artifactId: taskId });
+                // 步骤失败 → 整个任务 fail
+                await this.fsm.transition(taskId, 'fail', { actor: SYSTEM_ACTOR, reason: result.error });
+                this.eventBus.emit('task.failed', { taskId, stepId: step.id, error: result.error }, { artifactId: taskId });
+                return {
+                    taskId,
+                    success: false,
+                    completedSteps: [...runtime.completedSteps],
+                    failedStep: step.id,
+                    error: result.error,
+                    duration: Date.now() - startTime,
+                };
+            }
+        }
+        // 所有步骤通过 → complete
+        runtime.currentStep = steps.length;
+        await this.fsm.transition(taskId, 'complete', { actor: SYSTEM_ACTOR });
+        this.eventBus.emit('task.completed', { taskId, stepCount: steps.length }, { artifactId: taskId });
+        return {
+            taskId,
+            success: true,
+            completedSteps: [...runtime.completedSteps],
+            duration: Date.now() - startTime,
+        };
+    }
+    // ===== Pause / Resume / Cancel =====
+    async pause(taskId, reason) {
+        await this.checkpoint(taskId, 'auto-pause');
+        await this.fsm.transition(taskId, 'pause', { actor: SYSTEM_ACTOR, reason });
+        this.eventBus.emit('task.paused', { taskId, reason }, { artifactId: taskId });
+    }
+    async resume(taskId, steps = []) {
+        const state = await this.restoreFromCheckpoint(taskId);
+        // 注回运行时
+        this.runtimes.set(taskId, state);
+        await this.fsm.transition(taskId, 'resume', { actor: SYSTEM_ACTOR });
+        this.eventBus.emit('task.resumed', { taskId, fromStep: state.currentStep }, { artifactId: taskId });
+        // 继续从断点执行（FSM: RUNNING → 继续步骤循环）
+        // resume 后 task 回到 RUNNING，但 execute 需要 READY→RUNNING
+        // 所以这里直接走步骤循环
+        return this.executeFromRuntime(taskId, steps, state);
+    }
+    async cancel(taskId, reason) {
+        await this.fsm.transition(taskId, 'cancel', { actor: SYSTEM_ACTOR, reason });
+        this.runtimes.delete(taskId);
+        this.eventBus.emit('task.cancelled', { taskId, reason }, { artifactId: taskId });
+    }
+    // ===== Checkpoint =====
+    async checkpoint(taskId, label) {
+        const runtime = this.runtimes.get(taskId) ?? { context: {}, currentStep: 0, completedSteps: [], failedSteps: [] };
+        const checkpoint = {
+            id: `CKP-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+            taskId,
+            timestamp: Date.now(),
+            state: {
+                context: { ...runtime.context },
+                currentStep: runtime.currentStep,
+                completedSteps: [...runtime.completedSteps],
+                failedSteps: [...runtime.failedSteps],
+            },
+            description: label,
+            canResume: true,
+        };
+        const dir = join(this.checkpointsDir, taskId);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, `${checkpoint.id}.json`), JSON.stringify(checkpoint, null, 2));
+        this.eventBus.emit('task.checkpointed', { taskId, checkpointId: checkpoint.id, label }, { artifactId: taskId });
+        logger.info({ taskId, checkpointId: checkpoint.id, label }, 'Checkpoint saved');
+        return checkpoint;
+    }
+    async restoreFromCheckpoint(taskId, checkpointId) {
+        const dir = join(this.checkpointsDir, taskId);
+        if (!existsSync(dir))
+            throw new Error(`No checkpoints for task ${taskId}`);
+        let file;
+        if (checkpointId) {
+            file = `${checkpointId}.json`;
+        }
+        else {
+            // 找最新的
+            const files = readdirSync(dir).filter((f) => f.endsWith('.json')).sort();
+            const latest = files.pop();
+            if (!latest)
+                throw new Error(`No checkpoint files found for task ${taskId}`);
+            file = latest;
+        }
+        const data = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
+        if (!data.canResume)
+            throw new Error(`Checkpoint ${data.id} is not resumable`);
+        this.runtimes.set(taskId, { ...data.state });
+        this.eventBus.emit('task.restored', { taskId, checkpointId: data.id }, { artifactId: taskId });
+        logger.info({ taskId, checkpointId: data.id, currentStep: data.state.currentStep }, 'Checkpoint restored');
+        return data.state;
+    }
+    // ===== Decompose =====
+    async decompose(decomposition) {
+        const { parentTaskId, subtasks } = decomposition;
+        const ids = [];
+        for (const sub of subtasks) {
+            const artifact = await this.store.create({
+                type: 'Task',
+                title: sub.title,
+                payload: { ...sub.payload, dependencies: sub.dependencies },
+                parents: [parentTaskId],
+                initialStatus: 'PENDING',
+                createdBy: SYSTEM_ACTOR,
+            });
+            ids.push(artifact.id);
+        }
+        this.eventBus.emit('task.decomposed', {
+            parentTaskId,
+            subtaskIds: ids,
+            count: ids.length,
+        }, { artifactId: parentTaskId });
+        logger.info({ parentTaskId, subtaskCount: ids.length }, 'Task decomposed');
+        return ids;
+    }
+    // ===== Context =====
+    getContext(taskId) {
+        const runtime = this.runtimes.get(taskId);
+        return runtime ? { ...runtime.context } : {};
+    }
+    setContext(taskId, key, value) {
+        const runtime = this.getOrCreateRuntime(taskId);
+        runtime.context[key] = value;
+    }
+    // ===== Internal =====
+    getOrCreateRuntime(taskId) {
+        let runtime = this.runtimes.get(taskId);
+        if (!runtime) {
+            runtime = { context: {}, currentStep: 0, completedSteps: [], failedSteps: [] };
+            this.runtimes.set(taskId, runtime);
+        }
+        return runtime;
+    }
+    async executeStep(taskId, step, runtime) {
+        const timeout = Math.min(step.timeout ?? DEFAULT_STEP_TIMEOUT, MAX_STEP_TIMEOUT);
+        const maxRetries = step.retries ?? 0;
+        const ctx = {
+            taskId,
+            stepId: step.id,
+            stepIndex: runtime.currentStep,
+            get: (key) => runtime.context[key],
+            set: (key, value) => { runtime.context[key] = value; },
+            emit: (type, payload) => {
+                this.eventBus.emit(`task.custom.${type}`, { taskId, stepId: step.id, ...payload }, { artifactId: taskId });
+            },
+            log: (msg) => { logger.info({ taskId, step: step.id }, msg); },
+        };
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const result = await Promise.race([
+                    step.handler(ctx),
+                    this.timeoutPromise(timeout, step.id),
+                ]);
+                if (result.success || !result.retryable || attempt === maxRetries) {
+                    return result;
+                }
+                logger.warn({ taskId, step: step.id, attempt: attempt + 1 }, 'Step failed, retrying...');
+                this.eventBus.emit('task.step_retrying', { taskId, step: step.id, attempt: attempt + 1 }, { artifactId: taskId });
+            }
+            catch (err) {
+                if (attempt === maxRetries) {
+                    return { success: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            }
+        }
+        return { success: false, error: 'Exhausted retries' };
+    }
+    timeoutPromise(ms, stepId) {
+        return new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`Step ${stepId} timed out after ${ms}ms`)), ms);
+        });
+    }
+    /** resume 后继续执行剩余步骤（不再走 start transition） */
+    async executeFromRuntime(taskId, steps, state) {
+        const startTime = Date.now();
+        const runtime = this.getOrCreateRuntime(taskId);
+        for (let i = state.currentStep; i < steps.length; i++) {
+            const step = steps[i];
+            runtime.currentStep = i;
+            this.eventBus.emit('task.step_started', { taskId, stepId: step.id, index: i }, { artifactId: taskId });
+            const result = await this.executeStep(taskId, step, runtime);
+            if (result.success) {
+                runtime.completedSteps.push(step.id);
+                if (step.checkpoint !== false)
+                    await this.checkpoint(taskId, `after-${step.id}`);
+            }
+            else {
+                runtime.failedSteps.push(step.id);
+                await this.fsm.transition(taskId, 'fail', { actor: SYSTEM_ACTOR, reason: result.error });
+                return {
+                    taskId, success: false, completedSteps: [...runtime.completedSteps],
+                    failedStep: step.id, error: result.error, duration: Date.now() - startTime,
+                };
+            }
+        }
+        runtime.currentStep = steps.length;
+        await this.fsm.transition(taskId, 'complete', { actor: SYSTEM_ACTOR });
+        return {
+            taskId, success: true, completedSteps: [...runtime.completedSteps], duration: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=TaskEngine.js.map

package/dist/tasks/TaskEngine.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@hongmaple0820/scale-engine",
+  "version": "0.1.0",
+  "description": "AI engineering scaffold engine: artifacts, FSM, guardrails, knowledge, evolution",
+  "type": "module",
+  "bin": {
+    "scale": "./dist/api/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "bun --watch src/api/cli.ts",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts",
+    "mcp": "node dist/api/mcp.js",
+    "serve": "node dist/api/http.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.10.0",
+    "chokidar": "^3.6.0",
+    "citty": "^0.1.6",
+    "drizzle-orm": "^0.32.2",
+    "execa": "^9.3.0",
+    "hono": "^4.5.0",
+    "js-yaml": "^4.1.0",
+    "pino": "^9.3.0",
+    "pino-pretty": "^11.2.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}