paperclipai/paperclip · error

Migration journal entry ${index} is missing a tag

Error message

Migration journal entry ${index} is missing a tag

What it means

Error "Migration journal entry ${index} is missing a tag" thrown in paperclipai/paperclip.

Source

Thrown at packages/db/src/check-migration-numbering.ts:79

      );
    }
  }
}

async function main() {
  const migrationFiles = (await readdir(migrationsDir))
    .filter((entry) => entry.endsWith(".sql"))
    .sort();

  ensureNoDuplicates(migrationFiles, "migration files");
  ensureStrictlyOrdered(migrationFiles, "migration files");

  const rawJournal = await readFile(journalPath, "utf8");
  const journal = JSON.parse(rawJournal) as JournalFile;
  const journalTags = (journal.entries ?? [])
    .map((entry, index) => {
      if (typeof entry.tag !== "string" || entry.tag.length === 0) {
        throw new Error(`Migration journal entry ${index} is missing a tag`);
      }
      return entry.tag;
    });

  ensureNoDuplicates(journalTags, "migration journal");
  ensureStrictlyOrdered(journalTags, "migration journal");
  ensureJournalMatchesFiles(migrationFiles, journalTags);
}

await main();

View on GitHub (pinned to 120ae5428f)

Solutions

1. Add the missing tag to journal entry ${index} in the migration journal.

When it happens

Trigger: Thrown at packages/db/src/check-migration-numbering.ts:79 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/f8dc783ee92c5c2f. Report an issue: GitHub.