@hongmaple0820/scale-engine 0.1.0

package/dist/guardrails/detectors.js

@@ -0,0 +1,170 @@
+// SCALE Engine — 5 种懒惰检测器
+// 设计参考：docs/03-CORE-MODULES.md §3.5
+import { createHash } from 'node:crypto';
+const hashArgs = (args) => createHash('md5').update(JSON.stringify(args)).digest('hex').slice(0, 8);
+// 1. 暴力重试检测
+export class BruteRetryDetector {
+    name = 'brute-retry';
+    windowMs = 3 * 60 * 1000;
+    threshold = 3;
+    async check(input, ctx) {
+        const key = `${input.sessionId}:${input.tool}:${hashArgs(input.args)}`;
+        const history = ctx.cache.get(key) ?? [];
+        const recent = history.filter((t) => Date.now() - t < this.windowMs);
+        recent.push(Date.now());
+        ctx.cache.set(key, recent);
+        if (recent.length >= this.threshold) {
+            ctx.eventBus.emit('behavior.brute_retry', { tool: input.tool, count: recent.length }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: `检测到「暴力重试」：${input.tool} 在 ${this.windowMs / 60000} 分钟内已运行 ${recent.length} 次。请换策略，并说明你这次的新假设是什么。`,
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 2. 工具闲置检测
+export class IdleToolDetector {
+    name = 'idle-tool';
+    async check(input, ctx) {
+        if (!['Edit', 'Write', 'MultiEdit'].includes(input.tool))
+            return { triggered: false };
+        const recent = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.failed', 'tool.completed'],
+            limit: 10,
+        });
+        const failureIdx = recent.findIndex((e) => e.type === 'tool.failed');
+        if (failureIdx < 0)
+            return { triggered: false };
+        const after = recent.slice(0, failureIdx);
+        const investigation = ['Read', 'Grep', 'WebSearch', 'Bash'];
+        const hasInv = after.some((e) => investigation.includes(e.payload.tool));
+        if (!hasInv) {
+            ctx.eventBus.emit('behavior.idle_tool', { tool: input.tool }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'warn',
+                reason: '检测到「工具闲置」：上次工具失败后未读任何文件/日志就直接改代码。请先 Read 相关文件或 Bash 看错误日志。',
+                suggestion: 'Read failing test output OR Grep for similar patterns',
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 3. 忙碌假象（来回反复修改同一文件）
+export class BusyLoopDetector {
+    name = 'busy-loop';
+    async check(input, ctx) {
+        if (input.tool !== 'Edit')
+            return { triggered: false };
+        const file = input.args.file_path;
+        if (!file)
+            return { triggered: false };
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.tool === 'Edit' && p.args.file_path === file;
+            },
+            limit: 5,
+        });
+        if (edits.length < 4)
+            return { triggered: false };
+        const seen = new Set();
+        let cycle = false;
+        for (const e of edits) {
+            const p = e.payload;
+            const oldH = createHash('md5').update(p.args.old_string ?? '').digest('hex').slice(0, 8);
+            const newH = createHash('md5').update(p.args.new_string ?? '').digest('hex').slice(0, 8);
+            if (seen.has(`${newH}:${oldH}`)) {
+                cycle = true;
+                break;
+            }
+            seen.add(`${oldH}:${newH}`);
+        }
+        if (cycle) {
+            ctx.eventBus.emit('behavior.busy_loop', { file }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: `检测到「忙碌假象」：你在 ${file} 反复来回修改。停下来——这次修改是否产生新信息？没有 = 换思路。`,
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 4. 声称完成但未验证
+export class PrematureDoneDetector {
+    name = 'premature-done';
+    async check(input, ctx) {
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => ['Edit', 'Write', 'MultiEdit'].includes(e.payload.tool),
+        });
+        if (edits.length === 0)
+            return { triggered: false };
+        const verifications = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.tool === 'Bash' && /test|lint|build|typecheck/i.test(p.args.command ?? '');
+            },
+        });
+        if (verifications.length === 0) {
+            ctx.eventBus.emit('behavior.premature_done', { reason: 'no_verification' }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: '检测到「声称完成但未验证」：本会话修改了代码，但未运行任何 test/lint/build。请先运行验证命令。',
+                suggestion: 'pnpm test  (or your project test command)',
+            };
+        }
+        const lastVerify = verifications[0];
+        const lastEdit = edits[0];
+        if (lastVerify.timestamp < lastEdit.timestamp) {
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: '修改了代码但最后一次验证是修改之前运行的。请重新运行验证。',
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 5. 甩锅检测
+export class BlameShiftDetector {
+    name = 'blame-shift';
+    patterns = [
+        /可能是环境问题/i,
+        /建议你?手动/i,
+        /maybe (an?|the) (environment|version|setup)/i,
+        /not sure why/i,
+        /unable to (determine|figure out|resolve)/i,
+    ];
+    async check(input, ctx) {
+        const text = input.output ?? '';
+        if (!this.patterns.some((p) => p.test(text)))
+            return { triggered: false };
+        const verifications = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => e.payload.tool === 'Bash',
+            limit: 5,
+        });
+        if (verifications.length < 2) {
+            ctx.eventBus.emit('behavior.blame_shift', { sessionId: input.sessionId }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'warn',
+                reason: '检测到「甩锅」迹象：你说"可能是环境问题"但未做足够验证。至少：\n1. 验证版本 2. 验证依赖 3. 重现问题。\n证据齐了再下结论。',
+            };
+        }
+        return { triggered: false };
+    }
+}
+//# sourceMappingURL=detectors.js.map

package/dist/guardrails/detectors.js.map

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

package/dist/guardrails/roles.d.ts

@@ -0,0 +1,4 @@
+import type { RoleDefinition } from '../artifact/types.js';
+export declare const ROLES: Record<string, RoleDefinition>;
+export declare function getRole(name: string): RoleDefinition | undefined;
+export declare function listRoles(): string[];

package/dist/guardrails/roles.js

@@ -0,0 +1,54 @@
+// SCALE Engine — Role 定义
+// 设计参考：docs/03-CORE-MODULES.md §3.5 "Role 权限网关"
+export const ROLES = {
+    Explorer: {
+        name: 'Explorer',
+        canCreateArtifacts: ['Insight'],
+        canReadArtifacts: ['Need', 'Spec', 'Insight'],
+        allowedTools: ['Read', 'Grep', 'Glob', 'WebSearch', 'WebFetch'],
+        deniedTools: ['Edit', 'Write', 'Bash'],
+        requiresUpstream: [],
+    },
+    SpecWriter: {
+        name: 'SpecWriter',
+        canCreateArtifacts: ['Spec'],
+        canModifyArtifacts: [{ type: 'Spec', statuses: ['DRAFT', 'REVIEWING'] }],
+        allowedTools: ['Read', 'Write', 'WebSearch'],
+        requiresUpstream: [{ type: 'Need' }],
+    },
+    Planner: {
+        name: 'Planner',
+        canCreateArtifacts: ['Plan', 'TestPlan', 'Task'],
+        allowedTools: ['Read', 'Grep', 'WebSearch', 'Write'],
+        requiresUpstream: [{ type: 'Spec', status: 'FROZEN' }],
+    },
+    Implementer: {
+        name: 'Implementer',
+        canCreateArtifacts: ['Change'],
+        allowedTools: ['Read', 'Grep', 'Glob', 'Edit', 'Write', 'Bash', 'MultiEdit'],
+        requiresUpstream: [{ type: 'Task', status: 'READY' }],
+        mustRunAfterEdit: ['lint', 'typecheck'],
+    },
+    Verifier: {
+        name: 'Verifier',
+        canCreateArtifacts: ['Evidence', 'Defect'],
+        allowedTools: ['Read', 'Bash', 'Grep'],
+        deniedTools: ['Edit', 'Write'],
+    },
+    Releaser: {
+        name: 'Releaser',
+        canCreateArtifacts: ['Release'],
+        allowedTools: ['Read', 'Bash'],
+        requiresUpstream: [
+            { type: 'Defect', allMatch: 'CLOSED' },
+            { type: 'Evidence', allMatch: 'PASS' },
+        ],
+    },
+};
+export function getRole(name) {
+    return ROLES[name];
+}
+export function listRoles() {
+    return Object.keys(ROLES);
+}
+//# sourceMappingURL=roles.js.map

package/dist/guardrails/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/guardrails/roles.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,gDAAgD;AAIhD,MAAM,CAAC,MAAM,KAAK,GAAmC;IACnD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,SAAS,CAAC;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAC7C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC;QAC/D,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACtC,gBAAgB,EAAE,EAAE;KACrB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,kBAAkB,EAAE,CAAC,MAAM,CAAC;QAC5B,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACxE,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;QAC5C,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACrC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC;QAChD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC;QACpD,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACvD;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,kBAAkB,EAAE,CAAC,QAAQ,CAAC;QAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC;QAC5E,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACrD,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;KACxC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACtC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC/B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,SAAS,CAAC;QAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE;YAChB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACtC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;SACvC;KACF;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export * from './artifact/types.js';
+export { FSM, SpecFSM } from './artifact/fsm.js';
+export { InMemoryArtifactStore } from './artifact/store.js';
+export type { IArtifactStore } from './artifact/store.js';
+export { EventBus } from './core/eventBus.js';
+export type { IEventBus } from './core/eventBus.js';
+export { Container, container, createToken } from './core/container.js';
+export { logger } from './core/logger.js';
+export { TaskEngine } from './tasks/TaskEngine.js';
+export { KnowledgeBase } from './knowledge/KnowledgeBase.js';
+export { BehaviorTracker } from './evolution/BehaviorTracker.js';
+export { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from './evolution/EvolutionEngine.js';
+export { Gateway } from './guardrails/Gateway.js';
+export { ROLES, getRole, listRoles } from './guardrails/roles.js';
+export { ContextBuilder } from './context/ContextBuilder.js';
+export { wireEffects } from './orchestration/EffectsWiring.js';
+export { ModelRouter, DEFAULT_MODELS } from './routing/ModelRouter.js';
+export { ClaudeCodeAdapter, createAdapter } from './adapters/ClaudeCodeAdapter.js';
+export { CodexAdapter } from './adapters/CodexAdapter.js';
+export { Doctor } from './api/doctor.js';
+export { ScaleMCPServer } from './api/mcp.js';
+export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';

package/dist/index.js

@@ -0,0 +1,22 @@
+// SCALE Engine — Public API
+export * from './artifact/types.js';
+export { FSM, SpecFSM } from './artifact/fsm.js';
+export { InMemoryArtifactStore } from './artifact/store.js';
+export { EventBus } from './core/eventBus.js';
+export { Container, container, createToken } from './core/container.js';
+export { logger } from './core/logger.js';
+export { TaskEngine } from './tasks/TaskEngine.js';
+export { KnowledgeBase } from './knowledge/KnowledgeBase.js';
+export { BehaviorTracker } from './evolution/BehaviorTracker.js';
+export { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from './evolution/EvolutionEngine.js';
+export { Gateway } from './guardrails/Gateway.js';
+export { ROLES, getRole, listRoles } from './guardrails/roles.js';
+export { ContextBuilder } from './context/ContextBuilder.js';
+export { wireEffects } from './orchestration/EffectsWiring.js';
+export { ModelRouter, DEFAULT_MODELS } from './routing/ModelRouter.js';
+export { ClaudeCodeAdapter, createAdapter } from './adapters/ClaudeCodeAdapter.js';
+export { CodexAdapter } from './adapters/CodexAdapter.js';
+export { Doctor } from './api/doctor.js';
+export { ScaleMCPServer } from './api/mcp.js';
+export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAC9G,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EACL,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EACtD,qBAAqB,EAAE,kBAAkB,GAC1C,MAAM,2BAA2B,CAAA"}

package/dist/knowledge/KnowledgeBase.d.ts

@@ -0,0 +1,25 @@
+import type { KnowledgeEntry, KnowledgeQuery } from '../artifact/types.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface IKnowledgeBase {
+    add(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<KnowledgeEntry>;
+    recall(query: KnowledgeQuery): Promise<KnowledgeEntry[]>;
+    recallByVector(text: string, topK: number): Promise<KnowledgeEntry[]>;
+    markHelpful(id: string, sessionId: string): Promise<void>;
+    markUseless(id: string, sessionId: string): Promise<void>;
+    verify(id: string, verifiedBy: string): Promise<void>;
+    decay(): Promise<void>;
+}
+export declare class KnowledgeBase implements IKnowledgeBase {
+    private eventBus;
+    private entries;
+    private seq;
+    constructor(eventBus: IEventBus);
+    add(input: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<KnowledgeEntry>;
+    recall(query: KnowledgeQuery): Promise<KnowledgeEntry[]>;
+    recallByVector(text: string, topK: number): Promise<KnowledgeEntry[]>;
+    markHelpful(id: string, sessionId: string): Promise<void>;
+    markUseless(id: string, sessionId: string): Promise<void>;
+    verify(id: string, verifiedBy: string): Promise<void>;
+    decay(): Promise<void>;
+    private generateId;
+}

package/dist/knowledge/KnowledgeBase.js

@@ -0,0 +1,81 @@
+// SCALE Engine — Knowledge Base (W7 完整实现)
+// 设计参考：docs/03-CORE-MODULES.md §3.4
+import { logger } from '../core/logger.js';
+export class KnowledgeBase {
+    eventBus;
+    entries = new Map();
+    seq = 0;
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    async add(input) {
+        const entry = {
+            ...input,
+            id: this.generateId(),
+            createdAt: Date.now(),
+            accessCount: 0,
+            relevance: 0.5,
+        };
+        this.entries.set(entry.id, entry);
+        this.eventBus.emit('lesson.proposed', { lessonId: entry.id }, { artifactId: input.sourceArtifact });
+        return entry;
+    }
+    async recall(query) {
+        let results = Array.from(this.entries.values());
+        if (query.type) {
+            const types = Array.isArray(query.type) ? query.type : [query.type];
+            results = results.filter((e) => types.includes(e.type));
+        }
+        if (query.tags)
+            results = results.filter((e) => query.tags.every((t) => e.tags.includes(t)));
+        if (query.minRelevance)
+            results = results.filter((e) => e.relevance >= query.minRelevance);
+        if (query.verifiedOnly)
+            results = results.filter((e) => e.verified);
+        results.sort((a, b) => b.relevance - a.relevance);
+        return results.slice(0, query.limit ?? 10);
+    }
+    async recallByVector(text, topK) {
+        // W7 实现：Qdrant 集成
+        logger.debug({ text, topK }, 'recallByVector (skeleton, falling back to recall)');
+        return this.recall({ verifiedOnly: true, limit: topK });
+    }
+    async markHelpful(id, sessionId) {
+        const entry = this.entries.get(id);
+        if (entry) {
+            entry.relevance = Math.min(1, entry.relevance + 0.05);
+            entry.accessCount += 1;
+            entry.lastAccessed = Date.now();
+            this.eventBus.emit('lesson.helpful', { lessonId: id }, { sessionId });
+        }
+    }
+    async markUseless(id, sessionId) {
+        const entry = this.entries.get(id);
+        if (entry) {
+            entry.relevance = Math.max(0.05, entry.relevance - 0.1);
+            this.eventBus.emit('lesson.useless', { lessonId: id }, { sessionId });
+        }
+    }
+    async verify(id, verifiedBy) {
+        const entry = this.entries.get(id);
+        if (entry) {
+            entry.verified = true;
+            entry.verifiedBy = verifiedBy;
+            entry.verifiedAt = Date.now();
+            this.eventBus.emit('lesson.approved', { lessonId: id, verifiedBy });
+        }
+    }
+    async decay() {
+        const DAY = 24 * 60 * 60 * 1000;
+        for (const entry of this.entries.values()) {
+            const days = entry.lastAccessed ? (Date.now() - entry.lastAccessed) / DAY : 90;
+            const recency = Math.exp(-days / 30);
+            entry.relevance = Math.max(0.05, entry.relevance * 0.95 + recency * 0.05);
+        }
+    }
+    generateId() {
+        this.seq = (this.seq + 1) % 10000;
+        return `KB-${Date.now()}-${this.seq.toString().padStart(4, '0')}`;
+    }
+}
+//# sourceMappingURL=KnowledgeBase.js.map

package/dist/knowledge/KnowledgeBase.js.map

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

package/dist/orchestration/EffectsWiring.d.ts

@@ -0,0 +1,8 @@
+import type { IFSM } from '../artifact/fsm.js';
+import type { IArtifactStore } from '../artifact/store.js';
+import type { IEventBus } from '../core/eventBus.js';
+/**
+ * 注入所有跨 Artifact 的 effects
+ * 在引擎启动后调用（避免循环依赖）
+ */
+export declare function wireEffects(fsm: IFSM, store: IArtifactStore, eventBus: IEventBus): void;

package/dist/orchestration/EffectsWiring.js

@@ -0,0 +1,87 @@
+// SCALE Engine — FSM Effects Wiring (W9)
+// 上游 Artifact 状态变更时自动影响下游
+// 设计参考：docs/01-ARCHITECTURE.md §二 L4
+import { logger } from '../core/logger.js';
+/**
+ * 注入所有跨 Artifact 的 effects
+ * 在引擎启动后调用（避免循环依赖）
+ */
+export function wireEffects(fsm, store, eventBus) {
+    // Effect 1: Spec 进入 REVISING → 自动 invalidate 下游 Plan
+    const specDef = fsm.getDefinition('Spec');
+    if (specDef) {
+        const challengeTx = specDef.transitions.find((t) => t.from === 'FROZEN' && t.action === 'challenge');
+        if (challengeTx && !challengeTx.effects) {
+            challengeTx.effects = [];
+        }
+        if (challengeTx) {
+            challengeTx.effects.push({
+                name: 'invalidate_downstream_plans',
+                run: async (artifact, _ctx) => {
+                    const children = await store.findChildren(artifact.id);
+                    const plans = children.filter((c) => c.type === 'Plan' && ['APPROVED', 'IMPLEMENTING'].includes(c.status));
+                    for (const plan of plans) {
+                        try {
+                            await fsm.transition(plan.id, 'invalidate', {
+                                actor: { kind: 'system', component: 'EffectsWiring' },
+                                reason: `Parent Spec ${artifact.id} entered REVISING`,
+                            });
+                            logger.info({ planId: plan.id, specId: artifact.id }, 'Plan auto-invalidated due to Spec challenge');
+                        }
+                        catch (e) {
+                            logger.warn({ planId: plan.id, error: e.message }, 'Failed to invalidate downstream Plan');
+                        }
+                    }
+                },
+            });
+        }
+    }
+    // Effect 2: Plan 进入 DONE → 自动完成关联的未完成 Task
+    const planDef = fsm.getDefinition('Plan');
+    if (planDef) {
+        const completeTx = planDef.transitions.find((t) => t.from === 'IMPLEMENTING' && t.action === 'complete');
+        if (completeTx && !completeTx.effects) {
+            completeTx.effects = [];
+        }
+        if (completeTx) {
+            completeTx.effects.push({
+                name: 'check_incomplete_tasks',
+                run: async (artifact) => {
+                    const children = await store.findChildren(artifact.id);
+                    const incompleteTasks = children.filter((c) => c.type === 'Task' && !['COMPLETED', 'CANCELLED', 'FAILED'].includes(c.status));
+                    if (incompleteTasks.length > 0) {
+                        logger.warn({ planId: artifact.id, incompleteTasks: incompleteTasks.map((t) => t.id) }, 'Plan completed but has incomplete tasks — review needed');
+                        eventBus.emit('artifact.gate_checked', {
+                            artifactId: artifact.id,
+                            warning: `${incompleteTasks.length} incomplete tasks remain`,
+                            taskIds: incompleteTasks.map((t) => t.id),
+                        });
+                    }
+                },
+            });
+        }
+    }
+    // Effect 3: Defect CLOSED → 自动提取 Lesson (触发事件)
+    const defectDef = fsm.getDefinition('Defect');
+    if (defectDef) {
+        const verifyTx = defectDef.transitions.find((t) => t.from === 'FIXED' && t.action === 'verify');
+        if (verifyTx && !verifyTx.effects) {
+            verifyTx.effects = [];
+        }
+        if (verifyTx) {
+            verifyTx.effects.push({
+                name: 'trigger_lesson_extraction',
+                run: async (artifact) => {
+                    eventBus.emit('lesson.proposed', {
+                        defectId: artifact.id,
+                        trigger: 'defect_closed',
+                        rootCause: artifact.payload.rootCauseCategory,
+                    });
+                    logger.info({ defectId: artifact.id }, 'Lesson extraction triggered from closed defect');
+                },
+            });
+        }
+    }
+    logger.info('FSM effects wired successfully');
+}
+//# sourceMappingURL=EffectsWiring.js.map

package/dist/orchestration/EffectsWiring.js.map

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

package/dist/routing/ModelRouter.d.ts

@@ -0,0 +1,30 @@
+import type { IEventBus } from '../core/eventBus.js';
+export type ModelTier = 'fast' | 'balanced' | 'powerful' | 'local';
+export interface ModelConfig {
+    tier: ModelTier;
+    name: string;
+    maxTokens: number;
+    costPerMToken: number;
+}
+export declare const DEFAULT_MODELS: Record<ModelTier, ModelConfig>;
+export interface RoutingContext {
+    taskComplexity?: number;
+    artifactType?: string;
+    stepCount?: number;
+    previousFailures?: number;
+    budget?: 'low' | 'medium' | 'high';
+}
+export interface IModelRouter {
+    route(ctx: RoutingContext): ModelConfig;
+    getModels(): Record<ModelTier, ModelConfig>;
+    setModel(tier: ModelTier, config: ModelConfig): void;
+}
+export declare class ModelRouter implements IModelRouter {
+    private eventBus;
+    private models;
+    constructor(eventBus: IEventBus, models?: Partial<Record<ModelTier, ModelConfig>>);
+    route(ctx: RoutingContext): ModelConfig;
+    getModels(): Record<ModelTier, ModelConfig>;
+    setModel(tier: ModelTier, config: ModelConfig): void;
+    private explainRouting;
+}

package/dist/routing/ModelRouter.js

@@ -0,0 +1,69 @@
+// SCALE Engine — Model Router (W9)
+// 基于任务复杂度选择模型
+// 设计参考：docs/01-ARCHITECTURE.md §二 L4
+import { logger } from '../core/logger.js';
+export const DEFAULT_MODELS = {
+    fast: { tier: 'fast', name: 'claude-haiku', maxTokens: 200_000, costPerMToken: 0.25 },
+    balanced: { tier: 'balanced', name: 'claude-sonnet', maxTokens: 200_000, costPerMToken: 3.0 },
+    powerful: { tier: 'powerful', name: 'claude-opus', maxTokens: 200_000, costPerMToken: 15.0 },
+    local: { tier: 'local', name: 'local-llm', maxTokens: 32_000, costPerMToken: 0.0 },
+};
+export class ModelRouter {
+    eventBus;
+    models;
+    constructor(eventBus, models) {
+        this.eventBus = eventBus;
+        this.models = { ...DEFAULT_MODELS, ...models };
+    }
+    route(ctx) {
+        let tier;
+        // Rule 1: Budget override
+        if (ctx.budget === 'low') {
+            tier = 'fast';
+        }
+        else if (ctx.budget === 'high') {
+            tier = 'powerful';
+        }
+        // Rule 2: High complexity or repeated failures → powerful
+        else if ((ctx.taskComplexity ?? 0) > 0.7 || (ctx.previousFailures ?? 0) >= 2) {
+            tier = 'powerful';
+        }
+        // Rule 3: Simple tasks → fast
+        else if ((ctx.taskComplexity ?? 0.5) < 0.3 && (ctx.stepCount ?? 1) <= 2) {
+            tier = 'fast';
+        }
+        // Rule 4: Default → balanced
+        else {
+            tier = 'balanced';
+        }
+        const model = this.models[tier];
+        logger.debug({ ctx, selectedTier: tier, model: model.name }, 'Model routed');
+        this.eventBus.emit('tool.called', {
+            tool: 'ModelRouter',
+            routedTo: model.name,
+            tier,
+            reason: this.explainRouting(ctx, tier),
+        });
+        return model;
+    }
+    getModels() {
+        return { ...this.models };
+    }
+    setModel(tier, config) {
+        this.models[tier] = config;
+    }
+    explainRouting(ctx, tier) {
+        if (ctx.budget === 'low')
+            return 'budget=low → fast';
+        if (ctx.budget === 'high')
+            return 'budget=high → powerful';
+        if ((ctx.previousFailures ?? 0) >= 2)
+            return `${ctx.previousFailures} failures → powerful`;
+        if ((ctx.taskComplexity ?? 0) > 0.7)
+            return `complexity=${ctx.taskComplexity} → powerful`;
+        if ((ctx.taskComplexity ?? 0.5) < 0.3)
+            return `complexity=${ctx.taskComplexity} → fast`;
+        return `default → ${tier}`;
+    }
+}
+//# sourceMappingURL=ModelRouter.js.map

package/dist/routing/ModelRouter.js.map

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