migration-codegen

name	migration-codegen
description	Change Laravel, TypeORM, or Django migration generation and generated SQL parsing. Use when modifying framework code generation, foreign keys, indexes, naming, or migration artifacts.

Migration Code Generation

Read First

• src/lib/codegen/ and its Laravel, TypeORM, and Django generators.
• src/lib/exporter/ for dialect-specific SQL generation.
• src/lib/types.ts for columns, indexes, and edge metadata.
• src/lib/utils.ts for IDs and relationship helpers.

Change Rules

1. Keep framework conventions explicit: Laravel timestamps and inferred foreign-key names, TypeORM's SQL parsing assumptions, and Django's yourapp placeholder.
2. Validate identifier quoting, nullable/default/generated columns, indexes, composite foreign keys, on-delete/on-update behavior, and table ordering.
3. Do not assume generated SQL has one formatting shape. If a generator parses SQL, keep the parser tolerant of the SQL it emits and test alterations as well as creates.
4. Preserve hyphenated IDs when resolving handles and columns. Never use split("-")[0] as a column-ID parser.
5. Treat output as a candidate artifact. Do not claim a migration is executable without reviewing or executing it against the target framework/database.

Verification

• Generate artifacts for empty, single-table, indexed, related, composite-key, and altered schemas.
• Inspect generated files for valid syntax, deterministic naming, and correct foreign-key direction.
• Exercise each supported database type where the generator accepts it.
• Run type-check, lint, and build; manually review generated output because no generated SQL test runner is configured.