ruvnet/ruflo · error

Beads sync failed

Error message

Beads sync failed

What it means

Log warning in the gt/beads-sync session-start hook: the bidirectional AgentDB<->beads sync threw; the hook swallows the error so session start proceeds without the sync having completed.

Source

Thrown at v3/plugins/gastown-bridge/src/index.ts:1652

        return payload;
      },
    };
  }

  private createBeadsSyncHook(): PluginHook {
    return {
      name: 'gt/beads-sync',
      event: 'session-start',
      priority: 100,
      description: 'Sync beads with AgentDB on session start',
      handler: async (_context: PluginContext, payload: unknown) => {
        if (this.config.gastown?.enableBeadsSync && this.syncBridge) {
          this.logger.info('Beads sync triggered on session start');
          try {
            // Use syncBidirectional for full sync
            await this.syncBridge.syncBidirectional();
          } catch (error) {
            this.logger.warn('Beads sync failed', {
              error: error instanceof Error ? error.message : String(error),
            });
          }
        }
        return payload;
      },
    };
  }

  private createConvoyProgressHook(): PluginHook {
    return {
      name: 'gt/convoy-progress',
      event: 'task-complete',
      priority: 60,
      description: 'Update convoy progress when tasks complete',
      handler: async (_context: PluginContext, payload: unknown) => {
        if (this.convoyTracker) {
          // Refresh active convoy progress

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the sync error detail and AgentDB connectivity; retry the beads sync once the backend is healthy.

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/index.ts:1652 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/7c935ef3a7aa19f6. Report an issue: GitHub.