cmp-standards 2.8.0 → 2.9.1

package/dist/services/FeedbackCollector.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @file FeedbackCollector Service
+ * @description Tracks memory usage feedback to enable learning loop
+ *
+ * Features:
+ * - Track when memories are used, dismissed, or rated
+ * - Update memory decay scores based on feedback
+ * - Enable relevance learning over time
+ *
+ * @version 1.0.0
+ */
+import type { DevSystem } from '../types/index.js';
+export type FeedbackAction = 'used' | 'dismissed' | 'helpful' | 'wrong' | 'outdated';
+export interface MemoryFeedback {
+    memoryId: string;
+    action: FeedbackAction;
+    toolContext?: string;
+    sessionId?: string;
+    timestamp?: string;
+}
+export interface FeedbackStats {
+    totalFeedback: number;
+    usedCount: number;
+    dismissedCount: number;
+    helpfulCount: number;
+    wrongCount: number;
+    avgScore: number;
+}
+export interface MemoryWithScore {
+    id: string;
+    feedbackScore: number;
+    accessCount: number;
+    lastAccessedAt: string;
+}
+declare class FeedbackCollectorService {
+    /**
+     * Track feedback for a memory
+     */
+    track(feedback: MemoryFeedback): Promise<void>;
+    /**
+     * Track multiple memories used in a single tool call
+     */
+    trackBatch(memoryIds: string[], action: FeedbackAction, toolContext?: string, sessionId?: string): Promise<void>;
+    /**
+     * Get feedback statistics for a memory
+     */
+    getStats(memoryId: string): Promise<FeedbackStats | null>;
+    /**
+     * Get memories sorted by feedback score (for relevance-based retrieval)
+     */
+    getTopScoredMemories(system: DevSystem, limit?: number): Promise<MemoryWithScore[]>;
+    /**
+     * Get memories with low scores that might need review or archival
+     */
+    getLowScoredMemories(system: DevSystem, threshold?: number, limit?: number): Promise<MemoryWithScore[]>;
+    /**
+     * Archive memories with very low scores (cleanup)
+     */
+    archiveLowScoredMemories(system: DevSystem, threshold?: number, minAge?: number): Promise<number>;
+}
+/**
+ * Get or create the global FeedbackCollector instance
+ */
+export declare function getFeedbackCollector(): FeedbackCollectorService;
+/**
+ * Reset the global instance (useful for testing)
+ */
+export declare function resetFeedbackCollector(): void;
+export declare const feedbackCollector: FeedbackCollectorService;
+export default feedbackCollector;
+//# sourceMappingURL=FeedbackCollector.d.ts.map

package/dist/services/FeedbackCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackCollector.d.ts","sourceRoot":"","sources":["../../src/services/FeedbackCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAMlD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;AAEpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;CACvB;AAsBD,cAAM,wBAAwB;IAC5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEpD;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgC/D;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,SAAS,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC;IA8B7B;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,SAAS,EACjB,SAAS,SAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC;IA8B7B;;OAEG;IACG,wBAAwB,CAC5B,MAAM,EAAE,SAAS,EACjB,SAAS,SAAM,EACf,MAAM,SAAK,GACV,OAAO,CAAC,MAAM,CAAC;CAsBnB;AAQD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAK/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAGD,eAAO,MAAM,iBAAiB,0BAAyB,CAAA;AACvD,eAAe,iBAAiB,CAAA"}

package/dist/services/FeedbackCollector.js

@@ -0,0 +1,236 @@
+/**
+ * @file FeedbackCollector Service
+ * @description Tracks memory usage feedback to enable learning loop
+ *
+ * Features:
+ * - Track when memories are used, dismissed, or rated
+ * - Update memory decay scores based on feedback
+ * - Enable relevance learning over time
+ *
+ * @version 1.0.0
+ */
+import { turso } from '../db/turso-client.js';
+// =============================================================================
+// Score Adjustments
+// =============================================================================
+const SCORE_ADJUSTMENTS = {
+    used: 0.02, // Small positive for each use
+    dismissed: -0.05, // Negative when dismissed
+    helpful: 0.15, // Strong positive for explicit helpful
+    wrong: -0.25, // Strong negative for wrong info
+    outdated: -0.15 // Moderate negative for outdated
+};
+const MIN_SCORE = 0.0;
+const MAX_SCORE = 1.0;
+const DEFAULT_SCORE = 0.5;
+// =============================================================================
+// FeedbackCollector Implementation
+// =============================================================================
+class FeedbackCollectorService {
+    /**
+     * Track feedback for a memory
+     */
+    async track(feedback) {
+        const { memoryId, action, toolContext, sessionId } = feedback;
+        const timestamp = feedback.timestamp || new Date().toISOString();
+        try {
+            const db = turso.getClient();
+            // 1. Get current memory state
+            const result = await db.execute({
+                sql: `SELECT id, content FROM items WHERE id = ?`,
+                args: [memoryId]
+            });
+            if (result.rows.length === 0) {
+                console.warn(`[FeedbackCollector] Memory not found: ${memoryId}`);
+                return;
+            }
+            const row = result.rows[0];
+            const content = typeof row.content === 'string'
+                ? JSON.parse(row.content)
+                : row.content;
+            // 2. Calculate new score
+            const currentScore = content.feedbackScore ?? DEFAULT_SCORE;
+            const currentAccessCount = content.accessCount ?? 0;
+            const adjustment = SCORE_ADJUSTMENTS[action];
+            const newScore = Math.max(MIN_SCORE, Math.min(MAX_SCORE, currentScore + adjustment));
+            const newAccessCount = currentAccessCount + 1;
+            // 3. Build feedback history entry
+            const feedbackEntry = {
+                action,
+                toolContext,
+                sessionId,
+                timestamp
+            };
+            // Keep last 20 feedback entries
+            const feedbackHistory = content.feedbackHistory || [];
+            feedbackHistory.push(feedbackEntry);
+            if (feedbackHistory.length > 20) {
+                feedbackHistory.shift();
+            }
+            // 4. Update memory with new score and feedback
+            const updatedContent = {
+                ...content,
+                feedbackScore: newScore,
+                accessCount: newAccessCount,
+                lastAccessedAt: timestamp,
+                feedbackHistory
+            };
+            await db.execute({
+                sql: `UPDATE items SET content = ?, updated_at = datetime('now') WHERE id = ?`,
+                args: [JSON.stringify(updatedContent), memoryId]
+            });
+            console.log(`[FeedbackCollector] Tracked ${action} for ${memoryId}: ${currentScore.toFixed(2)} -> ${newScore.toFixed(2)}`);
+        }
+        catch (error) {
+            console.error(`[FeedbackCollector] Failed to track feedback:`, error);
+        }
+    }
+    /**
+     * Track multiple memories used in a single tool call
+     */
+    async trackBatch(memoryIds, action, toolContext, sessionId) {
+        const timestamp = new Date().toISOString();
+        await Promise.all(memoryIds.map(memoryId => this.track({ memoryId, action, toolContext, sessionId, timestamp })));
+    }
+    /**
+     * Get feedback statistics for a memory
+     */
+    async getStats(memoryId) {
+        try {
+            const db = turso.getClient();
+            const result = await db.execute({
+                sql: `SELECT content FROM items WHERE id = ?`,
+                args: [memoryId]
+            });
+            if (result.rows.length === 0)
+                return null;
+            const content = typeof result.rows[0].content === 'string'
+                ? JSON.parse(result.rows[0].content)
+                : result.rows[0].content;
+            const history = content.feedbackHistory || [];
+            const stats = {
+                totalFeedback: history.length,
+                usedCount: history.filter((f) => f.action === 'used').length,
+                dismissedCount: history.filter((f) => f.action === 'dismissed').length,
+                helpfulCount: history.filter((f) => f.action === 'helpful').length,
+                wrongCount: history.filter((f) => f.action === 'wrong').length,
+                avgScore: content.feedbackScore ?? DEFAULT_SCORE
+            };
+            return stats;
+        }
+        catch (error) {
+            console.error(`[FeedbackCollector] Failed to get stats:`, error);
+            return null;
+        }
+    }
+    /**
+     * Get memories sorted by feedback score (for relevance-based retrieval)
+     */
+    async getTopScoredMemories(system, limit = 20) {
+        try {
+            const db = turso.getClient();
+            const result = await db.execute({
+                sql: `SELECT id, content FROM items
+              WHERE system = ? AND type = 'memory' AND status = 'active'
+              ORDER BY COALESCE(json_extract(content, '$.feedbackScore'), 0.5) DESC,
+                       COALESCE(json_extract(content, '$.accessCount'), 0) DESC
+              LIMIT ?`,
+                args: [system, limit]
+            });
+            return result.rows.map(row => {
+                const content = typeof row.content === 'string'
+                    ? JSON.parse(row.content)
+                    : row.content;
+                return {
+                    id: row.id,
+                    feedbackScore: content.feedbackScore ?? DEFAULT_SCORE,
+                    accessCount: content.accessCount ?? 0,
+                    lastAccessedAt: content.lastAccessedAt ?? ''
+                };
+            });
+        }
+        catch (error) {
+            console.error(`[FeedbackCollector] Failed to get top scored:`, error);
+            return [];
+        }
+    }
+    /**
+     * Get memories with low scores that might need review or archival
+     */
+    async getLowScoredMemories(system, threshold = 0.3, limit = 20) {
+        try {
+            const db = turso.getClient();
+            const result = await db.execute({
+                sql: `SELECT id, content FROM items
+              WHERE system = ? AND type = 'memory' AND status = 'active'
+              AND COALESCE(json_extract(content, '$.feedbackScore'), 0.5) < ?
+              ORDER BY json_extract(content, '$.feedbackScore') ASC
+              LIMIT ?`,
+                args: [system, threshold, limit]
+            });
+            return result.rows.map(row => {
+                const content = typeof row.content === 'string'
+                    ? JSON.parse(row.content)
+                    : row.content;
+                return {
+                    id: row.id,
+                    feedbackScore: content.feedbackScore ?? DEFAULT_SCORE,
+                    accessCount: content.accessCount ?? 0,
+                    lastAccessedAt: content.lastAccessedAt ?? ''
+                };
+            });
+        }
+        catch (error) {
+            console.error(`[FeedbackCollector] Failed to get low scored:`, error);
+            return [];
+        }
+    }
+    /**
+     * Archive memories with very low scores (cleanup)
+     */
+    async archiveLowScoredMemories(system, threshold = 0.1, minAge = 30 // days
+    ) {
+        try {
+            const db = turso.getClient();
+            const result = await db.execute({
+                sql: `UPDATE items SET status = 'archived', updated_at = datetime('now')
+              WHERE system = ? AND type = 'memory' AND status = 'active'
+              AND COALESCE(json_extract(content, '$.feedbackScore'), 0.5) < ?
+              AND created_at < datetime('now', '-' || ? || ' days')`,
+                args: [system, threshold, minAge]
+            });
+            const archived = result.rowsAffected ?? 0;
+            if (archived > 0) {
+                console.log(`[FeedbackCollector] Archived ${archived} low-scored memories`);
+            }
+            return archived;
+        }
+        catch (error) {
+            console.error(`[FeedbackCollector] Failed to archive:`, error);
+            return 0;
+        }
+    }
+}
+// =============================================================================
+// Singleton Instance (Factory Pattern)
+// =============================================================================
+let instance = null;
+/**
+ * Get or create the global FeedbackCollector instance
+ */
+export function getFeedbackCollector() {
+    if (!instance) {
+        instance = new FeedbackCollectorService();
+    }
+    return instance;
+}
+/**
+ * Reset the global instance (useful for testing)
+ */
+export function resetFeedbackCollector() {
+    instance = null;
+}
+// Legacy export for backwards compatibility
+export const feedbackCollector = getFeedbackCollector();
+export default feedbackCollector;
+//# sourceMappingURL=FeedbackCollector.js.map

package/dist/services/FeedbackCollector.js.map

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

package/dist/services/GitIntegration.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Git Integration Service
+ *
+ * Provides Git integration for memory system:
+ * - Auto-commit memory changes
+ * - Export memories as Git-tracked files
+ * - Sync with remote repositories
+ * - Version history via Git
+ *
+ * @version 2.9.0
+ */
+import { StatusResult } from 'simple-git';
+import type { DevSystem, MemoryContent } from '../types/index.js';
+export interface GitConfig {
+    enabled: boolean;
+    repoPath: string;
+    memoriesDir: string;
+    branch?: string;
+    remote?: string;
+    autoCommit: boolean;
+    autoCommitInterval?: number;
+    commitPrefix?: string;
+    author?: {
+        name: string;
+        email: string;
+    };
+}
+export interface CommitResult {
+    success: boolean;
+    commitHash?: string;
+    message: string;
+    filesChanged?: number;
+    error?: string;
+}
+export interface SyncResult {
+    success: boolean;
+    pushed?: number;
+    pulled?: number;
+    conflicts?: string[];
+    error?: string;
+}
+export interface MemoryFileFormat {
+    id: string;
+    title: string;
+    body: string;
+    domain?: string;
+    source?: string;
+    tags?: string[];
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, unknown>;
+}
+export declare class GitIntegrationService {
+    private git;
+    private config;
+    private system;
+    private pendingChanges;
+    private commitTimer?;
+    private initialized;
+    constructor(options: {
+        system: DevSystem;
+        config: Partial<GitConfig>;
+    });
+    /**
+     * Initialize the Git integration
+     */
+    init(): Promise<boolean>;
+    /**
+     * Save a memory to file and stage for commit
+     */
+    saveMemory(memoryId: string, content: MemoryContent, options?: {
+        immediate?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Delete a memory file and stage for commit
+     */
+    deleteMemory(memoryId: string, domain?: string, options?: {
+        immediate?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Commit pending changes
+     */
+    commit(message?: string): Promise<CommitResult>;
+    /**
+     * Push changes to remote
+     */
+    push(): Promise<SyncResult>;
+    /**
+     * Pull changes from remote
+     */
+    pull(): Promise<SyncResult>;
+    /**
+     * Get current status
+     */
+    getStatus(): Promise<StatusResult>;
+    /**
+     * Get commit history for memories
+     */
+    getHistory(limit?: number): Promise<Array<{
+        hash: string;
+        date: string;
+        message: string;
+        author: string;
+    }>>;
+    /**
+     * Export all memories from database to files
+     */
+    exportAll(memories: Array<{
+        id: string;
+        content: MemoryContent;
+    }>): Promise<{
+        exported: number;
+        failed: number;
+    }>;
+    /**
+     * Import memories from files
+     */
+    importAll(): Promise<Array<MemoryFileFormat>>;
+    /**
+     * Stop auto-commit and cleanup
+     */
+    stop(): void;
+    private startAutoCommit;
+    private getMemoryFilePath;
+    private formatMemoryFile;
+    private parseMemoryFile;
+    private findMemoryFiles;
+    private hasChanges;
+    private formatCommitMessage;
+}
+export declare function getGitIntegration(system?: DevSystem, config?: Partial<GitConfig>): GitIntegrationService;
+export declare function resetGitIntegration(): void;
+/**
+ * Create a new Git integration with custom config
+ */
+export declare function createGitIntegration(options: {
+    system: DevSystem;
+    config: Partial<GitConfig>;
+}): GitIntegrationService;
+//# sourceMappingURL=GitIntegration.d.ts.map

package/dist/services/GitIntegration.d.ts.map

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