ai-debug-local-mcp
Version:
🎯 ENHANCED AI GUIDANCE v4.1.2: Dramatically improved tool descriptions help AI users choose the right tools instead of 'close enough' options. Ultra-fast keyboard automation (10x speed), universal recording, multi-ecosystem debugging support, and compreh
152 lines • 4.4 kB
TypeScript
/**
* AI Feedback Cloud Storage Structure
*
* Organized cloud storage system for AI feedback data with automated
* partitioning, compression, and lifecycle management for scalable
* multi-user feedback collection.
*/
import { AIFeedbackEntry } from './ai-feedback-collector.js';
import { AggregatedMetrics } from './ai-feedback-privacy-aggregator.js';
export interface CloudStorageConfig {
baseStoragePath: string;
enableCompression: boolean;
enableEncryption: boolean;
partitionStrategy: 'daily' | 'weekly' | 'monthly' | 'size-based';
maxPartitionSizeMB: number;
retentionPolicyDays: number;
backupEnabled: boolean;
compressionLevel: number;
}
export interface StoragePartition {
partitionId: string;
partitionType: 'feedback' | 'analytics' | 'aggregated' | 'backup';
createdAt: number;
lastModified: number;
entryCount: number;
sizeBytes: number;
filePath: string;
compressed: boolean;
encrypted: boolean;
checksum: string;
metadata: {
timeRange: {
start: number;
end: number;
};
dataTypes: string[];
privacyLevel: 'minimal' | 'standard' | 'strict';
sourceSystem?: string;
};
}
export interface StorageIndex {
version: string;
lastUpdated: number;
partitions: StoragePartition[];
totalEntries: number;
totalSizeBytes: number;
retentionStatus: {
activePartitions: number;
expiredPartitions: number;
pendingCleanup: number;
};
}
export interface CloudStorageMetrics {
storageEfficiency: {
compressionRatio: number;
diskUsageMB: number;
dataIntegrityScore: number;
};
performanceMetrics: {
averageWriteTimeMs: number;
averageReadTimeMs: number;
indexLookupTimeMs: number;
};
maintenanceStatus: {
lastBackup: number;
lastCompaction: number;
lastIntegrityCheck: number;
pendingOperations: string[];
};
}
/**
* Organized Cloud Storage System for AI Feedback
*/
export declare class AIFeedbackCloudStorage {
private config;
private storageIndex;
private encryptionKey;
private compressionStats;
constructor(config?: Partial<CloudStorageConfig>);
/**
* Store feedback batch with organized partitioning
*/
storeFeedbackBatch(feedbackEntries: AIFeedbackEntry[], batchMetadata: {
batchId: string;
sourceSystem: string;
privacyLevel: 'minimal' | 'standard' | 'strict';
}): Promise<{
partitionId: string;
storedEntries: number;
compressedSize: number;
storageLocation: string;
}>;
/**
* Store aggregated analytics data
*/
storeAggregatedMetrics(metrics: AggregatedMetrics, sourcePartitions: string[]): Promise<{
partitionId: string;
storageLocation: string;
}>;
/**
* Retrieve feedback data with query capabilities
*/
queryFeedbackData(query: {
timeRange?: {
start: number;
end: number;
};
sourceSystem?: string;
agentType?: string;
partitionIds?: string[];
limit?: number;
}): Promise<{
entries: AIFeedbackEntry[];
partitionsScanned: number;
totalMatched: number;
queryTimeMs: number;
}>;
/**
* Perform storage maintenance operations
*/
performMaintenance(): Promise<{
operationsPerformed: string[];
spaceReclaimed: number;
optimizationsApplied: number;
}>;
/**
* Get comprehensive storage metrics
*/
getStorageMetrics(): CloudStorageMetrics;
private initializeStorage;
private generatePartitionId;
private getOrCreatePartition;
private processAndStore;
private writeToPartition;
private readFromPartition;
private compressData;
private decompressData;
private encryptData;
private decryptData;
private generateEncryptionKey;
private calculateChecksum;
private findRelevantPartitions;
private filterEntries;
private updateStorageIndex;
private cleanupExpiredPartitions;
private compactPartitions;
private verifyDataIntegrity;
private createBackup;
private calculateDataIntegrityScore;
private getPendingMaintenanceOperations;
}
//# sourceMappingURL=ai-feedback-cloud-storage.d.ts.map