ruvnet/ruflo · error · SyncBridgeError

SYNC_FAILED

SYNC_FAILED

Error message

Failed to sync from AgentDB

What it means

syncFromAgentDB() failed while paging entries out of the AgentDB namespace (query error or connection issue). The SYNC_FAILED wrapper carries the original error; sync state was not advanced, so the next run retries from the old watermark.

Source

Thrown at v3/plugins/gastown-bridge/src/bridges/sync-bridge.ts:551

        }

        offset += entries.length;
        hasMore = entries.length === this.config.batchSize;
      }

      // Update sync state
      this.syncState.lastSyncTime = new Date().toISOString();
      await this.saveSyncState();

      const durationMs = Date.now() - startTime;
      this.logger.info('Sync from AgentDB complete', {
        beads: beads.length,
        durationMs,
      });

      return beads;
    } catch (error) {
      throw new SyncBridgeError(
        'Failed to sync from AgentDB',
        'SYNC_FAILED',
        undefined,
        error as Error
      );
    }
  }

  /**
   * Perform full bidirectional sync
   */
  async syncBidirectional(): Promise<{
    toAgentDB: SyncResult;
    fromAgentDB: Bead[];
  }> {
    this.ensureInitialized();

    this.logger.info('Starting bidirectional sync');

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check connectivity and credentials for AgentDB, then retry the sync.
2. Ensure both sides are initialized and schema versions match before syncing.

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/bridges/sync-bridge.ts:551 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/5ae7ef351ff990ee. Report an issue: GitHub.