@jclaw/core 0.1.0

package/dist/evolution/memory.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 进化记忆管理器
+ *
+ * 保存进化历史，让后续进化能利用之前的经验
+ *
+ * @module @jclaw/core/evolution/memory
+ */
+import type { Gene, EvolutionResult } from './types.js';
+import type { ContextManager } from '../types.js';
+/**
+ * 进化记忆条目
+ */
+export interface EvolutionMemory {
+    /** 原始代码哈希 */
+    codeHash: string;
+    /** 使用的策略 */
+    strategy: string;
+    /** 进化结果 */
+    result: {
+        fitness: number;
+        description: string;
+        improved: boolean;
+    };
+    /** 时间戳 */
+    timestamp: number;
+    /** 基因数据 */
+    gene?: Gene;
+}
+/**
+ * 进化记忆配置
+ */
+export interface EvolutionMemoryConfig {
+    /** 上下文管理器 (用于持久化) */
+    contextManager?: ContextManager;
+    /** 最大记忆条目 */
+    maxMemory?: number;
+}
+/**
+ * 进化记忆管理器
+ *
+ * 管理进化历史，支持：
+ * - 保存进化结果
+ * - 检索相关经验
+ * - 学习历史模式
+ *
+ * @example
+ * ```typescript
+ * const memory = new EvolutionMemoryManager(contextManager);
+ *
+ * // 保存进化结果
+ * await memory.remember(code, result);
+ *
+ * // 检索相关经验
+ * const experience = await memory.recall(code);
+ * ```
+ */
+export declare class EvolutionMemoryManager {
+    private memories;
+    private readonly config;
+    constructor(config?: EvolutionMemoryConfig);
+    /**
+     * 记住一次进化结果
+     */
+    remember(code: string, result: EvolutionResult): Promise<void>;
+    /**
+     * 回忆相关经验
+     */
+    recall(code: string): Promise<EvolutionMemory[]>;
+    /**
+     * 获取最佳实践（从历史中学习）
+     */
+    getBestPractices(): Map<string, {
+        strategy: string;
+        avgFitness: number;
+    }>;
+    /**
+     * 获取进化统计
+     */
+    getStats(): {
+        totalEvolutions: number;
+        successfulEvolutions: number;
+        avgFitness: number;
+        bestStrategy: string;
+    };
+    /**
+     * 导出记忆（用于 EvoMap 共享）
+     */
+    exportGenes(): Gene[];
+    /**
+     * 导入基因（从 EvoMap 或其他来源）
+     */
+    importGenes(genes: Gene[]): void;
+    /**
+     * 清除记忆
+     */
+    clear(): void;
+    private hashCode;
+    private isSimilar;
+    private toGene;
+    private syncToContext;
+}
+/**
+ * 创建进化记忆管理器
+ */
+export declare function createEvolutionMemory(config?: EvolutionMemoryConfig): EvolutionMemoryManager;
+//# sourceMappingURL=memory.d.ts.map

package/dist/evolution/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/evolution/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAY,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;gBAEU,MAAM,GAAE,qBAA0B;IAO9C;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYtD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAgDzE;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB;IAmCD;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAOrB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAiBhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,MAAM;YAYA,aAAa;CAe1B;AAGH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,sBAAsB,CAE5F"}

package/dist/evolution/memory.js

@@ -0,0 +1,232 @@
+/**
+ * 进化记忆管理器
+ *
+ * 保存进化历史，让后续进化能利用之前的经验
+ *
+ * @module @jclaw/core/evolution/memory
+ */
+/**
+ * 进化记忆管理器
+ *
+ * 管理进化历史，支持：
+ * - 保存进化结果
+ * - 检索相关经验
+ * - 学习历史模式
+ *
+ * @example
+ * ```typescript
+ * const memory = new EvolutionMemoryManager(contextManager);
+ *
+ * // 保存进化结果
+ * await memory.remember(code, result);
+ *
+ * // 检索相关经验
+ * const experience = await memory.recall(code);
+ * ```
+ */
+export class EvolutionMemoryManager {
+    memories = [];
+    config;
+    constructor(config = {}) {
+        this.config = {
+            maxMemory: 1000,
+            ...config,
+        };
+    }
+    /**
+     * 记住一次进化结果
+     */
+    async remember(code, result) {
+        const hash = this.hashCode(code);
+        for (const mutation of result.validatedMutations) {
+            const memory = {
+                codeHash: hash,
+                strategy: mutation.strategy,
+                result: {
+                    fitness: mutation.fitness ?? 0,
+                    description: mutation.description,
+                    improved: result.improved,
+                },
+                timestamp: Date.now(),
+                gene: this.toGene(mutation),
+            };
+            this.memories.push(memory);
+        }
+        // 限制记忆数量
+        if (this.memories.length > this.config.maxMemory) {
+            this.memories = this.memories.slice(-this.config.maxMemory);
+        }
+        // 同步到上下文管理器
+        if (this.config.contextManager) {
+            await this.syncToContext();
+        }
+    }
+    /**
+     * 回忆相关经验
+     */
+    async recall(code) {
+        const hash = this.hashCode(code);
+        // 查找相同或相似代码的进化历史
+        const related = this.memories.filter(m => m.codeHash === hash || this.isSimilar(m.codeHash, hash));
+        // 按适应度排序
+        return related.sort((a, b) => b.result.fitness - a.result.fitness);
+    }
+    /**
+     * 获取最佳实践（从历史中学习）
+     */
+    getBestPractices() {
+        const stats = new Map();
+        for (const memory of this.memories) {
+            const key = memory.codeHash.slice(0, 8);
+            const current = stats.get(key) || { total: 0, count: 0 };
+            stats.set(key, {
+                total: current.total + memory.result.fitness,
+                count: current.count + 1,
+            });
+        }
+        const best = new Map();
+        // 找出每个代码类型的最佳策略
+        const strategies = new Map();
+        for (const memory of this.memories) {
+            const key = memory.codeHash.slice(0, 8);
+            if (!strategies.has(key)) {
+                strategies.set(key, new Map());
+            }
+            const stratMap = strategies.get(key);
+            const strat = stratMap.get(memory.strategy) || { total: 0, count: 0 };
+            stratMap.set(memory.strategy, {
+                total: strat.total + memory.result.fitness,
+                count: strat.count + 1,
+            });
+        }
+        for (const [key, stratMap] of strategies) {
+            let bestStrat = '';
+            let bestAvg = 0;
+            for (const [strat, data] of stratMap) {
+                const avg = data.total / data.count;
+                if (avg > bestAvg) {
+                    bestAvg = avg;
+                    bestStrat = strat;
+                }
+            }
+            best.set(key, { strategy: bestStrat, avgFitness: bestAvg });
+        }
+        return best;
+    }
+    /**
+     * 获取进化统计
+     */
+    getStats() {
+        const total = this.memories.length;
+        const successful = this.memories.filter(m => m.result.improved).length;
+        const avgFitness = total > 0
+            ? this.memories.reduce((sum, m) => sum + m.result.fitness, 0) / total
+            : 0;
+        // 找出最佳策略
+        const strategyStats = new Map();
+        for (const m of this.memories) {
+            const current = strategyStats.get(m.strategy) || { total: 0, count: 0 };
+            strategyStats.set(m.strategy, {
+                total: current.total + m.result.fitness,
+                count: current.count + 1,
+            });
+        }
+        let bestStrategy = 'optimize';
+        let bestAvg = 0;
+        for (const [strat, data] of strategyStats) {
+            const avg = data.total / data.count;
+            if (avg > bestAvg) {
+                bestAvg = avg;
+                bestStrategy = strat;
+            }
+        }
+        return {
+            totalEvolutions: total,
+            successfulEvolutions: successful,
+            avgFitness,
+            bestStrategy,
+        };
+    }
+    /**
+     * 导出记忆（用于 EvoMap 共享）
+     */
+    exportGenes() {
+        return this.memories
+            .filter(m => m.gene && m.result.fitness > 0.7)
+            .map(m => m.gene)
+            .slice(-100); // 只导出最好的 100 个
+    }
+    /**
+     * 导入基因（从 EvoMap 或其他来源）
+     */
+    importGenes(genes) {
+        for (const gene of genes) {
+            const memory = {
+                codeHash: gene.id,
+                strategy: 'imported',
+                result: {
+                    fitness: gene.fitness,
+                    description: `Imported gene from generation ${gene.generation}`,
+                    improved: true,
+                },
+                timestamp: gene.createdAt.getTime(),
+                gene,
+            };
+            this.memories.push(memory);
+        }
+    }
+    /**
+     * 清除记忆
+     */
+    clear() {
+        this.memories = [];
+    }
+    // 私有方法
+    hashCode(code) {
+        let hash = 0;
+        const normalized = code.replace(/\s+/g, ' ').trim();
+        for (let i = 0; i < normalized.length; i++) {
+            const char = normalized.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(16);
+    }
+    isSimilar(hash1, hash2) {
+        // 简单的相似度判断：前4位相同
+        return hash1.slice(0, 4) === hash2.slice(0, 4);
+    }
+    toGene(mutation) {
+        return {
+            id: mutation.id,
+            type: 'behavior',
+            content: mutation.mutated,
+            fitness: mutation.fitness ?? 0,
+            generation: 1,
+            parents: [],
+            createdAt: mutation.createdAt,
+        };
+    }
+    async syncToContext() {
+        if (!this.config.contextManager)
+            return;
+        // 将进化记忆同步到上下文管理器
+        const summary = this.getStats();
+        const bestPractices = this.getBestPractices();
+        // const knowledge = ...
+        evolutionStats: summary,
+            bestPractices;
+        Object.fromEntries(bestPractices),
+            lastUpdated;
+        Date.now(),
+        ;
+    }
+    ;
+}
+/**
+ * 创建进化记忆管理器
+ */
+export function createEvolutionMemory(config) {
+    return new EvolutionMemoryManager(config);
+}
+//# sourceMappingURL=memory.js.map

package/dist/evolution/memory.js.map

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

package/dist/evolution/mutation.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Mutation Generator
+ *
+ * Generates code and behavior mutations for evolution.
+ *
+ * @module @jclaw/core/evolution/mutation
+ */
+import type { EvolutionStrategy, Mutation } from './types.js';
+import { LLMClient } from '../runtime/llm-client.js';
+/**
+ * Configuration for mutation generator
+ */
+export interface MutationGeneratorConfig {
+    /** LLM client for generating mutations */
+    llmClient: LLMClient;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Mutation Generator
+ *
+ * Uses LLM to generate code mutations based on different strategies.
+ *
+ * @example
+ * ```typescript
+ * const generator = new MutationGenerator({ llmClient });
+ * const mutations = await generator.generate(originalCode, ['repair', 'optimize']);
+ * ```
+ */
+export declare class MutationGenerator {
+    private readonly config;
+    /**
+     * Create a new mutation generator.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: MutationGeneratorConfig);
+    /**
+     * Generate mutations for the given code.
+     *
+     * @param code - The original code to mutate
+     * @param strategies - Evolution strategies to use
+     * @returns Array of generated mutations
+     */
+    generate(code: string, strategies: EvolutionStrategy[]): Promise<Mutation[]>;
+    /**
+     * Generate a single mutation using a specific strategy.
+     */
+    private generateSingle;
+    /**
+     * Generate a description for the mutation.
+     */
+    private generateDescription;
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    private log;
+}
+/**
+ * Create a new mutation generator.
+ *
+ * @param config - Configuration options
+ * @returns New MutationGenerator instance
+ */
+export declare function createMutationGenerator(config: MutationGeneratorConfig): MutationGenerator;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/evolution/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/evolution/mutation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAoB,MAAM,0BAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6BD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEF;;;;OAIG;gBACS,MAAM,EAAE,uBAAuB;IAO3C;;;;;;OAMG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAelF;;OAEG;YACW,cAAc;IAsB5B;;OAEG;YACW,mBAAmB;IAwBjC;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAE1F"}

package/dist/evolution/mutation.js

@@ -0,0 +1,139 @@
+/**
+ * Mutation Generator
+ *
+ * Generates code and behavior mutations for evolution.
+ *
+ * @module @jclaw/core/evolution/mutation
+ */
+/**
+ * Prompt templates for different strategies
+ */
+const STRATEGY_PROMPTS = {
+    repair: `You are a code repair specialist. Analyze the code and generate a repaired version that:
+1. Fixes any bugs or errors
+2. Maintains the original functionality
+3. Improves code quality where possible
+4. Keeps changes minimal and focused
+
+Return ONLY the repaired code, no explanations.`,
+    optimize: `You are a performance optimization specialist. Analyze the code and generate an optimized version that:
+1. Improves performance and efficiency
+2. Reduces complexity where possible
+3. Maintains exact same functionality
+4. Uses best practices and patterns
+
+Return ONLY the optimized code, no explanations.`,
+    innovate: `You are an innovation specialist. Analyze the code and generate an innovative version that:
+1. Introduces new approaches or patterns
+2. Explores alternative solutions
+3. Adds new capabilities or features
+4. Takes calculated risks while maintaining safety
+
+Return ONLY the innovative code, no explanations.`,
+};
+/**
+ * Mutation Generator
+ *
+ * Uses LLM to generate code mutations based on different strategies.
+ *
+ * @example
+ * ```typescript
+ * const generator = new MutationGenerator({ llmClient });
+ * const mutations = await generator.generate(originalCode, ['repair', 'optimize']);
+ * ```
+ */
+export class MutationGenerator {
+    config;
+    /**
+     * Create a new mutation generator.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        this.config = {
+            verbose: false,
+            ...config,
+        };
+    }
+    /**
+     * Generate mutations for the given code.
+     *
+     * @param code - The original code to mutate
+     * @param strategies - Evolution strategies to use
+     * @returns Array of generated mutations
+     */
+    async generate(code, strategies) {
+        const mutations = [];
+        for (const strategy of strategies) {
+            try {
+                const mutation = await this.generateSingle(code, strategy);
+                mutations.push(mutation);
+            }
+            catch (error) {
+                this.log(`Failed to generate ${strategy} mutation: ${error}`);
+            }
+        }
+        return mutations;
+    }
+    /**
+     * Generate a single mutation using a specific strategy.
+     */
+    async generateSingle(code, strategy) {
+        const messages = [
+            { role: 'system', content: STRATEGY_PROMPTS[strategy] },
+            { role: 'user', content: code },
+        ];
+        const response = await this.config.llmClient.chat(messages);
+        const mutated = response.content;
+        // Generate mutation description
+        const description = await this.generateDescription(code, mutated, strategy);
+        return {
+            id: `mutation-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+            strategy,
+            original: code,
+            mutated,
+            description,
+            createdAt: new Date(),
+        };
+    }
+    /**
+     * Generate a description for the mutation.
+     */
+    async generateDescription(original, mutated, strategy) {
+        const messages = [
+            {
+                role: 'system',
+                content: 'You are a technical writer. Describe the changes between two code snippets in one concise sentence.',
+            },
+            {
+                role: 'user',
+                content: `Original:\n\`\`\`\n${original}\n\`\`\`\n\nMutated (${strategy}):\n\`\`\`\n${mutated}\n\`\`\`\n\nDescribe the changes:`,
+            },
+        ];
+        try {
+            const response = await this.config.llmClient.chat(messages, { maxTokens: 100 });
+            return response.content.trim();
+        }
+        catch {
+            return `${strategy} mutation applied`;
+        }
+    }
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    log(message) {
+        if (this.config.verbose) {
+            console.log(`[MutationGenerator] ${message}`);
+        }
+    }
+}
+/**
+ * Create a new mutation generator.
+ *
+ * @param config - Configuration options
+ * @returns New MutationGenerator instance
+ */
+export function createMutationGenerator(config) {
+    return new MutationGenerator(config);
+}
+//# sourceMappingURL=mutation.js.map

package/dist/evolution/mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.js","sourceRoot":"","sources":["../../src/evolution/mutation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;GAEG;AACH,MAAM,gBAAgB,GAAsC;IAC1D,MAAM,EAAE;;;;;;gDAMsC;IAC9C,QAAQ,EAAE;;;;;;iDAMqC;IAC/C,QAAQ,EAAE;;;;;;kDAMsC;CACjD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IACX,MAAM,CAErB;IAEF;;;;OAIG;IACH,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,KAAK;YACd,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAA+B;QAC1D,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,sBAAsB,QAAQ,cAAc,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,QAA2B;QACpE,MAAM,QAAQ,GAAkB;YAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE;YACvD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;SAChC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAEjC,gCAAgC;QAChC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE5E,OAAO;YACL,EAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACnE,QAAQ;YACR,QAAQ,EAAE,IAAI;YACd,OAAO;YACP,WAAW;YACX,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,QAAgB,EAChB,OAAe,EACf,QAA2B;QAE3B,MAAM,QAAQ,GAAkB;YAC9B;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,qGAAqG;aAC/G;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,sBAAsB,QAAQ,wBAAwB,QAAQ,eAAe,OAAO,mCAAmC;aACjI;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAChF,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,QAAQ,mBAAmB,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/evolution/sandbox.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Sandbox Validator
+ *
+ * Validates mutations in an isolated environment.
+ *
+ * @module @jclaw/core/evolution/sandbox
+ */
+import type { Executor } from '../types.js';
+import type { Mutation, ValidationResult } from './types.js';
+/**
+ * Configuration for sandbox validator
+ */
+export interface SandboxConfig {
+    /** Command executor */
+    executor: Executor;
+    /** Validation timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Temporary directory for sandbox (default: os.tmpdir()) */
+    tempDir?: string;
+    /** Test command to run for validation */
+    testCommand?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Sandbox Validator
+ *
+ * Validates mutations by running tests in an isolated environment.
+ * Supports both local and docker execution modes.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = new SandboxValidator({
+ *   executor: localExecutor,
+ *   testCommand: 'npm test'
+ * });
+ *
+ * const result = await sandbox.validate(mutation);
+ * if (result.passed) {
+ *   console.log('Mutation is safe to apply');
+ * }
+ * ```
+ */
+export declare class SandboxValidator {
+    private readonly config;
+    /**
+     * Create a new sandbox validator.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: SandboxConfig);
+    /**
+     * Validate a mutation in the sandbox.
+     *
+     * @param mutation - The mutation to validate
+     * @param targetPath - Path to the target file to mutate (optional)
+     * @returns Validation result
+     */
+    validate(mutation: Mutation, targetPath?: string): Promise<ValidationResult>;
+    /**
+     * Validate multiple mutations.
+     *
+     * @param mutations - Mutations to validate
+     * @param targetPath - Target file path
+     * @returns Array of validation results
+     */
+    validateBatch(mutations: Mutation[], targetPath?: string): Promise<Map<string, ValidationResult>>;
+    /**
+     * Create a sandbox directory.
+     */
+    private createSandbox;
+    /**
+     * Apply mutation to the sandbox.
+     */
+    private applyMutation;
+    /**
+     * Run tests in the sandbox.
+     */
+    private runTests;
+    /**
+     * Cleanup sandbox directory.
+     */
+    private cleanup;
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    private log;
+}
+/**
+ * Create a new sandbox validator.
+ *
+ * @param config - Configuration options
+ * @returns New SandboxValidator instance
+ */
+export declare function createSandbox(config: SandboxConfig): SandboxValidator;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/evolution/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/evolution/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiE;IAExF;;;;OAIG;gBACS,MAAM,EAAE,aAAa;IAUjC;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiClF;;;;;;OAMG;IACG,aAAa,CACjB,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAWzC;;OAEG;YACW,aAAa;IAU3B;;OAEG;YACW,aAAa;IAc3B;;OAEG;YACW,QAAQ;IA0CtB;;OAEG;YACW,OAAO;IASrB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAErE"}