Merge branch 'main' into chore/rename-database-migrate-to-upgrade

packages/twenty-server/src/database/typeorm/core/core.datasource.ts

@@ -56,14 +56,19 @@ export const typeORMCoreModuleOptions: TypeOrmModuleOptions = {
   migrationsRun: false,
   migrationsTableName: '_typeorm_migrations',
   metadataTableName: '_typeorm_generated_columns_and_materialized_views',
+  // The TypeORM migration system is frozen — historical migrations live in
+  // `legacy-typeorm-migrations-do-not-add/` and are loaded here only so the
+  // `_typeorm_migrations` table stays consistent for older deployments.
+  // Do NOT add new files there: write a fast/slow instance command instead.
+  // See `packages/twenty-server/docs/UPGRADE_COMMANDS.md`.
   migrations:
     process.env.IS_BILLING_ENABLED === 'true'
       ? [
-          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/migrations/common/*{.ts,.js}`,
-          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/migrations/billing/*{.ts,.js}`,
+          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/legacy-typeorm-migrations-do-not-add/common/*{.ts,.js}`,
+          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/legacy-typeorm-migrations-do-not-add/billing/*{.ts,.js}`,
         ]
       : [
-          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/migrations/common/*{.ts,.js}`,
+          `${isJest ? 'src/' : 'dist/'}database/typeorm/core/legacy-typeorm-migrations-do-not-add/common/*{.ts,.js}`,
         ],
   ssl:
     process.env.PG_SSL_ALLOW_SELF_SIGNED === 'true'

packages/twenty-server/src/database/typeorm/core/legacy-typeorm-migrations-do-not-add/README.md

@@ -0,0 +1,23 @@
+# Legacy TypeORM migrations — do not add new files here
+
+This directory contains historical TypeORM migrations (`common/` and `billing/`).
+They are kept so that older deployments can still replay them against the
+`_typeorm_migrations` table.
+
+**The TypeORM migration system is frozen.** Do not add new files here.
+
+The active upgrade system is **instance commands** (fast / slow) and
+**workspace commands**, registered with `@RegisteredInstanceCommand` and
+`@RegisteredWorkspaceCommand`. Generate one with:
+
+```bash
+npx nx run twenty-server:database:migrate:generate --name <name> --type <fast|slow>
+```
+
+See `packages/twenty-server/docs/UPGRADE_COMMANDS.md` for the full guide and
+`packages/twenty-server/src/database/commands/upgrade-version-command/` for
+existing examples.
+
+Note: `../migrations/utils/` is **not** legacy — those SQL helpers are still
+imported by current instance/workspace commands and live outside this folder
+on purpose.