cmp-standards 3.7.0 → 3.7.1

package/dist/services/skill-learning-bridge.js

@@ -0,0 +1,331 @@
+/**
+ * @file Skill-Learning Bridge Service
+ * @description Connects memory systems with the skills learning framework
+ *
+ * ## Purpose
+ *
+ * This bridge service synchronizes learnings across:
+ * 1. memory-keeper MCP (local SQLite)
+ * 2. cmp-standards cloud (Turso/Upstash)
+ * 3. Skills markdown files (.claude/skills/SKILL/learnings.md)
+ *
+ * ## Flow
+ *
+ * Learning Detected -> SkillLearningBridge
+ *   - memory-keeper (immediate, local)
+ *   - skills/learnings.md (immediate, local)
+ *   - cmp-standards cloud (async, persistent)
+ *
+ * @version 1.0.0
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_CONFIG = {
+    skillsDir: join(homedir(), '.claude', 'skills'),
+    evolutionThreshold: 10,
+    syncToCloud: true
+};
+const SKILL_PATHS = {
+    'type-safety-enforcer': 'quality/type-safety-enforcer',
+    'useeffect-reducer': 'quality/useeffect-reducer',
+    'systematic-debugging': 'quality/systematic-debugging',
+    'code-deduplicator': 'quality/code-deduplicator',
+    'pre-commit-validator': 'quality/pre-commit-validator',
+    'domain-structure-guardian': 'architecture/domain-structure-guardian',
+    'simplification-cascades': 'architecture/simplification-cascades',
+    'skill-evolver': 'meta/skill-evolver',
+    'changelog-generator': 'meta/changelog-generator'
+};
+// =============================================================================
+// Skill Learning Bridge
+// =============================================================================
+export class SkillLearningBridge {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Record a learning to all systems
+     */
+    async recordLearning(learning) {
+        const result = {
+            skillsWritten: false,
+            memoryKeeperWritten: false,
+            cloudSynced: false
+        };
+        // 1. Write to skills/learnings.md
+        try {
+            result.skillsWritten = this.writeToSkillFile(learning);
+        }
+        catch (error) {
+            console.error('[bridge] Failed to write to skills:', error);
+        }
+        // 2. Write to memory-keeper (would need MCP client)
+        // TODO: Integrate with memory-keeper MCP
+        // result.memoryKeeperWritten = await this.writeToMemoryKeeper(learning)
+        // 3. Sync to cloud (async, non-blocking)
+        if (this.config.syncToCloud) {
+            // TODO: Integrate with cmp-standards cloud
+            // this.syncToCloud(learning).catch(console.error)
+        }
+        return result;
+    }
+    /**
+     * Write learning to skill's learnings.md file
+     */
+    writeToSkillFile(learning) {
+        const skillPath = SKILL_PATHS[learning.skill];
+        if (!skillPath) {
+            console.warn(`[bridge] Unknown skill: ${learning.skill}`);
+            return false;
+        }
+        const learningsFile = join(this.config.skillsDir, skillPath, 'learnings.md');
+        if (!existsSync(learningsFile)) {
+            console.warn(`[bridge] Learnings file not found: ${learningsFile}`);
+            return false;
+        }
+        let content = readFileSync(learningsFile, 'utf-8');
+        // Format the learning entry
+        const entry = this.formatLearningEntry(learning);
+        // Update total count
+        const countMatch = content.match(/\*\*Learnings Totales:\*\* (\d+)/);
+        if (countMatch) {
+            const currentCount = parseInt(countMatch[1], 10);
+            content = content.replace(/\*\*Learnings Totales:\*\* \d+/, `**Learnings Totales:** ${currentCount + 1}`);
+            // Also update pending count
+            const pendingMatch = content.match(/\*\*Learnings Pendientes:\*\* (\d+)/);
+            if (pendingMatch) {
+                const pendingCount = parseInt(pendingMatch[1], 10);
+                content = content.replace(/\*\*Learnings Pendientes:\*\* \d+/, `**Learnings Pendientes:** ${pendingCount + 1}`);
+            }
+        }
+        // Insert learning after "## Learnings" header
+        const learningsHeader = '## Learnings';
+        const headerIndex = content.indexOf(learningsHeader);
+        if (headerIndex !== -1) {
+            const insertPoint = content.indexOf('\n', headerIndex) + 1;
+            content = content.slice(0, insertPoint) + '\n' + entry + content.slice(insertPoint);
+        }
+        else {
+            // Fallback: append to end
+            content += '\n' + entry;
+        }
+        writeFileSync(learningsFile, content);
+        return true;
+    }
+    /**
+     * Format a learning entry as markdown
+     */
+    formatLearningEntry(learning) {
+        const date = learning.timestamp.split('T')[0];
+        const time = learning.timestamp.split('T')[1]?.slice(0, 5) || '';
+        return `### Learning ${date} ${time}
+
+**Context:** ${learning.context}
+**Problem:** ${learning.problem}
+**Solution:** ${learning.solution}
+**Confidence:** ${Math.round(learning.confidence * 100)}%${learning.file ? `\n**File:** ${learning.file}` : ''}
+**Source:** ${learning.source}
+
+---
+`;
+    }
+    /**
+     * Get statistics for all skills
+     */
+    async getSkillStats() {
+        const stats = [];
+        for (const [skillName, skillPath] of Object.entries(SKILL_PATHS)) {
+            const fullPath = join(this.config.skillsDir, skillPath);
+            const learningsFile = join(fullPath, 'learnings.md');
+            if (!existsSync(learningsFile))
+                continue;
+            const content = readFileSync(learningsFile, 'utf-8');
+            // Parse stats from content
+            const totalMatch = content.match(/\*\*Learnings Totales:\*\* (\d+)/);
+            const pendingMatch = content.match(/\*\*Learnings Pendientes:\*\* (\d+)/);
+            const evolutionMatch = content.match(/\*\*Última Evolución:\*\* (.+)/);
+            const total = totalMatch ? parseInt(totalMatch[1], 10) : 0;
+            const pending = pendingMatch ? parseInt(pendingMatch[1], 10) : 0;
+            const lastEvolution = evolutionMatch?.[1] === 'Nunca' ? null : (evolutionMatch?.[1] || null);
+            stats.push({
+                name: skillName,
+                path: skillPath,
+                totalLearnings: total,
+                pendingLearnings: pending,
+                lastEvolution,
+                readyForEvolution: pending >= this.config.evolutionThreshold
+            });
+        }
+        return stats;
+    }
+    /**
+     * Check if any skills are ready for evolution
+     */
+    async getSkillsReadyForEvolution() {
+        const allStats = await this.getSkillStats();
+        return allStats.filter(s => s.readyForEvolution);
+    }
+    /**
+     * Trigger skill evolution for ready skills
+     */
+    async triggerEvolution(skillName) {
+        const readySkills = await this.getSkillsReadyForEvolution();
+        if (skillName) {
+            const target = readySkills.find(s => s.name === skillName);
+            if (!target) {
+                throw new Error(`Skill ${skillName} not ready for evolution or not found`);
+            }
+            return this.evolveSkill(target);
+        }
+        // Evolve all ready skills
+        const results = [];
+        for (const skill of readySkills) {
+            const evolved = await this.evolveSkill(skill);
+            results.push(...evolved);
+        }
+        return results;
+    }
+    /**
+     * Evolve a single skill
+     */
+    async evolveSkill(skill) {
+        const changes = [];
+        const learningsFile = join(this.config.skillsDir, skill.path, 'learnings.md');
+        const skillFile = join(this.config.skillsDir, skill.path, 'SKILL.md');
+        if (!existsSync(learningsFile) || !existsSync(skillFile)) {
+            return changes;
+        }
+        const learningsContent = readFileSync(learningsFile, 'utf-8');
+        // Extract learnings
+        const learningBlocks = learningsContent.match(/### Learning \d{4}-\d{2}-\d{2}[\s\S]*?(?=### Learning|\n## |$)/g) || [];
+        // Analyze patterns
+        const patterns = this.analyzeLearningPatterns(learningBlocks);
+        if (patterns.length > 0) {
+            changes.push(`Found ${patterns.length} patterns to add to ${skill.name}`);
+            // Log the evolution
+            const evolutionLog = join(this.config.skillsDir, 'meta/skill-evolver/evolution-log.md');
+            if (existsSync(evolutionLog)) {
+                const date = new Date().toISOString();
+                const entry = `
+## Evolution ${date}
+
+**Skill Evolved:** ${skill.name}
+**Learnings Analyzed:** ${skill.pendingLearnings}
+**Patterns Found:** ${patterns.length}
+
+**Patterns:**
+${patterns.map(p => `- ${p}`).join('\n')}
+
+---
+`;
+                let logContent = readFileSync(evolutionLog, 'utf-8');
+                // Update total evolutions
+                const totalMatch = logContent.match(/\*\*Total Evoluciones:\*\* (\d+)/);
+                if (totalMatch) {
+                    const total = parseInt(totalMatch[1], 10);
+                    logContent = logContent.replace(/\*\*Total Evoluciones:\*\* \d+/, `**Total Evoluciones:** ${total + 1}`);
+                }
+                // Insert after ## Evolution History
+                const historyHeader = '## Evolution History';
+                const historyIndex = logContent.indexOf(historyHeader);
+                if (historyIndex !== -1) {
+                    const insertPoint = logContent.indexOf('\n', historyIndex) + 1;
+                    logContent = logContent.slice(0, insertPoint) + '\n' + entry + logContent.slice(insertPoint);
+                }
+                writeFileSync(evolutionLog, logContent);
+            }
+            // Reset pending count in learnings.md
+            let content = readFileSync(learningsFile, 'utf-8');
+            content = content.replace(/\*\*Learnings Pendientes:\*\* \d+/, '**Learnings Pendientes:** 0');
+            content = content.replace(/\*\*Última Evolución:\*\* .+/, `**Última Evolución:** ${new Date().toISOString().split('T')[0]}`);
+            writeFileSync(learningsFile, content);
+        }
+        return changes;
+    }
+    /**
+     * Analyze learnings to find common patterns
+     */
+    analyzeLearningPatterns(learningBlocks) {
+        const patterns = [];
+        const problemCounts = new Map();
+        for (const block of learningBlocks) {
+            const problemMatch = block.match(/\*\*Problem:\*\* (.+)/);
+            if (problemMatch) {
+                const problem = problemMatch[1].toLowerCase().trim();
+                problemCounts.set(problem, (problemCounts.get(problem) || 0) + 1);
+            }
+        }
+        // Find patterns that appear 2+ times
+        for (const [problem, count] of problemCounts) {
+            if (count >= 2) {
+                patterns.push(`"${problem}" (${count} occurrences)`);
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Migrate memories from memory-keeper to skills
+     */
+    async migrateFromMemoryKeeper(memories) {
+        let migrated = 0;
+        for (const memory of memories) {
+            // Try to detect skill from memory content
+            const skill = this.detectSkillFromContent(memory.value);
+            if (!skill)
+                continue;
+            const learning = {
+                type: 'general',
+                skill,
+                context: memory.key,
+                problem: 'Migrated from memory-keeper',
+                solution: memory.value.slice(0, 200),
+                confidence: 0.6,
+                timestamp: new Date().toISOString(),
+                source: 'sync'
+            };
+            const result = await this.recordLearning(learning);
+            if (result.skillsWritten)
+                migrated++;
+        }
+        return migrated;
+    }
+    /**
+     * Detect which skill a memory content relates to
+     */
+    detectSkillFromContent(content) {
+        const lower = content.toLowerCase();
+        if (lower.includes('type') || lower.includes('any') || lower.includes('typescript')) {
+            return 'type-safety-enforcer';
+        }
+        if (lower.includes('useeffect') || lower.includes('render') || lower.includes('performance')) {
+            return 'useeffect-reducer';
+        }
+        if (lower.includes('debug') || lower.includes('error') || lower.includes('fix')) {
+            return 'systematic-debugging';
+        }
+        if (lower.includes('structure') || lower.includes('domain') || lower.includes('architecture')) {
+            return 'domain-structure-guardian';
+        }
+        if (lower.includes('duplicate') || lower.includes('refactor')) {
+            return 'code-deduplicator';
+        }
+        return null;
+    }
+}
+// =============================================================================
+// Factory & Export
+// =============================================================================
+let bridgeInstance = null;
+export function getSkillLearningBridge(config) {
+    if (!bridgeInstance || config) {
+        bridgeInstance = new SkillLearningBridge(config);
+    }
+    return bridgeInstance;
+}
+export default SkillLearningBridge;
+//# sourceMappingURL=skill-learning-bridge.js.map

package/dist/services/skill-learning-bridge.js.map

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

package/dist/services/unified-memory-router.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @file Unified Memory Router
+ * @description Routes memory operations across all storage backends
+ *
+ * ## Architecture
+ *
+ * UnifiedMemoryRouter routes operations to multiple backends:
+ *
+ * save(item):
+ *   - memory-keeper MCP (local, fast, session-based)
+ *   - skills/learnings.md (if learning type)
+ *   - cmp-standards cloud (persistent, cross-project)
+ *
+ * search(query):
+ *   - memory-keeper (local context)
+ *   - skills (learned patterns)
+ *   - cloud (historical knowledge)
+ *
+ * sync():
+ *   - Bidirectional sync between all backends
+ *
+ * @version 1.0.0
+ */
+import type { DevSystem } from '../types/index.js';
+export interface MemoryItem {
+    id?: string;
+    type: 'memory' | 'learning' | 'pattern' | 'task' | 'decision' | 'knowledge';
+    title: string;
+    content: string;
+    domain?: string;
+    tags?: string[];
+    priority?: 'critical' | 'high' | 'normal' | 'low';
+    source?: 'auto' | 'manual' | 'sync' | 'claude' | 'gemini';
+    metadata?: Record<string, unknown>;
+}
+export interface SearchQuery {
+    text?: string;
+    type?: MemoryItem['type'] | MemoryItem['type'][];
+    domain?: string;
+    tags?: string[];
+    limit?: number;
+    includeSkills?: boolean;
+    includeCloud?: boolean;
+}
+export interface SearchResult {
+    item: MemoryItem;
+    source: 'memory-keeper' | 'skills' | 'cloud';
+    score: number;
+}
+export interface SyncResult {
+    memoryKeeperToCloud: number;
+    cloudToMemoryKeeper: number;
+    skillsUpdated: number;
+    errors: string[];
+}
+export interface RouterConfig {
+    system: DevSystem;
+    skillsDir: string;
+    enableCloud: boolean;
+    enableSkills: boolean;
+    cloudSyncInterval: number;
+}
+export declare class UnifiedMemoryRouter {
+    private config;
+    private skillBridge;
+    private memoryKeeper;
+    private cloudMemory;
+    private syncTimer;
+    private syncedKeys;
+    constructor(config?: Partial<RouterConfig>);
+    /**
+     * Save an item to all appropriate backends
+     */
+    save(item: MemoryItem): Promise<{
+        memoryKeeper: boolean;
+        skills: boolean;
+        cloud: boolean;
+    }>;
+    /**
+     * Search across all backends
+     */
+    search(query: SearchQuery): Promise<SearchResult[]>;
+    /**
+     * Get context for session start
+     */
+    getSessionContext(domain?: string): Promise<{
+        recentMemories: MemoryItem[];
+        recentLearnings: MemoryItem[];
+        activePatterns: MemoryItem[];
+        skillsStatus: Array<{
+            name: string;
+            learnings: number;
+            ready: boolean;
+        }>;
+    }>;
+    /**
+     * Sync between all backends
+     */
+    sync(): Promise<SyncResult>;
+    /**
+     * Start periodic sync
+     */
+    private startPeriodicSync;
+    /**
+     * Stop periodic sync
+     */
+    stopPeriodicSync(): void;
+    private saveToMemoryKeeper;
+    private searchMemoryKeeper;
+    private getUnsyncedFromMemoryKeeper;
+    private mapTypeToCategory;
+    private mapCategoryToType;
+    private cloudInitialized;
+    private initCloudIfNeeded;
+    private saveToCloud;
+    private searchCloud;
+    private getUnsyncedFromCloud;
+    private searchSkills;
+    private itemToLearning;
+}
+export declare function getUnifiedMemoryRouter(config?: Partial<RouterConfig>): UnifiedMemoryRouter;
+export default UnifiedMemoryRouter;
+//# sourceMappingURL=unified-memory-router.d.ts.map

package/dist/services/unified-memory-router.d.ts.map

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