ruvnet/ruflo · error · TeammateError

MEMORY_LOAD_FAILED

MEMORY_LOAD_FAILED

Error message

Failed to load memory for ${teammateId}

What it means

The teammate-memory loader caught an exception while reading/parsing the memory file for the teammate (missing file, unreadable JSON, or invalid date fields) and rethrew as a TeammateError. The persisted memory state is corrupt or absent, so the transcript/history cannot be reconstructed.

Source

Thrown at v3/plugins/teammate-plugin/src/teammate-bridge.ts:1784

    try {
      const memory = JSON.parse(fs.readFileSync(memoryPath, 'utf-8')) as TeammateMemory;

      // Parse dates
      memory.createdAt = new Date(memory.createdAt);
      memory.updatedAt = new Date(memory.updatedAt);
      memory.transcript = memory.transcript.map(m => ({
        ...m,
        timestamp: new Date(m.timestamp),
      }));

      const memoryKey = `${teamName}:${teammateId}`;
      this.teammateMemories.set(memoryKey, memory);

      this.emit('memory:loaded', { team: teamName, teammateId });

      return memory;
    } catch {
      throw new TeammateError(
        `Failed to load memory for ${teammateId}`,
        TeammateErrorCode.MEMORY_LOAD_FAILED,
        teamName,
        teammateId
      );
    }
  }

  /**
   * Share transcript between teammates
   */
  async shareTranscript(
    teamName: string,
    fromId: string,
    toId: string,
    options?: { start?: number; end?: number }
  ): Promise<void> {
    this.ensureAvailable();

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the memory store for the teammate; verify the store backend is reachable and the teammate id is correct.

When it happens

Trigger: Thrown at v3/plugins/teammate-plugin/src/teammate-bridge.ts:1784 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/4acb0bfbd344c258. Report an issue: GitHub.