ruvnet/ruflo · error · ResumeFailedError

--resume failed to load checkpoint ${resumeFrom}: ${(e as Er

Error message

--resume failed to load checkpoint ${resumeFrom}: ${(e as Error).message}

What it means

The pipeline found the checkpoint file but failed to restore it: resumeFrom() (preferred, epoch position + optimizer state) or the loadCheckpoint() fallback (weights only) threw, or loadCheckpoint explicitly returned false. Wrapped in ResumeFailedError so an explicit --resume never degrades into a fresh run.

Source

Thrown at v3/@claude-flow/cli/src/services/native-training.ts:130

    let resumed = false;
    let resumeMode: 'resumeFrom' | 'loadCheckpoint' | undefined;
    if (resumeFrom) {
      if (!existsSync(resumeFrom)) {
        throw new ResumeFailedError(`--resume checkpoint not found: ${resumeFrom}`);
      }
      try {
        if (typeof pipeline.resumeFrom === 'function') {
          pipeline.resumeFrom(resumeFrom);
          resumeMode = 'resumeFrom';
        } else {
          const ok = pipeline.loadCheckpoint(resumeFrom);
          if (ok === false) throw new Error('loadCheckpoint returned false');
          resumeMode = 'loadCheckpoint';
        }
        resumed = true;
      } catch (e) {
        if (e instanceof ResumeFailedError) throw e;
        throw new ResumeFailedError(
          `--resume failed to load checkpoint ${resumeFrom}: ${(e as Error).message}`,
        );
      }
    }

    // Pattern-alignment pairs, chunked into pipeline batches.
    const inputs: number[][] = [];
    const targets: number[][] = [];
    const qualities: number[] = [];
    for (let i = 0; i < embeddings.length; i++) {
      inputs.push(Array.from(embeddings[i]));
      targets.push(Array.from(embeddings[(i + 1) % embeddings.length]));
      qualities.push(1.0);
    }
    for (let i = 0; i < inputs.length; i += batchSize) {
      pipeline.addBatch(
        inputs.slice(i, i + batchSize),
        targets.slice(i, i + batchSize),

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the wrapped error message for the load failure cause
2. Re-create the checkpoint if it is corrupt, then resume from it

Example fix

Check the checkpoint file is intact and compatible with this version; if corrupted, resume from an earlier checkpoint or restart training.

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/services/native-training.ts:130 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/5e6e5d10dbd56032. Report an issue: GitHub.