@hongmaple0820/scale-engine 0.1.0

package/dist/api/mcp.d.ts

@@ -0,0 +1,32 @@
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare class ScaleMCPServer {
+    private bus;
+    private store;
+    private fsm;
+    private kb;
+    private ctx;
+    constructor(scaleDir?: string);
+    getTools(): MCPTool[];
+    handleToolCall(name: string, args: Record<string, unknown>): Promise<unknown>;
+    handleRequest(request: MCPRequest): Promise<MCPResponse>;
+}

package/dist/api/mcp.js

@@ -0,0 +1,227 @@
+// SCALE Engine — MCP Server (W11)
+// Model Context Protocol server over stdio
+// Exposes SCALE artifacts, transitions, and context as MCP tools
+import { EventBus } from '../core/eventBus.js';
+import { InMemoryArtifactStore } from '../artifact/store.js';
+import { FSM } from '../artifact/fsm.js';
+import { registerAllFSMs, INITIAL_STATES } from '../artifact/fsmDefinitions.js';
+import { KnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import { ContextBuilder } from '../context/ContextBuilder.js';
+import { wireEffects } from '../orchestration/EffectsWiring.js';
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// SCALE MCP Server
+// ============================================================================
+export class ScaleMCPServer {
+    bus;
+    store;
+    fsm;
+    kb;
+    ctx;
+    constructor(scaleDir = '.scale') {
+        const eventsDir = join(scaleDir, 'events');
+        const artifactsDir = join(scaleDir, 'artifacts');
+        for (const d of [eventsDir, artifactsDir]) {
+            if (!existsSync(d))
+                mkdirSync(d, { recursive: true });
+        }
+        this.bus = new EventBus({ eventsDir });
+        this.store = new InMemoryArtifactStore(this.bus, { artifactsDir });
+        this.fsm = new FSM(this.store, this.bus);
+        registerAllFSMs(this.fsm);
+        wireEffects(this.fsm, this.store, this.bus);
+        this.kb = new KnowledgeBase(this.bus);
+        this.ctx = new ContextBuilder(this.store, this.kb, this.bus);
+    }
+    getTools() {
+        return [
+            {
+                name: 'scale_create',
+                description: 'Create a new SCALE artifact (Spec, Plan, Task, Defect, etc.)',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', enum: Object.keys(INITIAL_STATES), description: 'Artifact type' },
+                        title: { type: 'string', description: 'Artifact title' },
+                        payload: { type: 'object', description: 'Type-specific payload' },
+                    },
+                    required: ['type', 'title'],
+                },
+            },
+            {
+                name: 'scale_transition',
+                description: 'Transition an artifact to a new state via FSM action',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        artifactId: { type: 'string', description: 'Artifact ID' },
+                        action: { type: 'string', description: 'FSM action name' },
+                        reason: { type: 'string', description: 'Reason for transition' },
+                    },
+                    required: ['artifactId', 'action'],
+                },
+            },
+            {
+                name: 'scale_list',
+                description: 'List artifacts with optional filters',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', description: 'Filter by type' },
+                        status: { type: 'string', description: 'Filter by status' },
+                        limit: { type: 'number', description: 'Max results', default: 20 },
+                    },
+                },
+            },
+            {
+                name: 'scale_show',
+                description: 'Show artifact details',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        artifactId: { type: 'string', description: 'Artifact ID' },
+                    },
+                    required: ['artifactId'],
+                },
+            },
+            {
+                name: 'scale_available_actions',
+                description: 'Get available FSM actions for an artifact',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        artifactId: { type: 'string', description: 'Artifact ID' },
+                    },
+                    required: ['artifactId'],
+                },
+            },
+            {
+                name: 'scale_context',
+                description: 'Build context for current session',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sessionId: { type: 'string', description: 'Session ID' },
+                        artifactId: { type: 'string', description: 'Current artifact ID' },
+                        roleId: { type: 'string', description: 'Current role' },
+                    },
+                    required: ['sessionId'],
+                },
+            },
+            {
+                name: 'scale_stats',
+                description: 'Get engine statistics',
+                inputSchema: { type: 'object', properties: {} },
+            },
+        ];
+    }
+    async handleToolCall(name, args) {
+        const actor = { kind: 'system', component: 'mcp-client' };
+        switch (name) {
+            case 'scale_create': {
+                const type = args.type;
+                const title = args.title;
+                const payload = args.payload ?? {};
+                const artifact = await this.store.create({
+                    type: type,
+                    title,
+                    payload,
+                    initialStatus: INITIAL_STATES[type],
+                    createdBy: actor,
+                });
+                return { id: artifact.id, type: artifact.type, title: artifact.title, status: artifact.status };
+            }
+            case 'scale_transition': {
+                const id = args.artifactId;
+                const action = args.action;
+                const reason = args.reason;
+                const result = await this.fsm.transition(id, action, { actor, reason });
+                return {
+                    success: result.success,
+                    status: result.artifact?.status,
+                    blockedBy: result.blockedBy,
+                    effectsExecuted: result.effectsExecuted,
+                };
+            }
+            case 'scale_list': {
+                const artifacts = await this.store.query({
+                    type: args.type,
+                    status: args.status,
+                    limit: args.limit ?? 20,
+                });
+                return artifacts.map((a) => ({
+                    id: a.id, type: a.type, title: a.title, status: a.status,
+                }));
+            }
+            case 'scale_show': {
+                const artifact = await this.store.get(args.artifactId);
+                if (!artifact)
+                    return { error: 'Artifact not found' };
+                return artifact;
+            }
+            case 'scale_available_actions': {
+                const actions = await this.fsm.availableActions(args.artifactId);
+                return { artifactId: args.artifactId, actions };
+            }
+            case 'scale_context': {
+                const ctx = await this.ctx.build({
+                    sessionId: args.sessionId,
+                    currentArtifactId: args.artifactId,
+                    roleId: args.roleId,
+                });
+                return ctx;
+            }
+            case 'scale_stats': {
+                const all = await this.store.query({ limit: 10000 });
+                const byType = {};
+                for (const a of all)
+                    byType[a.type] = (byType[a.type] ?? 0) + 1;
+                const events = await this.bus.query({ limit: 1000 });
+                return { artifactCount: all.length, byType, eventCount: events.length };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    async handleRequest(request) {
+        try {
+            switch (request.method) {
+                case 'initialize':
+                    return {
+                        jsonrpc: '2.0', id: request.id,
+                        result: {
+                            protocolVersion: '2024-11-05',
+                            capabilities: { tools: {} },
+                            serverInfo: { name: 'scale-engine', version: '0.1.0' },
+                        },
+                    };
+                case 'tools/list':
+                    return {
+                        jsonrpc: '2.0', id: request.id,
+                        result: { tools: this.getTools() },
+                    };
+                case 'tools/call': {
+                    const params = request.params;
+                    const result = await this.handleToolCall(params.name, params.arguments ?? {});
+                    return {
+                        jsonrpc: '2.0', id: request.id,
+                        result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] },
+                    };
+                }
+                default:
+                    return {
+                        jsonrpc: '2.0', id: request.id,
+                        error: { code: -32601, message: `Method not found: ${request.method}` },
+                    };
+            }
+        }
+        catch (e) {
+            return {
+                jsonrpc: '2.0', id: request.id,
+                error: { code: -32000, message: e.message },
+            };
+        }
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/api/mcp.js.map

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

package/dist/artifact/fsm.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SCALE Engine — FSM (Finite State Machine) Engine
+ *
+ * 系统的"宪法执行者"。
+ * 所有 Artifact 状态变化必须通过 fsm.transition()，禁止任何代码绕过。
+ *
+ * 设计参考：docs/02-DATA-MODEL.md §三、docs/03-CORE-MODULES.md §3.2
+ */
+import type { ArtifactType, FSMDefinition, TransitionContext, TransitionResult, GuardFailure } from './types.js';
+import type { IArtifactStore } from './store.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface IFSM {
+    register(definition: FSMDefinition): void;
+    canTransition(artifactId: string, action: string): Promise<{
+        allowed: boolean;
+        blockedBy?: GuardFailure[];
+    }>;
+    transition(artifactId: string, action: string, context: TransitionContext): Promise<TransitionResult>;
+    availableActions(artifactId: string): Promise<string[]>;
+    getDefinition(type: ArtifactType): FSMDefinition | undefined;
+}
+export declare class FSM implements IFSM {
+    private store;
+    private eventBus;
+    private registry;
+    constructor(store: IArtifactStore, eventBus: IEventBus);
+    register(definition: FSMDefinition): void;
+    getDefinition(type: ArtifactType): FSMDefinition | undefined;
+    canTransition(artifactId: string, action: string): Promise<{
+        allowed: boolean;
+        blockedBy?: GuardFailure[];
+    }>;
+    transition(artifactId: string, action: string, context: TransitionContext): Promise<TransitionResult>;
+    availableActions(artifactId: string): Promise<string[]>;
+}
+export declare const SpecFSM: FSMDefinition;

package/dist/artifact/fsm.js

@@ -0,0 +1,199 @@
+/**
+ * SCALE Engine — FSM (Finite State Machine) Engine
+ *
+ * 系统的"宪法执行者"。
+ * 所有 Artifact 状态变化必须通过 fsm.transition()，禁止任何代码绕过。
+ *
+ * 设计参考：docs/02-DATA-MODEL.md §三、docs/03-CORE-MODULES.md §3.2
+ */
+import { InvalidTransitionError, ArtifactNotFoundError, } from './types.js';
+import { logger } from '../core/logger.js';
+export class FSM {
+    store;
+    eventBus;
+    registry = new Map();
+    constructor(store, eventBus) {
+        this.store = store;
+        this.eventBus = eventBus;
+    }
+    register(definition) {
+        if (this.registry.has(definition.type)) {
+            throw new Error(`FSM already registered for type: ${definition.type}`);
+        }
+        this.registry.set(definition.type, definition);
+        logger.debug({ type: definition.type, states: definition.states }, 'FSM registered');
+    }
+    getDefinition(type) {
+        return this.registry.get(type);
+    }
+    async canTransition(artifactId, action) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            throw new ArtifactNotFoundError(artifactId);
+        const def = this.registry.get(artifact.type);
+        if (!def)
+            throw new Error(`No FSM registered for type: ${artifact.type}`);
+        const tx = def.transitions.find((t) => t.from === artifact.status && t.action === action);
+        if (!tx)
+            return { allowed: false, blockedBy: [{ guard: 'transition', message: `No transition from '${artifact.status}' via '${action}'` }] };
+        const failures = [];
+        for (const guard of tx.guards ?? []) {
+            try {
+                const passed = await guard.check(artifact, {
+                    actor: { kind: 'system', component: 'FSM.canTransition' },
+                });
+                if (!passed)
+                    failures.push({ guard: guard.name, message: guard.errorMessage });
+            }
+            catch (e) {
+                failures.push({ guard: guard.name, message: `Guard threw: ${e.message}` });
+            }
+        }
+        return { allowed: failures.length === 0, blockedBy: failures.length > 0 ? failures : undefined };
+    }
+    async transition(artifactId, action, context) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            throw new ArtifactNotFoundError(artifactId);
+        const def = this.registry.get(artifact.type);
+        if (!def)
+            throw new Error(`No FSM registered for type: ${artifact.type}`);
+        const tx = def.transitions.find((t) => t.from === artifact.status && t.action === action);
+        if (!tx)
+            throw new InvalidTransitionError(artifact.status, action);
+        // Phase 1: 检查所有 guards
+        const failures = [];
+        for (const guard of tx.guards ?? []) {
+            try {
+                const passed = await guard.check(artifact, context);
+                if (!passed) {
+                    failures.push({ guard: guard.name, message: guard.errorMessage });
+                }
+            }
+            catch (e) {
+                failures.push({
+                    guard: guard.name,
+                    message: `Guard threw: ${e.message}`,
+                });
+            }
+        }
+        if (failures.length > 0) {
+            logger.info({ artifactId, action, failures }, 'Transition blocked by guards');
+            return { success: false, blockedBy: failures, effectsExecuted: [] };
+        }
+        // Phase 2: 写状态历史 + 更新状态（事件先发，后落 DB）
+        const event = this.eventBus.emit('artifact.transitioned', {
+            artifactId,
+            from: artifact.status,
+            to: tx.to,
+            reason: context.reason,
+        }, {
+            sessionId: 'system',
+            actor: context.actor,
+            artifactId,
+        });
+        const updated = await this.store.update(artifactId, {
+            status: tx.to,
+            statusHistory: [
+                ...artifact.statusHistory,
+                {
+                    from: artifact.status,
+                    to: tx.to,
+                    at: Date.now(),
+                    by: context.actor,
+                    reason: context.reason,
+                    eventId: event.id,
+                },
+            ],
+            updatedAt: Date.now(),
+            ...(def.terminal.includes(tx.to) ? { closedAt: Date.now() } : {}),
+        });
+        logger.info({ artifactId, from: artifact.status, to: tx.to, by: context.actor }, 'Transition completed');
+        // Phase 3: 异步执行 effects（不阻塞返回，但记录失败）
+        const effectsExecuted = [];
+        for (const effect of tx.effects ?? []) {
+            try {
+                await effect.run(updated, context);
+                effectsExecuted.push(effect.name);
+            }
+            catch (e) {
+                logger.error({ artifactId, effect: effect.name, error: e.message }, 'Effect execution failed');
+                // Effect 失败不回滚状态迁移（事件已发出，下游可补偿）
+            }
+        }
+        return { success: true, artifact: updated, effectsExecuted };
+    }
+    async availableActions(artifactId) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            throw new ArtifactNotFoundError(artifactId);
+        const def = this.registry.get(artifact.type);
+        if (!def)
+            return [];
+        return def.transitions
+            .filter((t) => t.from === artifact.status)
+            .map((t) => t.action);
+    }
+}
+// ============================================================================
+// 内置 FSM 定义（11 种 Artifact）
+// 这些定义在 src/artifact/fsmDefinitions/ 下完整实现
+// 此处只列 Spec 作为示例
+// ============================================================================
+export const SpecFSM = {
+    type: 'Spec',
+    states: ['DRAFT', 'REVIEWING', 'FROZEN', 'REVISING', 'OBSOLETED'],
+    initial: 'DRAFT',
+    terminal: ['OBSOLETED'],
+    transitions: [
+        {
+            from: 'DRAFT',
+            action: 'refine',
+            to: 'REVIEWING',
+        },
+        {
+            from: 'REVIEWING',
+            action: 'reject',
+            to: 'DRAFT',
+        },
+        {
+            from: 'REVIEWING',
+            action: 'approve',
+            to: 'FROZEN',
+            guards: [
+                {
+                    name: 'ambiguity_below_threshold',
+                    check: (a) => {
+                        const payload = a.payload;
+                        return (payload.ambiguityScore ?? 1) <= 0.2;
+                    },
+                    errorMessage: 'Spec 模糊度必须 ≤ 0.2 才能 FROZEN',
+                },
+            ],
+        },
+        {
+            from: 'FROZEN',
+            action: 'challenge',
+            to: 'REVISING',
+            // effects 在运行时由 Engine 注入（避免循环依赖）
+        },
+        {
+            from: 'REVISING',
+            action: 'finalize',
+            to: 'FROZEN',
+        },
+        {
+            from: 'FROZEN',
+            action: 'supersede',
+            to: 'OBSOLETED',
+        },
+    ],
+};
+// 其他 FSM 定义占位（W2 完整实现）
+// export const NeedFSM: FSMDefinition = { ... }
+// export const PlanFSM: FSMDefinition = { ... }
+// export const TaskFSM: FSMDefinition = { ... }
+// export const ChangeFSM: FSMDefinition = { ... }
+// export const DefectFSM: FSMDefinition = { ... }
+// ...
+//# sourceMappingURL=fsm.js.map

package/dist/artifact/fsm.js.map

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

package/dist/artifact/fsmDefinitions.d.ts

@@ -0,0 +1,18 @@
+import type { FSMDefinition } from './types.js';
+export declare const NeedFSM: FSMDefinition;
+export declare const InsightFSM: FSMDefinition;
+export declare const SpecFSM: FSMDefinition;
+export declare const PlanFSM: FSMDefinition;
+export declare const TestPlanFSM: FSMDefinition;
+export declare const TaskFSM: FSMDefinition;
+export declare const ChangeFSM: FSMDefinition;
+export declare const EvidenceFSM: FSMDefinition;
+export declare const DefectFSM: FSMDefinition;
+export declare const LessonFSM: FSMDefinition;
+export declare const ReleaseFSM: FSMDefinition;
+export declare const ALL_FSMS: readonly [FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>, FSMDefinition<string, string>];
+import type { IFSM } from './fsm.js';
+import type { ArtifactType } from './types.js';
+export declare function registerAllFSMs(fsm: IFSM): void;
+/** 各 Artifact 类型的初始状态查询表 */
+export declare const INITIAL_STATES: Record<ArtifactType, string>;