@nahisaho/musubix-core 1.0.9 → 1.0.13

package/dist/learning/feedback-collector.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Feedback Collector
+ *
+ * Collects and stores user feedback on generated artifacts
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @module @musubix/core/learning
+ */
+import type { Feedback, FeedbackType, ArtifactType, FeedbackContext, LearningConfig } from './types.js';
+/**
+ * Feedback input for creating new feedback
+ */
+export interface FeedbackInput {
+    type: FeedbackType;
+    artifactType: ArtifactType;
+    artifactId: string;
+    context?: Partial<FeedbackContext>;
+    reason?: string;
+    original?: string;
+    modified?: string;
+}
+/**
+ * Feedback query options
+ */
+export interface FeedbackQuery {
+    artifactType?: ArtifactType;
+    type?: FeedbackType;
+    project?: string;
+    language?: string;
+    framework?: string;
+    since?: Date;
+    limit?: number;
+}
+/**
+ * Feedback Collector class
+ *
+ * Responsible for collecting, storing, and querying user feedback
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @see REQ-LEARN-006 - Privacy Protection (local storage only)
+ */
+export declare class FeedbackCollector {
+    private feedbackCache;
+    private storagePath;
+    private loaded;
+    constructor(config?: Partial<LearningConfig>);
+    /**
+     * Record new feedback
+     *
+     * @see REQ-LEARN-001 - Feedback Collection
+     * @param input - Feedback input data
+     * @returns Created feedback with generated ID
+     */
+    recordFeedback(input: FeedbackInput): Promise<Feedback>;
+    /**
+     * Get feedback by ID
+     */
+    getFeedback(id: string): Promise<Feedback | undefined>;
+    /**
+     * Query feedback with filters
+     */
+    queryFeedback(query?: FeedbackQuery): Promise<Feedback[]>;
+    /**
+     * Get feedback statistics
+     */
+    getStats(): Promise<{
+        total: number;
+        byType: Record<FeedbackType, number>;
+        byArtifactType: Record<ArtifactType, number>;
+    }>;
+    /**
+     * Delete feedback by ID
+     */
+    deleteFeedback(id: string): Promise<boolean>;
+    /**
+     * Export all feedback
+     */
+    export(): Promise<Feedback[]>;
+    /**
+     * Import feedback from array
+     */
+    import(feedbackList: Feedback[]): Promise<number>;
+    /**
+     * Clear all feedback
+     */
+    clear(): Promise<void>;
+    /**
+     * Sanitize feedback to remove sensitive data
+     *
+     * @see REQ-LEARN-006 - Privacy Protection
+     */
+    private sanitizeFeedback;
+    /**
+     * Detect current project name
+     */
+    private detectProject;
+    /**
+     * Ensure data is loaded from storage
+     */
+    private ensureLoaded;
+    /**
+     * Persist data to storage
+     *
+     * @see REQ-LEARN-006 - Local storage only
+     */
+    private persist;
+}
+//# sourceMappingURL=feedback-collector.d.ts.map

package/dist/learning/feedback-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-collector.d.ts","sourceRoot":"","sources":["../../src/learning/feedback-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAIhD;;;;;;OAMG;IACG,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6B7D;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAK5D;;OAEG;IACG,aAAa,CAAC,KAAK,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkCnE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrC,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;KAC9C,CAAC;IAoBF;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKnC;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAavD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;YACW,YAAY;IAkB1B;;;;OAIG;YACW,OAAO;CAatB"}

package/dist/learning/feedback-collector.js

@@ -0,0 +1,231 @@
+/**
+ * Feedback Collector
+ *
+ * Collects and stores user feedback on generated artifacts
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @module @musubix/core/learning
+ */
+import { randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import { join, dirname } from 'path';
+/**
+ * Feedback Collector class
+ *
+ * Responsible for collecting, storing, and querying user feedback
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @see REQ-LEARN-006 - Privacy Protection (local storage only)
+ */
+export class FeedbackCollector {
+    feedbackCache = new Map();
+    storagePath;
+    loaded = false;
+    constructor(config = {}) {
+        this.storagePath = config.storagePath || 'storage/learning';
+    }
+    /**
+     * Record new feedback
+     *
+     * @see REQ-LEARN-001 - Feedback Collection
+     * @param input - Feedback input data
+     * @returns Created feedback with generated ID
+     */
+    async recordFeedback(input) {
+        await this.ensureLoaded();
+        const feedback = {
+            id: `FB-${randomUUID().slice(0, 8).toUpperCase()}`,
+            timestamp: new Date(),
+            type: input.type,
+            artifactType: input.artifactType,
+            artifactId: input.artifactId,
+            context: {
+                project: input.context?.project || this.detectProject(),
+                language: input.context?.language,
+                framework: input.context?.framework,
+                tags: input.context?.tags || [],
+            },
+            reason: input.reason,
+            original: input.original,
+            modified: input.modified,
+        };
+        // Sanitize feedback to remove sensitive data
+        this.sanitizeFeedback(feedback);
+        this.feedbackCache.set(feedback.id, feedback);
+        await this.persist();
+        return feedback;
+    }
+    /**
+     * Get feedback by ID
+     */
+    async getFeedback(id) {
+        await this.ensureLoaded();
+        return this.feedbackCache.get(id);
+    }
+    /**
+     * Query feedback with filters
+     */
+    async queryFeedback(query = {}) {
+        await this.ensureLoaded();
+        let results = Array.from(this.feedbackCache.values());
+        if (query.artifactType) {
+            results = results.filter((f) => f.artifactType === query.artifactType);
+        }
+        if (query.type) {
+            results = results.filter((f) => f.type === query.type);
+        }
+        if (query.project) {
+            results = results.filter((f) => f.context.project === query.project);
+        }
+        if (query.language) {
+            results = results.filter((f) => f.context.language === query.language);
+        }
+        if (query.framework) {
+            results = results.filter((f) => f.context.framework === query.framework);
+        }
+        if (query.since) {
+            results = results.filter((f) => f.timestamp >= query.since);
+        }
+        // Sort by timestamp descending
+        results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        if (query.limit) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    /**
+     * Get feedback statistics
+     */
+    async getStats() {
+        await this.ensureLoaded();
+        const stats = {
+            total: this.feedbackCache.size,
+            byType: { accept: 0, reject: 0, modify: 0 },
+            byArtifactType: { requirement: 0, design: 0, code: 0, test: 0 },
+        };
+        for (const feedback of this.feedbackCache.values()) {
+            stats.byType[feedback.type]++;
+            stats.byArtifactType[feedback.artifactType]++;
+        }
+        return stats;
+    }
+    /**
+     * Delete feedback by ID
+     */
+    async deleteFeedback(id) {
+        await this.ensureLoaded();
+        const deleted = this.feedbackCache.delete(id);
+        if (deleted) {
+            await this.persist();
+        }
+        return deleted;
+    }
+    /**
+     * Export all feedback
+     */
+    async export() {
+        await this.ensureLoaded();
+        return Array.from(this.feedbackCache.values());
+    }
+    /**
+     * Import feedback from array
+     */
+    async import(feedbackList) {
+        await this.ensureLoaded();
+        let imported = 0;
+        for (const feedback of feedbackList) {
+            if (!this.feedbackCache.has(feedback.id)) {
+                this.feedbackCache.set(feedback.id, feedback);
+                imported++;
+            }
+        }
+        await this.persist();
+        return imported;
+    }
+    /**
+     * Clear all feedback
+     */
+    async clear() {
+        this.feedbackCache.clear();
+        await this.persist();
+    }
+    /**
+     * Sanitize feedback to remove sensitive data
+     *
+     * @see REQ-LEARN-006 - Privacy Protection
+     */
+    sanitizeFeedback(feedback) {
+        // Remove potential sensitive patterns
+        const sensitivePatterns = [
+            /password\s*[:=]\s*["']?[^"'\s]+["']?/gi,
+            /api[_-]?key\s*[:=]\s*["']?[^"'\s]+["']?/gi,
+            /secret\s*[:=]\s*["']?[^"'\s]+["']?/gi,
+            /token\s*[:=]\s*["']?[^"'\s]+["']?/gi,
+            /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, // emails
+        ];
+        const sanitize = (text) => {
+            if (!text)
+                return text;
+            let result = text;
+            for (const pattern of sensitivePatterns) {
+                result = result.replace(pattern, '[REDACTED]');
+            }
+            return result;
+        };
+        feedback.reason = sanitize(feedback.reason);
+        feedback.original = sanitize(feedback.original);
+        feedback.modified = sanitize(feedback.modified);
+    }
+    /**
+     * Detect current project name
+     */
+    detectProject() {
+        // Try to detect from package.json or current directory
+        try {
+            const cwd = process.cwd();
+            return cwd.split('/').pop() || 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Ensure data is loaded from storage
+     */
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        const filePath = join(this.storagePath, 'feedback.json');
+        try {
+            const data = await fs.readFile(filePath, 'utf-8');
+            const feedbackList = JSON.parse(data);
+            for (const feedback of feedbackList) {
+                // Convert date strings back to Date objects
+                feedback.timestamp = new Date(feedback.timestamp);
+                this.feedbackCache.set(feedback.id, feedback);
+            }
+        }
+        catch {
+            // File doesn't exist yet, start fresh
+        }
+        this.loaded = true;
+    }
+    /**
+     * Persist data to storage
+     *
+     * @see REQ-LEARN-006 - Local storage only
+     */
+    async persist() {
+        const filePath = join(this.storagePath, 'feedback.json');
+        const dir = dirname(filePath);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+        }
+        catch {
+            // Directory exists
+        }
+        const feedbackList = Array.from(this.feedbackCache.values());
+        await fs.writeFile(filePath, JSON.stringify(feedbackList, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=feedback-collector.js.map

package/dist/learning/feedback-collector.js.map

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

package/dist/learning/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Learning Module - Self-Learning System
+ *
+ * Provides self-learning capabilities through feedback collection,
+ * pattern extraction, and adaptive reasoning.
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @see REQ-LEARN-002 - Pattern Extraction
+ * @see REQ-LEARN-003 - Adaptive Reasoning
+ * @module @musubix/core/learning
+ */
+export type { FeedbackType, PatternSource, PatternActionType, FeedbackContext, Feedback, PatternTrigger, PatternAction, LearnedPattern, LearningStats, PatternMatch, LearningConfig, } from './types.js';
+export { DEFAULT_LEARNING_CONFIG } from './types.js';
+export type { ArtifactType as LearningArtifactType } from './types.js';
+export type { PatternCategory as LearningPatternCategory } from './types.js';
+export { FeedbackCollector, type FeedbackInput, type FeedbackQuery } from './feedback-collector.js';
+export { PatternExtractor } from './pattern-extractor.js';
+export { LearningEngine, type InferenceContext } from './learning-engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/learning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,YAAY,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,eAAe,IAAI,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/learning/index.js

@@ -0,0 +1,19 @@
+/**
+ * Learning Module - Self-Learning System
+ *
+ * Provides self-learning capabilities through feedback collection,
+ * pattern extraction, and adaptive reasoning.
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @see REQ-LEARN-002 - Pattern Extraction
+ * @see REQ-LEARN-003 - Adaptive Reasoning
+ * @module @musubix/core/learning
+ */
+export { DEFAULT_LEARNING_CONFIG } from './types.js';
+// Export feedback collector
+export { FeedbackCollector } from './feedback-collector.js';
+// Export pattern extractor
+export { PatternExtractor } from './pattern-extractor.js';
+// Export learning engine
+export { LearningEngine } from './learning-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/learning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMrD,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAA0C,MAAM,yBAAyB,CAAC;AAEpG,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAyB,MAAM,sBAAsB,CAAC"}

package/dist/learning/learning-engine.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Learning Engine
+ *
+ * Main orchestrator for the self-learning system
+ *
+ * @see REQ-LEARN-003 - Adaptive Reasoning
+ * @module @musubix/core/learning
+ */
+import { type FeedbackInput, type FeedbackQuery } from './feedback-collector.js';
+import type { Feedback, LearnedPattern, PatternMatch, LearningStats, LearningConfig, PatternCategory } from './types.js';
+/**
+ * Inference context for pattern matching
+ */
+export interface InferenceContext {
+    artifactType: 'requirement' | 'design' | 'code' | 'test';
+    language?: string;
+    framework?: string;
+    tags?: string[];
+}
+/**
+ * Learning Engine class
+ *
+ * Orchestrates feedback collection, pattern extraction, and adaptive reasoning
+ *
+ * @see REQ-LEARN-001 - Feedback Collection
+ * @see REQ-LEARN-002 - Pattern Extraction
+ * @see REQ-LEARN-003 - Adaptive Reasoning
+ */
+export declare class LearningEngine {
+    private feedbackCollector;
+    private patternExtractor;
+    private config;
+    constructor(config?: Partial<LearningConfig>);
+    /**
+     * Record feedback for an artifact
+     *
+     * @see REQ-LEARN-001 - Feedback Collection
+     */
+    recordFeedback(input: FeedbackInput): Promise<Feedback>;
+    /**
+     * Record acceptance of an artifact
+     */
+    acceptArtifact(artifactId: string, artifactType: FeedbackInput['artifactType'], context?: Partial<FeedbackInput['context']>, reason?: string): Promise<Feedback>;
+    /**
+     * Record rejection of an artifact
+     */
+    rejectArtifact(artifactId: string, artifactType: FeedbackInput['artifactType'], context?: Partial<FeedbackInput['context']>, reason?: string): Promise<Feedback>;
+    /**
+     * Record modification of an artifact
+     */
+    modifyArtifact(artifactId: string, artifactType: FeedbackInput['artifactType'], original: string, modified: string, context?: Partial<FeedbackInput['context']>, reason?: string): Promise<Feedback>;
+    /**
+     * Query feedback
+     */
+    queryFeedback(query?: FeedbackQuery): Promise<Feedback[]>;
+    /**
+     * Get all learned patterns
+     */
+    getPatterns(): Promise<LearnedPattern[]>;
+    /**
+     * Get patterns by category
+     */
+    getPatternsByCategory(category: PatternCategory): Promise<LearnedPattern[]>;
+    /**
+     * Add a manual pattern
+     */
+    addPattern(name: string, category: PatternCategory, trigger: LearnedPattern['trigger'], action: LearnedPattern['action'], confidence?: number): Promise<LearnedPattern>;
+    /**
+     * Remove a pattern
+     */
+    removePattern(id: string): Promise<boolean>;
+    /**
+     * Apply decay to unused patterns
+     *
+     * @see REQ-LEARN-004 - Pattern Decay
+     */
+    applyDecay(): Promise<{
+        decayed: number;
+        archived: number;
+    }>;
+    /**
+     * Find matching patterns for inference context
+     *
+     * @see REQ-LEARN-003 - Adaptive Reasoning
+     * @param context - Current inference context
+     * @returns Matching patterns sorted by relevance
+     */
+    findMatchingPatterns(context: InferenceContext): Promise<PatternMatch[]>;
+    /**
+     * Get recommendations for current context
+     *
+     * @see REQ-LEARN-003 - Adaptive Reasoning
+     */
+    getRecommendations(context: InferenceContext, limit?: number): Promise<{
+        prefer: LearnedPattern[];
+        avoid: LearnedPattern[];
+        suggest: LearnedPattern[];
+    }>;
+    /**
+     * Apply pattern to adjust inference
+     */
+    applyPattern(patternId: string, success: boolean): Promise<LearnedPattern | undefined>;
+    /**
+     * Get learning statistics
+     *
+     * @see REQ-LEARN-005 - Learning Visualization
+     */
+    getStats(): Promise<LearningStats>;
+    /**
+     * Export all learning data
+     */
+    export(): Promise<{
+        feedback: Feedback[];
+        patterns: LearnedPattern[];
+        stats: LearningStats;
+    }>;
+    /**
+     * Import learning data
+     */
+    import(data: {
+        feedback?: Feedback[];
+        patterns?: LearnedPattern[];
+    }): Promise<{
+        feedbackImported: number;
+        patternsImported: number;
+    }>;
+    /**
+     * Generate status report
+     */
+    generateStatusReport(): Promise<string>;
+    /**
+     * Calculate match score between pattern and context
+     */
+    private calculateMatchScore;
+    /**
+     * Try to extract patterns from recent feedback
+     */
+    private tryExtractPatterns;
+}
+//# sourceMappingURL=learning-engine.d.ts.map

package/dist/learning/learning-engine.d.ts.map

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