@nahisaho/musubix-library-learner 2.1.0 → 2.2.0

package/dist/EnhancedLibraryLearner.d.ts

@@ -0,0 +1,159 @@
+/**
+ * EnhancedLibraryLearner - v2.2.0 Integrated Library Learning
+ * @module @nahisaho/musubix-library-learner
+ * @see TSK-LL-109
+ * @see DES-LL-109
+ *
+ * v2.2.0コンポーネントを統合した拡張LibraryLearner
+ * - HierarchyManager: 階層的パターン管理
+ * - TypeDirectedPruner: 型指向プルーニング
+ * - RewriteRuleSet: 書き換えルール最適化
+ * - IncrementalUpdater: 高速インクリメンタル更新
+ */
+import type { CodeCorpus, LearnResult, Specification, SynthesizeOptions, SynthesisResult, LibraryStats, LibraryLearnerConfig, LearnedPattern } from './types.js';
+import { type HierarchyManager, type HierarchyMetrics } from './hierarchy/HierarchyManager.js';
+import { type TypeDirectedPruner } from './search/TypeDirectedPruner.js';
+import { type RewriteRuleSet } from './rewrite/RewriteRuleSet.js';
+import { type IncrementalUpdater, type FileChange, type UpdateResult } from './updater/IncrementalUpdater.js';
+/**
+ * Enhanced configuration with v2.2.0 options
+ */
+export interface EnhancedLibraryLearnerConfig extends LibraryLearnerConfig {
+    /** Enable hierarchy management (default: true) */
+    enableHierarchyManagement?: boolean;
+    /** Enable type-directed search (default: true) */
+    enableTypedSearch?: boolean;
+    /** Enable rewrite rules (default: true) */
+    enableRewriteRules?: boolean;
+    /** Enable incremental updates (default: true) */
+    enableIncrementalUpdate?: boolean;
+}
+/**
+ * Type-constrained synthesis specification
+ */
+export interface TypedSpecification {
+    /** Description of desired function */
+    description: string;
+    /** Input types */
+    inputTypes: string[];
+    /** Output type */
+    outputType: string;
+    /** Optional examples */
+    examples?: Array<{
+        input: unknown[];
+        output: unknown;
+    }>;
+}
+/**
+ * Search statistics
+ */
+export interface SearchStats {
+    /** Candidates examined */
+    candidatesExamined: number;
+    /** Candidates pruned */
+    candidatesPruned: number;
+    /** Search time in ms */
+    searchTimeMs: number;
+}
+/**
+ * Type-directed synthesis result
+ */
+export interface TypedSynthesisResult extends SynthesisResult {
+    /** Search statistics */
+    searchStats: SearchStats;
+}
+/**
+ * Optimization result
+ */
+export interface OptimizationResult {
+    /** Original program */
+    original: string;
+    /** Optimized program */
+    optimized: string;
+    /** Number of rewrites applied */
+    rewritesApplied: number;
+    /** Optimization time in ms */
+    optimizationTimeMs: number;
+}
+/**
+ * Enhanced statistics
+ */
+export interface EnhancedStats {
+    /** Basic library stats */
+    basic: LibraryStats;
+    /** Hierarchy metrics */
+    hierarchy: HierarchyMetrics;
+    /** Rewrite rule stats */
+    rewrite: {
+        ruleCount: number;
+        totalApplications: number;
+    };
+    /** Incremental update stats */
+    incremental: {
+        totalChanges: number;
+        averageTimeMs: number;
+    };
+}
+/**
+ * EnhancedLibraryLearner interface
+ */
+export interface EnhancedLibraryLearner {
+    learnFromCorpus(corpus: CodeCorpus): Promise<LearnResult>;
+    learnIncremental(code: string): Promise<void>;
+    synthesize(spec: Specification, options?: SynthesizeOptions): Promise<SynthesisResult>;
+    getStats(): Promise<LibraryStats>;
+    exportLibrary(): Promise<LearnedPattern[]>;
+    importLibrary(patterns: LearnedPattern[]): Promise<void>;
+    learnFromCode(code: string): Promise<LearnResult>;
+    synthesizeWithTypes(spec: TypedSpecification): Promise<TypedSynthesisResult>;
+    optimizeWithRewrites(program: string): Promise<OptimizationResult>;
+    processFileChange(change: FileChange): Promise<UpdateResult>;
+    getHierarchyManager(): HierarchyManager;
+    getTypePruner(): TypeDirectedPruner;
+    getRewriteRules(): RewriteRuleSet;
+    getIncrementalUpdater(): IncrementalUpdater;
+    getHierarchyMetrics(): HierarchyMetrics;
+    getEnhancedStats(): Promise<EnhancedStats>;
+    toJSON(): string;
+    fromJSON(json: string): void;
+}
+/**
+ * Default implementation of EnhancedLibraryLearner
+ */
+declare class DefaultEnhancedLibraryLearner implements EnhancedLibraryLearner {
+    private config;
+    private baseLearner;
+    private hierarchyManager;
+    private typePruner;
+    private rewriteRules;
+    private incrementalUpdater;
+    private rewriteApplications;
+    private lastHierarchyMetrics;
+    constructor(config?: EnhancedLibraryLearnerConfig);
+    learnFromCorpus(corpus: CodeCorpus): Promise<LearnResult>;
+    learnIncremental(code: string): Promise<void>;
+    synthesize(spec: Specification, options?: SynthesizeOptions): Promise<SynthesisResult>;
+    getStats(): Promise<LibraryStats>;
+    exportLibrary(): Promise<LearnedPattern[]>;
+    importLibrary(patterns: LearnedPattern[]): Promise<void>;
+    learnFromCode(code: string): Promise<LearnResult>;
+    synthesizeWithTypes(spec: TypedSpecification): Promise<TypedSynthesisResult>;
+    optimizeWithRewrites(program: string): Promise<OptimizationResult>;
+    processFileChange(change: FileChange): Promise<UpdateResult>;
+    getHierarchyManager(): HierarchyManager;
+    getTypePruner(): TypeDirectedPruner;
+    getRewriteRules(): RewriteRuleSet;
+    getIncrementalUpdater(): IncrementalUpdater;
+    getHierarchyMetrics(): HierarchyMetrics;
+    getEnhancedStats(): Promise<EnhancedStats>;
+    toJSON(): string;
+    fromJSON(json: string): void;
+}
+/**
+ * Create an EnhancedLibraryLearner instance
+ * @param config - Optional configuration
+ * @returns EnhancedLibraryLearner instance
+ */
+export declare function createEnhancedLibraryLearner(config?: EnhancedLibraryLearnerConfig): EnhancedLibraryLearner;
+export { DefaultEnhancedLibraryLearner };
+//# sourceMappingURL=EnhancedLibraryLearner.d.ts.map

package/dist/EnhancedLibraryLearner.d.ts.map

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

package/dist/EnhancedLibraryLearner.js

@@ -0,0 +1,296 @@
+/**
+ * EnhancedLibraryLearner - v2.2.0 Integrated Library Learning
+ * @module @nahisaho/musubix-library-learner
+ * @see TSK-LL-109
+ * @see DES-LL-109
+ *
+ * v2.2.0コンポーネントを統合した拡張LibraryLearner
+ * - HierarchyManager: 階層的パターン管理
+ * - TypeDirectedPruner: 型指向プルーニング
+ * - RewriteRuleSet: 書き換えルール最適化
+ * - IncrementalUpdater: 高速インクリメンタル更新
+ */
+import { createLibraryLearner } from './LibraryLearner.js';
+import { createHierarchyManager, } from './hierarchy/HierarchyManager.js';
+import { createTypeDirectedPruner, } from './search/TypeDirectedPruner.js';
+import { createRewriteRuleSet, } from './rewrite/RewriteRuleSet.js';
+import { createIncrementalUpdater, } from './updater/IncrementalUpdater.js';
+// =============================================================================
+// Default Implementation
+// =============================================================================
+/**
+ * Default implementation of EnhancedLibraryLearner
+ */
+class DefaultEnhancedLibraryLearner {
+    config;
+    baseLearner;
+    hierarchyManager;
+    typePruner;
+    rewriteRules;
+    incrementalUpdater;
+    rewriteApplications = 0;
+    lastHierarchyMetrics = {
+        extractionTimeMs: 0,
+        patternsPerLevel: [],
+        compressionRatio: 1.0,
+        totalPatternsRaw: 0,
+        totalPatternsAbstracted: 0,
+    };
+    constructor(config = {}) {
+        this.config = {
+            abstractionLevels: config.abstractionLevels ?? 3,
+            minOccurrences: config.minOccurrences ?? 2,
+            decayRate: config.decayRate ?? 0.95,
+            pruneThreshold: config.pruneThreshold ?? 0.1,
+            useEGraph: config.useEGraph ?? true,
+            storagePath: config.storagePath ?? '.musubix/library',
+            enableHierarchyManagement: config.enableHierarchyManagement ?? true,
+            enableTypedSearch: config.enableTypedSearch ?? true,
+            enableRewriteRules: config.enableRewriteRules ?? true,
+            enableIncrementalUpdate: config.enableIncrementalUpdate ?? true,
+        };
+        // Initialize base learner
+        this.baseLearner = createLibraryLearner({
+            abstractionLevels: this.config.abstractionLevels,
+            minOccurrences: this.config.minOccurrences,
+            decayRate: this.config.decayRate,
+            pruneThreshold: this.config.pruneThreshold,
+            useEGraph: this.config.useEGraph,
+            storagePath: this.config.storagePath,
+        });
+        // Initialize v2.2.0 components
+        this.hierarchyManager = createHierarchyManager({
+            maxLevels: this.config.abstractionLevels,
+            promotionThreshold: 10,
+        });
+        this.typePruner = createTypeDirectedPruner({
+            maxCandidates: 100,
+            enableGenerics: true,
+        });
+        this.rewriteRules = createRewriteRuleSet({
+            maxIterations: 10,
+            enableBuiltinRules: true,
+        });
+        this.incrementalUpdater = createIncrementalUpdater({
+            enableParallelProcessing: true,
+            maxCacheSize: 1000,
+        });
+    }
+    // =========================================================================
+    // Base Functionality
+    // =========================================================================
+    async learnFromCorpus(corpus) {
+        return this.baseLearner.learnFromCorpus(corpus);
+    }
+    async learnIncremental(code) {
+        return this.baseLearner.learnIncremental(code);
+    }
+    async synthesize(spec, options) {
+        return this.baseLearner.synthesize(spec, options);
+    }
+    async getStats() {
+        return this.baseLearner.getStats();
+    }
+    async exportLibrary() {
+        return this.baseLearner.exportLibrary();
+    }
+    async importLibrary(patterns) {
+        return this.baseLearner.importLibrary(patterns);
+    }
+    // =========================================================================
+    // v2.2.0 Enhanced Methods
+    // =========================================================================
+    async learnFromCode(code) {
+        const corpus = {
+            id: `code-${Date.now()}`,
+            files: [
+                {
+                    path: 'input.ts',
+                    content: code,
+                    language: 'typescript',
+                },
+            ],
+        };
+        const result = await this.learnFromCorpus(corpus);
+        // Update hierarchy if enabled
+        if (this.config.enableHierarchyManagement) {
+            const hierarchyResult = await this.hierarchyManager.extractHierarchy(corpus);
+            this.lastHierarchyMetrics = hierarchyResult.metrics;
+        }
+        return result;
+    }
+    async synthesizeWithTypes(spec) {
+        const startTime = Date.now();
+        let candidatesExamined = 0;
+        let candidatesPruned = 0;
+        // Get all patterns
+        const patterns = await this.exportLibrary();
+        candidatesExamined = patterns.length;
+        // Apply type-directed pruning if enabled
+        if (this.config.enableTypedSearch) {
+            // Create type signature from spec
+            const targetSignature = {
+                kind: 'function',
+                params: spec.inputTypes,
+                returns: spec.outputType,
+            };
+            // Prune candidates using type pruner
+            const candidates = patterns.map((p) => ({
+                id: p.id,
+                ast: (typeof p.content === 'object' && p.content !== null && 'ast' in p.content
+                    ? p.content.ast
+                    : { type: 'unknown' }),
+                typeSignature: {
+                    kind: 'function',
+                    params: spec.inputTypes,
+                    returns: spec.outputType,
+                },
+                score: p.confidence,
+            }));
+            const pruneResult = await this.typePruner.prune(candidates, targetSignature);
+            candidatesPruned = candidates.length - pruneResult.candidates.length;
+        }
+        // Perform synthesis
+        const inputTypes = spec.inputTypes.map((t) => ({
+            kind: 'primitive',
+            name: t,
+        }));
+        const baseSpec = {
+            description: spec.description,
+            examples: spec.examples ?? [],
+            type: {
+                kind: 'function',
+                paramTypes: inputTypes,
+                returnType: { kind: 'primitive', name: spec.outputType },
+            },
+        };
+        const result = await this.synthesize(baseSpec);
+        return {
+            ...result,
+            searchStats: {
+                candidatesExamined,
+                candidatesPruned,
+                searchTimeMs: Date.now() - startTime,
+            },
+        };
+    }
+    async optimizeWithRewrites(program) {
+        const startTime = Date.now();
+        let rewritesApplied = 0;
+        if (!this.config.enableRewriteRules) {
+            return {
+                original: program,
+                optimized: program,
+                rewritesApplied: 0,
+                optimizationTimeMs: Date.now() - startTime,
+            };
+        }
+        // Convert program string to a simple AST node for rewriting
+        const programAst = { type: 'Program', content: program };
+        // Apply rewrites
+        const result = this.rewriteRules.rewrite(programAst);
+        if (result.changed) {
+            rewritesApplied = result.rulesApplied.length;
+        }
+        this.rewriteApplications += rewritesApplied;
+        // Extract optimized content
+        const optimized = result.changed && 'content' in result.rewritten
+            ? String(result.rewritten['content'])
+            : program;
+        return {
+            original: program,
+            optimized,
+            rewritesApplied,
+            optimizationTimeMs: Date.now() - startTime,
+        };
+    }
+    async processFileChange(change) {
+        if (!this.config.enableIncrementalUpdate) {
+            return {
+                success: true,
+                changeType: change.changeType,
+                processingTimeMs: 0,
+                affectedPatterns: [],
+                dependentFiles: [],
+                cacheHit: false,
+            };
+        }
+        return this.incrementalUpdater.processChange(change);
+    }
+    // =========================================================================
+    // Component Access
+    // =========================================================================
+    getHierarchyManager() {
+        return this.hierarchyManager;
+    }
+    getTypePruner() {
+        return this.typePruner;
+    }
+    getRewriteRules() {
+        return this.rewriteRules;
+    }
+    getIncrementalUpdater() {
+        return this.incrementalUpdater;
+    }
+    // =========================================================================
+    // Enhanced Stats
+    // =========================================================================
+    getHierarchyMetrics() {
+        // Return cached metrics from last extraction, or default if no extraction yet
+        return this.lastHierarchyMetrics;
+    }
+    async getEnhancedStats() {
+        const basicStats = await this.getStats();
+        const hierarchyMetrics = this.lastHierarchyMetrics;
+        const incrementalStats = this.incrementalUpdater.getStatistics();
+        return {
+            basic: basicStats,
+            hierarchy: hierarchyMetrics,
+            rewrite: {
+                ruleCount: this.rewriteRules.getRuleCount(),
+                totalApplications: this.rewriteApplications,
+            },
+            incremental: {
+                totalChanges: incrementalStats.totalChangesProcessed,
+                averageTimeMs: incrementalStats.averageProcessingTimeMs,
+            },
+        };
+    }
+    // =========================================================================
+    // Serialization
+    // =========================================================================
+    toJSON() {
+        return JSON.stringify({
+            // IncrementalUpdater has toJSON/fromJSON
+            incrementalState: this.incrementalUpdater.toJSON(),
+            rewriteApplications: this.rewriteApplications,
+            lastHierarchyMetrics: this.lastHierarchyMetrics,
+        });
+    }
+    fromJSON(json) {
+        const data = JSON.parse(json);
+        // IncrementalUpdater has fromJSON
+        if (data.incrementalState) {
+            this.incrementalUpdater.fromJSON(data.incrementalState);
+        }
+        if (data.rewriteApplications !== undefined) {
+            this.rewriteApplications = data.rewriteApplications;
+        }
+        if (data.lastHierarchyMetrics) {
+            this.lastHierarchyMetrics = data.lastHierarchyMetrics;
+        }
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create an EnhancedLibraryLearner instance
+ * @param config - Optional configuration
+ * @returns EnhancedLibraryLearner instance
+ */
+export function createEnhancedLibraryLearner(config = {}) {
+    return new DefaultEnhancedLibraryLearner(config);
+}
+export { DefaultEnhancedLibraryLearner };
+//# sourceMappingURL=EnhancedLibraryLearner.js.map

package/dist/EnhancedLibraryLearner.js.map

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