chore: recovery checkpoint - v3.0 API successfully recovered

CRITICAL CHECKPOINT - DO NOT PUSH TO GITHUB

Recovery Status:
- Successfully recovered brainy.ts from compiled JavaScript
- All core v3.0 API methods functional (add, get, update, delete, relate, find, etc.)
- Neural subsystem intact (562KB embedded patterns, NLP working)
- Augmentation pipeline operational (20+ augmentations)
- HNSW clustering system complete
- Triple Intelligence compiled (needs constructor fix)
- Test suite validates functionality

Changes preserved:
- 898 files with changes from last 3 days
- 144,475 insertions
- All augmentation improvements
- All test coverage enhancements
- Complete v3.0 feature set

This is a LOCAL checkpoint only - contains recovered work after corruption incident.
Created backup in .backups/brainy-full-20250910-151314.tar.gz

Branch: recovery-checkpoint-20250910-151433
Date: Wed Sep 10 03:18:04 PM PDT 2025

.recovery-workspace/dist-backup-20250910-141917/connectors/interfaces/IConnector.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Brainy Connector Interface - Atomic Age Integration Framework
+ *
+ * 🧠 Base interface for all premium connectors in Brain Cloud
+ * ⚛️ Open source interface, implementations are premium-only
+ */
+export interface ConnectorConfig {
+    /** Connector identifier (e.g., 'notion', 'salesforce') */
+    connectorId: string;
+    /** Premium license key (required for Brain Cloud connectors) */
+    licenseKey: string;
+    /** API credentials for the external service */
+    credentials: {
+        apiKey?: string;
+        accessToken?: string;
+        refreshToken?: string;
+        clientId?: string;
+        clientSecret?: string;
+        [key: string]: any;
+    };
+    /** Connector-specific configuration */
+    options?: {
+        syncInterval?: number;
+        batchSize?: number;
+        retryAttempts?: number;
+        [key: string]: any;
+    };
+    /** Brainy database instance configuration */
+    brainy?: {
+        endpoint?: string;
+        storage?: string;
+        [key: string]: any;
+    };
+}
+export interface SyncResult {
+    /** Number of items successfully synced */
+    synced: number;
+    /** Number of items that failed to sync */
+    failed: number;
+    /** Number of items skipped (duplicates, etc.) */
+    skipped: number;
+    /** Total processing time in milliseconds */
+    duration: number;
+    /** Sync operation timestamp */
+    timestamp: string;
+    /** Error details for failed items */
+    errors?: Array<{
+        item: string;
+        error: string;
+        retryable: boolean;
+    }>;
+    /** Metadata about the sync operation */
+    metadata?: {
+        lastSyncId?: string;
+        nextPageToken?: string;
+        hasMore?: boolean;
+        [key: string]: any;
+    };
+}
+export interface ConnectorStatus {
+    /** Current connector state */
+    status: 'connected' | 'disconnected' | 'error' | 'syncing' | 'paused';
+    /** Human-readable status message */
+    message: string;
+    /** Last successful sync timestamp */
+    lastSync?: string;
+    /** Next scheduled sync timestamp */
+    nextSync?: string;
+    /** Connection health indicators */
+    health: {
+        apiReachable: boolean;
+        credentialsValid: boolean;
+        licenseValid: boolean;
+        quotaRemaining?: number;
+    };
+    /** Usage statistics */
+    stats?: {
+        totalSyncs: number;
+        totalItems: number;
+        averageDuration: number;
+        errorRate: number;
+    };
+}
+/**
+ * Base interface for all Brainy premium connectors
+ *
+ * Implementations auto-load with Brain Cloud subscription after auth
+ */
+export interface IConnector {
+    /** Unique connector identifier */
+    readonly id: string;
+    /** Human-readable connector name */
+    readonly name: string;
+    /** Connector version */
+    readonly version: string;
+    /** Supported data types this connector can handle */
+    readonly supportedTypes: string[];
+    /**
+     * Initialize the connector with configuration
+     */
+    initialize(config: ConnectorConfig): Promise<void>;
+    /**
+     * Test connection to the external service
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get current connector status and health
+     */
+    getStatus(): Promise<ConnectorStatus>;
+    /**
+     * Start syncing data from the external service
+     */
+    startSync(): Promise<SyncResult>;
+    /**
+     * Stop any ongoing sync operations
+     */
+    stopSync(): Promise<void>;
+    /**
+     * Perform incremental sync (delta changes only)
+     */
+    incrementalSync(): Promise<SyncResult>;
+    /**
+     * Perform full sync (all data)
+     */
+    fullSync(): Promise<SyncResult>;
+    /**
+     * Preview what would be synced without actually syncing
+     */
+    previewSync(limit?: number): Promise<{
+        items: Array<{
+            type: string;
+            title: string;
+            preview: string;
+            relationships: string[];
+        }>;
+        totalCount: number;
+        estimatedDuration: number;
+    }>;
+    /**
+     * Clean up resources and disconnect
+     */
+    disconnect(): Promise<void>;
+}