ruvnet/ruflo · error

[rvf-embedding-cache] Truncated entry, stopping load

Error message

[rvf-embedding-cache] Truncated entry, stopping load

What it means

Log warning in loadFromFile's entry loop: remaining bytes are fewer than the entry header/embedding requires (corrupt or truncated file); loading stops at the last complete entry instead of failing.

Source

Thrown at v3/@claude-flow/embeddings/src/rvf-embedding-cache.ts:533

          formatVersion = possibleVersion;
          offset += 4;
        }
      }

      // Read entries
      while (offset + 8 <= buffer.byteLength) {
        // Need at least 4 (hash) + 4 (dims) = 8 bytes for the header
        const hash = view.getUint32(offset, true);
        offset += 4;

        const dims = view.getUint32(offset, true);
        offset += 4;

        const entryDataSize = formatVersion === 2
          ? dims * 4 + 8 + 8 + 8   // v2: embedding + createdAt + accessedAt + accessCount
          : dims * 4 + 8 + 8;       // v1: embedding + accessedAt + accessCount
        if (offset + entryDataSize > buffer.byteLength) {
          console.warn('[rvf-embedding-cache] Truncated entry, stopping load');
          break;
        }

        // Read embedding
        const embedding = new Float32Array(dims);
        for (let i = 0; i < dims; i++) {
          embedding[i] = view.getFloat32(offset, true);
          offset += 4;
        }

        let createdAt: number;
        let accessedAt: number;
        let accessCount: number;

        if (formatVersion >= 2) {
          createdAt = view.getFloat64(offset, true);
          offset += 8;
          accessedAt = view.getFloat64(offset, true);

View on GitHub (pinned to fa13ee4ad6)

Solutions

  1. Delete the cache file so it is regenerated; truncation indicates an incomplete previous write.
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at v3/@claude-flow/embeddings/src/rvf-embedding-cache.ts:533 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/30a0a08790c4b128. Report an issue: GitHub.