gsd-agent 1.0.0

package/dist/reconnection-manager.test.js

@@ -0,0 +1,151 @@
+/**
+ * Tests for ReconnectionManager
+ *
+ * Validates disconnection detection, exponential backoff reconnection,
+ * and bidirectional reconciliation after reconnect.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { createReconnectionManager } from './reconnection-manager.js';
+import { createLogger } from './logger.js';
+describe('ReconnectionManager', () => {
+    let mockSupabase;
+    let mockSubscriber;
+    let mockRemoteSyncHandler;
+    let mockSyncEngine;
+    let mockSyncStateManager;
+    let workspaces;
+    let logger;
+    beforeEach(() => {
+        // Mock Supabase client
+        mockSupabase = {
+            connect: vi.fn().mockResolvedValue({ success: true })
+        };
+        // Mock RealtimeSubscriber
+        mockSubscriber = {
+            subscribe: vi.fn()
+        };
+        // Mock RemoteSyncHandler
+        mockRemoteSyncHandler = {
+            handleRemoteChange: vi.fn()
+        };
+        // Mock SyncEngine
+        mockSyncEngine = {
+            getState: vi.fn().mockReturnValue({
+                sync_queue: []
+            })
+        };
+        // Mock SyncStateManager
+        mockSyncStateManager = {
+            getWorkspaceState: vi.fn().mockReturnValue({
+                workspace_id: 'workspace-123',
+                last_sync_timestamp: '2026-03-27T00:00:00Z',
+                connection_status: 'connected',
+                pending_changes_count: 0
+            }),
+            updateWorkspaceState: vi.fn()
+        };
+        // Create test workspace
+        workspaces = new Map([
+            [
+                'workspace-123',
+                {
+                    id: 'workspace-123',
+                    root_path: '/test/workspace',
+                    name: 'Test Workspace',
+                    status: 'active',
+                    last_sync: '2026-03-27T00:00:00Z',
+                    discovered_at: '2026-03-27T00:00:00Z'
+                }
+            ]
+        ]);
+        logger = createLogger({
+            log_level: 'ERROR',
+            log_file: '/tmp/test.log',
+            log_rotation_days: 1
+        });
+    });
+    it('Test 1: detectDisconnection() sets connection_status to disconnected', () => {
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        manager.detectDisconnection('workspace-123');
+        expect(mockSyncStateManager.updateWorkspaceState).toHaveBeenCalledWith('workspace-123', expect.objectContaining({
+            connection_status: 'disconnected'
+        }));
+    });
+    it('Test 2: attemptReconnection() retries with exponential backoff (1s, 2s, 4s, 8s, max 60s)', async () => {
+        vi.useFakeTimers();
+        // Mock connect to fail first 3 times, then succeed
+        let callCount = 0;
+        mockSupabase.connect = vi.fn().mockImplementation(() => {
+            callCount++;
+            if (callCount <= 3) {
+                return Promise.resolve({ success: false, error: 'Connection failed' });
+            }
+            return Promise.resolve({ success: true });
+        });
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        // Start reconnection attempt
+        const reconnectPromise = manager.attemptReconnection('workspace-123');
+        // Fast-forward through backoff delays: 1s, 2s, 4s
+        await vi.advanceTimersByTimeAsync(1000); // First retry after 1s
+        await vi.advanceTimersByTimeAsync(2000); // Second retry after 2s
+        await vi.advanceTimersByTimeAsync(4000); // Third retry after 4s
+        await reconnectPromise;
+        expect(mockSupabase.connect).toHaveBeenCalledTimes(4); // Initial + 3 retries
+        expect(mockSyncStateManager.updateWorkspaceState).toHaveBeenCalledWith('workspace-123', expect.objectContaining({
+            connection_status: 'connected'
+        }));
+        vi.useRealTimers();
+    });
+    it('Test 3: On successful reconnect, reconcileChanges() syncs local → remote', async () => {
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        // Mock sync engine with pending changes
+        mockSyncEngine.getState = vi.fn().mockReturnValue({
+            sync_queue: [
+                {
+                    id: 'event-1',
+                    workspace_id: 'workspace-123',
+                    file_path: '.planning/STATE.md',
+                    content: 'local content',
+                    content_hash: 'hash123'
+                }
+            ]
+        });
+        await manager.reconcileChanges('workspace-123');
+        // Verify local changes were synced
+        expect(mockSyncEngine.getState).toHaveBeenCalled();
+    });
+    it('Test 4: On successful reconnect, reconcileChanges() syncs remote → local', async () => {
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        await manager.reconcileChanges('workspace-123');
+        // Verify reconciliation was attempted
+        expect(mockSyncStateManager.getWorkspaceState).toHaveBeenCalledWith('workspace-123');
+    });
+    it('Test 5: reconcileChanges() uses last_sync_timestamp to fetch missed changes', async () => {
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        mockSyncStateManager.getWorkspaceState = vi.fn().mockReturnValue({
+            workspace_id: 'workspace-123',
+            last_sync_timestamp: '2026-03-27T01:00:00Z',
+            connection_status: 'disconnected',
+            pending_changes_count: 0
+        });
+        await manager.reconcileChanges('workspace-123');
+        expect(mockSyncStateManager.getWorkspaceState).toHaveBeenCalledWith('workspace-123');
+    });
+    it('Test 6: reconcileChanges() detects conflicts during bidirectional sync', async () => {
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        // This test verifies the conflict detection logic is invoked
+        await manager.reconcileChanges('workspace-123');
+        // Verify state was checked for reconciliation
+        expect(mockSyncStateManager.getWorkspaceState).toHaveBeenCalled();
+    });
+    it('Test 7: Logs recovery summary: "Synced N local changes, M remote changes, K conflicts"', async () => {
+        const logSpy = vi.spyOn(logger, 'info');
+        const manager = createReconnectionManager(mockSupabase, mockSubscriber, mockRemoteSyncHandler, mockSyncEngine, mockSyncStateManager, workspaces, logger);
+        await manager.reconcileChanges('workspace-123');
+        // Verify recovery summary was logged
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Reconciliation complete'), expect.objectContaining({
+            workspace_id: 'workspace-123'
+        }));
+    });
+});
+//# sourceMappingURL=reconnection-manager.test.js.map

package/dist/reconnection-manager.test.js.map

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

package/dist/remote-sync-handler.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Remote sync handler for GSD Agent
+ *
+ * Handles remote → local sync by listening to RealtimeSubscriber events
+ * and writing changes to the filesystem with conflict detection.
+ */
+import type { RemoteChangeEvent, Workspace } from './types.js';
+import type { RealtimeSubscriber } from './realtime-subscriber.js';
+import type { ConflictResolver } from './conflict-resolver.js';
+import type { Logger } from './logger.js';
+/**
+ * RemoteSyncHandler applies remote changes to local filesystem
+ *
+ * Subscribes to RealtimeSubscriber events and writes remote changes locally.
+ * Detects conflicts and creates git-style conflict markers when needed.
+ * Prevents sync loops by tracking in-progress syncs.
+ */
+export declare class RemoteSyncHandler {
+    private subscriber;
+    private resolver;
+    private workspaces;
+    private logger;
+    private syncingFiles;
+    private remoteChangeHandler;
+    constructor(subscriber: RealtimeSubscriber, resolver: ConflictResolver, workspaces: Map<string, Workspace>, logger: Logger);
+    /**
+     * Start listening to remote change events
+     */
+    start(): void;
+    /**
+     * Stop listening to remote change events
+     */
+    stop(): void;
+    /**
+     * Handle remote change event
+     * @param event - RemoteChangeEvent from RealtimeSubscriber
+     */
+    handleRemoteChange(event: RemoteChangeEvent): Promise<void>;
+    /**
+     * Handle large file download from Supabase Storage
+     * @param event - RemoteChangeEvent with storage_url
+     * @param absolutePath - Absolute path to write file
+     */
+    private handleLargeFile;
+    /**
+     * Write file atomically with parent directory creation
+     * @param filePath - Absolute path to file
+     * @param content - File content
+     */
+    private writeFileAtomic;
+}
+/**
+ * Factory function to create RemoteSyncHandler
+ * @param subscriber - RealtimeSubscriber instance
+ * @param resolver - ConflictResolver instance
+ * @param workspaces - Map of workspace ID to Workspace
+ * @param logger - Logger instance
+ * @returns RemoteSyncHandler instance
+ */
+export declare function createRemoteSyncHandler(subscriber: RealtimeSubscriber, resolver: ConflictResolver, workspaces: Map<string, Workspace>, logger: Logger): RemoteSyncHandler;
+//# sourceMappingURL=remote-sync-handler.d.ts.map

package/dist/remote-sync-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync-handler.d.ts","sourceRoot":"","sources":["../src/remote-sync-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,mBAAmB,CAAsD;gBAG/E,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAClC,MAAM,EAAE,MAAM;IAUhB;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;;OAGG;IACG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgGjE;;;;OAIG;YACW,eAAe;IAmC7B;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAUxB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAClC,MAAM,EAAE,MAAM,GACb,iBAAiB,CAEnB"}

package/dist/remote-sync-handler.js

@@ -0,0 +1,197 @@
+/**
+ * Remote sync handler for GSD Agent
+ *
+ * Handles remote → local sync by listening to RealtimeSubscriber events
+ * and writing changes to the filesystem with conflict detection.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * RemoteSyncHandler applies remote changes to local filesystem
+ *
+ * Subscribes to RealtimeSubscriber events and writes remote changes locally.
+ * Detects conflicts and creates git-style conflict markers when needed.
+ * Prevents sync loops by tracking in-progress syncs.
+ */
+export class RemoteSyncHandler {
+    subscriber;
+    resolver;
+    workspaces;
+    logger;
+    syncingFiles;
+    remoteChangeHandler;
+    constructor(subscriber, resolver, workspaces, logger) {
+        this.subscriber = subscriber;
+        this.resolver = resolver;
+        this.workspaces = workspaces;
+        this.logger = logger;
+        this.syncingFiles = new Set();
+        this.remoteChangeHandler = null;
+    }
+    /**
+     * Start listening to remote change events
+     */
+    start() {
+        this.logger.info('Remote sync handler started', {
+            workspace_count: this.workspaces.size
+        });
+        // Create bound handler
+        this.remoteChangeHandler = this.handleRemoteChange.bind(this);
+        // Subscribe to remote-change events
+        this.subscriber.on('remote-change', this.remoteChangeHandler);
+    }
+    /**
+     * Stop listening to remote change events
+     */
+    stop() {
+        this.logger.info('Remote sync handler stopped', {
+            workspace_count: this.workspaces.size
+        });
+        // Unsubscribe from events
+        if (this.remoteChangeHandler) {
+            this.subscriber.off('remote-change', this.remoteChangeHandler);
+            this.remoteChangeHandler = null;
+        }
+    }
+    /**
+     * Handle remote change event
+     * @param event - RemoteChangeEvent from RealtimeSubscriber
+     */
+    async handleRemoteChange(event) {
+        const syncKey = `${event.workspace_id}:${event.file_path}`;
+        // Prevent sync loops - skip if already syncing this file
+        if (this.syncingFiles.has(syncKey)) {
+            this.logger.debug('Skipping remote change - sync already in progress', {
+                workspace_id: event.workspace_id,
+                file_path: event.file_path
+            });
+            return;
+        }
+        try {
+            this.syncingFiles.add(syncKey);
+            // Get workspace
+            const workspace = this.workspaces.get(event.workspace_id);
+            if (!workspace) {
+                this.logger.warn('Workspace not found for remote change', {
+                    workspace_id: event.workspace_id
+                });
+                return;
+            }
+            // Build absolute file path
+            const absolutePath = path.join(workspace.root_path, event.file_path);
+            // Handle large files from Storage
+            if (event.storage_url && !event.content) {
+                await this.handleLargeFile(event, absolutePath);
+                return;
+            }
+            // Check if file exists locally
+            const fileExists = fs.existsSync(absolutePath);
+            if (fileExists) {
+                // Read local content
+                const localContent = fs.readFileSync(absolutePath, 'utf8');
+                // Detect conflict
+                const conflict = await this.subscriber.detectConflict(event.workspace_id, event.file_path, event.content_hash, event.content || '', localContent);
+                if (conflict) {
+                    // Conflict detected - create conflict markers
+                    this.logger.warn('Conflict detected - creating conflict markers', {
+                        workspace_id: event.workspace_id,
+                        file_path: event.file_path,
+                        local_hash: conflict.local_hash,
+                        remote_hash: conflict.remote_hash
+                    });
+                    const conflictMarkers = this.resolver.resolveConflict(conflict);
+                    // Write conflict markers to file
+                    this.writeFileAtomic(absolutePath, conflictMarkers);
+                    // Commit conflicted file
+                    await this.resolver.commitConflict(workspace.root_path, event.file_path);
+                    this.logger.info('Conflict resolved with markers and committed', {
+                        workspace_id: event.workspace_id,
+                        file_path: event.file_path
+                    });
+                    return;
+                }
+            }
+            // No conflict or file doesn't exist - write remote content
+            if (event.content !== null) {
+                this.writeFileAtomic(absolutePath, event.content);
+                this.logger.info('File synced from remote', {
+                    workspace_id: event.workspace_id,
+                    file_path: event.file_path,
+                    size: event.size
+                });
+            }
+        }
+        catch (error) {
+            this.logger.error('Error handling remote change', {
+                workspace_id: event.workspace_id,
+                file_path: event.file_path,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+        finally {
+            this.syncingFiles.delete(syncKey);
+        }
+    }
+    /**
+     * Handle large file download from Supabase Storage
+     * @param event - RemoteChangeEvent with storage_url
+     * @param absolutePath - Absolute path to write file
+     */
+    async handleLargeFile(event, absolutePath) {
+        try {
+            this.logger.info('Downloading large file from Storage', {
+                workspace_id: event.workspace_id,
+                file_path: event.file_path,
+                storage_url: event.storage_url,
+                size: event.size
+            });
+            // Download from Storage
+            const response = await fetch(event.storage_url);
+            if (!response.ok) {
+                throw new Error(`Storage download failed: ${response.statusText}`);
+            }
+            const content = await response.text();
+            // Write to filesystem
+            this.writeFileAtomic(absolutePath, content);
+            this.logger.info('Large file downloaded and synced', {
+                workspace_id: event.workspace_id,
+                file_path: event.file_path,
+                size: content.length
+            });
+        }
+        catch (error) {
+            this.logger.error('Error downloading large file', {
+                workspace_id: event.workspace_id,
+                file_path: event.file_path,
+                storage_url: event.storage_url,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Write file atomically with parent directory creation
+     * @param filePath - Absolute path to file
+     * @param content - File content
+     */
+    writeFileAtomic(filePath, content) {
+        // Create parent directories if needed
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Write file atomically
+        fs.writeFileSync(filePath, content, 'utf8');
+    }
+}
+/**
+ * Factory function to create RemoteSyncHandler
+ * @param subscriber - RealtimeSubscriber instance
+ * @param resolver - ConflictResolver instance
+ * @param workspaces - Map of workspace ID to Workspace
+ * @param logger - Logger instance
+ * @returns RemoteSyncHandler instance
+ */
+export function createRemoteSyncHandler(subscriber, resolver, workspaces, logger) {
+    return new RemoteSyncHandler(subscriber, resolver, workspaces, logger);
+}
+//# sourceMappingURL=remote-sync-handler.js.map

package/dist/remote-sync-handler.js.map

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

package/dist/remote-sync-handler.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for RemoteSyncHandler
+ *
+ * Verifies remote → local sync with conflict detection and filesystem writes.
+ */
+export {};
+//# sourceMappingURL=remote-sync-handler.test.d.ts.map

package/dist/remote-sync-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync-handler.test.d.ts","sourceRoot":"","sources":["../src/remote-sync-handler.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/remote-sync-handler.test.js

@@ -0,0 +1,212 @@
+/**
+ * Tests for RemoteSyncHandler
+ *
+ * Verifies remote → local sync with conflict detection and filesystem writes.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { EventEmitter } from 'events';
+// Mock fs at top level
+vi.mock('fs', () => ({
+    default: {
+        existsSync: vi.fn(),
+        readFileSync: vi.fn(),
+        writeFileSync: vi.fn(),
+        mkdirSync: vi.fn()
+    }
+}));
+// Mock fetch at top level
+global.fetch = vi.fn();
+import { RemoteSyncHandler } from './remote-sync-handler.js';
+import fs from 'fs';
+describe('RemoteSyncHandler', () => {
+    let mockSubscriber;
+    let mockResolver;
+    let mockLogger;
+    let workspaces;
+    let handler;
+    beforeEach(() => {
+        // Mock RealtimeSubscriber
+        mockSubscriber = new EventEmitter();
+        mockSubscriber.detectConflict = vi.fn();
+        // Mock ConflictResolver
+        mockResolver = {
+            resolveConflict: vi.fn(),
+            commitConflict: vi.fn()
+        };
+        // Mock Logger
+        mockLogger = {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            debug: vi.fn()
+        };
+        // Setup workspaces
+        workspaces = new Map();
+        workspaces.set('ws-123', {
+            id: 'ws-123',
+            root_path: '/home/user/projects/my-project',
+            name: 'my-project',
+            status: 'active',
+            last_sync: '2026-03-27T00:00:00Z',
+            discovered_at: '2026-03-27T00:00:00Z'
+        });
+        handler = new RemoteSyncHandler(mockSubscriber, mockResolver, workspaces, mockLogger);
+        // Clear all mocks
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should write remote content to filesystem when handleRemoteChange is called', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            content: 'Remote content',
+            content_hash: 'abc123',
+            size: 14,
+            updated_at: '2026-03-27T13:45:32Z'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(false);
+        vi.mocked(mockSubscriber.detectConflict).mockResolvedValue(null);
+        await handler.handleRemoteChange(event);
+        expect(fs.writeFileSync).toHaveBeenCalledWith('/home/user/projects/my-project/.planning/STATE.md', 'Remote content', 'utf8');
+    });
+    it('should detect conflict when local file differs', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            content: 'Remote content',
+            content_hash: 'abc123',
+            size: 14,
+            updated_at: '2026-03-27T13:45:32Z'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(true);
+        vi.mocked(fs.readFileSync).mockReturnValue('Local content');
+        vi.mocked(mockSubscriber.detectConflict).mockResolvedValue({
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            local_hash: 'def456',
+            remote_hash: 'abc123',
+            local_content: 'Local content',
+            remote_content: 'Remote content',
+            detected_at: '2026-03-27T13:45:32Z'
+        });
+        await handler.handleRemoteChange(event);
+        expect(mockSubscriber.detectConflict).toHaveBeenCalledWith('ws-123', '.planning/STATE.md', 'abc123', 'Remote content', 'Local content');
+    });
+    it('should create conflict markers when conflict detected', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            content: 'Remote content',
+            content_hash: 'abc123',
+            size: 14,
+            updated_at: '2026-03-27T13:45:32Z'
+        };
+        const conflict = {
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            local_hash: 'def456',
+            remote_hash: 'abc123',
+            local_content: 'Local content',
+            remote_content: 'Remote content',
+            detected_at: '2026-03-27T13:45:32Z'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(true);
+        vi.mocked(fs.readFileSync).mockReturnValue('Local content');
+        vi.mocked(mockSubscriber.detectConflict).mockResolvedValue(conflict);
+        vi.mocked(mockResolver.resolveConflict).mockReturnValue('<<<<<<< LOCAL\nLocal content\n=======\nRemote content\n>>>>>>> REMOTE');
+        await handler.handleRemoteChange(event);
+        expect(mockResolver.resolveConflict).toHaveBeenCalledWith(conflict);
+        expect(fs.writeFileSync).toHaveBeenCalledWith('/home/user/projects/my-project/.planning/STATE.md', expect.stringContaining('<<<<<<< LOCAL'), 'utf8');
+    });
+    it('should commit conflicted file to git', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            content: 'Remote content',
+            content_hash: 'abc123',
+            size: 14,
+            updated_at: '2026-03-27T13:45:32Z'
+        };
+        const conflict = {
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            local_hash: 'def456',
+            remote_hash: 'abc123',
+            local_content: 'Local content',
+            remote_content: 'Remote content',
+            detected_at: '2026-03-27T13:45:32Z'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(true);
+        vi.mocked(fs.readFileSync).mockReturnValue('Local content');
+        vi.mocked(mockSubscriber.detectConflict).mockResolvedValue(conflict);
+        vi.mocked(mockResolver.resolveConflict).mockReturnValue('conflict markers');
+        await handler.handleRemoteChange(event);
+        expect(mockResolver.commitConflict).toHaveBeenCalledWith('/home/user/projects/my-project', '.planning/STATE.md');
+    });
+    it('should skip write during local sync to prevent loops', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/STATE.md',
+            content: 'Remote content',
+            content_hash: 'abc123',
+            size: 14,
+            updated_at: '2026-03-27T13:45:32Z'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(false);
+        // Create a promise that we control
+        let resolveWrite;
+        const writeDelay = new Promise(resolve => { resolveWrite = resolve; });
+        vi.mocked(fs.writeFileSync).mockImplementationOnce(() => {
+            // Don't actually block, just track the call
+        });
+        // Manually add to syncing set to simulate in-progress sync
+        const syncKey = `${event.workspace_id}:${event.file_path}`;
+        handler.syncingFiles.add(syncKey);
+        // Try to sync while already in progress
+        await handler.handleRemoteChange(event);
+        // Should log that sync was skipped
+        expect(mockLogger.debug).toHaveBeenCalledWith(expect.stringContaining('Skipping remote change - sync already in progress'), expect.any(Object));
+        // Should not write file
+        expect(fs.writeFileSync).not.toHaveBeenCalled();
+        handler.syncingFiles.delete(syncKey);
+    });
+    it('should subscribe to RealtimeSubscriber remote-change events on start', () => {
+        handler.start();
+        expect(mockSubscriber.listenerCount('remote-change')).toBeGreaterThan(0);
+        expect(mockLogger.info).toHaveBeenCalledWith(expect.stringContaining('Remote sync handler started'), expect.any(Object));
+    });
+    it('should unsubscribe from all events on stop', () => {
+        handler.start();
+        handler.stop();
+        expect(mockSubscriber.listenerCount('remote-change')).toBe(0);
+        expect(mockLogger.info).toHaveBeenCalledWith(expect.stringContaining('Remote sync handler stopped'), expect.any(Object));
+    });
+    it('should download large files from storage_url', async () => {
+        const event = {
+            id: 'file-1',
+            workspace_id: 'ws-123',
+            file_path: '.planning/large-file.md',
+            content: null,
+            content_hash: 'abc123',
+            size: 300000,
+            updated_at: '2026-03-27T13:45:32Z',
+            storage_url: 'https://storage.supabase.co/bucket/file.md'
+        };
+        vi.mocked(fs.existsSync).mockReturnValue(false);
+        vi.mocked(global.fetch).mockResolvedValue({
+            ok: true,
+            text: async () => 'Large file content'
+        });
+        await handler.handleRemoteChange(event);
+        expect(global.fetch).toHaveBeenCalledWith('https://storage.supabase.co/bucket/file.md');
+        expect(fs.writeFileSync).toHaveBeenCalledWith('/home/user/projects/my-project/.planning/large-file.md', 'Large file content', 'utf8');
+    });
+});
+//# sourceMappingURL=remote-sync-handler.test.js.map