@hongmaple0820/scale-engine 0.1.0

package/dist/core/eventBus.js

@@ -0,0 +1,158 @@
+// SCALE Engine — Event Bus
+// 系统的"神经系统"。所有模块通过它解耦。
+// 内存 pub/sub + JSONL 持久化 + 重放能力。
+// 设计参考：docs/03-CORE-MODULES.md §3.1
+import { logger } from './logger.js';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+export class EventBus {
+    handlers = new Map();
+    middlewares = [];
+    memoryRing = [];
+    maxRingSize = 1000;
+    seq = 0;
+    eventsDir;
+    constructor(opts = {}) {
+        this.eventsDir = opts.eventsDir ?? '.scale/events';
+        if (!existsSync(this.eventsDir))
+            mkdirSync(this.eventsDir, { recursive: true });
+    }
+    on(type, handler) {
+        if (!this.handlers.has(type))
+            this.handlers.set(type, new Set());
+        const handlers = this.handlers.get(type);
+        handlers.add(handler);
+        return { unsubscribe: () => { handlers.delete(handler); if (handlers.size === 0)
+                this.handlers.delete(type); } };
+    }
+    once(type, handler) {
+        const sub = this.on(type, (e) => { sub.unsubscribe(); handler(e); });
+    }
+    use(mw) { this.middlewares.push(mw); }
+    emit(type, payload, opts = {}) {
+        const event = Object.freeze({
+            id: this.generateId(),
+            type, timestamp: Date.now(),
+            sessionId: opts.sessionId ?? 'system',
+            actor: opts.actor ?? { kind: 'system', component: 'EventBus' },
+            artifactId: opts.artifactId, payload,
+            causedBy: opts.causedBy, correlationId: opts.correlationId,
+        });
+        let processed = event;
+        for (const mw of this.middlewares) {
+            processed = mw(processed);
+            if (!processed)
+                return event;
+        }
+        this.persist(processed);
+        this.pushToRing(processed);
+        this.dispatchAsync(processed);
+        return processed;
+    }
+    async emitAsync(type, payload, opts) {
+        const event = this.emit(type, payload, opts);
+        await this.dispatchSync(event);
+        return event;
+    }
+    async replay(filter, handler) {
+        for (const file of this.getEventFiles(filter)) {
+            const lines = readFileSync(file, 'utf-8').split('\n').filter(Boolean);
+            for (const line of lines) {
+                try {
+                    const event = JSON.parse(line);
+                    if (this.matchesFilter(event, filter))
+                        await handler(event);
+                }
+                catch (e) {
+                    logger.warn({ file, error: e.message }, 'Failed to parse event');
+                }
+            }
+        }
+    }
+    async query(filter) {
+        const results = [];
+        const limit = filter.limit ?? 1000;
+        for (let i = this.memoryRing.length - 1; i >= 0; i--) {
+            const event = this.memoryRing[i];
+            if (this.matchesFilter(event, filter) && (!filter.filter || filter.filter(event))) {
+                results.push(event);
+                if (results.length >= limit)
+                    return results;
+            }
+        }
+        if (results.length < limit) {
+            await this.replay(filter, (event) => {
+                if (results.length >= limit)
+                    return;
+                if (!filter.filter || filter.filter(event)) {
+                    if (!results.find((r) => r.id === event.id))
+                        results.push(event);
+                }
+            });
+        }
+        return results.slice(0, limit);
+    }
+    async flush() { }
+    generateId() {
+        this.seq = (this.seq + 1) % 100000;
+        return `EVT-${Date.now()}-${this.seq.toString().padStart(5, '0')}`;
+    }
+    persist(event) {
+        const date = new Date(event.timestamp).toISOString().slice(0, 10);
+        const file = join(this.eventsDir, `${date}.jsonl`);
+        try {
+            appendFileSync(file, JSON.stringify(event) + '\n', 'utf-8');
+        }
+        catch (e) {
+            logger.error({ event: event.id, error: e.message }, 'Failed to persist event');
+        }
+    }
+    pushToRing(event) {
+        this.memoryRing.push(event);
+        if (this.memoryRing.length > this.maxRingSize)
+            this.memoryRing.shift();
+    }
+    dispatchAsync(event) { setImmediate(() => this.dispatchSync(event)); }
+    async dispatchSync(event) {
+        const handlers = [...(this.handlers.get(event.type) ?? []), ...(this.handlers.get('*') ?? [])];
+        for (const handler of handlers) {
+            try {
+                await handler(event);
+            }
+            catch (e) {
+                logger.error({ event: event.id, type: event.type, error: e.message }, 'Event handler threw');
+            }
+        }
+    }
+    getEventFiles(filter) {
+        if (!existsSync(this.eventsDir))
+            return [];
+        const all = readdirSync(this.eventsDir).filter((f) => f.endsWith('.jsonl')).sort();
+        if (!filter.fromTimestamp && !filter.toTimestamp)
+            return all.map((f) => join(this.eventsDir, f));
+        return all.filter((f) => {
+            const date = f.replace('.jsonl', '');
+            const fileStart = new Date(date).getTime();
+            const fileEnd = fileStart + 24 * 60 * 60 * 1000;
+            if (filter.fromTimestamp && fileEnd < filter.fromTimestamp)
+                return false;
+            if (filter.toTimestamp && fileStart > filter.toTimestamp)
+                return false;
+            return true;
+        }).map((f) => join(this.eventsDir, f));
+    }
+    matchesFilter(event, filter) {
+        if (filter.fromTimestamp && event.timestamp < filter.fromTimestamp)
+            return false;
+        if (filter.toTimestamp && event.timestamp > filter.toTimestamp)
+            return false;
+        if (filter.types && !filter.types.includes(event.type))
+            return false;
+        if (filter.sessionId && event.sessionId !== filter.sessionId)
+            return false;
+        if (filter.artifactId && event.artifactId !== filter.artifactId)
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=eventBus.js.map

package/dist/core/eventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../src/core/eventBus.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,uBAAuB;AACvB,iCAAiC;AACjC,oCAAoC;AAGpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAuChC,MAAM,OAAO,QAAQ;IACX,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAA;IACxD,WAAW,GAAsB,EAAE,CAAA;IACnC,UAAU,GAAY,EAAE,CAAA;IACxB,WAAW,GAAG,IAAI,CAAA;IAClB,GAAG,GAAG,CAAC,CAAA;IACP,SAAS,CAAQ;IAEzB,YAAY,OAA+B,EAAE;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,eAAe,CAAA;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;IAED,EAAE,CAAI,IAAqB,EAAE,OAAwB;QACnD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAA;QACzC,QAAQ,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAA;QACrC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA,CAAC,CAAC,EAAE,CAAA;IACjI,CAAC;IAED,IAAI,CAAI,IAAe,EAAE,OAAwB;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAI,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,GAAG,CAAC,EAAmB,IAAU,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC;IAE5D,IAAI,CAAI,IAAe,EAAE,OAAU,EAAE,OAAoB,EAAE;QACzD,MAAM,KAAK,GAAa,MAAM,CAAC,MAAM,CAAC;YACpC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE;YAC9D,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa;SAC3D,CAAC,CAAA;QACF,IAAI,SAAS,GAAoB,KAAK,CAAA;QACtC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAoB,CAAA;YAC5C,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAA;QAC9B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAA;QAClF,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,IAAe,EAAE,OAAU,EAAE,IAAkB;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAC5C,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,OAAqB;QACtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACrE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAA;oBACvC,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;wBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC7D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAA;gBAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,MAAM,OAAO,GAAY,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAA;QAClC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAChC,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;oBAAE,OAAO,OAAO,CAAA;YAClE,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;oBAAE,OAAM;gBACnC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;wBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAClE,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,KAAsC,CAAC;IAE1C,UAAU;QAChB,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;QAClC,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;IACpE,CAAC;IAEO,OAAO,CAAC,KAAY;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAA;QAClD,IAAI,CAAC;YAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAAC,CAAC;QACnE,OAAO,CAAC,EAAE,CAAC;YAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,yBAAyB,CAAC,CAAA;QAAC,CAAC;IACzG,CAAC;IAEO,UAAU,CAAC,KAAY;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACxE,CAAC;IAEO,aAAa,CAAC,KAAY,IAAU,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC,CAAC;IAElF,KAAK,CAAC,YAAY,CAAC,KAAY;QACrC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC9F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;YAC5B,OAAO,CAAC,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAA;YAAC,CAAC;QACvH,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,MAAoB;QACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAA;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAClF,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;QAChG,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;YACpC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;YAC1C,MAAM,OAAO,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;YAC/C,IAAI,MAAM,CAAC,aAAa,IAAI,OAAO,GAAG,MAAM,CAAC,aAAa;gBAAE,OAAO,KAAK,CAAA;YACxE,IAAI,MAAM,CAAC,WAAW,IAAI,SAAS,GAAG,MAAM,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAA;YACtE,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC;IAEO,aAAa,CAAC,KAAY,EAAE,MAAoB;QACtD,IAAI,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,aAAa;YAAE,OAAO,KAAK,CAAA;QAChF,IAAI,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAA;QAC5E,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QACpE,IAAI,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;YAAE,OAAO,KAAK,CAAA;QAC1E,IAAI,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAA;QAC7E,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/core/logger.d.ts

@@ -0,0 +1,3 @@
+import pino from 'pino';
+export declare const logger: pino.Logger<never, boolean>;
+export type Logger = typeof logger;

package/dist/core/logger.js

@@ -0,0 +1,12 @@
+// SCALE Engine — Logger
+import pino from 'pino';
+export const logger = pino({
+    level: process.env.SCALE_LOG_LEVEL ?? 'info',
+    transport: process.env.NODE_ENV === 'production'
+        ? undefined
+        : {
+            target: 'pino-pretty',
+            options: { colorize: true, translateTime: 'HH:MM:ss.l' },
+        },
+});
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM;IAC5C,SAAS,EACP,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QACnC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE;SACzD;CACR,CAAC,CAAA"}

package/dist/evolution/BehaviorTracker.d.ts

@@ -0,0 +1,38 @@
+import type { IEventBus } from '../core/eventBus.js';
+export interface SessionMetrics {
+    sessionId: string;
+    duration: number;
+    toolCalls: number;
+    toolFailures: number;
+    bruteRetryCount: number;
+    blameShiftCount: number;
+    prematureDoneCount: number;
+    artifactsCreated: number;
+    rolesUsed: string[];
+    modelsUsed: Record<string, number>;
+}
+export interface IBehaviorTracker {
+    start(): void;
+    stop(): void;
+    getSessionMetrics(sessionId: string): Promise<SessionMetrics>;
+    detectPatterns(): Promise<unknown[]>;
+}
+export declare class BehaviorTracker implements IBehaviorTracker {
+    private eventBus;
+    private subs;
+    private metrics;
+    constructor(eventBus: IEventBus);
+    start(): void;
+    stop(): void;
+    getSessionMetrics(sessionId: string): Promise<SessionMetrics>;
+    detectPatterns(): Promise<unknown[]>;
+    private getOrCreate;
+    private createEmptyMetrics;
+    private onToolCalled;
+    private onToolFailed;
+    private onBruteRetry;
+    private onBlameShift;
+    private onPrematureDone;
+    private onArtifactCreated;
+    private onRoleActivated;
+}

package/dist/evolution/BehaviorTracker.js

@@ -0,0 +1,52 @@
+// SCALE Engine — Behavior Tracker (W10 完整实现)
+// 订阅事件流，统计指标，发现模式
+// 设计参考：docs/03-CORE-MODULES.md §3.7
+import { logger } from '../core/logger.js';
+export class BehaviorTracker {
+    eventBus;
+    subs = [];
+    metrics = new Map();
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    start() {
+        this.subs.push(this.eventBus.on('tool.called', (e) => this.onToolCalled(e.sessionId, e.payload)), this.eventBus.on('tool.failed', (e) => this.onToolFailed(e.sessionId)), this.eventBus.on('behavior.brute_retry', (e) => this.onBruteRetry(e.sessionId)), this.eventBus.on('behavior.blame_shift', (e) => this.onBlameShift(e.sessionId)), this.eventBus.on('behavior.premature_done', (e) => this.onPrematureDone(e.sessionId)), this.eventBus.on('artifact.created', (e) => this.onArtifactCreated(e.sessionId)), this.eventBus.on('role.activated', (e) => this.onRoleActivated(e.sessionId, e.payload.role)));
+        logger.info('BehaviorTracker started');
+    }
+    stop() {
+        for (const sub of this.subs)
+            sub.unsubscribe();
+        this.subs = [];
+    }
+    async getSessionMetrics(sessionId) {
+        return this.metrics.get(sessionId) ?? this.createEmptyMetrics(sessionId);
+    }
+    async detectPatterns() {
+        // W10 实现
+        return [];
+    }
+    getOrCreate(sessionId) {
+        if (!this.metrics.has(sessionId))
+            this.metrics.set(sessionId, this.createEmptyMetrics(sessionId));
+        return this.metrics.get(sessionId);
+    }
+    createEmptyMetrics(sessionId) {
+        return {
+            sessionId, duration: 0, toolCalls: 0, toolFailures: 0,
+            bruteRetryCount: 0, blameShiftCount: 0, prematureDoneCount: 0,
+            artifactsCreated: 0, rolesUsed: [], modelsUsed: {},
+        };
+    }
+    onToolCalled(sessionId, _payload) { this.getOrCreate(sessionId).toolCalls += 1; }
+    onToolFailed(sessionId) { this.getOrCreate(sessionId).toolFailures += 1; }
+    onBruteRetry(sessionId) { this.getOrCreate(sessionId).bruteRetryCount += 1; }
+    onBlameShift(sessionId) { this.getOrCreate(sessionId).blameShiftCount += 1; }
+    onPrematureDone(sessionId) { this.getOrCreate(sessionId).prematureDoneCount += 1; }
+    onArtifactCreated(sessionId) { this.getOrCreate(sessionId).artifactsCreated += 1; }
+    onRoleActivated(sessionId, role) {
+        const m = this.getOrCreate(sessionId);
+        if (!m.rolesUsed.includes(role))
+            m.rolesUsed.push(role);
+    }
+}
+//# sourceMappingURL=BehaviorTracker.js.map

package/dist/evolution/BehaviorTracker.js.map

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

package/dist/evolution/EvolutionEngine.d.ts

@@ -0,0 +1,99 @@
+import type { IEventBus } from '../core/eventBus.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import type { IArtifactStore } from '../artifact/store.js';
+import type { ArtifactId, KnowledgeEntry } from '../artifact/types.js';
+export interface ProposedRule {
+    id: string;
+    title: string;
+    description: string;
+    sourceLesson: string;
+    pattern: string;
+    enforcement: 'prompt' | 'hook';
+    createdAt: number;
+    approved: boolean;
+    approvedBy?: string;
+}
+export interface GeneratedHook {
+    id: string;
+    ruleId: string;
+    hookType: 'PreToolUse' | 'PostToolUse' | 'Stop';
+    matcher: string;
+    scriptPath: string;
+    createdAt: number;
+}
+export interface EvolutionStats {
+    lessonsExtracted: number;
+    rulesProposed: number;
+    rulesApproved: number;
+    hooksGenerated: number;
+}
+export interface ILessonExtractor {
+    extract(defectId: ArtifactId): Promise<KnowledgeEntry | null>;
+    scanForPatterns(): Promise<KnowledgeEntry[]>;
+}
+export declare class LessonExtractor implements ILessonExtractor {
+    private store;
+    private kb;
+    private eventBus;
+    constructor(store: IArtifactStore, kb: IKnowledgeBase, eventBus: IEventBus);
+    /**
+     * 从已关闭的 Defect 中提取 Lesson
+     * Gate 1: Defect 必须在 DIAGNOSED/FIXED/CLOSED 状态
+     * Gate 2: 必须有 rootCauseCategory
+     * Gate 3: 不重复（标题相似度检查）
+     */
+    extract(defectId: ArtifactId): Promise<KnowledgeEntry | null>;
+    /**
+     * 扫描所有已关闭的 Defect，批量提取 lessons
+     */
+    scanForPatterns(): Promise<KnowledgeEntry[]>;
+    private similarity;
+}
+export interface IRuleProposer {
+    proposeFromLesson(lessonId: string): Promise<ProposedRule | null>;
+    scanAndPropose(): Promise<ProposedRule[]>;
+    approve(ruleId: string, approvedBy: string): Promise<ProposedRule>;
+    getProposedRules(): ProposedRule[];
+    writeRuleFile(rule: ProposedRule, rulesDir: string): string;
+}
+export declare class RuleProposer implements IRuleProposer {
+    private kb;
+    private eventBus;
+    private rules;
+    private seq;
+    constructor(kb: IKnowledgeBase, eventBus: IEventBus);
+    proposeFromLesson(lessonId: string): Promise<ProposedRule | null>;
+    scanAndPropose(): Promise<ProposedRule[]>;
+    approve(ruleId: string, approvedBy: string): Promise<ProposedRule>;
+    getProposedRules(): ProposedRule[];
+    writeRuleFile(rule: ProposedRule, rulesDir: string): string;
+}
+export interface IHookGenerator {
+    generate(rule: ProposedRule, hooksDir: string): GeneratedHook | null;
+    getGeneratedHooks(): GeneratedHook[];
+}
+export declare class HookGenerator implements IHookGenerator {
+    private eventBus;
+    private hooks;
+    constructor(eventBus: IEventBus);
+    generate(rule: ProposedRule, hooksDir: string): GeneratedHook | null;
+    getGeneratedHooks(): GeneratedHook[];
+    private inferHookType;
+    private inferMatcher;
+}
+export declare class EvolutionEngine {
+    private extractor;
+    private proposer;
+    private generator;
+    private scaleDir;
+    private eventBus;
+    constructor(extractor: ILessonExtractor, proposer: IRuleProposer, generator: IHookGenerator, eventBus: IEventBus, scaleDir?: string);
+    /**
+     * 完整进化周期：
+     * 1. 扫描 Defects → 提取 Lessons
+     * 2. 扫描 Lessons → 提议 Rules
+     * 3. (人审后) 已批准 Rules → 生成 Hooks
+     */
+    runCycle(): Promise<EvolutionStats>;
+    getStats(): EvolutionStats;
+}