ruvnet/ruflo · error

Some beads failed to parse

Error message

Some beads failed to parse

What it means

Log warning in parseBdOutput: some JSONL lines failed JSON.parse or BeadSchema validation; the malformed lines are recorded with line numbers and errors, while successfully parsed beads are still returned.

Source

Thrown at v3/plugins/gastown-bridge/src/bridges/bd-bridge.ts:662

      if (!line) continue;

      try {
        const parsed = JSON.parse(line);
        const validated = BeadSchema.parse(parsed);
        beads.push(validated);

        // Also cache individual beads
        singleBeadCache.set(validated.id, validated);
      } catch (error) {
        errors.push({
          line: i + 1,
          error: error instanceof Error ? error.message : String(error),
        });
      }
    }

    if (errors.length > 0) {
      this.logger.warn('Some beads failed to parse', {
        totalLines: lines.length,
        parsed: beads.length,
        errors: errors.length,
        firstErrors: errors.slice(0, 3),
      });
    }

    // Cache the parsed result
    parsedCache.set(cacheKey, beads);

    return beads;
  }

  /**
   * Parse single bead from JSON output
   */
  parseSingleBead(output: string): Bead {
    if (!output || output.trim() === '') {

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the sanitizers log for which beads failed to parse; fix or remove the malformed entries in the beads source.

When it happens

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

Common situations: See trigger scenarios.

Understand the failure class

• Parsing and encoding errors: unexpected token, malformed input — why parsers reject input and how to find the real culprit.

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