ruvnet/ruflo · error

Skipping invalid migration filename: ${filename}

Error message

Skipping invalid migration filename: ${filename}

What it means

Generic guard in loadMigrations(): parseMigrationFilename could not extract a valid version/name from a .sql file in the migrations directory, so that file is excluded from the migration set rather than aborting the scan.

Source

Thrown at v3/@claude-flow/plugins/src/integrations/ruvector/migrations/migrations.ts:220

    this.log('Migrations table initialized');
  }

  /**
   * Load all migration files from the migrations directory
   */
  async loadMigrations(): Promise<MigrationFile[]> {
    this.log(`Loading migrations from ${this.migrationsDir}`);

    const files = await readdir(this.migrationsDir);
    const sqlFiles = files.filter(f => f.endsWith('.sql')).sort();

    const migrations: MigrationFile[] = [];

    for (const filename of sqlFiles) {
      const parsed = parseMigrationFilename(filename);
      if (!parsed) {
        this.logger.warn(`Skipping invalid migration filename: ${filename}`);
        continue;
      }

      const filepath = join(this.migrationsDir, filename);
      const content = await readFile(filepath, 'utf-8');

      migrations.push({
        number: parsed.number,
        name: `${parsed.number.toString().padStart(3, '0')}_${parsed.name}`,
        filename,
        upSql: content,
        downSql: extractRollbackSql(content),
        checksum: md5(content),
      });
    }

    this.log(`Found ${migrations.length} migration files`);
    return migrations;

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Rename the migration file to the expected numeric/name format so it is picked up, or remove it if stray.

When it happens

Trigger: Thrown at v3/@claude-flow/plugins/src/integrations/ruvector/migrations/migrations.ts:220 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/45a8b74558f2861b. Report an issue: GitHub.